c13f869432
Follow the POSIX description. SIGTSTP should be sent when the Ctrl-Z characters is encountered, not SIGSTP. Testing: Built with hifive1-revb:nsh (CONFIG_SERIAL_TERMIOS=y, CONFIG_SIG_DEFAULT=y and CONFIG_TTY_SIGTSTP=y)
565 lines
16 KiB
C
565 lines
16 KiB
C
/****************************************************************************
|
|
* sched/signal/sig_dispatch.c
|
|
*
|
|
* Copyright (C) 2007, 2009, 2011, 2016, 2018-2019 Gregory Nutt. All
|
|
* rights reserved.
|
|
* Author: Gregory Nutt <gnutt@nuttx.org>
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in
|
|
* the documentation and/or other materials provided with the
|
|
* distribution.
|
|
* 3. Neither the name NuttX nor the names of its contributors may be
|
|
* used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
|
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
|
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
|
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
|
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Included Files
|
|
****************************************************************************/
|
|
|
|
#include <nuttx/config.h>
|
|
|
|
#include <string.h>
|
|
#include <signal.h>
|
|
#include <unistd.h>
|
|
#include <sched.h>
|
|
#include <errno.h>
|
|
#include <debug.h>
|
|
|
|
#include <nuttx/irq.h>
|
|
#include <nuttx/arch.h>
|
|
#include <nuttx/signal.h>
|
|
|
|
#include "sched/sched.h"
|
|
#include "group/group.h"
|
|
#include "semaphore/semaphore.h"
|
|
#include "signal/signal.h"
|
|
#include "mqueue/mqueue.h"
|
|
|
|
/****************************************************************************
|
|
* Private Functions
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Name: nxsig_queue_action
|
|
*
|
|
* Description:
|
|
* Queue a signal action for delivery to a task.
|
|
*
|
|
* Returned Value:
|
|
* Returns 0 (OK) on success or a negated errno value on failure.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static int nxsig_queue_action(FAR struct tcb_s *stcb, siginfo_t *info)
|
|
{
|
|
FAR sigactq_t *sigact;
|
|
FAR sigq_t *sigq;
|
|
irqstate_t flags;
|
|
int ret = OK;
|
|
|
|
sched_lock();
|
|
DEBUGASSERT(stcb != NULL && stcb->group != NULL);
|
|
|
|
/* Find the group sigaction associated with this signal */
|
|
|
|
sigact = nxsig_find_action(stcb->group, info->si_signo);
|
|
|
|
/* Check if a valid signal handler is available and if the signal is
|
|
* unblocked. NOTE: There is no default action.
|
|
*/
|
|
|
|
if ((sigact) && (sigact->act.sa_u._sa_sigaction))
|
|
{
|
|
/* Allocate a new element for the signal queue. NOTE:
|
|
* nxsig_alloc_pendingsigaction will force a system crash if it is
|
|
* unable to allocate memory for the signal data.
|
|
*/
|
|
|
|
sigq = nxsig_alloc_pendingsigaction();
|
|
if (!sigq)
|
|
{
|
|
ret = -ENOMEM;
|
|
}
|
|
else
|
|
{
|
|
/* Populate the new signal queue element */
|
|
|
|
sigq->action.sighandler = sigact->act.sa_u._sa_sigaction;
|
|
sigq->mask = sigact->act.sa_mask;
|
|
memcpy(&sigq->info, info, sizeof(siginfo_t));
|
|
|
|
/* Put it at the end of the pending signals list */
|
|
|
|
flags = enter_critical_section();
|
|
sq_addlast((FAR sq_entry_t *)sigq, &(stcb->sigpendactionq));
|
|
leave_critical_section(flags);
|
|
}
|
|
}
|
|
|
|
sched_unlock();
|
|
return ret;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: nxsig_alloc_pendingsignal
|
|
*
|
|
* Description:
|
|
* Allocate a pending signal list entry
|
|
*
|
|
****************************************************************************/
|
|
|
|
static FAR sigpendq_t *nxsig_alloc_pendingsignal(void)
|
|
{
|
|
FAR sigpendq_t *sigpend;
|
|
irqstate_t flags;
|
|
|
|
/* Check if we were called from an interrupt handler. */
|
|
|
|
if (up_interrupt_context())
|
|
{
|
|
/* Try to get the pending signal structure from the free list */
|
|
|
|
sigpend = (FAR sigpendq_t *)sq_remfirst(&g_sigpendingsignal);
|
|
if (!sigpend)
|
|
{
|
|
/* If no pending signal structure is available in the free list,
|
|
* then try the special list of structures reserved for
|
|
* interrupt handlers
|
|
*/
|
|
|
|
sigpend = (FAR sigpendq_t *)sq_remfirst(&g_sigpendingirqsignal);
|
|
}
|
|
}
|
|
|
|
/* If we were not called from an interrupt handler, then we are
|
|
* free to allocate pending action structures if necessary.
|
|
*/
|
|
|
|
else
|
|
{
|
|
/* Try to get the pending signal structure from the free list */
|
|
|
|
flags = enter_critical_section();
|
|
sigpend = (FAR sigpendq_t *)sq_remfirst(&g_sigpendingsignal);
|
|
leave_critical_section(flags);
|
|
|
|
/* Check if we got one. */
|
|
|
|
if (!sigpend)
|
|
{
|
|
/* No... Allocate the pending signal */
|
|
|
|
if (!sigpend)
|
|
{
|
|
sigpend = (FAR sigpendq_t *)kmm_malloc((sizeof (sigpendq_t)));
|
|
}
|
|
|
|
/* Check if we got an allocated message */
|
|
|
|
if (sigpend)
|
|
{
|
|
sigpend->type = SIG_ALLOC_DYN;
|
|
}
|
|
}
|
|
}
|
|
|
|
return sigpend;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: nxsig_find_pendingsignal
|
|
*
|
|
* Description:
|
|
* Find a specified element in the pending signal list
|
|
*
|
|
****************************************************************************/
|
|
|
|
static FAR sigpendq_t *
|
|
nxsig_find_pendingsignal(FAR struct task_group_s *group, int signo)
|
|
{
|
|
FAR sigpendq_t *sigpend = NULL;
|
|
irqstate_t flags;
|
|
|
|
DEBUGASSERT(group != NULL);
|
|
|
|
/* Pending signals can be added from interrupt level. */
|
|
|
|
flags = enter_critical_section();
|
|
|
|
/* Search the list for a action pending on this signal */
|
|
|
|
for (sigpend = (FAR sigpendq_t *)group->tg_sigpendingq.head;
|
|
(sigpend && sigpend->info.si_signo != signo);
|
|
sigpend = sigpend->flink);
|
|
|
|
leave_critical_section(flags);
|
|
return sigpend;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: nxsig_add_pendingsignal
|
|
*
|
|
* Description:
|
|
* Add the specified signal to the signal pending list. NOTE: This
|
|
* function will queue only one entry for each pending signal. This
|
|
* was done intentionally so that a run-away sender cannot consume
|
|
* all of memory.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void nxsig_add_pendingsignal(FAR struct tcb_s *stcb,
|
|
FAR siginfo_t *info)
|
|
{
|
|
FAR struct task_group_s *group;
|
|
FAR sigpendq_t *sigpend;
|
|
irqstate_t flags;
|
|
|
|
DEBUGASSERT(stcb != NULL && stcb->group != NULL);
|
|
group = stcb->group;
|
|
|
|
/* Check if the signal is already pending for the group */
|
|
|
|
sigpend = nxsig_find_pendingsignal(group, info->si_signo);
|
|
if (sigpend != NULL)
|
|
{
|
|
/* The signal is already pending... retain only one copy */
|
|
|
|
memcpy(&sigpend->info, info, sizeof(siginfo_t));
|
|
}
|
|
|
|
/* No... There is nothing pending in the group for this signo */
|
|
|
|
else
|
|
{
|
|
/* Allocate a new pending signal entry */
|
|
|
|
sigpend = nxsig_alloc_pendingsignal();
|
|
if (sigpend != NULL)
|
|
{
|
|
/* Put the signal information into the allocated structure */
|
|
|
|
memcpy(&sigpend->info, info, sizeof(siginfo_t));
|
|
|
|
/* Add the structure to the group pending signal list */
|
|
|
|
flags = enter_critical_section();
|
|
sq_addlast((FAR sq_entry_t *)sigpend, &group->tg_sigpendingq);
|
|
leave_critical_section(flags);
|
|
}
|
|
}
|
|
|
|
DEBUGASSERT(sigpend);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Public Functions
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Name: nxsig_tcbdispatch
|
|
*
|
|
* Description:
|
|
* All signals received the task (whatever the source) go through this
|
|
* function to be processed. This function is responsible for:
|
|
*
|
|
* - Determining if the signal is blocked.
|
|
* - Queuing and dispatching signal actions
|
|
* - Unblocking tasks that are waiting for signals
|
|
* - Queuing pending signals.
|
|
*
|
|
* This function will deliver the signal to the task associated with
|
|
* the specified TCB. This function should *not* typically be used
|
|
* to dispatch signals since it will *not* follow the group signal
|
|
* deliver algorithms.
|
|
*
|
|
* Returned Value:
|
|
* Returns 0 (OK) on success or a negated errno value on failure.
|
|
*
|
|
****************************************************************************/
|
|
|
|
int nxsig_tcbdispatch(FAR struct tcb_s *stcb, siginfo_t *info)
|
|
{
|
|
irqstate_t flags;
|
|
int masked;
|
|
int ret = OK;
|
|
|
|
sinfo("TCB=0x%08x signo=%d code=%d value=%d mask=%08x\n",
|
|
stcb, info->si_signo, info->si_code,
|
|
info->si_value.sival_int, stcb->sigprocmask);
|
|
|
|
DEBUGASSERT(stcb != NULL && info != NULL);
|
|
|
|
/* Don't actually send a signal for signo 0. */
|
|
|
|
if (info->si_signo == 0)
|
|
{
|
|
return OK;
|
|
}
|
|
|
|
/************************** MASKED SIGNAL ACTIONS *************************/
|
|
|
|
masked = nxsig_ismember(&stcb->sigprocmask, info->si_signo);
|
|
|
|
#ifdef CONFIG_LIB_SYSCALL
|
|
/* Check if the signal is masked OR if the signal is received while we are
|
|
* processing a system call -- in either case, it will be added to the
|
|
* list of pending signals. Unmasked user signal actions will be deferred
|
|
* while we process the system call.
|
|
*
|
|
* If a thread calls a blocking system call, the thread will still be
|
|
* unblocked when the signal occurs (see OTHER SIGNAL HANDLING below), but
|
|
* any associated user signal action will be deferred until the system
|
|
* call returns. For example, if the application calls sem_wait(), the
|
|
* following would occur:
|
|
*
|
|
* 1. System call entry logic will block user signal handling and call
|
|
* sem_wait() in kernel mode.
|
|
* 2. sem_wait() will block,
|
|
* 3. The receipt of the signal will cause any signal action to pend
|
|
* but will unblock sem_wait(),
|
|
* 4. The sem_wait() system call will awaken and return EINTR,
|
|
* 5. The pending signal action will occur after the sem_wait() system
|
|
* call returns to user mode.
|
|
*
|
|
* Syscall handlers (and logic-in-general within the OS) should not use
|
|
* signal handlers.
|
|
*/
|
|
|
|
if ((masked == 1) || (stcb->flags & TCB_FLAG_SYSCALL) != 0)
|
|
#else
|
|
/* Check if the signal is masked. In that case, it will be added to the
|
|
* list of pending signals.
|
|
*/
|
|
|
|
if (masked == 1)
|
|
#endif
|
|
{
|
|
/* Check if the task is waiting for this pending signal. If so, then
|
|
* unblock it. This must be performed in a critical section because
|
|
* signals can be queued from the interrupt level.
|
|
*/
|
|
|
|
flags = enter_critical_section();
|
|
if (stcb->task_state == TSTATE_WAIT_SIG &&
|
|
nxsig_ismember(&stcb->sigwaitmask, info->si_signo))
|
|
{
|
|
memcpy(&stcb->sigunbinfo, info, sizeof(siginfo_t));
|
|
stcb->sigwaitmask = NULL_SIGNAL_SET;
|
|
up_unblock_task(stcb);
|
|
leave_critical_section(flags);
|
|
}
|
|
|
|
/* Its not one we are waiting for... Add it to the list of pending
|
|
* signals.
|
|
*/
|
|
|
|
else
|
|
{
|
|
leave_critical_section(flags);
|
|
nxsig_add_pendingsignal(stcb, info);
|
|
}
|
|
}
|
|
|
|
/************************* UNMASKED SIGNAL ACTIONS ************************/
|
|
|
|
else
|
|
{
|
|
/* Queue any sigaction's requested by this task. */
|
|
|
|
ret = nxsig_queue_action(stcb, info);
|
|
|
|
/* Deliver of the signal must be performed in a critical section */
|
|
|
|
flags = enter_critical_section();
|
|
|
|
/* Then schedule execution of the signal handling action on the
|
|
* recipient's thread. SMP related handling will be done in
|
|
* up_schedule_sigaction()
|
|
*/
|
|
|
|
up_schedule_sigaction(stcb, nxsig_deliver);
|
|
|
|
/* Check if the task is waiting for an unmasked signal. If so, then
|
|
* unblock it. This must be performed in a critical section because
|
|
* signals can be queued from the interrupt level.
|
|
*/
|
|
|
|
if (stcb->task_state == TSTATE_WAIT_SIG)
|
|
{
|
|
memcpy(&stcb->sigunbinfo, info, sizeof(siginfo_t));
|
|
stcb->sigwaitmask = NULL_SIGNAL_SET;
|
|
up_unblock_task(stcb);
|
|
}
|
|
|
|
leave_critical_section(flags);
|
|
|
|
/* If the task neither was waiting for the signal nor had a signal
|
|
* handler attached to the signal, then the default action is
|
|
* simply to ignore the signal
|
|
*/
|
|
}
|
|
|
|
/************************* OTHER SIGNAL HANDLING **************************/
|
|
|
|
/* Performed only if the signal is unmasked. These actions also must
|
|
* happen within a system call.
|
|
*/
|
|
|
|
if (masked == 0)
|
|
{
|
|
/* If the task is blocked waiting for a semaphore, then that task must
|
|
* be unblocked when a signal is received.
|
|
*/
|
|
|
|
if (stcb->task_state == TSTATE_WAIT_SEM)
|
|
{
|
|
nxsem_wait_irq(stcb, EINTR);
|
|
}
|
|
|
|
#ifndef CONFIG_DISABLE_MQUEUE
|
|
/* If the task is blocked waiting on a message queue, then that task
|
|
* must be unblocked when a signal is received.
|
|
*/
|
|
|
|
if (stcb->task_state == TSTATE_WAIT_MQNOTEMPTY ||
|
|
stcb->task_state == TSTATE_WAIT_MQNOTFULL)
|
|
{
|
|
nxmq_wait_irq(stcb, EINTR);
|
|
}
|
|
#endif
|
|
|
|
#ifdef CONFIG_SIG_SIGSTOP_ACTION
|
|
/* If the task was stopped by SIGSTOP or SIGTSTP, then unblock the task
|
|
* if SIGCONT is received.
|
|
*/
|
|
|
|
if (stcb->task_state == TSTATE_TASK_STOPPED &&
|
|
info->si_signo == SIGCONT)
|
|
{
|
|
#ifdef HAVE_GROUP_MEMBERS
|
|
group_continue(stcb);
|
|
#else
|
|
nxsched_continue(stcb);
|
|
#endif
|
|
}
|
|
#endif
|
|
}
|
|
|
|
/* In case nxsig_ismember failed due to an invalid signal number */
|
|
|
|
if (masked < 0)
|
|
{
|
|
ret = -EINVAL;
|
|
}
|
|
|
|
return ret;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: nxsig_dispatch
|
|
*
|
|
* Description:
|
|
* This is the front-end for nxsig_tcbdispatch that should be typically
|
|
* be used to dispatch a signal. If HAVE_GROUP_MEMBERS is defined,
|
|
* then function will follow the group signal delivery algorithms:
|
|
*
|
|
* This front-end does the following things before calling
|
|
* nxsig_tcbdispatch.
|
|
*
|
|
* With HAVE_GROUP_MEMBERS defined:
|
|
* - Get the TCB associated with the pid.
|
|
* - If the TCB was found, get the group from the TCB.
|
|
* - If the PID has already exited, lookup the group that that was
|
|
* started by this task.
|
|
* - Use the group to pick the TCB to receive the signal
|
|
* - Call nxsig_tcbdispatch with the TCB
|
|
*
|
|
* With HAVE_GROUP_MEMBERS *not* defined
|
|
* - Get the TCB associated with the pid.
|
|
* - Call nxsig_tcbdispatch with the TCB
|
|
*
|
|
* Returned Value:
|
|
* Returns 0 (OK) on success or a negated errno value on failure.
|
|
*
|
|
****************************************************************************/
|
|
|
|
int nxsig_dispatch(pid_t pid, FAR siginfo_t *info)
|
|
{
|
|
#ifdef HAVE_GROUP_MEMBERS
|
|
FAR struct tcb_s *stcb;
|
|
FAR struct task_group_s *group;
|
|
|
|
/* Get the TCB associated with the pid */
|
|
|
|
stcb = nxsched_get_tcb(pid);
|
|
if (stcb != NULL)
|
|
{
|
|
/* The task/thread associated with this PID is still active. Get its
|
|
* task group.
|
|
*/
|
|
|
|
group = stcb->group;
|
|
}
|
|
else
|
|
{
|
|
/* The task/thread associated with this PID has exited. In the normal
|
|
* usage model, the PID should correspond to the PID of the task that
|
|
* created the task group. Try looking it up.
|
|
*/
|
|
|
|
group = group_findbypid(pid);
|
|
}
|
|
|
|
/* Did we locate the group? */
|
|
|
|
if (group != NULL)
|
|
{
|
|
/* Yes.. call group_signal() to send the signal to the correct group
|
|
* member.
|
|
*/
|
|
|
|
return group_signal(group, info);
|
|
}
|
|
else
|
|
{
|
|
return -ESRCH;
|
|
}
|
|
|
|
#else
|
|
FAR struct tcb_s *stcb;
|
|
|
|
/* Get the TCB associated with the pid */
|
|
|
|
stcb = nxsched_get_tcb(pid);
|
|
if (stcb == NULL)
|
|
{
|
|
return -ESRCH;
|
|
}
|
|
|
|
return nxsig_tcbdispatch(stcb, info);
|
|
|
|
#endif
|
|
}
|