attr

Manipulate extended attributes on filesystem objects

TLDR

Set an extended attribute on a file

$ attr -s [attribute_name] -V [value] [path/to/file]

Get the value of an extended attribute

$ attr -g [attribute_name] [path/to/file]

Remove an extended attribute

$ attr -r [attribute_name] [path/to/file]

List all extended attributes on a file

$ attr -l [path/to/file]

Set attribute in the user namespace

$ setfattr -n user.[attribute_name] -v [value] [path/to/file]

Get all attributes with getfattr

$ getfattr -d [path/to/file]

SYNOPSIS

attr [-LRSq] -s attrname [-V attrvalue] pathnameattr [-LRSq] -g attrname pathnameattr [-LRSq] -r attrname pathnameattr [-LRSq] -l pathname

attr manipulates extended attributes on filesystem objects. Extended attributes are name-value pairs permanently associated with files and directories, providing metadata storage beyond traditional Unix permissions.Attributes exist in namespaces: user for arbitrary user data, system for OS features like ACLs, security for SELinux labels, and trusted for privileged applications. The attr command primarily works with the user namespace.Extended attributes persist across copy and backup operations when tools support them. Common uses include storing file metadata, checksums, capabilities, and application-specific data without modifying file content.The related commands getfattr and setfattr provide more detailed control and are preferred for scripting.

PARAMETERS

-s attrname

Set the named attribute to the value read from stdin. If the attribute already exists, its value is replaced. Combine with -V to supply the value on the command line instead.

-g attrname

Get and print to stdout the value associated with the named attribute.

-r attrname

Remove the named attribute if it exists.

-l

List the names of all attributes on the object together with the number of bytes in each value.

-V attrvalue

Provide the value for a -s operation directly, so stdin is not read.

-L

When the object is a symbolic link, operate on the target of the link rather than the link itself.

-R

Operate in the root (trusted) attribute namespace instead of the default user namespace. Requires privileges.

-S

Operate in the security attribute namespace.

-q

Quiet mode; print error messages to stderr but suppress status messages on stdout.

INSTALL

sudo apt install attr

sudo dnf install attr

sudo pacman -S attr

sudo apk add attr

sudo zypper install attr

brew install attr

nix profile install nixpkgs#attr

CAVEATS

Not all filesystems support extended attributes; ext4, XFS, and Btrfs do when mounted with user_xattr. Attribute size limits vary by filesystem (typically 64KB). Many backup and file transfer tools do not preserve extended attributes by default. The user namespace is limited to processes with read/write access to the file.

HISTORY

Extended attributes were added to Linux in kernel 2.6 (2003), inspired by similar features in IRIX and other Unix systems. The implementation followed the POSIX 1003.1e draft standard for extended security attributes. The attr package providing these utilities has been the standard interface for managing extended attributes since their introduction.

RESOURCES

Source code · Homepage