From nobody Tue Dec 03 10:26:30 2024 X-Original-To: bugs@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 4Y2cJR0wmWz5fksY 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 4Y2cJQ5H86z4h1W 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=LMazbag7eS+0g23PKdRyl8etTdT/ngUWtxR96/ktAyU=; b=gkK5b2OcYH3F5JgQsxaRt5oAdC7cLaAsmR5sQVxHur47vGXS8/yzfH1nNAmpfaER3KRGtg 9cuQ3CFqJpfv+Qw1fmCiBryYLTcpTq2MjVPYJIwI6Y5Ff5VeH2FaVxcrQefvFDH8/AEnvD j5f/g9FgKWvA2xXYI/MZvXhlRgPZczFmuc/2ooTbZ9UGfc0+QvVNxrewthybpjXPLTUeg5 RfL0c4E/uvE5jCLHVmQ448rqOUguVp/3XEqq45rnUA5QSfUnJF+zC9W+8MEowwaqyu7kFh OwVlL49SJ6dgmJc747mgx1VV/Ni9b09gFHGWZ8h2qZjZ1u2quD3tpa5xU/YdZw== 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=hhiwoBOnHdAtpsS2UCAN2ElglToEImFZS/PCsCvbpbtd/zih4ZsNwxm7UDTwPAcZcD7KiK Kl/Fs4kISJ6vG6ddnUzNY5Q++JzhMjEjxtO7ud3A4k2EzG15vKjjAts/kf9h6dmD0t6sVP LzHZ8BkiuL36V8cX+qxad47oJo5DNQdUFJDGYjd6aV5Hb5tZMwDGbgF+YS9aM+OAn6TsZh fyxXOiDCYUtDP8U+OhhRaNI8IUtqxeB/44skqmFT+/C+p7UYCYfcJAgLObu9otEwWGO+3p bbOn6T1RxqQxGwyvlkx00IDzDkkhJhDbOXZ+qX+/gwi83DI6EmugHy1I/GpSmw== 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 4Y2cJQ4fPFzJsq 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 4B3AQUYT022307 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 4B3AQUF7022306 for bugs@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: bugs@FreeBSD.org Subject: [Bug 283091] pfind(9) man page outdated Date: Tue, 03 Dec 2024 10:26:30 +0000 X-Bugzilla-Reason: AssignedTo 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: Bug reports List-Archive: https://lists.freebsd.org/archives/freebsd-bugs List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-bugs@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 the assignee for the bug.=