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 -x, --compresscmd CMD
82 Execute CMD in a write-only pipe to compress the output image.
83 Applicable to cloning. The output file is always overwritten.
84 -r, --restore
86 Restore partition from the special image format.
87 -b, --dev-to-dev
89 Local device to device copy on-the-fly, source and output both are
90 device.
91 -D, --domain
93 Create GNU Ddrescue domain log file from source device
94 --offset_domain=X
96 Add X (in bytes) to all positions reported in the domain log file
97 --restore_raw_file
99 Creating special raw file for loop device.
100 -l FILE, --logfile FILE
102 put special path to record partclone log information.(default
103 /var/log/partclone.log)
104 -R, --rescue
106 Continue after disk read errors.
107 -C, --no_check
109 Don't check device size and free space.
110 -N, --ncurse
112 Using Ncurses Text User Interface.
113 -X, --dialog
115 Output message as Dialog Format.
116 -I, --ignore_fschk
118 Ignore filesystem check.
119 --ignore_crc
121 Ignore crc check error.
122 -F, --force
124 Force progress.
125 -f sec, --UI-fresh sec
127 put special second to different interval.
128 -z size, --buffer_size size
130 Read/write buffer size (default: 1048576)
131 -q, --quiet
133 Disable progress message.
134 -dlevel, --debug level
136 Set the debug level [1|2|3]
137 -h, --help
139 Show summary of options.
140 -v, --version
142 Show version of program.
143
145 /var/log/partclone.log
146 The log file of partclone
147
149 clone /dev/hda1 to hda1.img and display debug information.
150 partclone.ext3 -c -d -s /dev/hda1 -o hda1.img
151 restore /dev/hda1 from hda1.img and display debug information.
153 partclone.extfs -r -d -s hda1.img -o /dev/hda1
154 restore image from clonezilla(split, gzip,) with stdin source
156 cat sda1.ext3-ptcl-img.gz.a* | gunzip -c | partclone.ext3 -d -r -s - -o /dev/sda1
157
160 The following diagnostics may be issued on stderr:
161 partclone provides some return codes, that can be used in scripts:
163 Code Diagnostic
165 0 Program exited successfully.
166 1 Clone or Restore seem failed.
167
170 Report bugs to thomas@nchc.org.tw or http://partclone.org.
171 You can get support at http://partclone.org
173
175 partclone(8), partclone.chkimg(8), partclone.restore(8),
176 partclone.dd(8), partclone.info(8)
177
179 Yu-Chin Tsai <thomas@nchc.org.tw>
180
182 Copyright © 2007 Yu-Chin Tsai
183 This manual page was written for the Debian system (and may be used by
185 others).
186 Permission is granted to copy, distribute and/or modify this document
188 under the terms of the GNU General Public License, Version 2 or (at
189 your option) any later version published by the Free Software
190 Foundation.
191 On Debian systems, the complete text of the GNU General Public License
193 can be found in /usr/share/common-licenses/GPL.
194partclone 12/24/2015 PARTCLONE(8)