sys_lsetxattr  [fs/xattr.c]


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