Return to readme CVS log

Up to [Net/2] / Net2 / scsi

Annotation of Net2/scsi/readme, revision 1.1

1.1     ! root        1:  *
        !             2:  * PATCHES MAGIC                LEVEL   PATCH THAT GOT US HERE
        !             3:  * --------------------         -----   ----------------------
        !             4:  * CURRENT PATCH LEVEL:         1       00098
        !             5:  * --------------------         -----   ----------------------
        !             6:  *
        !             7:  * 16 Feb 93   Julian Elischer         ADDED for SCSI system
        !             8: This release consists of the following files 
        !             9: (relative to the base of the kernel tree)
        !            10: 
        !            11: 
        !            12: MAKEDEV
        !            13: 
        !            14: scsi
        !            15: scsi/README
        !            16: scsi/scsiconf.h
        !            17: scsi/scsiconf.c
        !            18: scsi/scsi_all.h
        !            19: 
        !            20: scsi/scsi_disk.h
        !            21: scsi/sd.c
        !            22: 
        !            23: scsi/scsi_tape.h
        !            24: scsi/st.c
        !            25: 
        !            26: sys/chio.h
        !            27: scsi/scsi_changer.h
        !            28: scsi/ch.c
        !            29: 
        !            30: sys/cdio.h
        !            31: scsi/scsi_cd.h
        !            32: scsi/cd.c
        !            33: 
        !            34: i386/conf/SCSITEST
        !            35: i386/isa/aha1542.c
        !            36: 
        !            37: README.AHA1742
        !            38: i386/conf/AHBTEST
        !            39: i386/isa/aha1742.c
        !            40: 
        !            41: i386/conf/UHATEST
        !            42: i386/isa/ultra14f.c
        !            43: 
        !            44: i386/conf/BTTEST
        !            45: i386/isa/bt742a.c
        !            46: 
        !            47: 
        !            48: 
        !            49: ----------------------------------------------------------------
        !            50: This scsi system is designed to allow the re-use of top end drivers
        !            51: such as disk and tape drivers, with different scsi adapters.
        !            52: 
        !            53: As of writing this document, There are top end drivers working for:
        !            54: ----------------------------------------------------------------
        !            55: generic scsi disk
        !            56: generic scsi tape
        !            57: cd-rom  (plays music under the xcplayer (?) program)
        !            58: AEG Character recognition devices *
        !            59: Calera Character recognition devices *
        !            60: Kodak IL900 scanner *
        !            61: Exabyte tape changer device.
        !            62: ----------------------------------------------------------------
        !            63: 
        !            64: 
        !            65: There are also working bottom end drivers for:
        !            66: ----------------------------------------------------------------
        !            67: adaptec 1542 (and 1742 in 1542 mode)
        !            68: bustec 742a
        !            69: adaptec 174x 
        !            70: Ultrastore 14f                         
        !            71: ----------------------------------------------------------------
        !            72: 
        !            73: 
        !            74: Work is proceeding on the following bottom end drivers:
        !            75: ----------------------------------------------------------------
        !            76: Future Domain (1680)**                 [email protected] & me
        !            77: Future Domain (8  bit)****             [email protected]
        !            78: WD7000**                               [email protected]
        !            79: seagate st01/st02****                  [email protected] ?
        !            80: ----------------------------------------------------------------
        !            81: * drivers not made public (proprietary.. proof that the concept works though)
        !            82: ** driver not yet released but working.
        !            83: *** just a dream so far.
        !            84: **** some amount more than just a dream so far.
        !            85: 
        !            86: 
        !            87: ################## Using the scsi system ##################
        !            88: ------------minor numbers---------------
        !            89: This scsi system does not allocate minor numbers to devices depending
        !            90: on their SCSI IDs is any way. A devices minor number is dependant
        !            91: on the order in which it was found.
        !            92: e.g. the first tape found will become st0 (minor number 0)
        !            93:        the second found will become st1 (minor number 16)
        !            94:        the third will become st2 (minor 32) 
        !            95:        etc.
        !            96: 
        !            97: These devices could be on the same scsi bus or different scsi busses.
        !            98: That would not change their minor numbers.
        !            99: 
        !           100: It is possible to run two different TYPES of scsi adapters at the 
        !           101: same time and have st0 on one and st1 on another. (for example)
        !           102: 
        !           103: There is a scheme supported in which scsi devices can be 'wired in' even
        !           104: if they are not present or powered on at probe time. (see scsiconf.c)
        !           105: 
        !           106: --------------getting started------------
        !           107: It should be possible to use the /dev entries for as0 as if they were 
        !           108: /dev entries for sd0 and the old as bootblocks should
        !           109: continue to work if you are using an adaptec 1542b.
        !           110: 
        !           111: --------------making devices------------
        !           112: A changed version of /dev/MAKEDEV is supplied that
        !           113: can be used to make devices sd[01234] and st[01234]
        !           114: 
        !           115: e.g. 
        !           116: cd /dev
        !           117: sh MAKEDEV sd0 sd1 sd2 st0 st1 cd0
        !           118: 
        !           119: 
        !           120: The tape devices are as follows:
        !           121: rst0   basic raw device, will rewind on close
        !           122: nrst0  will not rewind on close
        !           123: erst0  will rewind and EJECTon close
        !           124: nerst0  will not rewind and WILL eject (some devices may rewind anyhow)
        !           125: 
        !           126: ------------future enhancements--------------
        !           127: Some people have indicated that they would like to have the SCSI ID
        !           128: encoded into the minor number in some way, and
        !           129: this may be supported at some timein the future, using
        !           130: minor numbers greater than 128. (or maybe a different major number)
        !           131: 
        !           132: I will also be writing (probably) a generic scsi-error
        !           133: handling routine that will be table driven, so that the routine can
        !           134: be removed from each individual driver. With enough care,
        !           135: two similar devices with different error codes (quite common) could run
        !           136: the same driver but use different error tables.
        !           137: 
        !           138: --------------file layout-------------------
        !           139: Originally I had all scsi definitions in one file: scsi.h
        !           140: I have since moved definitions of commands so that all
        !           141: definitions needed for a particular type of device are
        !           142: found together in the include file of that name.
        !           143: This approximatly follows the layout of their definition 
        !           144: in the SCSI-2 spec. 
        !           145: As such they are:
        !           146: 
        !           147: scsi_all.h             general commands for all devices --- CHAPTER 7
        !           148: scsi-disk.h            commands relevant to disk        --- CHAPTER 8
        !           149: scsi-tape.h            commands for scsi tapes          --- CHAPTER 9
        !           150: scsi-cd.h              commands for cd-roms (and audio) --- CHAPTER 13
        !           151: scsi-changer.h         commands medium changer devices  --- CHAPTER 16
        !           152: 
        !           153: ---------ioctl definitions-------------
        !           154: User accessable structures (e.g. ioctl definitions) have been
        !           155: placed in sys/cdio and sys/chio (based after sys/mtio for
        !           156: the ioctls for mag tapes (including st).
        !           157: 
        !           158: -----------cd-rom-----------------
        !           159: The cd rom driver ha been tested by a number of people and
        !           160: [email protected] has completed the audio play
        !           161: functions.
        !           162: He tells me he has some Public Domain package that
        !           163: allows an control of the cd player from an Xwindow
        !           164: but I don't have it.
        !           165: 
        !           166: -------------media changer---------------
        !           167: Once again courtesy of [email protected].
        !           168: I have not tested this but he assures me it's ready for testing.
        !           169: If anyone has an exabyte tape changer or similar, 
        !           170: contact the author for information regarding the control interface
        !           171: and program.
        !           172: 
        !           173: -----------booting from an AHA-174x---------
        !           174: For some reason I have not yet worked out,
        !           175: the BIOS-based bootblocks I have posted will not boot
        !           176: from the aha1742 in extended mode. (it can't be serious
        !           177: because the MACH version works) This is in fact not a 
        !           178: problem because the aha1742 driver will force the board into extended
        !           179: mode during probe, so it can be left in standard mode during the boot.
        !           180: During the next reboot, the bios will place it back in standard mode
        !           181: ready for the NEXT boot.
        !           182: 

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