vlogger.8.txt (2916B) download
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
16The vlogger utility writes messages to the system log or an arbitrary executable.
17
18
19If vlogger is executed as logger it will always use the system log and behave like the regular logger(1).
20
21
22Without 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
23the vlogger process.
24
25
26If 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
29The options are as follows:
30
31@list
32*-f file*
33Read lines from the specified file. This option cannot be combine message arguments.
34
35*-i*
36Log the PID of the vlogger process. Only supported if syslog(3) is used.
37
38*-p pri*
39The. pri can be facility.level or just facility. See FACILITIES, LEVELS or syslog(3). The default is “user.notice”.
40
41*-S*
42Force vlogger to use syslog(3) even if /etc/vlogger exists.
43
44*-s*
45Output the message to standard error, as well as syslog(3). Only supported if syslog(3) is used.
46
47*-t tag*
48Defines 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*
51Write the message to the system log.
52@endlist
53
54@title facilities Facilities
55
56auth~
57authpriv~
58cron~
59daemon~
60ftp~
61kern can not be used from userspace replaced with daemon~
62lpr~
63mail~
64news~
65syslog~
66user~
67uucp~
68local[0-7]~
69security deprecated synonym for auth
70
71
72@title levels Levels
73
74emerg~
75alert~
76crit~
77err~
78warning~
79notice~
80info~
81debug~
82panic deprecated synonym for emerg~
83error deprecated synonym for err~
84warn deprecated synonym for warning~
85
86
87@title files Files
88@list
89*/etc/vlogger*~
90An 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
95The vlogger utility exits 0 on success, and >0 if an error occurs.
96
97
98@title see See Also
99
100logger(1), syslog(3), svlogd(8)
101
102
103@title history History
104
105This program is a replacement for the logger utility provided by util-linux and forked from daemontools.
106
107
108@title authors Authors
109
110Duncan Overbruck <[email protected]>
111
112
113@title license License
114
115vlogger is in the public domain.
116
117To the extent possible under law, the creator of this work has waived all copyright and related or neighboring rights to this work.
118
119http://creativecommons.org/publicdomain/zero/1.0/