Fsdb::F...ce_to_db(3)

📦
version 3.9 · 3 versions
, in epel 9

💅 Fsdb::F...ce_to_db(3) 💅

okay bestie, welcome to Fsdb::F...ce_to_db(3) from the User Contributed Perl Documentation aisle of the manual-page mall 🛍️✨ this one is all about turning kitrace output into Fsdb format, and it's lowkey iconic.

💖 NAME 💖

kitrace_to_db — convert kitrace output to Fsdb format. slay.

✨ SYNOPSIS ✨

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

🦋 DESCRIPTION 🦋

Converts a kitrace data stream to Fsdb format. literally its whole job, and it ate.

The optional arguments are a list of registers which will be picked out of the output stream and formatted as their own columns. cute, organized, main character energy 💅

🎀 OPTIONS 🎀

  • -Y Y or --year Y — specify the 4-digit year for the dataset (defaults to current year).
  • -u or --utc — specify UTC timezone (defaults to local time zeon 🫶 yes, that spelling is in the page, not me).

This module also supports the standard fsdb options:

  • -d — enable debugging output.
  • -i or --input InputSource — read from InputSource, typically a file name, or "-" for standard input, or (if in Perl) a 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 in Perl) a IO::Handle, Fsdb::IO or Fsdb::BoundedQueue objects.
  • --autorun or --noautorun — by default, programs process automatically, but Fsdb::Filter objects in Perl do not run until you invoke the run() method. The "--(no)autorun" option controls that behavior within Perl.
  • --help — show help.
  • --man — show full manual.

🌸 SAMPLE USAGE 🌸

Here's the before/after, bestie — the glow-up is real 💖

📥 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

🫶 SEE ALSO 🫶

Fsdb. — that's the whole list, bestie. periodt.

🧚 CLASS FUNCTIONS 🧚

🆕 new

$filter = new Fsdb::Filter::kitrace_to_db(@arguments);

Create a new kitrace_to_db object, taking command-line arguments. new object, who dis 💅

⚙️ set_defaults

$filter->set_defaults();

Internal: set up defaults.

🪄 parse_options

$filter->parse_options(@ARGV);

Internal: parse command-line arguments.

🛠️ setup

$filter->setup();

Internal: setup, parse headers.

🏃 run

$filter->run();

Internal: run over each rows.

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.

okay bye bestie — this page was brought to you by perl v5.32.1, dated 2024-08-02, signing off as Fsdb::F...ce_to_db(3) 💖✨

📦 where this page comes from