diff --git a/ntfsprogs/ntfsclone.8.in b/ntfsprogs/ntfsclone.8.in index a665a893..09e24f97 100644 --- a/ntfsprogs/ntfsclone.8.in +++ b/ntfsprogs/ntfsclone.8.in @@ -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