Linux API. Исчерпывающее руководство полностью

Кроме того, ряд файловых систем накладывают более строгие ограничения на размер и количество EA, которые могут быть ассоциированы с файлом:

• в файловых системах ext2, ext3 и ext4 общее количество байтов, примененных именами и значениями всех расширенных атрибутов какого-либо файла, ограничено размером одного блока логического диска (см. раздел 14.3): 1024, 2048 или 4096 байтами;

• в файловой системе JFS существует верхний предел 128 Кбайт для общего количества байтов, используемых именами и значениями всех EA какого-либо файла.

В этом разделе мы рассмотрим системные вызовы, которые задействуются для обновления, извлечения и удаления расширенных атрибутов.

Создание и изменение расширенных атрибутов

С помощью системных вызовов setxattr(), lsetxattr() и fsetxattr() устанавливается значение какого-либо EA файла.

#include

int setxattr(const char *pathname, const char *name, const void *value,

size_t size, int flags);

int lsetxattr(const char *pathname, const char *name, const void *value,

size_t size, int flags);

int fsetxattr(int fd, const char *name, const void *value,

size_t size, int flags);

Все вызовы возвращают 0 при успешном завершении и –1 при ошибке

Различия между представленными тремя вызовами похожи на те, что существуют между вызовами stat(), lstat() и fstat() (см. раздел 15.1):

• системный вызов setxattr() идентифицирует файл по константе pathname и разыменовывает имя файла, если это символическая ссылка;

• системный вызов lsetxattr() идентифицирует файл по константе pathname, но не разыменовывает символические ссылки;

• системный вызов fsetxattr() идентифицирует файл по открытому дескриптору fd.

Эти же различия применимы и к другим группам системных вызовов, описываемых далее в данном разделе.

Аргумент name — строка с завершающим нулем, которая определяет имя расширенного атрибута. Аргумент value — указатель на буфер, определяющий новое значение для EA. Аргумент size задает длину данного буфера.

По умолчанию эти системные вызовы создают новый расширенный атрибут с заданным именем name, если такого атрибута еще нет, или изменяют значение уже существующего атрибута. Аргумент flags обеспечивает более тонкую настройку указанного поведения. Для него можно либо указать значение 0, чтобы добиться поведения по умолчанию, либо присвоить одну из следующих констант:

• XATTR_CREATE — приводит к ошибке (EEXIST), если EA с заданным именем name уже существует;

• XATTR_REPLACE — приводит к ошибке (ENODATA), если EA с именем name еще не создан.

Рассмотрим пример использования системного вызова setxattr() для создания расширенного атрибута user.

char *value;

value = "The past is not dead.";

if (setxattr(pathname, "user.x", value, strlen(value), 0) == -1)

errExit("setxattr");

Извлечение значения расширенного атрибута

С помощью системных вызовов getxattr(), lgetxattr() и fgetxattr() можно извлечь значение EA.

#include

ssize_t getxattr(const char *pathname, const char *name, void *value,

size_t size);

ssize_t lgetxattr(const char *pathname, const char *name, void *value,

size_t size);

ssize_t fgetxattr(int fd, const char *name, void *value,

size_t size);

Все вызовы возвращают 0 при успешном завершении и –1 при ошибке

Аргумент name является строкой с завершающим нулем, идентифицирующей расширенный атрибут, чье значение мы желаем извлечь. Данное значение возвращается в буфер, на который указывает аргумент value. Буфер должен быть выделен вызывающим процессом, а его длину следует указать в аргументе size. При успешном завершении эти системные вызовы возвращают количество байтов, скопированное в аргумент value.

Если файл не имеет атрибута с указанным именем name, то данные системные вызовы приводят к ошибке ENODATA. Если значение size чересчур мало — то к ошибке ERANGE.

Можно указать для аргумента size значение 0, и тогда аргумент value будет проигнорирован, но системный вызов по-прежнему возвращает размер значения расширенного атрибута. Таким образом обеспечивается механизм определения размера буфера value, который необходим для того, чтобы последующий вызов фактически извлек это значение EA. Однако обратите внимание: у нас по-прежнему нет гарантии того, что возвращаемый размер будет достаточно большим при последующей попытке извлечения значения. Другой процесс мог тем временем присвоить данному атрибуту большее значение или даже удалить сам атрибут.

Удаление расширенного атрибута

Системные вызовы removexattr(), lremovexattr() и fremovexattr() удаляет расширенный атрибут файла.

#include

int removexattr(const char *pathname, const char *name);

int lremovexattr(const char *pathname, const char *name);