> ## Documentation Index
> Fetch the complete documentation index at: https://docs.specterops.io/llms.txt
> Use this file to discover all available pages before exploring further.

# list_users

> This uses JXA to list the non-service user accounts on the system. You can specify a GID to look at the users of a certain group or you can use '-1' for GID to enumerate users for groups 0-1000

## Summary

This uses JXA to list the non-service user accounts on the system. You can specify a GID to look at the users of a certain group or you can use '-1' for GID to enumerate users for groups 0-1000

* Needs Admin: False
* Version: 1
* Author: @its\_a\_feature\_

### Arguments

#### gid

* Description:  Enumerate users in a specific group or -1 for all groups
* Required Value: False
* Default Value: None

<Tip>
  If -1 for all groups is used, there may be duplicate users shown if they are memebers of multiple groups
</Tip>

## Usage

```
list_users
```

## MITRE ATT\&CK Mapping

* T1087
* T1069

## Detailed Summary

* If gid is -1, enumerates all users and prints their info
* If gid > 0, enumerate all users within the specified group

All of these options are done via the Collaboration and CoreServices Frameworks and queried via API calls.