live-snapshot(1)
NAME
live-snapshot - a simple script to ease persistence usage
SYNOPSIS
live-snapshot [-c|--cow DIRECTORYs] [-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-initramfs(7). It is also used
on exit by the live-initramfs 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-initramfs 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-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. It works only for cpio targets.
/etc/live-snapshot.exclude_list- This optional file, if present will filter the files that will be saved
by live-snapshot removing (as in "grep -F -v") all filenames that will
be matched by strings listed in it. It works for cpio and squashfs
snapshot types only; it is pretty useful for filtering temporary files and disk caches.
SEE ALSO
This program is a part of live-initramfs.
BUGS
Report bugs against live-initramfs
http://packages.qa.debian.org/live-initramfs.
HOMEPAGE
More information about the Debian Live project can be found at
http://debian-live.alioth.debian.org/ and
http://wiki.debian.org/DebianLive/.
AUTHORS
live-initramfs is maintained by Daniel Baumann <daniel@debian.org[1]> for the Debian project. live-initramfs is a fork of casper[2]. casper was originally written by Tollef Fog Heen <tfheen@canonical.com[3]> and Matt Zimmerman <mdz@canonical.com[4]>.
NOTES
- 1. daniel@debian.org
- mailto:daniel@debian.org
- 2. casper
http://packages.ubuntu.com/casper/ - 3. tfheen@canonical.com
mailto:tfheen@canonical.com - 4. mdz@canonical.com
mailto:mdz@canonical.com