From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-oa1-f42.google.com (mail-oa1-f42.google.com [209.85.160.42]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 07DEB3624BC for ; Tue, 5 May 2026 18:24:57 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.160.42 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778005499; cv=none; b=J33wT9HSPstBg2n0n1JcceVU7we/gIP1dbWw//S+T162P1fnVUCWD9niITVXzHsNgBmlbUaBm0QRQYS0qf2eq509LQrOq/165nk/SySS3/6UQNp9SPA3JRvYNYQ0lMPZFaZEIwpp2TtAzDg4iMFrSnIFeKOkOXt+I9YrNeDtCco= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778005499; c=relaxed/simple; bh=8BLWvL3pQJD7WvtrZjA08CCrXVJhJAisOKhnvofZksM=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=PhaFRXcOVzoE0X71ORNKbpYFRoRqG5Cqce4u2IGBFYjRoXiwOqwotxPFkb7WvMuvo8GW8DzCfUi3TaGCDipOhCloY/TWhkAwP69hPylf1SHaI5KjmM/xqCPJxGMkoqqxh2uMBihLyLlmWT0HNzYIKC+6nvim3ax54UbQLyML6VY= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linuxfoundation.org; spf=pass smtp.mailfrom=linuxfoundation.org; dkim=pass (1024-bit key) header.d=linuxfoundation.org header.i=@linuxfoundation.org header.b=g6JBE3Up; arc=none smtp.client-ip=209.85.160.42 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linuxfoundation.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linuxfoundation.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=linuxfoundation.org header.i=@linuxfoundation.org header.b="g6JBE3Up" Received: by mail-oa1-f42.google.com with SMTP id 586e51a60fabf-43454c72d2bso1223389fac.0 for ; Tue, 05 May 2026 11:24:57 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linuxfoundation.org; s=google; t=1778005497; x=1778610297; darn=vger.kernel.org; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:user-agent:mime-version:date:message-id :from:to:cc:subject:date:message-id:reply-to; bh=AiWl0VvmCcmAvKE7k/xTFIVAHM3vfW7H3kIFu8jks8Y=; b=g6JBE3UpZb9/ztrnI/tMixvPdvmxQg9ODUI9lJN2QGIRl73iF8KDw3Y31gOKKIZ0NZ u3y1uAQ2Hl5w53inVa8ueUuxfXL8CQeILz7mY53DNsNVgcjaef/21J1g+2BIulY0Qyb5 XQ8KCGwqqSYdTPuMQSh0+gFMtE3DJm1MzPrk8= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1778005497; x=1778610297; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:user-agent:mime-version:date:message-id :x-gm-gg:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=AiWl0VvmCcmAvKE7k/xTFIVAHM3vfW7H3kIFu8jks8Y=; b=TWHdW4M/to/JRt54zJolVz/newtJt779q1NsdMemUzdz19yUHRO4PXUdDtsMRf/r70 kxWb+swBn2lzHMC7bFKdqP1VeaiVyg1btJPlpkyQfiJvQpCyd6rcMhC7XW2zaae0JlhK KytYXlr92D8BOvDVKjpWMxoCAispAZDXg/wdC9Jro934z+3jybRn6V7OetjR2fsyKjRu /Kyf76h0EopGIyuaPtkuJ3iTj3X9nmpaF+XlvrelUwG6VRjANC/acHtxssFg8eFXlSWY gjipdx4ePplNl+ChIFYx22LkDKcwou5ZT9hoB6cccXQ8nRfiR4yJygtflKCJ4G67NHgC cpyg== X-Forwarded-Encrypted: i=1; AFNElJ856JLXYa2do4eLXpar4T0o7Ygneid4T6wVjC4+ZyGyVZOjWEslrlpMqK39nDcRJPiPnZ8LE7/8JfqY7LE=@vger.kernel.org X-Gm-Message-State: AOJu0YzUTCxCpufOIdQGrmUwrSl0h/KyVVGXMvPP2hutlt+15TJtV22r hBrFbbmnQ7dDvxDkocrV88EeYeccNl59o9KM0iYoiPrFS49mUEW3vc1sPOJXy8AmdCk= X-Gm-Gg: AeBDieuWqggNaw1058GSID4tHgNQ4RX0MM43lzmdJpxAg5uDfh+QEBIYRu1cGUbu62x LTsgbmq5pMxGLoEfR5Zf35kzB6GkmReoZpht6q1L1hSW++VRRH3ueseSuwUMkoSPZNVwLkXMOKe 3OXPzE84JAv5cJeg8zMniH3Z1T10kC1QewySLcA9BsxQZwZtv6Zj0QhZhhxoTpBaj0lk8DVN7eC 9LQPsPunnuisJJJtbykAujq/zesQHl76jMKq/GMN9+oH5JAseZ550XtBNAaOwk56tl3jjdJyhkI YCED+6sO8w/YqJJEPqT4C5zx5ElDK14EckTlsDYedC6MBoY7FpQhsC0SDhcWRQBqP5MYBzzwGCo sbhD0jNdXDpG6uOGJ32V8NV1kTQVAdVhFSnJgwqLZ1IaYkmUlAKlAHgbzqVJ16ewOav+F9//sbc 2HmnUQ7pT7tKRK/pQTBxg5L4vIfty9uv+5Nxdl36jKPQ== X-Received: by 2002:a05:6820:f011:b0:695:818c:e552 with SMTP id 006d021491bc7-6998da4cbc7mr2424572eaf.55.1778005496865; Tue, 05 May 2026 11:24:56 -0700 (PDT) Received: from [192.168.1.14] ([38.15.57.99]) by smtp.gmail.com with ESMTPSA id 006d021491bc7-69689708304sm8096324eaf.12.2026.05.05.11.24.56 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 05 May 2026 11:24:56 -0700 (PDT) Message-ID: <936f9719-9e24-47f3-9c68-080040a5d0e0@linuxfoundation.org> Date: Tue, 5 May 2026 12:24:55 -0600 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH 4/4] docs: admin-guide: add IGNORE_DIRS example for cscope To: Cheng-Han Wu , Jonathan Corbet Cc: Randy Dunlap , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Shuah Khan References: <20260503101429.254394-1-hank20010209@gmail.com> <20260503101429.254394-5-hank20010209@gmail.com> Content-Language: en-US From: Shuah Khan In-Reply-To: <20260503101429.254394-5-hank20010209@gmail.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit On 5/3/26 04:14, Cheng-Han Wu wrote: > The workload tracing guide shows how to build a cscope database by > running cscope command directly. The kernel build system also provides > a cscope target, which supports IGNORE_DIRS for excluding directories > from the generated database. > > Mention make cscope and show how to exclude Documentation/ as an example. > > Signed-off-by: Cheng-Han Wu > --- > Documentation/admin-guide/workload-tracing.rst | 9 +++++++++ > 1 file changed, 9 insertions(+) > > diff --git a/Documentation/admin-guide/workload-tracing.rst b/Documentation/admin-guide/workload-tracing.rst > index c49c2a00a8b8..314e5f03474e 100644 > --- a/Documentation/admin-guide/workload-tracing.rst > +++ b/Documentation/admin-guide/workload-tracing.rst > @@ -202,6 +202,15 @@ database. To get out of this mode press ctrl+d. -p option is used to > specify the number of file path components to display. -p10 is optimal > for browsing kernel sources. > > +Alternatively, the kernel build system can generate the cscope database:: > + > + make cscope > + > +To exclude directories from the generated database, pass IGNORE_DIRS to > +the cscope target. For example, to exclude Documentation/, run:: > + > + make IGNORE_DIRS="Documentation" cscope > + > What is perf and how do we use it? > ================================== > Looks good to me. Reviewed-by: Shuah Khan thanks, -- Shuah