NAME

getmntent, getmntany - get mnttab file entry

SYNOPSIS

#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:

struct mnttab {
     char *mnt_special;
     char *mnt_mountp;
     char *mnt_fstype;
     char *mnt_mntopts;
     char *mnt_time;
};

The fields have meanings described in mnttab(4).

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

SEE ALSO

mnttab(4).

DIAGNOSTICS

If the next entry is successfully read by getmntent or a match is found with getmntany, 0 is returned. If an endof-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:

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.

NOTES

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.