debian/manpage/casper.7

   1 .TH CASPER 7 "Thu,  28 Sep 2006" "1.69" "Initramfs-tools hook"
   2
   3 .SH NAME
   4 casper \- an hook for initramfs-tools to boot live systems.
   5
   6 .SH SYNOPSIS
   7 .B BOOT=casper
   8 As kernel parameter boot prompt.
   9
  10 .SH DESCRIPTION
  11 Casper is an hook for initramfs-tools used to generate initramfs able to boot live systems like those created by make-live, this includes the Debian-Live isos, netboot tarballs, and usb stick image and Ubuntu live cds. At boot time it will look for a (often read-only) media containing a "/casper" directory where root filesystems (often squashfs compressed) lies and create, using unionfs, a writable environment for debian like systems to boot from.
  12
  13 .SH RECOGNIZED BOOT OPTIONS
  14 .TP
  15 .B casper-getty
  16 This enable a special serial login shell (experimental).
  17 .TP
  18 .BI "host=" HOSTNAME " , userfullname=" USERFULLNAME " , username=" USERNAME
  19 Those parameters lets you override values read from the config file.
  20 .TP
  21 .B "showmounts"
  22 Specifying this will make casper to show on "/" the ro filesystems (mostly compressed) on /casper. This is not enabled by default because could lead to problems by application like "mono" which store binary paths on installation.
  23 .TP
  24 .BI ip= IFACE,ADDRESS,NETMASK,GATEWAY [ :IFACE,ADDRESS,NETMASK,GATEWAY "]*"
  25 Let you specify the name(s) and the options of the interface(s) that should be configured at boot time. Do not specify it if you want to use dhcp (default).
  26 .TP
  27 .BR ip[= frommedia ]
  28 This way dhcp and static configuration is just skipped and the system will use the (must be) media-preconfigured /etc/network/interfaces instead.
  29
  30 .TP
  31 .BR "netboot[=" nfs "|" cifs ]
  32 This tells casper to look for a network mount, to be specified by parameter "nfsroot=" (with optional "nfsopts="), for the "/casper" dirs where root filesystem lies. With no args, will try cifs first, and if it fails nfs.
  33 .TP
  34 .B persistent
  35 Casper will look for persistent and snapshot partitions or files labeled "casper-rw", "home-rw", "casper-snap*", "home-snap*" and will try to, in order: mount as /cow the first, mount the second in /home, and just copy the contents of the latters in appropriate locations.
  36 .TP
  37 .B toram
  38 Adding this parameter, casper will try to copy to ram the whole read-only media before mounting the root filesystem(s), it could need a lot of ram, according to the space used by the read-only media.
  39
  40 .SH FILES
  41 .B /etc/casper.conf
  42 some variables could be configured via this config file.
  43
  44 .SH BUGS
  45 .B casper
  46 works fully on amd64, i386 and ppc, it should too on other archs.
  47
  48 .SH HOMEPAGE
  49 Debian Live project <http://live.debian.net/>
  50
  51 .SH SEE ALSO
  52 .BR casper-snapshot(1), initramfs-tools(8), make-live(1), make-live.conf(5)
  53
  54 .SH AUTHOR
  55 casper was written by Tollen Fog Heen <tfheen@canonical.com>, Matt Zimmerman <mdz@canonical.com>, and Marco Amadori <marco.amadori@gmail.com>.
  56 .TP
  57 This manual page was written by Marco Amadori <marco.amadori@gmail.com>,
  58 for the Debian project (but may be used by others).