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. Normanly, 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. Normanly, 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
90 --offset_domain=X
92 Add X (in bytes) to all positions reported in the domain log file
93 --restore_raw_file
95 Creating special raw file for loop device.
96 -L FILE, --logfile FILE
98 put special path to record partclone log information.(default
99 /var/log/partclone.log)
100 -R, --rescue
102 Continue after disk read errors.
103 -C, --no_check
105 Don't check device size and free space.
106 -N, --ncurse
108 Using Ncurses Text User Interface.
109 -X, --dialog
111 Output message as Dialog Format.
112 -I, --ignore_fschk
114 Ignore filesystem check.
115 --ignore_crc
117 Ignore crc check error.
118 -F, --force
120 Force progress.
121 -f sec, --UI-fresh sec
123 put special second to different interval.
124 -z size, --buffer_size size
126 Read/write buffer size (default: 1048576)
127 -q, --quiet
129 Disable progress message.
130 -dlevel, --debug level
132 Set the debug level [1|2|3]
133 -h, --help
135 Show summary of options.
136 -v, --version
138 Show version of program.
139
141 /var/log/partclone.log
142 The log file of partclone
143
145 clone /dev/hda1 to hda1.img and display debug information.
146 partclone.ext3 -c -d -s /dev/hda1 -o hda1.img
147 restore /dev/hda1 from hda1.img and display debug information.
149 partclone.extfs -r -d -s hda1.img -o /dev/hda1
150 restore image from clonezilla(split, gzip,) with stdin source
152 cat sda1.ext3-ptcl-img.gz.a* | gunzip -c | partclone.ext3 -d -r -s - -o /dev/sda1
153
156 The following diagnostics may be issued on stderr:
157 partclone provides some return codes, that can be used in scripts:
159 Code Diagnostic
161 0 Program exited successfully.
162 1 Clone or Restore seem failed.
163
166 Report bugs to thomas@nchc.org.tw or http://partclone.org.
167 You can get support at http://partclone.org
169
171 partclone(8), partclone.chkimg(8), partclone.restore(8),
172 partclone.dd(8), partclone.info(8)
173
175 Yu-Chin Tsai <thomas@nchc.org.tw>
176
178 Copyright © 2007 Yu-Chin Tsai
179 This manual page was written for the Debian system (and may be used by
181 others).
182 Permission is granted to copy, distribute and/or modify this document
184 under the terms of the GNU General Public License, Version 2 or (at
185 your option) any later version published by the Free Software
186 Foundation.
187 On Debian systems, the complete text of the GNU General Public License
189 can be found in /usr/share/common-licenses/GPL.
190partclone 06/12/2021 PARTCLONE(8)