xref: /csrg-svn/lib/libc/gen/getfsent.3 (revision 20425)
Copyright (c) 1980 Regents of the University of California.
All rights reserved. The Berkeley software License Agreement
specifies the terms and conditions for redistribution.

@(#)getfsent.3 4.1 (Berkeley) 05/15/85

GETFSENT 3
C 4
NAME
getfsent, getfsspec, getfsfile, setfsent, endfsent - get file system descriptor file entry
SYNOPSIS
 #include <fstab.h> 

struct fstab *getfsent()

struct fstab *getfsspec(name) char *name;

struct fstab *getfsfile(name) char *name;

int setfsend()

int endfsent()

DESCRIPTION
Getfsent, getfsspec and getfsfile each return a pointer to an object with the following structure containing the broken-out fields of a line in the file system description file, /usr/include/fstab.h.

#define FSNMLG 16

struct fstab{
 char fs_spec[FSNMLG];
 char fs_file[FSNMLG];
 char fs_type[3];
 int fs_freq;
 int fs_passno;
};

The fields have meanings described in fstab (5).

Getfsent reads the next line of the file, opening the file if necessary.

Setfsent opens and rewinds the file.

Endfsent closes the file.

Getfsspec and getfsfile sequentially search from the beginning of the file until a matching special file name or file system file name is found, or until EOF is encountered.

FILES
/etc/fstab
"SEE ALSO"
fstab(5)
DIAGNOSTICS
Null pointer (0) returned on EOF or error.
BUGS
All information is contained in a static area so it must be copied if it is to be saved.