diff --git a/xorriso/convert_man_to_html.sh b/xorriso/convert_man_to_html.sh index 6dee248a..5ae19e72 100755 --- a/xorriso/convert_man_to_html.sh +++ b/xorriso/convert_man_to_html.sh @@ -47,7 +47,7 @@ then -e 's/have a look at section EXAMPLES/have a look at section EXAMPLES<\/A>/' \ -e 's/Session model:<\/b>/\ 
Session model:<\/b>/' \ -e 's/Media types and states:<\/b>/\ 
Media types and states:<\/b>/' \ - -e 's/Creating, Growing, Modifying:<\/b>/\ 
Creating, Growing, Modifying:<\/b>/' \ + -e 's/Creating, Growing, Modifying, Blind Growing:<\/b>/\ 
Creating, Growing, Modifying, Blind Growing:<\/b>/' \ -e 's/Libburn drives:<\/b>/\ 
Libburn drives:<\/b>/' \ -e 's/^-dev /\ \ -dev /' \ -e 's/^-devices /\ \ -devices /' \ diff --git a/xorriso/xorriso.1 b/xorriso/xorriso.1 index 91ced2ac..37a477f9 100644 --- a/xorriso/xorriso.1 +++ b/xorriso/xorriso.1 @@ -50,11 +50,10 @@ Changes file properties in the ISO image. .br Updates ISO subtrees incrementally to match given disk subtrees. .br -Can write result as completely new image to optical media or -filesystem objects. +Writes result either as completely new image or as add-on session +to optical media or filesystem objects. .br -Can write result as add-on session to appendable multi-session media, -to overwriteable media, to regular files, and to block devices. +Can perform multi-session tasks as emulation of mkisofs and cdrecord. .br Can restore files from ISO image to disk filesystem (see osirrox). .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 the start arguments of the program. .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 and several restrictions apply: .br @@ -1974,7 +1973,7 @@ Copy modified ISO image from one media to another .br Write a ISO image into a pipe (single-session only) .br -Perform a single session run as of cdrtools traditions +Perform multi-session runs as of cdrtools traditions .br Adjust thresholds for verbosity, exit value and program abort .br @@ -2129,14 +2128,24 @@ first and only session to the output drive. .br | gzip >image.iso.gz .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. Between both processes there can be performed arbitrary transportation or filtering. .br -\fB$\fR xorriso -as mkisofs -J -R /home/prepared_for_iso/tree | \\ +The first session is written like this: .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 .B Let xorriso work underneath growisofs growisofs expects an ISO formatter program which understands options -o, -C, diff --git a/xorriso/xorriso_eng.html b/xorriso/xorriso_eng.html index 440529af..74688526 100644 --- a/xorriso/xorriso_eng.html +++ b/xorriso/xorriso_eng.html @@ -106,6 +106,7 @@ Changes file properties in the ISO image.
  • Updates ISO subtrees incrementally to match given disk subtrees.
  • +
  • Can write result as completely new image to optical media or filesystem objects. @@ -114,6 +115,16 @@ filesystem objects. Can write result as add-on session to appendable multi-session media, to overwriteable media, to regular files, and to block devices.
  • + +
  • Can restore single files and whole trees from ISO image to disk filesystem.
  • @@ -379,8 +390,11 @@ New options -cpax, -cp_rx, -cp_rax to restore files and trees from ISO to disk
  • New options -C and -M for -as mkisofs emulation
  • Can serve growisofs if started as xorrisofs, genisofs, mkisofs, genisoimage
  • -
  • make install creates xorriso aliases as symbolic links: osirrox, xorrisofs +
  • New options -multi and -msinfo for -as cdrecord emulation
  • +
  • make install creates xorriso aliases as symbolic links: +osirrox, xorrisofs, xorrecord
  • +