SYSLOGC(8)              OpenBSD System Manager's Manual             SYSLOGC(8)

NAME
     syslogc - collect messages from syslog memory buffer

SYNOPSIS
     syslogc [-Ccfo] [-s reporting_socket] logname
     syslogc -q

DESCRIPTION
     syslogc collects messages from the syslogd(8) memory buffer specified by
     the logname argument.

     For syslogc to work, syslogd(8) must be configured with one or more memo-
     ry buffer logs (see syslog.conf(5) for details) and have a reporting
     socket location specified on the commandline (using the -s option to
     syslogd(8)).

     By default, syslogc will query the specified log and return it to stan-
     dard output.

     The options are as follows:

     -C      Request that the log buffer be cleared without reading it.

     -c      Request that the log buffer be cleared once it has been read.

     -f      Print out the last 10 lines and read from the buffer continuous-
             ly.  Like the -f option in tail(1).

     -o      Check whether the specified log has overflowed.  If the log has
             overflowed, then a message will be printed to stdout(4) and the
             exit status will be set to 1.

     -q      Request a list of available logs.  If a log has overflowed an as-
             terisk (`*') will be appended to its name.

     -s reporting_socket
             Specify alternate reporting socket location (the default is
             /var/run/syslogd.sock).

SEE ALSO
     syslog(3), syslog.conf(5), syslogd(8)

HISTORY
     The syslogc command first appeared in OpenBSD 3.5.

CAVEATS
     The buffer space used for writing logs through the socket is limited.
     Thus it is possible to lose logs when running in continuous mode.  Losses
     are reported on standard error.

OpenBSD 4.7                   September 10, 2008                             1
