Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 1 | /* GSM 04.07 Transaction handling */ |
| 2 | |
| 3 | /* (C) 2009 by Harald Welte <laforge@gnumonks.org> |
| 4 | * All Rights Reserved |
| 5 | * |
| 6 | * This program is free software; you can redistribute it and/or modify |
Harald Welte | 9af6ddf | 2011-01-01 15:25:50 +0100 | [diff] [blame] | 7 | * it under the terms of the GNU Affero General Public License as published by |
| 8 | * the Free Software Foundation; either version 3 of the License, or |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 9 | * (at your option) any later version. |
| 10 | * |
| 11 | * This program is distributed in the hope that it will be useful, |
| 12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
Harald Welte | 9af6ddf | 2011-01-01 15:25:50 +0100 | [diff] [blame] | 14 | * GNU Affero General Public License for more details. |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 15 | * |
Harald Welte | 9af6ddf | 2011-01-01 15:25:50 +0100 | [diff] [blame] | 16 | * You should have received a copy of the GNU Affero General Public License |
| 17 | * along with this program. If not, see <http://www.gnu.org/licenses/>. |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 18 | * |
| 19 | */ |
| 20 | |
Neels Hofmeyr | 9084396 | 2017-09-04 15:04:35 +0200 | [diff] [blame] | 21 | #include <osmocom/msc/transaction.h> |
| 22 | #include <osmocom/msc/gsm_data.h> |
| 23 | #include <osmocom/msc/mncc.h> |
| 24 | #include <osmocom/msc/debug.h> |
Pablo Neira Ayuso | 136f453 | 2011-03-22 16:47:59 +0100 | [diff] [blame] | 25 | #include <osmocom/core/talloc.h> |
Neels Hofmeyr | 9084396 | 2017-09-04 15:04:35 +0200 | [diff] [blame] | 26 | #include <osmocom/msc/gsm_04_08.h> |
| 27 | #include <osmocom/msc/mncc.h> |
| 28 | #include <osmocom/msc/paging.h> |
| 29 | #include <osmocom/msc/osmo_msc.h> |
| 30 | #include <osmocom/msc/vlr.h> |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 31 | |
Harald Welte (local) | d19e58b | 2009-08-15 02:30:58 +0200 | [diff] [blame] | 32 | void *tall_trans_ctx; |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 33 | |
Holger Hans Peter Freyther | 34e9749 | 2009-08-10 07:54:02 +0200 | [diff] [blame] | 34 | void _gsm48_cc_trans_free(struct gsm_trans *trans); |
| 35 | |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 36 | /*! Find a transaction in connection for given protocol + transaction ID |
| 37 | * \param[in] conn Connection in whihc we want to find transaction |
| 38 | * \param[in] proto Protocol of transaction |
| 39 | * \param[in] trans_id Transaction ID of transaction |
| 40 | * \returns Matching transaction, if any |
| 41 | */ |
Jacob Erlbeck | dae1f64 | 2014-12-02 14:22:53 +0100 | [diff] [blame] | 42 | struct gsm_trans *trans_find_by_id(struct gsm_subscriber_connection *conn, |
Holger Hans Peter Freyther | c42ad8b | 2011-04-18 17:04:00 +0200 | [diff] [blame] | 43 | uint8_t proto, uint8_t trans_id) |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 44 | { |
| 45 | struct gsm_trans *trans; |
Neels Hofmeyr | a9f2bb5 | 2016-05-09 21:09:47 +0200 | [diff] [blame] | 46 | struct gsm_network *net = conn->network; |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 47 | struct vlr_subscr *vsub = conn->vsub; |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 48 | |
| 49 | llist_for_each_entry(trans, &net->trans_list, entry) { |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 50 | if (trans->vsub == vsub && |
Harald Welte | b8b4073 | 2009-07-23 21:58:40 +0200 | [diff] [blame] | 51 | trans->protocol == proto && |
| 52 | trans->transaction_id == trans_id) |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 53 | return trans; |
| 54 | } |
| 55 | return NULL; |
| 56 | } |
| 57 | |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 58 | /*! Find a transaction by call reference |
| 59 | * \param[in] net Network in which we should search |
| 60 | * \param[in] callref Call Reference of transaction |
| 61 | * \returns Matching transaction, if any |
| 62 | */ |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 63 | struct gsm_trans *trans_find_by_callref(struct gsm_network *net, |
Holger Hans Peter Freyther | c42ad8b | 2011-04-18 17:04:00 +0200 | [diff] [blame] | 64 | uint32_t callref) |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 65 | { |
| 66 | struct gsm_trans *trans; |
| 67 | |
| 68 | llist_for_each_entry(trans, &net->trans_list, entry) { |
| 69 | if (trans->callref == callref) |
| 70 | return trans; |
| 71 | } |
| 72 | return NULL; |
| 73 | } |
| 74 | |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 75 | /*! Allocate a new transaction and add it to network list |
| 76 | * \param[in] net Netwokr in which we allocate transaction |
| 77 | * \param[in] subscr Subscriber for which we allocate transaction |
| 78 | * \param[in] protocol Protocol (CC/SMS/...) |
| 79 | * \param[in] callref Call Reference |
| 80 | * \returns Transaction |
| 81 | */ |
Jacob Erlbeck | af792d6 | 2014-12-02 14:22:53 +0100 | [diff] [blame] | 82 | struct gsm_trans *trans_alloc(struct gsm_network *net, |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 83 | struct vlr_subscr *vsub, |
Holger Hans Peter Freyther | c42ad8b | 2011-04-18 17:04:00 +0200 | [diff] [blame] | 84 | uint8_t protocol, uint8_t trans_id, |
| 85 | uint32_t callref) |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 86 | { |
| 87 | struct gsm_trans *trans; |
| 88 | |
Benoit Bolsee | e7cf5e7 | 2017-07-05 12:34:18 +0200 | [diff] [blame] | 89 | /* a valid subscriber is indispensable */ |
| 90 | if (vsub == NULL) { |
| 91 | LOGP(DCC, LOGL_NOTICE, |
| 92 | "unable to alloc transaction, invalid subscriber (NULL)\n"); |
| 93 | return NULL; |
| 94 | } |
| 95 | |
Neels Hofmeyr | d1ec111 | 2017-11-22 01:58:00 +0100 | [diff] [blame] | 96 | DEBUGP(DCC, "(ti %02x sub %s callref %x) New transaction\n", |
| 97 | trans_id, vlr_subscr_name(vsub), callref); |
| 98 | |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 99 | trans = talloc_zero(tall_trans_ctx, struct gsm_trans); |
| 100 | if (!trans) |
| 101 | return NULL; |
| 102 | |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 103 | trans->vsub = vlr_subscr_get(vsub); |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 104 | |
| 105 | trans->protocol = protocol; |
| 106 | trans->transaction_id = trans_id; |
| 107 | trans->callref = callref; |
| 108 | |
Jacob Erlbeck | f07c605 | 2014-12-02 11:58:00 +0100 | [diff] [blame] | 109 | trans->net = net; |
| 110 | llist_add_tail(&trans->entry, &net->trans_list); |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 111 | |
| 112 | return trans; |
| 113 | } |
| 114 | |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 115 | /*! Release a transaction |
| 116 | * \param[in] trans Transaction to be released |
| 117 | */ |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 118 | void trans_free(struct gsm_trans *trans) |
| 119 | { |
Neels Hofmeyr | 6166f29 | 2017-11-22 14:33:12 +0100 | [diff] [blame] | 120 | enum msc_subscr_conn_use conn_usage_token = MSC_CONN_USE_UNTRACKED; |
| 121 | |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 122 | switch (trans->protocol) { |
| 123 | case GSM48_PDISC_CC: |
| 124 | _gsm48_cc_trans_free(trans); |
Neels Hofmeyr | 6166f29 | 2017-11-22 14:33:12 +0100 | [diff] [blame] | 125 | conn_usage_token = MSC_CONN_USE_TRANS_CC; |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 126 | break; |
Harald Welte (local) | 86b1717 | 2009-08-14 14:52:17 +0200 | [diff] [blame] | 127 | case GSM48_PDISC_SMS: |
| 128 | _gsm411_sms_trans_free(trans); |
Neels Hofmeyr | 6166f29 | 2017-11-22 14:33:12 +0100 | [diff] [blame] | 129 | conn_usage_token = MSC_CONN_USE_TRANS_SMS; |
Harald Welte (local) | 86b1717 | 2009-08-14 14:52:17 +0200 | [diff] [blame] | 130 | break; |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 131 | } |
| 132 | |
Holger Hans Peter Freyther | d6d7aff | 2015-04-06 12:03:45 +0200 | [diff] [blame] | 133 | if (trans->paging_request) { |
| 134 | subscr_remove_request(trans->paging_request); |
Holger Hans Peter Freyther | 49b3ed2 | 2010-12-29 17:09:07 +0100 | [diff] [blame] | 135 | trans->paging_request = NULL; |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 136 | } |
| 137 | |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 138 | if (trans->vsub) { |
| 139 | vlr_subscr_put(trans->vsub); |
| 140 | trans->vsub = NULL; |
Holger Hans Peter Freyther | 405824c | 2012-12-22 18:16:47 +0100 | [diff] [blame] | 141 | } |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 142 | |
| 143 | llist_del(&trans->entry); |
| 144 | |
Holger Hans Peter Freyther | 4049455 | 2010-06-28 17:09:29 +0800 | [diff] [blame] | 145 | if (trans->conn) |
Neels Hofmeyr | 6166f29 | 2017-11-22 14:33:12 +0100 | [diff] [blame] | 146 | msc_subscr_conn_put(trans->conn, conn_usage_token); |
Holger Hans Peter Freyther | 4049455 | 2010-06-28 17:09:29 +0800 | [diff] [blame] | 147 | |
Holger Hans Peter Freyther | 8effcb7 | 2013-12-27 18:07:23 +0100 | [diff] [blame] | 148 | trans->conn = NULL; |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 149 | talloc_free(trans); |
| 150 | } |
| 151 | |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 152 | /*! allocate an unused transaction ID for the given subscriber |
| 153 | * in the given protocol using the ti_flag specified |
| 154 | * \param[in] net GSM network |
| 155 | * \param[in] subscr Subscriber for which to find ID |
| 156 | * \param[in] protocol Protocol for whihc to find ID |
| 157 | * \param[in] ti_flag FIXME |
| 158 | */ |
| 159 | int trans_assign_trans_id(struct gsm_network *net, struct vlr_subscr *vsub, |
Holger Hans Peter Freyther | c42ad8b | 2011-04-18 17:04:00 +0200 | [diff] [blame] | 160 | uint8_t protocol, uint8_t ti_flag) |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 161 | { |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 162 | struct gsm_trans *trans; |
| 163 | unsigned int used_tid_bitmask = 0; |
Sylvain Munaut | 926fcec | 2009-12-24 13:26:17 +0100 | [diff] [blame] | 164 | int i, j, h; |
Harald Welte | 78283ef | 2009-07-23 21:36:44 +0200 | [diff] [blame] | 165 | |
| 166 | if (ti_flag) |
| 167 | ti_flag = 0x8; |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 168 | |
| 169 | /* generate bitmask of already-used TIDs for this (subscr,proto) */ |
| 170 | llist_for_each_entry(trans, &net->trans_list, entry) { |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 171 | if (trans->vsub != vsub || |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 172 | trans->protocol != protocol || |
| 173 | trans->transaction_id == 0xff) |
| 174 | continue; |
| 175 | used_tid_bitmask |= (1 << trans->transaction_id); |
| 176 | } |
| 177 | |
Sylvain Munaut | 926fcec | 2009-12-24 13:26:17 +0100 | [diff] [blame] | 178 | /* find a new one, trying to go in a 'circular' pattern */ |
| 179 | for (h = 6; h > 0; h--) |
| 180 | if (used_tid_bitmask & (1 << (h | ti_flag))) |
| 181 | break; |
Sylvain Munaut | b9f3dce | 2009-12-18 18:28:11 +0100 | [diff] [blame] | 182 | for (i = 0; i < 7; i++) { |
Sylvain Munaut | 926fcec | 2009-12-24 13:26:17 +0100 | [diff] [blame] | 183 | j = ((h + i) % 7) | ti_flag; |
| 184 | if ((used_tid_bitmask & (1 << j)) == 0) |
| 185 | return j; |
Harald Welte | 78283ef | 2009-07-23 21:36:44 +0200 | [diff] [blame] | 186 | } |
| 187 | |
| 188 | return -1; |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 189 | } |
Holger Hans Peter Freyther | 70ae5d3 | 2012-11-23 21:33:15 +0100 | [diff] [blame] | 190 | |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 191 | /*! Check if we have any transaction for given connection |
| 192 | * \param[in] conn Connection to check |
| 193 | * \returns 1 in case there is a transaction, 0 otherwise |
| 194 | */ |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 195 | struct gsm_trans *trans_has_conn(const struct gsm_subscriber_connection *conn) |
Holger Hans Peter Freyther | 70ae5d3 | 2012-11-23 21:33:15 +0100 | [diff] [blame] | 196 | { |
| 197 | struct gsm_trans *trans; |
| 198 | |
Neels Hofmeyr | a9f2bb5 | 2016-05-09 21:09:47 +0200 | [diff] [blame] | 199 | llist_for_each_entry(trans, &conn->network->trans_list, entry) |
Holger Hans Peter Freyther | 70ae5d3 | 2012-11-23 21:33:15 +0100 | [diff] [blame] | 200 | if (trans->conn == conn) |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 201 | return trans; |
Holger Hans Peter Freyther | 70ae5d3 | 2012-11-23 21:33:15 +0100 | [diff] [blame] | 202 | |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 203 | return NULL; |
Holger Hans Peter Freyther | 70ae5d3 | 2012-11-23 21:33:15 +0100 | [diff] [blame] | 204 | } |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 205 | |
| 206 | /*! Free all transactions associated with a connection, presumably when the |
| 207 | * conn is being closed. The transaction code will inform the CC or SMS |
| 208 | * facilities, which will then send the necessary release indications. |
| 209 | * \param[in] conn Connection that is going to be closed. |
| 210 | */ |
| 211 | void trans_conn_closed(struct gsm_subscriber_connection *conn) |
| 212 | { |
| 213 | struct gsm_trans *trans; |
| 214 | |
| 215 | /* As part of the CC REL_IND the remote leg might be released and this |
| 216 | * will trigger another call to trans_free. This is something the llist |
| 217 | * macro can not handle and we need to re-iterate the list every time. |
| 218 | */ |
| 219 | restart: |
| 220 | llist_for_each_entry(trans, &conn->network->trans_list, entry) { |
| 221 | if (trans->conn == conn) { |
| 222 | trans_free(trans); |
| 223 | goto restart; |
| 224 | } |
| 225 | } |
| 226 | } |