Provided by: manpages-ru-dev_4.21.0-2_all bug

ИМЯ

       ioctl_fat - управление файловой системой FAT

LIBRARY

       Standard C library (libc, -lc)

СИНТАКСИС

       #include <linux/msdos_fs.h>     /* Definition of [V]FAT_* and
                                          ATTR_* constants*/"
       #include <sys/ioctl.h>

       int ioctl(int fd, FAT_IOCTL_GET_ATTRIBUTES, uint32_t *attr);
       int ioctl(int fd, FAT_IOCTL_SET_ATTRIBUTES, uint32_t *attr);
       int ioctl(int fd, FAT_IOCTL_GET_VOLUME_ID, uint32_t *id);
       int ioctl(int fd, VFAT_IOCTL_READDIR_BOTH,
                 struct __fat_dirent entry[2]);
       int ioctl(int fd, VFAT_IOCTL_READDIR_SHORT,
                 struct __fat_dirent entry[2]);

ОПИСАНИЕ

       Системный вызов ioctl(2) можно использовать для чтения и записи метаданных файловых систем
       FAT, которые недоступны через другие системные вызовы.

   Чтение и установка файловых атрибутов
       У файлов и каталогов и в файловой системе FAT есть битовая маска атрибутов, которую  можно
       прочитать с помощью FAT_IOCTL_GET_ATTRIBUTES и записать с FAT_IOCTL_SET_ATTRIBUTES.

       Аргумент  fd  содержит  файловый  дескриптор  файла  или  каталога. Для создания файлового
       дескриптора достаточно вызвать open(2) с флагом O_RDONLY.

       Аргумент attr содержит указатель на битовую маску. Назначение битов в маске:

       ATTR_RO
              Данный бит означает, что файл или каталог доступен только для чтения.

       ATTR_HIDDEN
              Данный бит означает, что файл или каталог скрыт.

       ATTR_SYS
              Данный бит означает, что файл является системным.

       ATTR_VOLUME
              Данный бит означает, что файл является меткой тома. Данный атрибут доступен  только
              для чтения.

       ATTR_DIR
              Данный бит означает, что это каталог. Данный атрибут доступен только для чтения.

       ATTR_ARCH
              Данный бит означает, что файл или каталог должны архивироваться. Он устанавливается
              при создании или изменении файла. Он сбрасывается системой архивирования.

       Нулевое значение ATTR_NONE можно использовать для указания,  что  все  биты  атрибутов  не
       установлены.

   Чтение идентификатора тома
       Файловые  системы  FAT  маркируются  идентификатором  тома.  Идентификатор тома может быть
       прочитан с помощью FAT_IOCTL_GET_VOLUME_ID.

       Аргумент fd может быть файловым дескриптором файла  или  каталога  файловой  системы.  Для
       создания файлового дескриптора достаточно вызвать open(2) с флагом O_RDONLY.

       Аргумент   id  —  это  указатель  на  поле,  которое  будет  заполнено  ID  тома.  Обычно,
       идентификатор тома выдаётся пользователю как группа из двух 16-битных полей:

           printf("Volume ID %04x-%04x\n", id >> 16, id & 0xFFFF);

   Чтение коротких имён файлов каталога
       Файл или каталог файловой системы FAT всегда имеет короткое имя  файла,  состоящее  из  не
       более  чем  8 заглавных букв, необязательной точки и до 3 заглавных букв расширения файла.
       Если реальное имя файла не следует такой схеме, то оно сохраняется как длинное имя файла —
       до 255 символов UTF-16.

       Короткие  имена  файлов  в  каталоге можно прочитать с помощью VFAT_IOCTL_READDIR_SHORT. С
       помощью VFAT_IOCTL_READDIR_BOTH можно прочитать как короткие так и длинные имена файлов.

       Аргумент  fd  должен  содержать  файловый  дескриптор  каталога.  Для  создания  файлового
       дескриптора  достаточно  вызвать  open(2)  с  флагом  O_RDONLY.  Файловый дескриптор можно
       использовать только  однажды  для  обхода  всех  элементов  каталога  повторными  вызовами
       ioctl(2).

       Параметр info представляет собой двухэлементный массив структур следующего вида:

           struct __fat_dirent {
               long            d_ino;
               __kernel_off_t  d_off;
               uint32_t short  d_reclen;
               char            d_name[256];
           };

       Первый  элемент  массива  содержит  короткое  имя  файла. Во втором содержится длинное имя
       файла.

       Поля d_ino и d_off заполняются только для длинных имён. Поле d_ino  содержит  номер  inode
       каталога.  Поле  d_off  содержит  смещение  записи  файла  в  каталоге.  Так  как эти поля
       недоступны для коротких имён, пользовательский код должен просто игнорировать их.

       В поле d_reclen содержится длина имени файла  из  поля  d_name.  Для  сохранения  обратной
       совместимости  длина  0 для короткого имени указывает на достижение конца каталога. Однако
       предпочтительным  методом  определения  конца  каталога  является  проверка  возвращаемого
       ioctl(2)  значения. Если длинное имя не существует, то поле d_reclen устанавливается в 0 и
       d_name — строка символов длиной 0 для длинного имени файла.

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

       В случае ошибки возвращается -1, а errno устанавливается в значение ошибки.

       При использовании VFAT_IOCTL_READDIR_BOTH и VFAT_IOCTL_READDIR_SHORT возвращается значение
       1,  означающее,  что  был  прочитан  новый  элемент  каталога  и  0, когда достигнут конец
       каталога.

