Return to ss CVS log

Up to [MW Coherent from dump] / coherent / f / usr / man / KERNEL

Annotation of coherent/f/usr/man/KERNEL/ss, revision 1.1

1.1     ! root        1: ssss -- Device Driver
        !             2: 
        !             3: 
        !             4: The device driver ssss lets you use SCSI interface devices attached to any of
        !             5: the following host adapters:
        !             6: 
        !             7:     Future Domain TMC-845/850/860/875/885
        !             8:     Future Domain TMC-840/841/880/881
        !             9:     Seagate ST01/ST02
        !            10: 
        !            11: This driver  has major number  13.  It can  be accessed either  as a block-
        !            12: special  device  or  as  a  character-special  device.   The  minor  number
        !            13: specifies the device and  partition number for disk-type devices; this lets
        !            14: you use up to eight SCSI-IDs,  with one logical unit number (LUN) per SCSI-
        !            15: ID and  up to four partitions  per LUN.  The present  version supports only
        !            16: LUN 0 per SCSI-ID.
        !            17: 
        !            18: The first  ooppeenn call on a  SCSI disk device reads  the partition table into
        !            19: memory.
        !            20: 
        !            21: _C_o_n_t_r_o_l_l_e_r _C_o_n_f_i_g_u_r_a_t_i_o_n
        !            22: For your Future  Domain or Seagate host adapter to  work with COHERENT, you
        !            23: must install  it with  interrupts enabled.  If  you have been  running your
        !            24: host adapter  with interrupts disabled,  a good first  choice for interrupt
        !            25: number is IRQ 5, unless you  know that you have another device installed on
        !            26: your computer  that already uses this  interrupt.  Consult the instructions
        !            27: provided with your host adapter,  and the jumper settings, to determine the
        !            28: IRQ number.
        !            29: 
        !            30: The base  address value  used by ssss  is the four-digit  hexadecimal memory-
        !            31: segment number of the host adapter's starting address.  This number is most
        !            32: often CCAA0000; other  common values are CC880000, CCCC0000, CCEE0000,  DDCC0000, and DDEE0000. You
        !            33: must use  the correct value,  as specified by  the jumper settings  on your
        !            34: host adapter.
        !            35: 
        !            36: Device driver  variables SSSS_BBAASSEE and SSSS_IINNTT correspond  to the base address
        !            37: and interrupt vector, respectively.  Device driver variable NNSSDDRRIIVVEE must be
        !            38: patched before  the driver is loaded.  The low-order  byte of this variable
        !            39: is a bit  map that indicates the SCSI-IDs of  all installed target devices.
        !            40: The high-order byte indicates the type of host adapter.  Labelling the bits
        !            41: in the low-order byte of NNSSDDRRIIVVEE is as follows:
        !            42: 
        !            43:        _B_i_t _n_u_m_b_e_r:  7 6 5 4 3 2 1 0 <- _l_e_a_s_t _s_i_g_n_i_f_i_c_a_n_t _b_i_t
        !            44: 
        !            45: There should  be a value of  one for each installed  target device.  Do not
        !            46: set a  value of one  for the SCSI-ID  of the host  adapter.  The high-order
        !            47: byte  of  NNSSDDRRIIVVEE  is  00xx0000  for  Seagate ST01  and  ST02,  00xx8800  for  TMC-
        !            48: 845/850/860/875/885, and 00xx4400 for TMC-840/841/880/881.  For example, if you
        !            49: are using a TMC-885 and a  single hard drive with SCSI ID of zero, then set
        !            50: NNSSDDRRIIVVEE  to 0x8001.   See  Lexicon article  hhss  for an  example  of how  to
        !            51: configure a device driver.
        !            52: 
        !            53: When  processing BIOS  I/O requests  prior to  booting COHERENT,  SCSI host
        !            54: adapters  use  ``translation-mode''  drive  parameters:  number  of  heads,
        !            55: cylinders, and  sectors per track.   These numbers are  called translation-
        !            56: mode  parameters  because  they have  nothing  to  do  with physical  drive
        !            57: geometry.  The translation-mode parameters used by the BIOS code present on
        !            58: your host adapter  can be obtained using the ddppbb  utility found on the boot
        !            59: diskette of versions 3.2.0 and later of COHERENT.
        !            60: 
        !            61: ssss has  a table, ddrrvv_ppaarrmm,  which contains eight two-word  entries, one for
        !            62: each  possible SCSI-ID.   The first  word  of each  entry must  contain the
        !            63: number of cylinders for the drive.   The high-order byte of the second word
        !            64: is the  number of sectors  per track; the  low-order byte is  the number of
        !            65: heads.   Entries in  ddrrvv_ppaarrmm should  be  patched for  each drive  which is
        !            66: accessible by the BIOS.  Values need not be patched for drives inaccessible
        !            67: by the BIOS.   Note that BIOS code is executed  by COHERENT only during the
        !            68: initial  bootstrap.  After  that, drive  parameters  are of  no consequence
        !            69: because SCSI I/O requests are  based upon logical block number, rather than
        !            70: upon cylinder/head/sector addressing.
        !            71: 
        !            72: The installation  procedure for COHERENT  versions 3.2.0 and  later patches
        !            73: all necessary  variables for the  accompanying version of the  ssss driver by
        !            74: executing the command:
        !            75: 
        !            76:     /etc/mkdev scsi
        !            77: 
        !            78: _M_i_n_o_r _D_e_v_i_c_e _N_u_m_b_e_r_s
        !            79: ssss usually  uses the special files /ddeevv/ssdd*  and /ddeevv/rrssdd*. For information
        !            80: on the meaning  of minor numbers with these special  files, see the article
        !            81: on aahhaa115544xx.
        !            82: 
        !            83: _L_o_a_d_i_n_g _t_h_e _D_r_i_v_e_r (_C_O_H_E_R_E_N_T _2_8_6 _o_n_l_y)
        !            84: ssss must be  loaded on a COHERENT 286 system  that does not have a SCSI hard
        !            85: disk as the root device.  To do so, use the command /eettcc/ddrrvvlldd, as follows:
        !            86: 
        !            87:     /etc/drvld -r /drv/ss
        !            88: 
        !            89: _F_i_l_e_s
        !            90: /ddeevv/ssdd* -- block-special devices
        !            91: /ddeevv/rrssdd* -- character-special devices
        !            92: 
        !            93: _S_e_e _A_l_s_o
        !            94: ddeevviiccee ddrriivveerrss, ddrrvvlldd, ssccssii
        !            95: 
        !            96: _N_o_t_e_s
        !            97: Current releases  of ssss support  disk-type devices only.  Zero  is the only
        !            98: LUN  allowed.  Future  versions will  add support  for tape-type  and other
        !            99: devices, as well as nonzero LUN's.

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