← All commands
THE COMMAND REFERENCE

id

Print the user and group IDs and names of a user.

Last updated

Portable / common

Implementation-level reference; examples are not certified for every installed version.

Overview

id prints who a user is to the system: the numeric user ID, the group ID and the groups the user belongs to. With a flag it prints just one of these, which makes it handy in scripts, for example to test whether you are the root user (ID 0). With a user name as the last argument it describes that user instead of you.

Background

The macOS manual says id is expected to conform to POSIX.2, and that the historic groups command is equivalent to id -Gn and whoami to id -un. Today the name covers GNU id, the id that macOS ships, and the id applet in BusyBox. They agree on -u, -g, -G and -n.

Examples

Print your numeric user ID:

id -u | grep -c '^[0-9][0-9]*$'

Print your user name; -u selects the user and -n asks for the name:

test "$(id -un)" = "$(whoami)" && echo same

Print your primary group ID:

id -g | grep -c '^[0-9][0-9]*$'

List the names of all your groups on one line:

id -Gn | grep -c .

Check in a script whether you are the root user:

{ test "$(id -u)" -eq 0 && echo root || echo not root; } | grep -c .

Options

-u
Print only the user ID.

-g
Print only the primary group ID.

-G
Print the IDs of all groups.

-n
Print names instead of numbers; used with -u, -g or -G.

Common mistakes

-n does nothing on its own; combine it with -u, -g or -G. The group list shows the groups a session started with, so a group added later may not appear until you log in again. Test the number, as in id -u, rather than the name root, since a system can have another account with ID 0 or none named root.

Portability

Only -u, -g, -G and -n are in the Common examples, and the example outputs show only their shape because they depend on who runs them. GNU -Z for security context and -r for the real ID are not on every system. The Common examples were executed on GNU coreutils 9.11, macOS system tools, and BusyBox 1.37.0 (see the development guide for the exact check).

References

Original explanations, with upstream documentation for further reading. FreeBSD references are comparison material, not a claim of Apple version equivalence.