Provided by: bootcd_3.08ubuntu1_all bug

NAME

       bootcdwrite.conf - configuration file for bootcdwrite

DESCRIPTION

       The   file  bootcdwrite.conf  contains  configuration  option  for  the
       bootcdwrite(1) program of the same named  package.  The  file  must  be
       located in the configuration directory which is usually /etc/bootcd.

       Blank  lines  are ignored and lines with leading # are comments. Values
       have to be set with name=value

FORMAT

       SRCDISK="<path>"
              Define the filesystems root directory from  which  to  build  an
              image.  If you want to build bootcd from a remote system, export
              root-directory   with   nfs,   mount   it   locally   and    add
              SRCDISK=<mountpoint>.
                Default is "/"

       KERNEL="<path>"
              Define  the  path  to  the kernel which should be used. (SRCDISK
              will be automatically added to path if path does not start  with
              "/" !)
                Default is "vmlinuz"

       KERNEL<number>="<path>"
              You  can  define  multiple additional kernels with <number>. The
              numbers have to start with 1 and can continue with 2, 3, 4  ....
              The  syntax  is  as defined in KERNEL A label for KERNEL<number>
              can   e   defined   with   KLABEL<number>   the    default    is
              KLABEL<number>=linux<number>

       INITRD="<path>"
              Recent  official  debian  kernel  images  (2.4.x)  have  started
              installing initrd images. If you want to use such  a  kernel  to
              build a bootcd without recompiling the kernel you have to use an
              initrd image and add it here.  (SRCDISK  will  be  automatically
              added to path of INITRD if it does not start with "/" !)
                The  installed  initrd  image used to boot from hard disk does
              not always work from cdrom and miss some  drivers  and  features
              you need for bootcd. If CDDEV="auto" should be used, you have to
              build a new initrd. Install bootcd-mkinitramfs to do so.
                Default is "initrd.img"

       INITRD<number>="<path>"
              If KERNEL<number> is defined an initrd for this  kernel  can  be
              defined here.

       RAMDISK_SIZE=<number in kByte>
              Two  Ramdisks  ram1 and ram2 will be created, with the following
              directories:
                 ram1: /dev /etc /home /root /tmp
                 ram2: /var

              Both  Ramdisks  have  the  same  size  which   is   defined   by
              RAMDISK_SIZE.
                Default is 16384

       TYP="<CD|DVD>"
              Define  TYP=CD  or  TYP=DVD  if you want to get a warning if the
              size of the image will be larger as a CD or DVD. The CD  or  DVD
              itself  will  no  longer be automatically burned by bootcdwrite.
              Only the iso image will be created.
                Default is "CD"

       CDDEV="<auto|device> [...]">
              You can specify one or more CD devices to boot from and/or auto.
              The first entry is the default, the others will be given as boot
              options to the user.  See  DISPLAY.  Devices  are  separated  by
              spaces.  If  you  use  INITRD  and  you have installed installed
              bootcd-mkinitramfs you can use "auto" to try to find the  bootcd
              on all SCSI and IDE CDROMS automatically.
                Default is "auto /dev/hda /dev/hdb /dev/hdc /dev/hdd /dev/scd0
              /dev/scd1"

       DISPLAY[<number>]="<file>"
              Define the text to display at boot  time  (see  syslinux  doku),
              this  option  is  not  supported for hppa.  At boot time you can
              press Function Keys to see the text files. (F1 = DISPLAY,  F2  =
              DISPLAY2, F3 = DISPLAY3 ...)
                Default for DISPLAY is "/usr/share/bootcd/default.txt"
                The  word  kernelinfo  will  be  replaced  with  a  file which
              includes some kernelinfo. F10  lists  all  people  mentioned  in
              changelog.gz.

       DO_CHECK="<yes|no>"
              To  check  for possible problems can take a long time, but it is
              recommended to do the checks.
                Default="yes"

       APPEND="<kernel parameter>"
              If  you  need  kernel  options  other   than    "root=..."   and
              "ramdisk_size=..." see append in lilo.conf(5).
                Default is ""

       APPEND<number>="<kernel parameter>"
              If  KERNEL<number>  is defined kernel parameters for this kernel
              can be defined here.

       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 is ""

       NOT_TO_RAM=""
              When  you  boot  from  CD parts of the CD will be copied to ram.
              Here you can decide, what should not go to ram. The  directories
              /etc  /var /dev /tmp /home and /root will be in RAM because they
              have to be writable. Directories are separated by spaces.
                On CD this dirs will get different  names  (/etc.ro,  /var.ro,
              ...)  but  you  do  not  have  to  use  those different names in
              NOT_TO_RAM any more !!!
                If you exclude files in NOT_TO_RAM, they will be copied to  CD
              and  you  will  find  a symbolic link instead of the file in RAM
              pointing to the file on CD. (SRCDISK will be automatically added
              to each path that does not start with "/" !).
                Because  most  people’s home and root directories are to large
              to include in RAM,  subdirectories  can  be  excluded  with  the
              default setting.  Default is
                "$(find  $SRCDISK/home  $SRCDISK/root  -maxdepth 1 -mindepth 1
              -type d)"

       SSHOSTKEY="<yes|no>"
              If you are using ssh it is helpful to have a unique ssh  hostkey
              for   each   CD.   This  will  be  generated  at  burntime  with
              SSHHOSTKEY="<yes>".
                Default is "no"

       UDEV_FIXNET=<yes|no>
              If you are using the udev filesystem and  want  to  install  the
              image  on  other machines, you need to set this to "yes" because
              the      network      interfaces      are      hardwired      in
              /etc/udev/rules.d/z25_persistent-net.rules  and  we  must remove
              them.
                Default is "no"

       ERRORLOG="<file>"
              All errors would be logged to this location.
                Default is "/var/log/bootcdwrite.log"

       VAR="<path>"
              The ISO-image is written to this directory.
                Default is "/var/spool/bootcd"

       FLOPPY_RUNTIME_DEV="<floppy device>"
              When you boot from cd bootcd can read changes from this  device,
              e.g. /dev/fd0.
                Default is ""

       BOOTFLOPPY="<yes|no>"
              If  you  want  to  boot from FLOPPY specify BOOTFLOPPY=yes. This
              reduces space on floppy used by bootcdflopcp. For this  to  work
              FLOPPY_CREATE_DEV  has  to be specified. For hppa this option is
              not supported and must be set to no!
                Default is also "no"

       BOOT_ONLY_WITH_FLOPPY="<yes|no>"
              If you want to boot several machines from the  same  cdrom,  you
              must     have     the     individual     configuration     (exp:
              /etc/network/interfaces) on floppy. If one can not be mounted it
              is  a  good  idea  to  stop  booting  and  to  wait  for  manual
              interaction instead of coming up with a wrong configuration.
                Default is "no"

       CLEAN_VAR="<yes|no>"
              Cached files in /var will be deleted, before /var will be copied
              to  bootcd,  if this parameter is set. This will minimize needed
              space on CD. At this time only the  following  command  will  be
              executed: apt-get clean.
                Default is "yes"

       FASTBOOT="<yes|no>"
              If  is  set additional images for the ramdisk will be created by
              bootcdwrite and copied to CD. This allows  faster  booting,  but
              needs extra space on CD.
                Default is "yes"

       ISOLINUX="<auto|yes|no>"
              If  syslinux  is recent enough then isolinux can be used instead
              of syslinux and ISOLINUX=auto will be treated  as  ISOLINUX=yes.
              If you want to use syslinux instead you have to use ISOLINUX=no.
              (See also /usr/share/doc/syslinux/isolinux.doc.gz.)
                Default is "auto"

       SYSLINUX_SAVE="<yes|no>"
              This option for ISOLINUX. If SYSLINUX_SAVE=yes then syslinux  is
              called  with  -s  option.  The  manpage  of  syslinux says: this
              installs a "save, slow  and  stupid"  version  of  syslinux.  In
              earlier  version  the  -s  option  was  always used. Now you can
              change it.
                Default is "yes"

       ARCH="<auto|hppa|i386|ia64>"
              You can create bootcd for HP PA-RISC too. It is possible to  let
              bootcdwrite  detect  your  architecture  with  ARCH=auto. To use
              ARCH=hppa the debian package bootcd-hppa must be installed.
                Default is "auto"

       DEVFS="<yes|no>"
              With devfs you do not need device files and inodes in /dev/*. If
              running    diskless    this    will    save    some   ram   (See
              /usr/src/linux/Documentation/filesystems/devfs/README  for  more
              infos). It is probably better not to use this feature in future,
              because it will be obsolete in newer kernels.
                Default is "no"

       TO_FSTAB="<fstab entry>"
              Add additional mount point entries to the cdrom’s /etc/fstab. If
              you don’t want additional mount points, leave it as "".
                e.g.: TO_FSTAB="/dev/hdc1 /home ext3 defaults 1 1"
                Default is ""

       COMPRESS="<auto|yes|no>"
              If  you  want  to  have  a transparent-compression ISO 9660/Rock
              Ridge  filesystem  define  "yes".  Use  "auto"   if   you   want
              compression  and  bootcdwrite should check the needed disk space
              and check for the necessary software  is  installed.   Therefore
              you have to define DO_CHECK=yes if you define COMPRESS=auto.
                Default is "auto"

       NOTCOMPRESSED="<list of files and directories>"
              Files  or  Directory-Trees that should never be compressed on CD
              can be listed here.  This  is  useful  for  documentation  which
              should be visible without installing the bootcd-image.
                Define  the  path as it is on the CD, (with /var.ro instead of
              /var) and separate files and directories with spaces.
                Default is ""

       DISABLE_CRON="<list of files>"
              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.  (SRCDISK will
              be automatically added to path if path does not start  with  "/"
              !)
                Default    is   "etc/cron.daily/find   etc/cron.daily/standard
              etc/cron.daily/security"

       BOOTCDMODPROBE="<standard|bootcd|auto>"
              This  option  is  only  relevant,   if   bootcd-mkinitramfs   is
              installed.   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.  If bootcd should
              try extra  hard  to  load  necessary  modules  you  can  specify
              "bootcd"  here.   Bootcd  will use discover for this purpose. So
              discover has to be installed.  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 is "standard"

       MKISOFS_CHNG="<option>"
              Add  some  additional  options  to  mkisofs on creating cdimage.
              Possible syntax is MKISOFS_CHNG="[[!]<option>...]".
                Most people will probably define "", but it was reported  that
              you  may  need  the following option with newer hardware "-boot-
              load-size 20".

              Please create debian-bugreports  if  you  have  to  use  special
              options,  not mentioned here. Then I can list this options here!

              Example: MKISOFS_CHNG="-opt1 -opt2 <value> !-opt3"
               means: use "-opt1" and "-opt2 <value>", don’t use any
                      previous "-opt1 [<value>...]", "-opt2 [<value>...]" and
                      "-opt3 [<value>...]".
                      Leave any other options as defined.

       function extra_changes() {
              return }
              It is possible to define a function called extra_changes to have
              some files modified on the ISO image.

              Example:
                function extra_changes() {
                   echo "noname" >$VAR/changes/etc.ro/hostname
                }

              Optional

FILES

       /etc/bootcd/bootcdwrite.conf
              Configuration for bootcdwrite.

SEE ALSO

       bootcdwrite(1), bootcd2disk(1), bootcd(1), bootcdflopcp(1)

AUTHOR

       This    manual    page    was    written    by    Carsten    Dinkelmann
       <Carsten.Dinkelmann@foobar-cpa.de>, for  the  Debian  GNU/Linux  system
       (but may be used by others).

                         Wed Mai 15 12:15:00 MET 2005      BOOTCDWRITE.CONF(5)