ИМЯ¶

getmntent, setmntent, addmntent, endmntent, hasmntopt, getmntent_r - возвращают запись из файла описания файловых систем

СИНТАКСИС¶

#include <stdio.h>
#include <mntent.h>

FILE *setmntent(const char *filename, const char *type);

struct mntent *getmntent(FILE *stream);

int addmntent(FILE *stream, const struct mntent *mnt);

int endmntent(FILE *streamp);

char *hasmntopt(const struct mntent *mnt, const char *opt);
/* Расширение GNU */
#include <mntent.h>

struct mntent *getmntent_r(FILE *streamp, struct mntent *mntbuf,
                           char *buf, int buflen);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

getmntent_r(),
начиная с glibc 2.19:
_DEFAULT_SOURCE
в glibc 2.19 и старее:
_BSD_SOURCE || _SVID_SOURCE

ОПИСАНИЕ¶

Эти функции используются для доступа к файлу описаний файловых систем /etc/fstab и к файлу описаний смонтированных файловых систем /etc/mtab.

The setmntent() function opens the filesystem description file filename and returns a file pointer which can be used by getmntent(). The argument type is the type of access required and can take the same values as the mode argument of fopen(3).

Функция getmntent() считывает следующую строку из файла описаний файловых систем stream и возвращает указатель на структуру, содержащую поля строки файла. Указатель ссылается на статическую область памяти, которая перезаписывается последующими вызовами getmntent().

Функция addmntent() добавляет структуру mnt типа mntent к концу открытого stream.

Функция endmntent() закрывает stream, связанный с файл описаний файловых систем.

Функция hashmntopt() ищет в полях mnt_opts (смотрите ниже) структуры mnt типа mntent подстроку, совпадающую с opt. Список возможных параметров монтирования приведён в <mntent.h> и mount(8).

Реентерабельная функция getmntent_r() подобна getmntent(), но сохраняет struct mount в предоставляемом *mntbuf, а строки элементов этой структуры — в предоставляемый массив buf размера buflen.

Структура mntent определена в <mntent.h> следующим образом:

struct mntent {


    char *mnt_fsname;   /* название смонтированной файловой системы */


    char *mnt_dir;      /* префикс пути к файловой системе */


    char *mnt_type;     /* тип монтирования (смотрите mntent.h) */


    char *mnt_opts;     /* параметры монтирования (смотрите mntent.h) */


    int   mnt_freq;     /* периодичность запуска dump, в днях */


    int   mnt_passno;   /* номер прохода при параллельном fsck */
};

Так как поля в файлах mtab и fstab разделяются пробельными символами, то для их записи в одной из четырёх строках структуры mntent используются их экранированные последовательности в восьмеричном коде: пробел (\040), табуляция (\011), новая строка (\012) и обратная косая черта (\\). Функции addmntent() и getmntent() выполнят преобразование экранированных строк и обратно. При преобразовании из экранированного представления, последовательность \134 также преобразуется в символ обратной косой черты.

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

Функции getmntent() и getmntent_r() возвращают указатель на структуру типа mntent или NULL при ошибке.

Функция addmntent() возвращает 0 при успешном выполнении и 1 при ошибке.

Функция endmntent() всегда возвращает 1.

Функция hasmntopt() возвращает адрес подстроки, если она была найдена, в противном случае NULL.

ФАЙЛЫ¶

/etc/fstab

файл описаний файловых систем

/etc/mtab

файл описаний смонтированных файловых систем

АТРИБУТЫ¶

Описание терминов данного раздела смотрите в attributes(7).

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

Нереентерабельные функции появились из SunOS 4.1.3. Функция getmntent_r() появилась из HP-UX 10, но она возвращает int. Показанный здесь прототип есть только в glibc.

ЗАМЕЧАНИЯ¶

В System V также имеется функция getmntent(), однако последовательность вызова и возвращаемая структура отличаются от остальных. В System V используется /etc/mnttab. В BSD 4.4 и Digital UNIX есть функция getmntinfo(), обёртка над системным вызовом getfsstat().

СМ. ТАКЖЕ¶

fopen(3), fstab(5), mount(8)

ЗАМЕЧАНИЯ¶

Эта страница является частью проекта Linux man-pages версии 4.16. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД¶

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

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

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