---
name: "getsubids"
section: "1"
platform: "linux"
package: "shadow"
version: "4.20.0.arch1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/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)](/login.defs/5.md), [**newgidmap**(1)](/newgidmap/1.md), [**newuidmap**(1)](/newuidmap/1.md), [**subgid**(5)](/subgid/5.md), [**subuid**(5)](/subuid/5.md), [**useradd**(8)](/useradd/8.md), [**userdel**(8)](/userdel/8.md). [**usermod**(8)](/usermod/8.md),