Page MenuHomeFreeBSD

inet.4 tcp.4 udp.4: Replace *CTL_* OID macro names with sysctls
ClosedPublic

Authored by karels on Jul 13 2022, 7:05 PM.
Tags
None
Referenced Files
Unknown Object (File)
Fri, Apr 5, 7:44 PM
Unknown Object (File)
Jan 30 2024, 5:32 PM
Unknown Object (File)
Jan 14 2024, 10:16 AM
Unknown Object (File)
Dec 20 2023, 7:05 AM
Unknown Object (File)
Nov 10 2023, 8:35 PM
Unknown Object (File)
Nov 10 2023, 8:17 AM
Unknown Object (File)
Nov 8 2023, 8:19 AM
Unknown Object (File)
Nov 6 2023, 12:05 PM
Subscribers

Details

Summary

Older sysctls with constant OID macros were identified with those
in inet.4, tcp.4, and udp.4; newer sysctls with automatic numbering
were identified by sysctl names. No one remembers the OID macros,
or knows what they are; sysctls are always done by name now, usually
via sysctl(8).

Replace the OID macro names with sysctl names so that there is one
uniform identifier type; sysctl names were previously in parens.
Make the formatting a little more consistent in this area. In inet.4
and udp.4, move the "ip." or "udp." prefix from each entry into the
top-level name at the start of the section, as they are all the same.

Test Plan

tested with mandoc

Diff Detail

Repository
rS FreeBSD src repository - subversion
Lint
Lint Passed
Unit
No Test Coverage
Build Status
Buildable 46413
Build 43302: arc lint + arc unit

Event Timeline

rpokala added inline comments.
share/man/man4/inet.4
173

I think this paragraph reads more clearly like this:

In addition to the variables supported by the transport protocols in
.Va net.inet
(for which the respective manual pages may be consulted),
there are a number of general variables implemented in the
.Va net.inet.ip
branch of the
.Xr sysctl 3
MIB.
The following general variables are defined:

Replace intro to sysctl section in inet.4 with suggested text.

karels added inline comments.
share/man/man4/inet.4
173

Thanks, that is a definite improvement.

LGTM.

share/man/man4/inet.4
173

Thanks!

This revision is now accepted and ready to land.Jul 13 2022, 8:55 PM