getmntent(3G)                                          getmntent(3G)


       NAME
             getmntent, getmntany - get mnttab file entry

       SYNOPSIS
             cc [flag . . . ] file . . . -lgen [library] . . .
             #include <stdio.h>
             #include <sys/mnttab.h>
             int getmntent(FILE *fp, struct mnttab *mp);
             int getmntany(FILE *fp, struct mnttab *mp, struct mnttab *mpref);

       DESCRIPTION
             getmntent and getmntany each fill in the structure pointed to
             by mp with the broken-out fields of a line in the /etc/mnttab
             file.  Each line in the file contains a mnttab structure,
             declared in the sys/mnttab.h header file.  It contains the
             following members:

                         char  *mnt_special;
                         char  *mnt_mountp;
                         char  *mnt_fstype;
                         char  *mnt_mntopts;
                         char  *mnt_time;

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

             getmntent returns a pointer to the next mnttab structure in
             the file; so successive calls can be used to search the entire
             file.  getmntany searches the file referenced by fp until a
             match is found between a line in the file and mpref.  mpref
             matches the line if all non-null entries in mpref match the
             corresponding fields in the file.  Note that these routines do
             not open, close, or rewind the file.

          Files
             /etc/mnttab

          Return Values
             If the next entry is successfully read by getmntent or a match
             is found with getmntany, 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.





                           Copyright 1994 Novell, Inc.               Page 1

      getmntent(3G)                                          getmntent(3G)


         Errors
            The possible error values are:

            MNT_TOOLONG    A line in the file exceeded the internal buffer
                           size of MNT_LINE_MAX.

            MNT_TOOMANY    A line in the file contains too many fields.

            MNT_TOOFEW     A line in the file contains too few fields.

      REFERENCES
            mnttab(4)

      NOTICES
            The members of the mnttab 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