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
parent
37cf1d9b38
commit
1d17c6e429
|
@ -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>.
|
||||
|
|
Loading…
Reference in New Issue