fbgetty Copyright (C) 1999 Yann DRONEAUD (lch@multimania.com). 


Description
-----------

fbgetty a new getty program who support fully possibility of the 
Linux console. For the moment it run only under Linux.

Features
--------
  extended issue display (escape codes, shell variables)
  framebuffer support (display logo)
  refresh issue when VT is activated (time, user, uptime)
  display date/time according to locale
  display the output of any program

Usage 
-----

fbgetty [options] [variables] tty device framebuffer device

Options:

  -t --tty               set tty device 
  -f --fb --framebuffer  set framebuffer device
  -i --issue             set issue file
  -l --login-program     set login program
  -p --login-prompt      set login prompt
  -o --login-timeout     set login timeout
     --version           show version
     --help              show help


Options
-------

  --issue=none             disable display of issue file
  --login-prompt=none      disable display of login prompt

Environment
-----------
  fbgetty recognizes these environemnt variables
  simply put them on the command line

  LANG=[locale]
  issue=
  framebuffer=
  tty=
  login_program=
  login_prompt=
  login_timeout=
  refresh=
  clear_screen=

Difference between arguments, options and variables
---------------------------------------------------
 priority:
    options
    variables
    arguments

 if you put "fbgetty /dev/ttyXX fbX -t ttyYY framebuffer=fbY"
  fbgetty will use ttyYY and framebuffer fbY
    


 
Issue tag
---------

@system        %s display OS name (will certainly be Linux)

@version
@release       %r display OS release

@architecture
@arch          %m display host architecture

@tty
@line
@vt            %l display tty

@framebuffer
@fb            %f display framebuffer

@hostname      %n display hostname

@domain        %o display domain

@FQDN             *

@user          %u display number of users connected
@Users         %U display number of users with format  %d user(s)

@loadavg          display load average *

@date          %d display date  

@time          %t display time (24H)

@uptime           *

@include          *

@image            * not yet supported


$...              display env variable ($TERM will echoing linux or linux-m) *

&...              run the specified program

\a                echo alert (bell)
\b                backspace
\e
\E                echo escape char
\f                echo formfeed
\n                echo new line
\r                echo carriage return
\t                echo horizontal tab
\v                echo vertical tab
\@                echo arobas
\%                echo percent char
\&                echo ampersand
\$                echo dollar sign
\ooo              echo character octal *
\xhh
\Xhh              echo hex character *

All the short escape (\? or %u) work in login prompt

Issue files
-----------
If not overrided by --issue-file, fbgetty will look for /etc/issue
If LANG is set, it will first look for issue-file.[LANG]
If not, it will print the default

Installation
------------

$ ./configure.default
$ make
$ su
# make install

examples and scripts are installed in the $datadir/fbgetty
by default /usr/share/fbgetty

Edit inittab
replace your old getty by fbgetty
see examples/*.*


More Information
----------------

see info pages
see man pages
see http://www.multimania.com/lch/fbgetty
