mirror of
https://git.code.sf.net/p/ntfs-3g/ntfs-3g.git
synced 2024-11-23 18:14:24 +08:00
Note tar brokenness, update examples
This commit is contained in:
szaka
parent
fae8feea65
commit
1e05dd5d9a
@ -78,7 +78,7 @@ of view.
|
||||
|
||||
At present the most efficient way, both speed and space\-wise, to
|
||||
compress and uncompress large sparse files by common tools
|
||||
is using
|
||||
would be using
|
||||
.BR tar (1)
|
||||
with the options
|
||||
.B \-S
|
||||
@ -93,7 +93,11 @@ writing large amount of zeros to the disk needlessly. But since
|
||||
can't create an archive from the standard input, you can't do this
|
||||
in\-place by just reading
|
||||
.BR ntfsclone
|
||||
standard output.
|
||||
standard output. Even more sadly, using this \-S option results
|
||||
serious data loss since the end of 2004 and the GNU
|
||||
.BR tar
|
||||
maintainers don't care about releasing fixed versions until the
|
||||
present day.
|
||||
.SS The Special Image Format
|
||||
It's also possible, actually it's recommended, to save an NTFS filesystem
|
||||
to a special image format.
|
||||
@ -129,7 +133,7 @@ mountable. In this case all non\-metadata file content will be lost and
|
||||
reading them back will result always zeros.
|
||||
|
||||
The metadata\-only image can be compressed very
|
||||
well, usually to not more than 1\-3 MB thus it's relatively easy to transfer
|
||||
well, usually to not more than 1\-8 MB thus it's easy to transfer
|
||||
for investigation, troubleshooting.
|
||||
|
||||
In this mode of ntfsclone,
|
||||
@ -212,25 +216,31 @@ Show a list of options with a brief description of each one.
|
||||
.SH EXIT CODES
|
||||
The exit code is 0 on success, non\-zero otherwise.
|
||||
.SH EXAMPLES
|
||||
Save an NTFS to a file in the special image format
|
||||
Clone NTFS on /dev/hda1 to /dev/hdc1:
|
||||
.RS
|
||||
.sp
|
||||
.B ntfsclone \-\-overwrite /dev/hdc1 /dev/hda1
|
||||
.sp
|
||||
.RE
|
||||
Save an NTFS to a file in the special image format:
|
||||
.RS
|
||||
.sp
|
||||
.B ntfsclone \-\-save\-image \-\-output backup.img /dev/hda1
|
||||
.sp
|
||||
.RE
|
||||
Restore an NTFS from a special image file to its original partition
|
||||
Restore an NTFS from a special image file to its original partition:
|
||||
.RS
|
||||
.sp
|
||||
.B ntfsclone \-\-restore\-image \-\-overwrite /dev/hda1 backup.img
|
||||
.sp
|
||||
.RE
|
||||
Save an NTFS into a compressed image.
|
||||
Save an NTFS into a compressed image file:
|
||||
.RS
|
||||
.sp
|
||||
.B ntfsclone \-\-save\-image \-o \- /dev/hda1 | gzip \-c > backup.img.gz
|
||||
.sp
|
||||
.RE
|
||||
Restore an NTFS volume from a compressed image file
|
||||
Restore an NTFS volume from a compressed image file:
|
||||
.RS
|
||||
.sp
|
||||
.B gunzip \-c backup.img.gz | \\\\
|
||||
@ -238,7 +248,8 @@ Restore an NTFS volume from a compressed image file
|
||||
.B ntfsclone \-\-restore\-image \-\-overwrite /dev/hda1 \-
|
||||
.sp
|
||||
.RE
|
||||
Backup an NTFS volume to a remote host, using ssh.
|
||||
Backup an NTFS volume to a remote host, using ssh. Please note, that
|
||||
ssh may ask for a password!
|
||||
.RS
|
||||
.sp
|
||||
.B ntfsclone \-\-save\-image \-\-output \- /dev/hda1 | \\\\
|
||||
@ -246,7 +257,8 @@ Backup an NTFS volume to a remote host, using ssh.
|
||||
.B gzip \-c | ssh host 'cat > backup.img.gz'
|
||||
.sp
|
||||
.RE
|
||||
Restore an NTFS volume from a remote host via ssh.
|
||||
Restore an NTFS volume from a remote host via ssh. Please note, that
|
||||
ssh may ask for a password!
|
||||
.RS
|
||||
.sp
|
||||
.B ssh host 'cat backup.img.gz' | gunzip \-c | \\\\
|
||||
@ -254,7 +266,7 @@ Restore an NTFS volume from a remote host via ssh.
|
||||
.B ntfsclone \-\-restore\-image \-\-overwrite /dev/hda1 \-
|
||||
.sp
|
||||
.RE
|
||||
Stream an image from a web server and restore it to a partition
|
||||
Stream an image file from a web server and restore it to a partition:
|
||||
.RS
|
||||
.sp
|
||||
.B wget \-qO \- http://server/backup.img | \\\\
|
||||
@ -262,18 +274,28 @@ Stream an image from a web server and restore it to a partition
|
||||
.B ntfsclone \-\-restore\-image \-\-overwrite /dev/hda1 \-
|
||||
.sp
|
||||
.RE
|
||||
Clone an NTFS volume to a non\-existent file
|
||||
Clone an NTFS volume to a non\-existent file:
|
||||
.RS
|
||||
.sp
|
||||
.B ntfsclone \-\-output ntfs\-clone.img /dev/hda1
|
||||
.sp
|
||||
.RE
|
||||
Pack NTFS metadata for NTFS experts
|
||||
Pack NTFS metadata for NTFS experts. Please note that bzip2 runs
|
||||
very long but results usually at least 10 times smaller archives
|
||||
than gzip.
|
||||
.RS
|
||||
.sp
|
||||
.B ntfsclone \-\-metadata \-\-output ntfsmeta.img /dev/hda1
|
||||
.br
|
||||
.B tar \-cjSf ntfsmeta.img.tar.bz2 ntfsmeta.img
|
||||
.B bzip2 ntfsmeta.img
|
||||
.sp
|
||||
.RE
|
||||
Unpacking NTFS metadata into a sparse file:
|
||||
.RS
|
||||
.sp
|
||||
.B bunzip2 \-c ntfsmeta.img.bz2 | \\\\
|
||||
.br
|
||||
.B cp \-\-sparse=always /proc/self/fd/0 ntfsmeta.img
|
||||
.sp
|
||||
.RE
|
||||
.SH KNOWN ISSUES
|
||||
@ -281,7 +303,6 @@ There are no known problems with
|
||||
.BR ntfsclone .
|
||||
If you think you have found a problem then please send an email describing it
|
||||
to the development team:
|
||||
.br
|
||||
.nh
|
||||
linux\-ntfs\-dev@lists.sourceforge.net
|
||||
.hy
|
||||
|
||||
Loading…
Reference in New Issue
Block a user