


READCD(1)            Schily's USER COMMANDS             READCD(1)



NNNNAAAAMMMMEEEE
     readcd - read or write data Compact Discs

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     rrrreeeeaaaaddddccccdddd ddddeeeevvvv====_d_e_v_i_c_e [ _o_p_t_i_o_n_s ]


DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     RRRReeeeaaaaddddccccdddd is used to read or write Compact Discs.

     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  drive.  Com-
     munication  on  _S_u_n_O_S  is  done with the SCSI general driver
     ssssccccgggg.... Other operating systems are using a library  simulation
     of    this    driver.     Possible    syntax    is:     ddddeeeevvvv====
     _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,
     the drive has to be connected to the default SCSI bus of the
     machine.  _S_c_s_i_b_u_s, _t_a_r_g_e_t and _l_u_n are integer numbers.  Some
     operating  systems  or  SCSI  transport  implementations may
     require to specify a filename in addition.  In this case the
     corect     syntax     for     the     device    is:     ddddeeeevvvv====
     _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.
     If  the  name  of the device node that has been specified on
     such a system referres to exactly one SCSI device, a  short-
     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
     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,


     To make rrrreeeeaaaaddddccccdddd portable to all UNIX  platforms,  the  syntax
     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
     specific knowledge about device  names  from  the  user.   A
     specific  OS must not necessarily support a way to specify a
     real   device   file   name   nor   a   way    to    specify
     _s_c_s_i_b_u_s,_t_a_r_g_e_t,_l_u_n.


     _S_c_s_i_b_u_s 0 is the default SCSI bus on the machine. Watch  the
     boot   messages   for   more   information   or   look  into
     ////vvvvaaaarrrr////aaaaddddmmmm////mmmmeeeessssssssaaaaggggeeeessss for more information about the SCSI confi-
     guration  of  your  machine.  If you have problems to figure
     out what values for _s_c_s_i_b_u_s,_t_a_r_g_e_t,_l_u_n should be  used,  try
     the ----ssssccccaaaannnnbbbbuuuussss option of ccccddddrrrreeeeccccoooorrrrdddd.


OOOOPPPPTTTTIIIIOOOONNNNSSSS
     If no options except the _d_e_v= option  have  been  specified,
     rrrreeeeaaaaddddccccdddd  goes  into intercative mode.  Select a primary func-
     tion and then follow the instructions.

     ----vvvveeeerrrrssssiiiioooonnnn
          Print version information and exit.

     ----vvvv    Increment the level of general verbosity by one.



Joerg Schilling    Last change: Version 1.8.1                   1






READCD(1)            Schily's USER COMMANDS             READCD(1)



     ----VVVV    Increment the verbose level in respect of SCSI command
          transport  by one.  This helps to debug problems during
          the writing process, that occur in the drive.   If  you
          get incomprehensible error messages you should use this
          flag to get more detailed output.  ----VVVVVVVV will  show  data
          buffer content in addition.  Using ----VVVV or ----VVVVVVVV slows down
          the process and may be the reason for a  buffer  under-
          run.

     ----wwww    Switch to write mode. If this option is  not  present,
          rrrreeeeaaaaddddccccdddd reads from the specified device.

     sssseeeeccccttttoooorrrrssss====_r_a_n_g_e
          Specify a sector range that should be read.  The  range
          is  specified  by  the  starting sector number, a minus
          sign and the ending sector number.


EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
     For all examples below, it will be assumed that the drive is
     connected  to  the primary SCSI bus of the machine. The SCSI
     target id is set to 2.

     To read the complete media from a CD-ROM writing the data to
     the file _c_d_i_m_a_g_e._r_a_w:

         readcd dev=2,0 f=cdimage.raw

     To read sectors from range 150 ... 10000 from a CD-ROM writ-
     ing the data to the file _c_d_i_m_a_g_e._r_a_w:

         readcd dev=2,0 sectors=150-10000 f=cdimage.raw

     To write the data from the file _c_d_i_m_a_g_e._r_a_w (e.g. a filesys-
     tem image from mmmmkkkkiiiissssooooffffssss) to a DVD-RAM, call:

         readcd dev=2,0 -w f=cdimage.raw


FFFFIIIILLLLEEEESSSS
SSSSEEEEEEEE AAAALLLLSSSSOOOO
     ccccddddrrrreeeeccccoooorrrrdddd(1), mmmmkkkkiiiissssooooffffssss(1), ssssccccgggg(7), ffffbbbbkkkk(7).


NNNNOOOOTTTTEEEESSSS
     If you don't want to allow users to become root on your sys-
     tem,  rrrreeeeaaaaddddccccdddd  may safely be installed suid root. This allows
     all users or a group of users with no root privileges to use
     rrrreeeeaaaaddddccccdddd.... RRRReeeeaaaaddddccccdddd in this case will only allow access to CD-ROM
     type drives- To give all user access to use rrrreeeeaaaaddddccccdddd,,,, enter:





Joerg Schilling    Last change: Version 1.8.1                   2






