On Sat, Jan 7, 2023 at 2:19 PM Nick Gregory <nick@xxxxxxxxxxxxxx> wrote: > > Bring in man page changes from the patch set by Colin Cross > <ccross@xxxxxxxxxx> [0], and document the corresponding virtual names in > procfs. Hi Nick, The content LGTM (not an expert in formatting). You even captured the recent addition of named shared anonymous mapping support (CC'ing Pasha)! Thanks for doing this! > > Signed-off-by: Nick Gregory <nick@xxxxxxxxxxxxxx> > Cc: Colin Cross <ccross@xxxxxxxxxx> > Cc: Suren Baghdasaryan <surenb@xxxxxxxxxx> > Cc: Kees Cook <keescook@xxxxxxxxxxxx> Reviewed-by: Suren Baghdasaryan <surenb@xxxxxxxxxx> > > [0] https://lore.kernel.org/linux-mm/20211019215511.3771969-2-surenb@xxxxxxxxxx/ > --- > man2/prctl.2 | 34 ++++++++++++++++++++++++++++++++++ > man5/proc.5 | 14 ++++++++++++++ > 2 files changed, 48 insertions(+) > > diff --git a/man2/prctl.2 b/man2/prctl.2 > index 74f86ff49..2c8d52ade 100644 > --- a/man2/prctl.2 > +++ b/man2/prctl.2 > @@ -769,6 +769,40 @@ This feature is available only if the kernel is built with the > .B CONFIG_CHECKPOINT_RESTORE > option enabled. > .RE > +.\" prctl PR_SET_VMA > +.TP > +.BR PR_SET_VMA " (since Linux 5.17)" > +.\" Commit 9a10064f5625d5572c3626c1516e0bebc6c9fe9b > +Sets an attribute specified in > +.I arg2 > +for virtual memory areas starting from the address specified in > +.I arg3 > +and spanning the size specified in > +.IR arg4 . > +.I arg5 > +specifies the value of the attribute to be set. > +.IP > +Note that assigning an attribute to a virtual memory area > +might prevent it from being merged with adjacent virtual memory areas > +due to the difference in that attribute's value. > +.IP > +Currently, > +.I arg2 > +must be one of: > +.RS > +.TP > +.B PR_SET_VMA_ANON_NAME > +Set a name for anonymous virtual memory areas. > +.I arg5 > +should be a pointer to a null-terminated string containing the name. > +The name length including null byte cannot exceed 80 bytes. > +If > +.I arg5 > +is NULL, the name of the appropriate anonymous virtual memory areas > +will be reset. > +The name can contain only printable ascii characters (including space), > +except \(aq[\(aq, \(aq]\(aq, \(aq\e\(aq, \(aq$\(aq, and \(aq\(ga\(aq. > +.RE > .\" prctl PR_MPX_ENABLE_MANAGEMENT > .TP > .BR PR_MPX_ENABLE_MANAGEMENT ", " PR_MPX_DISABLE_MANAGEMENT " (since Linux 3.19, removed in Linux 5.4; only on x86)" > diff --git a/man5/proc.5 b/man5/proc.5 > index 65a4c38e3..e0a64d486 100644 > --- a/man5/proc.5 > +++ b/man5/proc.5 > @@ -1372,6 +1372,20 @@ See > .TP > .I [heap] > The process's heap. > +.TP > +.IR [anon: name ] " (since Linux 5.17)" > +.\" Commit 9a10064f5625d5572c3626c1516e0bebc6c9fe9b > +A named private anonymous mapping. > +Set with > +.BR prctl (2) > +.BR PR_SET_VMA_ANON_NAME . > +.TP > +.IR [anon_shmem: name ] " (since Linux 6.2)" > +.\" Commit d09e8ca6cb93bb4b97517a18fbbf7eccb0e9ff43 > +A named shared anonymous mapping. > +Set with > +.BR prctl (2) > +.BR PR_SET_VMA_ANON_NAME . > .in > .RE > .IP > -- > 2.39.0 >
