libosmo-sigtran 2.0.0.31-7261.202411072026
Osmocom SIGTRAN library
osmo_ss7.h
Go to the documentation of this file.
1#pragma once
2
3#include <stdint.h>
4#include <stdbool.h>
5
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>
13
14extern struct llist_head osmo_ss7_instances;
15
17struct osmo_ss7_user;
19struct osmo_mtp_prim;
22
23int osmo_ss7_init(void);
25
26bool osmo_ss7_pc_is_local(const struct osmo_ss7_instance *inst, uint32_t pc);
27int osmo_ss7_pointcode_parse(const struct osmo_ss7_instance *inst, const char *str);
28int osmo_ss7_pointcode_parse_mask_or_len(const struct osmo_ss7_instance *inst, const char *in);
29const char *osmo_ss7_pointcode_print_buf(char *buf, size_t buf_len, const struct osmo_ss7_instance *inst, uint32_t pc);
30const char *osmo_ss7_pointcode_print(const struct osmo_ss7_instance *inst, uint32_t pc);
31const char *osmo_ss7_pointcode_print2(const struct osmo_ss7_instance *inst, uint32_t pc);
32
33/* All known point-code formats have a length of or below 24 bit.
34 * A point-code value exceeding that is used to indicate an unset PC. */
35#define OSMO_SS7_PC_INVALID 0xffffffff
36static inline bool osmo_ss7_pc_is_valid(uint32_t pc)
37{
38 return pc <= 0x00ffffff;
39}
40
41/***********************************************************************
42 * SS7 Instances
43 ***********************************************************************/
44
47 uint8_t component_len[3];
48};
49
52 struct llist_head list;
54 struct llist_head linksets;
56 struct llist_head as_list;
58 struct llist_head asp_list;
60 struct llist_head rtable_list;
62 struct llist_head xua_servers;
63 /* array for faster lookup of user (indexed by service
64 * indicator) */
65 const struct osmo_ss7_user *user[16];
66
68
70
71 struct {
72 uint32_t id;
73 char *name;
75 uint32_t primary_pc;
76 /* capability PCs */
80 struct llist_head sccp_address_book;
81 uint32_t secondary_pc;
82 } cfg;
83};
84
85struct osmo_ss7_instance *osmo_ss7_instance_find(uint32_t id);
86struct osmo_ss7_instance *
87osmo_ss7_instance_find_or_create(void *ctx, uint32_t id);
90 uint8_t c0, uint8_t c1, uint8_t c2);
91
93
94uint8_t osmo_ss7_pc_width(const struct osmo_ss7_pc_fmt *pc_fmt);
95uint32_t osmo_ss7_pc_normalize(const struct osmo_ss7_pc_fmt *pc_fmt, uint32_t pc);
96
97/***********************************************************************
98 * MTP Users (Users of MTP, such as SCCP or ISUP)
99 ***********************************************************************/
100
102 /* pointer back to SS7 instance */
104 /* name of the user */
105 const char *name;
106 /* primitive call-back for incoming MTP primitives */
107 osmo_prim_cb prim_cb;
108 /* private data */
109 void *priv;
110};
111
112int osmo_ss7_user_register(struct osmo_ss7_instance *inst, uint8_t service_ind,
113 struct osmo_ss7_user *user);
114
115int osmo_ss7_user_unregister(struct osmo_ss7_instance *inst, uint8_t service_ind,
116 struct osmo_ss7_user *user);
117
118int osmo_ss7_mtp_to_user(struct osmo_ss7_instance *inst, struct osmo_mtp_prim *omp);
119
120/* SS7 User wants to issue MTP-TRANSFER.req */
122 struct osmo_mtp_prim *omp);
123
124/***********************************************************************
125 * SS7 Links
126 ***********************************************************************/
127
128struct osmo_ss7_link;
129
130/***********************************************************************
131 * SS7 Linksets
132 ***********************************************************************/
133
134struct osmo_ss7_linkset;
135
136/***********************************************************************
137 * SS7 Routes
138 ***********************************************************************/
139
140struct osmo_ss7_route;
141
142struct osmo_ss7_route *
143osmo_ss7_route_lookup(struct osmo_ss7_instance *inst, uint32_t dpc);
144const char *osmo_ss7_route_print(const struct osmo_ss7_route *rt);
145const char *osmo_ss7_route_name(struct osmo_ss7_route *rt, bool list_asps);
146struct osmo_ss7_as *
148
149/***********************************************************************
150 * SS7 Application Servers
151 ***********************************************************************/
152
154 uint32_t context;
155 uint32_t l_rk_id;
156
157 uint32_t pc;
158 uint8_t si;
159 uint32_t ssn;
160 /* FIXME: more complex routing keys */
161};
162
164 OSMO_SS7_AS_TMOD_OVERRIDE = 0, /* default */
170
171extern struct value_string osmo_ss7_as_traffic_mode_vals[];
172
173static inline const char *
175{
176 return get_value_string(osmo_ss7_as_traffic_mode_vals, mode);
177}
178
186
187extern struct value_string osmo_ss7_asp_protocol_vals[];
188
189static inline const char *
191{
192 return get_value_string(osmo_ss7_asp_protocol_vals, mode);
193}
194
196
198 OSMO_SS7_PATCH_NONE, /* no patching of SCCP */
199 OSMO_SS7_PATCH_BOTH, /* patch both OPC and DPC into SCCP addresses */
200};
201
204 struct llist_head list;
206
208 struct osmo_fsm_inst *fi;
209
212
215
217 struct rate_ctr_group *ctrg;
218
219 struct {
220 char *name;
225 /* traffic mode was configured by VTY / config file */
227 /* traffic mode was configured by RKM (routing key management) or first ASPAC */
230 uint8_t qos_class;
231 struct {
232 uint32_t dpc;
235
236 struct osmo_ss7_asp *asps[16];
237 uint8_t last_asp_idx_sent; /* used for load-sharing traffic mode (round robin implementation) */
239};
240
241struct osmo_ss7_as *
243struct osmo_ss7_as *
244osmo_ss7_as_find_by_rctx(struct osmo_ss7_instance *inst, uint32_t rctx);
245struct osmo_ss7_as *
246osmo_ss7_as_find_by_l_rk_id(struct osmo_ss7_instance *inst, uint32_t l_rk_id);
249struct osmo_ss7_as *
252int osmo_ss7_as_add_asp(struct osmo_ss7_as *as, const char *asp_name);
253int osmo_ss7_as_del_asp(struct osmo_ss7_as *as, const char *asp_name);
254void osmo_ss7_as_destroy(struct osmo_ss7_as *as);
255bool osmo_ss7_as_has_asp(const struct osmo_ss7_as *as,
256 const struct osmo_ss7_asp *asp);
257bool osmo_ss7_as_down(const struct osmo_ss7_as *as);
258bool osmo_ss7_as_active(const struct osmo_ss7_as *as);
259bool osmo_ss7_as_tmode_compatible_xua(struct osmo_ss7_as *as, uint32_t m3ua_tmt);
260void osmo_ss7_asp_disconnect(struct osmo_ss7_asp *asp);
261
262
263/***********************************************************************
264 * SS7 Application Server Processes
265 ***********************************************************************/
266
268 char *host[OSMO_SOCK_MAX_ADDRS];
269 size_t host_cnt;
270 uint16_t port;
271 /* index in "hosts" array marking the SCTP Primary Address, -1 if no explicit Primary Address set */
273};
274
282};
283
288};
289
290extern const struct value_string osmo_ss7_asp_role_names[];
291
294 struct llist_head list;
296
298 struct osmo_fsm_inst *fi;
299
302 struct llist_head siblings;
303
305 struct osmo_stream_cli *client;
306 struct osmo_stream_srv *server;
309
310 /* ASP Identifier for ASP-UP + NTFY */
311 uint32_t asp_id;
313
314 /* Layer Manager to which we talk */
316 void *lm_priv;
317
320
323
325 struct rate_ctr_group *ctrg;
326
328 struct msgb *pending_msg;
329
330 struct {
331 char *name;
339
342 uint8_t qos_class;
343 uint32_t quirks;
344
345 /* T_defs used by the default_lm: */
346 struct osmo_tdef *T_defs_lm;
347
348 struct {
356 uint16_t max_init_timeo_value; /* ms */
358
362};
363
365#define OSMO_SS7_ASP_QUIRK_NO_NOTIFY 0x00000001
367#define OSMO_SS7_ASP_QUIRK_DAUD_IN_ASP 0x00000002
369#define OSMO_SS7_ASP_QUIRK_SNM_INACTIVE 0x00000004
370
371int osmo_ss7_asp_peer_snprintf(char* buf, size_t buf_len, struct osmo_ss7_asp_peer *peer);
373int osmo_ss7_asp_peer_set_hosts(struct osmo_ss7_asp_peer *peer, void *talloc_ctx,
374 const char *const*hosts, size_t host_cnt);
375int osmo_ss7_asp_peer_set_hosts2(struct osmo_ss7_asp_peer *peer, void *talloc_ctx,
376 const char *const*hosts, size_t host_cnt, int idx_primary);
377int osmo_ss7_asp_peer_add_host(struct osmo_ss7_asp_peer *peer, void *talloc_ctx, const char *host);
378int osmo_ss7_asp_peer_add_host2(struct osmo_ss7_asp_peer *peer, void *talloc_ctx, const char *host, bool is_primary_addr);
379int osmo_ss7_asp_peer_del_host(struct osmo_ss7_asp_peer *peer, const char *host);
380
381
382struct osmo_ss7_asp *
384struct osmo_ss7_asp *
387struct osmo_ss7_asp *
388osmo_ss7_asp_find(struct osmo_ss7_instance *inst, const char *name,
389 uint16_t remote_port, uint16_t local_port,
391 OSMO_DEPRECATED("Use osmo_ss7_asp_find2() instead");
392struct osmo_ss7_asp *
393osmo_ss7_asp_find2(struct osmo_ss7_instance *inst, const char *name,
394 uint16_t remote_port, uint16_t local_port,
396struct osmo_ss7_asp *
398 uint16_t remote_port, uint16_t local_port,
400 OSMO_DEPRECATED("Use osmo_ss7_asp_find_or_create2() instead");
401struct osmo_ss7_asp *
403 uint16_t remote_port, uint16_t local_port,
405void osmo_ss7_asp_destroy(struct osmo_ss7_asp *asp);
406int osmo_ss7_asp_send(struct osmo_ss7_asp *asp, struct msgb *msg);
407int osmo_ss7_asp_restart(struct osmo_ss7_asp *asp);
408int osmo_ss7_asp_use_default_lm(struct osmo_ss7_asp *asp, int log_level);
409bool osmo_ss7_asp_active(const struct osmo_ss7_asp *asp);
410int osmo_ss7_asp_get_log_subsys(const struct osmo_ss7_asp *asp);
411const char *osmo_ss7_asp_get_name(const struct osmo_ss7_asp *asp);
413int osmo_ss7_asp_get_trans_proto(const struct osmo_ss7_asp *asp);
414
422typedef int osmo_ss7_asp_rx_unknown_cb(struct osmo_ss7_asp *asp, int ppid_mux, struct msgb *msg);
423
425
426/***********************************************************************
427 * xUA Servers
428 ***********************************************************************/
429
431 osmo_prim_cb prim_cb;
432};
433
435 struct llist_head list;
437
438 /* list of ASPs established via this server */
439 struct llist_head asp_list;
440
441 struct osmo_stream_srv_link *server;
442
443 struct {
447 struct {
453
457};
458
459struct osmo_xua_server *
462 uint16_t local_port)
463 OSMO_DEPRECATED("Use osmo_ss7_xua_server_find2() instead");
464struct osmo_xua_server *
466 int trans_proto,
468 uint16_t local_port);
469
470struct osmo_xua_server *
473 uint16_t local_port, const char *local_host)
474 OSMO_DEPRECATED("Use osmo_ss7_xua_server_create2() instead");
475struct osmo_xua_server *
478 uint16_t local_port, const char *local_host);
479
480int
482
483int
484osmo_ss7_xua_server_set_local_host(struct osmo_xua_server *xs, const char *local_host);
485int
486osmo_ss7_xua_server_set_local_hosts(struct osmo_xua_server *xs, const char **local_hosts, size_t local_host_cnt);
487int osmo_ss7_xua_server_add_local_host(struct osmo_xua_server *xs, const char *local_host);
488int osmo_ss7_xua_server_del_local_host(struct osmo_xua_server *xs, const char *local_host);
490
491struct osmo_sccp_instance *
492osmo_sccp_simple_client(void *ctx, const char *name, uint32_t default_pc,
493 enum osmo_ss7_asp_protocol prot, int default_local_port,
494 const char *default_local_ip, int default_remote_port,
495 const char *default_remote_ip);
496
497struct osmo_sccp_instance *
498osmo_sccp_simple_client_on_ss7_id(void *ctx, uint32_t ss7_id, const char *name,
499 uint32_t default_pc,
500 enum osmo_ss7_asp_protocol prot,
501 int default_local_port,
502 const char *default_local_ip,
503 int default_remote_port,
504 const char *default_remote_ip);
505
506struct osmo_sccp_instance *
507osmo_sccp_simple_server(void *ctx, uint32_t pc,
508 enum osmo_ss7_asp_protocol prot, int local_port,
509 const char *local_ip);
510
511struct osmo_sccp_instance *
512osmo_sccp_simple_server_on_ss7_id(void *ctx, uint32_t ss7_id, uint32_t pc,
513 enum osmo_ss7_asp_protocol prot,
514 int local_port, const char *local_ip);
515
516struct osmo_sccp_instance *
518 enum osmo_ss7_asp_protocol prot,
519 const char *name, uint32_t pc,
520 int local_port, int remote_port,
521 const char *remote_ip);
522
523void osmo_sccp_set_max_optional_data(struct osmo_sccp_instance *inst, int val);
524
527
528/* VTY related */
529struct vty;
530void osmo_ss7_vty_init_asp(void *ctx);
531void osmo_ss7_vty_init_sg(void *ctx);
532int osmo_ss7_vty_go_parent(struct vty *vty);
533int osmo_ss7_is_config_node(struct vty *vty, int node);
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:310
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:102
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.c:511
int osmo_ss7_pointcode_parse_mask_or_len(const struct osmo_ss7_instance *inst, const char *in)
Definition: osmo_ss7.c:280
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:891
struct osmo_xua_server * osmo_ss7_xua_server_create(struct osmo_ss7_instance *inst, enum osmo_ss7_asp_protocol proto, uint16_t local_port, const char *local_host) OSMO_DEPRECATED("Use osmo_ss7_xua_server_create2() instead")
create a new xUA server configured with given ip/port
Definition: osmo_ss7_xua_srv.c:258
osmo_ss7_as_patch_sccp_mode
Definition: osmo_ss7.h:197
@ OSMO_SS7_PATCH_BOTH
Definition: osmo_ss7.h:199
@ OSMO_SS7_PATCH_NONE
Definition: osmo_ss7.h:198
bool osmo_ss7_pc_is_local(const struct osmo_ss7_instance *inst, uint32_t pc)
Definition: osmo_ss7.c:788
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:1227
void osmo_ss7_vty_init_sg(void *ctx)
Definition: osmo_ss7_vty.c:3113
int osmo_ss7_asp_peer_add_host2(struct osmo_ss7_asp_peer *peer, void *talloc_ctx, const char *host, bool is_primary_addr)
Append (copy) address to a given ASP peer.
Definition: osmo_ss7_asp_peer.c:142
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.c:433
static bool osmo_ss7_pc_is_valid(uint32_t pc)
Definition: osmo_ss7.h:36
void osmo_ss7_xua_server_destroy(struct osmo_xua_server *xs)
Definition: osmo_ss7_xua_srv.c:359
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_hmrt.c:153
int osmo_ss7_pointcode_parse(const struct osmo_ss7_instance *inst, const char *str)
Definition: osmo_ss7.c:208
struct osmo_xua_server * osmo_ss7_xua_server_find(struct osmo_ss7_instance *inst, enum osmo_ss7_asp_protocol proto, uint16_t local_port) OSMO_DEPRECATED("Use osmo_ss7_xua_server_find2() instead")
find an xUA server with the given parameters
Definition: osmo_ss7.c:779
int osmo_ss7_xua_server_add_local_host(struct osmo_xua_server *xs, const char *local_host)
Definition: osmo_ss7_xua_srv.c:324
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:503
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.c:563
struct osmo_ss7_asp * osmo_ss7_asp_find_by_name(struct osmo_ss7_instance *inst, const char *name)
Definition: osmo_ss7.c:645
osmo_ss7_asp_protocol
Definition: osmo_ss7.h:179
@ OSMO_SS7_ASP_PROT_SUA
Definition: osmo_ss7.h:181
@ OSMO_SS7_ASP_PROT_NONE
Definition: osmo_ss7.h:180
@ OSMO_SS7_ASP_PROT_IPA
Definition: osmo_ss7.h:183
@ OSMO_SS7_ASP_PROT_M3UA
Definition: osmo_ss7.h:182
@ _NUM_OSMO_SS7_ASP_PROT
Definition: osmo_ss7.h:184
struct value_string osmo_ss7_asp_protocol_vals[]
Definition: osmo_ss7_asp.c:116
struct value_string osmo_ss7_as_traffic_mode_vals[]
Definition: osmo_ss7_as.c:46
int osmo_ss7_tmode_to_xua(enum osmo_ss7_as_traffic_mode tmod)
Definition: osmo_ss7.c:825
struct osmo_xua_server * osmo_ss7_xua_server_create2(struct osmo_ss7_instance *inst, int trans_proto, enum osmo_ss7_asp_protocol proto, uint16_t local_port, const char *local_host)
create a new xUA server configured with given ip/port
Definition: osmo_ss7_xua_srv.c:199
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.c:545
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:1218
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.c:457
osmo_ss7_asp_role
Definition: osmo_ss7.h:284
@ OSMO_SS7_ASP_ROLE_SG
Definition: osmo_ss7.h:286
@ OSMO_SS7_ASP_ROLE_ASP
Definition: osmo_ss7.h:285
@ OSMO_SS7_ASP_ROLE_IPSP
Definition: osmo_ss7.h:287
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:1110
int osmo_ss7_asp_peer_del_host(struct osmo_ss7_asp_peer *peer, const char *host)
Remove address from a given ASP peer.
Definition: osmo_ss7_asp_peer.c:215
int osmo_ss7_mtp_to_user(struct osmo_ss7_instance *inst, struct osmo_mtp_prim *omp)
Definition: osmo_ss7.c:477
struct osmo_xua_server * osmo_ss7_xua_server_find2(struct osmo_ss7_instance *inst, int trans_proto, enum osmo_ss7_asp_protocol proto, uint16_t local_port)
find an xUA server with the given parameters
Definition: osmo_ss7.c:751
void osmo_ss7_instance_destroy(struct osmo_ss7_instance *inst)
Destroy a SS7 Instance.
Definition: osmo_ss7.c:372
const char * osmo_ss7_route_print(const struct osmo_ss7_route *rt)
Definition: osmo_ss7_route.c:282
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:758
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:422
int osmo_ss7_asp_peer_snprintf(char *buf, size_t buf_len, struct osmo_ss7_asp_peer *peer)
Definition: osmo_ss7_asp_peer.c:53
const struct value_string osmo_ss7_asp_role_names[]
Definition: osmo_ss7_asp.c:124
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.c:528
osmo_ss7_asp_admin_state
Definition: osmo_ss7.h:275
@ OSMO_SS7_ASP_ADM_S_SHUTDOWN
no SCTP association with peer
Definition: osmo_ss7.h:277
@ OSMO_SS7_ASP_ADM_S_BLOCKED
SCP association, but reject ASP-ACTIVE.
Definition: osmo_ss7.h:279
@ OSMO_SS7_ASP_ADM_S_ENABLED
in normal operation
Definition: osmo_ss7.h:281
uint32_t osmo_ss7_pc_normalize(const struct osmo_ss7_pc_fmt *pc_fmt, uint32_t pc)
Definition: osmo_ss7.c:172
int osmo_ss7_xua_server_set_local_hosts(struct osmo_xua_server *xs, const char **local_hosts, size_t local_host_cnt)
Definition: osmo_ss7_xua_srv.c:312
int osmo_ss7_asp_peer_add_host(struct osmo_ss7_asp_peer *peer, void *talloc_ctx, const char *host)
Append (copy) address to a given ASP peer.
Definition: osmo_ss7_asp_peer.c:260
int osmo_ss7_asp_protocol_port(enum osmo_ss7_asp_protocol prot)
Definition: osmo_ss7_asp.c:175
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.c:676
int osmo_ss7_user_mtp_xfer_req(struct osmo_ss7_instance *inst, struct osmo_mtp_prim *omp)
Definition: osmo_ss7_hmrt.c:296
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:199
void osmo_ss7_asp_destroy(struct osmo_ss7_asp *asp)
Definition: osmo_ss7_asp.c:573
struct osmo_sccp_instance * osmo_ss7_ensure_sccp(struct osmo_ss7_instance *inst)
Allocate an SCCP instance, if not present yet.
Definition: osmo_ss7.c:414
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:209
struct osmo_ss7_route * osmo_ss7_route_lookup(struct osmo_ss7_instance *inst, uint32_t dpc)
Find a SS7 route for given destination point code in given SS7.
Definition: osmo_ss7_route.c:299
osmo_ss7_as_traffic_mode
Definition: osmo_ss7.h:163
@ OSMO_SS7_AS_TMOD_OVERRIDE
Definition: osmo_ss7.h:164
@ _NUM_OSMO_SS7_ASP_TMOD
Definition: osmo_ss7.h:168
@ OSMO_SS7_AS_TMOD_ROUNDROBIN
Definition: osmo_ss7.h:167
@ OSMO_SS7_AS_TMOD_BCAST
Definition: osmo_ss7.h:165
@ OSMO_SS7_AS_TMOD_LOADSHARE
Definition: osmo_ss7.h:166
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.c:732
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:811
bool osmo_ss7_asp_active(const struct osmo_ss7_asp *asp)
Definition: osmo_ss7_asp.c:720
struct llist_head osmo_ss7_instances
int osmo_ss7_asp_restart(struct osmo_ss7_asp *asp)
Definition: osmo_ss7_asp.c:611
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:358
const char * osmo_ss7_pointcode_print2(const struct osmo_ss7_instance *inst, uint32_t pc)
Definition: osmo_ss7.c:274
uint8_t osmo_ss7_pc_width(const struct osmo_ss7_pc_fmt *pc_fmt)
Definition: osmo_ss7.c:164
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.c:242
int osmo_ss7_xua_server_del_local_host(struct osmo_xua_server *xs, const char *local_host)
Definition: osmo_ss7_xua_srv.c:335
int osmo_ss7_init(void)
Definition: osmo_ss7.c:799
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:1167
int osmo_ss7_asp_peer_set_hosts2(struct osmo_ss7_asp_peer *peer, void *talloc_ctx, const char *const *hosts, size_t host_cnt, int idx_primary)
Set (copy) addresses for a given ASP peer.
Definition: osmo_ss7_asp_peer.c:93
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.c:710
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:802
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:737
int osmo_ss7_vty_go_parent(struct vty *vty)
Definition: osmo_ss7_vty.c:2919
int osmo_ss7_xua_server_bind(struct osmo_xua_server *xs)
Set the xUA server to bind/listen to the currently configured ip/port.
Definition: osmo_ss7_xua_srv.c:273
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:183
int osmo_ss7_is_config_node(struct vty *vty, int node)
Definition: osmo_ss7_vty.c:2973
static const char * osmo_ss7_asp_protocol_name(enum osmo_ss7_asp_protocol mode)
Definition: osmo_ss7.h:190
struct osmo_ss7_instance * osmo_ss7_instance_find(uint32_t id)
Find a SS7 Instance with given ID.
Definition: osmo_ss7.c:306
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:133
const char * osmo_ss7_pointcode_print(const struct osmo_ss7_instance *inst, uint32_t pc)
Definition: osmo_ss7.c:266
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.c:662
int osmo_ss7_find_free_rctx(struct osmo_ss7_instance *inst)
Definition: osmo_ss7.c:75
static const char * osmo_ss7_as_traffic_mode_name(enum osmo_ss7_as_traffic_mode mode)
Definition: osmo_ss7.h:174
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:1209
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.c:395
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.c:597
bool osmo_ss7_as_tmode_compatible_xua(struct osmo_ss7_as *as, uint32_t m3ua_tmt)
Definition: osmo_ss7.c:853
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.c:698
int osmo_ss7_xua_server_set_local_host(struct osmo_xua_server *xs, const char *local_host)
Definition: osmo_ss7_xua_srv.c:306
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:1193
void osmo_ss7_asp_peer_init(struct osmo_ss7_asp_peer *peer)
Definition: osmo_ss7_asp_peer.c:47
void osmo_ss7_asp_disconnect(struct osmo_ss7_asp *asp)
Definition: osmo_ss7_asp.c:1155
enum osmo_ss7_as_traffic_mode osmo_ss7_tmode_from_xua(uint32_t in)
Definition: osmo_ss7.c:839
int osmo_ss7_asp_use_default_lm(struct osmo_ss7_asp *asp, int log_level)
Definition: xua_default_lm_fsm.c:413
void osmo_ss7_vty_init_asp(void *ctx)
Definition: osmo_ss7_vty.c:3107
void osmo_ss7_as_destroy(struct osmo_ss7_as *as)
Destroy given Application Server.
Definition: osmo_ss7_as.c:157
int osmo_ss7_asp_peer_set_hosts(struct osmo_ss7_asp_peer *peer, void *talloc_ctx, const char *const *hosts, size_t host_cnt)
Set (copy) addresses for a given ASP peer.
Definition: osmo_ss7_asp_peer.c:121
Definition: mtp_sap.h:56
Definition: sccp_internal.h:37
Definition: osmo_ss7.h:202
struct osmo_ss7_as::@2 cfg
struct osmo_ss7_routing_key routing_key
Definition: osmo_ss7.h:223
uint32_t recovery_timeout_msec
Definition: osmo_ss7.h:229
struct osmo_ss7_as::@2::@3 pc_override
struct llist_head list
entry in 'ref osmo_ss7_instance.as_list
Definition: osmo_ss7.h:204
char * description
Definition: osmo_ss7.h:221
bool rkm_dyn_allocated
Were we dynamically allocated by RKM?
Definition: osmo_ss7.h:211
struct rate_ctr_group * ctrg
Rate Counter Group.
Definition: osmo_ss7.h:217
struct osmo_ss7_asp * asps[16]
Definition: osmo_ss7.h:236
uint8_t last_asp_idx_sent
Definition: osmo_ss7.h:237
char * name
Definition: osmo_ss7.h:220
bool mode_set_by_vty
Definition: osmo_ss7.h:226
struct osmo_fsm_inst * fi
AS FSM.
Definition: osmo_ss7.h:208
bool simple_client_allocated
Were we allocated by "simple client" support?
Definition: osmo_ss7.h:214
uint32_t dpc
Definition: osmo_ss7.h:232
enum osmo_ss7_as_traffic_mode mode
Definition: osmo_ss7.h:224
enum osmo_ss7_asp_protocol proto
Definition: osmo_ss7.h:222
enum osmo_ss7_as_patch_sccp_mode sccp_mode
Definition: osmo_ss7.h:233
struct osmo_ss7_instance * inst
Definition: osmo_ss7.h:205
bool mode_set_by_peer
Definition: osmo_ss7.h:228
uint8_t qos_class
Definition: osmo_ss7.h:230
Definition: osmo_ss7.h:267
size_t host_cnt
Definition: osmo_ss7.h:269
uint16_t port
Definition: osmo_ss7.h:270
char * host[OSMO_SOCK_MAX_ADDRS]
Definition: osmo_ss7.h:268
int idx_primary
Definition: osmo_ss7.h:272
Definition: osmo_ss7.h:292
enum osmo_ss7_asp_role role
Definition: osmo_ss7.h:336
char * sock_name
pre-formatted human readable local/remote socket name
Definition: osmo_ss7.h:308
bool role_set_by_vty
Definition: osmo_ss7.h:337
struct osmo_ss7_asp_peer remote
Definition: osmo_ss7.h:341
bool max_attempts_present
Definition: osmo_ss7.h:351
bool max_instreams_present
Definition: osmo_ss7.h:350
struct osmo_tdef * T_defs_lm
Definition: osmo_ss7.h:346
struct osmo_fsm_inst * fi
ASP FSM.
Definition: osmo_ss7.h:298
uint16_t max_attempts_value
Definition: osmo_ss7.h:355
uint16_t max_instreams_value
Definition: osmo_ss7.h:354
struct llist_head list
entry in osmo_ss7_instance::asp_list
Definition: osmo_ss7.h:294
enum osmo_ss7_asp_protocol proto
Definition: osmo_ss7.h:333
void * lm_priv
Definition: osmo_ss7.h:316
struct osmo_ss7_instance * inst
Definition: osmo_ss7.h:295
const struct osmo_xua_layer_manager * lm
Definition: osmo_ss7.h:315
bool num_ostreams_present
Definition: osmo_ss7.h:349
struct osmo_stream_srv * server
Definition: osmo_ss7.h:306
uint32_t quirks
Definition: osmo_ss7.h:343
bool simple_client_allocated
Were we allocated by "simple client" support?
Definition: osmo_ss7.h:322
struct osmo_stream_cli * client
osmo_stream / libosmo-netif handles
Definition: osmo_ss7.h:305
bool trans_role_set_by_vty
Definition: osmo_ss7.h:338
enum osmo_ss7_asp_admin_state adm_state
Definition: osmo_ss7.h:334
struct osmo_xua_server * xua_server
osmo_xua_server over which we were established
Definition: osmo_ss7.h:301
struct osmo_ss7_asp_peer local
Definition: osmo_ss7.h:340
struct osmo_ss7_asp::@4 cfg
bool is_server
Definition: osmo_ss7.h:335
bool dyn_allocated
Were we dynamically allocated.
Definition: osmo_ss7.h:319
bool max_init_timeo_present
Definition: osmo_ss7.h:352
char * name
Definition: osmo_ss7.h:331
uint8_t qos_class
Definition: osmo_ss7.h:342
struct msgb * pending_msg
Pending message for non-blocking IPA read.
Definition: osmo_ss7.h:328
uint32_t asp_id
Definition: osmo_ss7.h:311
uint16_t num_ostreams_value
Definition: osmo_ss7.h:353
struct osmo_ss7_asp::@4::@5 sctp_init
int trans_proto
The underlaying transport protocol (one of IPPROTO_*)
Definition: osmo_ss7.h:360
char * description
Definition: osmo_ss7.h:332
bool asp_id_present
Definition: osmo_ss7.h:312
struct rate_ctr_group * ctrg
Rate Counter Group.
Definition: osmo_ss7.h:325
struct llist_head siblings
Definition: osmo_ss7.h:302
uint16_t max_init_timeo_value
Definition: osmo_ss7.h:356
Definition: osmo_ss7.h:50
struct osmo_sccp_instance * sccp
Definition: osmo_ss7.h:69
uint32_t secondary_pc
Definition: osmo_ss7.h:81
struct osmo_ss7_route_table * rtable_system
Definition: osmo_ss7.h:67
struct llist_head linksets
list of osmo_ss7_linkset
Definition: osmo_ss7.h:54
char * name
Definition: osmo_ss7.h:73
struct osmo_ss7_instance::@1 cfg
uint32_t primary_pc
Definition: osmo_ss7.h:75
struct osmo_ss7_pc_fmt pc_fmt
Definition: osmo_ss7.h:78
struct llist_head as_list
list of osmo_ss7_as
Definition: osmo_ss7.h:56
struct llist_head rtable_list
list of osmo_ss7_route_table
Definition: osmo_ss7.h:60
uint8_t network_indicator
Definition: osmo_ss7.h:77
char * description
Definition: osmo_ss7.h:74
uint32_t id
Definition: osmo_ss7.h:72
struct llist_head asp_list
list of osmo_ss7_asp
Definition: osmo_ss7.h:58
const struct osmo_ss7_user * user[16]
Definition: osmo_ss7.h:65
bool permit_dyn_rkm_alloc
Definition: osmo_ss7.h:79
struct llist_head sccp_address_book
Definition: osmo_ss7.h:80
struct llist_head list
member of global list of instances
Definition: osmo_ss7.h:52
struct llist_head xua_servers
list of osmo_xua_servers
Definition: osmo_ss7.h:62
Definition: ss7_linkset.h:13
Definition: osmo_ss7.h:45
char delimiter
Definition: osmo_ss7.h:46
uint8_t component_len[3]
Definition: osmo_ss7.h:47
Definition: ss7_route_table.h:12
struct osmo_ss7_instance * inst
osmo_ss7_instance to which we belong
Definition: ss7_route_table.h:16
Definition: ss7_route.h:17
Definition: osmo_ss7.h:153
uint8_t si
Definition: osmo_ss7.h:158
uint32_t context
Definition: osmo_ss7.h:154
uint32_t l_rk_id
Definition: osmo_ss7.h:155
uint32_t ssn
Definition: osmo_ss7.h:159
uint32_t pc
Definition: osmo_ss7.h:157
Definition: osmo_ss7.h:101
const char * name
Definition: osmo_ss7.h:105
osmo_prim_cb prim_cb
Definition: osmo_ss7.h:107
void * priv
Definition: osmo_ss7.h:109
struct osmo_ss7_instance * inst
Definition: osmo_ss7.h:103
Definition: osmo_ss7.h:430
osmo_prim_cb prim_cb
Definition: osmo_ss7.h:431
Definition: osmo_ss7.h:434
struct osmo_stream_srv_link * server
Definition: osmo_ss7.h:441
uint16_t max_instreams_value
Definition: osmo_ss7.h:451
enum osmo_ss7_asp_protocol proto
Definition: osmo_ss7.h:446
bool num_ostreams_present
Definition: osmo_ss7.h:448
struct osmo_ss7_instance * inst
Definition: osmo_ss7.h:436
struct llist_head asp_list
Definition: osmo_ss7.h:439
struct osmo_xua_server::@6 cfg
struct osmo_xua_server::@6::@7 sctp_init
bool accept_dyn_reg
Definition: osmo_ss7.h:444
uint16_t num_ostreams_value
Definition: osmo_ss7.h:450
struct llist_head list
Definition: osmo_ss7.h:435
struct osmo_ss7_asp_peer local
Definition: osmo_ss7.h:445
bool max_instreams_present
Definition: osmo_ss7.h:449
int trans_proto
The underlaying transport protocol (one of IPPROTO_*)
Definition: osmo_ss7.h:455