Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
lcdproc(1)			 LCDproc suite			    lcdproc(1)

       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
       /usr/local/etc/lcdproc.conf,  some of them can be overridden using com-
       mand 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 config-
       ured 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 /usr/local/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	 [lcd-
	      proc] 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 back-

       -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  con-
       figuration 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).

       /usr/local/etc/lcdproc.conf, lcdproc's default configuration file

       LCDd(8),	lcdproc-config(5)

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

       All questions should be sent to the lcdproc mailing list.  The  mailing
       list, and 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 particu-
       lar 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.

LCDproc				 24 March 2011			    lcdproc(1)


Want to link to this manual page? Use this URL:

home | help