/**************************************************************************** * sched/mqueue/mq_timedsend.c * * SPDX-License-Identifier: Apache-2.0 * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. The * ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the * License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the * License for the specific language governing permissions and limitations * under the License. * ****************************************************************************/ /**************************************************************************** * Included Files ****************************************************************************/ #include #include #include #include #include #include #include #include #include #include #include #include #include #include "clock/clock.h" #include "sched/sched.h" #include "mqueue/mqueue.h" /**************************************************************************** * Private Functions ****************************************************************************/ /**************************************************************************** * Name: nxmq_sndtimeout * * Description: * This function is called if the timeout elapses before the message queue * becomes non-full. * * Input Parameters: * pid - the task ID of the task to wakeup * * Returned Value: * None * * Assumptions: * ****************************************************************************/ static void nxmq_sndtimeout(wdparm_t pid) { FAR struct tcb_s *wtcb; irqstate_t flags; /* Disable interrupts. This is necessary because an interrupt handler may * attempt to send a message while we are doing this. */ flags = enter_critical_section(); /* Get the TCB associated with this pid. It is possible that task may no * longer be active when this watchdog goes off. */ wtcb = nxsched_get_tcb(pid); /* It is also possible that an interrupt/context switch beat us to the * punch and already changed the task's state. */ if (wtcb != NULL && wtcb->task_state == TSTATE_WAIT_MQNOTFULL) { /* Restart with task with a timeout error */ nxmq_wait_irq(wtcb, ETIMEDOUT); } /* Interrupts may now be re-enabled. */ leave_critical_section(flags); } /**************************************************************************** * Public Functions ****************************************************************************/ /**************************************************************************** * Name: file_mq_timedsend_internal * * Description: * This is an internal function of file_mq_timedsend()/file_mq_ticksend(), * please refer to the detailed description for more information. * * Input Parameters: * mq - Message queue descriptor * msg - Message to send * msglen - The length of the message in bytes * prio - The priority of the message * abstime - the absolute time to wait until a timeout is decleared * ticks - Ticks to wait from the start time until the semaphore is * posted. * * Returned Value: * This is an internal OS interface and should not be used by applications. * It follows the NuttX internal error return policy: Zero (OK) is * returned on success. A negated errno value is returned on failure. * (see mq_timedsend() for the list list valid return values). * * EAGAIN The queue was empty, and the O_NONBLOCK flag was set for the * message queue description referred to by mq. * EINVAL Either msg or mq is NULL or the value of prio is invalid. * EBADF Message queue opened not opened for writing. * EMSGSIZE 'msglen' was greater than the maxmsgsize attribute of the * message queue. * EINTR The call was interrupted by a signal handler. * ****************************************************************************/ static int file_mq_timedsend_internal(FAR struct file *mq, FAR const char *msg, size_t msglen, unsigned int prio, FAR const struct timespec *abstime, sclock_t ticks) { FAR struct tcb_s *rtcb = this_task(); FAR struct mqueue_inode_s *msgq; FAR struct mqueue_msg_s *mqmsg; irqstate_t flags; int ret; /* Verify the input parameters on any failures to verify. */ ret = nxmq_verify_send(mq, msg, msglen, prio); if (ret < 0) { return ret; } msgq = mq->f_inode->i_private; /* Disable interruption */ flags = enter_critical_section(); /* Pre-allocate a message structure */ mqmsg = nxmq_alloc_msg(); if (mqmsg == NULL) { /* Failed to allocate the message. nxmq_alloc_msg() does not set the * errno value. */ ret = -ENOMEM; goto errout_in_critical_section; } /* OpenGroup.org: "Under no circumstance shall the operation fail with a * timeout if there is sufficient room in the queue to add the message * immediately. The validity of the abstime parameter need not be checked * when there is sufficient room in the queue." * * Also ignore the time value if for some crazy reason we were called from * an interrupt handler. This probably really should be an assertion. * * NOTE: There is a race condition here: What if a message is added by * interrupt related logic so that queue again becomes non-empty. That * is handled because nxmq_do_send() will permit the maxmsgs limit to be * exceeded in that case. */ if (msgq->nmsgs < msgq->maxmsgs || up_interrupt_context()) { /* Do the send with no further checks (possibly exceeding maxmsgs) * Currently nxmq_do_send() always returns OK. */ goto out_send_message; } /* The message queue is full... We are going to wait. * Now we must have a valid time value. */ if (abstime != NULL) { if (abstime->tv_nsec < 0 || abstime->tv_nsec >= 1000000000) { ret = -EINVAL; } else { /* We are not in an interrupt handler and the message queue * is full. Set up a timed wait for the message queue to * become non-full. * * Convert the timespec to clock ticks. We must have interrupts * disabled here so that this time stays valid until the wait * begins. */ clock_abstime2ticks(CLOCK_REALTIME, abstime, &ticks); } /* Handle any time-related errors */ if (ret != OK) { nxmq_free_msg(mqmsg); goto errout_in_critical_section; } } /* If the time has already expired and the message queue is empty, * return immediately. */ if (ticks <= 0) { ret = -ETIMEDOUT; nxmq_free_msg(mqmsg); goto errout_in_critical_section; } /* Start the watchdog and begin the wait for MQ not full */ wd_start(&rtcb->waitdog, ticks, nxmq_sndtimeout, nxsched_gettid()); /* And wait for the message queue to be non-empty */ ret = nxmq_wait_send(msgq, mq->f_oflags); /* This may return with an error and errno set to either EINTR * or ETIMEDOUT. Cancel the watchdog timer in any event. */ wd_cancel(&rtcb->waitdog); /* Check if nxmq_wait_send() failed */ if (ret == OK) { /* If any of the above failed, set the errno. Otherwise, there should * be space for another message in the message queue. NOW we can * allocate the message structure. * * Currently nxmq_do_send() always returns OK. */ out_send_message: ret = nxmq_do_send(msgq, mqmsg, msg, msglen, prio); } else { /* free the message as it can't be sent */ nxmq_free_msg(mqmsg); } /* Exit here with (1) the scheduler locked, (2) a message allocated, (3) a * wdog allocated, and (4) interrupts disabled. */ errout_in_critical_section: leave_critical_section(flags); return ret; } /**************************************************************************** * Name: file_mq_timedsend * * Description: * This function adds the specified message (msg) to the message queue * (mq). file_mq_timedsend() behaves just like mq_send(), except that if * the queue is full and the O_NONBLOCK flag is not enabled for the * message queue description, then abstime points to a structure which * specifies a ceiling on the time for which the call will block. * * file_mq_timedsend() is functionally equivalent to mq_timedsend() except * that: * * - It is not a cancellation point, and * - It does not modify the errno value. * * See comments with mq_timedsend() for a more complete description of the * behavior of this function * * Input Parameters: * mq - Message queue descriptor * msg - Message to send * msglen - The length of the message in bytes * prio - The priority of the message * abstime - the absolute time to wait until a timeout is decleared * * Returned Value: * This is an internal OS interface and should not be used by applications. * It follows the NuttX internal error return policy: Zero (OK) is * returned on success. A negated errno value is returned on failure. * (see mq_timedsend() for the list list valid return values). * * EAGAIN The queue was empty, and the O_NONBLOCK flag was set for the * message queue description referred to by mq. * EINVAL Either msg or mq is NULL or the value of prio is invalid. * EBADF Message queue opened not opened for writing. * EMSGSIZE 'msglen' was greater than the maxmsgsize attribute of the * message queue. * EINTR The call was interrupted by a signal handler. * ****************************************************************************/ int file_mq_timedsend(FAR struct file *mq, FAR const char *msg, size_t msglen, unsigned int prio, FAR const struct timespec *abstime) { return file_mq_timedsend_internal(mq, msg, msglen, prio, abstime, 0); } /**************************************************************************** * Name: file_mq_ticksend * * Description: * This function adds the specified message (msg) to the message queue * (mq). file_mq_ticksend() behaves just like mq_send(), except that if * the queue is full and the O_NONBLOCK flag is not enabled for the * message queue description, then abstime points to a structure which * specifies a ceiling on the time for which the call will block. * * file_mq_ticksend() is functionally equivalent to mq_timedsend() except * that: * * - It is not a cancellation point, and * - It does not modify the errno value. * * See comments with mq_timedsend() for a more complete description of the * behavior of this function * * Input Parameters: * mq - Message queue descriptor * msg - Message to send * msglen - The length of the message in bytes * prio - The priority of the message * ticks - Ticks to wait from the start time until the semaphore is * posted. * * Returned Value: * This is an internal OS interface and should not be used by applications. * It follows the NuttX internal error return policy: Zero (OK) is * returned on success. A negated errno value is returned on failure. * (see mq_timedsend() for the list list valid return values). * * EAGAIN The queue was empty, and the O_NONBLOCK flag was set for the * message queue description referred to by mq. * EINVAL Either msg or mq is NULL or the value of prio is invalid. * EBADF Message queue opened not opened for writing. * EMSGSIZE 'msglen' was greater than the maxmsgsize attribute of the * message queue. * EINTR The call was interrupted by a signal handler. * ****************************************************************************/ int file_mq_ticksend(FAR struct file *mq, FAR const char *msg, size_t msglen, unsigned int prio, sclock_t ticks) { return file_mq_timedsend_internal(mq, msg, msglen, prio, NULL, ticks); } /**************************************************************************** * Name: nxmq_timedsend * * Description: * This function adds the specified message (msg) to the message queue * (mqdes). nxmq_timedsend() behaves just like mq_send(), except * that if the queue is full and the O_NONBLOCK flag is not enabled for * the message queue description, then abstime points to a structure which * specifies a ceiling on the time for which the call will block. * * nxmq_timedsend() is functionally equivalent to mq_timedsend() except * that: * * - It is not a cancellation point, and * - It does not modify the errno value. * * See comments with mq_timedsend() for a more complete description of the * behavior of this function * * Input Parameters: * mqdes - Message queue descriptor * msg - Message to send * msglen - The length of the message in bytes * prio - The priority of the message * abstime - the absolute time to wait until a timeout is decleared * * Returned Value: * This is an internal OS interface and should not be used by applications. * It follows the NuttX internal error return policy: Zero (OK) is * returned on success. A negated errno value is returned on failure. * (see mq_timedsend() for the list list valid return values). * * EAGAIN The queue was empty, and the O_NONBLOCK flag was set for the * message queue description referred to by mqdes. * EINVAL Either msg or mqdes is NULL or the value of prio is invalid. * EBADF Message queue opened not opened for writing. * EMSGSIZE 'msglen' was greater than the maxmsgsize attribute of the * message queue. * EINTR The call was interrupted by a signal handler. * ****************************************************************************/ int nxmq_timedsend(mqd_t mqdes, FAR const char *msg, size_t msglen, unsigned int prio, FAR const struct timespec *abstime) { FAR struct file *filep; int ret; ret = fs_getfilep(mqdes, &filep); if (ret < 0) { return ret; } ret = file_mq_timedsend_internal(filep, msg, msglen, prio, abstime, 0); fs_putfilep(filep); return ret; } /**************************************************************************** * Name: mq_timedsend * * Description: * This function adds the specified message (msg) to the message queue * (mqdes). The "msglen" parameter specifies the length of the message * in bytes pointed to by "msg." This length must not exceed the maximum * message length from the mq_getattr(). * * If the message queue is not full, mq_timedsend() place the message in * the message queue at the position indicated by the "prio" argrument. * Messages with higher priority will be inserted before lower priority * messages. The value of "prio" must not exceed MQ_PRIO_MAX. * * If the specified message queue is full and O_NONBLOCK is not set in the * message queue, then mq_timedsend() will block until space becomes * available to the queue the message or a timeout occurs. * * mq_timedsend() behaves just like mq_send(), except that if the queue * is full and the O_NONBLOCK flag is not enabled for the message queue * description, then abstime points to a structure which specifies a * ceiling on the time for which the call will block. This ceiling is an * absolute timeout in seconds and nanoseconds since the Epoch (midnight * on the morning of 1 January 1970). * * If the message queue is full, and the timeout has already expired by * the time of the call, mq_timedsend() returns immediately. * * Input Parameters: * mqdes - Message queue descriptor * msg - Message to send * msglen - The length of the message in bytes * prio - The priority of the message * abstime - the absolute time to wait until a timeout is decleared * * Returned Value: * On success, mq_send() returns 0 (OK); on error, -1 (ERROR) * is returned, with errno set to indicate the error: * * EAGAIN The queue was full, and the O_NONBLOCK flag was set for the * message queue description referred to by mqdes. * EINVAL Either msg or mqdes is NULL or the value of prio is invalid. * EBADF Message queue opened not opened for writing. * EMSGSIZE 'msglen' was greater than the maxmsgsize attribute of the * message queue. * EINTR The call was interrupted by a signal handler. * * Assumptions/restrictions: * ****************************************************************************/ int mq_timedsend(mqd_t mqdes, FAR const char *msg, size_t msglen, unsigned int prio, FAR const struct timespec *abstime) { int ret; /* mq_timedsend() is a cancellation point */ enter_cancellation_point(); /* Let nxmq_send() do all of the work */ ret = nxmq_timedsend(mqdes, msg, msglen, prio, abstime); if (ret < 0) { set_errno(-ret); ret = ERROR; } leave_cancellation_point(); return ret; }