1 /************************************************************************** 2 * 3 * Copyright 2010 Vmware, Inc. 4 * All Rights Reserved. 5 * 6 * Permission is hereby granted, free of charge, to any person obtaining a 7 * copy of this software and associated documentation files (the 8 * "Software"), to deal in the Software without restriction, including 9 * without limitation the rights to use, copy, modify, merge, publish, 10 * distribute, sub license, and/or sell copies of the Software, and to 11 * permit persons to whom the Software is furnished to do so, subject to 12 * the following conditions: 13 * 14 * The above copyright notice and this permission notice (including the 15 * next paragraph) shall be included in all copies or substantial portions 16 * of the Software. 17 * 18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. 21 * IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR 22 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 23 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 24 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 25 * 26 **************************************************************************/ 27 28 29 /* 30 * Miscellaneous OS services. 31 */ 32 33 34 #ifndef _OS_MISC_H_ 35 #define _OS_MISC_H_ 36 37 38 #include "pipe/p_compiler.h" 39 40 41 #if defined(PIPE_OS_UNIX) 42 # include <signal.h> /* for kill() */ 43 # include <unistd.h> /* getpid() */ 44 #endif 45 46 #ifdef __GNUC__ 47 #define UNUSED __attribute__((unused)) 48 #ifdef NDEBUG 49 #define MAYBE_UNUSED __attribute__((unused)) 50 #else 51 #define MAYBE_UNUSED 52 #endif 53 #else 54 #define UNUSED 55 #define MAYBE_UNUSED 56 #endif 57 58 #ifdef __cplusplus 59 extern "C" { 60 #endif 61 62 63 /* 64 * Trap into the debugger. 65 */ 66 #if (defined(PIPE_ARCH_X86) || defined(PIPE_ARCH_X86_64)) && defined(PIPE_CC_GCC) 67 # define os_break() __asm("int3") 68 #elif defined(PIPE_CC_MSVC) 69 # define os_break() __debugbreak() 70 #elif defined(PIPE_OS_UNIX) 71 # define os_break() kill(getpid(), SIGTRAP) 72 #else 73 # define os_break() abort() 74 #endif 75 76 77 /* 78 * Abort the program. 79 */ 80 #if defined(DEBUG) 81 # define os_abort() os_break() 82 #else 83 # define os_abort() abort() 84 #endif 85 86 87 /* 88 * Output a message. Message should preferably end in a newline. 89 */ 90 void 91 os_log_message(const char *message); 92 93 94 /* 95 * Get an option. Should return NULL if specified option is not set. 96 */ 97 const char * 98 os_get_option(const char *name); 99 100 101 #ifdef __cplusplus 102 } 103 #endif 104 105 106 #endif /* _OS_MISC_H_ */ 107