bootcdwrite.conf

DESCRIPTION

bootcdwrite.conf is a configuration file used by bootcdwrite. The default path is /etc/bootcdwrite.conf.

This file will be sourced as shell file. The following Options can be used. Examples how to use the Options are shown.

Text files to display at boottime (see syslinux doku) When pressing F1 at boot time the file defined by DISPLAY is shown. F2 will show the file defined by DISPLAY2 and F3 will show the file defined by DISPLAY3 F10 lists all people mentioned in changelog.

The text file kernelinfo is replaced with a file which includes kernelinfo.

Default:

DISPLAY="/usr/share/bootcd/default.txt"
DISPLAY2="kernelinfo"

TYP

TYP can be defined as CD or DVD to get a warning if the size of the image will be larger as the specified medium.

Default:

TYP=DVD

CDDEV

Specifies one or more CD devices to boot from. The first one is the default. auto tries to find the bootcd on all SCSI and IDE CDROMS

Default:

CDDEV="auto /dev/hda /dev/hdb /dev/hdc /dev/hdd /dev/sr0 /dev/sr1"

DO_CHECK

Enables some checks or not. To check for possible problems can take a long time, but it is recommended to do the checks.

Default:

DO_CHECK=yes

NOT_TO_CD

Add directories which should be excluded from bootcd. Directories are separated by spaces. SRCDISK will be automatically added to each path that does not start with "/".

Default:

NOT_TO_CD=""

SSHHOSTKEY

If using ssh it is helpful to have a unique ssh hostkey for each CD. To be generated at burntime:: Default:

SSHHOSTKEY=yes

UDEV_FIXNET

If the network interfaces are hardwired in /etc/udev/rules.d/xx_persistent-net.rules they can removed on bootcd, with: Default:

UDEV_FIXNET="yes"

VAR

This defines the directoy where the image resists after build. Default:

VAR=/var/spool/bootcd

FLOPPY_RUNTIME_DEV

When you booting from cd changes will be read from this device. Without a floppy:

FLOPPY_RUNTIME_DEV=""

Default:

FLOPPY_RUNTIME_DEV=/dev/fd0

BOOTCDFLOPPY

If the system should boot the kernel from floppy. This reduces space on floppy used by bootcdflopcp. For this to work FLOPPY_CREATE_DEV has to be specified:

BOOTFLOPPY=yes|no

Default:

BOOTFLOPPY=no

BOOT_ONLY_WITH_FLOPPY

If you several machines will be booted from the same bootcd, you must have each one can hav separat configuraiton (exp: /etc/network/interfaces) on floppy. If the floppy can not be mounted, it may be a good idea to stop booting with:

BOOT_ONLY_WITH_FLOPPY=yes

Default:

BOOT_ONLY_WITH_FLOPPY=no

CLEAN_VAR

delete some chached files in /var with: Default:

CLEAN_VAR=yes

TO_FSTAB

To add addiditionel entries to fstab. Use for example:

TO_FSTAB="/dev/hdc1 /home ext3 defaults 1 1

Default:

TO_FSTAB=""

NOTCOMPRESSED

Files or Directory-Trees that should never be compressed on CD can be listed here. This can be used for documentation which should be visible without installing the bootcd. Default:

NOTCOMPRESSED=""

DISABLE_CRON

Files listed will be on the cdrom with a .no_run_on_bootcd suffix so run-parts won't execute them. The original file will be a link to /bin/true. This is meant for cron maintenance scripts which are useless on a static cdrom. The default is to disable the daily find, standard and security scripts. With bootcd2disk this files will be reactivated again.

Default:

DISABLE_CRON="etc/cron.daily/find etc/cron.daily/standard etc/cron.daily/security"

MKISOFS_CHNG

With this variable some options given to mkisofs by bootcdwrite can be changed.

Example: To use -opt1 and -opt2 <value> and to not use any previous -opt1 [<value>...], -opt2 [<value...>] and -opt3 [<value>...] and to leave any other options as defined:

MKISOFS_CHNG="-opt1 -opt2 <value> !-opt3"

Default:

MKISOFS_CHNG=""

extra_changes()

It is possible to define a function called extra_changes to have some files modified on the ISO image. Here is an example:

extra_changes() {
  bootcd_global VAR

  echo "noname" >$VAR/changes/etc/hostname

  mkdir -p $VAR/changes/etc/network
  ( echo "auto lo"
    echo "iface lo inet loopback"
    echo "" echo "auto eth0"
    echo "iface eth0 inet static"
    echo "       address 0.0.0.0"
    echo "       netmask 255.255.255.0"
  ) >$VAR/changes/etc/network/interfaces

  echo "127.0.0.1 localhost noname" >$VAR/changes/etc/hosts

  cat $SRCDISK/etc/passwd |
  grep -v -e "^bs:" -e "^bianca:" -e "^tim:" >$VAR/changes/etc/passwd

  cat $SRCDISK/etc/shadow |
  grep -v -e "^bs:" -e "^bianca:" -e "^tim:" >$VAR/changes/etc/shadow

  cat $SRCDISK/etc/group |
  grep -v -e "^bs:" -e "^bianca:" -e "^tim:" >$VAR/changes/etc/group
}

Default:

# make sure the function is not defined
unset -f extra_changes

BOOTCDMODPROBE

If booted from initrd bootcd has to load the necessary modules. If only modules provided by initramfs-tools are needed you can specify "standard" here:

BOOTCDMODPROBE=standard

If bootcd should try extra hard to load neccessary modules you can specify "bootcd" here. Bootcd will use discover for this purpose. So discover has to be installed:

BOOTCDMODPROBE=bootcd

If you specify auto, bootcd will check if discover is installed. If it is installed BOOTCDMODPROBE=bootcd will be set, if not BOOTCDMODPROBE=standard will be set. Be aware that people have reported, that sometimes BOOTCDMODPROBE=bootcd may not work but sometimes it is needed. Default: