launchd/src/launchd_runtime.h

   1 /*
   2  * Copyright (c) 2005 Apple Computer, Inc. All rights reserved.
   3  *
   4  * @APPLE_APACHE_LICENSE_HEADER_START@
   5  *
   6  * Licensed under the Apache License, Version 2.0 (the "License");
   7  * you may not use this file except in compliance with the License.
   8  * You may obtain a copy of the License at
   9  *
  10  *     http://www.apache.org/licenses/LICENSE-2.0
  11  *
  12  * Unless required by applicable law or agreed to in writing, software
  13  * distributed under the License is distributed on an "AS IS" BASIS,
  14  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15  * See the License for the specific language governing permissions and
  16  * limitations under the License.
  17  *
  18  * @APPLE_APACHE_LICENSE_HEADER_END@
  19  */
  20 #ifndef __LAUNCHD_RUNTIME_H__
  21 #define __LAUNCHD_RUNTIME_H__
  22
  23 #include <mach/mach.h>
  24 #include <sys/types.h>
  25 #include <bsm/libbsm.h>
  26 #include <stdbool.h>
  27 #include <stdint.h>
  28 #include <float.h>
  29 #include <syslog.h>
  30
  31 #include "launchd_runtime_kill.h"
  32 #include "launchd_ktrace.h"
  33
  34 #if 0
  35
  36 /* I need to do more testing of these macros */
  37
  38 #define min_of_type(x) \
  39         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), long double), LDBL_MIN, \
  40         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), double), DBL_MIN, \
  41         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), float), FLT_MIN, \
  42         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), char), 0, \
  43         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), signed char), INT8_MIN, \
  44         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), short), INT16_MIN, \
  45         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), int), INT32_MIN, \
  46         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), long), (__builtin_choose_expr(sizeof(x) == 4, INT32_MIN, INT64_MIN)), \
  47         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), long long), INT64_MIN, \
  48         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), unsigned char), 0, \
  49         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), unsigned short), 0, \
  50         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), unsigned int), 0, \
  51         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), unsigned long), 0, \
  52         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), unsigned long long), 0, \
  53         (void)0))))))))))))))
  54
  55 #define max_of_type(x) \
  56         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), long double), LDBL_MAX, \
  57         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), double), DBL_MAX, \
  58         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), float), FLT_MAX, \
  59         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), char), UINT8_MAX, \
  60         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), signed char), INT8_MAX, \
  61         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), short), INT16_MIN, \
  62         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), int), INT32_MAX, \
  63         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), long), (__builtin_choose_expr(sizeof(x) == 4, INT32_MAX, INT64_MAX)), \
  64         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), long long), INT64_MAX, \
  65         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), unsigned char), UINT8_MAX, \
  66         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), unsigned short), UINT16_MAX, \
  67         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), unsigned int), UINT32_MAX, \
  68         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), unsigned long), (__builtin_choose_expr(sizeof(x) == 4, UINT32_MAX, UINT64_MAX)), \
  69         __builtin_choose_expr(__builtin_types_compatible_p(typeof(x), unsigned long long), UINT64_MAX, \
  70         (void)0))))))))))))))
  71
  72 #endif
  73
  74 #define likely(x)       __builtin_expect((bool)(x), true)
  75 #define unlikely(x)     __builtin_expect((bool)(x), false)
  76
  77 struct ldcred {
  78         uid_t           euid;
  79         uid_t           uid;
  80         gid_t           egid;
  81         gid_t           gid;
  82         pid_t           pid;
  83         au_asid_t       asid;
  84         mach_port_t     asport;
  85 };
  86
  87 /*
  88  * Use launchd_assumes() when we can recover, even if it means we leak or limp along.
  89  *
  90  * Use launchd_assert() for core initialization routines.
  91  */
  92 #define launchd_assumes(e)      \
  93         (unlikely(!(e)) ? _log_launchd_bug(__rcs_file_version__, __FILE__, __LINE__, #e), false : true)
  94
  95 #define launchd_assert(e)       if (__builtin_constant_p(e)) { char __compile_time_assert__[e ? 1 : -1] __attribute__((unused)); } else if (!launchd_assumes(e)) { abort(); }
  96
  97 void _log_launchd_bug(const char *rcs_rev, const char *path, unsigned int line, const char *test);
  98
  99 typedef void (*kq_callback)(void *, struct kevent *);
 100 typedef boolean_t (*mig_callback)(mach_msg_header_t *, mach_msg_header_t *);
 101 typedef void (*timeout_callback)(void);
 102
 103 extern bool pid1_magic;
 104 extern bool low_level_debug;
 105 extern char g_username[128];
 106 extern char g_my_label[128];
 107 extern bool g_shutdown_debugging;
 108 extern bool g_verbose_boot;
 109 extern bool g_use_gmalloc;
 110 extern bool g_malloc_log_stacks;
 111 extern bool g_log_per_user_shutdown;
 112 extern bool g_log_strict_usage;
 113 extern bool g_embedded_shutdown_log;
 114 extern bool g_runtime_busy_time;
 115 extern bool g_trap_sigkill_bugs;
 116 extern size_t runtime_busy_cnt;
 117 extern int32_t g_sync_frequency;
 118 extern pid_t g_wsp;
 119
 120 mach_port_t runtime_get_kernel_port(void);
 121 extern boolean_t launchd_internal_demux(mach_msg_header_t *Request, mach_msg_header_t *Reply);
 122
 123 void runtime_add_ref(void);
 124 void runtime_del_ref(void);
 125 void runtime_add_weak_ref(void);
 126 void runtime_del_weak_ref(void);
 127 void runtime_install_timer(void);
 128 void runtime_remove_timer(void);
 129
 130 void launchd_runtime_init(void);
 131 void launchd_runtime_init2(void);
 132 void launchd_runtime(void) __attribute__((noreturn));
 133
 134 void launchd_log_vm_stats(void);
 135
 136 int runtime_close(int fd);
 137 int runtime_fsync(int fd);
 138
 139 #define RUNTIME_ADVISABLE_IDLE_TIMEOUT 30
 140
 141 void runtime_set_timeout(timeout_callback to_cb, unsigned int sec);
 142 kern_return_t runtime_add_mport(mach_port_t name, mig_callback demux, mach_msg_size_t msg_size);
 143 kern_return_t runtime_remove_mport(mach_port_t name);
 144 struct ldcred *runtime_get_caller_creds(void);
 145
 146 const char *signal_to_C_name(unsigned int sig);
 147 const char *reboot_flags_to_C_names(unsigned int flags);
 148
 149 int kevent_bulk_mod(struct kevent *kev, size_t kev_cnt);
 150 int kevent_mod(uintptr_t ident, short filter, u_short flags, u_int fflags, intptr_t data, void *udata);
 151 void log_kevent_struct(int level, struct kevent *kev_base, int indx);
 152
 153 pid_t runtime_fork(mach_port_t bsport);
 154
 155 mach_msg_return_t launchd_exc_runtime_once(mach_port_t port, mach_msg_size_t rcv_msg_size, mach_msg_size_t send_msg_size, mig_reply_error_t *bufRequest, mig_reply_error_t *bufReply, mach_msg_timeout_t to);
 156
 157 kern_return_t runtime_log_forward(uid_t forward_uid, gid_t forward_gid, vm_offset_t inval, mach_msg_type_number_t invalCnt);
 158 kern_return_t runtime_log_drain(mach_port_t srp, vm_offset_t *outval, mach_msg_type_number_t *outvalCnt);
 159
 160 #define LOG_APPLEONLY           0x4141504c /* AAPL in hex */
 161 #define LOG_SCOLDING            0x3030493b
 162 #define LOG_CONSOLE                     (1 << 31)
 163
 164 struct runtime_syslog_attr {
 165         const char *from_name;
 166         const char *about_name;
 167         const char *session_name;
 168         int priority;
 169         uid_t from_uid;
 170         pid_t from_pid;
 171         pid_t about_pid;
 172 };
 173
 174 int runtime_setlogmask(int maskpri);
 175 void runtime_closelog(void);
 176 void runtime_syslog(int pri, const char *message, ...) __attribute__((format(printf, 2, 3)));
 177 void runtime_vsyslog(struct runtime_syslog_attr *attr, const char *message, va_list args) __attribute__((format(printf, 2, 0)));
 178 void runtime_log_push(void);
 179
 180 int64_t runtime_get_wall_time(void) __attribute__((warn_unused_result));
 181 uint64_t runtime_get_opaque_time(void) __attribute__((warn_unused_result));
 182 uint64_t runtime_get_opaque_time_of_event(void) __attribute__((pure, warn_unused_result));
 183 uint64_t runtime_opaque_time_to_nano(uint64_t o) __attribute__((const, warn_unused_result));
 184 uint64_t runtime_get_nanoseconds_since(uint64_t o) __attribute__((pure, warn_unused_result));
 185
 186 kern_return_t launchd_set_bport(mach_port_t name);
 187 kern_return_t launchd_get_bport(mach_port_t *name);
 188 kern_return_t launchd_mport_notify_req(mach_port_t name, mach_msg_id_t which);
 189 kern_return_t launchd_mport_notify_cancel(mach_port_t name, mach_msg_id_t which);
 190 kern_return_t launchd_mport_create_recv(mach_port_t *name);
 191 kern_return_t launchd_mport_deallocate(mach_port_t name);
 192 kern_return_t launchd_mport_make_send(mach_port_t name);
 193 kern_return_t launchd_mport_copy_send(mach_port_t name);
 194 kern_return_t launchd_mport_make_send_once(mach_port_t name, mach_port_t *so);
 195 kern_return_t launchd_mport_close_recv(mach_port_t name);
 196
 197 #endif