---
name: "getsubids"
section: "1"
platform: "linux"
package: "shadow"
version: "4.20.0.arch1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://carta.tech/man/getsubids"
---

# getsubids(1)

get the subordinate id ranges for a user

## NAME

getsubids - get the subordinate id ranges for a user

## SYNOPSIS

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

## DESCRIPTION

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

## OPTIONS

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

- **-g**

  List the subordinate group ID ranges.

- **-h**

  Display help message and exit.

## EXAMPLE

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

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

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

## SEE ALSO

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