Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

xorrecord (1)

Name

xorrecord - Emulation of CD/DVD/BD program cdrecord by program xorriso

Synopsis

xorrecord [ options ] dev=device [track_source]

Description

XORRECORD(1)                General Commands Manual               XORRECORD(1)



NAME
       xorrecord -  Emulation of CD/DVD/BD program cdrecord by program xorriso

SYNOPSIS
       xorrecord [ options ] dev=device [track_source]

DESCRIPTION
       xorrecord writes preformatted data to CD, DVD, and BD media.

       It  understands some options of program cdrecord from cdrtools by Joerg
       Schilling.  Its implementation is part of program xorriso which  shares
       no  source  code  with  cdrtools,  but  rather makes use of libburn for
       communicating with the drive.
       Another, more complete cdrecord emulator is program cdrskin which  uses
       the same burn functions as xorrecord, but is able to burn audio CDs and
       to handle CD-TEXT.

   MMC, Session, Track, Media types:
       MMC is a standard out of the SCSI family which defines the  interaction
       between  computers and optical drives. Since more than a decade all CD,
       DVD, or BD recorders obey this standard regardless by what bus  cabling
       they  are  attached  to  the  computer. libburn relies on this standard
       compliance and on the capability of the  operating  system  to  perform
       SCSI transactions over the particular bus cabling.
       A  Session  is  a  data  region  on  an optical disc which usually gets
       written in a single sweep. It contains at least one Track  which  is  a
       contiguous  string  of  readable  blocks.   xorrecord produces a single
       session with a single data track which consists  of  blocks  with  2048
       bytes  each. It chooses the write mode automatically according to media
       type, medium state, and option -multi.
       On CD media there are other track types,  like  audio,  and  particular
       write  modes  like TAO and SAO. CD and DVD- media can put more than one
       track into a session. Some  of  these  features  can  be  addressed  by
       program cdrskin.
       MMC  describes  several  recordable  media types which roughly form two
       families.
       Sequentially recordable media are CD-R, CD-RW, DVD-R, DVD-R DL, DVD-RW,
       DVD+R,  DVD+R  DL,  BD-R.  Except DVD-R DL they can store more than one
       session if there is still unwritten space and if the  previous  session
       was  written  with  option  -multi.  CD-RW and DVD-RW can be blanked in
       order to be re-usable from scratch.
       Overwritable media are DVD-RAM, DVD+RW, formatted DVD-RW, BD-RE.   They
       offer  a  single session with a single track for random access writing.
       There is no need to blank overwritable media before re-use.
       DVD-RW media are sold in  sequentially  recordable  state  but  can  be
       formatted     once     to     become    overwritable.    See    options
       blank=format_overwrite and blank=deformat.
       If ISO 9660 filesystems are to be stored on overwritable media, then it
       is   possible   to   emulate   multiple   sessions,   by  using  option
       --grow_overwriteable_iso. In this case, the need  for  blanking  before
       re-use is emulated too.

   Drive preparation and addressing:
       The  drives,  CD,  DVD,  or BD burners, are accessed via file addresses
       which are specific to libburn and the operating system. Those addresses
       get listed by a run of xorrecord --devices or xorriso -device_links.
       On GNU/Linux, FreeBSD, and NetBSD, the user needs rw-permission for the
       device file.  On Solaris, the user  needs  r-permission  and  privilege
       "sys_devices", which is usually gained by running xorrecord via command
       pfexec.
       These permissions or privileges are needed already for listing a drive.
       So  it  might  be  necessary  to  get  the overview as superuser or via
       pfexec.
       xorrecord does not perform cdrecord option -scanbus and does not accept
       the  addresses  of  form Bus,Target,Lun which are told by -scanbus.  If
       support for these addresses  is  necessary,  consider  to  use  program
       cdrskin.
       It  is  possible  to  let  xorrecord  work  on  emulated drives.  Their
       addresses begin by prefix "stdio:" followed by  a  file  address.   The
       emulated  media behavior depends on the file type.  See man xorriso for
       details.
       If standard output is chosen as emulated drive, then all program result
       texts,  which usually appear on standard output, will get redirected to
       standard error.

   Relation to program xorriso:
       xorrecord is actually a command mode of  program  xorriso,  which  gets
       entered  either  by  xorriso  command "-as cdrecord" or by starting the
       program by one  of  the  names  "xorrecord",  "cdrecord",  "wodim",  or
       "cdrskin".
       This  command  mode can be left by argument "--" which leads to generic
       xorriso command mode. See man xorriso for its description.  Other  than
       in xorriso command mode, the sequence of the cdrecord emulation options
       does not matter.  All pending actions get performed in a fixed sequence
       before the program run ends or before cdrecord emulation ends.


