Deleted Added
full compact
acl_create_entry.3 (184607) acl_create_entry.3 (194955)
1.\"-
2.\" Copyright (c) 2001 Chris D. Faulhaber
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright

--- 9 unchanged lines hidden (view full) ---

18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24.\" SUCH DAMAGE.
25.\"
1.\"-
2.\" Copyright (c) 2001 Chris D. Faulhaber
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright

--- 9 unchanged lines hidden (view full) ---

18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24.\" SUCH DAMAGE.
25.\"
26.\" $FreeBSD: head/lib/libc/posix1e/acl_create_entry.3 184607 2008-11-04 00:20:43Z imp $
26.\" $FreeBSD: head/lib/libc/posix1e/acl_create_entry.3 194955 2009-06-25 12:46:59Z trasz $
27.\"
28.Dd March 16, 2001
29.Dt ACL_CREATE_ENTRY 3
30.Os
31.Sh NAME
32.Nm acl_create_entry
27.\"
28.Dd March 16, 2001
29.Dt ACL_CREATE_ENTRY 3
30.Os
31.Sh NAME
32.Nm acl_create_entry
33.Nm acl_create_entry_np
33.Nd create a new ACL entry
34.Sh LIBRARY
35.Lb libc
36.Sh SYNOPSIS
37.In sys/types.h
38.In sys/acl.h
39.Ft int
40.Fn acl_create_entry "acl_t *acl_p" "acl_entry_t *entry_p"
34.Nd create a new ACL entry
35.Sh LIBRARY
36.Lb libc
37.Sh SYNOPSIS
38.In sys/types.h
39.In sys/acl.h
40.Ft int
41.Fn acl_create_entry "acl_t *acl_p" "acl_entry_t *entry_p"
42.Ft int
43.Fn acl_create_entry_np "acl_t *acl_p" "acl_entry_t *entry_p" "int index"
41.Sh DESCRIPTION
42The
43.Fn acl_create_entry
44function
45is a POSIX.1e call that creates a new ACL entry in the ACL
46pointed to by
47.Fa acl_p .
44.Sh DESCRIPTION
45The
46.Fn acl_create_entry
47function
48is a POSIX.1e call that creates a new ACL entry in the ACL
49pointed to by
50.Fa acl_p .
51The
52.Fn acl_create_entry_np
53function is a non-portable version that creates the ACL entry
54at position
55.Fa index .
56Positions are numbered starting from zero, i.e. calling
57.Fn acl_create_entry_np
58with
59.Fa index
60argument equal to zero will prepend the entry to the ACL.
48.Sh RETURN VALUES
49.Rv -std acl_create_entry
50.Sh ERRORS
51The
52.Fn acl_create_entry
53function fails if:
54.Bl -tag -width Er
55.It Bq Er EINVAL
56Argument
57.Fa acl_p
58does not point to a pointer to a valid ACL.
61.Sh RETURN VALUES
62.Rv -std acl_create_entry
63.Sh ERRORS
64The
65.Fn acl_create_entry
66function fails if:
67.Bl -tag -width Er
68.It Bq Er EINVAL
69Argument
70.Fa acl_p
71does not point to a pointer to a valid ACL.
72Argument
73.Fa index
74is out of bounds.
59.It Bq Er ENOMEM
60The ACL working storage requires more memory than is
61allowed by the hardware or system-imposed memory
62management constraints.
63.El
64.Sh SEE ALSO
65.Xr acl 3 ,
66.Xr acl_delete_entry 3 ,

--- 16 unchanged lines hidden ---
75.It Bq Er ENOMEM
76The ACL working storage requires more memory than is
77allowed by the hardware or system-imposed memory
78management constraints.
79.El
80.Sh SEE ALSO
81.Xr acl 3 ,
82.Xr acl_delete_entry 3 ,

--- 16 unchanged lines hidden ---