xref: /dragonfly/sbin/iscontrol/iscontrol.h (revision 77b0c609)
1 /*-
2  * Copyright (c) 2005-2008 Daniel Braniss <danny@cs.huji.ac.il>
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24  * SUCH DAMAGE.
25  *
26  * $FreeBSD$
27  */
28 /*
29  | $Id: iscontrol.h,v 2.3 2007/04/27 08:36:49 danny Exp danny $
30  */
31 #define INITIATORMOD "iscsi_initiator"
32 
33 #ifdef DEBUG
34 int vflag;
35 
36 # define debug(level, fmt, args...)	do {if (level <= vflag) printf("%s: " fmt "\n", __func__ , ##args);} while(0)
37 # define debug_called(level)		do {if (level <= vflag) printf("%s: called\n", __func__);} while(0)
38 #else
39 # define debug(level, fmt, args...)
40 # define debug_called(level)
41 #endif // DEBUG
42 #define xdebug(fmt, args...)	printf("%s: " fmt "\n", __func__ , ##args)
43 
44 #define BIT(n)	(1 <<(n))
45 
46 #define MAXREDIRECTS	2
47 
48 typedef int auth_t(void *sess);
49 
50 typedef struct {
51      char      *address;
52      int       port;
53      int       pgt;
54 } target_t;
55 
56 typedef struct isess {
57      int	flags;
58 #define SESS_CONNECTED		BIT(0)
59 #define SESS_DISCONNECT		BIT(1)
60 #define SESS_LOGGEDIN		BIT(2)
61 #define SESS_RECONNECT		BIT(3)
62 #define SESS_REDIRECT		BIT(4)
63 
64 #define SESS_NEGODONE		BIT(10)	// XXX: kludge
65 
66 #define SESS_FULLFEATURE	BIT(29)
67 #define SESS_INITIALLOGIN1	BIT(30)
68 #define SESS_INITIALLOGIN	BIT(31)
69 
70 
71      isc_opt_t	*op;		// operational values
72      target_t  target;         // the Original target address
73      int	fd;		// the session fd
74      int	soc;		// the socket
75      iscsi_cam_t	cam;
76      struct cam_device	*camdev;
77 
78      time_t	open_time;
79      int	redirect_cnt;
80      time_t	redirect_time;
81      int	reconnect_cnt;
82      int	reconnect_cnt1;
83      time_t	reconnect_time;
84      char	isid[6+1];
85      int	csg;		// current stage
86      int	nsg;		// next stage
87      // Phases/Stages
88 #define	SN_PHASE	0	// Security Negotiation
89 #define LON_PHASE	1	// Login Operational Negotiation
90 #define FF_PHASE	3	// FuLL-Feature
91      uint	tsih;
92      sn_t	sn;
93 } isess_t;
94 
95 typedef struct token {
96      char	*name;
97      int	val;
98 } token_t;
99 
100 typedef enum {
101      NONE	= 0,
102      KRB5,
103      SPKM1,
104      SPKM2,
105      SRP,
106      CHAP
107 } authm_t;
108 
109 extern token_t AuthMethods[];
110 extern token_t DigestMethods[];
111 
112 typedef enum {
113      SET,
114      GET
115 } oper_t;
116 
117 typedef enum {
118      U_PR,	// private
119      U_IO,	// Initialize Only -- during login
120      U_LO,	// Leading Only -- when TSIH is zero
121      U_FFPO,	// Full Feature Phase Only
122      U_ALL	// in any phase
123 } usage_t;
124 
125 typedef enum {
126      S_PR,
127      S_CO,	// Connect only
128      S_SW	// Session Wide
129 } scope_t;
130 
131 typedef void keyfun_t(isess_t *, oper_t);
132 
133 typedef struct {
134      usage_t	usage;
135      scope_t	scope;
136      char	*name;
137      int	tokenID;
138 } textkey_t;
139 
140 typedef int handler_t(isess_t *sess, pdu_t *pp);
141 
142 int	authenticateLogin(isess_t *sess);
143 int	fsm(isc_opt_t *op);
144 int	sendPDU(isess_t *sess, pdu_t *pp, handler_t *hdlr);
145 int	addText(pdu_t *pp, char *fmt, ...) __printflike(2, 3);
146 void	freePDU(pdu_t *pp);
147 int	xmitpdu(isess_t *sess, pdu_t *pp);
148 int	recvpdu(isess_t *sess, pdu_t *pp);
149 void	pukeText(char *it, pdu_t *pp);
150 
151 int	lookup(token_t *tbl, char *m);
152 
153 int	vflag;
154 char	*iscsidev;
155 
156 void	parseArgs(int nargs, char **args, isc_opt_t *op);
157 void	parseConfig(FILE *fd, char *key, isc_opt_t *op);
158 
159 char	*chapDigest(char *ap, char id, char *cp, char *chapSecret);
160 char	*genChapChallenge(char *encoding, size_t len);
161 
162 int	str2bin(char *str, char **rsp);
163 char	*bin2str(char *fmt, unsigned char *md, int blen);
164 
165 int	negotiateOPV(isess_t *sess);
166 int	setOptions(isess_t *sess, int flag);
167 
168 int	loginPhase(isess_t *sess);
169