diff options
author | ru <ru@FreeBSD.org> | 2004-07-02 23:52:20 +0000 |
---|---|---|
committer | ru <ru@FreeBSD.org> | 2004-07-02 23:52:20 +0000 |
commit | 01548ace1533487f9c0488f55112c9d8641f8184 (patch) | |
tree | 23294a96f715e1e5bc35c1029ec151c90ee95b96 /lib/libc/posix1e | |
parent | 47f5e31e2bb626743fa9e912918201fe505b1419 (diff) | |
download | FreeBSD-src-01548ace1533487f9c0488f55112c9d8641f8184.zip FreeBSD-src-01548ace1533487f9c0488f55112c9d8641f8184.tar.gz |
Mechanically kill hard sentence breaks.
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 8121d2e..818b1af 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 86fe7b2..a931db0 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 a3343aa0..0740d61 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 fa4a4f3..ae4ff4f 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 bc06c99..d64c72a 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 f717d7b..8b10784 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 25ead88..fa915df 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 528fd34..0627ecb 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 cdfe882..867809e 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 8a98643..dba8923 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 db1be7d..a2d50b8 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 04dc2a2..3442a82 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 460e925..3830be7 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 1283a68c..833a6d2 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 3d47da5..e525db6 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. |