PMDANFSCLIENT(1)

💖 PMDANFSCLIENT(1) — the General Commands Manual page, but make it cute 💖

okay so bestie, welcome to PMDANFSCLIENT, straight out of the General Commands Manual section of your fave system docs. sit down, grab a boba, and let's get into it 🧋✨

---

✨ NAME ✨

pmdanfsclient — the NFS client statistics performance metrics domain agent (aka a PMDA, which is giving very much "Performance Metrics Domain Agent" energy 💅)

---

🌸 DESCRIPTION 🌸

okay so pmdanfsclient is a Performance Metrics Domain Agent (PMDA) — literally what it says on the tin, no cap. what does it DO though? it exports metric values from the /proc/self/mountstats interface, and the whole point of that is to hand you the tea ☕ on your NFS mounts. that's it. that's the job. and it ate. 🔥

---

🎀 INSTALLATION 🎀

wanna install the nfsclient PMDA? slay, here's the vibe — you gotta be root for this, no exceptions bestie 👑

# cd $PCP_PMDAS_DIR/nfsclient
# ./Install

and when you're done and you wanna uninstall? also root, also a whole thing, here's the ritual 🙈

# cd $PCP_PMDAS_DIR/nfsclient
# ./Remove

now listen, super important, do NOT skip this part: pmdanfsclient gets launched by pmcd(1) and should never be executed directly. like, never ever. it's not a "run it yourself" situation, it's a "let pmcd handle it" situation, iykyk 🫶

also cute detail: the Install and Remove scripts notify pmcd(1) when the agent gets installed or removed. so it always knows what's up. communication queen 💅

---

🦋 FILES 🦋

here's the file lineup, and yes every single one matters:

• $PCP_PMDAS_DIR/nfsclient/Install — the installation script for the pmdanfsclient agent 🛠️
• $PCP_PMDAS_DIR/nfsclient/Remove — the undo-installation script for the pmdanfsclient agent (the "jk, take it back" button) ↩️
• $PCP_LOG_DIR/pmcd/nfsclient.log — the default log file where pmdanfsclient drops its error messages, so if something's acting up, this is where the receipts live 📝

---

🌈 PCP ENVIRONMENT 🌈

okay so environment variables with the prefix PCP_ are the ones that parameterize the file and directory names that PCP uses. very "these names are customizable actually" of them ✨

on each installation, the file /etc/pcp.conf contains the local values for these variables. that's the home base for all your local config, bestie 🏠

and plot twist — you can use the $PCP_CONF variable to point at an alternative configuration file instead, as described over in pcp.conf(5). options! we love options! 💖

---

👑 SEE ALSO 👑

go read these next, they're all part of the lore:

• PCPIntro(1)
• pmcd(1)
• nfs(5)
• mountstats(8)

---

⭐ friendly reminder: if you're about to run pmdanfsclient by hand, don't. pmcd(1) is its ride-or-die and it does not need a plus-one 💀

---

and that's the whole page, periodt 💅✨ this lil masterpiece comes to you courtesy of Performance Co-Pilot / PCP — that's the source and the version right there, and the footer's date is the doc date, so now you know where it came from 🫶 bye bestie, go read your metrics 💖🌸