diff options
| author | Ruslan Ermilov <ru@FreeBSD.org> | 2004-07-02 23:52:20 +0000 |
|---|---|---|
| committer | Ruslan Ermilov <ru@FreeBSD.org> | 2004-07-02 23:52:20 +0000 |
| commit | 1a0a934547909744a6a2fa4cfd5b795ec6394f05 (patch) | |
| tree | 23294a96f715e1e5bc35c1029ec151c90ee95b96 /lib/libc/posix1e | |
| parent | e37a7c5f5a689c6f1994a879f5fa86066b7aac82 (diff) | |
Notes
Diffstat (limited to 'lib/libc/posix1e')
| -rw-r--r-- | lib/libc/posix1e/acl_delete.3 | 6 | ||||
| -rw-r--r-- | lib/libc/posix1e/acl_delete_entry.3 | 3 | ||||
| -rw-r--r-- | lib/libc/posix1e/acl_delete_perm.3 | 3 | ||||
| -rw-r--r-- | lib/libc/posix1e/acl_dup.3 | 12 | ||||
| -rw-r--r-- | lib/libc/posix1e/acl_free.3 | 6 | ||||
| -rw-r--r-- | lib/libc/posix1e/acl_from_text.3 | 15 | ||||
| -rw-r--r-- | lib/libc/posix1e/acl_get.3 | 12 | ||||
| -rw-r--r-- | lib/libc/posix1e/acl_get_entry.3 | 9 | ||||
| -rw-r--r-- | lib/libc/posix1e/acl_get_qualifier.3 | 6 | ||||
| -rw-r--r-- | lib/libc/posix1e/acl_init.3 | 16 | ||||
| -rw-r--r-- | lib/libc/posix1e/acl_set.3 | 6 | ||||
| -rw-r--r-- | lib/libc/posix1e/acl_set_qualifier.3 | 3 | ||||
| -rw-r--r-- | lib/libc/posix1e/acl_set_tag_type.3 | 3 | ||||
| -rw-r--r-- | lib/libc/posix1e/acl_to_text.3 | 18 | ||||
| -rw-r--r-- | lib/libc/posix1e/acl_valid.3 | 12 |
15 files changed, 87 insertions, 43 deletions
diff --git a/lib/libc/posix1e/acl_delete.3 b/lib/libc/posix1e/acl_delete.3 index 8121d2e24a1d..818b1af28639 100644 --- a/lib/libc/posix1e/acl_delete.3 +++ b/lib/libc/posix1e/acl_delete.3 @@ -124,9 +124,11 @@ The file system is read-only. .Xr acl_set 3 , .Xr posix1e 3 .Sh STANDARDS -POSIX.1e is described in IEEE POSIX.1e draft 17. Discussion +POSIX.1e is described in IEEE POSIX.1e draft 17. +Discussion of the draft continues on the cross-platform POSIX.1e implementation -mailing list. To join this list, see the +mailing list. +To join this list, see the .Fx POSIX.1e implementation page for more information. diff --git a/lib/libc/posix1e/acl_delete_entry.3 b/lib/libc/posix1e/acl_delete_entry.3 index 86fe7b233eac..a931db03f04a 100644 --- a/lib/libc/posix1e/acl_delete_entry.3 +++ b/lib/libc/posix1e/acl_delete_entry.3 @@ -56,7 +56,8 @@ function fails if: .It Bq Er EINVAL Argument .Fa acl -does not point to a valid ACL. Argument +does not point to a valid ACL. +Argument .Fa entry_d is not a valid descriptor for an ACL entry in .Fa acl . diff --git a/lib/libc/posix1e/acl_delete_perm.3 b/lib/libc/posix1e/acl_delete_perm.3 index a3343aa04467..0740d6133375 100644 --- a/lib/libc/posix1e/acl_delete_perm.3 +++ b/lib/libc/posix1e/acl_delete_perm.3 @@ -54,7 +54,8 @@ function fails if: .It Bq Er EINVAL Argument .Fa permset_d -is not a valid descriptor for a permission set. Argument +is not a valid descriptor for a permission set. +Argument .Fa perm does not contain a valid .Vt acl_perm_t diff --git a/lib/libc/posix1e/acl_dup.3 b/lib/libc/posix1e/acl_dup.3 index fa4a4f378ee8..ae4ff4f7b474 100644 --- a/lib/libc/posix1e/acl_dup.3 +++ b/lib/libc/posix1e/acl_dup.3 @@ -46,7 +46,8 @@ The function returns a pointer to a copy of the ACL pointed to by the argument .Va acl . .Pp -This function may cause memory to be allocated. The caller should free any +This function may cause memory to be allocated. +The caller should free any releasable memory, when the new ACL is no longer required, by calling .Xr acl_free 3 with the @@ -62,7 +63,8 @@ support for POSIX.1e interfaces and features is still under development at this time. .Sh RETURN VALUES Upon successful completion, this function shall return a pointer to the -duplicate ACL. Otherwise, a value of +duplicate ACL. +Otherwise, a value of .Va (acl_t)NULL shall be returned, and .Va errno @@ -92,9 +94,11 @@ system-imposed memory management constraints. .Xr acl_get 3 , .Xr posix1e 3 .Sh STANDARDS -POSIX.1e is described in IEEE POSIX.1e draft 17. Discussion +POSIX.1e is described in IEEE POSIX.1e draft 17. +Discussion of the draft continues on the cross-platform POSIX.1e implementation -mailing list. To join this list, see the +mailing list. +To join this list, see the .Fx POSIX.1e implementation page for more information. diff --git a/lib/libc/posix1e/acl_free.3 b/lib/libc/posix1e/acl_free.3 index bc06c993e27b..d64c72a7c7e2 100644 --- a/lib/libc/posix1e/acl_free.3 +++ b/lib/libc/posix1e/acl_free.3 @@ -73,9 +73,11 @@ argument is invalid. .Xr acl_init 3 , .Xr posix1e 3 .Sh STANDARDS -POSIX.1e is described in IEEE POSIX.1e draft 17. Discussion +POSIX.1e is described in IEEE POSIX.1e draft 17. +Discussion of the draft continues on the cross-platform POSIX.1e implementation -mailing list. To join this list, see the +mailing list. +To join this list, see the .Fx POSIX.1e implementation page for more information. diff --git a/lib/libc/posix1e/acl_from_text.3 b/lib/libc/posix1e/acl_from_text.3 index f717d7bbf082..8b10784e502b 100644 --- a/lib/libc/posix1e/acl_from_text.3 +++ b/lib/libc/posix1e/acl_from_text.3 @@ -48,7 +48,8 @@ function converts the text form of an ACL referred to by into the internal working structure for ACLs, appropriate for applying to files or manipulating. .Pp -This function may cause memory to be allocated. The caller should free any +This function may cause memory to be allocated. +The caller should free any releasable memory, when the new ACL is no longer required, by calling .Xr acl_free 3 with the @@ -60,7 +61,8 @@ support for POSIX.1e interfaces and features is still under development at this time. .Sh RETURN VALUES Upon successful completion, the function shall return a pointer to the -internal representation of the ACL in working storage. Otherwise, a value +internal representation of the ACL in working storage. +Otherwise, a value of .Va (acl_t)NULL shall be returned, and @@ -90,9 +92,11 @@ hardware or system-imposed memory management constraints. .Xr acl_to_text 3 , .Xr posix1e 3 .Sh STANDARDS -POSIX.1e is described in IEEE POSIX.1e draft 17. Discussion +POSIX.1e is described in IEEE POSIX.1e draft 17. +Discussion of the draft continues on the cross-platform POSIX.1e implementation -mailing list. To join this list, see the +mailing list. +To join this list, see the .Fx POSIX.1e implementation page for more information. @@ -112,7 +116,8 @@ rely on the .Xr getpwent 3 library calls to manage username and uid mapping, as well as the .Xr getgrent 3 -library calls to manage groupname and gid mapping. These calls are not +library calls to manage groupname and gid mapping. +These calls are not thread safe, and so transitively, neither are .Fn acl_from_text and diff --git a/lib/libc/posix1e/acl_get.3 b/lib/libc/posix1e/acl_get.3 index 25ead88e0011..fa915df3ec48 100644 --- a/lib/libc/posix1e/acl_get.3 +++ b/lib/libc/posix1e/acl_get.3 @@ -78,7 +78,8 @@ is a non-portable variation on which does not follow a symlink if the target of the call is a symlink. .Pp -These functions may cause memory to be allocated. The caller should free +These functions may cause memory to be allocated. +The caller should free any releasable memory, when the new ACL is no longer required, by calling .Xr acl_free 3 with the @@ -96,7 +97,8 @@ support for POSIX.1e interfaces and features is still under development at this time. .Sh RETURN VALUES Upon successful completion, the function shall return a pointer to the ACL -that was retrieved. Otherwise, a value of +that was retrieved. +Otherwise, a value of .Va (acl_t)NULL shall be returned, and .Va errno @@ -138,9 +140,11 @@ The file system does not support ACL retrieval. .Xr acl_set 3 , .Xr posix1e 3 .Sh STANDARDS -POSIX.1e is described in IEEE POSIX.1e draft 17. Discussion +POSIX.1e is described in IEEE POSIX.1e draft 17. +Discussion of the draft continues on the cross-platform POSIX.1e implementation -mailing list. To join this list, see the +mailing list. +To join this list, see the .Fx POSIX.1e implementation page for more information. diff --git a/lib/libc/posix1e/acl_get_entry.3 b/lib/libc/posix1e/acl_get_entry.3 index 528fd3420cb9..0627ecbd6b04 100644 --- a/lib/libc/posix1e/acl_get_entry.3 +++ b/lib/libc/posix1e/acl_get_entry.3 @@ -82,7 +82,8 @@ If the function successfully obtains an ACL entry, a value of 1 is returned. If the ACL has no ACL entries, the .Fn acl_get_entry -returns a value of 0. If the value of +returns a value of 0. +If the value of .Fa entry_id is .Dv ACL_NEXT_ENTRY @@ -93,7 +94,8 @@ a value of 0 will be returned until a successful call with .Fa entry_id of .Dv ACL_FIRST_ENTRY -is made. Otherwise, a value of -1 will be returned and +is made. +Otherwise, a value of -1 will be returned and the global variable .Va errno will be set to indicate the error. @@ -105,7 +107,8 @@ fails if: .It Bq Er EINVAL Argument .Fa acl -does not point to a valid ACL. Argument +does not point to a valid ACL. +Argument .Fa entry_id is neither .Dv ACL_FIRST_ENTRY diff --git a/lib/libc/posix1e/acl_get_qualifier.3 b/lib/libc/posix1e/acl_get_qualifier.3 index cdfe8826f637..867809e52da6 100644 --- a/lib/libc/posix1e/acl_get_qualifier.3 +++ b/lib/libc/posix1e/acl_get_qualifier.3 @@ -78,7 +78,8 @@ will return a value of .Vt ( void * ) Ns Dv NULL and the function will fail. .Pp -This function may cause memory to be allocated. The caller should +This function may cause memory to be allocated. +The caller should free any releasable memory, when the new qualifier is no longer required, by calling .Fn acl_free @@ -102,7 +103,8 @@ fails if: .It Bq Er EINVAL Argument .Fa entry_d -does not point to a valid descriptor for an ACL entry. The +does not point to a valid descriptor for an ACL entry. +The value of the tag type in the ACL entry referenced by argument .Fa entry_d is not diff --git a/lib/libc/posix1e/acl_init.3 b/lib/libc/posix1e/acl_init.3 index 8a98643d1a80..dba89231c44a 100644 --- a/lib/libc/posix1e/acl_init.3 +++ b/lib/libc/posix1e/acl_init.3 @@ -46,13 +46,16 @@ The function allocates and initializes the working storage for an ACL of at least .Va count -ACL entries. A pointer to the working storage is returned. The working +ACL entries. +A pointer to the working storage is returned. +The working storage allocated to contain the ACL is freed by a call to .Xr acl_free 3 . When the area is first allocated, it shall contain an ACL that contains no ACL entries. .Pp -This function may cause memory to be allocated. The caller should free any +This function may cause memory to be allocated. +The caller should free any releasable memory, when the new ACL is no longer required, by calling .Xr acl_free 3 with the @@ -64,7 +67,8 @@ support for POSIX.1e interfaces and features is still under development at this time. .Sh RETURN VALUES Upon successful completion, this function shall return a pointer to the -working storage. Otherwise, a value of +working storage. +Otherwise, a value of .Va (acl_t)NULL shall be returned, and .Va errno @@ -91,9 +95,11 @@ system-imposed memory management constraints. .Xr acl_free 3 , .Xr posix1e 3 .Sh STANDARDS -POSIX.1e is described in IEEE POSIX.1e draft 17. Discussion +POSIX.1e is described in IEEE POSIX.1e draft 17. +Discussion of the draft continues on the cross-platform POSIX.1e implementation -mailing list. To join this list, see the +mailing list. +To join this list, see the .Fx POSIX.1e implementation page for more information. diff --git a/lib/libc/posix1e/acl_set.3 b/lib/libc/posix1e/acl_set.3 index db1be7d01db2..a2d50b840dde 100644 --- a/lib/libc/posix1e/acl_set.3 +++ b/lib/libc/posix1e/acl_set.3 @@ -126,9 +126,11 @@ read-only. .Xr acl_valid 3 , .Xr posix1e 3 .Sh STANDARDS -POSIX.1e is described in IEEE POSIX.1e draft 17. Discussion +POSIX.1e is described in IEEE POSIX.1e draft 17. +Discussion of the draft continues on the cross-platform POSIX.1e implementation -mailing list. To join this list, see the +mailing list. +To join this list, see the .Fx POSIX.1e implementation page for more information. diff --git a/lib/libc/posix1e/acl_set_qualifier.3 b/lib/libc/posix1e/acl_set_qualifier.3 index 04dc2a2613f5..3442a823f9ec 100644 --- a/lib/libc/posix1e/acl_set_qualifier.3 +++ b/lib/libc/posix1e/acl_set_qualifier.3 @@ -56,7 +56,8 @@ function fails if: .It Bq Er EINVAL Argument .Fa entry_d -is not a valid descriptor for an ACL entry. The tag type of the +is not a valid descriptor for an ACL entry. +The tag type of the ACL entry .Fa entry_d is not diff --git a/lib/libc/posix1e/acl_set_tag_type.3 b/lib/libc/posix1e/acl_set_tag_type.3 index 460e92563af0..3830be7c1d7f 100644 --- a/lib/libc/posix1e/acl_set_tag_type.3 +++ b/lib/libc/posix1e/acl_set_tag_type.3 @@ -56,7 +56,8 @@ function fails if: .It Bq Er EINVAL Argument .Fa entry_d -is not a valid descriptor for an ACL entry. Argument +is not a valid descriptor for an ACL entry. +Argument .Fa tag_type is not a valid ACL tag type. .El diff --git a/lib/libc/posix1e/acl_to_text.3 b/lib/libc/posix1e/acl_to_text.3 index 1283a68c8983..833a6d2a575d 100644 --- a/lib/libc/posix1e/acl_to_text.3 +++ b/lib/libc/posix1e/acl_to_text.3 @@ -45,7 +45,8 @@ The .Fn acl_to_text function translates the ACL pointed to by argument .Va acl -into a NULL terminated character string. If the pointer +into a NULL terminated character string. +If the pointer .Va len_p is not NULL, then the function shall return the length of the string (not including the NULL terminator) in the location pointed to by @@ -55,7 +56,8 @@ The format of the text string returned by shall be the POSIX.1e long ACL form. .Pp This function allocates any memory necessary to contain the string and -returns a pointer to the string. The caller should free any releasable +returns a pointer to the string. +The caller should free any releasable memory, when the new string is no longer required, by calling .Xr acl_free 3 with the @@ -67,7 +69,8 @@ support for POSIX.1e interfaces and features is still under development at this time. .Sh RETURN VALUES Upon successful completion, the function shall return a pointer to the -long text form of an ACL. Otherwise, a value of +long text form of an ACL. +Otherwise, a value of .Va (char*)NULL shall be returned and .Va errno @@ -100,9 +103,11 @@ by the hardware or software-imposed memory management constraints. .Xr acl_from_text 3 , .Xr posix1e 3 .Sh STANDARDS -POSIX.1e is described in IEEE POSIX.1e draft 17. Discussion +POSIX.1e is described in IEEE POSIX.1e draft 17. +Discussion of the draft continues on the cross-platform POSIX.1e implementation -mailing list. To join this list, see the +mailing list. +To join this list, see the .Fx POSIX.1e implementation page for more information. @@ -122,7 +127,8 @@ rely on the .Xr getpwent 3 library calls to manage username and uid mapping, as well as the .Xr getgrent 3 -library calls to manage groupname and gid mapping. These calls are not +library calls to manage groupname and gid mapping. +These calls are not thread safe, and so transitively, neither are .Fn acl_from_text and diff --git a/lib/libc/posix1e/acl_valid.3 b/lib/libc/posix1e/acl_valid.3 index 3d47da54f5f3..e525db6e59a8 100644 --- a/lib/libc/posix1e/acl_valid.3 +++ b/lib/libc/posix1e/acl_valid.3 @@ -52,10 +52,12 @@ .Sh DESCRIPTION These functions check that the ACL referred to by the argument .Va acl -is valid. The POSIX.1e routine, +is valid. +The POSIX.1e routine, .Fn acl_valid , checks this validity only with POSIX.1e ACL semantics, and irrespective -of the context in which the ACL is to be used. The non-portable forms, +of the context in which the ACL is to be used. +The non-portable forms, .Fn acl_valid_fd_np , .Fn acl_valid_file_np , and @@ -140,9 +142,11 @@ The file system does not support ACL retrieval. .Xr acl_set 3 , .Xr posix1e 3 .Sh STANDARDS -POSIX.1e is described in IEEE POSIX.1e draft 17. Discussion +POSIX.1e is described in IEEE POSIX.1e draft 17. +Discussion of the draft continues on the cross-platform POSIX.1e implementation -mailing list. To join this list, see the +mailing list. +To join this list, see the .Fx POSIX.1e implementation page for more information. |
