Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for attr_removef (redhat section 3)

ATTR_REMOVE(3)					XFS Compatibility API				       ATTR_REMOVE(3)

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 filesys- tem 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
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). Dec 2001 Extended Attributes ATTR_REMOVE(3)


All times are GMT -4. The time now is 10:05 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password