libosmo-sigtran  2.1.0.93-5cebd.202505202026
Osmocom SIGTRAN library
xua_internal.h
Go to the documentation of this file.
1 #pragma once
2 
3 #include <osmocom/core/tdef.h>
5 #include "xua_msg.h"
6 
7 #define M3UA_MSG_SIZE 2048
8 #define M3UA_MSG_HEADROOM 512
9 
10 struct osmo_sccp_addr;
11 struct m3ua_data_hdr;
12 
13 int sua_addr_parse_part(struct osmo_sccp_addr *out,
14  const struct xua_msg_part *param);
15 int sua_addr_parse(struct osmo_sccp_addr *out, struct xua_msg *xua, uint16_t iei);
16 
17 int sua_parse_gt(struct osmo_sccp_gt *gt, const uint8_t *data, unsigned int datalen);
18 
19 struct xua_msg *osmo_sccp_to_xua(struct msgb *msg);
20 struct msgb *osmo_sua_to_sccp(struct xua_msg *xua);
21 
22 int sua_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg);
23 
24 int sua_tx_xua_as(struct osmo_ss7_as *as, struct xua_msg *xua);
25 void sua_tx_snm_available(struct osmo_ss7_asp *asp, const uint32_t *rctx, unsigned int num_rctx,
26  const uint32_t *aff_pc, unsigned int num_aff_pc, const uint32_t *aff_ssn,
27  const uint32_t *smi, const char *info_string, bool available);
28 void sua_tx_snm_congestion(struct osmo_ss7_asp *asp, const uint32_t *rctx, unsigned int num_rctx,
29  const uint32_t *aff_pc, unsigned int num_aff_pc, const uint32_t *ssn,
30  const uint8_t cong_level, const char *info_string);
31 void sua_tx_dupu(struct osmo_ss7_asp *asp, const uint32_t *rctx, unsigned int num_rctx,
32  uint32_t dpc, uint16_t user, uint16_t cause, const char *info_str);
33 
34 struct osmo_mtp_prim *m3ua_to_xfer_ind(struct xua_msg *xua);
35 int m3ua_hmdc_rx_from_l2(struct osmo_ss7_instance *inst, struct xua_msg *xua);
36 struct msgb *m3ua_to_msg(struct xua_msg *xua);
37 int m3ua_tx_xua_as(struct osmo_ss7_as *as, struct xua_msg *xua);
38 void m3ua_tx_snm_available(struct osmo_ss7_asp *asp, const uint32_t *rctx, unsigned int num_rctx,
39  const uint32_t *aff_pc, unsigned int num_aff_pc,
40  const char *info_string, bool available);
41 void m3ua_tx_snm_congestion(struct osmo_ss7_asp *asp, const uint32_t *rctx, unsigned int num_rctx,
42  const uint32_t *aff_pc, unsigned int num_aff_pc,
43  const uint32_t *concerned_dpc, const uint8_t *cong_level,
44  const char *info_string);
45 void m3ua_tx_dupu(struct osmo_ss7_asp *asp, const uint32_t *rctx, unsigned int num_rctx,
46  uint32_t dpc, uint16_t user, uint16_t cause, const char *info_str);
47 
48 void xua_snm_rx_daud(struct osmo_ss7_asp *asp, struct xua_msg *xua);
49 void xua_snm_rx_duna(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua);
50 void xua_snm_rx_dava(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua);
51 void xua_snm_rx_dupu(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua);
52 void xua_snm_rx_scon(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua);
53 int m3ua_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg);
54 
55 struct msgb *m3ua_msgb_alloc(const char *name);
56 struct xua_msg *m3ua_xfer_from_data(const struct m3ua_data_hdr *data_hdr,
57  const uint8_t *data, unsigned int data_len);
58 struct m3ua_data_hdr *data_hdr_from_m3ua(struct xua_msg *xua);
60  const struct m3ua_data_hdr *mdh);
62  const struct osmo_mtp_transfer_param *param);
63 
64 
65 extern const struct xua_msg_class m3ua_msg_class_mgmt;
66 extern const struct xua_msg_class m3ua_msg_class_snm;
67 extern const struct xua_msg_class m3ua_msg_class_rkm;
68 extern const struct xua_msg_class m3ua_msg_class_aspsm;
69 extern const struct xua_msg_class m3ua_msg_class_asptm;
70 
71 extern const struct value_string m3ua_err_names[];
72 extern const struct value_string m3ua_ntfy_type_names[];
73 extern const struct value_string m3ua_ntfy_stchg_names[];
74 extern const struct value_string m3ua_ntfy_other_names[];
75 const char *m3ua_ntfy_info_name(uint16_t ntfy_status_type, uint16_t ntfy_status_info);
76 
77 struct xua_msg *m3ua_encode_notify(const struct osmo_xlm_prim_notify *npar);
78 int m3ua_decode_notify(struct osmo_xlm_prim_notify *npar, void *ctx,
79  const struct xua_msg *xua);
80 int m3ua_rx_rkm(struct osmo_ss7_asp *asp, struct xua_msg *xua);
82 
84  enum osmo_prim_operation op);
85 
86 void xua_asp_send_xlm_prim(struct osmo_ss7_asp *asp, struct osmo_xlm_prim *prim);
88  enum osmo_xlm_prim_type prim_type,
89  enum osmo_prim_operation op);
90 
91 void xua_snm_pc_available(struct osmo_ss7_as *as, const uint32_t *aff_pc,
92  unsigned int num_aff_pc, const char *info_str, bool available);
93 
95  /* 0 kept unused on purpose since it's handled specially by osmo_fsm */
100  /* This must remain the last item: */
102 };
103 
104 extern const struct osmo_tdef ss7_asp_lm_timer_defaults[SS7_ASP_LM_TIMERS_LEN];
105 
106 extern const struct value_string ss7_asp_lm_timer_names[];
107 static inline const char *ss7_asp_lm_timer_name(enum ss7_asp_lm_timer val)
108 { return get_value_string(ss7_asp_lm_timer_names, val); }
109 
110 extern struct osmo_fsm xua_default_lm_fsm;
111 extern const struct value_string m3ua_rkm_reg_status_vals[];
112 extern const struct value_string m3ua_rkm_dereg_status_vals[];
113 
114 #define CS7_STR "ITU-T Signaling System 7\n"
115 #define PC_STR "Point Code\n"
116 #define INST_STR "An instance of the SS7 stack\n"
117 
118 int xua_as_transmit_msg(struct osmo_ss7_as *as, struct xua_msg *xua);
119 
120 int xua_find_as_for_asp(struct osmo_ss7_as **as, const struct osmo_ss7_asp *asp,
121  const struct xua_msg_part *rctx_ie);
122 
123 struct msgb *ipa_to_msg(struct xua_msg *xua);
124 int ipa_tx_xua_as(struct osmo_ss7_as *as, struct xua_msg *xua);
125 int ipa_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg, uint8_t sls);
126 struct osmo_ss7_as *ipa_find_as_for_asp(struct osmo_ss7_asp *asp);
127 
128 int osmo_isup_party_parse(char *out_digits, const uint8_t *in,
129  unsigned int in_num_bytes, bool odd);
130 int osmo_sccp_addr_parse(struct osmo_sccp_addr *out,
131  const uint8_t *addr, unsigned int addrlen);
132 int osmo_sccp_addr_encode(struct msgb *msg, const struct osmo_sccp_addr *in);
133 
134 int ss7_asp_rx_unknown(struct osmo_ss7_asp *asp, int ppid_mux, struct msgb *msg);
uint8_t sls
Definition: m3ua.h:5
uint32_t dpc
Definition: m3ua.h:1
uint8_t smi
Definition: sccp_scmg.h:3
osmo_xlm_prim_type
Definition: sigtran_sap.h:13
Definition: m3ua.h:95
Definition: mtp_sap.h:56
Definition: mtp_sap.h:36
Definition: sccp_sap.h:183
Definition: sccp_sap.h:175
Definition: ss7_as.h:74
Definition: ss7_asp.h:28
Definition: ss7_instance.h:21
Definition: sigtran_sap.h:37
Definition: sigtran_sap.h:67
Definition: xua_msg.h:49
Definition: xua_msg.h:39
Definition: xua_msg.h:31
const struct value_string m3ua_rkm_reg_status_vals[]
Definition: xua_rkm.c:40
const struct value_string m3ua_ntfy_type_names[]
Definition: m3ua.c:82
void xua_snm_rx_scon(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua)
Definition: xua_snm.c:446
const struct value_string m3ua_err_names[]
Definition: m3ua.c:58
void xua_snm_rx_dupu(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua)
Definition: xua_snm.c:412
int xua_as_transmit_msg(struct osmo_ss7_as *as, struct xua_msg *xua)
Definition: xua_as_fsm.c:172
int sua_addr_parse(struct osmo_sccp_addr *out, struct xua_msg *xua, uint16_t iei)
parse SCCP address from given xUA message IE
Definition: sua.c:507
int ipa_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg, uint8_t sls)
process M3UA message received from socket
Definition: ipa.c:308
void m3ua_tx_dupu(struct osmo_ss7_asp *asp, const uint32_t *rctx, unsigned int num_rctx, uint32_t dpc, uint16_t user, uint16_t cause, const char *info_str)
Transmit SSNM DUPU message indicating user unavailability.
Definition: m3ua.c:987
int xua_find_as_for_asp(struct osmo_ss7_as **as, const struct osmo_ss7_asp *asp, const struct xua_msg_part *rctx_ie)
Find the AS for given ASP + optional routing context IE.
Definition: xua_shared.c:71
void m3ua_tx_snm_available(struct osmo_ss7_asp *asp, const uint32_t *rctx, unsigned int num_rctx, const uint32_t *aff_pc, unsigned int num_aff_pc, const char *info_string, bool available)
Transmit SSNM DUNA/DAVA message indicating [un]availability of certain point code[s].
Definition: m3ua.c:932
struct msgb * m3ua_msgb_alloc(const char *name)
Definition: m3ua.c:328
void sua_tx_snm_available(struct osmo_ss7_asp *asp, const uint32_t *rctx, unsigned int num_rctx, const uint32_t *aff_pc, unsigned int num_aff_pc, const uint32_t *aff_ssn, const uint32_t *smi, const char *info_string, bool available)
Transmit SSNM DUNA/DAVA message indicating [un]availability of certain point code[s].
Definition: sua.c:875
int m3ua_tx_xua_as(struct osmo_ss7_as *as, struct xua_msg *xua)
Send a given xUA message via a given M3UA Application Server.
Definition: m3ua.c:550
const struct value_string m3ua_ntfy_stchg_names[]
Definition: m3ua.c:88
const struct xua_msg_class m3ua_msg_class_snm
Definition: m3ua.c:191
int m3ua_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg)
process M3UA message received from socket
Definition: m3ua.c:772
int osmo_isup_party_parse(char *out_digits, const uint8_t *in, unsigned int in_num_bytes, bool odd)
Parse ISUP style address of BCD digets.
Definition: sccp2sua.c:73
struct msgb * ipa_to_msg(struct xua_msg *xua)
Definition: ipa.c:55
int m3ua_decode_notify(struct osmo_xlm_prim_notify *npar, void *ctx, const struct xua_msg *xua)
Definition: m3ua.c:446
int ipa_tx_xua_as(struct osmo_ss7_as *as, struct xua_msg *xua)
Send a given xUA message via a given IPA "Application Server".
Definition: ipa.c:101
void xua_snm_rx_dava(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua)
Definition: xua_snm.c:377
void xua_rkm_cleanup_dyn_as_for_asp(struct osmo_ss7_asp *asp)
Definition: xua_rkm.c:615
const struct osmo_tdef ss7_asp_lm_timer_defaults[SS7_ASP_LM_TIMERS_LEN]
Definition: xua_default_lm_fsm.c:86
const struct value_string m3ua_rkm_dereg_status_vals[]
Definition: xua_rkm.c:57
int ss7_asp_rx_unknown(struct osmo_ss7_asp *asp, int ppid_mux, struct msgb *msg)
Definition: ss7_asp.c:1253
int sua_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg)
process SUA message received from socket
Definition: sua.c:686
struct osmo_ss7_as * ipa_find_as_for_asp(struct osmo_ss7_asp *asp)
Definition: ipa.c:142
void mtp_xfer_param_to_m3ua_dh(struct m3ua_data_hdr *mdh, const struct osmo_mtp_transfer_param *param)
Definition: m3ua.c:304
struct osmo_fsm xua_default_lm_fsm
Definition: xua_default_lm_fsm.c:377
void xua_asp_send_xlm_prim(struct osmo_ss7_asp *asp, struct osmo_xlm_prim *prim)
Definition: xua_asp_fsm.c:112
int sua_tx_xua_as(struct osmo_ss7_as *as, struct xua_msg *xua)
Send a given xUA message via a given SUA Application Server.
Definition: sua.c:311
struct msgb * m3ua_to_msg(struct xua_msg *xua)
Definition: m3ua.c:505
void sua_tx_snm_congestion(struct osmo_ss7_asp *asp, const uint32_t *rctx, unsigned int num_rctx, const uint32_t *aff_pc, unsigned int num_aff_pc, const uint32_t *ssn, const uint8_t cong_level, const char *info_string)
Transmit SSNM SCON message indicating congestion.
Definition: sua.c:899
const struct xua_msg_class m3ua_msg_class_rkm
Definition: m3ua.c:275
int sua_addr_parse_part(struct osmo_sccp_addr *out, const struct xua_msg_part *param)
parse SCCP address from given xUA message part
Definition: sua.c:375
static const char * ss7_asp_lm_timer_name(enum ss7_asp_lm_timer val)
Definition: xua_internal.h:107
struct xua_msg * m3ua_encode_notify(const struct osmo_xlm_prim_notify *npar)
Definition: m3ua.c:414
int m3ua_hmdc_rx_from_l2(struct osmo_ss7_instance *inst, struct xua_msg *xua)
Definition: ss7_hmrt.c:240
const char * m3ua_ntfy_info_name(uint16_t ntfy_status_type, uint16_t ntfy_status_info)
Definition: m3ua.c:103
const struct value_string ss7_asp_lm_timer_names[]
Definition: xua_default_lm_fsm.c:99
const struct xua_msg_class m3ua_msg_class_aspsm
Definition: m3ua.c:214
const struct xua_msg_class m3ua_msg_class_asptm
Definition: m3ua.c:227
const struct value_string m3ua_ntfy_other_names[]
Definition: m3ua.c:96
struct xua_msg * m3ua_xfer_from_data(const struct m3ua_data_hdr *data_hdr, const uint8_t *data, unsigned int data_len)
Definition: m3ua.c:336
void xua_snm_pc_available(struct osmo_ss7_as *as, const uint32_t *aff_pc, unsigned int num_aff_pc, const char *info_str, bool available)
Definition: xua_snm.c:151
int m3ua_rx_rkm(struct osmo_ss7_asp *asp, struct xua_msg *xua)
Definition: xua_rkm.c:553
void m3ua_dh_to_xfer_param(struct osmo_mtp_transfer_param *param, const struct m3ua_data_hdr *mdh)
Definition: m3ua.c:316
const struct xua_msg_class m3ua_msg_class_mgmt
Definition: m3ua.c:245
ss7_asp_lm_timer
Definition: xua_internal.h:94
@ SS7_ASP_LM_T_WAIT_ASP_UP
Definition: xua_internal.h:96
@ SS7_ASP_LM_TIMERS_LEN
Definition: xua_internal.h:101
@ SS7_ASP_LM_T_WAIT_NOTIFY
Definition: xua_internal.h:97
@ SS7_ASP_LM_T_WAIT_RK_REG_RESP
Definition: xua_internal.h:99
@ SS7_ASP_LM_T_WAIT_NOTIY_RKM
Definition: xua_internal.h:98
struct osmo_xlm_prim * xua_xlm_prim_alloc(enum osmo_xlm_prim_type prim_type, enum osmo_prim_operation op)
Definition: xua_asp_fsm.c:97
struct xua_msg * osmo_sccp_to_xua(struct msgb *msg)
convert SCCP message to a SUA message
Definition: sccp2sua.c:1667
int osmo_sccp_addr_encode(struct msgb *msg, const struct osmo_sccp_addr *in)
encode a SCCP address from parsed format to wire format
Definition: sccp2sua.c:225
void m3ua_tx_snm_congestion(struct osmo_ss7_asp *asp, const uint32_t *rctx, unsigned int num_rctx, const uint32_t *aff_pc, unsigned int num_aff_pc, const uint32_t *concerned_dpc, const uint8_t *cong_level, const char *info_string)
Transmit SSNM SCON message indicating congestion.
Definition: m3ua.c:955
int sua_parse_gt(struct osmo_sccp_gt *gt, const uint8_t *data, unsigned int datalen)
Decode SUA Global Title according to RFC3868 Section 3.10.2.3.
Definition: sua.c:338
int osmo_sccp_addr_parse(struct osmo_sccp_addr *out, const uint8_t *addr, unsigned int addrlen)
Parse wire-encoded SCCP address into osmo_sccp_addr.
Definition: sccp2sua.c:119
struct msgb * osmo_sua_to_sccp(struct xua_msg *xua)
convert parsed SUA message to SCCP message
Definition: sccp2sua.c:1781
void xua_asp_send_xlm_prim_simple(struct osmo_ss7_asp *asp, enum osmo_xlm_prim_type prim_type, enum osmo_prim_operation op)
Definition: xua_asp_fsm.c:127
void xua_snm_rx_duna(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua)
Definition: xua_snm.c:342
struct m3ua_data_hdr * data_hdr_from_m3ua(struct xua_msg *xua)
Definition: m3ua.c:573
void sua_tx_dupu(struct osmo_ss7_asp *asp, const uint32_t *rctx, unsigned int num_rctx, uint32_t dpc, uint16_t user, uint16_t cause, const char *info_str)
Transmit SSNM DUPU message indicating user unavailability.
Definition: sua.c:926
void xua_snm_rx_daud(struct osmo_ss7_asp *asp, struct xua_msg *xua)
Definition: xua_snm.c:291
struct osmo_mtp_prim * m3ua_to_xfer_ind(struct xua_msg *xua)
Definition: ss7_hmrt.c:47
uint8_t data[0]
Definition: xua_types.h:5