]> git.ipfire.org Git - thirdparty/util-linux.git/blobdiff - misc-utils/kill.1
lsblk: rename set_device()
[thirdparty/util-linux.git] / misc-utils / kill.1
index 1d7e765521e584178712def0a49e7cd2fbee2b47..24c32a24921fd4e99c9330b379f1402a861ed1a3 100644 (file)
@@ -31,19 +31,19 @@ an orderly fashion.
 If a process does not terminate after a TERM signal has been sent,
 then the KILL signal may be used; be aware that the latter signal
 cannot be caught, and so does not give the target process the opportunity
-to do perform any clean-up before terminating.
+to perform any clean-up before terminating.
 .PP
-Most modern shells have a builtin kill function, with a usage rather similar to
+Most modern shells have a builtin kill command, with a usage rather similar to
 that of the command described here.  The
 .BR \-\-all ,
 .BR \-\-pid ", and"
-.BR \-\-queue
+.B \-\-queue
 options, and the possibility to specify processes by command name, are local extensions.
 .PP
 If \fIsignal\fR is 0, then no actual signal is sent, but error checking is still performed.
 
 .SH ARGUMENTS
-The list of processes to be signaled can be a mixture of names and pids.
+The list of processes to be signaled can be a mixture of names and PIDs.
 .TP
 .I pid
 Each
@@ -54,7 +54,7 @@ can be one of four things:
 .I n
 where
 .I n
-is larger than 0.  The process with pid
+is larger than 0.  The process with PID
 .I n
 is signaled.
 .TP
@@ -62,7 +62,7 @@ is signaled.
 All processes in the current process group are signaled.
 .TP
 .B -1
-All processes with a pid larger than 1 are signaled.
+All processes with a PID larger than 1 are signaled.
 .TP
 .BI - n
 where
@@ -93,15 +93,15 @@ Similar to \fB\-l\fR, but it will print signal names and their corresponding
 numbers.
 .TP
 \fB\-a\fR, \fB\-\-all\fR
-Do not restrict the command-name-to-pid conversion to processes with the same
-uid as the present process.
+Do not restrict the command-name-to-PID conversion to processes with the same
+UID as the present process.
 .TP
 \fB\-p\fR, \fB\-\-pid\fR
-Only print the process id (pid) of the named processes, do not send any
+Only print the process ID (PID) of the named processes, do not send any
 signals.
 .TP
 \fB\-\-verbose\fR
-Print pid(s) that will be signaled with kill along with the signal.
+Print PID(s) that will be signaled with kill along with the signal.
 .TP
 \fB\-q\fR, \fB\-\-queue\fR \fIvalue\fR
 Use
@@ -111,10 +111,15 @@ rather than
 The
 .I value
 argument is an integer that is sent along with the signal.  If the
-receiving process has installed a handler for this signal using the SA_SIGINFO
+receiving process has installed a handler for this signal using the
+.B SA_SIGINFO
 flag to
 .BR sigaction (2),
-then it can obtain this data via the si_sigval field of the siginfo_t structure.
+then it can obtain this data via the
+.I si_sigval
+field of the
+.I siginfo_t
+structure.
 
 .SH NOTES
 Although it is possible to specify the TID (thread ID, see
@@ -130,7 +135,7 @@ in the target process that is not blocking the signal.
 For more details, see
 .BR signal (7)
 and the description of
-.BR CLONE_THREAD
+.B CLONE_THREAD
 in
 .BR clone (2).
 
@@ -138,13 +143,13 @@ in
 .B kill
 has the following return codes:
 .TP
-.BR 0
+.B 0
 success
 .TP
-.BR 1
+.B 1
 failure
 .TP
-.BR 64
+.B 64
 partial success (when more than one process specified)
 
 .SH SEE ALSO
@@ -169,6 +174,6 @@ The original version was taken from BSD 4.4.
 
 .SH AVAILABILITY
 The kill command is part of the util-linux package and is available from
-.UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
+.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
 Linux Kernel Archive
 .UE .