OPTIONS
       Addressing the drive:

       --devices
              Print  the  list of accessible CD, DVD, or BD drives to standard
              output.  Drives might be  inaccessible  if  the  user  lacks  of
              permissions  to  use  them  or if the drive is in use by another
              program.
              Each accessible drive is shown by a line like:
                0  -dev '/dev/sr0' rwrw-- :  'TSSTcorp' 'CDDVDW SH-S203B'
              The libburn address of this drive is '/dev/sr0'.  'TSSTcorp'  is
              the  name  of  the vendor (in this case: Toshiba Samsung Storage
              Technologies Corporation), 'CDDVDW SH-S203B' is the  model  name
              (in this case: a DVD burner).
              Afterwards  end  emulation  without performing any further drive
              operation.

       dev=drive_address
              Set the libburn address of the drive to be used.
              E.g. on GNU/Linux: dev=/dev/sr0
              E.g. on FreeBSD: dev=/dev/cd0
              E.g. on NetBSD: dev=/dev/rcd0d
              E.g. on Solaris: dev=/dev/rdsk/c2t2d0s2
              See also above "Drive preparation and addressing".
              The medium in the drive should not be mounted or be otherwise in
              use.
              This  option  will  only  get  into  effect if a track source, a
              blank= option, or a drive inquiry option is given. Else it  will
              lead to a SORRY event and normally cause a non-zero exit value.

       Inquiring drive and media:

       -inq   Print  to  standard  output:  vendor,  model  name, and firmware
              revision of the drive.

       -checkdrive
              Print unconditionally that the drive supports burnfree, SAO, and
              TAO.  Also print the output of option -inq.

       -atip  Print the output of -checkdrive, the most capable profile of the
              medium in the drive, the list of profiles which are supported by
              the  drive,  whether  it  is erasable (i.e. can be blanked), the
              media manufacturer, and the medium product name.
              Profiles are usage models, which are often tied to a  particular
              media  type  (e.g.  CD-RW),  but  may  also apply to a family of
              media. E.g. profile CD-ROM applies to all CD media which contain
              data.

       -toc   Print  a table of content of the medium in the drive. The output
              is not compatible to cdrecord option -toc, but rather the one of
              xorriso command -toc.  It lists the address, vendor, model name,
              and firmware revision of the drive.
              About the medium it tells product name and manufacturer, whether
              there  is already content written, and if so, whether the medium
              is closed or  appendable.  Appendable  media  can  take  another
              session.   The amount of readable and writable data is told.  If
              there are sessions, then their start block address and  size  is
              reported.   If  a  session contains an ISO 9660 filesystem, then
              its Volume Id is reported.  If the medium is writable, then  the
              next writable block address is reported.
              If  not  option --grow_overwriteable_iso is given or no ISO 9660
              file system is present on the medium,  then  overwritable  media
              are  reported  as being blank. This is due to the fact that they
              can be written from scratch  without  further  preparation,  and
              that  MMC  does not distinguish between data written by the most
              previous burn run and older data which have not been overwritten
              by that burn run.  Consequently, these media are reported with 0
              readable blocks, although all their writable blocks normally are
              readable, too.

       -msinfo
              Print  the  argument  text  for  option  -C of programs mkisofs,
              genisoimage, or xorrisofs. It consists of two numbers  separated
              by a comma.
              The first number tells the first block of the first track of the
              last recorded session. This is also the address used by  default
              when  operating  systems  mount  a  medium  with  e.g.  ISO 9660
              filesystem.
              The  second  number  tells  the  next  writable  address,  where
              xorrecord will begin to write the next session.
              This  option is only valid for written, appendable media. In all
              other cases it will yield no output  text  but  will  abort  the
              program with non-zero exit value.

       Settings for the burn run:

       A  burn  run  requires exactly one track source address argument, which
       tells from where to read the data which shall be put into the upcomming
       session. The medium state must be either blank or appendable.
       Track source may be "-" for standard input or the address of a readable
       file of any type except directories. Nearly all media  types  accept  a
       track  source  with  unpredictable  byte  count, like standard input or
       named pipes.   Nevertheless,  DVD-R  DL  and  DVD-RW  blanked  by  mode
       deformat_quickest  demand  exact  in-advance  reservation  of the track
       size, so that they either need to be read from a source of  predictable
       length,  or  need  to  be  accompanied  by  option  tsize= or by option
       -isosize.
       Several options expect a size  value  as  argument.  A  number  with  a
       trailing letter "b" or without a trailing letter is a plain byte count.
       Other trailing letters cause multiplication of the given  number  by  a
       scaling factor:
       "k"  or  "K"  = 1024 , "m" or "M" = 1024k , "g" or "G" = 1024m , "s" or
       "S" = 2048
       E.g. tsize=234567s means a size of 234567 * 2048 = 480393216 bytes.

       blank=mode
              Blank a CD-RW or DVD-RW  to  make  it  re-usable  from  scratch.
              Format  a  DVD-RW,  DVD+RW,  DVD-RAM,  BD-R, or BD-RE if not yet
              formatted.
              This operation normally makes any recorded data  on  the  medium
              unreadable.   It  is  combinable with burning in the same run of
              xorrecord, or it  may  be  performed  without  a  track  source,
              leaving the medium empty.
              The mode given with blank= selects the particular behavior:

              as_needed
                     Try  to make the media ready for writing from scratch. If
                     it needs formatting, then format it. If it is not  blank,
                     then try to apply blank=fast.  It is a reason to abort if
                     the medium cannot assume thoroughly writeable state, e.g.
                     if it is a non-blank write-once.
                     This  leaves  unformatted  DVD-RW  in  unformatted  blank
                     state. To format DVD-RW use blank=format_overwrite. Blank
                     unformatted BD-R stay unformatted.
                     (Note:   blank=as_needed  is  not  an  original  cdrecord
                     option.)

              all
                     Blank an entire CD-RW or an unformatted DVD-RW.

              fast
                     Minimally blank an entire CD-RW or blank  an  unformatted
                     DVD-RW.

              deformat
                     Like  blank=all  but with the additional ability to blank
                     overwriteable DVD-RW.  This will destroy their formatting
                     and make them sequentially recordable.
                     (Note:   blank=deformat   is  not  an  original  cdrecord
                     options)

              deformat_quickest
                     Like blank=deformat but blanking DVD-RW  only  minimally.
                     This  is  faster  than  full  blanking  but  yields media
                     incapable  of  writing  tracks  of  unpredicatable  size.
                     Multi-session will not be possible either.
                     (Note:   blank=deformat_quickest   is   not  an  original
                     cdrecord option.)

              format_overwrite
                     Format a  DVD-RW  to  "Restricted  Overwrite".  The  user
                     should bring some patience.
                     Format  unformatted  DVD+RW, BD-RE or blank BD-R to their
                     default size.  It is not mandatory to do this with DVD+RW
                     and   BD-RE   media,  because  they  will  get  formatted
                     automatically on the first write attempt.
                     BD-R media may be  written  in  unformatted  state.  This
                     keeps  disabled the replacement of bad blocks and enables
                     full nominal write speed. Once BD-R  media  are  written,
                     they cannot be formatted any more.
                     For   re-formatting   already   formatted  media  or  for
                     formatting with non-default  size,  use  program  xorriso
                     with command -format.
                     (Note: blank=format_overwrite is not an original cdrecord
                     options)

              help
                     Print a short overview of blank modes to  standard  error
                     output.
                     Afterwards  end  emulation  without  performing any drive
                     operation.

       -multi This option keeps  CD,  unformatted  DVD-R[W],  DVD+R,  or  BD-R
              appendable  after the current session has been written.  Without
              it the disc gets closed and may  not  be  written  any  more   -
              unless  it  is  a -RW and gets blanked, which causes loss of its
              content.
              This option cannot be applied to DVD-R DL  or  to  DVD-RW  which
              were     blanked    by    mode    "deformat_quickest".    Option
              --multi_if_possible may automatically recognize and handle  this
              situation.
              In order to have all filesystem content accessible, the eventual
              ISO-9660 filesystem of a follow-up session needs to be  prepared
              in  a  special way by the filesystem formatter program. mkisofs,
              genisoimage, and xorrisofs  expect  particular  info  about  the
              situation which can be retrieved by xorrecord option -msinfo.
              With  overwriteable  DVD or BD media, -multi cannot mark the end
              of the session.  So when adding a new session, this end  has  to
              be   determined  from  the  payload.   Currently  only  ISO-9660
              filesystems   can    be    used    that    way.    See    option
              --grow_overwriteable_iso.

       -dummy Try  to  perform the drive operations without actually affecting
              the inserted media. There is no warranty  that  this  will  work
              with  a  particular  combination of drive and media. Blanking is
              prevented reliably, though.  To avoid inadverted  real  burning,
              -dummy  refuses  burn runs on anything but CD-R[W], DVD-R[W], or
              emulated stdio-drives.

       -waiti Wait until input data is available at stdin  or  EOF  occurs  at
              stdin.  Only then begin to access any drives.
              One should use this if xorrisofs is working at the end of a pipe
              where the feeder process reads from the drive before  it  starts
              writing its output into xorrisofs. Example:
              xorrisofs ... -C 0,12800 -M /dev/sr0 ... | \
              xorrecord dev=/dev/sr0 ... -waiti -
              This  option  works  even  if  standard  input  is not the track
              source. If no process is piping in, then the Enter key  of  your
              terminal will act as trigger for xorrecord. Note that this input
              line will not be consumed by cdrskin if standard  input  is  not
              the track source. It will end up as shell command, usually.

       tsize=size
              Announce  the  exact size of the track source. This is necessary
              with DVD-R DL media and with quickest  blanked  DVD-RW,  if  the
              size cannot be determined in advance from the track source. E.g.
              if it is standard input or a named pipe.
              If the track source does not deliver  the  predicted  amount  of
              bytes,  the remainder of the track is padded with zeros. This is
              not considered an error.  If on the other hand the track  source
              delivers  more  than the announced bytes then the track on media
              gets truncated to the predicted size and  xorrecord  exits  with
              non-zero value.

       -isosize
              Try  to  obtain  the  track  size  from the content of the track
              source.  This works only if the track source bears an  ISO  9660
              filesystem.   Any other track source content will cause the burn
              run to abort.
              If the track source is not a regular file or block device,  then
              this  option  will  work  only  if the program's fifo size is at
              least 64k. See option fs=.

       padsize=size
              Add the given amount of trailing zeros to the  upcomming  track.
              This  feature  can  be  disabled by size 0. Default is 300 kB in
              order to work around a problem with GNU/Linux which often  fails
              to  read  the last few blocks of a CD track which was written in
              write mode TAO. TAO is used  by  xorrecord  if  the  track  size
              cannot  be  predicted  or  if  the  CD  medium  is not blank but
              appendable.

       -nopad The same as padsize=0.

       -pad   The same as padsize=15s. This was  once  sufficient  with  older
              GNU/Linux   kernels.   Meanwhile   one   should   at  least  use
              padsize=128k, if not padsize=300k.

       -data  Explicitly announce that the track source shall be  recorded  as
              data  track,  and  not as audio track. This option has no effect
              with xorrecord, because there is  no  support  for  other  track
              formats anyway.

       -tao   Explicitly  demand  that write type TAO shall be used for CD, or
              Incremental for DVD-R. Normally  the  program  will  choose  the
              write  type  according to the given medium state, option -multi,
              and track source. Demanding it explicitly prevents the start  of
              a write run, if it is not appropriate to the situation.

       -sao   Explicitly  demand  that write type SAO shall be used for CD, or
              DAO for DVD-R.  This might prevent the write run, if it  is  not
              appropriate to the situation.

       -dao   Alias of -sao.

       fs=size
              Set  the  size  of  the  program  fifo buffer to the given value
              rather than the default of 4m.
              The fifo buffers a temporary surplus of  track  source  data  in
              order  to provide the drive with a steady stream during times of
              temporary lack of track source supply.
              Other than cdrecord, xorrecord  enables  drive  buffer  underrun
              protection  by  default and does not wait with writing until the
              fifo is full for a first time.  On very old CD drives  and  slow
              computers,  this  might  cause aborted burn runs.  In this case,
              consider to use program cdrskin for  CD  burning.   DVD  and  BD
              drives tolerate buffer underrun without problems.
              The  larger  the  fifo, the longer periods of poor source supply
              can be compensated. But a large fifo can deprive  the  operating
              system of read cache for better filesystem performance.

       speed=value
              Set the write speed. Default is 0 = maximum speed.  Speed can be
              given in media type dependent x-speed numbers or  as  a  desired
              throughput per second in MMC compliant kB (= 1000) or MB (= 1000
              kB). Media x-speed factor can be set explicitly by appending "c"
              for CD, "d" for DVD, "b" for BD. "x" is optional.
              Example speeds:
               706k = 706kB/s = 4c = 4xCD
               5540k = 5540kB/s = 4d = 4xDVD
              If  there  is  no  hint  about the speed unit attached, then the
              medium in the drive will decide.   Default  unit  is  CD,  1x  =
              176,400   raw   bytes/second.    With   DVD,   1x   =  1,385,000
              bytes/second.  With BD, 1x = 4,495,625 bytes/second.
              MMC drives usually activate their own idea of speed and take the
              speed  value  given by the burn program only as a hint for their
              own decision.

       minbuf=percentage
              Equivalent to:
               modesty_on_drive=<percentage>

       -immed Equivalent to:
               modesty_on_drive=75
              In cdrecord, this also controls  use  of  the  Immed  bit.   But
              xorriso  uses Immed where possible and appropriate, unless it is
              disabled by option use_immed_bit=off .

       -eject Eject the drive tray after alll other work is done.

       Program version and verbosity:

       -version
              Print to standard output a line beginning by
              "Cdrecord 2.01-Emulation Copyright"
              and further lines which report the version of  xorriso  and  its
              supporting  libraries.  They  also state the license under which
              the program is provided,  and  disclaim  any  warranty,  to  the
              extent permitted by law.
              Afterwards end emulation without performing any drive operation.

       -v     Increase   program  verbosity  by  one  level.  There  are  four
              verbosity levels from nearly silent to debugging verbosity.  The
              both  highest  levels can be enabled by repeated -v or by -vv or
              by -vvv.

       -V     Log SCSI commands and drive replies  to  standard  error.   This
              might  be  of  interest  if  xorrecord and a particular drive or
              medium do not cooperate as expected, or if you just want to know
              how  libburn  interacts  with  the  drive.   To  understand this
              extremely verbous log, one needs to read SCSI  specs  SPC,  SBC,
              and MMC.
              Please  do not add such a log to a bug report on the first hand,
              unless you want to point out a particular  deviation  from  said
              specs,  or  if  you  get  asked  for this log by a maintainer of
              xorrecord who feels in charge for your bug report.

       -help  Print a sparse list of program options  to  standard  error  and
              declare not to be cdrecord.
              Afterwards end emulation without performing any drive operation.

       Options not compatible to cdrecord:

       --no_rc
              Only if used as first command line argument this option prevents
              reading and interpretation of startup files. See  section  FILES
              below.

       drive_scsi_dev_family=sr|sdc|sg|default
              GNU/Linux specific:
              By  default,  cdrskin  tries  to  map  Linux  drive addresses to
              /dev/sr* before they get opened for operating  the  drive.  This
              coordinates  well  with  other use cases of optical drives, like
              mount(8). But since year 2010 all /dev/sr* share a  global  lock
              which allows only one drive to process an SCSI command while all
              others have to wait  for  its  completion.   This  yields  awful
              throughput  if  more  than  one  drive  is  writing  or  reading
              simultaneously.
              The global lock is not applied to device files /dev/sg* and also
              not with the system calls read(2), write(2). But ioctl(SG_IO) is
              affected, which is needed  to  perform  the  SCSI  commands  for
              optical burning.
              So  for  simultaneous  burn  runs  on  modern  GNU/Linux  it  is
              advisable to use drive_scsi_dev_family="sg". The drive addresses
              may  then  well  be  given as /dev/sr* but will nevertheless get
              used as /dev/sg*.

       --grow_overwriteable_iso
              Enable emulation of multi-session writing on overwriteable media
              which  contain an ISO 9660 filesystem. This emulation is learned
              from growisofs -M but adapted to the usage model of
              xorrecord -msinfo
              xorrisofs -C -M | xorrecord -waiti -multi -
              for sequential media.
              --grow_overwriteable_iso  does  not  hamper  the  use  of   true
              multi-session  media.   I.e.  it  is  possible  to  use the same
              xorrecord options with  both  kinds  of  media  and  to  achieve
              similar results if ISO 9660 filesystem images are to be written.
              This option implies option -isosize and therefore  demands  that
              the track source is a ISO 9660 filesystem image.
              With overwriteable media and no option blank=fast|all present it
              expands an eventual ISO 9660 filesystem on media. It is  assumed
              that  this  image's  inner size description points to the end of
              the valuable data.  Overwriteable media with a recognizable  ISO
              9660  size  will be regarded as appendable rather than as blank.
              I.e. options -msinfo and -toc will work.  -toc will always  show
              a  single  session with its size increasing with every added ISO
              9660 image.

       --multi_if_possible
              Apply option -multi if the medium is suitable. Not suitable  are
              DVD-R   DL   and   DVD-RW,   which   were   blanked   with  mode
              "deformat_quickest".
              Not all drives  correctly  recognize  such  fast-blanked  DVD-RW
              which need "on".  If there is well founded suspicion that a burn
              run failed due to -multi, then  this  causes  a  re-try  without
              -multi.

       stream_recording="on"|"off"|number
              Mode  "on" requests that compliance to the desired speed setting
              is preferred over management of write errors. With  DVD-RAM  and
              BD  this  can  bring  effective  write speed near to the nominal
              write speed  of  the  media.   But  it  will  also  disable  the
              automatic  use  of  replacement blocks if write errors occur. It
              might as well be disliked or ignored by the drive.
              If a number is given, then error management  stays  enabled  for
              all  byte  addresses  below that number. Any number below 16s is
              the same as "off".

       dvd_obs="default"|"32k"|"64k"
              Linux specific: Set the number of bytes to be  transmitted  with
              each write operation to DVD or BD media. Tracks get padded up to
              the next multiple of this write size. A  number  of  64  KB  may
              improve throughput with bus systems which show latency problems.
              The default depends on media type, option stream_recording=, and
              on compile time options.

       modesty_on_drive=parameter[:parameters]
              Control  whether  the  drive  buffer  shall be kept from getting
              completely filled.  Parameter "on" (or "1")  keeps  the  program
              from  trying to write to the burner drive while its buffer is in
              danger to be filled over a given  limit.   If  this  filling  is
              exceeded  then the program will wait until the filling reaches a
              given low percentage value.
              This can ease the load on operating system and drive  controller
              and  thus help with achieving better input bandwidth if disk and
              burner are not on independent controllers (like hda and hdb). It
              may  also help with simultaneous burns on different burners with
              Linux kernels like 3.16, if  one  has  reason  not  to  fix  the
              problem  by  drive_scsi_dev_family="sg".  On  the  other hand it
              increases the risk of buffer underflow and  thus  reduced  write
              speed.
              Some  burners  are  not suitable because they report buffer fill
              with granularity too coarse in size or  time,  or  expect  their
              buffer to be filled to the top before they go to full speed.
              Parameters "off" or "0" disable this feature.
              The  threshold  for  beginning  to  wait  is  given by parameter
              "max_percent=".  Parameter "min_percent=" defines the  threshold
              for  resuming  transmission.  Percentages are permissible in the
              range of 25 to 100. Numbers in this range  without  a  prepended
              name are interpreted as "on:min_percent=".
              E.g.: modesty_on_drive=75
              The optimal values depend on the buffer behavior of the drive.
              Parameter   "timeout_sec="   defines   after   which   time   of
              unsuccessful waiting the modesty shall be  disabled  because  it
              does not work.
              Parameter  "min_usec="  defines  the  initial sleeping period in
              microseconds.  If the drive buffer appears to be  too  full  for
              sending  more  data,  the  program  will wait the given time and
              inquire the buffer fill state again.  If repeated inquiry  shows
              not  enough  free space, the sleep time will slowly be increased
              to what parameter "max_usec=" defines.
              Parameters, which are not  mentioned  with  a  modesty_on_drive=
              option, stay unchanged.  Default is:
                modesty_on_drive=off:min_percent=90:max_percent=95:
                timeout_sec=120:min_usec=5000:max_usec=25000

       use_immed_bit="on"|"off"|"default"
              Control  whether  several  long  lasting  SCSI commands shall be
              executed with the Immed bit, which makes the commands end  early
              while  the  drive  operation  is  still  going  on. xorriso then
              inquires progress indication until the drive reports to be ready
              again.  If  this  feature  is  turned  off,  then  blanking  and
              formatting will show no progress indication.
              It may depend on the operating system whether -use_immed_bit  is
              set to "off" by default.

       write_start_address=value
              Set  the  block  address  on  overwritable  media where to start
              writing the track.  With DVD+RW, DVD-RAM or  BD-RE,  byte_offset
              must be aligned to 2 kiB blocks, but better is 32 kiB on DVD and
              64 kiB on  BD.   With  formatted  DVD-RW  32  kiB  alignment  is
              mandatory.
              Other media are not suitable for this option.

       stdio_sync="on"|"off"|number
              Set  the number of bytes after which to force output to emulated
              stdio: drives.  This forcing keeps the memory from being clogged
              with  lots of pending data for slow devices. Default "on" is the
              same as "16m".  Forced output can be disabled by "off".

