Section 3: library functions
NAME acl_get_perm – test for a permission in an ACL permission set LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In acl/libacl.h Ft int Fn acl_get_perm acl_permset_t permset_d acl_perm_t perm DESCRIPTION The Fn acl_get_perm function tests if the permission specified by the argument perm is contained in the ACL permission set pointed…
NAME acl_get_file – get an ACL by filename LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In sys/acl.h Ft acl_t Fn acl_get_file const char *path_p acl_type_t type DESCRIPTION The Fn acl_get_file function retrieves the access ACL associated with a file or directory, or the default ACL associated with a directory. The pathname…
NAME acl_get_fd – get an ACL by file descriptor LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In sys/acl.h Ft acl_t Fn acl_get_fd int fd DESCRIPTION The Fn acl_get_fd function retrieves the access ACL associated with the file referred to by fd The ACL is placed into working storage and Fn acl_get_fd…
NAME acl_get_entry – get an ACL entry LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In sys/acl.h Ft int Fn acl_get_entry acl_t acl int entry_id acl_entry_t *entry_p DESCRIPTION The Fn acl_get_entry function obtains a descriptor for an ACL entry as specified by entry_id within the ACL indicated by the argument acl If…
NAME acl_from_text – create an ACL from text LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In sys/acl.h Ft acl_t Fn acl_from_text const char *buf_p DESCRIPTION The Fn acl_from_text function converts the text form of the ACL referred to by buf_p into the internal form of an ACL and returns a pointer…
NAME acl_from_mode – create an ACL from file permission bits LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In acl/libacl.h Ft acl_t Fn acl_from_mode mode_t mode DESCRIPTION The 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…
NAME acl_free – release memory allocated to an ACL data object LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In sys/acl.h Ft int Fn acl_free void *obj_p DESCRIPTION The Fn acl_free function frees any releasable memory currently allocated by to the ACL data object identified by obj_p The argument obj_p may identify…
NAME acl_extended_file, acl_extended_file_nofollow – test for information in ACLs by file name LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In acl/libacl.h Ft int Fn acl_extended_file const char *path_p Ft int Fn acl_extended_file_nofollow const char *path_p DESCRIPTION The Fn acl_extended_file function returns 1 if the file or directory referred to by the…
NAME acl_extended_fd – test for information in the ACL by file descriptor LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In acl/libacl.h Ft int Fn acl_extended_fd int fd DESCRIPTION The Fn acl_extended_fd function returns 1 if the file identified by the argument fd is associated with an extended access ACL. The function…
NAME acl_error – convert an ACL error code to a text message LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In acl/libacl.h Ft const char * Fn acl_error int code DESCRIPTION The Fn acl_error function converts an ACL error code such as returned by the Fn acl_check function to a text message…
NAME acl_equiv_mode – check for an equivalent ACL LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In acl/libacl.h Ft int Fn acl_equiv_mode acl_t acl mode_t *mode_p DESCRIPTION The Fn acl_equiv_mode function checks if the ACL pointed to by the argument acl contains only the required ACL entries of tag types ACL_USER_OBJ, ACL_GROUP_OBJ,…
NAME acl_entries – return the number of entries in an ACL LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In acl/libacl.h Ft int Fn acl_entries acl_t acl DESCRIPTION The Fn acl_entries function returns the number of ACL entries that are contained in the ACL referred to by the argument acl RETURN VALUE…
NAME acl_dup – duplicate an ACL LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In sys/acl.h Ft acl_t Fn acl_dup acl_t acl DESCRIPTION The Fn acl_dup function returns a pointer to a copy of the ACL pointed to by acl This function may cause memory to be allocated. The caller should free…
NAME acl_delete_perm – delete a permission from an ACL permission set LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In sys/acl.h Ft int Fn acl_delete_perm acl_permset_t permset_d acl_perm_t perm DESCRIPTION The Fn acl_delete_perm function deletes the permission contained in the argument perm from the permission set referred to by the argument permset_d…
NAME acl_delete_entry – delete an ACL entry LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In sys/acl.h Ft int Fn acl_delete_entry acl_t acl acl_entry_t entry_d DESCRIPTION The Fn acl_delete_entry function removes the ACL entry indicated by the entry_d descriptor from the ACL pointed to by acl Any existing ACL entry descriptors that…
NAME acl_delete_def_file – delete a default ACL by filename LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In sys/acl.h Ft int Fn acl_delete_def_file const char *path_p DESCRIPTION The Fn acl_delete_def_file function deletes a default ACL from the directory whose pathname is pointed to by the argument path_p The effective user ID of…
NAME acl_create_entry – create a new ACL entry LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In sys/acl.h Ft int Fn acl_create_entry acl_t *acl_p acl_entry_t *entry_p DESCRIPTION The Fn acl_create_entry function creates a new ACL entry in the ACL pointed to by the contents of the pointer argument acl_p On success, the…
NAME acl_copy_int – copy an ACL from external to internal representation LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In sys/acl.h Ft acl_t Fn acl_copy_int const void *buf_p DESCRIPTION The Fn acl_copy_int function copies an exportable, contiguous, persistent form of an ACL, pointed to by buf_p to the internal representation. This function…
NAME acl_copy_ext – copy an ACL from internal to external representation LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In sys/acl.h Ft ssize_t Fn acl_copy_ext void *buf_p acl_t acl ssize_t size DESCRIPTION The Fn acl_copy_ext function copies the ACL pointed to by acl from system-managed space to the user managed space pointed…
NAME acl_copy_entry – copy an ACL entry LIBRARY Linux Access Control Lists library (libacl, -lacl). SYNOPSIS In sys/types.h In sys/acl.h Ft int Fn acl_copy_entry acl_entry_t dest_d acl_entry_t src_d DESCRIPTION The Fn acl_copy_entry function copies the contents of the ACL entry indicated by the src_d descriptor to the existing ACL entry indicated by the dest_d descriptor….