xref: /netbsd/sys/dev/scsipi/scsi_base.c (revision bf9ec67e)
1 /*	$NetBSD: scsi_base.c,v 1.77 2001/11/15 09:48:16 lukem Exp $	*/
2 
3 /*-
4  * Copyright (c) 1998 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
7  * This code is derived from software contributed to The NetBSD Foundation
8  * by Charles M. Hannum.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  * 3. All advertising materials mentioning features or use of this software
19  *    must display the following acknowledgement:
20  *        This product includes software developed by the NetBSD
21  *        Foundation, Inc. and its contributors.
22  * 4. Neither the name of The NetBSD Foundation nor the names of its
23  *    contributors may be used to endorse or promote products derived
24  *    from this software without specific prior written permission.
25  *
26  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
27  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
28  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
29  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
30  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
31  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
32  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
33  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
34  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
35  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
36  * POSSIBILITY OF SUCH DAMAGE.
37  */
38 
39 #include <sys/cdefs.h>
40 __KERNEL_RCSID(0, "$NetBSD: scsi_base.c,v 1.77 2001/11/15 09:48:16 lukem Exp $");
41 
42 #include <sys/param.h>
43 #include <sys/systm.h>
44 #include <sys/kernel.h>
45 #include <sys/buf.h>
46 #include <sys/uio.h>
47 #include <sys/malloc.h>
48 #include <sys/errno.h>
49 #include <sys/device.h>
50 #include <sys/proc.h>
51 
52 #include <dev/scsipi/scsipi_all.h>
53 #include <dev/scsipi/scsi_all.h>
54 #include <dev/scsipi/scsi_disk.h>
55 #include <dev/scsipi/scsiconf.h>
56 #include <dev/scsipi/scsipi_base.h>
57 
58 /*
59  * Do a scsi operation, asking a device to run as SCSI-II if it can.
60  */
61 int
62 scsi_change_def(periph, flags)
63 	struct scsipi_periph *periph;
64 	int flags;
65 {
66 	struct scsi_changedef scsipi_cmd;
67 
68 	memset(&scsipi_cmd, 0, sizeof(scsipi_cmd));
69 	scsipi_cmd.opcode = SCSI_CHANGE_DEFINITION;
70 	scsipi_cmd.how = SC_SCSI_2;
71 
72 	return (scsipi_command(periph,
73 	    (struct scsipi_generic *) &scsipi_cmd, sizeof(scsipi_cmd),
74 	    0, 0, SCSIPIRETRIES, 100000, NULL, flags));
75 }
76 
77 /*
78  * ask the scsi driver to perform a command for us.
79  * tell it where to read/write the data, and how
80  * long the data is supposed to be. If we have  a buf
81  * to associate with the transfer, we need that too.
82  */
83 int
84 scsi_scsipi_cmd(periph, scsipi_cmd, cmdlen, data, datalen,
85 	retries, timeout, bp, flags)
86 	struct scsipi_periph *periph;
87 	struct scsipi_generic *scsipi_cmd;
88 	int cmdlen;
89 	void *data;
90 	size_t datalen;
91 	int retries;
92 	int timeout;
93 	struct buf *bp;
94 	int flags;
95 {
96 	struct scsipi_xfer *xs;
97 	int error, s;
98 
99 	SC_DEBUG(periph, SCSIPI_DB2, ("scsi_scsipi_cmd\n"));
100 
101 #ifdef DIAGNOSTIC
102 	if (bp != NULL && (flags & XS_CTL_ASYNC) == 0)
103 		panic("scsi_scsipi_cmd: buffer without async");
104 #endif
105 
106 	if ((xs = scsipi_make_xs(periph, scsipi_cmd, cmdlen, data,
107 	    datalen, retries, timeout, bp, flags)) == NULL) {
108 		if (bp != NULL) {
109 			s = splbio();
110 			bp->b_flags |= B_ERROR;
111 			bp->b_error = ENOMEM;
112 			biodone(bp);
113 			splx(s);
114 		}
115 		return (ENOMEM);
116 	}
117 
118 	/*
119 	 * Set the LUN in the CDB if we have an older device.  We also
120 	 * set it for more modern SCSI-2 devices "just in case".
121 	 */
122 	if (periph->periph_version <= 2)
123 		xs->cmd->bytes[0] |=
124 		    ((periph->periph_lun << SCSI_CMD_LUN_SHIFT) &
125 			SCSI_CMD_LUN_MASK);
126 
127 	if ((error = scsipi_execute_xs(xs)) == EJUSTRETURN)
128 		return (0);
129 	return (error);
130 }
131 
132 /*
133  * Utility routines often used in SCSI stuff
134  */
135 
136 /*
137  * Print out the periph's address info.
138  */
139 void
140 scsi_print_addr(periph)
141 	struct scsipi_periph *periph;
142 {
143 	struct scsipi_channel *chan = periph->periph_channel;
144 	struct scsipi_adapter *adapt = chan->chan_adapter;
145 
146 	printf("%s(%s:%d:%d:%d): ", periph->periph_dev != NULL ?
147 	    periph->periph_dev->dv_xname : "probe",
148 	    adapt->adapt_dev->dv_xname,
149 	    chan->chan_channel, periph->periph_target,
150 	    periph->periph_lun);
151 }
152 
153 /*
154  * Kill off all pending xfers for a periph.
155  *
156  * Must be called at splbio().
157  */
158 void
159 scsi_kill_pending(periph)
160 	struct scsipi_periph *periph;
161 {
162 	struct scsipi_xfer *xs;
163 
164 	while ((xs = TAILQ_FIRST(&periph->periph_xferq)) != NULL) {
165 		xs->error = XS_DRIVER_STUFFUP;
166 		scsipi_done(xs);
167 	}
168 }
169