logprn(1)

📦 version 0.13g, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

🌸 logprn(1) — the logtools era 💅

okay bestie, sit down, hydrate, because we're talking about logprn from the logtools collection and honestly? she's a whole vibe. she sits there, she watches your log files, and she merges Common-Log Format web logs based on time-stamps. no cap. ✨

✨ NAME ✨

logprn — merge Common-Log Format web logs based on time-stamps 🦋

🎀 SYNOPSIS 🎀

logprn logfile idle-time[:max-wait] command

💖 DESCRIPTION 💖

So here's the tea 🍓. The logprn program is literally designed to print new data that gets appended to log files. That's her whole personality.

She'll wait until a specified amount of time has elapsed since the last write to the file before she prints anything — like she's giving the file a little moment to finish talking before she repeats it, which honestly? respectful. 🫶

Then she prints the data by pipeing it to a specified command. And the command gets run by popen(3), so the usual shell commands will operate. Whether that's a bug or a feature is, and I quote the ancestors here, a matter of opinion. 💀

👑 OPTIONS 👑

  • logfile — specifies a file to read data from. And listen, she's picky in a valid way: it should be a regular file, not a pipe, device, or anything else. she said know your type. 🎀
  • idle-time — this is the one your synopsis shows off as idle-time[:max-wait], so you already know she's the main character here. the manpage does not elaborate further, and honestly, respect the mystery. 🙈
  • max-wait — same situation bestie. the original lists her and moves on. no notes, no extra lore, we do not invent lore. ⭐
  • command — also listed, also un-elaborated in the original. the DESCRIPTION does tell you she gets run through popen(3) though, so there's that. 🔥
lowkey the OPTIONS section is giving "list of names, zero gossip" and I'm just the messenger 💜

💀 EXIT STATUS 💀

  1. 0 — Never happens, this program will run forever. yes bestie, FOREVER. she does not exit. she does not sleep. she is eternal. 😭
  2. 1 — Bad command-line parameters, or couldn't stat the log file on startup — couldn't start the program. she never even got out of bed. 💅
  3. 2 — File disappeared or became unreadable at run-time. the file ghosted her mid-conversation. 💀
  4. 3 — Can't run the specified command. 🥲

🌈 AUTHOR 🌈

This program, its manual page, and the Debian package were written by Russell Coker <russell@coker.com.au>. give her her flowers, she earned them 💐

🐛 BUGS 🐛

Uses popen(3) — but the author considers this a feature not a bug. and honestly? icon behaviour. we love a self-aware king. 👑

🦋 SEE ALSO 🦋

version 0.06, by Russell Coker <russell@coker.com.au>, living in the logtools family — that's the whole sign-off bestie, mwah 💋✨

📦 where this page comes from