getvfsent(3C) getvfsent(3C)
NAME
getvfsent, getvfsfile, getvfsspec, getvfsany - vfstab-Dateieintrag
lesen
SYNTAX
#include <stdio.h>
#include <sys/vfstab.h>
int getvfsent(FILE *fp, struct vfstab *vp);
int getvfsfile(FILE *fp, struct vfstab *vp, char *file);
int getvfsspec(FILE *fp, struct vfstab *vp, char *spec);
int getvfsany(FILE *fp, struct vfstab *vp, struct vfstab *vref);
BESCHREIBUNG
getvfsent(), getvfsfile(), getvfsspec() und getvfsany() füllen die
Struktur, auf die vp zeigt, mit den Feldern einer Zeile aus der Datei
/etc/vfstab. Jede Zeile der Datei enthält eine Struktur vom Typ
vfstab, die in der Datei sys/vfstab.h vereinbart wird:
char *vfsspecial;
char *vfsfsckdev;
char *vfsmountp;
char *vfsfstype;
char *vfsfsckpass;
char *vfsautomnt;
char *vfsmntopts;
Die Bedeutung der einzelnen Felder wird in vfstab(4) beschrieben.
getvfsent() liefert einen Zeiger auf die nächste vfstab-Struktur in
der Datei zurück. Aufeinanderfolgende Aufrufe können somit verwendet
werden, um die komplette Datei zu durchsuchen. getvfsfile() durchsucht
die Datei, die durch fp bezeichnet wird, nach einem Einhängepunkt, der
file entspricht; vp wird mit den Feldern aus der Zeile gefüllt.
getvfsspec() durchsucht die Datei fp, bis eine Gerätedatei gefunden
wird, die spec entspricht; vp wird mit den Feldern aus der Zeile
gefüllt. spec versucht, dem Gerätetyp (block- oder zeichenorientiert)
und der höher- (major) und niedrigerwertigen (minor) Gerätenummer zu
entsprechen. Kann keine Entsprechung gefunden werden, werden die Zei-
chenketten verglichen. getvfsany() durchsucht die Datei fp nach einer
Zeile, die vref entspricht. vref entspricht einer Zeile, wenn alle
Einträge aus vref, die nicht Null sind, den Feldern aus der Datei
gleichen.
Beachten Sie, daß diese Routinen die Datei weder öffnen, schließen
noch zurückspulen.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
getvfsent(3C) getvfsent(3C)
ERGEBNIS
Wenn der nächste Eintrag von getvfsent() erfolgreich gelesen werden
kann oder mit getvfsfile(), getvfsspec() oder getvfsany() eine Übe-
reinstimmung gefunden wird, so wird 0 zurückgegeben. Wird das Datei-
ende beim Lesen erreicht, liefern diese Funktionen -1 zurück. Tritt
ein Fehler auf, wird ein Wert größer als 0 zurückgegeben. Die mögli-
chen Fehlercodes sind:
VFSTOOLONG Die Länge einer Zeile der Datei überschritt die interne
Pufferlänge VFSLINEMAX.
VFSTOOMANY Eine Zeile der Datei enthält zu viele Felder.
VFSTOOFEW Eine Zeile der Datei enthält zu wenig Felder.
HINWEISE
Die Komponenten der Struktur vfstab zeigen auf Daten, welche sich in
einem statischen Bereich befinden; um die Daten zu sichern, müssen sie
kopiert werden.
DATEIEN
/etc/vfstab
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98