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. Normally, 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. Normally, 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. This is a
90           human readable file in which + marks used block areas and ? marks
91           free areas.
92
93       --offset_domain=X
94           Add X (in bytes) to all positions reported in the domain log file
95
96       --restore_raw_file
97           Creating special raw file for loop device.
98
99       -L FILE, --logfile FILE
100           put special path to record partclone log information.(default
101           /var/log/partclone.log)
102
103       -R, --rescue
104           Continue after disk read errors.
105
106       -C, --no_check
107           Don't check device size and free space.
108
109       -N, --ncurses
110           Using Ncurses Text User Interface.
111
112       -X, --dialog
113           Output message as Dialog Format.
114
115       -I, --ignore_fschk
116           Ignore filesystem check.
117
118       --ignore_crc
119           Ignore crc check error.
120
121       -F, --force
122           Force progress.
123
124       -f sec, --UI-fresh sec
125           put special second to different interval.
126
127       -z size, --buffer_size size
128           Read/write buffer size (default: 1048576)
129
130       -q, --quiet
131           Disable progress message.
132
133       -dlevel, --debug level
134           Set the debug level [1|2|3]
135
136       -h, --help
137           Show summary of options.
138
139       -v, --version
140           Show version of program.
141

FILES

143       /var/log/partclone.log
144           The log file of partclone
145

EXAMPLES

147            clone /dev/hda1 to hda1.img and display debug information.
148              partclone.ext3 -c -d -s /dev/hda1 -o hda1.img
149
150            restore /dev/hda1 from hda1.img and display debug information.
151              partclone.extfs -r -d -s hda1.img -o /dev/hda1
152
153            restore image from clonezilla(split, gzip,) with stdin source
154              cat sda1.ext3-ptcl-img.gz.a* | gunzip -c | partclone.ext3 -d -r -s - -o /dev/sda1
155
156

DIAGNOSTICS

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

BUGS

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

SEE ALSO

173       partclone(8), partclone.chkimg(8), partclone.restore(8),
174       partclone.dd(8), partclone.info(8)
175

AUTHOR

177       Yu-Chin Tsai <thomas@nchc.org.tw>
178
180       Copyright © 2007 Yu-Chin Tsai
181
182       This manual page was written for the Debian system (and may be used by
183       others).
184
185       Permission is granted to copy, distribute and/or modify this document
186       under the terms of the GNU General Public License, Version 2 or (at
187       your option) any later version published by the Free Software
188       Foundation.
189
190       On Debian systems, the complete text of the GNU General Public License
191       can be found in /usr/share/common-licenses/GPL.
192
193
194
195
196partclone                         03/18/2022                      PARTCLONE(8)
Impressum