syslog-summary(1) summarize the contents of a syslog log file


syslog-summary [-s | --state= filename] [-i | --ignore= filename] [-d | --debug] [-r | --repeat] logfile...
syslog-summary [-h | --help]


This manual page documents briefly the syslog-summary command.

syslog-summary summarizes the contents of log files via the syslog(3) service, by displaying each unique (except for the time) line once, and also the number of times such a line occurs in the input. The lines are displayed in the order they occur in the input.


-i filename, --ignore=filename

Read regular expressions from filename and ignore lines in the logfiles that match them.

-s filename, --state=filename

Read state information from filename. The state contains information about the already reported parts of a log file, and prevents syslog-summary from reporting the same things many times. This is useful when syslog-summary is run from crontab every hour. The file is created, if it doesn't exist already.

-r, --repeat

Merge "last message repeated * times" lines with the repeated event.

-d, --debug

Enable verbose messages when errors occur (i.e. "debug mode").

-h, --help

Show summary of options.



Default ignore.rules file with default regular expressions.


When reporting a bug, please run syslog-summary with the -d (or --debug) flag enabled.

syslog-summary provides some return codes, that can be used in scripts:

0 Program exited successfully.
1 Something went wrong, please run the program with the debug messages enabled.


Lars Wirzenius <[email protected]>

Wrote this manpage for the Debian system.

Wrote the first version of syslog-summary.

Maintained the Debian package from 1998 to 2000.

Tommi Virtanen <[email protected]>

Maintained the package from 2001 to early 2008.

David Paleino <[email protected]>

Maintains the package since early 2008.


Copyright © 2008 David Paleino
Copyright © 2001-2007 Tommi Virtanen
Copyright © 1998-2000 Lars Wirzenius

This manual page was written for the Debian system (but may be used by others).

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 or (at your option) any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.