|
From: Szabolcs S. <sz...@us...> - 2006-02-06 00:48:30
|
Changes by: szaka Update of /cvsroot/linux-ntfs/ntfsprogs/ntfsprogs In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv20171/ntfsprogs Modified Files: ntfsclone.8.in Log Message: Note tar brokenness, update examples Index: ntfsclone.8.in =================================================================== RCS file: /cvsroot/linux-ntfs/ntfsprogs/ntfsprogs/ntfsclone.8.in,v retrieving revision 1.27 retrieving revision 1.28 diff -u -p -r1.27 -r1.28 --- ntfsclone.8.in 8 Jan 2006 21:01:23 -0000 1.27 +++ ntfsclone.8.in 6 Feb 2006 00:48:23 -0000 1.28 @@ -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 dis 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\-metadat 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 desc .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 .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, .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 hos .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 re .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\-de...@li... .hy |
