fiss

Friedel's Initialization and Service Supervision
Log | Files | Refs | LICENSE

vlogger.8.txt (2916B)

      1 @man vlogger 1 "MAY 2023" "%VERSION%" "fiss man page"
      2 @header vlogger(1) %VERSION%
      3 
      4 @title name Name
      5 
      6 *vlogger* - log messages to syslog or an arbitrary executable
      7 
      8 
      9 @title synopsis Synopsis
     10 
     11 *vlogger* [*-isS*] [*-f* file] [*-p* pri] [*-t* tag] [message ...]
     12 
     13 
     14 @title description Description
     15 
     16 The vlogger utility writes messages to the system log or an arbitrary executable.
     17 
     18 
     19 If vlogger is executed as logger it will always use the system log and behave like the regular logger(1).
     20 
     21 
     22 Without message arguments vlogger reads messages from stdin or the file specified with the -f flag. If the /etc/vlogger executable exists vlogger executes it with tag, level and facility as arguments, replacing
     23 the vlogger process.
     24 
     25 
     26 If vlogger is executed as a log service for fiss(8) or another daemontools like supervision suite it uses the service name as default tag. As example if vlogger is linked to /var/service/foo/log/run it uses “foo” as tag and “daemon.notice” as pri.
     27 
     28 
     29 The options are as follows:
     30 
     31 @list
     32 *-f file*
     33 Read lines from the specified file. This option cannot be combine message arguments.
     34 
     35 *-i*
     36 Log the PID of the vlogger process. Only supported if syslog(3) is used.
     37 
     38 *-p pri*
     39 The. pri can be facility.level or just facility. See FACILITIES, LEVELS or syslog(3). The default is “user.notice”.
     40 
     41 *-S*
     42 Force vlogger to use syslog(3) even if /etc/vlogger exists.
     43 
     44 *-s*
     45 Output the message to standard error, as well as syslog(3). Only supported if syslog(3) is used.
     46 
     47 *-t tag*
     48 Defines the openlog(3) ident which is used as prefix for each log message or passed as first argument to /etc/vlogger. The default is the LOGNAME environment variable.
     49 
     50 *message*
     51 Write the message to the system log.
     52 @endlist
     53 
     54 @title facilities Facilities
     55 
     56 auth~
     57 authpriv~
     58 cron~
     59 daemon~
     60 ftp~
     61 kern can not be used from userspace replaced with daemon~
     62 lpr~
     63 mail~
     64 news~
     65 syslog~
     66 user~
     67 uucp~
     68 local[0-7]~
     69 security deprecated synonym for auth
     70 
     71 
     72 @title levels Levels
     73 
     74 emerg~
     75 alert~
     76 crit~
     77 err~
     78 warning~
     79 notice~
     80 info~
     81 debug~
     82 panic deprecated synonym for emerg~
     83 error deprecated synonym for err~
     84 warn deprecated synonym for warning~
     85 
     86 
     87 @title files Files
     88 @list
     89 */etc/vlogger*~
     90 An optional executable file that is used to handle the messages. It is executed with tag, level and facility as arguments and replaces the vlogger process.
     91 @endlist
     92 
     93 @title exit Exit STATUS
     94 
     95 The vlogger utility exits 0 on success, and >0 if an error occurs.
     96 
     97 
     98 @title see See Also
     99 
    100 logger(1), syslog(3), svlogd(8)
    101 
    102 
    103 @title history History
    104 
    105 This program is a replacement for the logger utility provided by util-linux and forked from daemontools.
    106 
    107 
    108 @title authors Authors
    109 
    110 Duncan Overbruck <[email protected]>
    111 
    112 
    113 @title license License
    114 
    115 vlogger is in the public domain.
    116 
    117 To the extent possible under law, the creator of this work has waived all copyright and related or neighboring rights to this work.
    118 
    119 http://creativecommons.org/publicdomain/zero/1.0/