Return to getpwent.3 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man3

Annotation of cci/usr/src/man/man3/getpwent.3, revision 1.1

1.1     ! root        1: .TH GETPWENT 3  "19 January 1983"
        !             2: .SH NAME
        !             3: getpwent, getpwuid, getpwnam, setpwent, endpwent \- get password file entry
        !             4: .SH SYNOPSIS
        !             5: .nf
        !             6: .B #include <pwd.h>
        !             7: .PP
        !             8: .B struct passwd *getpwent()
        !             9: .PP
        !            10: .B struct passwd *getpwuid(uid)
        !            11: .B int uid;
        !            12: .PP
        !            13: .B struct passwd *getpwnam(name)
        !            14: .B char *name;
        !            15: .PP
        !            16: .B int setpwent()
        !            17: .PP
        !            18: .B int endpwent()
        !            19: .fi
        !            20: .SH DESCRIPTION
        !            21: .I Getpwent,
        !            22: .I getpwuid
        !            23: and
        !            24: .I getpwnam
        !            25: each return a pointer to an object with the
        !            26: following structure
        !            27: containing the broken-out
        !            28: fields of a line in the password file.
        !            29: .RS
        !            30: .PP
        !            31: .nf
        !            32: .so /usr/include/pwd.h
        !            33: .ft R
        !            34: .ad
        !            35: .fi
        !            36: .RE
        !            37: .PP
        !            38: The fields
        !            39: .I pw_quota
        !            40: and
        !            41: .I pw_comment
        !            42: are unused; the others have meanings described in
        !            43: .IR passwd (5).
        !            44: .PP
        !            45: .I Getpwent
        !            46: reads the next
        !            47: line (opening the file if necessary);
        !            48: .I setpwent
        !            49: rewinds the file;
        !            50: .I endpwent
        !            51: closes it.
        !            52: .PP
        !            53: .I Getpwuid
        !            54: and
        !            55: .I getpwnam
        !            56: search from the beginning until a matching
        !            57: .I uid
        !            58: or
        !            59: .I name
        !            60: is found
        !            61: (or until EOF is encountered).
        !            62: .SH FILES
        !            63: /etc/passwd
        !            64: .SH "SEE ALSO"
        !            65: getlogin(3), getgrent(3), passwd(5)
        !            66: .SH DIAGNOSTICS
        !            67: Null pointer
        !            68: (0) returned on EOF or error.
        !            69: .SH BUGS
        !            70: All information
        !            71: is contained in a static area
        !            72: so it must be copied if it is
        !            73: to be saved.
        !            74: .br

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