diff options
| author | Corinna Vinschen <corinna@vinschen.de> | 2025-03-20 14:21:42 +0100 |
|---|---|---|
| committer | Corinna Vinschen <corinna@vinschen.de> | 2025-03-20 14:21:42 +0100 |
| commit | 8e50c7af7c49819245739d6f626f6fecc394ef7f (patch) | |
| tree | 06ddade4afa8b5593f54616edb78e565858cd615 | |
| parent | d5025106cf4fc520fd9ad5e53272bf9dc193bc1f (diff) | |
| download | newlib-8e50c7af7c49819245739d6f626f6fecc394ef7f.zip newlib-8e50c7af7c49819245739d6f626f6fecc394ef7f.tar.gz newlib-8e50c7af7c49819245739d6f626f6fecc394ef7f.tar.bz2 | |
Cygwin: doc: improve Solaris ACL documentation
Document including cygwin/acl.h functions when using Solaris ACL functions.
Signed-off-by: Corinna Vinschen <corinna@vinschen.de>
| -rw-r--r-- | winsup/doc/posix.xml | 31 |
1 files changed, 21 insertions, 10 deletions
diff --git a/winsup/doc/posix.xml b/winsup/doc/posix.xml index d4a4e0d..bb5f414 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 |