Annotation of coherent/a/usr/man/COHERENT/aha154x, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: aha154x                   Device Driver                   aha154x
                      4: 
                      5: 
                      6: 
                      7: 
                      8: Adaptec AHA-154x device driver
                      9: 
                     10: 
                     11: The  device driver  aahhaa115544xx lets you  use SCSI  interface devices
                     12: attached to an Adaptec AHA-154x series host adapter.  This driver
                     13: has  major number  13.  It  can  be accessed  either as  a block-
                     14: special  device  or as  a  character-special  device.  The  minor
                     15: number specifies  the device  and partition number  for disk-type
                     16: devices, letting  you use up  to eight SCSI-IDs, with  up to four
                     17: logical unit numbers (LUNs) per SCSI-ID and up to four partitions
                     18: per LUN.
                     19: 
                     20: The first  ooppeenn call on  a SCSI disk device  allocates memory for
                     21: the partition table and reads it into memory.
                     22: 
                     23: ***** Controller Configuration *****
                     24: 
                     25: Prior to installing the  Adaptec host adapter in your system, you
                     26: must  configure the  I/O base address,  interrupt vector  and DMA
                     27: channel as follows:
                     28: 
                     29: 
                     30:             I/O base address:0x330
                     31:             DMA channel:    5
                     32:             Interrupt vector:IRQ11
                     33: 
                     34: 
                     35: In addition,  if you are using  any synchronous SCSI peripherals,
                     36: disable  the  synchronous transfer  option  on  the Adaptec  host
                     37: adapter.
                     38: 
                     39: After verifying that your controller works with COHERENT, you may
                     40: select an  alternate I/O base  address or an  alternate interrupt
                     41: vector.  Device driver variables SSDDBBAASSEE_ and SSDDIIRRQQ_ correspond to
                     42: the  I/O base  address and  interrupt vector,  respectively.  See
                     43: Lexicon article  hhss for an  example of how to  configure a device
                     44: driver.
                     45: 
                     46: When processing BIOS  I/O requests prior to booting COHERENT, the
                     47: Adaptec host adapter  uses ``translation mode'' drive parameters:
                     48: number of heads,  cylinders, and sectors per track.  Most current
                     49: versions of  the AHA-154x use  values of 64 heads  and 32 sectors
                     50: per track, and calculate the number of cylinders based upon drive
                     51: capacity.   Note that these  numbers are  called translation-mode
                     52: parameters  because they  have nothing  to  do with  the physical
                     53: drive geometry.   Some early versions  of the AHA-154x,  and some
                     54: versions distributed  by Tandy, use  16 heads and  32 sectors per
                     55: track.  Device  driver variable SSDD_HHDDSS_  is initialized to  64 as
                     56: shipped;   it should  be patched  to a value  of 16  for adapters
                     57: whose BIOS code  uses 16-head translation mode.  The translation-
                     58: mode  parameters  used by  the  BIOS code  present  on your  host
                     59: adapter can  be obtained using the ddppbb utility  found on the boot
                     60: diskette of versions 3.2.0  and later of COHERENT.  Note that the
                     61: BIOS code is  executed by COHERENT only during initial bootstrap.
                     62: 
                     63: 
                     64: COHERENT Lexicon                                           Page 1
                     65: 
                     66: 
                     67: 
                     68: 
                     69: aha154x                   Device Driver                   aha154x
                     70: 
                     71: 
                     72: 
                     73: After that, drive parameters are of no consequence since SCSI I/O
                     74: requests  are based  upon logical  block  number, rather  than on
                     75: cylinder/head/sector addressing.
                     76: 
                     77: The installation procedure  for COHERENT versions 3.2.0 and later
                     78: patches all  necessary variables for the  accompanying version of
                     79: the aahhaa115544xx driver by executing the command:
                     80: 
                     81: 
                     82:        /etc/mkdev scsi
                     83: 
                     84: 
                     85: ***** Minor Device Numbers *****
                     86: 
                     87: The minor device number is decoded as follows:
                     88: 
                     89: 
                     90:        _B_i_t _n_u_m_b_e_r:  7 6 5 4 3 2 1 0
                     91:        _M_e_a_n_i_n_g:     S I I I L L P P
                     92: 
                     93: 
                     94: where _S indicates  the ``special'' bit, _I_I_I indicates a three-bit
                     95: field containing the SCSI-ID  in the range of zero through seven,
                     96: _L_L indicates  a two-bit  field containing a  LUN in the  range of
                     97: zero  through  three,  and  _P_P  indicates  a two-bit  field  that
                     98: contains either a partition number for disk-type devices or a set
                     99: of special modes for devices other than disks.
                    100: 
                    101: The ``special'' bit and the partition number interact as follows:
                    102: 
                    103: 
                    104: _D_e_s_c_r_i_p_t_i_o_n        _S _B_i_t  _P_P  _D_e_v_i_c_e      _T_y_p_e
                    105: partition a        0      00 /dev/sd?a    disk
                    106: partition b        0      01 /dev/sd?b    disk
                    107: partition c        0      10 /dev/sd?c    disk
                    108: partition d        0      11 /dev/sd?d    disk
                    109: partition table    1      00 /dev/sd?x    disk
                    110: no rewind          1      01 /dev/sd?n    tape
                    111: RESERVED           1      10     ---      ----
                    112: rewind on close    1      11 /dev/sd?     tape
                    113: 
                    114: 
                    115: ***** Loading the Driver ***** The aahhaa115544xx loadable device driver
                    116: must be loaded on a system that does not have a SCSI hard disk as
                    117: the  root  device.  To  do  so, use  the  command /eettcc/ddrrvvlldd,  as
                    118: follows:
                    119: 
                    120: 
                    121:                    /etc/drvld -r /drv/aha154x
                    122: 
                    123: 
                    124: ***** Files ***** /ddeevv/ssdd* -- bblloocckk-ssppeecciiaall ddeevviicceess
                    125: /ddeevv/rrssdd* -- cchhaarraacctteerr-ssppeecciiaall ddeevviicceess
                    126: 
                    127: 
                    128: 
                    129: 
                    130: COHERENT Lexicon                                           Page 2
                    131: 
                    132: 
                    133: 
                    134: 
                    135: aha154x                   Device Driver                   aha154x
                    136: 
                    137: 
                    138: 
                    139: ***** See Also *****
                    140: 
                    141: ddeevviiccee ddrriivveerrss, ddrrvvlldd, ssccssii
                    142: 
                    143: ***** Notes *****
                    144: 
                    145: This release of the aahhaa115544xx device driver only supports disk-type
                    146: devices.  A  future version  of the  driver will add  support for
                    147: tape-type and other devices.
                    148: 
                    149: 
                    150: 
                    151: 
                    152: 
                    153: 
                    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: 
                    196: COHERENT Lexicon                                           Page 3
                    197: 
                    198: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.