[PATCH 0/4] proc.5: Fixes and updates

[PATCH 0/4] proc.5: Fixes and updates

[Guillem Jover]

Hi!

Had these old changes laying around for a long time, which I've now
refreshed and I'm sending out.

Thanks,
Guillem

Guillem Jover (4):
  proc.5: Document exact /proc/PID/exe behavior on unlinked pathnames
  proc.5: A process can increase its own /proc/PID/oom_adj setting
  proc.5: Document that /proc/<pid>/oom_adj is no longer present
  proc.5: tfix

 man5/proc.5 | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

-- 
2.40.0

[PATCH 1/4] proc.5: Document exact /proc/PID/exe behavior on unlinked pathnames

[Guillem Jover]

Add the space which gets appended before the "(deleted)" marker.

Signed-off-by: Guillem Jover <guillem@hadrons.org>
---
 man5/proc.5 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man5/proc.5 b/man5/proc.5
index dc5397a22..1947957ad 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -634,7 +634,7 @@ to run another copy of the same executable that is being run by
 process
 .IR pid .
 If the pathname has been unlinked, the symbolic link will contain the
-string \[aq](deleted)\[aq] appended to the original pathname.
+string \[aq] (deleted)\[aq] appended to the original pathname.
 .\" The following was still true as at kernel 2.6.13
 In a multithreaded process, the contents of this symbolic link
 are not available if the main thread has already terminated
-- 
2.40.0

[PATCH 2/4] proc.5: A process can increase its own /proc/PID/oom_adj setting

[Guillem Jover]

See kernel commit 8fb4fc68ca391862b061b3d358a288ccf6abed39.

Signed-off-by: Guillem Jover <guillem@hadrons.org>
---
 man5/proc.5 | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/man5/proc.5 b/man5/proc.5
index 1947957ad..4bb7dd262 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -1633,7 +1633,11 @@ a new process inherits its parent's
 setting.
 A process must be privileged
 .RB ( CAP_SYS_RESOURCE )
-to update this file.
+to update this file,
+.\" commit 8fb4fc68ca391862b061b3d358a288ccf6abed39
+although a process can always increase its own
+.I oom_adj
+setting (since 2.6.20).
 .IP
 Since Linux 2.6.36, use of this file is deprecated in favor of
 .IR /proc/ pid /oom_score_adj .
-- 
2.40.0

[PATCH 3/4] proc.5: Document that /proc/<pid>/oom_adj is no longer present

[Guillem Jover]

Signed-off-by: Guillem Jover <guillem@hadrons.org>
---
 man5/proc.5 | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/man5/proc.5 b/man5/proc.5
index 4bb7dd262..a3b5ffc7b 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -1640,7 +1640,9 @@ although a process can always increase its own
 setting (since 2.6.20).
 .IP
 Since Linux 2.6.36, use of this file is deprecated in favor of
-.IR /proc/ pid /oom_score_adj .
+.IR /proc/ pid /oom_score_adj ,
+.\" commit 01dc52ebdf472f77cca623ca693ca24cfc0f1bbe
+and finally removed in Linux 3.7.
 .TP
 .IR /proc/ pid /oom_score " (since Linux 2.6.11)"
 .\" See mm/oom_kill.c::badness() before Linux 2.6.36 sources
-- 
2.40.0

[PATCH 4/4] proc.5: tfix

[Guillem Jover]

Use Ctrl-Alt-Del instead of ctrl-alt-del, as used in all other
instances.

Signed-off-by: Guillem Jover <guillem@hadrons.org>
---
 man5/proc.5 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man5/proc.5 b/man5/proc.5
index a3b5ffc7b..535bbc61b 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -5001,7 +5001,7 @@ When the value is greater than zero, Linux's reaction to a Vulcan
 Nerve Pinch (tm) will be an immediate reboot, without even
 syncing its dirty buffers.
 Note: when a program (like dosemu) has the keyboard in "raw"
-mode, the ctrl-alt-del is intercepted by the program before it
+mode, the Ctrl-Alt-Del is intercepted by the program before it
 ever reaches the kernel tty layer, and it's up to the program
 to decide what to do with it.
 .TP
-- 
2.40.0

Re: [PATCH 1/4] proc.5: Document exact /proc/PID/exe behavior on unlinked pathnames

[Alejandro Colomar]

