OpenBSD::IdCache(3p)

OpenBSD::IdCache3p

Cache for user and group look-ups

Usage

    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);

Overview

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

Releases

32 releases since OpenBSD 5.0; the text changed 20 times.

  1. 5.0–5.3
  2. 5.4–5.5
  3. 5.6
  4. 5.7
  5. 5.8–5.9
  6. 6.0
  7. 6.1
  8. 6.2
  9. 6.3–6.4
  10. 6.5
  11. 6.6
  12. 6.7
  13. 6.8
  14. 6.9–7.2
  15. 7.3
  16. 7.4
  17. 7.5
  18. 7.6
  19. 7.7–7.8
  20. 7.9
  21. 8.0

From man 8.0-current-20261101 in OpenBSD 8.0-current (2026-11-01). Parsed by carta from the page's man source.