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

Corrections and updates of documentation

Browse Source
This commit is contained in:
Thomas Schmitt
2011-03-09 12:48:21 +00:00
parent 0577b487d9
commit c1a24e71f1
6 changed files with 278 additions and 128 deletions
Download Patch File Download Diff File Expand all files Collapse all files

104
xorriso/xorrisofs.info
View File

@ -193,11 +193,18 @@ then a new image is composed from scratch.
superblock address on the intended media.
Both values can be inquired from optical media by help of burn
programs and cdrecord option -msinfo. xorriso itself can obtain it
in its cdrecord emulation:
values=$(xorriso -as cdrecord dev=/dev/... -msinfo) echo $values
in its cdrecord emulation. Do not let it load the drive, but
rather do this manually or by a program like dd which reads a few
bytes. Only then it is sure that the device driver knows the true
readable size of the media.
dd if=/dev/... count=1 >/dev/null 2>&1
values=$(xorriso -as cdrecord dev=/dev/... -msinfo)
echo $values
Option -C may be used without option -M to create an ISO image from
scratch and prepare it for being finally written to a block address
other than 0. Parameter last_session_start should then be set to 0.
other than 0. Parameter last_session_start must then be set to 0.
-cdrecord-params last_session_start,next_writeable_address
Alias of -C.
@ -1133,6 +1140,10 @@ File: xorrisofs.info, Node: ExMkisofs, Next: ExGrowisofs, Prev: ExGraft, Up:
6.3 Perform multi-session runs
==============================
This example works for multi-session media only: CD-R[W], DVD-R[W],
DVD+R, BD-R. Add cdrskin option --grow_overwriteable_iso to all -as
cdrecord runs in order to enable multi-session emulation on
overwriteable media.
The first session is written like this:
$ xorrisofs -graft-points \
@ -1141,18 +1152,19 @@ $ xorrisofs -graft-points \
Follow-up sessions are written like this:
$ dd if=/dev/sr0 count=1 >/dev/null 2>&1
$ m=$(xorriso -as cdrecord dev=/dev/sr0 -msinfo)
$ xorrisofs -M /dev/sr0 -C $m -graft-points \
/tree2/=prepared_for_iso/tree2 \
/tree2=prepared_for_iso/tree2 \
| xorriso -as cdrecord -v dev=/dev/sr0 -waiti -multi -eject -
Always eject the drive tray between sessions. The old sessions get read
via /dev/sr0. Its device driver might not be aware of the changed
content before it loads the media again.
This example works for multi-session media only. Add cdrskin option
--grow_overwriteable_iso to all -as cdrecord runs in order to enable
multi-session emulation on overwriteable media.
content before it loads the media again. In this case the previous
session would not be loaded and the new session would contain only the
newly added files.
For the same reason do not let xorriso -as cdrecord load the media, but
rather do this manually or by a program that reads from /dev/sr0.

File: xorrisofs.info, Node: ExGrowisofs, Next: ExIncBackup, Prev: ExMkisofs, Up: Examples
@ -1178,8 +1190,13 @@ One may quit mkisofs emulation by argument "--" and make use of all
xorriso commands. growisofs dislikes options which start with "-o" but
-outdev must be set to "-". So use "outdev" instead:
$ growisofs -Z /dev/dvd -- outdev - -update_r /my/files /files
$ growisofs -M /dev/dvd -- outdev - -update_r /my/files /files
$ growisofs -Z /dev/dvd --for_backup -- \
outdev - -update_r /my/files /files
$ growisofs -M /dev/dvd --for_backup -- \
outdev - -update_r /my/files /files
Note that --for_backup is given in the mkisofs emulation. To preserve
the recorded extra data it must already be in effect, when the
emulation loads the image.

