Return to getpwwho.3 CVS log

Up to [CSRG BSD Unix] / 42BSD / usr.lib / sendmail / aux

Annotation of 42BSD/usr.lib/sendmail/aux/getpwwho.3, revision 1.1

1.1     ! root        1: From James.Gosling@CMU-VLSI@CMU-10A  Thu Sep 10 07:17:42 1981
        !             2: Date: 10 Sep 1981 10:08:10-EDT
        !             3: From: James.Gosling at CMU-VLSI at CMU-10A
        !             4: Reply-To: James.Gosling at CMU-10A
        !             5: To: IngVAX.eric@Berkeley
        !             6: Subject: getpwwho.1
        !             7: Status: R
        !             8: 
        !             9: .TH GETPWWHO 3 5/9/80
        !            10: .CM 2
        !            11: .SH "NAME"
        !            12: getpwwho \- get password file entry using liberal name matching.
        !            13: .SH "SYNOPSIS"
        !            14: .B
        !            15: #include <pwd.h>
        !            16: .br
        !            17: .B
        !            18: extern struct gecos *_gecos;
        !            19: .sp
        !            20: .B
        !            21: struct passwd *getpwwho(name)
        !            22: .br
        !            23: .B
        !            24: char *name;
        !            25: .sp
        !            26: .B
        !            27: struct passwd *getpwambig();
        !            28: .SH "DESCRIPTION"
        !            29: .I
        !            30: Getpwwho
        !            31: is much like
        !            32: .IR getpwnam (3),
        !            33: except that it is much more
        !            34: liberal about the names that it will match.
        !            35: .I
        !            36: Name
        !            37: may be a full login name
        !            38: or it may be the unique abbreviation of a persons last name, or it
        !            39: may be a unique abbreviation of a persons first
        !            40: and last name.
        !            41: .sp
        !            42: The subroutine
        !            43: .I
        !            44: getpwambig
        !            45: may be used to iterate through all the
        !            46: matches for the name given to the last call to
        !            47: .IR getpwwho .
        !            48: If
        !            49: .I
        !            50: getpwwho
        !            51: returns -1 then name does not uniquely determine
        !            52: a person, a program can then print out all the names that match
        !            53: by repeatedly calling
        !            54: .I
        !            55: getpwambig
        !            56: until
        !            57: .I
        !            58: getpwambig
        !            59: returns 0.
        !            60: .sp
        !            61: Both
        !            62: .I
        !            63: getpwwho
        !            64: and
        !            65: .I
        !            66: getpwambig
        !            67: return with
        !            68: .I
        !            69: _gecos
        !            70: pointing to
        !            71: a
        !            72: .I
        !            73: gecos
        !            74: structure that results from parsing the GECOS field of
        !            75: the
        !            76: .I
        !            77: passwd
        !            78: entry that is returned.
        !            79: .SH "FILES"
        !            80: /etc/passwd    The password file.
        !            81: .SH "SEE ALSO"
        !            82: getpwnam(3),
        !            83: parsgecos(3)
        !            84: .SH "EXAMPLE"
        !            85: .B
        !            86: getpwwho("harry bovik");
        !            87: .br
        !            88: .B
        !            89: getpwwho("bovik");
        !            90: .br
        !            91: .B
        !            92: getpwwho("H Bovik");
        !            93: .br
        !            94: .B
        !            95: getpwwho("hb");
        !            96: .RS
        !            97: All of these match the person "Harry Q. Bovik",
        !            98: who has "hb" as his login name.
        !            99: .RE
        !           100: .SH "DIAGNOSTICS"
        !           101: .I
        !           102: Getpwwho
        !           103: return 0 if the person isn't found, -1 if the name
        !           104: is ambiguous.
        !           105: In the case that the name is ambiguous a program can
        !           106: iterate through all the possibilities by using
        !           107: .IR getpwambig .
        !           108: .SH "HISTORY"
        !           109: .TP
        !           110: 09-May-80  James Gosling (jag) at Carnegie-Mellon University
        !           111: Created.
        !           112: 
        !           113: 

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