ATOPCONVERT(1)

📦
version 2.13.0 · 3 versions
  • 2.13.0 · alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, debian trixie, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 2.7.1 · ubuntu jammy
  • 2.8.1 · debian bookworm
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, debian trixie, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

👑 atopconvert — the glow-up machine for your raw log files

okay bestie, welcome to atopconvert(1), a manual page for a tiny little program that does one job and does it flawlessly: it takes your crusty old raw log file and gives it a whole new-version makeover. no cap.

✨ NAME ✨

atopconvert — convert raw log file to newer version

like. that's it. that's the whole gig. 💅

🌸 SYNOPSIS 🌸

atopconvert [-t version ] rawinput [rawoutput]

look at that. three little pieces. so demure.

💖 DESCRIPTION 💖

so the way that atopconvert works is genuinely so simple it's giving main character energy. its whole thing is converting the layout of a raw log file to a newer version. that's the vibe.

the only mandatory argument is the name of the raw input file. rawinput. that one, you have to give her. no rawinput, no conversion. periodt.

now here's the cute part — what happens next depends on whether you hand her an output file:

  • no output file on the command line? then atopconvert just shows you the version of the input file. that's it. she's just reading the tag on the inside of the collar. lowkey iconic.
  • you specify a name for an output file? then the input file gets converted into that output file. and if the input file is already at the required version, she just copies it. no drama, no fuss. 🫶

by default, atopconvert converts the input file to the format used by the newest version of atop, and writes the result to the output file. newest version, always, unless you say otherwise.

and if you do wanna say otherwise:

  • -t version — specify an alternative target version for the output file instead of the newest version. the version goes in major.minor format, like 2.3. example below, bestie:
-t 2.3

after the conversion is finished, the output file can be read by the newer version of atop — or it can even be extended by that atop version. so like, she's not just pretty, she's functional. 🔥

🦋 NOTES 🦋

okay listen, two things, and I need you to actually hear them:

the raw input file should be at least of version 2.0! do not come to her with anything older, she will not be able to help you. 😭
files can only be upgraded to higher versions. they cannot be downgraded. it's a one-way glow-up. there is no un-glow-up. 💀

🌈 SEE ALSO 🌈

go read those too, they're all part of the family. iykyk. 🎀

💜 AUTHOR 💜

Gerlof Langeveld (gerlof.langeveld@atoptool.nl)

okay that's the whole page bestie!! this one was written for <strong>Linux</strong> and the last time it got a lil touch-up was <strong>January 2024</strong> — stay gorgeous, stay converted, and never downgrade your version or yourself 💅✨

📦 where this page comes from