1/* SPDX-License-Identifier: GPL-2.0 */
 2#ifndef _LINUX_BSG_H
 3#define _LINUX_BSG_H
 4
 5#include <uapi/linux/bsg.h>
 6
 7struct request;
 8
 9#ifdef CONFIG_BLK_DEV_BSG
10struct bsg_ops {
11	int	(*check_proto)(struct sg_io_v4 *hdr);
12	int	(*fill_hdr)(struct request *rq, struct sg_io_v4 *hdr,
13				fmode_t mode);
14	int	(*complete_rq)(struct request *rq, struct sg_io_v4 *hdr);
15	void	(*free_rq)(struct request *rq);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
16};
17
 
 
 
18struct bsg_class_device {
19	struct device *class_dev;
 
20	int minor;
21	struct request_queue *queue;
22	const struct bsg_ops *ops;
 
23};
24
25int bsg_register_queue(struct request_queue *q, struct device *parent,
26		const char *name, const struct bsg_ops *ops);
27int bsg_scsi_register_queue(struct request_queue *q, struct device *parent);
28void bsg_unregister_queue(struct request_queue *q);
29#else
30static inline int bsg_scsi_register_queue(struct request_queue *q,
31		struct device *parent)
 
32{
33	return 0;
34}
35static inline void bsg_unregister_queue(struct request_queue *q)
36{
37}
38#endif /* CONFIG_BLK_DEV_BSG */
39#endif /* _LINUX_BSG_H */
 
 
 

 1#ifndef BSG_H
 2#define BSG_H
 3
 4#include <linux/types.h>
 5
 6#define BSG_PROTOCOL_SCSI		0
 7
 8#define BSG_SUB_PROTOCOL_SCSI_CMD	0
 9#define BSG_SUB_PROTOCOL_SCSI_TMF	1
10#define BSG_SUB_PROTOCOL_SCSI_TRANSPORT	2
11
12/*
13 * For flags member below
14 * sg.h sg_io_hdr also has bits defined for it's flags member. However
15 * none of these bits are implemented/used by bsg. The bits below are
16 * allocated to not conflict with sg.h ones anyway.
17 */
18#define BSG_FLAG_Q_AT_TAIL 0x10 /* default, == 0 at this bit, is Q_AT_HEAD */
19
20struct sg_io_v4 {
21	__s32 guard;		/* [i] 'Q' to differentiate from v3 */
22	__u32 protocol;		/* [i] 0 -> SCSI , .... */
23	__u32 subprotocol;	/* [i] 0 -> SCSI command, 1 -> SCSI task
24				   management function, .... */
25
26	__u32 request_len;	/* [i] in bytes */
27	__u64 request;		/* [i], [*i] {SCSI: cdb} */
28	__u64 request_tag;	/* [i] {SCSI: task tag (only if flagged)} */
29	__u32 request_attr;	/* [i] {SCSI: task attribute} */
30	__u32 request_priority;	/* [i] {SCSI: task priority} */
31	__u32 request_extra;	/* [i] {spare, for padding} */
32	__u32 max_response_len;	/* [i] in bytes */
33	__u64 response;		/* [i], [*o] {SCSI: (auto)sense data} */
34
35        /* "dout_": data out (to device); "din_": data in (from device) */
36	__u32 dout_iovec_count;	/* [i] 0 -> "flat" dout transfer else
37				   dout_xfer points to array of iovec */
38	__u32 dout_xfer_len;	/* [i] bytes to be transferred to device */
39	__u32 din_iovec_count;	/* [i] 0 -> "flat" din transfer */
40	__u32 din_xfer_len;	/* [i] bytes to be transferred from device */
41	__u64 dout_xferp;	/* [i], [*i] */
42	__u64 din_xferp;	/* [i], [*o] */
43
44	__u32 timeout;		/* [i] units: millisecond */
45	__u32 flags;		/* [i] bit mask */
46	__u64 usr_ptr;		/* [i->o] unused internally */
47	__u32 spare_in;		/* [i] */
48
49	__u32 driver_status;	/* [o] 0 -> ok */
50	__u32 transport_status;	/* [o] 0 -> ok */
51	__u32 device_status;	/* [o] {SCSI: command completion status} */
52	__u32 retry_delay;	/* [o] {SCSI: status auxiliary information} */
53	__u32 info;		/* [o] additional information */
54	__u32 duration;		/* [o] time to complete, in milliseconds */
55	__u32 response_len;	/* [o] bytes of response actually written */
56	__s32 din_resid;	/* [o] din_xfer_len - actual_din_xfer_len */
57	__s32 dout_resid;	/* [o] dout_xfer_len - actual_dout_xfer_len */
58	__u64 generated_tag;	/* [o] {SCSI: transport generated task tag} */
59	__u32 spare_out;	/* [o] */
60
61	__u32 padding;
62};
63
64#ifdef __KERNEL__
65
66#if defined(CONFIG_BLK_DEV_BSG)
67struct bsg_class_device {
68	struct device *class_dev;
69	struct device *parent;
70	int minor;
71	struct request_queue *queue;
72	struct kref ref;
73	void (*release)(struct device *);
74};
75
76extern int bsg_register_queue(struct request_queue *q,
77			      struct device *parent, const char *name,
78			      void (*release)(struct device *));
79extern void bsg_unregister_queue(struct request_queue *);
80#else
81static inline int bsg_register_queue(struct request_queue *q,
82				     struct device *parent, const char *name,
83				     void (*release)(struct device *))
84{
85	return 0;
86}
87static inline void bsg_unregister_queue(struct request_queue *q)
88{
89}
90#endif
91
92#endif /* __KERNEL__ */
93
94#endif