Provided by: bootcd_2.51_all bug

NAME

       bootcdwrite.conf - configuration file for bootcdwrite

DESCRIPTION

       The  file  .I  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"

       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 harddisk 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. Use bootcdmkinitrd to do so.
                Default is "initrd.img"

       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 8192

       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  run  bootcdmkinitrd  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="<file>"
              Define  the  text  to  display at boot time (see syslinux doku),
              this option is not supported for hppa.
                Default is "/usr/share/bootcd/default.txt"

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

       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 "/" !).
                Default is ""

       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"

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

       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),
       bootcdmkinitrd(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)