getmntent(3G)


getmntent -- 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

getmntany- get mnttab file entry

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.

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.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004