Some documentation updates

This commit is contained in:
Thomas Schmitt 2008-07-10 17:25:19 +00:00
parent d8b6e69429
commit 7765835374
3 changed files with 34 additions and 11 deletions

View File

@ -47,7 +47,7 @@ then
-e 's/have a look at section EXAMPLES/have a look at section <A HREF="#EXAMPLES">EXAMPLES<\/A>/' \ -e 's/have a look at section EXAMPLES/have a look at section <A HREF="#EXAMPLES">EXAMPLES<\/A>/' \
-e 's/<b>Session model:<\/b>/\&nbsp;<BR><b>Session model:<\/b>/' \ -e 's/<b>Session model:<\/b>/\&nbsp;<BR><b>Session model:<\/b>/' \
-e 's/<b>Media types and states:<\/b>/\&nbsp;<BR><b>Media types and states:<\/b>/' \ -e 's/<b>Media types and states:<\/b>/\&nbsp;<BR><b>Media types and states:<\/b>/' \
-e 's/<b>Creating, Growing, Modifying:<\/b>/\&nbsp;<BR><b>Creating, Growing, Modifying:<\/b>/' \ -e 's/<b>Creating, Growing, Modifying, Blind Growing:<\/b>/\&nbsp;<BR><b>Creating, Growing, Modifying, Blind Growing:<\/b>/' \
-e 's/<b>Libburn drives:<\/b>/\&nbsp;<BR><b>Libburn drives:<\/b>/' \ -e 's/<b>Libburn drives:<\/b>/\&nbsp;<BR><b>Libburn drives:<\/b>/' \
-e 's/^-dev /\&nbsp;\&nbsp;-dev /' \ -e 's/^-dev /\&nbsp;\&nbsp;-dev /' \
-e 's/^-devices /\&nbsp;\&nbsp;-devices /' \ -e 's/^-devices /\&nbsp;\&nbsp;-devices /' \

View File

@ -50,11 +50,10 @@ Changes file properties in the ISO image.
.br .br
Updates ISO subtrees incrementally to match given disk subtrees. Updates ISO subtrees incrementally to match given disk subtrees.
.br .br
Can write result as completely new image to optical media or Writes result either as completely new image or as add-on session
filesystem objects. to optical media or filesystem objects.
.br .br
Can write result as add-on session to appendable multi-session media, Can perform multi-session tasks as emulation of mkisofs and cdrecord.
to overwriteable media, to regular files, and to block devices.
.br .br
Can restore files from ISO image to disk filesystem (see osirrox). Can restore files from ISO image to disk filesystem (see osirrox).
.br .br
@ -305,7 +304,7 @@ To prevent a fatal intermingling of ISO image and text messages, all result
texts get redirected to stderr if -*dev "-" or "stdio:/dev/fd/1" is among texts get redirected to stderr if -*dev "-" or "stdio:/dev/fd/1" is among
the start arguments of the program. the start arguments of the program.
.br .br
Standard output is currently suitable for creating a single new session Standard output is currently suitable for creating one session
per program run without dialog. Use in other situations is discouraged per program run without dialog. Use in other situations is discouraged
and several restrictions apply: and several restrictions apply:
.br .br
@ -1974,7 +1973,7 @@ Copy modified ISO image from one media to another
.br .br
Write a ISO image into a pipe (single-session only) Write a ISO image into a pipe (single-session only)
.br .br
Perform a single session run as of cdrtools traditions Perform multi-session runs as of cdrtools traditions
.br .br
Adjust thresholds for verbosity, exit value and program abort Adjust thresholds for verbosity, exit value and program abort
.br .br
@ -2129,14 +2128,24 @@ first and only session to the output drive.
.br .br
| gzip >image.iso.gz | gzip >image.iso.gz
.SS .SS
.B Perform a single session run as of cdrtools traditions .B Perform multi-session runs as of cdrtools traditions
This shall illustrate how xorriso can act in either role. This shall illustrate how xorriso can act in either role.
Between both processes there can be performed arbitrary transportation Between both processes there can be performed arbitrary transportation
or filtering. or filtering.
.br .br
\fB$\fR xorriso -as mkisofs -J -R /home/prepared_for_iso/tree | \\ The first session is written like this:
.br .br
xorriso -as cdrecord -v dev=/dev/sr0 blank=fast -eject - \fB$\fR xorriso -as mkisofs prepared_for_iso/tree1 | \\
.br
xorriso -as cdrecord -v dev=/dev/sr0 blank=fast -multi -eject -
.br
Follow-up sessions are written like this:
.br
\fB$\fR m=$(xorriso -as cdrecord dev=/dev/sr0 -msinfo)
.br
\fB$\fR xorriso -as mkisofs -M /dev/sr0 -C $m prepared_for_iso/tree2 | \\
.br
xorriso -as cdrecord -v dev=/dev/sr0 -multi -eject -
.SS .SS
.B Let xorriso work underneath growisofs .B Let xorriso work underneath growisofs
growisofs expects an ISO formatter program which understands options -o, -C, growisofs expects an ISO formatter program which understands options -o, -C,

View File

@ -106,6 +106,7 @@ Changes file properties in the ISO image.
<LI> <LI>
Updates ISO subtrees incrementally to match given disk subtrees. Updates ISO subtrees incrementally to match given disk subtrees.
</LI> </LI>
<LI> <LI>
Can write result as completely new image to optical media or Can write result as completely new image to optical media or
filesystem objects. filesystem objects.
@ -114,6 +115,16 @@ filesystem objects.
Can write result as add-on session to appendable multi-session media, Can write result as add-on session to appendable multi-session media,
to overwriteable media, to regular files, and to block devices. to overwriteable media, to regular files, and to block devices.
</LI> </LI>
<!--
<LI>
Writes result as completely new image or as add-on session
to optical media or filesystem objects.
</LI>
<LI>
Can perform multi-session tasks as emulation of mkisofs and cdrecord.
</LI>
-->
<LI> <LI>
Can restore single files and whole trees from ISO image to disk filesystem. Can restore single files and whole trees from ISO image to disk filesystem.
</LI> </LI>
@ -379,8 +390,11 @@ New options -cpax, -cp_rx, -cp_rax to restore files and trees from ISO to disk
<LI>New options -C and -M for -as mkisofs emulation</LI> <LI>New options -C and -M for -as mkisofs emulation</LI>
<LI>Can serve growisofs if started as xorrisofs, genisofs, mkisofs, genisoimage <LI>Can serve growisofs if started as xorrisofs, genisofs, mkisofs, genisoimage
</LI> </LI>
<LI>make install creates xorriso aliases as symbolic links: osirrox, xorrisofs <LI>New options -multi and -msinfo for -as cdrecord emulation</LI>
<LI>make install creates xorriso aliases as symbolic links:
osirrox, xorrisofs, xorrecord
</LI> </LI>
<LI></LI>
<!-- <!--
<LI>- none yet -</LI> <LI>- none yet -</LI>
--> -->