From nobody Tue Dec 03 10:26:30 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 4Y2cJR0wwCz5fldy for ; Tue, 03 Dec 2024 10:26:31 +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 4Y2cJQ5njfz4h8Z for ; Tue, 3 Dec 2024 10:26:30 +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=1733221590; 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; bh=RtJ6M2N/3qtl10zVk8LUTtgCwd50mAIBsUAdOtNL65o=; b=Zxkuj3gZYacqyTvQHzsbYKKjhtsRRsEND7SzlnU8c7nPcVPgMHekKCD4ZZKESepBwsPE+z zRipyKtYILYUsnajLbKUpzxYSJ2JW428VHgGU2WP+6ASGIW6T5/oXL7ibDb0lu+IJNIanx EyDD4oQq6bve5QZhaIaWZo3kIFpIg1XWjCj5shU5duEwomyWLFsCviHoY69BLM6VtKiyUF DqEul8w7/lHCpGzE4G4fJxoJ6SQqwKWzQ2eb7mQfpDj3q/XV7KTI769yWRbFSdFTR/ElgM x/kaRsDMwEUxWYyYI3MBiKKDPM62MJSgsiLfw8rgLA38zGsA8a924iNh4cSGCA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1733221590; a=rsa-sha256; cv=none; b=F4KPS/hfW3Rev5w8ctRwGRpMINhgw3ojwOLbKaQ0rjHrRGZPxx4NdCJp7+ICFq6Rhkc2gu FmCQSn3xau38EwBOeA3CLN7HhAxrnOY+mtA7Ibdw7RWF37mF80X51Xb/YEkcLnUJ0TDnYV 5tk22JrSAhAYzwX14f7EUTB38D+KxIhIkl58V1xaBOejP27j+s53gdltmXtUz7YsblrBFi JY/Q058u5wrAQHFIoUonrwYUMxmW2vrsKYrBJsbnXAnqlOkhA67ht22hNIfvxZGkFcLKy7 YhZXJM05jcO4XZEI0ckmTRDexEn7YpMNrKPiDsHhVVfM/wxFivfNOtHszVU6ow== 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 4Y2cJQ50jzzJXv for ; Tue, 3 Dec 2024 10:26:30 +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 4B3AQU9P022311 for ; Tue, 3 Dec 2024 10:26:30 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 4B3AQUHf022310 for doc@FreeBSD.org; Tue, 3 Dec 2024 10:26:30 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www 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: Tue, 03 Dec 2024 10:26:30 +0000 X-Bugzilla-Reason: CC X-Bugzilla-Type: new 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: bses30074@gmail.com X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: bugs@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status bug_severity priority component assigned_to reporter cc attachments.created Message-ID: 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 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 on the CC list for the bug.=