1PARTCLONE(8) Partclone User Manual PARTCLONE(8)
2
6 partclone - The utility for clone and restore a partition.
7
9 partclone.[fstype]
10 {[-c | --clone] [-r | --restore] [-b | --dev-to-dev]}
11 {[-s | --source] source}
12 {[[-o | --output] [-O | --overwrite]] target}
13 [[-dX | --debug=X] [--restore_raw_file]]
14 [[-z | --buffer_size] [-N | --ncurses]]
15 [[-q | --quiet] [-f | --UI-fresh]]
16 [[-F | --force] [-I | --ignore_fschk]]
17 [[--ignore_crc] [-X | --dialog] [-C | --nocheck]]
18 [[-R | --rescue] [-L | --logfile] logfile]
19
21 partclone.[fstype] is a part of Partclone project. Partclone provide
22 utilities to backup used blocks and design for higher compatibility of
23 the file system by using existing library, e.g. e2fslibs is used to
24 read the used block of ext2 partition.
25 Partclone supported file system include btrfs, ext2, ext3, ext4,
27 reiserfs, reiser4, xfs and jfs for LINUX. Also support some non-linux
28 operation system, ex: NTFS, FAT and EXFAT(for Windows), HFS plus(APPLE
29 MAC OS), UFS2(FreeBSD), VMFS(VMWare Vsphere) and MINIX(MINIX3).
30 All partclone utils could be run like partclone.[fstype] is very
32 smiliar fsck or mkfs. For example, for backup/restore hfsplus, just run
33 partclone.hfsp
34 File System partclone.[fstype]
36 btrfs partclone.btrfs
38 ext2, ext3, ext4 partclone.[ext2|ext3|ext4]
39 reiserfs 3.5 partclone.reiserfs
40 reiser 4 partclone.reiser4
41 xfs partclone.xfs
42 ufs | ufs2 partclone.ufs
43 jfs partclone.jfs
44 hfs plusfs partclone.[hfs+|hfsplus]
45 vmfs partclone.vmfs
46 ntfs partclone.ntfs
47 fat12, fat16, fat32 partclone.[fat12|fat16|fat32]
48 exfat partclone.exfat
49 minix partclone.minix
50 f2fs partclone.f2fs
51 nilfs2 partclone.nilfs2
52
55 The program follows the usual GNU command line syntax, with long
56 options starting with two dashes (`-'). A summary of options is
57 included below.
58 -s FILE, --source FILE
60 Source FILE. The FILE could be a image file(made by partclone) or
61 device depend on your action. Normally, backup source is device,
62 restore source is image file.
63 Receving data from pipe line is supported ONLY for restoring, just
65 ignore -s option or use '-' means receive data from stdin.
66 -o FILE, --output FILE
68 Output FILE. The FILE could be a image file(partclone will
69 generate) or device depend on your action. Normally, backup output
70 to image file and restore output to device.
71 Sending data to pipe line is also supported ONLY for back-up, just
73 ignore -o option or use '-' means send data to stdout.
74 -O FILE, --overwrite FILE
76 Overwrite FILE, overwriting if exists.
77 -c, --clone
79 Save partition to the special image format.
80 -r, --restore
82 Restore partition from the special image format.
83 -b, --dev-to-dev
85 Local device to device copy on-the-fly, source and output both are
86 device.
87 -D, --domain
89 Create GNU Ddrescue domain log file from source device. This is a
90 human readable file in which + marks used block areas and ? marks
91 free areas.
92 --offset_domain=X
94 Add X (in bytes) to all positions reported in the domain log file
95 --restore_raw_file
97 Creating special raw file for loop device.
98 -L FILE, --logfile FILE
100 put special path to record partclone log information.(default
101 /var/log/partclone.log)
102 -R, --rescue
104 Continue after disk read errors.
105 -C, --no_check
107 Don't check device size and free space.
108 -N, --ncurses
110 Using Ncurses Text User Interface.
111 -X, --dialog
113 Output message as Dialog Format.
114 -I, --ignore_fschk
116 Ignore filesystem check.
117 --ignore_crc
119 Ignore crc check error.
120 -F, --force
122 Force progress.
123 -f sec, --UI-fresh sec
125 put special second to different interval.
126 -z size, --buffer_size size
128 Read/write buffer size (default: 1048576)
129 -q, --quiet
131 Disable progress message.
132 -dlevel, --debug level
134 Set the debug level [1|2|3]
135 -h, --help
137 Show summary of options.
138 -v, --version
140 Show version of program.
141
143 /var/log/partclone.log
144 The log file of partclone
145
147 clone /dev/hda1 to hda1.img and display debug information.
148 partclone.ext3 -c -d -s /dev/hda1 -o hda1.img
149 restore /dev/hda1 from hda1.img and display debug information.
151 partclone.extfs -r -d -s hda1.img -o /dev/hda1
152 restore image from clonezilla(split, gzip,) with stdin source
154 cat sda1.ext3-ptcl-img.gz.a* | gunzip -c | partclone.ext3 -d -r -s - -o /dev/sda1
155
158 The following diagnostics may be issued on stderr:
159 partclone provides some return codes, that can be used in scripts:
161 Code Diagnostic
163 0 Program exited successfully.
164 1 Clone or Restore seem failed.
165
168 Report bugs to thomas@nchc.org.tw or http://partclone.org.
169 You can get support at http://partclone.org
171
173 partclone(8), partclone.chkimg(8), partclone.restore(8),
174 partclone.dd(8), partclone.info(8)
175
177 Yu-Chin Tsai <thomas@nchc.org.tw>
178
180 Copyright © 2007 Yu-Chin Tsai
181 This manual page was written for the Debian system (and may be used by
183 others).
184 Permission is granted to copy, distribute and/or modify this document
186 under the terms of the GNU General Public License, Version 2 or (at
187 your option) any later version published by the Free Software
188 Foundation.
189 On Debian systems, the complete text of the GNU General Public License
191 can be found in /usr/share/common-licenses/GPL.
192partclone 03/18/2022 PARTCLONE(8)