OSX/utilities/src/debugging.h

   1 /*
   2  * Copyright (c) 2006-2007,2009-2010,2012-2014 Apple Inc. All Rights Reserved.
   3  *
   4  * @APPLE_LICENSE_HEADER_START@
   5  *
   6  * This file contains Original Code and/or Modifications of Original Code
   7  * as defined in and that are subject to the Apple Public Source License
   8  * Version 2.0 (the 'License'). You may not use this file except in
   9  * compliance with the License. Please obtain a copy of the License at
  10  * http://www.opensource.apple.com/apsl/ and read it before using this
  11  * file.
  12  *
  13  * The Original Code and all software distributed under the License are
  14  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  15  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  16  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  18  * Please see the License for the specific language governing rights and
  19  * limitations under the License.
  20  *
  21  * @APPLE_LICENSE_HEADER_END@
  22  */
  23
  24 /*
  25  * debugging.h - non-trivial debug support
  26  */
  27
  28 /*
  29  * CONFIGURING DEFAULT DEBUG SCOPES
  30  *
  31  * Default debug "scope" inclusion / exclusion is configured in  com.apple.securityd.plist (iOS) and
  32  * com.apple.secd.plist (OSX) in the Environmental Variable "DEBUGSCOPE".  The current value for that
  33  * variable begins with a dash ("-") indicating an "exclusion list".  If you add a scope for a
  34  * secnotice, etc that you don't want to always be "on" add the new string to the DEBUGSCOPE variable
  35  * in both plists.
  36  */
  37
  38 #ifndef _SECURITY_UTILITIES_DEBUGGING_H_
  39 #define _SECURITY_UTILITIES_DEBUGGING_H_
  40
  41 #if TARGET_OS_OSX
  42 #include <security_utilities/debugging_internal.h>
  43 #endif
  44
  45 #ifdef KERNEL
  46         #include <libkern/libkern.h>
  47         #define secalert(format, ...) printf((format), ## __VA_ARGS__)
  48         #define secemergency(format, ...) printf((format), ## __VA_ARGS__)
  49         #define seccritical(format, ...) printf((format), ## __VA_ARGS__)
  50         #define secerror(format, ...) printf((format), ## __VA_ARGS__)
  51         #define secwarning(format, ...) printf((format), ## __VA_ARGS__)
  52         #define secnotice(scope, format, ...) printf((format), ## __VA_ARGS__)
  53         #define secnoticeq(scope, format, ...) printf((format), ## __VA_ARGS__)
  54         #define secinfo(scope, format, ...) printf((format), ## __VA_ARGS__)
  55     #undef secdebug
  56     #if !defined(NDEBUG)
  57         #define secdebug(scope, format, ...) printf((format), ## __VA_ARGS__)
  58     #else // NDEBUG
  59         #define secdebug(scope, format, ...)    /* nothing */
  60     #endif // NDEBUG
  61 #else // !KERNEL
  62
  63 #include <TargetConditionals.h>
  64 #include <CoreFoundation/CFString.h>
  65 #include <asl.h>
  66
  67 __BEGIN_DECLS
  68
  69 #define SECLOG_LEVEL_EMERG  0
  70 #define SECLOG_LEVEL_ALERT  1
  71 #define SECLOG_LEVEL_CRIT   2
  72 #define SECLOG_LEVEL_ERR    3
  73 #define SECLOG_LEVEL_WARNING 4
  74 #define SECLOG_LEVEL_NOTICE 5
  75 #define SECLOG_LEVEL_INFO   6
  76 #define SECLOG_LEVEL_DEBUG  7
  77
  78 #include <os/log_private.h>
  79 extern os_log_t logObjForScope(const char *scope);
  80 extern bool secLogEnabled(void);
  81 extern void secLogDisable(void);
  82 extern void secLogEnable(void);
  83
  84 #if TARGET_OS_OSX
  85 #define NO_OS_LOG 1
  86 #ifdef NO_OS_LOG
  87
  88 // There might be no os_log available. Weak link their internal functions.
  89 void weak_os_log_impl(void *dso, os_log_t log, os_log_type_t type, const char *format, uint8_t *buf, unsigned int size);
  90 #define _os_log_impl weak_os_log_impl
  91
  92 #undef os_log_create
  93 os_log_t weak_os_log_create(const char *subsystem, const char *category);
  94 #define os_log_create weak_os_log_create
  95
  96 bool weak_os_log_type_enabled(os_log_t oslog, os_log_type_t type);
  97 #define os_log_type_enabled weak_os_log_type_enabled
  98
  99 #endif // NO_OS_LOG
 100 #endif // TARGET_OS_OSX
 101
 102 CFStringRef SecLogAPICreate(bool apiIn, const char *api, CFStringRef format, ...);
 103
 104 extern const char *api_trace;
 105
 106 #define sec_trace_enter_api(format...) { \
 107     CFStringRef info = SecLogAPICreate(true, __FUNCTION__, format, NULL); \
 108     secinfo(api_trace, "%@",  info); CFReleaseNull(info); \
 109 }
 110
 111 #define sec_trace_return_api(rtype, body, format...) { \
 112     rtype _r = body(); \
 113     CFStringRef info = SecLogAPICreate(true, __FUNCTION__, format, _r); \
 114     secinfo(api_trace, "%@",  info); \
 115     CFReleaseNull(info); return _r; \
 116 }
 117
 118 #define sec_trace_return_bool_api(body, format...) { \
 119     bool _r = body(); \
 120     CFStringRef info = SecLogAPICreate(true, __FUNCTION__, format ? format : CFSTR("return=%d"), _r); \
 121     secinfo(api_trace, "%@",  info); \
 122     CFReleaseNull(info); return _r; \
 123 }
 124
 125 #define secemergency(format, ...)       os_log_error(logObjForScope("SecEmergency"), format, ## __VA_ARGS__)
 126 #define secalert(format, ...)           os_log_error(logObjForScope("SecAlert"), format, ## __VA_ARGS__)
 127 #define seccritical(format, ...)        os_log(logObjForScope("SecCritical"), format, ## __VA_ARGS__)
 128 #define secerror(format, ...)           os_log(logObjForScope("SecError"), format, ## __VA_ARGS__)
 129 #define secerrorq(format, ...)          os_log(logObjForScope("SecError"), format, ## __VA_ARGS__)
 130 #define secwarning(format, ...)         os_log(logObjForScope("SecWarning"), format, ## __VA_ARGS__)
 131 #define secnotice(scope, format, ...)   os_log(logObjForScope(scope), format, ## __VA_ARGS__)
 132 #define secnoticeq(scope, format, ...)  os_log(logObjForScope(scope), format, ## __VA_ARGS__)
 133 #define secinfo(scope, format, ...)     os_log_debug(logObjForScope(scope), format, ## __VA_ARGS__)
 134
 135 #define secinfoenabled(scope)           os_log_debug_enabled(logObjForScope(scope))
 136
 137 // secdebug is used for things that might not be privacy safe at all, so only debug builds can have these traces
 138 #undef secdebug
 139 #if !defined(NDEBUG)
 140 #define secdebug(scope, format, ...)    os_log_debug(logObjForScope(scope), format, ## __VA_ARGS__)
 141 #else
 142 # define secdebug(scope,...)    /* nothing */
 143 #endif
 144
 145 typedef void (^security_log_handler)(int level, CFStringRef scope, const char *function,
 146                                      const char *file, int line, CFStringRef message);
 147
 148 /* To simulate a process crash in some conditions */
 149 void __security_simulatecrash(CFStringRef reason, uint32_t code);
 150 void __security_stackshotreport(CFStringRef reason, uint32_t code);
 151
 152 /* predefined simulate crash exception codes */
 153 #define __sec_exception_code(x) (0x53c00000+x)
 154 /* 1 was __sec_exception_code_CorruptDb */
 155 #define __sec_exception_code_CorruptItem            __sec_exception_code(2)
 156 #define __sec_exception_code_OTRError               __sec_exception_code(3)
 157 #define __sec_exception_code_DbItemDescribe         __sec_exception_code(4)
 158 #define __sec_exception_code_TwiceCorruptDb(db)     __sec_exception_code(5|((db)<<8))
 159 #define __sec_exception_code_AuthLoop               __sec_exception_code(6)
 160 #define __sec_exception_code_MissingEntitlements    __sec_exception_code(7)
 161 #define __sec_exception_code_LostInMist             __sec_exception_code(8)
 162 #define __sec_exception_code_CKD_nil_pending_keys   __sec_exception_code(9)
 163 #define __sec_exception_code_SQLiteBusy             __sec_exception_code(10)
 164 #define __sec_exception_code_CorruptDb(rc)          __sec_exception_code(11|((rc)<<8))
 165
 166 /* For testing only, turns off/on simulated crashes, when turning on, returns number of
 167    simulated crashes which were not reported since last turned off. */
 168 int __security_simulatecrash_enable(bool enable);
 169
 170 /* Logging control functions */
 171
 172 typedef enum {
 173     kScopeIDEnvironment = 0,
 174     kScopeIDDefaults = 1,
 175     kScopeIDConfig = 2,
 176     kScopeIDXPC = 3,
 177     kScopeIDCircle = 4,
 178     kScopeIDMax = 4,
 179 } SecDebugScopeID;
 180
 181 void ApplyScopeListForID(CFStringRef scopeList, SecDebugScopeID whichID);
 182 void ApplyScopeDictionaryForID(CFDictionaryRef scopeList, SecDebugScopeID whichID);
 183 CFPropertyListRef CopyCurrentScopePlist(void);
 184
 185 __END_DECLS
 186
 187 #endif // !KERNEL
 188
 189 #endif /* _SECURITY_UTILITIES_DEBUGGING_H_ */