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

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

       /etc/live-snapshot.list
           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.

SEE ALSO

       live-boot(1)

       live-build(7)

       live-config(7)

       live-tools(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 package 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.