Remove wheel submodule - will re-add later with new URL
[dmon:dmon.git] / dlog.rst
1 ======
2  dlog
3 ======
4
5 ---------------------------------------------
6 Send lines from standard input to a log file
7 ---------------------------------------------
8
9 :Author: Adrian Perez <aperez@igalia.com>
10 :Manual section: 8
11
12
13 SYNOPSIS
14 ========
15
16 ``dlog [options] [logfile]``
17
18
19 DESCRIPTION
20 ===========
21
22 The ``dlog`` program sends lines given as standard input to a log file,
23 one line at a time, optionally adding a timestamp in front of each line.
24 If the log file is not specified, then lines are printed back to standard
25 output. The latter may be useful to add timestamps in shell pipelines.
26
27
28 USAGE
29 =====
30
31 Command line options:
32
33 -b, --buffered
34               Buffered operation. If enabled, calls to `fsync(2)` will be
35               avoided. This improves performance, but may cause messages to
36               be lost.
37
38 -t, --timestamp
39               Prepend a timestamp to each saved line. By default
40               timestamps are disabled. Timestamp format is
41               ``YYYY-mm-dd/HH:MM:SS``.
42
43 -h, --help    Show a summary of available options.
44
45 Albeit it can be used stan-alone, most of the time you will be running
46 ``dlog`` under a process control tool like `dmon(8)` or `supervise(8)`.
47
48
49 ENVIRONMENT
50 ===========
51
52 Additional options will be picked from the ``DLOG_OPTIONS`` environment
53 variable, if defined. Any command line option can be specified this way.
54 Arguments read from the environment variable will be prepended to the ones
55 given in the command line, so they may still be overriden.
56
57
58 SEE ALSO
59 ========
60
61 `dmon(8)`, `dslog(8)`, `rotlog(8)`, `multilog(8)`, `supervise(8)`
62
63 http://cr.yp.to/daemontools.html
64