Museum

getvfsent(3C)                    UNIX System V                    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 *fp, struct vfstab *vp, char *spec);

      int getvfsany (FILE *fp, struct vfstab *vp, 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
      file fp.  Each line in the file contains a vfstab structure, declared in
      the sys/vfstab.h header file:

                  char  *vfsspecial;
                  char  *vfsfsckdev;
                  char  *vfsmountp;
                  char  *vfsfstype;
                  char  *vfsfsckpass;
                  char  *vfsautomnt;
                  char  *vfsmntopts;


      The fields have meanings described in vfstab(4).

      getvfsent fills vp with the next vfstab structure in fp 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.

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

FILES
      /etc/vfstab

DIAGNOSTICS
      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-


10/89                                                                    Page 1

getvfsent(3C)                    UNIX System V                    getvfsent(3C)


      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:

      VFSTOOLONG         A line in the file exceeded the internal buffer size
                          of VFSLINEMAX.

      VFSTOOMANY         A line in the file contains too many fields.

      VFSTOOFEW          A line in the file contains too few fields.

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.








































Page 2                                                                    10/89