KITRACE_TO_DB(1)

📦
version 3.9 · 3 versions
, in epel 9

💅 kitrace_to_db — the perl manpage, but make it make sense

okay so real talk, bestie: this is KITRACE_TO_DB(1), part of the User Contributed Perl Documentation collection, and it's genuinely the glow-up your kitrace data has been waiting for. Let's get into it 💖

✨ NAME ✨

kitrace_to_db — no cap, this thing converts kitrace output into Fsdb format. that's the whole vibe. 🎀

🌸 SYNOPSIS 🌸

kitrace_to_db [-Y year] [registers] <kitrace.out >kitrace.fsdb

literally just pipe it in and it comes out the other side looking like a database. iconic. ✨

🦋 DESCRIPTION 🦋

So here's the tea: this converts a kitrace data stream into Fsdb format. 🫶

And the optional arguments? They list registers — which get picked out of the output stream and formatted as their own little columns. main character energy for each register, honestly. 💅

💜 OPTIONS 💜

the kitrace_to_db girlies 🌸

  • -Y Y or --year Y — specifies the 4-digit year for the dataset. defaults to the current year, which like… fair. 🗓️
  • -u or --utc — specifies the UTC timezone. defaults to local time zeon. (yes, the manpage literally says "zeon". we're keeping it. it's iconic. 😭)

the standard fsdb options (it also supports these, bestie) 🧚

  • -d — enable debugging output. for when you need to see what's happening. 🔍
  • -i or --input InputSource — read from InputSource, typically a file name, or "-" for standard input, or (if you're in Perl) IO::Handle, Fsdb::IO or Fsdb::BoundedQueue objects. 🍓
  • -o or --output OutputDestination — write to OutputDestination, typically a file name, or "-" for standard output, or (if you're in Perl) IO::Handle, Fsdb::IO or Fsdb::BoundedQueue objects. 🌈
  • --autorun or --noautorun — okay so by default, programs process automatically, but Fsdb::Filter objects in Perl do not run until you invoke the run() method. this option controls that behavior within Perl. very "you have to ask nicely" of them. 💅
  • --help — show help. 🫶
  • --man — show the full manual. (hi, you're here 👋)

🔥 SAMPLE USAGE 🔥

🎀 Input:

_null_getpage+4  Nov  7 22:40:13.281070 (            ) pid 4893
_null_getpage+128 Nov  7 22:40:13.281756 (   00.000686) pid 4893
_null_getpage+4  Nov  7 22:40:13.282694 (   00.000938) pid 4893
_null_getpage+128 Nov  7 22:40:13.328709 (   00.046015) pid 4893
_null_getpage+4  Nov  7 22:40:13.330758 (   00.002049) pid 4893
_null_getpage+128 Nov  7 22:40:13.353830 (   00.023072) pid 4893
_null_getpage+4  Nov  7 22:40:13.355566 (   00.001736) pid 4893
_null_getpage+128 Nov  7 22:40:13.357169 (   00.001603) pid 4893
_null_getpage+4  Nov  7 22:40:13.358780 (   00.001611) pid 4893
_null_getpage+128 Nov  7 22:40:13.375844 (   00.017064) pid 4893
_null_getpage+4  Nov  7 22:40:13.377850 (   00.002006) pid 4893
_null_getpage+128 Nov  7 22:40:13.378358 (   00.000508) pid 4893

🦋 Command:

kitrace_to_db -Y 1995

⭐ Output:

#fsdb event clock diff
_null_getpage+4  815812813.281070      0.0
_null_getpage+128  815812813.281756  00.000686
_null_getpage+4  815812813.282694  00.000938
_null_getpage+128  815812813.328709  00.046015
_null_getpage+4  815812813.330758  00.002049
_null_getpage+128  815812813.353830  00.023072
_null_getpage+4  815812813.355566  00.001736
_null_getpage+128  815812813.357169  00.001603
_null_getpage+4  815812813.358780  00.001611
_null_getpage+128  815812813.375844  00.017064
_null_getpage+4  815812813.377850  00.002006
_null_getpage+128  815812813.378358  00.000508
# | kitrace_to_db

look at that #fsdb event clock diff header line. she ate. 👑

🌈 SEE ALSO 🌈

  • Fsdb. go give her a read, iykyk 💖

Copyright (C) 1991-2011 by John Heidemann <johnh@isi.edu>

This program is distributed under terms of the GNU general public license, version 2. See the file COPYING with the distribution for details. 📜

fr fr, read the COPYING file if you're gonna redistribute. it's giving "respect the license" energy and we stan. 💅

and that's the whole page, bestie 🫶 this version dropped as perl v5.32.1, dated 2024-08-02 — mwah, go convert some kitrace output, you're gonna slay 💖✨🎀

📦 where this page comes from