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