File: xorrisofs.info, Node: ExIncBackup, Next: ExIncBckAcc, Prev: ExGrowisofs, Up: Examples
@ -1200,7 +1217,10 @@ To be used several times on the same media, whenever an update of the
two disk trees to the media is desired. Begin with blank media and start
a new blank media when the run fails due to lack of remaining space on
the old one.
Do not let xorriso -as cdrecord load the media, but rather do this
manually or by a program that reads from /dev/sr0.
$ dd if=/dev/sr0 count=1 >/dev/null 2>&1
$ msinfo=$(xorriso -as cdrecord dev=/dev/sr0 -msinfo)
$ load_opts=
$ test -n "$msinfo" && load_opts="-M /dev/sr0 -C $msinfo"
@ -1274,8 +1294,11 @@ $ xorrisofs -root /session1 \
-multi -waiti -eject -
With the second session, option -old-root refers to /session1 and the
new -root is /session2:
new -root is /session2.
Do not let xorriso -as cdrecord load the media, but rather do this
manually or by a program that reads from /dev/sr0.
$ dd if=/dev/sr0 count=1 >/dev/null 2>&1
$ msinfo=$(xorriso -as cdrecord dev=/dev/sr0 -msinfo)
$ load_opts=
$ test -n "$msinfo" && load_opts="-M /dev/sr0 -C $msinfo"
@ -1306,8 +1329,12 @@ $ xorrisofs -o output.iso \
-no-emul-boot -boot-load-size 4 -boot-info-table \
./CD_root
Put it on CD by a burn program. E.g.:
$ xorriso -as cdrecord -v dev=/dev/sr0 blank=as_needed output.iso
The image from above example will boot from CD, DVD or BD, but not from
USB stick or orther hard-disk-like devices. This can be done by help of
USB stick or other hard-disk-like devices. This can be done by help of
an isohybrid MBR. Syslinux provides matching template files as
isohdp[fp]x*.bin . E.g. /usr/lib/syslinux/isohdpfx.bin .
If a few hundred KB of size do not matter, then option -partition_offset
@ -1316,6 +1343,7 @@ block 0. This facilitates later manipulations of the USB stick by tools
for partitioning and formatting.
The image from the following example will be prepared for booting via
MBR and its first parttion will start at hard disk block 64.
It will also boot from optical media.
$ xorrisofs -o output.iso \
-b isolinux/isolinux.bin -c isolinux/boot.cat \
@ -1481,7 +1509,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -c El Torito boot catalog name: Bootable. (line 86)
* -C set load address and write address offset: Loading. (line 28)
* -cdrecord-params set load address and write address offset: Loading.
(line 43)
(line 50)
* -checksum_algorithm_iso choose .jigdo checksums: Jigdo. (line 80)
* -checksum_algorithm_template choose .template checksums: Jigdo.
(line 87)
@ -1753,29 +1781,29 @@ Node: Insert3163
Node: Xorriso4584
Node: Options5720
Node: Loading6437
Node: SetInsert8474
Node: SetProduct12876
Node: SetCompl16583
Node: SetExtras18902
Node: SetHide21630
Node: ImageId22638
Node: Bootable26142
Node: SystemArea30222
Node: Charset36582
Node: Jigdo37607
Node: Miscellaneous41888
Node: Examples43061
Node: ExSimple43547
Node: ExGraft44026
Node: ExMkisofs45273
Node: ExGrowisofs46198
Node: ExIncBackup47179
Node: ExIncBckAcc50069
Node: ExBootable51585
Node: Files53541
Node: Seealso54611
Node: Legal55126
Node: CommandIdx55922
Node: ConceptIdx67255
Node: SetInsert8731
Node: SetProduct13133
Node: SetCompl16840
Node: SetExtras19159
Node: SetHide21887
Node: ImageId22895
Node: Bootable26399
Node: SystemArea30479
Node: Charset36839
Node: Jigdo37864
Node: Miscellaneous42145
Node: Examples43318
Node: ExSimple43804
Node: ExGraft44283
Node: ExMkisofs45530
Node: ExGrowisofs46781
Node: ExIncBackup47953
Node: ExIncBckAcc51002
Node: ExBootable52677
Node: Files54776
Node: Seealso55846
Node: Legal56361
Node: CommandIdx57157
Node: ConceptIdx68490

End Tag Table