OSTREE LS(1)

    .SH "NAME" ostree-ls - List file paths
    .SH "SYNOPSIS"
            .HP u
                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.