BNO_PLOT(1)

💖 BNO_PLOT 💖

okay so bestie, this is the manual page for bno_plot, section 1 of the manual — a little command that makes 3D plots of your IO blocks and sizes ✨ no cap.

✨ NAME ✨

bno_plot — generate interactive 3D plot of IO blocks and sizes 🦋

🌸 SYNOPSIS 🌸

bno_plot [ -h | --help ]
         [ -v | --verbose ]
         [ -K | --keys-below ]
         [ <file...> ]

like… that's the whole vibe check. three flags, some files, we move 💅

🎀 DESCRIPTION 🎀

so bno_plot is a visualization tool for the block layer IO tracing tool called blktrace(8). and as its own docs say, blktrace is a block layer IO tracing mechanism that gives you detailed info about request queue operations all the way up to user space. it's giving ✨observability✨.

bno_plot utilizes gnuplot to generate a 3D plot of the block number output from btt. and if you don't specify any <files>, bestie, it will just utilize all files generated after btt was run with -B blknos — meaning: all files of the form blknos*[rw].dat. iconic default behaviour honestly.

now the flags, since there's no separate OPTIONS section, they live right here in the description where they belong:

• -h, --help — shows you the help. the "what do i even do" button 🙈
• -v, --verbose — verbose mode. it tells you more about what it's doing, which is lowkey nice.
• -K, --keys-below — forces bno_plot to put the keys below the graph. if you don't specify it, all keys for the input files get put in the upper right corner of the graph instead. and here's the plot twist: if the number of devices exceeds 10, then bno_plot will automatically push the keys under the graph. it just knows. main character energy fr fr 👑

⚠️ to use this utility, the gnuplot package needs to be installed. no gnuplot, no plot, no slay. periodt.

💀 and when you wanna dip out of the plotter, enter 'quit' or ^D at the 'gnuplot> ' prompt. that's your exit, bestie, don't just close the terminal and ghost it.

👑 AUTHORS 👑

bno_plot was written by Alan D. Brunelle. 🫶 and this man page was created from the blktrace documentation by Bas Zoetekouw. the way they documented this so we didn't have to 😭💖

🐛 REPORTING BUGS 🐛

found a bug? don't suffer in silence, report it to <linux-btrace@vger.kernel.org> — they literally wanna know ✨

📜 COPYRIGHT 📜

Copyright © 2008 Hewlett-Packard Development Company, L.P.

This is free software. You may redistribute copies of it under the terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law. (so like, no promises, bestie, don't come for them 💀)

This manual page was created for Debian by Bas Zoetekouw. It was derived from the documentation provided by the authors and it may be used, distributed and modified under the terms of the GNU General Public License, version 2.

On Debian systems, the text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-2. 📚

🌈 SEE ALSO 🌈

• btt (1)
• gnuplot (1)
• blktrace (8)
• blkparse (1)
• verify_blkparse (1)
• blkrawverify (1)

and that's the whole page, babes 🎀 this one came from the blktrace crew, version git-20080213182518, dated February 22, 2007 — yes it's an elder, and yes it still ate. 💅🦋 go plot something gorgeous, mwah 💖