[newlib-cygwin/cygwin-3_6-branch] Cygwin: doc: improve Solaris ACL documentation
Corinna Vinschen via Cygwin-cvs <[email protected]>
| Newsgroups | gmane.os.cygwin.cvs |
|---|---|
| Message-ID | <[email protected]> |
https://sourceware.org/git/gitweb.cgi?p=newlib-cygwin.git;h=da976244534d5ce21a16c891395b44cf4e5a649d commit da976244534d5ce21a16c891395b44cf4e5a649d Author: Corinna Vinschen <[email protected]> AuthorDate: Thu Mar 20 14:21:42 2025 +0100 Commit: Corinna Vinschen <[email protected]> CommitDate: Mon Mar 24 21:49:24 2025 +0100 Cygwin: doc: improve Solaris ACL documentation Document including cygwin/acl.h functions when using Solaris ACL functions. Signed-off-by: Corinna Vinschen <[email protected]> (cherry picked from commit 8e50c7af7c49819245739d6f626f6fecc394ef7f) Diff: --- winsup/doc/posix.xml | 31 +++++++++++++++++++++---------- 1 file changed, 21 insertions(+), 10 deletions(-) diff --git a/winsup/doc/posix.xml b/winsup/doc/posix.xml index d4a4e0d839c7..bb5f4146dbc3 100644 --- a/winsup/doc/posix.xml +++ b/winsup/doc/posix.xml @@ -1528,17 +1528,17 @@ ISO®/IEC DIS 9945 Information technology __fwriting __xdrrec_getrec (available in external "libtirpc" library) __xdrrec_setnonblock (available in external "libtirpc" library) - acl - aclcheck - aclfrommode - aclfrompbits - aclfromtext - aclsort - acltomode - acltopbits - acltotext + acl (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + aclcheck (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + aclfrommode (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + aclfrompbits (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + aclfromtext (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + aclsort (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + acltomode (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + acltopbits (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + acltotext (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) endmntent - facl + facl (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) fegetprec fesetprec futimesat @@ -1809,6 +1809,17 @@ currently support only CLOCK_REALTIME.</para> <para><function>close_range</function> does not support the Linux-specific flag CLOSE_RANGE_UNSHARE.</para> +<para>The Solaris-invented ACL functions <function>acl</function>, +<function>facl</function>, <function>aclcheck</function>, +<function>aclfrommode</function>, <function>aclfrompbits</function>, +<function>aclfromtext</function>, <function>aclsort</function>, +<function>acltomode</function>, <function>acltopbits</function> and +<function>acltotext</function> and the belonging macros and datatypes +are defined in <cygwin/acl.h> since they collide with the +Linux-compatible POSIX.1e draft macros in <sys/acl.h>. Just +include <cygwin/acl.h> if you prefer them over the POSIX.1e +functions.</para> + <para>POSIX file locks via <function>fcntl</function> or <function>lockf</function>, as well as BSD <function>flock</function> locks are advisory locks. They don't interact with Windows mandatory locks, nor