libosmo-sigtran  2.1.0.101-af06.202506182026
Osmocom SIGTRAN library
ss7_as.h
Go to the documentation of this file.
1 #pragma once
2 
3 #include <stdint.h>
4 #include <osmocom/core/linuxlist.h>
5 #include <osmocom/core/fsm.h>
6 #include <osmocom/core/msgb.h>
7 #include <osmocom/core/tdef.h>
8 #include <osmocom/netif/stream.h>
9 
11 
12 #include "ss7_internal.h"
13 
14 /***********************************************************************
15  * SS7 Application Server
16  ***********************************************************************/
17 
18 struct osmo_ss7_instance;
19 struct osmo_ss7_asp;
21 
23  OSMO_SS7_PATCH_NONE, /* no patching of SCCP */
24  OSMO_SS7_PATCH_BOTH, /* patch both OPC and DPC into SCCP addresses */
25 };
26 
27 enum ss7_as_ctr {
63 };
64 
65 #define NUM_AS_EXT_SLS 128
66 typedef uint8_t as_ext_sls_t; /* range: 0-127, 7 bit */
68  /* ITU Q.704 4.2.1: "normal signallink link" */
70  /* ITU Q.704 4.2.1: "alternative signallink link" */
72 };
73 
74 struct osmo_ss7_as {
76  struct llist_head list;
78 
80  struct osmo_fsm_inst *fi;
81 
84 
87 
89  struct rate_ctr_group *ctrg;
90 
91  /* ASP loadshare: */
93 
94  struct {
95  char *name;
96  char *description;
100  /* traffic mode was configured by VTY / config file */
102  /* traffic mode was configured by RKM (routing key management) or first ASPAC */
105  uint8_t qos_class;
106  struct {
107  uint32_t dpc;
110 
111  struct osmo_ss7_asp *asps[16];
112  /* used for load-sharing traffic mode (round robin implementation) */
115 
116  struct {
117  /* How many bits from ITU SLS field (starting from least-significant-bit)
118  * to skip for routing decisions.
119  * range 0-3, defaults to 0, which means take all 4 bits. */
120  uint8_t sls_shift;
121  /* Whether to generate a extended-SLS with OPC information, see opc_shift below. */
122  bool opc_sls;
123  /* How many bits from ITU OPC field (starting from least-significant-bit)
124  * to skip for routing decisions (always takes 12 bits).
125  * range 0-2, defaults to 0, which means take least significant 12 bits. */
126  uint8_t opc_shift;
128  } cfg;
129 };
130 
131 struct osmo_ss7_asp *ss7_as_select_asp(struct osmo_ss7_as *as, const struct osmo_mtp_transfer_param *mtp);
132 
133 unsigned int osmo_ss7_as_count_asp(const struct osmo_ss7_as *as);
134 int ss7_as_add_asp(struct osmo_ss7_as *as, struct osmo_ss7_asp *asp);
136 
137 #define LOGPAS(as, subsys, level, fmt, args ...) \
138  _LOGSS7((as)->inst, subsys, level, "AS(%s) " fmt, (as)->cfg.name, ## args)
osmo_ss7_asp_protocol
Definition: osmo_ss7.h:157
osmo_ss7_as_traffic_mode
Definition: osmo_ss7.h:183
osmo_ss7_as_patch_sccp_mode
Definition: ss7_as.h:22
@ OSMO_SS7_PATCH_BOTH
Definition: ss7_as.h:24
@ OSMO_SS7_PATCH_NONE
Definition: ss7_as.h:23
void ss7_as_loadshare_binding_table_reset(struct osmo_ss7_as *as)
Definition: ss7_as.c:361
uint8_t as_ext_sls_t
Definition: ss7_as.h:66
struct osmo_ss7_asp * ss7_as_select_asp(struct osmo_ss7_as *as, const struct osmo_mtp_transfer_param *mtp)
Select an AS to transmit a message, according to AS configuration and ASP availability.
Definition: ss7_as.c:498
#define NUM_AS_EXT_SLS
Definition: ss7_as.h:65
int ss7_as_add_asp(struct osmo_ss7_as *as, struct osmo_ss7_asp *asp)
Add given ASP to given AS.
Definition: ss7_as.c:153
ss7_as_ctr
Definition: ss7_as.h:27
@ SS7_AS_CTR_TX_MSU_SLS_8
Definition: ss7_as.h:55
@ SS7_AS_CTR_TX_MSU_SLS_15
Definition: ss7_as.h:62
@ SS7_AS_CTR_RX_MSU_SLS_10
Definition: ss7_as.h:40
@ SS7_AS_CTR_RX_MSU_TOTAL
Definition: ss7_as.h:29
@ SS7_AS_CTR_TX_MSU_SLS_14
Definition: ss7_as.h:61
@ SS7_AS_CTR_TX_MSU_SLS_7
Definition: ss7_as.h:54
@ SS7_AS_CTR_RX_MSU_SLS_15
Definition: ss7_as.h:45
@ SS7_AS_CTR_RX_MSU_SLS_1
Definition: ss7_as.h:31
@ SS7_AS_CTR_TX_MSU_SLS_5
Definition: ss7_as.h:52
@ SS7_AS_CTR_RX_MSU_SLS_2
Definition: ss7_as.h:32
@ SS7_AS_CTR_TX_MSU_SLS_3
Definition: ss7_as.h:50
@ SS7_AS_CTR_RX_MSU_SLS_5
Definition: ss7_as.h:35
@ SS7_AS_CTR_TX_MSU_SLS_10
Definition: ss7_as.h:57
@ SS7_AS_CTR_RX_MSU_SLS_8
Definition: ss7_as.h:38
@ SS7_AS_CTR_TX_MSU_SLS_12
Definition: ss7_as.h:59
@ SS7_AS_CTR_RX_MSU_SLS_4
Definition: ss7_as.h:34
@ SS7_AS_CTR_TX_MSU_SLS_9
Definition: ss7_as.h:56
@ SS7_AS_CTR_TX_MSU_SLS_2
Definition: ss7_as.h:49
@ SS7_AS_CTR_TX_MSU_SLS_0
Definition: ss7_as.h:47
@ SS7_AS_CTR_TX_MSU_TOTAL
Definition: ss7_as.h:46
@ SS7_AS_CTR_RX_MSU_SLS_7
Definition: ss7_as.h:37
@ SS7_AS_CTR_RX_MSU_DISCARD
Definition: ss7_as.h:28
@ SS7_AS_CTR_TX_MSU_SLS_11
Definition: ss7_as.h:58
@ SS7_AS_CTR_TX_MSU_SLS_6
Definition: ss7_as.h:53
@ SS7_AS_CTR_RX_MSU_SLS_6
Definition: ss7_as.h:36
@ SS7_AS_CTR_RX_MSU_SLS_14
Definition: ss7_as.h:44
@ SS7_AS_CTR_RX_MSU_SLS_9
Definition: ss7_as.h:39
@ SS7_AS_CTR_TX_MSU_SLS_13
Definition: ss7_as.h:60
@ SS7_AS_CTR_RX_MSU_SLS_13
Definition: ss7_as.h:43
@ SS7_AS_CTR_RX_MSU_SLS_12
Definition: ss7_as.h:42
@ SS7_AS_CTR_TX_MSU_SLS_1
Definition: ss7_as.h:48
@ SS7_AS_CTR_RX_MSU_SLS_3
Definition: ss7_as.h:33
@ SS7_AS_CTR_RX_MSU_SLS_11
Definition: ss7_as.h:41
@ SS7_AS_CTR_RX_MSU_SLS_0
Definition: ss7_as.h:30
@ SS7_AS_CTR_TX_MSU_SLS_4
Definition: ss7_as.h:51
unsigned int osmo_ss7_as_count_asp(const struct osmo_ss7_as *as)
Determine amount of ASPs associated to an AS.
Definition: ss7_as.c:264
Definition: mtp_sap.h:36
Definition: ss7_as.h:67
struct osmo_ss7_asp * normal_asp
Definition: ss7_as.h:69
struct osmo_ss7_asp * alt_asp
Definition: ss7_as.h:71
Definition: ss7_as.h:74
struct osmo_ss7_routing_key routing_key
Definition: ss7_as.h:98
uint8_t opc_shift
Definition: ss7_as.h:126
uint8_t sls_shift
Definition: ss7_as.h:120
uint32_t recovery_timeout_msec
Definition: ss7_as.h:104
struct osmo_ss7_as_esls_entry aesls_table[NUM_AS_EXT_SLS]
Definition: ss7_as.h:92
struct llist_head list
entry in 'ref osmo_ss7_instance.as_list
Definition: ss7_as.h:76
uint8_t last_asp_idx_assigned
Definition: ss7_as.h:113
char * description
Definition: ss7_as.h:96
bool rkm_dyn_allocated
Were we dynamically allocated by RKM?
Definition: ss7_as.h:83
struct rate_ctr_group * ctrg
Rate Counter Group.
Definition: ss7_as.h:89
struct osmo_ss7_asp * asps[16]
Definition: ss7_as.h:111
uint8_t last_asp_idx_sent
Definition: ss7_as.h:114
char * name
Definition: ss7_as.h:95
bool mode_set_by_vty
Definition: ss7_as.h:101
struct osmo_fsm_inst * fi
AS FSM.
Definition: ss7_as.h:80
struct osmo_ss7_as::@22::@24 loadshare
bool simple_client_allocated
Were we allocated by "simple client" support?
Definition: ss7_as.h:86
uint32_t dpc
Definition: ss7_as.h:107
bool opc_sls
Definition: ss7_as.h:122
enum osmo_ss7_as_traffic_mode mode
Definition: ss7_as.h:99
struct osmo_ss7_as::@22::@23 pc_override
enum osmo_ss7_asp_protocol proto
Definition: ss7_as.h:97
enum osmo_ss7_as_patch_sccp_mode sccp_mode
Definition: ss7_as.h:108
struct osmo_ss7_instance * inst
Definition: ss7_as.h:77
bool mode_set_by_peer
Definition: ss7_as.h:103
uint8_t qos_class
Definition: ss7_as.h:105
struct osmo_ss7_as::@22 cfg
Definition: ss7_asp.h:42
Definition: ss7_instance.h:21
Definition: osmo_ss7.h:142