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

FILES

145       /var/log/partclone.log
146           The log file of partclone
147

EXAMPLES

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

DIAGNOSTICS

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

BUGS

170       Report bugs to thomas@nchc.org.tw or http://partclone.org.
171
172       You can get support at http://partclone.org
173

SEE ALSO

175       partclone(8), partclone.chkimg(8), partclone.restore(8),
176       partclone.dd(8), partclone.info(8)
177

AUTHOR

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