New command -assess_indev_features

xorriso/xorriso.texi

@@ -50,7 +50,7 @@
 @c man .\" First parameter, NAME, should be all caps
 @c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 @c man .\" other parameters are allowed: see man(7), man(1)
-@c man .TH XORRISO 1 "Version 1.5.5, Jun 02, 2022"
+@c man .TH XORRISO 1 "Version 1.5.5, Sep 18, 2022"
 @c man .\" Please adjust this date whenever revising the manpage.
 @c man .\"
 @c man .\" Some roff macros, for reference:
@@ -5082,6 +5082,50 @@ summary of drive state and medium content is printed.
 As further difference to -toc, this command does not emit FAILURE events
 if the desired drive is not acquired.
 @c man .TP
+@item -assess_indev_features "plain"|"cmd"|"as_mkisofs"|"replay"
+@kindex -assess_indev_features   shows filesystem features
+@cindex Filesytem features, show, -assess_indev_features
+Inspect the filesystem on -indev for the presence of Rock Ridge, Joliet, or
+ISO 9660:1999, and for traces of other write options which seem to have been
+used when the filesystem was created.
+@*
+Note that this command does not detect and report a possibly present HFS+ tree.
+@*
+Mode "cmd" lists xorriso commands which would activate the detected settings.
+@*
+Mode "as_mkisofs" lists options of the -as mkisofs emulation, which would
+activate those of the detected settings which are not default.
+@*
+Mode "replay" performs the commands which get listed by mode "cmd".
+@*
+Mode "plain" lists after a "Indev feature: " header name-value pairs as
+delivered by libisofs function iso_read_image_feature_named(). See libisofs.h.
+The other modes derive their output from this list. I.e. the sequence of
+commands from "cmd" follows the sequence of "plain".
+@*
+Not leading to "cmd" lines are:
+@*
+"size=" tells the number of 2048 byte blocks of the filesystem.
+@*
+"eltorito=1" tells that El Torito boot equipment was detected.
+@*
+"tree_loaded=" tells which tree was loaded by -indev:
+@*
+  0 = ISO 9660 , 1 = Joliet , 2 = ISO 9660:1999
+@*
+"tree_loaded_text=" tells the same by name: "ISO9660", "Joliet", "ISO9660:1999"
+@*
+"rr_loaded=1" tells that Rock Ridge information was loaded with the tree.
+@*
+"aaip=1" tells that AAIP information was detected (ACL, xattr, MD5, ...).
+@*
+"relaxed_vol_atts=1" tells that the volume attributes like -volid or
+-preparer_id bear characters outside the restricted character sets which are
+specified for them by ECMA-119.
+@*
+"rrip_1_10_px_ino=1" tells that with Rock Ridge 1.10 a PX entry was found which
+looks like from Rock Ridge 1.12.
+@c man .TP
 @item -mount_cmd drive entity id path
 @kindex -mount_cmd   composes mount command line
 @cindex Session, mount command line, -mount_cmd