mdw@git.distorted.org.uk Git - qmail/blob - splogger.8

   1 .TH splogger 8
   2 .SH NAME
   3 splogger \- make entries in syslog
   4 .SH SYNOPSIS
   5 .B splogger
   6 [
   7 .I tag
   8 [
   9 .I fac
  10 ]
  11 ]
  12 .SH DESCRIPTION
  13 .B splogger
  14 reads a series of messages and feeds them to
  15 .BR syslog .
  16 At the front of each message it puts
  17 .I tag
  18 (default:
  19 .BR splogger )
  20 and a numerical timestamp.
  21
  22 .B splogger
  23 checks for
  24 .B alert:
  25 or
  26 .B warning:
  27 at the beginning of each message.
  28 It selects a priority of
  29 LOG_ALERT, LOG_WARNING, or LOG_INFO accordingly.
  30
  31 .B splogger
  32 logs messages with facility
  33 .IR fac .
  34 .I fac
  35 (default: 2)
  36 must be numeric.
  37
  38 .B splogger
  39 converts unprintable characters to question marks.
  40
  41 .B splogger
  42 does not log blank lines.
  43
  44 .B splogger
  45 folds messages after 800 characters,
  46 since
  47 .B syslog
  48 can't handle long messages.
  49 .B splogger
  50 uses a + after the timestamp
  51 to mark folded lines.
  52
  53 Note that the
  54 .B syslog
  55 mechanism is inherently unreliable:
  56 it does not guarantee that messages will be logged.
  57 It is also very slow.
  58 .SH "SEE ALSO"
  59 syslog(3),
  60 logger(8)