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
This commit is contained in:
@ -435,7 +435,19 @@ grew over the years.
|
||||
*-lfa_flags*. 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.
|
||||
disk. *XFS-style project ids* 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.
|
||||
'xorriso' records non-zero project ids of disk files if enabled by
|
||||
command *-projid*. 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.
|
||||
|
||||
|
||||
File: xorriso.info, Node: Processing, Next: Dialog, Prev: Extras, Up: Top
|
||||
@ -1022,6 +1034,40 @@ activate them only after image loading.
|
||||
-lfa_flags off:read:restore:restore_su_auto:restore_only_known
|
||||
-lfa_flags restore_mask=:restore_error=sorry:restore_single
|
||||
Use "default:on" to get default settings with enabled processing.
|
||||
-projid mode[:mode...]
|
||||
Enable, disable, or influence processing of XFS-style project ids.
|
||||
Mode "on" enables recording and restoring of project ids.
|
||||
Mode "off" disables it.
|
||||
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.
|
||||
Mode "map+" defines mappings of project id intervals in the ISO to
|
||||
project id intervals on disk when files get restored. The form is:
|
||||
|
||||
map+low_in_iso,high_in_iso=low_on_disk[,[high_on_disk]]
|
||||
"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
|
||||
low_on_disk + (project_id - low_in_iso)
|
||||
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".
|
||||
Multiple "map+" modes may be given with one or more -projid
|
||||
commands. E.g.:
|
||||
-projid on:map+1,1=11,11:map+1000,1999=2000,
|
||||
The first match in the list of mappings defines the mapping of a
|
||||
given project id in the ISO.
|
||||
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.:
|
||||
-projid map_test=1001
|
||||
Mode "default" discards all defined mappings and sets -projid to
|
||||
"off:no_restore_0".
|
||||
-md5 "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
|
||||
@ -1057,7 +1103,7 @@ activate them only after image loading.
|
||||
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 any -md5 on
|
||||
-hardlinks on -acl on -xattr any -md5 on -projid on
|
||||
and possibly:
|
||||
-lfa_flags default:on:import_only_settable
|
||||
-lfa_flags restore_mask=aAcdDijmPsStTux
|
||||
@ -1807,6 +1853,14 @@ whether they stem from the loaded image or were newly inserted.
|
||||
or else a SORRY event will happen. Files below the given
|
||||
directories will be skipped silently if their type is not suitable
|
||||
for -chattr.
|
||||
-set_projid 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.
|
||||
-set_projid_r number iso_rr_path [***]
|
||||
Like -projid but affecting also all files below the given
|
||||
directories.
|
||||
-alter_date type timestring iso_rr_path [***]
|
||||
Alter the date entries of files in the ISO image. type may be one
|
||||
of the following:
|
||||
@ -1953,6 +2007,8 @@ File: xorriso.info, Node: CmdFind, Next: Filter, Prev: Manip, Up: Commands
|
||||
-has_xattr :
|
||||
Matches files which have xattr name-value pairs from user
|
||||
namespace.
|
||||
-has_any_xattr :
|
||||
Matches files which have any xattr other than ACL.
|
||||
-has_aaip :
|
||||
Matches files which have ACL or any xattr.
|
||||
-has_lfa_flags flag_letters :
|
||||
@ -1973,8 +2029,9 @@ File: xorriso.info, Node: CmdFind, Next: Filter, Prev: Manip, Up: Commands
|
||||
matches any file. E.g. look for files which have 'i' or 'a'
|
||||
or both of them set:
|
||||
-has_some_lfa_flags_of ia
|
||||
-has_any_xattr :
|
||||
Matches files which have any xattr other than ACL.
|
||||
-has_projid number :
|
||||
Matches files which bear the given XFS-style project id
|
||||
number.
|
||||
-has_md5 :
|
||||
Matches data files which have MD5 checksums.
|
||||
-has_hfs_crtp creator type :
|
||||
@ -2172,11 +2229,21 @@ File: xorriso.info, Node: CmdFind, Next: Filter, Prev: Manip, Up: Commands
|
||||
lsattrd
|
||||
shows the Linux file attribute flags like command -lsattrd
|
||||
does.
|
||||
chattr
|
||||
chattr mode
|
||||
applies -chattr with the given mode. Other than command
|
||||
-chattr this silently skips any file which are not -type "dir"
|
||||
or "file".
|
||||
E.g.: -exec chattr +sDu -
|
||||
get_projid
|
||||
shows the XFS-style project id number.
|
||||
get_projid_minmax
|
||||
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.
|
||||
set_projid number
|
||||
applies -set_projid with the given number. Number range is 0
|
||||
to 4294967295.
|
||||
E.g.: -exec set_projid 1001 -
|
||||
get_md5
|
||||
prints the MD5 sum, if recorded, together with file path.
|
||||
check_md5
|
||||
@ -4303,6 +4370,13 @@ File: xorriso.info, Node: Navigate, Next: Verify, Prev: Inquiry, Up: Command
|
||||
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.
|
||||
-get_projid 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).
|
||||
-get_projid_r iso_rr_pattern [***]
|
||||
Like -get_projid but listing recursively the whole file trees
|
||||
underneath of directories.
|
||||
-du iso_rr_pattern [***]
|
||||
Recursively list size of directories and files in the ISO image
|
||||
which match one of the patterns. similar to shell command du -k.
|
||||
@ -4322,9 +4396,10 @@ File: xorriso.info, Node: Navigate, Next: Verify, Prev: Inquiry, Up: Command
|
||||
-findx accepts the same tests as -find, but only the following ones
|
||||
work like described with -find:
|
||||
-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, -use_pattern, -wholename
|
||||
-has_any_xattr, -has_lfa_flags, -has_some_lfa_flags_of,
|
||||
-has_projid, -has_xattr, -lba_range, -maxdepth, -mindepth, -name,
|
||||
-or_use_pattern, -prune, -size, -true, -type, -use_pattern,
|
||||
-wholename
|
||||
The others get defaulted to -false, because they are not applicable
|
||||
to disk files.
|
||||
Test -type accepts the same parameters as with -find. Additionally
|
||||
@ -4392,9 +4467,17 @@ File: xorriso.info, Node: Navigate, Next: Verify, Prev: Inquiry, Up: Command
|
||||
mode.
|
||||
E.g. -exec list_extattr e -
|
||||
lsattrd
|
||||
prints 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.
|
||||
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.
|
||||
get_projid
|
||||
prints the XFS-style project id number to the result channel.
|
||||
|
||||
get_projid_minmax
|
||||
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.
|
||||
-compare disk_path iso_rr_path
|
||||
Compare attributes and eventual data file content of a fileobject
|
||||
in the local filesystem with a file object in the ISO image. The
|
||||
@ -5080,7 +5163,11 @@ File: xorriso.info, Node: Scripting, Next: Frontend, Prev: Emulation, Up: Co
|
||||
-version
|
||||
Print program name and version, component versions, license.
|
||||
-list_extras 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.
|
||||
Code "all" lists all features and a headline. Other codes pick a
|
||||
single feature. Code "codes" lists them. They share names with
|
||||
related commands (see also there):
|
||||
@ -5090,6 +5177,8 @@ File: xorriso.info, Node: Scripting, Next: Frontend, Prev: Emulation, Up: Co
|
||||
EA.
|
||||
"lfa_flags" tells whether xorriso has an adapter for local Linux
|
||||
file attributes (see man 1 chattr).
|
||||
"projid" tells whether xorriso has an adapter for local XFS-style
|
||||
project ids.
|
||||
"jigdo" tells whether production of Jigdo files is possible.
|
||||
"zisofs" tells whether zisofs and built-in gzip filters are
|
||||
enabled.
|
||||
@ -5965,9 +6054,9 @@ Other programs which produce ISO 9660 images
|
||||
mkisofs(8), genisoimage(1)
|
||||
Other programs which burn sessions to optical media
|
||||
growisofs(1), cdrecord(1), wodim(1), cdrskin(1)
|
||||
ACL, xattr, Linux file attributes
|
||||
ACL, xattr, Linux file attributes, project ids
|
||||
getfacl(1), setfacl(1), getfattr(1), setfattr(1), lsattr(1),
|
||||
chattr(1)
|
||||
chattr(1), ext4(5), xfs_quota(8)
|
||||
MD5 checksums
|
||||
md5sum(1)
|
||||
On FreeBSD some commands differ:
|
||||
@ -6030,14 +6119,14 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
||||
|