Corrections and updates of documentation
This commit is contained in:
parent
0577b487d9
commit
c1a24e71f1
@ -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 "Mar 04, 2011"
|
||||
.TH XORRISO 1 "Mar 09, 2011"
|
||||
.\" Please adjust this date whenever revising the manpage.
|
||||
.\"
|
||||
.\" Some roff macros, for reference:
|
||||
@ -771,7 +771,7 @@ Enable or disable processing of xattr attributes in user namespace.
|
||||
If enabled, then xorriso will handle xattr similar to ACL.
|
||||
See also options -getfattr, -setfattr and above paragraph about xattr.
|
||||
.TP
|
||||
\fB\-md5\fR "on"|"all"|"off"
|
||||
\fB\-md5\fR "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 get loaded only if eventual
|
||||
checksums tags of superblock and directory tree match properly. The MD5
|
||||
@ -792,6 +792,15 @@ Mode "all" will additionally check during image generation whether the checksum
|
||||
of a data file changed between the time when its reading began and the time
|
||||
when it ended. This implies reading every file twice.
|
||||
.br
|
||||
Mode "load_check_off" together with "on" or "all" will load recorded MD5 sums
|
||||
but not test the recorded checksum tags of superblock and directory tree.
|
||||
This is necessary if growisofs was used as burn program, because it does
|
||||
not overwrite the superblock checksum tag of the first session.
|
||||
Therefore load_check_off is in effect when xorriso -as mkisofs option -M
|
||||
is performed.
|
||||
.br
|
||||
The test can be re-enabled by mode "load_check_on".
|
||||
.br
|
||||
Checksums can be exploited via options -check_md5, -check_md5_r, via find
|
||||
actions get_md5, check_md5, and via -check_media.
|
||||
.TP
|
||||
@ -4219,6 +4228,8 @@ $ xorriso -as mkisofs prepared_for_iso/tree1 | \\
|
||||
.br
|
||||
Follow-up sessions are written like this:
|
||||
.br
|
||||
$ dd if=/dev/sr0 count=1 >/dev/null 2>&1
|
||||
.br
|
||||
$ m=$(xorriso -as cdrecord dev=/dev/sr0 -msinfo)
|
||||
.br
|
||||
$ xorriso -as mkisofs -M /dev/sr0 -C $m prepared_for_iso/tree2 | \\
|
||||
@ -4226,8 +4237,13 @@ $ xorriso -as mkisofs -M /dev/sr0 -C $m prepared_for_iso/tree2 | \\
|
||||
xorriso -as cdrecord -v dev=/dev/sr0 -waiti -multi -eject -
|
||||
.br
|
||||
Always eject the drive tray between sessions. The old sessions
|
||||
get read via stdio:/dev/sr0 and thus are prone to device driver
|
||||
peculiarities.
|
||||
get read via /dev/sr0. Its device driver might not be aware
|
||||
of the changed 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.
|
||||
.br
|
||||
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.
|
||||
.br
|
||||
This example works for multi-session media only.
|
||||
Add cdrskin option --grow_overwriteable_iso
|
||||
|
||||
@ -728,7 +728,7 @@ activate them only after image loading.
|
||||
If enabled, then xorriso will handle xattr similar to ACL. See
|
||||
also options -getfattr, -setfattr and above paragraph about xattr.
|
||||
|
||||
-md5 "on"|"all"|"off"
|
||||
-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 get
|
||||
loaded only if eventual checksums tags of superblock and directory
|
||||
@ -747,6 +747,13 @@ activate them only after image loading.
|
||||
the checksum of a data file changed between the time when its
|
||||
reading began and the time when it ended. This implies reading
|
||||
every file twice.
|
||||
Mode "load_check_off" together with "on" or "all" will load
|
||||
recorded MD5 sums but not test the recorded checksum tags of
|
||||
superblock and directory tree. This is necessary if growisofs was
|
||||
used as burn program, because it does not overwrite the superblock
|
||||
checksum tag of the first session. Therefore load_check_off is in
|
||||
effect when xorriso -as mkisofs option -M is performed.
|
||||
The test can be re-enabled by mode "load_check_on".
|
||||
Checksums can be exploited via options -check_md5, -check_md5_r,
|
||||
via find actions get_md5, check_md5, and via -check_media.
|
||||
|
||||
@ -3746,12 +3753,18 @@ xorriso -as cdrecord -v dev=/dev/sr0 blank=fast -multi -eject -
|
||||
|
||||
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)
|
||||
$ xorriso -as mkisofs -M /dev/sr0 -C $m 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 stdio:/dev/sr0 and thus are prone to device driver peculiarities.
|
||||
via /dev/sr0. Its device driver might not be aware of the changed
|
||||
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.
|
||||
|
||||
This example works for multi-session media only. Add cdrskin option
|
||||
--grow_overwriteable_iso to all -as cdrecord runs in order to enable
|
||||
@ -4081,11 +4094,11 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
||||
* -assert_volid rejects undesired images: Loading. (line 84)
|
||||
* -auto_charset learns character set from image: Loading. (line 99)
|
||||
* -backslash_codes enables backslash conversion: Scripting. (line 45)
|
||||
* -ban_stdio_write demands real drive: Loading. (line 239)
|
||||
* -ban_stdio_write demands real drive: Loading. (line 246)
|
||||
* -biblio_file sets biblio file name: SetWrite. (line 165)
|
||||
* -blank erases media: Writing. (line 45)
|
||||
* -boot_image controls bootability: Bootable. (line 26)
|
||||
* -calm_drive reduces drive activity: Loading. (line 228)
|
||||
* -calm_drive reduces drive activity: Loading. (line 235)
|
||||
* -cd sets working directory in ISO: Navigate. (line 7)
|
||||
* -cdx sets working directory on disk: Navigate. (line 16)
|
||||
* -charset sets input/output character set: Charset. (line 43)
|
||||
@ -4118,7 +4131,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
||||
* -dev aquires one drive for input and output: AqDrive. (line 10)
|
||||
* -devices gets list of drives: Inquiry. (line 7)
|
||||
* -dialog enables dialog mode: DialogCtl. (line 7)
|
||||
* -disk_dev_ino fast incremental backup: Loading. (line 182)
|
||||
* -disk_dev_ino fast incremental backup: Loading. (line 189)
|
||||
* -disk_pattern controls pattern expansion: Insert. (line 31)
|
||||
* -displacement compensate altered image start address: Loading.
|
||||
(line 35)
|
||||
@ -4143,7 +4156,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
||||
* -find traverses and alters ISO tree: CmdFind. (line 7)
|
||||
* -findx traverses disk tree: Navigate. (line 105)
|
||||
* -follow softlinks and mount points: SetInsert. (line 76)
|
||||
* -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 177)
|
||||
* -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 184)
|
||||
* -format formats media: Writing. (line 69)
|
||||
* -fs sets size of fifo: SetWrite. (line 253)
|
||||
* -getfacl shows ACL in ISO image: Navigate. (line 69)
|
||||
@ -4224,7 +4237,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
||||
* -rmdir deletes ISO directory: Manip. (line 32)
|
||||
* -rollback discards pending changes: Writing. (line 9)
|
||||
* -rollback_end ends program without writing: Scripting. (line 125)
|
||||
* -rom_toc_scan searches for sessions: Loading. (line 203)
|
||||
* -rom_toc_scan searches for sessions: Loading. (line 210)
|
||||
* -scdbackup_tag enables scdbackup checksum tag: Emulation. (line 168)
|
||||
* -scsi_log reports SCSI commands: Scripting. (line 113)
|
||||
* -session_log logs written sessions: Scripting. (line 104)
|
||||
@ -4280,8 +4293,8 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
|
||||
* Appendable media, _definition: Media. (line 38)
|
||||
* Appended Filesystem Image, -append_partition: Bootable. (line 202)
|
||||
* Backslash Interpretation, _definition: Processing. (line 49)
|
||||
* Backup, enable fast incremental, -disk_dev_ino: Loading. (line 182)
|
||||
* Backup, enable features, -for_backup: Loading. (line 177)
|
||||
* Backup, enable fast incremental, -disk_dev_ino: Loading. (line 189)
|
||||
* Backup, enable features, -for_backup: Loading. (line 184)
|
||||
* Backup, scdbackup checksum tag, -scdbackup: Emulation. (line 168)
|
||||
* Blank media, _definition: Media. (line 29)
|
||||
* Blind growing, _definition: Methods. (line 40)
|
||||
@ -4313,14 +4326,14 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
|
||||
* disk_path, _definition: Insert. (line 6)
|
||||
* Drive, _definiton: Drives. (line 6)
|
||||
* Drive, accessability, -drive_class: Loading. (line 54)
|
||||
* Drive, demand real MMC, -ban_stdio_write: Loading. (line 239)
|
||||
* Drive, demand real MMC, -ban_stdio_write: Loading. (line 246)
|
||||
* Drive, eject tray, -eject: Writing. (line 36)
|
||||
* Drive, for input and output, -dev: AqDrive. (line 10)
|
||||
* Drive, for input, -indev: AqDrive. (line 22)
|
||||
* Drive, for output, -outdev: AqDrive. (line 29)
|
||||
* Drive, get drive list, -devices: Inquiry. (line 7)
|
||||
* Drive, list supported media, -list_profiles: Writing. (line 119)
|
||||
* Drive, reduce activity, -calm_drive: Loading. (line 228)
|
||||
* Drive, reduce activity, -calm_drive: Loading. (line 235)
|
||||
* Drive, report SCSI commands, -scsi_log: Scripting. (line 113)
|
||||
* Drive, write and eject, -commit_eject: Writing. (line 40)
|
||||
* El Torito, _definiton: Extras. (line 19)
|
||||
@ -4473,7 +4486,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
|
||||
* SUN Disk Label, production: Bootable. (line 189)
|
||||
* SUN SPARC boot images, activation: Bootable. (line 223)
|
||||
* System area, _definiton: Bootable. (line 123)
|
||||
* Table-of-content, search sessions, -rom_toc_scan: Loading. (line 203)
|
||||
* Table-of-content, search sessions, -rom_toc_scan: Loading. (line 210)
|
||||
* Table-of-content, show, -toc: Inquiry. (line 18)
|
||||
* Timestamps, set in ISO image, -alter_date: Manip. (line 146)
|
||||
* Timestamps, set in ISO image, -alter_date_r: Manip. (line 166)
|
||||
@ -4525,46 +4538,46 @@ Node: Dialog21570
|
||||
Node: Options23227
|
||||
Node: AqDrive24835
|
||||
Node: Loading27741
|
||||
Node: Insert40885
|
||||
Node: SetInsert50504
|
||||
Node: Manip59071
|
||||
Node: CmdFind67752
|
||||
Node: Filter79052
|
||||
Node: Writing83401
|
||||
Node: SetWrite89690
|
||||
Node: Bootable103631
|
||||
Node: Jigdo116949
|
||||
Node: Charset121207
|
||||
Node: Exception123958
|
||||
Node: DialogCtl128473
|
||||
Node: Inquiry131060
|
||||
Node: Navigate135437
|
||||
Node: Verify143377
|
||||
Node: Restore151966
|
||||
Node: Emulation158622
|
||||
Node: Scripting168458
|
||||
Node: Frontend174020
|
||||
Node: Examples175315
|
||||
Node: ExDevices176484
|
||||
Node: ExCreate177118
|
||||
Node: ExDialog178392
|
||||
Node: ExGrowing179654
|
||||
Node: ExModifying180456
|
||||
Node: ExBootable180957
|
||||
Node: ExCharset181504
|
||||
Node: ExPseudo182332
|
||||
Node: ExCdrecord183226
|
||||
Node: ExMkisofs183541
|
||||
Node: ExGrowisofs184544
|
||||
Node: ExException185668
|
||||
Node: ExTime186122
|
||||
Node: ExIncBackup186581
|
||||
Node: ExRestore190502
|
||||
Node: ExRecovery191471
|
||||
Node: Files192037
|
||||
Node: Seealso193265
|
||||
Node: Legal193845
|
||||
Node: CommandIdx194767
|
||||
Node: ConceptIdx209074
|
||||
Node: Insert41367
|
||||
Node: SetInsert50986
|
||||
Node: Manip59553
|
||||
Node: CmdFind68234
|
||||
Node: Filter79534
|
||||
Node: Writing83883
|
||||
Node: SetWrite90172
|
||||
Node: Bootable104113
|
||||
Node: Jigdo117431
|
||||
Node: Charset121689
|
||||
Node: Exception124440
|
||||
Node: DialogCtl128955
|
||||
Node: Inquiry131542
|
||||
Node: Navigate135919
|
||||
Node: Verify143859
|
||||
Node: Restore152448
|
||||
Node: Emulation159104
|
||||
Node: Scripting168940
|
||||
Node: Frontend174502
|
||||
Node: Examples175797
|
||||
Node: ExDevices176966
|
||||
Node: ExCreate177600
|
||||
Node: ExDialog178874
|
||||
Node: ExGrowing180136
|
||||
Node: ExModifying180938
|
||||
Node: ExBootable181439
|
||||
Node: ExCharset181986
|
||||
Node: ExPseudo182814
|
||||
Node: ExCdrecord183708
|
||||
Node: ExMkisofs184023
|
||||
Node: ExGrowisofs185359
|
||||
Node: ExException186483
|
||||
Node: ExTime186937
|
||||
Node: ExIncBackup187396
|
||||
Node: ExRestore191317
|
||||
Node: ExRecovery192286
|
||||
Node: Files192852
|
||||
Node: Seealso194080
|
||||
Node: Legal194660
|
||||
Node: CommandIdx195582
|
||||
Node: ConceptIdx209889
|
||||
|
||||
End Tag Table
|
||||
|
||||
@ -44,7 +44,7 @@
|
||||
@c man .\" First parameter, NAME, should be all caps
|
||||
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
||||
@c man .\" other parameters are allowed: see man(7), man(1)
|
||||
@c man .TH XORRISO 1 "Mar 05, 2011"
|
||||
@c man .TH XORRISO 1 "Mar 09, 2011"
|
||||
@c man .\" Please adjust this date whenever revising the manpage.
|
||||
@c man .\"
|
||||
@c man .\" Some roff macros, for reference:
|
||||
@ -983,7 +983,7 @@ Enable or disable processing of xattr attributes in user namespace.
|
||||
If enabled, then xorriso will handle xattr similar to ACL.
|
||||
See also options -getfattr, -setfattr and above paragraph about xattr.
|
||||
@c man .TP
|
||||
@item -md5 "on"|"all"|"off"
|
||||
@item -md5 "on"|"all"|"off"|"load_check_off"
|
||||
@kindex -md5 controls handling of MD5 sums
|
||||
@cindex MD5, control handling, -md5
|
||||
Enable or disable processing of MD5 checksums for the overall session and for
|
||||
@ -1006,6 +1006,15 @@ Mode "all" will additionally check during image generation whether the checksum
|
||||
of a data file changed between the time when its reading began and the time
|
||||
when it ended. This implies reading every file twice.
|
||||
@*
|
||||
Mode "load_check_off" together with "on" or "all" will load recorded MD5 sums
|
||||
but not test the recorded checksum tags of superblock and directory tree.
|
||||
This is necessary if growisofs was used as burn program, because it does
|
||||
not overwrite the superblock checksum tag of the first session.
|
||||
Therefore load_check_off is in effect when xorriso -as mkisofs option -M
|
||||
is performed.
|
||||
@*
|
||||
The test can be re-enabled by mode "load_check_on".
|
||||
@*
|
||||
Checksums can be exploited via options -check_md5, -check_md5_r, via find
|
||||
actions get_md5, check_md5, and via -check_media.
|
||||
@c man .TP
|
||||
@ -5035,6 +5044,8 @@ $ xorriso -as mkisofs prepared_for_iso/tree1 | \
|
||||
Follow-up sessions are written like this:
|
||||
@*
|
||||
@sp 1
|
||||
$ dd if=/dev/sr0 count=1 >/dev/null 2>&1
|
||||
@*
|
||||
$ m=$(xorriso -as cdrecord dev=/dev/sr0 -msinfo)
|
||||
@*
|
||||
$ xorriso -as mkisofs -M /dev/sr0 -C $m prepared_for_iso/tree2 | \
|
||||
@ -5043,8 +5054,13 @@ $ xorriso -as mkisofs -M /dev/sr0 -C $m prepared_for_iso/tree2 | \
|
||||
@*
|
||||
@sp 1
|
||||
Always eject the drive tray between sessions. The old sessions
|
||||
get read via stdio:/dev/sr0 and thus are prone to device driver
|
||||
peculiarities.
|
||||
get read via /dev/sr0. Its device driver might not be aware
|
||||
of the changed 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.
|
||||
@*
|
||||
@sp 1
|
||||
This example works for multi-session media only.
|
||||
|
||||
@ -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 XORRISOFS 1 "Mar 06, 2011"
|
||||
.TH XORRISOFS 1 "Mar 09, 2011"
|
||||
.\" Please adjust this date whenever revising the manpage.
|
||||
.\"
|
||||
.\" Some roff macros, for reference:
|
||||
@ -176,14 +176,19 @@ on the intended media.
|
||||
.br
|
||||
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:
|
||||
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.
|
||||
.br
|
||||
dd if=/dev/... count=1 >/dev/null 2>&1
|
||||
.br
|
||||
values=$(xorriso -as cdrecord dev=/dev/... -msinfo)
|
||||
.br
|
||||
echo $values
|
||||
.br
|
||||
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.
|
||||
.TP
|
||||
\fB\-cdrecord-params\fR last_session_start,next_writeable_address
|
||||
Alias of -C.
|
||||
@ -1114,6 +1119,12 @@ yields in the ISO image:
|
||||
/with_=_and_\\/file
|
||||
.SS
|
||||
.B 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.
|
||||
.br
|
||||
The first session is written like this:
|
||||
.br
|
||||
$ xorrisofs -graft-points \\
|
||||
@ -1123,23 +1134,25 @@ The first session is written like this:
|
||||
| xorriso -as cdrecord -v dev=/dev/sr0 blank=fast -multi -eject -
|
||||
.br
|
||||
Follow-up sessions are written like this:
|
||||
.br
|
||||
$ dd if=/dev/sr0 count=1 >/dev/null 2>&1
|
||||
.br
|
||||
$ m=$(xorriso -as cdrecord dev=/dev/sr0 -msinfo)
|
||||
.br
|
||||
$ xorrisofs -M /dev/sr0 -C $m -graft-points \\
|
||||
.br
|
||||
/tree2/=prepared_for_iso/tree2 \\
|
||||
/tree2=prepared_for_iso/tree2 \\
|
||||
.br
|
||||
| xorriso -as cdrecord -v dev=/dev/sr0 -waiti -multi -eject -
|
||||
.br
|
||||
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.
|
||||
In this case the previous session would not be loaded and the
|
||||
new session would contain only the newly added files.
|
||||
.br
|
||||
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.
|
||||
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.
|
||||
.SS
|
||||
.B Let xorrisofs work underneath growisofs
|
||||
growisofs expects an ISO formatter program which understands options -C and
|
||||
@ -1163,9 +1176,17 @@ use of all xorriso commands. growisofs dislikes options which
|
||||
start with "-o" but -outdev must be set to "-".
|
||||
So use "outdev" instead:
|
||||
.br
|
||||
$ growisofs -Z /dev/dvd -- outdev - -update_r /my/files /files
|
||||
$ growisofs -Z /dev/dvd --for_backup -- \\
|
||||
.br
|
||||
$ growisofs -M /dev/dvd -- outdev - -update_r /my/files /files
|
||||
outdev - -update_r /my/files /files
|
||||
.br
|
||||
$ growisofs -M /dev/dvd --for_backup -- \\
|
||||
.br
|
||||
outdev - -update_r /my/files /files
|
||||
.br
|
||||
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.
|
||||
.SS
|
||||
.B Incremental backup of a few directory trees
|
||||
This changes the directory trees /open_source_project and /personal_mail
|
||||
@ -1183,6 +1204,11 @@ 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.
|
||||
.br
|
||||
Do not let xorriso -as cdrecord load the media,
|
||||
but rather do this manually or by a program that reads from /dev/sr0.
|
||||
.br
|
||||
$ dd if=/dev/sr0 count=1 >/dev/null 2>&1
|
||||
.br
|
||||
$ msinfo=$(xorriso -as cdrecord dev=/dev/sr0 -msinfo)
|
||||
.br
|
||||
@ -1275,7 +1301,12 @@ With the first session:
|
||||
.br
|
||||
.sp 1
|
||||
With the second session, option -old-root refers to /session1 and the
|
||||
new -root is /session2:
|
||||
new -root is /session2.
|
||||
.br
|
||||
Do not let xorriso -as cdrecord load the media,
|
||||
but rather do this manually or by a program that reads from /dev/sr0.
|
||||
.br
|
||||
$ dd if=/dev/sr0 count=1 >/dev/null 2>&1
|
||||
.br
|
||||
$ msinfo=$(xorriso -as cdrecord dev=/dev/sr0 -msinfo)
|
||||
.br
|
||||
@ -1314,9 +1345,13 @@ The prescribed mkisofs options can be used unchanged with xorrisofs:
|
||||
.br
|
||||
./CD_root
|
||||
.br
|
||||
Put it on CD by a burn program. E.g.:
|
||||
.br
|
||||
$ xorriso -as cdrecord -v dev=/dev/sr0 blank=as_needed output.iso
|
||||
.br
|
||||
.sp 1
|
||||
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 an
|
||||
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 .
|
||||
.br
|
||||
@ -1327,6 +1362,8 @@ tools for partitioning and formatting.
|
||||
.br
|
||||
The image from the following example will be prepared for booting via MBR
|
||||
and its first parttion will start at hard disk block 64.
|
||||
.br
|
||||
It will also boot from optical media.
|
||||
.br
|
||||
$ xorrisofs -o output.iso \\
|
||||
-b isolinux/isolinux.bin -c isolinux/boot.cat \\
|
||||
|
||||
@ -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
|
||||
|
||||
@ -44,7 +44,7 @@
|
||||
@c man .\" First parameter, NAME, should be all caps
|
||||
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
||||
@c man .\" other parameters are allowed: see man(7), man(1)
|
||||
@c man .TH XORRISOFS 1 "Mar 06, 2011"
|
||||
@c man .TH XORRISOFS 1 "Mar 09, 2011"
|
||||
@c man .\" Please adjust this date whenever revising the manpage.
|
||||
@c man .\"
|
||||
@c man .\" Some roff macros, for reference:
|
||||
@ -298,14 +298,21 @@ 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:
|
||||
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.
|
||||
@*
|
||||
@sp 1
|
||||
dd if=/dev/... count=1 >/dev/null 2>&1
|
||||
@*
|
||||
values=$(xorriso -as cdrecord dev=/dev/... -msinfo)
|
||||
@*
|
||||
echo $values
|
||||
@*
|
||||
@sp 1
|
||||
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.
|
||||
@c man .TP
|
||||
@item -cdrecord-params last_session_start,next_writeable_address
|
||||
@kindex -cdrecord-params set load address and write address offset
|
||||
@ -1552,6 +1559,12 @@ yields in the ISO image:
|
||||
@c man .B Perform multi-session runs
|
||||
@node ExMkisofs, ExGrowisofs, ExGraft, Examples
|
||||
@section 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 @minus{}@minus{}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:
|
||||
@*
|
||||
@sp 1
|
||||
@ -1565,11 +1578,13 @@ The first session is written like this:
|
||||
Follow-up sessions are written like this:
|
||||
@*
|
||||
@sp 1
|
||||
$ 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 -
|
||||
@*
|
||||
@ -1577,12 +1592,11 @@ Follow-up sessions are written like this:
|
||||
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.
|
||||
In this case the previous session would not be loaded and the
|
||||
new session would contain only the newly added files.
|
||||
@*
|
||||
@sp 1
|
||||
This example works for multi-session media only.
|
||||
Add cdrskin option @minus{}@minus{}grow_overwriteable_iso
|
||||
to all -as cdrecord runs
|
||||
in order to enable multi-session emulation on overwriteable media.
|
||||
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.
|
||||
@c man .SS
|
||||
@c man .B Let xorrisofs work underneath growisofs
|
||||
@node ExGrowisofs, ExIncBackup, ExMkisofs, Examples
|
||||
@ -1613,9 +1627,17 @@ start with "-o" but -outdev must be set to "-".
|
||||
So use "outdev" instead:
|
||||
@*
|
||||
@sp 1
|
||||
$ growisofs -Z /dev/dvd @minus{}@minus{} outdev - -update_r /my/files /files
|
||||
$ growisofs -Z /dev/dvd @minus{}@minus{}for_backup @minus{}@minus{} \
|
||||
@*
|
||||
$ growisofs -M /dev/dvd @minus{}@minus{} outdev - -update_r /my/files /files
|
||||
outdev - -update_r /my/files /files
|
||||
@*
|
||||
$ growisofs -M /dev/dvd @minus{}@minus{}for_backup @minus{}@minus{} \
|
||||
@*
|
||||
outdev - -update_r /my/files /files
|
||||
@*
|
||||
Note that @minus{}@minus{}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.
|
||||
@c man .SS
|
||||
@c man .B Incremental backup of a few directory trees
|
||||
@node ExIncBackup, ExIncBckAcc, ExGrowisofs, Examples
|
||||
@ -1637,7 +1659,12 @@ 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.
|
||||
@*
|
||||
@sp 1
|
||||
$ dd if=/dev/sr0 count=1 >/dev/null 2>&1
|
||||
@*
|
||||
$ msinfo=$(xorriso -as cdrecord dev=/dev/sr0 -msinfo)
|
||||
@*
|
||||
$ load_opts=
|
||||
@ -1745,9 +1772,14 @@ With the first session:
|
||||
@sp 1
|
||||
@c man .sp 1
|
||||
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.
|
||||
@*
|
||||
@sp 1
|
||||
$ dd if=/dev/sr0 count=1 >/dev/null 2>&1
|
||||
@*
|
||||
$ msinfo=$(xorriso -as cdrecord dev=/dev/sr0 -msinfo)
|
||||
@*
|
||||
$ load_opts=
|
||||
@ -1790,9 +1822,15 @@ The prescribed mkisofs options can be used unchanged with xorrisofs:
|
||||
./CD_root
|
||||
@*
|
||||
@sp 1
|
||||
Put it on CD by a burn program. E.g.:
|
||||
@*
|
||||
@sp 1
|
||||
$ xorriso -as cdrecord -v dev=/dev/sr0 blank=as_needed output.iso
|
||||
@*
|
||||
@sp 1
|
||||
@c man .sp 1
|
||||
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 an
|
||||
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 .
|
||||
@*
|
||||
@ -1804,6 +1842,8 @@ 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.
|
||||
@*
|
||||
@sp 1
|
||||
$ xorrisofs -o output.iso \
|
||||
@*
|
||||
|
||||
Loading…
Reference in New Issue
Block a user