usr/src/man/man9s/scsi_address.9s

   1 '\" te
   2 .\"  Copyright (c) 2000, Sun Microsystems, Inc.,  All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH SCSI_ADDRESS 9S "Aug 30, 1995"
   7 .SH NAME
   8 scsi_address \- SCSI address structure
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 #include <sys/scsi/scsi.h>
  13 .fi
  14
  15 .SH INTERFACE LEVEL
  16 .sp
  17 .LP
  18 Solaris architecture specific (Solaris DDI)
  19 .SH DESCRIPTION
  20 .sp
  21 .LP
  22 A \fBscsi_address\fR structure defines the addressing components for a
  23 \fBSCSI\fR target device. The address of the target device is separated into
  24 two components: target number and logical unit number. The two addressing
  25 components are used to uniquely identify any type of \fBSCSI\fR device;
  26 however, most devices can be addressed with the target component of the
  27 address.
  28 .sp
  29 .LP
  30 In the case where only the target component is used to address the device, the
  31 logical unit should be set to  \fB0\fR. If the \fBSCSI\fR target device
  32 supports logical units, then the \fBHBA\fR must interpret the logical units
  33 field of the data structure.
  34 .sp
  35 .LP
  36 The \fBpkt_address\fR member of a \fBscsi_pkt\fR(9S) is initialized by
  37 \fBscsi_init_pkt\fR(9F).
  38 .SH STRUCTURE MEMBERS
  39 .sp
  40 .in +2
  41 .nf
  42 scsi_hba_tran_t   *a_hba_tran;  /* Transport vectors for the SCSI bus */
  43 ushort_t          a_target;     /* SCSI target id */
  44 uchar_t           a_lun;        /* SCSI logical unit */
  45 .fi
  46 .in -2
  47
  48 .sp
  49 .LP
  50 \fBa_hba_tran\fR is a pointer to the controlling \fBHBA\fR's transport vector
  51 structure. The \fBSCSA\fR interface uses this field to pass any transport
  52 requests from the \fBSCSI\fR target device drivers to the \fBHBA\fR driver.
  53 .sp
  54 .LP
  55 \fBa_target\fR is the target component of the \fBSCSI\fR address.
  56 .sp
  57 .LP
  58 \fBa_lun\fR is the logical unit component of the \fBSCSI\fR address. The
  59 logical unit is used to further distinguish a \fBSCSI\fR target device that
  60 supports multiple logical units from one that does not. The \fBmakecom\fR(9F)
  61 family of functions use the \fBa_lun\fR field to set the logical unit field in
  62 the \fBSCSI\fR \fBCDB\fR, for compatibility with \fBSCSI-1\fR.
  63 .SH SEE ALSO
  64 .sp
  65 .LP
  66 \fBmakecom\fR(9F), \fBscsi_init_pkt\fR(9F), \fBscsi_hba_tran\fR(9S),
  67 \fBscsi_pkt\fR(9S)
  68 .sp
  69 .LP
  70 \fIWriting Device Drivers\fR