RUNSTAT(1)

📦 version 1.10, in debian bookworm, debian trixie, nixpkgs unstable, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 RUNSTAT — bestie's guide to stalking your own processes 💖

okay so like, runstat is the manual page for the runstat command, and she is literally the friend who takes notes at the party so you don't have to. she runs your command, watches it do its thing, and then writes down everything that happened. iconic behavior honestly. 🦋

✨ NAME ✨

runstat — collect statistics about execution of a process 👀

🌸 SYNOPSYS 🌸

(yes bestie the manpage really spells it like that, we do not fix, we only admire ✨)

runstat [ -h ]
runstat [ -d ] [ -f pathname ] command [ args ]

💅 DESCRIPTION 💅

so here's the vibe: runstat tries to execute a command in a subprocess, and when that subprocess terminates (rip little guy 🪦), it collects some statistics about it and writes them to a file. that's it. that's the whole job. no cap.

and what's in those stats, you ask? time of execution, exit status, and elapsed time to execute, plus use of various OS resources. she's thorough. she's giving main character energy but make it observability. 👑

🌈 USAGE 🌈

  • -d — Debug mode, babes 🔍✨. Sends log messages to standard error as well as to the system log. so you get the tea twice, once right in your face and once in the logs. double the gossip, double the fun.
  • -f pathname — Specifies the pathname of the file to save the statistics to 📁. and if you don't say anything? the default is to create a file in /tmp/cronutils-$USER with the name of the command, and suffix ".stat". so like, it just makes you a lil stat file and calls it a day. lowkey thoughtful ngl.
  • -h — Prints some basic help 🆘💖. a little hand-holding, as a treat.

🫶 SEE ALSO 🫶

(the whole cronutils friend group, fr fr — go say hi to all of them 🌸)

👑 AUTHOR 👑

runstat was written by Jamie Wilkinson <jaq@google.com>. thank you for your service, king 🫡💜

This program is copyright (C) 2010 Google, Inc.

It is licensed under the Apache License, Version 2.0.

okay bestie real talk: that's the licensing info, don't skip it, it's giving legally binding and we respect the paperwork 💅

and that's the whole page!! this beauty ships with Google, Inc. energy, dated October 18, 2010, and yes she's filed under RUNSTAT(1) in the General Commands Manual section, exactly where she belongs. go forth and collect your stats, bestie 🎀✨💖

📦 where this page comes from