[-- Attachment #1.1: Type: text/plain, Size: 1085 bytes --]

Hi Guillem,

On 4/17/23 01:35, Guillem Jover wrote:
> Add the space which gets appended before the "(deleted)" marker.
> 
> Signed-off-by: Guillem Jover <guillem@hadrons.org>

Patch applied.

> ---
>  man5/proc.5 | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/man5/proc.5 b/man5/proc.5
> index dc5397a22..1947957ad 100644
> --- a/man5/proc.5
> +++ b/man5/proc.5
> @@ -634,7 +634,7 @@ to run another copy of the same executable that is being run by
>  process
>  .IR pid .
>  If the pathname has been unlinked, the symbolic link will contain the
> -string \[aq](deleted)\[aq] appended to the original pathname.
> +string \[aq] (deleted)\[aq] appended to the original pathname.

I used the unbreakable space instead: '\ '

Cheers,
Alex

>  .\" The following was still true as at kernel 2.6.13
>  In a multithreaded process, the contents of this symbolic link
>  are not available if the main thread has already terminated

-- 
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH 2/4] proc.5: A process can increase its own /proc/PID/oom_adj setting

[Alejandro Colomar]

[-- Attachment #1.1: Type: text/plain, Size: 1035 bytes --]

Hi Guillem,

On 4/17/23 01:35, Guillem Jover wrote:
> See kernel commit 8fb4fc68ca391862b061b3d358a288ccf6abed39.
> 
> Signed-off-by: Guillem Jover <guillem@hadrons.org>

Patch applied.

> ---
>  man5/proc.5 | 6 +++++-
>  1 file changed, 5 insertions(+), 1 deletion(-)
> 
> diff --git a/man5/proc.5 b/man5/proc.5
> index 1947957ad..4bb7dd262 100644
> --- a/man5/proc.5
> +++ b/man5/proc.5
> @@ -1633,7 +1633,11 @@ a new process inherits its parent's
>  setting.
>  A process must be privileged
>  .RB ( CAP_SYS_RESOURCE )
> -to update this file.
> +to update this file,
> +.\" commit 8fb4fc68ca391862b061b3d358a288ccf6abed39
> +although a process can always increase its own
> +.I oom_adj
> +setting (since 2.6.20).

I specified "(since Linux 2.6.20)", for consistency.

Cheers,
Alex

>  .IP
>  Since Linux 2.6.36, use of this file is deprecated in favor of
>  .IR /proc/ pid /oom_score_adj .

-- 
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH 3/4] proc.5: Document that /proc/<pid>/oom_adj is no longer present

[Alejandro Colomar]

[-- Attachment #1.1: Type: text/plain, Size: 1124 bytes --]

Hi Guillem,

On 4/17/23 01:35, Guillem Jover wrote:
> Signed-off-by: Guillem Jover <guillem@hadrons.org>

Patch applied.  BTW, changes the subject to PID for consistency with
your other patches.

> ---
>  man5/proc.5 | 4 +++-
>  1 file changed, 3 insertions(+), 1 deletion(-)
> 
> diff --git a/man5/proc.5 b/man5/proc.5
> index 4bb7dd262..a3b5ffc7b 100644
> --- a/man5/proc.5
> +++ b/man5/proc.5
> @@ -1640,7 +1640,9 @@ although a process can always increase its own
>  setting (since 2.6.20).
>  .IP
>  Since Linux 2.6.36, use of this file is deprecated in favor of
> -.IR /proc/ pid /oom_score_adj .
> +.IR /proc/ pid /oom_score_adj ,
> +.\" commit 01dc52ebdf472f77cca623ca693ca24cfc0f1bbe

And moved this to the commit message, since I don't want to pollute
the source code for such an antique reference.

Cheers,
Alex

> +and finally removed in Linux 3.7.
>  .TP
>  .IR /proc/ pid /oom_score " (since Linux 2.6.11)"
>  .\" See mm/oom_kill.c::badness() before Linux 2.6.36 sources

-- 
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH 4/4] proc.5: tfix

[Alejandro Colomar]

[-- Attachment #1.1: Type: text/plain, Size: 1041 bytes --]

Hi Guillem,

On 4/17/23 01:35, Guillem Jover wrote:
> Use Ctrl-Alt-Del instead of ctrl-alt-del, as used in all other
> instances.
> 
> Signed-off-by: Guillem Jover <guillem@hadrons.org>

Patch applied; thanks!

Cheers,
Alex

> ---
>  man5/proc.5 | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/man5/proc.5 b/man5/proc.5
> index a3b5ffc7b..535bbc61b 100644
> --- a/man5/proc.5
> +++ b/man5/proc.5
> @@ -5001,7 +5001,7 @@ When the value is greater than zero, Linux's reaction to a Vulcan
>  Nerve Pinch (tm) will be an immediate reboot, without even
>  syncing its dirty buffers.
>  Note: when a program (like dosemu) has the keyboard in "raw"
> -mode, the ctrl-alt-del is intercepted by the program before it
> +mode, the Ctrl-Alt-Del is intercepted by the program before it
>  ever reaches the kernel tty layer, and it's up to the program
>  to decide what to do with it.
>  .TP

-- 
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]