READCD(1)            Schily's USER COMMANDS             READCD(1)



          chown root /usr/local/bin/readcd
          chmod 4711 /usr/local/bin/readcd

     To give a restricted group of users access to rrrreeeeaaaaddddccccdddd enter:

          chown root /usr/local/bin/readcd
          chgrp cdburners /usr/local/bin/readcd
          chmod 4710 /usr/local/bin/readcd

     and add a group _c_d_b_u_r_n_e_r_s on your system.

     Never give write permissions  for  non  root  users  to  the
     /_d_e_v/_s_c_g?   devices   unless  you  would  allow  anybody  to
     read/write/format all your disks.

     You should not  connect  old  drives  that  do  not  support
     disconnect/reconnect  to  either  the  SCSI bus that is con-
     nected to the CD-Recorder or the source disk.

     When using rrrreeeeaaaaddddccccdddd with the broken LLLLiiiinnnnuuuuxxxx SSSSCCCCSSSSIIII ggggeeeennnneeeerrrriiiicccc ddddrrrriiiivvvveeeerrrr....
     You  should note that rrrreeeeaaaaddddccccdddd uses a hack, that tries to emu-
     late the functionality of the  scg  driver.   Unfortunately,
     the sg driver on LLLLiiiinnnnuuuuxxxx has several severe bugs:

     +o     It cannot see if a SCSI command could not be  sent  at
          all.

     +o     It cannot get the SCSI status byte.  RRRReeeeaaaaddddccccdddd  for  that
          reason  cannot  report  failing  SCSI  commands in some
          situations.

     +o     It cannot get real DMA count of transfer. RRRReeeeaaaaddddccccdddd  can-
          not tell you if there is an DMA residual count.

     +o     It cannot get number of  bytes  valid  in  auto  sense
          data.   RRRReeeeaaaaddddccccdddd  cannot  tell you if device transfers no
          sense data at all.

      +o     It  fetches  to  few  data  in  auto  request   sense
          (CCS/SCSI-2/SCSI-3 needs >= 18).


DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
     A typical error message for a SCSI command looks like:

          readcd: I/O error. test unit ready: scsi sendcmd: no error
          CDB:  00 20 00 00 00 00
          status: 0x2 (CHECK CONDITION)
          Sense Bytes: 70 00 05 00 00 00 00 0A 00 00 00 00 25 00 00 00 00 00
          Sense Key: 0x5 Illegal Request, Segment 0
          Sense Code: 0x25 Qual 0x00 (logical unit not supported) Fru 0x0
          Sense flags: Blk 0 (not valid)



Joerg Schilling    Last change: Version 1.8.1                   3






READCD(1)            Schily's USER COMMANDS             READCD(1)



     The first line gives information about the transport of  the
     command.   The  text  after  the first colon gives the error
     text for the system call from the view  of  the  kernel.  It
     usually  is:   IIII////OOOO  eeeerrrrrrrroooorrrr  unless other problems happen. The
     next words contain a short description for the SCSI  command
     that fails. The rest of the line tells you if there were any
     problems for the transport of the command over the SCSI bus.
     ffffaaaattttaaaallll  eeeerrrrrrrroooorrrr means that it was not possible to transport the
     command (i.e.  no  device  present  at  the  requested  SCSI
     address).

     The second line prints the SCSI command descriptor block for
     the failed command.

     The third line gives information on  the  SCSI  status  code
     returned  by  the  command,  if the transport of the command
     succeeds. This is error information from the SCSI device.

     The fourth line is a hex dump  of  the  auto  request  sense
     information for the command.

     The fifth line is the error text for the sense key if avail-
     able,  followed  by the segment number that is only valid if
     the command was a _c_o_p_y command. If the error message is  not
     directly  related  to the current command, the text _d_e_f_e_r_r_e_d
     _e_r_r_o_r is appended.

     The sixth line is the error text for the sense code and  the
     sense  qualifier if available.  If the type of the device is
     known, the sense data is decoded from tables in _s_c_s_i_e_r_r_s._c .
     The text is followed by the error value for a field replace-
     able unit.

     The seventh line prints the block number that is related  to
     the  failed  command  and  text for several error flags. The
     block number may not be valid.


BBBBUUUUGGGGSSSS
CCCCRRRREEEEDDDDIIIITTTTSSSS
MMMMAAAAIIIILLLLIIIINNNNGGGG LLLLIIIISSSSTTTTSSSS
     If you want to actively take  part  on  the  development  of
     cdrecord, you may join the cdwriting mailing list by sending
     mail to:

          other-cdwrite-request@lists.debian.org

     and include the  word  _s_u_b_s_c_r_i_b_e  in  the  body.   The  mail
     address of the list is:

          cdwrite@lists.debian.org




Joerg Schilling    Last change: Version 1.8.1                   4






READCD(1)            Schily's USER COMMANDS             READCD(1)



AAAAUUUUTTTTHHHHOOOORRRR
     Joerg Schilling
     Seestr. 110
     D-13353 Berlin
     Germany

     Additional information can be found on:
     http://www.fokus.gmd.de/usr/schilling/cdrecord.html

     Mail bugs and suggestions to:

     jjjjooooeeeerrrrgggg@@@@sssscccchhhhiiiillllyyyy....iiiissssddddnnnn....ccccssss....ttttuuuu----bbbbeeeerrrrlllliiiinnnn....ddddeeee or  jjjjssss@@@@ccccssss....ttttuuuu----bbbbeeeerrrrlllliiiinnnn....ddddeeee  or
     sssscccchhhhiiiilllllllliiiinnnngggg@@@@ffffooookkkkuuuussss....ggggmmmmdddd....ddddeeee










































Joerg Schilling    Last change: Version 1.8.1                   5



