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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
|
<chapter id="running">
<title>Running LCDproc</title>
<sect1 id="running-lcdd">
<title>Running LCDd</title>
<para>
If you have installed the init-scripts you can simply start, stop
and restart LCDd with the init-script.
</para>
<sect2 id="lcdd-commandline">
<title>Running LCDd from the command line</title>
<para>
There are several reasons for running LCDd from the command line
</para>
<itemizedlist>
<listitem><para>You don't want to install LCDd but run it from the source directory.</para></listitem>
<listitem><para>You want to do some debugging.</para></listitem>
<listitem><para>You want to get the output directly on stderr.</para></listitem>
<listitem><para>...</para></listitem>
</itemizedlist>
<note>
<para>
If you run LCDd as a "normal" user, it will not change to the user
specified in the config file.
For some devices, mostly parallel port devices but also some USB devices,
you will need root privileges anyway ;)
</para>
</note>
<para>
The simplest command that will run LCDd is the following. It is useful for
running LCDd from the source directory, e.g. after building.
</para>
<screen>
<prompt>$</prompt> <userinput>server/LCDd -c LCDd.conf</userinput>
</screen>
</sect2>
<sect2 id="lcdd-commandline-options">
<title>The Command Line Options of LCDd</title>
<para>
Running <command>LCDd -h</command> gives you an overview of the currently available
command line options.
</para>
<example id="lcdd-commandline-options.example">
<title><command>LCDd -h</command></title>
<screen> <![CDATA[
LCDd - LCDproc Server Daemon, 0.5dev
Copyright (c) 1999-2006 Selene Scriven, William Ferrell, and misc. contributors.
This program is released under the terms of the GNU General Public License.
Usage: LCDd [<options>]
where <options> are:
-h Display this help screen
-c <config> Use a configuration file other than /etc/lcdproc/LCDd.conf
-d <driver> Add a driver to use (overrides drivers in config file) [curses]
-f Run in the foreground
-a <addr> Network (IP) address to bind to [127.0.0.1]
-p <port> Network port to listen for connections on [13666]
-u <user> User to run as [nobody]
-w <waittime> Time to pause at each screen (in seconds) [4]
-s <bool> If set, reporting will be done using syslog
-r <level> Report level [2]
-i <bool> Whether to rotate the server info screen
]]>
</screen>
</example>
</sect2>
</sect1>
<sect1 id="running-lcdproc">
<title>Running lcdproc</title>
<para>
You will probably more often run <command>lcdproc</command> from the command line than
you will run LCDd.
</para>
<sect2 id="lcdproc-commandline-options">
<title>The Command Line Options of lcdproc</title>
<para>
Running <command>lcdproc -h</command> gives you an overview of the currently available
command line options.
</para>
<example id="lcdproc-commandline-optionsi.example">
<title><command>lcdproc -h</command></title>
<screen> <![CDATA[
lcdproc - LCDproc system status information viewer
Copyright (c) 1999-2006 Selene Scriven, William Ferrell, and misc. contributors.
This program is released under the terms of the GNU General Public License.
Usage: lcdproc [<options>] [<screens> ...]
where <options> are
-s <host> connect to LCDd daemon on <host>
-p <port> connect to LCDd daemon using <port>
-f run in foreground
-e <delay> slow down initial announcement of screens (in 1/100s)
-c <config> use a configuration file other than /etc/lcdproc/lcdproc.conf
-h show this help screen
-v display program version
and <screens> are
C CPU detailed CPU usage
P SMP-CPU CPU usage overview (one line per CPU)
G CPUGraph CPU usage histogram
L Load load histogram
M Memory memory & swap usage
S ProcSize biggest processes size
D Disk filling level of mounted file systems
I Iface network interface usage
B Battery battery status
T TimeDate time & date information
O OldTime old time screen
U Uptime uptime screen
K BigClock big clock
N MiniClock minimal clock
A About credits page
Example:
lcdproc -s my.lcdproc.server.com -p 13666 C M X
]]>
</screen>
</example>
<note>
<para>
You will not be able to connect to a remote server, unless it listens to
the correct interface and port! See <link linkend="server-section">
<filename>LCDd.conf</filename>: The [server] Section</link>
for details on the server setup.
</para>
</note>
</sect2>
</sect1>
</chapter>
|
