Remove wheel submodule - will re-add later with new URL
[dmon:dmon.git] / dslog.rst
1 ======
2  dlog
3 ======
4
5 ------------------------------------------------
6 Send lines from standard input to the system log
7 ------------------------------------------------
8
9 :Author: Adrian Perez <aperez@igalia.com>
10 :Manual section: 8
11
12
13 SYNOPSIS
14 ========
15
16 ``dslog [options] name``
17
18
19 DESCRIPTION
20 ===========
21
22 The ``dslog`` program sends lines given as standard input to the system
23 logger, one line at a time, with a selectable priority, facility and origin
24 program name.
25
26
27 USAGE
28 =====
29
30 Command line options:
31
32 -p PRIORITY, --priority PRIORITY
33               Priority of messages. Refer to `syslog(3)` to see possible
34               values. Just pass any valid priority without the ``LOG_``
35               prefix. Case does not matter.
36
37 -f FACILITY, --facility FACILITY
38               Logging facility. Refer to `syslog(3)` to see possible values.
39               Just pass any valid facility without the ``LOG_`` prefix. Case
40               does not matter.
41
42 -c, --console
43               If a message cannot be sent to the system logger, print a copy
44               of it to the system console.
45
46 -h, --help    Show a summary of available options.
47
48 Albeit it can be used stan-alone, most of the time you will be running
49 ``dslog`` under a process control tool like `dmon(8)` or `supervise(8)`.
50
51
52 ENVIRONMENT
53 ===========
54
55 Additional options will be picked from the ``DSLOG_OPTIONS`` environment
56 variable, if defined. Any command line option can be specified this way.
57 Arguments read from the environment variable will be prepended to the ones
58 given in the command line, so they may still be overriden.
59
60
61 SEE ALSO
62 ========
63
64 `dmon(8)`, `dlog(8)`, `rotlog(8)`, `multilog(8)`, `supervise(8)`
65
66 http://cr.yp.to/daemontools.html
67