xattr_get

(no version information, might be only in CVS)

xattr_get --  Get an extended attribute

Description

string xattr_get ( string path, string name [, int flags])

This function gets a value of an extended attribute named name 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.

Returns string with value or FALSE if attribute doesn't exist.

Example 1. xattr_get() example

The following code checks if system administrator has signed the file.

<?php
$file
= '/usr/local/sbin/some_binary';
$signature = xattr_get($file, 'Root signature', XATTR_ROOT);

/* ... check if $signature is valid ... */

?>

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