
                           LMW.SH OPTIONS

List of lmw.sh options:
=======================

REV

BUILDIR=
MOUNTP

BLOCKSIZE

FIREWALL
THTTPD
GPM
LDD
REBOOT
SULOGIN
STRACE

INSTALL_X
LWM
GTK
DILLO
HELIWM
XCRUISE
BROWSEX_SUP
XENON
XFILEMAN
VGA16
FBDEV
XVNC

---------------------
Detailed explanation:
---------------------

REV
---
A bash string variable for internal housekeeping. Update in lmw.sh, line# 4.
Changes reflected in backup script file names. Cheap and dirty RCS. Default
setting to current release REV.

BUILDIR="target"
----------------
BUILDIR holds the name of the directory which is created and contains the LMW 
tree under construction. Previous instance is deleted. Default "target".

MOUNTP="embfiles"
-----------------
MOUNTP holds the name of the mount point directory for the initrd image, 
"newfs". The final tarred and gzipped initrd image, ready for booting,
is named "newfs.gz". Copy/install on the medium of choice.

First the LMW tree is created and stocked in the BUILDIR directory. File
copying, creation, stripping and soft links are performed here. After 
successfully building the tree, it is then copied into the initrd image
which is loop mounted on MOUNTP directory. This minimizes file 
fragmentation for maximal tgz compression.

BLOCKSIZE
---------
Specifies the number of 1024 byte blocks to initialize in the initrd image
'newfs'. E.G. 8192 creates an image of 8192 x 1024 bytes for a total size
of 8Meg. Rescue disk size=4096, Xvnc size=12288, GTK/dillo=13312. 
Default is 12288.

!!!!Be sure to rebuild your kernel to a matching RAMDISK size!!!!

The following is an example from conf243nm, the example '.config'.

CONFIG_BLK_DEV_RAM=y
CONFIG_BLK_DEV_RAM_SIZE=12288
CONFIG_BLK_DEV_INITRD=y

======================
Option enable/disable:
======================

The following variables specify which options are installed into the
final initrd image. Place a bash comment character, '#', in front of
an undesired option to disable, remove to enable. 

=================================
Minimal kernel/Text mode options:

FIREWALL="1"
-------------
When enabled, turns on the x bit for etc/rc.d/rc.start/rc.00.firewall.
Default disabled

THTTPD="1"
-----------
When enabled, turns on the x bit for etc/rc.d/rc.start/rc.20.httpd and
copies the thttpd binary into usr/sbin.
Default disabled.

GPM="1"
-------
Enable GPM console mouse. Creates rc.gpm. Customize for mouse type, port
and usage. See code for specific options.
Default enabled.

LDD="1"
--------
When enabled, copies the ldd binary to usr/bin.
Default disabled.

REBOOT="1"
----------
When enabled, replaces busybox 'halt' and 'reboot' with standalone versions.
Added due to bugs in busybox with kernel 2.4.3 rebooting.
Default enabled.

SULOGIN="1"
------------
When enabled, appends an explicit 'sulogin' to the end of rc.sysinit and 
copies the standalone sulogin binary to sbin. Useful for debugging tinylogin
passwd configuration.
Default disabled.

STRACE="1"
-----------
When enabled, copies the strace binary to usr/bin and support libs to lib.
Default disabled.


==========
X OPTIONS:
==========

INSTALL_X="1"
-------------
When enabled, X install options are enabled.
Default enabled.

LWM="1"
-------
Install lwm, 'light-weight window manager'.
Default enabled.

GTK="1"
--------
Install resident GTk+ dynamic lib support. Does _not_ copy static libs.
Default disabled.

DILLO="1"
----------
Install the open source 'dillo' web browser (220k). Requires option GTK enabled.
Default disabled.

HELIWM="1"
-----------
Install keyboard driven 'Helix window manager'.
Default disabled

XCRUISE="1"
-----------
Install eye candy xcruise file directory viewer. Read the doc, see the galaxy.
Default enabled.

BROWSEX_SUP="1"
----------------
Install libgdbm to support tcl/tk BrowseX web browser. BrowseX is a compressed
binary that conflicts with the initrd compression (compressed files larger than
1k do _not_ survive initrd decompression). The compressed BrowseX must be loaded 
from a non-compressed storage medium or uncompressed prior to newfs.gz creation.
Default disabled.

XENON="1"
---------
Install xenon X text editor.
Default enabled.

XFILEMAN="1"
------------
Install xfilemanager.
Default enabled.

VGA16="1"
----------
Install XF86_VGA16 X server and supporting XF86Config.
Default disabled.

FBDEV="1"
----------
Install XF86_FBDev X server and supporting XF86Config.
Default disabled.

XVNC="1"
--------
Install Xvnc remote X virtual network console server and support.
Default enabled.

=================
Multiple Options:

Loading both VGA16 and FBDEV options will leave the default X set to 
FBDEV. The last option in the sequence takes precedence.

It is possible to install both an explicit X server _and_ Xvnc. But
since LMW is targeted at a low memory application, no effort has been
made to resolve any potential conflicts.


