srg(1)

📦 version 1.3.6, in debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 srg(1) — the manual, but make it cute 💖

General Commands Manual ✨ okay bestie, gather round, we're learning srg today and honestly? she's iconic.

🌸 NAME 🌸

srg — a fast and flexible log analyser for the Squid proxy 🦋

🎀 SYNOPSIS 🎀

srg srg [options] <logfile> [logfile] ...

yes the srg srg is really in there, I'm not typo-ing at you, that's literally what it says 💅

✨ DESCRIPTION ✨

So. SRG is a log analyser for the Squid web proxy. Periodt. 🫶

You feed her Squid access logs, and she hands you back a whole series of reports in PHP (or HTML) format — all designed to summarise what the users of the cache have been viewing. Like, she's basically doing a vibe check on your entire cache, no cap.

And she's flexible too 😭💖 SRG supports grouping requests by user, subnet or IP, and she can also filter on those same criteria. Grouping and filtering, both. She contains multitudes.

👑 OPTIONS 👑

One bullet per flag, every single one, let's gooo 🔥

  • -C <config file> — where the srg config file lives. Location of the srg config file.
  • -d — turn on debugging output. 🐛
  • -f <date>[time] — the start time to begin analysation at.
  • --help, -h — displays this help. hi bestie 👋
  • -H — generate HTML reports rather than PHP reports.
  • -m <days> — specify the maximum number of days to keep a report.
  • -M — output a summary report suitable for emailing. 📧
  • -o <directory> — output directory.
  • -O <URL> — the URL where reports will be located.
  • -t <date>[time] — the end time to stop analysation at.
  • -v — verbose mode. Prints relevant messages. 🗣️
  • -V — print version and exit.

🕰️ the date/time format tea 🕰️

For -f and -t, date and time get specified in this exact format:

 Date: YYYY-MM-DD
 Time: :HH:MM:SS - note leading :
 eg. 2005-01-08:15:46:30 (Jan 8 2005 15:46:30)

the leading : on the time is NOT optional, she will not accept your 24-hour-clock-without-colon nonsense. Note it. Memorise it. Slay it. 💅

📁 where the logfiles go 📁

Logfile(s) to process should be specified at the end of the options. Not the beginning. Not sprinkled in the middle. The end. 🎀

🌈 AUTHOR 🌈

SRG is written and maintained by Matt Brown <matt@crc.net.nz> with the help of many others. See AUTHORS in the top level of the source tree. 🫶

💀 BUGS 💀

Of course SRG doesn't have any bugs wink 😏

But if by some obscure chance you happen to find a bug in SRG, please report it via the URL below:

http://sourceforge.net/tracker/?func=add&group_id=62787&atid=501794
no for real, report it, she wants to know, she's not mad, she's just disappointed 🥺

and that's the whole page bestie 💖 this was the srg(1) manual page, straight out of the General Commands Manual — go analyse some logs, you're gonna eat ✨👑🦋

📦 where this page comes from