User  |  Syst  |  Libr  |  Device  |  Files  |  Other  |  Admin  |  Head  |

---

   attr_removef    ( 3 )

---

---

Имя (Name)

attr_remove, attr_removef - remove a user attribute of a
       filesystem object

---

Синопсис C (C Synopsis)

#include <attr/attributes.h>

       int attr_remove (const char *path, const char *attrname, int flags);

       int attr_removef (int fd, const char *attrname, int flags);

---

Описание (Description)

The attr_remove and attr_removef functions provide a way to
       remove previously created attributes from filesystem objects.

       Path points to a path name for a filesystem object, and fd refers
       to the file descriptor associated with a file.  If the attribute
       attrname exists, the attribute name and value will be removed
       from the fileystem object.  The flags argument can contain the
       following symbols bitwise OR´ed together:

       ATTR_ROOT
              Look for attrname in the root address space, not in the
              user address space.  (limited to use by super-user only)

       ATTR_DONTFOLLOW
              Do not follow symbolic links when resolving a path on an
              attr_remove function call.  The default is to follow
              symbolic links.

       attr_remove will fail if one or more of the following are true:

       [ENOATTR]
              The attribute name given is not associated with the
              indicated filesystem object.

       [ENOENT]
              The named file does not exist.

       [EPERM]
              The effective user ID does not match the owner of the file
              and the effective user ID is not super-user.

       [ENOTDIR]
              A component of the path prefix is not a directory.

       [EACCES]
              Search permission is denied on a component of the path
              prefix.

       [EINVAL]
              A bit was set in the flag argument that is not defined for
              this system call.

       [EFAULT]
              Path points outside the allocated address space of the
              process.

       [ELOOP]
              A path name lookup involved too many symbolic links.

       [ENAMETOOLONG]
              The length of path exceeds {MAXPATHLEN}, or a pathname
              component is longer than {MAXNAMELEN}.

       attr_removef will fail if:

       [ENOATTR]
              The attribute name given is not associated with the
              indicated filesystem object.

       [EINVAL]
              A bit was set in the flag argument that is not defined for
              this system call, or fd refers to a socket, not a file.

       [EFAULT]
              Attrname points outside the allocated address space of the
              process.

       [EBADF]
              Fd does not refer to a valid descriptor.

---

Диагностика (Diagnostic)

On success, zero is returned.  On error, -1 is returned, and
       errno is set appropriately.

---

Смотри также (See also)

attr(1), attr_get(3), attr_list(3), attr_multi(3), attr_set(3)

---