NetBSD Problem Report #58056

From www@netbsd.org  Wed Mar 20 19:13:19 2024
Return-Path: <www@netbsd.org>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 64CB51A9239
	for <gnats-bugs@gnats.NetBSD.org>; Wed, 20 Mar 2024 19:13:19 +0000 (UTC)
Message-Id: <20240320191318.861941A923A@mollari.NetBSD.org>
Date: Wed, 20 Mar 2024 19:13:18 +0000 (UTC)
From: campbell+netbsd@mumble.net
Reply-To: campbell+netbsd@mumble.net
To: gnats-bugs@NetBSD.org
Subject: sysctl(9) man page missing CTLFLAG_ANYNUMBER and examples section
X-Send-Pr-Version: www-1.0

>Number:         58056
>Category:       kern
>Synopsis:       sysctl(9) man page missing CTLFLAG_ANYNUMBER and examples section
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    kern-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Mar 20 19:15:00 +0000 2024
>Originator:     Taylor R Campbell
>Release:        current
>Organization:
the.netbsd.foundation
>Environment:
>Description:
The CTLFLAG_ANYNUMBER is the magic way that sysctl proc.* works, but it's not obvious without digging into the guts of kern_sysctl.c sysctl_locate.  It should be documented.

Also there should be an EXAMPLES section in the man page to show some common example uses.  (And maybe we should have shorter idioms for some common examples.)
>How-To-Repeat:
man 9 sysctl
>Fix:
Yes, please!

Home	PR Database Search