Re: [PATCH v2] prctl.2, proc.5: Document VMA naming

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Tue, Jan 10, 2023 at 1:12 PM Alejandro Colomar
<alx.manpages@xxxxxxxxx> wrote:
>
> Hi Nick and Suren!
>
> On 1/10/23 22:02, Suren Baghdasaryan wrote:
> > 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).
>
> The formatting is perfect, AFAICS. :)
>
> > You even captured the
> > recent addition of named shared anonymous mapping support (CC'ing
> > Pasha)! Thanks for doing this!
>
> Do you want me to wait for him to have a look, or should I just apply?

I CC'ed Pasha as FYI. I don't think he will have any objections.
Thanks for checking!

>
> >
> >>
> >> 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>
>
> Thanks for the patch and the review!
>
> Cheers,
>
> Alex
>
> >
> >>
> >> [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
> >>
>
> --
> <http://www.alejandro-colomar.es/>



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux