LIVE-BOOT(1)		      Debian Live Project		  LIVE-BOOT(1)



NAME
       live-snapshot - simple script to ease persistence usage


SYNOPSIS
       live-snapshot	 [-c|--cow     DIRECTORY]     [-d|--device     DEVICE]
       [-e|--exclude-list FILE] [-o|--output FILE] [-t|--type TYPE]
       live-snapshot [-r|--resync-string STRING]
       live-snapshot [-h|--help]
       live-snapshot [-u|--usage]
       live-snapshot [-v|--version]


DESCRIPTION
       live-snapshot is a script which can be used to build the right types of
       persistent  image  files  supported by live-boot(7). It is also used on
       exit by the live-boot init script to resync  the  boot-found  snapshots
       devices.


OPTIONS
       -c, --cow DIRECTORY
	   specifies  the  input directory to be cloned in the image file. Its
	   default value "/live/cow" should be right for most uses. However it
	   could  be  handy  to  specify "/home" and type ext2 for the type to
	   prepare an image file suited to be directly mounted by live-boot as
	   home.

       -d, --device DEVICE
	   sets  the  device  where  the  media which the snapshot/persistence
	   file/partition will be put. If it is not specified, a tmpfs will be
	   used  and  linked  to  the  user's  desktop	to move it where it is
	   needed. If the device has no filesystem, an ext2 fs will  be  auto‐
	   matically  created  and  labelled according to the values specified
	   after the "--output" value or with a sane default.

       -e, --exclude-list FILE
	   a file containing a list of	filenames/paths  that  should  not  be
	   saved.  This  exclude list will be remebered on the target snapshot
	   media for reuse.

       -o, --output FILE
	   the filename/label used for	the  output  file/partition.  If  left
	   blank, live-snapshot will search for a proper file on the device or
	   use the whole partition.

       -r, --resync-string STRING
	   internally used on resyncs.

       -f, --refresh
	   try to do the same operation that should be done at reboot or halt,
	   resyncing  boot-time auto discovered snapshots. Useful to prevent a
	   crash or surge power-off.

       -t, --type TYPE
	   Type could be one of "cpio", "squashfs", "ext2", "ext3", "ext4", or
	   "jffs2".

       -h, --help
	   display help and exit.

       -u, --usage
	   show usage and exit.

       -v, --version
	   output version information and exit.


FILES
       /etc/live.conf
	   Some  variables  can be configured via this config file (inside the
	   live system).

       live/filesystem.module
	   This optional file (inside the  live  media)  contains  a  list  of
	   white-space	or  carriage-return-separated file names corresponding
	   to disk images in the "/live" directory. If this file exists,  only
	   images listed here will be merged into the root aufs, and they will
	   be loaded in the order listed here. The first entry	in  this  file
	   will  be  the "lowest" point in the aufs, and the last file in this
	   list will be on the "top" of the aufs, directly below /cow.	 With‐
	   out	this  file,  any images in the "/live" directory are loaded in
	   alphanumeric order.

       /etc/live-persistence.binds
	   This optional file (which resides in the rootfs system, not in  the
	   live media) is used as a list of directories which not need be per‐
	   sistent: ie. their content does not need to	survive  reboots  when
	   using the persistence features.
	   This  saves	expensive  writes and speeds up operations on volatile
	   data such as web caches and temporary files	(like  e.g.  /tmp  and
	   .mozilla) which are regenerated each time. This is achieved by bind
	   mounting each listed directory with a tmpfs on the original path.

       /etc/live-snapshot.list
	   This optional file, if present changes the behaviour of  live-snap‐
	   shot:  only	files and directories listed there are included (inte‐
	   grally) in the snapshot. Beware, it is an experimental feature that
	   only works for cpio targets now.


SEE ALSO
       live-boot(1)

       live-build(7)

       live-config(7)


HOMEPAGE
       More  information  about  live-boot  and the Debian Live project can be
       found on the homepage at <http://live.debian.net/> and in the manual at
       <http://live.debian.net/manual/>.


BUGS
       Bugs  can be reported by submitting a bugreport for the live-boot pack‐
       age in the Debian Bug Tracking System at  <http://bugs.debian.org/>  or
       by  writing  a  mail  to  the  Debian  Live  mailing  list  at <debian-
       live@lists.debian.org>.


AUTHOR
       live-boot was written by Daniel	Baumann  <daniel@debian.org>  for  the
       Debian project.



2.0.15				  2011-02-01			  LIVE-BOOT(1)