New -lfa_flags modes "import_non_settable", "import_only_settable"

This commit is contained in:
2024-08-27 11:01:37 +02:00
parent a40a8a16e0
commit cdd17e814d
9 changed files with 180 additions and 98 deletions

View File

@ -9,7 +9,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 "Version 1.5.7, Aug 07, 2024"
.TH XORRISO 1 "Version 1.5.7, Aug 27, 2024"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -1082,13 +1082,23 @@ any file attributes, run before \-commit :
.br
\-chattr_r \-\-remove\-lfa\-flags / \-\-
.br
Mode "import_non_settable" enables obtaining of non\-settable attributes from
disk and attaching of attributes to files in the emerging ISO image even if
all attribute flags are zero.
.br
Mode "import_only_settable" causes non\-settable attributes ("eEhINVZ") to be
ignored when file objects get read from disk. If the remaining attribute flags
are all zero, then no attribute information gets attached to the file in the
ISO. This saves storage and eases finding of non\-trivial attributes in the
ISO image.
.br
Mode "restore" enables restoring of attributes when their file gets restored
and comparing them during comparisons between files on disk and in ISO.
Several modes below modify the behavior during restoring of attributes.
.br
Mode "no_restore" disables restoring of attributes.
.br
Mode "restore_su" enables restoring of the attributes "iaj" which are only
Mode "restore_su" enables restoring of the attributes "aij" which are only
changeable by the bearer of superuser capabilities. "no_restore_su" disables
restoring of these attributes. "restore_su_auto" enables it only if the
effective user id is 0.
@ -1110,11 +1120,19 @@ like "off" does. Example:
.br
\-lfa_flags restore_mask=SdCiaj
.br
Mode "restore_error=" sets the behavior for the event that restoring of
attribute flags to the local filesystem fails. Available are the
keyword "silent" and the severities from "all" to "fatal".
"silent" and severity "all" suppress any error messages and abort
considerations caused by restore attemps of attribute flags. Else the error
message is issued with the given severity. Then it depends on the setting
of command \-abort_on whether restoring goes on or gets aborted.
.br
Mode "default" reinstates the default settings:
.br
\-lfa_flags off:read:restore:restore_su_auto:restore_only_known
.br
\-lfa_flags restore_mask=
\-lfa_flags restore_mask=:restore_error=sorry
.br
Use "default:on" to get default settings with enabled processing.
.TP
@ -1789,7 +1807,7 @@ and re\-enables \-disk_pattern expansion.
.TP
\fB\-overwrite\fR "on"|"nondir"|"off"
Allow or disallow overwriting of existing files in the
ISO image by files with the same name.
ISO image or in the local filesystem by files with the same name.
.br
With setting "off", name collisions with at least one non\-directory file
cause FAILURE events. Collisions of two directories lead to merging of their
@ -1800,7 +1818,8 @@ existing file types get treated with \-rm before the new file gets added.
Setting "on" enables automatic \-rm_r. I.e. a non\-directory can replace an
existing directory and all its subordinates.
.br
If restoring of files is enabled, then the overwrite rule applies to the
If restoring of files to the disk filesystem is enabled by \-osirrox, then the
overwrite rule applies to the
target file objects on disk as well, but "on" is downgraded to "nondir".
.TP
\fB\-split_size\fR number["k"|"m"]
@ -4524,6 +4543,8 @@ or an important resource failed unexpectedly.
.br
"DEBUG" A message which would only interest the program developers.
.br
"ERRFILE" A filename for the \-errfile_log if it is enabled.
.br
"ALL" The lower end of the severity spectrum.
.TP
\fB\-abort_on\fR severity