xref: /openbmc/linux/drivers/scsi/arm/arm_scsi.h (revision 4f2c0a4acffbec01079c28f839422e64ddeff004)
18c97e2f3SBart Van Assche /* SPDX-License-Identifier: GPL-2.0-only */
28c97e2f3SBart Van Assche /*
38c97e2f3SBart Van Assche  *  Copyright (C) 2002 Russell King
48c97e2f3SBart Van Assche  *
58c97e2f3SBart Van Assche  *  Commonly used functions by the ARM SCSI-II drivers.
68c97e2f3SBart Van Assche  */
78c97e2f3SBart Van Assche 
88c97e2f3SBart Van Assche #include <linux/scatterlist.h>
98c97e2f3SBart Van Assche 
108c97e2f3SBart Van Assche #define BELT_AND_BRACES
118c97e2f3SBart Van Assche 
12*dc417545SBart Van Assche struct arm_cmd_priv {
13*dc417545SBart Van Assche 	struct scsi_pointer scsi_pointer;
14*dc417545SBart Van Assche };
15*dc417545SBart Van Assche 
arm_scsi_pointer(struct scsi_cmnd * cmd)16*dc417545SBart Van Assche static inline struct scsi_pointer *arm_scsi_pointer(struct scsi_cmnd *cmd)
17*dc417545SBart Van Assche {
18*dc417545SBart Van Assche 	struct arm_cmd_priv *acmd = scsi_cmd_priv(cmd);
19*dc417545SBart Van Assche 
20*dc417545SBart Van Assche 	return &acmd->scsi_pointer;
21*dc417545SBart Van Assche }
22*dc417545SBart Van Assche 
238c97e2f3SBart Van Assche /*
248c97e2f3SBart Van Assche  * The scatter-gather list handling.  This contains all
258c97e2f3SBart Van Assche  * the yucky stuff that needs to be fixed properly.
268c97e2f3SBart Van Assche  */
278c97e2f3SBart Van Assche 
288c97e2f3SBart Van Assche /*
298c97e2f3SBart Van Assche  * copy_SCp_to_sg() Assumes contiguous allocation at @sg of at-most @max
308c97e2f3SBart Van Assche  * entries of uninitialized memory. SCp is from scsi-ml and has a valid
318c97e2f3SBart Van Assche  * (possibly chained) sg-list
328c97e2f3SBart Van Assche  */
copy_SCp_to_sg(struct scatterlist * sg,struct scsi_pointer * SCp,int max)338c97e2f3SBart Van Assche static inline int copy_SCp_to_sg(struct scatterlist *sg, struct scsi_pointer *SCp, int max)
348c97e2f3SBart Van Assche {
358c97e2f3SBart Van Assche 	int bufs = SCp->buffers_residual;
368c97e2f3SBart Van Assche 
378c97e2f3SBart Van Assche 	/* FIXME: It should be easy for drivers to loop on copy_SCp_to_sg().
388c97e2f3SBart Van Assche 	 * and to remove this BUG_ON. Use min() in-its-place
398c97e2f3SBart Van Assche 	 */
408c97e2f3SBart Van Assche 	BUG_ON(bufs + 1 > max);
418c97e2f3SBart Van Assche 
428c97e2f3SBart Van Assche 	sg_set_buf(sg, SCp->ptr, SCp->this_residual);
438c97e2f3SBart Van Assche 
448c97e2f3SBart Van Assche 	if (bufs) {
458c97e2f3SBart Van Assche 		struct scatterlist *src_sg;
468c97e2f3SBart Van Assche 		unsigned i;
478c97e2f3SBart Van Assche 
488c97e2f3SBart Van Assche 		for_each_sg(sg_next(SCp->buffer), src_sg, bufs, i)
498c97e2f3SBart Van Assche 			*(++sg) = *src_sg;
508c97e2f3SBart Van Assche 		sg_mark_end(sg);
518c97e2f3SBart Van Assche 	}
528c97e2f3SBart Van Assche 
538c97e2f3SBart Van Assche 	return bufs + 1;
548c97e2f3SBart Van Assche }
558c97e2f3SBart Van Assche 
next_SCp(struct scsi_pointer * SCp)568c97e2f3SBart Van Assche static inline int next_SCp(struct scsi_pointer *SCp)
578c97e2f3SBart Van Assche {
588c97e2f3SBart Van Assche 	int ret = SCp->buffers_residual;
598c97e2f3SBart Van Assche 	if (ret) {
608c97e2f3SBart Van Assche 		SCp->buffer = sg_next(SCp->buffer);
618c97e2f3SBart Van Assche 		SCp->buffers_residual--;
628c97e2f3SBart Van Assche 		SCp->ptr = sg_virt(SCp->buffer);
638c97e2f3SBart Van Assche 		SCp->this_residual = SCp->buffer->length;
648c97e2f3SBart Van Assche 	} else {
658c97e2f3SBart Van Assche 		SCp->ptr = NULL;
668c97e2f3SBart Van Assche 		SCp->this_residual = 0;
678c97e2f3SBart Van Assche 	}
688c97e2f3SBart Van Assche 	return ret;
698c97e2f3SBart Van Assche }
708c97e2f3SBart Van Assche 
get_next_SCp_byte(struct scsi_pointer * SCp)718c97e2f3SBart Van Assche static inline unsigned char get_next_SCp_byte(struct scsi_pointer *SCp)
728c97e2f3SBart Van Assche {
738c97e2f3SBart Van Assche 	char c = *SCp->ptr;
748c97e2f3SBart Van Assche 
758c97e2f3SBart Van Assche 	SCp->ptr += 1;
768c97e2f3SBart Van Assche 	SCp->this_residual -= 1;
778c97e2f3SBart Van Assche 
788c97e2f3SBart Van Assche 	return c;
798c97e2f3SBart Van Assche }
808c97e2f3SBart Van Assche 
put_next_SCp_byte(struct scsi_pointer * SCp,unsigned char c)818c97e2f3SBart Van Assche static inline void put_next_SCp_byte(struct scsi_pointer *SCp, unsigned char c)
828c97e2f3SBart Van Assche {
838c97e2f3SBart Van Assche 	*SCp->ptr = c;
848c97e2f3SBart Van Assche 	SCp->ptr += 1;
858c97e2f3SBart Van Assche 	SCp->this_residual -= 1;
868c97e2f3SBart Van Assche }
878c97e2f3SBart Van Assche 
init_SCp(struct scsi_cmnd * SCpnt)888c97e2f3SBart Van Assche static inline void init_SCp(struct scsi_cmnd *SCpnt)
898c97e2f3SBart Van Assche {
90*dc417545SBart Van Assche 	struct scsi_pointer *scsi_pointer = arm_scsi_pointer(SCpnt);
91*dc417545SBart Van Assche 
92*dc417545SBart Van Assche 	memset(scsi_pointer, 0, sizeof(struct scsi_pointer));
938c97e2f3SBart Van Assche 
948c97e2f3SBart Van Assche 	if (scsi_bufflen(SCpnt)) {
958c97e2f3SBart Van Assche 		unsigned long len = 0;
968c97e2f3SBart Van Assche 
97*dc417545SBart Van Assche 		scsi_pointer->buffer = scsi_sglist(SCpnt);
98*dc417545SBart Van Assche 		scsi_pointer->buffers_residual = scsi_sg_count(SCpnt) - 1;
99*dc417545SBart Van Assche 		scsi_pointer->ptr = sg_virt(scsi_pointer->buffer);
100*dc417545SBart Van Assche 		scsi_pointer->this_residual = scsi_pointer->buffer->length;
101*dc417545SBart Van Assche 		scsi_pointer->phase = scsi_bufflen(SCpnt);
1028c97e2f3SBart Van Assche 
1038c97e2f3SBart Van Assche #ifdef BELT_AND_BRACES
1048c97e2f3SBart Van Assche 		{	/*
1058c97e2f3SBart Van Assche 			 * Calculate correct buffer length.  Some commands
1068c97e2f3SBart Van Assche 			 * come in with the wrong scsi_bufflen.
1078c97e2f3SBart Van Assche 			 */
1088c97e2f3SBart Van Assche 			struct scatterlist *sg;
1098c97e2f3SBart Van Assche 			unsigned i, sg_count = scsi_sg_count(SCpnt);
1108c97e2f3SBart Van Assche 
1118c97e2f3SBart Van Assche 			scsi_for_each_sg(SCpnt, sg, sg_count, i)
1128c97e2f3SBart Van Assche 				len += sg->length;
1138c97e2f3SBart Van Assche 
1148c97e2f3SBart Van Assche 			if (scsi_bufflen(SCpnt) != len) {
1158c97e2f3SBart Van Assche 				printk(KERN_WARNING
1168c97e2f3SBart Van Assche 				       "scsi%d.%c: bad request buffer "
1178c97e2f3SBart Van Assche 				       "length %d, should be %ld\n",
1188c97e2f3SBart Van Assche 					SCpnt->device->host->host_no,
1198c97e2f3SBart Van Assche 					'0' + SCpnt->device->id,
1208c97e2f3SBart Van Assche 					scsi_bufflen(SCpnt), len);
1218c97e2f3SBart Van Assche 				/*
1228c97e2f3SBart Van Assche 				 * FIXME: Totaly naive fixup. We should abort
1238c97e2f3SBart Van Assche 				 * with error
1248c97e2f3SBart Van Assche 				 */
125*dc417545SBart Van Assche 				scsi_pointer->phase =
1268c97e2f3SBart Van Assche 					min_t(unsigned long, len,
1278c97e2f3SBart Van Assche 					      scsi_bufflen(SCpnt));
1288c97e2f3SBart Van Assche 			}
1298c97e2f3SBart Van Assche 		}
1308c97e2f3SBart Van Assche #endif
1318c97e2f3SBart Van Assche 	} else {
132*dc417545SBart Van Assche 		scsi_pointer->ptr = NULL;
133*dc417545SBart Van Assche 		scsi_pointer->this_residual = 0;
134*dc417545SBart Van Assche 		scsi_pointer->phase = 0;
1358c97e2f3SBart Van Assche 	}
1368c97e2f3SBart Van Assche }
137