---
name: "acl_add_flag_np"
section: "3"
platform: "freebsd"
package: "base"
version: "16.0-CURRENT-20261027-61c70dc16a79"
release: "FreeBSD 16.0-CURRENT (2026-10-27)"
platforms: ["freebsd", "macos"]
url: "https://new.carta.tech/acl_add_flag_np"
---

# acl\_add\_flag\_np(3)

add flags to a flagset

## 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; otherwise 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/3.md), [acl\_clear\_flags\_np(3)](/acl_clear_flags_np/3.md), [acl\_delete\_flag\_np(3)](/acl_delete_flag_np/3.md), [acl\_get\_flagset\_np(3)](/acl_get_flagset_np/3.md), [acl\_set\_flagset\_np(3)](/acl_set_flagset_np/3.md), [posix1e(3)](/posix1e/3.md)

## 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*⟩.