umoci-list(1)(#)

✨ umoci-list β€” bestie edition ✨

okay so you want the tea on umoci list? it's the umoci-list(1) page, and honestly? it's a little icon. πŸ’…

written by Aleksa Sarai, back in DECEMBER 2016, which is basically the jurassic period but the code still eats.


🌸 NAME 🌸

umoci list β€” list all the tags in an OCI layout πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

umoci list --layout=layout

umoci ls --layout=layout

yes bestie, ls is the short king version of list. same energy, fewer letters. ✨


πŸ’– DESCRIPTION πŸ’–

so what this does is it gets you the list of tags that are defined in an OCI layout. one tag name per line, super clean, super readable, no notes. πŸ’…

⚠️ but heads up: the output order is not defined. like, do NOT go building your whole personality around the order it comes out in. it's giving "trust the contents, not the sequence." 😭

πŸ‘‘ OPTIONS πŸ‘‘

  • --layout=layout β€” the OCI image layout you want the list of tags from. layout must be a path to a valid OCI layout, no exceptions, no shortcuts, periodt. 🫢

🌈 EXAMPLE 🌈

here's the moment you've been waiting for: listing the set of tags in a layout that got copied from a docker(1) registry using skopeo(1). iconic collab honestly. 🧚

% skopeo copy docker://opensuse/amd64:42.1 oci:ocidir:42.1
% skopeo copy docker://opensuse/amd64:42.2 oci:ocidir:42.2
% skopeo copy docker://opensuse/amd64:latest oci:ocidir:latest
% umoci ls --layout ocidir
42.1
42.2
latest

look at that. three tags, three lines, zero drama. ate. ⭐


πŸ”₯ SEE ALSO πŸ”₯

go read those too, bestie, they're part of the same friend group. πŸ’œ


okay that's the whole page!! this was umoci-list(1) from the umoci manual, and it's dated back to DECEMBER 2016 β€” shoutout to the archives. stay hydrated, read your manpages, and remember: the order is not defined, so don't @ me about it. mwah πŸ’‹

πŸ“¦ where this page comes from