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
29       (APPLE MAC OS), UFS2 (FreeBSD), VMFS (VMWare Vsphere) and MINIX
30       (MINIX3).
31
32       All partclone utils could be run like partclone.[fstype] is very
33       smiliar fsck or mkfs. For example, for backup/restore hfsplus, just run
34       partclone.hfsp
35
36                  File System             partclone.[fstype]
37
38                  btrfs                   partclone.btrfs
39                  ext2, ext3, ext4        partclone.[ext2|ext3|ext4]
40                  reiserfs 3.5            partclone.reiserfs
41                  reiser 4                partclone.reiser4
42                  xfs                     partclone.xfs
43                  ufs | ufs2              partclone.ufs
44                  jfs                     partclone.jfs
45                  hfs plusfs              partclone.[hfs+|hfsplus]
46                  vmfs                    partclone.vmfs
47                  ntfs                    partclone.ntfs
48                  fat12, fat16, fat32     partclone.[fat12|fat16|fat32]
49                  exfat                   partclone.exfat
50                  minix                   partclone.minix
51                  f2fs                    partclone.f2fs
52                  nilfs2                  partclone.nilfs2
53
54

OPTIONS

56       The program follows the usual GNU command line syntax, with long
57       options starting with two dashes (`-'). A summary of options is
58       included below.
59
60       -s FILE, --source FILE
61           Source FILE. The FILE could be a image file (made by partclone) or
62           device depend on your action. Normally, backup source is device,
63           restore source is image file.
64
65           Receving data from pipe line is supported ONLY for restoring, just
66           ignore -s option or use '-' means receive data from stdin.
67
68       -o FILE, --output FILE
69           Output FILE. The FILE could be a image file (partclone will
70           generate) or device depend on your action. Normally, backup output
71           to image file and restore output to device.
72
73           Sending data to pipe line is also supported ONLY for back-up, just
74           ignore -o option or use '-' means send data to stdout.
75
76       -O FILE, --overwrite FILE
77           Overwrite FILE, overwriting if exists.
78
79       -c, --clone
80           Save partition to the special image format.
81
82       -r, --restore
83           Restore partition from the special image format.
84
85       -b, --dev-to-dev
86           Local device to device copy on-the-fly, source and output both are
87           device.
88
89       -D, --domain
90           Create GNU Ddrescue domain log file from source device. This is a
91           human readable file in which + marks used block areas and ? marks
92           free areas.
93
94       --offset_domain=X
95           Add X (in bytes) to all positions reported in the domain log file
96
97       --restore_raw_file
98           Creating special raw file for loop device.
99
100       -L FILE, --logfile FILE
101           put special path to record partclone log information. (default
102           /var/log/partclone.log)
103
104       -R, --rescue
105           Continue after disk read errors.
106
107       -C, --no_check
108           Don't check device size and free space.
109
110       -N, --ncurses
111           Using Ncurses Text User Interface.
112
113       -X, --dialog
114           Output message as Dialog Format.
115
116       -I, --ignore_fschk
117           Ignore filesystem check.
118
119       --ignore_crc
120           Ignore crc check error.
121
122       -F, --force
123           Force progress.
124
125       -f sec, --UI-fresh sec
126           put special second to different interval.
127
128       -z size, --buffer_size size
129           Read/write buffer size (default: 1048576)
130
131       -q, --quiet
132           Disable progress message.
133
134       -dlevel, --debug level
135           Set the debug level [1|2|3]
136
137       -h, --help
138           Show summary of options.
139
140       -v, --version
141           Show version of program.
142

FILES

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

EXAMPLES

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

DIAGNOSTICS

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

BUGS

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

SEE ALSO

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

AUTHOR

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