![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to ss CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [MW Coherent from dump] / coherent / f / usr / man / KERNEL|
Return to ss CVS log | Up to [MW Coherent from dump] / coherent / f / usr / man / KERNEL |
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.