From 8480a1eb149d512c35d0b6d0d0ae7be2f826c3c5 Mon Sep 17 00:00:00 2001 From: Ruslan Ermilov Date: Fri, 23 Mar 2001 09:39:35 +0000 Subject: [PATCH] mdoc(7) police: fix markup. --- lib/libc/posix1e/acl_add_perm.3 | 30 ++++++++--------------- lib/libc/posix1e/acl_clear_perms.3 | 24 ++++++------------- lib/libc/posix1e/acl_copy_entry.3 | 30 ++++++++--------------- lib/libc/posix1e/acl_create_entry.3 | 22 +++++------------ lib/libc/posix1e/acl_delete_perm.3 | 28 +++++++--------------- lib/libc/posix1e/acl_get_permset.3 | 25 ++++++------------- lib/libc/posix1e/acl_get_tag_type.3 | 28 +++++++--------------- lib/libc/posix1e/acl_set_qualifier.3 | 36 ++++++++++++---------------- lib/libposix1e/acl_add_perm.3 | 30 ++++++++--------------- lib/libposix1e/acl_clear_perms.3 | 24 ++++++------------- lib/libposix1e/acl_copy_entry.3 | 30 ++++++++--------------- lib/libposix1e/acl_create_entry.3 | 22 +++++------------ lib/libposix1e/acl_delete_perm.3 | 28 +++++++--------------- lib/libposix1e/acl_get_permset.3 | 25 ++++++------------- lib/libposix1e/acl_get_tag_type.3 | 28 +++++++--------------- lib/libposix1e/acl_set_qualifier.3 | 36 ++++++++++++---------------- 16 files changed, 144 insertions(+), 302 deletions(-) diff --git a/lib/libc/posix1e/acl_add_perm.3 b/lib/libc/posix1e/acl_add_perm.3 index 7354d2398c2b..88b22fb9f7ec 100644 --- a/lib/libc/posix1e/acl_add_perm.3 +++ b/lib/libc/posix1e/acl_add_perm.3 @@ -30,48 +30,38 @@ .Os .Sh NAME .Nm acl_add_perm -.Nd Add permissions to a permission set +.Nd add permissions to a permission set .Sh LIBRARY .Lb libposix1e .Sh SYNOPSIS .Fd #include .Fd #include .Ft int -.Fn acl_add_perm "acl_permset_t permset_d, acl_perm_t perm" +.Fn acl_add_perm "acl_permset_t permset_d" "acl_perm_t perm" .Sh DESCRIPTION .Fn acl_add_perm is a POSIX.1e call that adds the permission contained in -.Ar perm +.Fa perm to the permission set -.Ar permset_d . +.Fa permset_d . .Pp Note: it is not considered an error to attempt to add permissions that already exist in the permission set. .Sh RETURN VALUES -Upon successful completion, the function will return a value of -.Va 0 . -Otherwise, a value of -.Va -1 -will be returned, and -.Va errno -will be set to indicate the error. +.Rv -std acl_add_perm .Sh ERRORS -If any of the following conditions occur, the +The .Fn acl_add_perm -function will return a value of -.Va -1 -and set -.Va errno -to the corresponding value: +function fails if: .Bl -tag -width Er .It Bq Er EINVAL Argument -.Ar permset_d +.Fa permset_d is not a valid descriptor for a permission set within an ACL entry. Argument -.Ar perm +.Fa perm does not contain a valid -.Ar acl_perm_t +.Vt acl_perm_t value. .El .Sh SEE ALSO diff --git a/lib/libc/posix1e/acl_clear_perms.3 b/lib/libc/posix1e/acl_clear_perms.3 index d41ab3ee002a..1e327c85a2d9 100644 --- a/lib/libc/posix1e/acl_clear_perms.3 +++ b/lib/libc/posix1e/acl_clear_perms.3 @@ -26,11 +26,11 @@ .\" $FreeBSD$ .\" .Dd March 10, 2001 -.Dt ACL_CLEAR_PERM 3 +.Dt ACL_CLEAR_PERMS 3 .Os .Sh NAME .Nm acl_clear_perms -.Nd Clear permissions from a permission set +.Nd clear permissions from a permission set .Sh LIBRARY .Lb libposix1e .Sh SYNOPSIS @@ -41,27 +41,17 @@ .Sh DESCRIPTION .Fn acl_clear_perms is a POSIX.1e call that clears all permissions from permissions set -.Ar perm . +.Fa permset_d . .Sh RETURN VALUES -Upon successful completion, the function will return a value of -.Va 0 . -Otherwise, a value of -.Va -1 -will be returned, and -.Va errno -will be set to indicate the error. +.Rv -std acl_clear_perms .Sh ERRORS -If the following condition occurs, the +The .Fn acl_clear_perms -function will return a value of -.Va -1 -and set -.Va errno -to the corresponding value: +function fails if: .Bl -tag -width Er .It Bq Er EINVAL Argument -.Ar permset_d +.Fa permset_d is not a valid descriptor for a permission set. .El .Sh SEE ALSO diff --git a/lib/libc/posix1e/acl_copy_entry.3 b/lib/libc/posix1e/acl_copy_entry.3 index 5e18e60087e6..ce8d60f4362c 100644 --- a/lib/libc/posix1e/acl_copy_entry.3 +++ b/lib/libc/posix1e/acl_copy_entry.3 @@ -30,7 +30,7 @@ .Os .Sh NAME .Nm acl_copy_entry -.Nd Copy an ACL entry to another ACL entry +.Nd copy an ACL entry to another ACL entry .Sh LIBRARY .Lb libposix1e .Sh SYNOPSIS @@ -41,36 +41,26 @@ .Sh DESCRIPTION .Fn acl_copy_entry is a POSIX.1e call that copies the contents of ACL entry -.Ar src_d +.Fa src_d to ACL entry -.Ar dest_d . +.Fa dest_d . .Sh RETURN VALUES -Upon successful completion, the function will return a value of -.Va 0 . -Otherwise, a value of -.Va -1 -will be returned, and -.Va errno -will be set to indicate the error. +.Rv -std acl_copy_entry .Sh ERRORS -If any of the following conditions occur, the +The .Fn acl_copy_entry -function will return a value of -.Va -1 -and set -.Va errno -to the corresponding value: +function fails if: .Bl -tag -width Er .It Bq Er EINVAL Argument -.Ar src_d +.Fa src_d or -.Ar dest_d +.Fa dest_d is not a valid descriptor for an ACL entry, or arguments -.Ar src_d +.Fa src_d and -.Ar dest_d +.Fa dest_d reference the same ACL entry. .El .Sh SEE ALSO diff --git a/lib/libc/posix1e/acl_create_entry.3 b/lib/libc/posix1e/acl_create_entry.3 index c1e8cd34cabb..1b94312a23de 100644 --- a/lib/libc/posix1e/acl_create_entry.3 +++ b/lib/libc/posix1e/acl_create_entry.3 @@ -30,7 +30,7 @@ .Os .Sh NAME .Nm acl_create_entry -.Nd Create a new ACL entry +.Nd create a new ACL entry .Sh LIBRARY .Lb libposix1e .Sh SYNOPSIS @@ -42,27 +42,17 @@ .Fn acl_create_entry is a POSIX.1e call that creates a new ACL entry in the ACL pointed to by -.Ar acl_p. +.Fa acl_p . .Sh RETURN VALUES -Upon successful completion, the function will return a value of -.Va 0 . -Otherwise, a value of -.Va -1 -will be returned, and -.Va errno -will be set to indicate the error. +.Rv -std acl_create_entry .Sh ERRORS -If one of the following conditions occur, the +The .Fn acl_create_entry -function will return a value of -.Va -1 -and set -.Va errno -to the corresponding value: +function fails if: .Bl -tag -width Er .It Bq Er EINVAL Argument -.Ar acl_p +.Fa acl_p does not point to a pointer to a valid ACL. .It Bq Er ENOMEM The ACL working storage requires more memory than is diff --git a/lib/libc/posix1e/acl_delete_perm.3 b/lib/libc/posix1e/acl_delete_perm.3 index 0a76623d4fa6..1fbb51ed8d58 100644 --- a/lib/libc/posix1e/acl_delete_perm.3 +++ b/lib/libc/posix1e/acl_delete_perm.3 @@ -30,7 +30,7 @@ .Os .Sh NAME .Nm acl_delete_perm -.Nd Delete permissions from a permission set +.Nd delete permissions from a permission set .Sh LIBRARY .Lb libposix1e .Sh SYNOPSIS @@ -41,34 +41,22 @@ .Sh DESCRIPTION .Fn acl_delete_perm is a POSIX.1e call that removes specific permissions from permissions set -.Ar perm . +.Fa perm . .Sh RETURN VALUES -Upon successful completion, the function will return a value of -.Va 0 . -Otherwise, a value of -.Va -1 -will be returned, and -.Va errno -will be set to indicate the error. +.Rv -std acl_delete_perm .Sh ERRORS -If one of the following conditions occur, the +The .Fn acl_delete_perm -function will return a value of -.Va -1 -and set -.Va errno -to the corresponding value: +function fails if: .Bl -tag -width Er .It Bq Er EINVAL Argument -.Ar permset_d +.Fa permset_d is not a valid descriptor for a permission set. Argument -.Ar perm +.Fa perm does not contain a valid -.Ar acl_perm_t +.Vt acl_perm_t value. -.It Bq Er ENOSYS -This function is not supported by the implementation. .El .Sh SEE ALSO .Xr acl 3 , diff --git a/lib/libc/posix1e/acl_get_permset.3 b/lib/libc/posix1e/acl_get_permset.3 index 512246c19488..b607257bebda 100644 --- a/lib/libc/posix1e/acl_get_permset.3 +++ b/lib/libc/posix1e/acl_get_permset.3 @@ -30,7 +30,7 @@ .Os .Sh NAME .Nm acl_get_permset -.Nd Retrieve permset from an ACL entry +.Nd retrieve permission set from an ACL entry .Sh LIBRARY .Lb libposix1e .Sh SYNOPSIS @@ -41,32 +41,21 @@ .Sh DESCRIPTION .Fn acl_get_permset is a POSIX.1e call that returns via -.Ar permset_p +.Fa permset_p a descriptor to the permission set in the ACL entry -.Ar entry_d . +.Fa entry_d . Subsequent operations using the returned permission set operate on the permission set within the ACL entry. -.Ar perm . .Sh RETURN VALUES -Upon successful completion, the function will return a value of -.Va 0 . -Otherwise, a value of -.Va -1 -will be returned, and -.Va errno -will be set to indicate the error. +.Rv -std acl_get_permset .Sh ERRORS -If the following condition occurs, the +The .Fn acl_get_permset -function will return a value of -.Va -1 -and set -.Va errno -to the corresponding value: +function fails if: .Bl -tag -width Er .It Bq Er EINVAL Argument -.Ar entry_d +.Fa entry_d is not a valid descriptor for an ACL entry. .El .Sh SEE ALSO diff --git a/lib/libc/posix1e/acl_get_tag_type.3 b/lib/libc/posix1e/acl_get_tag_type.3 index a438e1730075..8294e1ae3087 100644 --- a/lib/libc/posix1e/acl_get_tag_type.3 +++ b/lib/libc/posix1e/acl_get_tag_type.3 @@ -30,42 +30,32 @@ .Os .Sh NAME .Nm acl_get_tag_type -.Nd Calculate and set ACL mask permissions +.Nd calculate and set ACL mask permissions .Sh LIBRARY .Lb libposix1e .Sh SYNOPSIS .Fd #include .Fd #include .Ft int -.Fn acl_get_tag_type "acl_entry_t entry_d, acl_tag_t *tag_type_p" +.Fn acl_get_tag_type "acl_entry_t entry_d" "acl_tag_t *tag_type_p" .Sh DESCRIPTION .Fn acl_get_tag_type is a POSIX.1e call that returs the tag type for the ACL entry -.Ar entry_d . +.Fa entry_d . Upon successful completion, the location referred to by the argument -.Ar tag_type_p +.Fa tag_type_p will be set to the tag type of the ACL entry -.Ar entry_d . +.Fa entry_d . .Sh RETURN VALUES -Upon successful completion, the function will return a value of -.Va 0 . -Otherwise, a value of -.Va -1 -will be returned, and -.Va errno -will be set to indicate the error. +.Rv -std acl_get_tag_type .Sh ERRORS -If any of the following conditions occur, the +The .Fn acl_get_tag_type -function will return a value of -.Va -1 -and set -.Va errno -to the corresponding value: +function fails if: .Bl -tag -width Er .It Bq Er EINVAL Argument -.Ar entry_d +.Fa entry_d is not a valid descriptor for an ACL entry; .El .Sh SEE ALSO diff --git a/lib/libc/posix1e/acl_set_qualifier.3 b/lib/libc/posix1e/acl_set_qualifier.3 index 430c19467503..6df659e0f90f 100644 --- a/lib/libc/posix1e/acl_set_qualifier.3 +++ b/lib/libc/posix1e/acl_set_qualifier.3 @@ -30,45 +30,39 @@ .Os .Sh NAME .Nm acl_set_qualifier -.Nd Set ACL tag qualifier +.Nd set ACL tag qualifier .Sh LIBRARY .Lb libposix1e .Sh SYNOPSIS .Fd #include .Fd #include .Ft int -.Fn acl_set_qualifier "acl_entry_t entry_d, const void *tag_qualifier_p" +.Fn acl_set_qualifier "acl_entry_t entry_d" "const void *tag_qualifier_p" .Sh DESCRIPTION .Fn acl_set_qualifier is a POSIX.1e call that sets the qualifier of the tag for the ACl entry -.Ar entry_d +.Fa entry_d to the value referred to by -.Ar tag_qualifier_p . +.Fa tag_qualifier_p . .Sh RETURN VALUES -Upon successful completion, the function will return a value of -.Va 0 . -Otherwise, a value of -.Va -1 -will be returned, and -.Va errno -will be set to indicate the error. +.Rv -std acl_set_qualifier .Sh ERRORS -If any of the following conditions occur, the +The .Fn acl_set_qualifier -function will return a value of -.Va -1 -and set -.Va errno -to the corresponding value: +function fails if: .Bl -tag -width Er .It Bq Er EINVAL Argument -.Ar entry_d +.Fa entry_d is not a valid descriptor for an ACL entry. The tag type of the ACL entry -.Ar entry_d -is not ACL_USER or ACL_GROUP. The value pointed to by -.Ar tag_qualifier_p +.Fa entry_d +is not +.Dv ACL_USER +or +.Dv ACL_GROUP . +The value pointed to by +.Fa tag_qualifier_p is not valid. .It Bq Er ENOMEM The value to be returned requires more memory than is allowed diff --git a/lib/libposix1e/acl_add_perm.3 b/lib/libposix1e/acl_add_perm.3 index 7354d2398c2b..88b22fb9f7ec 100644 --- a/lib/libposix1e/acl_add_perm.3 +++ b/lib/libposix1e/acl_add_perm.3 @@ -30,48 +30,38 @@ .Os .Sh NAME .Nm acl_add_perm -.Nd Add permissions to a permission set +.Nd add permissions to a permission set .Sh LIBRARY .Lb libposix1e .Sh SYNOPSIS .Fd #include .Fd #include .Ft int -.Fn acl_add_perm "acl_permset_t permset_d, acl_perm_t perm" +.Fn acl_add_perm "acl_permset_t permset_d" "acl_perm_t perm" .Sh DESCRIPTION .Fn acl_add_perm is a POSIX.1e call that adds the permission contained in -.Ar perm +.Fa perm to the permission set -.Ar permset_d . +.Fa permset_d . .Pp Note: it is not considered an error to attempt to add permissions that already exist in the permission set. .Sh RETURN VALUES -Upon successful completion, the function will return a value of -.Va 0 . -Otherwise, a value of -.Va -1 -will be returned, and -.Va errno -will be set to indicate the error. +.Rv -std acl_add_perm .Sh ERRORS -If any of the following conditions occur, the +The .Fn acl_add_perm -function will return a value of -.Va -1 -and set -.Va errno -to the corresponding value: +function fails if: .Bl -tag -width Er .It Bq Er EINVAL Argument -.Ar permset_d +.Fa permset_d is not a valid descriptor for a permission set within an ACL entry. Argument -.Ar perm +.Fa perm does not contain a valid -.Ar acl_perm_t +.Vt acl_perm_t value. .El .Sh SEE ALSO diff --git a/lib/libposix1e/acl_clear_perms.3 b/lib/libposix1e/acl_clear_perms.3 index d41ab3ee002a..1e327c85a2d9 100644 --- a/lib/libposix1e/acl_clear_perms.3 +++ b/lib/libposix1e/acl_clear_perms.3 @@ -26,11 +26,11 @@ .\" $FreeBSD$ .\" .Dd March 10, 2001 -.Dt ACL_CLEAR_PERM 3 +.Dt ACL_CLEAR_PERMS 3 .Os .Sh NAME .Nm acl_clear_perms -.Nd Clear permissions from a permission set +.Nd clear permissions from a permission set .Sh LIBRARY .Lb libposix1e .Sh SYNOPSIS @@ -41,27 +41,17 @@ .Sh DESCRIPTION .Fn acl_clear_perms is a POSIX.1e call that clears all permissions from permissions set -.Ar perm . +.Fa permset_d . .Sh RETURN VALUES -Upon successful completion, the function will return a value of -.Va 0 . -Otherwise, a value of -.Va -1 -will be returned, and -.Va errno -will be set to indicate the error. +.Rv -std acl_clear_perms .Sh ERRORS -If the following condition occurs, the +The .Fn acl_clear_perms -function will return a value of -.Va -1 -and set -.Va errno -to the corresponding value: +function fails if: .Bl -tag -width Er .It Bq Er EINVAL Argument -.Ar permset_d +.Fa permset_d is not a valid descriptor for a permission set. .El .Sh SEE ALSO diff --git a/lib/libposix1e/acl_copy_entry.3 b/lib/libposix1e/acl_copy_entry.3 index 5e18e60087e6..ce8d60f4362c 100644 --- a/lib/libposix1e/acl_copy_entry.3 +++ b/lib/libposix1e/acl_copy_entry.3 @@ -30,7 +30,7 @@ .Os .Sh NAME .Nm acl_copy_entry -.Nd Copy an ACL entry to another ACL entry +.Nd copy an ACL entry to another ACL entry .Sh LIBRARY .Lb libposix1e .Sh SYNOPSIS @@ -41,36 +41,26 @@ .Sh DESCRIPTION .Fn acl_copy_entry is a POSIX.1e call that copies the contents of ACL entry -.Ar src_d +.Fa src_d to ACL entry -.Ar dest_d . +.Fa dest_d . .Sh RETURN VALUES -Upon successful completion, the function will return a value of -.Va 0 . -Otherwise, a value of -.Va -1 -will be returned, and -.Va errno -will be set to indicate the error. +.Rv -std acl_copy_entry .Sh ERRORS -If any of the following conditions occur, the +The .Fn acl_copy_entry -function will return a value of -.Va -1 -and set -.Va errno -to the corresponding value: +function fails if: .Bl -tag -width Er .It Bq Er EINVAL Argument -.Ar src_d +.Fa src_d or -.Ar dest_d +.Fa dest_d is not a valid descriptor for an ACL entry, or arguments -.Ar src_d +.Fa src_d and -.Ar dest_d +.Fa dest_d reference the same ACL entry. .El .Sh SEE ALSO diff --git a/lib/libposix1e/acl_create_entry.3 b/lib/libposix1e/acl_create_entry.3 index c1e8cd34cabb..1b94312a23de 100644 --- a/lib/libposix1e/acl_create_entry.3 +++ b/lib/libposix1e/acl_create_entry.3 @@ -30,7 +30,7 @@ .Os .Sh NAME .Nm acl_create_entry -.Nd Create a new ACL entry +.Nd create a new ACL entry .Sh LIBRARY .Lb libposix1e .Sh SYNOPSIS @@ -42,27 +42,17 @@ .Fn acl_create_entry is a POSIX.1e call that creates a new ACL entry in the ACL pointed to by -.Ar acl_p. +.Fa acl_p . .Sh RETURN VALUES -Upon successful completion, the function will return a value of -.Va 0 . -Otherwise, a value of -.Va -1 -will be returned, and -.Va errno -will be set to indicate the error. +.Rv -std acl_create_entry .Sh ERRORS -If one of the following conditions occur, the +The .Fn acl_create_entry -function will return a value of -.Va -1 -and set -.Va errno -to the corresponding value: +function fails if: .Bl -tag -width Er .It Bq Er EINVAL Argument -.Ar acl_p +.Fa acl_p does not point to a pointer to a valid ACL. .It Bq Er ENOMEM The ACL working storage requires more memory than is diff --git a/lib/libposix1e/acl_delete_perm.3 b/lib/libposix1e/acl_delete_perm.3 index 0a76623d4fa6..1fbb51ed8d58 100644 --- a/lib/libposix1e/acl_delete_perm.3 +++ b/lib/libposix1e/acl_delete_perm.3 @@ -30,7 +30,7 @@ .Os .Sh NAME .Nm acl_delete_perm -.Nd Delete permissions from a permission set +.Nd delete permissions from a permission set .Sh LIBRARY .Lb libposix1e .Sh SYNOPSIS @@ -41,34 +41,22 @@ .Sh DESCRIPTION .Fn acl_delete_perm is a POSIX.1e call that removes specific permissions from permissions set -.Ar perm . +.Fa perm . .Sh RETURN VALUES -Upon successful completion, the function will return a value of -.Va 0 . -Otherwise, a value of -.Va -1 -will be returned, and -.Va errno -will be set to indicate the error. +.Rv -std acl_delete_perm .Sh ERRORS -If one of the following conditions occur, the +The .Fn acl_delete_perm -function will return a value of -.Va -1 -and set -.Va errno -to the corresponding value: +function fails if: .Bl -tag -width Er .It Bq Er EINVAL Argument -.Ar permset_d +.Fa permset_d is not a valid descriptor for a permission set. Argument -.Ar perm +.Fa perm does not contain a valid -.Ar acl_perm_t +.Vt acl_perm_t value. -.It Bq Er ENOSYS -This function is not supported by the implementation. .El .Sh SEE ALSO .Xr acl 3 , diff --git a/lib/libposix1e/acl_get_permset.3 b/lib/libposix1e/acl_get_permset.3 index 512246c19488..b607257bebda 100644 --- a/lib/libposix1e/acl_get_permset.3 +++ b/lib/libposix1e/acl_get_permset.3 @@ -30,7 +30,7 @@ .Os .Sh NAME .Nm acl_get_permset -.Nd Retrieve permset from an ACL entry +.Nd retrieve permission set from an ACL entry .Sh LIBRARY .Lb libposix1e .Sh SYNOPSIS @@ -41,32 +41,21 @@ .Sh DESCRIPTION .Fn acl_get_permset is a POSIX.1e call that returns via -.Ar permset_p +.Fa permset_p a descriptor to the permission set in the ACL entry -.Ar entry_d . +.Fa entry_d . Subsequent operations using the returned permission set operate on the permission set within the ACL entry. -.Ar perm . .Sh RETURN VALUES -Upon successful completion, the function will return a value of -.Va 0 . -Otherwise, a value of -.Va -1 -will be returned, and -.Va errno -will be set to indicate the error. +.Rv -std acl_get_permset .Sh ERRORS -If the following condition occurs, the +The .Fn acl_get_permset -function will return a value of -.Va -1 -and set -.Va errno -to the corresponding value: +function fails if: .Bl -tag -width Er .It Bq Er EINVAL Argument -.Ar entry_d +.Fa entry_d is not a valid descriptor for an ACL entry. .El .Sh SEE ALSO diff --git a/lib/libposix1e/acl_get_tag_type.3 b/lib/libposix1e/acl_get_tag_type.3 index a438e1730075..8294e1ae3087 100644 --- a/lib/libposix1e/acl_get_tag_type.3 +++ b/lib/libposix1e/acl_get_tag_type.3 @@ -30,42 +30,32 @@ .Os .Sh NAME .Nm acl_get_tag_type -.Nd Calculate and set ACL mask permissions +.Nd calculate and set ACL mask permissions .Sh LIBRARY .Lb libposix1e .Sh SYNOPSIS .Fd #include .Fd #include .Ft int -.Fn acl_get_tag_type "acl_entry_t entry_d, acl_tag_t *tag_type_p" +.Fn acl_get_tag_type "acl_entry_t entry_d" "acl_tag_t *tag_type_p" .Sh DESCRIPTION .Fn acl_get_tag_type is a POSIX.1e call that returs the tag type for the ACL entry -.Ar entry_d . +.Fa entry_d . Upon successful completion, the location referred to by the argument -.Ar tag_type_p +.Fa tag_type_p will be set to the tag type of the ACL entry -.Ar entry_d . +.Fa entry_d . .Sh RETURN VALUES -Upon successful completion, the function will return a value of -.Va 0 . -Otherwise, a value of -.Va -1 -will be returned, and -.Va errno -will be set to indicate the error. +.Rv -std acl_get_tag_type .Sh ERRORS -If any of the following conditions occur, the +The .Fn acl_get_tag_type -function will return a value of -.Va -1 -and set -.Va errno -to the corresponding value: +function fails if: .Bl -tag -width Er .It Bq Er EINVAL Argument -.Ar entry_d +.Fa entry_d is not a valid descriptor for an ACL entry; .El .Sh SEE ALSO diff --git a/lib/libposix1e/acl_set_qualifier.3 b/lib/libposix1e/acl_set_qualifier.3 index 430c19467503..6df659e0f90f 100644 --- a/lib/libposix1e/acl_set_qualifier.3 +++ b/lib/libposix1e/acl_set_qualifier.3 @@ -30,45 +30,39 @@ .Os .Sh NAME .Nm acl_set_qualifier -.Nd Set ACL tag qualifier +.Nd set ACL tag qualifier .Sh LIBRARY .Lb libposix1e .Sh SYNOPSIS .Fd #include .Fd #include .Ft int -.Fn acl_set_qualifier "acl_entry_t entry_d, const void *tag_qualifier_p" +.Fn acl_set_qualifier "acl_entry_t entry_d" "const void *tag_qualifier_p" .Sh DESCRIPTION .Fn acl_set_qualifier is a POSIX.1e call that sets the qualifier of the tag for the ACl entry -.Ar entry_d +.Fa entry_d to the value referred to by -.Ar tag_qualifier_p . +.Fa tag_qualifier_p . .Sh RETURN VALUES -Upon successful completion, the function will return a value of -.Va 0 . -Otherwise, a value of -.Va -1 -will be returned, and -.Va errno -will be set to indicate the error. +.Rv -std acl_set_qualifier .Sh ERRORS -If any of the following conditions occur, the +The .Fn acl_set_qualifier -function will return a value of -.Va -1 -and set -.Va errno -to the corresponding value: +function fails if: .Bl -tag -width Er .It Bq Er EINVAL Argument -.Ar entry_d +.Fa entry_d is not a valid descriptor for an ACL entry. The tag type of the ACL entry -.Ar entry_d -is not ACL_USER or ACL_GROUP. The value pointed to by -.Ar tag_qualifier_p +.Fa entry_d +is not +.Dv ACL_USER +or +.Dv ACL_GROUP . +The value pointed to by +.Fa tag_qualifier_p is not valid. .It Bq Er ENOMEM The value to be returned requires more memory than is allowed