UUID(3)

πŸ¦‹ UUID(3) πŸ¦‹

okay bestie, welcome to the UUID(3) page β€” Programmers Manual energy, but make it fun ✨


🌸 NAME 🌸

uuid β€” the DCE compatible Universally Unique Identifier library, aka the vibe-checked way to make IDs that don't clash πŸ’…


✨ SYNOPSIS ✨

#include <uuid.h>

that's it. one include and you're in, no cap 🫢


πŸŽ€ DESCRIPTION πŸŽ€

Okay so picture this: you need identifiers for objects that might be reachable beyond the local system β€” like, other machines, other servers, other whole ecosystems. That's literally what the UUID library is for, and it ate πŸ’–

This library generates UUIDs that are compatible with the ones created by the Open Software Foundation (OSF) Distributed Computing Environment (DCE) utility uuidgen(1). Same family, same energy πŸ‘‘

The UUIDs it spits out can be reasonably expected to be unique within a system, and unique across all systems β€” yes, plural, all of them. Use case? Say you're running a bunch of web servers and you want unique HTTP cookies across all of them, with no communication between the servers, and no fear of a name clash. Iconic behaviour honestly 🌈


⭐ CONFORMING TO ⭐

This library generates UUIDs compatible with OSF DCE 1.1, plus hash based UUIDs V3 and V5 compatible with RFC-4122 <https://tools.ietf.org/html/rfc4122>. Standards queen πŸŽ€


πŸ’œ AUTHORS πŸ’œ

Theodore Y. Ts’o β€” the main character who made this happen πŸ™Œ


πŸ’… SEE ALSO πŸ’…

go read these next, iykyk:


πŸ“ REPORTING BUGS πŸ“

Found a bug? bestie pls don't suffer in silence 😭 take it to the issue tracker: <https://github.com/util-linux/util-linux/issues>. They want to hear from you fr fr 🫢


🌟 AVAILABILITY 🌟

The libuuid library has been part of the util-linux package since version 2.15.1 β€” yes, since before most of us were cool. You can download it from the Linux Kernel Archive <https://www.kernel.org/pub/linux/utils/util-linux/> if you need it πŸ’Ύβœ¨


and that's the whole page, bestie β€” no skipped sections, nothing left out, every fact accounted for. periodt πŸ’€πŸ’–

okay bye ily, go make some unique identifiers 🧚

β€” signed off with love: util-linux 2.41.6, dated 2026-08-31, page UUID(3) πŸŽ€πŸŒΈπŸ’œ

πŸ“¦ where this page comes from