diff --git a/ntfsprogs/ntfsclone.8.in b/ntfsprogs/ntfsclone.8.in index eb709b57..32ad1bf6 100644 --- a/ntfsprogs/ntfsclone.8.in +++ b/ntfsprogs/ntfsclone.8.in @@ -1,10 +1,10 @@ .\" -*- nroff -*- .\" Copyright (c) 2003 Richard Russon -.\" Copyright (c) 2003 Szabolcs Szakacsits +.\" Copyright (c) 2003-2004 Szabolcs Szakacsits .\" All Rights Reserved. .\" This file may be copied under the terms of the GNU Public License. .\" -.TH NTFSCLONE 8 "Oct 2003" "ntfsprogs version @VERSION@" +.TH NTFSCLONE 8 "Mar 2004" "ntfsprogs version @VERSION@" .SH NAME ntfsclone \- Efficiently clone an NTFS filesystem .SH SYNOPSIS @@ -12,11 +12,11 @@ ntfsclone \- Efficiently clone an NTFS filesystem [ .B \-fhm ] -.B \-o +.B \-\-output [ .I FILE | -.B \- +.B \- ] .B device .br @@ -24,7 +24,7 @@ ntfsclone \- Efficiently clone an NTFS filesystem [ .B \-fhm ] -.B \-O +.B \-\-overwrite .I FILE .B device .SH DESCRIPTION @@ -66,7 +66,7 @@ The only main Linux filesystem having support for efficient sparse file handling is XFS by the XFS_IOC_GETBMAPX .BR ioctl\fR. -However none of the common utility supports it. +However none of the common utilities supports it. This means when you tar, cp, gzip, bzip2, etc a large sparse file they will always read the entire file, even if you use the "sparse support" options. @@ -77,15 +77,8 @@ compresses large sparse files much better than but it does so also much slower. Moreover neither of them handles large sparse files efficiently during uncompression from disk space usage point -of view. A possible workaround is if you pipe the uncompressed -stream through -.BR cp\fR, -for example this way, -.RS -.sp -.B bunzip2 \-c image.bz2 | cp \-\-sparse=always /proc/self/fd/0 image -.sp -.RE +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 @@ -117,7 +110,7 @@ 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 -it for investigation to NTFS experts. +for investigation, troubleshooting. In this mode of ntfsclone, .B NONE @@ -168,13 +161,13 @@ to overcome every single safety checks. .B \-h, \-\-help Show a list of options with a brief description of each one. .SH EXAMPLES -Cloning (save, backup) an NTFS volume to a non-existent file +Clone (save, backup) an NTFS volume to a non-existent file .RS .sp .B ntfsclone \-\-output ntfs.img /dev/hda1 .sp .RE -Restoring a clone image to its original partition +Restore a clone image to its original partition .RS .sp .B ntfsclone \-\-overwrite /dev/hda1 ntfs.img @@ -201,10 +194,10 @@ at least 2-4 times but it creates also bigger compressed files. .B ntfsclone \-\-output ntfs.img /dev/hda1 | bzip2 \-c > ntfs.img.bz2 .sp .RE -Restoring an NTFS volume from a compressed image +Restore an NTFS volume from a compressed image .RS .sp -.B bunzip2 \-c ntfs.img.bz2 | dd of=/dev/hda1 +.B bunzip2 \-c ntfs.img.bz2 | dd of=/dev/hda1 bs=8192 .sp .RE Backup an NTFS volume to a remote host, using @@ -215,26 +208,10 @@ default compression. .B ntfsclone \-o \- /dev/hda1 | ssh \-C host 'bzip \-c9 > ntfs.img.bz2' .sp .RE -Clone an NTFS volume to a remote host, using -.BR ssh -default compression (type everything in one line). +Restore an NTFS volume from a remote host via ssh. .RS .sp -.B ntfsclone \-o \- /dev/hda1 | \\\\ -.br -.B ssh \-C host 'cat | cp \-\-sparse=always /proc/self/fd/0 ntfs.img' -.sp -.RE -Clone a remote NTFS volume to the local filesystem via -.BR ssh -using a custom compression level (type everything in one line). -Speed-wise the optimal compression level depends on your network, -disk and CPU speed, saturation. -.RS -.sp -.B ssh host 'ntfsclone \-o \- /dev/hda1 | gzip \-2c' | \\\\ -.br -.B gunzip \-c | cp \-\-sparse=always /proc/self/fd/0 ntfs.img +.B ssh host 'cat ntfs.img.bz2' | bunzip2 | dd of=/dev/hda1 bs=8192 .sp .RE Pack NTFS metadata for NTFS experts @@ -243,7 +220,7 @@ Pack NTFS metadata for NTFS experts .B ntfsclone \-\-metadata \-\-output ntfsmeta.img /dev/hda1 .br .B tar \-cjSf ntfsmeta.img.tar.bz2 ntfsmeta.img -.SH BUGS +.SH KNOWN ISSUES This program has no known bugs. If you find one, please send an email to .nh .