getvfsent, getvfsfile, getvfsspec, getvfsany - get vfstab
int getvfsent(FILE *fp, struct vfstab *vp);
int getvfsfile(FILE *fp, struct vfstab *vp, char *file);
int getvfsspec(FILE *, struct vfstab *vp, char *spec);
int getvfsany(FILE *, struct vfstab *vp, struct vfstab
The getvfsent(), getvfsfile(), getvfsspec(), and getvfsany()
functions each fill in the structure pointed to by vp with
the broken-out fields of a line in the /etc/vfstab file.
Each line in the file contains a vfstab structure, declared
in the <sys/vfstab.h> header, whose following members are
described on the vfstab(4) manual page:
The getvfsent() function returns a pointer to the next
vfstab structure in the file; so successive calls can be
used to search the entire file.
The getvfsfile() function searches the file referenced by fp
until a mount point matching file is found and fills vp with
the fields from the line in the file.
The getvfsspec() function searches the file referenced by fp
until a special device matching spec is found and fills vp
with the fields from the line in the file. The spec argu-
ment will try to match on device type (block or character
special) and major and minor device numbers. If it cannot
match in this manner, then it compares the strings.
The getvfsany() function searches the file referenced by fp
until a match is found between a line in the file and vref.
A match occurrs if all non-null entries in vref match the
corresponding fields in the file.
Note that these functions do not open, close, or rewind the
If the next entry is successfully read by getvfsent() or a
match is found with getvfsfile(), getvfsspec(), or
getvfsany(), 0 is returned. If an end-of-file is encountered
on reading, these functions return -1. If an error is
encountered, a value greater than 0 is returned. The possi-
ble error values are:
A line in the file exceeded the internal buffer size
A line in the file contains too many fields.
A line in the file contains too few fields.
See attributes(5) for descriptions of the following attri-
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| MT-Level | Safe |
The members of the vfstab structure point to information
contained in a static area, so it must be copied if it is to
Man(1) output converted with