home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / scsicontrol.z / scsicontrol
Encoding:
Text File  |  2002-10-03  |  8.2 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ssssccccssssiiiiccccoooonnnnttttrrrroooollll((((1111mmmm))))                                                ssssccccssssiiiiccccoooonnnnttttrrrroooollll((((1111mmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      scsicontrol - probe and control scsi devices
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////ssssbbbbiiiinnnn////ssssccccssssiiiiccccoooonnnnttttrrrroooollll [[[[----CCCCDDDDHHHHIIIIRRRRSSSSaaaaccccddddeeeeggggiiiillllmmmmqqqqssssvvvv]]]] [[[[----bbbb bbbblllloooocccckkkkiiiizzzzeeee]]]] _d_e_v_i_c_e ...
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _s_c_s_i_c_o_n_t_r_o_l may be used to print info from the SCSI inquiry commands,
  16.      which normally indicate the device type, manufacturer, and similar info.
  17.      Other options may be used show more data, or to issue commands that
  18.      control the operation of the device, or the bus as a whole.  By using the
  19.      debug option (----dddd), the exact command sent, and the data returned (if any)
  20.      is displayed, along with more extensive error information.
  21.  
  22.      The device(s) may be specified without the normal /_d_e_v/_s_c_s_i prefix, if
  23.      desired.
  24.  
  25.      ----CCCC   Send the SGI-specific command that causes the CD-ROM drive to reply
  26.           to the inquiry command (see ----iiii below) as a CD-ROM drive.  On
  27.           poweron, or after a SCSI bus reset (either as part of error recovery
  28.           or from a user issued command), the CD-ROM drives sold by SGI
  29.           respond to inquiry as a hard disk.  This was done because older
  30.           systems would otherwise refuse to boot from the CD-ROM drive.
  31.  
  32.      ----DDDD   Send the SCSI self test (diagnostic) command to the device.
  33.  
  34.      ----HHHH   Send the SCSI halt, or stop, command.  This causes the device to
  35.           stop the media, or in some cases, to unload it.
  36.  
  37.      ----RRRR   Display the Logical Unit Numbers of all configured logical units on
  38.           the device.
  39.  
  40.      ----SSSS   Send the SCSI start, or load, command.  This causes the device to
  41.           start the media, or in some cases, to load it.
  42.  
  43.      ----aaaa   Attempt to negotiate with the device to operate in asynchronous
  44.           mode.  This will usually mean a lower data rate on the SCSI bus, but
  45.           is less sensitive to scsi cabling problems, etc.  Some devices will
  46.           negotiate synchronous mode, but may not work correctly in that mode.
  47.           This can also be forced by changing the configuration variables for
  48.           the scsi controller driver (e.g., the _w_d_9_3__s_y_n_c_e_n_a_b_l_e array in the
  49.           file /_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d/_w_d_9_3).  Also see the ----ssss option below.
  50.  
  51.      ----dddd   Debug mode.  This causes all commands sent to the device and  the
  52.           data that is returned, if any, to be printed.  Extensive information
  53.           about errors is also printed when they occur.
  54.  
  55.      ----eeee   Open the device in exclusive mode.  This will fail (with busy
  56.           status) if the device is in use by some other process or SCSI
  57.           driver.  If it succeeds, other opens will then fail.  This mode
  58.           applies to the host controller driver, and does not issue any SCSI
  59.           commands to the device (in particular, the reserve unit command is
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssccccssssiiiiccccoooonnnnttttrrrroooollll((((1111mmmm))))                                                ssssccccssssiiiiccccoooonnnnttttrrrroooollll((((1111mmmm))))
  71.  
  72.  
  73.  
  74.           not sent).
  75.  
  76.      ----gggg   Get the host adapter flags for this SCSI bus.  This is mostly of
  77.           interest to driver writer's, but it does provide a way to determine
  78.           if the SCSI disconnect option has been disabled on the bus.
  79.  
  80.      ----iiii   Send the SCSI inquiry command, and display the info in a readable
  81.           fashion.  The information typically includes the device type, the
  82.           manufacturer, the SCSI version, and some of the optional SCSI
  83.           features the device supports.  Also see ----IIII below.
  84.  
  85.      ----IIII   display all the data from the ----iiii or ----vvvv options in both hex and ascii
  86.           form.  Implies ----iiii if neither ----iiii or ----vvvv were given on the command
  87.           line.
  88.  
  89.      ----qqqq   Quiet mode.  Don't print the name of each device as it is opened,
  90.           unless an error occurs.
  91.  
  92.      ----ssss   Attempt to negotiate with the device to operate in synchronous mode.
  93.           This is normally done by the operating system when the device is
  94.           first used, but that may fail, and the system will not then re-
  95.           attempt to negotiate.  Some drivers will suppress the negotiation.
  96.           Operating in synchronous mode will usually mean a higher data rate
  97.           on the SCSI bus, but this mode is more sensitive to SCSI cabling
  98.           problems.  Additionally, some devices will negotiate successfully
  99.           for this mode, but will not work correctly.  Also see the ----aaaa option
  100.           above.
  101.  
  102.      ----vvvv   Issue the SCSI iiiinnnnqqqquuuuiiiirrrryyyy command with the vital products modifier, and
  103.           display the data in a readable fashion.  The vital product data
  104.           often includes the serial number, and the additional information
  105.           about the device.  Also see ----IIII above.
  106.  
  107.      ----cccc bbbblllloooocccckkkkssssiiiizzzzeeee
  108.           For devices that support the readcapacity command, print the
  109.           capacity of the device, and if it's block oriented, the number of
  110.           bytes per block.
  111.  
  112.      ----bbbb bbbblllloooocccckkkkssssiiiizzzzeeee
  113.           Set the blocksize (for disks, CDROMs, and some types of tape drives)
  114.           to the given value, and also report the previous value.  bbbblllloooocccckkkkssssiiiizzzzeeee
  115.           may be given in decimal, hex (with leading 0x), or octal (with
  116.           leading 0).  Not all devices support changing their block size.
  117.  
  118.      ----llll   Print the current values of all the supported logsense pages.  This
  119.           can sometimes be useful in debugging device problems, but almost
  120.           always requires the device specific manual from it's manufacturer,
  121.           to be of use.
  122.  
  123.      ----mmmm   Print the current values of all the supported modesense pages.
  124.           Mostly of use to people debugging problems or writing devscsi
  125.           drivers.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ssssccccssssiiiiccccoooonnnnttttrrrroooollll((((1111mmmm))))                                                ssssccccssssiiiiccccoooonnnnttttrrrroooollll((((1111mmmm))))
  137.  
  138.  
  139.  
  140. FFFFIIIILLLLEEEESSSS
  141.      /dev/scsi/sc* - the generic scsi driver devices /dev/scsi/jag* - the
  142.      generic scsi driver devices
  143.  
  144. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  145.      dsopen(3X), ds(7M), scsiha(1M), scsiha(7M).
  146.  
  147. NNNNOOOOTTTTEEEE
  148.      This command is normally usable only by the superuser, because the
  149.      standard permissions of the devices in /dev/scsi restrict access to other
  150.      users.
  151.  
  152.      The source to this program is also shipped as sample source code in the
  153.      iiiirrrriiiixxxx____ddddeeeevvvv....ggggiiiiffffttttssss....ssssccccssssiiii subsystem as part of _IIII_DDDD_OOOO.
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.