# ==================================================================== # # signals.cdl # # C library signal related configuration data # # ==================================================================== ## ####ECOSGPLCOPYRIGHTBEGIN#### ## ------------------------------------------- ## This file is part of eCos, the Embedded Configurable Operating System. ## Copyright (C) 1998, 1999, 2000, 2001, 2002 Free Software Foundation, Inc. ## ## eCos is free software; you can redistribute it and/or modify it under ## the terms of the GNU General Public License as published by the Free ## Software Foundation; either version 2 or (at your option) any later ## version. ## ## eCos is distributed in the hope that it will be useful, but WITHOUT ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or ## FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License ## for more details. ## ## You should have received a copy of the GNU General Public License ## along with eCos; if not, write to the Free Software Foundation, Inc., ## 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. ## ## As a special exception, if other files instantiate templates or use ## macros or inline functions from this file, or you compile this file ## and link it with other works to produce a work based on this file, ## this file does not by itself cause the resulting work to be covered by ## the GNU General Public License. However the source code for this file ## must still be made available in accordance with section (3) of the GNU ## General Public License v2. ## ## This exception does not invalidate any other reasons why a work based ## on this file might be covered by the GNU General Public License. ## ------------------------------------------- ## ####ECOSGPLCOPYRIGHTEND#### # ==================================================================== ######DESCRIPTIONBEGIN#### # # Author(s): jlarmour # Contributors: # Date: 2000-04-14 # #####DESCRIPTIONEND#### # # ==================================================================== cdl_package CYGPKG_LIBC_SIGNALS { display "ISO C library signal functions" description " This component controls signal functionality, as implemented in ISO/IEC 9899:1990 chapter 7.7 with the signal() and raise() functions. As well as allowing a program to send itself signals, it is also possible to cause hardware exceptions to be signalled to the program in a similar way." doc ref/libc.html include_dir cyg/libc/signals parent CYGPKG_LIBC implements CYGINT_ISO_SIGNAL_NUMBERS implements CYGINT_ISO_SIGNAL_IMPL requires { CYGBLD_ISO_SIGNAL_NUMBERS_HEADER == \ "" } requires { CYGBLD_ISO_SIGNAL_IMPL_HEADER == \ "" } requires CYGPKG_ISOINFRA compile raise.cxx siginit.cxx signal.cxx # ==================================================================== cdl_option CYGSEM_LIBC_SIGNALS_THREAD_SAFE { display "Thread safe signals" requires CYGPKG_KERNEL default_value 1 description " Because signal handlers are global, and not thread-specific (as mandated by POSIX 1003.1) it is possible for multiple threads to clash and corrupt data if setting the same signal handler at the same time. With this option enabled, a kernel mutex will be used to protect the shared data." } cdl_component CYGSEM_LIBC_SIGNALS_HWEXCEPTIONS { display "Hardware exceptions cause signals" flavor bool requires CYGSEM_KERNEL_EXCEPTIONS_GLOBAL requires CYGSEM_KERNEL_EXCEPTIONS_DECODE default_value 0 description " This causes hardware exceptions like arithmetic exceptions (e.g. divide by zero) or bad memory accesses to be passed through as signals. It is thus possible for a program to handle these exceptions in a generic way using the appropriate signal handlers. The details of exactly which exceptions are passed through under what circumstances depend on the underlying HAL implementation. Consequently it must be remembered that signal handlers cannot be guaranteed to be invoked in the expected circumstances if you do not know about the underlying HAL implementation - it is possible that the architecture is unable to detect that exception." cdl_option CYGSEM_LIBC_SIGNALS_CHAIN_HWEXCEPTIONS { display "Chain old exception handlers" default_value 1 description " When hardware exceptions are generated, it is possible to chain into the old kernel exception handler before calling any registered signal handler. If this is not required, disable this option and only the signal handler will be called when this exception occurs. Disabling this option will also save some space and code usage." } } cdl_component CYGPKG_LIBC_SIGNALS_INLINE { display "Inline versions of functions" flavor none description " Some functions can be made inline instead of being function calls. These can be set here." cdl_option CYGIMP_LIBC_SIGNALS_RAISE_INLINE { display "raise()" default_value 1 description " Enabling this option makes raise() an inline function." } cdl_option CYGIMP_LIBC_SIGNALS_SIGNAL_INLINE { display "signal()" default_value 1 description " Enabling this option makes signal() an inline function." } } cdl_component CYGPKG_LIBC_SIGNALS_ERROR_HANDLING { display "Error handling" flavor none description " You may or may not want errno to be set by certain functions. Not using errno could save both space, code, and avoid worrying about interactions between multiple threads when setting it." cdl_option CYGSEM_LIBC_SIGNALS_BAD_SIGNAL_FATAL { display "Bad signal fatal" requires CYGDBG_USE_ASSERTS default_value 0 description " Enabling this option will cause an assertion failure if the signal handling code is passed a bad signal. Otherwise an error will be returned, or in the case of a hardware-generated exception it will be silently ignored." } cdl_option CYGSEM_LIBC_SIGNALS_RAISE_SETS_ERRNO { display "raise() sets errno" requires CYGINT_ISO_ERRNO requires CYGINT_ISO_ERRNO_CODES default_value 1 description " You may or may not want errno to be set by raise() on error conditions. Not using errno could save both space, code, and avoid worrying about interactions between multiple threads when setting it. Strictly ISO C does not mandate that errno be set by raise()." } cdl_option CYGSEM_LIBC_SIGNALS_SIGNAL_SETS_ERRNO { display "signal() sets errno" requires CYGINT_ISO_ERRNO requires CYGINT_ISO_ERRNO_CODES default_value 1 description " You may or may not want errno to be set by signal() on error conditions. Not using errno could save both space, code, and avoid worrying about interactions between multiple threads when setting it. Strictly ISO C mandates that errno be set by signal()." } } cdl_component CYGPKG_LIBC_SIGNALS_TRACING { display "Tracing" flavor none description " These options control the trace output for the C library internal signal implementation." cdl_option CYGNUM_LIBC_SIGNALS_RAISE_TRACE_LEVEL { display "Default trace level for raise()" flavor data legal_values 0 to 1 default_value 0 description " This gives the default tracing level for the raise() function. Higher numbers are more verbose." } cdl_option CYGNUM_LIBC_SIGNALS_HWHANDLER_TRACE_LEVEL { display "Default hardware exception handler trace level" flavor data legal_values 0 to 1 default_value 0 description " This gives the default tracing level for the hardware exception handler function (if enabled). Higher numbers are more verbose." } } # ==================================================================== cdl_component CYGPKG_LIBC_SIGNALS_OPTIONS { display "C library signal functions build options" flavor none no_define description " Package specific build options including control over compiler flags used only in building this package, and details of which tests are built." cdl_option CYGPKG_LIBC_SIGNALS_CFLAGS_ADD { display "Additional compiler flags" flavor data no_define default_value { "" } description " This option modifies the set of compiler flags for building the C library. These flags are used in addition to the set of global flags." } cdl_option CYGPKG_LIBC_SIGNALS_CFLAGS_REMOVE { display "Suppressed compiler flags" flavor data no_define default_value { "" } description " This option modifies the set of compiler flags for building the C library. These flags are removed from the set of global flags if present." } cdl_option CYGPKG_LIBC_SIGNALS_TESTS { display "C library signal function tests" flavor data no_define calculated { "tests/signal1" . ((CYGSEM_LIBC_SIGNALS_HWEXCEPTIONS) ? " tests/signal2" : "") } description " This option specifies the set of tests for the C library signal functions." } } } # ==================================================================== # EOF signals.cdl