logread(1)

📦 version 0.2.4, in alpine 3.24

💖 logread(1) — your bestie's guide to the logbookd log fetcher ✨

okay so welcome to the logread page!! this is from the General Commands Manual and honestly it's giving tiny-but-mighty 🎀

✨ NAME ✨

logread — fetch log messages from the logbookd socket 🫶

🌸 SYNOPSIS 🌸

logread [OPTIONS]

OPTIONS := { -f | -F | -n limit | -d datefmt | -u unit  | -b boot | -c
color | -h }

like, you just run logread with some options and it goes and gets your logs, no big deal 💅 (the synopsis literally spells out the whole options set for you, so slay)

🦋 DESCRIPTION 🦋

so basically: logread connects to the running logbookd instance and queries the database for old or realtime log messages. that's it. that's the whole vibe. you want logs, it has logs, everyone's happy 😌✨

👑 OPTIONS 👑

  • -h — show the help message and quit. the classic "please tell me what's going on" button 🙈
  • -c { on | off } — force enable or disable the colorized output. yes queen, control the aesthetic yourself 💅🌈
  • -f — show only new log messages as they come in, in realtime. main character energy: you only care about what's happening right now ⭐
  • -F — show log messages as they come in, but first output the historical log messages. so you get the backstory and the live feed, obsessed 🫶
  • -n count — number of historical log messages to fetch after filtering. defaults to 100. and bestie, listen: if you pass 0, the amount of messages is not limited 😭 (that's a lot of logs, you've been warned)
  • -d datefmt — override the datetime formatting in the log output. defaults to %b %d %H:%M:%S. make it pretty, make it yours 🎀
  • -u unit — show only log messages for this specific service. this matches the prefix of the syslog "app" field. filtering by app? iconic 🌸
  • -b { boot-index | boot-id | "list" } — get only the log messages matching a specific boot-id. this parameter accepts the boot as a relative index or as an uuid to specify an absolute boot event. and use the special value "list" to display a list of stored boot logs instead 👑✨
ngl the -b one is lowkey the most powerful one here — relative index or uuid, your choice, iykyk 💜

🌈 SEE ALSO 🌈

  • logbookd(1) — the other half of this whole situation, go read it fr fr 🦋

and that's the page!! 💖 this was logread from the General Commands Manual, version/date situation being logread · 2026-03-06 · logread(1) — mwah, go fetch those logs bestie, periodt 🌟💅

📦 where this page comes from