about summary refs log tree commit diff
path: root/vlogger.8
blob: 2f46fcd0ef282b0c918024db5a855502c2e55984 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
.Dd March 1, 2017
.Dt VLOGGER 8
.Os Linux
.Sh NAME
.Nm vlogger
.Nd log messages to syslog or an arbitrary executable
.Sh SYNOPSIS
.Nm vlogger
.Op Fl p Ar priority
.Op Fl t Ar tag
.Sh DESCRIPTION
By default,
.Nm
reads lines from
.Dv stdin
and sends them to syslog.
If the file
.Pa /etc/vlogger
exists and is executable it is executed with
.Ar tag
as only argument and replaces
.Nm .
.Pp
If
.Nm
is executed as a log service for runit or another daemontools like
supervision suite it uses the service name as default
.Ar tag .
As example if
.Nm
is linked to
.Dv /var/service/foo/log/run
it uses
.Dv foo
as default
.Ar tag .
.Bl -tag -width indent
.It Fl p Ar priority
The.
.Ar priority
can be
.Pa facility.level
or just
.Pa facility .
See
.Sx FACILITIES ,
.Sx LEVELS
or
.Xr syslog 3 .
The default is
.Pa daemon.info .
.It Fl t Ar tag
Defines the
.Xr openlog 3
.Pa ident
which is used as prefix for each log message or passed as first argument to
.Pa /etc/vlogger .
.El
.Sh FACILITIES
.Bl -tag -width 11n -compact
.It auth
.It authpriv
.It cron
.It daemon
.It ftp
.It kern
can not be used from userspace replaced with
.Pa daemon .
.It lpr
.It mail
.It news
.It syslog
.It user
.It uucp
.It local[0-7]
.It security
deprecated synonym for
.Pa auth.
.El
.Sh LEVELS
.Bl -tag -width 11n -compact
.It emerg
.It alert
.It crit
.It err
.It warning
.It notice
.It info
.It debug
.It panic
deprecated synonym for
.Pa emerg .
.It error
deprecated synonym for
.Ar err .
.It warn
deprecated synonym for
.Pa warning .
.El
.Sh FILES
.Bl -tag -width indent
.It /etc/vlogger
An optional executable file that is used to to handle the messages.
It is executed with
.Ar tag
as first argument and replaces the
.Nm
process.
.El
.Sh EXIT STATUS
.Ex -std
.Sh EXAMPLES
.Pa /etc/vlogger :
.Bd -literal -offset indent
#!/bin/sh
exec svlogd /var/log/$1
.Ed
.Sh SEE ALSO
.Xr logger 1 ,
.Xr syslog 3 ,
.Xr svlogd 8
.Sh HISTORY
This program is a replacement for the
.Nm logger
utility provided by
.Nm util-linux .
.Sh AUTHOR
.An Duncan Overbruck Aq Mt mail@duncano.de
.Sh LICENSE
.Nm
is in the public domain.
.Pp
To the extent possible under law,
the creator of this work
has waived all copyright and related or
neighboring rights to this work.
.Pp
.Lk http://creativecommons.org/publicdomain/zero/1.0/