Update, corrections and removed all mentions of the buggy cp --sparse=always that could corrupt data

if the destination is block device (though GNU cp was fixed after we reported the problem).

(Logical change 1.354)
edge.strict_endians
omakaista.fi!szaka 2004-04-01 21:30:42 +00:00
parent 37cf1d9b38
commit 1d17c6e429
1 changed files with 16 additions and 39 deletions

View File

@ -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
<linux-ntfs-dev@lists.sourceforge.net>.