aboutsummaryrefslogtreecommitdiffstats
ModeNameSize
-rw-r--r--.cvsignore5logstatsplain
-rw-r--r--AUTHORS714logstatsplain
-rw-r--r--COPYING17992logstatsplain
-rw-r--r--CREDITS77logstatsplain
-rw-r--r--ChangeLog74916logstatsplain
-rw-r--r--FAQ310logstatsplain
-rw-r--r--INSTALL7831logstatsplain
-rw-r--r--Makefile.am3184logstatsplain
-rw-r--r--Makefile.in15662logstatsplain
-rw-r--r--NEWS1877logstatsplain
-rw-r--r--README161logstatsplain
-rw-r--r--README.Drivers1992logstatsplain
-rw-r--r--README.KDE1431logstatsplain
-rw-r--r--README.Plugins1021logstatsplain
-rw-r--r--Status2887logstatsplain
-rw-r--r--TODO6422logpre { line-height: 125%; } td.linenos .normal { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } span.linenos { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } .highlight .hll { background-color: #ffffcc } .highlight .c { color: #888888 } /* Comment */ .highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */ .highlight .k { color: #008800; font-weight: bold } /* Keyword */ .highlight .ch { color: #888888 } /* Comment.Hashbang */ .highlight .cm { color: #888888 } /* Comment.Multiline */ .highlight .cp { color: #cc0000; font-weight: bold } /* Comment.Preproc */ .highlight .cpf { color: #888888 } /* Comment.PreprocFile */ .highlight .c1 { color: #888888 } /* Comment.Single */ .highlight .cs { color: #cc0000; font-weight: bold; background-color: #fff0f0 } /* Comment.Special */ .highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */ .highlight .ge { font-style: italic } /* Generic.Emph */ .highlight .gr { color: #aa0000 } /* Generic.Error */ .highlight .gh { color: #333333 } /* Generic.Heading */ .highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */ .highlight .go { color: #888888 } /* Generic.Output */ .highlight .gp { color: #555555 } /* Generic.Prompt */ .highlight .gs { font-weight: bold } /* Generic.Strong */ .highlight .gu { color: #666666 } /* Generic.Subheading */ .highlight .gt { color: #aa0000 } /* Generic.Traceback */ .highlight .kc { color: #008800; font-weight: bold } /* Keyword.Constant */ .highlight .kd { color: #008800; font-weight: bold } /* Keyword.Declaration */ .highlight .kn { color: #008800; font-weight: bold } /* Keyword.Namespace */ .highlight .kp { color: #008800 } /* Keyword.Pseudo */ .highlight .kr { color: #008800; font-weight: bold } /* Keyword.Reserved */ .highlight .kt { color: #888888; font-weight: bold } /* Keyword.Type */ .highlight .m { color: #0000DD; font-weight: bold } /* Literal.Number */ .highlight .s { color: #dd2200; background-color: #fff0f0 } /* Literal.String */ .highlight .na { color: #336699 } /* Name.Attribute */ .highlight .nb { color: #003388 } /* Name.Builtin */ .highlight .nc { color: #bb0066; font-weight: bold } /* Name.Class */ .highlight .no { color: #003366; font-weight: bold } /* Name.Constant */ .highlight .nd { color: #555555 } /* Name.Decorator */ .highlight .ne { color: #bb0066; font-weight: bold } /* Name.Exception */ .highlight .nf { color: #0066bb; font-weight: bold } /* Name.Function */ .highlight .nl { color: #336699; font-style: italic } /* Name.Label */ .highlight .nn { color: #bb0066; font-weight: bold } /* Name.Namespace */ .highlight .py { color: #336699; font-weight: bold } /* Name.Property */ .highlight .nt { color: #bb0066; font-weight: bold } /* Name.Tag */ .highlight .nv { color: #336699 } /* Name.Variable */ .highlight .ow { color: #008800 } /* Operator.Word */ .highlight .w { color: #bbbbbb } /* Text.Whitespace */ .highlight .mb { color: #0000DD; font-weight: bold } /* Literal.Number.Bin */ .highlight .mf { color: #0000DD; font-weight: bold } /* Literal.Number.Float */ .highlight .mh { color: #0000DD; font-weight: bold } /* Literal.Number.Hex */ .highlight .mi { color: #0000DD; font-weight: bold } /* Literal.Number.Integer */ .highlight .mo { color: #0000DD; font-weight: bold } /* Literal.Number.Oct */ .highlight .sa { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Affix */ .highlight .sb { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Backtick */ .highlight .sc { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Char */ .highlight .dl { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Delimiter */ .highlight .sd { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Doc */ .highlight .s2 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Double */ .highlight .se { color: #0044dd; background-color: #fff0f0 } /* Literal.String.Escape */ .highlight .sh { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Heredoc */ .highlight .si { color: #3333bb; background-color: #fff0f0 } /* Literal.String.Interpol */ .highlight .sx { color: #22bb22; background-color: #f0fff0 } /* Literal.String.Other */ .highlight .sr { color: #008800; background-color: #fff0ff } /* Literal.String.Regex */ .highlight .s1 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Single */ .highlight .ss { color: #aa6600; background-color: #fff0f0 } /* Literal.String.Symbol */ .highlight .bp { color: #003388 } /* Name.Builtin.Pseudo */ .highlight .fm { color: #0066bb; font-weight: bold } /* Name.Function.Magic */ .highlight .vc { color: #336699 } /* Name.Variable.Class */ .highlight .vg { color: #dd7700 } /* Name.Variable.Global */ .highlight .vi { color: #3333bb } /* Name.Variable.Instance */ .highlight .vm { color: #336699 } /* Name.Variable.Magic */ .highlight .il { color: #0000DD; font-weight: bold } /* Literal.Number.Integer.Long */
#
# $Id: README,v 1.15 2001/03/09 13:08:11 ltoetsch Exp $
#

This is the README file for lcd4linux


INTRODUCTION 

lcd4linux is a small program that reads various information from the kernel
(and probably from other subsystems, especially ISDN) and displays them on a
LCD.

It supports displaying text values and different types of bars: Horizontal and
vertical bars, logarithmic bars, split bars (two independent bars in one row).


USAGE

lcd4linux -h  
  print version number and a small help text, then exit

lcd4linux -l 
  list available drivers

lcd4linux -d
  calibrate delay loop (necessary for some drivers)

lcd4linux [-c key=val] [-F] [-f config-file] [-o output] [-q] [-v]
  run lcd4linux 
  overwrite entries from the config-file with '-c'
  do not fork and detach with '-F'
  use configuration from 'config-file' instead of /etc/lcd4linux.conf
  write picture to 'output' (raster driver only)
  suppress startup splash screen with '-q'
  generate info messages with '-v'
  generate debugging messages with '-vv'
  
DIAGNOSTICS

  lcd4linux on foreground writes (depending on level) to stdout or stderr.
  The Text-Driver has ist's own diagnostics window.
  
  Started in the background (the default), lcd4linux uses your syslog daemon
  for logging. Facility is USER, levels are ERR, INFO and DEBUG.


SUPPORTED DISPLAYS

* Matrox Orbital: <http://www.matrixorbital.com>
	
  "LCD0821": 2 lines by  8 characters
  "LCD1621": 2 lines by 16 characters
  "LCD2021": 2 lines by 20 characters
  "LCD2041": 4 lines by 20 characters (tested)
  "LCD4021": 2 lines by 40 characters


* CrystalFontz <http://www.crystalfontz.com>

  any of 626, 632, 634 and 636.


* HD44780-based displays

  This driver supports display modules based on the Hitachi HD44780 chip,
  connected to a parallel port. These displays are made by different 
  manufactures, and come in various sizes.


* PalmOrb

  I was told that lcd4linux works fine with PalmOrb, a small program that 
  emulates a Matrox Orbital display on the Palm Pilot.


* X11
  thanks to Herbert Rosmanith <herp@wildsau.idv.uni-linz.ac.at> a driver
  for the X Window System is available. It supports any size at any
  resolution. A very small XLCD4Linux-Window can even swallow on the KDE
  Panel!


* Raster formats:
  a generic raster driver (which is used by the X11-driver, too) is availiable,
  it supports:
     PPM (portable pixmap)
     PNG (with libgd)

* Text:
  This is a ncurses based text driver, mainly intended for debugging.

* other displays: lcd4linux and especially the display driver code is very
  modular, so it should be quite easy to write a driver for any display. See
  README.driver for details. Contributors are welcome!!!


CONFIGURATION

The configuration file (default: /etc/lcd4linux.conf) has a very simple
format: Every line consists of a key and a value, seperated by whitespace
(blanks or tabs). Values can contain whitespace, and can be enclosed in
single or double quotes. A key must not contain whitespace. Keys are NOT
case-sensitive. Order doesn't matter. Empty lines and all text on a line
after a '#' will be ignored. If you want to use '#' in a value (think of
X11-colors), you have to quote it with a backslash.

NOTE:

Because of security reasons the config file is assured to be:
   * - file is a normal file (or /dev/null)
   * - file owner is owner of program
   * - file is not accessible by group
   * - file is not accessible by other
   
So if you run lcd4linux as root, /etc/lcd4linux has to be:
  chmod 600
  chown root.root


The configuration file contains information for different modules of
lcd4linux:

Global options:

  tick: time in milliseconds between bar updates
  tack: time in milliseconds between text updates (text can be updated less 
        often than bars, so you get a smooth bar display and readable text)
  tau:  time constant (in milliseconds) for damping function (not used by now)

Data-specific options:

  overload: load average threshold and bar scaling. The '%L' token (see below)
            displays a '!' instead of a blank if the current load average 
	    exceeds this value. 
            load bars are scaled by this value (load=overload gives 100%)
  fifo: path to fifo for communication with isdnlog (not yet implemented)
  sensor1: path to the 1st temperature file 
           (e.g. /proc/sys/dev/sensors/w83781d-isa-0290/temp1)
           it is important that you use the isa sensors, because the i2c 
	   sensors are very slow!
  sensor1_min: temperature where the corresponding bar starts
  sensor1_max: temperature where bar ends
  sensor[2..9], -_min, -_max: entries for the 2nd to 9th temperature sensor
  
  exec:
     x1 ... x9: command to execute, PATH=/usr/local/bin:/usr/bin:/bin
                $X1 ... $X8 is result of command 1..8 in environment
     Tick_x1 .. 9 delay in ticks (overrides delay_x)
     Delay_x1 ..9 delay in seconds (default 1)
     Scale_x1 ..9 scale for bars (default 100)
     
  battery: Battwarning 10 (default 10)
   
 
Driver-specific options:
  
  Display: the name of a display model (see "supported displays" above)
  every driver has its own configuration options (e.g. 'Port', 'Speed', ...)
  see README.<Drivername> for details!
  
  
Display options:
  
  row1: Text to display in row 1
  row[2-max]: Text to display in other rows

  The text to be displayed can contain specific directives, which will be
  replaced by the appropriate values, or will create bars:

  '\nnn` will write the ASCII-character nnn (octal)
  '%<token>' will be replaced by the value of <token>
  '%%' will write a '%'
  '%$' will write a '$'

  '$<direction><length><token>[+<token>] will create a bar with the
  specified direction and length (in characters) with the value of <token>.
  If the driver supports dual bars, you can specify the second value with
  '+<token>'. <direction> can be 'l' (left), 'r' (right), 'u' (up) or 'd'
  (down). If you specify the direction in upper case, a logarithmic bar will
  be created. note that the space occupied by a bar always grows from left
  to right or from top to bottom, regardless of the direction!

Tokens:

  'o',  operating system name ('Linux')
  'v',  operating system release ('2.0.38')
  'p',  processor ('i686')
  'r',  total amount of memory installed (MB)
  'mt', total memory from /proc/meminfo (kB)
  'mu', used memory (kB)  
  'mf', free memory (kB)
  'ms', shared memory (kB)
  'mb', buffers (kB)
  'mc', page cache (kB)  
  'ma', application memory (kB) = used - buffer - cache
  'l1', load average for the past 1 minute
  'l2', load average for the past 5 minutes
  'l3', load average for the past 15 minutes
  'L',  '!' if load > overload (from config)   
  'cu', percentage of CPU in user mode
  'cn', percentage of CPU in niced tasks
  'cs', percentage of CPU in system mode
  'cb', percentage of CPU busy (=100-idle)
  'ci', percentage of CPU idle
  'dr', disk blocks read
  'dw', disk blocks written
  'dt', disk blocks total (read+write)
  'dm', disk blocks max (read, write)
  'nr', network bytes received
  'nw', network bytes transmitted
  'nt', network bytes total (receive+transmit)
  'nm', network bytes max (receive, transmit)
  'ii', ISDN bytes received
  'io', ISDN bytes sent
  'it', ISDN bytes total (received+send)
  'im', ISDN bytes max (received, send)
  'ic', ISDN connected (0=offline, 1=online)
  'ti', PPP bytes received
  'to', PPP bytes sent
  'tt', PPP bytes total (received+send)
  'tm', PPP bytes max (received, send)
  's1', temperature of sensor 1
  's2', temperature of sensor 2 (up to s9)
  'bp', battery percentage (APM by now)
  'bs', battery status ('=' = online, '+' = charging, '-' discharging)
  'bd', battery duration in s{econds}, m{ins}, h{ours} or d{ays}
  'e*', mails in mailbox 1-9,
  'x*', output of command 1-9
  
Please have a look at lcd4linux.conf.sample, where you can find examples
of all options.
ordInstruments.c?id=3f9f909fa330cb2ff47b56c43d2a4c5e1dc0a8c0'>plain -rw-r--r--drv_NULL.c4778logstatsplain -rw-r--r--drv_T6963.c14239logstatsplain -rw-r--r--drv_USBLCD.c10770logstatsplain -rw-r--r--drv_X11.c10567logstatsplain -rw-r--r--drv_generic_graphic.c10016logstatsplain -rw-r--r--drv_generic_graphic.h2512logstatsplain -rw-r--r--drv_generic_parport.c10907logstatsplain -rw-r--r--drv_generic_parport.h3521logstatsplain -rw-r--r--drv_generic_serial.c10683logstatsplain -rw-r--r--drv_generic_serial.h2526logstatsplain -rw-r--r--drv_generic_text.c21816logstatsplain -rw-r--r--drv_generic_text.h3882logstatsplain -rw-r--r--evaluator.c28348logstatsplain -rw-r--r--evaluator.h3098logstatsplain -rw-r--r--font_6x8.h12029logstatsplain -rw-r--r--hash.c14796logstatsplain -rw-r--r--hash.h4295logstatsplain -rwxr-xr-xinstall-sh5599logstatsplain -rw-r--r--layout.c4051logstatsplain -rw-r--r--layout.h1436logstatsplain -rw-r--r--lcd4kde.conf224logstatsplain -rw-r--r--lcd4linux.c17146logstatsplain -rw-r--r--lcd4linux.conf.sample12170logstatsplain -rw-r--r--lcd4linux.kdelnk285logstatsplain -rw-r--r--lcd4linux.lsm533logstatsplain -rw-r--r--lcd4linux.xpm1441logstatsplain -rwxr-xr-xlibtool202940logstatsplain -rw-r--r--ltmain.sh183816logstatsplain -rwxr-xr-xmissing6480logstatsplain -rwxr-xr-xmkinstalldirs725logstatsplain -rwxr-xr-xnph-png987logstatsplain -rw-r--r--pid.c4287logstatsplain -rw-r--r--pid.h1166logstatsplain -rw-r--r--plugin.c9374logstatsplain -rw-r--r--plugin.h1653logstatsplain -rw-r--r--plugin_apm.c4884logstatsplain -rw-r--r--plugin_cfg.c4575logstatsplain -rw-r--r--plugin_cpuinfo.c4441logstatsplain -rw-r--r--plugin_diskstats.c3784logstatsplain -rw-r--r--plugin_dvb.c4149logstatsplain -rw-r--r--plugin_exec.c6595logstatsplain -rw-r--r--plugin_i2c_sensors.c11570logstatsplain -rwxr-xr-xplugin_imon.c11553logstatsplain -rw-r--r--plugin_isdn.c5657logstatsplain -rw-r--r--plugin_loadavg.c4159logstatsplain -rw-r--r--plugin_math.c3648logstatsplain -rw-r--r--plugin_meminfo.c4205logstatsplain -rw-r--r--plugin_mysql.c5311logstatsplain -rw-r--r--plugin_netdev.c5317logstatsplain -rw-r--r--plugin_pop3.c9018logstatsplain -rw-r--r--plugin_ppp.c3781logstatsplain -rw-r--r--plugin_proc_stat.c9991logstatsplain -rw-r--r--plugin_sample.c5808logstatsplain -rw-r--r--plugin_seti.c3872logstatsplain -rw-r--r--plugin_string.c2020logstatsplain -rw-r--r--plugin_test.c2976logstatsplain -rw-r--r--plugin_time.c1787logstatsplain -rw-r--r--plugin_uname.c2768logstatsplain -rw-r--r--plugin_uptime.c4599logstatsplain -rwxr-xr-xplugin_wireless.c16051logstatsplain -rw-r--r--plugin_xmms.c4522logstatsplain -rw-r--r--plugins.m46364logstatsplain -rw-r--r--png.html113logstatsplain -rw-r--r--qprintf.c4406logstatsplain -rw-r--r--qprintf.h1475logstatsplain -rw-r--r--thread.c4419logstatsplain -rw-r--r--thread.h1962logstatsplain -rw-r--r--timer.c5028logstatsplain -rw-r--r--timer.h1739logstatsplain -rw-r--r--udelay.c7200logstatsplain -rw-r--r--udelay.h2177logstatsplain -rw-r--r--widget.c5735logstatsplain -rw-r--r--widget.h2834logstatsplain -rw-r--r--widget_bar.c6479logstatsplain -rw-r--r--widget_bar.h2664logstatsplain -rw-r--r--widget_icon.c6371logstatsplain -rw-r--r--widget_icon.h2476logstatsplain -rw-r--r--widget_text.c11659logstatsplain -rw-r--r--widget_text.h2825logstatsplain