scsi_transport_srp.h 4.98 KB
Newer Older
1 2 3 4 5 6 7
#ifndef SCSI_TRANSPORT_SRP_H
#define SCSI_TRANSPORT_SRP_H

#include <linux/transport_class.h>
#include <linux/types.h>
#include <linux/mutex.h>

8 9 10
#define SRP_RPORT_ROLE_INITIATOR 0
#define SRP_RPORT_ROLE_TARGET 1

11 12
struct srp_rport_identifiers {
	u8 port_id[16];
13
	u8 roles;
14 15
};

16 17 18 19 20 21
/**
 * enum srp_rport_state - SRP transport layer state
 * @SRP_RPORT_RUNNING:   Transport layer operational.
 * @SRP_RPORT_BLOCKED:   Transport layer not operational; fast I/O fail timer
 *                       is running and I/O has been blocked.
 * @SRP_RPORT_FAIL_FAST: Fast I/O fail timer has expired; fail I/O fast.
22
 * @SRP_RPORT_LOST:      Port is being removed.
23 24 25 26 27 28 29 30 31
 */
enum srp_rport_state {
	SRP_RPORT_RUNNING,
	SRP_RPORT_BLOCKED,
	SRP_RPORT_FAIL_FAST,
	SRP_RPORT_LOST,
};

/**
32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50
 * struct srp_rport - SRP initiator or target port
 *
 * Fields that are relevant for SRP initiator and SRP target drivers:
 * @dev:               Device associated with this rport.
 * @port_id:           16-byte port identifier.
 * @roles:             Role of this port - initiator or target.
 *
 * Fields that are only relevant for SRP initiator drivers:
 * @lld_data:          LLD private data.
 * @mutex:             Protects against concurrent rport reconnect /
 *                     fast_io_fail / dev_loss_tmo activity.
 * @state:             rport state.
 * @reconnect_delay:   Reconnect delay in seconds.
 * @failed_reconnects: Number of failed reconnect attempts.
 * @reconnect_work:    Work structure used for scheduling reconnect attempts.
 * @fast_io_fail_tmo:  Fast I/O fail timeout in seconds.
 * @dev_loss_tmo:      Device loss timeout in seconds.
 * @fast_io_fail_work: Work structure used for scheduling fast I/O fail work.
 * @dev_loss_work:     Work structure used for scheduling device loss work.
51
 */
52
struct srp_rport {
53 54
	/* for initiator and target drivers */

55 56 57
	struct device dev;

	u8 port_id[16];
58
	u8 roles;
59 60 61

	/* for initiator drivers */

62 63 64 65
	void			*lld_data;

	struct mutex		mutex;
	enum srp_rport_state	state;
66 67 68
	int			reconnect_delay;
	int			failed_reconnects;
	struct delayed_work	reconnect_work;
69 70 71 72
	int			fast_io_fail_tmo;
	int			dev_loss_tmo;
	struct delayed_work	fast_io_fail_work;
	struct delayed_work	dev_loss_work;
73 74
};

75 76
/**
 * struct srp_function_template
77 78
 *
 * Fields that are only relevant for SRP initiator drivers:
79 80 81 82
 * @has_rport_state: Whether or not to create the state, fast_io_fail_tmo and
 *     dev_loss_tmo sysfs attribute for an rport.
 * @reset_timer_if_blocked: Whether or srp_timed_out() should reset the command
 *     timer if the device on which it has been queued is blocked.
83
 * @reconnect_delay: If not NULL, points to the default reconnect_delay value.
84 85 86 87 88 89
 * @fast_io_fail_tmo: If not NULL, points to the default fast_io_fail_tmo value.
 * @dev_loss_tmo: If not NULL, points to the default dev_loss_tmo value.
 * @reconnect: Callback function for reconnecting to the target. See also
 *     srp_reconnect_rport().
 * @terminate_rport_io: Callback function for terminating all outstanding I/O
 *     requests for an rport.
90 91 92 93 94
 * @rport_delete: Callback function that deletes an rport.
 *
 * Fields that are only relevant for SRP target drivers:
 * @tsk_mgmt_response: Callback function for sending a task management response.
 * @it_nexus_response: Callback function for processing an IT nexus response.
95
 */
96
struct srp_function_template {
97
	/* for initiator drivers */
98 99
	bool has_rport_state;
	bool reset_timer_if_blocked;
100
	int *reconnect_delay;
101 102 103 104
	int *fast_io_fail_tmo;
	int *dev_loss_tmo;
	int (*reconnect)(struct srp_rport *rport);
	void (*terminate_rport_io)(struct srp_rport *rport);
105
	void (*rport_delete)(struct srp_rport *rport);
106
	/* for target drivers */
107
	int (* tsk_mgmt_response)(struct Scsi_Host *, u64, u64, int);
108
	int (* it_nexus_response)(struct Scsi_Host *, u64, int);
109 110 111 112 113 114
};

extern struct scsi_transport_template *
srp_attach_transport(struct srp_function_template *);
extern void srp_release_transport(struct scsi_transport_template *);

115 116
extern void srp_rport_get(struct srp_rport *rport);
extern void srp_rport_put(struct srp_rport *rport);
117 118 119
extern struct srp_rport *srp_rport_add(struct Scsi_Host *,
				       struct srp_rport_identifiers *);
extern void srp_rport_del(struct srp_rport *);
120 121
extern int srp_tmo_valid(int reconnect_delay, int fast_io_fail_tmo,
			 int dev_loss_tmo);
122 123
extern int srp_reconnect_rport(struct srp_rport *rport);
extern void srp_start_tl_fail_timers(struct srp_rport *rport);
124
extern void srp_remove_host(struct Scsi_Host *);
125
extern void srp_stop_rport_timers(struct srp_rport *rport);
126

127 128
/**
 * srp_chkready() - evaluate the transport layer state before I/O
129
 * @rport: SRP target port pointer.
130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148
 *
 * Returns a SCSI result code that can be returned by the LLD queuecommand()
 * implementation. The role of this function is similar to that of
 * fc_remote_port_chkready().
 */
static inline int srp_chkready(struct srp_rport *rport)
{
	switch (rport->state) {
	case SRP_RPORT_RUNNING:
	case SRP_RPORT_BLOCKED:
	default:
		return 0;
	case SRP_RPORT_FAIL_FAST:
		return DID_TRANSPORT_FAILFAST << 16;
	case SRP_RPORT_LOST:
		return DID_NO_CONNECT << 16;
	}
}

149
#endif