.\" -*- coding: UTF-8 -*- .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" .\" References consulted: .\" Linux libc source code .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 21:46:57 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 961109, 031115, aeb .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH GETMNTENT 3 "6 марта 2019 г." "" "Руководство программиста Linux" .SH ИМЯ getmntent, setmntent, addmntent, endmntent, hasmntopt, getmntent_r \- возвращают запись из файла описания файловых систем .SH СИНТАКСИС .nf \fB#include \fP \fB#include \fP .PP \fBFILE *setmntent(const char *\fP\fIfilename\fP\fB, const char *\fP\fItype\fP\fB);\fP .PP \fBstruct mntent *getmntent(FILE *\fP\fIstream\fP\fB);\fP .PP \fBint addmntent(FILE *\fP\fIstream\fP\fB, const struct mntent *\fP\fImnt\fP\fB);\fP .PP \fBint endmntent(FILE *\fP\fIstreamp\fP\fB);\fP .PP \fBchar *hasmntopt(const struct mntent *\fP\fImnt\fP\fB, const char *\fP\fIopt\fP\fB);\fP /* Расширение GNU */ \fB#include \fP .PP \fBstruct mntent *getmntent_r(FILE *\fP\fIstreamp\fP\fB, struct mntent *\fP\fImntbuf\fP\fB,\fP \fB char *\fP\fIbuf\fP\fB, int \fP\fIbuflen\fP\fB);\fP .fi .PP .RS -4 Требования макроса тестирования свойств для glibc (см. \fBfeature_test_macros\fP(7)): .RE .PP \fBgetmntent_r\fP(), начиная с glibc 2.19: _DEFAULT_SOURCE в glibc 2.19 и старее: _BSD_SOURCE || _SVID_SOURCE .SH ОПИСАНИЕ Эти функции используются для доступа к файлу описаний файловых систем \fI/etc/fstab\fP и к файлу описаний смонтированных файловых систем \fI/etc/mtab\fP. .PP Функция \fBsetmntent\fP() открывает файл описаний файловых систем \fIfilename\fP и возвращает указатель на файл, который может быть использован \fBgetmntent\fP(). В аргументе \fItype\fP указывается требуемый тип доступа и и могут задаваться те же значения, что и в аргументе \fImode\fP функции \fBfclose\fP(3). Возвращаемый поток должен закрываться с помощью \fBendmntent\fP(), а не \fBfclose\fP(3). .PP Функция \fBgetmntent\fP() считывает следующую строку из файла описаний файловых систем \fIstream\fP и возвращает указатель на структуру, содержащую поля строки файла. Указатель ссылается на статическую область памяти, которая перезаписывается последующими вызовами \fBgetmntent\fP(). .PP Функция \fBaddmntent\fP() добавляет структуру \fImnt\fP типа \fImntent\fP к концу открытого \fIstream\fP. .PP Функция \fBendmntent\fP() закрывает \fIstream\fP, связанный с файл описаний файловых систем. .PP Функция \fBhashmntopt\fP() ищет в полях \fImnt_opts\fP (смотрите ниже) структуры \fImnt\fP типа \fImntent\fP подстроку, совпадающую с \fIopt\fP. Список возможных параметров монтирования приведён в \fI\fP и \fBmount\fP(8). .PP Реентерабельная функция \fBgetmntent_r\fP() подобна \fBgetmntent\fP(), но сохраняет \fIstruct mount\fP в предоставляемом \fI*mntbuf\fP, а строки элементов этой структуры — в предоставляемый массив \fIbuf\fP размера \fIbuflen\fP. .PP Структура \fImntent\fP определена в \fI\fP следующим образом: .PP .in +4n .EX 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 */ }; .EE .in .PP Так как поля в файлах mtab и fstab разделяются пробельными символами, то для их записи в одной из четырёх строках структуры \fImntent\fP используются их экранированные последовательности в восьмеричном коде: пробел (\e040), табуляция (\e011), новая строка (\e012) и обратная косая черта (\e\e). Функции \fBaddmntent\fP() и \fBgetmntent\fP() выполнят преобразование экранированных строк и обратно. При преобразовании из экранированного представления, последовательность \e134 также преобразуется в символ обратной косой черты. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" Функции \fBgetmntent\fP() и \fBgetmntent_r\fP() возвращают указатель на структуру типа \fImntent\fP или NULL при ошибке. .PP Функция \fBaddmntent\fP() возвращает 0 при успешном выполнении и 1 при ошибке. .PP Функция \fBendmntent\fP() всегда возвращает 1. .PP Функция \fBhasmntopt\fP() возвращает адрес подстроки, если она была найдена, в противном случае NULL. .SH ФАЙЛЫ .TP \fI/etc/fstab\fP файл описаний файловых систем .TP \fI/etc/mtab\fP файл описаний смонтированных файловых систем .SH АТРИБУТЫ Описание терминов данного раздела смотрите в \fBattributes\fP(7). .ad l .TS allbox; lbw13 lb lbw31 l l l. Интерфейс Атрибут Значение T{ \fBsetmntent\fP(), \fBendmntent\fP(), \fBhasmntopt\fP() T} Безвредность в нитях MT\-Safe T{ \fBgetmntent\fP() T} Безвредность в нитях MT\-Unsafe race:mntentbuf locale T{ \fBaddmntent\fP() T} Безвредность в нитях MT\-Safe race:stream locale T{ \fBgetmntent_r\fP() T} Безвредность в нитях MT\-Safe locale .TE .ad .SH "СООТВЕТСТВИЕ СТАНДАРТАМ" The nonreentrant functions are from SunOS 4.1.3. A routine \fBgetmntent_r\fP() was introduced in HP\-UX 10, but it returns an \fIint\fP. The prototype shown above is glibc\-only. .SH ЗАМЕЧАНИЯ В System V также имеется функция \fBgetmntent\fP(), однако последовательность вызова и возвращаемая структура отличаются от остальных. В System V используется \fI/etc/mnttab\fP. В BSD 4.4 и Digital UNIX есть функция \fBgetmntinfo\fP(), обёртка над системным вызовом \fBgetfsstat\fP(). .SH "СМ. ТАКЖЕ" \fBfopen\fP(3), \fBfstab\fP(5), \fBmount\fP(8) .SH ЗАМЕЧАНИЯ Эта страница является частью проекта Linux \fIman\-pages\fP версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу \%https://www.kernel.org/doc/man\-pages/. .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан Azamat Hackimov , Dmitry Bolkhovskikh , Vladislav , Yuri Kozlov и Иван Павлов . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .