.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" 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 "2. Mai 2024" "Linux man\-pages 6.8" .SH BEZEICHNUNG getmntent, setmntent, addmntent, endmntent, hasmntopt \- Lesen des Eintrags in der Dateisystem\-Beschreibungsdatei .SH BIBLIOTHEK Standard\-C\-Bibliothek (\fIlibc\fP, \fI\-lc\fP) .SH ÜBERSICHT .nf \fB#include \fP \fB#include \fP .P \fBFILE *setmntent(const char *\fP\fIdateiname\fP\fB, const char *\fP\fItyp\fP\fB);\fP .P \fBstruct mntent *getmntent(FILE *\fP\fIdatenstrom\fP\fB);\fP .P \fBint addmntent(FILE *restrict \fP\fIdatenstrom\fP\fB,\fP \fB const struct mntent *restrict \fP\fImnt\fP\fB);\fP .P \fBint endmntent(FILE *\fP\fIdatenstromz\fP\fB);\fP .P \fBchar *hasmntopt(const struct mntent *\fP\fImnt\fP\fB, const char *\fP\fIopt\fP\fB);\fP .P /* GNU\-Erweiterung */ \fB#include \fP .P \fBstruct mntent *getmntent_r(FILE *restrict \fP\fIdatenstromz\fP\fB,\fP \fB struct mntent *restrict \fP\fImntbuf\fP\fB,\fP \fB char \fP\fIpuf\fP\fB[restrict .\fP\fIpuflänge\fP\fB], int \fP\fIpuflänge\fP\fB);\fP .fi .P .RS -4 Mit Glibc erforderliche Feature\-Test\-Makros (siehe \fBfeature_test_macros\fP(7)): .RE .P \fBgetmntent_r\fP(): .nf Seit Glibc 2.19: _DEFAULT_SOURCE Glibc 2.19 und älter: _BSD_SOURCE || _SVID_SOURCE .fi .SH BESCHREIBUNG Diese Routinen werden benutzt, um auf die Dateien \fI/etc/fstab\fP und \fI/etc/mtab\fP zuzugreifen. Erstere beschreibt die Dateisysteme, letztere die aktuell eingehängten Dateisysteme. .P Die Funktion \fBsetmntent\fP() öffnet die Dateisystem\-Beschreibungsdatei \fIdateiname\fP und liefert einen Dateizeiger zurück, der von \fBgetmntent\fP() benutzt werden kann. Das Argument \fItyp\fP ist die Art des benötigten Zugriffs und kann dieselben Werte annehmen wie das \fImode\fP\-Argument von fopen(3). Der zurückgelieferte Datenstrom sollte mittels \fBendmntent\fP() statt \fBfclose\fP(3) geschlossen werden. .P Die Funktion \fBgetmntent\fP() liest die nächste Zeile der Dateisystem\-Beschreibungsdatei aus \fIdatenstrom\fP und liefert einen Zeiger auf eine Struktur zurück, welche die einzelnen Felder der gelesenen Zeile enthält. Der Zeiger weist zu einem statischen Speicherbereich, der von den folgenden Aufrufen von \fBgetmntent\fP() wieder überschrieben wird. .P Die Funktion \fBaddmntent\fP() fügt die \fImntent\fP\-Struktur an das Ende des offenen \fIdatenstrom\fP an. .P Die Funktion \fBendmntent\fP() schließt den mit der Dateisystemdeskriptorendatei assoziierten \fIdatenstrom\fP. .P Die Funktion \fBhasmntopt\fP() durchsucht das Feld \fImnt_opts\fP (siehe unten) der \fImntent\fP\-Struktur \fImnt\fP nach einer Teilzeichenkette, die zu \fIopt\fP passt. Gültige Optionen finden Sie unter \fI\fP und in \fBmount\fP(8). .P Die ablaufinvariante Funktion \fBgetmntent_r\fP() ähnelt \fBgetmntent\fP(), speichert aber die Struktur \fImntent\fP im bereitgestellten \fI*mntbuf\fP und die Zeichenketten, auf welche die Einträge in dieser Struktur zeigen, im Feld \fIpuf\fP der Größe \fIpuflänge\fP. .P Die Struktur \fImntent\fP wird in \fI\fP wie folgt definiert: .P .in +4n .EX struct mntent { char *mnt_fsname; /* Name des eingehängten Dateisystems */ char *mnt_dir; /* Präfix des Dateisystempfads */ char *mnt_type; /* Typ des Dateisystems (siehe mntent.h) */ char *mnt_opts; /* Mount\-Optionen (siehe mntent.h) */ int mnt_freq; /* Dump\-Häufigkeit in Tagen */ int mnt_passno; /* Durchgangsnummer beim parallelen fsck */ }; .EE .in .P Da die Felder in den Dateien mtab und fstab durch Leerräume getrennt sind, werden oktale Maskierungszeichen verwendet, um die Zeichen Leerzeichen (\e040), Tabulator (\e011), Zeilenumbruch (\e012) und Rückwärtsschrägstrich (\e\e) in diesen Dateien darzustellen, wenn sie in einer der vier Zeichenketten in einer \fImntent\fP\-Struktur auftreten. Die Routinen \fBaddmntent\fP() und \fBgetmntent\fP() wandeln die Darstellung der Zeichenketten mit und ohne Maskierungszeichen ineinander um. Beim Umwandeln aus der maskierten Darstellung wird die Sequenz \e134 auch in einen Rückwärtsschrägstrich umgewandelt. .SH RÜCKGABEWERT Die Funktionen \fBgetmntent\fP() und \fBgetmntent_r\fP() geben einen Zeiger auf die \fImntent\fP\-Struktur zurück oder NULL bei einem Fehler. .P Die Funktion \fBaddmntent\fP() liefert bei Erfolg eine 0 zurück, bei einem Fehler dagegen eine 1. .P Die Funktion \fBendmntent\fP() liefert immer eine 1 zurück. .P Die Funktion \fBhasmntopt\fP() liefert die Adresse der Teilzeichenkette zurück, wenn eine Entsprechung gefunden wurde; ansonsten NULL. .SH DATEIEN .TP \fI/etc/fstab\fP Dateisystembeschreibungsdatei .TP \fI/etc/mtab\fP Beschreibungsdatei eingehängter Dateisysteme .SH ATTRIBUTE Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke. .TS allbox; lb lb lbx l l l. Schnittstelle Attribut Wert T{ .na .nh \fBsetmntent\fP(), \fBendmntent\fP(), \fBhasmntopt\fP() T} Multithread\-Fähigkeit MT\-Sicher T{ .na .nh \fBgetmntent\fP() T} Multithread\-Fähigkeit T{ .na .nh MT\-Unsicher race:mntentbuf locale T} T{ .na .nh \fBaddmntent\fP() T} Multithread\-Fähigkeit T{ .na .nh MT\-Sicher race:stream locale T} T{ .na .nh \fBgetmntent_r\fP() T} Multithread\-Fähigkeit MT\-Sicher locale .TE .SH STANDARDS Keine. .SH GESCHICHTE Die nicht ablaufinvarianten Funktionen stammen aus SunOS 4.1.3. Eine Routine \fBgetmntent_r\fP() wurde in HP\-UX 10 eingeführt, aber sie gibt einen \fIint\fP zurück. Den oben erwähnten Prototyp gibt es nur in der Glibc. .P Auch System V verfügt über eine \fBgetmntent\fP()\-Funktion, aber die Aufrufreihenfolge und die zurückgegebene Struktur sind anders. Unter System V wird \fI/etc/mnttab\fP verwendet. In 4.4BSD und Digital UNIX gibt es eine Routine \fB\%getmntinfo\fP(), einen Wrapper um den Systemaufruf \fBgetfsstat\fP(). .SH "SIEHE AUCH" \fBfopen\fP(3), \fBfstab\fP(5), \fBmount\fP(8) .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .