libosmo-sigtran  1.4.0
Osmocom SIGTRAN library
xua_internal.h
Go to the documentation of this file.
1 #pragma once
2 
5 
6 struct osmo_sccp_addr;
7 struct m3ua_data_hdr;
8 
9 int sua_addr_parse_part(struct osmo_sccp_addr *out,
10  const struct xua_msg_part *param);
11 int sua_addr_parse(struct osmo_sccp_addr *out, struct xua_msg *xua, uint16_t iei);
12 
13 int sua_parse_gt(struct osmo_sccp_gt *gt, const uint8_t *data, unsigned int datalen);
14 
15 struct xua_msg *osmo_sccp_to_xua(struct msgb *msg);
16 struct msgb *osmo_sua_to_sccp(struct xua_msg *xua);
17 
18 int sua_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg);
19 
20 int sua_tx_xua_as(struct osmo_ss7_as *as, struct xua_msg *xua);
21 void sua_tx_snm_available(struct osmo_ss7_asp *asp, const uint32_t *rctx, unsigned int num_rctx,
22  const uint32_t *aff_pc, unsigned int num_aff_pc, const uint32_t *aff_ssn,
23  const uint32_t *smi, const char *info_string, bool available);
24 void sua_tx_dupu(struct osmo_ss7_asp *asp, const uint32_t *rctx, unsigned int num_rctx,
25  uint32_t dpc, uint16_t user, uint16_t cause, const char *info_str);
26 
27 struct osmo_mtp_prim *m3ua_to_xfer_ind(struct xua_msg *xua);
28 int m3ua_hmdc_rx_from_l2(struct osmo_ss7_instance *inst, struct xua_msg *xua);
29 int m3ua_tx_xua_as(struct osmo_ss7_as *as, struct xua_msg *xua);
30 void m3ua_tx_snm_available(struct osmo_ss7_asp *asp, const uint32_t *rctx, unsigned int num_rctx,
31  const uint32_t *aff_pc, unsigned int num_aff_pc,
32  const char *info_string, bool available);
33 void m3ua_tx_dupu(struct osmo_ss7_asp *asp, const uint32_t *rctx, unsigned int num_rctx,
34  uint32_t dpc, uint16_t user, uint16_t cause, const char *info_str);
35 void xua_snm_rx_daud(struct osmo_ss7_asp *asp, struct xua_msg *xua);
36 void xua_snm_rx_duna(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua);
37 void xua_snm_rx_dava(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua);
38 void xua_snm_rx_dupu(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua);
39 int m3ua_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg);
40 
41 struct msgb *m3ua_msgb_alloc(const char *name);
42 struct xua_msg *m3ua_xfer_from_data(const struct m3ua_data_hdr *data_hdr,
43  const uint8_t *data, unsigned int data_len);
44 struct m3ua_data_hdr *data_hdr_from_m3ua(struct xua_msg *xua);
46  const struct m3ua_data_hdr *mdh);
48  const struct osmo_mtp_transfer_param *param);
49 
50 
51 extern const struct xua_msg_class m3ua_msg_class_mgmt;
52 extern const struct xua_msg_class m3ua_msg_class_snm;
53 extern const struct xua_msg_class m3ua_msg_class_rkm;
54 extern const struct xua_msg_class m3ua_msg_class_aspsm;
55 extern const struct xua_msg_class m3ua_msg_class_asptm;
56 
57 extern const struct value_string m3ua_err_names[];
58 extern const struct value_string m3ua_ntfy_type_names[];
59 extern const struct value_string m3ua_ntfy_stchg_names[];
60 extern const struct value_string m3ua_ntfy_other_names[];
61 
62 struct xua_msg *m3ua_encode_notify(const struct osmo_xlm_prim_notify *npar);
63 int m3ua_decode_notify(struct osmo_xlm_prim_notify *npar, void *ctx,
64  const struct xua_msg *xua);
65 int m3ua_rx_rkm(struct osmo_ss7_asp *asp, struct xua_msg *xua);
67 
69  enum osmo_prim_operation op);
70 
71 void xua_asp_send_xlm_prim(struct osmo_ss7_asp *asp, struct osmo_xlm_prim *prim);
73  enum osmo_xlm_prim_type prim_type,
74  enum osmo_prim_operation op);
75 
76 void xua_snm_pc_available(struct osmo_ss7_as *as, const uint32_t *aff_pc,
77  unsigned int num_aff_pc, const char *info_str, bool available);
78 
79 extern struct osmo_fsm xua_default_lm_fsm;
80 extern const struct value_string m3ua_rkm_reg_status_vals[];
81 extern const struct value_string m3ua_rkm_dereg_status_vals[];
82 
83 #define CS7_STR "ITU-T Signaling System 7\n"
84 #define PC_STR "Point Code\n"
85 #define INST_STR "An instance of the SS7 stack\n"
86 
87 int xua_as_transmit_msg(struct osmo_ss7_as *as, struct msgb *msg);
88 
89 int xua_find_as_for_asp(struct osmo_ss7_as **as, const struct osmo_ss7_asp *asp,
90  const struct xua_msg_part *rctx_ie);
91 
92 int ipa_tx_xua_as(struct osmo_ss7_as *as, struct xua_msg *xua);
93 int ipa_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg);
94 
95 int osmo_isup_party_parse(char *out_digits, const uint8_t *in,
96  unsigned int in_num_bytes, bool odd);
97 int osmo_sccp_addr_parse(struct osmo_sccp_addr *out,
98  const uint8_t *addr, unsigned int addrlen);
99 int osmo_sccp_addr_encode(struct msgb *msg, const struct osmo_sccp_addr *in);
100 
101 int ss7_asp_rx_unknown(struct osmo_ss7_asp *asp, int ppid_mux, struct msgb *msg);
uint32_t dpc
Definition: m3ua.h:497
struct msgb * osmo_sua_to_sccp(struct xua_msg *xua)
convert parsed SUA message to SCCP message
Definition: sccp2sua.c:1413
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:859
struct msgb * m3ua_msgb_alloc(const char *name)
Definition: m3ua.c:315
void xua_snm_rx_dupu(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua)
Definition: xua_snm.c:376
int m3ua_rx_rkm(struct osmo_ss7_asp *asp, struct xua_msg *xua)
Definition: xua_rkm.c:521
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:302
const struct value_string m3ua_err_names[]
Definition: m3ua.c:55
struct osmo_fsm xua_default_lm_fsm
Definition: xua_default_lm_fsm.c:331
struct xua_msg * osmo_sccp_to_xua(struct msgb *msg)
convert SCCP message to a SUA message
Definition: sccp2sua.c:1315
struct xua_msg * m3ua_encode_notify(const struct osmo_xlm_prim_notify *npar)
Definition: m3ua.c:380
struct m3ua_data_hdr * data_hdr_from_m3ua(struct xua_msg *xua)
Definition: m3ua.c:518
int m3ua_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg)
process M3UA message received from socket
Definition: m3ua.c:686
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:68
int sua_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg)
process SUA message received from socket
Definition: sua.c:670
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:881
Definition: xua_msg.h:38
Definition: sigtran_sap.h:66
int xua_as_transmit_msg(struct osmo_ss7_as *as, struct msgb *msg)
Definition: xua_as_fsm.c:152
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:323
uint8_t smi
Definition: sccp_scmg.h:41
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:90
const struct xua_msg_class m3ua_msg_class_asptm
Definition: m3ua.c:211
int ss7_asp_rx_unknown(struct osmo_ss7_asp *asp, int ppid_mux, struct msgb *msg)
Definition: osmo_ss7.c:2250
void xua_rkm_cleanup_dyn_as_for_asp(struct osmo_ss7_asp *asp)
Definition: xua_rkm.c:581
void xua_snm_rx_daud(struct osmo_ss7_asp *asp, struct xua_msg *xua)
Definition: xua_snm.c:261
void xua_asp_send_xlm_prim(struct osmo_ss7_asp *asp, struct osmo_xlm_prim *prim)
Definition: xua_asp_fsm.c:105
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:57
struct osmo_mtp_prim * m3ua_to_xfer_ind(struct xua_msg *xua)
Definition: osmo_ss7_hmrt.c:40
const struct xua_msg_class m3ua_msg_class_aspsm
Definition: m3ua.c:198
int m3ua_hmdc_rx_from_l2(struct osmo_ss7_instance *inst, struct xua_msg *xua)
Definition: osmo_ss7_hmrt.c:269
const struct value_string m3ua_ntfy_other_names[]
Definition: m3ua.c:93
const struct xua_msg_class m3ua_msg_class_snm
Definition: m3ua.c:175
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:120
Definition: sigtran_sap.h:37
const struct value_string m3ua_rkm_reg_status_vals[]
Definition: xua_rkm.c:35
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:72
osmo_xlm_prim_type
Definition: sigtran_sap.h:13
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:490
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:847
Definition: xua_msg.h:48
Definition: m3ua.h:95
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:118
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:869
const struct xua_msg_class m3ua_msg_class_mgmt
Definition: m3ua.c:229
const struct value_string m3ua_rkm_dereg_status_vals[]
Definition: xua_rkm.c:52
const struct xua_msg_class m3ua_msg_class_rkm
Definition: m3ua.c:259
Definition: mtp_sap.h:36
void xua_snm_rx_duna(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua)
Definition: xua_snm.c:306
Definition: osmo_ss7.h:382
Definition: sccp_sap.h:170
Definition: sccp_sap.h:162
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:334
const struct value_string m3ua_ntfy_type_names[]
Definition: m3ua.c:79
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:371
void xua_snm_rx_dava(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua)
Definition: xua_snm.c:341
void mtp_xfer_param_to_m3ua_dh(struct m3ua_data_hdr *mdh, const struct osmo_mtp_transfer_param *param)
Definition: m3ua.c:288
Definition: xua_msg.h:31
uint8_t data[0]
Definition: xua_types.h:72
Definition: osmo_ss7.h:72
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:499
const struct value_string m3ua_ntfy_stchg_names[]
Definition: m3ua.c:85
int ipa_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg)
process M3UA message received from socket
Definition: ipa.c:292
void m3ua_dh_to_xfer_param(struct osmo_mtp_transfer_param *param, const struct m3ua_data_hdr *mdh)
Definition: m3ua.c:300
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 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:224
Definition: osmo_ss7.h:298
Definition: mtp_sap.h:56
int m3ua_decode_notify(struct osmo_xlm_prim_notify *npar, void *ctx, const struct xua_msg *xua)
Definition: m3ua.c:409