d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

mdoc(7) police: fix markup.

Browse Source
This commit is contained in:
Ruslan Ermilov 2001-03-23 09:39:35 +00:00
parent f8376ccd46
commit 8480a1eb14
16 changed files with 144 additions and 302 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
lib/libc/posix1e/acl_add_perm.3
View File

@ -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 <sys/types.h>
.Fd #include <sys/acl.h>
.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

24
lib/libc/posix1e/acl_clear_perms.3
View File

@ -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

30
lib/libc/posix1e/acl_copy_entry.3
View File

@ -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

22
lib/libc/posix1e/acl_create_entry.3
View File

@ -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

28
lib/libc/posix1e/acl_delete_perm.3
View File

@ -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 ,

25
lib/libc/posix1e/acl_get_permset.3
View File

@ -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

28
lib/libc/posix1e/acl_get_tag_type.3
View File

@ -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 <sys/types.h>
.Fd #include <sys/acl.h>
.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

36
lib/libc/posix1e/acl_set_qualifier.3
View File

@ -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 <sys/types.h>
.Fd #include <sys/acl.h>
.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

30
lib/libposix1e/acl_add_perm.3
View File

@ -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 <sys/types.h>
.Fd #include <sys/acl.h>
.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

24
lib/libposix1e/acl_clear_perms.3
View File

@ -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

30
lib/libposix1e/acl_copy_entry.3
View File

@ -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

22
lib/libposix1e/acl_create_entry.3
View File

@ -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

28
lib/libposix1e/acl_delete_perm.3
View File

@ -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 ,

25
lib/libposix1e/acl_get_permset.3
View File

@ -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

28
lib/libposix1e/acl_get_tag_type.3
View File

@ -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 <sys/types.h>
.Fd #include <sys/acl.h>
.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

36
lib/libposix1e/acl_set_qualifier.3
View File

@ -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 <sys/types.h>
.Fd #include <sys/acl.h>
.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