| acl_add_perm.3 (192638) | acl_add_perm.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_add_perm.3 192638 2009-05-23 13:51:05Z trasz $ | 26.\" $FreeBSD: head/lib/libc/posix1e/acl_add_perm.3 194955 2009-06-25 12:46:59Z trasz $ |
| 27.\" 28.Dd March 10, 2001 29.Dt ACL_ADD_PERM 3 30.Os 31.Sh NAME 32.Nm acl_add_perm 33.Nd add permissions to a permission set 34.Sh LIBRARY --- 12 unchanged lines hidden (view full) --- 47to the permission set 48.Fa permset_d . 49.Pp 50Note: it is not considered an error to attempt to add permissions 51that already exist in the permission set. 52.Pp 53For POSIX.1e ACLs, valid values are: 54.Pp | 27.\" 28.Dd March 10, 2001 29.Dt ACL_ADD_PERM 3 30.Os 31.Sh NAME 32.Nm acl_add_perm 33.Nd add permissions to a permission set 34.Sh LIBRARY --- 12 unchanged lines hidden (view full) --- 47to the permission set 48.Fa permset_d . 49.Pp 50Note: it is not considered an error to attempt to add permissions 51that already exist in the permission set. 52.Pp 53For POSIX.1e ACLs, valid values are: 54.Pp |
| 55.Bl -column -offset 3n "ACL_EXECUTE" | 55.Bl -column -offset 3n "ACL_WRITE_NAMED_ATTRS" |
| 56.It ACL_EXECUTE Execute permission 57.It ACL_WRITE Write permission 58.It ACL_READ Read permission 59.El | 56.It ACL_EXECUTE Execute permission 57.It ACL_WRITE Write permission 58.It ACL_READ Read permission 59.El |
| 60.Pp 61For NFSv4 ACLs, valid values are: 62.Pp 63.Bl -column -offset 3n "ACL_WRITE_NAMED_ATTRS" 64.It ACL_READ_DATA Read permission 65.It ACL_LIST_DIRECTORY Same as ACL_READ_DATA 66.It ACL_WRITE_DATA Write permission, or permission to create files 67.It ACL_ADD_FILE Same as ACL_READ_DATA 68.It ACL_APPEND_DATA Permission to create directories. Ignored for files 69.It ACL_ADD_SUBDIRECTORY Same as ACL_APPEND_DATA 70.It ACL_READ_NAMED_ATTRS Ignored 71.It ACL_WRITE_NAMED_ATTRS Ignored 72.It ACL_EXECUTE Execute permission 73.It ACL_DELETE_CHILD Permission to delete files and subdirectories 74.It ACL_READ_ATTRIBUTES Permission to read basic attributes 75.It ACL_WRITE_ATTRIBUTES Permission to change basic attributes 76.It ACL_DELETE Permission to delete the object this ACL is placed on 77.It ACL_READ_ACL Permission to read ACL 78.It ACL_WRITE_ACL Permission to change the ACL and file mode 79.It ACL_SYNCHRONIZE Ignored 80.El 81.Pp 82Calling 83.Fn acl_add_perm 84with 85.Fa perm 86equal to ACL_WRITE or ACL_READ brands the ACL as POSIX. 87Calling it with ACL_READ_DATA, ACL_LIST_DIRECTORY, ACL_WRITE_DATA, 88ACL_ADD_FILE, ACL_APPEND_DATA, ACL_ADD_SUBDIRECTORY, ACL_READ_NAMED_ATTRS, 89ACL_WRITE_NAMED_ATTRS, ACL_DELETE_CHILD, ACL_READ_ATTRIBUTES, 90ACL_WRITE_ATTRIBUTES, ACL_DELETE, ACL_READ_ACL, ACL_WRITE_ACL 91or ACL_SYNCHRONIZE brands the ACL as NFSv4. |
|
| 60.Sh RETURN VALUES 61.Rv -std acl_add_perm 62.Sh ERRORS 63The 64.Fn acl_add_perm 65function fails if: 66.Bl -tag -width Er 67.It Bq Er EINVAL 68Argument 69.Fa permset_d 70is not a valid descriptor for a permission set within an ACL entry. 71Argument 72.Fa perm 73does not contain a valid 74.Vt acl_perm_t 75value. | 92.Sh RETURN VALUES 93.Rv -std acl_add_perm 94.Sh ERRORS 95The 96.Fn acl_add_perm 97function fails if: 98.Bl -tag -width Er 99.It Bq Er EINVAL 100Argument 101.Fa permset_d 102is not a valid descriptor for a permission set within an ACL entry. 103Argument 104.Fa perm 105does not contain a valid 106.Vt acl_perm_t 107value. |
| 108ACL is already branded differently. |
|
| 76.El 77.Sh SEE ALSO 78.Xr acl 3 , 79.Xr acl_clear_perms 3 , 80.Xr acl_delete_perm 3 , | 109.El 110.Sh SEE ALSO 111.Xr acl 3 , 112.Xr acl_clear_perms 3 , 113.Xr acl_delete_perm 3 , |
| 114.Xr acl_get_brand_np 3 , |
|
| 81.Xr acl_get_permset 3 , 82.Xr acl_set_permset 3 , 83.Xr posix1e 3 84.Sh STANDARDS 85POSIX.1e is described in IEEE POSIX.1e draft 17. 86.Sh HISTORY 87POSIX.1e support was introduced in 88.Fx 4.0 . 89The 90.Fn acl_add_perm 91function was added in 92.Fx 5.0 . 93.Sh AUTHORS 94The 95.Fn acl_add_perm 96function was written by 97.An Chris D. Faulhaber Aq jedgar@fxp.org . | 115.Xr acl_get_permset 3 , 116.Xr acl_set_permset 3 , 117.Xr posix1e 3 118.Sh STANDARDS 119POSIX.1e is described in IEEE POSIX.1e draft 17. 120.Sh HISTORY 121POSIX.1e support was introduced in 122.Fx 4.0 . 123The 124.Fn acl_add_perm 125function was added in 126.Fx 5.0 . 127.Sh AUTHORS 128The 129.Fn acl_add_perm 130function was written by 131.An Chris D. Faulhaber Aq jedgar@fxp.org . |