atlas ls

file version: 10 July 2026

Overview

atlas ls lists files and directories at the given path.

The command follows POSIX ls conventions, but note that -r and -R have different meanings than in most other atlas commands.

Usage

atlas ls [path] [flags]

Flags

Flag	Description
-a, --all	Include hidden files
-D, --detail	Show full archive detail per file
-E, --extra	Show extra detail including checksums
--full-path	Print one full path per entry, suitable for piping
-l, --long	Show detailed output with mode, owner, group, size, mtime, flags, copies, and name
-0, --print0	Terminate each entry with NUL instead of newline
-R, --recursive	List directories recursively
-r, --reverse	Reverse sort order
-t, --sort-time	Sort by modification time, newest first

Long Format Columns

mode  owner  group  size  mtime  flags  copies  name

ScoutAM File Flags

Archive flags:

Flag	Meaning
a----	File is completely archived
n----	File is marked as no archive
-----	File is not archived

Cache flags:

Flag	Meaning
-o---	File is online
-p---	File is partially online (mixed online/offline blocks)
-n---	File is marked as release never
-w---	File is offline but has a warm-tier copy (cache, POSIX, or S3)
-----	File is offline

Staging flags:

Flag	Meaning
--s--	File is staging
--X--	File is marked as stage failed
-----	File is not staging

Retention flags:

Flag	Meaning
---r-	File has retention set
-----	File does not have retention set

Checksum flags:

Flag	Meaning
----n	File has checksum set but has not been verified
----v	File has checksum set and has been verified
----X	File has checksum set but verified invalid
-----	File does not have a user checksum

Examples

atlas ls
atlas ls -la /data/projects
atlas ls --recursive /archive
atlas ls -lt /data/projects
atlas ls -ltr /data/projects
atlas ls -D /data/projects/file.dat
atlas ls -E /data/projects/
atlas ls -R --full-path /data/projects
atlas ls -R -0 /data | xargs -0 atlas rm -r

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