Updated xorriso man page
This commit is contained in:
parent
89c6796d91
commit
625ca056c4
@ -2,7 +2,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 "Feb 02, 2008"
|
||||
.TH XORRISO 1 "Feb 12, 2008"
|
||||
.\" Please adjust this date whenever revising the manpage.
|
||||
.\"
|
||||
.\" Some roff macros, for reference:
|
||||
@ -83,7 +83,7 @@ Creating, Growing, Modifying, Blind Growing
|
||||
.br
|
||||
Libburn drives
|
||||
.br
|
||||
Rock Ridge, POSIX, X/Open, and El Torito
|
||||
Rock Ridge, POSIX, X/Open, El Torito, ACL, xattr
|
||||
.br
|
||||
Command processing
|
||||
.br
|
||||
@ -346,7 +346,7 @@ One may prepend "mmc:" to a path to surely disallow any automatic "stdio:".
|
||||
By option -drive_class one may ban certain paths or allow access without
|
||||
prefix "stdio:" to other paths.
|
||||
.SS
|
||||
.B Rock Ridge, POSIX, X/Open, and El Torito:
|
||||
.B Rock Ridge, POSIX, X/Open, El Torito, ACL, xattr:
|
||||
.br
|
||||
.B Rock Ridge
|
||||
is the name of a set of additional informations which enhance
|
||||
@ -381,6 +381,34 @@ bears the isohybrid signature of ISOLINUX 3.72 or later. It will occupy the
|
||||
first 512 bytes of the emerging ISO image and enable booting from media which
|
||||
appear as hard disk rather than as CDROM. An MBR does not hamper CDROM booting.
|
||||
The MBR of a follow-up session can get in effect only on overwriteable media.
|
||||
.PP
|
||||
.B ACL
|
||||
are an advanced way of controlling access permissions to file objects. Neither
|
||||
ISO 9660 nor Rock Ridge specify a way to record ACLs. So libisofs has
|
||||
introduced a standard conformant extension named AAIP for that purpose.
|
||||
It uses this extension if enabled by option -acl.
|
||||
.br
|
||||
AAIP enhanced images are supposed to be mountable normally, but one cannot
|
||||
expect that the mounted filesystem will show and respect the eventual ACLs.
|
||||
For now, only xorriso is able to retrieve those ACLs. It can bring them into
|
||||
effect when files get restored to an ACL enabled file system or it can
|
||||
print them in a format suitable for tool setfacl.
|
||||
.br
|
||||
Files with ACL show as group permissions the setting of entry "mask::" if
|
||||
that entry exists. Nevertheless the non-listed group members get handled
|
||||
according to entry "group::". xorriso brings "group::" into effect before
|
||||
eventually removing the ACL from a file.
|
||||
.PP
|
||||
.B xattr
|
||||
are pairs of name and value which can be attached to file objects. AAIP is
|
||||
able to represent them and xorriso allows to record and restore pairs which
|
||||
have names out of the user namespace. I.e. those which begin with "user.",
|
||||
like "user.x" or "user.whatever". Value can be any string which does
|
||||
not exceed the size of 4095 characters. xattr processing happens only if
|
||||
it is enabled by option -xattr.
|
||||
.br
|
||||
As with ACL, currently only xorriso is able to retrieve xattr from AAIP
|
||||
enhanced images and to restore them to xattr capable file systems.
|
||||
.SS
|
||||
.B Command processing:
|
||||
.br
|
||||
@ -531,7 +559,7 @@ apply. See above paragraph "Libburn drives".
|
||||
An empty address string "" gives up the current output drive
|
||||
without aquiring a new one. No writing is possible without an output drive.
|
||||
.TP
|
||||
\fB\-drive_class\fR "harmless"|"banned"|"risky"|"clear_list" disk_pattern
|
||||
\fB\-drive_class\fR "harmless"|"banned"|"caution"|"clear_list" disk_pattern
|
||||
Add a drive path pattern to one of the safety lists or make those lists empty.
|
||||
There are three lists defined which get tested in the following sequence:
|
||||
.br
|
||||
@ -543,7 +571,7 @@ Else if the path matches the "banned" list then the drive will not be
|
||||
accepted by xorriso but rather lead to a FAILURE event. This list is empty by
|
||||
default.
|
||||
.br
|
||||
Else if the path matches the "risky" list and if it is not a MMC device,
|
||||
Else if the path matches the "caution" list and if it is not a MMC device,
|
||||
then its address must have the prefix "stdio:" or it will be rejected.
|
||||
This list has by default one entry: "/dev".
|
||||
.br
|
||||
@ -554,8 +582,8 @@ A path matches a list if one of its parent paths or itself matches a list
|
||||
entry. An eventual address prefix "stdio:" or "mmc:" will be ignored when
|
||||
testing for matches.
|
||||
.br
|
||||
By pseudo-class "clear_list" and pseudo-patterns "banned", "risky", "harmless",
|
||||
or "all", the lists may be made empty.
|
||||
By pseudo-class "clear_list" and pseudo-patterns "banned", "caution",
|
||||
"harmless", or "all", the lists may be made empty.
|
||||
.br
|
||||
E.g.: -drive_class clear_list banned
|
||||
.br
|
||||
@ -636,7 +664,7 @@ Enable or disable processing of XFS style Extended Attributes. These are
|
||||
pairs of name and value. The names are 0-terminated strings. Values can
|
||||
be arbitrary binary data.
|
||||
If enabled, then xorriso will import and export xattr similar to ACL.
|
||||
See also option -getfattr.
|
||||
See also options -getfattr, -setfattr.
|
||||
.TP
|
||||
\fB\-rom_toc_scan\fR "on"|"off"[:"emul_on"|"emul_off"]
|
||||
Read-only drives do not tell the actual media type but show any media as
|
||||
@ -980,6 +1008,19 @@ ownership, group and ACL of the given files.
|
||||
Since -getfacl and getfacl strip leading "/" from file paths, the setting of
|
||||
-cd does always matter.
|
||||
.TP
|
||||
\fB\-setfattr\fR [-]name value iso_rr_path [***]
|
||||
Attach the given xattr pair of name and value to the given iso_rr_paths.
|
||||
If the given name is prefixed by "-", then the pair with that name gets
|
||||
removed from the xattr list. If name is "--remove-all" then the whole xattr
|
||||
list of the given iso_rr_paths is 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".
|
||||
.TP
|
||||
\fB\-setfattr_r\fR [-]name value iso_rr_path [***]
|
||||
Like -setfattr but affecting all files below eventual directories.
|
||||
.TP
|
||||
\fB\-alter_date\fR type timestring iso_rr_path [***]
|
||||
Alter the date entries of a file in the ISO image. type is
|
||||
one of "a", "m", "b" for access time, modification time,
|
||||
@ -1160,6 +1201,12 @@ E.g.:
|
||||
.br
|
||||
-find / -has_xattr -exec getfattr
|
||||
.br
|
||||
"setfattr" sets or deletes xattr name value pairs.
|
||||
.br
|
||||
E.g.:
|
||||
.br
|
||||
-find / -has_xattr -exec setfattr --remove-all ''
|
||||
.br
|
||||
"find" performs another run of -find on the matching file address. It accepts
|
||||
the same params as -find, except iso_rr_path.
|
||||
E.g.:
|
||||
@ -2314,7 +2361,7 @@ handled like any other ISO image directory.
|
||||
Option "auto_chmod_off" is default. If "auto_chmod_on" is set then access
|
||||
restrictions for disk directories get circumvented if those directories
|
||||
are owned by the effective user who runs xorriso. This happens by temporarily
|
||||
granting rwx permission to the owner. It will not work with ACL restrictions.
|
||||
granting rwx permission to the owner.
|
||||
.TP
|
||||
\fB\-extract\fR iso_rr_path disk_path
|
||||
Restore the file objects at and underneath iso_rr_path to their corresponding
|
||||
@ -2403,7 +2450,7 @@ of commands which in said programs trigger comparable actions.
|
||||
.TP
|
||||
\fB\-as\fR personality option [options] --
|
||||
.br
|
||||
Perform its variable length option list as sparse emulation of the program
|
||||
Perform the variable length option list as sparse emulation of the program
|
||||
depicted by the personality word.
|
||||
.br
|
||||
|
||||
@ -2440,8 +2487,9 @@ Writing to stdout is possible only if -as "mkisofs" was among the start
|
||||
arguments or if other start arguments pointed the output drive to
|
||||
standard output.
|
||||
.br
|
||||
Not original mkisofs options are --quoted_path_list (see -quoted_path_list)
|
||||
and isolinux_mbr= (see -boot_image isolinux isohybrid=).
|
||||
Not original mkisofs options are --quoted_path_list (see -quoted_path_list),
|
||||
isolinux_mbr= (see -boot_image isolinux isohybrid=), --acl (see -acl "on"),
|
||||
--xattr (see -xattr "on").
|
||||
.br
|
||||
Personalites "\fBxorrisofs\fR", "\fBgenisoimage\fR", and "\fBgenisofs\fR"
|
||||
are aliases for "mkisofs".
|
||||
@ -3154,6 +3202,12 @@ Other programs which burn sessions to optical media
|
||||
.BR cdrecord(1),
|
||||
.BR wodim(1),
|
||||
.BR cdrskin(1)
|
||||
.TP
|
||||
ACL and xattr
|
||||
.BR getfacl(1),
|
||||
.BR setfacl(1),
|
||||
.BR getfattr(1),
|
||||
.BR setfattr(1)
|
||||
.br
|
||||
.SH AUTHOR
|
||||
Thomas Schmitt <scdbackup@gmx.net>
|
||||
|
Loading…
Reference in New Issue
Block a user