Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 1 | /* |
Holger Hans Peter Freyther | c7f52c4 | 2016-11-12 21:25:21 +0100 | [diff] [blame] | 2 | * (C) 2010-2016 by Holger Hans Peter Freyther |
Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 3 | * (C) 2010 by On-Waves |
| 4 | * |
| 5 | * All Rights Reserved |
| 6 | * |
Harald Welte | e08da97 | 2017-11-13 01:00:26 +0900 | [diff] [blame] | 7 | * SPDX-License-Identifier: GPL-2.0+ |
| 8 | * |
Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 9 | * This program is free software; you can redistribute it and/or modify |
| 10 | * it under the terms of the GNU General Public License as published by |
| 11 | * the Free Software Foundation; either version 2 of the License, or |
| 12 | * (at your option) any later version. |
| 13 | * |
| 14 | * This program is distributed in the hope that it will be useful, |
| 15 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 16 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 17 | * GNU General Public License for more details. |
| 18 | * |
| 19 | * You should have received a copy of the GNU General Public License along |
| 20 | * with this program; if not, write to the Free Software Foundation, Inc., |
| 21 | * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. |
| 22 | * |
| 23 | */ |
| 24 | |
Daniel Willmann | bd8a89d | 2014-06-10 10:02:24 +0200 | [diff] [blame] | 25 | #include <errno.h> |
Pablo Neira Ayuso | 8341934 | 2011-03-22 16:36:13 +0100 | [diff] [blame] | 26 | #include <osmocom/core/write_queue.h> |
Holger Hans Peter Freyther | c7f52c4 | 2016-11-12 21:25:21 +0100 | [diff] [blame] | 27 | #include <osmocom/core/logging.h> |
Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 28 | |
Harald Welte | 2777ecd | 2011-08-17 14:23:42 +0200 | [diff] [blame] | 29 | /*! \addtogroup write_queue |
| 30 | * @{ |
Neels Hofmeyr | 17518fe | 2017-06-20 04:35:06 +0200 | [diff] [blame] | 31 | * Write queue for writing \ref msgb to sockets/fds. |
| 32 | * |
| 33 | * \file write_queue.c */ |
Harald Welte | 2777ecd | 2011-08-17 14:23:42 +0200 | [diff] [blame] | 34 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 35 | /*! Select loop function for write queue handling |
Harald Welte | 2777ecd | 2011-08-17 14:23:42 +0200 | [diff] [blame] | 36 | * \param[in] fd osmocom file descriptor |
| 37 | * \param[in] what bit-mask of events that have happened |
Harald Welte | 2d2e2cc | 2016-04-25 12:11:20 +0200 | [diff] [blame] | 38 | * \returns 0 on success; negative on error |
Harald Welte | 2777ecd | 2011-08-17 14:23:42 +0200 | [diff] [blame] | 39 | * |
| 40 | * This function is provided so that it can be registered with the |
| 41 | * select loop abstraction code (\ref osmo_fd::cb). |
| 42 | */ |
Pablo Neira Ayuso | 9111d93 | 2011-05-07 12:42:51 +0200 | [diff] [blame] | 43 | int osmo_wqueue_bfd_cb(struct osmo_fd *fd, unsigned int what) |
Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 44 | { |
Pablo Neira Ayuso | 9111d93 | 2011-05-07 12:42:51 +0200 | [diff] [blame] | 45 | struct osmo_wqueue *queue; |
Daniel Willmann | bd8a89d | 2014-06-10 10:02:24 +0200 | [diff] [blame] | 46 | int rc; |
Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 47 | |
Pablo Neira Ayuso | 9111d93 | 2011-05-07 12:42:51 +0200 | [diff] [blame] | 48 | queue = container_of(fd, struct osmo_wqueue, bfd); |
Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 49 | |
Harald Welte | 1688699 | 2019-03-20 10:26:39 +0100 | [diff] [blame] | 50 | if (what & OSMO_FD_READ) { |
Daniel Willmann | bd8a89d | 2014-06-10 10:02:24 +0200 | [diff] [blame] | 51 | rc = queue->read_cb(fd); |
Holger Hans Peter Freyther | eb55e6a | 2014-07-01 19:39:26 +0200 | [diff] [blame] | 52 | if (rc == -EBADF) |
Daniel Willmann | bd8a89d | 2014-06-10 10:02:24 +0200 | [diff] [blame] | 53 | goto err_badfd; |
| 54 | } |
Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 55 | |
Harald Welte | 1688699 | 2019-03-20 10:26:39 +0100 | [diff] [blame] | 56 | if (what & OSMO_FD_EXCEPT) { |
Daniel Willmann | bd8a89d | 2014-06-10 10:02:24 +0200 | [diff] [blame] | 57 | rc = queue->except_cb(fd); |
Holger Hans Peter Freyther | eb55e6a | 2014-07-01 19:39:26 +0200 | [diff] [blame] | 58 | if (rc == -EBADF) |
Daniel Willmann | bd8a89d | 2014-06-10 10:02:24 +0200 | [diff] [blame] | 59 | goto err_badfd; |
| 60 | } |
Holger Hans Peter Freyther | 4052c81 | 2010-04-08 10:58:20 +0200 | [diff] [blame] | 61 | |
Harald Welte | 1688699 | 2019-03-20 10:26:39 +0100 | [diff] [blame] | 62 | if (what & OSMO_FD_WRITE) { |
Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 63 | struct msgb *msg; |
| 64 | |
Harald Welte | 1688699 | 2019-03-20 10:26:39 +0100 | [diff] [blame] | 65 | fd->when &= ~OSMO_FD_WRITE; |
Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 66 | |
Harald Welte | f449378 | 2020-09-27 16:39:01 +0200 | [diff] [blame] | 67 | msg = msgb_dequeue_count(&queue->msg_queue, &queue->current_length); |
Holger Hans Peter Freyther | 76681ba | 2011-02-15 00:42:19 +0100 | [diff] [blame] | 68 | /* the queue might have been emptied */ |
Harald Welte | f449378 | 2020-09-27 16:39:01 +0200 | [diff] [blame] | 69 | if (msg) { |
Daniel Willmann | bd8a89d | 2014-06-10 10:02:24 +0200 | [diff] [blame] | 70 | rc = queue->write_cb(fd, msg); |
Harald Welte | c433889 | 2020-09-27 16:46:25 +0200 | [diff] [blame] | 71 | if (rc == -EBADF) { |
| 72 | msgb_free(msg); |
Daniel Willmann | bd8a89d | 2014-06-10 10:02:24 +0200 | [diff] [blame] | 73 | goto err_badfd; |
Harald Welte | c433889 | 2020-09-27 16:46:25 +0200 | [diff] [blame] | 74 | } else if (rc == -EAGAIN) { |
| 75 | /* re-enqueue the msgb to the head of the queue */ |
| 76 | llist_add(&msg->list, &queue->msg_queue); |
| 77 | queue->current_length++; |
| 78 | } else |
| 79 | msgb_free(msg); |
Daniel Willmann | bd8a89d | 2014-06-10 10:02:24 +0200 | [diff] [blame] | 80 | |
Holger Hans Peter Freyther | 76681ba | 2011-02-15 00:42:19 +0100 | [diff] [blame] | 81 | if (!llist_empty(&queue->msg_queue)) |
Harald Welte | 1688699 | 2019-03-20 10:26:39 +0100 | [diff] [blame] | 82 | fd->when |= OSMO_FD_WRITE; |
Holger Hans Peter Freyther | 76681ba | 2011-02-15 00:42:19 +0100 | [diff] [blame] | 83 | } |
Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 84 | } |
| 85 | |
Daniel Willmann | bd8a89d | 2014-06-10 10:02:24 +0200 | [diff] [blame] | 86 | err_badfd: |
| 87 | /* Return value is not checked in osmo_select_main() */ |
Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 88 | return 0; |
| 89 | } |
| 90 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 91 | /*! Initialize a \ref osmo_wqueue structure |
Harald Welte | 2777ecd | 2011-08-17 14:23:42 +0200 | [diff] [blame] | 92 | * \param[in] queue Write queue to operate on |
| 93 | * \param[in] max_length Maximum length of write queue |
| 94 | */ |
Pablo Neira Ayuso | 9111d93 | 2011-05-07 12:42:51 +0200 | [diff] [blame] | 95 | void osmo_wqueue_init(struct osmo_wqueue *queue, int max_length) |
Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 96 | { |
| 97 | queue->max_length = max_length; |
| 98 | queue->current_length = 0; |
| 99 | queue->read_cb = NULL; |
| 100 | queue->write_cb = NULL; |
Holger Hans Peter Freyther | c7f52c4 | 2016-11-12 21:25:21 +0100 | [diff] [blame] | 101 | queue->except_cb = NULL; |
Pablo Neira Ayuso | 9111d93 | 2011-05-07 12:42:51 +0200 | [diff] [blame] | 102 | queue->bfd.cb = osmo_wqueue_bfd_cb; |
Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 103 | INIT_LLIST_HEAD(&queue->msg_queue); |
| 104 | } |
| 105 | |
Harald Welte | 66138cc | 2020-09-26 22:02:27 +0200 | [diff] [blame] | 106 | /*! Enqueue a new \ref msgb into a write queue (without logging full queue events) |
| 107 | * \param[in] queue Write queue to be used |
| 108 | * \param[in] data to-be-enqueued message buffer |
| 109 | * \returns 0 on success; negative on error |
| 110 | */ |
| 111 | int osmo_wqueue_enqueue_quiet(struct osmo_wqueue *queue, struct msgb *data) |
| 112 | { |
| 113 | if (queue->current_length >= queue->max_length) |
| 114 | return -ENOSPC; |
| 115 | |
Harald Welte | f449378 | 2020-09-27 16:39:01 +0200 | [diff] [blame] | 116 | msgb_enqueue_count(&queue->msg_queue, data, &queue->current_length); |
Harald Welte | 66138cc | 2020-09-26 22:02:27 +0200 | [diff] [blame] | 117 | queue->bfd.when |= OSMO_FD_WRITE; |
| 118 | |
| 119 | return 0; |
| 120 | } |
| 121 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 122 | /*! Enqueue a new \ref msgb into a write queue |
Harald Welte | 2777ecd | 2011-08-17 14:23:42 +0200 | [diff] [blame] | 123 | * \param[in] queue Write queue to be used |
| 124 | * \param[in] data to-be-enqueued message buffer |
Harald Welte | 2d2e2cc | 2016-04-25 12:11:20 +0200 | [diff] [blame] | 125 | * \returns 0 on success; negative on error |
Harald Welte | 2777ecd | 2011-08-17 14:23:42 +0200 | [diff] [blame] | 126 | */ |
Pablo Neira Ayuso | 9111d93 | 2011-05-07 12:42:51 +0200 | [diff] [blame] | 127 | int osmo_wqueue_enqueue(struct osmo_wqueue *queue, struct msgb *data) |
Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 128 | { |
Holger Hans Peter Freyther | c7f52c4 | 2016-11-12 21:25:21 +0100 | [diff] [blame] | 129 | if (queue->current_length >= queue->max_length) { |
| 130 | LOGP(DLGLOBAL, LOGL_ERROR, |
| 131 | "wqueue(%p) is full. Rejecting msgb\n", queue); |
| 132 | return -ENOSPC; |
| 133 | } |
Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 134 | |
Harald Welte | 66138cc | 2020-09-26 22:02:27 +0200 | [diff] [blame] | 135 | return osmo_wqueue_enqueue_quiet(queue, data); |
Holger Hans Peter Freyther | 8df932a | 2010-02-26 20:30:32 +0100 | [diff] [blame] | 136 | } |
Holger Hans Peter Freyther | 99a263f | 2010-03-26 09:20:22 +0100 | [diff] [blame] | 137 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 138 | /*! Clear a \ref osmo_wqueue |
Harald Welte | 2777ecd | 2011-08-17 14:23:42 +0200 | [diff] [blame] | 139 | * \param[in] queue Write queue to be cleared |
| 140 | * |
| 141 | * This function will clear (remove/release) all messages in it. |
| 142 | */ |
Pablo Neira Ayuso | 9111d93 | 2011-05-07 12:42:51 +0200 | [diff] [blame] | 143 | void osmo_wqueue_clear(struct osmo_wqueue *queue) |
Holger Hans Peter Freyther | 99a263f | 2010-03-26 09:20:22 +0100 | [diff] [blame] | 144 | { |
| 145 | while (!llist_empty(&queue->msg_queue)) { |
| 146 | struct msgb *msg = msgb_dequeue(&queue->msg_queue); |
| 147 | msgb_free(msg); |
| 148 | } |
| 149 | |
| 150 | queue->current_length = 0; |
Harald Welte | 1688699 | 2019-03-20 10:26:39 +0100 | [diff] [blame] | 151 | queue->bfd.when &= ~OSMO_FD_WRITE; |
Holger Hans Peter Freyther | 99a263f | 2010-03-26 09:20:22 +0100 | [diff] [blame] | 152 | } |
Harald Welte | 2777ecd | 2011-08-17 14:23:42 +0200 | [diff] [blame] | 153 | |
Sylvain Munaut | dca7d2c | 2012-04-18 21:53:23 +0200 | [diff] [blame] | 154 | /*! @} */ |