Mike Doherty > App-Sysadmin-Log-Simple-0.005 > log


Annotate this POD


View/Report Bugs


log - maintain a single-host system administration log


version 0.005


log [--date YYYY/MM/DD] [--view] [--version] [--help]

Options: --date Read from/write to a date other than today's --view View a log file instead of add to it --logdir Use a different log directory --twitter Send your log entry to Twitter --no-file Skip logging to file --no-udp Skip sending log data over UDP --udp-data Sets UDP data: - whether to apply IRC colour encoding - port and host to send to --refresh-index Just refresh the index --version Print version information, then exit --help Show this manpage


log allows you to maintain a single-host system administration log with simple shell commands.



Which date to use instead of today's date. This allows you to add entries to old logs, or view old logs. Providing a future date is a fatal error.


View a log instead of adding to it.


Sets the log directory to use - defaults to /var/log/sysadmin.

--twitter, --no-twitter

Whether to send your log entry to Twitter. Default is false.

--file, --no-file

Whether to log to a file. Default is true.

--udp, --no-udp

Whether to send data by UDP in addition to logging (default) or not. If true, use --udp-data to specify where to send the data.


Sets data related to UDP. Specify a single key-value pair:

  • irc - whether to apply IRC colour encoding or not - default is on
  • host - the host to send to - default is localhost
  • port - the port to send to - default is 9002

Use it multiple times to set multiple key-value pairs:

    log --udp-data host=localhost --udp-data port=9002

Refresh the index of logs and exit.

--help, --man, -?

View this documentation.


View version data.



Add something to today's log.

log --view --date 2011/01/01

View the log for January 1, 2011, if it exists.

log --no-udp

Don't send a UDP datagram while adding to today's log

log --refresh-index

Re-generate the index page for the logs.

log --udp-data host= --udp-data port=5001

Send the UDP datagram somewhere other than the default.

log --udp-data irc=0

Don't apply IRC colouring to the log data send via UDP.


The project homepage is http://p3rl.org/App::Sysadmin::Log::Simple.

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit http://www.perl.com/CPAN/ to find a CPAN site near you, or see https://metacpan.org/module/App::Sysadmin::Log::Simple/.


The development version is on github at http://github.com/doherty/App-Sysadmin-Log-Simple and may be cloned from git://github.com/doherty/App-Sysadmin-Log-Simple.git


You can make new bug reports, and view existing ones, through the web interface at https://github.com/doherty/App-Sysadmin-Log-Simple/issues.


Mike Doherty <doherty@cpan.org>


This software is copyright (c) 2011 by Mike Doherty.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

syntax highlighting: