xref: /386bsd/usr/share/man/cat3/pwcache.0 (revision a2142627)
1PWCACHE(3)                386BSD Programmer's Manual                PWCACHE(3)
2
3NNAAMMEE
4     ppwwccaacchhee - cache password and group entries
5
6SSYYNNOOPPSSIISS
7     uusseerr__ffrroomm__uuiidd(_u_i_d__t _u_i_d, _i_n_t _n_o_u_s_e_r)
8
9     ggrroouupp__ffrroomm__ggiidd(_g_i_d__t _g_i_d, _i_n_t _n_o_g_r_o_u_p)
10
11DDEESSCCRRIIPPTTIIOONN
12     TThhiiss iinntteerrffaaccee iiss nnoott ppaarrtt ooff tthhee CC lliibbrraarryy..  IItt hhaass bbeeeenn ppllaacceedd iinn tthhee
13     BBeerrkkeelleeyy uuttiilliittyy lliibbrraarryy,, lliibbuuttiill,, aass iitt iiss uusseedd bbyy sseevveerraall ssttaannddaarrdd
14     uuttiilliittiieess..
15
16     The uusseerr__ffrroomm__uuiidd() function returns the user name associated with the
17     argument _u_i_d. The user name is cached so that multiple calls with the
18     same _u_i_d do not require additional calls to getpwuid(3).  If there is no
19     user associated with the _u_i_d, a pointer is returned to an ASCII
20     representation of the _u_i_d, unless the argument _n_o_u_s_e_r is non-zero, in
21     which case a NULL pointer is returned.
22
23     The ggrroouupp__ffrroomm__ggiidd() function returns the group name associated with the
24     argument _g_i_d. The group name is cached so that multiple calls with the
25     same _g_i_d do not require additional calls to getgrgid(3).  If there is no
26     group associated with the _g_i_d, a pointer is returned to an ASCII
27     representation of the _g_i_d, unless the argument _n_o_g_r_o_u_p is non-zero, in
28     which case a NULL pointer is returned.
29
30SSEEEE AALLSSOO
31     getgrgid(3),  getpwuid(3)
32
33HHIISSTTOORRYY
34     The uusseerr__ffrroomm__iidd() and ggrroouupp__ffrroomm__iidd() functions are currently under
35     development.
36
37BSD Experimental                April 19, 1991                               1
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67