File:  [CSRG BSD Unix] / 43BSDTahoe / man / man3 / getfsent.3
Revision 1.1.1.1 (vendor branch): download - view: text, annotated - select for diffs
Tue Apr 24 16:12:58 2018 UTC (8 years, 1 month ago) by root
Branches: MAIN, BSD
CVS tags: HEAD, BSD43tahoe
BSD 4.3tahoe

.\" 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	6.3 (Berkeley) 5/12/86
.\"
.TH GETFSENT 3  "May 12, 1986"
.UC 4
.SH NAME
getfsent, getfsspec, getfsfile, getfstype, setfsent, endfsent \- get file system descriptor file entry
.SH SYNOPSIS
.nf
.B #include <fstab.h>
.PP
.B struct fstab *getfsent()
.PP
.B struct fstab *getfsspec(spec)
.B char *spec;
.PP
.B struct fstab *getfsfile(file)
.B char *file;
.PP
.B struct fstab *getfstype(type)
.B char *type;
.PP
.B int setfsent()
.PP
.B int endfsent()
.fi
.SH DESCRIPTION
.IR Getfsent ,
.IR getfsspec ,
.IR getfstype ,
and
.I 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,
.IR < fstab.h >.
.RS
.PP
.nf
struct fstab {
	char	*fs_spec;
	char	*fs_file;
	char	*fs_type;
	int	fs_freq;
	int	fs_passno;
};
.ft R
.ad
.fi
.RE
.PP
The fields have meanings described in
.IR fstab (5).
.PP
.I Getfsent
reads the next line of the file, opening the file if necessary.
.PP
.I Setfsent
opens and rewinds the file.
.PP
.I Endfsent
closes the file.
.PP
.I Getfsspec
and
.I 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.
.I Getfstype
does likewise, matching on the file system type field.
.SH FILES
/etc/fstab
.SH "SEE ALSO"
fstab(5)
.SH DIAGNOSTICS
Null pointer
(0) returned on EOF or error.
.SH BUGS
All information is contained in a static area so it must be copied if it is
to be saved.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.