EXAMPLES
   Overview of examples:
       Get an overview of drives and their addresses
       Get info about a particular drive or loaded media
       Prepare CD-RW or DVD-RW for re-use, BD-R for bad block handling
       Format DVD-RW to avoid need for blanking before re-use
       De-format DVD-RW to make it capable of multi-session again
       Write a single ISO 9660 filesystem image
       Write multiple ISO 9660 sessions
       Write ISO 9660 session on-the-fly
       Write compressed afio archive on-the-fly

   Get an overview of drives and their addresses:
         $ xorrecord --devices

   Get info about a particular drive and loaded media:
         $ xorrecord dev=/dev/sr0 -atip -toc --grow_overwriteable_iso

   Prepare CD-RW or DVD-RW for re-use:
         $ xorrecord -v dev=/dev/sr0 blank=as_needed -eject

   Format DVD-RW to avoid need for blanking before re-use:
         $ xorrecord -v dev=/dev/sr0 blank=format_overwrite -eject
       This command may also be used to format BD-R media before first use, in
       order  to  enable handling of write errors. Several hundred MB of spare
       blocks will be reserved and write runs on such media will perform  with
       less than half nominal speed.

   De-format DVD-RW to make it capable of multi-session again:
         $ xorrecord -v dev=/dev/sr0 blank=deformat

   Write a single ISO 9660 filesystem image:
         $ xorrecord -v dev=/dev/sr0 speed=12 fs=8m \
                     blank=as_needed -eject padsize=300k my_image.iso

   Write multiple ISO 9660 sessions:
       This  is  possible  with  all media except minimally blanked DVD-RW and
       DVD-R DL, which cannot do multi-session.
       The first session is written like in the previous example, except  that
       option -multi is used. It will contain the files of hard disk directory
       ./tree1 under the ISO 9660 directory /dir1:
         $ xorrisofs -o image_1.iso -J -graft-points /dir1=./tree1
         $ xorrecord -v dev=/dev/sr0 speed=12 fs=8m \
                     -multi --grow_overwriteable_iso \
                     blank=as_needed -eject padsize=300k image_1.iso
       For the second session xorrisofs needs to know the -msinfo  numbers  of
       the  medium.  Further  it  will  read data from the medium by using the
       system's read-only CD-ROM driver.
       It is advised to load the tray manually or via dd by the CD-ROM driver,
       rather  than  letting  xorrecord  do  this by its own SCSI driver. Many
       system CD-ROM drivers do not take notice of xorrecord's activities.
         $ dd if=/dev/sr0 count=1 >/dev/null 2>&1
       Now get the -msinfo numbers:
         $ m=$(xorrecord dev=/dev/sr0 -msinfo)
       and use them with xorrisofs to add ./tree2 to the image as /dir2:
         $ xorrisofs -M /dev/sr0 -C $m -o image_2.iso \
                     -J -graft-points /dir2=./tree2
       Now burn the new session  onto  the  same  medium.  This  time  without
       blanking:
         $ xorrecord -v dev=/dev/sr0 speed=12 fs=8m \
                     -multi --grow_overwriteable_iso \
                     -eject padsize=300k image_2.iso
       Operating  systems  which mount this medium will read the superblock of
       the second session and show both directories /dir1 and /dir2.

   Write ISO 9660 session on-the-fly:
       It is possible to combine the run  of  xorrisofs  and  xorrecord  in  a
       pipeline without storing the ISO 9660 image as file on hard disk:
         $ xorrisofs -M /dev/sr0 -C $m  \
                     -J -graft-points /dir2=./tree2 \
           | xorrecord -v dev=/dev/sr0 speed=12 fs=8m \
                       -waiti -multi --grow_overwriteable_iso \
                       -eject padsize=300k -
       This  is  also  the main use case of program xorriso itself, where this
       run would look like:
         $ xorriso -dev /dev/sr0 -joliet on -speed 12 -fs 8m \
                   -map ./tree2 /dir2 -commit_eject all

   Write compressed afio archive on-the-fly:
       This is possible with all media except  minimally  blanked  DVD-RW  and
       DVD-R  DL.   Since  the  compressed  output  stream is of very variable
       speed, a larger fifo is advised.  Nevertheless,  this  example  is  not
       suitable  for  very old CD drives which have no underrun protection and
       thus would abort the burn run on temporary data shortage.
         $ find . | afio -oZ - | \
           xorrecord -v dev=/dev/sr0 speed=12 fs=64m \
                     -multi padsize=300k -
       afio  archives  do  not  contain  references  to  absolute  data  block
       addresses.  So  they need no special precautions for multi-session. One
       may get the session start addresses by option -toc,  and  then  use  dd
       option  skip=  to  begin  reading  at  one of those addresses. E.g. for
       listing its content:
         $ dd if=/dev/sr0 bs=2048 skip=64046 | afio -tvZ -
       afio will know when the end of the archive is reached.

