[Bug 287963] res_ninit (and friends) is present but not documented

From: <bugzilla-noreply_at_freebsd.org>
Date: Wed, 02 Jul 2025 10:31:29 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=287963

            Bug ID: 287963
           Summary: res_ninit (and friends) is present but not documented
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Many People
          Priority: ---
         Component: Manual Pages
          Assignee: bugs@FreeBSD.org
          Reporter: gray@nxg.name
                CC: doc@FreeBSD.org

Function res_ninit (the thread-safe alternative to res_init) is present, and
declared in /usr/include/resolv.h, but isn't documented.

`man res_init` produces the man-page resolver(3), but there is no mention of
`res_ninit`.  `man res_ninit` says 'no manual entry'; `apropos res_ninit`
produces nothing.

`res_init` and friends aren't marked as deprecated in FreeBSD (though it
currently seems to be thus marked in Linux), so this isn't a FreeBSD _error_,
but the thread-safe alternative would be preferable in many cases, and is
available, so making it visible seems like a good thing.

-- 
You are receiving this mail because:
You are on the CC list for the bug.