LIRE.IN(1)

📦 version 2.1.1, in arch rolling

💅 LIRE.IN(1) — the lire page, but make it make sense

ok so bestie, welcome to Lire (that's section 1 of the manual, from LogReport's Lire Documentation — very official, very demure). This is the page for lire, the interface. Let's get into it ✨

🌸 NAME 🌸

lire — the Lire interface. That's it, that's the name, she's simple, she's iconic.

🦋 SYNOPSIS 🦋

lire

no flags, no drama, just vibes and a menu. periodt.

💖 DESCRIPTION 💖

okay so lire has two purposes, and honestly she's a multi-hyphenate:

  1. it configures Lire
  2. it enables automatic report generation

lire is a menu driven application — as in, it's all clicking around in a cute little interface, not typing a novel into the terminal. You should use the TAB key to navigate across the various interface elements. The arrow keys should be used to navigate menus. The main menubar can be accessed at all times using F10 — like a little home button for your soul 🏠

The mouse might be available depending on your terminal and the implementation of the Curses::UI module of your system. might. no promises. it's giving "it depends" 💀

🎀 configuring Lire 🎀

The 'Preferences' menu item in the 'Lire' menu will give you access to all the Lire settings. Like, all of them. The lire command edits or creates ~/.lire/config.xml — so that's the file doing all the heavy lifting, bestie 🫶

🔥 automatic report generation 🔥

lire enables automatic report generation by creating and managing DLF stores. A DLF store is a log repository — think of it as the closet where all your logs live, organized, slaying 🗄️✨

In a DLF store, you can configure ImportJobs and ReportJobs that will be executed regularly. Store configuration is saved in store/config.xml.

  • ImportJob — a job that will import log data into the DLF store. This data will be used later to generate the reports. (the data has to come from somewhere, bestie 💅)
  • ReportJobs — should be used to generate periodical reports. Reports are generated from the DLF streams available in your DLF store. The report can be generated for different schedules. Lire supports 5 different schedules: hourly, daily, weekly, monthly and yearly.

You will need to select the report configuration file to use for each schedule. Defaults are located in <sysconfdir>/lire/, which you should use as templates that you need to customize according to your purpose. templates, okay? TEMPLATES. customize them, don't just rawdog the defaults 🙈

The reports can be generated either from the log data imported in the database or from previously generated daily reports. This is useful when you have lots of log data and you don't want to keep all the raw data available. The source is selected automatically based on data availability. You should note however that only 'daily' reports are considered as a data source for other reports (making that possible only with weekly or longer schedules). iykyk — daily is the main character here 👑

When executed, a ReportSchedule will only generate the report and save it in the DLF store. If you want to obtain a formatted copy of the report, you will need to configure one or more OutputJobs. no formatted copy for free, honey, you gotta configure her 💅

Two types of OutputJob are supported:

  1. The report can be sent by email to one or more address;
  2. or it can saved in a file on the disk. A useful configuration is to generate HTML reports in a directory published on a web site. When using a "file" OutputJob you will probably want to use strftime(3) expansion so that the filename is different each time the report is generated. The most common expansions are:
%Y - fou digits year (2000);
%m - two-digits month number (01 for january);
%V - ISO week number;
%d - day of the month number;
%H - hour of day (01-23).

Also, contrary to the lr_log2report command, HTML reports are generated into a directory (not as a tar file). different behavior, same queen energy 🎀

To run the scheduled jobs, you will need to setup cron jobs. Use lr_cron(1) to process the configured jobs in a store. cron is the og scheduler and we respect her 🫡

💜 SEE ALSO 💜

go read them, they're free and they're lore 🌈

👑 AUTHORS 👑

The legends themselves:

  • Francis J. Lacoste <flacoste@logreport.org>
  • Wolfgang Sourdeau <wolfgang@logreport.org>

⭐ VERSION ⭐

$Id: lire.in,v 1.10 2006/07/23 13:16:32 vanbaal Exp $

the version string, preserved exactly, untouched, sacred 🧚

Copyright (C) 2004 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. (like, genuinely, no warranty, don't come for her 😭)

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.

okay bestie that's the whole page 💖 every option, every file path, every schedule, every strftime expansion — all of it, no cap. now go configure your DLF store and slay ✨

Lire 2.1.1 · dated 2025-09-28 · mwah, that's the whole man page, ily, go read lr_cron(1) next 🫶💅

📦 where this page comes from