splogger.8
changeset 0 068428edee47
equal deleted inserted replaced
-1:000000000000 0:068428edee47
       
     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)