Fsdb::F...at_to_db(3)

📦
version 3.9 · 3 versions
, in epel 9

💖 NAME 💖

okay bestie, welcome to the Fsdb::F...at_to_db(3) page from the User Contributed Perl Documentation — yes, that manual name is a whole mouthful, but the utility is combined_log_format_to_db, and it does one iconic thing: convert Apache Combined Log Format to Fsdb. 🦋

✨ SYNOPSIS ✨

combined_log_format_to_db < access_log > access_log.fsdb

🌸 DESCRIPTION 🌸

It converts logs in Apache Combined-Log-Format into Fsdb format. that's the vibe, that's the whole job. 💅

🎀 OPTIONS 🎀

No program-specific options — literally zero, bestie.

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 🦋

📥 Input

foo.example.com - - [01/Jan/2007:00:00:01 -0800] "GET /~moll/wedding/index.html HTTP/1.0" 200 2390 "-" "Mozilla/5.0 (compatible; Yahoo! Slurp; http://help.yahoo.com/help/us/ysearch/slurp)"
127.0.0.1 - - [01/Jan/2007:00:00:02 -0800] "GET /hpdc2007/ HTTP/1.1" 304 - "http://grid.hust.edu.cn:8080/call/cfp.jsp" "Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; InfoPath.1; InfoPath.2)"
bar.example.com - - [31/Dec/2006:23:51:40 -0800] "GET /nsnam/dist/ns-allinone-2.29.2.tar.gz HTTP/1.1" 206 58394090 "file://D:\\\xce\xd2\xb5\xc4\xce\xc4\xb5\xb5\\ns2\\XP_Using_Cygwin.htm#Windows_Support_for_Ns-2.27_and_Earlier" "Mozilla/4.0 (compatible; MSIE 5.00; Windows 98)"
127.0.0.1 - - [01/Jan/2007:00:00:02 -0800] "GET /hpdc2007/hpdc.css HTTP/1.1" 304 - "http://www.isi.edu/hpdc2007/" "Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; InfoPath.1; InfoPath.2)"

🪄 Command

combined_log_format_to_db

📤 Output

#fsdb -F S client identity userid time method resource protocol status size refer useragent
foo.example.com  -  -  [01/Jan/2007:00:00:01 -0800]  GET  /~moll/wedding/index.html  HTTP/1.0  200  2390  "-"  "Mozilla/5.0 (compatible; Yahoo! Slurp; http://help.yahoo.com/help/us/ysearch/slurp)"
127.0.0.1  -  -  [01/Jan/2007:00:00:02 -0800]  GET  /hpdc2007/  HTTP/1.1  304  -  "http://grid.hust.edu.cn:8080/call/cfp.jsp"  "Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; InfoPath.1; InfoPath.2)"
bar.example.com  -  -  [31/Dec/2006:23:51:40 -0800]  GET  /nsnam/dist/ns-allinone-2.29.2.tar.gz  HTTP/1.1  206  58394090  "file://D:\\\xce\xd2\xb5\xc4\xce\xc4\xb5\xb5\\ns2\\XP_Using_Cygwin.htm#Windows_Support_for_Ns-2.27_and_Earlier"  "Mozilla/4.0 (compatible; MSIE 5.00; Windows 98)"
127.0.0.1  -  -  [01/Jan/2007:00:00:02 -0800]  GET  /hpdc2007/hpdc.css  HTTP/1.1  304  -  "http://www.isi.edu/hpdc2007/"  "Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; InfoPath.1; InfoPath.2)"
#   | combined_log_format_to_db

👀 SEE ALSO 👀

Fsdb. and <http://httpd.apache.org/docs/2.0/logs.html> — go peek, bestie. 💜

🧚 CLASS FUNCTIONS 🧚

🌱 new

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

Create a new combined_log_format_to_db object, taking command-line arguments.

🌸 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) 2008 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.

✨ cute sign-off: this lil page ships with perl v5.32.1, dated 2024-08-02, under the Fsdb::F...at_to_db(3) manual name. bye bestie, go parse some logs 💅💖

📦 where this page comes from