Loading...
1/* SPDX-License-Identifier: GPL-2.0 */
2#ifndef _SCSI_PRIV_H
3#define _SCSI_PRIV_H
4
5#include <linux/device.h>
6#include <scsi/scsi_device.h>
7#include <linux/sbitmap.h>
8
9struct bsg_device;
10struct request_queue;
11struct request;
12struct scsi_cmnd;
13struct scsi_device;
14struct scsi_target;
15struct scsi_host_template;
16struct Scsi_Host;
17struct scsi_nl_hdr;
18
19#define SCSI_CMD_RETRIES_NO_LIMIT -1
20
21/*
22 * Error codes used by scsi-ml internally. These must not be used by drivers.
23 */
24enum scsi_ml_status {
25 SCSIML_STAT_OK = 0x00,
26 SCSIML_STAT_RESV_CONFLICT = 0x01, /* Reservation conflict */
27 SCSIML_STAT_NOSPC = 0x02, /* Space allocation on the dev failed */
28 SCSIML_STAT_MED_ERROR = 0x03, /* Medium error */
29 SCSIML_STAT_TGT_FAILURE = 0x04, /* Permanent target failure */
30 SCSIML_STAT_DL_TIMEOUT = 0x05, /* Command Duration Limit timeout */
31};
32
33static inline u8 scsi_ml_byte(int result)
34{
35 return (result >> 8) & 0xff;
36}
37
38/*
39 * Scsi Error Handler Flags
40 */
41#define SCSI_EH_ABORT_SCHEDULED 0x0002 /* Abort has been scheduled */
42
43#define SCSI_SENSE_VALID(scmd) \
44 (((scmd)->sense_buffer[0] & 0x70) == 0x70)
45
46/* hosts.c */
47extern int scsi_init_hosts(void);
48extern void scsi_exit_hosts(void);
49
50/* scsi.c */
51int scsi_init_sense_cache(struct Scsi_Host *shost);
52void scsi_init_command(struct scsi_device *dev, struct scsi_cmnd *cmd);
53#ifdef CONFIG_SCSI_LOGGING
54void scsi_log_send(struct scsi_cmnd *cmd);
55void scsi_log_completion(struct scsi_cmnd *cmd, int disposition);
56#else
57static inline void scsi_log_send(struct scsi_cmnd *cmd)
58 { };
59static inline void scsi_log_completion(struct scsi_cmnd *cmd, int disposition)
60 { };
61#endif
62
63/* scsi_devinfo.c */
64
65/* list of keys for the lists */
66enum scsi_devinfo_key {
67 SCSI_DEVINFO_GLOBAL = 0,
68 SCSI_DEVINFO_SPI,
69};
70
71extern blist_flags_t scsi_get_device_flags(struct scsi_device *sdev,
72 const unsigned char *vendor,
73 const unsigned char *model);
74extern blist_flags_t scsi_get_device_flags_keyed(struct scsi_device *sdev,
75 const unsigned char *vendor,
76 const unsigned char *model,
77 enum scsi_devinfo_key key);
78extern int scsi_dev_info_list_add_keyed(int compatible, char *vendor,
79 char *model, char *strflags,
80 blist_flags_t flags,
81 enum scsi_devinfo_key key);
82extern int scsi_dev_info_list_del_keyed(char *vendor, char *model,
83 enum scsi_devinfo_key key);
84extern int scsi_dev_info_add_list(enum scsi_devinfo_key key, const char *name);
85extern int scsi_dev_info_remove_list(enum scsi_devinfo_key key);
86
87extern int __init scsi_init_devinfo(void);
88extern void scsi_exit_devinfo(void);
89
90/* scsi_error.c */
91extern void scmd_eh_abort_handler(struct work_struct *work);
92extern enum blk_eh_timer_return scsi_timeout(struct request *req);
93extern int scsi_error_handler(void *host);
94extern enum scsi_disposition scsi_decide_disposition(struct scsi_cmnd *cmd);
95extern void scsi_eh_wakeup(struct Scsi_Host *shost, unsigned int busy);
96extern void scsi_eh_scmd_add(struct scsi_cmnd *);
97void scsi_eh_ready_devs(struct Scsi_Host *shost,
98 struct list_head *work_q,
99 struct list_head *done_q);
100int scsi_eh_get_sense(struct list_head *work_q,
101 struct list_head *done_q);
102bool scsi_noretry_cmd(struct scsi_cmnd *scmd);
103void scsi_eh_done(struct scsi_cmnd *scmd);
104
105/* scsi_lib.c */
106extern void scsi_device_unbusy(struct scsi_device *sdev, struct scsi_cmnd *cmd);
107extern void scsi_queue_insert(struct scsi_cmnd *cmd, int reason);
108extern void scsi_io_completion(struct scsi_cmnd *, unsigned int);
109extern void scsi_run_host_queues(struct Scsi_Host *shost);
110extern void scsi_requeue_run_queue(struct work_struct *work);
111extern void scsi_start_queue(struct scsi_device *sdev);
112extern int scsi_mq_setup_tags(struct Scsi_Host *shost);
113extern void scsi_mq_free_tags(struct kref *kref);
114extern void scsi_exit_queue(void);
115extern void scsi_evt_thread(struct work_struct *work);
116
117/* scsi_proc.c */
118#ifdef CONFIG_SCSI_PROC_FS
119extern int scsi_proc_hostdir_add(const struct scsi_host_template *);
120extern void scsi_proc_hostdir_rm(const struct scsi_host_template *);
121extern void scsi_proc_host_add(struct Scsi_Host *);
122extern void scsi_proc_host_rm(struct Scsi_Host *);
123extern int scsi_init_procfs(void);
124extern void scsi_exit_procfs(void);
125#else
126# define scsi_proc_hostdir_add(sht) 0
127# define scsi_proc_hostdir_rm(sht) do { } while (0)
128# define scsi_proc_host_add(shost) do { } while (0)
129# define scsi_proc_host_rm(shost) do { } while (0)
130# define scsi_init_procfs() (0)
131# define scsi_exit_procfs() do { } while (0)
132#endif /* CONFIG_PROC_FS */
133
134/* scsi_scan.c */
135void scsi_enable_async_suspend(struct device *dev);
136extern int scsi_complete_async_scans(void);
137extern int scsi_scan_host_selected(struct Scsi_Host *, unsigned int,
138 unsigned int, u64, enum scsi_scan_mode);
139extern void scsi_forget_host(struct Scsi_Host *);
140
141/* scsi_sysctl.c */
142#ifdef CONFIG_SYSCTL
143extern int scsi_init_sysctl(void);
144extern void scsi_exit_sysctl(void);
145#else
146# define scsi_init_sysctl() (0)
147# define scsi_exit_sysctl() do { } while (0)
148#endif /* CONFIG_SYSCTL */
149
150/* scsi_sysfs.c */
151extern int scsi_sysfs_add_sdev(struct scsi_device *);
152extern int scsi_sysfs_add_host(struct Scsi_Host *);
153extern int scsi_sysfs_register(void);
154extern void scsi_sysfs_unregister(void);
155extern void scsi_sysfs_device_initialize(struct scsi_device *);
156extern struct scsi_transport_template blank_transport_template;
157extern void __scsi_remove_device(struct scsi_device *);
158
159extern struct bus_type scsi_bus_type;
160extern const struct attribute_group *scsi_shost_groups[];
161
162/* scsi_netlink.c */
163#ifdef CONFIG_SCSI_NETLINK
164extern void scsi_netlink_init(void);
165extern void scsi_netlink_exit(void);
166extern struct sock *scsi_nl_sock;
167#else
168static inline void scsi_netlink_init(void) {}
169static inline void scsi_netlink_exit(void) {}
170#endif
171
172/* scsi_pm.c */
173#ifdef CONFIG_PM
174extern const struct dev_pm_ops scsi_bus_pm_ops;
175
176extern void scsi_autopm_get_target(struct scsi_target *);
177extern void scsi_autopm_put_target(struct scsi_target *);
178extern int scsi_autopm_get_host(struct Scsi_Host *);
179extern void scsi_autopm_put_host(struct Scsi_Host *);
180#else
181static inline void scsi_autopm_get_target(struct scsi_target *t) {}
182static inline void scsi_autopm_put_target(struct scsi_target *t) {}
183static inline int scsi_autopm_get_host(struct Scsi_Host *h) { return 0; }
184static inline void scsi_autopm_put_host(struct Scsi_Host *h) {}
185#endif /* CONFIG_PM */
186
187/* scsi_dh.c */
188#ifdef CONFIG_SCSI_DH
189void scsi_dh_add_device(struct scsi_device *sdev);
190void scsi_dh_release_device(struct scsi_device *sdev);
191#else
192static inline void scsi_dh_add_device(struct scsi_device *sdev) { }
193static inline void scsi_dh_release_device(struct scsi_device *sdev) { }
194#endif
195
196struct bsg_device *scsi_bsg_register_queue(struct scsi_device *sdev);
197
198extern int scsi_device_max_queue_depth(struct scsi_device *sdev);
199
200/*
201 * internal scsi timeout functions: for use by mid-layer and transport
202 * classes.
203 */
204
205#define SCSI_DEVICE_BLOCK_MAX_TIMEOUT 600 /* units in seconds */
206
207#endif /* _SCSI_PRIV_H */
1/* SPDX-License-Identifier: GPL-2.0 */
2#ifndef _SCSI_PRIV_H
3#define _SCSI_PRIV_H
4
5#include <linux/device.h>
6#include <scsi/scsi_device.h>
7#include <linux/sbitmap.h>
8
9struct bsg_device;
10struct request_queue;
11struct request;
12struct scsi_cmnd;
13struct scsi_device;
14struct scsi_target;
15struct scsi_host_template;
16struct Scsi_Host;
17struct scsi_nl_hdr;
18
19#define SCSI_CMD_RETRIES_NO_LIMIT -1
20
21/*
22 * Error codes used by scsi-ml internally. These must not be used by drivers.
23 */
24enum scsi_ml_status {
25 SCSIML_STAT_OK = 0x00,
26 SCSIML_STAT_RESV_CONFLICT = 0x01, /* Reservation conflict */
27 SCSIML_STAT_NOSPC = 0x02, /* Space allocation on the dev failed */
28 SCSIML_STAT_MED_ERROR = 0x03, /* Medium error */
29 SCSIML_STAT_TGT_FAILURE = 0x04, /* Permanent target failure */
30};
31
32/*
33 * Scsi Error Handler Flags
34 */
35#define SCSI_EH_ABORT_SCHEDULED 0x0002 /* Abort has been scheduled */
36
37#define SCSI_SENSE_VALID(scmd) \
38 (((scmd)->sense_buffer[0] & 0x70) == 0x70)
39
40/* hosts.c */
41extern int scsi_init_hosts(void);
42extern void scsi_exit_hosts(void);
43
44/* scsi.c */
45int scsi_init_sense_cache(struct Scsi_Host *shost);
46void scsi_init_command(struct scsi_device *dev, struct scsi_cmnd *cmd);
47#ifdef CONFIG_SCSI_LOGGING
48void scsi_log_send(struct scsi_cmnd *cmd);
49void scsi_log_completion(struct scsi_cmnd *cmd, int disposition);
50#else
51static inline void scsi_log_send(struct scsi_cmnd *cmd)
52 { };
53static inline void scsi_log_completion(struct scsi_cmnd *cmd, int disposition)
54 { };
55#endif
56
57/* scsi_devinfo.c */
58
59/* list of keys for the lists */
60enum scsi_devinfo_key {
61 SCSI_DEVINFO_GLOBAL = 0,
62 SCSI_DEVINFO_SPI,
63};
64
65extern blist_flags_t scsi_get_device_flags(struct scsi_device *sdev,
66 const unsigned char *vendor,
67 const unsigned char *model);
68extern blist_flags_t scsi_get_device_flags_keyed(struct scsi_device *sdev,
69 const unsigned char *vendor,
70 const unsigned char *model,
71 enum scsi_devinfo_key key);
72extern int scsi_dev_info_list_add_keyed(int compatible, char *vendor,
73 char *model, char *strflags,
74 blist_flags_t flags,
75 enum scsi_devinfo_key key);
76extern int scsi_dev_info_list_del_keyed(char *vendor, char *model,
77 enum scsi_devinfo_key key);
78extern int scsi_dev_info_add_list(enum scsi_devinfo_key key, const char *name);
79extern int scsi_dev_info_remove_list(enum scsi_devinfo_key key);
80
81extern int __init scsi_init_devinfo(void);
82extern void scsi_exit_devinfo(void);
83
84/* scsi_error.c */
85extern void scmd_eh_abort_handler(struct work_struct *work);
86extern enum blk_eh_timer_return scsi_timeout(struct request *req);
87extern int scsi_error_handler(void *host);
88extern enum scsi_disposition scsi_decide_disposition(struct scsi_cmnd *cmd);
89extern void scsi_eh_wakeup(struct Scsi_Host *shost);
90extern void scsi_eh_scmd_add(struct scsi_cmnd *);
91void scsi_eh_ready_devs(struct Scsi_Host *shost,
92 struct list_head *work_q,
93 struct list_head *done_q);
94int scsi_eh_get_sense(struct list_head *work_q,
95 struct list_head *done_q);
96bool scsi_noretry_cmd(struct scsi_cmnd *scmd);
97void scsi_eh_done(struct scsi_cmnd *scmd);
98
99/* scsi_lib.c */
100extern int scsi_maybe_unblock_host(struct scsi_device *sdev);
101extern void scsi_device_unbusy(struct scsi_device *sdev, struct scsi_cmnd *cmd);
102extern void scsi_queue_insert(struct scsi_cmnd *cmd, int reason);
103extern void scsi_io_completion(struct scsi_cmnd *, unsigned int);
104extern void scsi_run_host_queues(struct Scsi_Host *shost);
105extern void scsi_requeue_run_queue(struct work_struct *work);
106extern void scsi_start_queue(struct scsi_device *sdev);
107extern int scsi_mq_setup_tags(struct Scsi_Host *shost);
108extern void scsi_mq_free_tags(struct kref *kref);
109extern void scsi_exit_queue(void);
110extern void scsi_evt_thread(struct work_struct *work);
111
112/* scsi_proc.c */
113#ifdef CONFIG_SCSI_PROC_FS
114extern int scsi_proc_hostdir_add(const struct scsi_host_template *);
115extern void scsi_proc_hostdir_rm(const struct scsi_host_template *);
116extern void scsi_proc_host_add(struct Scsi_Host *);
117extern void scsi_proc_host_rm(struct Scsi_Host *);
118extern int scsi_init_procfs(void);
119extern void scsi_exit_procfs(void);
120#else
121# define scsi_proc_hostdir_add(sht) 0
122# define scsi_proc_hostdir_rm(sht) do { } while (0)
123# define scsi_proc_host_add(shost) do { } while (0)
124# define scsi_proc_host_rm(shost) do { } while (0)
125# define scsi_init_procfs() (0)
126# define scsi_exit_procfs() do { } while (0)
127#endif /* CONFIG_PROC_FS */
128
129/* scsi_scan.c */
130void scsi_enable_async_suspend(struct device *dev);
131extern int scsi_complete_async_scans(void);
132extern int scsi_scan_host_selected(struct Scsi_Host *, unsigned int,
133 unsigned int, u64, enum scsi_scan_mode);
134extern void scsi_forget_host(struct Scsi_Host *);
135extern void scsi_rescan_device(struct device *);
136
137/* scsi_sysctl.c */
138#ifdef CONFIG_SYSCTL
139extern int scsi_init_sysctl(void);
140extern void scsi_exit_sysctl(void);
141#else
142# define scsi_init_sysctl() (0)
143# define scsi_exit_sysctl() do { } while (0)
144#endif /* CONFIG_SYSCTL */
145
146/* scsi_sysfs.c */
147extern int scsi_sysfs_add_sdev(struct scsi_device *);
148extern int scsi_sysfs_add_host(struct Scsi_Host *);
149extern int scsi_sysfs_register(void);
150extern void scsi_sysfs_unregister(void);
151extern void scsi_sysfs_device_initialize(struct scsi_device *);
152extern int scsi_sysfs_target_initialize(struct scsi_device *);
153extern struct scsi_transport_template blank_transport_template;
154extern void __scsi_remove_device(struct scsi_device *);
155
156extern struct bus_type scsi_bus_type;
157extern const struct attribute_group *scsi_shost_groups[];
158
159/* scsi_netlink.c */
160#ifdef CONFIG_SCSI_NETLINK
161extern void scsi_netlink_init(void);
162extern void scsi_netlink_exit(void);
163extern struct sock *scsi_nl_sock;
164#else
165static inline void scsi_netlink_init(void) {}
166static inline void scsi_netlink_exit(void) {}
167#endif
168
169/* scsi_pm.c */
170#ifdef CONFIG_PM
171extern const struct dev_pm_ops scsi_bus_pm_ops;
172
173extern void scsi_autopm_get_target(struct scsi_target *);
174extern void scsi_autopm_put_target(struct scsi_target *);
175extern int scsi_autopm_get_host(struct Scsi_Host *);
176extern void scsi_autopm_put_host(struct Scsi_Host *);
177#else
178static inline void scsi_autopm_get_target(struct scsi_target *t) {}
179static inline void scsi_autopm_put_target(struct scsi_target *t) {}
180static inline int scsi_autopm_get_host(struct Scsi_Host *h) { return 0; }
181static inline void scsi_autopm_put_host(struct Scsi_Host *h) {}
182#endif /* CONFIG_PM */
183
184/* scsi_dh.c */
185#ifdef CONFIG_SCSI_DH
186void scsi_dh_add_device(struct scsi_device *sdev);
187void scsi_dh_release_device(struct scsi_device *sdev);
188#else
189static inline void scsi_dh_add_device(struct scsi_device *sdev) { }
190static inline void scsi_dh_release_device(struct scsi_device *sdev) { }
191#endif
192
193struct bsg_device *scsi_bsg_register_queue(struct scsi_device *sdev);
194
195extern int scsi_device_max_queue_depth(struct scsi_device *sdev);
196
197/*
198 * internal scsi timeout functions: for use by mid-layer and transport
199 * classes.
200 */
201
202#define SCSI_DEVICE_BLOCK_MAX_TIMEOUT 600 /* units in seconds */
203
204#endif /* _SCSI_PRIV_H */