LSCFG(8)

okay bestie, welcome to the lscfg(8) manual page 💅 — grab a snack, this one's actually useful 🍓

---

✨ NAME ✨

lscfg — list hardware configuration 🌸

---

✨ SYNOPSIS ✨

lscfg [-v | --verbose] [-p | --specific] [-l<name> | --list=<name>]
      [-d<database-file> | --data=<database-file>] [-z<database-archive>
      | --zip=<database-archive>] [-h | --help]

---

✨ DESCRIPTION ✨

So this program is part of the lsvpd package for Linux, and that package is a (partial) reimplementation of AIX's lsvpd and its related commands — like, they brought the vibe over to Linux, no cap 🫶

lscfg lists hardware configuration info for the system and all its components, and the output is in a human readable format. Cute, right?

Here's the tea though, and this is important ☕: this implementation is merely a pretty-printer for info that's already been stored in lscfg's hardware inventory database at boot time and at hot-plug time. So it's not out here discovering anything new for you — it's just making what's already there look gorgeous ✨ Which means the vpdupdate(8) command must have been executed prior to running lscfg. Like, non-negotiable. If you skipped that step, bestie, there's nothing to print 💀

Some IBM POWER systems feature dynamic VPD (that's Vital Product Data, iykyk 🔥). And lscfg will only list this VPD when it's invoked by the root user. When invoked by another user, this VPD will be omitted — but the other VPD will still be listed, so you're not fully left on read 🙈

---

✨ OPTIONS ✨

• -v, --verbose — show Vital Product Data (VPD) for components, where available. The receipts, basically 🧾
• -p, --specific — list platform-specific information in a separate section, where available. Main character energy for your specific platform 👑
• -l<name>, --list=<name> — only show configuration information for the component with the given operating system name (i.e. the AX field in lsvpd output). Note that name may include wildcards, such as * and ? — however, such wildcards should be protected from the shell 🐚 (yes, your shell will absolutely eat them if you're not careful, protect them fr fr)
• -d<database-file>, --data=<database-file> — use <database-file> as the hardware inventory database, rather than the default file (/var/lib/lsvpd/vpd.db). This option is useful for producing output for previous hardware inventory databases that have been replaced by the system — like time-travelling back to your old hardware era 🦋
• -z<database-archive>, --zip=<database-archive> — use <database-archive> as the hardware inventory database, rather than the default directory (/var/lib/lsvpd/). Heads up though: the archive is a tar(1) archive that has been compressed using gzip(1), and it must contain a single directory containing at least a file called system-id 🎀 This option is useful for producing output for old hardware inventory databases that have been archived by the system.
• -h, --help — display a help screen and quit. The classic escape hatch, we stan 🌈

---

✨ FILES ✨

• /var/lib/lsvpd/vpd.db — database file used by lscfg. This is the default one, the home base, the main character file 💖

---

✨ SEE ALSO ✨

lsvpd(8), lsmcode(8), lsvio(8), vpdupdate(8) — go read those too, they're the friend group 🌸

---

✨ AUTHORS ✨

Eric Munson <ebmunson@us.ibm.com>. Brad Peters <bpeters@us.ibm.com>.

Copyright (c) 2002 - 2013 IBM. 🏢

---

and that's the whole page bestie, we ate and left zero crumbs 💅✨ — this was the lscfg(8) manual, so go forth and list that hardware configuration, mwah 🫶💖