lcdproc - system status information client
Contents
Description
lcdproc is the client in the LCDproc suite that displays information about the local system's status on
an LCD that is connected to an LCDd server daemon.
Due to the client-server architecture it does not matter whether the LCDd daemon runs on the local
machine or on a remote system.
Most settings of lcdproc are configured through its configuration file /etc/lcdproc.conf, some of them
can be overridden using command line options.
Before running lcdproc you should carefully read through that file and modify the settings therein
according to your needs.
When compiled appropriately, some aspects of lcdproc can even configured at run time using a menu on the
LCD.
Currently, only Linux, the BSD variants FreeBSD, NetBSD, OpenBSD and Darwin as well as Solaris are
supported, but not all features may be available on all platforms.
Examples
lcdprocCMD'!L'
With the command line specified above, lcdproc loads the default configuration file, connects to the LCDd
server specified therein and then displays the following screens in addition to those activated in the
configuration file on the LCD:
* detailed CPU Usage
* Memory & swap usage
* filling level of the mounted file systems
The
* Load histogram
screen is disabled and therefore not shown in the display. (The quotes are not part of lcdproc's command
line syntax; they are required to disable special interpretation of the exclamation mark by the shell).
Files
/etc/lcdproc.conf, lcdproc's default configuration file
Legal Stuff
LCDproc is released as "WorksForMe-Ware". In other words, it is free, kinda neat, and we don't guarantee
that it will do anything in particular on any machine except the ones it was developed on.
It is technically released under the GNU GPL license (you should have received the file, "COPYING", with
LCDproc) (also, look on http://www.fsf.org/ for more information), so you can distribute and use it for
free -- but you must make the source code freely available to anyone who wants it.
For any sort of real legal information, read the GNU GPL (GNU General Public License). It's worth
reading.
LCDproc 24 March 2011 lcdproc(1)
Name
lcdproc - system status information client
Options
lcdproc understands these command line options:
-cconfig
Use a configuration file other than /etc/LCDd.conf
-shost
Connect to the LCDd server on host, instead to the one listed in te Server parameter in the config
file's [lcdproc] section. If not given here and not specified in the config file or if the
default config file does not exist, it defaults to 'localhost.
-pport
Use port port when connecting to the LCDd server on host. This option overrides the Port
parameter in the config file's [lcdproc] section. Without a default config file or when not set
in the config file, it defaults to the LCDproc port 13666.
-f Run in the foreground, overriding the Foreground parameter in the config file's [lcdproc] section.
The default, if not in the config file or without a config file, is to daemonize lcdproc as it is
intended to display the system information in the background.
-edelay
Sleep delay in 100ths of seconds between updating screens in an update cycle. This option
overrides the Delay parameter in the config file's [lcdproc] section. When not given and not in
the config file, it defaults to 0.
-h Show help screen.
-v Print the version of lcdproc and exit.
screen can be one of the following:
CCPU show detailed CPU usage
PSMP-CPU CPU usage overview: one line per CPU, especially useful on SMP systems.
GCPUGraph CPU histogram
LLoad Load histogram
MMemory memory & swap usage
SProcSize memory usage of 5 biggest processes
DDisk filling level of the mounted file systems
IIface network interface usage
BBattery battery status
TTimeDate time & date information
OOldTime old time screen
UUptime uptime screen
KBigClock big clock
NMiniClock minimal clock
AAbout credits page
On the command line you may either use the short or the long screen name. In the config file, the
long names are used as section labels to configure the screens further.
You may also prefix the screen names with an exclamation mark '!' to disable a screen that was
activated in the config file instead of activating a disabled one.
See Also
LCDd(8), lcdproc-config(5)
Synopsis
lcdproc [-hfv] [-cconfig] [-shost] [-pport] [-edelay] [screen ...]
