Remove wheel submodule - will re-add later with new URL
[dmon:dmon.git] / dlog.8
1 .\" Man page generated from reStructeredText.
2 .
3 .TH DLOG 8 "" "" ""
4 .SH NAME
5 dlog \- Send lines from standard input to a log file
6 .
7 .nr rst2man-indent-level 0
8 .
9 .de1 rstReportMargin
10 \\$1 \\n[an-margin]
11 level \\n[rst2man-indent-level]
12 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
13 -
14 \\n[rst2man-indent0]
15 \\n[rst2man-indent1]
16 \\n[rst2man-indent2]
17 ..
18 .de1 INDENT
19 .\" .rstReportMargin pre:
20 . RS \\$1
21 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
22 . nr rst2man-indent-level +1
23 .\" .rstReportMargin post:
24 ..
25 .de UNINDENT
26 . RE
27 .\" indent \\n[an-margin]
28 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
29 .nr rst2man-indent-level -1
30 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
31 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
32 ..
33 .SH SYNOPSIS
34 .sp
35 \fBdlog [options] [logfile]\fP
36 .SH DESCRIPTION
37 .sp
38 The \fBdlog\fP program sends lines given as standard input to a log file,
39 one line at a time, optionally adding a timestamp in front of each line.
40 If the log file is not specified, then lines are printed back to standard
41 output. The latter may be useful to add timestamps in shell pipelines.
42 .SH USAGE
43 .sp
44 Command line options:
45 .INDENT 0.0
46 .TP
47 .B \-b,  \-\-buffered
48 Buffered operation. If enabled, calls to \fIfsync(2)\fP will be
49 avoided. This improves performance, but may cause messages to
50 be lost.
51 .TP
52 .B \-t,  \-\-timestamp
53 Prepend a timestamp to each saved line. By default
54 timestamps are disabled. Timestamp format is
55 \fBYYYY\-mm\-dd/HH:MM:SS\fP.
56 .TP
57 .B \-h,  \-\-help
58 Show a summary of available options.
59 .UNINDENT
60 .sp
61 Albeit it can be used stan\-alone, most of the time you will be running
62 \fBdlog\fP under a process control tool like \fIdmon(8)\fP or \fIsupervise(8)\fP.
63 .SH ENVIRONMENT
64 .sp
65 Additional options will be picked from the \fBDLOG_OPTIONS\fP environment
66 variable, if defined. Any command line option can be specified this way.
67 Arguments read from the environment variable will be prepended to the ones
68 given in the command line, so they may still be overriden.
69 .SH SEE ALSO
70 .sp
71 \fIdmon(8)\fP, \fIdslog(8)\fP, \fIrotlog(8)\fP, \fImultilog(8)\fP, \fIsupervise(8)\fP
72 .sp
73 \fI\%http://cr.yp.to/daemontools.html\fP
74 .SH AUTHOR
75 Adrian Perez <aperez@igalia.com>
76 .\" Generated by docutils manpage writer.
77 .\" 
78 .