PHP Manual
PrevNext

xattr_list

(no version information, might be only in CVS)

xattr_list --  Get a list of extended attributes

Description

array xattr_list ( string path [, int flags])

This functions gets a list of names of extended attributes of a file path.

Extended attributes have two different namespaces: user and root namespace. User namespace is available for all users while root namespace is available only for user with root privileges. xattr operates on user namespace by default, but you can change that using flags argument.

Table 1. Supported xattr flags

XATTR_DONTFOLLOWDo not follow the symbolic link but operate on symbolic link itself.
XATTR_ROOTSet attribute in root (trusted) namespace. Requires root privileges.

This function returns array with names of extended attributes.

Example 1. xattr_list() example

The following code prints names of all extended attributes of file.

<?php
$file = 'some_file';
$root_attributes = xattr_list($file, XATTR_ROOT);
$user_attributes = xattr_list($file);

echo "Root attributes: \n";
foreach ($root_attributes as $attr_name) {
    printf("%s\n", $attr_name);
}

echo "\n User attributes: \n";
foreach ($attributes as $attr_name) {
    printf("%s\n", $attr_name);
}

?>

See also xattr_get(), xattr_set(), xattr_remove(), xattr_supported().

PrevHomeNext
xattr_getUpxattr_remove