GETVFSENT(3C)GETVFSENT(3C)NAME
getvfsent, getvfsfile, getvfsspec, getvfsany - get vfstab file entry
SYNOPSIS
#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 *, struct vfstab *vp, char *spec);
int getvfsany(FILE *, struct vfstab *vp, struct vfstab *vref);
DESCRIPTION
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 follow‐
ing members are described on the vfstab(4) manual page:
char *vfs_special;
char *vfs_fsckdev;
char *vfs_mountp;
char *vfs_fstype;
char *vfs_fsckpass;
char *vfs_automnt;
char *vfs_mntopts;
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 argument 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 file.
RETURN VALUES
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
possible error values are:
VFS_TOOLONG
A line in the file exceeded the internal buffer size of
VFS_LINE_MAX.
VFS_TOOMANY
A line in the file contains too many fields.
VFS_TOOFEW
A line in the file contains too few fields.
FILES
/etc/vfstab
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌───────────────┬─────────────────┐
│ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├───────────────┼─────────────────┤
│MT-Level │ Safe │
└───────────────┴─────────────────┘
SEE ALSOvfstab(4), attributes(5)NOTES
The members of the vfstab structure point to information contained in a
static area, so it must be copied if it is to be saved.
Mar 12, 1997 GETVFSENT(3C)