[Bug 283091] pfind(9) man page outdated

From: <bugzilla-noreply_at_freebsd.org>
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.