OSTREE LS(1) ostree ls OSTREE LS(1)

.SH "NAME" ostree-ls - List file paths

.SH "SYNOPSIS"

.HP 240u

**ostree ls** \[OPTIONS...] {COMMIT} \[PATHS...]

.SH "DESCRIPTION"

.PP Prints a list of file paths within the given commit, and within the given path(s) if specified. The first letter of the file line output specifies the type: "-" for regular file, "d" for directory, "l" for symbolic link. See EXAMPLE section for more detail on the specific output.

.SH "OPTIONS"

.PP **--dironly**,**-d**

Do not recurse into directory arguments.

.RE

.PP **--recursive**,**-R**

Print directories recursively.

.RE

.PP **--checksum**,**-C**

Print checksum.

.RE

.PP **--xattrs**,**-X**

Print extended attributes.

.RE

.PP **--nul-filenames-only**

Print only filenames, NUL separated.

.RE

.SH "EXAMPLE"

.PP **$ ostree ls my-branch**

```


        d00644 0 0    0 /


        -00644 0 0    2 /helloworld.txt


        d00755 0 0    0 /testdirectory
```

Here, the first column is the file-type symbol (as explained in the DESCRIPTION section) followed by the S\_IFMT file type. The next two columns (here: 0 0) are respectively the user ID and group ID for the file. After the break, the next number represents that file's standard size. The final column is the file path.

OSTree

---

Document: ostree-ls(1) from ostree 2026.6-r0 (Chainguard OS)
Source: https://github.com/ostreedev/ostree