6#include <osmocom/core/linuxlist.h>
7#include <osmocom/core/utils.h>
8#include <osmocom/core/fsm.h>
9#include <osmocom/core/msgb.h>
10#include <osmocom/core/prim.h>
11#include <osmocom/core/socket.h>
12#include <osmocom/core/rate_ctr.h>
24#define OSMO_SS7_PC_INVALID 0xffffffff
27 return pc <= 0x00ffffff;
54 uint8_t c0, uint8_t c1, uint8_t c2);
129 OSMO_DEPRECATED(
"Use internal ss7_instance_lookup_route() instead");
163static inline const char *
196static inline const char *
260#define OSMO_SS7_ASP_QUIRK_NO_NOTIFY 0x00000001
262#define OSMO_SS7_ASP_QUIRK_DAUD_IN_ASP 0x00000002
264#define OSMO_SS7_ASP_QUIRK_SNM_INACTIVE 0x00000004
274 uint16_t remote_port, uint16_t local_port,
276 OSMO_DEPRECATED(
"Use osmo_ss7_asp_find2() instead");
279 uint16_t remote_port, uint16_t local_port,
283 uint16_t remote_port, uint16_t local_port,
285 OSMO_DEPRECATED(
"Use osmo_ss7_asp_find_or_create2() instead");
288 uint16_t remote_port, uint16_t local_port,
320 const char *default_local_ip,
int default_remote_port,
321 const char *default_remote_ip);
327 int default_local_port,
328 const char *default_local_ip,
329 int default_remote_port,
330 const char *default_remote_ip);
339 const char *local_ip);
344 int local_port,
const char *local_ip);
349 const char *name, uint32_t pc,
350 int local_port,
int remote_port,
351 const char *remote_ip);
359 OSMO_DEPRECATED(
"Implicit parent node tracking has replaced the use of this callback. "
360 "This callback is no longer called, ever, and can be left NULL.");
uint32_t dpc
Definition: m3ua.h:1
struct osmo_ss7_as * osmo_ss7_route_get_dest_as(struct osmo_ss7_route *rt)
Get destination AS of route.
Definition: osmo_ss7_route.c:362
int osmo_ss7_as_add_asp(struct osmo_ss7_as *as, const char *asp_name)
Add given ASP to given AS.
Definition: osmo_ss7_as.c:174
struct osmo_ss7_as * osmo_ss7_as_find_by_name(struct osmo_ss7_instance *inst, const char *name)
Find Application Server by given name.
Definition: osmo_ss7_instance.c:223
int osmo_ss7_pointcode_parse_mask_or_len(const struct osmo_ss7_instance *inst, const char *in)
Definition: osmo_ss7_instance.c:596
void osmo_sccp_set_max_optional_data(struct osmo_sccp_instance *inst, int val)
Adjust the upper bound for the optional data length (the payload) for CR, CC, CREF and RLSD messages.
Definition: sccp_user.c:903
bool osmo_ss7_pc_is_local(const struct osmo_ss7_instance *inst, uint32_t pc)
Definition: osmo_ss7_instance.c:172
int osmo_ss7_asp_get_trans_proto(const struct osmo_ss7_asp *asp)
Get the transport proto of a given ASP.
Definition: osmo_ss7_asp.c:1275
void * osmo_ss7_user_get_priv(const struct osmo_ss7_user *user)
Definition: osmo_ss7_user.c:69
void osmo_ss7_vty_init_sg(void *ctx)
Definition: osmo_ss7_vty.c:3465
uint32_t osmo_ss7_instance_get_primary_pc(const struct osmo_ss7_instance *inst)
Definition: osmo_ss7_instance.c:122
int osmo_ss7_user_register(struct osmo_ss7_instance *inst, uint8_t service_ind, struct osmo_ss7_user *user)
Register a MTP user for a given service indicator.
Definition: osmo_ss7_user.c:79
static bool osmo_ss7_pc_is_valid(uint32_t pc)
Definition: osmo_ss7.h:25
const char * osmo_ss7_route_name(struct osmo_ss7_route *rt, bool list_asps)
Return human readable representation of the route, in a static buffer.
Definition: osmo_ss7_route.c:286
struct osmo_ss7_user * osmo_ss7_user_create(struct osmo_ss7_instance *inst, const char *name)
Definition: osmo_ss7_user.c:37
int osmo_ss7_pointcode_parse(const struct osmo_ss7_instance *inst, const char *str)
Definition: osmo_ss7_instance.c:524
struct osmo_sccp_instance * osmo_sccp_simple_client_on_ss7_id(void *ctx, uint32_t ss7_id, const char *name, uint32_t default_pc, enum osmo_ss7_asp_protocol prot, int default_local_port, const char *default_local_ip, int default_remote_port, const char *default_remote_ip)
request an sccp client instance
Definition: sccp_user.c:519
uint32_t osmo_ss7_instance_get_id(const struct osmo_ss7_instance *inst)
Definition: osmo_ss7_instance.c:112
struct osmo_ss7_as * osmo_ss7_as_find_by_proto(struct osmo_ss7_instance *inst, enum osmo_ss7_asp_protocol proto)
Find Application Server (AS) by given protocol.
Definition: osmo_ss7_instance.c:275
struct osmo_ss7_asp * osmo_ss7_asp_find_by_name(struct osmo_ss7_instance *inst, const char *name)
Definition: osmo_ss7_instance.c:335
osmo_ss7_asp_protocol
Definition: osmo_ss7.h:154
@ OSMO_SS7_ASP_PROT_SUA
Definition: osmo_ss7.h:156
@ OSMO_SS7_ASP_PROT_NONE
Definition: osmo_ss7.h:155
@ OSMO_SS7_ASP_PROT_IPA
Definition: osmo_ss7.h:158
@ OSMO_SS7_ASP_PROT_M3UA
Definition: osmo_ss7.h:157
@ _NUM_OSMO_SS7_ASP_PROT
Definition: osmo_ss7.h:159
struct value_string osmo_ss7_asp_protocol_vals[]
Definition: osmo_ss7_asp.c:119
struct value_string osmo_ss7_as_traffic_mode_vals[]
Definition: osmo_ss7_as.c:50
int osmo_ss7_tmode_to_xua(enum osmo_ss7_as_traffic_mode tmod)
Definition: osmo_ss7.c:190
struct osmo_ss7_as * osmo_ss7_as_find_by_l_rk_id(struct osmo_ss7_instance *inst, uint32_t l_rk_id)
Find Application Server by given local routing key ID.
Definition: osmo_ss7_instance.c:257
enum osmo_ss7_asp_protocol osmo_ss7_asp_get_proto(const struct osmo_ss7_asp *asp)
Get the proto of a given ASP.
Definition: osmo_ss7_asp.c:1266
struct osmo_ss7_asp * osmo_ss7_as_select_asp(struct osmo_ss7_as *as)
Select an AS to transmit a message, according to AS configuration and ASP availability.
Definition: osmo_ss7_as.c:517
int osmo_ss7_user_unregister(struct osmo_ss7_instance *inst, uint8_t service_ind, struct osmo_ss7_user *user)
Unregister a MTP user for a given service indicator.
Definition: osmo_ss7_user.c:103
osmo_ss7_asp_role
Definition: osmo_ss7.h:249
@ OSMO_SS7_ASP_ROLE_SG
Definition: osmo_ss7.h:251
@ OSMO_SS7_ASP_ROLE_ASP
Definition: osmo_ss7.h:250
@ OSMO_SS7_ASP_ROLE_IPSP
Definition: osmo_ss7.h:252
int osmo_ss7_asp_send(struct osmo_ss7_asp *asp, struct msgb *msg)
send a fully encoded msgb via a given ASP
Definition: osmo_ss7_asp.c:1157
struct osmo_ss7_instance * osmo_ss7_user_get_instance(const struct osmo_ss7_user *user)
Definition: osmo_ss7_user.c:54
void osmo_ss7_instance_destroy(struct osmo_ss7_instance *inst)
Destroy a SS7 Instance.
Definition: osmo_ss7_instance.c:89
const char * osmo_ss7_route_print(const struct osmo_ss7_route *rt)
Definition: osmo_ss7_route.c:264
void osmo_ss7_user_set_priv(struct osmo_ss7_user *user, void *priv)
Definition: osmo_ss7_user.c:64
struct osmo_sccp_instance * osmo_ss7_get_sccp(const struct osmo_ss7_instance *inst)
Get the SCCP instance, if present.
Definition: osmo_ss7_instance.c:167
struct osmo_sccp_instance * osmo_sccp_simple_server_on_ss7_id(void *ctx, uint32_t ss7_id, uint32_t pc, enum osmo_ss7_asp_protocol prot, int local_port, const char *local_ip)
Definition: sccp_user.c:770
int osmo_ss7_asp_rx_unknown_cb(struct osmo_ss7_asp *asp, int ppid_mux, struct msgb *msg)
Weak function to handle payload for unknown/unsupported PPID or IPA StreamID.
Definition: osmo_ss7.h:308
const struct value_string osmo_ss7_asp_role_names[]
Definition: osmo_ss7_asp.c:127
struct osmo_ss7_as * osmo_ss7_as_find_by_rctx(struct osmo_ss7_instance *inst, uint32_t rctx)
Find Application Server by given routing context.
Definition: osmo_ss7_instance.c:240
osmo_ss7_asp_admin_state
Definition: osmo_ss7.h:240
@ OSMO_SS7_ASP_ADM_S_SHUTDOWN
no SCTP association with peer
Definition: osmo_ss7.h:242
@ OSMO_SS7_ASP_ADM_S_BLOCKED
SCP association, but reject ASP-ACTIVE.
Definition: osmo_ss7.h:244
@ OSMO_SS7_ASP_ADM_S_ENABLED
in normal operation
Definition: osmo_ss7.h:246
uint32_t osmo_ss7_pc_normalize(const struct osmo_ss7_pc_fmt *pc_fmt, uint32_t pc)
Definition: osmo_ss7.c:95
int osmo_ss7_asp_protocol_port(enum osmo_ss7_asp_protocol prot)
Definition: osmo_ss7_asp.c:178
struct osmo_ss7_asp * osmo_ss7_asp_find2(struct osmo_ss7_instance *inst, const char *name, uint16_t remote_port, uint16_t local_port, int trans_proto, enum osmo_ss7_asp_protocol proto)
Definition: osmo_ss7_instance.c:366
int osmo_ss7_user_mtp_xfer_req(struct osmo_ss7_instance *inst, struct osmo_mtp_prim *omp)
Definition: osmo_ss7_hmrt.c:257
bool osmo_ss7_as_active(const struct osmo_ss7_as *as)
Determine if given AS is in the active state.
Definition: osmo_ss7_as.c:274
void osmo_ss7_asp_destroy(struct osmo_ss7_asp *asp)
Definition: osmo_ss7_asp.c:576
struct osmo_sccp_instance * osmo_ss7_ensure_sccp(struct osmo_ss7_instance *inst)
Allocate an SCCP instance, if not present yet.
Definition: osmo_ss7_instance.c:153
bool osmo_ss7_as_down(const struct osmo_ss7_as *as)
Determine if given AS is in the down state.
Definition: osmo_ss7_as.c:284
osmo_ss7_as_traffic_mode
Definition: osmo_ss7.h:180
@ OSMO_SS7_AS_TMOD_OVERRIDE
Definition: osmo_ss7.h:182
@ _NUM_OSMO_SS7_ASP_TMOD
Definition: osmo_ss7.h:191
@ OSMO_SS7_AS_TMOD_ROUNDROBIN
Definition: osmo_ss7.h:190
@ OSMO_SS7_AS_TMOD_BCAST
Definition: osmo_ss7.h:184
@ OSMO_SS7_AS_TMOD_LOADSHARE
Definition: osmo_ss7.h:187
struct osmo_ss7_asp * osmo_ss7_asp_find_or_create(struct osmo_ss7_instance *inst, const char *name, uint16_t remote_port, uint16_t local_port, enum osmo_ss7_asp_protocol proto) OSMO_DEPRECATED("Use osmo_ss7_asp_find_or_create2() instead")
Definition: osmo_ss7_instance.c:422
struct osmo_sccp_instance * osmo_sccp_simple_server_add_clnt(struct osmo_sccp_instance *inst, enum osmo_ss7_asp_protocol prot, const char *name, uint32_t pc, int local_port, int remote_port, const char *remote_ip)
Definition: sccp_user.c:823
bool osmo_ss7_asp_active(const struct osmo_ss7_asp *asp)
Definition: osmo_ss7_asp.c:759
struct llist_head osmo_ss7_instances
int osmo_ss7_asp_restart(struct osmo_ss7_asp *asp)
Definition: osmo_ss7_asp.c:714
struct osmo_ss7_instance * osmo_ss7_instance_find_or_create(void *ctx, uint32_t id)
Find or create a SS7 Instance.
Definition: osmo_ss7.c:126
const char * osmo_ss7_pointcode_print2(const struct osmo_ss7_instance *inst, uint32_t pc)
Definition: osmo_ss7_instance.c:590
uint8_t osmo_ss7_pc_width(const struct osmo_ss7_pc_fmt *pc_fmt)
Definition: osmo_ss7.c:87
const char * osmo_ss7_pointcode_print_buf(char *buf, size_t buf_len, const struct osmo_ss7_instance *inst, uint32_t pc)
Definition: osmo_ss7_instance.c:558
int osmo_ss7_init(void)
Definition: osmo_ss7.c:164
void osmo_ss7_register_rx_unknown_cb(osmo_ss7_asp_rx_unknown_cb *cb)
Register a call-back function for unknown SCTP PPID / IPA Stream ID.
Definition: osmo_ss7_asp.c:1215
int osmo_ss7_is_config_node(struct vty *vty, int node) OSMO_DEPRECATED("Implicit parent node tracking has replaced the use of this callback. " "This callback is no longer called
void osmo_ss7_user_set_prim_cb(struct osmo_ss7_user *user, osmo_prim_cb prim_cb)
Definition: osmo_ss7_user.c:59
void osmo_ss7_user_destroy(struct osmo_ss7_user *user)
Definition: osmo_ss7_user.c:49
enum osmo_ss7_asp_protocol osmo_ss7_as_get_asp_protocol(const struct osmo_ss7_as *as)
Get asp_protocol configuration of a given AS.
Definition: osmo_ss7_as.c:139
struct osmo_ss7_route * osmo_ss7_route_lookup(struct osmo_ss7_instance *inst, uint32_t dpc) OSMO_DEPRECATED("Use internal ss7_instance_lookup_route() instead")
Find a SS7 route for given destination point code in given SS7.
Definition: osmo_ss7_route.c:345
const struct osmo_ss7_pc_fmt * osmo_ss7_instance_get_pc_fmt(const struct osmo_ss7_instance *inst)
Definition: osmo_ss7_instance.c:146
struct osmo_ss7_asp * osmo_ss7_asp_find_or_create2(struct osmo_ss7_instance *inst, const char *name, uint16_t remote_port, uint16_t local_port, int trans_proto, enum osmo_ss7_asp_protocol proto)
Definition: osmo_ss7_instance.c:400
struct osmo_sccp_instance * osmo_sccp_simple_server(void *ctx, uint32_t pc, enum osmo_ss7_asp_protocol prot, int local_port, const char *local_ip)
Definition: sccp_user.c:814
struct osmo_sccp_instance * osmo_sccp_simple_client(void *ctx, const char *name, uint32_t default_pc, enum osmo_ss7_asp_protocol prot, int default_local_port, const char *default_local_ip, int default_remote_port, const char *default_remote_ip)
request an sccp client instance
Definition: sccp_user.c:749
int osmo_ss7_vty_go_parent(struct vty *vty)
Definition: osmo_ss7_vty.c:3263
bool osmo_ss7_as_has_asp(const struct osmo_ss7_as *as, const struct osmo_ss7_asp *asp)
Determine if given AS contains ASP.
Definition: osmo_ss7_as.c:243
static const char * osmo_ss7_asp_protocol_name(enum osmo_ss7_asp_protocol mode)
Definition: osmo_ss7.h:164
struct osmo_ss7_instance * osmo_ss7_instance_find(uint32_t id)
Find a SS7 Instance with given ID.
Definition: osmo_ss7.c:109
int osmo_ss7_as_del_asp(struct osmo_ss7_as *as, const char *asp_name)
Delete given ASP from given AS.
Definition: osmo_ss7_as.c:190
const char * osmo_ss7_pointcode_print(const struct osmo_ss7_instance *inst, uint32_t pc)
Definition: osmo_ss7_instance.c:582
struct osmo_ss7_asp * osmo_ss7_asp_find_by_proto(struct osmo_ss7_as *as, enum osmo_ss7_asp_protocol proto)
Find an ASP that matches the given ASP protocol (xUA variant).
Definition: osmo_ss7_instance.c:352
int osmo_ss7_find_free_rctx(struct osmo_ss7_instance *inst)
Definition: osmo_ss7_instance.c:183
static const char * osmo_ss7_as_traffic_mode_name(enum osmo_ss7_as_traffic_mode mode)
Definition: osmo_ss7.h:197
const char * osmo_ss7_asp_get_name(const struct osmo_ss7_asp *asp)
Get the name of a given ASP.
Definition: osmo_ss7_asp.c:1257
int osmo_ss7_instance_set_pc_fmt(struct osmo_ss7_instance *inst, uint8_t c0, uint8_t c1, uint8_t c2)
Set the point code format used in given SS7 instance.
Definition: osmo_ss7_instance.c:128
struct osmo_ss7_as * osmo_ss7_as_find_or_create(struct osmo_ss7_instance *inst, const char *name, enum osmo_ss7_asp_protocol proto)
Find or Create Application Server.
Definition: osmo_ss7_instance.c:309
bool osmo_ss7_as_tmode_compatible_xua(struct osmo_ss7_as *as, uint32_t m3ua_tmt)
Definition: osmo_ss7_as.c:549
struct osmo_ss7_asp * osmo_ss7_asp_find(struct osmo_ss7_instance *inst, const char *name, uint16_t remote_port, uint16_t local_port, enum osmo_ss7_asp_protocol proto) OSMO_DEPRECATED("Use osmo_ss7_asp_find2() instead")
Definition: osmo_ss7_instance.c:388
int osmo_ss7_asp_get_log_subsys(const struct osmo_ss7_asp *asp)
Get the logging subsystem for a given ASP.
Definition: osmo_ss7_asp.c:1241
void osmo_ss7_asp_disconnect(struct osmo_ss7_asp *asp)
Definition: osmo_ss7_asp.c:1203
enum osmo_ss7_as_traffic_mode osmo_ss7_tmode_from_xua(uint32_t in)
Definition: osmo_ss7.c:207
int osmo_ss7_asp_use_default_lm(struct osmo_ss7_asp *asp, int log_level)
Definition: xua_default_lm_fsm.c:424
void osmo_ss7_vty_init_asp(void *ctx)
Definition: osmo_ss7_vty.c:3459
const char * osmo_ss7_instance_get_name(const struct osmo_ss7_instance *inst)
Definition: osmo_ss7_instance.c:117
struct osmo_ss7_instance * osmo_ss7_instances_llist_entry(struct llist_head *list)
Definition: osmo_ss7.c:68
void osmo_ss7_as_destroy(struct osmo_ss7_as *as)
Destroy given Application Server.
Definition: osmo_ss7_as.c:222
Definition: sccp_internal.h:39
char * name
Definition: ss7_as.h:94
enum osmo_ss7_asp_protocol proto
Definition: ss7_as.h:96
struct osmo_ss7_instance * inst
Definition: ss7_as.h:76
enum osmo_ss7_asp_protocol proto
Definition: ss7_asp.h:69
struct osmo_ss7_instance * inst
Definition: ss7_asp.h:31
char * name
Definition: ss7_asp.h:67
int trans_proto
The underlaying transport protocol (one of IPPROTO_*)
Definition: ss7_asp.h:96
Definition: ss7_instance.h:21
const struct osmo_ss7_user * user[16]
Definition: ss7_instance.h:36
struct llist_head list
member of global list of instances
Definition: ss7_instance.h:23
Definition: ss7_link.h:19
Definition: ss7_linkset.h:13
Definition: ss7_instance.h:16
Definition: ss7_route.h:17
Definition: osmo_ss7.h:139
uint8_t si
Definition: osmo_ss7.h:144
uint32_t context
Definition: osmo_ss7.h:140
uint32_t l_rk_id
Definition: osmo_ss7.h:141
uint32_t ssn
Definition: osmo_ss7.h:145
uint32_t pc
Definition: osmo_ss7.h:143
Definition: ss7_user.h:13
const char * name
Definition: ss7_user.h:17
struct osmo_ss7_instance * inst
Definition: ss7_user.h:15
Definition: ss7_xua_srv.h:18
Definition: ss7_xua_srv.h:22