From: Christian Goeschel Ndjomouo Date: Thu, 9 Apr 2026 16:18:38 +0000 (-0400) Subject: kill: (man) improve PID:inode description X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=847d7ed8c040866ad10f07fce39694e2be33c1f2;p=thirdparty%2Futil-linux.git kill: (man) improve PID:inode description Signed-off-by: Christian Goeschel Ndjomouo --- diff --git a/misc-utils/kill.1.adoc b/misc-utils/kill.1.adoc index 6c5da13e0..05247c285 100644 --- a/misc-utils/kill.1.adoc +++ b/misc-utils/kill.1.adoc @@ -19,13 +19,13 @@ kill - terminate a process == SYNOPSIS -*kill* [**-**_signal_|*-s* _signal_|*-p*] [*-q* _value_] [*-a*] [*--timeout* _milliseconds_ _signal_] [*--*] _pid_|_pid_:_pidfd_inode_|_name_... +*kill* [**-**_signal_|*-s* _signal_|*-p*] [*-q* _value_] [*-a*] [*--timeout* _milliseconds_ _signal_] [*--*] _PID_[:_inode_]... -*kill* [**-**_signal_|*-s* _signal_] _pid_|_pid_:_pidfd_inode_... +*kill* [**-**_signal_|*-s* _signal_] _PID_[:_inode_]... *kill* *-l* [_number_|``0x``_sigmask_] | *-L* -*kill* *-d* _pid_ +*kill* *-d* _PID_[:_inode_] == DESCRIPTION @@ -41,8 +41,8 @@ If _signal_ is 0, then no actual signal is sent, but error checking is still per The list of processes to be signaled can be a mixture of names and PIDs. -_pid_:: -Each _pid_ can be expressed in one of the following ways: +_PID_:: +Each _PID_ can be expressed in one of the following ways: _n_;; where _n_ is larger than 0. The process with PID _n_ is signaled. *0*;; @@ -52,8 +52,9 @@ All processes with a PID larger than 1 are signaled. **-**__n__;; where _n_ is larger than 1. All processes in process group _n_ are signaled. When an argument of the form '-n' is given, and it is meant to denote a process group, either a signal must be specified first, or the argument must be preceded by a '--' option, otherwise it will be taken as the signal to send. -_pid_:_pidfd_inode_:: -A process can be referenced by its _pid_ plus _pidfd_inode_ (pid:pidfd_inode), to uniquely identify it and perform race-free signalling. This works only for the options -s, --signal and -_signal_. Requires kernel version 6.9 and later. +_PID_:_inode_:: +A process can be referenced with the format *PID:inode*, where the _inode_ uniquely identifies the process identity in the pidfs. This feature enables race-free process signalling and requires kernel version 6.9 or later. +Note that this only works for the option *--signal* and the *-_signal_* notation. Lastly, to retrieve a process's inode number you can use the *getino*(1) utility. _name_:: All processes invoked using this _name_ will be signaled. @@ -144,12 +145,13 @@ The original version was taken from BSD 4.4. *bash*(1), *tcsh*(1), +*getino*(1), *sigaction*(2), *kill*(2), *sigqueue*(3), -*signal*(7) -*proc(5)* -*proc_pid_status(5)* +*signal*(7), +*proc*(5), +*proc_pid_status*(5) include::man-common/bugreports.adoc[]