NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #include <fstab.h>

     struct fstab *
     getfsent(void);

     struct fstab *
     getfsspec(const char *spec);

     struct fstab *
     getfsfile(const char *file);

     int
     setfsent(void);

     void
     endfsent(void);

DESCRIPTION    [Toc]    [Back]

     The  getfsent(), getfsspec(), and getfsfile() functions each
return a
     pointer to an object with the following structure containing
the brokenout
  fields  of  a line in the file system description file,
<fstab.h>.

           struct fstab {
                   char    *fs_spec;       /* block  special  device name */
                   char     *fs_file;        /*  file system path
prefix */
                   char    *fs_vfstype;    /* type of file system
*/
                   char     *fs_mntops;      /*  comma  separated
mount options */
                   char    *fs_type;       /* rw, ro, sw,  or  xx
*/
                   int      fs_freq;        /* dump frequency, in
days */
                   int     fs_passno;      /* pass number on parallel fsck */
           };

     The fields have meanings described in fstab(5).

     setfsent()  opens  the  file  (closing any previously opened
file) or rewinds
     it if it is already open.

     endfsent() closes the file.

     The getfsspec() and getfsfile() functions search the  entire
file (opening
     it  if  necessary)  for a matching special file name or file
system file
     name.

     For programs wishing to read the entire database, getfsent()
reads the
     next entry (opening the file if necessary).

     All  entries  in  the  file  with a type field equivalent to
FSTAB_XX are ignored.

RETURN VALUES    [Toc]    [Back]

     The getfsent(), getfsspec(), and getfsfile()  functions  return a null
     pointer  on EOF or error.  The setfsent() function returns 0
on failure or
     1 on success.  The endfsent() function returns nothing.

FILES    [Toc]    [Back]

     /etc/fstab  file system table

SEE ALSO    [Toc]    [Back]

     fstab(5)

HISTORY    [Toc]    [Back]

     The getfsent() function appeared in 4.0BSD; the  endfsent(),
getfsfile(),
     getfsspec(), and setfsent() functions appeared in 4.3BSD.

BUGS    [Toc]    [Back]

     These  functions  use  static  data  storage; if the data is
needed for future
     use, it should be copied before any subsequent  calls  overwrite it.

OpenBSD      3.6                           June      4,      1993