Bug 284158 - [patch] Some special PIDs for kill(1) are missed in the man page.
Summary: [patch] Some special PIDs for kill(1) are missed in the man page.
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: freebsd-bugs (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2025-01-19 13:15 UTC by Artem Bunichev
Modified: 2025-01-21 00:30 UTC (History)
2 users (show)

See Also:

Attachments
Patch for kill.1 manual page. (1.55 KB, patch)
2025-01-19 13:15 UTC, Artem Bunichev 		no flags Details | Diff
View All Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Artem Bunichev 2025-01-19 13:15:41 UTC 
Created attachment 256799 [details]
Patch for kill.1 manual page.

According to the kill(2) manual page, there are three types of PID that have special meaning: 0, -1 and -<PGID>.

However, only 0 PID is actually mentioned in the kill(1) manual.

A patch that adds descriptions for rest special PIDs is attached.
Comment 1 commit-hook freebsd_committer freebsd_triage 2025-01-19 13:32:40 UTC 
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=d6c2d4fe975c70975bdc6bec76d044408f6dcb8c

commit d6c2d4fe975c70975bdc6bec76d044408f6dcb8c
Author:     artembunichev <artembunichev@zohomail.com>
AuthorDate: 2025-01-19 12:58:55 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2025-01-19 13:31:36 +0000

    kill.1: mention special meaning of PGID as a PID

    PR:      284158
    MFC after:      3 days

 bin/kill/kill.1 | 3 +++
 1 file changed, 3 insertions(+)
Comment 2 commit-hook freebsd_committer freebsd_triage 2025-01-19 13:32:41 UTC 
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=f5cf173de0dc62dbf47a8bbdcae28aac947d90a6

commit f5cf173de0dc62dbf47a8bbdcae28aac947d90a6
Author:     artembunichev <artembunichev@zohomail.com>
AuthorDate: 2025-01-19 12:49:14 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2025-01-19 13:29:27 +0000

    kill.1: mention special PID 0

    PR:      284158
    MFC after:      3 days

 bin/kill/kill.1 | 3 +++
 1 file changed, 3 insertions(+)
Comment 3 commit-hook freebsd_committer freebsd_triage 2025-01-21 00:27:40 UTC 
A commit in branch stable/14 references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=fe74df3f9db830194ba7b91d4d703dddee2a60c7

commit fe74df3f9db830194ba7b91d4d703dddee2a60c7
Author:     artembunichev <artembunichev@zohomail.com>
AuthorDate: 2025-01-19 12:58:55 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2025-01-21 00:25:59 +0000

    kill.1: mention special meaning of PGID as a PID

    PR:      284158

    (cherry picked from commit d6c2d4fe975c70975bdc6bec76d044408f6dcb8c)

 bin/kill/kill.1 | 3 +++
 1 file changed, 3 insertions(+)
Comment 4 commit-hook freebsd_committer freebsd_triage 2025-01-21 00:27:42 UTC 
A commit in branch stable/14 references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=2c0e00dc0147bdf3a6a84d0a16174aa521cbd262

commit 2c0e00dc0147bdf3a6a84d0a16174aa521cbd262
Author:     artembunichev <artembunichev@zohomail.com>
AuthorDate: 2025-01-19 12:49:14 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2025-01-21 00:25:59 +0000

    kill.1: mention special PID 0

    PR:      284158

    (cherry picked from commit f5cf173de0dc62dbf47a8bbdcae28aac947d90a6)

 bin/kill/kill.1 | 3 +++
 1 file changed, 3 insertions(+)