cdrecord.man
上传用户:xiejiait
上传日期:2007-01-06
资源大小:881k
文件大小:57k
源码类别:

SCSI/ASPI

开发平台:

MultiPlatform

  1. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  2. NNNNAAAAMMMMEEEE
  3.      cdrecord - record audio or data Compact Discs from a master
  4. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  5.      ccccddddrrrreeeeccccoooorrrrdddd [ _g_e_n_e_r_a_l _o_p_t_i_o_n_s ] ddddeeeevvvv====_d_e_v_i_c_e [  _t_r_a_c_k  _o_p_t_i_o_n_s  ]
  6.      _t_r_a_c_k_1..._t_r_a_c_k_n
  7. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  8.      CCCCddddrrrreeeeccccoooorrrrdddd is used to record data or audio Compact Discs on an
  9.      Orange Book CD-Recorder.
  10.      The _d_e_v_i_c_e refers to _s_c_s_i_b_u_s/_t_a_r_g_e_t/_l_u_n of the  CD-Recorder.
  11.      Communication  on _S_u_n_O_S is done with the SCSI general driver
  12.      ssssccccgggg.... Other operating systems are using a library  simulation
  13.      of    this    driver.     Possible    syntax    is:     ddddeeeevvvv====
  14.      _s_c_s_i_b_u_s,_t_a_r_g_e_t,_l_u_n or ddddeeeevvvv==== _t_a_r_g_e_t,_l_u_n.  In the latter  case,
  15.      the  CD-Recorder has to be connected to the default SCSI bus
  16.      of  the  machine.   _S_c_s_i_b_u_s,  _t_a_r_g_e_t  and  _l_u_n  are  integer
  17.      numbers.  Some operating systems or SCSI transport implemen-
  18.      tations may require to specify a filename in  addition.   In
  19.      this  case  the  corect  syntax  for  the  device  is:  ddddeeeevvvv====
  20.      _d_e_v_i_c_e_n_a_m_e:_s_c_s_i_b_u_s,_t_a_r_g_e_t,  or  ddddeeeevvvv====  _d_e_v_i_c_e_n_a_m_e:_t_a_r_g_e_t,_l_u_n.
  21.      If  the  name  of the device node that has been specified on
  22.      such a system referres to exactly one SCSI device, a  short-
  23.      hand  in the form ddddeeeevvvv==== _d_e_v_i_c_e_n_a_m_e:@ or ddddeeeevvvv==== _d_e_v_i_c_e_n_a_m_e:@,_l_u_n
  24.      may be used instead of ddddeeeevvvv==== _d_e_v_i_c_e_n_a_m_e:_s_c_s_i_b_u_s,_t_a_r_g_e_t,
  25.      To make ccccddddrrrreeeeccccoooorrrrdddd portable to all UNIX platforms, the  syntax
  26.      ddddeeeevvvv====  _d_e_v_i_c_e_n_a_m_e:_s_c_s_i_b_u_s,_t_a_r_g_e_t, is preferred as is hides OS
  27.      specific knowledge about device  names  from  the  user.   A
  28.      specific  OS must not necessarily support a way to specify a
  29.      real   device   file   name   nor   a   way    to    specify
  30.      _s_c_s_i_b_u_s,_t_a_r_g_e_t,_l_u_n.
  31.      _S_c_s_i_b_u_s 0 is the default SCSI bus on the machine. Watch  the
  32.      boot   messages   for   more   information   or   look  into
  33.      ////vvvvaaaarrrr////aaaaddddmmmm////mmmmeeeessssssssaaaaggggeeeessss for more information about the SCSI confi-
  34.      guration  of  your  machine.  If you have problems to figure
  35.      out what values for _s_c_s_i_b_u_s,_t_a_r_g_e_t,_l_u_n should be  used,  try
  36.      the ----ssssccccaaaannnnbbbbuuuussss option of ccccddddrrrreeeeccccoooorrrrdddd described below.
  37.      If a file /etc/default/cdrecord exists, the parameter to the
  38.      ddddeeeevvvv==== option may also be a drive name label in said file (see
  39.      FILES section).
  40.      On SSSSVVVVrrrr4444 compliant systems, ccccddddrrrreeeeccccoooorrrrdddd uses the the  real  time
  41.      class  to  get  the  highest  scheduling  priotity  that  is
  42. Joerg Schilling     Last change: Version 1.8                    1
  43. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  44.      possible (higher than all  kernel  processes).   On  systems
  45.      with  PPPPOOOOSSSSIIIIXXXX  rrrreeeeaaaallll  ttttiiiimmmmeeee  sssscccchhhheeeedddduuuulllliiiinnnngggg  cdrecord uses real time
  46.      scheduling too, but may not be able to gain a priority  that
  47.      is higher than all kernel processes.
  48.      In _T_r_a_c_k _A_t _O_n_c_e mode, each _t_r_a_c_k corresponds  to  a  single
  49.      file that contains the prepared data for that track.  If the
  50.      argument is `----', standard input is used for that track. Only
  51.      one track may be taken from _s_t_d_i_n.
  52. GGGGEEEENNNNEEEERRRRAAAALLLL OOOOPPPPTTTTIIIIOOOONNNNSSSS
  53.      General options must be before any track file name or  track
  54.      option.
  55.      ----vvvveeeerrrrssssiiiioooonnnn
  56.           Print version information and exit.
  57.      ----vvvv    Increment the level of general verbosity by one.  This
  58.           is  used  e.g.  to  display the progress of the writing
  59.           process.
  60.      ----VVVV    Increment the verbose level in respect of SCSI command
  61.           transport  by one.  This helps to debug problems during
  62.           the writing process, that occur in the CD-Recorder.  If
  63.           you  get incomprehensible error messages you should use
  64.           this flag to get more detailed output.  ----VVVVVVVV  will  show
  65.           data buffer content in addition.  Using ----VVVV or ----VVVVVVVV slows
  66.           down the process and may be the  reason  for  a  buffer
  67.           underrun.  Using
  68.      ----ddddeeeebbbbuuuugggg
  69.           Print additional debug messages. This may help to  find
  70.           out problems with sector sizes and sector types.  Using
  71.           ----ddddeeeebbbbuuuugggg slows down the process and may be the reason for
  72.           a buffer underrun.
  73.      ----ffffoooorrrrcccceeee
  74.           Force  to  continue  on  some  errors.    This   option
  75.           currently implements some tricks that will allow you to
  76.           blank bad CD-RW disks.
  77.      ----dddduuuummmmmmmmyyyy
  78.           The CD-Recorder  will  go  through  all  steps  of  the
  79.           recording  process,  but the laser is turned off during
  80.           this procedure.  It is recommended to run several tests
  81.           before  actually writing to a Compact Disk, if the tim-
  82.           ing and load response of the system is not known.
  83.      ----ddddaaaaoooo  Set DDDDiiiisssskkkk AAAAtttt OOOOnnnncccceeee mmmmooooddddeeee.... This currently only works  with
  84.           MMC drives that support non raw SSSSeeeessssssssiiiioooonnnn AAAAtttt OOOOnnnncccceeee mode.
  85. Joerg Schilling     Last change: Version 1.8                    2
  86. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  87.      ----mmmmuuuullllttttiiii
  88.           Allow multi session CD's to be made. This flag needs to
  89.           be  present  on  all  sessions of a multi session disk,
  90.           except you want to create a session that  will  be  the
  91.           last  session  on the media.  The fixation will be done
  92.           in a way that allows the CD-Recorder  to  append  addi-
  93.           tional sessions later. This is done by generation a TOC
  94.           with a link to the next program area. The so  generated
  95.           media  is  not  100%  compatible  to  manufactured CD's
  96.           (except for CDplus). Use only for  recording  of  multi
  97.           session  CD's.   If this option is present, the default
  98.           track type is CCCCDDDD----RRRROOOOMMMM XXXXAAAA mmmmooooddddeeee 2222.  The _S_o_n_y  drives  have
  99.           no  hardware support for CCCCDDDD----RRRROOOOMMMM XXXXAAAA mmmmooooddddeeee 2222.  You have to
  100.           specify the ----ddddaaaattttaaaa option in order to create multi  ses-
  101.           sion  disks  on these drives.  As long as cdrecord does
  102.           not have a coder for converting data sectors  to  audio
  103.           sectors,  you need to force CCCCDDDD----RRRROOOOMMMM sectors by including
  104.           the ----ddddaaaattttaaaa option if you like to record  a  multisession
  105.           disk  in  DAO/SAO mode.  Not all drives allow multises-
  106.           sion CD's in DAO/SAO mode.
  107.      ----mmmmssssiiiinnnnffffoooo
  108.           Retrieve multi session info  in  a  form  suitable  for
  109.           mmmmkkkkiiiissssooooffffssss----1111....11110000 or later.
  110.           This option makes only sense with a CD that contains at
  111.           least one closed session and is appendable (not finally
  112.           closed yet). Some drives create error messages  if  you
  113.           try  to  get  the multi session info for a disk that is
  114.           not suitable for this operation.
  115.      ----ttttoooocccc  Retrieve and print out the table of content or PMA  of
  116.           a  CD.   With this option, ccccddddrrrreeeeccccoooorrrrdddd will work with CD-R
  117.           drives and with CD-ROM drives.
  118.      ----aaaattttiiiipppp
  119.           Retrieve and print out the ATIP (absolute Time in  Pre-
  120.           groove) info of a CD recordable or CD rewritable media.
  121.           With this option, ccccddddrrrreeeeccccoooorrrrdddd will  try  to  retrieve  the
  122.           ATIP info. If the actual drive does not support to read
  123.           the ATIP info, it may be that only  a  reduced  set  of
  124.           information  records or even nothing is displayed. Only
  125.           a limited number of MMC  compliant  drives  support  to
  126.           read the ATIP info.
  127.           If ccccddddrrrreeeeccccoooorrrrdddd is able to retrieve the lead-in start  time
  128.           for  the first session, it will try to decode and print
  129.           the manufacturer info from the media.
  130.      ----ffffiiiixxxx  The disk will only be fixated (i.e. a TOC  for  a  CD-
  131.           Reader  will be written). This may be used, if for some
  132.           reason the disk has been written but not fixated.  This
  133. Joerg Schilling     Last change: Version 1.8                    3
  134. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  135.           option currently does not work with TEAC drives.
  136.      ----nnnnooooffffiiiixxxx
  137.           Do not fixate the disk after writing the  tracks.  This
  138.           may  be  used  to create an audio disk in steps. An un-
  139.           fixated disk can usually not be used on a non CD-writer
  140.           type  drive but there are audio CD players that will be
  141.           able to play such a disk.
  142.      ----llllooooaaaadddd
  143.           Load the media and exit. This only works  with  a  tray
  144.           loading mechanism but seems to be useful when using the
  145.           Kodak disk transporter.
  146.      ----eeeejjjjeeeecccctttt
  147.           Eject disk after doing the work.   Some  Devices  (e.g.
  148.           Philips) need to eject the medium before creating a new
  149.           disk. Doing a -dummy test and  immediately  creating  a
  150.           real disk would not work on these devices.
  151.      ssssppppeeeeeeeedddd====####
  152.           Set the speed factor of the writing process to #.  # is
  153.           an integer, representing a multiple of the audio speed.
  154.           This is about 150 KB/s for CD-ROM and  about  172  KB/s
  155.           for  CD-Audio.  If no _s_p_e_e_d option is present, ccccddddrrrreeeeccccoooorrrrdddd
  156.           will try to get the  speed  value  from  the  CCCCDDDDRRRR____SSSSPPPPEEEEEEEEDDDD
  157.           environment.   If  your drive has problems with _s_p_e_e_d=_2
  158.           or _s_p_e_e_d=_4, you should try _s_p_e_e_d=_0.
  159.      bbbbllllaaaannnnkkkk====_t_y_p_e
  160.           Blank a CD-RW and exit or blank a CD-RW before writing.
  161.           The blanking type may be one of:
  162.           help        Display a list of possible blanking types.
  163.           all         Blank the entire disk. This may take a long
  164.                       time.
  165.           fast        Minimally blank the disk. This  results  in
  166.                       erasing the PMA, the TOC and the pregap.
  167.           track       Blank a track.
  168.           unreserve   Unreserve a reserved track.
  169.           trtail      Blank the tail of a track.
  170.           unclose     Unclose last session.
  171.           session     Blank the last session.
  172.      If used together with the ----ffffoooorrrrcccceeee flag, this  option  may  be
  173.      used  to blank CD-RW disks that otherwise cannot be blanked.
  174. Joerg Schilling     Last change: Version 1.8                    4
  175. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  176.      Note that you may need to  specify  bbbbllllaaaannnnkkkk====_a_l_l  because  some
  177.      drives  will  not  continue  with certain types of bad CD-RW
  178.      disks. Note also that ccccddddeeeeccccoooorrrrdddd does it's best if the  ---- ffffoooorrrrcccceeee
  179.      flag  is used but it finally depends on the drive's firmware
  180.      whether the blanking operation will succeed or not.
  181.      ffffssss====# Set the fifo (ring buffer) size to #.  You may use  the
  182.           same method as in dddddddd(1), ssssdddddddd(1) or ssssttttaaaarrrr(1).  The number
  183.           representing the size is taken in bytes  unless  other-
  184.           wise  specified.   If  a number is followed directly by
  185.           the letter `b', `k', `m', `s' of `f', the size is  mul-
  186.           tiplied  by 512, 1024, 1024*1024, 2048 or 2352.  If the
  187.           size consists of numbers separated by `x' or `*',  mul-
  188.           tiplication  of  the  two  numbers  is performed.  Thus
  189.           _f_s=_1_0_x_6_3_k will specify a fifo size of 630 kBytes.
  190.           The size specified by the  _f_s=  argument  includes  the
  191.           shared  memory  that is needed for administration. This
  192.           is at least one page of memory.  If no  _f_s=  option  is
  193.           present,  ccccddddrrrreeeeccccoooorrrrdddd  will try to get the fifo size value
  194.           from the CCCCDDDDRRRR____FFFFIIIIFFFFOOOOSSSSIIIIZZZZEEEE environment.   The  default  fifo
  195.           size is currently 4 MB.
  196.           The fifo is used to increase  buffering  for  the  real
  197.           time  writing  process.   It  allows to run a pipe from
  198.           mmmmkkkkiiiissssooooffffssss directly into ccccddddrrrreeeeccccoooorrrrdddd.  If the fifo is  active
  199.           and a pipe from mmmmkkkkiiiissssooooffffssss into ccccddddrrrreeeeccccoooorrrrdddd is used to create
  200.           a CD, ccccddddrrrreeeeccccoooorrrrdddd will abort prior to do any modifications
  201.           on  the  disk if mmmmkkkkiiiissssooooffffssss dies before it starts writing.
  202.           The recommended fifo size is between 4 and  32  MBytes.
  203.           As  a  rule  of thumb, the fifo size should be at least
  204.           equal to the size of the internal  buffer  of  the  CD-
  205.           Recorder  and  no more than half of the physical amount
  206.           of RAM available in the machine.  If the fifo  size  is
  207.           big enough, the fifo statistics will print a fifo empty
  208.           count of zero and the fifo min fill is not  below  20%.
  209.           It  is  not wise to use too much space for the fifo. If
  210.           you need more than 8 MB  to  write  a  CD  on  an  idle
  211.           machine,  your  machine  is  either  underpowered,  has
  212.           hardware problems  or  is  mis-configured.   The  sun4c
  213.           architecture  (e.g. a Sparcstation-2) has only MMU page
  214.           table entries for 16 MBytes  per  process.  Using  more
  215.           than  14  MBytes  for  the fifo may cause the operating
  216.           system in this case to spend much  time  to  constantly
  217.           reload  the  MMU tables. Newer machines from Sun do not
  218.           have this MMU hardware problem. I have  no  information
  219.           on PC-hardware reflecting this problem.
  220.           If you have buffer underruns or  similar  problems  and
  221.           observe  a  zero  _f_i_f_o  _e_m_p_t_y  _c_o_u_n_t, you have hardware
  222.           problems. The fifo size in this case is sufficient.
  223. Joerg Schilling     Last change: Version 1.8                    5
  224. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  225.      ddddeeeevvvv====_t_a_r_g_e_t
  226.           Sets the SCSI target for  the  CD-Recorder,  see  notes
  227.           above.  A typical device specification is ddddeeeevvvv====_6,_0 .  If
  228.           a filename must be provided together with the numerical
  229.           target  specification,  the  filename is implementation
  230.           specific.  The correct filename in  this  case  can  be
  231.           found  in  the  system  specific  manuals of the target
  232.           operating system.  On a _F_r_e_e_B_S_D system without _C_A_M sup-
  233.           port,   you  need  to  use  the  control  device  (e.g.
  234.           /_d_e_v/_r_c_d_0._c_t_l).  A correct device specification in this
  235.           case may be ddddeeeevvvv====/_d_e_v/_r_c_d_0._c_t_l:@ .
  236.           On Linux, drives connected to a parallel  port  adapter
  237.           are  mapped  to  a virtual SCSI bus. Different adapters
  238.           are mapped to different targets on  this  virtual  SCSI
  239.           bus.
  240.           If no _d_e_v option is present, ccccddddrrrreeeeccccoooorrrrdddd will try  to  get
  241.           the device from the CCCCDDDDRRRR____DDDDEEEEVVVVIIIICCCCEEEE environment.
  242.           If the argument to the ddddeeeevvvv==== option does not contain the
  243.           characters  ',',  '/', '@' or ':', it is interpreted as
  244.           an  label  name  that  may  be  found   in   the   file
  245.           /etc/default/cdrecord (see FILES section).
  246.      ttttiiiimmmmeeeeoooouuuutttt====#
  247.           Set the default SCSI command timeout value to  #.   The
  248.           default  SCSI  command  timeout  is the minimum timeout
  249.           used for sending SCSI  commands.   If  a  SCSI  command
  250.           fails  due  to  a  timeout,  you  may  try to raise the
  251.           default SCSI command timeout above the timeout value of
  252.           the failed command.  If the command runs correctly with
  253.           a raised command  timeout,  please  report  the  better
  254.           timeout  value  and  the  corresponding  command to the
  255.           author  of  the  program.   If  no  _t_i_m_e_o_u_t  option  is
  256.           present, a default timeout of 40 seconds is used.
  257.      ddddrrrriiiivvvveeeerrrr====_n_a_m_e
  258.           Allows to use a user supplied driver name for the  dev-
  259.           ice.    To   get   a   list  of  possible  drivers  use
  260.           ddddrrrriiiivvvveeeerrrr====hhhheeeellllpppp.  The reason  for  the  existence  of  this
  261.           option  is  to  allow users to use ccccddddrrrreeeeccccoooorrrrdddd with drives
  262.           that are similar to  supported  drives  but  not  known
  263.           directly  by  ccccddddrrrreeeeccccoooorrrrdddd.   Use  this option with extreme
  264.           care. If a wrong driver is used for a device, the  pos-
  265.           sibility  of  creating  corrupted  disks  is high.  The
  266.           minimum problem related to a wrong driver is that the ----
  267.           ssssppppeeeeeeeedddd or ----dddduuuummmmmmmmyyyy will not work.
  268.           There are two  special  driver  entries  in  the  list:
  269.           ccccddddrrrr____ssssiiiimmmmuuuullll  and  ddddvvvvdddd____ssssiiiimmmmuuuullll.   These  driver  entries are
  270.           designed to make timing tests at any  speed  or  timing
  271. Joerg Schilling     Last change: Version 1.8                    6
  272. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  273.           tests for drives that do not support the ----dddduuuummmmmmmmyyyy option.
  274.           The simulation drivers implement a drive with a  buffer
  275.           size   of   1MB   that   can   be   changed   via   the
  276.           CCCCDDDDRRRR____SSSSIIIIMMMMUUUULLLL____BBBBUUUUFFFFSSSSIIIIZZZZEEEE environment variable.  The simultaion
  277.           driver  correctly simulates even a buffer underrun con-
  278.           dition.  If the ----dddduuuummmmmmmmyyyy option is  present,  the  simul-
  279.           taion is not aborted in case of a buffer underrun.
  280.      ----cccchhhheeeecccckkkkddddrrrriiiivvvveeee
  281.           Checks if a driver for the current drive is present and
  282.           exit.   If  the  drive  is a known drive, ccccddddrrrreeeeccccoooorrrrdddd uses
  283.           exit code 0.
  284.      ----pppprrrrccccaaaapppp
  285.           Print the drive capabilities for  SCSI-3/mmc  compliant
  286.           drives  as  obtained from mode page 0x2A. Values marked
  287.           with _k_B use 1000 bytes as kilo-byte, values marked with
  288.           _K_B use 1024 bytes as Kilo-byte.
  289.      ----iiiinnnnqqqq  Do an inquiry for the drive, print  the  inquiry  info
  290.           and exit.
  291.      ----ssssccccaaaannnnbbbbuuuussss
  292.           Scan all SCSI devices on all SCSI busses and print  the
  293.           inquiry  strings.  This option may be used to find SCSI
  294.           address of the CD-Recorder on a  system.   The  numbers
  295.           printed out as labels are computed by: bbbbuuuussss **** 111100000000 ++++ ttttaaaarrrr----
  296.           ggggeeeetttt
  297.      ----rrrreeeesssseeeetttt
  298.           Try to reset the SCSI bus  where  the  CD  recorder  is
  299.           located. This works not on all operating systems.
  300.      ----iiiiggggnnnnssssiiiizzzzeeee
  301.           Ignore the known  size  of  the  medium.  This  options
  302.           should  be  used  with extreme care, it exists only for
  303.           debugging purposes don't use it for other reasons.   It
  304.           is not needed to write disks with more than the nominal
  305.           capacity.
  306.      ----uuuusssseeeeiiiinnnnffffoooo
  307.           Use *.inf files to overwrite audio  options.   If  this
  308.           option  is  used,  the  pregap size information is read
  309.           from the *.inf file that is associated  with  the  file
  310.           that contains the audio data for a track.
  311.      ddddeeeeffffpppprrrreeeeggggaaaapppp=#
  312.           Set the default pre-gap  size  for  all  tracks  except
  313.           track number 1.  This option currently only makes sense
  314.           with the TEAC drive when creating  track-at-once  disks
  315.           without the 2 second silence before each track.
  316. Joerg Schilling     Last change: Version 1.8                    7
  317. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  318.           This option may go away in future.
  319.      ----ppppaaaacccckkkkeeeetttt
  320.           Set PPPPaaaacccckkkkeeeetttt wwwwrrrriiiittttiiiinnnngggg mmmmooooddddeeee.... This is an experimental inter-
  321.           face.
  322.      ppppkkkkttttssssiiiizzzzeeee=#
  323.           Set the paket size to  #,  forces  fixed  packet  mode.
  324.           This is an experimental interface.
  325.      ----nnnnoooocccclllloooosssseeee
  326.           Do not close the current track,  useful  only  when  in
  327.           packet  writing  mode.   This is an experimental inter-
  328.           face.
  329.      mmmmccccnnnn====mmmmeeeedddd____ccccaaaatttt____nnnnrrrr
  330.           Set the MMMMeeeeddddiiiiaaaa CCCCaaaattttaaaalllloooogggg NNNNuuuummmmbbbbeeeerrrr of the CD to _m_e_d__c_a_t__n_r.
  331. TTTTRRRRAAAACCCCKKKK OOOOPPPPTTTTIIIIOOOONNNNSSSS
  332.      Track options may be mixed with track file names.
  333.      iiiissssrrrrcccc====IIIISSSSRRRRCCCC____nnnnuuuummmmbbbbeeeerrrr
  334.           Set the IIIInnnntttteeeerrrrnnnnaaaattttiiiioooonnnnaaaallll SSSSttttaaaannnnddddaaaarrrrdddd RRRReeeeccccoooorrrrddddiiiinnnngggg NNNNuuuummmmbbbbeeeerrrr for the
  335.           next track to _I_S_R_C__n_u_m_b_e_r.
  336.      iiiinnnnddddeeeexxxx====_l_i_s_t
  337.           Sets an index list for the next track.  In  index  list
  338.           is  a comma separated list of numbers that are counting
  339.           from index 1. The first entry in this list must contain
  340.           a 0, the following numbers must be an ascending list of
  341.           numbers (counting in 1/75 seconds) that  represent  the
  342.           start  of  the  indices.  An  index  list  in the form:
  343.           0,7500,15000 sets index 1 to the start  of  the  track,
  344.           index  2  100  seconds  from the start of the track and
  345.           index 3 200 seconds from the start of the track.
  346.      ----aaaauuuuddddiiiioooo
  347.           If this flag is  present,  all  subsequent  tracks  are
  348.           written  in  CCCCDDDD----DDDDAAAA  (similar to Red Book) audio format.
  349.           The file with  data  for  this  tracks  should  contain
  350.           stereo, 16-bit digital audio with 44100 samples/s.  The
  351.           byte order should be the following: MSB left, LSB left,
  352.           MSB  right,  LSB  right,  MSB left and so on. The track
  353.           should be a multiple of 2352 bytes. It is not  possible
  354.           to put the master image of an audio track on a raw disk
  355.           because data will be read in  multiple  of  2352  bytes
  356.           during the recording process.
  357.           If a filename ends in ._a_u or  ._w_a_v  the  file  is  con-
  358.           sidered  to  be a structured audio data file.  CCCCddddrrrreeeeccccoooorrrrdddd
  359.           assumes that the file in this case is a Sun audio  file
  360. Joerg Schilling     Last change: Version 1.8                    8
  361. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  362.           or  a  Microsoft  .WAV file and extracts the audio data
  363.           from the files by skipping over  the  non-audio  header
  364.           information.   In  all  other cases, cdrecord will only
  365.           work correctly if the audio data stream does  not  have
  366.           any header.  Because many structured audio files do not
  367.           have an integral number of blocks  (1/75th  second)  in
  368.           length,  it  is  often  necessary  to  specify the ----ppppaaaadddd
  369.           option as well.  ccccddddrrrreeeeccccoooorrrrdddd recognizes that audio data in
  370.           a  .WAV  file  is  stored in Intel (little-endian) byte
  371.           order, and will automatically byte-swap the data if the
  372.           CD  recorder  requires  big-endian  data. CCCCddddrrrreeeeccccoooorrrrdddd will
  373.           reject any audio file that does not match the Red  Book
  374.           requirements  of 16-bit stereo samples in PCM coding at
  375.           44100 samples/second.
  376.           Using other structured audio data formats as  input  to
  377.           ccccddddrrrreeeeccccoooorrrrdddd will usually work if the structure of the data
  378.           is the structure described above (raw pcm data in  big-
  379.           endian  byte  order).   However,  if  the  data  format
  380.           includes a header, you will hear a click at  the  start
  381.           of a track.
  382.           If neither -_d_a_t_a  nor   - _a_u_d_i_o  have  been  specified,
  383.           ccccddddrrrreeeeccccoooorrrrdddd  defaults to -_a_u_d_i_o for all filenames that end
  384.           in ._a_u or ._w_a_v and to -_d_a_t_a for all other files.
  385.      ----sssswwwwaaaabbbb
  386.           If this flag is present, audio data is assumed to be in
  387.           byte-swapped  (little-endian) order.  Some types of CD-
  388.           Writers e.g. Yamaha, Sony and the new SCSI-3/mmc drives
  389.           require  audio  data  to  be presented in little-endian
  390.           order, while other writers require  audio  data  to  be
  391.           presented  in  the big-endian (network) byte order nor-
  392.           mally used by the SCSI protocol.  CCCCddddrrrreeeeccccoooorrrrdddd knows  if  a
  393.           CD-Recorder  needs  audio data in big- or little-endian
  394.           order, and corrects the byte order of the  data  stream
  395.           to match the needs of the recorder.  You only need the
  396.           -_s_w_a_b flag if your data stream  is  in  Intel  (little-
  397.           endian) byte order.
  398.           Note that the verbose output of ccccddddrrrreeeeccccoooorrrrdddd will show  you
  399.           if  swapping is necessary to make the byte order of the
  400.           input data fit the required byte order of the recorder.
  401.           CCCCddddrrrreeeeccccoooorrrrdddd  will not show you if the -_s_w_a_b flag was actu-
  402.           ally present for a track.
  403.      ----ddddaaaattttaaaa
  404.           If this flag is  present,  all  subsequent  tracks  are
  405.           written in CCCCDDDD----RRRROOOOMMMM mmmmooooddddeeee 1111 (Yellow Book) format. The data
  406.           is a multiple of 2048 bytes.  The file with track  data
  407.           should  contain  an  IIIISSSSOOOO----9999666666660000  or RRRRoooocccckkkk RRRRiiiiddddggggeeee filesystem
  408.           image (see mmmmkkkkiiiissssooooffffssss for more details). If the track data
  409. Joerg Schilling     Last change: Version 1.8                    9
  410. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  411.           is an uuuuffffssss filesystem image, fragment size should be set
  412.           to 2 KB or more to allow CR-drives  with  2  KB  sector
  413.           size to to be used for reading.
  414.           -data is the default, if no other flag is present.
  415.           If neither -_d_a_t_a  nor   - _a_u_d_i_o  have  been  specified,
  416.           ccccddddrrrreeeeccccoooorrrrdddd  defaults to -_a_u_d_i_o for all filenames that end
  417.           in ._a_u or ._w_a_v and to -_d_a_t_a for all other files.
  418.      ----mmmmooooddddeeee2222
  419.           If this flag is  present,  all  subsequent  tracks  are
  420.           written in CCCCDDDD----RRRROOOOMMMM mmmmooooddddeeee 2222 format. The data is a multiple
  421.           of 2048 bytes.
  422.      ----xxxxaaaa1111  If this flag is present,  all  subsequent  tracks  are
  423.           written  in CCCCDDDD----RRRROOOOMMMM XXXXAAAA mmmmooooddddeeee 1111 format. The data is a mul-
  424.           tiple of 2048 bytes.
  425.      ----xxxxaaaa2222  If this flag is present,  all  subsequent  tracks  are
  426.           written  in CCCCDDDD----RRRROOOOMMMM XXXXAAAA mmmmooooddddeeee 2222 format. The data is a mul-
  427.           tiple of 2048 bytes.
  428.      ----ccccddddiiii  If this flag is present,  all  subsequent  tracks  are
  429.           written  in  CCCCDDDDIIII format. The data is a multiple of 2048
  430.           bytes.
  431.      ----iiiissssoooossssiiiizzzzeeee
  432.           Use the IIIISSSSOOOO----9999666666660000 file system size as the  size  of  the
  433.           next  track.  This option is needed if you want to read
  434.           the image of a track from a raw disk partition or on  a
  435.           master  CD.  In  the  first case the option ----iiiissssoooossssiiiizzzzeeee is
  436.           needed to limit the size of the CD to the size  of  the
  437.           ISO filesystem.  In the second case the option ----iiiissssoooossssiiiizzzzeeee
  438.           is needed to prevent ccccddddrrrreeeeccccoooorrrrdddd from reading the two  run
  439.           out  blocks  that  are  appended by each CD-recorder in
  440.           track at once mode. These two run out blocks cannot  be
  441.           read  and  would  cause  a  buffer under run that would
  442.           cause a defective copy.  Do  not  use  this  option  if
  443.           ccccddddrrrreeeeccccoooorrrrdddd  reads the track data from _s_t_d_i_n.  This option
  444.           currently cannot be used to determine  the  size  of  a
  445.           file system if the multi session option is present.
  446.      ----ppppaaaadddd  If the track is a data track,  15  sectors  of  zeroed
  447.           data  will  be added to the end of this and each subse-
  448.           quent data track.  In this case, the  ---- ppppaaaadddd  option  is
  449.           superseded  by the ppppaaaaddddssssiiiizzzzeeee==== option. It will remain how-
  450.           ever as a shorthand for  ppppaaaaddddssssiiiizzzzeeee====11115555ssss....   If  the   - _p_a_d
  451.           option  refers to an audio track, ccccddddrrrreeeeccccoooorrrrdddd will pad the
  452.           audio data to be a multiple of 2352  bytes.  The  audio
  453.           data  padding is done with binary zeroes which is equal
  454.           to absolute silence.
  455. Joerg Schilling     Last change: Version 1.8                   10
  456. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  457.           ----ppppaaaadddd remains valid until disabled by ----nnnnooooppppaaaadddd.
  458.      ppppaaaaddddssssiiiizzzzeeee====#
  459.           Set the amount of data to be appended as padding to the
  460.           next  track  to #.  Opposed to the behavior of the ----ppppaaaadddd
  461.           option, the value for _p_a_d_s_i_z_e= is  reset  to  zero  for
  462.           each new track.  See ffffssss= option for possible arguments.
  463.           Use this option if your CD-drive is not  able  to  read
  464.           the  last  sectors of a track or if you want to be able
  465.           to read the CD on a  LLLLiiiinnnnuuuuxxxx  system  with  the  ISO-9660
  466.           filesystem  read  ahead  bug.  If an empty file is used
  467.           for track data, this option may be  used  to  create  a
  468.           disk that is entirely made of padding.
  469.      ----nnnnooooppppaaaadddd
  470.           Do not pad the following tracks - the default.
  471.      pppprrrreeeeggggaaaapppp=#
  472.           Set the  pre-gap size for the next track.  This  option
  473.           currently  only  makes  sense  with the TEAC drive when
  474.           creating  track-at-once  disks  without  the  2  second
  475.           silence before each track.
  476.           This option may go away in future.
  477.      ----pppprrrreeeeeeeemmmmpppp
  478.           If this flag is present, all TOC entries for subsequent
  479.           audio tracks will indicate that the audio data has been
  480.           sampled with 50/15 祍ec preemphasis.  The data, however
  481.           is not modified during the process of transferring from
  482.           file to disk. This option has no effect on data tracks.
  483.      ----nnnnoooopppprrrreeeeeeeemmmmpppp
  484.           If this flag is present, all TOC entries for subsequent
  485.           audio tracks will indicate that the audio data has been
  486.           mastered with linear data - this is the default.
  487.      ttttssssiiiizzzzeeee====####
  488.           If the master image for the next track has been  stored
  489.           on  a  raw  disk,  use this option to specify the valid
  490.           amount of data on this disk. If the image of  the  next
  491.           track  is  stored  in  a regular file, the size of that
  492.           file is taken to determine the length  of  this  track.
  493.           If  the track contains an ISO 9660 filesystem image use
  494.           the -_i_s_o_s_i_z_e option to determine  the  length  of  that
  495.           filesystem image.
  496.           In Disk at Once mode and with some drives that use  the
  497.           TEAC programming interface, even in Track at Once mode,
  498.           ccccddddrrrreeeeccccoooorrrrdddd needs to know the size of  each  track  before
  499.           starting  to  write the disk.  Cdrecord now checks this
  500.           and aborts before starting to write.  If  this  happens
  501.           you will need to run mmmmkkkkiiiissssooooffffssss ----pppprrrriiiinnnntttt----ssssiiiizzzzeeee before and use
  502.           the output as an  argument  to  the  ttttssssiiiizzzzeeee=  option  of
  503. Joerg Schilling     Last change: Version 1.8                   11
  504. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  505.           ccccddddrrrreeeeccccoooorrrrdddd.
  506.           See ffffssss= option for possible arguments.
  507. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  508.      For all examples below, it will  be  assumed  that  the  CD-
  509.      Recorder  is  connected  to  the  primary  SCSI  bus  of the
  510.      machine. The SCSI target id is set to 2.
  511.      To record a pure CD-ROM at double speed, using data from the
  512.      file _c_d_i_m_a_g_e._r_a_w:
  513.          cdrecord -v speed=2 dev=2,0 cdimage.raw
  514.      To create an image for a ISO 9660 filesystem with Rock Ridge
  515.      extensions:
  516.          mkisofs -R -o cdimage.raw /home/joerg/master/tree
  517.      To check the resulting file before writing to CD on Solaris:
  518.          mount -r -F fbk -o type=hsfs /dev/fbk0:cdimage.raw /mnt
  519.      On Linux:
  520.          mount cdimage.raw -r -t iso9660 -o loop /mnt
  521.      Go on with:
  522.          ls -lR /mnt
  523.          umount /mnt
  524.      If the overall speed of the system  is  sufficient  and  the
  525.      structure  of  the  filesystem  is not too complex, cdrecord
  526.      will run without creating an image of the ISO 9660  filesys-
  527.      tem. Simply run the pipeline:
  528.          mkisofs -R /master/tree |  cdrecord  - v  fs=6m  speed=2
  529.      dev=2,0 -
  530.      The recommended minimum fifo size for running this  pipeline
  531.      is  4  MBytes.   As  the  default fifo size is 4 MB, the ffffssss====
  532.      option needs only be present if you want to use a  different
  533.      fifo size.  If your system is loaded, you should run mkisofs
  534.      in the real time  class  too.   To  raise  the  priority  of
  535.      mmmmkkkkiiiissssooooffffssss replace the command
  536.          mkisofs -R /master/tree
  537.      by
  538.          priocntl -e -c RT -p 59 mkisofs -R /master/tree
  539.      on Solaris and by
  540. Joerg Schilling     Last change: Version 1.8                   12
  541. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  542.          nice --18 mkisofs -R /master/tree
  543.      on systems that  don't  have  UUUUNNNNIIIIXXXX  IIIInnnntttteeeerrrrnnnnaaaattttiiiioooonnnnaaaallll  compliant
  544.      realtime scheduling.
  545.      Cdrecord runs at priority 59  on  Solaris,  you  should  run
  546.      mkisofs  at  no more than priority 58. On other systems, you
  547.      should run mkisofs at no less than nice --18.
  548.      Creating a CD-ROM without file system image on disk has been
  549.      tested  on  a  Sparcstation-2  with a Yamaha CDR-400. It did
  550.      work up to quad speed when the machine was  not  loaded.   A
  551.      faster  machine may be able to handle quad speed also in the
  552.      loaded case.
  553.      To record a pure CD-DA (audio) at single  speed,  with  each
  554.      track   contained   in   a   file   named   _t_r_a_c_k_0_1._c_d_a_u_d_i_o,
  555.      _t_r_a_c_k_0_2._c_d_a_u_d_i_o, etc:
  556.          cdrecord -v speed=1 dev=2,0 -audio track*.cdaudio
  557.      To check if it will be ok to use double speed for the  exam-
  558.      ple above. Use the dummy write option:
  559.          cdrecord -v -dummy speed=2 dev=2,0 -audio track*.cdaudio
  560.      To record a mixed-mode CD with an ISO 9660  filesystem  from
  561.      _c_d_i_m_a_g_e._r_a_w on the first track, the other tracks being audio
  562.      tracks from the files _t_r_a_c_k_0_1._c_d_a_u_d_i_o, _t_r_a_c_k_0_2._c_d_a_u_d_i_o, etc:
  563.          cdrecord  - v  - dummy  dev=2,0   cdimage.raw   -  audio
  564.      track*.cdaudio
  565.      To handle drives that need to  know  the  size  of  a  track
  566.      before starting to write, first run
  567.          mkisofs -R -q -print-size /master/tree
  568.      and then run
  569.          mkisofs  -R  /master/tree  |  cdrecord  speed=2  dev=2,0
  570.      tsize=XXXs -
  571.      where _X_X_X is replaced by the output of the previous  run  of
  572.      mkisofs.
  573. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  574.      CDR_DEVICE
  575.           This may either hold a device identifier that is  suit-
  576.           able  to the open call of the SCSI transport library or
  577.           a label in the file /etc/default/cdrecord.
  578. Joerg Schilling     Last change: Version 1.8                   13
  579. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  580.      CDR_SPEED
  581.           Sets the default speed value for writing (see  also   ----
  582.           ssssppppeeeeeeeedddd option).
  583.      CDR_FIFOSIZE
  584.           Sets the default  size  of  the  FIFO  (see  also  ffffssss====####
  585.           option).
  586. FFFFIIIILLLLEEEESSSS
  587.      /etc/default/cdrecord
  588.           Default values can be set for the following options  in
  589.           /etc/default/cdrecord.   For  example:  CDR_FIFOSIZE=8m
  590.           or CDR_SPEED=2
  591.           CDR_DEVICE
  592.                This may either hold a device identifier  that  is
  593.                suitable  to  the  open call of the SCSI transport
  594.                library    or    a    label    in     the     file
  595.                /etc/default/cdrecord  that  allows  to identify a
  596.                specific drive on the system.
  597.           CDR_SPEED
  598.                Sets the default speed value for writing (see also
  599.                ----ssssppppeeeeeeeedddd option).
  600.           CDR_FIFOSIZE
  601.                Sets the default size of the FIFO (see  also  ffffssss====####
  602.                option).
  603.           Any other label
  604.                is an identifier for a specific drive on the  sys-
  605.                tem.  Such an identifier may not contain the char-
  606.                acters ',', '/', '@' or ':'.
  607.                Each line that follows  a  label  contains  a  TAB
  608.                separates  list  of items.  Currently, three items
  609.                are recognized: the SCSI  ID  of  the  drive,  the
  610.                default  speed  that should be used for this drive
  611.                and the default FIFO size that should be used  for
  612.                this  drive. The values for _s_p_e_e_d and _f_i_f_o_s_i_z_e may
  613.                be set to -1 to tell cdrecord to  use  the  global
  614.                defaults.  A typical line may look this way:
  615.                teac1= 0,5,0   4    8m
  616.                yamaha= 1,6,0  -1   -1
  617.                This tells ccccddddrrrreeeeccccoooorrrrdddd that a drive named _t_e_a_c_1 is at
  618.                scsibus 0, target 5, lun 0 and should be used with
  619.                speed 4 and a FIFO size of 8 MB.  A  second  drive
  620.                may  be  found  at  scsibus 1, target 6, lun 0 and
  621. Joerg Schilling     Last change: Version 1.8                   14
  622. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  623.                uses the default speed and the default FIFO size.
  624. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  625.      mmmmkkkkiiiissssooooffffssss(1), ssssccccgggg(7), ffffbbbbkkkk(7).
  626. NNNNOOOOTTTTEEEESSSS
  627.      Disks made in TTTTrrrraaaacccckkkk AAAAtttt OOOOnnnncccceeee mode are not suitable as a  mas-
  628.      ter  for  direct  mass  production by CD manufacturers.  You
  629.      will need the ddddiiiisssskkkk aaaatttt oooonnnncccceeee  option  to  record  such  disks.
  630.      Nevertheless  the  disks made in TTTTrrrraaaacccckkkk AAAAtttt OOOOnnnncccceeee will normally
  631.      be read in all CD players. Some old audio CD players however
  632.      may produce a two second click between two audio tracks.
  633.      The minimal size of a track is 4 seconds or 300 sectors.  If
  634.      you  write  smaller  tracks,  the CD-Recorder will add dummy
  635.      blocks. This is not an error,  even  though  the  SCSI-error
  636.      message looks this way.
  637.      CCCCddddrrrreeeeccccoooorrrrdddd has been tested  on  an  upgraded  Philips  CDD-521
  638.      recorder at single and double speed on a SparcStation 20/502
  639.      with no problems, slower computer systems should work  also.
  640.      The  newer  Philips/HP/Plasmon/Grundig  drives  as  well  as
  641.      Yamaha CDR-100 and CDR-102 work also.  The  Plasmon  RF-4100
  642.      work,  but  has not tested in multi session.  A Philips CDD-
  643.      521 that has not been upgraded  will  not  work.   The  Sony
  644.      CDU-924  has  been  tested, but does not support XA-mode2 in
  645.      hardware.  The sony therefore cannot create conforming multi
  646.      session  disks.   The  Ricoh RO-1420C works, but some people
  647.      seem to have problems to use them with speed=2, try  speed=0
  648.      in this case.
  649.      The Yamaha CDR-400 and all new SCSI-3/mmc conforming  drives
  650.      are supported in single and multi-session.
  651.      You should run several tests in all supported speeds of your
  652.      drive  with  the   ---- dddduuuummmmmmmmyyyy option turned on if you are using
  653.      ccccddddrrrreeeeccccoooorrrrdddd on an unknown system. Writing a CD  is  a  realtime
  654.      process.  NNNNFFFFSSSS  will not always deliver constantly the needed
  655.      data rates.  If you want to use ccccddddrrrreeeeccccoooorrrrdddd with CD-images that
  656.      are  located  on  a NNNNFFFFSSSS mounted filesystem, be sure that the
  657.      fifo size is big enough.  I used ccccddddrrrreeeeccccoooorrrrdddd with  with  medium
  658.      load   on   a   SS20/502   and  even  at  quad  speed  on  a
  659.      Sparcstation-2 which was heavily loaded, but  it  is  recom-
  660.      mended  to  leave  the  system as lightly loaded as possible
  661.      while writing a CD.  If you want to make  sure  that  buffer
  662.      underrungs  are  not caused by your source disk, you may use
  663.      the command
  664.          ccccddddrrrreeeeccccoooorrrrdddd ----dddduuuummmmmmmmyyyy ddddeeeevvvv====2222,,,,0000 ppppaaaaddddssssiiiizzzzeeee====666600000000mmmm ////ddddeeeevvvv////nnnnuuuullllllll
  665. Joerg Schilling     Last change: Version 1.8                   15
  666. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  667.      to create a disk  that  is  entirely  made  of  dummy  data.
  668.      CCCCddddrrrreeeeccccoooorrrrdddd needs to run as root to get access to the ////ddddeeeevvvv////ssssccccgggg????
  669.      device nodes and to be able to lock itself into memory.
  670.      If you don't want to allow users to become root on your sys-
  671.      tem, ccccddddrrrreeeeccccoooorrrrdddd may safely be installed suid root. This allows
  672.      all users or a group of users with no root privileges to use
  673.      ccccddddrrrreeeeccccoooorrrrdddd....  CCCCddddrrrreeeeccccoooorrrrdddd  in  this  case checks, if the real user
  674.      would have been able to read the specified files.   To  give
  675.      all user access to use ccccddddrrrreeeeccccoooorrrrdddd,,,, enter:
  676.           chown root /usr/local/bin/cdrecord
  677.           chmod 4711 /usr/local/bin/cdrecord
  678.      To give a restricted  group  of  users  access  to  cdrecord
  679.      enter:
  680.           chown root /usr/local/bin/cdrecord
  681.           chgrp cdburners /usr/local/bin/cdrecord
  682.           chmod 4710 /usr/local/bin/cdrecord
  683.      and add a group _c_d_b_u_r_n_e_r_s on your system.
  684.      Never give write permissions  for  non  root  users  to  the
  685.      /_d_e_v/_s_c_g?   devices   unless  you  would  allow  anybody  to
  686.      read/write/format all your disks.
  687.      You should not  connect  old  drives  that  do  not  support
  688.      disconnect/reconnect  to  either  the  SCSI bus that is con-
  689.      nected to the CD-Recorder or the source disk.
  690.      A Compact Disc can have no more than 99 tracks.
  691.      When creating a disc with both audio and  data  tracks,  the
  692.      data  should  be  on  track  1 otherwise you should create a
  693.      CDplus disk which is a multi session  disk  with  the  first
  694.      session  containing  the audio tracks and the following ses-
  695.      sion containing the data track.
  696.      Many operating systems are not able to read more than a sin-
  697.      gle data track, or need special software to do so.
  698.      More information on the SCSI command set of a HP CD-Recorder
  699.      can be found at:
  700.           http://www.hp.com/isgsupport/cdr/index.html
  701.      If you have more information or  SCSI  command  manuals  for
  702.      currently   unsupported   CD-Recorders  please  contact  the
  703.      author.
  704. Joerg Schilling     Last change: Version 1.8                   16
  705. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  706.      The Philips CDD 521 CD-Recorder (even in the  upgraded  ver-
  707.      sion) has several firmware bugs. Some of them will force you
  708.      to power cycle the device or to reboot the machine.
  709.      When using ccccddddrrrreeeeccccoooorrrrdddd  with  the  broken  LLLLiiiinnnnuuuuxxxx  SSSSCCCCSSSSIIII  ggggeeeennnneeeerrrriiiicccc
  710.      ddddrrrriiiivvvveeeerrrr....  You  should  note  that  ccccddddrrrreeeeccccoooorrrrdddd uses a hack, that
  711.      tries to  emulate  the  functionality  of  the  scg  driver.
  712.      Unfortunately,  the  sg  driver  on LLLLiiiinnnnuuuuxxxx has several severe
  713.      bugs:
  714.      +o     It cannot see if a SCSI command could not be  sent  at
  715.           all.
  716.      +o     It cannot get the SCSI status byte. CCCCddddrrrreeeeccccoooorrrrdddd for  that
  717.           reason  cannot  report  failing  SCSI  commands in some
  718.           situations.
  719.      +o     It cannot get real DMA  count  of  transfer.  CCCCddddrrrreeeeccccoooorrrrdddd
  720.           cannot tell you if there is an DMA residual count.
  721.      +o     It cannot get number of  bytes  valid  in  auto  sense
  722.           data.   CCCCddddrrrreeeeccccoooorrrrdddd cannot tell you if device transfers no
  723.           sense data at all.
  724.       +o     It  fetches  to  few  data  in  auto  request   sense
  725.           (CCS/SCSI-2/SCSI-3 needs >= 18).
  726.      The fifo percent output is computed just after  a  block  of
  727.      data  has  been written to the CD-Recorder. For this reason,
  728.      there will never be 100% fifo fill, while  the  fifo  is  in
  729.      streaming mode.
  730. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  731.      You have 9 seconds to type ^C to abort  ccccddddrrrreeeeccccoooorrrrdddd  after  you
  732.      see the message:
  733.      Starting to write CD at speed %d in %s mode for %s session.
  734.      A typical error message for a SCSI command looks like:
  735.           cdrecord: I/O error. test unit ready: scsi sendcmd: no error
  736.           CDB:  00 20 00 00 00 00
  737.           status: 0x2 (CHECK CONDITION)
  738.           Sense Bytes: 70 00 05 00 00 00 00 0A 00 00 00 00 25 00 00 00 00 00
  739.           Sense Key: 0x5 Illegal Request, Segment 0
  740.           Sense Code: 0x25 Qual 0x00 (logical unit not supported) Fru 0x0
  741.           Sense flags: Blk 0 (not valid)
  742.      The first line gives information about the transport of  the
  743.      command.   The  text  after  the first colon gives the error
  744.      text for the system call from the view  of  the  kernel.  It
  745. Joerg Schilling     Last change: Version 1.8                   17
  746. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  747.      usually  is:   IIII////OOOO  eeeerrrrrrrroooorrrr  unless other problems happen. The
  748.      next words contain a short description for the SCSI  command
  749.      that fails. The rest of the line tells you if there were any
  750.      problems for the transport of the command over the SCSI bus.
  751.      ffffaaaattttaaaallll  eeeerrrrrrrroooorrrr means that it was not possible to transport the
  752.      command (i.e.  no  device  present  at  the  requested  SCSI
  753.      address).
  754.      The second line prints the SCSI command descriptor block for
  755.      the failed command.
  756.      The third line gives information on  the  SCSI  status  code
  757.      returned  by  the  command,  if the transport of the command
  758.      succeeds. This is error information from the SCSI device.
  759.      The fourth line is a hex dump  of  the  auto  request  sense
  760.      information for the command.
  761.      The fifth line is the error text for the sense key if avail-
  762.      able,  followed  by the segment number that is only valid if
  763.      the command was a _c_o_p_y command. If the error message is  not
  764.      directly  related  to the current command, the text _d_e_f_e_r_r_e_d
  765.      _e_r_r_o_r is appended.
  766.      The sixth line is the error text for the sense code and  the
  767.      sense  qualifier if available.  If the type of the device is
  768.      known, the sense data is decoded from tables in _s_c_s_i_e_r_r_s._c .
  769.      The text is followed by the error value for a field replace-
  770.      able unit.
  771.      The seventh line prints the block number that is related  to
  772.      the  failed  command  and  text for several error flags. The
  773.      block number may not be valid.
  774.      The following message is not an error:
  775.           Track 01: Total bytes read/written: 2048/2048 (1 sectors).
  776.           cdrecord: I/O error. flush cache: scsi sendcmd: no error
  777.           CDB:  35 00 00 00 00 00 00 00 00 00
  778.           status: 0x2 (CHECK CONDITION)
  779.           Sense Bytes: F0 00 05 80 00 00 27 0A 00 00 00 00 B5 00 00 00 00 00
  780.           Sense Key: 0x5 Illegal Request, Segment 0
  781.           Sense Code: 0xB5 Qual 0x00 (dummy data blocks added) Fru 0x0
  782.           Sense flags: Blk -2147483609 (valid)
  783.      It simply notifies, that a track that is  smaller  than  the
  784.      minimum size has been expanded to 300 sectors.
  785. BBBBUUUUGGGGSSSS
  786.      CCCCddddrrrreeeeccccoooorrrrdddd has even more options than llllssss.
  787.      CCCCddddrrrreeeeccccoooorrrrdddd currently only warns if the input data will not fit
  788.      on  the  disk.   If you don't abort the command you will get
  789. Joerg Schilling     Last change: Version 1.8                   18
  790. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  791.      unpredictable results.
  792.      There should be an option to write index numbers  for  audio
  793.      tracks.
  794.      There should be a recover option to make disks usable,  that
  795.      have been written during a power failure.
  796. CCCCRRRREEEEDDDDIIIITTTTSSSS
  797.      Bill Swartz    (Bill_Swartz@twolf.com)
  798.                     For helping me with the TEAC driver support
  799.      Aaron Newsome  (aaron.d.newsome@wdc.com)
  800.                     For letting me develop Sony  support  on  his
  801.                     drive
  802.      Eric Youngdale (eric@andante.jic.com)
  803.                     For supplying mkisofs
  804.      Gadi Oxman     (gadio@netvision.net.il)
  805.                     For tips on the ATAPI standard
  806.      Finn Arne Gangstad  (finnag@guardian.no)
  807.                     For the first FIFO implementation.
  808.      Dave Platt     (dplatt@feghoot.ml.org)
  809.                     For creating the experimental packet  writing
  810.                     support,  the  first  implementation of CD-RW
  811.                     blanking support, the first .wav file decoder
  812.                     and many nice discussions on cdrecord.
  813.      Chris P. Ross (cross@eng.us.uu.net)
  814.                     For the first implementation os a  BSDI  SCSI
  815.                     rtansport.
  816.      Grant R. Guenther   (grant@torque.net)
  817.                     For creating the first  parallel  port  tran-
  818.                     sport implementation for Linux.
  819.      Kenneth D. Merry (ken@kdm.org)
  820.                     for  providing  the  CAM  port  for   FreeBSD
  821.                     together       with       Michael       Smith
  822.                     (msmith@freebsd.org)
  823. MMMMAAAAIIIILLLLIIIINNNNGGGG LLLLIIIISSSSTTTTSSSS
  824.      If you want to actively take  part  on  the  development  of
  825.      cdrecord, you may join the cdwriting mailing list by sending
  826.      mail to:
  827.           other-cdwrite-request@lists.debian.org
  828. Joerg Schilling     Last change: Version 1.8                   19
  829. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  830.      and include the  word  _s_u_b_s_c_r_i_b_e  in  the  body.   The  mail
  831.      address of the list is:
  832.           cdwrite@lists.debian.org
  833. AAAAUUUUTTTTHHHHOOOORRRR
  834.      Joerg Schilling
  835.      Seestr. 110
  836.      D-13353 Berlin
  837.      Germany
  838.      Additional information can be found on:
  839.      http://www.fokus.gmd.de/nthp/employees/schilling/cdrecord.html
  840.      Mail bugs and suggestions to:
  841.      jjjjooooeeeerrrrgggg@@@@sssscccchhhhiiiillllyyyy....iiiissssddddnnnn....ccccssss....ttttuuuu----bbbbeeeerrrrlllliiiinnnn....ddddeeee or  jjjjssss@@@@ccccssss....ttttuuuu----bbbbeeeerrrrlllliiiinnnn....ddddeeee  or
  842.      sssscccchhhhiiiilllllllliiiinnnngggg@@@@ffffooookkkkuuuussss....ggggmmmmdddd....ddddeeee
  843. Joerg Schilling     Last change: Version 1.8                   20