Enabling non-user xattr namespaces with -getfattr and -setfattr

This commit is contained in:
2017-11-15 11:10:33 +01:00
parent 3eee0607ec
commit 3794753662
7 changed files with 253 additions and 157 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.4.9, Oct 10, 2017"
.TH XORRISO 1 "Version 1.4.9, Nov 12, 2017"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -468,7 +468,7 @@ able to represent them and \fBxorriso\fR can record and restore them.
.br
But be aware that pairs with names of non\-user namespaces are not necessarily
portable between operating systems and not even between filesystems.
I.e. only those which begin with "user.", like "user.x" or "user.whatever",
Only those which begin with "user.", like "user.x" or "user.whatever",
can unconditionally be expected to be appropriate on other machines and disks.
Processing of other xattr may need administrator privileges.
.br
@ -947,7 +947,9 @@ Mode "any" processes attributes of all namespaces. This might need adminstrator
privileges, even if the owner of the disk file tries to read or write the
attributes.
.br
Note that xattr from namespace "isofs." are never restored to disk.
Note that xattr from namespace "isofs." are never read from disk or restored
to disk. Further it is not possible to set them via xorriso xattr manipulation
commands.
.TP
\fB\-md5\fR "on"|"all"|"off"|"load_check_off"
Enable or disable processing of MD5 checksums for the overall session and for
@ -1748,8 +1750,11 @@ then all user namespace
xattr of the given iso_rr_paths get deleted. In case of deletion, value must
be an empty text.
.br
Only names from the user namespace are allowed. I.e. a name has to begin with
"user.", like "user.x" or "user.whatever".
Which names are permissible depends on the setting of command \-xattr.
"on" or "user" restricts them to namespace "user". I.e. a name has to look
like "user.x" or "user.whatever".
.br
\-xattr setting "any" enables names from all namespaces except "isofs".
.br
Values and names undergo the normal input processing of \fBxorriso\fR.
See also command \-backslash_codes. Other than with command \-setfattr_list,
@ -1759,9 +1764,12 @@ the byte value 0 cannot be expressed via \-setfattr.
Like \-setfattr but affecting all files below eventual directories.
.TP
\fB\-setfattr_list\fR disk_path
Read the output of \-getfattr_r or shell command getfattr \-Rd and apply it to
the iso_rr_paths as given in lines beginning with "# file:". All previously
existing user space xattr of the given iso_rr_paths will be deleted.
Read the output format of \-getfattr_r or shell command getfattr \-Rd and apply
it to the iso_rr_paths as given in lines beginning with "# file:".
All previously existing xattr of the acceptable namespaces will be deleted
before the new xattr get attached. The set of acceptable names depends on the
setting of command \-xattr.
.br
If disk_path is "\-" then lines are read from standard input.
.br
Since \-getfattr and getfattr \-Rd strip leading "/" from file paths, the setting
@ -1773,8 +1781,7 @@ the pending iso_rr_path. Other input lines must have the form
.br
name="value"
.br
Name must be from user namespace. I.e. user.xyz where xyz should consist of
printable characters only. The separator "=" is not allowed in names.
The separator "=" is not allowed in names.
Value may contain any kind of bytes. It must be in quotes. Trailing
whitespace after the end quote will be ignored. Non\-printables bytes and quotes
must be represented as \\XYZ by their octal 8\-bit code XYZ.
@ -2150,8 +2157,9 @@ ACL is given in text form as defined with command \-setfacl.
E.g.: \-exec setfacl u:lisa:rw,u::rw,g::r,o::\-,m::rw \-\-
.br
\fBgetfattr\fR
prints xattr name\-value pairs from user namespace
to the result channel.
prints xattr name\-value pairs to the result channel. The choice of namespaces
depends on the setting of command \-xattr: "on" or "user" restricts it to the
namespace "user", "any" only omits namespace "isofs".
.br
\fBget_any_xattr\fR
prints xattr name\-value pairs from any namespace
@ -4351,9 +4359,12 @@ directories.
\fB\-getfattr\fR iso_rr_pattern [***]
Print the xattr of the given files in the ISO image.
If a file has no such xattr then noting is printed for it.
The choice of namespaces
depends on the setting of command \-xattr: "on" or "user" restricts it to
namespace "user", "any" only omits namespace "isofs".
.TP
\fB\-getfattr_r\fR iso_rr_pattern [***]
Like \-gefattr but listing recursively the whole file trees underneath eventual
Like \-gefattr but listing recursively the whole file trees underneath of
directories.
.TP
\fB\-du\fR iso_rr_pattern [***]