2 * Copyright (c) 2000-2011, 2013-2020 Apple Inc. All rights reserved.
4 * @APPLE_LICENSE_HEADER_START@
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
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.
21 * @APPLE_LICENSE_HEADER_END@
25 * Modification History
27 * October 30, 2003 Allan Nathanson <ajn@apple.com>
28 * - add plugin "stop()" function support
30 * June 1, 2001 Allan Nathanson <ajn@apple.com>
31 * - public API conversion
33 * 24 March 2000 Allan Nathanson <ajn@apple.com>
46 #include <sys/types.h>
49 #include <objc/objc-runtime.h>
50 #include <servers/bootstrap.h>
52 #include <vproc_priv.h>
55 #include "configd_server.h"
56 #include "plugin_support.h"
57 #include "SCDynamicStoreInternal.h"
59 #if TARGET_OS_IPHONE && !TARGET_OS_SIMULATOR && !defined(DO_NOT_INFORM)
60 #include <CoreFoundation/CFUserNotification.h>
61 #endif // TARGET_OS_IPHONE && !TARGET_OS_SIMULATOR && !defined(DO_NOT_INFORM)
64 Boolean _configd_verbose = FALSE; /* TRUE if verbose logging enabled */
67 CFMutableSetRef _plugins_allowed = NULL; /* bundle identifiers to allow when loading */
70 CFMutableSetRef _plugins_exclude = NULL; /* bundle identifiers to exclude from loading */
73 CFMutableSetRef _plugins_verbose = NULL; /* bundle identifiers to enable verbose logging */
75 static CFMachPortRef termRequested = NULL; /* Mach port used to notify runloop of a shutdown request */
78 static const struct option longopts[] = {
79 // { "include-plugin", required_argument, 0, 'A' },
80 // { "no-bundles", no_argument, 0, 'b' },
81 // { "exclude-plugin", required_argument, 0, 'B' },
82 // { "no-fork", no_argument, 0, 'd' },
83 // { "test-bundle", required_argument, 0, 't' },
84 // { "verbose", no_argument, 0, 'v' },
85 // { "verbose-bundle", required_argument, 0, 'V' },
86 { "help", no_argument, 0, '?' },
92 usage(const char *prog)
94 SCPrint(TRUE, stderr, CFSTR("%s: [-d] [-v] [-V bundleID] [-b] [-B bundleID] [-A bundleID] [-t bundle-path]\n"), prog);
95 SCPrint(TRUE, stderr, CFSTR("options:\n"));
96 SCPrint(TRUE, stderr, CFSTR("\t-d\tdisable daemon/run in foreground\n"));
97 SCPrint(TRUE, stderr, CFSTR("\t-v\tenable verbose logging\n"));
98 SCPrint(TRUE, stderr, CFSTR("\t-V\tenable verbose logging for the specified plug-in\n"));
99 SCPrint(TRUE, stderr, CFSTR("\t-f\tload ALL plug-ins in a separate process\n"));
100 SCPrint(TRUE, stderr, CFSTR("\t-b\tdisable loading of ALL plug-ins\n"));
101 SCPrint(TRUE, stderr, CFSTR("\t-B\tdisable loading of the specified plug-in\n"));
102 SCPrint(TRUE, stderr, CFSTR("\t-A\tenable loading of the specified plug-in\n"));
103 SCPrint(TRUE, stderr, CFSTR("\t-t\tload/test the specified plug-in\n"));
104 SCPrint(TRUE, stderr, CFSTR("\t\t (Note: only the plug-in will be started)\n"));
109 __private_extern__ os_log_t
110 __configd_SCDynamicStore()
112 static os_log_t log = NULL;
115 log = os_log_create("com.apple.SystemConfiguration", "SCDynamicStore");
128 if (termRequested != NULL) {
129 if (_sc_log > kSCLogDestinationFile) {
131 * if we've received a [shutdown] SIGTERM
132 * and we are syslog'ing than it's likely
133 * that syslogd is also being term'd. As
134 * such, let's also push any remaining log
135 * messages to stdout/stderr.
137 _sc_log = kSCLogDestinationBoth;
141 * send message to indicate that a request has been made
142 * for the daemon to be shutdown.
144 _SC_sendMachMessage(CFMachPortGetPort(termRequested), 0);
156 term(CFMachPortRef port, void *msg, CFIndex size, void *info)
165 wait = plugin_term(&status);
167 // if we are not waiting on a plugin
189 /* close any open FDs */
190 for (i = getdtablesize()-1; i>=0; i--) close(i);
192 /* set stdin, stdout, stderr */
193 fd = open(_PATH_DEVNULL, O_RDWR, 0);
198 (void) dup2(fd, STDIN_FILENO);
201 ofd = open("/var/log/configd.log", O_WRONLY|O_APPEND, 0);
203 if (fd > STDIN_FILENO) {
208 (void) dup2(fd, STDOUT_FILENO);
209 (void) dup2(fd, STDERR_FILENO);
210 if (fd > STDERR_FILENO) {
224 signal(SIGTERM, parent_exit);
231 /* child: becomes the daemon (see below) */
232 signal(SIGTERM, SIG_DFL);
236 /* parent: wait for signal, then exit */
239 (void) wait4(child_pid, (int *)&status, 0, 0);
240 if (WIFEXITED(status)) {
242 "*** configd (daemon) failed to start, exit status=%d\n",
243 WEXITSTATUS(status));
246 "*** configd (daemon) failed to start, received signal=%d\n",
263 termMPCopyDescription(const void *info)
266 return CFStringCreateWithFormat(NULL, NULL, CFSTR("<SIGTERM MP>"));
271 main(int argc, char * const argv[])
273 CFMachPortContext context = { 0
277 , termMPCopyDescription
279 Boolean forceForeground = FALSE;
280 Boolean forcePlugin = FALSE;
281 int64_t is_launchd_job = 0;
282 mach_port_limits_t limits;
283 Boolean loadBundles = TRUE;
284 struct sigaction nact;
286 // extern int optind;
287 const char *prog = argv[0];
288 CFRunLoopSourceRef rls;
289 kern_return_t status;
291 const char *testBundle = NULL;
293 _plugins_allowed = CFSetCreateMutable(NULL, 0, &kCFTypeSetCallBacks);
294 _plugins_exclude = CFSetCreateMutable(NULL, 0, &kCFTypeSetCallBacks);
295 _plugins_verbose = CFSetCreateMutable(NULL, 0, &kCFTypeSetCallBacks);
297 /* process any arguments */
299 while ((opt = getopt_long(argc, argv, "A:bB:dt:vV:", longopts, NULL)) != -1) {
302 str = CFStringCreateWithCString(NULL, optarg, kCFStringEncodingMacRoman);
303 CFSetSetValue(_plugins_allowed, str);
310 str = CFStringCreateWithCString(NULL, optarg, kCFStringEncodingMacRoman);
311 CFSetSetValue(_plugins_exclude, str);
315 forceForeground = TRUE;
321 _configd_verbose = TRUE;
324 if (strcmp(optarg, "com.apple.SystemConfiguration") == 0) {
327 str = CFStringCreateWithCString(NULL, optarg, kCFStringEncodingMacRoman);
328 CFSetSetValue(_plugins_verbose, str);
340 /* check credentials */
341 #if !TARGET_OS_SIMULATOR
343 fprintf(stderr, "%s: permission denied.\n", prog);
346 #endif // !TARGET_OS_SIMULATOR
348 /* check if we have been started by launchd */
349 vproc_swap_integer(NULL, VPROC_GSK_IS_MANAGED, NULL, &is_launchd_job);
351 #if TARGET_OS_IPHONE && !TARGET_OS_SIMULATOR && !defined(DO_NOT_INFORM)
352 // if launchd job, check to see if we have been restarted
353 if (is_launchd_job) {
356 vproc_swap_integer(NULL, VPROC_GSK_LAST_EXIT_STATUS, NULL, &status);
357 if ((status != 0) && _SC_isAppleInternal()) {
360 // if we've been restarted
361 fd = open("/var/run/configd-crash-reported", O_WRONLY|O_CREAT|O_EXCL, 0644);
363 // if we have not yet alerted the user
364 CFUserNotificationDisplayNotice(0,
365 kCFUserNotificationStopAlertLevel,
369 CFSTR("\"configd\" restarted"),
370 CFSTR("Please collect the crash report and file a Radar."),
376 #endif // TARGET_OS_IPHONE && !TARGET_OS_SIMULATOR && !defined(DO_NOT_INFORM)
378 /* ensure that forked plugins behave */
379 if (testBundle != NULL) {
383 /* if needed, daemonize */
384 if (!forceForeground && !is_launchd_job) {
386 * if we haven't been asked to run in the foreground
387 * and have not been started by launchd (i.e. we're
388 * not already running as a Foreground process) then
391 if (fork_child() == -1) {
392 fprintf(stderr, "configd: fork() failed: %s\n", strerror(errno));
397 * Note: we are now the child process. The parent
398 * waits/exits in fork_child.
403 * close file descriptors, establish stdin/stdout/stderr,
406 if (!forceForeground || forcePlugin) {
407 if (!is_launchd_job && !forcePlugin) {
411 if (_SC_isInstallEnvironment()) {
413 LOG_CONS|LOG_NDELAY|LOG_PID, // logopt
414 LOG_INSTALL); // facility
417 _sc_log = kSCLogDestinationFile; /* redirect SCLog() to stdout/stderr */
420 /* add signal handler to catch a SIGHUP */
421 nact.sa_handler = catcher;
422 sigemptyset(&nact.sa_mask);
423 nact.sa_flags = SA_RESTART;
424 if (sigaction(SIGHUP, &nact, NULL) == -1) {
425 SC_log(LOG_ERR, "sigaction(SIGHUP, ...) failed: %s", strerror(errno));
428 /* add signal handler to catch a SIGPIPE */
429 if (sigaction(SIGPIPE, &nact, NULL) == -1) {
430 SC_log(LOG_ERR, "sigaction(SIGPIPE, ...) failed: %s", strerror(errno));
433 /* add signal handler to catch a SIGTERM */
434 if (sigaction(SIGTERM, &nact, NULL) == -1) {
435 SC_log(LOG_ERR, "sigaction(SIGTERM, ...) failed: %s", strerror(errno));
438 /* add signal handler to catch a SIGINT */
439 if (sigaction(SIGINT, &nact, NULL) == -1) {
440 SC_log(LOG_ERR, "sigaction(SIGINT, ...) failed: %s", strerror(errno));
443 /* create the "shutdown requested" notification port */
444 termRequested = CFMachPortCreate(NULL, term, &context, NULL);
446 /* set queue limit */
447 limits.mpl_qlimit = 1;
448 status = mach_port_set_attributes(mach_task_self(),
449 CFMachPortGetPort(termRequested),
450 MACH_PORT_LIMITS_INFO,
451 (mach_port_info_t)&limits,
452 MACH_PORT_LIMITS_INFO_COUNT);
453 if (status != KERN_SUCCESS) {
454 perror("mach_port_set_attributes");
457 /* add to our runloop */
458 rls = CFMachPortCreateRunLoopSource(NULL, termRequested, 0);
459 CFRunLoopAddSource(CFRunLoopGetCurrent(), rls, kCFRunLoopDefaultMode);
462 if (testBundle == NULL) {
463 /* don't complain about having lots of SCDynamicStore sessions */
464 _SCDynamicStoreSetSessionWatchLimit(0);
466 /* initialize primary (store management) thread */
469 if (!forceForeground && !is_launchd_job) {
470 /* synchronize with parent process */
471 kill(getppid(), SIGTERM);
475 if ((testBundle != NULL) || loadBundles) {
476 /* load/initialize/start [specified] plug-ins */
477 plugin_exec((void *)testBundle);
480 SC_log(LOG_DEBUG, "starting main/plugin CFRunLoop");
483 exit (EX_OK); /* insure the process exit status is 0 */
484 return 0; /* ...and make main fit the ANSI spec. */