atlas lsar#

file version: 10 July 2026

Overview#

atlas lsar lists the contents of an archive file without extracting it. The file must be online, not currently archived to tape. Stage it first if needed.

The summary line is written to stderr so the entry list on stdout pipes cleanly into other tools.

Supported archive types are tar, tar.gz, tgz, and zip.

Usage#

atlas lsar [flags] <archive-path>

Command Flags#

Flag	Description
`--limit N`	Maximum number of entries to return (default 10000)
`--limit int32`	Maximum number of entries to return (0 = server default)

Examples#

atlas lsar /hsm/arch/project/archive.tar
atlas lsar --limit 100 /data/archive.zip
atlas lsar @home/backups/dataset.tar.gz

Global Flags#

Flag	Description
`--ca-cert string`	Path to CA certificate for server verification
`--format string`	Machine-readable output format (`json` or `csv`); omit for the default human-readable output
`-L, --lang string`	Interface language (`en`, `de`)
`--no-color`	Disable color output
`-P, --plaintext`	Use plaintext (non-TLS) connection
`-s, --server string`	ATLAS server address; defaults to `ACLI_SERVER`, then the stored session, `/etc/atlas/atlas.conf`, and finally `localhost:7449`
`--tls-skip-verify`	Skip TLS certificate verification; enabled by default for self-signed setups