Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

For bugs related to Red Hat Enterprise Linux 4 product line. The current stable release is 4.9. For Red Hat Enterprise Linux 6 and above, please visit Red Hat JIRA https://issues.redhat.com/secure/CreateIssue!default.jspa?pid=12332745 to report new issues.

Bug 174835

Summary:	kill man/info documentation bugs
Product:	Red Hat Enterprise Linux 4	Reporter:	Steve Bonneville <sbonnevi>
Component:	util-linux	Assignee:	Karel Zak <kzak>
Status:	CLOSED NOTABUG	QA Contact:	Ben Levenson <benl>
Severity:	low	Docs Contact:
Priority:	medium
Version:	4.0
Target Milestone:	---
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2006-01-03 09:43:46 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Steve Bonneville 2005-12-02 16:56:13 UTC

Description of problem:

The man page and info pages for kill(1) list options that don't exist.

The man page claims there are -a and -p options to kill(1).

The info page claims there are -t/--table options which are synonyms for -l,
it also claims kill supports --help and --version which it does not.  However,
the info page for kill appears to come from the coreutils package, while the man
page for kill(1) appears to come from the util-linux package, as does the
version of /bin/kill that we ship.  (/usr/bin/kill is a symlink to /bin/kill).

Running /bin/kill without arguments displays the following usage message:

[user@foobar ~]$ kill
kill: usage: kill [-s sigspec | -n signum | -sigspec] [pid | job]... or kill -l
[sigspec]

Version-Release number of selected component (if applicable):

util-linux-2.12a-16.EL4-12
coreutils-5.2.1-31.2

Comment 1 Karel Zak 2006-01-03 09:42:54 UTC

There're two "kill" implementation. The man page kill(1) is correct, because
it's for /bin/kill.

the kill command from util-linux:

  $ /bin/kill
  usage: kill [ -s signal | -p ] [ -a ] pid ...
         kill -l [ signal ]

bash buil-in command:

  $ help kill
  kill: kill [-s sigspec | -n signum | -sigspec] [pid | job]... or kill -l  
[sigspec]

By the way, see kill(1) man page, there is note about it: "Most modern shells
have a builtin kill function..."