summaryrefslogtreecommitdiff
path: root/man/man3/acl_from_mode.3
diff options
context:
space:
mode:
authorNathan Scott <nathans@sgi.com>2002-04-01 08:28:34 +0000
committerNathan Scott <nathans@sgi.com>2002-04-01 08:28:34 +0000
commit286f06f7624d044ed69e0571bf50722fb2f98d45 (patch)
tree2703918cc8937370e9c20b08bf448318df6b4019 /man/man3/acl_from_mode.3
parent813d820ecafa979db7a8e36e31133879f50ac5f5 (diff)
downloadacl-286f06f7624d044ed69e0571bf50722fb2f98d45.tar.gz
fix INSTALL_MAN macro so that mandoc style man pages are grokked also.
Diffstat (limited to 'man/man3/acl_from_mode.3')
-rw-r--r--man/man3/acl_from_mode.368
1 files changed, 36 insertions, 32 deletions
diff --git a/man/man3/acl_from_mode.3 b/man/man3/acl_from_mode.3
index 908c8ec..86d2e43 100644
--- a/man/man3/acl_from_mode.3
+++ b/man/man3/acl_from_mode.3
@@ -14,50 +14,54 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.TH ACL_FROM_MODE 3 "Linux ACL Library" "March 2002" "Access Control Lists"
-.SH NAME
-acl_from_mode \- create an ACL from file permission bits
-.SH LIBRARY
+.Dd March 23, 2002
+.Dt ACL_FROM_MODE 3
+.Os "Linux ACL"
+.Sh NAME
+.Nm acl_from_mode
+.Nd create an ACL from file permission bits
+.Sh LIBRARY
Linux Access Control Lists library (libacl, \-lacl).
-.SH C SYNOPSIS
-.sp
-.nf
-.B #include <sys/types.h>
-.B #include <sys/acl.h>
-.sp
-.B "acl_t acl_from_mode (mode_t \f2mode\f3);"
-.Op
-.SH DESCRIPTION
+.Sh SYNOPSIS
+.In sys/types.h
+.In acl/libacl.h
+.Ft acl_t
+.Fn acl_from_mode "mode_t mode"
+.Sh DESCRIPTION
The
-.B acl_from_mode
+.Fn acl_from_mode
function creates a minimal ACL that contains the three entries with tag
types ACL_USER_OBJ, ACL_GROUP_OBJ, and ACL_OTHER, with permissions
corresponding to the owner, group, and other permission bits of its
argument
-.IR mode .
-.SH RETURN VALUE
+.Va mode .
+.Sh RETURN VALUE
Upon successful completion, this function returns a pointer to the
-working storage. Otherwise, a value of (acl_t)NULL is returned, and
-.B errno
+working storage. Otherwise, a value of
+.Li (acl_t)NULL
+is returned, and
+.Va errno
is set to indicate the error.
-.SH ERRORS
+.Sh ERRORS
If any of the following conditions occur, the
-.B acl_from_mode
-function returns a value of (acl_t)NULL and sets
-.B errno
+.Fn acl_from_mode
+function returns a value of
+.Li (acl_t)NULL
+and sets
+.Va errno
to the corresponding value:
-.TP
-.SM
-\%[ENOMEM]
+.Bl -tag -width Er
+.It Bq Er ENOMEM
The ACL working storage requires more memory than is allowed by the
hardware or system-imposed memory management constraints.
-.SH STANDARDS
+.El
+.Sh STANDARDS
This is a non-portable, Linux specific extension to the ACL manipulation
functions defined in IEEE Std 1003.1e draft 17 (\(lqPOSIX.1e\(rq, abandoned).
-.SH AUTHOR
+.Sh SEE ALSO
+.Xr acl_equiv_mode 3 ,
+.Xr acl_get_file 3 ,
+.Xr acl 5
+.Sh AUTHOR
Written by
-.I "Andreas Gruenbacher"
-<a.gruenbacher@computer.org>.
-.SH SEE ALSO
-.BR acl_equiv_mode (3),
-.BR acl (5)
+.An "Andreas Gruenbacher" Aq a.gruenbacher@computer.org .