Return to getfsent.3 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / lib / libc / gen

Annotation of 43BSDReno/lib/libc/gen/getfsent.3, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1983 The Regents of the University of California.
        !             2: .\" All rights reserved.
        !             3: .\"
        !             4: .\" Redistribution and use in source and binary forms are permitted provided
        !             5: .\" that: (1) source distributions retain this entire copyright notice and
        !             6: .\" comment, and (2) distributions including binaries display the following
        !             7: .\" acknowledgement:  ``This product includes software developed by the
        !             8: .\" University of California, Berkeley and its contributors'' in the
        !             9: .\" documentation or other materials provided with the distribution and in
        !            10: .\" all advertising materials mentioning features or use of this software.
        !            11: .\" Neither the name of the University nor the names of its contributors may
        !            12: .\" be used to endorse or promote products derived from this software without
        !            13: .\" specific prior written permission.
        !            14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
        !            15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
        !            16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
        !            17: .\"
        !            18: .\"    @(#)getfsent.3  6.8 (Berkeley) 6/23/90
        !            19: .\"
        !            20: .TH GETFSENT 3  "June 23, 1990"
        !            21: .UC 4
        !            22: .SH NAME
        !            23: getfsent, getfsspec, getfsfile, setfsent, endfsent \- get file system descriptor file entry
        !            24: .SH SYNOPSIS
        !            25: .nf
        !            26: .B #include <fstab.h>
        !            27: .PP
        !            28: .B struct fstab *getfsent()
        !            29: .PP
        !            30: .B struct fstab *getfsspec(spec)
        !            31: .B char *spec;
        !            32: .PP
        !            33: .B struct fstab *getfsfile(file)
        !            34: .B char *file;
        !            35: .PP
        !            36: .B int setfsent()
        !            37: .PP
        !            38: .B void endfsent()
        !            39: .fi
        !            40: .SH DESCRIPTION
        !            41: .IR Getfsent ,
        !            42: .IR getfsspec ,
        !            43: and
        !            44: .I getfsfile
        !            45: each return a pointer to an object with the following structure
        !            46: containing the broken-out fields of a line in the file system
        !            47: description file,
        !            48: .IR < fstab.h >.
        !            49: .RS
        !            50: .PP
        !            51: .nf
        !            52: .ta \w'#define 'u +\w'char\ \ 'u +\w'*fs_vfstype;\ \ 'u
        !            53: struct fstab {
        !            54:        char    *fs_spec;       /* block special device name */
        !            55:        char    *fs_file;       /* file system path prefix */
        !            56:        char    *fs_vfstype;    /* type of file system */
        !            57:        char    *fs_mntops;     /* comma separated mount options */
        !            58:        char    *fs_type;       /* rw, ro, sw, or xx */
        !            59:        int     fs_freq;        /* dump frequency, in days */
        !            60:        int     fs_passno;      /* pass number on parallel dump */
        !            61: };
        !            62: .ft R
        !            63: .ad
        !            64: .fi
        !            65: .RE
        !            66: .PP
        !            67: The fields have meanings described in
        !            68: .IR fstab (5).
        !            69: .PP
        !            70: .I Setfsent
        !            71: opens the file (closing any previously opened file) or rewinds it
        !            72: if it is already open.
        !            73: .PP
        !            74: .I Endfsent
        !            75: closes the file.
        !            76: .PP
        !            77: .I Getfsspec
        !            78: and
        !            79: .I getfsfile
        !            80: search the entire file (opening it if necessary) for a matching special
        !            81: file name or file system file name.
        !            82: .PP
        !            83: For programs wishing to read the entire database,
        !            84: .I getfsent
        !            85: reads the next entry (opening the file if necessary).
        !            86: .PP
        !            87: All entries in the file with a type field equivalent to
        !            88: .I FSTAB_XX
        !            89: are ignored.
        !            90: .SH FILES
        !            91: /etc/fstab
        !            92: .SH "SEE ALSO"
        !            93: fstab(5)
        !            94: .SH DIAGNOSTICS
        !            95: .IR Getfsent ,
        !            96: .IR getfsspec ,
        !            97: and
        !            98: .I getfsfile
        !            99: return a null pointer (0) on EOF or error.
        !           100: .I Setfsent
        !           101: returns 0 on failure, 1 on success.
        !           102: .I Endfsent
        !           103: returns nothing.
        !           104: .SH BUGS
        !           105: All information is contained in a static area so it must be copied if it is
        !           106: to be saved.

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