Return to scsi.4 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man4

Annotation of researchv10dc/man/adm/man4/scsi.4, revision 1.1

1.1     ! root        1: .TH SCSI 4
        !             2: .CT 2 sa
        !             3: .SH NAME
        !             4: scsi \- SCSI interface
        !             5: .SH SYNOPSIS
        !             6: .B "#include <scsi.h>"
        !             7: .SH DESCRIPTION
        !             8: The special file
        !             9: .F /dev/scsi
        !            10: provides a low level interface to a SCSI bus.
        !            11: Commands are transmitted to the bus by
        !            12: .IR write ;
        !            13: the response to each command is received with
        !            14: .IR read (2).
        !            15: The format of a command is
        !            16: .IP
        !            17: .EX
        !            18: .ta \w'unsigned char scsistatus;  'u
        !            19: unsigned long tran_id; /* transaction id */
        !            20: unsigned char target;  /* SCSI id of target device */
        !            21: unsigned char flags;   /* flags for this transaction */
        !            22: char cmd[10];  /* SCSI command */
        !            23: char data[];   /* optional data */
        !            24: .EE
        !            25: .LP
        !            26: Thus, to send 
        !            27: .I n
        !            28: bytes of data, the byte count for
        !            29: .I write
        !            30: should be
        !            31: .IR n +16.
        !            32: Possible flags are
        !            33: .B SCSI_WR
        !            34: (data goes from host to SCSI),
        !            35: .B SCSI_RD
        !            36: (data goes from SCSI to host),
        !            37: .B SCSI_BRESET
        !            38: (reset the SCSI bus),
        !            39: .B SCSI_RESET
        !            40: (reset the controller),
        !            41: and
        !            42: .B SCSI_SENSE
        !            43: (return extended sense data on error).
        !            44: For most controllers, 
        !            45: .B SCSI_BRESET
        !            46: implies
        !            47: .BR SCSI_RESET .
        !            48: Flags are OR'ed together, and there must be exactly one of
        !            49: .B SCSI_WR
        !            50: and
        !            51: .BR SCSI_RD .
        !            52: .LP
        !            53: The data read is structured as
        !            54: .IP
        !            55: .EX
        !            56: unsigned long tran_id; /* transaction id */
        !            57: unsigned char status;  /* scsi status byte */
        !            58: unsigned char message; /* scsi message byte */
        !            59: unsigned char flags;   /* flags for this transaction */
        !            60: unsigned char c_type;  /* 1=td 2=us */
        !            61: unsigned short c_reg1; /* td=sa, us=csr */
        !            62: unsigned short c_reg2; /* td=mscp, us=per */
        !            63: unsigned char sense[22];       /* extended sense data */
        !            64: char data[];   /* any data */
        !            65: .EE
        !            66: .LP
        !            67: Thus, to read 
        !            68: .I n
        !            69: bytes of data. the byte count to
        !            70: .I read
        !            71: should be
        !            72: .IR n +34.
        !            73: If
        !            74: .I flags
        !            75: has the
        !            76: .B SCSI_CERR
        !            77: bit set,
        !            78: there was a controller error, which is described by the
        !            79: .B c_
        !            80: fields.
        !            81: The values of
        !            82: .B csr
        !            83: (or
        !            84: .BR sa )
        !            85: and
        !            86: .B per
        !            87: (or
        !            88: .BR mscp )
        !            89: are documented in the interface manual for the U.S. Design 1158
        !            90: Unibus controller (or T.D. Systems Viking controller).
        !            91: If the
        !            92: .B SCSI_SENSE
        !            93: bit was set in the 
        !            94: .I write,
        !            95: and the status byte shows a check condition,
        !            96: an attempt is made to get extended sense information.
        !            97: If the attempt succeeds the
        !            98: .B SCSI_SENSE
        !            99: is set in
        !           100: .I flags.
        !           101: Otherwise, the status and message bytes for the failed
        !           102: attempt are placed in
        !           103: .B sense[0]
        !           104: and
        !           105: .B sense[1]
        !           106: respectively.
        !           107: .PP
        !           108: The transaction id identifies which
        !           109: .I write
        !           110: caused the results for this
        !           111: .IR read .
        !           112: This will become more important when multiple simultaneous transactions
        !           113: are allowed.
        !           114: .SH FILES
        !           115: .F /dev/scsi
        !           116: .SH "SEE ALSO"
        !           117: .IR scsish (8)

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