PWCACHE(3) | Library Functions Manual | PWCACHE(3) |
pwcache
, user_from_uid
,
uid_from_user
, pwcache_userdb
,
group_from_gid
,
gid_from_group
,
pwcache_groupdb
—
#include <pwd.h>
const char *
user_from_uid
(uid_t
uid, int
nouser);
int
uid_from_user
(const
char *name, uid_t
*uid);
int
pwcache_userdb
(int
(*setpassent)(int), void
(*endpwent)(void), struct
passwd * (*getpwnam)(const char *),
struct passwd *
(*getpwuid)(uid_t));
#include
<grp.h>
const char *
group_from_gid
(gid_t
gid, int
nogroup);
int
gid_from_group
(const
char *name, gid_t
*gid);
int
pwcache_groupdb
(int
(*setgroupent)(int), void
(*endgrent)(void), struct
group * (*getgrnam)(const char *),
struct group *
(*getgrgid)(gid_t));
user_from_uid
() function returns the user name
associated with the argument uid. The user name is
cached so that multiple calls with the same uid do not
require additional calls to
getpwuid(3). If there is no
user associated with the uid, a pointer is returned to a
string representation of the uid, unless the argument
nouser is non-zero, in which case a
NULL
pointer is returned.
The group_from_gid
() function returns the
group name associated with the argument gid. The group
name is cached so that multiple calls with the same
gid do not require additional calls to
getgrgid(3). If there is no
group associated with the gid, a pointer is returned
to a string representation of the gid, unless the
argument nogroup is non-zero, in which case a
NULL
pointer is returned.
The uid_from_user
() function returns the
uid associated with the argument name. The uid is
cached so that multiple calls with the same name do
not require additional calls to
getpwnam(3). If there is no
uid associated with the name, the
uid_from_user
() function returns -1; otherwise it
stores the uid at the location pointed to by uid and
returns 0.
The gid_from_group
() function returns the
gid associated with the argument name. The gid is
cached so that multiple calls with the same name do
not require additional calls to
getgrnam(3). If there is no
gid associated with the name, the
gid_from_group
() function returns -1; otherwise it
stores the gid at the location pointed to by gid and
returns 0.
The pwcache_userdb
() function changes the
user database access routines which user_from_uid
()
and uid_from_user
() call to search for users. The
caches are flushed and the existing endpwent
()
method is called before switching to the new routines.
getpwnam and getpwuid must be
provided, and setpassent and
endpwent may be NULL
pointers.
The pwcache_groupdb
() function changes the
group database access routines which
group_from_gid
() and
gid_from_group
() call to search for groups. The
caches are flushed and the existing endgrent
()
method is called before switching to the new routines.
getgrnam and getgrgid must be
provided, and setgroupent and
endgrent may be NULL
pointers.
user_from_uid
() and
group_from_gid
() functions first appeared in
4.4BSD.
The uid_from_user
() and
gid_from_group
() functions first appeared in
NetBSD 1.4.
The pwcache_userdb
() and
pwcache_groupdb
() functions first appeared in
NetBSD 1.6.
January 24, 2002 | NetBSD 9.2 |