attr_remove, attr_removef - remove a user attribute of a
filesystem object
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 associ
ated 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 compo
nent of the path prefix.
[EINVAL] A bit was set in the flag argument that
is not defined for this system call.
space of the process.
[ELOOP] A path name lookup involved too many sym
bolic 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.
DIAGNOSTICS
Upon successful completion, a value of 0 is returned.
Otherwise, a value of -1 is returned and errno is set to
indicate the error.
SEE ALSO
attr(1), attr_get(3), attr_multi(3), and attr_set(3).
Man(1) output converted with
man2html