OpenBSD::IdCache(3p) | Perl Programmers Reference Guide | OpenBSD::IdCache(3p)

# 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.

2023-05-16 | perl v5.40.1