Date: Tue, 03 Dec 2024 10:26:30 +0000 From: bugzilla-noreply@freebsd.org To: bugs@FreeBSD.org Subject: [Bug 283091] pfind(9) man page outdated Message-ID: <bug-283091-227@https.bugs.freebsd.org/bugzilla/>
next in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D283091 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=3D255594&action= =3Dedit 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 remov= ed. Relevant commits include [2319489](https://github.com/freebsd/freebsd-src/commit/2319489b6e506645f99= 6300db2d39861a1906357) (remove zpfind) and [88cc62e](https://github.com/freebsd/freebsd-src/commit/88cc62e5a53bb1b6541= 6bd4a40e6b6c2981fcc38#diff-9d0eeaa1ed0362df667f09d9c453699a70544055a199038d= 03a68da9f8d9b39dR986) (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/4b4e88d9= 425b59a377a71ffeb553376b1c60a80e/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=E2=80= =99t 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. --=20 You are receiving this mail because: You are the assignee for the bug.=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-283091-227>