Skip to contentSkip to conversation

proc.5: document 'subset' mount option.

PATCH Superseded [email protected] 3 participants 5 messages May 14, 2024 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

v2 of 3 Superseded Latest is v3 →

lore
Share & tools
lore
#0 lore raw

PATCH v2 1/1 proc.5: document 'subset' mount option.

From: Matteo Croce <[email protected]>

The 'subset=pid' option was added in commit 6814ef2d, document it.

---
 man/man5/proc.5 | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)
man/man5/proc.5 +6 -1
index 8022ca49e..2567387d3 100644
@@ -105,7 +105,12 @@ This group should be used instead of approaches such as putting
 nonroot users into the
 .BR sudoers (5)
 file.
-.\"
+.RE
+.TP
+.BR subset "=\fBpid\fP (since Linux 5.8)"
+.\" commit 6814ef2d992af09451bbeda4770daa204461329e
+Show only the specified subset of procfs hiding all top level files
+and directories in the procfs that are not related to tasks.
 .SS Overview
 Underneath
 .IR /proc ,
Signature · 1 line
2.43.0
#1 lore raw
Quoted 14 lines · On Tue, May 14, 2024 at 09:21:10PM GMT, [email protected] wrote:

From: Matteo Croce <[email protected]>

The 'subset=pid' option was added in commit 6814ef2d, document it.

---
 man/man5/proc.5 | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)
man/man5/proc.5 +0 -0
index 8022ca49e..2567387d3 100644

man/man5/proc.5 This group should be used instead of approaches such as putting · line 110

Quoted 7 lines
man/man5/proc.5 +3 -1
@@ -105,7 +105,12 @@ This group should be used instead of approaches such as putting
 nonroot users into the
 .BR sudoers (5)
 file.
-.\"
+.RE
+.TP
+.BR subset "=\fBpid\fP (since Linux 5.8)"

This can be simplified as:

.BR subset = pid " (since Linux 5.8)"

Quoted 9 lines
man/man5/proc.5 +3 -0
+.\" commit 6814ef2d992af09451bbeda4770daa204461329e
+Show only the specified subset of procfs hiding all top level files
+and directories in the procfs that are not related to tasks.
 .SS Overview
 Underneath
 .IR /proc ,
Signature · 1 line
2.43.0
Signature · 3 lines
<https://www.alejandro-colomar.es/>
A client is hiring kernel driver, mm, and/or crypto developers;
contact me if interested.
#2 lore raw

Hi Alex,

Quoted 5 lines · Alejandro Colomar
Quoted 1 line

+.BR subset "=\fBpid\fP (since Linux 5.8)"

This can be simplified as:

.BR subset = pid " (since Linux 5.8)"

It appears to me that all of the equals signs in mount options in this page should be bold. They are literal, after all...

So this would simplify further to:

.BR subset=pid " (since Linux 5.8)"

...which might look almost non-mystical to man(7) novices.

Regards,
Branden

#3 lore raw

Il giorno mar 14 mag 2024 alle ore 22:15 G. Branden Robinson <[email protected]> ha scritto:

Quoted 13 lines

Hi Alex,

Quoted 5 lines · Alejandro Colomar
Quoted 1 line

+.BR subset "=\fBpid\fP (since Linux 5.8)"

This can be simplified as:

.BR subset = pid " (since Linux 5.8)"

It appears to me that all of the equals signs in mount options in this page should be bold. They are literal, after all...

Quoted 8 lines

So this would simplify further to:

.BR subset=pid " (since Linux 5.8)"

...which might look almost non-mystical to man(7) novices.

Regards,
Branden

Could be, but that could be done all in once in a further refactor, I don't want to change the document style within this change.

Regards,

Signature · 3 lines
Matteo Croce

perl -e 'for($t=0;;$t++){print chr($t*($t>>8|$t>>13)&255)}' |aplay
#4 lore raw
Quoted 19 lines · Matteo Croce

Il giorno mar 14 mag 2024 alle ore 22:15 G. Branden Robinson <[email protected]> ha scritto:

Quoted 17 lines

Hi Alex,

Quoted 5 lines · Alejandro Colomar
Quoted 1 line

+.BR subset "=\fBpid\fP (since Linux 5.8)"

This can be simplified as:

.BR subset = pid " (since Linux 5.8)"

It appears to me that all of the equals signs in mount options in this page should be bold. They are literal, after all...

So this would simplify further to:

.BR subset=pid " (since Linux 5.8)"

Quoted 7 lines
Quoted 4 lines

...which might look almost non-mystical to man(7) novices.

Regards,
Branden

Could be, but that could be done all in once in a further refactor, I don't want to change the document style within this change.

Agree; a separate patch is better for that refactor.

And yep, the = is better as bold, since it's also literal.

Have a lovely night!
Alex

Signature · 3 lines
<https://www.alejandro-colomar.es/>
A client is hiring kernel driver, mm, and/or crypto developers;
contact me if interested.