libosmo-sigtran 1.5.0
Osmocom SIGTRAN library
xua_internal.h
Go to the documentation of this file.
1#pragma once
2
5
6struct osmo_sccp_addr;
7struct m3ua_data_hdr;
8
10 const struct xua_msg_part *param);
11int sua_addr_parse(struct osmo_sccp_addr *out, struct xua_msg *xua, uint16_t iei);
12
13int sua_parse_gt(struct osmo_sccp_gt *gt, const uint8_t *data, unsigned int datalen);
14
15struct xua_msg *osmo_sccp_to_xua(struct msgb *msg);
16struct msgb *osmo_sua_to_sccp(struct xua_msg *xua);
17
18int sua_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg);
19
20int sua_tx_xua_as(struct osmo_ss7_as *as, struct xua_msg *xua);
21void 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);
24void 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
27struct osmo_mtp_prim *m3ua_to_xfer_ind(struct xua_msg *xua);
28int m3ua_hmdc_rx_from_l2(struct osmo_ss7_instance *inst, struct xua_msg *xua);
29int m3ua_tx_xua_as(struct osmo_ss7_as *as, struct xua_msg *xua);
30void 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);
33void 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);
35void xua_snm_rx_daud(struct osmo_ss7_asp *asp, struct xua_msg *xua);
36void xua_snm_rx_duna(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua);
37void xua_snm_rx_dava(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua);
38void xua_snm_rx_dupu(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua);
39int m3ua_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg);
40
41struct msgb *m3ua_msgb_alloc(const char *name);
42struct xua_msg *m3ua_xfer_from_data(const struct m3ua_data_hdr *data_hdr,
43 const uint8_t *data, unsigned int data_len);
44struct 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
51extern const struct xua_msg_class m3ua_msg_class_mgmt;
52extern const struct xua_msg_class m3ua_msg_class_snm;
53extern const struct xua_msg_class m3ua_msg_class_rkm;
54extern const struct xua_msg_class m3ua_msg_class_aspsm;
55extern const struct xua_msg_class m3ua_msg_class_asptm;
56
57extern const struct value_string m3ua_err_names[];
58extern const struct value_string m3ua_ntfy_type_names[];
59extern const struct value_string m3ua_ntfy_stchg_names[];
60extern const struct value_string m3ua_ntfy_other_names[];
61
62struct xua_msg *m3ua_encode_notify(const struct osmo_xlm_prim_notify *npar);
63int m3ua_decode_notify(struct osmo_xlm_prim_notify *npar, void *ctx,
64 const struct xua_msg *xua);
65int m3ua_rx_rkm(struct osmo_ss7_asp *asp, struct xua_msg *xua);
67
69 enum osmo_prim_operation op);
70
71void 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
76void 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
79extern struct osmo_fsm xua_default_lm_fsm;
80extern const struct value_string m3ua_rkm_reg_status_vals[];
81extern 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
87int xua_as_transmit_msg(struct osmo_ss7_as *as, struct msgb *msg);
88
89int 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
92int ipa_tx_xua_as(struct osmo_ss7_as *as, struct xua_msg *xua);
93int ipa_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg);
94
95int osmo_isup_party_parse(char *out_digits, const uint8_t *in,
96 unsigned int in_num_bytes, bool odd);
98 const uint8_t *addr, unsigned int addrlen);
99int osmo_sccp_addr_encode(struct msgb *msg, const struct osmo_sccp_addr *in);
100
101int ss7_asp_rx_unknown(struct osmo_ss7_asp *asp, int ppid_mux, struct msgb *msg);
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:170
Definition: sccp_sap.h:162
Definition: osmo_ss7.h:300
Definition: osmo_ss7.h:387
Definition: osmo_ss7.h:73
Definition: sigtran_sap.h:37
Definition: sigtran_sap.h:66
Definition: xua_msg.h:48
Definition: xua_msg.h:38
Definition: xua_msg.h:31
const struct value_string m3ua_rkm_reg_status_vals[]
Definition: xua_rkm.c:35
const struct value_string m3ua_ntfy_type_names[]
Definition: m3ua.c:80
const struct value_string m3ua_err_names[]
Definition: m3ua.c:56
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 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:500
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:875
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
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:91
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:324
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:852
struct osmo_mtp_prim * m3ua_to_xfer_ind(struct xua_msg *xua)
Definition: osmo_ss7_hmrt.c:41
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:864
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:491
const struct value_string m3ua_ntfy_stchg_names[]
Definition: m3ua.c:86
const struct xua_msg_class m3ua_msg_class_snm
Definition: m3ua.c:176
int m3ua_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg)
process M3UA message received from socket
Definition: m3ua.c:689
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
struct m3ua_data_hdr * data_hdr_from_m3ua(struct xua_msg *xua)
Definition: m3ua.c:519
int m3ua_decode_notify(struct osmo_xlm_prim_notify *npar, void *ctx, const struct xua_msg *xua)
Definition: m3ua.c:410
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:58
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 xua_rkm_cleanup_dyn_as_for_asp(struct osmo_ss7_asp *asp)
Definition: xua_rkm.c:587
const struct value_string m3ua_rkm_dereg_status_vals[]
Definition: xua_rkm.c:52
int ss7_asp_rx_unknown(struct osmo_ss7_asp *asp, int ppid_mux, struct msgb *msg)
Definition: osmo_ss7.c:2417
int sua_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg)
process SUA message received from socket
Definition: sua.c:675
void mtp_xfer_param_to_m3ua_dh(struct m3ua_data_hdr *mdh, const struct osmo_mtp_transfer_param *param)
Definition: m3ua.c:289
struct osmo_fsm xua_default_lm_fsm
Definition: xua_default_lm_fsm.c:338
void xua_asp_send_xlm_prim(struct osmo_ss7_asp *asp, struct osmo_xlm_prim *prim)
Definition: xua_asp_fsm.c:106
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:303
int ipa_rx_msg(struct osmo_ss7_asp *asp, struct msgb *msg)
process M3UA message received from socket
Definition: ipa.c:296
const struct xua_msg_class m3ua_msg_class_rkm
Definition: m3ua.c:260
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:372
int m3ua_hmdc_rx_from_l2(struct osmo_ss7_instance *inst, struct xua_msg *xua)
Definition: osmo_ss7_hmrt.c:272
struct xua_msg * m3ua_encode_notify(const struct osmo_xlm_prim_notify *npar)
Definition: m3ua.c:381
const struct xua_msg_class m3ua_msg_class_aspsm
Definition: m3ua.c:199
const struct xua_msg_class m3ua_msg_class_asptm
Definition: m3ua.c:212
struct xua_msg * osmo_sccp_to_xua(struct msgb *msg)
convert SCCP message to a SUA message
Definition: sccp2sua.c:1409
const struct value_string m3ua_ntfy_other_names[]
Definition: m3ua.c:94
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:527
struct msgb * osmo_sua_to_sccp(struct xua_msg *xua)
convert parsed SUA message to SCCP message
Definition: sccp2sua.c:1515
struct msgb * m3ua_msgb_alloc(const char *name)
Definition: m3ua.c:316
void m3ua_dh_to_xfer_param(struct osmo_mtp_transfer_param *param, const struct m3ua_data_hdr *mdh)
Definition: m3ua.c:301
const struct xua_msg_class m3ua_msg_class_mgmt
Definition: m3ua.c:230
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
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:335
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 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:121
void xua_snm_rx_duna(struct osmo_ss7_asp *asp, struct osmo_ss7_as *as, struct xua_msg *xua)
Definition: xua_snm.c:306
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:886
void xua_snm_rx_daud(struct osmo_ss7_asp *asp, struct xua_msg *xua)
Definition: xua_snm.c:261
int xua_as_transmit_msg(struct osmo_ss7_as *as, struct msgb *msg)
Definition: xua_as_fsm.c:152
uint8_t data[0]
Definition: xua_types.h:5