sys/cam/ctl/ctl_ha.h

   1 /*-
   2  * SPDX-License-Identifier: BSD-2-Clause
   3  *
   4  * Copyright (c) 2003-2009 Silicon Graphics International Corp.
   5  * Copyright (c) 2011 Spectra Logic Corporation
   6  * Copyright (c) 2015 Alexander Motin <mav@FreeBSD.org>
   7  * All rights reserved.
   8  *
   9  * Redistribution and use in source and binary forms, with or without
  10  * modification, are permitted provided that the following conditions
  11  * are met:
  12  * 1. Redistributions of source code must retain the above copyright
  13  *    notice, this list of conditions, and the following disclaimer,
  14  *    without modification.
  15  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
  16  *    substantially similar to the "NO WARRANTY" disclaimer below
  17  *    ("Disclaimer") and any redistribution must be conditioned upon
  18  *    including a substantially similar Disclaimer requirement for further
  19  *    binary redistribution.
  20  *
  21  * NO WARRANTY
  22  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  23  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  24  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
  25  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  26  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  27  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  28  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  29  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  30  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
  31  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  32  * POSSIBILITY OF SUCH DAMAGES.
  33  *
  34  * $Id: //depot/users/kenm/FreeBSD-test2/sys/cam/ctl/ctl_ha.h#1 $
  35  */
  36
  37 #ifndef _CTL_HA_H_
  38 #define _CTL_HA_H_
  39
  40 #include <sys/queue.h>
  41
  42 /*
  43  * CTL High Availability Modes:
  44  *
  45  * CTL_HA_MODE_ACT_STBY:  Commands are serialized to the master side.
  46  *                        No media access commands on slave side (Standby).
  47  * CTL_HA_MODE_SER_ONLY:  Commands are serialized to the master side.
  48  *                        Media can be accessed on both sides.
  49  * CTL_HA_MODE_XFER:      Commands and data are forwarded to the
  50  *                        master side for execution.
  51  */
  52 typedef enum {
  53         CTL_HA_MODE_ACT_STBY,
  54         CTL_HA_MODE_SER_ONLY,
  55         CTL_HA_MODE_XFER
  56 } ctl_ha_mode;
  57
  58 /*
  59  * Communication channel IDs for various system components.  This is to
  60  * make sure one CTL instance talks with another, one ZFS instance talks
  61  * with another, etc.
  62  */
  63 typedef enum {
  64         CTL_HA_CHAN_CTL,
  65         CTL_HA_CHAN_DATA,
  66         CTL_HA_CHAN_MAX
  67 } ctl_ha_channel;
  68
  69 /*
  70  * HA communication event notification.  These are events generated by the
  71  * HA communication subsystem.
  72  *
  73  * CTL_HA_EVT_MSG_RECV:         Message received by the other node.
  74  * CTL_HA_EVT_LINK_CHANGE:      Communication channel status changed.
  75  */
  76 typedef enum {
  77         CTL_HA_EVT_NONE,
  78         CTL_HA_EVT_MSG_RECV,
  79         CTL_HA_EVT_LINK_CHANGE,
  80         CTL_HA_EVT_MAX
  81 } ctl_ha_event;
  82
  83 typedef enum {
  84         CTL_HA_STATUS_WAIT,
  85         CTL_HA_STATUS_SUCCESS,
  86         CTL_HA_STATUS_ERROR,
  87         CTL_HA_STATUS_INVALID,
  88         CTL_HA_STATUS_DISCONNECT,
  89         CTL_HA_STATUS_BUSY,
  90         CTL_HA_STATUS_MAX
  91 } ctl_ha_status;
  92
  93 typedef enum {
  94         CTL_HA_DT_CMD_READ,
  95         CTL_HA_DT_CMD_WRITE,
  96 } ctl_ha_dt_cmd;
  97
  98 struct ctl_ha_dt_req;
  99
 100 typedef void (*ctl_ha_dt_cb)(struct ctl_ha_dt_req *);
 101
 102 struct ctl_ha_dt_req {
 103         ctl_ha_dt_cmd   command;
 104         void            *context;
 105         ctl_ha_dt_cb    callback;
 106         int             ret;
 107         uint32_t        size;
 108         uint8_t         *local;
 109         uint8_t         *remote;
 110         TAILQ_ENTRY(ctl_ha_dt_req)       links;
 111 };
 112
 113 struct ctl_softc;
 114 ctl_ha_status ctl_ha_msg_init(struct ctl_softc *softc);
 115 void ctl_ha_msg_shutdown(struct ctl_softc *softc);
 116 ctl_ha_status ctl_ha_msg_destroy(struct ctl_softc *softc);
 117
 118 typedef void (*ctl_evt_handler)(ctl_ha_channel channel, ctl_ha_event event,
 119                                 int param);
 120 void ctl_ha_register_evthandler(ctl_ha_channel channel,
 121                                 ctl_evt_handler handler);
 122
 123 ctl_ha_status ctl_ha_msg_register(ctl_ha_channel channel,
 124     ctl_evt_handler handler);
 125 ctl_ha_status ctl_ha_msg_recv(ctl_ha_channel channel, void *addr,
 126     size_t len, int wait);
 127 ctl_ha_status ctl_ha_msg_send(ctl_ha_channel channel, const void *addr,
 128     size_t len, int wait);
 129 ctl_ha_status ctl_ha_msg_send2(ctl_ha_channel channel, const void *addr,
 130     size_t len, const void *addr2, size_t len2, int wait);
 131 ctl_ha_status ctl_ha_msg_abort(ctl_ha_channel channel);
 132 ctl_ha_status ctl_ha_msg_deregister(ctl_ha_channel channel);
 133
 134 struct ctl_ha_dt_req * ctl_dt_req_alloc(void);
 135 void ctl_dt_req_free(struct ctl_ha_dt_req *req);
 136 ctl_ha_status ctl_dt_single(struct ctl_ha_dt_req *req);
 137
 138 typedef enum {
 139         CTL_HA_LINK_OFFLINE     = 0x00,
 140         CTL_HA_LINK_UNKNOWN     = 0x01,
 141         CTL_HA_LINK_ONLINE      = 0x02
 142 } ctl_ha_link_state;
 143
 144 #endif /* _CTL_HA_H_ */