1PARTCLONE.DD(8) Partclone User Manual PARTCLONE.DD(8)
2
3
4
6 partclone.dd - unsupported file system backup utility.(like `dd` )
7
9 partclone.dd {[-s | --source] source}
10 {[[-o | --output] [-O | --overwrite]] target}
11 [[-dX | --debug=X] [--restore_raw_file] [-z | --buffer_size] [-N | --ncurses] [-q | --quiet] [-f | --UI-fresh] [-F | --force] [-C | --nocheck] [-R | --rescue] [-L | --logfile] logfile [-D | --domain] [--offset_domain] [-w | --skip_write_error] [-E | --offset=X] [-T | --btfiles] [-t | --btfiles_torrent] [-B | --no_block_detail] [--write-direct-io] [--read-direct-io]]
12
14 partclone.dd is a part of Partclone project to clone unsupported file
15 system with dd method. It will backup all block from partition.
16 Partclone provide utilities to backup used blocks and design for higher
17 compatibility of the file system by using existing library, e.g.
18 e2fslibs is used to read the used block of ext2 partition.
19
20 Partclone supported file system include btrfs, ext2, ext3, ext4,
21 reiserfs, reiser4, xfs and jfs for LINUX. Also support some non-linux
22 operation system, ex: NTFS and FAT (for Windows), HFS plus(APPLE MAC
23 OS), UFS2(FreeBSD), VMFS(VMWare Vsphere). All partclone utils could be
24 run like partclone.xxx is very smiliar fsck or mkfs. For example, for
25 backup/restore hfsplus, just run partclone.hfsp.
26
28 The program follows the usual GNU command line syntax, with long
29 options starting with two dashes (`-'). A summary of options is
30 included below.
31
32 -s FILE, --source FILE
33 Source FILE. The FILE could be a image file(made by partclone) or
34 device depend on your action. Normally, backup source is device,
35 restore source is image file.
36
37 Receving data from pipe line is supported ONLY for restoring, just
38 ignore -s option or use '-' means receive data from stdin.
39
40 -o FILE, --output FILE
41 Output FILE. The FILE could be a image file(partclone will
42 generate) or device depend on your action. Normally, backup output
43 to image file and restore output to device.
44
45 Sending data to pipe line is also supported ONLY for back-up, just
46 ignore -o option or use '-' means send data to stdout.
47
48 -O FILE, --overwrite FILE
49 Overwrite FILE, overwriting if exists.
50
51 -D, --domain
52 Create GNU Ddrescue domain log file from source device. This is a
53 human readable file in which + marks used block areas and ? marks
54 free areas.
55
56 --offset_domain=X
57 Add X (in bytes) to all positions reported in the domain log file
58
59 --restore_raw_file
60 Creating special raw file for loop device.
61
62 -L FILE, --logfile FILE
63 put special path to record partclone log information.(default
64 /var/log/partclone.log)
65
66 -R, --rescue
67 Continue after disk read errors.
68
69 -C, --no_check
70 Don't check device size and free space.
71
72 -N, --ncurses
73 Using Ncurses Text User Interface.
74
75 -F, --force
76 Force progress.
77
78 -f sec, --UI-fresh sec
79 put special second to different interval.
80
81 -z size, --buffer_size size
82 Read/write buffer size (default: 1048576)
83
84 -q, --quiet
85 Disable progress message.
86
87 -dlevel, --debug level
88 Set the debug level [1|2|3]
89
90 -w, --skip_write_error
91 Continue restore while write errors
92
93 --write-direct-io
94 Writing data to TARGET partition without cache
95
96 --read-direct-io
97 Reading data from SOURCE partition without cache
98
99 -B, --no_block_detail
100 Show progress message without block detail
101
102 -E, --offset=X
103 Add offset X (bytes) to OUTPUT
104
105 -T, --btfiles
106 Restore block as file for ClonezillaBT.
107
108 -t, --btfiles_torrent
109 Restore block as file for ClonezillaBT but only generate torrent.
110
111 -h, --help
112 Show summary of options.
113
114 -v, --version
115 Show version of program.
116
118 /var/log/partclone.log
119 The log file of partclone.dd
120
122 clone /dev/hda1 to hda1.dd.img and display debug information.
123 partclone.dd -d -s /dev/hda1 -o hda1.dd.img
124
125 restore /dev/hda1 from hda1.dd.img and display debug information.
126 partclone.dd -d -s hda1.dd.img -o /dev/hda1
127
128
130 The following diagnostics may be issued on stderr:
131
132 partclone.dd provides some return codes, that can be used in scripts:
133
134 Code Diagnostic
135 0 Program exited successfully.
136 1 Clone or Restore seem failed.
137
138
140 Report bugs to thomas@clonezilla.org or http://partclone.org.
141
142 You can get support at http://partclone.org
143
145 partclone(8), partclone.chkimg(8), partclone.restore(8),
146 partclone.dd(8), partclone.info(8)
147
149 Yu-Chin Tsai <thomas@clonezilla.org>
150
152 Copyright © 2007 Yu-Chin Tsai
153
154 This manual page was written for the Debian system (and may be used by
155 others).
156
157 Permission is granted to copy, distribute and/or modify this document
158 under the terms of the GNU General Public License, Version 2 or (at
159 your option) any later version published by the Free Software
160 Foundation.
161
162 On Debian systems, the complete text of the GNU General Public License
163 can be found in /usr/share/common-licenses/GPL.
164
165
166
167
168partclone.dd 10/04/2023 PARTCLONE.DD(8)