ostree-ls(1)

ostree-ls1

List file paths

Usage

ostree ls [OPTIONS ...] COMMIT [PATHS ...]

Overview

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.

Options

--dironly,-d

Do not recurse into directory arguments.

--recursive,-R

Print directories recursively.

--checksum,-C

Print checksum.

--xattrs,-X

Print extended attributes.

--nul-filenames-only

Print only filenames, NUL separated.

Examples

$ 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.

Releases

6 releases since Debian 9 (Stretch); the text changed 5 times.

  1. 9
  2. 10
  3. 11
  4. 12
  5. 13
  6. Arch

From ostree 2026.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.