hpls(1)

💖 hpls — bestie edition 💖

okay so like, this is the manual page for hpls, and it lives in section 1 of the General Commands Manual, which is where all the cool commands hang out. it lists stuff on HFS+ volumes. let's get into it. 🦋

✨ NAME ✨

hpls — list the contents of a directory on an HFS+ volume. that's it. that's the whole vibe. 👑

🌸 SYNOPSIS 🌸

hpls [options] [hfs-path ...]

💅 DESCRIPTION 💅

so hpls is literally what you use to list files and directories on an HFS+ volume. if you hand it one or more arguments, each file or directory you named gets shown. if you don't hand it anything? it just shows you the contents of the current working directory. no thoughts, head empty, just your cwd. 🙈

🎀 OPTIONS 🎀

• -1 — every entry gets its own line. one entry, one line, periodt. this is the default when standard output is not a terminal.
• -a — show ALL the entries, even the "invisible" ones. default is to hide invisible files (rude of the default, honestly).
• -c — sort and display entries by their creation date instead of their modification date.
• -d — list the directory entries themselves instead of what's inside them. normally, if you name a directory on the command-line, you get its contents — this says "no bestie, give me the directory itself."
• -i — show the catalogue ID for each entry. every single file and directory on an HFS+ volume has a unique catalogue ID, no cap. 🔥
• -l — long format, main character energy. this shows:
  • entry type: "d" for directory, "f" for file, "F" for locked file
  • flags: "i" for invisible
  • type and creator (four-character strings) — files only
  • size (number of items in a directory, or resource and data bytes of a file, respectively)
  • date of last modification (or creation if the -c flag is given)
  • and the name 💖
• -m — continuous format, entries separated by commas. streamy.
• -q — swap special and non-printable characters in displayed filenames for question marks (?). this is the default when standard output is a terminal.
• -r — sort entries in reverse order before displaying. flip it and reverse it. 🔄
• -s — show the file size for each entry in 1K block units. heads up: the size includes blocks used for both data and resource forks. both. forks. 🍴
• -t — sort and display entries by time. normally files get sorted by name, but this switches it up. it sorts by last modification date unless -c is also specified (then creation date takes over).
• -x — column format like -C, except sorted horizontally into rows rather than columns. same energy, different direction.
• -w width — format output lines so they fit the given width. normally the width comes from your terminal, or from the environment variable COLUMNS, or from a default value of 80.
• -C — column format with entries sorted vertically. this is the default output format when standard output is a terminal.
• -F — certain output filenames get a single-character flag tacked on telling you what kind of thing it is: directories get a slash /, and executable Macintosh applications get an asterisk *.
• -N — all filenames get output verbatim, with no question-mark substitution whatsoever.
• -R — for each directory encountered in a listing, recursively descend into it and display its contents. it goes deeper. it always goes deeper. 🌀

ngl bestie, -R can spiral fast — every directory it hits, it dives into. just so you know what you're signing up for.

🫶 SEE ALSO 🫶

hfsplus(7), hpmount(1), hpcd(1), hppwd(1), hprm(1), hpmkdir(1), hpcopy(1), hpumount(1), hpfsck(1).

the whole friend group. go say hi. 🌈

👑 AUTHOR 👑

this manual page was written by Jens Schmalzing <jensen@debian.org> for Debian GNU/Linux, using the manual page by Klaus Halfmann <halfmann@libra.de> that comes with the source code, plus documentation from the Tech Info Library. icons giving credit where credit is due, we love to see it. 💜

and that's a wrap!! this page is hpls(1) from the General Commands Manual, section 1, and it's genuinely iconic. go list some directories, bestie. slay. ✨🎀💅