nuttx/libs/libc/stdlib/lib_abort.c
Alin Jerpelea d6b50a1d3f libs: nxstyle fixes
nxstyle fixes to pass the CI checks

Signed-off-by: Alin Jerpelea <alin.jerpelea@sony.com>
2021-03-03 18:52:53 -08:00

84 lines
3.2 KiB
C

/****************************************************************************
* libs/libc/stdlib/lib_abort.c
*
* 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 <stdlib.h>
#include <pthread.h>
/****************************************************************************
* Public Functions
****************************************************************************/
/****************************************************************************
* Name: Abort
*
* Description:
* The abort() first unblocks the SIGABRT signal, and then raises that
* signal for the calling process. This results in the abnormal
* termination of the process unless the SIGABRT signal is caught and
* the signal handler does not return.
*
* If the abort() function causes process termination, all open
* streams are closed and flushed.
*
* If the SIGABRT signal is ignored, or caught by a handler that
* returns, the abort() function will still terminate the process.
* It does this by restoring the default disposition for SIGABRT and
* then raising the signal for a second time.
*
* Input Parameters:
* None
*
* Returned Value:
* This function does not return,
*
****************************************************************************/
void abort(void)
{
/* NuttX does not support standard signal functionality (like the
* behavior of the SIGABRT signal). So no attempt is made to provide
* a conformant version of abort() at this time. This version does not
* signal the calling thread all.
*
* Note that pthread_exit() is called instead of exit(). That is because
* we do no know if abort was called from a pthread or a normal thread
* (we could find out, of course). If abort() is called from a
* non-pthread, then pthread_exit() should fail and fall back to call
* exit() anyway.
*
* If exit() is called (either below or via pthread_exit()), then exit()
* will flush and close all open files and terminate the thread. If this
* function was called from a pthread, then pthread_exit() will complete
* any joins, but will not flush or close any streams.
*/
#ifdef CONFIG_DISABLE_PTHREAD
exit(EXIT_FAILURE);
#else
pthread_exit(NULL);
#endif
}