1 /* 2 * BSG helper library 3 * 4 * Copyright (C) 2008 James Smart, Emulex Corporation 5 * Copyright (C) 2011 Red Hat, Inc. All rights reserved. 6 * Copyright (C) 2011 Mike Christie 7 * 8 * This program is free software; you can redistribute it and/or modify 9 * it under the terms of the GNU General Public License as published by 10 * the Free Software Foundation; either version 2 of the License, or 11 * (at your option) any later version. 12 * 13 * This program is distributed in the hope that it will be useful, 14 * but WITHOUT ANY WARRANTY; without even the implied warranty of 15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 16 * GNU General Public License for more details. 17 * 18 * You should have received a copy of the GNU General Public License 19 * along with this program; if not, write to the Free Software 20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 21 * 22 */ 23 #ifndef _BLK_BSG_ 24 #define _BLK_BSG_ 25 26 #include <linux/blkdev.h> 27 #include <scsi/scsi_request.h> 28 29 struct request; 30 struct device; 31 struct scatterlist; 32 struct request_queue; 33 34 struct bsg_buffer { 35 unsigned int payload_len; 36 int sg_cnt; 37 struct scatterlist *sg_list; 38 }; 39 40 struct bsg_job { 41 struct scsi_request sreq; 42 struct device *dev; 43 44 struct kref kref; 45 46 unsigned int timeout; 47 48 /* Transport/driver specific request/reply structs */ 49 void *request; 50 void *reply; 51 52 unsigned int request_len; 53 unsigned int reply_len; 54 /* 55 * On entry : reply_len indicates the buffer size allocated for 56 * the reply. 57 * 58 * Upon completion : the message handler must set reply_len 59 * to indicates the size of the reply to be returned to the 60 * caller. 61 */ 62 63 /* DMA payloads for the request/response */ 64 struct bsg_buffer request_payload; 65 struct bsg_buffer reply_payload; 66 67 void *dd_data; /* Used for driver-specific storage */ 68 }; 69 70 void bsg_job_done(struct bsg_job *job, int result, 71 unsigned int reply_payload_rcv_len); 72 struct request_queue *bsg_setup_queue(struct device *dev, const char *name, 73 bsg_job_fn *job_fn, int dd_job_size, 74 void (*release)(struct device *)); 75 void bsg_job_put(struct bsg_job *job); 76 int __must_check bsg_job_get(struct bsg_job *job); 77 78 #endif 79