ОШИБКИ

       ENOENT Данная    ошибка    может    возвращаться     при     VFAT_IOCTL_READDIR_BOTH     и
              VFAT_IOCTL_READDIR_SHORT, если файловый дескриптор fd указывает на на удалённый, но
              ещё открытый каталог.

       ENOTDIR
              Данная    ошибка    может    возвращаться     при     VFAT_IOCTL_READDIR_BOTH     и
              VFAT_IOCTL_READDIR_SHORT, если файловый дескриптор fd не указывает на каталог.

       ENOTTY Файловый дескриптор fd указывает не на объект в файловой системе FAT.

       Дополнительные значения ошибок смотрите в ioctl(2).

ВЕРСИИ

       VFAT_IOCTL_READDIR_BOTH и VFAT_IOCTL_READDIR_SHORT впервые появились в Linux 2.0.

       FAT_IOCTL_GET_ATTRIBUTES и FAT_IOCTL_SET_ATTRIBUTES впервые появились в Linux 2.6.12.

       FAT_IOCTL_GET_VOLUME_ID появился в версии 3.11 ядра Linux.

СТАНДАРТЫ

       Данный программный интерфейс существует только в Linux.

ПРИМЕРЫ

   Переключение флага архивирования
       В  следующей  программе  показано  использование  ioctl(2) для изменения атрибутов файлов.
       Программа читает и  показывает  атрибут  архивирования  файла.  После  изменения  значения
       атрибута на противоположный, программа читает и показывает атрибут ещё раз.

       Пример сеанса работы программы с файлом /mnt/user/foo:

           # ./toggle_fat_archive_flag /mnt/user/foo
           Флаг архивирования установлен
           Переключение флага архивирования
           Флаг архивирования сброшен

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

       #include <fcntl.h>
       #include <linux/msdos_fs.h>
       #include <stdint.h>
       #include <stdio.h>
       #include <stdlib.h>
       #include <sys/ioctl.h>
       #include <unistd.h>

       /*
        * Читает атрибуты файла в файловой системе FAT.
        * Выводит состояние флага архивирования.
        */
       static uint32_t
       readattr(int fd)
       {
           int       ret;
           uint32_t  attr;

           ret = ioctl(fd, FAT_IOCTL_GET_ATTRIBUTES, &attr);
           if (ret == -1) {
               perror("ioctl");
               exit(EXIT_FAILURE);
           }

           if (attr & ATTR_ARCH)
               printf("Флаг архивирования установлен\n");
           else
               printf("Флаг архивирования сброшен\n");

           return attr;
       }

       int
       main(int argc, char *argv[])
       {
           int       fd;
           int       ret;
           uint32_t  attr;

           if (argc != 2) {
               printf("Использование: %s ИМЯ_ФАЙЛА\n", argv[0]);
               exit(EXIT_FAILURE);
           }

           fd = open(argv[1], O_RDONLY);
           if (fd == -1) {
               perror("open");
               exit(EXIT_FAILURE);
           }

           /*
            * Читает и показывает атрибуты файлов в FAT.
            */
           attr = readattr(fd);

           /*
            * Invert archive attribute.
            */
           printf("Toggling archive flag\n");
           attr ^= ATTR_ARCH;

           /*
            * Записывает изменённые атрибуты файлов в FAT.
            */
           ret = ioctl(fd, FAT_IOCTL_SET_ATTRIBUTES, &attr);
           if (ret == -1) {
               perror("ioctl");
               exit(EXIT_FAILURE);
           }

           /*
            * Читает и показывает атрибуты файлов в FAT.
            */
           readattr(fd);

           close(fd);

           exit(EXIT_SUCCESS);
       }

   Чтение идентификатора тома
       Следующий  пример кода демонстрирует использование ioctl(2) для вывода идентификатора тома
       файловой системы FAT.

       Пример сеанса работы программы с файлом /mnt/user:

           $ ./display_fat_volume_id /mnt/user
           Volume ID 6443-6241

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

       #include <fcntl.h>
       #include <linux/msdos_fs.h>
       #include <stdint.h>
       #include <stdio.h>
       #include <stdlib.h>
       #include <sys/ioctl.h>
       #include <unistd.h>

       int
       main(int argc, char *argv[])
       {
           int       fd;
           int       ret;
           uint32_t  id;

           if (argc != 2) {
               printf("Использование: %s ИМЯ_ФАЙЛА\n", argv[0]);
               exit(EXIT_FAILURE);
           }

           fd = open(argv[1], O_RDONLY);
           if (fd == -1) {
               perror("open");
               exit(EXIT_FAILURE);
           }

           /*
            * Читает ID тома.
            */
           ret = ioctl(fd, FAT_IOCTL_GET_VOLUME_ID, &id);
           if (ret == -1) {
               perror("ioctl");
               exit(EXIT_FAILURE);
           }

           /*
            * Форматирует вывод в виде двух групп по 16 бит каждая.
            */
           printf("Volume ID %04x-%04x\n", id >> 16, id & 0xFFFF);

           close(fd);

           exit(EXIT_SUCCESS);
       }

   Вывод содержимого каталога
       Следующий  пример  кода  демонстрирует  использование  ioctl(2)  для  вывода   содержимого
       каталога.

       Пример сеанса работы программы с файлом /mnt/user:

           $ ./fat_dir /mnt/user
           . -> ''
           .. -> ''
           ALONGF~1.TXT -> 'a long filename.txt'
           UPPER.TXT -> ''
           LOWER.TXT -> 'lower.txt'

   Исходный код программы
           #include <fcntl.h>
           #include <linux/msdos_fs.h>
           #include <stdio.h>
           #include <stdlib.h>
           #include <sys/ioctl.h>
           #include <unistd.h>

           int
           main(int argc, char *argv[])
           {
               int                  fd;
               int                  ret;
               struct __fat_dirent  entry[2];

               if (argc != 2) {
                   printf("Использование: %s КАТАЛОГ\n", argv[0]);
                   exit(EXIT_FAILURE);
               }

               /*
                * Открывает файловый дескриптор каталога.
                */
               fd = open(argv[1], O_RDONLY | O_DIRECTORY);
               if (fd == -1) {
                   perror("open");
                   exit(EXIT_FAILURE);
               }

               for (;;) {

                   /*
                    * Читает следующий элемент из каталога.
                    */
                   ret = ioctl(fd, VFAT_IOCTL_READDIR_BOTH, entry);

                   /*
                    * Если произошла ошибка, то возвращает -1.
                    * Если достигнут конец каталога, то
                    * возвращает 0.
                    * Для обратной совместимости при достижении конца каталога
                    * также d_reclen == 0.
                    */
                   if (ret < 1)
                       break;

                   /*
                    * Write both the short name and the long name.
                    */
                   printf("%s -> '%s'\n", entry[0].d_name, entry[1].d_name);
               }

               if (ret == -1) {
                   perror("VFAT_IOCTL_READDIR_BOTH");
                   exit(EXIT_FAILURE);
               }

               /*
                * Закрывает файловый дескриптор.
                */
               close(fd);

               exit(EXIT_SUCCESS);
           }

СМ. ТАКЖЕ

       ioctl(2)

ПЕРЕВОД

       Русский    перевод    этой    страницы    руководства    был    сделан   Azamat   Hackimov
       <azamat.hackimov@gmail.com>,   Dmitriy   S.   Seregin   <dseregin@59.ru>,   Yuri    Kozlov
       <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

       Этот  перевод  является  бесплатной  документацией;  прочитайте  Стандартную  общественную
       лицензию GNU версии 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ или более позднюю, чтобы
       узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

       Если  вы  обнаружите  ошибки  в  переводе этой страницы руководства, пожалуйста, отправьте
       электронное письмо на ⟨man-pages-ru-talks@lists.sourceforge.net⟩.