Hi Günther, > Date: 2026-11-03 21:22:02+0100 > From: Günther Noack > > Hello! > > This is patch set (B) spun off from the "Documentation fixes in > unix(7)" patch set [1], which is now split into these three parts: > > (A) Miscellaneous fixes, mostly in unix.7, one in socket.7 > (B) Socket options and Socket-level Control Messages (SCM_*) <-- this one > (C) sock_diag.7 Would you mind rebasing and sending a revised patch set? There are some patches which I'd like to apply, but they don't apply cleanly. There's also some patches which I haven't applied yet (I commented on them). Have a lovely night! Alex > > This patch set fixes unix(7) documentation related to socket options > and SCM_* control messages. The first 5 commits are fixes and factual > corrections, the last two commits are documenting two relevant new > features (PIDFD passing and SO_PASSRIGHTS). > > The patch set is based on the "miscellaneous" patch set (A) ("General > Unix Domain Socket fixes"), since it is touching some error code > documentation in the same corner as what is getting changed in (A). > > Thank you for your reviews of v1 and v2 of the still-joined patch set, > as well as of v1 of the split patch set. > > Changes in v2 (split): > > * Mention commit hashes in commit messages, not in groff comments > * Reword __scm_send() code snippet in commit message > * s/the last one takes effect/the last one is sent/ > * Rewrite SCM_SECURITY section to be about byte buffers > and independent of the LSM > * New commit: > * Remove mentions of "namespace" in the general sense > > Changes in v1 (split): > > * Some commit message rewording (especially quoted the kernel code > more directly). > * I removed the commit that changed the wording about Out-of-Band > messaging, per Kuniyuki's suggestion in [2]. > * The ETOOMANYREFS commit is a SCM_RIGHTS-specific error; the Autobind > documentation change is included here because it refers to > SO_PASSPIDFD. > * I am not 100% happy with how verbose the SCM_SECURITY change has > become, but I don't see a good way to shorten it without cutting > away from the substance. > > v1: https://lore.kernel.org/all/20261021212256.27961-1-gnoack3000@gmail.com/ > > More details are attached in the commit notes. > > This patch set has been produced with the help of a LLM, which was > helpful for spotting a long list of inaccuracies, comparing the > documentation with the kernel implementation. (More details in [1]) > > –Günther > > P.S.: Part (C) will come soon, but not today any more. :) > That part is more independent again and, being about "sock_diag", > it is outside of the main unix(7) documentation. > > > Günther Noack (8): > man/man7/unix.7: ERRORS: ETOOMANYREFS: Fix the conditions > man/man7/unix.7: Multiple same-typed SCM_* messages may be sent in one > message > man/man7/unix.7: Autobind: Clarify when it happens, and mention > SO_PASSPIDFD > man/man7/unix.7: SCM_SECURITY: Generalize to other LSMs, not just > SELinux > man/man7/unix.7: SO_PASSSEC: wfix > man/man7/unix.7: Document SO_PASSPIDFD, SO_PEERPIDFD, and SCM_PIDFD > man/man7/unix.7: Document SO_PASSRIGHTS > man/man7/unix.7: Remove mentions of "namespace" in the general sense > > man/man7/unix.7 | 215 +++++++++++++++++++++++++++++++++++++++++++----- > 1 file changed, 195 insertions(+), 20 deletions(-) > > -- > 2.56.0 > > --