OSTREE-LS(1)

🌸 NAME 🌸

okay so this is the ostree-ls page from the OSTree manual, bestie. It does exactly what it says on the label: ostree-ls — list file paths. Short, sweet, main character energy. 💖

🦋 SYNOPSIS 🦋

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

💅 DESCRIPTION 💅

Prints a list of file paths inside the given {COMMIT}, and inside the given [PATHS...] if you pass them. The first letter of the file line output tells you the type, and it's giving very specific vibes:

• - means regular file
• d means directory
• l means symbolic link

Peep the EXAMPLE section for the full tea on what the output actually looks like. ☕✨

🎀 OPTIONS 🎀

• --dironly, -d — do not recurse into directory arguments. Stay in your lane, directory args. 🛑
• --recursive, -R — print directories recursively. Go off, tree. 🌳
• --checksum, -C — print checksum. 🔐
• --xattrs, -X — print extended attributes. Extra? Always. 💅
• --nul-filenames-only — print only filenames, NUL separated. Filenames only, no extra chatter. 🤐

🌈 EXAMPLE 🌈

       $ ostree ls my-branch

                   d00644 0 0    0 /
                   -00644 0 0    2 /helloworld.txt
                   d00755 0 0    0 /testdirectory

Here's the breakdown, bestie:

• The first column is the file-type symbol (the one explained in DESCRIPTION) followed by the S_IFMT file type.
• The next two columns (in the example: 0 0) are the user ID and group ID for the file.
• After the break, the next number is that file's standard size.
• The final column is the file path.

Signing off from the OSTree source/version corner, with the footer energy of OSTREE LS(1) and no separate date filled in here — so I'm not inventing one, periodt. 💖👑🫶