[Bug 283091] pfind(9) man page outdated
- Reply: bugzilla-noreply_a_freebsd.org: "[Bug 283091] pfind(9) man page outdated"
- Reply: bugzilla-noreply_a_freebsd.org: "[Bug 283091] pfind(9) man page outdated"
- Reply: bugzilla-noreply_a_freebsd.org: "[Bug 283091] pfind(9) man page outdated"
- Reply: bugzilla-noreply_a_freebsd.org: "[Bug 283091] pfind(9) man page outdated"
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Tue, 03 Dec 2024 10:26:30 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=283091 Bug ID: 283091 Summary: pfind(9) man page outdated Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Severity: Affects Many People Priority: --- Component: Manual Pages Assignee: bugs@FreeBSD.org Reporter: bses30074@gmail.com CC: doc@FreeBSD.org Created attachment 255594 --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=255594&action=edit The patch The pfind(9) manual page in FreeBSD contains outdated content, such as references to zpfind() and the zombproc list, which have already been removed. Relevant commits include [2319489](https://github.com/freebsd/freebsd-src/commit/2319489b6e506645f996300db2d39861a1906357) (remove zpfind) and [88cc62e](https://github.com/freebsd/freebsd-src/commit/88cc62e5a53bb1b65416bd4a40e6b6c2981fcc38#diff-9d0eeaa1ed0362df667f09d9c453699a70544055a199038d03a68da9f8d9b39dR986) (remove zombproc). Instead, there are new functions available for process search, as defined in [sys/sys/proc.h#L1093](https://github.com/freebsd/freebsd-src/blob/4b4e88d9425b59a377a71ffeb553376b1c60a80e/sys/sys/proc.h#L1093): 1. pfind_any(): Finds a process (including zombies) by its ID. 2. pfind_any_locked(): Finds a process by its ID liek pfind but don’t lock the process hash bucket. It assert the process hash bucket is lock or not. In the current FreeBSD implementation, the allproc list is used, and the `p->p_state` field can determine whether a process is a zombie or not. I have attempted to revise the pfind(9) manual page as shown in my patch. However, since English is not my native language, the documentation team may need to refine my patch or not use it. My primary goal is to highlight the outdated content for correction. This patch addresses several versions greater than the 13.3 release. -- You are receiving this mail because: You are the assignee for the bug.