unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

GETMNTENT(3)               Library Functions Manual               GETMNTENT(3)



NAME
       getmntent, setmntent, addmntent, endmntent, hasmntopt - get file system
       descriptor file entry

SYNOPSIS
       #include <&lt;stdio.h>&gt;
       #include <&lt;mntent.h>&gt;
       FILE *setmntent(filep, type)
       char *filep;
       char *type;
       struct mntent *getmntent(filep)
       FILE *filep;
       int addmntent(filep, mnt)
       FILE *filep;
       struct mntent *mnt;
       char *hasmntopt(mnt, opt)
       struct mntent *mnt;
       char *opt;
       int endmntent(filep)
       FILE *filep;

DESCRIPTION
       These routines replace the getfsent() routines for accessing  the  file
       system  description  file /etc/fstab.  They are also used to access the
       mounted file system description file /etc/mtab.

       setmntent() opens a file system description file  and  returns  a  file
       pointer which can then be used with getmntent, addmntent, or endmntent.
       The type argument is the same as in fopen(3V).  getmntent()  reads  the
       next  line  from filep and returns a pointer to an object with the fol-
       lowing structure containing the broken-out fields of a line in the file
       system  description  file, <&lt;mntent.h>&gt;.  On failure, getmntent() returns
       the NULL pointer.  The fields have meanings described in fstab(5).

              struct mntent{
                     char  *mnt_fsname;  /* name of mounted file system */
                     char  *mnt_dir;     /* file system path prefix */
                     char  *mnt_type;    /* MNTTYPE_* */
                     char  *mnt_opts;    /* MNTOPT* */
                     int   mnt_freq;     /* dump frequency, in days */
                     int   mnt_passno;   /* pass number on parallel fsck */
              };

       addmntent() adds the mntent structure mnt to the end of the  open  file
       filep.   addmntent(  ) returns 0 on success, 1 on failure.  Note: filep
       has to be opened for writing if this is to work.  hasmntopt() scans the
       mnt_opts field of the mntent structure mnt for a substring that matches
       opt.  It returns the address of the substring if a match  is  found,  0
       otherwise.   endmntent(  )  closes  the  file.  It always returns 1, so
       should be treated as type void.

FILES
       /etc/fstab
       /etc/mtab

SEE ALSO
       fopen(3V), getfsent(3), fstab(5)

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

BUGS
       The returned mntent structure points  to  static  information  that  is
       overwritten in each call.



                               26 February 1988                   GETMNTENT(3)