/usr.bin/killall/killall.1

https://bitbucket.org/freebsd/freebsd-head/ · Unknown · 176 lines · 176 code · 0 blank · 0 comment · 0 complexity · f0cd9749c082cedb04787821258d52d6 MD5 · raw file

  1. .\" Copyright (C) 1995 by Joerg Wunsch, Dresden
  2. .\" All rights reserved.
  3. .\"
  4. .\" Redistribution and use in source and binary forms, with or without
  5. .\" modification, are permitted provided that the following conditions
  6. .\" are met:
  7. .\" 1. Redistributions of source code must retain the above copyright
  8. .\" notice, this list of conditions and the following disclaimer.
  9. .\" 2. Redistributions in binary form must reproduce the above copyright
  10. .\" notice, this list of conditions and the following disclaimer in the
  11. .\" documentation and/or other materials provided with the distribution.
  12. .\"
  13. .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY EXPRESS
  14. .\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  15. .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  16. .\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT,
  17. .\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  18. .\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  19. .\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  20. .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  21. .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
  22. .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  23. .\" POSSIBILITY OF SUCH DAMAGE.
  24. .\"
  25. .\" $FreeBSD$
  26. .\"
  27. .Dd June 27, 2012
  28. .Dt KILLALL 1
  29. .Os
  30. .Sh NAME
  31. .Nm killall
  32. .Nd kill processes by name
  33. .Sh SYNOPSIS
  34. .Nm
  35. .Op Fl delmsvz
  36. .Op Fl help
  37. .Op Fl I
  38. .Op Fl j Ar jail
  39. .Op Fl u Ar user
  40. .Op Fl t Ar tty
  41. .Op Fl c Ar procname
  42. .Op Fl Ar SIGNAL
  43. .Op Ar procname ...
  44. .Sh DESCRIPTION
  45. The
  46. .Nm
  47. utility kills processes selected by name, as opposed to the selection by PID
  48. as done by
  49. .Xr kill 1 .
  50. By default, it will send a
  51. .Dv TERM
  52. signal to all processes with a real UID identical to the
  53. caller of
  54. .Nm
  55. that match the name
  56. .Ar procname .
  57. The super-user is allowed to kill any process.
  58. .Pp
  59. The options are as follows:
  60. .Bl -tag -width ".Fl c Ar procname"
  61. .It Fl d | v
  62. Be more verbose about what will be done.
  63. For a single
  64. .Fl d
  65. option, a list of the processes that will be sent the signal will be
  66. printed, or a message indicating that no matching processes have been
  67. found.
  68. .It Fl e
  69. Use the effective user ID instead of the (default) real user ID for matching
  70. processes specified with the
  71. .Fl u
  72. option.
  73. .It Fl help
  74. Give a help on the command usage and exit.
  75. .It Fl I
  76. Request confirmation before attempting to signal each
  77. process.
  78. .It Fl l
  79. List the names of the available signals and exit, like in
  80. .Xr kill 1 .
  81. .It Fl m
  82. Match the argument
  83. .Ar procname
  84. as a (case sensitive) regular expression against the names
  85. of processes found.
  86. CAUTION!
  87. This is dangerous, a single dot will match any process
  88. running under the real UID of the caller.
  89. .It Fl s
  90. Show only what would be done, but do not send any signal.
  91. .It Fl Ar SIGNAL
  92. Send a different signal instead of the default
  93. .Dv TERM .
  94. The signal may be specified either as a name
  95. (with or without a leading
  96. .Dq Li SIG ) ,
  97. or numerically.
  98. .It Fl j Ar jail
  99. Kill processes in the specified
  100. .Ar jail .
  101. .It Fl u Ar user
  102. Limit potentially matching processes to those belonging to
  103. the specified
  104. .Ar user .
  105. .It Fl t Ar tty
  106. Limit potentially matching processes to those running on
  107. the specified
  108. .Ar tty .
  109. .It Fl c Ar procname
  110. Limit potentially matching processes to those matching
  111. the specified
  112. .Ar procname .
  113. .It Fl z
  114. Do not skip zombies.
  115. This should not have any effect except to print a few error messages
  116. if there are zombie processes that match the specified pattern.
  117. .El
  118. .Sh ALL PROCESSES
  119. Sending a signal to all processes with the given UID
  120. is already supported by
  121. .Xr kill 1 .
  122. So use
  123. .Xr kill 1
  124. for this job (e.g.\&
  125. .Dq Li "kill -TERM -1"
  126. or as root
  127. .Dq Li "echo kill -TERM -1 | su -m <user>" ) .
  128. .Sh IMPLEMENTATION NOTES
  129. This
  130. .Fx
  131. implementation of
  132. .Nm
  133. has completely different semantics as compared to the traditional
  134. .Ux
  135. System V behavior of
  136. .Nm .
  137. The latter will kill all processes that the current user is able to
  138. kill, and is intended to be used by the system shutdown process only.
  139. .Sh EXIT STATUS
  140. The
  141. .Nm
  142. utility exits 0 if some processes have been found and
  143. signalled successfully.
  144. Otherwise, a status of 1 will be
  145. returned.
  146. .Sh DIAGNOSTICS
  147. Diagnostic messages will only be printed if requested by
  148. .Fl d
  149. options.
  150. .Sh SEE ALSO
  151. .Xr kill 1 ,
  152. .Xr pkill 1 ,
  153. .Xr sysctl 3 ,
  154. .Xr jail 8
  155. .Sh HISTORY
  156. The
  157. .Nm
  158. command appeared in
  159. .Fx 2.1 .
  160. It has been modeled after the
  161. .Nm
  162. command as available on other platforms.
  163. .Sh AUTHORS
  164. .An -nosplit
  165. The
  166. .Nm
  167. program was originally written in Perl and was contributed by
  168. .An Wolfram Schneider ,
  169. this manual page has been written by
  170. .An J\(:org Wunsch .
  171. The current version of
  172. .Nm
  173. was rewritten in C by
  174. .An Peter Wemm
  175. using
  176. .Xr sysctl 3 .