GETFSENT(3)                          BSD                           GETFSENT(3)



NAME
     getfsent, getfsspec, getfsfile, getfstype, setfsent, endfsent - get file
     system descriptor file entry

SYNOPSIS
     #include <fstab.h>

     struct fstab *getfsent()

     struct fstab *getfsspec(spec)
     char *spec;

     struct fstab *getfsfile(file)
     char *file;

     struct fstab *getfstype(type)
     char *type;

     int setfsent()

     int endfsent()

DESCRIPTION
     getfsent, getfsspec, getfstype, and getfsfile each return a pointer to an
     object with the following structure containing the broken-out fields of a
     line in the file system description file, <fstab.h>.

          struct fstab {
               char *fs_spec;
               char *fs_file;
               char *fs_type;
               int  fs_freq;
               int  fs_passno;
          };

     The fields have meanings described in fstab(5).

     getfsent reads the next line of the file, opening the file if necessary.

     setfsent opens and rewinds the file.

     endfsent closes the file.

     getfsspec and getfsfile sequentially search from  the  beginning  of  the
     file  until a matching special filename or file system filename is found,
     or until EOF is encountered.  getfstype does likewise,  matching  on  the
     file system type field.

FILES
     /etc/fstab

SEE ALSO
     fstab(5)

DIAGNOSTICS
     NULL pointer (0) is returned on EOF or error.

BUGS
     All information is contained in a static area, so it must be copied if it
     is to be saved.