COMMON2DLF.IN(1)

📦 version 2.1.1, in arch rolling

🦋 common2dlf.in(1) — like, the whole manual, bestie 🦋

okay so welcome to the LogReport's Lire Documentation corner of the internet 💖 this one's about common2dlf, and yes she's a .in file, we love a template moment ✨

🌸 NAME 🌸

common2dlf — the little icon that converts Common Log Format web server log files into a www DLF 🎀

⭐ SYNOPSIS ⭐

common2dlf file

that's it. one argument. she's lowkey minimal 💅

🫶 DESCRIPTION 🫶

okay so here's the tea ☕ — common2dlf converts Common Log Format web server log files into the www DLF. and what is Common Log Format? it's a standard log format, originally implemented in the CERN httpd web server, but now supported nowadays by most web servers (yes, the manpage really said "now supported nowadays", we're keeping the energy 😭). Apache, IIS, Boa and PureFTPD can all be configured to log in that format, no cap 🔥

and if the file argument is missing? no stress — STDIN gets parsed instead 🙈. DLF goes straight out on STDOUT. very demure, very mindful.

💜 COMMON LOG FORMAT 💜

the Common Log Format has this shape, and you're gonna memorize it because it's literally the whole vibe check:

remotehost rfc931 authuser [date] "request" status bytes

and here's what every field actually means 👇

  • remotehost — the host that made the request. can be an IP or a hostname, she's flexible like that 💫
  • rfc931 — the result of an ident lookup on the host. honestly? this is usually never used. like, ever. it's giving vestigial 🦋
  • authuser — the authenticated username 👤
  • date — the timestamp of the request ⏰
  • request — the first line of the request. usually in the format "method request-uri http-version". see also RFC 2616, section 5.1 📚
  • status — the result status of the request. i.e. 200, 301, 404, 500 💀 (we've all seen a 500, and we don't talk about it)
  • bytes — the size of the request sent to the client 📦

log example, because of course there's an example, bestie:

127.0.01 - - [11/03/2001 12:12:01 -0400] "GET / HTTP/1.0" 200 513
dsl1.myprovider.com - francis [11/03/2001 12:14:01 -0400] "GET /secret/ HTTP/1.0" 200 1256

look at francis, out here requesting /secret/ at 12:14 on 11/03/2001 — main character energy honestly 👑 (the 127.0.01 is exactly how the original wrote it, we do not fix, we do not touch, periodt 💅)

✨ EXAMPLES ✨

to process a log as produced in the common logformat:

$ lr_run common2dlf < common.log

and ngl, common2dlf will be rarely used on its own — she's more likely called by lr_log2report like the social butterfly she is 🧚

$ lr_log2report common < /var/log/httpd/common.log

🌈 SEE ALSO 🌈

go read those too, iykyk 🎀

👑 AUTHORS 👑

  • Joost van Baal <joostvb@logreport.org>
  • Francis J. Lacoste <flacoste@logreport.org>
  • Egon Willighagen <egonw@logreport.org>

based on an idea by Edwin Groothuis 💡 (the original idea-haver, we stan)

🍓 VERSION 🍓

$Id: common2dlf.in,v 1.15 2006/07/23 13:16:36 vanbaal Exp $

yep, that's the whole version string, character for character 📌

Copyright (C) 2000, 2001 Stichting LogReport Foundation LogReport@LogReport.org

this program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. 🫶

this program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. see the GNU General Public License for more details.

you should have received a copy of the GNU General Public License along with this program (see COPYING); if not, check with http://www.gnu.org/copyleft/gpl.html. 💖

⚠️ bestie, keep those warranty lines in mind — "without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE" is not a vibe, it's a legal fact 🙈

and that's the page!! Lire 2.1.1, dated 2025-09-28, signing off — mwah, go convert some logs, you're gonna slay 💅💖🎀

📦 where this page comes from