18
19 DESCRIPTION
20 The acl_totext() function converts an internal ACL representation
21 pointed to by aclp into an external ACL representation. The memory for
22 the external text string is obtained using malloc(3C). The caller is
23 responsible for freeing the memory upon completion.
24
25
26 The format of the external ACL is controlled by the flags argument.
27 Values for flags are constructed by a bitwise-inclusive-OR of flags
28 from the following list, defined in <sys/acl.h>.
29
30 ACL_COMPACT_FMT
31 For NFSv4 ACLs, the ACL entries will be formatted
32 using the compact ACL format detailed in ls(1) for
33 the -V option.
34
35
36 ACL_APPEND_ID
37 Append the uid or gid for additional user or group
38 entries. This flag is used to construt ACL entries
39 in a manner that is suitable for archive utilities
40 such as tar(1). When the ACL is translated from the
41 external format to internal representation using
42 acl_fromtext(), the appended ID will be used to
43 populate the uid or gid field of the ACL entry when
44 the user or group name does not exist on the host
45 system. The appended id will be ignored when the
46 user or group name does exist on the system.
47
48
49 ACL_SID_FMT
50 For NFSv4 ACLs, the ACL entries for user or group
51 entries will use the usersid or groupsid format when
52 the "id" field in the ACL entry is an ephemeral uid
53 or gid. The raw sid format will only be used when
54 the "id" cannot be resolved to a windows name.
55
56
57
58 The acl_fromtext() function converts an external ACL representation
|
18
19 DESCRIPTION
20 The acl_totext() function converts an internal ACL representation
21 pointed to by aclp into an external ACL representation. The memory for
22 the external text string is obtained using malloc(3C). The caller is
23 responsible for freeing the memory upon completion.
24
25
26 The format of the external ACL is controlled by the flags argument.
27 Values for flags are constructed by a bitwise-inclusive-OR of flags
28 from the following list, defined in <sys/acl.h>.
29
30 ACL_COMPACT_FMT
31 For NFSv4 ACLs, the ACL entries will be formatted
32 using the compact ACL format detailed in ls(1) for
33 the -V option.
34
35
36 ACL_APPEND_ID
37 Append the uid or gid for additional user or group
38 entries. This flag is used to construct ACL entries
39 in a manner that is suitable for archive utilities
40 such as tar(1). When the ACL is translated from the
41 external format to internal representation using
42 acl_fromtext(), the appended ID will be used to
43 populate the uid or gid field of the ACL entry when
44 the user or group name does not exist on the host
45 system. The appended id will be ignored when the
46 user or group name does exist on the system.
47
48
49 ACL_SID_FMT
50 For NFSv4 ACLs, the ACL entries for user or group
51 entries will use the usersid or groupsid format when
52 the "id" field in the ACL entry is an ephemeral uid
53 or gid. The raw sid format will only be used when
54 the "id" cannot be resolved to a windows name.
55
56
57
58 The acl_fromtext() function converts an external ACL representation
|