PMIE2COL(1)

💖 PMIE2COL 💖

okay bestie, welcome to pmie2col — a lil tool from the PCP fam (that's Performance Co-Pilot, in case you were wondering) and it is so good at what it does. she takes the kinda chaotic output from pmie(1) and turns it into a nice tidy column format. glow-up behavior honestly. 🌸

---

✨ NAME ✨

pmie2col — convert pmie output to multi-column format 🦋

---

🎀 SYNOPSIS 🎀

pmie2col [-?] [-d delimiter] [-p precision] [-w width]

---

💅 DESCRIPTION 💅

so pmie2col is a simple lil tool that converts output from pmie(1) into regular column format. like, it's giving spreadsheet-ready, no cap. 📊

each column is 7 characters wide by default (but you can change that with the -w option, more on her below) with a single space</> between columns. and bestie, that single space? you can swap it out for an alternate delimiter using the -d option — which is super useful if you're importing the data into a spreadsheet, for example. icons only. ✨

the precision of the tabulated values from pmie can be specified with the -p option (default is 2 decimal places). and heads up: this option can and will override any width setting in order to present the requested precision. she said width WHO? precision is the main character here. 💅

the pmie(1) configuration must follow these rules, fr fr:

1. Each pmie(1) expression is of the form NAME = expr;. NAME will be used as the column heading, and must contain no white space, although special characters can be escaped by enclosing NAME in single quotes.
2. The expr must be a valid pmie(1) expression that produces a singular value.

in addition, pmie(1) must be run with the -v command line option. don't forget it or she won't work, and that's on periodt. 😭

it is also possible to use the -e command line to pmie(1) and output lines will be prefixed by a timestamp. cute lil timestamp moment. ⏰

---

🌈 OPTIONS 🌈

the available command line options are:

• -d char, --delimiter=char — use char as output delimiter.
• -p N, --precision=N — use n as output floating point precision.
• -w N, --width=N — use n as output column width.
• -?, --help — display usage message and exit.

---

🍓 EXAMPLES 🍓

given this pmie(1) configuration file (named config):

loadav = kernel.all.load #'1 minute';
'%usr' = kernel.all.cpu.user;
'%sys' = kernel.all.cpu.sys;
'%wio' = kernel.all.cpu.wait.total;
'%idle' = kernel.all.cpu.idle;
'max-iops' = max_inst(disk.dev.total);

then this command pipeline:

$ pmie -v -t 5 <config | pmie2col -w 8

produces output like this:

   loadav     %usr     %sys     %wio    %idle max-iops
     0.21        ?        ?        ?        ?        ?
     0.36     0.49     0.03     0.18     0.29    25.40
     0.49     0.41     0.10     0.36     0.13    51.00
     0.69     0.49     0.10     0.05     0.37    43.20
     0.71     0.39     0.08     0.04     0.49    14.00
     0.83     0.63     0.15     0.00     0.21    32.30
     1.09     0.60     0.02     0.10     0.27    47.00
     0.92     0.01     0.00     0.00     0.99     2.40

look at those columns. aligned. immaculate. she ate and left no crumbs. 👑

---

🧚 PCP ENVIRONMENT 🧚

environment variables with the prefix PCP_ are used to parameterize the file and directory names used by PCP. on each installation, the file /etc/pcp.conf contains the local values for these variables. the $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(5).

---

👑 SEE ALSO 👑

PCPIntro(1) and pmie(1).

---

okay that's the whole page bestie, go forth and tabulate 💖

this lil manual page is from Performance Co-Pilot (that's the PCP girlies, hey!!) and she's living in section PMIE2COL(1). mwah, bye 🫶