Changeset 1967 in MondoRescue for branches/2.2.6/mondo-doc

Timestamp:

May 29, 2008, 5:40:05 PM (18 years ago)

Author:

Bruno Cornec

Message:

• Remove all references to /root/images
• Fix the lack of support for options in mondorestore by copying what is done for mondoarchive and sharing the functions analyzing the cli (getopt usage)
• Review the now common handle_incoming_parameters to have it support correctly 2 modes (archiving and restoring)
• Update mondorestore man page to take in account the options supported now
• Replace mondorestore options --nuke, --interactive, with -Z nuke, -Z interactive ...

Location:

branches/2.2.6/mondo-doc

Files:

• mondoarchive.8 (modified) (2 diffs)
• mondorescue-howto.sgml (modified) (4 diffs)
• mondorestore.8 (modified) (2 diffs)

branches/2.2.6/mondo-doc/mondoarchive.8

@@ -186 +186 @@
 this is the directory where the ISO images are stored. For NFS users, this is
 the directory within the NFS mount where the backups are stored. The default
-for ISO and NFS is '/root/images/mondo'.
+for ISO and NFS is '/var/cache/mondo'.
 
 .TP
@@ -305 +305 @@
 .TP
 .BI "-e "
-Don't eject the CD or tape when backing up or restoring... unless cdrecord
-insists on it. If it does, well, tough. Sorry. :)
+Don't eject the CD or tape when backing up...
 
 .TP

branches/2.2.6/mondo-doc/mondorescue-howto.sgml

@@ -469 +469 @@
 <row>
 <entry>
-        bash# cd /root/images/mindi
+        bash# cd /var/cache/mindi
 
 </entry>
@@ -575 +575 @@
 <row>
 <entry>
-bash# cdrecord dev=0,0,0 speed=4 -eject -v /root/images/mindi/mindi.iso
+        bash# cdrecord dev=0,0,0 speed=4 -eject -v /var/cache/mindi/mindi.iso
 </entry>
 </row>
@@ -1255 +1255 @@
 Making 2880KB boot disk...........................mkfs.vfat 2.10 (22 Sep 2003)
 ... 2880 KB boot disks were created OK                          Done.
-In the directory '/root/images/mindi' you will find the images:-
+In the directory '/var/cache/mindi' you will find the images:-
    mindi-data-1.img    mindi-data-2.img    mindi-data-3.img    mindi-data-4.img    mindi-data-5.img mindi-root.1440.img
 Shall I make a bootable CD image? (y/n) y
@@ -1281 +1281 @@
 <row>
 <entry>
-        bash# cd /root/images/mindi
+        bash# cd /var/cache/mindi
 </entry>
 </row>

branches/2.2.6/mondo-doc/mondorestore.8

@@ -45 +45 @@
 .B prefix 
 to specify the name of your ISO images.
-By default, mondoarchive names images mondorescue-1.iso, mondorescue-2.iso, ...
+By default, mondorestore names images mondorescue-1.iso, mondorescue-2.iso, ...
 Using 
 .B -p machine
@@ -52 +52 @@
 
 .TP
+.BI "-i "
+Use ISO files (CD images) as restore media. This is good when having backed up your
+system to a spare hard drive. The
+.B -n
+switch is a wiser choice if you plan to restore from a remote filesystem.
+
+.TP
+.BI "-n " mount
+Use files residing on NFS partition as restore media.
+.I mount
+is the remote mount-point, e.g. '192.168.1.3:/home/nfs'
+for my file server. Please mount it before restoring/verifying.
+
+.TP
+.BI "-t "
+Use tape streamer as restore device and its tapes as restore media.
+
+.TP
+.BI "-U "
+Use a generic USB device as restore device. Use this if you want to read
+your backup from a USB key or USB disk.
+The USB device should be attached to the system ir order for this to work and
+its device name passed to the
+.BR \-d 
+option.
+
+.TP
+.BI "-u "
+Use a generic streaming device as restore device. Use this if you want to read
+your backup from a device that is not directly support by mondoarchive. This will
+get the data directly from a raw device.
+.B For experienced users only.
+
+.TP
+.BI "-E " "\*(lqpath ...\*(rq"
+Exclude path(s) from restore (future dev). The paths should be separated with a whitespace.
+/mnt/cdrom, /proc, /sys, /tmp). For example, if you are restoring up from an NFS mount but you
+do not want to restore some content, exclude it with that switch.
+
+.TP
+.BI "-I " "\*(lqpath ...\*(rq"
+Include paths(s) to retore (future dev). 
+
+.TP
+.BI "-J " "file"
+Specify an explicit list of files and directories to restore in a plain text file, one item
+(file or directory) per line. Beware that directories placed in that file are not managed recursively contrary to what is done with the -I option.
+
+.TP
+.BI "-d " "dev|dir"
+Specify the restore device (CD/tape/USB) or directory (NFS/ISO). For CD-R[W] drives,
+this is the SCSI node where the drive may be found, e.g. '0,1,0'. For tape
+users, this is the tape streamers /dev entry, e.g. '/dev/st0'. For USB users,
+this is the device name of your key or external disk. For ISO users,
+this is the directory where the ISO images are stored. For NFS users, this is
+the directory within the NFS mount where the backups are stored. The default
+for ISO and NFS is '/var/cache/mondo'.
+
+.TP
+.BI "-g "
+GUI mode. Without this switch, the screen output of mondorestore is text based.
+
+.TP
+.BI "-m "
+Manual (not self-retracting) CD trays are often found on laptops. If you are
+a laptop user, your CD burner has BurnProof technology or you experience 
+problems with mondo then please call mondorestore with this switch. 
+
+.TP
+.BI "-o "
+Use OBDR (One Button Disaster Recovery) type of tapes.
+By default, tapes are not bootable. With this flag, tape will be read as bootable tapes
+following the OBDR format.
+
+.TP
+.BI "-x " "'dev ...'"
+Specify non-Linux partitions which you want to restore (future dev).
+
+.TP
+.BI "-T " "path"
+Specify the full pathname of the tempdir, the directory where temporary files 
+are stored. 
+
+.TP
+.BI "-b "
+Specify the internal block size used by the tape drive. This is usually 32K but
+some drives just don't like that. They should but they don't. That's what
+happens when tape drive vendors don't talk to kernel driver writers. Try 512 or
+16384.
+
+.TP
+.BI "-e "
+Don't eject the CD or tape when restoring... 
+
+.TP
+.BI "-f " "device"
+Specify the drive on which your Master Boot Record lives. Usually, this is
+discovered automatically. (future dev)
+
+.TP
+.BI "-Q "
+Give more detailed information about the boot loader.
+
+.TP
 .BI "-K " "loglevel"
 Specify the loglevel. Use 99 for full debug. Standard debug level is 4.
+
+.TP
+.BI "-z "
+Use extended attributes and acl for each file and store them in the backup media. Use this option if you use SElinux e.g. but it will slow down backup and restore time of course.
 
 .SH DIAGNOSTICS