.\"
.\" Copyright (c) 2001 Partition Image Team
.\" All rights reserved.
.\" 
.\" Permission is granted to copy, distribute and/or modify this
.\" document under the terms of the GNU Free Documentation License,
.\" Version 1.1 or any later version published by the Free Software
.\" Foundation; with no Invariant Sections, with no Front-Cover Texts, and
.\" with no Back-Cover Texts. 
.\"
.TH partimage 1 "24 June 2001"
.UC 1
.SH NAME
partimage \- back up and restore disk partitions
.SH SYNOPSIS
.B partimage
.RB [ " \-bcdehimMnoSvwy " ]
.RB [ \-B\ 'pattern\ response\ string' ]
.RB [ \-z\ compresslevel ]
.RB [ \-V\ volumesize ]
.RB [ \-f\ actionatend ]
.RB [ \-s\ server ]
.RB [ \-p\ port ]
.RB [ \-a\ mountoptions ]
.RB [ \-g\ loglevel ]
[ 
.I "save"
.I "device"
.I "image_file"
]
.br 
.B partimage
.RB [ " \-bcdehimMnoSvwy " ]
.RB [ \-B\ 'pattern\ response\ string' ]
.RB [ \-z\ compresslevel ]
.RB [ \-V\ volumesize ]
.RB [ \-f\ actionatend ]
.RB [ \-s\ server ]
.RB [ \-p\ port ]
.RB [ \-a\ mountoptions ]
.RB [ \-g\ loglevel ]
[ 
.I "restore"
.I "device"
.I "image_file/'stdin'"
]
.br 
.B partimage
[
.I "restmbr"
.I "image_file"
]
.br 
.B partimage
[
.I "imginfo"
.I "image_file"
]
.SH DESCRIPTION
\fIpartimage\fR backs up disk partitions into image files and restores them.
.SH OPTIONS
.TP
.B \-z val,   --compress val
Set image file compression level:
.br
val=0: don't compress: very fast but very big image file
.br
val=1: compress using gzip: fast and small image file (default)
.br
val=2: compress using bzip2: very slow and very small image file
.TP
.B \-c,   --nocheck
Don't check the partition before saving.
.TP
.B \-o,   --overwrite
Overwrite the existing image file without confirmation.
.TP
.B \-d,   --nodesc
Don't ask any description for the image file.
.TP 
.B \-V vol,  --volume vol
Split image into multiple volumes files. vol will be the size in KB of volumes.
.TP 
.B \-w,   --waitvol
Wait for a confirmation after each volume change.
.TP 
.B \-e,   --erase
Erase empty blocks on restore with zero bytes.
.TP 
.B \-m,   --allowmnt
Don't fail if the partition is mounted. Dangerous!
.TP 
.B \-M,   --nombr
Don't create a backup of the MBR (Mast Boot Record) in the image file.
.TP 
.B \-h,   --help
Show help.
.TP 
.B \-v,   --version
Show version.
.TP 
.B \-f action,  --finish action
Action to do if finished successfully:
.br
action=0: wait (do nothing)
.br
action=1: halt (power off the computer)
.br
action=2: reboot (restart the computer)
.br
action=3: quit
.TP 
.B \-b,   --batch
batch mode: the GUI won't wait for an user action.
.TP
.B \-B 'pattern response string',  --fully-batch 'pattern response string'
full batch mode: the GUI is not being displayed. Rather status messages
are displayed as normal text.
The pattern response string has the following format:
.br
.B \'<glob-pattern>=<response-value>;...\'
.br
where the glob pattern is matched against the string
.B <window-title>/<message-text>
of the message dialogue box to be displayed. For dialog boxes with
buttons in the window, the <response> must be the exact button text.
The pattern response string usually needs to be quoted as above.
.TP 
.B \-y,   --nosync
Don't synchronize the disks at the end of the operation. Dangerous!
.TP 
.B \-s addr,   --server addr
Give partimaged server's ip address.
.TP
.B \-p port,   --port port
Give partimaged server's listening port.
.TP 
.B \-g debuglevel,   --debug debuglevel
Set the debug level to debuglevel (defaults to 1).
.TP 
.B \-n,   --nossl
Disable SSL in network mode.
.TP 
.B \-S,   --simulate
Simulation of restoration mode.
.TP 
.B \-a str, --automnt str
Automatic mount with X options. Read the doc for more details.

.SH EXAMPLE
partimage -z1 -o -d save /dev/hda12 /mnt/backup/redhat-6.2.partimg.gz
.br
partimage -z1 -om save /dev/hda9 /mnt/backup/win95-osr2.partimg.gz
.br
partimage restore /dev/hda13 /mnt/backup/suse-6.4.partimg
.br
cat debian.partimg.000 debian.partimg.001 | partimage restore /dev/hda1 stdin
.br
partimage restmbr /mnt/backup/debian-potato-2.2.partimg.bz2
.br
partimage imginfo /mnt/backup/debian-potato-2.2.partimg.bz2
.SH SEE ALSO
.BR partimaged(8)
.SH DIAGNOSTICS
You can read options set at compile time running 'partimage -i'.
.PP
When using batchmode, exit status is normaly 0.
.SH CAVEATS
For now, only ext2fs, FAT16, FAT32, NTFS, HPFS, JFS, XFS, reiserfs are supported.
.PP
FAT12 will never be supported.
.SH BUGS
Refer to BUGS file to read them.
.SH AUTHOR
.nf
Franck Ladurelle <ladurelf@partimage.org>