FILES
   Startup files:
       If not --no_rc is given as the first argument then  xorrecord  attempts
       on startup to read and execute lines from the following files:
          /etc/default/xorriso
          /etc/opt/xorriso/rc
          /etc/xorriso/xorriso.conf
          $HOME/.xorrisorc
       The  files  are  read  in  the sequence given here, but none of them is
       required to exist. The lines are not interpreted as  xorrecord  options
       but as generic xorriso commands. See man xorriso.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | media/xorriso    |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
SEE ALSO
       For generic xorriso command mode
              xorriso(1)

       Formatting track sources for xorrecord:
              xorrisofs(1), mkisofs(8), genisoimage(8), afio(1), star(1)

       Other programs which burn sessions to optical media
              growisofs(1), cdrecord(1), wodim(1), cdrskin(1)

BUGS
       To  report  bugs,  request  help,  or suggest enhancements for xorriso,
       please send electronic mail to the public  list  <bug-xorriso@gnu.org>.
       If more privacy is desired, mail to <scdbackup@gmx.net>.
       Please describe what you expect xorriso to do, the program arguments or
       dialog commands by which you tried  to  achieve  it,  the  messages  of
       xorriso, and the undesirable outcome of your program run.
       Expect to get asked more questions before solutions can be proposed.

AUTHOR
       Thomas Schmitt <scdbackup@gmx.net>
       for libburnia-project.org

COPYRIGHT
       Copyright (c) 2011 - 2017 Thomas Schmitt
       Permission  is granted to distribute this text freely. It shall only be
       modified in sync with the technical properties of xorriso. If you  make
       use  of the license to derive modified versions of xorriso then you are
       entitled to modify this text under that same license.

CREDITS
       xorriso is in part  based  on  work  by  Vreixo  Formoso  who  provides
       libisofs  together  with Mario Danic who also leads the libburnia team.
       Thanks to Andy Polyakov who invented emulated growing, to Derek Foreman
       and Ben Jansens who once founded libburn.
       Compliments  towards  Joerg  Schilling whose cdrtools served me for ten
       years.



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source                was                downloaded                from
       https://ftp.gnu.org/gnu/xorriso/xorriso-1.4.8.tar.gz

       Further information about this software can be found on the open source
       community website at https://www.gnu.org/software/xorriso.



                                                   Version 1.4.8, Sep 12, 2017
                                                                  XORRECORD(1)