.\" Process this file with .\" groff -man -Tascii modlogan.1 .\" This document is published under the term of the GPLv2. .\" Available at http://www.gnu.org/ .TH MODLOGAN 1 "NOV 2002" Linux "User Manuals" .SH NAME modlogan \- a modular log file analyzer .SH SYNOPSIS .TP 9 .B modlogan .B [ \-c .I configfile .B ] [ \-r ] [ \-u .I username .B ] .br .B [ \-h | \-\-help ] [ \-v | \-\-version ] .SH DESCRIPTION Modlogan is a modular logfile anaylizer. It is designed to have variable input, processing and output modules to give one a good flexiblity. .P The input modules parse the logfiles. The processor modules summarize the various data elements of a log file and is handed to the output module which makes in most cases a pretty webpage showing all the results. .P So far there the following .B input modules supported: bsdftpd, clf, elmeg, flow, flowraw, hicom116, ipchains, isdn4bsd isdnlog, msiis, msmedia, netscape, pureftpd, qmail, qmailscanner, qtss, realserver, sendmail, shoutcast, squid, wuftpd (also includes lgofiles from proftpd and the like). .P The following .B processor modules are supported: accounting, mail, telecom, web. .P And finally the .B output modules : csv, modlogan, template, tkcontrol, text, webalizer .SH OPTIONS .TP .BI -c " configfile" Specify another configuration file than the default .I /etc/modlogan/modlogan.conf . .TP .B -r It is note recommened to run modlogan as root. By default this is not permitted. If you still want to run it as root you have to use this option. .TP .BI -u " username" If you want to run modlogan as a specific user, you can use this option. In order to use this function you have to combine it with the .B -r command line switch. .TP .BR -h ", " --help Shows the help text of the program and exits. .TP .BR -v ", " --version Shows the version number of the program and exits. .SH FILES .TP .I /etc/modlogan/modlogan.conf This is the name and location of the default configuration file. .TP .I modlogan.def.conf This file contains the default settings for all the necessary options that modlogan can function. .TP .I group.*.conf These files contain regular expressions to group certain aspects of a logfile under a common term, like operating system, user agent, etc. .TP .I match.*.conf These configuration files also contain regular expressions to match a certain aspect of a logfile. .TP .I ignore.searchengines.conf This is a blacklist for all the known searchengines to filter them out from the logfiles. .SH AUTHOR The program was written by Jan Kneschke . This manual page was written by Othmar Pasteka . .SH SEE ALSO If you want further information about modlogan, see the .B modlogan web site at .