Provided by: live-boot-doc_3.0~a24-1ubuntu1_all bug


       live-snapshot - simple script to ease persistence usage


       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]


       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


       -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

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

       -h, --help
           display help and exit.

       -u, --usage
           show usage and exit.

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


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

           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.
           Without  this  file, any images in the "/live" directory are loaded
           in alphanumeric order.

           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
           persistent: 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.

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







       More  information  about  live-boot  and the Debian Live project can be
       found on the homepage at <> and in the manual at


       Bugs  can  be  reported  by  submitting  a  bugreport for the live-boot
       package in the Debian Bug Tracking System at  <>
       or  by  writing  a  mail  to  the  Debian Live mailing list at <debian->.


       live-boot was written by Daniel  Baumann  <>  for  the
       Debian project.