Have a look at man pages like chown(2), we already do document what privilege is necessary.
Some of the man pages have similar man pages (but not chown(2) I notice) do have privileges(5) as a see also. The fact that chown(2) does not is IMO a bug in that man page. I think the relevant functions in libdlpi should in their man page document what privilege they need and they should cross reference to privileges(5). It isn't the library as a whole but the individual functions. -- Darren J Moffat
