NAME

       lr_log2mail - send a report generated from a log file by email

SYNOPSIS

       lr_log2mail [options] service addresses...

       lr_log2report --version

       lr_log2report --help [dlf-converters|output-formats|report-templates]

OPTIONS

       --help [section]
           If no argument is given, prints usage information and exits. Argument can be one of
           the following:

           dlf-converters
               Prints the list of available DLF converters and exits.

           output-formats
               Prints the list of available output formats and exits.

           report-templates
               Prints the list of available report templates and exits.

       --version
           Prints Lire's version and exits.

       --output-format|-o output format
           Selects the ouput format in which to generate the report.

       --template name
           Uses the report configuration named name to generate the report.

       --log-file logfile
           Selects the log file that should be processed instead of STDIN.

       --subject|-s subject
           Sets the subject of the email message. Defaults to 'Your format report'.

       --extra-file file
           An additional text file that will be sent along the report. If the output format is
           txt, it will be appended to the report.

DESCRIPTION

       The lr_log2mail command is similar to the lr_log2report(1) command with the difference
       that the report is sent by email. The log file is read from STDIN or from the file
       specified using the --log-file option. The format of the log file is specified using the
       dlf_converter argument. Use the --help-dlf-converters option to get a list of all
       currently available DLF converters. All remaining arguments are interpreted as email
       addresses to which to send the report. In case the log is passed in a compressed format,
       it's uncompressed on the fly, using gzip(1).

       The report will be encapsulated in a MIME email appropriate for the output format. For
       example, ASCII reports will be sent inline, PDF reports will be sent as a file attachment
       and HTML reports should appear inline in a HTML-capable mail reader.

       The From and Reply-To headers in the outgoing emails are set to the values of the
       lr_mail_from and lr_mail_replyto configuration variables.

EXAMPLE

        % lr_log2mail -s "bind8 report" bind8_query \
            root "Joe User <joe@example.com>" < /var/log/query.log

SEE ALSO

       lr_log2report(1), lr_xml2report(1), lr_xml2mail(1), lire(1), lire(7), documentation in the
       Lire User Manual

AUTHORS

         Joost van Baal <joostvb@logreport.org>
         Francis J. Lacoste <flacoste@logreport.org>

VERSION

       $Id: lr_log2mail.in,v 1.60 2006/07/23 13:16:33 vanbaal Exp $

COPYRIGHT

       Copyright (C) 2000-2004 Stichting LogReport Foundation LogReport@LogReport.org

       This program is part of Lire.

       Lire 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.