77 lines
2.1 KiB
Plaintext
77 lines
2.1 KiB
Plaintext
$OpenBSD: patch-pkill_pkill_1,v 1.2 2003/03/28 22:11:24 david Exp $
|
|
Document the -V flag.
|
|
Document return values.
|
|
Added NOTES section.
|
|
--- pkill/pkill.1.orig Tue May 22 10:17:30 2001
|
|
+++ pkill/pkill.1 Mon Jan 6 23:07:49 2003
|
|
@@ -25,7 +25,7 @@
|
|
.\"OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
|
|
.\"USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
.\"
|
|
-.Dd May 21, 2001
|
|
+.Dd January 6, 2003
|
|
.Dt PKILL 1
|
|
.Os
|
|
.Sh NAME
|
|
@@ -34,7 +34,7 @@
|
|
.Sh SYNOPSIS
|
|
.Nm pkill
|
|
.Op Fl signal
|
|
-.Op Fl fnvx
|
|
+.Op Fl fnvVx
|
|
.Op Fl g Ar pgrplist
|
|
.Op Fl G Ar gidlist
|
|
.Op Fl P Ar ppidlist
|
|
@@ -103,6 +103,13 @@ usernames and as numeric user IDs.
|
|
.It Fl v
|
|
Invert the matching algorithm to print information about process that do not
|
|
match the given arguments.
|
|
+.It Fl V
|
|
+Invert the matching algorithm to print information about process that do not
|
|
+match the given flags but DO match the given pattern. Has no effect if only
|
|
+a pattern is given (the pattern will be matched as normal). Overrides
|
|
+.Fl v
|
|
+if it is also given.
|
|
+(OpenBSD extension.)
|
|
.It Fl x
|
|
Make the pattern match be an exact match instead of a regular expression.
|
|
.El
|
|
@@ -126,10 +133,26 @@ Sends signal 9 (SIGKILL) to all shells w
|
|
.Xr pgrep 1 ,
|
|
.Xr ps 1 ,
|
|
.Xr regex 3
|
|
+.Sh RETURN VALUES
|
|
+The
|
|
+.Nm
|
|
+utility exits with one of the following values:
|
|
+.Bl -tag -width Ds
|
|
+.It 0
|
|
+One or more processes were matched.
|
|
+.It 1
|
|
+No processes were matched.
|
|
+.It 64 (EX_USAGE)
|
|
+Invalid command-line options were specified.
|
|
+.El
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
command first appeared in Sun Solaris 7.
|
|
+.Pp
|
|
+The
|
|
+.Fl V
|
|
+flag first appeared in the OpenBSD 3.3 ports tree.
|
|
.Sh BUGS
|
|
The original Solaris pkill could also match against session ID, but OpenBSD's
|
|
session ID can fail to exist if the session leader exits.
|
|
@@ -139,5 +162,8 @@ Also, the original Solaris version had o
|
|
option to specify what signal to send. This version can also use the
|
|
.Fl s Ar signal
|
|
option, which subsumes the session ID match listed above.
|
|
-.Pp
|
|
-It is possible for pkill to kill itself.
|
|
+.Sh NOTES
|
|
+The current
|
|
+.Nm
|
|
+process will never consider itself a potential match.
|
|
+
|