The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]

Интерактивная система просмотра системных руководств (man-ов)

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

listxattr (2)
  • >> listxattr (2) ( Русские man: Системные вызовы )
  • listxattr (2) ( Linux man: Системные вызовы )
  •  

    НАЗВАНИЕ

    listxattr, llistxattr, flistxattr - выводит список названий расширенных атрибутов  

    СИНТАКСИС

    #include <sys/types.h>
    #include <attr/xattr.h>
    
    ssize_t listxattr (const char *path,
    				 char *list, size_t size);
    ssize_t llistxattr (const char *path,
    				 char *list, size_t size);
    ssize_t flistxattr (int filedes,
    				 char *list, size_t size);
    
     

    ОПИСАНИЕ

    Расширенные атрибуты являются парами name:value ассоциированными с записями inode (файлы, каталоги, символьные ссылки и т.п.). Они являются расширениями к обычным атрибутам, ассоциированными со всеми записями inode в системе (например, данные stat(2)). Полный обзор концепции расширенных атрибутов можно посмотреть в attr(5).

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

    llistxattr идентично listxattr, за исключением случая символьной ссылки, где список названий расширенных атрибутов ассоциируется с самой полученной ссылкой, а не с файлом, на который они ссылаются.

    flistxattr идентично listxattr, только открываемый файл, на который указывает filedes (возвращаемый от open(2)) рассматривается вместо path.

    Расширенный атрибут name является просто строкой, заканчивающейся NULL. Имя включает префикс пространства имен - их может быть несколько, разрозненные пространства ассоциируются с разными записями inode.

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

     

    ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ

    Список list названий возвращается в виде неупорядоченного массива символьных строк, заканчивающихся NULL (названия атрибутов разделяются символами NULL), например:
    user.name1\0system.name1\0user.name2\0
    
    Файловые системы ext2, ext3 и XFS, реализующие ACL стандарта POSIX, используя расширенные атрибуты, должны возвращать список list в таком виде:
    system.posix_acl_access\0system.posix_acl_default\0
    
     

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

    При успешном завершении работы возвращается положительное число, обозначая размер списка названий расширенных атрибутов. При ошибках возвращается -1 и errno устанавливается соответственно ошибке.

    Если размер size буфера значения value слишком мал для хранения результата, то errno устанавливается в ERANGE.

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

    Ошибки, документированные для системного вызова stat(2) также применимы и тут.  

    АВТОРЫ

    Andreas Gruenbacher, <a.gruenbacher@computer.org> и команда разработчиков SGI XFS, <linux-xfs@oss.sgi.com>. Пожалуйста, отправляйте все замечания или сообщения по ошибкам на этот адрес.  

    СМ. ТАКЖЕ

    getfattr(1), setfattr(1), open(2), stat(2), getxattr(2), setxattr(2), removexattr(2), attr(5).


     

    Index

    НАЗВАНИЕ
    СИНТАКСИС
    ОПИСАНИЕ
    ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ
    ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ
    АВТОРЫ
    СМ. ТАКЖЕ


    Поиск по тексту MAN-ов: 




    Партнёры:
    PostgresPro
    Inferno Solutions
    Hosting by Hoster.ru
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2024 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру