getvfsent(3G)                                          getvfsent(3G)


       NAME
             getvfsent, getvfsfile, getvfsspec, getvfsany - get vfstab file
             entry

       SYNOPSIS
             cc [flag . . . ] file . . . -lgen [library] . . .
             #include <stdio.h>
             #include <sys/vfstab.h>
             int getvfsent (FILE *fp, struct vfstab *vp);
             int getvfsfile (FILE *fp, struct vfstab *vp, const char *file);
             int getvfsspec (FILE *fp, struct vfstab *vp, const char *spec);
             int getvfsany (FILE *fp, struct vfstab *vp, const struct vfstab *vref);

       DESCRIPTION
             getvfsent, getvfsfile, getvfsspec, and getvfsany 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 file:

                   char  *vfs_special;
                   char  *vfs_fsckdev;
                   char  *vfs_mountp;
                   char  *vfs_fstype;
                   char  *vfs_fsckpass;
                   char  *vfs_automnt;
                   char  *vfs_mntopts;
                   char  *vfs_macceiling;

             If the fields have meaning, the meanings are described in
             vfstab(4).  Fields with no valid information are set to point
             at the null string.

             getvfsent returns a pointer to the next vfstab structure in
             the file; so successive calls can be used to search the entire
             file.  getvfsfile 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.  getvfsspec 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.
             spec 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.  getvfsany
             searches the file referenced by fp until a match is found
             between a line in the file and vref.  vref matches the line if
             all non-null entries in vref match the corresponding fields in
             the file.


                           Copyright 1994 Novell, Inc.               Page 1

      getvfsent(3G)                                          getvfsent(3G)


            Note that these routines do not open, close, or rewind the
            file.

         Files
            /etc/vfstab

         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.

         Errors
            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.

      REFERENCES
            vfstab(4)

      NOTICES
            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.















                          Copyright 1994 Novell, Inc.               Page 2