summaryrefslogtreecommitdiffstats
path: root/lib/libc/posix1e
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2004-07-02 23:52:20 +0000
committerru <ru@FreeBSD.org>2004-07-02 23:52:20 +0000
commit01548ace1533487f9c0488f55112c9d8641f8184 (patch)
tree23294a96f715e1e5bc35c1029ec151c90ee95b96 /lib/libc/posix1e
parent47f5e31e2bb626743fa9e912918201fe505b1419 (diff)
downloadFreeBSD-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.36
-rw-r--r--lib/libc/posix1e/acl_delete_entry.33
-rw-r--r--lib/libc/posix1e/acl_delete_perm.33
-rw-r--r--lib/libc/posix1e/acl_dup.312
-rw-r--r--lib/libc/posix1e/acl_free.36
-rw-r--r--lib/libc/posix1e/acl_from_text.315
-rw-r--r--lib/libc/posix1e/acl_get.312
-rw-r--r--lib/libc/posix1e/acl_get_entry.39
-rw-r--r--lib/libc/posix1e/acl_get_qualifier.36
-rw-r--r--lib/libc/posix1e/acl_init.316
-rw-r--r--lib/libc/posix1e/acl_set.36
-rw-r--r--lib/libc/posix1e/acl_set_qualifier.33
-rw-r--r--lib/libc/posix1e/acl_set_tag_type.33
-rw-r--r--lib/libc/posix1e/acl_to_text.318
-rw-r--r--lib/libc/posix1e/acl_valid.312
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.
OpenPOWER on IntegriCloud