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.