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
29 (APPLE MAC OS), UFS2 (FreeBSD), VMFS (VMWare Vsphere) and MINIX
30 (MINIX3).
31 All partclone utils could be run like partclone.[fstype] is very
33 smiliar fsck or mkfs. For example, for backup/restore hfsplus, just run
34 partclone.hfsp
35 File System partclone.[fstype]
37 btrfs partclone.btrfs
39 ext2, ext3, ext4 partclone.[ext2|ext3|ext4]
40 reiserfs 3.5 partclone.reiserfs
41 reiser 4 partclone.reiser4
42 xfs partclone.xfs
43 ufs | ufs2 partclone.ufs
44 jfs partclone.jfs
45 hfs plusfs partclone.[hfs+|hfsplus]
46 vmfs partclone.vmfs
47 ntfs partclone.ntfs
48 fat12, fat16, fat32 partclone.[fat12|fat16|fat32]
49 exfat partclone.exfat
50 minix partclone.minix
51 f2fs partclone.f2fs
52 nilfs2 partclone.nilfs2
53
56 The program follows the usual GNU command line syntax, with long
57 options starting with two dashes (`-'). A summary of options is
58 included below.
59 -s FILE, --source FILE
61 Source FILE. The FILE could be a image file (made by partclone) or
62 device depend on your action. Normally, backup source is device,
63 restore source is image file.
64 Receving data from pipe line is supported ONLY for restoring, just
66 ignore -s option or use '-' means receive data from stdin.
67 -o FILE, --output FILE
69 Output FILE. The FILE could be a image file (partclone will
70 generate) or device depend on your action. Normally, backup output
71 to image file and restore output to device.
72 Sending data to pipe line is also supported ONLY for back-up, just
74 ignore -o option or use '-' means send data to stdout.
75 -O FILE, --overwrite FILE
77 Overwrite FILE, overwriting if exists.
78 -c, --clone
80 Save partition to the special image format.
81 -r, --restore
83 Restore partition from the special image format.
84 -b, --dev-to-dev
86 Local device to device copy on-the-fly, source and output both are
87 device.
88 -D, --domain
90 Create GNU Ddrescue domain log file from source device. This is a
91 human readable file in which + marks used block areas and ? marks
92 free areas.
93 --offset_domain=X
95 Add X (in bytes) to all positions reported in the domain log file
96 --restore_raw_file
98 Creating special raw file for loop device.
99 -L FILE, --logfile FILE
101 put special path to record partclone log information. (default
102 /var/log/partclone.log)
103 -R, --rescue
105 Continue after disk read errors.
106 -C, --no_check
108 Don't check device size and free space.
109 -N, --ncurses
111 Using Ncurses Text User Interface.
112 -X, --dialog
114 Output message as Dialog Format.
115 -I, --ignore_fschk
117 Ignore filesystem check.
118 --ignore_crc
120 Ignore crc check error.
121 -F, --force
123 Force progress.
124 -f sec, --UI-fresh sec
126 put special second to different interval.
127 -z size, --buffer_size size
129 Read/write buffer size (default: 1048576)
130 -q, --quiet
132 Disable progress message.
133 -dlevel, --debug level
135 Set the debug level [1|2|3]
136 -h, --help
138 Show summary of options.
139 -v, --version
141 Show version of program.
142
144 /var/log/partclone.log
145 The log file of partclone
146
148 clone /dev/hda1 to hda1.img and display debug information.
149 partclone.ext3 -c -d -s /dev/hda1 -o hda1.img
150 restore /dev/hda1 from hda1.img and display debug information.
152 partclone.extfs -r -d -s hda1.img -o /dev/hda1
153 restore image from clonezilla (split, gzip,) with stdin source
155 cat sda1.ext3-ptcl-img.gz.a* | gunzip -c | partclone.ext3 -d -r -s - -o /dev/sda1
156
159 The following diagnostics may be issued on stderr:
160 partclone provides some return codes, that can be used in scripts:
162 Code Diagnostic
164 0 Program exited successfully.
165 1 Clone or Restore seem failed.
166
169 Report bugs to thomas@nchc.org.tw or http://partclone.org.
170 You can get support at http://partclone.org
172
174 partclone(8), partclone.chkimg(8), partclone.restore(8),
175 partclone.dd(8), partclone.info(8)
176
178 Yu-Chin Tsai <thomas@nchc.org.tw>
179
181 Copyright © 2007 Yu-Chin Tsai
182 This manual page was written for the Debian system (and may be used by
184 others).
185 Permission is granted to copy, distribute and/or modify this document
187 under the terms of the GNU General Public License, Version 2 or (at
188 your option) any later version published by the Free Software
189 Foundation.
190 On Debian systems, the complete text of the GNU General Public License
192 can be found in /usr/share/common-licenses/GPL.
193partclone 01/09/2023 PARTCLONE(8)