НАИМЕНОВАНИЕ

       getfsent, getfsspec, getfsfile, setfsent, endfsent - для работы с записями fstab

БИБЛИОТЕКА

       Стандартная библиотека языка C (libc, -lc)

ОБЗОР

       #include <fstab.h>

       int setfsent(void);
       struct fstab *getfsent(void);
       void endfsent(void);

       struct fstab *getfsfile(const char *mount_point);
       struct fstab *getfsspec(const char *special_file);

ОПИСАНИЕ

       Эти функции читают файл /etc/fstab. Структура struct fstab определена следующим образом:

           struct fstab {
               char       *fs_spec;       /* block device name */
               char       *fs_file;       /* mount point */
               char       *fs_vfstype;    /* filesystem type */
               char       *fs_mntops;     /* mount options */
               const char *fs_type;       /* rw/rq/ro/sw/xx option */
               int         fs_freq;       /* dump frequency, in days */
               int         fs_passno;     /* pass number on parallel dump */
           };

       Здесь  поле  fs_type  содержит  (в  системах  *BSD)  одну  из  пяти  строк:  «rw», «rq», «ro», «sw», «xx»
       (чтение-запись, чтение-запись с квотами, только-чтение, подкачка, игнорировать).

       Функция setfsent() открывает файл при необходимости и устанавливает указатель на первую строку.

       Функция getfsent() обрабатывает следующую строку из файла (открыв файл, если требуется).

       Функция endfsent() закрывает файл, если требуется.

       Функция getfsspec() ищет с  начала  файла  запись,  для  которой  поле  fs_spec  соответствует  аргументу
       special_file и возвращает её.

       Функция  getfsfile()  ищет  с  начала  файла  запись,  для  которой  поле fs_file соответствует аргументу
       mount_point и возвращает её.

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

       При успешном выполнении функции getfsent(), getfsfile() и getfsspec() возвращают указатель  на  структуру
       struct  fstab,  а setfsent() возвращает 1. При ошибке или обнаружении конца файла эти функции возвращают,
       соответственно, NULL или 0.

АТРИБУТЫ

       Описание терминов данного раздела смотрите в attributes(7).
       ┌──────────────────────────┬──────────────────────┬─────────────────────────────────────────────────────┐
       │ Интерфейс                │ Атрибут              │ Значение                                            │
       ├──────────────────────────┼──────────────────────┼─────────────────────────────────────────────────────┤
       │ endfsent(), setfsent()   │ Безвредность в нитях │ MT-Unsafe race:fsent                                │
       ├──────────────────────────┼──────────────────────┼─────────────────────────────────────────────────────┤
       │ getfsent(), getfsspec(), │ Безвредность в нитях │ MT-Unsafe race:fsent locale                         │
       │ getfsfile()              │                      │                                                     │
       └──────────────────────────┴──────────────────────┴─────────────────────────────────────────────────────┘

ВЕРСИИ

       Several operating systems have these functions, for example, *BSD, SunOS, Digital UNIX, AIX  (which  also
       has  a  getfstype()).  HP-UX has functions of the same names, that however use a struct checklist instead
       of a struct fstab, and calls these functions obsolete, superseded by getmntent(3).

СТАНДАРТЫ

       Отсутствуют.

ИСТОРИЯ

       The getfsent()  function appeared in 4.0BSD; the other four functions appeared in 4.3BSD.

ПРИМЕЧАНИЯ

       Эти функции нельзя использовать в нескольких нитях одновременно.

       Так как Linux позволяет монтировать специальное блочное устройство в несколько разных точек, а также  так
       как  несколько  устройств  могут  иметь  одну  точку  монтирования, то неясно, будет ли результат (первая
       запись), возвращенный функциями getfsfile() и getfsspec() именно тем, что и  ожидался.  Поэтому  эти  две
       функции не подходят для использования под Linux.

СМОТРИТЕ ТАКЖЕ

       getmntent(3), fstab(5)

ПЕРЕВОД

       Русский  перевод  этой  страницы  руководства  разработал(и) Azamat Hackimov <azamat.hackimov@gmail.com>,
       Dmitry  Bolkhovskikh   <d20052005@yandex.ru>,   Vladislav   <ivladislavefimov@gmail.com>,   Yuri   Kozlov
       <yuray@komyakino.ru>, Иван Павлов <pavia00@gmail.com> и Kirill Rekhov <krekhov.dev@gmail.com>

       Этот  перевод является свободной программной документацией; он распространяется на условиях общедоступной
       лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html  версии  3  или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

       Если  вы  обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом
       разработчику(ам)  по  его(их)  адресу(ам)  электронной  почты  или  по   адресу   списка рассылки русских
       переводчиков.

Справочные страницы Linux 6.9.1                   2 мая 2024 г.                                      getfsent(3)