lcdvc(1) [debian man page]

lcdvc(1)							   LCDproc suite							  lcdvc(1)

NAME

       lcdvc - LCDproc virtual console

SYNOPSIS

       lcdvc [-fh] [-a addr] [-c file] [-p port] [-r level] [-s bool]

DESCRIPTION

       This  program  shows content from a system console on a LCD controlled by LCDd. As the console is usually larger than a LCD, the area shown
       on the LCD screen can be scrolled using keys attached to the display.

       Additionally it has an autoscroll feature, which is on by default and can only be disabled by using lcdvc's menu.

       By default it uses /dev/vcs and /dev/vcsa devices as the console to show. Other console devices	can  be  set  in  the  configuration  file
       /etc/lcdvc.conf. The keys used for scrolling can be set in the config file as well.

OPTIONS

       The following options can be set in the configuration file /etc/lcdvc.conf as well, but those given on the command line take precedence:

       -a addr
	      DNS name or IP address of the LCDd server (default localhost).

       -c file
	      Specify configuration file.

       -f     Run in foreground.

       -h     Output help and exit.

       -p port
	      Port of the LCDd server (default 13666).

       -r level
	      Set reporting level (0-5, default: 2)

       -s bool
	      Report to syslog (1) or stderr (0, default).

FILES

       /etc/lcdvc.conf
       /dev/vcs
       /dev/vcsa

AUTHORS

       lcdvc was originally written by Joris Robijn, modified by Peter Marschall.

       This man page was written by Markus Dolze.

SEE ALSO

       LCDd(8) vcs(4)

LICENSE

       lcdvc is released under the GNU General Public License, version 2.

LCDproc 							   12 June 2009 							  lcdvc(1)

lcdproc-config(5)						   LCDproc suite						 lcdproc-config(5)

NAME

       lcdproc-config - format of LCDproc's configuration files

SYNTAX

       The syntax for LCDproc's configuration files is INI-file style.

       They  are  8-bit text files divided into sections, each containing zero or more key-value pairs.  Sections are introduced by section labels
       which start with '[' and end with ']', and key-value pairs consist of a key name, a '=' sign and a value each.

       Key names are sequences of non-space characters, not starting with '[' and not containing '=' or '
', while values are shell like strings.
       I.e. they are either simple sequences of non-space characters, or double quoted-strings with C-style syntax (except the missing support for
       'NNN' and 'xNN' escape sequences) or or a mix of both of these forms.

       Section labels and key names are case-insensitive and may occur more than once.	Keys of duplicate sections will be merged  into  one  sec-
       tion,  while the values of duplicate keys in a section will be appended to form an array of values for this key.  (In the program, all val-
       ues of a key can be retrieved individually)

       Spaces around section labels, keys, and values are ignored.  Lines starting with ';' or '#' are considered comments and ignored too.

       While all of the above is quite common to almost all INI-file implementations, there are a few special features that make LCDproc's  config
       files special:

       *      Section  labels may contain any character except ']', '
' or ''.  However, all characters are interpreted literally (i.e. neither
	      quoting, nor escaping done).

       *      Key names may contain any non-space character except '
' or ''.  However, all characters are interpreted literally (i.e.  neither
	      quoting, nor escaping done).

       *      Comments are allowed after section labels and key value pairs

       *      Values  may  be  a mix of quoted and unquoted strings similar as strings are interpreted in the shell.  E.g. the value 'string" with
	      "blanks"	!"' will be parsed as 'string with blanks<TAB>!'  where <TAB> stands for the TAB character.

       In case of a a parsing error the rest of the line is ignored and parsing continues with the next line.

EXAMPLE

       Here is fully working example of an LCDd.conf (formatted somewhat strange to show the features):
       # the server section
       [server]
       Bind=127.0.0.1
       Port=13666
       User="nobody"
       #Foreground=no
       #ReportLevel=3
       #ReportToSyslog=yes
       Driver="my Curses Driver"
       DriverPath=/usr/lib/lcdproc/
       WaitTime= "5"
       ServerScreen=no

       # assign keys to special functions #
       ToggleRotateKey = Enter
       PrevScreenKey = Left
       NextScreenKey = Right
       # ScrollUpKey = Up
	#ScrollDownKey=Down

       #  menu section: define keys to use in the server menu #
	     [menu]
       MenuKey = Escape    # ESC switches to server menu
       EnterKey =Enter
       UpKey= Up
       DownKey="Down"
	LeftKey= "Left"
	RightKey = "Right"

       # configuration of the curses driver #
       [my curses Driver]  # yes I use the curse driver
       File= "curses.so"
       Size="20"x"4"	   # LCD screen dimensions
       TopLeftX=7	   # screen position: X coordinate
       TopLeftY=7	   # screen position: Y coordinate
       Foreground=blue		# foreground color
       Background=cyan		# background color when backight is off
       Backlight=red	   # background color when backight is on

FILES

       These are the default config files for the various parts of the LCDproc suite:

       /etc/LCDd.conf
	      configuration of the LCDd server daemon

       /etc/lcdproc.conf
	      configuration of the lcdproc system monitoring client

       /etc/lcdexec.conf
	      configuration of the lcdexec the program starter client

       /etc/lcdvc.conf
	      configuration of the lcdvc virtual console client

SEE ALSO

       LCDd(8), lcdproc(1), lcdexec(1)

AUTHOR

       This manual page has been written by Peter Marschall <peter@adpm.de>

LCDproc 							 18 September 2006						 lcdproc-config(5)