NAME

OpenBSD::IdCache - cache for user and group look-ups

SYNOPSIS

    use OpenBSD::IdCache;
    my $ucache = OpenBSD::UidCache->new;
    my $uid = $ucache->lookup("espie");
    my $gcache = OpenBSD::GidCache->new;
    my $gid = $gcache->lookup("wheel", 0);
    my $unamecache = OpenBSD::UnameCache->new;
    my $name = $unamecache->lookup($uid);
    my $gnamecache = OpenBSD::GnameCache->new;
    my $grname = $gnamecache->lookup($gid);

DESCRIPTION

"OpenBSD::IdCache" provides four classes: "OpenBSD::UidCache" for UIDs, "OpenBSD::GidCache" for GIDs, "OpenBSD::UnameCache" for user names, and "OpenBSD::GnameCache" for group names.

"UidCache::new" creates a UID cache, which can be used to look up user names by using the "lookup" method. Looking up a numeric user name is a no-op. Non-existing IDs return a default value, which is normally "undef" but can be provided as an extra argument to "lookup".

"GidCache::new" provides the same service for GIDs.

"UnameCache::new" creates a user name cache, which can be used to look up UIDs.

"GnameCache::new" provides the same service for group names.