Differential D9298

Clean up documentation of AF_UNIX control messages.
ClosedPublic
Actions

Authored by jilles on Jan 22 2017, 10:11 PM.

Details

Reviewers

wblock

Group Reviewers

manpages

Commits

rS313174: Clean up documentation of AF_UNIX control messages.

Summary

Document AF_UNIX control messages in unix(4) only, not split between
unix(4) and recv(2).

Also, warn about LOCAL_CREDS effective uid/gid fields, since the
write could be from a setuid or setgid program (with the explicit SCM_CREDS
and LOCAL_PEERCRED, the credentials are read at such a time that it can
be assumed that the process intends for them to be used in this context).

Test Plan

igor without options only complains about the date (.Dd).

Diff Detail

Repository

rS FreeBSD src repository - subversion

Lint

Lint Not Applicable

Unit

Tests Not Applicable

Event Timeline

jilles updated this revision to Diff 24330.Jan 22 2017, 10:11 PM

jilles retitled this revision from to Clean up documentation of AF_UNIX control messages..

jilles updated this object.

jilles edited the test plan for this revision. (Show Details)

Herald added a reviewer: manpages. · View Herald TranscriptJan 22 2017, 10:11 PM

Herald added a subscriber: imp. · View Herald Transcript

wblock added a subscriber: wblock.Jan 27 2017, 2:53 PM

wblock added inline comments.

share/man/man4/unix.4
141 ↗	(On Diff #24330)	Combine these two lines: To send file descriptors, the message type is
165 ↗	(On Diff #24330)	Rearrange to get rid of the apostrophe: Credentials of the sending process can be transmitted explicitly using a
184 ↗	(On Diff #24330)	The sender should pass a zeroed buffer which will be filled in by the system.
195 ↗	(On Diff #24330)	The sending process could have exited and its process ID already been