From nobody Fri Dec 6 16:48:49 2024 X-Original-To: doc@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Y4cf96Y3qz5gX16 for ; Fri, 06 Dec 2024 16:48:49 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R10" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Y4cf95J1Qz4VgR for ; Fri, 6 Dec 2024 16:48:49 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1733503729; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=kZxHOmBPegJvtHYBaUqj0ibNYLlZvzJT6r4XYbLt5tg=; b=RI/reihQYYc0M0iVcd6oV52DAiRmV4PmWieyDIfTu5nr3WL7hsA59ZquH/9tTjlcCSa9sU by+adlgGj6pWwb8E8hcO9lRszDuWMPQtkuZe/GXgTMSkZyxKN85FwXIuQH6l+Ov9T8NRyU bZIb1qtLuPhAeNMe26muYURpmC0yFWa+/pVkpLgUFRHb1OryzC70S3P7uL4A/H9zdv7xbK c5hnj9JCvpIcl5hPqoWDL0uO6Wf57ki2fy/w2IOIiwUZY9FT9MyPx3j1PplCHvnzW5c+34 9M2yMofKp+BAHioF9kW9PABinAeFtY0G0TNiMhWUgKLFKGpmcvbxwt0O7L23HA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1733503729; a=rsa-sha256; cv=none; b=AH5M4iUIFLwhKYJiS4GU/T0z2m9vtwfmrp0WpL8oDDNz5u1ej+tRfQ5n5VLY8Du6KAKyes sFIz0MnN324pDDQs7TvTiCcNCbs16TC3zUZDEQbcFpvq0zgHxaOHxwh3e2t+uV4Bl8hgBy +7Ipr8A9qhlcTt/3mldDf59Aw6sqJojVyVbB671KOqg2S1AACc1yipXz6A+/gQOs1RrK8c AoUUF+P3EKclS/OY7wpPMmz3aGjxJNSIUc6SBAMdDK7ySAH29PHODPE9tjiitWbmC1CZTO wxqbHXnvLrx8HDL86ck7TKVmvvjDBSphDml+4Uldx33DL9Tob8kn20PlUBBCnw== Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Y4cf94mntzlXM for ; Fri, 6 Dec 2024 16:48:49 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 4B6Gmng0074587 for ; Fri, 6 Dec 2024 16:48:49 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from bugzilla@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 4B6GmnVJ074586 for doc@FreeBSD.org; Fri, 6 Dec 2024 16:48:49 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: bugzilla set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 283091] pfind(9) man page outdated Date: Fri, 06 Dec 2024 16:48:49 +0000 X-Bugzilla-Reason: CC X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Manual Pages X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Many People X-Bugzilla-Who: commit-hook@FreeBSD.org X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: imp@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: Message-ID: In-Reply-To: References: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@FreeBSD.org MIME-Version: 1.0 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D283091 --- Comment #3 from commit-hook@FreeBSD.org --- A commit in branch main references this bug: URL: https://cgit.FreeBSD.org/src/commit/?id=3D07d78399eb7994d45338f58a331dae9fb= 8fe1023 commit 07d78399eb7994d45338f58a331dae9fb8fe1023 Author: Yan-Hao Wang AuthorDate: 2024-12-06 16:23:35 +0000 Commit: Warner Losh CommitDate: 2024-12-06 16:47:31 +0000 pfind(9): Update to recent behavior The pfind(9) manual page in FreeBSD contains outdated content, such as references to zpfind() and the zombproc list, which have already been removed. Instead, there are new functions available for process search, as defined in sys/proc.h: 1. pfind_any(): Finds a process (including zombies) by its ID. 2, pfind_any_locked(): Finds a process by its ID like pfind but doesn't find 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. [[ imp fixed a few markup bugs, tweaked language a little ]] PR: 283091 Reviewed by: imp share/man/man9/pfind.9 | 49 +++++++++++++++++++++++++++-------------------= --- 1 file changed, 27 insertions(+), 22 deletions(-) --=20 You are receiving this mail because: You are on the CC list for the bug.=