PEPC-ASPM(1)

💖 the aspm command 💖

okay bestie, sit down, hydrate, because we're about to talk about the aspm command and it's genuinely so good. this is section 1 of the General Commands Manual, and yes, that means it's a real executable you can just... run. iconic behavior fr fr.

---

✨ General options ✨

these are the glow-up options that work no matter what you're doing with aspm. learn them, love them.

• -h — show a short help message and then dip. that's it, that's the whole job. 💅
• -q — be quiet. like, only print the important stuff (warnings and such). main character silence. 🤫
• -d — print debugging information. turn this on when you wanna know everything.
• --debug-modules MODNAME[,MODNAME1,...] — okay so -d turns on all the debug messages, which is a lot. this option narrows them down to just the modules you name. for example, -d --debug-modules MSR will only show debug messages from the MSR module. targeted. precise. slay.
• --version — print the version number and exit. the classic.
• -H HOSTNAME, --host HOSTNAME — host name or IP address of the target system. the pepc command gets executed on that system using SSH instead of running locally. if you don't specify it, the command just runs locally. no cap.
• -U USERNAME, --username USERNAME — the name of the user to use for logging into the remote host over SSH. by default it looks up the user name in SSH configuration files. if it's not found there, it uses the current user name. 🫶
• -K PRIVKEY, --priv-key PRIVKEY — path to the private SSH key for logging into the remote host. if you don't specify it, keys configured for the host in SSH configuration files (e.g. ~/.ssh/config) are used. if no keys are configured there, standard key files (e.g. ~/.ssh/id_rsa) and the SSH agent are tried. the backup plans have backup plans.
• -D DATASET, --dataset DATASET — this one is for debugging and testing. it specifies the dataset to use for emulating the host you're running the command on. the datasets live in the pepc source code repository.

the argument can be a dataset path or a name. if you give it by name, these locations get searched for the dataset:

1. ./tests/emul-data in the program's directory
2. $PEPC_DATA_PATH/tests/emul-data
3. $VIRTUAL_ENV/share/pepc/tests/emul-data
4. $HOME/.local/share/pepc/tests/emul-data
5. /usr/local/share/pepc/tests/emul-data
6. /usr/share/pepc/tests/emul-data

• --force-color — force colorized output even if the output stream is not a terminal (this adds ANSI escape codes). rainbow mode, activated. 🌈
• --print-man-path — print the pepc manual pages directory path and exit. add this path to the MANPATH environment variable to make the manual pages available to the man tool. iykyk.

---

🎀 Subcommand info 🎀

retrieve PCI ASPM information for the system. she's nosy and we love her for it. 🌸

• --policy — retrieve the current global PCI ASPM policy from /sys/module/pcie_aspm/parameters/policy. the "default" policy indicates the system's default.
• --policies — retrieve the list of available PCI ASPM policies from /sys/module/pcie_aspm/parameters/policy.
• --device ADDR — specify the PCI device address for the --l1-aspm option. example: 0000:00:02.0.
• --l1-aspm — retrieve the L1 ASPM status (on/off) for the PCI device specified by --device. it reads from /sys/bus/pci/devices/{device}/link/l1_aspm.

---

🦋 Subcommand config 🦋

configure PCI ASPM settings. and listen — if you provide no parameter at all, the current value(s) will be displayed instead. she's helpful like that. 💜

• --policy [POLICY] — set the global PCI ASPM policy by writing to /sys/module/pcie_aspm/parameters/policy. use "default" to reset the policy back to the system's default setting.
• --device ADDR — specify the PCI device address for the --l1-aspm option. example: 0000:00:02.0.
• --l1-aspm [OPTION] — enable or disable L1 ASPM for the PCI device specified by --device. this happens via /sys/bus/pci/devices/{device}/link/l1_aspm. the valid values are 'on', 'off', 'enable', 'disable', 'true', or 'false'. six whole options, pick your fighter. 👑

---

reminder bestie: --device ADDR shows up in both info and config because it's the setup for --l1-aspm in each of them. it's not a typo, it's just how she's built. 🙈

and that's the whole page, no notes, ate and left no crumbs. this was PEPC-ASPM(1) from the General Commands Manual — section 1, general commands, periodt. 🎀✨🦋