Bug 257984 - pthread_create(3) refers to racct(2) which does not exist
Summary: pthread_create(3) refers to racct(2) which does not exist
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: Eric van Gyzen
URL:
Keywords: easy
Depends on:
Blocks:
 
Reported: 2021-08-21 13:14 UTC by Karlo Miličević
Modified: 2026-08-14 21:55 UTC (History)
3 users (show)

See Also:


Attachments
pthread_create(3) patch (617 bytes, patch)
2021-09-20 00:11 UTC, Felix Johnson
no flags Details | Diff
thr_new(2) patch (626 bytes, patch)
2021-09-20 00:12 UTC, Felix Johnson
no flags Details | Diff
Document rctl(4) sysctls (1.44 KB, patch)
2021-09-20 00:12 UTC, Felix Johnson
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Karlo Miličević 2021-08-21 13:14:34 UTC
In 'man 3 pthread_create' under section 'SEE ALSO' racct(2) page is referred to but it does not exist.

The problem also exists on the web version: https://www.freebsd.org/cgi/man.cgi?pthread_create
Comment 1 Felix Johnson 2021-09-20 00:11:04 UTC
Created attachment 228025 [details]
pthread_create(3) patch

Change reference from racct(2) to rctl(8). There is no racct(2) man page.
Comment 2 Felix Johnson 2021-09-20 00:12:00 UTC
Created attachment 228026 [details]
thr_new(2) patch

Replace references to racct(2) with rctl(8). There is no racct(2) man page.
Comment 3 Felix Johnson 2021-09-20 00:12:44 UTC
Created attachment 228027 [details]
Document rctl(4) sysctls

Document rctl(4) sysctls.
Comment 4 Eric van Gyzen freebsd_committer freebsd_triage 2026-08-14 21:53:59 UTC
Wow, I haven't looked at my bug list in a long time.  My apologies for ignoring this.

e9e615c88a7 fixed the reference in thr_new(2).

I just fixed pthread_create(3) in e9e615c88a7, using the same reference as thr_new(2).  I failed to mention this PR in the commit message.

Thank you for the patch for rctl(4).  However, I prefer not to duplicate the existing documentation.  I will, however, tell the user where to find the relevant sysctl tree so he/she can find that documentation.  I realize you also documented the defaults, which "sysctl -d" does not, but these tend to get stale and don't provide much value.  If the user has changed the value, they probably also recorded the default in /etc/sysctl.conf when they configured the new value (or they _should_ have).
Comment 5 commit-hook freebsd_committer freebsd_triage 2026-08-14 21:54:15 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=ffc9b42f5a388bcf911b0bb5401d11f207f99a80

commit ffc9b42f5a388bcf911b0bb5401d11f207f99a80
Author:     Eric van Gyzen <vangyzen@FreeBSD.org>
AuthorDate: 2026-08-14 21:47:17 +0000
Commit:     Eric van Gyzen <vangyzen@FreeBSD.org>
CommitDate: 2026-08-14 21:52:53 +0000

    rctl(4): document the sysctl tree

    Do not duplicate the documentation already available
    through "sysctl -d", but tell the user where to find it.

    PR:             257984
    Suggested by:   Felix Johnson <felix.the.red@gmail.com>

 share/man/man4/rctl.4 | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)