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 
14 extern struct llist_head osmo_ss7_instances;
15 
16 struct osmo_ss7_instance;
17 struct osmo_ss7_user;
18 struct osmo_sccp_instance;
19 struct osmo_mtp_prim;
22 
23 int osmo_ss7_init(void);
25 
26 bool osmo_ss7_pc_is_local(const struct osmo_ss7_instance *inst, uint32_t pc);
27 int osmo_ss7_pointcode_parse(const struct osmo_ss7_instance *inst, const char *str);
28 int osmo_ss7_pointcode_parse_mask_or_len(const struct osmo_ss7_instance *inst, const char *in);
29 const char *osmo_ss7_pointcode_print_buf(char *buf, size_t buf_len, const struct osmo_ss7_instance *inst, uint32_t pc);
30 const char *osmo_ss7_pointcode_print(const struct osmo_ss7_instance *inst, uint32_t pc);
31 const 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
36 static inline bool osmo_ss7_pc_is_valid(uint32_t pc)
37 {
38  return pc <= 0x00ffffff;
39 }
40 
41 /***********************************************************************
42  * SS7 Instances
43  ***********************************************************************/
44 
46  char delimiter;
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;
74  char *description;
75  uint32_t primary_pc;
76  /* capability PCs */
78  struct osmo_ss7_pc_fmt pc_fmt;
80  struct llist_head sccp_address_book;
81  uint32_t secondary_pc;
82  } cfg;
83 };
84 
85 struct osmo_ss7_instance *osmo_ss7_instance_find(uint32_t id);
86 struct osmo_ss7_instance *
87 osmo_ss7_instance_find_or_create(void *ctx, uint32_t id);
90  uint8_t c0, uint8_t c1, uint8_t c2);
91 
93 
94 uint8_t osmo_ss7_pc_width(const struct osmo_ss7_pc_fmt *pc_fmt);
95 uint32_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 
112 int osmo_ss7_user_register(struct osmo_ss7_instance *inst, uint8_t service_ind,
113  struct osmo_ss7_user *user);
114 
115 int osmo_ss7_user_unregister(struct osmo_ss7_instance *inst, uint8_t service_ind,
116  struct osmo_ss7_user *user);
117 
118 int 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 
128 struct osmo_ss7_link;
129 
130 /***********************************************************************
131  * SS7 Linksets
132  ***********************************************************************/
133 
134 struct osmo_ss7_linkset;
135 
136 /***********************************************************************
137  * SS7 Routes
138  ***********************************************************************/
139 
140 struct osmo_ss7_route;
141 
142 struct osmo_ss7_route *
143 osmo_ss7_route_lookup(struct osmo_ss7_instance *inst, uint32_t dpc);
144 const char *osmo_ss7_route_print(const struct osmo_ss7_route *rt);
145 const char *osmo_ss7_route_name(struct osmo_ss7_route *rt, bool list_asps);
146 struct 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 */
169 };
170 
171 extern struct value_string osmo_ss7_as_traffic_mode_vals[];
172 
173 static inline const char *
175 {
176  return get_value_string(osmo_ss7_as_traffic_mode_vals, mode);
177 }
178 
185 };
186 
187 extern struct value_string osmo_ss7_asp_protocol_vals[];
188 
189 static 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 
202 struct osmo_ss7_as {
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;
221  char *description;
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) */
238  } cfg;
239 };
240 
241 struct osmo_ss7_as *
243 struct osmo_ss7_as *
244 osmo_ss7_as_find_by_rctx(struct osmo_ss7_instance *inst, uint32_t rctx);
245 struct osmo_ss7_as *
246 osmo_ss7_as_find_by_l_rk_id(struct osmo_ss7_instance *inst, uint32_t l_rk_id);
249 struct osmo_ss7_as *
252 int osmo_ss7_as_add_asp(struct osmo_ss7_as *as, const char *asp_name);
253 int osmo_ss7_as_del_asp(struct osmo_ss7_as *as, const char *asp_name);
254 void osmo_ss7_as_destroy(struct osmo_ss7_as *as);
255 bool osmo_ss7_as_has_asp(const struct osmo_ss7_as *as,
256  const struct osmo_ss7_asp *asp);
257 bool osmo_ss7_as_down(const struct osmo_ss7_as *as);
258 bool osmo_ss7_as_active(const struct osmo_ss7_as *as);
259 bool osmo_ss7_as_tmode_compatible_xua(struct osmo_ss7_as *as, uint32_t m3ua_tmt);
260 void 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 
290 extern const struct value_string osmo_ss7_asp_role_names[];
291 
292 struct osmo_ss7_asp {
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;
308  char *sock_name;
309 
310  /* ASP Identifier for ASP-UP + NTFY */
311  uint32_t asp_id;
313 
314  /* Layer Manager to which we talk */
315  const struct osmo_xua_layer_manager *lm;
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;
332  char *description;
335  bool is_server;
336  enum osmo_ss7_asp_role role;
339 
340  struct osmo_ss7_asp_peer local;
341  struct osmo_ss7_asp_peer remote;
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 
361  } cfg;
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 
371 int osmo_ss7_asp_peer_snprintf(char* buf, size_t buf_len, struct osmo_ss7_asp_peer *peer);
372 void osmo_ss7_asp_peer_init(struct osmo_ss7_asp_peer *peer);
373 int osmo_ss7_asp_peer_set_hosts(struct osmo_ss7_asp_peer *peer, void *talloc_ctx,
374  const char *const*hosts, size_t host_cnt);
375 int 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);
377 int osmo_ss7_asp_peer_add_host(struct osmo_ss7_asp_peer *peer, void *talloc_ctx, const char *host);
378 int osmo_ss7_asp_peer_add_host2(struct osmo_ss7_asp_peer *peer, void *talloc_ctx, const char *host, bool is_primary_addr);
379 int osmo_ss7_asp_peer_del_host(struct osmo_ss7_asp_peer *peer, const char *host);
380 
381 
382 struct osmo_ss7_asp *
384 struct osmo_ss7_asp *
387 struct osmo_ss7_asp *
388 osmo_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");
392 struct osmo_ss7_asp *
393 osmo_ss7_asp_find2(struct osmo_ss7_instance *inst, const char *name,
394  uint16_t remote_port, uint16_t local_port,
396 struct osmo_ss7_asp *
398  uint16_t remote_port, uint16_t local_port,
400  OSMO_DEPRECATED("Use osmo_ss7_asp_find_or_create2() instead");
401 struct osmo_ss7_asp *
403  uint16_t remote_port, uint16_t local_port,
405 void osmo_ss7_asp_destroy(struct osmo_ss7_asp *asp);
406 int osmo_ss7_asp_send(struct osmo_ss7_asp *asp, struct msgb *msg);
407 int osmo_ss7_asp_restart(struct osmo_ss7_asp *asp);
408 int osmo_ss7_asp_use_default_lm(struct osmo_ss7_asp *asp, int log_level);
409 bool osmo_ss7_asp_active(const struct osmo_ss7_asp *asp);
410 int osmo_ss7_asp_get_log_subsys(const struct osmo_ss7_asp *asp);
411 const char *osmo_ss7_asp_get_name(const struct osmo_ss7_asp *asp);
413 int osmo_ss7_asp_get_trans_proto(const struct osmo_ss7_asp *asp);
414 
422 typedef 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 {
445  struct osmo_ss7_asp_peer local;
447  struct {
453 
456  } cfg;
457 };
458 
459 struct osmo_xua_server *
462  uint16_t local_port)
463  OSMO_DEPRECATED("Use osmo_ss7_xua_server_find2() instead");
464 struct osmo_xua_server *
466  int trans_proto,
468  uint16_t local_port);
469 
470 struct osmo_xua_server *
473  uint16_t local_port, const char *local_host)
474  OSMO_DEPRECATED("Use osmo_ss7_xua_server_create2() instead");
475 struct osmo_xua_server *
478  uint16_t local_port, const char *local_host);
479 
480 int
482 
483 int
484 osmo_ss7_xua_server_set_local_host(struct osmo_xua_server *xs, const char *local_host);
485 int
486 osmo_ss7_xua_server_set_local_hosts(struct osmo_xua_server *xs, const char **local_hosts, size_t local_host_cnt);
487 int osmo_ss7_xua_server_add_local_host(struct osmo_xua_server *xs, const char *local_host);
488 int osmo_ss7_xua_server_del_local_host(struct osmo_xua_server *xs, const char *local_host);
490 
491 struct osmo_sccp_instance *
492 osmo_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 
497 struct osmo_sccp_instance *
498 osmo_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 
506 struct osmo_sccp_instance *
507 osmo_sccp_simple_server(void *ctx, uint32_t pc,
508  enum osmo_ss7_asp_protocol prot, int local_port,
509  const char *local_ip);
510 
511 struct osmo_sccp_instance *
512 osmo_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 
516 struct 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 
523 void osmo_sccp_set_max_optional_data(struct osmo_sccp_instance *inst, int val);
524 
527 
528 /* VTY related */
529 struct vty;
530 void osmo_ss7_vty_init_asp(void *ctx);
531 void osmo_ss7_vty_init_sg(void *ctx);
532 int osmo_ss7_vty_go_parent(struct vty *vty);
533 int osmo_ss7_is_config_node(struct vty *vty, int node);
uint32_t dpc
Definition: m3ua.h:1
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
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
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
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
const char * osmo_ss7_pointcode_print2(const struct osmo_ss7_instance *inst, uint32_t pc)
Definition: osmo_ss7.c:274
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
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
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
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_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
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
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
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_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_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
void osmo_ss7_instance_destroy(struct osmo_ss7_instance *inst)
Destroy a SS7 Instance.
Definition: osmo_ss7.c:372
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
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
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
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
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
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_sccp_instance * osmo_ss7_ensure_sccp(struct osmo_ss7_instance *inst)
Allocate an SCCP instance, if not present yet.
Definition: osmo_ss7.c:414
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_instance * osmo_ss7_instance_find_or_create(void *ctx, uint32_t id)
Find or create a SS7 Instance.
Definition: osmo_ss7.c:358
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
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
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
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
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
uint8_t osmo_ss7_pc_width(const struct osmo_ss7_pc_fmt *pc_fmt)
Definition: osmo_ss7.c:164
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
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
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
struct osmo_ss7_asp * osmo_ss7_asp_find_by_name(struct osmo_ss7_instance *inst, const char *name)
Definition: osmo_ss7.c:645
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
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_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_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
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
static const char * osmo_ss7_asp_protocol_name(enum osmo_ss7_asp_protocol mode)
Definition: osmo_ss7.h:190
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
const char * osmo_ss7_route_print(const struct osmo_ss7_route *rt)
Definition: osmo_ss7_route.c:282
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_as_del_asp(struct osmo_ss7_as *as, const char *asp_name)
Delete given ASP from given AS.
Definition: osmo_ss7_as.c:133
struct osmo_ss7_instance * osmo_ss7_instance_find(uint32_t id)
Find a SS7 Instance with given ID.
Definition: osmo_ss7.c:306
const char * osmo_ss7_pointcode_print(const struct osmo_ss7_instance *inst, uint32_t pc)
Definition: osmo_ss7.c:266
int osmo_ss7_find_free_rctx(struct osmo_ss7_instance *inst)
Definition: osmo_ss7.c:75
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
static const char * osmo_ss7_as_traffic_mode_name(enum osmo_ss7_as_traffic_mode mode)
Definition: osmo_ss7.h:174
bool osmo_ss7_as_tmode_compatible_xua(struct osmo_ss7_as *as, uint32_t m3ua_tmt)
Definition: osmo_ss7.c:853
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
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
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
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
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
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
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
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