attr - расширенные атрибуты объектов файловой системы XFS
attr [ -LRSq ] -s attrname [ -V attrvalue ] pathname
attr [ -LRSq ] -g attrname pathname
attr [ -LRSq ] -r attrname pathname
attr [ -LRSq ] -l pathname
Расширенные атрибуты позволяют пользователю присоединять пары имя:значение к объектам в файловой системе XFS.
В этом документе описывается команда attr, которая в основном совместима с одноименной командой IRIX. Таким образом, он предназначен специально для пользователей файловой системы XFS — для независимой от файловой системы расширенной работы с атрибутами обратитесь к документации getfattr(1) и setfattr(1).
Расширенные атрибуты могут использоваться для хранения метаинформации о файле. Например, «character-set=kanji» может указать браузеру документа использовать набор символов Kanji при отображении этого документа, а «thumbnail=...» может предоставить обзор графического изображения с высоким разрешением в уменьшенном разрешении.
В файловой системе XFS имена могут иметь длину до 256 байт и заканчиваться первым 0 байтом. Цель состоит в том, чтобы они были печатными именами ASCII (или другого набора символов) для атрибута. значения могут содержать до 64 КБ произвольных двоичных данных.
Атрибуты могут быть прикреплены ко всем типам индексных дескрипторов XFS: обычным файлам, каталогам, символическим ссылкам, узлам устройств и т. д.
XFS использует 2 непересекающихся пространства имен атрибутов, связанных с каждым объектом файловой системы. Это адресные пространства root и user. Адресное пространство root доступно только суперпользователю, и то только при указании флагового аргумента вызова функции. Другие пользователи не увидят и не смогут изменить атрибуты в адресном пространстве root. Адресное пространство user защищено обычным механизмом прав доступа к файлам, поэтому владелец файла может решать, кто может просматривать и/или изменять значения атрибутов любого конкретного файла.
Утилита attr позволяет управлять расширенными атрибутами, связанными с объектами файловой системы, из сценариев оболочки.
attr может выполнять четыре основные операции:
Опция -g attrname указывает attr искать именованный объект и выводить (на стандартный вывод) значение, связанное с этим именем атрибута. С флагом -q stdout будет точно и только значением атрибута, подходящим для хранения непосредственно в файле или обработки с помощью конвейерной команды.
Опция -l сообщает attr, что нужно перечислить имена всех атрибутов, связанных с объектом, и количество байтов в значении каждого из этих атрибутов. С флагом -q стандартный вывод будет представлять собой простой список только имен атрибутов, по одному на строку, пригодных для ввода в сценарий.
Параметр -r attrname указывает attr удалить атрибут с заданным именем из объекта, если атрибут существует. При успешном завершении нет вывода.
Опция -s attrname указывает attr установить для именованного атрибута объекта значение, считанное со стандартного ввода. Если атрибут с таким именем уже существует, его значение будет заменено этим. Если атрибут с таким именем еще не существует, он будет создан с этим значением. С флагом -V attrvalue для атрибута будет установлено значение attrvalue, а стандартный ввод не будет прочитан. С флагом -q стандартный вывод использоваться не будет. Без флага -q будет напечатано сообщение с именем атрибута и полным значением.
Когда указана опция -L и именованный объект является символической ссылкой, оперируйте атрибутами объекта, на который ссылается символическая ссылка. Без этой опции оперируйте атрибутами самой символической ссылки.
Когда указана опция -R и процесс имеет соответствующие привилегии, работайте в пространстве имен атрибута root, а не в пространстве имен атрибута USER.
Параметр -S аналогичен, за исключением того, что он указывает использование пространства имен атрибута security.
Когда указана опция -q, attr будет пытаться хранить молчание. Он будет выводить сообщения об ошибках (на стандартный вывод), но не будет печатать сообщения о состоянии (на стандартный вывод).
Стандартные программы обмена/архивирования файлов tar(1) и cpio(1) не будут архивировать или восстанавливать расширенные атрибуты, в то время как xfsdump( 8) программа будет.
Параметр list, присутствующий в версии этой команды для IRIX, не поддерживается. getfattr предоставляет механизм для получения всех имен атрибутов.
Андреас Грюнбахер, <andreas.gruenbacher@gmail.com> и команда разработчиков SGI XFS, <linux-xfs@oss.sgi.com>.
Пожалуйста, присылайте свои отчеты об ошибках или комментарии по адресу <https://savannah.nongnu.org/bugs/?group=attr> или <acl-devel@nongnu.org>. .
getfattr(1), setfattr(1), attr_get(3), attr_set(3), attr_multi(3), attr_remove(3), attr(5), xfsdump(8)