-disk_dev_ino mode ino_only

libisoburn/trunk/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 "Feb 12, 2008"
+.TH XORRISO 1 "Feb 23, 2008"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -414,7 +414,10 @@ enhanced images and to restore them to xattr capable file systems.
 .SS
 .B Command processing:
 .br
-Commands are either actions or settings. They consist of a command word,
+Commands are either actions which happen immediately or settings which
+influence following actions. So their sequence does matter.
+.br
+Commands consist of a command word,
 followed by zero or more parameter words. If the list of parameter words
 is of variable length (indicated by "[...]" or "[***]") then it has to be
 terminated by either the \fBlist delimiter\fR, or the end of argument list,
@@ -667,10 +670,10 @@ 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\-disk_dev_ino\fR "on"|"off"
+\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 "isofs.di" and allow
-to substantially accelerate file comparison:
+to substantially accelerate file comparison.
 .br
 If device numbers and inode numbers of the disk filesystems are persistent
 and if no irregular alterations of timestamps or system clock happen,
@@ -678,6 +681,10 @@ then potential content changes can be detected without reading that content.
 File content change is assumed if any of mtime, ctime, device number or inode
 number have changed.
 .br
+Mode "ino_only" replaces the precondition that device numbers are stable by the
+precondition that mount points in the compared tree always lead to the
+same filesystems. Use this if mode "on" always sees all files changed.
+.br
 The speed advantage appears only if the loaded session was produced with
 -disk_dev_ino "on" too.
 .TP
@@ -1141,11 +1148,12 @@ match files which have resp. have not a non-trivial ACL.
 .br
 -has_xattr , -has_no_xattr
 .br
-match files which have resp. have not xattr name-value pairs.
+match files which have resp. have not xattr name-value pairs
+from user namespace.
 .br
 -has_aaip , -has_no_aaip
 .br
-match files which have ACL or xattr resp. have neither of them.
+match files which have ACL or any xattr resp. have neither of them.
 .br
 
 Default action is "echo",
@@ -3104,11 +3112,17 @@ This changes the directory trees /open_source_project and /personal_mail
 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.
+Only media with the expected volume id or blank media are accepted.
 Files with names matching *.o or *.swp get excluded explicitely.
 .br
-Only media with the expected volume id or blank media are accepted.
+\fB$\fR xorriso \\
 .br
-\fB$\fR xorriso -assert_volid 'PROJECTS_MAIL_*' FATAL \\
+ -acl on -xattr on -disk_dev_ino on \\
+.br
+ -assert_volid 'PROJECTS_MAIL_*' FATAL \\
 .br
  -dev /dev/sr0 \\
 .br
@@ -3129,8 +3143,10 @@ the old one.
 .br
 This makes sense if the full backup leaves substantial remaining capacity
 on media and if the expected changes are much smaller than the full backup.
-An update run will probably save no time but last longer than a full backup,
-unless option -disk_dev_ino "on" is used.
+.br
+Option -disk_dev_ino depends on stable device and inode numbers on disk.
+Without it, an update run will probably save no time but last longer than
+a full backup. Such a slow run might produce a smaller backup, though.
 .br 
 With \fBmount\fR option \fB-o "sbsector="\fR on Linux resp. \fB-s\fR on FreeBSD
 it is possible to access the session trees which represent the older backup