=====================================================================
fsarchiver: Filesystem Archiver for Linux [http://www.fsarchiver.org]
=====================================================================

About FSArchiver
----------------
FSArchiver is a system tool that allows you to save the contents of a
filesystem to a compressed archive file. The filesystem contents can be
restored on a device which has a different size and it can be restored on a
different filesystem. Unlike tar/dar, FSArchiver also creates the
filesystem when it extracts the data to devices. Everything is checksummed
in the archive in order to protect the data. If the archive is corrupt, you
just lose the current file, not the whole archive. FSArchiver is released
under the GPLv2 license. You should read the Quick Start guide
[http://www.fsarchiver.org/quickstart/] if you are using FSArchiver for the
first time.

Detailed description
--------------------
The purpose of this project is to provide a safe and flexible filesystem
backup/deployment tool. Other open-source filesystems tools such as
Partimage already exist. These tools are working at the filesystem block
level, so it's not possible to restore the backup to a smaller device, and
restoring to a bigger one forces you to resize the filesystem by hand.

The purpose is to have a very flexible program. FSArchiver can extract an
archive to a device which is smaller that the original one as long as there
is enough space to store the data. It can also restore the data on a
different filesystem, so you can use it when you want to convert your
filesystem: you can backup an EXT3 filesystem, and restore it as ReiserFS.

FSArchiver works at the file level. It can make an archive of most Linux
filesystems (EXT3, ReiserFS, XFS, ...) that the running kernel can mount
with read-write support. It will preserve all the standard Unix file
attributes (permissions, timestamps, symbolic-links, hard-links,
extended-attributes, ...), as long as the kernel has support for them
enabled.

Limitations
-----------
There are limitations anyway: FAT filesystem is supported basically for EFI
System Partition volumes (UEFI systems) and won't work for bootable Windows
volumes. Also, NTFS support is experimental and shouldn't be used in
production. FSArchiver won't preserve features which are very specific to a
filesystem. For instance, if you create a snapshot in a Btrfs volume,
FSArchiver won't know anything about that, and it will just backup the
contents seen when you mount the device.

FSArchiver is safe when it makes backups of devices which are not mounted
or are mounted read-only. There is an option to force the backup of a
read-write mounted volume, but there may be problems with the files that
changed during the backup. If you want to backup a device which are in use,
the best thing to do is to make an LVM snapshot of it using lvcreate -s,
which is part of the LVM userland tools. Unfortunately you can only make
snapshots of devices which are LVM Logical Volumes.

Protection against data loss
----------------------------
FSArchiver is using two levels of checksums to protect your data against
corruption. Each block of each file has a 32-bit checksum written in the
archive. That way we can identify which block of your file is damaged. Once
a file has been restored, the MD5 checksum of the whole file is compared to
the original MD5. It's a 128-bit checksum, so it will detect all file
corruptions. In case one file is damaged, FSArchiver will restore all the
other files from your archive, so you won't lose all your data. It's very
different from tar.gz where the whole tar is compressed with gzip. In that
case, the data which are written after the corruption are lost.
FSArchiver-0.2.3 and newer versions are able to ignore corrupt contents in
an archive file, so all the other files will be restored.