Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 1 | /*! \file gprs_ns2_internal.h */ |
| 2 | |
| 3 | #pragma once |
| 4 | |
| 5 | #include <stdbool.h> |
| 6 | #include <stdint.h> |
| 7 | |
Alexander Couzens | 6cf65d9 | 2021-01-18 17:55:35 +0100 | [diff] [blame] | 8 | #include <osmocom/core/logging.h> |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 9 | #include <osmocom/gprs/protocol/gsm_08_16.h> |
| 10 | #include <osmocom/gprs/gprs_ns2.h> |
| 11 | |
Harald Welte | f294974 | 2021-01-20 14:54:14 +0100 | [diff] [blame] | 12 | #define LOGNSE(nse, lvl, fmt, args ...) \ |
| 13 | LOGP(DLNS, lvl, "NSE(%05u) " fmt, (nse)->nsei, ## args) |
| 14 | |
| 15 | #define LOGBIND(bind, lvl, fmt, args ...) \ |
| 16 | LOGP(DLNS, lvl, "BIND(%s) " fmt, (bind)->name, ## args) |
| 17 | |
Alexander Couzens | 6cf65d9 | 2021-01-18 17:55:35 +0100 | [diff] [blame] | 18 | #define LOGNSVC_SS(ss, nsvc, lvl, fmt, args ...) \ |
Harald Welte | f294974 | 2021-01-20 14:54:14 +0100 | [diff] [blame] | 19 | do { \ |
| 20 | if ((nsvc)->nsvci_is_valid) { \ |
Alexander Couzens | 6cf65d9 | 2021-01-18 17:55:35 +0100 | [diff] [blame] | 21 | LOGP(ss, lvl, "NSE(%05u)-NSVC(%05u) " fmt, \ |
Harald Welte | f294974 | 2021-01-20 14:54:14 +0100 | [diff] [blame] | 22 | (nsvc)->nse->nsei, (nsvc)->nsvci, ## args); \ |
| 23 | } else { \ |
Alexander Couzens | 6cf65d9 | 2021-01-18 17:55:35 +0100 | [diff] [blame] | 24 | LOGP(ss, lvl, "NSE(%05u)-NSVC(none) " fmt, \ |
Harald Welte | f294974 | 2021-01-20 14:54:14 +0100 | [diff] [blame] | 25 | (nsvc)->nse->nsei, ## args); \ |
| 26 | } \ |
| 27 | } while (0) |
| 28 | |
Alexander Couzens | 6cf65d9 | 2021-01-18 17:55:35 +0100 | [diff] [blame] | 29 | #define LOGNSVC(nsvc, lvl, fmt, args ...) \ |
| 30 | LOGNSVC_SS(DLNS, nsvc, lvl, fmt, ## args) |
| 31 | |
| 32 | #define LOG_NS_SIGNAL(nsvc, direction, pdu_type, lvl, fmt, args ...) \ |
| 33 | LOGNSVC_SS(DLNSSIGNAL, nsvc, lvl, "%s %s" fmt, direction, get_value_string(gprs_ns_pdu_strings, pdu_type), ## args) |
| 34 | |
| 35 | #define LOG_NS_DATA(nsvc, direction, pdu_type, lvl, fmt, args ...) \ |
| 36 | LOGNSVC_SS(DLNSDATA, nsvc, lvl, "%s %s" fmt, direction, get_value_string(gprs_ns_pdu_strings, pdu_type), ## args) |
| 37 | |
| 38 | #define LOG_NS_RX_SIGNAL(nsvc, pdu_type) LOG_NS_SIGNAL(nsvc, "Rx", pdu_type, LOGL_INFO, "\n") |
| 39 | #define LOG_NS_TX_SIGNAL(nsvc, pdu_type) LOG_NS_SIGNAL(nsvc, "Tx", pdu_type, LOGL_INFO, "\n") |
| 40 | |
Daniel Willmann | efa64f9 | 2021-07-09 20:35:00 +0200 | [diff] [blame] | 41 | #define RATE_CTR_INC_NS(nsvc, ctr) \ |
| 42 | do { \ |
| 43 | struct gprs_ns2_vc *_nsvc = (nsvc); \ |
| 44 | rate_ctr_inc(rate_ctr_group_get_ctr(_nsvc->ctrg, ctr)); \ |
| 45 | rate_ctr_inc(rate_ctr_group_get_ctr(_nsvc->nse->ctrg, ctr)); \ |
| 46 | } while (0) |
| 47 | |
| 48 | #define RATE_CTR_ADD_NS(nsvc, ctr, val) \ |
| 49 | do { \ |
| 50 | struct gprs_ns2_vc *_nsvc = (nsvc); \ |
| 51 | rate_ctr_add(rate_ctr_group_get_ctr(_nsvc->ctrg, ctr), val); \ |
| 52 | rate_ctr_add(rate_ctr_group_get_ctr(_nsvc->nse->ctrg, ctr), val); \ |
| 53 | } while (0) |
| 54 | |
Alexander Couzens | 6cf65d9 | 2021-01-18 17:55:35 +0100 | [diff] [blame] | 55 | |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 56 | struct osmo_fsm_inst; |
| 57 | struct tlv_parsed; |
| 58 | struct vty; |
| 59 | |
| 60 | struct gprs_ns2_vc_driver; |
| 61 | struct gprs_ns2_vc_bind; |
| 62 | |
Alexander Couzens | 1f3193d | 2021-06-05 22:08:11 +0200 | [diff] [blame] | 63 | #define NS_TIMERS_COUNT 11 |
| 64 | #define NS_TIMERS "(tns-block|tns-block-retries|tns-reset|tns-reset-retries|tns-test|tns-alive|tns-alive-retries|tsns-prov|tsns-size-retries|tsns-config-retries|tsns-procedures-retries)" |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 65 | #define NS_TIMERS_HELP \ |
| 66 | "(un)blocking Timer (Tns-block) timeout\n" \ |
| 67 | "(un)blocking Timer (Tns-block) number of retries\n" \ |
| 68 | "Reset Timer (Tns-reset) timeout\n" \ |
| 69 | "Reset Timer (Tns-reset) number of retries\n" \ |
| 70 | "Test Timer (Tns-test) timeout\n" \ |
| 71 | "Alive Timer (Tns-alive) timeout\n" \ |
| 72 | "Alive Timer (Tns-alive) number of retries\n" \ |
Alexander Couzens | 90ee963 | 2020-12-07 06:18:32 +0100 | [diff] [blame] | 73 | "SNS Provision Timer (Tsns-prov) timeout\n" \ |
| 74 | "SNS Size number of retries\n" \ |
| 75 | "SNS Config number of retries\n" \ |
Alexander Couzens | 1f3193d | 2021-06-05 22:08:11 +0200 | [diff] [blame] | 76 | "SNS Procedures number of retries\n" \ |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 77 | |
| 78 | /* Educated guess - LLC user payload is 1500 bytes plus possible headers */ |
| 79 | #define NS_ALLOC_SIZE 3072 |
| 80 | #define NS_ALLOC_HEADROOM 20 |
| 81 | |
| 82 | enum ns2_timeout { |
| 83 | NS_TOUT_TNS_BLOCK, |
| 84 | NS_TOUT_TNS_BLOCK_RETRIES, |
| 85 | NS_TOUT_TNS_RESET, |
| 86 | NS_TOUT_TNS_RESET_RETRIES, |
| 87 | NS_TOUT_TNS_TEST, |
| 88 | NS_TOUT_TNS_ALIVE, |
| 89 | NS_TOUT_TNS_ALIVE_RETRIES, |
| 90 | NS_TOUT_TSNS_PROV, |
Alexander Couzens | 90ee963 | 2020-12-07 06:18:32 +0100 | [diff] [blame] | 91 | NS_TOUT_TSNS_SIZE_RETRIES, |
| 92 | NS_TOUT_TSNS_CONFIG_RETRIES, |
Alexander Couzens | 1f3193d | 2021-06-05 22:08:11 +0200 | [diff] [blame] | 93 | NS_TOUT_TSNS_PROCEDURES_RETRIES, |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 94 | }; |
| 95 | |
| 96 | enum nsvc_timer_mode { |
| 97 | /* standard timers */ |
| 98 | NSVC_TIMER_TNS_TEST, |
| 99 | NSVC_TIMER_TNS_ALIVE, |
| 100 | NSVC_TIMER_TNS_RESET, |
| 101 | _NSVC_TIMER_NR, |
| 102 | }; |
| 103 | |
Harald Welte | 7634607 | 2021-01-31 11:54:02 +0100 | [diff] [blame] | 104 | enum ns2_vc_stat { |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 105 | NS_STAT_ALIVE_DELAY, |
| 106 | }; |
| 107 | |
Harald Welte | 7634607 | 2021-01-31 11:54:02 +0100 | [diff] [blame] | 108 | enum ns2_bind_stat { |
| 109 | NS2_BIND_STAT_BACKLOG_LEN, |
| 110 | }; |
| 111 | |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 112 | /*! Osmocom NS2 VC create status */ |
Alexander Couzens | ba5a992 | 2021-01-25 16:03:23 +0100 | [diff] [blame] | 113 | enum ns2_cs { |
| 114 | NS2_CS_CREATED, /*!< A NSVC object has been created */ |
| 115 | NS2_CS_FOUND, /*!< A NSVC object has been found */ |
| 116 | NS2_CS_REJECTED, /*!< Rejected and answered message */ |
| 117 | NS2_CS_SKIPPED, /*!< Skipped message */ |
| 118 | NS2_CS_ERROR, /*!< Failed to process message */ |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 119 | }; |
| 120 | |
Harald Welte | 3d5eaee | 2021-01-30 21:33:02 +0100 | [diff] [blame] | 121 | enum ns_ctr { |
| 122 | NS_CTR_PKTS_IN, |
| 123 | NS_CTR_PKTS_OUT, |
Harald Welte | f22ae5a | 2021-01-30 22:01:28 +0100 | [diff] [blame] | 124 | NS_CTR_PKTS_OUT_DROP, |
Harald Welte | 3d5eaee | 2021-01-30 21:33:02 +0100 | [diff] [blame] | 125 | NS_CTR_BYTES_IN, |
| 126 | NS_CTR_BYTES_OUT, |
Harald Welte | f22ae5a | 2021-01-30 22:01:28 +0100 | [diff] [blame] | 127 | NS_CTR_BYTES_OUT_DROP, |
Harald Welte | 3d5eaee | 2021-01-30 21:33:02 +0100 | [diff] [blame] | 128 | NS_CTR_BLOCKED, |
Harald Welte | b40bf8b | 2021-01-30 22:43:01 +0100 | [diff] [blame] | 129 | NS_CTR_UNBLOCKED, |
Harald Welte | 3d5eaee | 2021-01-30 21:33:02 +0100 | [diff] [blame] | 130 | NS_CTR_DEAD, |
| 131 | NS_CTR_REPLACED, |
| 132 | NS_CTR_NSEI_CHG, |
| 133 | NS_CTR_INV_VCI, |
| 134 | NS_CTR_INV_NSEI, |
| 135 | NS_CTR_LOST_ALIVE, |
| 136 | NS_CTR_LOST_RESET, |
| 137 | }; |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 138 | |
| 139 | #define NSE_S_BLOCKED 0x0001 |
| 140 | #define NSE_S_ALIVE 0x0002 |
| 141 | #define NSE_S_RESET 0x0004 |
| 142 | |
| 143 | #define NS_DESC_B(st) ((st) & NSE_S_BLOCKED ? "BLOCKED" : "UNBLOCKED") |
| 144 | #define NS_DESC_A(st) ((st) & NSE_S_ALIVE ? "ALIVE" : "DEAD") |
| 145 | #define NS_DESC_R(st) ((st) & NSE_S_RESET ? "RESET" : "UNRESET") |
| 146 | |
| 147 | /*! An instance of the NS protocol stack */ |
| 148 | struct gprs_ns2_inst { |
| 149 | /*! callback to the user for incoming UNIT DATA IND */ |
| 150 | osmo_prim_cb cb; |
| 151 | |
| 152 | /*! callback data */ |
| 153 | void *cb_data; |
| 154 | |
| 155 | /*! linked lists of all NSVC binds (e.g. IPv4 bind, but could be also E1 */ |
| 156 | struct llist_head binding; |
| 157 | |
| 158 | /*! linked lists of all NSVC in this instance */ |
| 159 | struct llist_head nse; |
| 160 | |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 161 | uint16_t timeout[NS_TIMERS_COUNT]; |
| 162 | |
| 163 | /*! workaround for rate counter until rate counter accepts char str as index */ |
Harald Welte | 97ccbf7 | 2021-01-31 11:49:19 +0100 | [diff] [blame] | 164 | uint32_t nsvc_rate_ctr_idx; |
Harald Welte | 7634607 | 2021-01-31 11:54:02 +0100 | [diff] [blame] | 165 | uint32_t bind_rate_ctr_idx; |
Harald Welte | 53a2fde | 2020-12-01 22:21:14 +0100 | [diff] [blame] | 166 | |
| 167 | /*! libmnl netlink socket for link state monitoring */ |
| 168 | struct osmo_mnl *linkmon_mnl; |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 169 | }; |
| 170 | |
Harald Welte | 53a2fde | 2020-12-01 22:21:14 +0100 | [diff] [blame] | 171 | |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 172 | /*! Structure repesenting a NSE. The BSS/PCU will only have a single NSE, while SGSN has one for each BSS/PCU */ |
| 173 | struct gprs_ns2_nse { |
| 174 | uint16_t nsei; |
| 175 | |
| 176 | /*! entry back to ns2_inst */ |
| 177 | struct gprs_ns2_inst *nsi; |
| 178 | |
| 179 | /*! llist entry for gprs_ns2_inst */ |
| 180 | struct llist_head list; |
| 181 | |
| 182 | /*! llist head to hold all nsvc */ |
| 183 | struct llist_head nsvc; |
| 184 | |
Alexander Couzens | 8a2a1a4 | 2020-12-26 18:00:17 +0100 | [diff] [blame] | 185 | /*! count all active NSVCs */ |
| 186 | int nsvc_count; |
Alexander Couzens | fc3dd1f | 2020-11-19 00:41:47 +0100 | [diff] [blame] | 187 | |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 188 | /*! true if this NSE was created by VTY or pcu socket) */ |
| 189 | bool persistent; |
| 190 | |
Alexander Couzens | da0a285 | 2020-10-01 23:24:07 +0200 | [diff] [blame] | 191 | /*! true if this NSE wasn't yet alive at all. |
| 192 | * Will be true after the first status ind with NS_AFF_CAUSE_RECOVERY */ |
| 193 | bool first; |
| 194 | |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 195 | /*! true if this NSE has at least one alive VC */ |
| 196 | bool alive; |
| 197 | |
Alexander Couzens | aac9016 | 2020-11-19 02:44:04 +0100 | [diff] [blame] | 198 | /*! which link-layer are we based on? */ |
| 199 | enum gprs_ns2_ll ll; |
| 200 | |
Alexander Couzens | d923cff | 2020-12-01 01:03:52 +0100 | [diff] [blame] | 201 | /*! which dialect does this NSE speaks? */ |
| 202 | enum gprs_ns2_dialect dialect; |
| 203 | |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 204 | struct osmo_fsm_inst *bss_sns_fi; |
Harald Welte | 3221f87 | 2021-01-18 14:58:51 +0100 | [diff] [blame] | 205 | |
Alexander Couzens | e052c41 | 2021-02-15 02:10:57 +0100 | [diff] [blame] | 206 | /*! sum of all the data weight of _alive_ NS-VCs */ |
Harald Welte | 3221f87 | 2021-01-18 14:58:51 +0100 | [diff] [blame] | 207 | uint32_t sum_data_weight; |
| 208 | |
Alexander Couzens | e052c41 | 2021-02-15 02:10:57 +0100 | [diff] [blame] | 209 | /*! sum of all the signalling weight of _alive_ NS-VCs */ |
Harald Welte | 3221f87 | 2021-01-18 14:58:51 +0100 | [diff] [blame] | 210 | uint32_t sum_sig_weight; |
Alexander Couzens | 4f1128f | 2021-01-20 17:42:48 +0100 | [diff] [blame] | 211 | |
| 212 | /*! MTU of a NS PDU. This is the lowest MTU of all NSVCs */ |
| 213 | uint16_t mtu; |
Harald Welte | 5b034fb | 2021-03-04 14:16:49 +0100 | [diff] [blame] | 214 | |
| 215 | /*! are we implementing the SGSN role? */ |
| 216 | bool ip_sns_role_sgsn; |
Daniel Willmann | efa64f9 | 2021-07-09 20:35:00 +0200 | [diff] [blame] | 217 | |
| 218 | /*! NSE-wide statistics */ |
| 219 | struct rate_ctr_group *ctrg; |
Alexander Couzens | 41589a3 | 2021-07-19 03:40:02 +0200 | [diff] [blame] | 220 | |
| 221 | /*! recursive anchor */ |
| 222 | bool freed; |
Alexander Couzens | 2c64c25 | 2021-09-05 23:15:29 +0200 | [diff] [blame] | 223 | |
| 224 | /*! when the NSE became alive or dead */ |
| 225 | struct timespec ts_alive_change; |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 226 | }; |
| 227 | |
| 228 | /*! Structure representing a single NS-VC */ |
| 229 | struct gprs_ns2_vc { |
| 230 | /*! list of NS-VCs within NSE */ |
| 231 | struct llist_head list; |
| 232 | |
| 233 | /*! list of NS-VCs within bind, bind is the owner! */ |
| 234 | struct llist_head blist; |
| 235 | |
| 236 | /*! pointer to NS Instance */ |
| 237 | struct gprs_ns2_nse *nse; |
| 238 | |
| 239 | /*! pointer to NS VL bind. bind own the memory of this instance */ |
| 240 | struct gprs_ns2_vc_bind *bind; |
| 241 | |
| 242 | /*! true if this NS was created by VTY or pcu socket) */ |
| 243 | bool persistent; |
| 244 | |
| 245 | /*! uniquely identifies NS-VC if VC contains nsvci */ |
| 246 | uint16_t nsvci; |
| 247 | |
| 248 | /*! signalling weight. 0 = don't use for signalling (BVCI == 0)*/ |
| 249 | uint8_t sig_weight; |
| 250 | |
Alexander Couzens | fc3dd1f | 2020-11-19 00:41:47 +0100 | [diff] [blame] | 251 | /*! signalling packet counter for the load sharing function */ |
| 252 | uint8_t sig_counter; |
| 253 | |
| 254 | /*! data weight. 0 = don't use for user data (BVCI != 0) */ |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 255 | uint8_t data_weight; |
| 256 | |
| 257 | /*! can be used by the bind/driver of the virtual circuit. e.g. ipv4/ipv6/frgre/e1 */ |
| 258 | void *priv; |
| 259 | |
| 260 | bool nsvci_is_valid; |
Harald Welte | c962a2e | 2021-03-05 08:09:08 +0100 | [diff] [blame] | 261 | /*! should this NS-VC only be used for SNS-SIZE and SNS-CONFIG? */ |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 262 | bool sns_only; |
| 263 | |
| 264 | struct rate_ctr_group *ctrg; |
| 265 | struct osmo_stat_item_group *statg; |
| 266 | |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 267 | enum gprs_ns2_vc_mode mode; |
| 268 | |
| 269 | struct osmo_fsm_inst *fi; |
Alexander Couzens | 41589a3 | 2021-07-19 03:40:02 +0200 | [diff] [blame] | 270 | |
| 271 | /*! recursive anchor */ |
| 272 | bool freed; |
Alexander Couzens | ca5ce0d | 2021-09-05 23:15:56 +0200 | [diff] [blame] | 273 | |
| 274 | /*! when the NSVC became alive or dead */ |
| 275 | struct timespec ts_alive_change; |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 276 | }; |
| 277 | |
| 278 | /*! Structure repesenting a bind instance. E.g. IPv4 listen port. */ |
| 279 | struct gprs_ns2_vc_bind { |
Alexander Couzens | aaa55a6 | 2020-12-03 06:02:03 +0100 | [diff] [blame] | 280 | /*! unique name */ |
| 281 | const char *name; |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 282 | /*! list entry in nsi */ |
| 283 | struct llist_head list; |
| 284 | /*! list of all VC */ |
| 285 | struct llist_head nsvc; |
| 286 | /*! driver private structure */ |
| 287 | void *priv; |
| 288 | /*! a pointer back to the nsi */ |
| 289 | struct gprs_ns2_inst *nsi; |
| 290 | struct gprs_ns2_vc_driver *driver; |
| 291 | |
Alexander Couzens | d923cff | 2020-12-01 01:03:52 +0100 | [diff] [blame] | 292 | bool accept_ipaccess; |
| 293 | bool accept_sns; |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 294 | |
Alexander Couzens | 1c8785d | 2020-12-17 06:58:53 +0100 | [diff] [blame] | 295 | /*! transfer capability in mbit */ |
| 296 | int transfer_capability; |
| 297 | |
Alexander Couzens | 4f1128f | 2021-01-20 17:42:48 +0100 | [diff] [blame] | 298 | /*! MTU of a NS PDU on this bind. */ |
| 299 | uint16_t mtu; |
| 300 | |
Alexander Couzens | aac9016 | 2020-11-19 02:44:04 +0100 | [diff] [blame] | 301 | /*! which link-layer are we based on? */ |
| 302 | enum gprs_ns2_ll ll; |
| 303 | |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 304 | /*! send a msg over a VC */ |
| 305 | int (*send_vc)(struct gprs_ns2_vc *nsvc, struct msgb *msg); |
| 306 | |
| 307 | /*! free the vc priv data */ |
| 308 | void (*free_vc)(struct gprs_ns2_vc *nsvc); |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 309 | |
Alexander Couzens | 22f3471 | 2020-10-02 02:34:39 +0200 | [diff] [blame] | 310 | /*! allow to show information for the vty */ |
| 311 | void (*dump_vty)(const struct gprs_ns2_vc_bind *bind, |
| 312 | struct vty *vty, bool stats); |
Harald Welte | 7634607 | 2021-01-31 11:54:02 +0100 | [diff] [blame] | 313 | |
Alexander Couzens | c470476 | 2021-02-08 23:13:12 +0100 | [diff] [blame] | 314 | /*! the IP-SNS signalling weight when doing dynamic configuration */ |
| 315 | uint8_t sns_sig_weight; |
| 316 | /*! the IP-SNS data weight when doing dynamic configuration */ |
| 317 | uint8_t sns_data_weight; |
| 318 | |
Harald Welte | 7634607 | 2021-01-31 11:54:02 +0100 | [diff] [blame] | 319 | struct osmo_stat_item_group *statg; |
Alexander Couzens | 41589a3 | 2021-07-19 03:40:02 +0200 | [diff] [blame] | 320 | |
| 321 | /*! recursive anchor */ |
| 322 | bool freed; |
Alexander Couzens | 22f3471 | 2020-10-02 02:34:39 +0200 | [diff] [blame] | 323 | }; |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 324 | |
| 325 | struct gprs_ns2_vc_driver { |
| 326 | const char *name; |
| 327 | void *priv; |
| 328 | void (*free_bind)(struct gprs_ns2_vc_bind *driver); |
| 329 | }; |
| 330 | |
Alexander Couzens | 175eb7b | 2021-07-20 18:41:14 +0200 | [diff] [blame] | 331 | enum ns2_sns_event { |
| 332 | NS2_SNS_EV_REQ_SELECT_ENDPOINT, /*!< Select a SNS endpoint from the list */ |
| 333 | NS2_SNS_EV_RX_SIZE, |
| 334 | NS2_SNS_EV_RX_SIZE_ACK, |
| 335 | NS2_SNS_EV_RX_CONFIG, |
| 336 | NS2_SNS_EV_RX_CONFIG_END, /*!< SNS-CONFIG with end flag received */ |
| 337 | NS2_SNS_EV_RX_CONFIG_ACK, |
| 338 | NS2_SNS_EV_RX_ADD, |
| 339 | NS2_SNS_EV_RX_DELETE, |
| 340 | NS2_SNS_EV_RX_CHANGE_WEIGHT, |
| 341 | NS2_SNS_EV_RX_ACK, /*!< Rx of SNS-ACK (response to ADD/DELETE/CHG_WEIGHT */ |
| 342 | NS2_SNS_EV_REQ_NO_NSVC, /*!< no more NS-VC remaining (all dead) */ |
Alexander Couzens | 83f06ce | 2021-08-06 19:50:09 +0200 | [diff] [blame] | 343 | NS2_SNS_EV_REQ_FREE_NSVCS, /*!< free all NS-VCs */ |
Alexander Couzens | 175eb7b | 2021-07-20 18:41:14 +0200 | [diff] [blame] | 344 | NS2_SNS_EV_REQ_NSVC_ALIVE, /*!< a NS-VC became alive */ |
| 345 | NS2_SNS_EV_REQ_ADD_BIND, /*!< add a new local bind to this NSE */ |
| 346 | NS2_SNS_EV_REQ_DELETE_BIND, /*!< remove a local bind from this NSE */ |
Alexander Couzens | 1f3193d | 2021-06-05 22:08:11 +0200 | [diff] [blame] | 347 | NS2_SNS_EV_REQ_CHANGE_WEIGHT, /*!< a bind changed its weight */ |
Alexander Couzens | 175eb7b | 2021-07-20 18:41:14 +0200 | [diff] [blame] | 348 | }; |
| 349 | |
Alexander Couzens | ba5a992 | 2021-01-25 16:03:23 +0100 | [diff] [blame] | 350 | enum ns2_cs ns2_create_vc(struct gprs_ns2_vc_bind *bind, |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 351 | struct msgb *msg, |
Harald Welte | 7d0daac | 2021-03-02 23:08:43 +0100 | [diff] [blame] | 352 | const struct osmo_sockaddr *remote, |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 353 | const char *logname, |
| 354 | struct msgb **reject, |
| 355 | struct gprs_ns2_vc **success); |
| 356 | |
Alexander Couzens | ffd49d0 | 2020-09-24 00:47:17 +0200 | [diff] [blame] | 357 | int ns2_recv_vc(struct gprs_ns2_vc *nsvc, |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 358 | struct msgb *msg); |
| 359 | |
| 360 | struct gprs_ns2_vc *ns2_vc_alloc(struct gprs_ns2_vc_bind *bind, |
| 361 | struct gprs_ns2_nse *nse, |
Alexander Couzens | d923cff | 2020-12-01 01:03:52 +0100 | [diff] [blame] | 362 | bool initiater, |
Harald Welte | 603f404 | 2020-11-29 17:39:19 +0100 | [diff] [blame] | 363 | enum gprs_ns2_vc_mode vc_mode, |
| 364 | const char *id); |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 365 | |
Alexander Couzens | f074659 | 2021-07-20 19:05:45 +0200 | [diff] [blame] | 366 | void ns2_free_nsvcs(struct gprs_ns2_nse *nse); |
Harald Welte | c3aa8f9 | 2021-01-31 11:41:34 +0100 | [diff] [blame] | 367 | int ns2_bind_alloc(struct gprs_ns2_inst *nsi, const char *name, |
| 368 | struct gprs_ns2_vc_bind **result); |
| 369 | |
Alexander Couzens | 8dfc24c | 2021-01-25 16:09:23 +0100 | [diff] [blame] | 370 | struct msgb *ns2_msgb_alloc(void); |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 371 | |
Alexander Couzens | 8dfc24c | 2021-01-25 16:09:23 +0100 | [diff] [blame] | 372 | void ns2_sns_write_vty(struct vty *vty, const struct gprs_ns2_nse *nse); |
| 373 | void ns2_sns_dump_vty(struct vty *vty, const char *prefix, const struct gprs_ns2_nse *nse, bool stats); |
Alexander Couzens | bf95f0f | 2020-10-01 22:56:03 +0200 | [diff] [blame] | 374 | void ns2_prim_status_ind(struct gprs_ns2_nse *nse, |
Daniel Willmann | 15c09a8 | 2020-11-03 23:05:43 +0100 | [diff] [blame] | 375 | struct gprs_ns2_vc *nsvc, |
Alexander Couzens | bf95f0f | 2020-10-01 22:56:03 +0200 | [diff] [blame] | 376 | uint16_t bvci, |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 377 | enum gprs_ns2_affecting_cause cause); |
| 378 | void ns2_nse_notify_alive(struct gprs_ns2_vc *nsvc, bool alive); |
Alexander Couzens | 4f1128f | 2021-01-20 17:42:48 +0100 | [diff] [blame] | 379 | void ns2_nse_update_mtu(struct gprs_ns2_nse *nse); |
Harald Welte | 06d9bf9 | 2021-03-05 10:20:11 +0100 | [diff] [blame] | 380 | int ns2_nse_set_dialect(struct gprs_ns2_nse *nse, enum gprs_ns2_dialect dialect); |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 381 | |
| 382 | /* message */ |
Alexander Couzens | 8dfc24c | 2021-01-25 16:09:23 +0100 | [diff] [blame] | 383 | int ns2_validate(struct gprs_ns2_vc *nsvc, |
| 384 | uint8_t pdu_type, |
| 385 | struct msgb *msg, |
| 386 | struct tlv_parsed *tp, |
| 387 | uint8_t *cause); |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 388 | |
| 389 | /* SNS messages */ |
| 390 | int ns2_tx_sns_ack(struct gprs_ns2_vc *nsvc, uint8_t trans_id, uint8_t *cause, |
| 391 | const struct gprs_ns_ie_ip4_elem *ip4_elems, |
| 392 | unsigned int num_ip4_elems, |
| 393 | const struct gprs_ns_ie_ip6_elem *ip6_elems, |
| 394 | unsigned int num_ip6_elems); |
| 395 | int ns2_tx_sns_config(struct gprs_ns2_vc *nsvc, bool end_flag, |
| 396 | const struct gprs_ns_ie_ip4_elem *ip4_elems, |
| 397 | unsigned int num_ip4_elems, |
| 398 | const struct gprs_ns_ie_ip6_elem *ip6_elems, |
| 399 | unsigned int num_ip6_elems); |
| 400 | int ns2_tx_sns_config_ack(struct gprs_ns2_vc *nsvc, uint8_t *cause); |
| 401 | int ns2_tx_sns_size(struct gprs_ns2_vc *nsvc, bool reset_flag, uint16_t max_nr_nsvc, |
| 402 | int ip4_ep_nr, int ip6_ep_nr); |
| 403 | int ns2_tx_sns_size_ack(struct gprs_ns2_vc *nsvc, uint8_t *cause); |
| 404 | |
Alexander Couzens | 27a5592 | 2021-02-27 01:08:35 +0100 | [diff] [blame] | 405 | int ns2_tx_sns_add(struct gprs_ns2_vc *nsvc, |
| 406 | uint8_t trans_id, |
| 407 | const struct gprs_ns_ie_ip4_elem *ip4_elems, |
| 408 | unsigned int num_ip4_elems, |
| 409 | const struct gprs_ns_ie_ip6_elem *ip6_elems, |
| 410 | unsigned int num_ip6_elems); |
| 411 | int ns2_tx_sns_change_weight(struct gprs_ns2_vc *nsvc, |
| 412 | uint8_t trans_id, |
| 413 | const struct gprs_ns_ie_ip4_elem *ip4_elems, |
| 414 | unsigned int num_ip4_elems, |
| 415 | const struct gprs_ns_ie_ip6_elem *ip6_elems, |
| 416 | unsigned int num_ip6_elems); |
| 417 | int ns2_tx_sns_del(struct gprs_ns2_vc *nsvc, |
| 418 | uint8_t trans_id, |
| 419 | const struct gprs_ns_ie_ip4_elem *ip4_elems, |
| 420 | unsigned int num_ip4_elems, |
| 421 | const struct gprs_ns_ie_ip6_elem *ip6_elems, |
| 422 | unsigned int num_ip6_elems); |
| 423 | |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 424 | /* transmit message over a VC */ |
Alexander Couzens | 67cfc5d | 2021-09-07 01:10:38 +0200 | [diff] [blame] | 425 | int ns2_tx_block(struct gprs_ns2_vc *nsvc, uint8_t cause, uint16_t *nsvci); |
| 426 | int ns2_tx_block_ack(struct gprs_ns2_vc *nsvc, uint16_t *nsvci); |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 427 | |
| 428 | int ns2_tx_reset(struct gprs_ns2_vc *nsvc, uint8_t cause); |
| 429 | int ns2_tx_reset_ack(struct gprs_ns2_vc *nsvc); |
| 430 | |
| 431 | int ns2_tx_unblock(struct gprs_ns2_vc *nsvc); |
| 432 | int ns2_tx_unblock_ack(struct gprs_ns2_vc *nsvc); |
| 433 | |
| 434 | int ns2_tx_alive(struct gprs_ns2_vc *nsvc); |
| 435 | int ns2_tx_alive_ack(struct gprs_ns2_vc *nsvc); |
| 436 | |
| 437 | int ns2_tx_unit_data(struct gprs_ns2_vc *nsvc, |
| 438 | uint16_t bvci, uint8_t sducontrol, |
| 439 | struct msgb *msg); |
| 440 | |
| 441 | int ns2_tx_status(struct gprs_ns2_vc *nsvc, uint8_t cause, |
Alexander Couzens | d802f9a | 2021-09-23 16:19:32 +0200 | [diff] [blame] | 442 | uint16_t bvci, struct msgb *orig_msg, uint16_t *nsvci); |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 443 | |
| 444 | /* driver */ |
Alexander Couzens | 8dfc24c | 2021-01-25 16:09:23 +0100 | [diff] [blame] | 445 | struct gprs_ns2_vc *ns2_ip_bind_connect(struct gprs_ns2_vc_bind *bind, |
| 446 | struct gprs_ns2_nse *nse, |
| 447 | const struct osmo_sockaddr *remote); |
Alexander Couzens | e769f52 | 2020-12-07 07:37:07 +0100 | [diff] [blame] | 448 | int ns2_ip_count_bind(struct gprs_ns2_inst *nsi, struct osmo_sockaddr *remote); |
| 449 | struct gprs_ns2_vc_bind *ns2_ip_get_bind_by_index(struct gprs_ns2_inst *nsi, |
| 450 | struct osmo_sockaddr *remote, |
| 451 | int index); |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 452 | |
| 453 | /* sns */ |
Alexander Couzens | 8dfc24c | 2021-01-25 16:09:23 +0100 | [diff] [blame] | 454 | int ns2_sns_rx(struct gprs_ns2_vc *nsvc, struct msgb *msg, struct tlv_parsed *tp); |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 455 | struct osmo_fsm_inst *ns2_sns_bss_fsm_alloc(struct gprs_ns2_nse *nse, |
| 456 | const char *id); |
Harald Welte | 4f12746 | 2021-03-02 20:49:10 +0100 | [diff] [blame] | 457 | struct osmo_fsm_inst *ns2_sns_sgsn_fsm_alloc(struct gprs_ns2_nse *nse, const char *id); |
Alexander Couzens | be7cecc | 2021-02-03 18:25:27 +0100 | [diff] [blame] | 458 | void ns2_sns_replace_nsvc(struct gprs_ns2_vc *nsvc); |
| 459 | void ns2_sns_notify_alive(struct gprs_ns2_nse *nse, struct gprs_ns2_vc *nsvc, bool alive); |
Alexander Couzens | c470476 | 2021-02-08 23:13:12 +0100 | [diff] [blame] | 460 | void ns2_sns_update_weights(struct gprs_ns2_vc_bind *bind); |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 461 | |
| 462 | /* vc */ |
Alexander Couzens | 8dfc24c | 2021-01-25 16:09:23 +0100 | [diff] [blame] | 463 | struct osmo_fsm_inst *ns2_vc_fsm_alloc(struct gprs_ns2_vc *nsvc, |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 464 | const char *id, bool initiate); |
Alexander Couzens | 8dfc24c | 2021-01-25 16:09:23 +0100 | [diff] [blame] | 465 | int ns2_vc_fsm_start(struct gprs_ns2_vc *nsvc); |
| 466 | int ns2_vc_force_unconfigured(struct gprs_ns2_vc *nsvc); |
| 467 | int ns2_vc_rx(struct gprs_ns2_vc *nsvc, struct msgb *msg, struct tlv_parsed *tp); |
| 468 | int ns2_vc_is_alive(struct gprs_ns2_vc *nsvc); |
| 469 | int ns2_vc_is_unblocked(struct gprs_ns2_vc *nsvc); |
Alexander Couzens | 47afc42 | 2021-01-17 20:12:46 +0100 | [diff] [blame] | 470 | int ns2_vc_block(struct gprs_ns2_vc *nsvc); |
Alexander Couzens | 27e5873 | 2021-03-21 17:12:08 +0100 | [diff] [blame] | 471 | int ns2_vc_reset(struct gprs_ns2_vc *nsvc); |
Alexander Couzens | 47afc42 | 2021-01-17 20:12:46 +0100 | [diff] [blame] | 472 | int ns2_vc_unblock(struct gprs_ns2_vc *nsvc); |
Alexander Couzens | 75b6188 | 2021-03-21 16:18:17 +0100 | [diff] [blame] | 473 | void ns2_vty_dump_nsvc(struct vty *vty, struct gprs_ns2_vc *nsvc, bool stats); |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 474 | |
Alexander Couzens | 6a16149 | 2020-07-12 13:45:50 +0200 | [diff] [blame] | 475 | /* nse */ |
| 476 | void ns2_nse_notify_unblocked(struct gprs_ns2_vc *nsvc, bool unblocked); |
Alexander Couzens | 8dfc24c | 2021-01-25 16:09:23 +0100 | [diff] [blame] | 477 | enum gprs_ns2_vc_mode ns2_dialect_to_vc_mode(enum gprs_ns2_dialect dialect); |
Alexander Couzens | 1c8785d | 2020-12-17 06:58:53 +0100 | [diff] [blame] | 478 | int ns2_count_transfer_cap(struct gprs_ns2_nse *nse, |
| 479 | uint16_t bvci); |
Harald Welte | d164ef8 | 2021-03-04 22:29:17 +0100 | [diff] [blame] | 480 | |
| 481 | /* vty */ |
| 482 | int ns2_sns_add_sns_default_binds(struct gprs_ns2_nse *nse); |