Return to pwcache.3 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / lib / libutil

Annotation of 43BSDReno/lib/libutil/pwcache.3, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1989 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: .\"    @(#)pwcache.3   5.3 (Berkeley) 6/23/90
                     19: .\"
                     20: .TH PWCACHE 3 "June 23, 1990"
                     21: .UC 7
                     22: .SH NAME
                     23: pwcache \- cache password and group entries
                     24: .SH SYNOPSIS
                     25: .ft B
                     26: .nf
                     27: user_from_uid(uid, nouser)
                     28: uid_t uid;
                     29: int nouser;
                     30: 
                     31: group_from_gid(gid, nogroup)
                     32: gid_t gid;
                     33: int nogroup;
                     34: .fi
                     35: .ft R
                     36: .SH DESCRIPTION
                     37: .ft B
                     38: This interface is not part of the C library.
                     39: It has been placed in the Berkeley utility library, libutil, as it is
                     40: used by several standard utilities.
                     41: .ft R
                     42: .PP
                     43: The
                     44: .I user_from_uid
                     45: function returns the user name associated with the argument uid.
                     46: The user name is cached so that multiple calls with the same uid 
                     47: do not require additional calls to
                     48: .IR getpwuid (3).
                     49: If there is no user associated with the uid, a pointer is returned
                     50: to an ASCII representation of the uid, unless the argument
                     51: .I nouser
                     52: is non-zero, in which case a NULL pointer is returned.
                     53: .PP
                     54: The
                     55: .I group_from_gid
                     56: function returns the group name associated with the argument gid.
                     57: The group name is cached so that multiple calls with the same gid
                     58: do not require additional calls to
                     59: .IR getgrgid (3).
                     60: If there is no group associated with the gid, a pointer is returned
                     61: to an ASCII representation of the gid, unless the argument
                     62: .I nogroup
                     63: is non-zero, in which case a NULL pointer is returned.
                     64: .SH SEE ALSO
                     65: getgrgid(3), getpwuid(3)

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