LSHMC(8)

💿 lshmc(8) — okay bestie, let's peek inside that HMC DVD drive ✨

so this is a page from the System Manager's Manual, and it's all about lshmc — yes, lowercase, yes, it's giving "ls but make it mainframe" 💅

---

✨ NAME ✨

lshmc — list HMC drive DVD contents 🎀

---

🦋 SYNOPSIS 🦋

lshmc [OPTIONS] [FILE]

---

💖 DESCRIPTION 💖

okay so picture this: there's a DVD sitting in the DVD drive of your Hardware Management Console (HMC), and you wanna know what's on it. that's literally the whole gig. lshmc lists the files on that DVD, no cap 🫶

by default the command lists all files in the root directory of the DVD. simple. iconic.

but wait, there's more — you can pass FILE to list a different set of files. and FILE can specify the path, relative to the DVD root directory, for a directory and file, and it can contain the * and ? wildcard characters 🌸 so yeah, globbing is very much invited to the party.

---

💅 OPTIONS 💅

• -h, --help — prints the help text, then dips out. exit stage left 💀
• -v, --version — prints version info, then exits. short and sweet ✨
• -s, --short — prints only regular files — no directories, no symbolic links, no special files — in a short listing format. it's the "just the essentials" vibe check 🔥

---

🌈 EXAMPLES 🌈

want to list the files in an HMC drive DVD root directory? say less:

# lshmc

and if the hmcdrv kernel module wasn't loaded in advance (oops 🙈), do this first:

# modprobe hmcdrv
# lshmc

want all the HTML files in the subdirectory www? obsessed, here you go:

# lshmc /www/*.html

---

🩺 DIAGNOSTICS 🩺

okay so here's the part where you gotta pay attention, bestie, because lshmc needs access to the device node /dev/hmcdrv 👑

that node gets created automatically when the hmcdrv kernel module is loaded (peep the Linux kernel configuration option CONFIG_HMC_DRV for the deets).

and the user process running the lshmc command must have sufficient privileges to read from and write to the node /dev/hmcdrv — yes, read and write, both, no shortcuts. if it doesn't, use the commands chown(1), chgrp(1) and/or chmod(1) on the node /dev/hmcdrv to make that condition happen. permission glow-up, periodt 💫

ngl, if you're getting weird errors, this is the first thing to check — are you allowed to touch /dev/hmcdrv? 🧚

---

👀 SEE ALSO 👀

ls(1), chown(1), chgrp(1), chmod(1) and Linux on System z: Device Drivers, Features and Commands 📚

---

k bye, that's the whole page!! this lil masterpiece comes to you courtesy of s390-tools, dated Mar 2015 — vintage but still slaying 💜🎀🦋