-
Notifications
You must be signed in to change notification settings - Fork 3
/
dlog.8
91 lines (91 loc) · 2.77 KB
/
dlog.8
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
.\" Man page generated from reStructuredText.
.
.TH DLOG 8 "" "" ""
.SH NAME
dlog \- Send lines from standard input to a log file
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
\fBdlog [options] [logfile]\fP
.SH DESCRIPTION
.sp
The \fBdlog\fP program sends lines given as standard input to a log file,
one line at a time, optionally adding a timestamp in front of each line.
If the log file is not specified, then lines are printed back to standard
output. The latter may be useful to add timestamps in shell pipelines.
.SH USAGE
.sp
Command line options:
.INDENT 0.0
.TP
.BI \-p \ TEXT\fR,\fB \ \-\-prefix \ TEXT
Insert the given text as prefix for each logged message. If
adding timestamps is enabled, the text is inserted \fIafter\fP
the timestamp, but still before the logged text.
.TP
.BI \-i \ NUMBER\fR,\fB \ \-\-input\-fd \ NUMBER
Use file descriptor \fBNUMBER\fP to read input. By default the
standard input descriptor (number \fB0\fP) is used.
.TP
.B \-b\fP,\fB \-\-buffered
Buffered operation. If enabled, calls to \fIfsync(2)\fP will be
avoided. This improves performance, but may cause messages to
be lost.
.TP
.B \-t\fP,\fB \-\-timestamp
Prepend a timestamp to each saved line. By default
timestamps are disabled. Timestamp format is
\fBYYYY\-mm\-dd/HH:MM:SS\fP\&.
.TP
.B \-e\fP,\fB \-\-skip\-empty
Ignore empty input lines. An empty line is one that does not
contain any characters; a line which contains whitespace is
\fBnot\fP considered empty.
.TP
.B \-h\fP,\fB \-\-help
Show a summary of available options.
.UNINDENT
.sp
Albeit it can be used stan\-alone, most of the time you will be running
\fBdlog\fP under a process control tool like \fIdmon(8)\fP or \fIsupervise(8)\fP\&.
.SH ENVIRONMENT
.sp
Additional options will be picked from the \fBDLOG_OPTIONS\fP environment
variable, if defined. Any command line option can be specified this way.
Arguments read from the environment variable will be prepended to the ones
given in the command line, so they may still be overriden.
.SH SEE ALSO
.sp
\fIdmon(8)\fP, \fIdslog(8)\fP, \fIrotlog(8)\fP, \fImultilog(8)\fP, \fIsupervise(8)\fP
.sp
\fI\%http://cr.yp.to/daemontools.html\fP
.SH AUTHOR
Adrian Perez <[email protected]>
.\" Generated by docutils manpage writer.
.