unix(4): Comma is wrong; semicolon is right.
(Personally I would use an em dash here, but then I always render man
pages with LC_ALL=C because UTF-8 output is screwy for various other
reasons like rendering program options with characters other than
standard hyphen `-' so searching for text like `-F' doesn't work.)
unix(4): tweak markup
Use comma instead of em-dash, it's easier to read in plain-text output
(especically if it ends up as a single cell monospace em-dash in UTF-8
that is just a pixel or two wider than a hyphen). Use .Bx to get
nicer looking smallcaps "BSD" in the PostScript output.
unix(4): Rehome paragraph about sockcred that had wandered off.
This paragraph is about LOCAL_CREDS, not about LOCAL_PEEREID. Not
sure how it escaped but let's bring it back where it belongs!
PR kern/32844: unix domain sockets documentation is incomplete
unix(4): Replace prose on cmsg details by xref to cmsg(3).
This provides better information with less verbiage.
Fix .Bl markup by specifying missing -width.
PR kern/32844: unix domain sockets documentation is incomplete
unix(4): Document options more legibly.
1. Use `.Bl -tag' rather than just paragraphs upon paragraphs.
2. Specify the type of each option and how it is to be used.
3. Add LOCAL_CONNWAIT.
4. Slim down the comment spacing a little to fit.
PR kern/32844: unix domain sockets documentation is incomplete
unix(4): Fix/add markup
Untabify examples, .Bd -literal -offset indent doesn't seem to mesh
with tabs nicely in the PostScript output. The indent is probably not
a multiple a of literal tab width. This causes a small vertical
misalignment for tab-indented lines, but what's worse - it can cause
an extra tab in some cases (and did here for the unpcbid definition).
Change back various occurrences of \*[Le], \*[Ge] (less/greater equal)
and \*(ua (upwards arrow) to literal "<=", ">=" and "^" whenever
appropriate (e.g., in code examples).
introduce a SOL_LOCAL for unix-domain socket level socket options
as an alias of the current 0 used for these options, as in FreeBSD.
reviewed by many.
Add sc_pid to sockcred so that SOCK_DGRAM and LOCAL_CREDS socket option
can learn the process id of the AF_LOCAL sender.
Add compat glue for old structure.
Rewrite the sentence about the socket options to avoid questionable
typographic layout and to be more inline with the wording of the rest of
the man page.
Add a new socket option for unix domain sockets: LOCAL_PEEREID, to make
it possible to get the pid, euid and egid of the process at the remote
end at the time it did bind() or connect().
Add a new libc function, getpeereid() to easily get at the euid and egid.
As a consequence, bump libc's minor number.
Document the LOCAL_PEEREID socket option in unix(4).
Based on contribution by Arne H. Juul, minor modifications by myself.
Moved example code into its own section with an additional path truncation
check. Added a COMPATIBILITY section for sun_len and SUN_LEN() as suggested
by soda. Fixes PR lib/34744.