$OpenBSD: OpenBSD::IdCache.pod,v 1.2 2005/06/13 11:33:07 espie Exp $

=head1 NAME

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

=head1 SYNOPSIS

    use OpenBSD::IdCache;

    my $ucache = new OpenBSD::UidCache;
    my $uid = $ucache->lookup("espie");

    my $gcache = new OpenBSD::GidCache;
    my $gid = $gcache->lookup("wheel", 0);

    my $unamecache = new OpenBSD::UnameCache;
    my $name = $unamecache->lookup($uid);

    my $gnamecache = new OpenBSD::GnameCache;
    my $grname = $gnamecache->lookup($gid);

=head1 DESCRIPTION

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

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

C<GidCache::new> provides the same service for GIDs.

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

C<GnameCache::new> provides the same service for group names.