xref: /illumos-gate/usr/src/cmd/zoneadmd/zoneadmd.c (revision 6446bd46ed1b4e9f69da153665f82181ccaedad5)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 
22 /*
23  * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved.
24  * Copyright 2014 Nexenta Systems, Inc. All rights reserved.
25  * Copyright (c) 2016 by Delphix. All rights reserved.
26  */
27 
28 /*
29  * zoneadmd manages zones; one zoneadmd process is launched for each
30  * non-global zone on the system.  This daemon juggles four jobs:
31  *
32  * - Implement setup and teardown of the zone "virtual platform": mount and
33  *   unmount filesystems; create and destroy network interfaces; communicate
34  *   with devfsadmd to lay out devices for the zone; instantiate the zone
35  *   console device; configure process runtime attributes such as resource
36  *   controls, pool bindings, fine-grained privileges.
37  *
38  * - Launch the zone's init(8) process.
39  *
40  * - Implement a door server; clients (like zoneadm) connect to the door
41  *   server and request zone state changes.  The kernel is also a client of
42  *   this door server.  A request to halt or reboot the zone which originates
43  *   *inside* the zone results in a door upcall from the kernel into zoneadmd.
44  *
45  *   One minor problem is that messages emitted by zoneadmd need to be passed
46  *   back to the zoneadm process making the request.  These messages need to
47  *   be rendered in the client's locale; so, this is passed in as part of the
48  *   request.  The exception is the kernel upcall to zoneadmd, in which case
49  *   messages are syslog'd.
50  *
51  *   To make all of this work, the Makefile adds -a to xgettext to extract *all*
52  *   strings, and an exclusion file (zoneadmd.xcl) is used to exclude those
53  *   strings which do not need to be translated.
54  *
55  * - Act as a console server for zlogin -C processes; see comments in zcons.c
56  *   for more information about the zone console architecture.
57  *
58  * DESIGN NOTES
59  *
60  * Restart:
61  *   A chief design constraint of zoneadmd is that it should be restartable in
62  *   the case that the administrator kills it off, or it suffers a fatal error,
63  *   without the running zone being impacted; this is akin to being able to
64  *   reboot the service processor of a server without affecting the OS instance.
65  */
66 
67 #include <sys/param.h>
68 #include <sys/mman.h>
69 #include <sys/types.h>
70 #include <sys/stat.h>
71 #include <sys/sysmacros.h>
72 
73 #include <bsm/adt.h>
74 #include <bsm/adt_event.h>
75 
76 #include <alloca.h>
77 #include <assert.h>
78 #include <errno.h>
79 #include <door.h>
80 #include <fcntl.h>
81 #include <locale.h>
82 #include <signal.h>
83 #include <stdarg.h>
84 #include <stdio.h>
85 #include <stdlib.h>
86 #include <string.h>
87 #include <strings.h>
88 #include <synch.h>
89 #include <syslog.h>
90 #include <thread.h>
91 #include <unistd.h>
92 #include <wait.h>
93 #include <limits.h>
94 #include <zone.h>
95 #include <libbrand.h>
96 #include <sys/brand.h>
97 #include <libcontract.h>
98 #include <libcontract_priv.h>
99 #include <sys/brand.h>
100 #include <sys/contract/process.h>
101 #include <sys/ctfs.h>
102 #include <libdladm.h>
103 #include <sys/dls_mgmt.h>
104 #include <libscf.h>
105 
106 #include <libzonecfg.h>
107 #include <zonestat_impl.h>
108 #include "zoneadmd.h"
109 
110 static char *progname;
111 char *zone_name;	/* zone which we are managing */
112 char pool_name[MAXNAMELEN];
113 char default_brand[MAXNAMELEN];
114 char brand_name[MAXNAMELEN];
115 boolean_t zone_isnative;
116 boolean_t zone_iscluster;
117 boolean_t zone_islabeled;
118 boolean_t shutdown_in_progress;
119 static zoneid_t zone_id;
120 dladm_handle_t dld_handle = NULL;
121 
122 static char pre_statechg_hook[2 * MAXPATHLEN];
123 static char post_statechg_hook[2 * MAXPATHLEN];
124 char query_hook[2 * MAXPATHLEN];
125 
126 zlog_t logsys;
127 
128 mutex_t	lock = DEFAULTMUTEX;	/* to serialize stuff */
129 mutex_t	msglock = DEFAULTMUTEX;	/* for calling setlocale() */
130 
131 static sema_t scratch_sem;	/* for scratch zones */
132 
133 static char	zone_door_path[MAXPATHLEN];
134 static int	zone_door = -1;
135 
136 boolean_t in_death_throes = B_FALSE;	/* daemon is dying */
137 boolean_t bringup_failure_recovery = B_FALSE; /* ignore certain failures */
138 
139 #if !defined(TEXT_DOMAIN)		/* should be defined by cc -D */
140 #define	TEXT_DOMAIN	"SYS_TEST"	/* Use this only if it wasn't */
141 #endif
142 
143 #define	DEFAULT_LOCALE	"C"
144 
145 static const char *
146 z_cmd_name(zone_cmd_t zcmd)
147 {
148 	/* This list needs to match the enum in sys/zone.h */
149 	static const char *zcmdstr[] = {
150 		"ready", "boot", "forceboot", "reboot", "halt",
151 		"note_uninstalling", "mount", "forcemount", "unmount",
152 		"shutdown"
153 	};
154 
155 	if (zcmd >= sizeof (zcmdstr) / sizeof (*zcmdstr))
156 		return ("unknown");
157 	else
158 		return (zcmdstr[(int)zcmd]);
159 }
160 
161 static char *
162 get_execbasename(char *execfullname)
163 {
164 	char *last_slash, *execbasename;
165 
166 	/* guard against '/' at end of command invocation */
167 	for (;;) {
168 		last_slash = strrchr(execfullname, '/');
169 		if (last_slash == NULL) {
170 			execbasename = execfullname;
171 			break;
172 		} else {
173 			execbasename = last_slash + 1;
174 			if (*execbasename == '\0') {
175 				*last_slash = '\0';
176 				continue;
177 			}
178 			break;
179 		}
180 	}
181 	return (execbasename);
182 }
183 
184 static void
185 usage(void)
186 {
187 	(void) fprintf(stderr, gettext("Usage: %s -z zonename\n"), progname);
188 	(void) fprintf(stderr,
189 	    gettext("\tNote: %s should not be run directly.\n"), progname);
190 	exit(2);
191 }
192 
193 /* ARGSUSED */
194 static void
195 sigchld(int sig)
196 {
197 }
198 
199 char *
200 localize_msg(char *locale, const char *msg)
201 {
202 	char *out;
203 
204 	(void) mutex_lock(&msglock);
205 	(void) setlocale(LC_MESSAGES, locale);
206 	out = gettext(msg);
207 	(void) setlocale(LC_MESSAGES, DEFAULT_LOCALE);
208 	(void) mutex_unlock(&msglock);
209 	return (out);
210 }
211 
212 /* PRINTFLIKE3 */
213 void
214 zerror(zlog_t *zlogp, boolean_t use_strerror, const char *fmt, ...)
215 {
216 	va_list alist;
217 	char buf[MAXPATHLEN * 2]; /* enough space for err msg with a path */
218 	char *bp;
219 	int saved_errno = errno;
220 
221 	if (zlogp == NULL)
222 		return;
223 	if (zlogp == &logsys)
224 		(void) snprintf(buf, sizeof (buf), "[zone '%s'] ",
225 		    zone_name);
226 	else
227 		buf[0] = '\0';
228 	bp = &(buf[strlen(buf)]);
229 
230 	/*
231 	 * In theory, the locale pointer should be set to either "C" or a
232 	 * char array, so it should never be NULL
233 	 */
234 	assert(zlogp->locale != NULL);
235 	/* Locale is per process, but we are multi-threaded... */
236 	fmt = localize_msg(zlogp->locale, fmt);
237 
238 	va_start(alist, fmt);
239 	(void) vsnprintf(bp, sizeof (buf) - (bp - buf), fmt, alist);
240 	va_end(alist);
241 	bp = &(buf[strlen(buf)]);
242 	if (use_strerror)
243 		(void) snprintf(bp, sizeof (buf) - (bp - buf), ": %s",
244 		    strerror(saved_errno));
245 	if (zlogp == &logsys) {
246 		(void) syslog(LOG_ERR, "%s", buf);
247 	} else if (zlogp->logfile != NULL) {
248 		(void) fprintf(zlogp->logfile, "%s\n", buf);
249 	} else {
250 		size_t buflen;
251 		size_t copylen;
252 
253 		buflen = snprintf(zlogp->log, zlogp->loglen, "%s\n", buf);
254 		copylen = MIN(buflen, zlogp->loglen);
255 		zlogp->log += copylen;
256 		zlogp->loglen -= copylen;
257 	}
258 }
259 
260 /*
261  * Emit a warning for any boot arguments which are unrecognized.  Since
262  * Solaris boot arguments are getopt(3c) compatible (see kernel(8)), we
263  * put the arguments into an argv style array, use getopt to process them,
264  * and put the resultant argument string back into outargs.
265  *
266  * During the filtering, we pull out any arguments which are truly "boot"
267  * arguments, leaving only those which are to be passed intact to the
268  * progenitor process.  The one we support at the moment is -i, which
269  * indicates to the kernel which program should be launched as 'init'.
270  *
271  * A return of Z_INVAL indicates specifically that the arguments are
272  * not valid; this is a non-fatal error.  Except for Z_OK, all other return
273  * values are treated as fatal.
274  */
275 static int
276 filter_bootargs(zlog_t *zlogp, const char *inargs, char *outargs,
277     char *init_file, char *badarg)
278 {
279 	int argc = 0, argc_save;
280 	int i;
281 	int err;
282 	char *arg, *lasts, **argv = NULL, **argv_save;
283 	char zonecfg_args[BOOTARGS_MAX];
284 	char scratchargs[BOOTARGS_MAX], *sargs;
285 	char c;
286 
287 	bzero(outargs, BOOTARGS_MAX);
288 	bzero(badarg, BOOTARGS_MAX);
289 
290 	/*
291 	 * If the user didn't specify transient boot arguments, check
292 	 * to see if there were any specified in the zone configuration,
293 	 * and use them if applicable.
294 	 */
295 	if (inargs == NULL || inargs[0] == '\0')  {
296 		zone_dochandle_t handle;
297 		if ((handle = zonecfg_init_handle()) == NULL) {
298 			zerror(zlogp, B_TRUE,
299 			    "getting zone configuration handle");
300 			return (Z_BAD_HANDLE);
301 		}
302 		err = zonecfg_get_snapshot_handle(zone_name, handle);
303 		if (err != Z_OK) {
304 			zerror(zlogp, B_FALSE,
305 			    "invalid configuration snapshot");
306 			zonecfg_fini_handle(handle);
307 			return (Z_BAD_HANDLE);
308 		}
309 
310 		bzero(zonecfg_args, sizeof (zonecfg_args));
311 		(void) zonecfg_get_bootargs(handle, zonecfg_args,
312 		    sizeof (zonecfg_args));
313 		inargs = zonecfg_args;
314 		zonecfg_fini_handle(handle);
315 	}
316 
317 	if (strlen(inargs) >= BOOTARGS_MAX) {
318 		zerror(zlogp, B_FALSE, "boot argument string too long");
319 		return (Z_INVAL);
320 	}
321 
322 	(void) strlcpy(scratchargs, inargs, sizeof (scratchargs));
323 	sargs = scratchargs;
324 	while ((arg = strtok_r(sargs, " \t", &lasts)) != NULL) {
325 		sargs = NULL;
326 		argc++;
327 	}
328 
329 	if ((argv = calloc(argc + 1, sizeof (char *))) == NULL) {
330 		zerror(zlogp, B_FALSE, "memory allocation failed");
331 		return (Z_NOMEM);
332 	}
333 
334 	argv_save = argv;
335 	argc_save = argc;
336 
337 	(void) strlcpy(scratchargs, inargs, sizeof (scratchargs));
338 	sargs = scratchargs;
339 	i = 0;
340 	while ((arg = strtok_r(sargs, " \t", &lasts)) != NULL) {
341 		sargs = NULL;
342 		if ((argv[i] = strdup(arg)) == NULL) {
343 			err = Z_NOMEM;
344 			zerror(zlogp, B_FALSE, "memory allocation failed");
345 			goto done;
346 		}
347 		i++;
348 	}
349 
350 	/*
351 	 * We preserve compatibility with the Solaris system boot behavior,
352 	 * which allows:
353 	 *
354 	 *	# reboot kernel/unix -s -m verbose
355 	 *
356 	 * In this example, kernel/unix tells the booter what file to
357 	 * boot.  We don't want reboot in a zone to be gratuitously different,
358 	 * so we silently ignore the boot file, if necessary.
359 	 */
360 	if (argv[0] == NULL)
361 		goto done;
362 
363 	assert(argv[0][0] != ' ');
364 	assert(argv[0][0] != '\t');
365 
366 	if (argv[0][0] != '-' && argv[0][0] != '\0') {
367 		argv = &argv[1];
368 		argc--;
369 	}
370 
371 	optind = 0;
372 	opterr = 0;
373 	err = Z_OK;
374 	while ((c = getopt(argc, argv, "fi:m:s")) != -1) {
375 		switch (c) {
376 		case 'i':
377 			/*
378 			 * -i is handled by the runtime and is not passed
379 			 * along to userland
380 			 */
381 			(void) strlcpy(init_file, optarg, MAXPATHLEN);
382 			break;
383 		case 'f':
384 			/* This has already been processed by zoneadm */
385 			break;
386 		case 'm':
387 		case 's':
388 			/* These pass through unmolested */
389 			(void) snprintf(outargs, BOOTARGS_MAX,
390 			    "%s -%c %s ", outargs, c, optarg ? optarg : "");
391 			break;
392 		case '?':
393 			/*
394 			 * We warn about unknown arguments but pass them
395 			 * along anyway-- if someone wants to develop their
396 			 * own init replacement, they can pass it whatever
397 			 * args they want.
398 			 */
399 			err = Z_INVAL;
400 			(void) snprintf(outargs, BOOTARGS_MAX,
401 			    "%s -%c", outargs, optopt);
402 			(void) snprintf(badarg, BOOTARGS_MAX,
403 			    "%s -%c", badarg, optopt);
404 			break;
405 		}
406 	}
407 
408 	/*
409 	 * For Solaris Zones we warn about and discard non-option arguments.
410 	 * Hence 'boot foo bar baz gub' --> 'boot'.  However, to be similar
411 	 * to the kernel, we concat up all the other remaining boot args.
412 	 * and warn on them as a group.
413 	 */
414 	if (optind < argc) {
415 		err = Z_INVAL;
416 		while (optind < argc) {
417 			(void) snprintf(badarg, BOOTARGS_MAX, "%s%s%s",
418 			    badarg, strlen(badarg) > 0 ? " " : "",
419 			    argv[optind]);
420 			optind++;
421 		}
422 		zerror(zlogp, B_FALSE, "WARNING: Unused or invalid boot "
423 		    "arguments `%s'.", badarg);
424 	}
425 
426 done:
427 	for (i = 0; i < argc_save; i++) {
428 		if (argv_save[i] != NULL)
429 			free(argv_save[i]);
430 	}
431 	free(argv_save);
432 	return (err);
433 }
434 
435 
436 static int
437 mkzonedir(zlog_t *zlogp)
438 {
439 	struct stat st;
440 	/*
441 	 * We must create and lock everyone but root out of ZONES_TMPDIR
442 	 * since anyone can open any UNIX domain socket, regardless of
443 	 * its file system permissions.  Sigh...
444 	 */
445 	if (mkdir(ZONES_TMPDIR, S_IRWXU) < 0 && errno != EEXIST) {
446 		zerror(zlogp, B_TRUE, "could not mkdir '%s'", ZONES_TMPDIR);
447 		return (-1);
448 	}
449 	/* paranoia */
450 	if ((stat(ZONES_TMPDIR, &st) < 0) || !S_ISDIR(st.st_mode)) {
451 		zerror(zlogp, B_TRUE, "'%s' is not a directory", ZONES_TMPDIR);
452 		return (-1);
453 	}
454 	(void) chmod(ZONES_TMPDIR, S_IRWXU);
455 	return (0);
456 }
457 
458 /*
459  * Run the brand's pre-state change callback, if it exists.
460  */
461 static int
462 brand_prestatechg(zlog_t *zlogp, int state, int cmd)
463 {
464 	char cmdbuf[2 * MAXPATHLEN];
465 	const char *altroot;
466 
467 	if (pre_statechg_hook[0] == '\0')
468 		return (0);
469 
470 	altroot = zonecfg_get_root();
471 	if (snprintf(cmdbuf, sizeof (cmdbuf), "%s %d %d %s", pre_statechg_hook,
472 	    state, cmd, altroot) > sizeof (cmdbuf))
473 		return (-1);
474 
475 	if (do_subproc(zlogp, cmdbuf, NULL) != 0)
476 		return (-1);
477 
478 	return (0);
479 }
480 
481 /*
482  * Run the brand's post-state change callback, if it exists.
483  */
484 static int
485 brand_poststatechg(zlog_t *zlogp, int state, int cmd)
486 {
487 	char cmdbuf[2 * MAXPATHLEN];
488 	const char *altroot;
489 
490 	if (post_statechg_hook[0] == '\0')
491 		return (0);
492 
493 	altroot = zonecfg_get_root();
494 	if (snprintf(cmdbuf, sizeof (cmdbuf), "%s %d %d %s", post_statechg_hook,
495 	    state, cmd, altroot) > sizeof (cmdbuf))
496 		return (-1);
497 
498 	if (do_subproc(zlogp, cmdbuf, NULL) != 0)
499 		return (-1);
500 
501 	return (0);
502 }
503 
504 /*
505  * Notify zonestatd of the new zone.  If zonestatd is not running, this
506  * will do nothing.
507  */
508 static void
509 notify_zonestatd(zoneid_t zoneid)
510 {
511 	int cmd[2];
512 	int fd;
513 	door_arg_t params;
514 
515 	fd = open(ZS_DOOR_PATH, O_RDONLY);
516 	if (fd < 0)
517 		return;
518 
519 	cmd[0] = ZSD_CMD_NEW_ZONE;
520 	cmd[1] = zoneid;
521 	params.data_ptr = (char *)&cmd;
522 	params.data_size = sizeof (cmd);
523 	params.desc_ptr = NULL;
524 	params.desc_num = 0;
525 	params.rbuf = NULL;
526 	params.rsize = 0;
527 	(void) door_call(fd, &params);
528 	(void) close(fd);
529 }
530 
531 /*
532  * Bring a zone up to the pre-boot "ready" stage.  The mount_cmd argument is
533  * 'true' if this is being invoked as part of the processing for the "mount"
534  * subcommand.
535  */
536 static int
537 zone_ready(zlog_t *zlogp, zone_mnt_t mount_cmd, int zstate)
538 {
539 	int err;
540 
541 	if (brand_prestatechg(zlogp, zstate, Z_READY) != 0)
542 		return (-1);
543 
544 	if ((err = zonecfg_create_snapshot(zone_name)) != Z_OK) {
545 		zerror(zlogp, B_FALSE, "unable to create snapshot: %s",
546 		    zonecfg_strerror(err));
547 		goto bad;
548 	}
549 
550 	if ((zone_id = vplat_create(zlogp, mount_cmd)) == -1) {
551 		if ((err = zonecfg_destroy_snapshot(zone_name)) != Z_OK)
552 			zerror(zlogp, B_FALSE, "destroying snapshot: %s",
553 			    zonecfg_strerror(err));
554 		goto bad;
555 	}
556 	if (vplat_bringup(zlogp, mount_cmd, zone_id) != 0) {
557 		bringup_failure_recovery = B_TRUE;
558 		(void) vplat_teardown(NULL, (mount_cmd != Z_MNT_BOOT), B_FALSE);
559 		if ((err = zonecfg_destroy_snapshot(zone_name)) != Z_OK)
560 			zerror(zlogp, B_FALSE, "destroying snapshot: %s",
561 			    zonecfg_strerror(err));
562 		goto bad;
563 	}
564 
565 	if (brand_poststatechg(zlogp, zstate, Z_READY) != 0)
566 		goto bad;
567 
568 	return (0);
569 
570 bad:
571 	/*
572 	 * If something goes wrong, we up the zones's state to the target
573 	 * state, READY, and then invoke the hook as if we're halting.
574 	 */
575 	(void) brand_poststatechg(zlogp, ZONE_STATE_READY, Z_HALT);
576 	return (-1);
577 }
578 
579 int
580 init_template(void)
581 {
582 	int fd;
583 	int err = 0;
584 
585 	fd = open64(CTFS_ROOT "/process/template", O_RDWR);
586 	if (fd == -1)
587 		return (-1);
588 
589 	/*
590 	 * For now, zoneadmd doesn't do anything with the contract.
591 	 * Deliver no events, don't inherit, and allow it to be orphaned.
592 	 */
593 	err |= ct_tmpl_set_critical(fd, 0);
594 	err |= ct_tmpl_set_informative(fd, 0);
595 	err |= ct_pr_tmpl_set_fatal(fd, CT_PR_EV_HWERR);
596 	err |= ct_pr_tmpl_set_param(fd, CT_PR_PGRPONLY | CT_PR_REGENT);
597 	if (err || ct_tmpl_activate(fd)) {
598 		(void) close(fd);
599 		return (-1);
600 	}
601 
602 	return (fd);
603 }
604 
605 typedef struct fs_callback {
606 	zlog_t		*zlogp;
607 	zoneid_t	zoneid;
608 	boolean_t	mount_cmd;
609 } fs_callback_t;
610 
611 static int
612 mount_early_fs(void *data, const char *spec, const char *dir,
613     const char *fstype, const char *opt)
614 {
615 	zlog_t *zlogp = ((fs_callback_t *)data)->zlogp;
616 	zoneid_t zoneid = ((fs_callback_t *)data)->zoneid;
617 	boolean_t mount_cmd = ((fs_callback_t *)data)->mount_cmd;
618 	char rootpath[MAXPATHLEN];
619 	pid_t child;
620 	int child_status;
621 	int tmpl_fd;
622 	int rv;
623 	ctid_t ct;
624 
625 	/* determine the zone rootpath */
626 	if (mount_cmd) {
627 		char zonepath[MAXPATHLEN];
628 		char luroot[MAXPATHLEN];
629 
630 		if (zone_get_zonepath(zone_name,
631 		    zonepath, sizeof (zonepath)) != Z_OK) {
632 			zerror(zlogp, B_FALSE, "unable to determine zone path");
633 			return (-1);
634 		}
635 
636 		(void) snprintf(luroot, sizeof (luroot), "%s/lu", zonepath);
637 		resolve_lofs(zlogp, luroot, sizeof (luroot));
638 		(void) strlcpy(rootpath, luroot, sizeof (rootpath));
639 	} else {
640 		if (zone_get_rootpath(zone_name,
641 		    rootpath, sizeof (rootpath)) != Z_OK) {
642 			zerror(zlogp, B_FALSE, "unable to determine zone root");
643 			return (-1);
644 		}
645 	}
646 
647 	if ((rv = valid_mount_path(zlogp, rootpath, spec, dir, fstype)) < 0) {
648 		zerror(zlogp, B_FALSE, "%s%s is not a valid mount point",
649 		    rootpath, dir);
650 		return (-1);
651 	} else if (rv > 0) {
652 		/* The mount point path doesn't exist, create it now. */
653 		if (make_one_dir(zlogp, rootpath, dir,
654 		    DEFAULT_DIR_MODE, DEFAULT_DIR_USER,
655 		    DEFAULT_DIR_GROUP) != 0) {
656 			zerror(zlogp, B_FALSE, "failed to create mount point");
657 			return (-1);
658 		}
659 
660 		/*
661 		 * Now this might seem weird, but we need to invoke
662 		 * valid_mount_path() again.  Why?  Because it checks
663 		 * to make sure that the mount point path is canonical,
664 		 * which it can only do if the path exists, so now that
665 		 * we've created the path we have to verify it again.
666 		 */
667 		if ((rv = valid_mount_path(zlogp, rootpath, spec, dir,
668 		    fstype)) < 0) {
669 			zerror(zlogp, B_FALSE,
670 			    "%s%s is not a valid mount point", rootpath, dir);
671 			return (-1);
672 		}
673 	}
674 
675 	if ((tmpl_fd = init_template()) == -1) {
676 		zerror(zlogp, B_TRUE, "failed to create contract");
677 		return (-1);
678 	}
679 
680 	if ((child = fork()) == -1) {
681 		(void) ct_tmpl_clear(tmpl_fd);
682 		(void) close(tmpl_fd);
683 		zerror(zlogp, B_TRUE, "failed to fork");
684 		return (-1);
685 
686 	} else if (child == 0) {	/* child */
687 		char opt_buf[MAX_MNTOPT_STR];
688 		int optlen = 0;
689 		int mflag = MS_DATA;
690 
691 		(void) ct_tmpl_clear(tmpl_fd);
692 		/*
693 		 * Even though there are no procs running in the zone, we
694 		 * do this for paranoia's sake.
695 		 */
696 		(void) closefrom(0);
697 
698 		if (zone_enter(zoneid) == -1) {
699 			_exit(errno);
700 		}
701 		if (opt != NULL) {
702 			/*
703 			 * The mount() system call is incredibly annoying.
704 			 * If options are specified, we need to copy them
705 			 * into a temporary buffer since the mount() system
706 			 * call will overwrite the options string.  It will
707 			 * also fail if the new option string it wants to
708 			 * write is bigger than the one we passed in, so
709 			 * you must pass in a buffer of the maximum possible
710 			 * option string length.  sigh.
711 			 */
712 			(void) strlcpy(opt_buf, opt, sizeof (opt_buf));
713 			opt = opt_buf;
714 			optlen = MAX_MNTOPT_STR;
715 			mflag = MS_OPTIONSTR;
716 		}
717 		if (mount(spec, dir, mflag, fstype, NULL, 0, opt, optlen) != 0)
718 			_exit(errno);
719 		_exit(0);
720 	}
721 
722 	/* parent */
723 	if (contract_latest(&ct) == -1)
724 		ct = -1;
725 	(void) ct_tmpl_clear(tmpl_fd);
726 	(void) close(tmpl_fd);
727 	if (waitpid(child, &child_status, 0) != child) {
728 		/* unexpected: we must have been signalled */
729 		(void) contract_abandon_id(ct);
730 		return (-1);
731 	}
732 	(void) contract_abandon_id(ct);
733 	if (WEXITSTATUS(child_status) != 0) {
734 		errno = WEXITSTATUS(child_status);
735 		zerror(zlogp, B_TRUE, "mount of %s failed", dir);
736 		return (-1);
737 	}
738 
739 	return (0);
740 }
741 
742 /*
743  * If retstr is not NULL, the output of the subproc is returned in the str,
744  * otherwise it is output using zerror().  Any memory allocated for retstr
745  * should be freed by the caller.
746  */
747 int
748 do_subproc(zlog_t *zlogp, char *cmdbuf, char **retstr)
749 {
750 	char buf[1024];		/* arbitrary large amount */
751 	char *inbuf;
752 	FILE *file;
753 	int status;
754 	int rd_cnt;
755 
756 	if (retstr != NULL) {
757 		if ((*retstr = malloc(1024)) == NULL) {
758 			zerror(zlogp, B_FALSE, "out of memory");
759 			return (-1);
760 		}
761 		inbuf = *retstr;
762 		rd_cnt = 0;
763 	} else {
764 		inbuf = buf;
765 	}
766 
767 	file = popen(cmdbuf, "r");
768 	if (file == NULL) {
769 		zerror(zlogp, B_TRUE, "could not launch: %s", cmdbuf);
770 		return (-1);
771 	}
772 
773 	while (fgets(inbuf, 1024, file) != NULL) {
774 		if (retstr == NULL) {
775 			if (zlogp != &logsys)
776 				zerror(zlogp, B_FALSE, "%s", inbuf);
777 		} else {
778 			char *p;
779 
780 			rd_cnt += 1024 - 1;
781 			if ((p = realloc(*retstr, rd_cnt + 1024)) == NULL) {
782 				zerror(zlogp, B_FALSE, "out of memory");
783 				(void) pclose(file);
784 				return (-1);
785 			}
786 
787 			*retstr = p;
788 			inbuf = *retstr + rd_cnt;
789 		}
790 	}
791 	status = pclose(file);
792 
793 	if (WIFSIGNALED(status)) {
794 		zerror(zlogp, B_FALSE, "%s unexpectedly terminated due to "
795 		    "signal %d", cmdbuf, WTERMSIG(status));
796 		return (-1);
797 	}
798 	assert(WIFEXITED(status));
799 	if (WEXITSTATUS(status) == ZEXIT_EXEC) {
800 		zerror(zlogp, B_FALSE, "failed to exec %s", cmdbuf);
801 		return (-1);
802 	}
803 	return (WEXITSTATUS(status));
804 }
805 
806 static int
807 zone_bootup(zlog_t *zlogp, const char *bootargs, int zstate)
808 {
809 	zoneid_t zoneid;
810 	struct stat st;
811 	char zpath[MAXPATHLEN], initpath[MAXPATHLEN], init_file[MAXPATHLEN];
812 	char nbootargs[BOOTARGS_MAX];
813 	char cmdbuf[MAXPATHLEN];
814 	fs_callback_t cb;
815 	brand_handle_t bh;
816 	zone_iptype_t iptype;
817 	boolean_t links_loaded = B_FALSE;
818 	dladm_status_t status;
819 	char errmsg[DLADM_STRSIZE];
820 	int err;
821 	boolean_t restart_init, restart_init0, restart_initreboot;
822 
823 	if (brand_prestatechg(zlogp, zstate, Z_BOOT) != 0)
824 		return (-1);
825 
826 	if ((zoneid = getzoneidbyname(zone_name)) == -1) {
827 		zerror(zlogp, B_TRUE, "unable to get zoneid");
828 		goto bad;
829 	}
830 
831 	cb.zlogp = zlogp;
832 	cb.zoneid = zoneid;
833 	cb.mount_cmd = B_FALSE;
834 
835 	/* Get a handle to the brand info for this zone */
836 	if ((bh = brand_open(brand_name)) == NULL) {
837 		zerror(zlogp, B_FALSE, "unable to determine zone brand");
838 		goto bad;
839 	}
840 
841 	/*
842 	 * Get the list of filesystems to mount from the brand
843 	 * configuration.  These mounts are done via a thread that will
844 	 * enter the zone, so they are done from within the context of the
845 	 * zone.
846 	 */
847 	if (brand_platform_iter_mounts(bh, mount_early_fs, &cb) != 0) {
848 		zerror(zlogp, B_FALSE, "unable to mount filesystems");
849 		brand_close(bh);
850 		goto bad;
851 	}
852 
853 	/*
854 	 * Get the brand's boot callback if it exists.
855 	 */
856 	if (zone_get_zonepath(zone_name, zpath, sizeof (zpath)) != Z_OK) {
857 		zerror(zlogp, B_FALSE, "unable to determine zone path");
858 		brand_close(bh);
859 		goto bad;
860 	}
861 	(void) strcpy(cmdbuf, EXEC_PREFIX);
862 	if (brand_get_boot(bh, zone_name, zpath, cmdbuf + EXEC_LEN,
863 	    sizeof (cmdbuf) - EXEC_LEN) != 0) {
864 		zerror(zlogp, B_FALSE,
865 		    "unable to determine branded zone's boot callback");
866 		brand_close(bh);
867 		goto bad;
868 	}
869 
870 	/* Get the path for this zone's init(8) (or equivalent) process.  */
871 	if (brand_get_initname(bh, init_file, MAXPATHLEN) != 0) {
872 		zerror(zlogp, B_FALSE,
873 		    "unable to determine zone's init(8) location");
874 		brand_close(bh);
875 		goto bad;
876 	}
877 
878 	/* See if this zone's brand should restart init if it dies. */
879 	restart_init = brand_restartinit(bh);
880 	restart_init0 = brand_restartinit0(bh);
881 	restart_initreboot = brand_restartinitreboot(bh);
882 
883 	brand_close(bh);
884 
885 	err = filter_bootargs(zlogp, bootargs, nbootargs, init_file,
886 	    bad_boot_arg);
887 	if (err == Z_INVAL)
888 		eventstream_write(Z_EVT_ZONE_BADARGS);
889 	else if (err != Z_OK)
890 		goto bad;
891 
892 	assert(init_file[0] != '\0');
893 
894 	/* Try to anticipate possible problems: Make sure init is executable. */
895 	if (zone_get_rootpath(zone_name, zpath, sizeof (zpath)) != Z_OK) {
896 		zerror(zlogp, B_FALSE, "unable to determine zone root");
897 		goto bad;
898 	}
899 
900 	(void) snprintf(initpath, sizeof (initpath), "%s%s", zpath, init_file);
901 
902 	if (stat(initpath, &st) == -1) {
903 		zerror(zlogp, B_TRUE, "could not stat %s", initpath);
904 		goto bad;
905 	}
906 
907 	if ((st.st_mode & S_IXUSR) == 0) {
908 		zerror(zlogp, B_FALSE, "%s is not executable", initpath);
909 		goto bad;
910 	}
911 
912 	/*
913 	 * Exclusive stack zones interact with the dlmgmtd running in the
914 	 * global zone.  dladm_zone_boot() tells dlmgmtd that this zone is
915 	 * booting, and loads its datalinks from the zone's datalink
916 	 * configuration file.
917 	 */
918 	if (vplat_get_iptype(zlogp, &iptype) == 0 && iptype == ZS_EXCLUSIVE) {
919 		status = dladm_zone_boot(dld_handle, zoneid);
920 		if (status != DLADM_STATUS_OK) {
921 			zerror(zlogp, B_FALSE, "unable to load zone datalinks: "
922 			    " %s", dladm_status2str(status, errmsg));
923 			goto bad;
924 		}
925 		links_loaded = B_TRUE;
926 	}
927 
928 	/*
929 	 * If there is a brand 'boot' callback, execute it now to give the
930 	 * brand one last chance to do any additional setup before the zone
931 	 * is booted.
932 	 */
933 	if ((strlen(cmdbuf) > EXEC_LEN) &&
934 	    (do_subproc(zlogp, cmdbuf, NULL) != Z_OK)) {
935 		zerror(zlogp, B_FALSE, "%s failed", cmdbuf);
936 		goto bad;
937 	}
938 
939 	if (zone_setattr(zoneid, ZONE_ATTR_INITNAME, init_file, 0) == -1) {
940 		zerror(zlogp, B_TRUE, "could not set zone boot file");
941 		goto bad;
942 	}
943 
944 	if (zone_setattr(zoneid, ZONE_ATTR_BOOTARGS, nbootargs, 0) == -1) {
945 		zerror(zlogp, B_TRUE, "could not set zone boot arguments");
946 		goto bad;
947 	}
948 
949 	if (!restart_init && zone_setattr(zoneid, ZONE_ATTR_INITNORESTART,
950 	    NULL, 0) == -1) {
951 		zerror(zlogp, B_TRUE, "could not set zone init-no-restart");
952 		goto bad;
953 	}
954 	if (restart_init0 && zone_setattr(zoneid, ZONE_ATTR_INITRESTART0,
955 	    NULL, 0) == -1) {
956 		zerror(zlogp, B_TRUE,
957 		    "could not set zone init-restart-on-exit-0");
958 		goto bad;
959 	}
960 	if (restart_initreboot && zone_setattr(zoneid, ZONE_ATTR_INITREBOOT,
961 	    NULL, 0) == -1) {
962 		zerror(zlogp, B_TRUE, "could not set zone reboot-on-init-exit");
963 		goto bad;
964 	}
965 
966 	/*
967 	 * Inform zonestatd of a new zone so that it can install a door for
968 	 * the zone to contact it.
969 	 */
970 	notify_zonestatd(zone_id);
971 
972 	if (zone_boot(zoneid) == -1) {
973 		zerror(zlogp, B_TRUE, "unable to boot zone");
974 		goto bad;
975 	}
976 
977 	if (brand_poststatechg(zlogp, zstate, Z_BOOT) != 0)
978 		goto bad;
979 
980 	return (0);
981 
982 bad:
983 	/*
984 	 * If something goes wrong, we up the zones's state to the target
985 	 * state, RUNNING, and then invoke the hook as if we're halting.
986 	 */
987 	(void) brand_poststatechg(zlogp, ZONE_STATE_RUNNING, Z_HALT);
988 	if (links_loaded)
989 		(void) dladm_zone_halt(dld_handle, zoneid);
990 	return (-1);
991 }
992 
993 static int
994 zone_halt(zlog_t *zlogp, boolean_t unmount_cmd, boolean_t rebooting, int zstate)
995 {
996 	int err;
997 
998 	if (brand_prestatechg(zlogp, zstate, Z_HALT) != 0)
999 		return (-1);
1000 
1001 	if (vplat_teardown(zlogp, unmount_cmd, rebooting) != 0) {
1002 		if (!bringup_failure_recovery)
1003 			zerror(zlogp, B_FALSE, "unable to destroy zone");
1004 		return (-1);
1005 	}
1006 
1007 	if ((err = zonecfg_destroy_snapshot(zone_name)) != Z_OK)
1008 		zerror(zlogp, B_FALSE, "destroying snapshot: %s",
1009 		    zonecfg_strerror(err));
1010 
1011 	if (brand_poststatechg(zlogp, zstate, Z_HALT) != 0)
1012 		return (-1);
1013 
1014 	return (0);
1015 }
1016 
1017 static int
1018 zone_graceful_shutdown(zlog_t *zlogp)
1019 {
1020 	zoneid_t zoneid;
1021 	pid_t child;
1022 	char cmdbuf[MAXPATHLEN];
1023 	brand_handle_t bh = NULL;
1024 	char zpath[MAXPATHLEN];
1025 	ctid_t ct;
1026 	int tmpl_fd;
1027 	int child_status;
1028 
1029 	if (shutdown_in_progress) {
1030 		zerror(zlogp, B_FALSE, "shutdown already in progress");
1031 		return (-1);
1032 	}
1033 
1034 	if ((zoneid = getzoneidbyname(zone_name)) == -1) {
1035 		zerror(zlogp, B_TRUE, "unable to get zoneid");
1036 		return (-1);
1037 	}
1038 
1039 	/* Get a handle to the brand info for this zone */
1040 	if ((bh = brand_open(brand_name)) == NULL) {
1041 		zerror(zlogp, B_FALSE, "unable to determine zone brand");
1042 		return (-1);
1043 	}
1044 
1045 	if (zone_get_zonepath(zone_name, zpath, sizeof (zpath)) != Z_OK) {
1046 		zerror(zlogp, B_FALSE, "unable to determine zone path");
1047 		brand_close(bh);
1048 		return (-1);
1049 	}
1050 
1051 	/*
1052 	 * If there is a brand 'shutdown' callback, execute it now to give the
1053 	 * brand a chance to cleanup any custom configuration.
1054 	 */
1055 	(void) strcpy(cmdbuf, EXEC_PREFIX);
1056 	if (brand_get_shutdown(bh, zone_name, zpath, cmdbuf + EXEC_LEN,
1057 	    sizeof (cmdbuf) - EXEC_LEN) != 0 || strlen(cmdbuf) <= EXEC_LEN) {
1058 		(void) strcat(cmdbuf, SHUTDOWN_DEFAULT);
1059 	}
1060 	brand_close(bh);
1061 
1062 	if ((tmpl_fd = init_template()) == -1) {
1063 		zerror(zlogp, B_TRUE, "failed to create contract");
1064 		return (-1);
1065 	}
1066 
1067 	if ((child = fork()) == -1) {
1068 		(void) ct_tmpl_clear(tmpl_fd);
1069 		(void) close(tmpl_fd);
1070 		zerror(zlogp, B_TRUE, "failed to fork");
1071 		return (-1);
1072 	} else if (child == 0) {
1073 		(void) ct_tmpl_clear(tmpl_fd);
1074 		if (zone_enter(zoneid) == -1) {
1075 			_exit(errno);
1076 		}
1077 		_exit(execl("/bin/sh", "sh", "-c", cmdbuf, (char *)NULL));
1078 	}
1079 
1080 	if (contract_latest(&ct) == -1)
1081 		ct = -1;
1082 	(void) ct_tmpl_clear(tmpl_fd);
1083 	(void) close(tmpl_fd);
1084 
1085 	if (waitpid(child, &child_status, 0) != child) {
1086 		/* unexpected: we must have been signalled */
1087 		(void) contract_abandon_id(ct);
1088 		return (-1);
1089 	}
1090 
1091 	(void) contract_abandon_id(ct);
1092 	if (WEXITSTATUS(child_status) != 0) {
1093 		errno = WEXITSTATUS(child_status);
1094 		zerror(zlogp, B_FALSE, "unable to shutdown zone");
1095 		return (-1);
1096 	}
1097 
1098 	shutdown_in_progress = B_TRUE;
1099 
1100 	return (0);
1101 }
1102 
1103 static int
1104 zone_wait_shutdown(zlog_t *zlogp)
1105 {
1106 	zone_state_t zstate;
1107 	uint64_t *tm = NULL;
1108 	scf_simple_prop_t *prop = NULL;
1109 	int timeout;
1110 	int tries;
1111 	int rc = -1;
1112 
1113 	/* Get default stop timeout from SMF framework */
1114 	timeout = SHUTDOWN_WAIT;
1115 	if ((prop = scf_simple_prop_get(NULL, SHUTDOWN_FMRI, "stop",
1116 	    SCF_PROPERTY_TIMEOUT)) != NULL) {
1117 		if ((tm = scf_simple_prop_next_count(prop)) != NULL) {
1118 			if (tm != 0)
1119 				timeout = *tm;
1120 		}
1121 		scf_simple_prop_free(prop);
1122 	}
1123 
1124 	/* allow time for zone to shutdown cleanly */
1125 	for (tries = 0; tries < timeout; tries ++) {
1126 		(void) sleep(1);
1127 		if (zone_get_state(zone_name, &zstate) == Z_OK &&
1128 		    zstate == ZONE_STATE_INSTALLED) {
1129 			rc = 0;
1130 			break;
1131 		}
1132 	}
1133 
1134 	if (rc != 0)
1135 		zerror(zlogp, B_FALSE, "unable to shutdown zone");
1136 
1137 	shutdown_in_progress = B_FALSE;
1138 
1139 	return (rc);
1140 }
1141 
1142 
1143 
1144 /*
1145  * Generate AUE_zone_state for a command that boots a zone.
1146  */
1147 static void
1148 audit_put_record(zlog_t *zlogp, ucred_t *uc, int return_val,
1149     char *new_state)
1150 {
1151 	adt_session_data_t	*ah;
1152 	adt_event_data_t	*event;
1153 	int			pass_fail, fail_reason;
1154 
1155 	if (!adt_audit_enabled())
1156 		return;
1157 
1158 	if (return_val == 0) {
1159 		pass_fail = ADT_SUCCESS;
1160 		fail_reason = ADT_SUCCESS;
1161 	} else {
1162 		pass_fail = ADT_FAILURE;
1163 		fail_reason = ADT_FAIL_VALUE_PROGRAM;
1164 	}
1165 
1166 	if (adt_start_session(&ah, NULL, 0)) {
1167 		zerror(zlogp, B_TRUE, gettext("audit failure."));
1168 		return;
1169 	}
1170 	if (adt_set_from_ucred(ah, uc, ADT_NEW)) {
1171 		zerror(zlogp, B_TRUE, gettext("audit failure."));
1172 		(void) adt_end_session(ah);
1173 		return;
1174 	}
1175 
1176 	event = adt_alloc_event(ah, ADT_zone_state);
1177 	if (event == NULL) {
1178 		zerror(zlogp, B_TRUE, gettext("audit failure."));
1179 		(void) adt_end_session(ah);
1180 		return;
1181 	}
1182 	event->adt_zone_state.zonename = zone_name;
1183 	event->adt_zone_state.new_state = new_state;
1184 
1185 	if (adt_put_event(event, pass_fail, fail_reason))
1186 		zerror(zlogp, B_TRUE, gettext("audit failure."));
1187 
1188 	adt_free_event(event);
1189 
1190 	(void) adt_end_session(ah);
1191 }
1192 
1193 /*
1194  * The main routine for the door server that deals with zone state transitions.
1195  */
1196 /* ARGSUSED */
1197 static void
1198 server(void *cookie, char *args, size_t alen, door_desc_t *dp,
1199     uint_t n_desc)
1200 {
1201 	ucred_t *uc = NULL;
1202 	const priv_set_t *eset;
1203 
1204 	zone_state_t zstate;
1205 	zone_cmd_t cmd;
1206 	zone_cmd_arg_t *zargp;
1207 
1208 	boolean_t kernelcall = B_FALSE;
1209 
1210 	int rval = -1;
1211 	uint64_t uniqid;
1212 	zoneid_t zoneid = -1;
1213 	zlog_t zlog;
1214 	zlog_t *zlogp;
1215 	zone_cmd_rval_t *rvalp;
1216 	size_t rlen = getpagesize(); /* conservative */
1217 	fs_callback_t cb;
1218 	brand_handle_t bh;
1219 	boolean_t wait_shut = B_FALSE;
1220 
1221 	/* LINTED E_BAD_PTR_CAST_ALIGN */
1222 	zargp = (zone_cmd_arg_t *)args;
1223 
1224 	/*
1225 	 * When we get the door unref message, we've fdetach'd the door, and
1226 	 * it is time for us to shut down zoneadmd.
1227 	 */
1228 	if (zargp == DOOR_UNREF_DATA) {
1229 		/*
1230 		 * See comment at end of main() for info on the last rites.
1231 		 */
1232 		exit(0);
1233 	}
1234 
1235 	if (zargp == NULL) {
1236 		(void) door_return(NULL, 0, 0, 0);
1237 	}
1238 
1239 	rvalp = alloca(rlen);
1240 	bzero(rvalp, rlen);
1241 	zlog.logfile = NULL;
1242 	zlog.buflen = zlog.loglen = rlen - sizeof (zone_cmd_rval_t) + 1;
1243 	zlog.buf = rvalp->errbuf;
1244 	zlog.log = zlog.buf;
1245 	/* defer initialization of zlog.locale until after credential check */
1246 	zlogp = &zlog;
1247 
1248 	if (alen != sizeof (zone_cmd_arg_t)) {
1249 		/*
1250 		 * This really shouldn't be happening.
1251 		 */
1252 		zerror(&logsys, B_FALSE, "argument size (%d bytes) "
1253 		    "unexpected (expected %d bytes)", alen,
1254 		    sizeof (zone_cmd_arg_t));
1255 		goto out;
1256 	}
1257 	cmd = zargp->cmd;
1258 
1259 	if (door_ucred(&uc) != 0) {
1260 		zerror(&logsys, B_TRUE, "door_ucred");
1261 		goto out;
1262 	}
1263 	eset = ucred_getprivset(uc, PRIV_EFFECTIVE);
1264 	if (ucred_getzoneid(uc) != GLOBAL_ZONEID ||
1265 	    (eset != NULL ? !priv_ismember(eset, PRIV_SYS_CONFIG) :
1266 	    ucred_geteuid(uc) != 0)) {
1267 		zerror(&logsys, B_FALSE, "insufficient privileges");
1268 		goto out;
1269 	}
1270 
1271 	kernelcall = ucred_getpid(uc) == 0;
1272 
1273 	/*
1274 	 * This is safe because we only use a zlog_t throughout the
1275 	 * duration of a door call; i.e., by the time the pointer
1276 	 * might become invalid, the door call would be over.
1277 	 */
1278 	zlog.locale = kernelcall ? DEFAULT_LOCALE : zargp->locale;
1279 
1280 	(void) mutex_lock(&lock);
1281 
1282 	/*
1283 	 * Once we start to really die off, we don't want more connections.
1284 	 */
1285 	if (in_death_throes) {
1286 		(void) mutex_unlock(&lock);
1287 		ucred_free(uc);
1288 		(void) door_return(NULL, 0, 0, 0);
1289 		thr_exit(NULL);
1290 	}
1291 
1292 	/*
1293 	 * Check for validity of command.
1294 	 */
1295 	if (cmd != Z_READY && cmd != Z_BOOT && cmd != Z_FORCEBOOT &&
1296 	    cmd != Z_REBOOT && cmd != Z_SHUTDOWN && cmd != Z_HALT &&
1297 	    cmd != Z_NOTE_UNINSTALLING && cmd != Z_MOUNT &&
1298 	    cmd != Z_FORCEMOUNT && cmd != Z_UNMOUNT) {
1299 		zerror(&logsys, B_FALSE, "invalid command %d", (int)cmd);
1300 		goto out;
1301 	}
1302 
1303 	if (kernelcall && (cmd != Z_HALT && cmd != Z_REBOOT)) {
1304 		/*
1305 		 * Can't happen
1306 		 */
1307 		zerror(&logsys, B_FALSE, "received unexpected kernel upcall %d",
1308 		    cmd);
1309 		goto out;
1310 	}
1311 	/*
1312 	 * We ignore the possibility of someone calling zone_create(2)
1313 	 * explicitly; all requests must come through zoneadmd.
1314 	 */
1315 	if (zone_get_state(zone_name, &zstate) != Z_OK) {
1316 		/*
1317 		 * Something terribly wrong happened
1318 		 */
1319 		zerror(&logsys, B_FALSE, "unable to determine state of zone");
1320 		goto out;
1321 	}
1322 
1323 	if (kernelcall) {
1324 		/*
1325 		 * Kernel-initiated requests may lose their validity if the
1326 		 * zone_t the kernel was referring to has gone away.
1327 		 */
1328 		if ((zoneid = getzoneidbyname(zone_name)) == -1 ||
1329 		    zone_getattr(zoneid, ZONE_ATTR_UNIQID, &uniqid,
1330 		    sizeof (uniqid)) == -1 || uniqid != zargp->uniqid) {
1331 			/*
1332 			 * We're not talking about the same zone. The request
1333 			 * must have arrived too late.  Return error.
1334 			 */
1335 			rval = -1;
1336 			goto out;
1337 		}
1338 		zlogp = &logsys;	/* Log errors to syslog */
1339 	}
1340 
1341 	/*
1342 	 * If we are being asked to forcibly mount or boot a zone, we
1343 	 * pretend that an INCOMPLETE zone is actually INSTALLED.
1344 	 */
1345 	if (zstate == ZONE_STATE_INCOMPLETE &&
1346 	    (cmd == Z_FORCEBOOT || cmd == Z_FORCEMOUNT))
1347 		zstate = ZONE_STATE_INSTALLED;
1348 
1349 	switch (zstate) {
1350 	case ZONE_STATE_CONFIGURED:
1351 	case ZONE_STATE_INCOMPLETE:
1352 		/*
1353 		 * Not our area of expertise; we just print a nice message
1354 		 * and die off.
1355 		 */
1356 		zerror(zlogp, B_FALSE,
1357 		    "%s operation is invalid for zones in state '%s'",
1358 		    z_cmd_name(cmd), zone_state_str(zstate));
1359 		break;
1360 
1361 	case ZONE_STATE_INSTALLED:
1362 		switch (cmd) {
1363 		case Z_READY:
1364 			rval = zone_ready(zlogp, Z_MNT_BOOT, zstate);
1365 			if (rval == 0)
1366 				eventstream_write(Z_EVT_ZONE_READIED);
1367 			break;
1368 		case Z_BOOT:
1369 		case Z_FORCEBOOT:
1370 			eventstream_write(Z_EVT_ZONE_BOOTING);
1371 			if ((rval = zone_ready(zlogp, Z_MNT_BOOT, zstate))
1372 			    == 0) {
1373 				rval = zone_bootup(zlogp, zargp->bootbuf,
1374 				    zstate);
1375 			}
1376 			audit_put_record(zlogp, uc, rval, "boot");
1377 			if (rval != 0) {
1378 				bringup_failure_recovery = B_TRUE;
1379 				(void) zone_halt(zlogp, B_FALSE, B_FALSE,
1380 				    zstate);
1381 				eventstream_write(Z_EVT_ZONE_BOOTFAILED);
1382 			}
1383 			break;
1384 		case Z_SHUTDOWN:
1385 		case Z_HALT:
1386 			if (kernelcall)	/* Invalid; can't happen */
1387 				abort();
1388 			/*
1389 			 * We could have two clients racing to halt this
1390 			 * zone; the second client loses, but its request
1391 			 * doesn't fail, since the zone is now in the desired
1392 			 * state.
1393 			 */
1394 			zerror(zlogp, B_FALSE, "zone is already halted");
1395 			rval = 0;
1396 			break;
1397 		case Z_REBOOT:
1398 			if (kernelcall)	/* Invalid; can't happen */
1399 				abort();
1400 			zerror(zlogp, B_FALSE, "%s operation is invalid "
1401 			    "for zones in state '%s'", z_cmd_name(cmd),
1402 			    zone_state_str(zstate));
1403 			rval = -1;
1404 			break;
1405 		case Z_NOTE_UNINSTALLING:
1406 			if (kernelcall)	/* Invalid; can't happen */
1407 				abort();
1408 			/*
1409 			 * Tell the console to print out a message about this.
1410 			 * Once it does, we will be in_death_throes.
1411 			 */
1412 			eventstream_write(Z_EVT_ZONE_UNINSTALLING);
1413 			break;
1414 		case Z_MOUNT:
1415 		case Z_FORCEMOUNT:
1416 			if (kernelcall)	/* Invalid; can't happen */
1417 				abort();
1418 			if (!zone_isnative && !zone_iscluster &&
1419 			    !zone_islabeled) {
1420 				/*
1421 				 * -U mounts the zone without lofs mounting
1422 				 * zone file systems back into the scratch
1423 				 * zone.  This is required when mounting
1424 				 * non-native branded zones.
1425 				 */
1426 				(void) strlcpy(zargp->bootbuf, "-U",
1427 				    BOOTARGS_MAX);
1428 			}
1429 
1430 			rval = zone_ready(zlogp,
1431 			    strcmp(zargp->bootbuf, "-U") == 0 ?
1432 			    Z_MNT_UPDATE : Z_MNT_SCRATCH, zstate);
1433 			if (rval != 0)
1434 				break;
1435 
1436 			eventstream_write(Z_EVT_ZONE_READIED);
1437 
1438 			/*
1439 			 * Get a handle to the default brand info.
1440 			 * We must always use the default brand file system
1441 			 * list when mounting the zone.
1442 			 */
1443 			if ((bh = brand_open(default_brand)) == NULL) {
1444 				rval = -1;
1445 				break;
1446 			}
1447 
1448 			/*
1449 			 * Get the list of filesystems to mount from
1450 			 * the brand configuration.  These mounts are done
1451 			 * via a thread that will enter the zone, so they
1452 			 * are done from within the context of the zone.
1453 			 */
1454 			cb.zlogp = zlogp;
1455 			cb.zoneid = zone_id;
1456 			cb.mount_cmd = B_TRUE;
1457 			rval = brand_platform_iter_mounts(bh,
1458 			    mount_early_fs, &cb);
1459 
1460 			brand_close(bh);
1461 
1462 			/*
1463 			 * Ordinarily, /dev/fd would be mounted inside the zone
1464 			 * by svc:/system/filesystem/usr:default, but since
1465 			 * we're not booting the zone, we need to do this
1466 			 * manually.
1467 			 */
1468 			if (rval == 0)
1469 				rval = mount_early_fs(&cb,
1470 				    "fd", "/dev/fd", "fd", NULL);
1471 			break;
1472 		case Z_UNMOUNT:
1473 			if (kernelcall)	/* Invalid; can't happen */
1474 				abort();
1475 			zerror(zlogp, B_FALSE, "zone is already unmounted");
1476 			rval = 0;
1477 			break;
1478 		}
1479 		break;
1480 
1481 	case ZONE_STATE_READY:
1482 		switch (cmd) {
1483 		case Z_READY:
1484 			/*
1485 			 * We could have two clients racing to ready this
1486 			 * zone; the second client loses, but its request
1487 			 * doesn't fail, since the zone is now in the desired
1488 			 * state.
1489 			 */
1490 			zerror(zlogp, B_FALSE, "zone is already ready");
1491 			rval = 0;
1492 			break;
1493 		case Z_FORCEBOOT:
1494 		case Z_BOOT:
1495 			(void) strlcpy(boot_args, zargp->bootbuf,
1496 			    sizeof (boot_args));
1497 			eventstream_write(Z_EVT_ZONE_BOOTING);
1498 			rval = zone_bootup(zlogp, zargp->bootbuf, zstate);
1499 			audit_put_record(zlogp, uc, rval, "boot");
1500 			if (rval != 0) {
1501 				bringup_failure_recovery = B_TRUE;
1502 				(void) zone_halt(zlogp, B_FALSE, B_TRUE,
1503 				    zstate);
1504 				eventstream_write(Z_EVT_ZONE_BOOTFAILED);
1505 			}
1506 			boot_args[0] = '\0';
1507 			break;
1508 		case Z_HALT:
1509 			if (kernelcall)	/* Invalid; can't happen */
1510 				abort();
1511 			if ((rval = zone_halt(zlogp, B_FALSE, B_FALSE, zstate))
1512 			    != 0)
1513 				break;
1514 			eventstream_write(Z_EVT_ZONE_HALTED);
1515 			break;
1516 		case Z_SHUTDOWN:
1517 		case Z_REBOOT:
1518 		case Z_NOTE_UNINSTALLING:
1519 		case Z_FORCEMOUNT:
1520 		case Z_MOUNT:
1521 		case Z_UNMOUNT:
1522 			if (kernelcall)	/* Invalid; can't happen */
1523 				abort();
1524 			zerror(zlogp, B_FALSE, "%s operation is invalid "
1525 			    "for zones in state '%s'", z_cmd_name(cmd),
1526 			    zone_state_str(zstate));
1527 			rval = -1;
1528 			break;
1529 		}
1530 		break;
1531 
1532 	case ZONE_STATE_MOUNTED:
1533 		switch (cmd) {
1534 		case Z_UNMOUNT:
1535 			if (kernelcall)	/* Invalid; can't happen */
1536 				abort();
1537 			rval = zone_halt(zlogp, B_TRUE, B_FALSE, zstate);
1538 			if (rval == 0) {
1539 				eventstream_write(Z_EVT_ZONE_HALTED);
1540 				(void) sema_post(&scratch_sem);
1541 			}
1542 			break;
1543 		default:
1544 			if (kernelcall)	/* Invalid; can't happen */
1545 				abort();
1546 			zerror(zlogp, B_FALSE, "%s operation is invalid "
1547 			    "for zones in state '%s'", z_cmd_name(cmd),
1548 			    zone_state_str(zstate));
1549 			rval = -1;
1550 			break;
1551 		}
1552 		break;
1553 
1554 	case ZONE_STATE_RUNNING:
1555 	case ZONE_STATE_SHUTTING_DOWN:
1556 	case ZONE_STATE_DOWN:
1557 		switch (cmd) {
1558 		case Z_READY:
1559 			if ((rval = zone_halt(zlogp, B_FALSE, B_TRUE, zstate))
1560 			    != 0)
1561 				break;
1562 			if ((rval = zone_ready(zlogp, Z_MNT_BOOT, zstate)) == 0)
1563 				eventstream_write(Z_EVT_ZONE_READIED);
1564 			else
1565 				eventstream_write(Z_EVT_ZONE_HALTED);
1566 			break;
1567 		case Z_FORCEBOOT:
1568 		case Z_BOOT:
1569 			/*
1570 			 * We could have two clients racing to boot this
1571 			 * zone; the second client loses, but its request
1572 			 * doesn't fail, since the zone is now in the desired
1573 			 * state.
1574 			 */
1575 			zerror(zlogp, B_FALSE, "zone is already booted");
1576 			rval = 0;
1577 			break;
1578 		case Z_HALT:
1579 			if ((rval = zone_halt(zlogp, B_FALSE, B_FALSE, zstate))
1580 			    != 0)
1581 				break;
1582 			eventstream_write(Z_EVT_ZONE_HALTED);
1583 			break;
1584 		case Z_REBOOT:
1585 			(void) strlcpy(boot_args, zargp->bootbuf,
1586 			    sizeof (boot_args));
1587 			eventstream_write(Z_EVT_ZONE_REBOOTING);
1588 			if ((rval = zone_halt(zlogp, B_FALSE, B_TRUE, zstate))
1589 			    != 0) {
1590 				eventstream_write(Z_EVT_ZONE_BOOTFAILED);
1591 				boot_args[0] = '\0';
1592 				break;
1593 			}
1594 			if ((rval = zone_ready(zlogp, Z_MNT_BOOT, zstate))
1595 			    != 0) {
1596 				eventstream_write(Z_EVT_ZONE_BOOTFAILED);
1597 				boot_args[0] = '\0';
1598 				break;
1599 			}
1600 			rval = zone_bootup(zlogp, zargp->bootbuf, zstate);
1601 			audit_put_record(zlogp, uc, rval, "reboot");
1602 			if (rval != 0) {
1603 				(void) zone_halt(zlogp, B_FALSE, B_TRUE,
1604 				    zstate);
1605 				eventstream_write(Z_EVT_ZONE_BOOTFAILED);
1606 			}
1607 			boot_args[0] = '\0';
1608 			break;
1609 		case Z_SHUTDOWN:
1610 			if ((rval = zone_graceful_shutdown(zlogp)) == 0) {
1611 				wait_shut = B_TRUE;
1612 			}
1613 			break;
1614 		case Z_NOTE_UNINSTALLING:
1615 		case Z_FORCEMOUNT:
1616 		case Z_MOUNT:
1617 		case Z_UNMOUNT:
1618 			zerror(zlogp, B_FALSE, "%s operation is invalid "
1619 			    "for zones in state '%s'", z_cmd_name(cmd),
1620 			    zone_state_str(zstate));
1621 			rval = -1;
1622 			break;
1623 		}
1624 		break;
1625 	default:
1626 		abort();
1627 	}
1628 
1629 	/*
1630 	 * Because the state of the zone may have changed, we make sure
1631 	 * to wake the console poller, which is in charge of initiating
1632 	 * the shutdown procedure as necessary.
1633 	 */
1634 	eventstream_write(Z_EVT_NULL);
1635 
1636 out:
1637 	(void) mutex_unlock(&lock);
1638 
1639 	/* Wait for the Z_SHUTDOWN commands to complete */
1640 	if (wait_shut)
1641 		rval = zone_wait_shutdown(zlogp);
1642 
1643 	if (kernelcall) {
1644 		rvalp = NULL;
1645 		rlen = 0;
1646 	} else {
1647 		rvalp->rval = rval;
1648 	}
1649 	if (uc != NULL)
1650 		ucred_free(uc);
1651 	(void) door_return((char *)rvalp, rlen, NULL, 0);
1652 	thr_exit(NULL);
1653 }
1654 
1655 static int
1656 setup_door(zlog_t *zlogp)
1657 {
1658 	if ((zone_door = door_create(server, NULL,
1659 	    DOOR_UNREF | DOOR_REFUSE_DESC | DOOR_NO_CANCEL)) < 0) {
1660 		zerror(zlogp, B_TRUE, "%s failed", "door_create");
1661 		return (-1);
1662 	}
1663 	(void) fdetach(zone_door_path);
1664 
1665 	if (fattach(zone_door, zone_door_path) != 0) {
1666 		zerror(zlogp, B_TRUE, "fattach to %s failed", zone_door_path);
1667 		(void) door_revoke(zone_door);
1668 		(void) fdetach(zone_door_path);
1669 		zone_door = -1;
1670 		return (-1);
1671 	}
1672 	return (0);
1673 }
1674 
1675 /*
1676  * zoneadm(8) will start zoneadmd if it thinks it isn't running; this
1677  * is where zoneadmd itself will check to see that another instance of
1678  * zoneadmd isn't already controlling this zone.
1679  *
1680  * The idea here is that we want to open the path to which we will
1681  * attach our door, lock it, and then make sure that no-one has beat us
1682  * to fattach(3c)ing onto it.
1683  *
1684  * fattach(3c) is really a mount, so there are actually two possible
1685  * vnodes we could be dealing with.  Our strategy is as follows:
1686  *
1687  * - If the file we opened is a regular file (common case):
1688  *	There is no fattach(3c)ed door, so we have a chance of becoming
1689  *	the managing zoneadmd. We attempt to lock the file: if it is
1690  *	already locked, that means someone else raced us here, so we
1691  *	lose and give up.  zoneadm(8) will try to contact the zoneadmd
1692  *	that beat us to it.
1693  *
1694  * - If the file we opened is a namefs file:
1695  *	This means there is already an established door fattach(3c)'ed
1696  *	to the rendezvous path.  We've lost the race, so we give up.
1697  *	Note that in this case we also try to grab the file lock, and
1698  *	will succeed in acquiring it since the vnode locked by the
1699  *	"winning" zoneadmd was a regular one, and the one we locked was
1700  *	the fattach(3c)'ed door node.  At any rate, no harm is done, and
1701  *	we just return to zoneadm(8) which knows to retry.
1702  */
1703 static int
1704 make_daemon_exclusive(zlog_t *zlogp)
1705 {
1706 	int doorfd = -1;
1707 	int err, ret = -1;
1708 	struct stat st;
1709 	struct flock flock;
1710 	zone_state_t zstate;
1711 
1712 top:
1713 	if ((err = zone_get_state(zone_name, &zstate)) != Z_OK) {
1714 		zerror(zlogp, B_FALSE, "failed to get zone state: %s",
1715 		    zonecfg_strerror(err));
1716 		goto out;
1717 	}
1718 	if ((doorfd = open(zone_door_path, O_CREAT|O_RDWR,
1719 	    S_IREAD|S_IWRITE)) < 0) {
1720 		zerror(zlogp, B_TRUE, "failed to open %s", zone_door_path);
1721 		goto out;
1722 	}
1723 	if (fstat(doorfd, &st) < 0) {
1724 		zerror(zlogp, B_TRUE, "failed to stat %s", zone_door_path);
1725 		goto out;
1726 	}
1727 	/*
1728 	 * Lock the file to synchronize with other zoneadmd
1729 	 */
1730 	flock.l_type = F_WRLCK;
1731 	flock.l_whence = SEEK_SET;
1732 	flock.l_start = (off_t)0;
1733 	flock.l_len = (off_t)0;
1734 	if (fcntl(doorfd, F_SETLK, &flock) < 0) {
1735 		/*
1736 		 * Someone else raced us here and grabbed the lock file
1737 		 * first.  A warning here is inappropriate since nothing
1738 		 * went wrong.
1739 		 */
1740 		goto out;
1741 	}
1742 
1743 	if (strcmp(st.st_fstype, "namefs") == 0) {
1744 		struct door_info info;
1745 
1746 		/*
1747 		 * There is already something fattach()'ed to this file.
1748 		 * Lets see what the door is up to.
1749 		 */
1750 		if (door_info(doorfd, &info) == 0 && info.di_target != -1) {
1751 			/*
1752 			 * Another zoneadmd process seems to be in
1753 			 * control of the situation and we don't need to
1754 			 * be here.  A warning here is inappropriate
1755 			 * since nothing went wrong.
1756 			 *
1757 			 * If the door has been revoked, the zoneadmd
1758 			 * process currently managing the zone is going
1759 			 * away.  We'll return control to zoneadm(8)
1760 			 * which will try again (by which time zoneadmd
1761 			 * will hopefully have exited).
1762 			 */
1763 			goto out;
1764 		}
1765 
1766 		/*
1767 		 * If we got this far, there's a fattach(3c)'ed door
1768 		 * that belongs to a process that has exited, which can
1769 		 * happen if the previous zoneadmd died unexpectedly.
1770 		 *
1771 		 * Let user know that something is amiss, but that we can
1772 		 * recover; if the zone is in the installed state, then don't
1773 		 * message, since having a running zoneadmd isn't really
1774 		 * expected/needed.  We want to keep occurences of this message
1775 		 * limited to times when zoneadmd is picking back up from a
1776 		 * zoneadmd that died while the zone was in some non-trivial
1777 		 * state.
1778 		 */
1779 		if (zstate > ZONE_STATE_INSTALLED) {
1780 			zerror(zlogp, B_FALSE,
1781 			    "zone '%s': WARNING: zone is in state '%s', but "
1782 			    "zoneadmd does not appear to be available; "
1783 			    "restarted zoneadmd to recover.",
1784 			    zone_name, zone_state_str(zstate));
1785 		}
1786 
1787 		(void) fdetach(zone_door_path);
1788 		(void) close(doorfd);
1789 		goto top;
1790 	}
1791 	ret = 0;
1792 out:
1793 	(void) close(doorfd);
1794 	return (ret);
1795 }
1796 
1797 /*
1798  * Setup the brand's pre and post state change callbacks, as well as the
1799  * query callback, if any of these exist.
1800  */
1801 static int
1802 brand_callback_init(brand_handle_t bh, char *zone_name)
1803 {
1804 	char zpath[MAXPATHLEN];
1805 
1806 	if (zone_get_zonepath(zone_name, zpath, sizeof (zpath)) != Z_OK)
1807 		return (-1);
1808 
1809 	(void) strlcpy(pre_statechg_hook, EXEC_PREFIX,
1810 	    sizeof (pre_statechg_hook));
1811 
1812 	if (brand_get_prestatechange(bh, zone_name, zpath,
1813 	    pre_statechg_hook + EXEC_LEN,
1814 	    sizeof (pre_statechg_hook) - EXEC_LEN) != 0)
1815 		return (-1);
1816 
1817 	if (strlen(pre_statechg_hook) <= EXEC_LEN)
1818 		pre_statechg_hook[0] = '\0';
1819 
1820 	(void) strlcpy(post_statechg_hook, EXEC_PREFIX,
1821 	    sizeof (post_statechg_hook));
1822 
1823 	if (brand_get_poststatechange(bh, zone_name, zpath,
1824 	    post_statechg_hook + EXEC_LEN,
1825 	    sizeof (post_statechg_hook) - EXEC_LEN) != 0)
1826 		return (-1);
1827 
1828 	if (strlen(post_statechg_hook) <= EXEC_LEN)
1829 		post_statechg_hook[0] = '\0';
1830 
1831 	(void) strlcpy(query_hook, EXEC_PREFIX,
1832 	    sizeof (query_hook));
1833 
1834 	if (brand_get_query(bh, zone_name, zpath, query_hook + EXEC_LEN,
1835 	    sizeof (query_hook) - EXEC_LEN) != 0)
1836 		return (-1);
1837 
1838 	if (strlen(query_hook) <= EXEC_LEN)
1839 		query_hook[0] = '\0';
1840 
1841 	return (0);
1842 }
1843 
1844 int
1845 main(int argc, char *argv[])
1846 {
1847 	int opt;
1848 	zoneid_t zid;
1849 	priv_set_t *privset;
1850 	zone_state_t zstate;
1851 	char parents_locale[MAXPATHLEN];
1852 	brand_handle_t bh;
1853 	int err;
1854 
1855 	pid_t pid;
1856 	sigset_t blockset;
1857 	sigset_t block_cld;
1858 
1859 	struct {
1860 		sema_t sem;
1861 		int status;
1862 		zlog_t log;
1863 	} *shstate;
1864 	size_t shstatelen = getpagesize();
1865 
1866 	zlog_t errlog;
1867 	zlog_t *zlogp;
1868 
1869 	int ctfd;
1870 
1871 	progname = get_execbasename(argv[0]);
1872 
1873 	/*
1874 	 * Make sure stderr is unbuffered
1875 	 */
1876 	(void) setbuffer(stderr, NULL, 0);
1877 
1878 	/*
1879 	 * Get out of the way of mounted filesystems, since we will daemonize
1880 	 * soon.
1881 	 */
1882 	(void) chdir("/");
1883 
1884 	/*
1885 	 * Use the default system umask per PSARC 1998/110 rather than
1886 	 * anything that may have been set by the caller.
1887 	 */
1888 	(void) umask(CMASK);
1889 
1890 	/*
1891 	 * Initially we want to use our parent's locale.
1892 	 */
1893 	(void) setlocale(LC_ALL, "");
1894 	(void) textdomain(TEXT_DOMAIN);
1895 	(void) strlcpy(parents_locale, setlocale(LC_MESSAGES, NULL),
1896 	    sizeof (parents_locale));
1897 
1898 	/*
1899 	 * This zlog_t is used for writing to stderr
1900 	 */
1901 	errlog.logfile = stderr;
1902 	errlog.buflen = errlog.loglen = 0;
1903 	errlog.buf = errlog.log = NULL;
1904 	errlog.locale = parents_locale;
1905 
1906 	/*
1907 	 * We start off writing to stderr until we're ready to daemonize.
1908 	 */
1909 	zlogp = &errlog;
1910 
1911 	/*
1912 	 * Process options.
1913 	 */
1914 	while ((opt = getopt(argc, argv, "R:z:")) != EOF) {
1915 		switch (opt) {
1916 		case 'R':
1917 			zonecfg_set_root(optarg);
1918 			break;
1919 		case 'z':
1920 			zone_name = optarg;
1921 			break;
1922 		default:
1923 			usage();
1924 		}
1925 	}
1926 
1927 	if (zone_name == NULL)
1928 		usage();
1929 
1930 	/*
1931 	 * Because usage() prints directly to stderr, it has gettext()
1932 	 * wrapping, which depends on the locale.  But since zerror() calls
1933 	 * localize() which tweaks the locale, it is not safe to call zerror()
1934 	 * until after the last call to usage().  Fortunately, the last call
1935 	 * to usage() is just above and the first call to zerror() is just
1936 	 * below.  Don't mess this up.
1937 	 */
1938 	if (strcmp(zone_name, GLOBAL_ZONENAME) == 0) {
1939 		zerror(zlogp, B_FALSE, "cannot manage the %s zone",
1940 		    GLOBAL_ZONENAME);
1941 		return (1);
1942 	}
1943 
1944 	if (zone_get_id(zone_name, &zid) != 0) {
1945 		zerror(zlogp, B_FALSE, "could not manage %s: %s", zone_name,
1946 		    zonecfg_strerror(Z_NO_ZONE));
1947 		return (1);
1948 	}
1949 
1950 	if ((err = zone_get_state(zone_name, &zstate)) != Z_OK) {
1951 		zerror(zlogp, B_FALSE, "failed to get zone state: %s",
1952 		    zonecfg_strerror(err));
1953 		return (1);
1954 	}
1955 	if (zstate < ZONE_STATE_INCOMPLETE) {
1956 		zerror(zlogp, B_FALSE,
1957 		    "cannot manage a zone which is in state '%s'",
1958 		    zone_state_str(zstate));
1959 		return (1);
1960 	}
1961 
1962 	if (zonecfg_default_brand(default_brand,
1963 	    sizeof (default_brand)) != Z_OK) {
1964 		zerror(zlogp, B_FALSE, "unable to determine default brand");
1965 		return (1);
1966 	}
1967 
1968 	/* Get a handle to the brand info for this zone */
1969 	if (zone_get_brand(zone_name, brand_name, sizeof (brand_name))
1970 	    != Z_OK) {
1971 		zerror(zlogp, B_FALSE, "unable to determine zone brand");
1972 		return (1);
1973 	}
1974 	zone_isnative = (strcmp(brand_name, NATIVE_BRAND_NAME) == 0);
1975 	zone_islabeled = (strcmp(brand_name, LABELED_BRAND_NAME) == 0);
1976 
1977 	/*
1978 	 * In the alternate root environment, the only supported
1979 	 * operations are mount and unmount.  In this case, just treat
1980 	 * the zone as native if it is cluster.  Cluster zones can be
1981 	 * native for the purpose of LU or upgrade, and the cluster
1982 	 * brand may not exist in the miniroot (such as in net install
1983 	 * upgrade).
1984 	 */
1985 	if (strcmp(brand_name, CLUSTER_BRAND_NAME) == 0) {
1986 		zone_iscluster = B_TRUE;
1987 		if (zonecfg_in_alt_root()) {
1988 			(void) strlcpy(brand_name, default_brand,
1989 			    sizeof (brand_name));
1990 		}
1991 	} else {
1992 		zone_iscluster = B_FALSE;
1993 	}
1994 
1995 	if ((bh = brand_open(brand_name)) == NULL) {
1996 		zerror(zlogp, B_FALSE, "unable to open zone brand");
1997 		return (1);
1998 	}
1999 
2000 	/* Get state change brand hooks. */
2001 	if (brand_callback_init(bh, zone_name) == -1) {
2002 		zerror(zlogp, B_TRUE,
2003 		    "failed to initialize brand state change hooks");
2004 		brand_close(bh);
2005 		return (1);
2006 	}
2007 
2008 	brand_close(bh);
2009 
2010 	/*
2011 	 * Check that we have all privileges.  It would be nice to pare
2012 	 * this down, but this is at least a first cut.
2013 	 */
2014 	if ((privset = priv_allocset()) == NULL) {
2015 		zerror(zlogp, B_TRUE, "%s failed", "priv_allocset");
2016 		return (1);
2017 	}
2018 
2019 	if (getppriv(PRIV_EFFECTIVE, privset) != 0) {
2020 		zerror(zlogp, B_TRUE, "%s failed", "getppriv");
2021 		priv_freeset(privset);
2022 		return (1);
2023 	}
2024 
2025 	if (priv_isfullset(privset) == B_FALSE) {
2026 		zerror(zlogp, B_FALSE, "You lack sufficient privilege to "
2027 		    "run this command (all privs required)");
2028 		priv_freeset(privset);
2029 		return (1);
2030 	}
2031 	priv_freeset(privset);
2032 
2033 	if (mkzonedir(zlogp) != 0)
2034 		return (1);
2035 
2036 	/*
2037 	 * Pre-fork: setup shared state
2038 	 */
2039 	if ((shstate = (void *)mmap(NULL, shstatelen,
2040 	    PROT_READ|PROT_WRITE, MAP_SHARED|MAP_ANON, -1, (off_t)0)) ==
2041 	    MAP_FAILED) {
2042 		zerror(zlogp, B_TRUE, "%s failed", "mmap");
2043 		return (1);
2044 	}
2045 	if (sema_init(&shstate->sem, 0, USYNC_PROCESS, NULL) != 0) {
2046 		zerror(zlogp, B_TRUE, "%s failed", "sema_init()");
2047 		(void) munmap((char *)shstate, shstatelen);
2048 		return (1);
2049 	}
2050 	shstate->log.logfile = NULL;
2051 	shstate->log.buflen = shstatelen - sizeof (*shstate);
2052 	shstate->log.loglen = shstate->log.buflen;
2053 	shstate->log.buf = (char *)shstate + sizeof (*shstate);
2054 	shstate->log.log = shstate->log.buf;
2055 	shstate->log.locale = parents_locale;
2056 	shstate->status = -1;
2057 
2058 	/*
2059 	 * We need a SIGCHLD handler so the sema_wait() below will wake
2060 	 * up if the child dies without doing a sema_post().
2061 	 */
2062 	(void) sigset(SIGCHLD, sigchld);
2063 	/*
2064 	 * We must mask SIGCHLD until after we've coped with the fork
2065 	 * sufficiently to deal with it; otherwise we can race and
2066 	 * receive the signal before pid has been initialized
2067 	 * (yes, this really happens).
2068 	 */
2069 	(void) sigemptyset(&block_cld);
2070 	(void) sigaddset(&block_cld, SIGCHLD);
2071 	(void) sigprocmask(SIG_BLOCK, &block_cld, NULL);
2072 
2073 	/*
2074 	 * The parent only needs stderr after the fork, so close other fd's
2075 	 * that we inherited from zoneadm so that the parent doesn't have those
2076 	 * open while waiting. The child will close the rest after the fork.
2077 	 */
2078 	closefrom(3);
2079 
2080 	if ((ctfd = init_template()) == -1) {
2081 		zerror(zlogp, B_TRUE, "failed to create contract");
2082 		return (1);
2083 	}
2084 
2085 	/*
2086 	 * Do not let another thread localize a message while we are forking.
2087 	 */
2088 	(void) mutex_lock(&msglock);
2089 	pid = fork();
2090 	(void) mutex_unlock(&msglock);
2091 
2092 	/*
2093 	 * In all cases (parent, child, and in the event of an error) we
2094 	 * don't want to cause creation of contracts on subsequent fork()s.
2095 	 */
2096 	(void) ct_tmpl_clear(ctfd);
2097 	(void) close(ctfd);
2098 
2099 	if (pid == -1) {
2100 		zerror(zlogp, B_TRUE, "could not fork");
2101 		return (1);
2102 
2103 	} else if (pid > 0) { /* parent */
2104 		(void) sigprocmask(SIG_UNBLOCK, &block_cld, NULL);
2105 		/*
2106 		 * This marks a window of vulnerability in which we receive
2107 		 * the SIGCLD before falling into sema_wait (normally we would
2108 		 * get woken up from sema_wait with EINTR upon receipt of
2109 		 * SIGCLD).  So we may need to use some other scheme like
2110 		 * sema_posting in the sigcld handler.
2111 		 * blech
2112 		 */
2113 		(void) sema_wait(&shstate->sem);
2114 		(void) sema_destroy(&shstate->sem);
2115 		if (shstate->status != 0)
2116 			(void) waitpid(pid, NULL, WNOHANG);
2117 		/*
2118 		 * It's ok if we die with SIGPIPE.  It's not like we could have
2119 		 * done anything about it.
2120 		 */
2121 		(void) fprintf(stderr, "%s", shstate->log.buf);
2122 		_exit(shstate->status == 0 ? 0 : 1);
2123 	}
2124 
2125 	/*
2126 	 * The child charges on.
2127 	 */
2128 	(void) sigset(SIGCHLD, SIG_DFL);
2129 	(void) sigprocmask(SIG_UNBLOCK, &block_cld, NULL);
2130 
2131 	/*
2132 	 * SIGPIPE can be delivered if we write to a socket for which the
2133 	 * peer endpoint is gone.  That can lead to too-early termination
2134 	 * of zoneadmd, and that's not good eats.
2135 	 */
2136 	(void) sigset(SIGPIPE, SIG_IGN);
2137 	/*
2138 	 * Stop using stderr
2139 	 */
2140 	zlogp = &shstate->log;
2141 
2142 	/*
2143 	 * We don't need stdout/stderr from now on.
2144 	 */
2145 	closefrom(0);
2146 
2147 	/*
2148 	 * Initialize the syslog zlog_t.  This needs to be done after
2149 	 * the call to closefrom().
2150 	 */
2151 	logsys.buf = logsys.log = NULL;
2152 	logsys.buflen = logsys.loglen = 0;
2153 	logsys.logfile = NULL;
2154 	logsys.locale = DEFAULT_LOCALE;
2155 
2156 	openlog("zoneadmd", LOG_PID, LOG_DAEMON);
2157 
2158 	/*
2159 	 * The eventstream is used to publish state changes in the zone
2160 	 * from the door threads to the console I/O poller.
2161 	 */
2162 	if (eventstream_init() == -1) {
2163 		zerror(zlogp, B_TRUE, "unable to create eventstream");
2164 		goto child_out;
2165 	}
2166 
2167 	(void) snprintf(zone_door_path, sizeof (zone_door_path),
2168 	    "%s" ZONE_DOOR_PATH, zonecfg_get_root(), zone_name);
2169 
2170 	/*
2171 	 * See if another zoneadmd is running for this zone.  If not, then we
2172 	 * can now modify system state.
2173 	 */
2174 	if (make_daemon_exclusive(zlogp) == -1)
2175 		goto child_out;
2176 
2177 
2178 	/*
2179 	 * Create/join a new session; we need to be careful of what we do with
2180 	 * the console from now on so we don't end up being the session leader
2181 	 * for the terminal we're going to be handing out.
2182 	 */
2183 	(void) setsid();
2184 
2185 	/*
2186 	 * This thread shouldn't be receiving any signals; in particular,
2187 	 * SIGCHLD should be received by the thread doing the fork().
2188 	 */
2189 	(void) sigfillset(&blockset);
2190 	(void) thr_sigsetmask(SIG_BLOCK, &blockset, NULL);
2191 
2192 	/*
2193 	 * Setup the console device and get ready to serve the console;
2194 	 * once this has completed, we're ready to let console clients
2195 	 * make an attempt to connect (they will block until
2196 	 * serve_console_sock() below gets called, and any pending
2197 	 * connection is accept()ed).
2198 	 */
2199 	if (!zonecfg_in_alt_root() && init_console(zlogp) < 0)
2200 		goto child_out;
2201 
2202 	/*
2203 	 * Take the lock now, so that when the door server gets going, we
2204 	 * are guaranteed that it won't take a request until we are sure
2205 	 * that everything is completely set up.  See the child_out: label
2206 	 * below to see why this matters.
2207 	 */
2208 	(void) mutex_lock(&lock);
2209 
2210 	/* Init semaphore for scratch zones. */
2211 	if (sema_init(&scratch_sem, 0, USYNC_THREAD, NULL) == -1) {
2212 		zerror(zlogp, B_TRUE,
2213 		    "failed to initialize semaphore for scratch zone");
2214 		goto child_out;
2215 	}
2216 
2217 	/* open the dladm handle */
2218 	if (dladm_open(&dld_handle) != DLADM_STATUS_OK) {
2219 		zerror(zlogp, B_FALSE, "failed to open dladm handle");
2220 		goto child_out;
2221 	}
2222 
2223 	/*
2224 	 * Note: door setup must occur *after* the console is setup.
2225 	 * This is so that as zlogin tests the door to see if zoneadmd
2226 	 * is ready yet, we know that the console will get serviced
2227 	 * once door_info() indicates that the door is "up".
2228 	 */
2229 	if (setup_door(zlogp) == -1)
2230 		goto child_out;
2231 
2232 	/*
2233 	 * Things seem OK so far; tell the parent process that we're done
2234 	 * with setup tasks.  This will cause the parent to exit, signalling
2235 	 * to zoneadm, zlogin, or whatever forked it that we are ready to
2236 	 * service requests.
2237 	 */
2238 	shstate->status = 0;
2239 	(void) sema_post(&shstate->sem);
2240 	(void) munmap((char *)shstate, shstatelen);
2241 	shstate = NULL;
2242 
2243 	(void) mutex_unlock(&lock);
2244 
2245 	/*
2246 	 * zlogp is now invalid, so reset it to the syslog logger.
2247 	 */
2248 	zlogp = &logsys;
2249 
2250 	/*
2251 	 * Now that we are free of any parents, switch to the default locale.
2252 	 */
2253 	(void) setlocale(LC_ALL, DEFAULT_LOCALE);
2254 
2255 	/*
2256 	 * At this point the setup portion of main() is basically done, so
2257 	 * we reuse this thread to manage the zone console.  When
2258 	 * serve_console() has returned, we are past the point of no return
2259 	 * in the life of this zoneadmd.
2260 	 */
2261 	if (zonecfg_in_alt_root()) {
2262 		/*
2263 		 * This is just awful, but mounted scratch zones don't (and
2264 		 * can't) have consoles.  We just wait for unmount instead.
2265 		 */
2266 		while (sema_wait(&scratch_sem) == EINTR)
2267 			;
2268 	} else {
2269 		serve_console(zlogp);
2270 		assert(in_death_throes);
2271 	}
2272 
2273 	/*
2274 	 * This is the next-to-last part of the exit interlock.  Upon calling
2275 	 * fdetach(), the door will go unreferenced; once any
2276 	 * outstanding requests (like the door thread doing Z_HALT) are
2277 	 * done, the door will get an UNREF notification; when it handles
2278 	 * the UNREF, the door server will cause the exit.  It's possible
2279 	 * that fdetach() can fail because the file is in use, in which
2280 	 * case we'll retry the operation.
2281 	 */
2282 	assert(!MUTEX_HELD(&lock));
2283 	for (;;) {
2284 		if ((fdetach(zone_door_path) == 0) || (errno != EBUSY))
2285 			break;
2286 		yield();
2287 	}
2288 
2289 	for (;;)
2290 		(void) pause();
2291 
2292 child_out:
2293 	assert(pid == 0);
2294 
2295 	shstate->status = -1;
2296 	(void) sema_post(&shstate->sem);
2297 	(void) munmap((char *)shstate, shstatelen);
2298 
2299 	/*
2300 	 * This might trigger an unref notification, but if so,
2301 	 * we are still holding the lock, so our call to exit will
2302 	 * ultimately win the race and will publish the right exit
2303 	 * code.
2304 	 */
2305 	if (zone_door != -1) {
2306 		assert(MUTEX_HELD(&lock));
2307 		(void) door_revoke(zone_door);
2308 		(void) fdetach(zone_door_path);
2309 	}
2310 
2311 	if (dld_handle != NULL)
2312 		dladm_close(dld_handle);
2313 
2314 	return (1); /* return from main() forcibly exits an MT process */
2315 }
2316