Sets an extended attribute value.
Extended attributes are name:value pairs associated with inodes (files, directories, symlinks, etc). They are extensions to the normal attributes which are associated with all inodes in the system (i.e. the sys_stat data).
This system call is identical to sys_setxattr except that in a case of a symbolic link the extended attribute is set on the link itself and not the file that it refers to.
Arguments
eax |
227 |
ebx |
Pointer to a null-terminated string that specifies the path. |
ecx |
Pointer to a null-terminated string that specifies the name.
The name attribute includes a namespace prefix; there may be several, disjoint namespaces associated with an individual inode. |
edx |
Pointer to a null-terminated string that specifies the value. |
esi |
Size of the string pointed by edx. |
edi |
Flags. This parameter can be used to refine the semantics of the operation. XATTR_CREATE specifies a pure create, which fails if the named attribute exists already. XATTR_REPLACE specifies a pure replace operation, which fails if the named attribute does not already exist. By default (no flags), the extended attribute will be created if need be, or will simply replace the value if the attribute exists. |
Return values
If the system call succeeds the return value is 0.
If the system call fails the return value is one of the following errno values:
-ENOATTR |
The named attribute does not exist, or the process has no access to this attribute. |
-ENOTSUP |
Extended attributes are not supported by the filesystem, or are disabled. |
-ENOMEM |
Out of memory (i.e. kernel memory). |
-EEXIST |
XATTR_CREATE was specified, and the attribute existed already. |
-ENOATTR |
XATTR_REPLACE was specified, and the attribute didn't exist. |
-ENOSPC |
Insufficient space to store the extended attribute. |
-EDQUOT |
Quota enforcement took place. |
-EACCES |
Search permission is denied for one of the directories in the path prefix. |
-ELOOP |
Too many symbolic links encountered while traversing the path. |
-ENAMETOOLONG |
File name too long. |
-ENOENT |
A component of the path does not exist, or the path is an empty string. |
-ENOTDIR |
A component of the path is not a directory. |
|
Remarks
n/a
Compatibility
n/a
|