lsuser 0.3.0

List system users in a clean, columnar layout using raw POSIX libc calls.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

# lsuser

List system users in a clean, columnar layout.

Most operating systems do not provide a straightforward, consistent API for enumerating local user accounts. `lsuser` solves this by using raw POSIX `libc` calls (`getpwent`/`setpwent`/`endpwent`) to read the password database and present users in a readable table — or structured JSON for scripting.

## Features

- **Cross-platform** — Works on macOS, Linux, and other Unix-likes via libc.
- **Smart defaults** — Filters out system accounts by default (UID < 500 on macOS, UID < 1000 or 65534 on Linux).
- **Show all accounts** — Use `-a` / `--all` to include system daemon users.
- **Customizable columns** — Choose which fields to display: `USER`, `UID`, `GID`, `REAL_NAME`, `HOME`, `SHELL`.
- **JSON output** — Use `-J` / `--json` for machine-readable output.
- **No external commands** — Does not parse `/etc/passwd` directly or shell out to `dscl`/`getent`.

## Installation

```sh
cargo install lsuser
```

Or build from source:

```sh
git clone https://github.com/your-username/lsuser.git
cd lsuser
cargo build --release
cp target/release/lsuser ~/.local/bin/
```

## Usage

```
lsuser [OPTIONS]
```

| Flag                    | Description                                    |
|-------------------------|------------------------------------------------|
| `-a`, `--all`           | List all users including system accounts       |
| `-n`, `--noheadings`    | Omit the header row                            |
| `-o`, `--output`        | Comma-separated columns (USER,UID,GID,REAL_NAME,HOME,SHELL) |
| `-O`, `--output-all`    | Show all available columns                     |
| `-J`, `--json`          | Output as JSON                                 |

### Examples

```sh
lsuser                     # list human users (default columns: USER, UID, HOME, SHELL)
lsuser -a                  # include system accounts
lsuser -o USER,UID,REAL_NAME  # custom columns
lsuser -O -J               # all columns as JSON
```