PCP-ROCESTAT(1)

💅 pcp-rocestat — the manual page bestie

okay so this is the PCP-ROCESTAT(1) page, from the General Commands Manual section, and it's literally all about reporting stats for your nVidia RoCE devices. no cap. let's get into it 🦋

✨ NAME ✨

pcp-rocestat — reports statistics for nVidia RoCE devices.

like that's the whole job. it reports. it stats. iconic behavior honestly 👑

🌸 SYNOPSIS 🌸

pcp [pcp options] rocestat [--hw_stats|--lane_stats]

see how it's nested inside pcp? yeah, rocestat rides along as a sub-command with your pcp options, and then you get to pick your lil stats flavor. 🎀

💖 DESCRIPTION 💖

so here's the tea: pcp-rocestat uses ethtool counters for each device and reports throughput per priority queue. that's the vibe. 📊

by default, pcp-rocestat reports live data for the local host — like, right now, your machine, in real time. main character energy. but bestie, it's flexible: it also has the ability to analyze data from PDP archives. so you can go back in time and read the receipts. 🔥

🎀 OPTIONS 🎀

• --hw_stats — display hardware counters. the raw hardware tea. 🔧
• --lane_stats — display lane statistics. lane by lane, bestie. 🛣️
• -a archive, --archive=archive — specify the PCP archive to examine. tell it which archive you wanna snoop through. 🗂️
• -s samples, --samples=samples — specify number of samples to report. how many lil snapshots do you want. 🔢
• -S starttime, --start=starttime — report the samples from the archive from the given time. your starting point, periodt. ⏰
• -T endtime, --finish=endtime — report samples from the archive until the given time. and this is where you stop. 🛑
• -V, --version — display version number and exit. quick lil flex then bye. 👋
• -?, --help — display usage message and exit. when you're lost, ask for directions. 🫶

🌈 PCP ENVIRONMENT 🌈

so environment variables with the prefix PCP_ are used to parameterize the file and directory names used by PCP. very demure, very mindful. 🧚

on each installation, the file /etc/pcp.conf contains the local values for these variables. and get this — the $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(5). ✨

for environment variables affecting PCP tools, see pmGetOptions(3). iykyk. 💜

👑 SEE ALSO 👑

PCPIntro(1), pcp(1), pmParseInterval(3) and environ(7). go read your siblings, bestie, they're all part of the family. 🫶

fr fr that's the whole page. every flag, every path, every variable — nothing skipped, nothing invented. slay. 💅

and that's a wrap, gorgeous 🌸 — this one came to you from Performance Co-Pilot (that's the PCP source, in case you were wondering) and it lives in the PCP-ROCESTAT(1) section of the manual. mwah. 💖