1
.TH logd 8 "October 2006" "Upstart"
4
logd \- job output logging daemon
7
\fBlogd\fR [\fIOPTION\fR]...
13
to receive the output of jobs with
15
in their job definition, which is the default if no other
19
Output is timestamped and written, with the job name, to
21
or stored in memory until the file is writable.
26
Detaches from the terminal and runs in the background.
29
To eliminate race conditions on startup, such as not being ready to receive
30
connections when the first job is started, the following procedure is used.
32
Once ready to receive connections,
36
signal, putting itself to sleep until continued by another process.
41
waits for the process to stop if it hasn't already, and then sends it the
43
signal so that it can proceed. Only once this has happened, will
49
option is given, this is not performed; instead
51
will not detach from the console until it is listening on the socket.
57
stream socket in the abstract namespace, bound to
58
.IR /com/ubuntu/upstart/logd .
61
opens a new connection for each job that is to be logged, binding the
62
socket to the standard input, output and error file descriptors for the job.
64
Before running the job, it sends the job name on the socket so that it can be
65
logged along with the messages. This is sent as a
67
that contains the length of the name to read, followed by that many
68
character bytes. The NULL terminator is not sent as part of the protocol,
69
it is up to the receiver to add that if required.
71
Further information about the job, such as its description, can be obtained
72
by opening an ordinary connection to the
74
daemon and querying it using the name received.
77
Written by Scott James Remnant.
80
Report bugs at https://launchpad.net/products/upstart/+bugs
83
Copyright \(co 2006 Canonical Ltd.
85
This is free software; see the source for copying conditions. There is NO
86
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.