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