-c **CLASSES**::
-Specify the CLASSES to be used for building the ISO via fai.
-By default only the class GRML is assumed, resulting in a small base system (being
-about ~170MB ISO size).
+Specify the CLASSES to be used for building the ISO via fai. By default only
+the classes GRML and I386 are assumed, resulting in a small base system (being
+about ~150MB ISO size).
-t **TARGET_DIRECTORY**::
Display short usage information and exit.
- additional_arguments_for_fai::
-
-Any additional argument(s) to grml-live will be given to the FAI commandline
-(being basically "fai dirinstall ...). This might become a temporary solution
-(due to security reasons), if you need an option please let us know so we can
-implement it.
-
How to get your own live-cd - the easy, fast and simple way
-----------------------------------------------------------
-To get a small, Debian-stable and grml based live-cd:
+To get a small, Debian-stable and grml based live-cd using /dev/shm/
+as build and output directory:
- # TARGET="/grml/grml_uncompressed"
- # CDDIR="/grml/grml_cd"
- # grml-live -c GRML -t $TARGET
- # mksquashfs $TARGET/* $CDDIR/live/grml.squashfs -noappend
- # cd $CDDIR
- # mkisofs -V "my personal grml" -l -r -J -no-emul-boot -boot-load-size 4 \
- -boot-info-table -c boot/isolinux/boot.cat \
- -b boot/isolinux/isolinux.bin -o /grml/grml.iso .
+ # grml-live
-(TODO: provide the content of /grml/chroot/grml_cd through the package
-grml-live, in the meanwhile get the content from a current grml-ISO)
+[NOTE]
+
+If you have about 700MB of free space inside /dev/shm (being a tmpfs, usually
+you have >=1GB of RAM) just run "mount -o remount,suid,dev,rw /dev/shm" and use
+/dev/shm as build and output directory - resulting in very fast build process.
+But please be aware of the fact that rebooting your system will result in an
+empty /dev/shm, so please another directory for $CHROOT_TARGET, $BUILD_TARGET
+and $ISO_TARGET if you plan to create more persistent output. :)
The class concept
-----------------
The main and base class provided by grml-live is named GRML. It's strongly
recommended to **always** use the class GRML when building an ISO using
-grml-live. The following files and directories are relevant for class GRML by
-default:
+grml-live as well as the architecture dependend class (being 'I386' for x86_32
+currently only). The following files and directories are relevant for class GRML
+by default:
/etc/grml/fai/config/scripts/GRML/
/etc/grml/fai/config/debconf/GRML
/etc/grml/fai/make-fai-nfsroot.conf
-TODO
+TODO: documentation
/etc/grml/fai/NFSROOT
-TODO
+TODO: documentation
/etc/grml/fai/apt/sources.list
* any Debian based system should be sufficient (if not please send a bug
report), for example a grml2hd harddisk installation ships all you need
-* enough free disk space, at least 1GB are required for a minimal grml-live run
+* enough free disk space; at least 800MB are required for a minimal grml-live
+run (\~400MB for the chroot [$CHROOT_TARGET], \~150MB for the build target
+[$BUILD_TARGET] and \~150MB for the resulting ISO [$ISO_TARGET] plus some
+temporary files)
* fast network access for retreiving the Debian packages used for creating the
chroot (check out "local mirror" and "NFSROOT" to workaround this problem as far
* explain (and provide configuration for) the use of NFSROOT
-* support setting stuff like ISO name, version,...
+* support setting stuff like ISO name, version,... (especially for stuff inside
+x86_files/boot/isolinux)
+
+* identify all packages that are arch specific
* support different flavours and architectures of Debian (currently it defaults
to Debian/stable x86_32)
+* use hooks of FAI in grml-live script?
+
+* the GRML class(es) should send output as used inside FAI as well (so it's not
+as verbose unless you specify it)
+
+* provide possibility for cleanup of all created build directories
+
+* support nocolor-option for /etc/grml/fai/grml/grml_cleanup_chroot
+
+* copy files from $FAI_CONFIGDIR/... instead of using 'cat > $FILE << EOF ...'
+inside the /etc/grml/fai/config/scripts/GRML/-scripts
+
Bugs
----
-------
Michael Prokop <mika@grml.org>.
+/////////////////////////////////////
+// vim:ai tw=80 ft=asciidoc expandtab
+/////////////////////////////////////