xref: /illumos-gate/usr/src/cmd/zoneadmd/zoneadmd.c (revision 1b863af9bc9a5c76ed773e129889fc19dbf9e41c)
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(1M) 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(1m)), 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(1M) (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(1M) 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;
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_BOOT:
1494 			(void) strlcpy(boot_args, zargp->bootbuf,
1495 			    sizeof (boot_args));
1496 			eventstream_write(Z_EVT_ZONE_BOOTING);
1497 			rval = zone_bootup(zlogp, zargp->bootbuf, zstate);
1498 			audit_put_record(zlogp, uc, rval, "boot");
1499 			if (rval != 0) {
1500 				bringup_failure_recovery = B_TRUE;
1501 				(void) zone_halt(zlogp, B_FALSE, B_TRUE,
1502 				    zstate);
1503 				eventstream_write(Z_EVT_ZONE_BOOTFAILED);
1504 			}
1505 			boot_args[0] = '\0';
1506 			break;
1507 		case Z_HALT:
1508 			if (kernelcall)	/* Invalid; can't happen */
1509 				abort();
1510 			if ((rval = zone_halt(zlogp, B_FALSE, B_FALSE, zstate))
1511 			    != 0)
1512 				break;
1513 			eventstream_write(Z_EVT_ZONE_HALTED);
1514 			break;
1515 		case Z_SHUTDOWN:
1516 		case Z_REBOOT:
1517 		case Z_NOTE_UNINSTALLING:
1518 		case Z_MOUNT:
1519 		case Z_UNMOUNT:
1520 			if (kernelcall)	/* Invalid; can't happen */
1521 				abort();
1522 			zerror(zlogp, B_FALSE, "%s operation is invalid "
1523 			    "for zones in state '%s'", z_cmd_name(cmd),
1524 			    zone_state_str(zstate));
1525 			rval = -1;
1526 			break;
1527 		}
1528 		break;
1529 
1530 	case ZONE_STATE_MOUNTED:
1531 		switch (cmd) {
1532 		case Z_UNMOUNT:
1533 			if (kernelcall)	/* Invalid; can't happen */
1534 				abort();
1535 			rval = zone_halt(zlogp, B_TRUE, B_FALSE, zstate);
1536 			if (rval == 0) {
1537 				eventstream_write(Z_EVT_ZONE_HALTED);
1538 				(void) sema_post(&scratch_sem);
1539 			}
1540 			break;
1541 		default:
1542 			if (kernelcall)	/* Invalid; can't happen */
1543 				abort();
1544 			zerror(zlogp, B_FALSE, "%s operation is invalid "
1545 			    "for zones in state '%s'", z_cmd_name(cmd),
1546 			    zone_state_str(zstate));
1547 			rval = -1;
1548 			break;
1549 		}
1550 		break;
1551 
1552 	case ZONE_STATE_RUNNING:
1553 	case ZONE_STATE_SHUTTING_DOWN:
1554 	case ZONE_STATE_DOWN:
1555 		switch (cmd) {
1556 		case Z_READY:
1557 			if ((rval = zone_halt(zlogp, B_FALSE, B_TRUE, zstate))
1558 			    != 0)
1559 				break;
1560 			if ((rval = zone_ready(zlogp, Z_MNT_BOOT, zstate)) == 0)
1561 				eventstream_write(Z_EVT_ZONE_READIED);
1562 			else
1563 				eventstream_write(Z_EVT_ZONE_HALTED);
1564 			break;
1565 		case Z_BOOT:
1566 			/*
1567 			 * We could have two clients racing to boot this
1568 			 * zone; the second client loses, but its request
1569 			 * doesn't fail, since the zone is now in the desired
1570 			 * state.
1571 			 */
1572 			zerror(zlogp, B_FALSE, "zone is already booted");
1573 			rval = 0;
1574 			break;
1575 		case Z_HALT:
1576 			if ((rval = zone_halt(zlogp, B_FALSE, B_FALSE, zstate))
1577 			    != 0)
1578 				break;
1579 			eventstream_write(Z_EVT_ZONE_HALTED);
1580 			break;
1581 		case Z_REBOOT:
1582 			(void) strlcpy(boot_args, zargp->bootbuf,
1583 			    sizeof (boot_args));
1584 			eventstream_write(Z_EVT_ZONE_REBOOTING);
1585 			if ((rval = zone_halt(zlogp, B_FALSE, B_TRUE, zstate))
1586 			    != 0) {
1587 				eventstream_write(Z_EVT_ZONE_BOOTFAILED);
1588 				boot_args[0] = '\0';
1589 				break;
1590 			}
1591 			if ((rval = zone_ready(zlogp, Z_MNT_BOOT, zstate))
1592 			    != 0) {
1593 				eventstream_write(Z_EVT_ZONE_BOOTFAILED);
1594 				boot_args[0] = '\0';
1595 				break;
1596 			}
1597 			rval = zone_bootup(zlogp, zargp->bootbuf, zstate);
1598 			audit_put_record(zlogp, uc, rval, "reboot");
1599 			if (rval != 0) {
1600 				(void) zone_halt(zlogp, B_FALSE, B_TRUE,
1601 				    zstate);
1602 				eventstream_write(Z_EVT_ZONE_BOOTFAILED);
1603 			}
1604 			boot_args[0] = '\0';
1605 			break;
1606 		case Z_SHUTDOWN:
1607 			if ((rval = zone_graceful_shutdown(zlogp)) == 0) {
1608 				wait_shut = B_TRUE;
1609 			}
1610 			break;
1611 		case Z_NOTE_UNINSTALLING:
1612 		case Z_MOUNT:
1613 		case Z_UNMOUNT:
1614 			zerror(zlogp, B_FALSE, "%s operation is invalid "
1615 			    "for zones in state '%s'", z_cmd_name(cmd),
1616 			    zone_state_str(zstate));
1617 			rval = -1;
1618 			break;
1619 		}
1620 		break;
1621 	default:
1622 		abort();
1623 	}
1624 
1625 	/*
1626 	 * Because the state of the zone may have changed, we make sure
1627 	 * to wake the console poller, which is in charge of initiating
1628 	 * the shutdown procedure as necessary.
1629 	 */
1630 	eventstream_write(Z_EVT_NULL);
1631 
1632 out:
1633 	(void) mutex_unlock(&lock);
1634 
1635 	/* Wait for the Z_SHUTDOWN commands to complete */
1636 	if (wait_shut)
1637 		rval = zone_wait_shutdown(zlogp);
1638 
1639 	if (kernelcall) {
1640 		rvalp = NULL;
1641 		rlen = 0;
1642 	} else {
1643 		rvalp->rval = rval;
1644 	}
1645 	if (uc != NULL)
1646 		ucred_free(uc);
1647 	(void) door_return((char *)rvalp, rlen, NULL, 0);
1648 	thr_exit(NULL);
1649 }
1650 
1651 static int
1652 setup_door(zlog_t *zlogp)
1653 {
1654 	if ((zone_door = door_create(server, NULL,
1655 	    DOOR_UNREF | DOOR_REFUSE_DESC | DOOR_NO_CANCEL)) < 0) {
1656 		zerror(zlogp, B_TRUE, "%s failed", "door_create");
1657 		return (-1);
1658 	}
1659 	(void) fdetach(zone_door_path);
1660 
1661 	if (fattach(zone_door, zone_door_path) != 0) {
1662 		zerror(zlogp, B_TRUE, "fattach to %s failed", zone_door_path);
1663 		(void) door_revoke(zone_door);
1664 		(void) fdetach(zone_door_path);
1665 		zone_door = -1;
1666 		return (-1);
1667 	}
1668 	return (0);
1669 }
1670 
1671 /*
1672  * zoneadm(1m) will start zoneadmd if it thinks it isn't running; this
1673  * is where zoneadmd itself will check to see that another instance of
1674  * zoneadmd isn't already controlling this zone.
1675  *
1676  * The idea here is that we want to open the path to which we will
1677  * attach our door, lock it, and then make sure that no-one has beat us
1678  * to fattach(3c)ing onto it.
1679  *
1680  * fattach(3c) is really a mount, so there are actually two possible
1681  * vnodes we could be dealing with.  Our strategy is as follows:
1682  *
1683  * - If the file we opened is a regular file (common case):
1684  *	There is no fattach(3c)ed door, so we have a chance of becoming
1685  *	the managing zoneadmd. We attempt to lock the file: if it is
1686  *	already locked, that means someone else raced us here, so we
1687  *	lose and give up.  zoneadm(1m) will try to contact the zoneadmd
1688  *	that beat us to it.
1689  *
1690  * - If the file we opened is a namefs file:
1691  *	This means there is already an established door fattach(3c)'ed
1692  *	to the rendezvous path.  We've lost the race, so we give up.
1693  *	Note that in this case we also try to grab the file lock, and
1694  *	will succeed in acquiring it since the vnode locked by the
1695  *	"winning" zoneadmd was a regular one, and the one we locked was
1696  *	the fattach(3c)'ed door node.  At any rate, no harm is done, and
1697  *	we just return to zoneadm(1m) which knows to retry.
1698  */
1699 static int
1700 make_daemon_exclusive(zlog_t *zlogp)
1701 {
1702 	int doorfd = -1;
1703 	int err, ret = -1;
1704 	struct stat st;
1705 	struct flock flock;
1706 	zone_state_t zstate;
1707 
1708 top:
1709 	if ((err = zone_get_state(zone_name, &zstate)) != Z_OK) {
1710 		zerror(zlogp, B_FALSE, "failed to get zone state: %s",
1711 		    zonecfg_strerror(err));
1712 		goto out;
1713 	}
1714 	if ((doorfd = open(zone_door_path, O_CREAT|O_RDWR,
1715 	    S_IREAD|S_IWRITE)) < 0) {
1716 		zerror(zlogp, B_TRUE, "failed to open %s", zone_door_path);
1717 		goto out;
1718 	}
1719 	if (fstat(doorfd, &st) < 0) {
1720 		zerror(zlogp, B_TRUE, "failed to stat %s", zone_door_path);
1721 		goto out;
1722 	}
1723 	/*
1724 	 * Lock the file to synchronize with other zoneadmd
1725 	 */
1726 	flock.l_type = F_WRLCK;
1727 	flock.l_whence = SEEK_SET;
1728 	flock.l_start = (off_t)0;
1729 	flock.l_len = (off_t)0;
1730 	if (fcntl(doorfd, F_SETLK, &flock) < 0) {
1731 		/*
1732 		 * Someone else raced us here and grabbed the lock file
1733 		 * first.  A warning here is inappropriate since nothing
1734 		 * went wrong.
1735 		 */
1736 		goto out;
1737 	}
1738 
1739 	if (strcmp(st.st_fstype, "namefs") == 0) {
1740 		struct door_info info;
1741 
1742 		/*
1743 		 * There is already something fattach()'ed to this file.
1744 		 * Lets see what the door is up to.
1745 		 */
1746 		if (door_info(doorfd, &info) == 0 && info.di_target != -1) {
1747 			/*
1748 			 * Another zoneadmd process seems to be in
1749 			 * control of the situation and we don't need to
1750 			 * be here.  A warning here is inappropriate
1751 			 * since nothing went wrong.
1752 			 *
1753 			 * If the door has been revoked, the zoneadmd
1754 			 * process currently managing the zone is going
1755 			 * away.  We'll return control to zoneadm(1m)
1756 			 * which will try again (by which time zoneadmd
1757 			 * will hopefully have exited).
1758 			 */
1759 			goto out;
1760 		}
1761 
1762 		/*
1763 		 * If we got this far, there's a fattach(3c)'ed door
1764 		 * that belongs to a process that has exited, which can
1765 		 * happen if the previous zoneadmd died unexpectedly.
1766 		 *
1767 		 * Let user know that something is amiss, but that we can
1768 		 * recover; if the zone is in the installed state, then don't
1769 		 * message, since having a running zoneadmd isn't really
1770 		 * expected/needed.  We want to keep occurences of this message
1771 		 * limited to times when zoneadmd is picking back up from a
1772 		 * zoneadmd that died while the zone was in some non-trivial
1773 		 * state.
1774 		 */
1775 		if (zstate > ZONE_STATE_INSTALLED) {
1776 			zerror(zlogp, B_FALSE,
1777 			    "zone '%s': WARNING: zone is in state '%s', but "
1778 			    "zoneadmd does not appear to be available; "
1779 			    "restarted zoneadmd to recover.",
1780 			    zone_name, zone_state_str(zstate));
1781 		}
1782 
1783 		(void) fdetach(zone_door_path);
1784 		(void) close(doorfd);
1785 		goto top;
1786 	}
1787 	ret = 0;
1788 out:
1789 	(void) close(doorfd);
1790 	return (ret);
1791 }
1792 
1793 /*
1794  * Setup the brand's pre and post state change callbacks, as well as the
1795  * query callback, if any of these exist.
1796  */
1797 static int
1798 brand_callback_init(brand_handle_t bh, char *zone_name)
1799 {
1800 	char zpath[MAXPATHLEN];
1801 
1802 	if (zone_get_zonepath(zone_name, zpath, sizeof (zpath)) != Z_OK)
1803 		return (-1);
1804 
1805 	(void) strlcpy(pre_statechg_hook, EXEC_PREFIX,
1806 	    sizeof (pre_statechg_hook));
1807 
1808 	if (brand_get_prestatechange(bh, zone_name, zpath,
1809 	    pre_statechg_hook + EXEC_LEN,
1810 	    sizeof (pre_statechg_hook) - EXEC_LEN) != 0)
1811 		return (-1);
1812 
1813 	if (strlen(pre_statechg_hook) <= EXEC_LEN)
1814 		pre_statechg_hook[0] = '\0';
1815 
1816 	(void) strlcpy(post_statechg_hook, EXEC_PREFIX,
1817 	    sizeof (post_statechg_hook));
1818 
1819 	if (brand_get_poststatechange(bh, zone_name, zpath,
1820 	    post_statechg_hook + EXEC_LEN,
1821 	    sizeof (post_statechg_hook) - EXEC_LEN) != 0)
1822 		return (-1);
1823 
1824 	if (strlen(post_statechg_hook) <= EXEC_LEN)
1825 		post_statechg_hook[0] = '\0';
1826 
1827 	(void) strlcpy(query_hook, EXEC_PREFIX,
1828 	    sizeof (query_hook));
1829 
1830 	if (brand_get_query(bh, zone_name, zpath, query_hook + EXEC_LEN,
1831 	    sizeof (query_hook) - EXEC_LEN) != 0)
1832 		return (-1);
1833 
1834 	if (strlen(query_hook) <= EXEC_LEN)
1835 		query_hook[0] = '\0';
1836 
1837 	return (0);
1838 }
1839 
1840 int
1841 main(int argc, char *argv[])
1842 {
1843 	int opt;
1844 	zoneid_t zid;
1845 	priv_set_t *privset;
1846 	zone_state_t zstate;
1847 	char parents_locale[MAXPATHLEN];
1848 	brand_handle_t bh;
1849 	int err;
1850 
1851 	pid_t pid;
1852 	sigset_t blockset;
1853 	sigset_t block_cld;
1854 
1855 	struct {
1856 		sema_t sem;
1857 		int status;
1858 		zlog_t log;
1859 	} *shstate;
1860 	size_t shstatelen = getpagesize();
1861 
1862 	zlog_t errlog;
1863 	zlog_t *zlogp;
1864 
1865 	int ctfd;
1866 
1867 	progname = get_execbasename(argv[0]);
1868 
1869 	/*
1870 	 * Make sure stderr is unbuffered
1871 	 */
1872 	(void) setbuffer(stderr, NULL, 0);
1873 
1874 	/*
1875 	 * Get out of the way of mounted filesystems, since we will daemonize
1876 	 * soon.
1877 	 */
1878 	(void) chdir("/");
1879 
1880 	/*
1881 	 * Use the default system umask per PSARC 1998/110 rather than
1882 	 * anything that may have been set by the caller.
1883 	 */
1884 	(void) umask(CMASK);
1885 
1886 	/*
1887 	 * Initially we want to use our parent's locale.
1888 	 */
1889 	(void) setlocale(LC_ALL, "");
1890 	(void) textdomain(TEXT_DOMAIN);
1891 	(void) strlcpy(parents_locale, setlocale(LC_MESSAGES, NULL),
1892 	    sizeof (parents_locale));
1893 
1894 	/*
1895 	 * This zlog_t is used for writing to stderr
1896 	 */
1897 	errlog.logfile = stderr;
1898 	errlog.buflen = errlog.loglen = 0;
1899 	errlog.buf = errlog.log = NULL;
1900 	errlog.locale = parents_locale;
1901 
1902 	/*
1903 	 * We start off writing to stderr until we're ready to daemonize.
1904 	 */
1905 	zlogp = &errlog;
1906 
1907 	/*
1908 	 * Process options.
1909 	 */
1910 	while ((opt = getopt(argc, argv, "R:z:")) != EOF) {
1911 		switch (opt) {
1912 		case 'R':
1913 			zonecfg_set_root(optarg);
1914 			break;
1915 		case 'z':
1916 			zone_name = optarg;
1917 			break;
1918 		default:
1919 			usage();
1920 		}
1921 	}
1922 
1923 	if (zone_name == NULL)
1924 		usage();
1925 
1926 	/*
1927 	 * Because usage() prints directly to stderr, it has gettext()
1928 	 * wrapping, which depends on the locale.  But since zerror() calls
1929 	 * localize() which tweaks the locale, it is not safe to call zerror()
1930 	 * until after the last call to usage().  Fortunately, the last call
1931 	 * to usage() is just above and the first call to zerror() is just
1932 	 * below.  Don't mess this up.
1933 	 */
1934 	if (strcmp(zone_name, GLOBAL_ZONENAME) == 0) {
1935 		zerror(zlogp, B_FALSE, "cannot manage the %s zone",
1936 		    GLOBAL_ZONENAME);
1937 		return (1);
1938 	}
1939 
1940 	if (zone_get_id(zone_name, &zid) != 0) {
1941 		zerror(zlogp, B_FALSE, "could not manage %s: %s", zone_name,
1942 		    zonecfg_strerror(Z_NO_ZONE));
1943 		return (1);
1944 	}
1945 
1946 	if ((err = zone_get_state(zone_name, &zstate)) != Z_OK) {
1947 		zerror(zlogp, B_FALSE, "failed to get zone state: %s",
1948 		    zonecfg_strerror(err));
1949 		return (1);
1950 	}
1951 	if (zstate < ZONE_STATE_INCOMPLETE) {
1952 		zerror(zlogp, B_FALSE,
1953 		    "cannot manage a zone which is in state '%s'",
1954 		    zone_state_str(zstate));
1955 		return (1);
1956 	}
1957 
1958 	if (zonecfg_default_brand(default_brand,
1959 	    sizeof (default_brand)) != Z_OK) {
1960 		zerror(zlogp, B_FALSE, "unable to determine default brand");
1961 		return (1);
1962 	}
1963 
1964 	/* Get a handle to the brand info for this zone */
1965 	if (zone_get_brand(zone_name, brand_name, sizeof (brand_name))
1966 	    != Z_OK) {
1967 		zerror(zlogp, B_FALSE, "unable to determine zone brand");
1968 		return (1);
1969 	}
1970 	zone_isnative = (strcmp(brand_name, NATIVE_BRAND_NAME) == 0);
1971 	zone_islabeled = (strcmp(brand_name, LABELED_BRAND_NAME) == 0);
1972 
1973 	/*
1974 	 * In the alternate root environment, the only supported
1975 	 * operations are mount and unmount.  In this case, just treat
1976 	 * the zone as native if it is cluster.  Cluster zones can be
1977 	 * native for the purpose of LU or upgrade, and the cluster
1978 	 * brand may not exist in the miniroot (such as in net install
1979 	 * upgrade).
1980 	 */
1981 	if (strcmp(brand_name, CLUSTER_BRAND_NAME) == 0) {
1982 		zone_iscluster = B_TRUE;
1983 		if (zonecfg_in_alt_root()) {
1984 			(void) strlcpy(brand_name, default_brand,
1985 			    sizeof (brand_name));
1986 		}
1987 	} else {
1988 		zone_iscluster = B_FALSE;
1989 	}
1990 
1991 	if ((bh = brand_open(brand_name)) == NULL) {
1992 		zerror(zlogp, B_FALSE, "unable to open zone brand");
1993 		return (1);
1994 	}
1995 
1996 	/* Get state change brand hooks. */
1997 	if (brand_callback_init(bh, zone_name) == -1) {
1998 		zerror(zlogp, B_TRUE,
1999 		    "failed to initialize brand state change hooks");
2000 		brand_close(bh);
2001 		return (1);
2002 	}
2003 
2004 	brand_close(bh);
2005 
2006 	/*
2007 	 * Check that we have all privileges.  It would be nice to pare
2008 	 * this down, but this is at least a first cut.
2009 	 */
2010 	if ((privset = priv_allocset()) == NULL) {
2011 		zerror(zlogp, B_TRUE, "%s failed", "priv_allocset");
2012 		return (1);
2013 	}
2014 
2015 	if (getppriv(PRIV_EFFECTIVE, privset) != 0) {
2016 		zerror(zlogp, B_TRUE, "%s failed", "getppriv");
2017 		priv_freeset(privset);
2018 		return (1);
2019 	}
2020 
2021 	if (priv_isfullset(privset) == B_FALSE) {
2022 		zerror(zlogp, B_FALSE, "You lack sufficient privilege to "
2023 		    "run this command (all privs required)");
2024 		priv_freeset(privset);
2025 		return (1);
2026 	}
2027 	priv_freeset(privset);
2028 
2029 	if (mkzonedir(zlogp) != 0)
2030 		return (1);
2031 
2032 	/*
2033 	 * Pre-fork: setup shared state
2034 	 */
2035 	if ((shstate = (void *)mmap(NULL, shstatelen,
2036 	    PROT_READ|PROT_WRITE, MAP_SHARED|MAP_ANON, -1, (off_t)0)) ==
2037 	    MAP_FAILED) {
2038 		zerror(zlogp, B_TRUE, "%s failed", "mmap");
2039 		return (1);
2040 	}
2041 	if (sema_init(&shstate->sem, 0, USYNC_PROCESS, NULL) != 0) {
2042 		zerror(zlogp, B_TRUE, "%s failed", "sema_init()");
2043 		(void) munmap((char *)shstate, shstatelen);
2044 		return (1);
2045 	}
2046 	shstate->log.logfile = NULL;
2047 	shstate->log.buflen = shstatelen - sizeof (*shstate);
2048 	shstate->log.loglen = shstate->log.buflen;
2049 	shstate->log.buf = (char *)shstate + sizeof (*shstate);
2050 	shstate->log.log = shstate->log.buf;
2051 	shstate->log.locale = parents_locale;
2052 	shstate->status = -1;
2053 
2054 	/*
2055 	 * We need a SIGCHLD handler so the sema_wait() below will wake
2056 	 * up if the child dies without doing a sema_post().
2057 	 */
2058 	(void) sigset(SIGCHLD, sigchld);
2059 	/*
2060 	 * We must mask SIGCHLD until after we've coped with the fork
2061 	 * sufficiently to deal with it; otherwise we can race and
2062 	 * receive the signal before pid has been initialized
2063 	 * (yes, this really happens).
2064 	 */
2065 	(void) sigemptyset(&block_cld);
2066 	(void) sigaddset(&block_cld, SIGCHLD);
2067 	(void) sigprocmask(SIG_BLOCK, &block_cld, NULL);
2068 
2069 	/*
2070 	 * The parent only needs stderr after the fork, so close other fd's
2071 	 * that we inherited from zoneadm so that the parent doesn't have those
2072 	 * open while waiting. The child will close the rest after the fork.
2073 	 */
2074 	closefrom(3);
2075 
2076 	if ((ctfd = init_template()) == -1) {
2077 		zerror(zlogp, B_TRUE, "failed to create contract");
2078 		return (1);
2079 	}
2080 
2081 	/*
2082 	 * Do not let another thread localize a message while we are forking.
2083 	 */
2084 	(void) mutex_lock(&msglock);
2085 	pid = fork();
2086 	(void) mutex_unlock(&msglock);
2087 
2088 	/*
2089 	 * In all cases (parent, child, and in the event of an error) we
2090 	 * don't want to cause creation of contracts on subsequent fork()s.
2091 	 */
2092 	(void) ct_tmpl_clear(ctfd);
2093 	(void) close(ctfd);
2094 
2095 	if (pid == -1) {
2096 		zerror(zlogp, B_TRUE, "could not fork");
2097 		return (1);
2098 
2099 	} else if (pid > 0) { /* parent */
2100 		(void) sigprocmask(SIG_UNBLOCK, &block_cld, NULL);
2101 		/*
2102 		 * This marks a window of vulnerability in which we receive
2103 		 * the SIGCLD before falling into sema_wait (normally we would
2104 		 * get woken up from sema_wait with EINTR upon receipt of
2105 		 * SIGCLD).  So we may need to use some other scheme like
2106 		 * sema_posting in the sigcld handler.
2107 		 * blech
2108 		 */
2109 		(void) sema_wait(&shstate->sem);
2110 		(void) sema_destroy(&shstate->sem);
2111 		if (shstate->status != 0)
2112 			(void) waitpid(pid, NULL, WNOHANG);
2113 		/*
2114 		 * It's ok if we die with SIGPIPE.  It's not like we could have
2115 		 * done anything about it.
2116 		 */
2117 		(void) fprintf(stderr, "%s", shstate->log.buf);
2118 		_exit(shstate->status == 0 ? 0 : 1);
2119 	}
2120 
2121 	/*
2122 	 * The child charges on.
2123 	 */
2124 	(void) sigset(SIGCHLD, SIG_DFL);
2125 	(void) sigprocmask(SIG_UNBLOCK, &block_cld, NULL);
2126 
2127 	/*
2128 	 * SIGPIPE can be delivered if we write to a socket for which the
2129 	 * peer endpoint is gone.  That can lead to too-early termination
2130 	 * of zoneadmd, and that's not good eats.
2131 	 */
2132 	(void) sigset(SIGPIPE, SIG_IGN);
2133 	/*
2134 	 * Stop using stderr
2135 	 */
2136 	zlogp = &shstate->log;
2137 
2138 	/*
2139 	 * We don't need stdout/stderr from now on.
2140 	 */
2141 	closefrom(0);
2142 
2143 	/*
2144 	 * Initialize the syslog zlog_t.  This needs to be done after
2145 	 * the call to closefrom().
2146 	 */
2147 	logsys.buf = logsys.log = NULL;
2148 	logsys.buflen = logsys.loglen = 0;
2149 	logsys.logfile = NULL;
2150 	logsys.locale = DEFAULT_LOCALE;
2151 
2152 	openlog("zoneadmd", LOG_PID, LOG_DAEMON);
2153 
2154 	/*
2155 	 * The eventstream is used to publish state changes in the zone
2156 	 * from the door threads to the console I/O poller.
2157 	 */
2158 	if (eventstream_init() == -1) {
2159 		zerror(zlogp, B_TRUE, "unable to create eventstream");
2160 		goto child_out;
2161 	}
2162 
2163 	(void) snprintf(zone_door_path, sizeof (zone_door_path),
2164 	    "%s" ZONE_DOOR_PATH, zonecfg_get_root(), zone_name);
2165 
2166 	/*
2167 	 * See if another zoneadmd is running for this zone.  If not, then we
2168 	 * can now modify system state.
2169 	 */
2170 	if (make_daemon_exclusive(zlogp) == -1)
2171 		goto child_out;
2172 
2173 
2174 	/*
2175 	 * Create/join a new session; we need to be careful of what we do with
2176 	 * the console from now on so we don't end up being the session leader
2177 	 * for the terminal we're going to be handing out.
2178 	 */
2179 	(void) setsid();
2180 
2181 	/*
2182 	 * This thread shouldn't be receiving any signals; in particular,
2183 	 * SIGCHLD should be received by the thread doing the fork().
2184 	 */
2185 	(void) sigfillset(&blockset);
2186 	(void) thr_sigsetmask(SIG_BLOCK, &blockset, NULL);
2187 
2188 	/*
2189 	 * Setup the console device and get ready to serve the console;
2190 	 * once this has completed, we're ready to let console clients
2191 	 * make an attempt to connect (they will block until
2192 	 * serve_console_sock() below gets called, and any pending
2193 	 * connection is accept()ed).
2194 	 */
2195 	if (!zonecfg_in_alt_root() && init_console(zlogp) < 0)
2196 		goto child_out;
2197 
2198 	/*
2199 	 * Take the lock now, so that when the door server gets going, we
2200 	 * are guaranteed that it won't take a request until we are sure
2201 	 * that everything is completely set up.  See the child_out: label
2202 	 * below to see why this matters.
2203 	 */
2204 	(void) mutex_lock(&lock);
2205 
2206 	/* Init semaphore for scratch zones. */
2207 	if (sema_init(&scratch_sem, 0, USYNC_THREAD, NULL) == -1) {
2208 		zerror(zlogp, B_TRUE,
2209 		    "failed to initialize semaphore for scratch zone");
2210 		goto child_out;
2211 	}
2212 
2213 	/* open the dladm handle */
2214 	if (dladm_open(&dld_handle) != DLADM_STATUS_OK) {
2215 		zerror(zlogp, B_FALSE, "failed to open dladm handle");
2216 		goto child_out;
2217 	}
2218 
2219 	/*
2220 	 * Note: door setup must occur *after* the console is setup.
2221 	 * This is so that as zlogin tests the door to see if zoneadmd
2222 	 * is ready yet, we know that the console will get serviced
2223 	 * once door_info() indicates that the door is "up".
2224 	 */
2225 	if (setup_door(zlogp) == -1)
2226 		goto child_out;
2227 
2228 	/*
2229 	 * Things seem OK so far; tell the parent process that we're done
2230 	 * with setup tasks.  This will cause the parent to exit, signalling
2231 	 * to zoneadm, zlogin, or whatever forked it that we are ready to
2232 	 * service requests.
2233 	 */
2234 	shstate->status = 0;
2235 	(void) sema_post(&shstate->sem);
2236 	(void) munmap((char *)shstate, shstatelen);
2237 	shstate = NULL;
2238 
2239 	(void) mutex_unlock(&lock);
2240 
2241 	/*
2242 	 * zlogp is now invalid, so reset it to the syslog logger.
2243 	 */
2244 	zlogp = &logsys;
2245 
2246 	/*
2247 	 * Now that we are free of any parents, switch to the default locale.
2248 	 */
2249 	(void) setlocale(LC_ALL, DEFAULT_LOCALE);
2250 
2251 	/*
2252 	 * At this point the setup portion of main() is basically done, so
2253 	 * we reuse this thread to manage the zone console.  When
2254 	 * serve_console() has returned, we are past the point of no return
2255 	 * in the life of this zoneadmd.
2256 	 */
2257 	if (zonecfg_in_alt_root()) {
2258 		/*
2259 		 * This is just awful, but mounted scratch zones don't (and
2260 		 * can't) have consoles.  We just wait for unmount instead.
2261 		 */
2262 		while (sema_wait(&scratch_sem) == EINTR)
2263 			;
2264 	} else {
2265 		serve_console(zlogp);
2266 		assert(in_death_throes);
2267 	}
2268 
2269 	/*
2270 	 * This is the next-to-last part of the exit interlock.  Upon calling
2271 	 * fdetach(), the door will go unreferenced; once any
2272 	 * outstanding requests (like the door thread doing Z_HALT) are
2273 	 * done, the door will get an UNREF notification; when it handles
2274 	 * the UNREF, the door server will cause the exit.  It's possible
2275 	 * that fdetach() can fail because the file is in use, in which
2276 	 * case we'll retry the operation.
2277 	 */
2278 	assert(!MUTEX_HELD(&lock));
2279 	for (;;) {
2280 		if ((fdetach(zone_door_path) == 0) || (errno != EBUSY))
2281 			break;
2282 		yield();
2283 	}
2284 
2285 	for (;;)
2286 		(void) pause();
2287 
2288 child_out:
2289 	assert(pid == 0);
2290 
2291 	shstate->status = -1;
2292 	(void) sema_post(&shstate->sem);
2293 	(void) munmap((char *)shstate, shstatelen);
2294 
2295 	/*
2296 	 * This might trigger an unref notification, but if so,
2297 	 * we are still holding the lock, so our call to exit will
2298 	 * ultimately win the race and will publish the right exit
2299 	 * code.
2300 	 */
2301 	if (zone_door != -1) {
2302 		assert(MUTEX_HELD(&lock));
2303 		(void) door_revoke(zone_door);
2304 		(void) fdetach(zone_door_path);
2305 	}
2306 
2307 	if (dld_handle != NULL)
2308 		dladm_close(dld_handle);
2309 
2310 	return (1); /* return from main() forcibly exits an MT process */
2311 }
2312