debian/manpage/casper.7

   1 .TH CASPER 7 "Mon,  26 Sep 2006" "1.68" "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 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 .BI "host=" HOSTNAME " , userfullname=" USERFULLNAME " , username=" USERNAME
  16 Those parameters lets you override values read from the config file.
  17 .TP
  18 .B casper-getty
  19 This enable a special serial login shell (experimental).
  20 .TP
  21 .BI ip= IFACE,ADDRESS,NETMASK,GATEWAY [ :IFACE,ADDRESS,NETMASK,GATEWAY "]*"
  22 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).
  23 .TP
  24 .BR ip[= frommedia ]
  25 This way dhcp and static configuration is just skipped and the system will use the (must be) media-preconfigured /etc/network/interfaces instead.
  26
  27 .TP
  28 .BR "netboot[=" nfs "|" cifs ]
  29 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.
  30 .TP
  31 .B persistent
  32 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.
  33 .TP
  34 .B toram
  35 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.
  36
  37 .SH FILES
  38 .B /etc/casper.conf
  39 some variables could be configured via this config file.
  40
  41 .SH BUGS
  42 .B casper
  43 works fully on amd64, i386 and ppc, it should too on other archs.
  44
  45 .SH HOMEPAGE
  46 Debian Live project <http://live.debian.net/>
  47
  48 .SH SEE ALSO
  49 .BR initramfs-tools(8), make-live(8), make-live.conf(8)
  50
  51 .SH AUTHOR
  52 casper was written by Tollen Fog Heen <tfheen@canonical.com>, Matt Zimmerman <mdz@canonical.com>, and Marco Amadori <marco.amadori@gmail.com>,
  53 .TP
  54 This manual was written by Marco Amadori <marco.amadori@gmail.com>,
  55 for the Debian project (but may be used by others).