mirror of
https://github.com/apache/nuttx.git
synced 2026-05-13 10:38:40 +08:00
wangchengdong
faf864b04f
Signals in NuttX serve two primary purposes:
1. Synchronization and wake-up:
Signals can be used to block threads on specific signal sets and later
wake them up by delivering the corresponding signals to those threads.
2. Asynchronous notification:
Signals can also be used to install callback handlers for specific signals, allowing threads to
asynchronously invoke those handlers when the signals are delivered.
This change introduces the ability to disable all signal functionality to reduce footprint for NuttX.
Signed-off-by: Chengdong Wang wangchengdong@lixiang.com
122 lines
3.5 KiB
C
122 lines
3.5 KiB
C
/****************************************************************************
|
|
* sched/pthread/pthread_exit.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 <nuttx/config.h>
|
|
|
|
#include <stdint.h>
|
|
#include <stdlib.h>
|
|
#include <unistd.h>
|
|
#include <signal.h>
|
|
#include <pthread.h>
|
|
#include <assert.h>
|
|
#include <errno.h>
|
|
#include <debug.h>
|
|
|
|
#include <nuttx/arch.h>
|
|
#include <nuttx/signal.h>
|
|
|
|
#include "sched/sched.h"
|
|
#include "task/task.h"
|
|
#include "pthread/pthread.h"
|
|
|
|
/****************************************************************************
|
|
* Public Functions
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Name: pthread_exit
|
|
*
|
|
* Description:
|
|
* Terminate execution of a thread started with pthread_create.
|
|
*
|
|
* Input Parameters:
|
|
* exit_value
|
|
*
|
|
* Returned Value:
|
|
* None
|
|
*
|
|
* Assumptions:
|
|
*
|
|
****************************************************************************/
|
|
|
|
void nx_pthread_exit(FAR void *exit_value)
|
|
{
|
|
FAR struct tcb_s *tcb = this_task();
|
|
#ifndef CONFIG_DISABLE_ALL_SIGNALS
|
|
sigset_t set;
|
|
#endif
|
|
int status;
|
|
|
|
sinfo("exit_value=%p\n", exit_value);
|
|
|
|
DEBUGASSERT(tcb != NULL);
|
|
|
|
/* Block any signal actions that would awaken us while were
|
|
* are performing the JOIN handshake.
|
|
*/
|
|
|
|
#ifndef CONFIG_DISABLE_ALL_SIGNALS
|
|
sigfillset(&set);
|
|
nxsig_procmask(SIG_SETMASK, &set, NULL);
|
|
#endif
|
|
|
|
/* Complete pending join operations */
|
|
|
|
status = pthread_completejoin(nxsched_gettid(), exit_value);
|
|
if (status != OK)
|
|
{
|
|
/* Assume that the join completion failed because this is
|
|
* not really a pthread. Exit by calling exit().
|
|
*/
|
|
|
|
_exit(EXIT_FAILURE);
|
|
}
|
|
|
|
/* Make sure that we are in a critical section with local interrupts.
|
|
* The IRQ state will be restored when the next task is started.
|
|
*/
|
|
|
|
enter_critical_section();
|
|
|
|
/* Perform common task termination logic. This will get called again later
|
|
* through logic kicked off by up_exit().
|
|
*
|
|
* REVISIT: Tt should not be necessary to call this here, but releasing the
|
|
* task group (especially the group file list) requires that it is done
|
|
* here.
|
|
*
|
|
* The reason? up_exit removes the current process from the ready-to-run
|
|
* list and trying to execute code that depends on this_task() crashes at
|
|
* once, or does something very naughty.
|
|
*/
|
|
|
|
tcb->flags |= TCB_FLAG_EXIT_PROCESSING;
|
|
|
|
nxtask_exithook(tcb, status);
|
|
|
|
up_exit(EXIT_SUCCESS);
|
|
}
|