Received: by 2002:ab2:7855:0:b0:1f9:5764:f03e with SMTP id m21csp259124lqp; Wed, 22 May 2024 04:00:04 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCXub+cZH4JNSfQ2aoO8WPymXQk3HTr2Jhx6/X3St9OKY8zHKvMdrgEIDXOv+KITj0h1WbvTiQEejNpgPm3EYWIUUyvKQJlzLGVmJxjj3Q== X-Google-Smtp-Source: AGHT+IEpbdXXMmfhrwGRJH8FhhmPvPhpJ+3NkW55sf0ZYRZFTpYuAC1IxzUVeSOIFpyChYyz09hQ X-Received: by 2002:a25:aea5:0:b0:df4:e4a0:13a9 with SMTP id 3f1490d57ef6-df4e4a015d1mr1128445276.49.1716375603711; Wed, 22 May 2024 04:00:03 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1716375603; cv=pass; d=google.com; s=arc-20160816; b=DO+wT9Jb184PQ84X9VgFQngbj8AUM0xN6GoULAnXyzTJ7AbVCl//dCPIqyBGdrbL2e YqUCZ8eO4iEpP2mdHi0hBIsY7wvPbkBjXMXcBuVe4oK1SDBmhwP6X2cdmbHx+sxbkLxn r5yiyyJQKkfX7gJFhtNyRouYZMM7fhHUWvfs/BJW41bVkwgOpTlYFFyrMGv7+4zdITgm g/HEhXiYlSxM2ZOYZFMQR1PYpYHKrznFHropDOhjqoi0GzBoVCNQjlCArYISSblSa7M1 nyHA7NL8Cn9VSiMhel9cnNjIwWxobvksdSbo8k2bd//Bf5w8JOy3QZBmuJNjOXh2U4gi ESGw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=in-reply-to:content-disposition:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:references:message-id:subject:cc :to:from:date:dkim-signature; bh=sx3uKwz5RrZJcbBa/yQlWx+FRVyvnYImHESgBy+3ONE=; fh=3HI+uA/z0fqdUfxaJ4b1Z9rppp55NzG29ZN0f4GHe9M=; b=Tx9o6XpLvcInG3Cr543p+Cz/4+0D4jZT6zDanLXHDgDnk3hO4ryrCX2hlmvAYSEHTS XcAVKjAIqvZEUWuNIOqvi/ektUsh99Z3oFstL8M7d9NDfAelGmAq/ogcCPc5SfX3KlPM rzMZyXldaeH+2jarbBF/ENfYaHjMmTpuvi1B1FW02dqSfO+0gTqLdSAGAvd1mY/wA5NC x2PFm2rjjMrGmzEtuukJqvmch3BJDrrYJ7s5xEXD/6AqN2bUIXYRWVTE7ilnvO6zWB31 aUU6uheyWUAaCZ5ZaHMaBfTTk/0c0YRGSmAeDdE/JjGNg4vdlSFNkj9zGsqF/sB8pI4b S3/Q==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=rfCayVRX; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-186091-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-186091-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [147.75.199.223]) by mx.google.com with ESMTPS id d75a77b69052e-43df549ca44si37993051cf.15.2024.05.22.04.00.03 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 22 May 2024 04:00:03 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-186091-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=rfCayVRX; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-186091-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-186091-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ny.mirrors.kernel.org (Postfix) with ESMTPS id 257BF1C21E5F for ; Wed, 22 May 2024 11:00:03 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id D9218824AE; Wed, 22 May 2024 10:59:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="rfCayVRX" Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (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 D681C811FB; Wed, 22 May 2024 10:59:52 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1716375593; cv=none; b=XddNN+Ib6sgLfkobDkNEGrn8PRhoweRmhGIaRL6X75SzdWWzjZbI4jx3qWjY0AOqY6K1NxutHSKhx+lly+K/K5+tRhRVLj5qBJu1LNLUgzgbwBUJIbloKWP2hdaVlbY5oqt1u4OG0vYGQrQmasmTYR9YiyrL+qlAuydVPK/QL/s= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1716375593; c=relaxed/simple; bh=XaYc48nWQB8aUx5U/Gx056TfLX/HyLCwVB+Go/sd0LU=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=Ms318d4mQ/ElncX/FXSGoHpFJfQe6Aol8BzDQNCea2D474jC7K8DrL7ugpX4oK/UL/DEv7G+OOuL8bEUqifIaeuLmHB+cc43vX5B5GSzouYt8iBJSjUPyLpIEmrMkd40Dqu7qpgB7im1HXNzVW+41GJI4ypoQYTiUJ4Gd69WGQo= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=rfCayVRX; arc=none smtp.client-ip=10.30.226.201 Received: by smtp.kernel.org (Postfix) with ESMTPSA id 44C89C2BD11; Wed, 22 May 2024 10:59:48 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1716375592; bh=XaYc48nWQB8aUx5U/Gx056TfLX/HyLCwVB+Go/sd0LU=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=rfCayVRXLu7f1ARZtR4PKS7x50GnD3g4npuB1isGy4VpvuQyXQk+E4kkFKZESF42S cwkfrPSlpZvX8oQEDMDqZwzs1wPgQo1RbXKXCRTvKhMPATgKhYNgBopZYq1C5DcQZT 6uWb2Kqova43fqDiJ2MVj9Chw+M/Lm1r2hTWGB6KmhN9JgRnf817QWWtIuh0/VEMlq +O4xTxeJDugSw46UEwtdmrPdAGII9yuub6sGt6+rrspIIqIkIXZS+zcqoPU63g1BIg K6bKhfvN4Ujuc8fGNoTpbLgmRrHSFrT/MDvj8ZGvODJwcvkT/GGGHZAdweUj+TXV5j YvMM1ZveMv+pQ== Date: Wed, 22 May 2024 12:59:46 +0200 From: Alejandro Colomar To: Jiri Olsa Cc: Steven Rostedt , Masami Hiramatsu , Oleg Nesterov , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , linux-kernel@vger.kernel.org, linux-trace-kernel@vger.kernel.org, linux-api@vger.kernel.org, linux-man@vger.kernel.org, x86@kernel.org, bpf@vger.kernel.org, Song Liu , Yonghong Song , John Fastabend , Peter Zijlstra , Thomas Gleixner , "Borislav Petkov (AMD)" , Ingo Molnar , Andy Lutomirski , "Edgecombe, Rick P" , Deepak Gupta Subject: Re: [PATCHv6 9/9] man2: Add uretprobe syscall page Message-ID: References: <20240521104825.1060966-1-jolsa@kernel.org> <20240521104825.1060966-10-jolsa@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="q46npir5oijusqfi" Content-Disposition: inline In-Reply-To: --q46npir5oijusqfi Content-Type: text/plain; protected-headers=v1; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable From: Alejandro Colomar To: Jiri Olsa Cc: Steven Rostedt , Masami Hiramatsu , Oleg Nesterov , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , linux-kernel@vger.kernel.org, linux-trace-kernel@vger.kernel.org, linux-api@vger.kernel.org, linux-man@vger.kernel.org, x86@kernel.org, bpf@vger.kernel.org, Song Liu , Yonghong Song , John Fastabend , Peter Zijlstra , Thomas Gleixner , "Borislav Petkov (AMD)" , Ingo Molnar , Andy Lutomirski , "Edgecombe, Rick P" , Deepak Gupta Subject: Re: [PATCHv6 9/9] man2: Add uretprobe syscall page References: <20240521104825.1060966-1-jolsa@kernel.org> <20240521104825.1060966-10-jolsa@kernel.org> MIME-Version: 1.0 In-Reply-To: Hi Jirka, On Wed, May 22, 2024 at 09:54:58AM GMT, Jiri Olsa wrote: > ok, thanks >=20 > jirka >=20 >=20 > --- > diff --git a/man/man2/uretprobe.2 b/man/man2/uretprobe.2 > new file mode 100644 > index 000000000000..5b5f340b59b6 > --- /dev/null > +++ b/man/man2/uretprobe.2 > @@ -0,0 +1,56 @@ > +.\" Copyright (C) 2024, Jiri Olsa > +.\" > +.\" SPDX-License-Identifier: Linux-man-pages-copyleft > +.\" > +.TH uretprobe 2 (date) "Linux man-pages (unreleased)" > +.SH NAME > +uretprobe \- execute pending return uprobes > +.SH SYNOPSIS > +.nf > +.B int uretprobe(void) > +.fi > +.SH DESCRIPTION > +The > +.BR uretprobe () > +system call is an alternative to breakpoint instructions for triggering = return > +uprobe consumers. > +.P > +Calls to > +.BR uretprobe () > +system call are only made from the user-space trampoline provided by the= kernel. > +Calls from any other place result in a > +.BR SIGILL . > +.SH RETURN VALUE > +The > +.BR uretprobe () > +system call return value is architecture-specific. > +.SH ERRORS > +.TP > +.B SIGILL > +The > +.BR uretprobe () > +system call was called by user. Maybe 'a user-space program'? Anyway, LGTM. Thanks! Reviewed-by: Alejandro Colomar Have a lovely day! Alex > +.SH VERSIONS > +Details of the > +.BR uretprobe () > +system call behavior vary across systems. > +.SH STANDARDS > +None. > +.SH HISTORY > +TBD > +.SH NOTES > +The > +.BR uretprobe () > +system call was initially introduced for the x86_64 architecture > +where it was shown to be faster than breakpoint traps. > +It might be extended to other architectures. > +.P > +The > +.BR uretprobe () > +system call exists only to allow the invocation of return uprobe consume= rs. > +It should > +.B never > +be called directly. > +Details of the arguments (if any) passed to > +.BR uretprobe () > +and the return value are architecture-specific. --=20 --q46npir5oijusqfi Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCgAdFiEE6jqH8KTroDDkXfJAnowa+77/2zIFAmZN0BwACgkQnowa+77/ 2zK38w/9FtV+ULMKrpnQryO/Z1ZIRX+42KpBbiPHaiHHSyuos+4ywVOTOXGd26C2 a/u972Scjw0DfwezA/t7sRKALOzBHD2L2+Y3U6HfD9AlEWQ2PY8AfcMB260c46jf opjOZRsBLQMtcJY6RBzXNH7eiACs5XO+IpD7BCj8EJ+HbLD53Ogk722A6C4kcD8o N4id9bgR9Z4RG28TFkP+rsq+LmQqTrWDkdHzC6cd+CLnu4wb7wszCiuTubRzBfsw Mm85aU3fCl9BKaKJCblneLhB4/FU1VkDIFscx//fT8VIEUKPh3Pepv0HFVyHrpFP 8hsUo/DyhJyfWllz0ubmmf9VODKoMHtVYP4HGl/JVPYGdhHc+YCjUsV/IaIUnElC XOpCQHsN6GDYboebdCb+QhiD0CsVlhiTzAz1jbeJA/eY76sW4z44I5PQAouICbI5 G8W4xjDa2SVqJVlzGmfdnfOote6pzyvep++igKI06UYPT8LJ2pRDRQZ1/DFLQWc5 tnwu3XlQCRG7lSMKi9qPI7AEOvmnxilnYPhVXrvnjjYMwHVs36n8efsBB16K62hv nDjVWWoV6FxDdQjsYI9kSfB4zTrERIQzP0H64xqr4f6pgtZVnmkNPU+c84QMhv6E UWiI7K5BeWmloEQ8uuyqW4RLwCWF3891HxXTH6baw3WdpFYsdpU= =uEkW -----END PGP SIGNATURE----- --q46npir5oijusqfi--