Rand Stats



Actions Status


File::ExtendedAttributes - access extended attributes of files


use File::ExtendedAttributes;

say list-attributes($path);

set-attribute($path, "user.test", "hello world");

say get-attribute($path, "user.test"); # as a str
say get-attribute($path, "user.test", :bin); # as a blob

remove-attribute($path, "user.test");


File::ExtendedAttributes is a module to provide low-level access to extended attributes on Linux, sometimes known as xattrs. These attributes are used for various metadata stored outside the file itself that can be interpreted by one or more applications.

This feature is well-supported on typical Linux filesystems, but may not be supported in all cases, especially with networked filesystems. Many filesystems generally impose size limits of a single filesystem block (often 1024, 2048, or 4096 bytes), so be frugal with the size of this metadata.

These attributes are conceptually key/value pairs. In Linux, the key must begin with a namespace (typically user) and a period, such as "user.test". The value is an arbitrary string or blob.



Returns a list of attributes defined on the given path.

get-attribute($path, $key, :$bin)

Returns the value of the attribute if present. This value will be decoded as utf-8, unless the :bin parameter is specified.

set-attribute($path, $key, $value)

Sets the specified attribute to the provided value. $value may be a Str or a Blob[uint8]. If $value is a string, it is encoded in utf-8 before being stored.

remove-attribute($path, $key)

Removes the given attribute. If the specified attribute does not exist, then an error is thrown (errno is ENODATA).


If an error occurs, die is called with the error message (provided by errno). Error reporting may not be reliable if another thread can overwrite errno.


The commands getfattr/setfattr and attr

The xattr(7) manpage


Adrian Kreher avuserow@gmail.com


Copyright 2022 Adrian Kreher

This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.