GETSUBIDS(1) User Commands GETSUBIDS(1)

.SH "NAME" getsubids - get the subordinate id ranges for a user

.SH "SYNOPSIS"

.HP 240u

**getsubids**  
\[*options*]  
*USER*

.SH "DESCRIPTION"

.PP The **getsubids** command lists the subordinate user ID ranges for a given user. The subordinate group IDs can be listed using the **-g** option.

.SH "OPTIONS"

.PP The options which apply to the **getsubids** command are:

.PP **-g**

List the subordinate group ID ranges.

.RE  
.PP **-h**

Display help message and exit.

.RE

.SH "EXAMPLE"

.PP For example, to obtain the subordinate UIDs of the testuser:

.PP

```
$ getsubids testuser
0: testuser 100000 65536
```

.PP This command output provides (in order from left to right) the list index, username, UID range start, and number of UIDs in range.

.SH "SEE ALSO"

.PP [**login.defs**(5)](/man/os/shadow/login.defs.5), [**newgidmap**(1)](/man/os/shadow/newgidmap.1), [**newuidmap**(1)](/man/os/shadow/newuidmap.1), [**subgid**(5)](/man/os/shadow/subgid.5), [**subuid**(5)](/man/os/shadow/subuid.5), [**useradd**(8)](/man/os/shadow/useradd.8), [**userdel**(8)](/man/os/shadow/userdel.8). [**usermod**(8)](/man/os/shadow/usermod.8),

10/09/2026 shadow-utils 4.20.3

---

Document: getsubids(1) from shadow 4.20.3-r0 (Chainguard OS)
Source: https://github.com/shadow-maint/shadow