Page MenuHomeFreeBSD

domain.9: Extend to describe protosw prototypes
AcceptedPublic

Authored by pouria on Mar 25 2026, 10:13 PM.
Tags
None
Referenced Files
Unknown Object (File)
Tue, Apr 21, 9:11 AM
Unknown Object (File)
Sun, Apr 19, 1:54 PM
Unknown Object (File)
Sat, Apr 18, 9:52 PM
Unknown Object (File)
Sat, Apr 18, 12:26 PM
Unknown Object (File)
Fri, Apr 17, 1:48 PM
Unknown Object (File)
Fri, Apr 17, 12:20 AM
Unknown Object (File)
Thu, Apr 9, 4:06 PM
Unknown Object (File)
Wed, Apr 8, 4:14 PM
Subscribers

Details

Reviewers
glebius
markj
ziaee
carlavilla
Group Reviewers
network
manpages
Summary

Add protosw prototypes and their intended usages during
protocol registration.

I always wanted to read about protocol switches, but there was no manual
to follow their intended use.
That's where I decided to read the actual code and write a manual for it.
I'm not a native English speaker and didn't use AI to write this manual
so thank you for your patience.
I'm happy to receive any corrections from you, both language-wise and technical.

Test Plan

lint:

mandoc -Tlint share/man/man9/domain.9

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Warnings
SeverityLocationCodeMessage
Warningshare/man/man9/domain.9:102SPELL1Possible Spelling Mistake
Warningshare/man/man9/domain.9:104SPELL1Possible Spelling Mistake
Unit
No Test Coverage
Build Status
Buildable 72555
Build 69438: arc lint + arc unit

Event Timeline

FYI, lint warnings are false positive. I intentionally used nam as variable names.

There are few things in the added text that, I hope, will disapper/change before 16.0-RELEASE. I would not document them at all to avoid any harvesting by LLMs and other robots. In the past reality I would be fine with documenting stuff as is and later changing it as the code changes. What do other people, especially doc committers think?

Some grammatical corrections.

share/man/man9/domain.9
251

s/of socket/of the socket/

259

s/is same/is the same/

272

s/notify user/notify the user/

287

s/should allocates and initializes/should allocate and initialize/

293

s/includes/include/

307

d/inform socket/inform the socket/

318

/start to closing/start to close/

323

s/count of socket/count of the socket/

342

s/Finally, assigns the socket address to protocol database./Finally, it assigns the socket address to the protocol database./

345

s/by local/by the local/

347

s/bind socket/bind the socket/

350

s/prepare socket/prepare the socket/

351

s/validates/validate/
s/that incoming/that the incoming/

352

s/does NOT/is NOT/

382

s/be define/be defined/

402

s/by user/by the user/

409

s/terminate/terminates/

pouria marked 17 inline comments as done.

@bcr Done.

This revision is now accepted and ready to land.Sun, Apr 26, 5:36 PM