1. Introduction
---------------
Since 1.1.9, splashutils can be run in two different operating modes. The
first one is the standard 'call-do_stuff-exit' way known from all previous
versions of splashutils. The second one is the so-called splash daemon mode.

Using the first mode to manage the silent splash screen is inefficient
and should be considered deprecated.


2. Starting the splash daemon
-----------------------------
The splash daemon can be started with:
  # splash_util -d -t <theme>

Upon startup, the daemon will parse the config file, open a communications
FIFO (SPLASH_FIFO, default: /usr/lib/splash/cache/.splash) and go into background,
detaching from the current console. It will also start a thread that
will monitor the silent tty for keypresses. This thread will then switch
the screen to verbose mode if a F2 keypress is detected. If an event device
(more info below) is monitored for keypresses, it will be possible to use
F2 to switch back and forth between the silent and verbose modes.


3. Communicating with the splash daemon
---------------------------------------
All communications with the splash daemon are performed via the splash
FIFO. Currently, the following commands are recognized:

 - set theme <theme>
   Sets the current theme to <theme>. This can also be used to force the
   splash daemon to re-read the config file for the currently used theme.

 - set mode <silent|verbose>
   Sets the splash mode to either verbose or silent. A tty switch is
   performed and, if necessary, the screen is redrawn.

 - set tty <silent|verbose> <tty>
   Sets the silent or verbose tty to <tty>. <tty> is a number in the range
   1 - MAX_NR_CONSOLES.

 - set effects [fadein fadeout]
   Set the special effects that the splash daemon will use.  If used without
   any optional parameters, this command will disable the use of all special
   effects.

 - set event dev <evdev>
   Sets the event device to <evdev> (such as /dev/input/event0). If the
   kernel was configured with CONFIG_INPUT_EVDEV='y' or if the evdev.ko
   module is loaded, the splash daemon will use the event interface to
   detect F2 keypresses, allowing switching back and forth between silent
   and verbose modes.

 - set message <text>
   Sets the main system message to <text>. This command only does anything
   when splashutils was built with CONFIG_TTF defined.

 - set gpm
   Makes the splash daemon a GPM client for the silent tty. This provides
   a good way to prevent the mouse cursor from messing the silent splash.

 - paint rect <x0> <y0> <x1> <y1>
   Paints the specified part of the background buffer on the screen.

 - paint
   Updates the image on screen. Equivalent to 'splash_util -c paint ...'

 - repaint
   Repaints the whole screen.

 - progress <num>
   Sets the progress to <num>, where <num> has to be in the range 0 - 65535.

 - update_svc <service> <state>
   Updates the service <service> state to <state>. <state> can be one
   of the following:
      svc_inactive_start
      svc_inactive_stop
      svc_start
      svc_stop
      svc_started
      svc_stopped
      svc_start_failed
      svc_stop_failed

 - log <text>
   Add a line of text to the fbsplash message log. If 'text' is longer than
   log_cols, it is automatically truncated.

 - exit [staysilent]
   Causes the splash daemon to exit.

   If the 'staysilent' option is provided, the daemon won't try to
   automatically switch the screen to the verbose tty.


4. Exporting the background buffer to a file (EXPERIMENTAL)
-----------------------------------------------------------

The splash daemon provides an option (-e) to export its background buffer
to a file (by mmaping it). When the background buffer is exported to a file,
the 'set notify' command can be used to run programs whenever the screen is
being (re)painted. These programs can draw additional objects in the
background buffer, thus providing support for features not present in the
core splash daemon (such as support for some exotic file formats).

Special care has to be taken not to truncate the file with the background
buffer. Failure to keep the size unchagned might result in unexpected
behaviour of the splash daemon.

-- 
Written by Michal Januszewski <spock@gentoo.org>.

