Man Linux: Main Page and Category List


       lcdproc - system status information client


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


       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  overriden  using  command  line

       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.


       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

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


              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


       *      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).


       /etc/lcdproc.conf, lcdproc’s default configuration file


       LCDd(8), lcdproc-config(5)


       LCDproc was originally written by William Ferrell  (
       andr Scott Scriven (

       Since that time various people have contributed to LCDproc.

       The newest version of LCDproc should be available from here:



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