acl_add_flag_np(3) - NetBSD Manual Pages

ACL_ADD_FLAG_NP(3)      NetBSD Library Functions Manual     ACL_ADD_FLAG_NP(3)


NAME

     acl_add_flag_np -- add flags to a flagset


LIBRARY

     Standard C Library (libc, -lc)


SYNOPSIS

     #include <sys/types.h>
     #include <sys/acl.h>

     int
     acl_add_flag_np(acl_flagset_t flagset_d, acl_flag_t flag);


DESCRIPTION

     The acl_add_flag_np() function is a non-portable call that adds the NFSv4
     ACL flags contained in flags to the flagset flagset_d.

     Note: it is not considered an error to attempt to add flags that already
     exist in the flagset.

     Valid values are:

        ACL_ENTRY_FILE_INHERIT            Will be inherited by files.
        ACL_ENTRY_DIRECTORY_INHERIT       Will be inherited by directories.
        ACL_ENTRY_NO_PROPAGATE_INHERIT    Will not propagate.
        ACL_ENTRY_INHERIT_ONLY            Inherit-only.
        ACL_ENTRY_INHERITED               Inherited from parent


RETURN VALUES

     The acl_add_flag_np() function returns the value 0 if successful; other-
     wise the value -1 is returned and the global variable errno is set to
     indicate the error.


ERRORS

     The acl_add_flag_np() function fails if:

     [EINVAL]           Argument flagset_d is not a valid descriptor for a
                        flagset within an ACL entry.  Argument flag does not
                        contain a valid acl_flag_t value.


SEE ALSO

     acl(3), acl_clear_flags_np(3), acl_delete_flag_np(3),
     acl_get_flagset_np(3), acl_set_flagset_np(3), posix1e(3)


STANDARDS

     POSIX.1e is described in IEEE POSIX.1e draft 17.


HISTORY

     POSIX.1e support was introduced in FreeBSD 4.0.  The acl_add_flag_np()
     function was added in FreeBSD 8.0.


AUTHORS

     The acl_add_flag_np() function was written by Edward Tomasz Napierala
     <trasz@FreeBSD.org>.

NetBSD 10.99                   September 4, 2015                  NetBSD 10.99