New option -for_backup as shortcut for -acl -xattr -hardlinks

xorriso/xorriso.1

@@ -2,7 +2,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH XORRISO 1 "May 26, 2009"
+.TH XORRISO 1 "May 29, 2009"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -683,7 +683,7 @@ Whether these numbers are respected at mount time depends on the operating
 system.
 .br
 xorriso commands which extract files from an ISO image try to restore files
-with the same inode number as hardlinks. This applies only to files which
+with the same inode number as hard links. This applies only to files which
 get extracted during execution of that same command. A large number of
 hardlink families may exhaust -temp_mem_limit if not -osirrox option
 "sort_lba_on" is in effect.
@@ -706,6 +706,11 @@ Enable or disable processing of xattr attributes in user namespace.
 If enabled, then xorriso will handle xattr similar to ACL.
 See also options -getfattr, -setfattr and above paragraph about xattr.
 .TP
+\fB\-for_backup\fR
+Enable all extra features which help to produce or to restore backups with
+highest fidelity of file properties.
+Currently this is a shortcut for: -hardlinks on -acl on -xattr on .
+.TP
 \fB\-disk_dev_ino\fR "on"|"ino_only"|"off"
 Enable or disable processing of recorded file identification numbers
 (dev_t and ino_t). They are eventually stored as xattr and allow
@@ -2622,7 +2627,7 @@ are owned by the effective user who runs xorriso. This happens by temporarily
 granting rwx permission to the owner.
 .br
 Option "sort_lba_on" may improve read performance with optical drives. It
-allows to restore large numbers of hardlinks without exhausting
+allows to restore large numbers of hard links without exhausting
 -temp_mem_limit. It does not preserve directory mtime and it needs
 -osirrox option auto_chmod_on in order to extract directories which offer no
 write permission. Default is "sort_lba_off".
@@ -2750,7 +2755,8 @@ arguments or if other start arguments pointed the output drive to
 standard output.
 .br
 Not original mkisofs options are --quoted_path_list (see -quoted_path_list),
-isolinux_mbr= (see -boot_image isolinux isohybrid=), --acl (see -acl "on"),
+isolinux_mbr= (see -boot_image isolinux isohybrid=),
+--hardlinks (see -hardlinks "on") --acl (see -acl "on"),
 --xattr (see -xattr "on").
 .br
 Personalites "\fBxorrisofs\fR", "\fBgenisoimage\fR", and "\fBgenisofs\fR"
@@ -2904,7 +2910,7 @@ Mode "on" is
 \fB\-temp_mem_limit\fR number["k"|"m"]
 Set the maximum size of temporary memory to be used for image dependent
 buffering. Currently this applies to pattern expansion, LBA sorting,
-restoring of hardlinks.
+restoring of hard links.
 .br
 Default is 16m = 16 MiB, minimum 64k = 64 kiB, maximum 1024m = 1 GiB.
 .TP
@@ -3325,14 +3331,14 @@ in the ISO image so that they become exact copies of their disk counterparts.
 ISO file objects get created, deleted or get their attributes adjusted
 accordingly.
 .br
-ACL and xattr will be recorded. Accelerated comparison is enabled at the
-expense of potentially larger backup size.
+ACL, xattr and hard links will be recorded. Accelerated comparison is enabled
+at the expense of potentially larger backup size.
 Only media with the expected volume id or blank media are accepted.
 Files with names matching *.o or *.swp get excluded explicitely.
 .br
 \fB$\fR xorriso \\
 .br
- -acl on -xattr on -disk_dev_ino on \\
+ -for_backup -disk_dev_ino on \\
 .br
  -assert_volid 'PROJECTS_MAIL_*' FATAL \\
 .br
@@ -3402,9 +3408,10 @@ First check which backup sessions are on the media:
 \fB$\fR xorriso -outdev /dev/sr0 -toc
 .br
 Then load the desired session and copy the file trees to disk.
+Enable restoring of ACL, xattr and hard links.
 Avoid to eventually create /home/thomas/restored without rwx-permission.
 .br
-\fB$\fR xorriso -acl on -xattr on \\
+\fB$\fR xorriso -for_backup \\
 .br
  -load volid 'PROJECTS_MAIL_2008_06_19*' \\
 .br