Holger Hans Peter Freyther | 857e5e6 | 2009-06-12 07:08:13 +0200 | [diff] [blame] | 1 | /* The concept of a subscriber for the MSC, roughly HLR/VLR functionality */ |
Harald Welte | 52b1f98 | 2008-12-23 20:25:15 +0000 | [diff] [blame] | 2 | |
| 3 | /* (C) 2008 by Harald Welte <laforge@gnumonks.org> |
Holger Hans Peter Freyther | e7bd863 | 2013-06-30 15:30:47 +0200 | [diff] [blame] | 4 | * (C) 2009,2013 by Holger Hans Peter Freyther <zecke@selfish.org> |
Harald Welte | 8470bf2 | 2008-12-25 23:28:35 +0000 | [diff] [blame] | 5 | * |
Harald Welte | 52b1f98 | 2008-12-23 20:25:15 +0000 | [diff] [blame] | 6 | * All Rights Reserved |
| 7 | * |
| 8 | * This program is free software; you can redistribute it and/or modify |
Harald Welte | 9af6ddf | 2011-01-01 15:25:50 +0100 | [diff] [blame] | 9 | * it under the terms of the GNU Affero General Public License as published by |
| 10 | * the Free Software Foundation; either version 3 of the License, or |
Harald Welte | 52b1f98 | 2008-12-23 20:25:15 +0000 | [diff] [blame] | 11 | * (at your option) any later version. |
| 12 | * |
| 13 | * This program is distributed in the hope that it will be useful, |
| 14 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 15 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
Harald Welte | 9af6ddf | 2011-01-01 15:25:50 +0100 | [diff] [blame] | 16 | * GNU Affero General Public License for more details. |
Harald Welte | 52b1f98 | 2008-12-23 20:25:15 +0000 | [diff] [blame] | 17 | * |
Harald Welte | 9af6ddf | 2011-01-01 15:25:50 +0100 | [diff] [blame] | 18 | * You should have received a copy of the GNU Affero General Public License |
| 19 | * along with this program. If not, see <http://www.gnu.org/licenses/>. |
Harald Welte | 52b1f98 | 2008-12-23 20:25:15 +0000 | [diff] [blame] | 20 | * |
| 21 | */ |
| 22 | |
Neels Hofmeyr | 00e82d6 | 2017-07-05 15:19:52 +0200 | [diff] [blame] | 23 | #include "../../bscconfig.h" |
| 24 | |
Harald Welte | 75a983f | 2008-12-27 21:34:06 +0000 | [diff] [blame] | 25 | #include <unistd.h> |
| 26 | #include <stdlib.h> |
| 27 | #include <stdio.h> |
| 28 | #include <string.h> |
Holger Freyther | 85a7b36 | 2009-04-18 13:48:55 +0200 | [diff] [blame] | 29 | #include <assert.h> |
Jan Luebbe | bfbdeec | 2012-12-27 00:27:16 +0100 | [diff] [blame] | 30 | #include <time.h> |
Max | e6052c4 | 2016-06-30 10:25:49 +0200 | [diff] [blame] | 31 | #include <stdbool.h> |
Harald Welte | 52b1f98 | 2008-12-23 20:25:15 +0000 | [diff] [blame] | 32 | |
Pablo Neira Ayuso | 136f453 | 2011-03-22 16:47:59 +0100 | [diff] [blame] | 33 | #include <osmocom/core/talloc.h> |
Sylvain Munaut | 1e24550 | 2010-12-01 21:07:29 +0100 | [diff] [blame] | 34 | |
Holger Hans Peter Freyther | 763b42a | 2010-12-29 11:07:22 +0100 | [diff] [blame] | 35 | #include <osmocom/vty/vty.h> |
| 36 | |
Neels Hofmeyr | 00e82d6 | 2017-07-05 15:19:52 +0200 | [diff] [blame] | 37 | #ifdef BUILD_IU |
| 38 | #include <osmocom/ranap/iu_client.h> |
| 39 | #else |
Neels Hofmeyr | 9084396 | 2017-09-04 15:04:35 +0200 | [diff] [blame] | 40 | #include <osmocom/msc/iu_dummy.h> |
Neels Hofmeyr | 00e82d6 | 2017-07-05 15:19:52 +0200 | [diff] [blame] | 41 | #endif |
| 42 | |
Neels Hofmeyr | 9084396 | 2017-09-04 15:04:35 +0200 | [diff] [blame] | 43 | #include <osmocom/msc/gsm_subscriber.h> |
| 44 | #include <osmocom/msc/gsm_04_08.h> |
| 45 | #include <osmocom/msc/debug.h> |
Neels Hofmeyr | 9084396 | 2017-09-04 15:04:35 +0200 | [diff] [blame] | 46 | #include <osmocom/msc/signal.h> |
| 47 | #include <osmocom/msc/db.h> |
Neels Hofmeyr | 9084396 | 2017-09-04 15:04:35 +0200 | [diff] [blame] | 48 | #include <osmocom/msc/vlr.h> |
Neels Hofmeyr | 9084396 | 2017-09-04 15:04:35 +0200 | [diff] [blame] | 49 | #include <osmocom/msc/msc_ifaces.h> |
| 50 | #include <osmocom/msc/a_iface.h> |
Harald Welte | 0df904d | 2018-12-03 11:00:04 +0100 | [diff] [blame] | 51 | #include <osmocom/msc/sgs_iface.h> |
Harald Welte | 52b1f98 | 2008-12-23 20:25:15 +0000 | [diff] [blame] | 52 | |
Neels Hofmeyr | 7c5346c | 2019-02-19 02:36:35 +0100 | [diff] [blame^] | 53 | #define VSUB_USE_PAGING "Paging" |
| 54 | |
Neels Hofmeyr | facd57a | 2017-12-15 03:48:48 +0100 | [diff] [blame] | 55 | void subscr_paging_cancel(struct vlr_subscr *vsub, enum gsm_paging_event event) |
| 56 | { |
| 57 | subscr_paging_dispatch(GSM_HOOK_RR_PAGING, event, NULL, NULL, vsub); |
| 58 | } |
| 59 | |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 60 | int subscr_paging_dispatch(unsigned int hooknum, unsigned int event, |
| 61 | struct msgb *msg, void *data, void *param) |
Sylvain Munaut | 1e24550 | 2010-12-01 21:07:29 +0100 | [diff] [blame] | 62 | { |
Holger Hans Peter Freyther | d6d7aff | 2015-04-06 12:03:45 +0200 | [diff] [blame] | 63 | struct subscr_request *request, *tmp; |
Neels Hofmeyr | c036b79 | 2018-11-29 22:37:51 +0100 | [diff] [blame] | 64 | struct ran_conn *conn = data; |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 65 | struct vlr_subscr *vsub = param; |
Sylvain Munaut | 8a31a3f | 2010-12-01 23:04:03 +0100 | [diff] [blame] | 66 | struct paging_signal_data sig_data; |
Sylvain Munaut | 1e24550 | 2010-12-01 21:07:29 +0100 | [diff] [blame] | 67 | |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 68 | OSMO_ASSERT(vsub); |
| 69 | OSMO_ASSERT(hooknum == GSM_HOOK_RR_PAGING); |
| 70 | OSMO_ASSERT(!(conn && (conn->vsub != vsub))); |
| 71 | OSMO_ASSERT(!((event == GSM_PAGING_SUCCEEDED) && !conn)); |
Sylvain Munaut | 1e24550 | 2010-12-01 21:07:29 +0100 | [diff] [blame] | 72 | |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 73 | LOGP(DPAG, LOGL_DEBUG, "Paging %s for %s (event=%d)\n", |
| 74 | event == GSM_PAGING_SUCCEEDED ? "success" : "failure", |
| 75 | vlr_subscr_name(vsub), event); |
| 76 | |
| 77 | if (!vsub->cs.is_paging) { |
| 78 | LOGP(DPAG, LOGL_ERROR, |
| 79 | "Paging Response received for subscriber" |
| 80 | " that is not paging.\n"); |
| 81 | return -EINVAL; |
| 82 | } |
| 83 | |
Neels Hofmeyr | 2ff5bcd | 2017-12-15 03:02:27 +0100 | [diff] [blame] | 84 | osmo_timer_del(&vsub->cs.paging_response_timer); |
| 85 | |
| 86 | if (event == GSM_PAGING_SUCCEEDED |
| 87 | || event == GSM_PAGING_EXPIRED) |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 88 | msc_stop_paging(vsub); |
Holger Hans Peter Freyther | 778c7d1 | 2015-08-03 11:18:23 +0200 | [diff] [blame] | 89 | |
Holger Hans Peter Freyther | d6d7aff | 2015-04-06 12:03:45 +0200 | [diff] [blame] | 90 | /* Inform parts of the system we don't know */ |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 91 | sig_data.vsub = vsub; |
| 92 | sig_data.conn = conn; |
Holger Hans Peter Freyther | d3baf41 | 2010-12-23 18:19:17 +0100 | [diff] [blame] | 93 | sig_data.paging_result = event; |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 94 | osmo_signal_dispatch(SS_PAGING, |
| 95 | event == GSM_PAGING_SUCCEEDED ? |
| 96 | S_PAGING_SUCCEEDED : S_PAGING_EXPIRED, |
| 97 | &sig_data); |
Sylvain Munaut | 8a31a3f | 2010-12-01 23:04:03 +0100 | [diff] [blame] | 98 | |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 99 | llist_for_each_entry_safe(request, tmp, &vsub->cs.requests, entry) { |
Holger Hans Peter Freyther | d6d7aff | 2015-04-06 12:03:45 +0200 | [diff] [blame] | 100 | llist_del(&request->entry); |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 101 | if (request->cbfn) { |
| 102 | LOGP(DPAG, LOGL_DEBUG, "Calling paging cbfn.\n"); |
| 103 | request->cbfn(hooknum, event, msg, data, request->param); |
| 104 | } else |
| 105 | LOGP(DPAG, LOGL_DEBUG, "Paging without action.\n"); |
Holger Hans Peter Freyther | d6d7aff | 2015-04-06 12:03:45 +0200 | [diff] [blame] | 106 | talloc_free(request); |
Holger Hans Peter Freyther | ffccb77 | 2010-12-28 17:47:43 +0100 | [diff] [blame] | 107 | } |
Holger Hans Peter Freyther | f72b3d5 | 2010-12-28 17:27:05 +0100 | [diff] [blame] | 108 | |
Holger Hans Peter Freyther | d6d7aff | 2015-04-06 12:03:45 +0200 | [diff] [blame] | 109 | /* balanced with the moment we start paging */ |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 110 | vsub->cs.is_paging = false; |
Neels Hofmeyr | 7c5346c | 2019-02-19 02:36:35 +0100 | [diff] [blame^] | 111 | vlr_subscr_put(vsub, VSUB_USE_PAGING); |
Sylvain Munaut | 1e24550 | 2010-12-01 21:07:29 +0100 | [diff] [blame] | 112 | return 0; |
| 113 | } |
| 114 | |
Harald Welte | 0df904d | 2018-12-03 11:00:04 +0100 | [diff] [blame] | 115 | /* Execute a paging on the currently active RAN. Returns the number of |
| 116 | * delivered paging requests or -EINVAL in case of failure. */ |
| 117 | static int msc_paging_request(struct vlr_subscr *vsub, enum sgsap_service_ind serv_ind) |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 118 | { |
| 119 | /* The subscriber was last seen in subscr->lac. Find out which |
| 120 | * BSCs/RNCs are responsible and send them a paging request via open |
| 121 | * SCCP connections (if any). */ |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 122 | switch (vsub->cs.attached_via_ran) { |
Neels Hofmeyr | 7814a83 | 2018-12-26 00:40:18 +0100 | [diff] [blame] | 123 | case OSMO_RAT_GERAN_A: |
Max | 7d41d87 | 2018-12-19 11:48:33 +0100 | [diff] [blame] | 124 | return a_iface_tx_paging(vsub->imsi, vsub->tmsi, vsub->cgi.lai.lac); |
Neels Hofmeyr | 7814a83 | 2018-12-26 00:40:18 +0100 | [diff] [blame] | 125 | case OSMO_RAT_UTRAN_IU: |
Neels Hofmeyr | 00e82d6 | 2017-07-05 15:19:52 +0200 | [diff] [blame] | 126 | return ranap_iu_page_cs(vsub->imsi, |
| 127 | vsub->tmsi == GSM_RESERVED_TMSI? |
| 128 | NULL : &vsub->tmsi, |
Max | 7d41d87 | 2018-12-19 11:48:33 +0100 | [diff] [blame] | 129 | vsub->cgi.lai.lac); |
Harald Welte | 0df904d | 2018-12-03 11:00:04 +0100 | [diff] [blame] | 130 | case OSMO_RAT_EUTRAN_SGS: |
| 131 | return sgs_iface_tx_paging(vsub, serv_ind); |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 132 | default: |
| 133 | break; |
| 134 | } |
| 135 | |
| 136 | LOGP(DPAG, LOGL_ERROR, "%s: Cannot page, subscriber not attached\n", |
| 137 | vlr_subscr_name(vsub)); |
| 138 | return -EINVAL; |
| 139 | } |
| 140 | |
Neels Hofmeyr | 2ff5bcd | 2017-12-15 03:02:27 +0100 | [diff] [blame] | 141 | static void paging_response_timer_cb(void *data) |
| 142 | { |
| 143 | struct vlr_subscr *vsub = data; |
Neels Hofmeyr | facd57a | 2017-12-15 03:48:48 +0100 | [diff] [blame] | 144 | subscr_paging_cancel(vsub, GSM_PAGING_EXPIRED); |
Neels Hofmeyr | 2ff5bcd | 2017-12-15 03:02:27 +0100 | [diff] [blame] | 145 | } |
| 146 | |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 147 | /*! \brief Start a paging request for vsub, call cbfn(param) when done. |
| 148 | * \param vsub subscriber to page. |
| 149 | * \param cbfn function to call when the conn is established. |
| 150 | * \param param caller defined param to pass to cbfn(). |
| 151 | * \param label human readable label of the request kind used for logging. |
Harald Welte | 0df904d | 2018-12-03 11:00:04 +0100 | [diff] [blame] | 152 | * \param serv_ind sgsap service indicator (in case SGs interface is used to page). |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 153 | */ |
| 154 | struct subscr_request *subscr_request_conn(struct vlr_subscr *vsub, |
| 155 | gsm_cbfn *cbfn, void *param, |
Harald Welte | 0df904d | 2018-12-03 11:00:04 +0100 | [diff] [blame] | 156 | const char *label, enum sgsap_service_ind serv_ind) |
Sylvain Munaut | 1e24550 | 2010-12-01 21:07:29 +0100 | [diff] [blame] | 157 | { |
Sylvain Munaut | 1e24550 | 2010-12-01 21:07:29 +0100 | [diff] [blame] | 158 | int rc; |
Sylvain Munaut | 1e24550 | 2010-12-01 21:07:29 +0100 | [diff] [blame] | 159 | struct subscr_request *request; |
Neels Hofmeyr | 2ff5bcd | 2017-12-15 03:02:27 +0100 | [diff] [blame] | 160 | struct gsm_network *net = vsub->vlr->user_ctx; |
Sylvain Munaut | 1e24550 | 2010-12-01 21:07:29 +0100 | [diff] [blame] | 161 | |
Holger Hans Peter Freyther | d6d7aff | 2015-04-06 12:03:45 +0200 | [diff] [blame] | 162 | /* Start paging.. we know it is async so we can do it before */ |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 163 | if (!vsub->cs.is_paging) { |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 164 | LOGP(DMM, LOGL_DEBUG, "Subscriber %s not paged yet, start paging.\n", |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 165 | vlr_subscr_name(vsub)); |
Harald Welte | 0df904d | 2018-12-03 11:00:04 +0100 | [diff] [blame] | 166 | rc = msc_paging_request(vsub, serv_ind); |
Holger Hans Peter Freyther | d6d7aff | 2015-04-06 12:03:45 +0200 | [diff] [blame] | 167 | if (rc <= 0) { |
| 168 | LOGP(DMM, LOGL_ERROR, "Subscriber %s paging failed: %d\n", |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 169 | vlr_subscr_name(vsub), rc); |
Holger Hans Peter Freyther | d6d7aff | 2015-04-06 12:03:45 +0200 | [diff] [blame] | 170 | return NULL; |
| 171 | } |
| 172 | /* reduced on the first paging callback */ |
Neels Hofmeyr | 7c5346c | 2019-02-19 02:36:35 +0100 | [diff] [blame^] | 173 | vlr_subscr_get(vsub, VSUB_USE_PAGING); |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 174 | vsub->cs.is_paging = true; |
Neels Hofmeyr | 2ff5bcd | 2017-12-15 03:02:27 +0100 | [diff] [blame] | 175 | osmo_timer_setup(&vsub->cs.paging_response_timer, paging_response_timer_cb, vsub); |
| 176 | osmo_timer_schedule(&vsub->cs.paging_response_timer, net->paging_response_timer, 0); |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 177 | } else { |
| 178 | LOGP(DMM, LOGL_DEBUG, "Subscriber %s already paged.\n", |
| 179 | vlr_subscr_name(vsub)); |
Sylvain Munaut | 1e24550 | 2010-12-01 21:07:29 +0100 | [diff] [blame] | 180 | } |
| 181 | |
Holger Hans Peter Freyther | d6d7aff | 2015-04-06 12:03:45 +0200 | [diff] [blame] | 182 | /* TODO: Stop paging in case of memory allocation failure */ |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 183 | request = talloc_zero(vsub, struct subscr_request); |
Holger Hans Peter Freyther | d6d7aff | 2015-04-06 12:03:45 +0200 | [diff] [blame] | 184 | if (!request) |
| 185 | return NULL; |
| 186 | |
Sylvain Munaut | 1e24550 | 2010-12-01 21:07:29 +0100 | [diff] [blame] | 187 | request->cbfn = cbfn; |
| 188 | request->param = param; |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 189 | llist_add_tail(&request->entry, &vsub->cs.requests); |
Holger Hans Peter Freyther | d6d7aff | 2015-04-06 12:03:45 +0200 | [diff] [blame] | 190 | return request; |
Sylvain Munaut | 1e24550 | 2010-12-01 21:07:29 +0100 | [diff] [blame] | 191 | } |
| 192 | |
Holger Hans Peter Freyther | d6d7aff | 2015-04-06 12:03:45 +0200 | [diff] [blame] | 193 | void subscr_remove_request(struct subscr_request *request) |
Sylvain Munaut | 1e24550 | 2010-12-01 21:07:29 +0100 | [diff] [blame] | 194 | { |
Holger Hans Peter Freyther | d6d7aff | 2015-04-06 12:03:45 +0200 | [diff] [blame] | 195 | llist_del(&request->entry); |
| 196 | talloc_free(request); |
Sylvain Munaut | 1e24550 | 2010-12-01 21:07:29 +0100 | [diff] [blame] | 197 | } |
| 198 | |
Neels Hofmeyr | c036b79 | 2018-11-29 22:37:51 +0100 | [diff] [blame] | 199 | struct ran_conn *connection_for_subscr(struct vlr_subscr *vsub) |
Holger Hans Peter Freyther | 7634ec1 | 2013-10-04 08:35:11 +0200 | [diff] [blame] | 200 | { |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 201 | struct gsm_network *net = vsub->vlr->user_ctx; |
Neels Hofmeyr | c036b79 | 2018-11-29 22:37:51 +0100 | [diff] [blame] | 202 | struct ran_conn *conn; |
Neels Hofmeyr | 1a60644 | 2016-05-10 13:56:43 +0200 | [diff] [blame] | 203 | |
Neels Hofmeyr | c036b79 | 2018-11-29 22:37:51 +0100 | [diff] [blame] | 204 | llist_for_each_entry(conn, &net->ran_conns, entry) { |
Neels Hofmeyr | 8e2c6a3 | 2019-03-07 03:06:16 +0100 | [diff] [blame] | 205 | if (conn->vsub != vsub) |
| 206 | continue; |
| 207 | /* Found a conn, but is it in a usable state? Must not add transactions to a conn that is in release, |
| 208 | * and must not start transactions for an unauthenticated subscriber. There will obviously be only one |
| 209 | * conn for this vsub, so return NULL right away. */ |
| 210 | if (!ran_conn_is_accepted(conn)) |
| 211 | return NULL; |
| 212 | return conn; |
Neels Hofmeyr | 1a60644 | 2016-05-10 13:56:43 +0200 | [diff] [blame] | 213 | } |
| 214 | |
| 215 | return NULL; |
| 216 | } |