Provided by: lcdproc_0.5.5-2_i386 bug

NAME

       lcdproc - system status information client

SYNOPSIS

       lcdproc [-hfv] [-c config] [-s host] [-p port] [-e delay] [screen ...]

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.

OPTIONS

       lcdproc understands these command line options:

       -c config
              Use a configuration file other than /etc/LCDd.conf

       -s host
              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.

       -p port
              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.

       -e delay
              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:

              C CPU           show detailed CPU usage

              P SMP-CPU       CPU usage overview: one line per CPU, especially
                              useful on SMP systems.

              G CPUGraph      CPU histogram

              L Load          Load histogram

              M Memory        memory & swap usage

              S ProcSize      memory usage of 5 biggest processes

              D Disk          filling level of the 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

              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.

EXAMPLES

              lcdproc C M D '!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

SEE ALSO

       LCDd(8), lcdproc-config(5)

AUTHOR

       Many people have contributed to LCDproc.  See the CREDITS file for more
       details.

       All questions should be sent to the lcdproc mailing list.  The  mailing
       list, and the newest version of LCDproc, should be available from here:

                 http://www.lcdproc.org/

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.