ctld.h revision 263723
1123475Swpaul/*- 2123475Swpaul * Copyright (c) 2012 The FreeBSD Foundation 3124060Swpaul * All rights reserved. 4124060Swpaul * 5124060Swpaul * This software was developed by Edward Tomasz Napierala under sponsorship 6124060Swpaul * from the FreeBSD Foundation. 7124060Swpaul * 8124060Swpaul * Redistribution and use in source and binary forms, with or without 9124060Swpaul * modification, are permitted provided that the following conditions 10124060Swpaul * are met: 11124060Swpaul * 1. Redistributions of source code must retain the above copyright 12124060Swpaul * notice, this list of conditions and the following disclaimer. 13124060Swpaul * 2. Redistributions in binary form must reproduce the above copyright 14124060Swpaul * notice, this list of conditions and the following disclaimer in the 15124060Swpaul * documentation and/or other materials provided with the distribution. 16124060Swpaul * 17124060Swpaul * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 18124060Swpaul * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19124060Swpaul * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20124060Swpaul * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 21124060Swpaul * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22124060Swpaul * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23124060Swpaul * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24124060Swpaul * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25124060Swpaul * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26124060Swpaul * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27124060Swpaul * SUCH DAMAGE. 28124060Swpaul * 29124060Swpaul * $FreeBSD: stable/10/usr.sbin/ctld/ctld.h 263723 2014-03-25 12:10:30Z trasz $ 30124060Swpaul */ 31124060Swpaul 32123475Swpaul#ifndef CTLD_H 33123475Swpaul#define CTLD_H 34123475Swpaul 35123475Swpaul#include <sys/queue.h> 36123475Swpaul#include <stdbool.h> 37123475Swpaul#include <libutil.h> 38123475Swpaul 39123475Swpaul#define DEFAULT_CONFIG_PATH "/etc/ctl.conf" 40123475Swpaul#define DEFAULT_PIDFILE "/var/run/ctld.pid" 41123475Swpaul#define DEFAULT_BLOCKSIZE 512 42123475Swpaul 43123475Swpaul#define MAX_NAME_LEN 223 44123475Swpaul#define MAX_DATA_SEGMENT_LENGTH (128 * 1024) 45123475Swpaul#define MAX_BURST_LENGTH 16776192 46123475Swpaul 47123475Swpaulstruct auth { 48123475Swpaul TAILQ_ENTRY(auth) a_next; 49123475Swpaul struct auth_group *a_auth_group; 50123475Swpaul char *a_user; 51123475Swpaul char *a_secret; 52123475Swpaul char *a_mutual_user; 53123475Swpaul char *a_mutual_secret; 54123475Swpaul}; 55123475Swpaul 56123475Swpaulstruct auth_name { 57123475Swpaul TAILQ_ENTRY(auth_name) an_next; 58123475Swpaul struct auth_group *an_auth_group; 59123475Swpaul char *an_initator_name; 60123475Swpaul}; 61123475Swpaul 62123475Swpaulstruct auth_portal { 63123475Swpaul TAILQ_ENTRY(auth_portal) ap_next; 64123475Swpaul struct auth_group *ap_auth_group; 65123475Swpaul char *ap_initator_portal; 66123475Swpaul}; 67123475Swpaul 68123475Swpaul#define AG_TYPE_UNKNOWN 0 69123475Swpaul#define AG_TYPE_NO_AUTHENTICATION 1 70123475Swpaul#define AG_TYPE_CHAP 2 71123475Swpaul#define AG_TYPE_CHAP_MUTUAL 3 72123475Swpaul 73123475Swpaulstruct auth_group { 74123475Swpaul TAILQ_ENTRY(auth_group) ag_next; 75123475Swpaul struct conf *ag_conf; 76123475Swpaul char *ag_name; 77123475Swpaul struct target *ag_target; 78123475Swpaul int ag_type; 79123475Swpaul TAILQ_HEAD(, auth) ag_auths; 80123475Swpaul TAILQ_HEAD(, auth_name) ag_names; 81123475Swpaul TAILQ_HEAD(, auth_portal) ag_portals; 82123475Swpaul}; 83123475Swpaul 84123475Swpaulstruct portal { 85123475Swpaul TAILQ_ENTRY(portal) p_next; 86123475Swpaul struct portal_group *p_portal_group; 87123475Swpaul bool p_iser; 88123475Swpaul char *p_listen; 89123475Swpaul struct addrinfo *p_ai; 90123475Swpaul 91123475Swpaul TAILQ_HEAD(, target) p_targets; 92123475Swpaul int p_socket; 93123475Swpaul}; 94123475Swpaul 95123475Swpaulstruct portal_group { 96123475Swpaul TAILQ_ENTRY(portal_group) pg_next; 97123475Swpaul struct conf *pg_conf; 98123475Swpaul char *pg_name; 99123475Swpaul struct auth_group *pg_discovery_auth_group; 100123475Swpaul bool pg_unassigned; 101123475Swpaul TAILQ_HEAD(, portal) pg_portals; 102123475Swpaul 103123475Swpaul uint16_t pg_tag; 104123475Swpaul}; 105123475Swpaul 106123475Swpaulstruct lun_option { 107123475Swpaul TAILQ_ENTRY(lun_option) lo_next; 108123475Swpaul struct lun *lo_lun; 109123475Swpaul char *lo_name; 110123475Swpaul char *lo_value; 111}; 112 113struct lun { 114 TAILQ_ENTRY(lun) l_next; 115 TAILQ_HEAD(, lun_option) l_options; 116 struct target *l_target; 117 int l_lun; 118 char *l_backend; 119 int l_blocksize; 120 char *l_device_id; 121 char *l_path; 122 char *l_serial; 123 int64_t l_size; 124 125 int l_ctl_lun; 126}; 127 128struct target { 129 TAILQ_ENTRY(target) t_next; 130 TAILQ_HEAD(, lun) t_luns; 131 struct conf *t_conf; 132 struct auth_group *t_auth_group; 133 struct portal_group *t_portal_group; 134 char *t_name; 135 char *t_alias; 136}; 137 138struct conf { 139 char *conf_pidfile_path; 140 TAILQ_HEAD(, target) conf_targets; 141 TAILQ_HEAD(, auth_group) conf_auth_groups; 142 TAILQ_HEAD(, portal_group) conf_portal_groups; 143 int conf_debug; 144 int conf_timeout; 145 int conf_maxproc; 146 147 uint16_t conf_last_portal_group_tag; 148 struct pidfh *conf_pidfh; 149}; 150 151#define CONN_SESSION_TYPE_NONE 0 152#define CONN_SESSION_TYPE_DISCOVERY 1 153#define CONN_SESSION_TYPE_NORMAL 2 154 155#define CONN_DIGEST_NONE 0 156#define CONN_DIGEST_CRC32C 1 157 158struct connection { 159 struct portal *conn_portal; 160 struct target *conn_target; 161 int conn_socket; 162 int conn_session_type; 163 char *conn_initiator_name; 164 char *conn_initiator_addr; 165 char *conn_initiator_alias; 166 uint32_t conn_cmdsn; 167 uint32_t conn_statsn; 168 size_t conn_max_data_segment_length; 169 size_t conn_max_burst_length; 170 int conn_immediate_data; 171 int conn_header_digest; 172 int conn_data_digest; 173}; 174 175struct pdu { 176 struct connection *pdu_connection; 177 struct iscsi_bhs *pdu_bhs; 178 char *pdu_data; 179 size_t pdu_data_len; 180}; 181 182#define KEYS_MAX 1024 183 184struct keys { 185 char *keys_names[KEYS_MAX]; 186 char *keys_values[KEYS_MAX]; 187 char *keys_data; 188 size_t keys_data_len; 189}; 190 191struct conf *conf_new(void); 192struct conf *conf_new_from_file(const char *path); 193struct conf *conf_new_from_kernel(void); 194void conf_delete(struct conf *conf); 195int conf_verify(struct conf *conf); 196 197struct auth_group *auth_group_new(struct conf *conf, const char *name); 198void auth_group_delete(struct auth_group *ag); 199struct auth_group *auth_group_find(struct conf *conf, const char *name); 200 201const struct auth *auth_new_chap(struct auth_group *ag, 202 const char *user, const char *secret); 203const struct auth *auth_new_chap_mutual(struct auth_group *ag, 204 const char *user, const char *secret, 205 const char *user2, const char *secret2); 206const struct auth *auth_find(struct auth_group *ag, 207 const char *user); 208 209const struct auth_name *auth_name_new(struct auth_group *ag, 210 const char *initiator_name); 211bool auth_name_defined(const struct auth_group *ag); 212const struct auth_name *auth_name_find(const struct auth_group *ag, 213 const char *initiator_name); 214 215const struct auth_portal *auth_portal_new(struct auth_group *ag, 216 const char *initiator_portal); 217bool auth_portal_defined(const struct auth_group *ag); 218const struct auth_portal *auth_portal_find(const struct auth_group *ag, 219 const char *initiator_portal); 220 221struct portal_group *portal_group_new(struct conf *conf, const char *name); 222void portal_group_delete(struct portal_group *pg); 223struct portal_group *portal_group_find(struct conf *conf, const char *name); 224int portal_group_add_listen(struct portal_group *pg, 225 const char *listen, bool iser); 226 227struct target *target_new(struct conf *conf, const char *name); 228void target_delete(struct target *target); 229struct target *target_find(struct conf *conf, 230 const char *name); 231 232struct lun *lun_new(struct target *target, int lun_id); 233void lun_delete(struct lun *lun); 234struct lun *lun_find(struct target *target, int lun_id); 235void lun_set_backend(struct lun *lun, const char *value); 236void lun_set_blocksize(struct lun *lun, size_t value); 237void lun_set_device_id(struct lun *lun, const char *value); 238void lun_set_path(struct lun *lun, const char *value); 239void lun_set_serial(struct lun *lun, const char *value); 240void lun_set_size(struct lun *lun, size_t value); 241void lun_set_ctl_lun(struct lun *lun, uint32_t value); 242 243struct lun_option *lun_option_new(struct lun *lun, 244 const char *name, const char *value); 245void lun_option_delete(struct lun_option *clo); 246struct lun_option *lun_option_find(struct lun *lun, const char *name); 247void lun_option_set(struct lun_option *clo, 248 const char *value); 249 250void kernel_init(void); 251int kernel_lun_add(struct lun *lun); 252int kernel_lun_resize(struct lun *lun); 253int kernel_lun_remove(struct lun *lun); 254void kernel_handoff(struct connection *conn); 255int kernel_port_on(void); 256int kernel_port_off(void); 257void kernel_capsicate(void); 258 259/* 260 * ICL_KERNEL_PROXY 261 */ 262void kernel_listen(struct addrinfo *ai, bool iser); 263int kernel_accept(void); 264void kernel_send(struct pdu *pdu); 265void kernel_receive(struct pdu *pdu); 266 267struct keys *keys_new(void); 268void keys_delete(struct keys *keys); 269void keys_load(struct keys *keys, const struct pdu *pdu); 270void keys_save(struct keys *keys, struct pdu *pdu); 271const char *keys_find(struct keys *keys, const char *name); 272int keys_find_int(struct keys *keys, const char *name); 273void keys_add(struct keys *keys, 274 const char *name, const char *value); 275void keys_add_int(struct keys *keys, 276 const char *name, int value); 277 278struct pdu *pdu_new(struct connection *conn); 279struct pdu *pdu_new_response(struct pdu *request); 280void pdu_delete(struct pdu *pdu); 281void pdu_receive(struct pdu *request); 282void pdu_send(struct pdu *response); 283 284void login(struct connection *conn); 285 286void discovery(struct connection *conn); 287 288void log_init(int level); 289void log_set_peer_name(const char *name); 290void log_set_peer_addr(const char *addr); 291void log_err(int, const char *, ...) 292 __dead2 __printf0like(2, 3); 293void log_errx(int, const char *, ...) 294 __dead2 __printf0like(2, 3); 295void log_warn(const char *, ...) __printf0like(1, 2); 296void log_warnx(const char *, ...) __printflike(1, 2); 297void log_debugx(const char *, ...) __printf0like(1, 2); 298 299char *checked_strdup(const char *); 300bool valid_iscsi_name(const char *name); 301bool timed_out(void); 302 303#endif /* !CTLD_H */ 304