man attr_remove – Man page for attr_remove

June 1, 2007 – 1:21 am

ATTR_REMOVE

Section: XFS Compatibility API (3)
Updated: Extended Attributes
Index
Return to Main Contents

---

 

NAME

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 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.

 

DIAGNOSTICS

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),

and
attr_set(3).

---

 

Index

NAME

C SYNOPSIS

DESCRIPTION

DIAGNOSTICS

SEE ALSO

---

Related posts:

1. man attr_list – Man page for attr_list
2. man attr_multif – Man page for attr_multif
3. man mknod – Man page for mknod
4. man chdir – Man page for chdir
5. man sendmsg – Man page for sendmsg
6. man ldap_explode_dn – Man page for ldap_explode_dn
7. man nash – Man page for nash
8. man ftw – Man page for ftw
9. man getfattr – Man page for getfattr
10. man sem_open – Man page for sem_open