src/usr.bin/pkill, branch main

pkill(1) first appeared in /usr/bin, but later it was moved to /bin

2008-08-31T14:27:59+00:00

for the convenience of rc.d.  Now it has happily lived there for quite
a while.  So move the pkill(1) source files from usr.bin to bin, too.

Approved by:	gad

Be more accurate in the description of the -I option:

2006-12-20T11:57:22+00:00

signaling to a process doesn't necessarily kill it.

Fix and extend the -j option to pkill/pgrep WRT the jail

2006-11-23T11:55:17+00:00

wildcard specifications.  Earlier the only wildcard syntax
was "-j 0" for "any jail".  There were at least
two shortcomings in it:  First, jail ID 0 was abused; it
meant "no jail" in other utils, e.g., ps(1).  Second, it
was impossible to match processed not in jail, which could
be useful to rc.d developers.  Therefore a new syntax is
introduced: "-j any" means any jail while "-j none" means
out of jail.  The old syntax is preserved for compatibility,
but now it's deprecated because it's limited and confusing.

Update the respective regression tests.  While I'm here,
make the tests more complex but sensitive:  Start several
processes, some in jail and some out of jail, so we can
detect that only the right processes are killed by pkill
or matched by pgrep.

Reviewed by:	gad, pjd
MFC after:	1 week

Tell in a comment that the symlinks from /usr/bin are

2006-08-20T04:25:20+00:00

for compatibility with other OS types, too.

Pointed out by:		gad

Install pkill(1), aka pgrep(1), to /bin so that rc scripts

2006-08-19T08:24:01+00:00

can use this small and nifty utility.  Create compatibility
symlinks from /usr/bin for the time being to avoid breaking
custom scripts relying on the hardcoded path to the utility.

If pkill(1) takes root, its source should be repocopied some
day to src/bin.

Idea by:	des
Discussed with:	brooks (in cvs-src and cvs-all)

-mdoc sweep.

2005-11-18T10:36:29+00:00

Sync as close as possible with NetBSD.

2005-11-16T11:03:00+00:00

This includes fixes and cleanups listed below:

- If a process dissappears while we are signalling it, don't count it as a
  match/error.
- Better handling of errors and messages.
- Downgrade failure to kill(2) (other than ESRCH) from fatal error to a
  warning; otherwise processing aborts and possibly matching killees would
  remain unsignalled. This makes pkill match the Solaris behavior.
- Exit with 2 on usage errors as documented.

Obtained from:	NetBSD
Glanced at by:	maintainer (gad) [a bit different version of this patch]

I often find myself doing:

2005-11-16T10:36:44+00:00

	% pgrep  [to verify which processes match]
	% pkill 

To speed such operation up, add -I option which works like rm(1)'s -i
option (unfortunately -i is already used in pkill(1)), ie. pkill will
ask for confirmation before killing each matching process.

After adding -j, -F, -i, -S, -o and -L options and other improvements,
I think I can add myself to the copyright header.

Glanced at by:	maintainer (gad)

Revert previous behaviour of '-F' option and add '-L' option, which will

2005-08-25T20:10:47+00:00

tell pkill(1)/pgrep(1) to try to flock(2) pidfile before reading PID from
there.

Discussed with:	jhb, gad

Modify '-F' option to work nicely with pidfile(3) - a pidfile given as

2005-08-24T19:38:28+00:00

an argument has to be locked.