libosmo-sigtran 2.1.0.201-feb1 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/* Maximum number of supported RCTXs present in RFC4666 Routing Context IE. */
15#define OSMO_SS7_MAX_RCTX_COUNT 128
16
17 struct osmo_ss7_instance;
18
19 extern struct llist_head osmo_ss7_instances;
20/* Get an entry pointer from a list item in osmo_ss7_instances: */
21 struct osmo_ss7_instance *osmo_ss7_instances_llist_entry(struct llist_head *list);
22
23 int osmo_ss7_init(void);
24
25/* All known point-code formats have a length of or below 24 bit.
26 * A point-code value exceeding that is used to indicate an unset PC. */
27#define OSMO_SS7_PC_INVALID 0xffffffff
28 static inline bool osmo_ss7_pc_is_valid(uint32_t pc)
29{
30 return pc <= 0x00ffffff;
31}
32
33/***********************************************************************
34 * xUA Servers
35 ***********************************************************************/
36
37 struct osmo_xua_layer_manager;
38
39 struct osmo_xua_server;
40
41/***********************************************************************
42 * SS7 Instances
43 ***********************************************************************/
44
45 struct osmo_ss7_pc_fmt;
46 struct osmo_ss7_instance;
47
48 struct osmo_ss7_instance *osmo_ss7_instance_find(uint32_t id);
49 struct osmo_ss7_instance *
50 osmo_ss7_instance_find_or_create(void *ctx, uint32_t id);
51 void osmo_ss7_instance_destroy(struct osmo_ss7_instance *inst);
52
53uint32_t osmo_ss7_instance_get_id(const struct osmo_ss7_instance *inst);
54 const char *osmo_ss7_instance_get_name(const struct osmo_ss7_instance *inst);
55
56 int osmo_ss7_instance_set_pc_fmt(struct osmo_ss7_instance *inst,
57 uint8_t c0, uint8_t c1, uint8_t c2);
58 const struct osmo_ss7_pc_fmt *
59 osmo_ss7_instance_get_pc_fmt(const struct osmo_ss7_instance *inst);
60
61uint32_t osmo_ss7_instance_get_primary_pc(const struct osmo_ss7_instance *inst);
62uint8_t osmo_ss7_instance_get_network_indicator(const struct osmo_ss7_instance *inst);
63
64 struct osmo_sccp_instance *osmo_ss7_ensure_sccp(struct osmo_ss7_instance *inst);
65 struct osmo_sccp_instance *osmo_ss7_get_sccp(const struct osmo_ss7_instance *inst);
66
67 int osmo_ss7_find_free_rctx(struct osmo_ss7_instance *inst);
68
69 bool osmo_ss7_pc_is_local(const struct osmo_ss7_instance *inst, uint32_t pc);
70 int osmo_ss7_pointcode_parse(const struct osmo_ss7_instance *inst, const char *str);
71 int osmo_ss7_pointcode_parse_mask_or_len(const struct osmo_ss7_instance *inst, const char *in);
72 const char *osmo_ss7_pointcode_print_buf(char *buf, size_t buf_len, const struct osmo_ss7_instance *inst, uint32_t pc);
73 const char *osmo_ss7_pointcode_print(const struct osmo_ss7_instance *inst, uint32_t pc);
74 const char *osmo_ss7_pointcode_print2(const struct osmo_ss7_instance *inst, uint32_t pc);
75
76uint8_t osmo_ss7_pc_width(const struct osmo_ss7_pc_fmt *pc_fmt);
77uint32_t osmo_ss7_pc_normalize(const struct osmo_ss7_pc_fmt *pc_fmt, uint32_t pc);
78
79/***********************************************************************
80 * MTP Users (Users of MTP, such as SCCP or ISUP)
81 ***********************************************************************/
82
83 struct osmo_ss7_user;
84 struct osmo_mtp_prim;
85
86
87 struct osmo_ss7_user *osmo_ss7_user_create(struct osmo_ss7_instance *inst, const char *name);
88 void osmo_ss7_user_destroy(struct osmo_ss7_user *user);
89
90 struct osmo_ss7_instance *osmo_ss7_user_get_instance(const struct osmo_ss7_user *user);
91 void osmo_ss7_user_set_prim_cb(struct osmo_ss7_user *user, osmo_prim_cb prim_cb);
92 void osmo_ss7_user_set_priv(struct osmo_ss7_user *user, void *priv);
93 void *osmo_ss7_user_get_priv(const struct osmo_ss7_user *user);
94
95 int osmo_ss7_user_register(struct osmo_ss7_user *user, uint8_t service_ind);
96 int osmo_ss7_user_unregister(struct osmo_ss7_user *user, uint8_t service_ind);
97
98 struct osmo_ss7_user *osmo_ss7_user_find_by_si(const struct osmo_ss7_instance *inst, uint8_t service_indicator);
99
100/* MTP User wants to submit a primitive down to MTP SAP */
101 int osmo_ss7_user_mtp_sap_prim_down(struct osmo_ss7_user *user,
102 struct osmo_mtp_prim *omp);
103
104/***********************************************************************
105 * SCCP Instance
106 ***********************************************************************/
107
108 struct osmo_sccp_instance;
109
110 void osmo_sccp_set_max_optional_data(struct osmo_sccp_instance *inst, int val);
111
112/***********************************************************************
113 * SS7 Links
114 ***********************************************************************/
115
116 struct osmo_ss7_link;
117
118/***********************************************************************
119 * SS7 Linksets
120 ***********************************************************************/
121
122 struct osmo_ss7_linkset;
123
124/***********************************************************************
125 * SS7 Routes
126 ***********************************************************************/
127
128 struct osmo_ss7_route;
129
130 struct osmo_ss7_route *
131 osmo_ss7_route_lookup(struct osmo_ss7_instance *inst, uint32_t dpc)
132 OSMO_DEPRECATED("Use internal ss7_instance_lookup_route() instead");
133 const char *osmo_ss7_route_print(const struct osmo_ss7_route *rt);
134 const char *osmo_ss7_route_name(struct osmo_ss7_route *rt, bool list_asps);
135 struct osmo_ss7_as *
136 osmo_ss7_route_get_dest_as(struct osmo_ss7_route *rt);
137
138/***********************************************************************
139 * SS7 Routing key
140 ***********************************************************************/
141
142 struct osmo_ss7_routing_key {
143 uint32_t context;
144 uint32_t l_rk_id;
145
146 uint32_t pc;
147 uint8_t si;
148 uint32_t ssn;
149 /* FIXME: more complex routing keys */
150};
151
152
153/***********************************************************************
154 * SS7 ASP Protocols
155 ***********************************************************************/
156
157 enum osmo_ss7_asp_protocol {
158 OSMO_SS7_ASP_PROT_NONE,
159 OSMO_SS7_ASP_PROT_SUA,
160 OSMO_SS7_ASP_PROT_M3UA,
161 OSMO_SS7_ASP_PROT_IPA,
162 _NUM_OSMO_SS7_ASP_PROT
163};
164
165 extern struct value_string osmo_ss7_asp_protocol_vals[];
166 static inline const char *
167 osmo_ss7_asp_protocol_name(enum osmo_ss7_asp_protocol mode)
168{
169 return get_value_string(osmo_ss7_asp_protocol_vals, mode);
170}
171
172 int osmo_ss7_asp_protocol_port(enum osmo_ss7_asp_protocol prot);
173
174
175/***********************************************************************
176 * SS7 AS Traffic Mode
177 ***********************************************************************/
178
179 /* Traffic mode implementations which can be configured on an AS, either by
180 * peer (eg. RFC4666 M3UA "Traffic Mode Type") or locally through VTY.
181 * Note: This is related but not exactly RFC4666 M3UA "Traffic Mode Type" (enum
182 * m3ua_traffic_mode). */
183 enum osmo_ss7_as_traffic_mode {
184 /* RFC4666 M3UA "Traffic Mode Type" "Override". Default traffic mode: */
185 OSMO_SS7_AS_TMOD_OVERRIDE = 0,
186 /* RFC4666 M3UA "Traffic Mode Type" "Broadcast": */
187 OSMO_SS7_AS_TMOD_BCAST,
188 /* RFC4666 M3UA "Traffic Mode Type" "Loadshare",
189 * traffic distribution based on OPC+SLS: */
190 OSMO_SS7_AS_TMOD_LOADSHARE,
191 /* RFC4666 M3UA "Traffic Mode Type" "Loadshare",
192 * traffic distribution implemented as round-robin: */
193 OSMO_SS7_AS_TMOD_ROUNDROBIN,
194 _NUM_OSMO_SS7_ASP_TMOD
195};
196
197 extern struct value_string osmo_ss7_as_traffic_mode_vals[];
198
199 static inline const char *
200 osmo_ss7_as_traffic_mode_name(enum osmo_ss7_as_traffic_mode mode)
201{
202 return get_value_string(osmo_ss7_as_traffic_mode_vals, mode);
203}
204
205 enum osmo_ss7_as_traffic_mode osmo_ss7_tmode_from_xua(uint32_t in);
206 int osmo_ss7_tmode_to_xua(enum osmo_ss7_as_traffic_mode tmod);
207
208
209/***********************************************************************
210 * SS7 Application Servers
211 ***********************************************************************/
212
213 struct osmo_ss7_as;
214 struct osmo_ss7_asp;
215
216 struct osmo_ss7_as *
217 osmo_ss7_as_find_by_name(struct osmo_ss7_instance *inst, const char *name);
218 struct osmo_ss7_as *
219 osmo_ss7_as_find_by_rctx(struct osmo_ss7_instance *inst, uint32_t rctx);
220 struct osmo_ss7_as *
221 osmo_ss7_as_find_by_l_rk_id(struct osmo_ss7_instance *inst, uint32_t l_rk_id);
222 struct osmo_ss7_as *osmo_ss7_as_find_by_proto(struct osmo_ss7_instance *inst,
223 enum osmo_ss7_asp_protocol proto);
224 struct osmo_ss7_as *
225 osmo_ss7_as_find_or_create(struct osmo_ss7_instance *inst, const char *name,
226 enum osmo_ss7_asp_protocol proto);
227 enum osmo_ss7_asp_protocol osmo_ss7_as_get_asp_protocol(const struct osmo_ss7_as *as);
228 int osmo_ss7_as_add_asp(struct osmo_ss7_as *as, const char *asp_name);
229 int osmo_ss7_as_del_asp(struct osmo_ss7_as *as, const char *asp_name);
230 void osmo_ss7_as_destroy(struct osmo_ss7_as *as);
231 bool osmo_ss7_as_has_asp(const struct osmo_ss7_as *as,
232 const struct osmo_ss7_asp *asp);
233 struct osmo_ss7_asp *osmo_ss7_as_select_asp(struct osmo_ss7_as *as);
234 bool osmo_ss7_as_down(const struct osmo_ss7_as *as);
235 bool osmo_ss7_as_active(const struct osmo_ss7_as *as);
236 bool osmo_ss7_as_tmode_compatible_xua(struct osmo_ss7_as *as, uint32_t m3ua_tmt);
237
238
239/***********************************************************************
240 * SS7 Application Server Processes
241 ***********************************************************************/
242
243 enum osmo_ss7_asp_admin_state {
245 OSMO_SS7_ASP_ADM_S_SHUTDOWN,
247 OSMO_SS7_ASP_ADM_S_BLOCKED,
249 OSMO_SS7_ASP_ADM_S_ENABLED,
250};
251 extern const struct value_string osmo_ss7_asp_admin_state_names[];
252
253 enum osmo_ss7_asp_role {
254 OSMO_SS7_ASP_ROLE_ASP,
255 OSMO_SS7_ASP_ROLE_SG,
256 OSMO_SS7_ASP_ROLE_IPSP,
257};
258
259 extern const struct value_string osmo_ss7_asp_role_names[];
260
261 struct osmo_ss7_asp;
262
264#define OSMO_SS7_ASP_QUIRK_NO_NOTIFY 0x00000001
266#define OSMO_SS7_ASP_QUIRK_DAUD_IN_ASP 0x00000002
268#define OSMO_SS7_ASP_QUIRK_SNM_INACTIVE 0x00000004
269
270
271 struct osmo_ss7_asp *
272 osmo_ss7_asp_find_by_name(struct osmo_ss7_instance *inst, const char *name);
273 struct osmo_ss7_asp *
274 osmo_ss7_asp_find_by_proto(struct osmo_ss7_as *as,
275 enum osmo_ss7_asp_protocol proto);
276 struct osmo_ss7_asp *
277 osmo_ss7_asp_find(struct osmo_ss7_instance *inst, const char *name,
278 uint16_t remote_port, uint16_t local_port,
279 enum osmo_ss7_asp_protocol proto)
280 OSMO_DEPRECATED("Use osmo_ss7_asp_find2() instead");
281 struct osmo_ss7_asp *
282 osmo_ss7_asp_find2(struct osmo_ss7_instance *inst, const char *name,
283 uint16_t remote_port, uint16_t local_port,
284 int trans_proto, enum osmo_ss7_asp_protocol proto);
285 struct osmo_ss7_asp *
286 osmo_ss7_asp_find_or_create(struct osmo_ss7_instance *inst, const char *name,
287 uint16_t remote_port, uint16_t local_port,
288 enum osmo_ss7_asp_protocol proto)
289 OSMO_DEPRECATED("Use osmo_ss7_asp_find_or_create2() instead");
290 struct osmo_ss7_asp *
291 osmo_ss7_asp_find_or_create2(struct osmo_ss7_instance *inst, const char *name,
292 uint16_t remote_port, uint16_t local_port,
293 int trans_proto, enum osmo_ss7_asp_protocol proto);
294 void osmo_ss7_asp_disconnect(struct osmo_ss7_asp *asp);
295 void osmo_ss7_asp_destroy(struct osmo_ss7_asp *asp);
296 int osmo_ss7_asp_send(struct osmo_ss7_asp *asp, struct msgb *msg);
297 int osmo_ss7_asp_restart(struct osmo_ss7_asp *asp);
298 int osmo_ss7_asp_use_default_lm(struct osmo_ss7_asp *asp, int log_level);
299 bool osmo_ss7_asp_active(const struct osmo_ss7_asp *asp);
300 int osmo_ss7_asp_get_log_subsys(const struct osmo_ss7_asp *asp);
301 const char *osmo_ss7_asp_get_name(const struct osmo_ss7_asp *asp);
302 enum osmo_ss7_asp_protocol osmo_ss7_asp_get_proto(const struct osmo_ss7_asp *asp);
303 int osmo_ss7_asp_get_trans_proto(const struct osmo_ss7_asp *asp);
304
312 typedef int osmo_ss7_asp_rx_unknown_cb(struct osmo_ss7_asp *asp, int ppid_mux, struct msgb *msg);
313
314 void osmo_ss7_register_rx_unknown_cb(osmo_ss7_asp_rx_unknown_cb *cb);
315
316
317/***********************************************************************
318 * Simple Client
319 ***********************************************************************/
320
321 struct osmo_sccp_instance *
322 osmo_sccp_simple_client(void *ctx, const char *name, uint32_t default_pc,
323 enum osmo_ss7_asp_protocol prot, int default_local_port,
324 const char *default_local_ip, int default_remote_port,
325 const char *default_remote_ip);
326
327 struct osmo_sccp_instance *
328 osmo_sccp_simple_client_on_ss7_id(void *ctx, uint32_t ss7_id, const char *name,
329 uint32_t default_pc,
330 enum osmo_ss7_asp_protocol prot,
331 int default_local_port,
332 const char *default_local_ip,
333 int default_remote_port,
334 const char *default_remote_ip);
335
336/***********************************************************************
337 * Simple Server
338 ***********************************************************************/
339
340 struct osmo_sccp_instance *
341 osmo_sccp_simple_server(void *ctx, uint32_t pc,
342 enum osmo_ss7_asp_protocol prot, int local_port,
343 const char *local_ip);
344
345 struct osmo_sccp_instance *
346 osmo_sccp_simple_server_on_ss7_id(void *ctx, uint32_t ss7_id, uint32_t pc,
347 enum osmo_ss7_asp_protocol prot,
348 int local_port, const char *local_ip);
349
350 struct osmo_sccp_instance *
351 osmo_sccp_simple_server_add_clnt(struct osmo_sccp_instance *inst,
352 enum osmo_ss7_asp_protocol prot,
353 const char *name, uint32_t pc,
354 int local_port, int remote_port,
355 const char *remote_ip);
356
357/* VTY related */
358 struct vty;
359 void osmo_ss7_vty_init_asp(void *ctx);
360 void osmo_ss7_vty_init_sg(void *ctx);
361 int osmo_ss7_vty_go_parent(struct vty *vty);
362 int osmo_ss7_is_config_node(struct vty *vty, int node)
363 OSMO_DEPRECATED("Implicit parent node tracking has replaced the use of this callback. "
364 "This callback is no longer called, ever, and can be left NULL.");
dpc
uint32_t dpc
Definition: m3ua.h:1
osmo_ss7_route_get_dest_as
struct osmo_ss7_as * osmo_ss7_route_get_dest_as(struct osmo_ss7_route *rt)
Get destination AS of route.
Definition: ss7_route.c:377
osmo_ss7_as_add_asp
int osmo_ss7_as_add_asp(struct osmo_ss7_as *as, const char *asp_name)
Add given ASP to given AS.
Definition: ss7_as.c:181
osmo_ss7_as_find_by_name
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: ss7_instance.c:250
osmo_ss7_pointcode_parse_mask_or_len
int osmo_ss7_pointcode_parse_mask_or_len(const struct osmo_ss7_instance *inst, const char *in)
Definition: ss7_instance.c:623
osmo_sccp_set_max_optional_data
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_instance.c:974
osmo_ss7_pc_is_local
bool osmo_ss7_pc_is_local(const struct osmo_ss7_instance *inst, uint32_t pc)
Definition: ss7_instance.c:199
osmo_ss7_asp_get_trans_proto
int osmo_ss7_asp_get_trans_proto(const struct osmo_ss7_asp *asp)
Get the transport proto of a given ASP.
Definition: ss7_asp.c:1499
osmo_ss7_user_get_priv
void * osmo_ss7_user_get_priv(const struct osmo_ss7_user *user)
Definition: ss7_user.c:79
osmo_ss7_vty_init_sg
void osmo_ss7_vty_init_sg(void *ctx)
Definition: ss7_vty.c:1480
osmo_ss7_instance_get_primary_pc
uint32_t osmo_ss7_instance_get_primary_pc(const struct osmo_ss7_instance *inst)
Definition: ss7_instance.c:143
osmo_ss7_pc_is_valid
static bool osmo_ss7_pc_is_valid(uint32_t pc)
Definition: osmo_ss7.h:28
osmo_ss7_route_name
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: ss7_route.c:297
osmo_ss7_user_create
struct osmo_ss7_user * osmo_ss7_user_create(struct osmo_ss7_instance *inst, const char *name)
Definition: ss7_user.c:39
osmo_ss7_pointcode_parse
int osmo_ss7_pointcode_parse(const struct osmo_ss7_instance *inst, const char *str)
Definition: ss7_instance.c:551
osmo_sccp_simple_client_on_ss7_id
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_instance.c:590
osmo_ss7_instance_get_id
uint32_t osmo_ss7_instance_get_id(const struct osmo_ss7_instance *inst)
Definition: ss7_instance.c:133
osmo_ss7_as_find_by_proto
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: ss7_instance.c:302
osmo_ss7_asp_find_by_name
struct osmo_ss7_asp * osmo_ss7_asp_find_by_name(struct osmo_ss7_instance *inst, const char *name)
Definition: ss7_instance.c:362
osmo_ss7_user_register
int osmo_ss7_user_register(struct osmo_ss7_user *user, uint8_t service_ind)
Register a MTP user for a given service indicator.
Definition: ss7_user.c:88
osmo_ss7_asp_protocol
osmo_ss7_asp_protocol
Definition: osmo_ss7.h:157
OSMO_SS7_ASP_PROT_SUA
@ OSMO_SS7_ASP_PROT_SUA
Definition: osmo_ss7.h:159
OSMO_SS7_ASP_PROT_NONE
@ OSMO_SS7_ASP_PROT_NONE
Definition: osmo_ss7.h:158
OSMO_SS7_ASP_PROT_IPA
@ OSMO_SS7_ASP_PROT_IPA
Definition: osmo_ss7.h:161
OSMO_SS7_ASP_PROT_M3UA
@ OSMO_SS7_ASP_PROT_M3UA
Definition: osmo_ss7.h:160
_NUM_OSMO_SS7_ASP_PROT
@ _NUM_OSMO_SS7_ASP_PROT
Definition: osmo_ss7.h:162
osmo_ss7_asp_protocol_vals
struct value_string osmo_ss7_asp_protocol_vals[]
Definition: ss7_asp.c:142
osmo_ss7_as_traffic_mode_vals
struct value_string osmo_ss7_as_traffic_mode_vals[]
Definition: ss7_as.c:51
osmo_ss7_tmode_to_xua
int osmo_ss7_tmode_to_xua(enum osmo_ss7_as_traffic_mode tmod)
Definition: ss7.c:196
osmo_ss7_as_find_by_l_rk_id
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: ss7_instance.c:284
osmo_ss7_asp_get_proto
enum osmo_ss7_asp_protocol osmo_ss7_asp_get_proto(const struct osmo_ss7_asp *asp)
Get the proto of a given ASP.
Definition: ss7_asp.c:1490
osmo_ss7_as_select_asp
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: ss7_as.c:577
osmo_ss7_asp_role
osmo_ss7_asp_role
Definition: osmo_ss7.h:253
OSMO_SS7_ASP_ROLE_SG
@ OSMO_SS7_ASP_ROLE_SG
Definition: osmo_ss7.h:255
OSMO_SS7_ASP_ROLE_ASP
@ OSMO_SS7_ASP_ROLE_ASP
Definition: osmo_ss7.h:254
OSMO_SS7_ASP_ROLE_IPSP
@ OSMO_SS7_ASP_ROLE_IPSP
Definition: osmo_ss7.h:256
osmo_ss7_asp_send
int osmo_ss7_asp_send(struct osmo_ss7_asp *asp, struct msgb *msg)
send a fully encoded msgb via a given ASP
Definition: ss7_asp.c:1379
osmo_ss7_user_get_instance
struct osmo_ss7_instance * osmo_ss7_user_get_instance(const struct osmo_ss7_user *user)
Definition: ss7_user.c:64
osmo_ss7_instance_destroy
void osmo_ss7_instance_destroy(struct osmo_ss7_instance *inst)
Destroy a SS7 Instance.
Definition: ss7_instance.c:109
osmo_ss7_route_print
const char * osmo_ss7_route_print(const struct osmo_ss7_route *rt)
Definition: ss7_route.c:272
osmo_ss7_user_set_priv
void osmo_ss7_user_set_priv(struct osmo_ss7_user *user, void *priv)
Definition: ss7_user.c:74
osmo_ss7_get_sccp
struct osmo_sccp_instance * osmo_ss7_get_sccp(const struct osmo_ss7_instance *inst)
Get the SCCP instance, if present.
Definition: ss7_instance.c:194
osmo_sccp_simple_server_on_ss7_id
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_instance.c:841
osmo_ss7_asp_rx_unknown_cb
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:312
osmo_ss7_asp_role_names
const struct value_string osmo_ss7_asp_role_names[]
Definition: ss7_asp.c:157
osmo_ss7_as_find_by_rctx
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: ss7_instance.c:267
osmo_ss7_asp_admin_state
osmo_ss7_asp_admin_state
Definition: osmo_ss7.h:243
OSMO_SS7_ASP_ADM_S_SHUTDOWN
@ OSMO_SS7_ASP_ADM_S_SHUTDOWN
no SCTP association with peer
Definition: osmo_ss7.h:245
OSMO_SS7_ASP_ADM_S_BLOCKED
@ OSMO_SS7_ASP_ADM_S_BLOCKED
SCP association, but reject ASP-ACTIVE.
Definition: osmo_ss7.h:247
OSMO_SS7_ASP_ADM_S_ENABLED
@ OSMO_SS7_ASP_ADM_S_ENABLED
in normal operation
Definition: osmo_ss7.h:249
osmo_ss7_pc_normalize
uint32_t osmo_ss7_pc_normalize(const struct osmo_ss7_pc_fmt *pc_fmt, uint32_t pc)
Definition: ss7.c:102
osmo_ss7_asp_protocol_port
int osmo_ss7_asp_protocol_port(enum osmo_ss7_asp_protocol prot)
Definition: ss7_asp.c:208
osmo_ss7_asp_find2
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: ss7_instance.c:393
osmo_ss7_as_active
bool osmo_ss7_as_active(const struct osmo_ss7_as *as)
Determine if given AS is in the active state.
Definition: ss7_as.c:324
osmo_ss7_asp_destroy
void osmo_ss7_asp_destroy(struct osmo_ss7_asp *asp)
Definition: ss7_asp.c:746
osmo_ss7_ensure_sccp
struct osmo_sccp_instance * osmo_ss7_ensure_sccp(struct osmo_ss7_instance *inst)
Allocate an SCCP instance, if not present yet.
Definition: ss7_instance.c:180
osmo_ss7_as_down
bool osmo_ss7_as_down(const struct osmo_ss7_as *as)
Determine if given AS is in the down state.
Definition: ss7_as.c:334
osmo_ss7_as_traffic_mode
osmo_ss7_as_traffic_mode
Definition: osmo_ss7.h:183
OSMO_SS7_AS_TMOD_OVERRIDE
@ OSMO_SS7_AS_TMOD_OVERRIDE
Definition: osmo_ss7.h:185
_NUM_OSMO_SS7_ASP_TMOD
@ _NUM_OSMO_SS7_ASP_TMOD
Definition: osmo_ss7.h:194
OSMO_SS7_AS_TMOD_ROUNDROBIN
@ OSMO_SS7_AS_TMOD_ROUNDROBIN
Definition: osmo_ss7.h:193
OSMO_SS7_AS_TMOD_BCAST
@ OSMO_SS7_AS_TMOD_BCAST
Definition: osmo_ss7.h:187
OSMO_SS7_AS_TMOD_LOADSHARE
@ OSMO_SS7_AS_TMOD_LOADSHARE
Definition: osmo_ss7.h:190
osmo_ss7_asp_find_or_create
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: ss7_instance.c:449
osmo_sccp_simple_server_add_clnt
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_instance.c:894
osmo_ss7_asp_active
bool osmo_ss7_asp_active(const struct osmo_ss7_asp *asp)
Definition: ss7_asp.c:947
osmo_ss7_user_unregister
int osmo_ss7_user_unregister(struct osmo_ss7_user *user, uint8_t service_ind)
Unregister a MTP user for a given service indicator.
Definition: ss7_user.c:110
osmo_ss7_instances
struct llist_head osmo_ss7_instances
osmo_ss7_asp_restart
int osmo_ss7_asp_restart(struct osmo_ss7_asp *asp)
Definition: ss7_asp.c:881
osmo_ss7_instance_find_or_create
struct osmo_ss7_instance * osmo_ss7_instance_find_or_create(void *ctx, uint32_t id)
Find or create a SS7 Instance.
Definition: ss7.c:132
osmo_ss7_pointcode_print2
const char * osmo_ss7_pointcode_print2(const struct osmo_ss7_instance *inst, uint32_t pc)
Definition: ss7_instance.c:617
osmo_ss7_pc_width
uint8_t osmo_ss7_pc_width(const struct osmo_ss7_pc_fmt *pc_fmt)
Definition: ss7.c:88
osmo_ss7_pointcode_print_buf
const char * osmo_ss7_pointcode_print_buf(char *buf, size_t buf_len, const struct osmo_ss7_instance *inst, uint32_t pc)
Definition: ss7_instance.c:585
osmo_ss7_init
int osmo_ss7_init(void)
Definition: ss7.c:170
osmo_ss7_register_rx_unknown_cb
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: ss7_asp.c:1438
osmo_ss7_is_config_node
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
osmo_ss7_user_set_prim_cb
void osmo_ss7_user_set_prim_cb(struct osmo_ss7_user *user, osmo_prim_cb prim_cb)
Definition: ss7_user.c:69
osmo_ss7_user_destroy
void osmo_ss7_user_destroy(struct osmo_ss7_user *user)
Definition: ss7_user.c:51
osmo_ss7_instance_get_network_indicator
uint8_t osmo_ss7_instance_get_network_indicator(const struct osmo_ss7_instance *inst)
Definition: ss7_instance.c:149
osmo_ss7_as_get_asp_protocol
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: ss7_as.c:145
osmo_ss7_route_lookup
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: ss7_route.c:360
osmo_ss7_instance_get_pc_fmt
const struct osmo_ss7_pc_fmt * osmo_ss7_instance_get_pc_fmt(const struct osmo_ss7_instance *inst)
Definition: ss7_instance.c:173
osmo_ss7_asp_find_or_create2
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: ss7_instance.c:427
osmo_sccp_simple_server
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_instance.c:885
osmo_sccp_simple_client
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_instance.c:820
osmo_ss7_vty_go_parent
int osmo_ss7_vty_go_parent(struct vty *vty)
Definition: ss7_vty.c:1354
osmo_ss7_as_has_asp
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: ss7_as.c:272
osmo_ss7_asp_protocol_name
static const char * osmo_ss7_asp_protocol_name(enum osmo_ss7_asp_protocol mode)
Definition: osmo_ss7.h:167
osmo_ss7_instance_find
struct osmo_ss7_instance * osmo_ss7_instance_find(uint32_t id)
Find a SS7 Instance with given ID.
Definition: ss7.c:115
osmo_ss7_as_del_asp
int osmo_ss7_as_del_asp(struct osmo_ss7_as *as, const char *asp_name)
Delete given ASP from given AS.
Definition: ss7_as.c:237
osmo_ss7_asp_admin_state_names
const struct value_string osmo_ss7_asp_admin_state_names[]
Definition: ss7_asp.c:150
osmo_ss7_pointcode_print
const char * osmo_ss7_pointcode_print(const struct osmo_ss7_instance *inst, uint32_t pc)
Definition: ss7_instance.c:609
osmo_ss7_asp_find_by_proto
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: ss7_instance.c:379
osmo_ss7_user_mtp_sap_prim_down
int osmo_ss7_user_mtp_sap_prim_down(struct osmo_ss7_user *user, struct osmo_mtp_prim *omp)
Definition: mtp_sap.c:214
osmo_ss7_find_free_rctx
int osmo_ss7_find_free_rctx(struct osmo_ss7_instance *inst)
Definition: ss7_instance.c:210
osmo_ss7_as_traffic_mode_name
static const char * osmo_ss7_as_traffic_mode_name(enum osmo_ss7_as_traffic_mode mode)
Definition: osmo_ss7.h:200
osmo_ss7_asp_get_name
const char * osmo_ss7_asp_get_name(const struct osmo_ss7_asp *asp)
Get the name of a given ASP.
Definition: ss7_asp.c:1481
osmo_ss7_instance_set_pc_fmt
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: ss7_instance.c:155
osmo_ss7_as_find_or_create
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: ss7_instance.c:336
osmo_ss7_user_find_by_si
struct osmo_ss7_user * osmo_ss7_user_find_by_si(const struct osmo_ss7_instance *inst, uint8_t service_indicator)
Definition: ss7_user.c:57
osmo_ss7_as_tmode_compatible_xua
bool osmo_ss7_as_tmode_compatible_xua(struct osmo_ss7_as *as, uint32_t m3ua_tmt)
Definition: ss7_as.c:609
osmo_ss7_asp_find
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: ss7_instance.c:415
osmo_ss7_asp_get_log_subsys
int osmo_ss7_asp_get_log_subsys(const struct osmo_ss7_asp *asp)
Get the logging subsystem for a given ASP.
Definition: ss7_asp.c:1465
osmo_ss7_asp_disconnect
void osmo_ss7_asp_disconnect(struct osmo_ss7_asp *asp)
Definition: ss7_asp.c:1426
osmo_ss7_tmode_from_xua
enum osmo_ss7_as_traffic_mode osmo_ss7_tmode_from_xua(uint32_t in)
Definition: ss7.c:213
osmo_ss7_asp_use_default_lm
int osmo_ss7_asp_use_default_lm(struct osmo_ss7_asp *asp, int log_level)
Definition: xua_default_lm_fsm.c:427
osmo_ss7_vty_init_asp
void osmo_ss7_vty_init_asp(void *ctx)
Definition: ss7_vty.c:1474
osmo_ss7_instance_get_name
const char * osmo_ss7_instance_get_name(const struct osmo_ss7_instance *inst)
Definition: ss7_instance.c:138
osmo_ss7_instances_llist_entry
struct osmo_ss7_instance * osmo_ss7_instances_llist_entry(struct llist_head *list)
Definition: ss7.c:69
osmo_ss7_as_destroy
void osmo_ss7_as_destroy(struct osmo_ss7_as *as)
Destroy given Application Server.
Definition: ss7_as.c:251
osmo_mtp_prim
Definition: mtp_sap.h:64
osmo_sccp_instance
Definition: sccp_instance.h:47
osmo_ss7_as
Definition: ss7_as.h:75
osmo_ss7_as::name
char * name
Definition: ss7_as.h:96
osmo_ss7_as::proto
enum osmo_ss7_asp_protocol proto
Definition: ss7_as.h:98
osmo_ss7_as::inst
struct osmo_ss7_instance * inst
Definition: ss7_as.h:78
osmo_ss7_asp
Definition: ss7_asp.h:43
osmo_ss7_asp::proto
enum osmo_ss7_asp_protocol proto
Definition: ss7_asp.h:99
osmo_ss7_asp::inst
struct osmo_ss7_instance * inst
Definition: ss7_asp.h:46
osmo_ss7_asp::name
char * name
Definition: ss7_asp.h:97
osmo_ss7_asp::trans_proto
int trans_proto
The underlaying transport protocol (one of IPPROTO_*)
Definition: ss7_asp.h:150
osmo_ss7_instance
Definition: ss7_instance.h:31
osmo_ss7_instance::user
struct osmo_ss7_user * user[16]
Definition: ss7_instance.h:46
osmo_ss7_instance::list
struct llist_head list
member of global list of instances
Definition: ss7_instance.h:33
osmo_ss7_link
Definition: ss7_link.h:19
osmo_ss7_linkset
Definition: ss7_linkset.h:13
osmo_ss7_pc_fmt
Definition: ss7_instance.h:26
osmo_ss7_route
Definition: ss7_route.h:28
osmo_ss7_routing_key
Definition: osmo_ss7.h:142
osmo_ss7_routing_key::si
uint8_t si
Definition: osmo_ss7.h:147
osmo_ss7_routing_key::context
uint32_t context
Definition: osmo_ss7.h:143
osmo_ss7_routing_key::l_rk_id
uint32_t l_rk_id
Definition: osmo_ss7.h:144
osmo_ss7_routing_key::ssn
uint32_t ssn
Definition: osmo_ss7.h:148
osmo_ss7_routing_key::pc
uint32_t pc
Definition: osmo_ss7.h:146
osmo_ss7_user
Definition: ss7_user.h:15
osmo_ss7_user::name
const char * name
Definition: ss7_user.h:19
osmo_ss7_user::inst
struct osmo_ss7_instance * inst
Definition: ss7_user.h:17
osmo_xua_layer_manager
Definition: ss7_xua_srv.h:18
osmo_xua_server
Definition: ss7_xua_srv.h:22