File: running.docbook

package info (click to toggle)
lcdproc 0.4.3-10
  • links: PTS
  • area: main
  • in suites: woody
  • size: 1,964 kB
  • ctags: 1,838
  • sloc: ansic: 21,286; sh: 2,871; perl: 574; makefile: 101
file content (138 lines) | stat: -rw-r--r-- 3,669 bytes parent folder | download
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
<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 parallel port 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, including a list of the compiled in drivers.
</para>

<example>
<title><command>LCDd -h</command></title>
<screen> <![CDATA[
LCDd Server Daemon (part of lcdproc), 0.4.3dev
Copyright (c) 1999 Scott Scriven, William Ferrell, and misc contributors
This program is freely redistributable under the terms of the GNU Public License
Usage: LCDd [ -hfiws ] [ -c <config> ] [ -d <driver> ] [ -a <addr> ] \
	[ -p <port> ] [ -u <user> ] [ -w <time> ] [ -r <level> ]

Available options are:
	-h		Display this help screen
	-c <config>	Use a configuration file other than /etc/LCDd.conf
	-d <driver>	Add a driver to use (output only to first)
	-f		Run in the foreground
	-i		Disable showing of the main LCDproc server screen
	-w <waittime>	Time to pause at each screen (in seconds)
	-a <addr>	Network (IP) address to bind to
	-p <port>	Network port to listen for connections on
	-u <user>	User to run as
	-s		Output messages to syslog
	-r <level>	Report level (default=2)

Currently available drivers:
	lcdm001, LCDM001, MtxOrb, MatrixOrbital, CFontz, CrystalFontz, LB216, text,
	curses, ncurses, BayRAD, glk, glc


]]>
</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>
<title><command>lcdproc -h</command></title>
<screen> <![CDATA[

LCDproc, 0.4.3dev
Usage: lcdproc [-s server] [-p port] [modelist]
	Options in []'s are optional.
	modelist is "mode [mode mode ...]"
	Mode letters: 	[C]pu [G]raph [T]ime [M]emory [X]load [D]isk [B]attery
			proc_[S]izes [O]ld_time big_cloc[K] [U]ptime CPU_SM[P]
			[A]bout

	Use "man lcdproc" for more info.
Example:
	lcdproc -s my.lcdproc.server.com C M X -p 13666

]]>
</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>