blob: 5c82227d75ab60e8a40dfaa8e142323fcd74bf12 [file] [log] [blame]
Harald Welte9b455bf2010-03-14 15:45:01 +08001#ifndef _GPRS_SGSN_H
2#define _GPRS_SGSN_H
3
Harald Welteeaa614c2010-05-02 11:26:34 +02004#include <stdint.h>
Harald Welted193cb32010-05-17 22:58:03 +02005#include <netinet/in.h>
6
Holger Hans Peter Freyther26d0fe32012-01-06 17:29:06 +01007#include <osmocom/core/timer.h>
8
Pablo Neira Ayuso136f4532011-03-22 16:47:59 +01009#include <osmocom/gsm/gsm48.h>
Harald Welteeaa614c2010-05-02 11:26:34 +020010
Harald Welte496aee42010-06-30 19:59:55 +020011#include <osmocom/crypt/gprs_cipher.h>
12
Harald Welte2720e732010-05-17 00:44:57 +020013#define GSM_IMSI_LENGTH 17
14#define GSM_IMEI_LENGTH 17
15#define GSM_EXTENSION_LENGTH 15
16
Harald Welte807a5d82010-06-01 11:53:01 +020017struct gprs_llc_lle;
Holger Hans Peter Freythera2730302014-03-23 18:08:26 +010018struct ctrl_handle;
Harald Welte807a5d82010-06-01 11:53:01 +020019
Harald Welte9b455bf2010-03-14 15:45:01 +080020/* TS 04.08 4.1.3.3 GMM mobility management states on the network side */
21enum gprs_mm_state {
22 GMM_DEREGISTERED, /* 4.1.3.3.1.1 */
23 GMM_COMMON_PROC_INIT, /* 4.1.3.3.1.2 */
24 GMM_REGISTERED_NORMAL, /* 4.1.3.3.2.1 */
25 GMM_REGISTERED_SUSPENDED, /* 4.1.3.3.2.2 */
26 GMM_DEREGISTERED_INIT, /* 4.1.3.3.1.4 */
27};
28
Harald Weltec2e8cc42010-05-31 20:23:38 +020029enum gprs_mm_ctr {
Harald Welte8acd88f2010-05-18 10:57:45 +020030 GMM_CTR_PKTS_SIG_IN,
31 GMM_CTR_PKTS_SIG_OUT,
32 GMM_CTR_PKTS_UDATA_IN,
33 GMM_CTR_PKTS_UDATA_OUT,
34 GMM_CTR_BYTES_UDATA_IN,
35 GMM_CTR_BYTES_UDATA_OUT,
36 GMM_CTR_PDP_CTX_ACT,
37 GMM_CTR_SUSPEND,
38 GMM_CTR_PAGING_PS,
39 GMM_CTR_PAGING_CS,
40 GMM_CTR_RA_UPDATE,
41};
42
Harald Welteefbdee92010-06-10 00:20:12 +020043enum gprs_pdp_ctx {
44 PDP_CTR_PKTS_UDATA_IN,
45 PDP_CTR_PKTS_UDATA_OUT,
46 PDP_CTR_BYTES_UDATA_IN,
47 PDP_CTR_BYTES_UDATA_OUT,
48};
49
Harald Weltec2e8cc42010-05-31 20:23:38 +020050enum gprs_t3350_mode {
51 GMM_T3350_MODE_ATT,
52 GMM_T3350_MODE_RAU,
53 GMM_T3350_MODE_PTMSI_REALL,
54};
55
Harald Welte9b455bf2010-03-14 15:45:01 +080056#define MS_RADIO_ACCESS_CAPA
57
58/* According to TS 03.60, Table 5: SGSN MM and PDP Contexts */
Harald Weltef533e132010-05-01 16:45:46 +020059/* Extended by 3GPP TS 23.060, Table 6: SGSN MM and PDP Contexts */
Harald Welte9b455bf2010-03-14 15:45:01 +080060struct sgsn_mm_ctx {
61 struct llist_head list;
62
63 char imsi[GSM_IMSI_LENGTH];
64 enum gprs_mm_state mm_state;
Harald Welteeaa614c2010-05-02 11:26:34 +020065 uint32_t p_tmsi;
Harald Weltec2e8cc42010-05-31 20:23:38 +020066 uint32_t p_tmsi_old; /* old P-TMSI before new is confirmed */
Harald Welteeaa614c2010-05-02 11:26:34 +020067 uint32_t p_tmsi_sig;
Harald Welte9b455bf2010-03-14 15:45:01 +080068 char imei[GSM_IMEI_LENGTH];
Harald Weltef533e132010-05-01 16:45:46 +020069 /* Opt: Software Version Numbber / TS 23.195 */
Harald Welte9b455bf2010-03-14 15:45:01 +080070 char msisdn[GSM_EXTENSION_LENGTH];
71 struct gprs_ra_id ra;
Harald Welteeaa614c2010-05-02 11:26:34 +020072 uint16_t cell_id;
73 uint32_t cell_id_age;
74 uint16_t sac; /* Iu: Service Area Code */
75 uint32_t sac_age;/* Iu: Service Area Code age */
Harald Welte9b455bf2010-03-14 15:45:01 +080076 /* VLR number */
Harald Welteeaa614c2010-05-02 11:26:34 +020077 uint32_t new_sgsn_addr;
Harald Welte9b455bf2010-03-14 15:45:01 +080078 /* Authentication Triplets */
79 /* Kc */
Harald Weltef533e132010-05-01 16:45:46 +020080 /* Iu: CK, IK, KSI */
Harald Welte9b455bf2010-03-14 15:45:01 +080081 /* CKSN */
82 enum gprs_ciph_algo ciph_algo;
83 struct {
Harald Welteeaa614c2010-05-02 11:26:34 +020084 uint8_t len;
Alexander Chemeris84402c02013-07-03 10:12:23 +040085 uint8_t buf[50]; /* GSM 04.08 10.5.5.12a, extended in TS 24.008 */
Harald Welte9b455bf2010-03-14 15:45:01 +080086 } ms_radio_access_capa;
87 struct {
Harald Welteeaa614c2010-05-02 11:26:34 +020088 uint8_t len;
Alexander Chemeris84402c02013-07-03 10:12:23 +040089 uint8_t buf[8]; /* GSM 04.08 10.5.5.12, extended in TS 24.008 */
Harald Welte9b455bf2010-03-14 15:45:01 +080090 } ms_network_capa;
Harald Welteeaa614c2010-05-02 11:26:34 +020091 uint16_t drx_parms;
Harald Welte9b455bf2010-03-14 15:45:01 +080092 int mnrg; /* MS reported to HLR? */
93 int ngaf; /* MS reported to MSC/VLR? */
94 int ppf; /* paging for GPRS + non-GPRS? */
95 /* SMS Parameters */
96 int recovery;
Harald Welteba850c52010-05-02 14:40:32 +020097 uint8_t radio_prio_sms;
Harald Welte9b455bf2010-03-14 15:45:01 +080098
99 struct llist_head pdp_list;
100
101 /* Additional bits not present in the GSM TS */
Harald Welte807a5d82010-06-01 11:53:01 +0200102 struct gprs_llc_llme *llme;
Harald Welteeaa614c2010-05-02 11:26:34 +0200103 uint32_t tlli;
Harald Welte807a5d82010-06-01 11:53:01 +0200104 uint32_t tlli_new;
Harald Welte6abf94e2010-05-18 10:35:06 +0200105 uint16_t nsei;
106 uint16_t bvci;
Harald Welte8acd88f2010-05-18 10:57:45 +0200107 struct rate_ctr_group *ctrg;
Pablo Neira Ayusobf540cb2011-05-06 12:11:06 +0200108 struct osmo_timer_list timer;
Harald Weltec2e8cc42010-05-31 20:23:38 +0200109 unsigned int T; /* Txxxx number */
110 unsigned int num_T_exp; /* number of consecutive T expirations */
111
112 enum gprs_t3350_mode t3350_mode;
113 uint8_t t3370_id_type;
Harald Welte9b455bf2010-03-14 15:45:01 +0800114};
115
Daniel Willmannb15ceec2014-09-03 15:57:49 +0200116#define LOGMMCTXP(level, mm, fmt, args...) \
117 LOGP(DMM, level, "MM(%s/%08x) " fmt, (mm)->imsi, (mm)->p_tmsi, ## args)
118
Harald Welte9b455bf2010-03-14 15:45:01 +0800119/* look-up a SGSN MM context based on TLLI + RAI */
Harald Welteeaa614c2010-05-02 11:26:34 +0200120struct sgsn_mm_ctx *sgsn_mm_ctx_by_tlli(uint32_t tlli,
Harald Welte9b455bf2010-03-14 15:45:01 +0800121 const struct gprs_ra_id *raid);
Harald Welteeaa614c2010-05-02 11:26:34 +0200122struct sgsn_mm_ctx *sgsn_mm_ctx_by_ptmsi(uint32_t tmsi);
Harald Welte9b455bf2010-03-14 15:45:01 +0800123struct sgsn_mm_ctx *sgsn_mm_ctx_by_imsi(const char *imsi);
124
125/* Allocate a new SGSN MM context */
Harald Welteeaa614c2010-05-02 11:26:34 +0200126struct sgsn_mm_ctx *sgsn_mm_ctx_alloc(uint32_t tlli,
Harald Welte9b455bf2010-03-14 15:45:01 +0800127 const struct gprs_ra_id *raid);
Harald Weltec728eea2010-12-24 23:07:18 +0100128void sgsn_mm_ctx_free(struct sgsn_mm_ctx *mm);
Harald Welte9b455bf2010-03-14 15:45:01 +0800129
Harald Welted193cb32010-05-17 22:58:03 +0200130
131enum pdp_ctx_state {
132 PDP_STATE_NONE,
Harald Welte6abf94e2010-05-18 10:35:06 +0200133 PDP_STATE_CR_REQ,
134 PDP_STATE_CR_CONF,
Harald Weltea9b473a2010-12-24 21:13:26 +0100135
136 /* 04.08 / Figure 6.2 / 6.1.2.2 */
137 PDP_STATE_INACT_PEND,
138 PDP_STATE_INACTIVE = PDP_STATE_NONE,
Harald Welted193cb32010-05-17 22:58:03 +0200139};
140
141enum pdp_type {
142 PDP_TYPE_NONE,
Harald Welte6abf94e2010-05-18 10:35:06 +0200143 PDP_TYPE_ETSI_PPP,
144 PDP_TYPE_IANA_IPv4,
145 PDP_TYPE_IANA_IPv6,
Harald Welted193cb32010-05-17 22:58:03 +0200146};
147
148struct sgsn_pdp_ctx {
149 struct llist_head list; /* list_head for mmctx->pdp_list */
150 struct llist_head g_list; /* list_head for global list */
151 struct sgsn_mm_ctx *mm; /* back pointer to MM CTX */
152 struct sgsn_ggsn_ctx *ggsn; /* which GGSN serves this PDP */
Harald Welteefbdee92010-06-10 00:20:12 +0200153 struct rate_ctr_group *ctrg;
Harald Welted193cb32010-05-17 22:58:03 +0200154
155 //unsigned int id;
156 struct pdp_t *lib; /* pointer to libgtp PDP ctx */
157 enum pdp_ctx_state state;
158 enum pdp_type type;
159 uint32_t address;
160 char *apn_subscribed;
161 //char *apn_used;
Harald Welte6abf94e2010-05-18 10:35:06 +0200162 uint16_t nsapi; /* SNDCP */
163 uint16_t sapi; /* LLC */
Harald Welted193cb32010-05-17 22:58:03 +0200164 uint8_t ti; /* transaction identifier */
165 int vplmn_allowed;
166 uint32_t qos_profile_subscr;
167 //uint32_t qos_profile_req;
168 //uint32_t qos_profile_neg;
169 uint8_t radio_prio;
170 uint32_t tx_npdu_nr;
171 uint32_t rx_npdu_nr;
172 uint32_t tx_gtp_snd;
173 uint32_t rx_gtp_snu;
174 //uint32_t charging_id;
175 int reordering_reqd;
Harald Weltea9b473a2010-12-24 21:13:26 +0100176
Pablo Neira Ayusobf540cb2011-05-06 12:11:06 +0200177 struct osmo_timer_list timer;
Harald Weltea9b473a2010-12-24 21:13:26 +0100178 unsigned int T; /* Txxxx number */
179 unsigned int num_T_exp; /* number of consecutive T expirations */
Harald Welted193cb32010-05-17 22:58:03 +0200180};
181
Daniel Willmannb15ceec2014-09-03 15:57:49 +0200182#define LOGPDPCTXP(level, pdp, fmt, args...) \
Jacob Erlbeck99985b52014-10-13 10:32:00 +0200183 LOGP(DGPRS, level, "PDP(%s/%u) " \
184 fmt, (pdp)->mm ? (pdp)->mm->imsi : "---", (pdp)->ti, ## args)
Harald Welted193cb32010-05-17 22:58:03 +0200185
Harald Welte96df6062010-06-03 06:37:26 +0200186/* look up PDP context by MM context and NSAPI */
Harald Welted193cb32010-05-17 22:58:03 +0200187struct sgsn_pdp_ctx *sgsn_pdp_ctx_by_nsapi(const struct sgsn_mm_ctx *mm,
188 uint8_t nsapi);
Harald Welte96df6062010-06-03 06:37:26 +0200189/* look up PDP context by MM context and transaction ID */
Harald Welte77289c22010-05-18 14:32:29 +0200190struct sgsn_pdp_ctx *sgsn_pdp_ctx_by_tid(const struct sgsn_mm_ctx *mm,
191 uint8_t tid);
Harald Welte96df6062010-06-03 06:37:26 +0200192
Harald Welted193cb32010-05-17 22:58:03 +0200193struct sgsn_pdp_ctx *sgsn_pdp_ctx_alloc(struct sgsn_mm_ctx *mm,
194 uint8_t nsapi);
Jacob Erlbeck99985b52014-10-13 10:32:00 +0200195void sgsn_pdp_ctx_terminate(struct sgsn_pdp_ctx *pdp);
Harald Welted193cb32010-05-17 22:58:03 +0200196void sgsn_pdp_ctx_free(struct sgsn_pdp_ctx *pdp);
197
198
Harald Welte77289c22010-05-18 14:32:29 +0200199struct sgsn_ggsn_ctx {
Harald Welted193cb32010-05-17 22:58:03 +0200200 struct llist_head list;
201 uint32_t id;
202 unsigned int gtp_version;
203 struct in_addr remote_addr;
Harald Weltea9b473a2010-12-24 21:13:26 +0100204 int remote_restart_ctr;
Harald Welted193cb32010-05-17 22:58:03 +0200205 struct gsn_t *gsn;
206};
Harald Weltecd4dd4d2010-05-18 17:20:49 +0200207struct sgsn_ggsn_ctx *sgsn_ggsn_ctx_alloc(uint32_t id);
208struct sgsn_ggsn_ctx *sgsn_ggsn_ctx_by_id(uint32_t id);
Harald Weltea9b473a2010-12-24 21:13:26 +0100209struct sgsn_ggsn_ctx *sgsn_ggsn_ctx_by_addr(struct in_addr *addr);
Harald Weltecd4dd4d2010-05-18 17:20:49 +0200210struct sgsn_ggsn_ctx *sgsn_ggsn_ctx_find_alloc(uint32_t id);
Harald Welted193cb32010-05-17 22:58:03 +0200211
212struct apn_ctx {
213 struct llist_head list;
Harald Welte77289c22010-05-18 14:32:29 +0200214 struct sgsn_ggsn_ctx *ggsn;
Harald Welted193cb32010-05-17 22:58:03 +0200215 char *name;
216 char *description;
217};
218
219extern struct llist_head sgsn_mm_ctxts;
220extern struct llist_head sgsn_ggsn_ctxts;
221extern struct llist_head sgsn_apn_ctxts;
222extern struct llist_head sgsn_pdp_ctxts;
223
Harald Welte6463c072010-05-18 17:04:55 +0200224uint32_t sgsn_alloc_ptmsi(void);
225
Harald Weltea9b473a2010-12-24 21:13:26 +0100226/* High-level function to be called in case a GGSN has disappeared or
227 * ottherwise lost state (recovery procedure) */
228int drop_all_pdp_for_ggsn(struct sgsn_ggsn_ctx *ggsn);
229
Holger Hans Peter Freythera2730302014-03-23 18:08:26 +0100230char *gprs_pdpaddr2str(uint8_t *pdpa, uint8_t len);
231
Jacob Erlbeck78ecaf02014-09-05 14:32:36 +0200232/* Force re-attachment based on msgb meta data */
233int sgsn_force_reattach_oldmsg(struct msgb *oldmsg);
234
Holger Hans Peter Freythera2730302014-03-23 18:08:26 +0100235/*
236 * ctrl interface related work
237 */
238struct gsm_network;
239struct ctrl_handle *sgsn_controlif_setup(struct gsm_network *, uint16_t port);
240int sgsn_ctrl_cmds_install(void);
241
Holger Hans Peter Freyther1768a572014-04-04 12:40:34 +0200242/*
243 * ACL handling
244 */
Jacob Erlbeck3b5d4072014-10-24 15:11:03 +0200245struct imsi_acl_entry {
246 struct llist_head list;
247 char imsi[16+1];
248};
249struct sgsn_config;
250struct sgsn_instance;
251
252void sgsn_auth_init(struct sgsn_instance *sgi);
253struct imsi_acl_entry *sgsn_acl_lookup(const char *imsi, struct sgsn_config *cfg);
254int sgsn_acl_add(const char *imsi, struct sgsn_config *cfg);
255int sgsn_acl_del(const char *imsi, struct sgsn_config *cfg);
Holger Hans Peter Freyther1768a572014-04-04 12:40:34 +0200256
Holger Hans Peter Freyther90e9a442014-04-04 12:51:28 +0200257int gprs_sndcp_vty_init(void);
258struct sgsn_instance;
259int sgsn_gtp_init(struct sgsn_instance *sgi);
260
Harald Welte9b455bf2010-03-14 15:45:01 +0800261#endif /* _GPRS_SGSN_H */