1PARTCLONE(8)                 Partclone User Manual                PARTCLONE(8)
2
3
4

NAME

6       partclone - The utility for clone and restore a partition.
7

SYNOPSIS

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

DESCRIPTION

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
26       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
31       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
35                  File System             partclone.[fstype]
36
37                  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
53

OPTIONS

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
59       -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
64           Receving data from pipe line is supported ONLY for restoring, just
65           ignore -s option or use '-' means receive data from stdin.
66
67       -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
72           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
75       -O FILE, --overwrite FILE
76           Overwrite FILE, overwriting if exists.
77
78       -c, --clone
79           Save partition to the special image format.
80
81       -r, --restore
82           Restore partition from the special image format.
83
84       -b, --dev-to-dev
85           Local device to device copy on-the-fly, source and output both are
86           device.
87
88       -D, --domain
89           Create GNU Ddrescue domain log file from source device
90
91       --offset_domain=X
92           Add X (in bytes) to all positions reported in the domain log file
93
94       --restore_raw_file
95           Creating special raw file for loop device.
96
97       -l FILE, --logfile FILE
98           put special path to record partclone log information.(default
99           /var/log/partclone.log)
100
101       -R, --rescue
102           Continue after disk read errors.
103
104       -C, --no_check
105           Don't check device size and free space.
106
107       -N, --ncurse
108           Using Ncurses Text User Interface.
109
110       -X, --dialog
111           Output message as Dialog Format.
112
113       -I, --ignore_fschk
114           Ignore filesystem check.
115
116       --ignore_crc
117           Ignore crc check error.
118
119       -F, --force
120           Force progress.
121
122       -f sec, --UI-fresh sec
123           put special second to different interval.
124
125       -z size, --buffer_size size
126           Read/write buffer size (default: 1048576)
127
128       -q, --quiet
129           Disable progress message.
130
131       -dlevel, --debug level
132           Set the debug level [1|2|3]
133
134       -h, --help
135           Show summary of options.
136
137       -v, --version
138           Show version of program.
139

FILES

141       /var/log/partclone.log
142           The log file of partclone
143

EXAMPLES

145            clone /dev/hda1 to hda1.img and display debug information.
146              partclone.ext3 -c -d -s /dev/hda1 -o hda1.img
147
148            restore /dev/hda1 from hda1.img and display debug information.
149              partclone.extfs -r -d -s hda1.img -o /dev/hda1
150
151            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
154

DIAGNOSTICS

156       The following diagnostics may be issued on stderr:
157
158       partclone provides some return codes, that can be used in scripts:
159
160       Code   Diagnostic
161       0      Program exited successfully.
162       1      Clone or Restore seem failed.
163
164

BUGS

166       Report bugs to thomas@nchc.org.tw or http://partclone.org.
167
168       You can get support at http://partclone.org
169

SEE ALSO

171       partclone(8), partclone.chkimg(8), partclone.restore(8),
172       partclone.dd(8), partclone.info(8)
173

AUTHOR

175       Yu-Chin Tsai <thomas@nchc.org.tw>
176
178       Copyright © 2007 Yu-Chin Tsai
179
180       This manual page was written for the Debian system (and may be used by
181       others).
182
183       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
188       On Debian systems, the complete text of the GNU General Public License
189       can be found in /usr/share/common-licenses/GPL.
190
191
192
193
194partclone                         12/24/2015                      PARTCLONE(8)
Impressum