From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from relay.hostedemail.com (smtprelay0013.hostedemail.com [216.40.44.13]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id E57413A7E02; Tue, 20 Jan 2026 20:53:21 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=216.40.44.13 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768942403; cv=none; b=Kfi5JqcUGOzRcsjR79uGzwrtwxTDIBQkWycFz4hIyhNHyz7iIQTbgKMAUPrEojT74qoTTDROpG7JdznD8Y+aVpqIDVxkUn7XUM87bbwUZ4Cx7Seb9AcNX35A1rfQxBpQ/nnrYhJZu72++Bgc1TBHwfkH+pFIEmHzswB9qFDJZmM= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768942403; c=relaxed/simple; bh=uP8d0d+fxd33Q3HUTjKUKiAlyIbc/ltGWmJgzKq6RWk=; h=Date:From:To:Cc:Subject:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=Cw2JiJcIb3ubG1cIcvyW3nC3LXM0DZmuXAqN2+MCcxXVdbUoSBQ0ykPnV4AMfKkBwWtT4T0g2S14kwNNFutEATB+BHqMi6CdoBF5Y7rB83gN/VQqZJMDCHUlctnR68brQVLWYN/4ck7zpctL7w65YWPZJ3hu4yCnEjjPZU12B4k= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=goodmis.org; spf=pass smtp.mailfrom=goodmis.org; arc=none smtp.client-ip=216.40.44.13 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=goodmis.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=goodmis.org Received: from omf18.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id 9418B1A06CA; Tue, 20 Jan 2026 20:53:20 +0000 (UTC) Received: from [HIDDEN] (Authenticated sender: rostedt@goodmis.org) by omf18.hostedemail.com (Postfix) with ESMTPA id 6B8532F; Tue, 20 Jan 2026 20:53:18 +0000 (UTC) Date: Tue, 20 Jan 2026 15:53:40 -0500 From: Steven Rostedt To: "Seokwoo Chung (Ryan)" Cc: mhiramat@kernel.org, corbet@lwn.net, shuah@kernel.org, mathieu.desnoyers@efficios.com, linux-kernel@vger.kernel.org, linux-trace-kernel@vger.kernel.org, linux-doc@vger.kernel.org, linux-kselftest@vger.kernel.org Subject: Re: [PATCH v5 v5 1/3] docs: tracing/fprobe: Document list filters and :entry/:exit Message-ID: <20260120155340.2dac7fab@gandalf.local.home> In-Reply-To: <20260118011815.56516-2-seokwoo.chung130@gmail.com> References: <20260118011815.56516-1-seokwoo.chung130@gmail.com> <20260118011815.56516-2-seokwoo.chung130@gmail.com> X-Mailer: Claws Mail 3.20.0git84 (GTK+ 2.24.33; x86_64-pc-linux-gnu) Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-Rspamd-Server: rspamout07 X-Rspamd-Queue-Id: 6B8532F X-Stat-Signature: ixutpamsajw7cik16ciuqack4n9p8ko8 X-Session-Marker: 726F737465647440676F6F646D69732E6F7267 X-Session-ID: U2FsdGVkX1/zXRpA+Z28kL9/CYL7IFSM3d+dRjdipjE= X-HE-Tag: 1768942398-432765 X-HE-Meta: U2FsdGVkX1/1f9BFMU+kqLTPKr+Vsbi2VrbCBjzDnI0kdvIzCeCDOeIwhuFkjKJSp9b1zw5jVL2xl5wRf3mP91O954f1s3uDPKe5qOpKzGK/vpmPkdJwtXX+4f0hLZfd+TuvF8NgoGCNUy8SqlRKPdkLvQOKYzRZy/DEwyyBRcrzqirq9sHZzd+fE63SXhT0D4GLwB4Nz+VQ8XdtuLrVz3vbgHumVc4LjftkVSWgPZD00BT1c8ddogXraPNXoi6W+O4Md9W/37OqXwuI5scfg9+fkSwmik2uMpTCGw3i2RY1saXiwIOwZzkZmaGk/CINiaMlZsKLUWQS13PlK2anc/4uL+UT+EOt On Sat, 17 Jan 2026 20:18:13 -0500 "Seokwoo Chung (Ryan)" wrote: > Update fprobe event documentation to describe comma-separated symbol lists, > exclusions, and explicit suffixes. Usually, the documentation updates comes *after* the changes. -- Steve > > Signed-off-by: Seokwoo Chung (Ryan) > --- > Documentation/trace/fprobetrace.rst | 17 ++++++++++++++--- > 1 file changed, 14 insertions(+), 3 deletions(-) > > diff --git a/Documentation/trace/fprobetrace.rst b/Documentation/trace/fprobetrace.rst > index b4c2ca3d02c1..bbcfd57f0005 100644 > --- a/Documentation/trace/fprobetrace.rst > +++ b/Documentation/trace/fprobetrace.rst > @@ -25,14 +25,18 @@ Synopsis of fprobe-events > ------------------------- > :: > > - f[:[GRP1/][EVENT1]] SYM [FETCHARGS] : Probe on function entry > - f[MAXACTIVE][:[GRP1/][EVENT1]] SYM%return [FETCHARGS] : Probe on function exit > + f[:[GRP1/][EVENT1]] SYM[%return] [FETCHARGS] : Single function > + f[:[GRP1/][EVENT1]] SYM[,[!]SYM[,...]][:entry|:exit] [FETCHARGS] :Multiple > + function > t[:[GRP2/][EVENT2]] TRACEPOINT [FETCHARGS] : Probe on tracepoint > > GRP1 : Group name for fprobe. If omitted, use "fprobes" for it. > GRP2 : Group name for tprobe. If omitted, use "tracepoints" for it. > EVENT1 : Event name for fprobe. If omitted, the event name is > - "SYM__entry" or "SYM__exit". > + - For a single literal symbol, the event name is > + "SYM__entry" or "SYM__exit". > + - For a *list or any wildcard*, an explicit [GRP1/][EVENT1] is > + required; otherwise the parser rejects it. > EVENT2 : Event name for tprobe. If omitted, the event name is > the same as "TRACEPOINT", but if the "TRACEPOINT" starts > with a digit character, "_TRACEPOINT" is used. > @@ -40,6 +44,13 @@ Synopsis of fprobe-events > can be probed simultaneously, or 0 for the default value > as defined in Documentation/trace/fprobe.rst > > + SYM : Function name or comma-separated list of symbols. > + - SYM prefixed with "!" are exclusions. > + - ":entry" suffix means it probes entry of given symbols > + (default) > + - ":exit" suffix means it probes exit of given symbols. > + - "%return" suffix means it probes exit of SYM (single > + symbol). > FETCHARGS : Arguments. Each probe can have up to 128 args. > ARG : Fetch "ARG" function argument using BTF (only for function > entry or tracepoint.) (\*1)