libburnia/libisoburn
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

New commands -projid, -get_projid, -get_projid_r, -set_projid, -set_projid_r, -find test -has_projid, -find actions get_projid, set_projid, get_projid_minmax

Browse Source
This commit is contained in:
Thomas Schmitt
2024-11-03 20:04:54 +01:00
parent 923bfa0be9
commit 32bfa95973
25 changed files with 1168 additions and 214 deletions
Download Patch File Download Diff File Expand all files Collapse all files

128
xorriso/xorriso.1
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, Oct 10, 2024"
.TH XORRISO 1 "Version 1.5.7, Nov 01, 2024"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -502,6 +502,19 @@ number grew over the years.
\fB\-lfa_flags\fR. Its command \-lsattr lists 22 flags the same way as the
program lsattr does. They can be set by xorriso command \-chattr and can be
enabled by \-lfa_flags for restoring when their files get restored to disk.
.PP
\fBXFS\-style project ids\fR are numbers which define the members of file
object groups, called projects. They can be set by programs chattr(1) and
xfs_quota(8) and reported by programs lsattr(1) and xfs_quota(8).
The files of a project can share quotas which limit their usage of filesystem
resources. This is possible in XFS and in specially prepared and mounted ext4
filesystems. Project id 0 means that the file is not member of any project.
.br
\fBxorriso\fR records non\-zero project ids of disk files if enabled by
command \fB\-projid\fR. Command \-get_projid lists the project ids of files.
They can be set by command \-set_projid and get restored to disk if enabled
by \-projid. Usually project id 0 is not set to restored disk files, so that
they may get the project id of their parent disk directory.
.SS
.B Command processing:
.br
@ -1145,6 +1158,51 @@ Mode "default" reinstates the default settings:
.br
Use "default:on" to get default settings with enabled processing.
.TP
\fB\-projid\fR mode[:mode...]
Enable, disable, or influence processing of XFS\-style project ids.
.br
Mode "on" enables recording and restoring of project ids.
.br
Mode "off" disables it.
.br
Mode "restore_0" enables restoring of project id 0 when files get extracted
to disk. Default is "no_restore_0" which leaves the decision about the project
id to the local filesystem, if the file has project id 0 in the ISO filesystem.
.br
Mode "map+" defines mappings of project id intervals in the ISO to project id
intervals on disk when files get restored. The form is:
.br
map+low_in_iso,high_in_iso=low_on_disk[,[high_on_disk]]
.br
"low_in_iso" and "high_in_iso" define the number interval from which the
mapping happens at restore time. "low_on_disk" is the mapping result of
"low_in_iso". Project id numbers up to "high_in_iso" get mapped to
.br
low_on_disk + (project_id \- low_in_iso)
.br
If the resulting number is higher than "high_on_disk", then it gets mapped to
"high_on_disk". "low_on_disk" without following comma means
"low_on_disk,low_on_disk" which maps the whole "_in_iso" interval to the single
number "low_on_disk". "low_on_disk," with no following number means
"low_on_disk,4294967295".
.br
Multiple "map+" modes may be given with one or more \-projid commands.
E.g.:
.br
\-projid on:map+1,1=11,11:map+1000,1999=2000,
.br
The first match in the list of mappings defines the mapping of a given
project id in the ISO.
.br
Pseudo\-mode "map_test=" can be used to learn the current mapping
of the given project number. It immediately reports the mapping result on
result channel and does not change the current \-projid settings. E.g.:
.br
\-projid map_test=1001
.br
Mode "default" discards all defined mappings and sets \-projid to
"off:no_restore_0".
.TP
\fB\-md5\fR "on"|"all"|"off"|"load_check_off"
Enable or disable processing of MD5 checksums for the overall session and for
each single data file. If enabled then images with checksum tags get loaded
@ -1185,7 +1243,7 @@ actions get_md5, check_md5, and via \-check_media.
Enable all extra features which help to produce or to restore backups with
highest fidelity of file properties. Currently this is a shortcut for:
.br
\-hardlinks on \-acl on \-xattr any \-md5 on
\-hardlinks on \-acl on \-xattr any \-md5 on \-projid on
.br
and possibly:
.br
@ -2092,6 +2150,14 @@ to be directories or regular data files or else a SORRY event will happen.
Files below the given directories will be skipped silently if their type is
not suitable for \-chattr.
.TP
\fB\-set_projid\fR number iso_rr_path [***]
Set the XFS\-style project ids like programs xfs_quota(8) or chattr(1)
would do to disk files. The permissible number range is 0 to 4294967295.
0 means that the file does not belong to any project.
.TP
\fB\-set_projid_r\fR number iso_rr_path [***]
Like \-projid but affecting also all files below the given directories.
.TP
\fB\-alter_date\fR type timestring iso_rr_path [***]
Alter the date entries of files in the ISO image. type may be one of
the following:
@ -2279,6 +2345,9 @@ Matches files which have a non\-trivial ACL.
\fB\-has_xattr\fR :
Matches files which have xattr name\-value pairs from user namespace.
.br
\fB\-has_any_xattr\fR :
Matches files which have any xattr other than ACL.
.br
\fB\-has_aaip\fR :
Matches files which have ACL or any xattr.
.br
@ -2301,8 +2370,8 @@ E.g. look for files which have 'i' or 'a' or both of them set:
.br
\-has_some_lfa_flags_of ia
.br
\fB\-has_any_xattr\fR :
Matches files which have any xattr other than ACL.
\fB\-has_projid\fR number :
Matches files which bear the given XFS\-style project id number.
.br
\fB\-has_md5\fR :
Matches data files which have MD5 checksums.
@ -2536,12 +2605,24 @@ Command \-backslash_codes does not affect the output.
\fBlsattrd\fR
shows the Linux file attribute flags like command \-lsattrd does.
.br
\fBchattr\fR
\fBchattr\fR mode
applies \-chattr with the given mode. Other than command \-chattr this silently
skips any file which are not \-type "dir" or "file".
.br
E.g.: \-exec chattr +sDu \-\-
.br
\fBget_projid\fR
shows the XFS\-style project id number.
.br
\fBget_projid_minmax\fR
shows at the end of the \-find run the minimal and the maximal XFS\-style
project id numbers among the files which were matched by the find tests.
.br
\fBset_projid\fR number
applies \-set_projid with the given number. Number range is 0 to 4294967295.
.br
E.g.: \-exec set_projid 1001 \-\-
.br
\fBget_md5\fR
prints the MD5 sum, if recorded, together with file path.
.br
@ -5119,6 +5200,14 @@ attributes attached. In this case all flags will be shown as '\-'.
Like \-lsattr but listing the directory attributes if the iso_rr_path leads to
a directory, rather than the attributes of the files in the directory.
.TP
\fB\-get_projid\fR iso_rr_pattern [***]
Print the XFS\-style project ids of the given file objects. On disk this
information can be inspected by programs lsattr(1) or xfs_quota(8).
.TP
\fB\-get_projid_r\fR iso_rr_pattern [***]
Like \-get_projid but listing recursively the whole file trees underneath of
directories.
.TP
\fB\-du\fR iso_rr_pattern [***]
Recursively list size of directories and files in the ISO image
which match one of the patterns.
@ -5147,8 +5236,8 @@ like described with \-find:
.br
\-bad_outname, \-decision, \-disk_name, \-disk_path, \-has_acl,
\-has_any_xattr, \-has_lfa_flags, \-has_some_lfa_flags_of,
\-has_xattr, \-lba_range, \-maxdepth, \-mindepth, \-name,
\-or_use_pattern, \-prune, \-size, \-true, \-type,
\-has_projid, \-has_xattr, \-lba_range, \-maxdepth, \-mindepth,
\-name, \-or_use_pattern, \-prune, \-size, \-true, \-type,
\-use_pattern, \-wholename
.br
The others get defaulted to \-false, because they are not applicable to disk
@ -5230,9 +5319,17 @@ See \-find for a description of parameter mode.
E.g. \-exec list_extattr e \-\-
.br
\fBlsattrd\fR
prints the Linux file attribute flags like command \-lsattrd does.
prints to the result channel the Linux file attribute flags like
command \-lsattrd does.
This shows non\-settable flags, too, even if they are to be ignored by the
setting of command \-lfa_flags.
.br
\fBget_projid\fR
prints the XFS\-style project id number to the result channel.
.br
\fBget_projid_minmax\fR
prints at the end of the \-findx run the minimal and the maximal XFS\-style
project id numbers among the files which were matched by the find tests.
.TP
\fB\-compare\fR disk_path iso_rr_path
Compare attributes and eventual data file content of a fileobject in the
@ -6041,7 +6138,12 @@ Print helptext.
Print program name and version, component versions, license.
.TP
\fB\-list_extras\fR code
Tell whether certain extra features were enabled at compile time.
Tell whether certain extra features were enabled at compile time and the
environment provided the necessary system interfaces.
Application of the enabled features might fail at run time because the system
does not provide the necessary interfaces or the involved local filesystem
does not provide the desired feature.
.br
Code "all" lists all features and a headline.
Other codes pick a single feature.
Code "codes" lists them. They share names with related commands
@ -6054,6 +6156,8 @@ Code "codes" lists them. They share names with related commands
"lfa_flags" tells whether xorriso has an adapter for local Linux file
attributes (see man 1 chattr).
.br
"projid" tells whether xorriso has an adapter for local XFS\-style project ids.
.br
"jigdo" tells whether production of Jigdo files is possible.
.br
"zisofs" tells whether zisofs and built\-in gzip filters are enabled.
@ -7063,13 +7167,15 @@ Other programs which burn sessions to optical media
.BR wodim(1),
.BR cdrskin(1)
.TP
ACL, xattr, Linux file attributes
ACL, xattr, Linux file attributes, project ids
.BR getfacl(1),
.BR setfacl(1),
.BR getfattr(1),
.BR setfattr(1),
.BR lsattr(1),
.BR chattr(1)
.BR chattr(1),
.BR ext4(5),
.BR xfs_quota(8)
.TP
MD5 checksums
.BR md5sum(1)