---

   flistxattr - выводит список названий расширенных

---

user.name1\0system.name1\0user.name2\0

Файловые системы, реализующие ACL стандарта POSIX с помощью расширенных атрибутов, могут возвращать такой список:

system.posix_acl_access\0system.posix_acl_default\0

---

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

---

ОШИБКИ

E2BIG Размер списка имён атрибутов этого файла превышает определённое в системе ограничение. Смотрите ДЕФЕКТЫ.

ENOTSUP Расширенные атрибуты не поддерживаются файловой системой или отключены.

ERANGE Размер size буфера list слишком мал для хранения результата.

Также могут возникать ошибки, описанные в stat(2).

ВЕРСИИ

---

СООТВЕТСТВИЕ СТАНДАРТАМ

---

ПРИМЕР

Для упрощения кода при выполнении программы ключи атрибутов и значения считаются константами. В реальной программе нужно учитывать и обрабатывать изменения при выполнении программы. Например, количество байт, необходимое для ключей атрибутов, может увеличиваться между двумя вызовами listxattr(). В приложении нужно предусмотреть эту возможность с помощью цикла, который повторяет вызов (возможно, ввести задаваемое максимальное количество попыток) с большим буфером каждый раз при ошибке ERANGE. Вызовы getxattr(2) могут обрабатываться схожим образом.

В следующем выводе был создан файл, заданы некоторые расширенные файловые атрибуты и показан вывод атрибутов с помощью программы-примера.

Пример вывода

$ touch /tmp/foo
$ setfattr -n user.fred -v chocolate /tmp/foo
$ setfattr -n user.frieda -v bar /tmp/foo
$ setfattr -n user.empty /tmp/foo
$ ./listxattr /tmp/foo
user.fred: chocolate
user.frieda: bar
user.empty: <нет значения>

Исходный код программы (listxattr.c)

#include <malloc.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/types.h>
#include <sys/xattr.h>
int
main(int argc, char *argv[])
{
    ssize_t buflen, keylen, vallen;
    char *buf, *key, *val;
    if (argc != 2) {
        fprintf(stderr, "Использование: %s путь\n", argv[0]);
        exit(EXIT_FAILURE);
    }
    /*
     * Определение длины буфера.
     */
    buflen = listxattr(argv[1], NULL, 0);
    if (buflen == -1) {
        perror("listxattr");
        exit(EXIT_FAILURE);
    }
    if (buflen == 0) {
        printf("%s не имеет атрибутов.\n", argv[1]);
        exit(EXIT_SUCCESS);
    }
    /*
     * Выделение буфера.
     */
    buf = malloc(buflen);
    if (buf == NULL) {
        perror("malloc");
        exit(EXIT_FAILURE);
    }
    /*
     * Копирование списка ключей атрибутов в буфер.
     */
    buflen = listxattr(argv[1], buf, buflen);
    if (buflen == -1) {
        perror("listxattr");
        exit(EXIT_FAILURE);
    }
    /*
     * Циклический проход по списку строк (завершающихся 0) с
     * ключей атрибутов. Используется оставшаяся длина буфера для
     * определения конца списка.
     */
    key = buf;
    while (buflen > 0) {
        /*
         * Вывод ключа атрибута.
         */
        printf("%s: ", key);
        /*
         * Определение длины значения.
         */
        vallen = getxattr(argv[1], key, NULL, 0);
        if (vallen == -1)
            perror("getxattr");
        if (vallen > 0) {
            /*
             * Выделение буфера под значения.
             * Один доп. байт нужен для добавляемого 0x00.
             */
            val = malloc(vallen + 1);
            if (val == NULL) {
                perror("malloc");
                exit(EXIT_FAILURE);
            }
            /*
             * Копирование значения в буфер.
             */
            vallen = getxattr(argv[1], key, val, vallen);
            if (vallen == -1)
                perror("getxattr");
            else {
                /*
                 * Вывод значения атрибута.
                 */
                val[vallen] = 0;
                printf("%s", val);
            }
            free(val);
        } else if (vallen == 0)
            printf("<нет значения>");
        printf("\n");
        /*
         * Переход к следующему ключу атрибута.
         */
        keylen = strlen(key) + 1;
        buflen -= keylen;
        key += keylen;
    }
    free(buf);
    exit(EXIT_SUCCESS);
}

ДЕФЕКТЫ