8
8
xorriso - creates, loads, manipulates and writes ISO 9660 filesystem
9
9
images with Rock Ridge extensions.
11
Copyright (C) 2007 - 2010 Thomas Schmitt
11
Copyright (C) 2007 - 2011 Thomas Schmitt
13
13
Permission is granted to distrubute this text freely.
16
16
File: xorriso.info, Node: Top, Next: Overview, Up: (dir)
21
21
xorriso - creates, loads, manipulates and writes ISO 9660 filesystem
275
275
-dev /dev/rdsk/c4t0d0s2
276
276
Get a list of accessible drives by command
278
278
It might be necessary to do this as *superuser* in order to see all
279
279
drives and to then allow rw-access for the intended users. Consider to
280
280
bundle the authorized users in a group like old "floppy".
369
369
if that entry exists. Nevertheless the non-listed group members get
370
370
handled according to entry "group::". When removing ACL from a file,
371
371
`xorriso' brings "group::" into effect.
372
Recording and restoring of ACLs from and to local files works currently
373
only on GNU/Linux and FreeBSD.
373
*xattr* (aka EA) are pairs of name and value which can be attached
374
to file objects. AAIP is able to represent them and `xorriso' allows to
375
record and restore pairs which have names out of the user namespace.
376
I.e. those which begin with "user.", like "user.x" or "user.whatever".
377
Name has to be a 0 terminated string. Value may be any array of bytes
378
which does not exceed the size of 4095 bytes. xattr processing happens
379
only if it is enabled by option *-xattr*.
375
*xattr* (aka EA, or extattr) are pairs of name and value which can
376
be attached to file objects. AAIP is able to represent them and
377
`xorriso' allows to record and restore pairs which have names out of
378
the user namespace. I.e. those which begin with "user.", like "user.x"
379
or "user.whatever". Name has to be a 0 terminated string. Value may be
380
any array of bytes which does not exceed the size of 4095 bytes. xattr
381
processing happens only if it is enabled by option *-xattr*.
380
382
As with ACL, currently only `xorriso' is able to retrieve xattr from
381
383
AAIP enhanced images, to restore them to xattr capable file systems, or
385
Recording and restoring of xattr from and to local files works currently
386
only on GNU/Linux and FreeBSD, where they are known as extattr.
385
389
File: xorriso.info, Node: Processing, Next: Dialog, Prev: Extras, Up: Top
1572
1576
prints xattr name-value pairs from any namespace except ACL
1573
1577
to the result channel. This is mostly for debugging of
1574
1578
namespace "isofs".
1580
prints a script to the result channel, which would use
1581
FreeBSD command setextattr to set the file's xattr name-value
1582
pairs of user namespace. Parameter mode controls the form of
1583
the output of names and values. Default mode "e" prints
1584
harmless characters in shell quotation marks, but represents
1585
texts with octal 001 to 037 and 0177 to 0377 by an embedded
1586
echo -e command. Mode "q" prints any characters in shell
1587
quotation marks. This might not be terminal-safe but should
1588
work in script files. Mode "r" uses no quotation marks. Not
1589
safe. Mode "b" prints backslash encoding. Not suitable for
1591
E.g. -exec list_extattr e -
1592
Option -backslash_codes does not affect the output.
1576
1594
prints the MD5 sum, if recorded, together with file path.
1835
Put out a list of speed values as reported by the output drive for
1836
the loaded media. At the end of the list, "Write speed L" and
1837
"Write speed H" are the best guesses for lower and upper speed
1839
"Write speed l" and "Write speed h" may appear only with CD and
1840
eventually override the list of other speed offers.
1853
Put out a list of speed values as reported by the output drive with
1854
the loaded media. This does not necessarily mean that the media is
1855
writable or that these speeds are actually achievable. Especially
1856
the lists reported with empty drive or with ROM media obviously
1857
advertise speeds for other media.
1841
1858
It is not mandatory to use speed values out of the listed range.
1842
1859
The drive is supposed to choose a safe speed that is as near to
1843
1860
the desired speed as possible.
1861
At the end of the list, "Write speed L" and "Write speed H" are
1862
the best guesses for lower and upper speed limit. "Write speed l"
1863
and "Write speed h" may appear only with CD and eventually
1864
override the list of other speed offers.
1845
1866
-close_damaged "as_needed"|"force"
1846
1867
Try to close the upcomming track and session if the drive reported
2687
2708
*superuser* who is able to see all drives.
2688
2709
Drives which are occupied by other processes get not shown.
2712
Like -devices, but presenting the drives with addresses of
2713
symbolic links which point to the actual device files.
2714
Modern GNU/Linux systems may shuffle drive addresses from boot to
2715
boot. The udev daemon is supposed to create links which always
2716
point to the same drive, regardless of its system address. The
2717
command -device_links shows the addresses of such links if they
2718
begin by "/dev/dvd" or "/dev/cd". Precedence is: "dvdrw", "cdrw",
2719
"dvd", "cdrom", "cd".
2691
2722
Show media specific table of content. This is the media session
2692
2723
history, not the ISO image directory tree.
2895
2926
blocks which the found files together will occupy in the
2896
2927
emerging ISO image. This does not account for the superblock,
2897
2928
for the directories in the -findx path, or for image padding.
2930
prints a script to the result channel, which would use
2931
FreeBSD command setextattr to set the file's xattr name-value
2932
pairs of user namespace. See -find for a description of
2934
E.g. -exec list_extattr e -
2899
2936
-compare disk_path iso_rr_path
2900
2937
Compare attributes and eventual data file content of a fileobject
3009
3046
scans the payload range of a media without respecting track
3049
similar to "disc", but restricts scanning to the range of the
3050
ISO 9660 image, if present.
3012
3052
omits all blocks with addresses lower than limit.
3153
3193
Drives which get acquired while "o_excl_off" will refuse to get
3154
3194
blanked, formatted, written, or ejected. But be aware that even
3155
3195
harmless inquiries can spoil ongoing burns of CD-R[W] and DVD-R[W].
3196
Option "strict_acl_off" is default. It tolerates on FreeBSD the
3197
presence of directory "default" ACLs in the ISO image. With
3198
"strict_acl_on" these GNU/Linux ACLs cause on FreeBSD a FAILURE
3199
event during restore with -acl "on".
3157
3201
-extract iso_rr_path disk_path
3158
3202
Copy the file objects at and underneath iso_rr_path to their
3432
3476
Print program name and version, component versions, license.
3479
Tell whether certain extra features were enabled at compile time.
3480
Code "all" lists all features and a headline. Other codes pick a
3481
single feature. Code "codes" lists them. They share names with
3482
related commands (see also there):
3483
"acl" tells whether xorriso has an adapter for local filesystems
3485
"xattr" tells whether xorriso has an adapter for local filesystems
3487
"jigdo" tells whether production of Jigdo files is possible.
3488
"zisofs" tells whether zisofs and built-in gzip filters are
3490
"external_filter" tells whether external filter processes are
3491
allowed and whether they are allowed if real user id and effective
3493
"dvd_obs" tells whether 64 kB output to DVD media is default.
3494
"use_readline" tells whether readline may be enabled in dialog
3434
3496
-history textline
3435
3497
Copy textline into libreadline history.
3621
3683
Solaris use pfexec. Consider to restrict privileges of `xorriso' to
3622
3684
"base,sys_devices" and to give r-permission to user or group.
3625
0 -dev '/dev/sr0' rwrw-- : '_NEC ' 'DVD_RW ND-4570A'
3626
1 -dev '/dev/sr1' rwrw-- : 'HL-DT-ST' 'DVDRAM GSA-4082B'
3627
2 -dev '/dev/sr2' rwrw-- : 'PHILIPS ' 'SPD3300L'
3686
$ xorriso -device_links
3687
1 -dev '/dev/cdrom1' rwrw-- : 'TSSTcorp' 'DVD-ROM SH-D162C
3688
1 -dev '/dev/cdrw' rwrw-- : 'TSSTcorp' 'CDDVDW SH-S223B'
3689
2 -dev '/dev/cdrw3' rwrw-- : 'HL-DT-ST' 'BDDVDRW_GGC-H20L'
3630
3692
File: xorriso.info, Node: ExCreate, Next: ExDialog, Prev: ExDevices, Up: Examples
4187
On FreeBSD some commands differ:
4188
getextattr(8), setextattr(8), md5(1)
4126
4191
File: xorriso.info, Node: Bugreport, Next: Legal, Prev: Seealso, Up: Top