17c478bdstevel@tonic-gate/*
27c478bdstevel@tonic-gate * CDDL HEADER START
37c478bdstevel@tonic-gate *
47c478bdstevel@tonic-gate * The contents of this file are subject to the terms of the
5ffbafc5comay * Common Development and Distribution License (the "License").
6ffbafc5comay * You may not use this file except in compliance with the License.
77c478bdstevel@tonic-gate *
87c478bdstevel@tonic-gate * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
97c478bdstevel@tonic-gate * or http://www.opensolaris.org/os/licensing.
107c478bdstevel@tonic-gate * See the License for the specific language governing permissions
117c478bdstevel@tonic-gate * and limitations under the License.
127c478bdstevel@tonic-gate *
137c478bdstevel@tonic-gate * When distributing Covered Code, include this CDDL HEADER in each
147c478bdstevel@tonic-gate * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
157c478bdstevel@tonic-gate * If applicable, add the following below this CDDL HEADER, with the
167c478bdstevel@tonic-gate * fields enclosed by brackets "[]" replaced with your own identifying
177c478bdstevel@tonic-gate * information: Portions Copyright [yyyy] [name of copyright owner]
187c478bdstevel@tonic-gate *
197c478bdstevel@tonic-gate * CDDL HEADER END
207c478bdstevel@tonic-gate */
21ffbafc5comay
227c478bdstevel@tonic-gate/*
23efd4c9bSteve Lawrence * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved.
243c7284bAlexander Eremin * Copyright 2014 Nexenta Systems, Inc. All rights reserved.
257c478bdstevel@tonic-gate */
267c478bdstevel@tonic-gate
277c478bdstevel@tonic-gate#ifndef	_ZONEADMD_H
287c478bdstevel@tonic-gate#define	_ZONEADMD_H
297c478bdstevel@tonic-gate
307c478bdstevel@tonic-gate#ifdef	__cplusplus
317c478bdstevel@tonic-gateextern "C" {
327c478bdstevel@tonic-gate#endif
337c478bdstevel@tonic-gate
344ac67f0Anurag S. Maskey#include <libdladm.h>
354ac67f0Anurag S. Maskey
367c478bdstevel@tonic-gate/*
377c478bdstevel@tonic-gate * Multi-threaded programs should avoid MT-unsafe library calls (i.e., any-
387c478bdstevel@tonic-gate * thing which could try to acquire a user-level lock unprotected by an atfork
397c478bdstevel@tonic-gate * handler) between fork(2) and exec(2).  See the pthread_atfork(3THR) man
407c478bdstevel@tonic-gate * page for details.  In particular, we want to avoid calls to zerror() in
417c478bdstevel@tonic-gate * such situations, as it calls setlocale(3c) which is susceptible to such
427c478bdstevel@tonic-gate * problems.  So instead we have the child use one of the special exit codes
437c478bdstevel@tonic-gate * below when needed, and the parent look out for such possibilities and call
447c478bdstevel@tonic-gate * zerror() there.
457c478bdstevel@tonic-gate *
467c478bdstevel@tonic-gate * Since 0, 1 and 2 are generally used for success, general error, and usage,
477c478bdstevel@tonic-gate * we start with 3.
487c478bdstevel@tonic-gate */
497c478bdstevel@tonic-gate#define	ZEXIT_FORK		3
507c478bdstevel@tonic-gate#define	ZEXIT_EXEC		4
517c478bdstevel@tonic-gate#define	ZEXIT_ZONE_ENTER	5
527c478bdstevel@tonic-gate
537c478bdstevel@tonic-gate#define	DEVFSADM	"devfsadm"
547c478bdstevel@tonic-gate#define	DEVFSADM_PATH	"/usr/sbin/devfsadm"
557c478bdstevel@tonic-gate
569acbbeann#define	EXEC_PREFIX	"exec "
579acbbeann#define	EXEC_LEN	(strlen(EXEC_PREFIX))
589acbbeann
5984561e8td#define	CLUSTER_BRAND_NAME	"cluster"
609a5d73eRic Aleshire#define	LABELED_BRAND_NAME	"labeled"
6184561e8td
623c7284bAlexander Eremin#define	SHUTDOWN_WAIT		60
633c7284bAlexander Eremin#define	SHUTDOWN_DEFAULT	"/sbin/init 0"
643c7284bAlexander Eremin#define	SHUTDOWN_FMRI	"svc:/system/zones:default"
653c7284bAlexander Eremin
66d314f03edp/* 0755 is the default directory mode. */
67d314f03edp#define	DEFAULT_DIR_MODE \
68d314f03edp	(S_IRWXU | S_IRGRP | S_IXGRP | S_IROTH | S_IXOTH)
69d314f03edp#define	DEFAULT_DIR_USER -1	/* user ID for chown: -1 means don't change */
70d314f03edp#define	DEFAULT_DIR_GROUP -1	/* grp ID for chown: -1 means don't change */
71d314f03edp
72d314f03edp
737c478bdstevel@tonic-gatetypedef struct zlog {
747c478bdstevel@tonic-gate	FILE *logfile;	/* file to log to */
757c478bdstevel@tonic-gate
767c478bdstevel@tonic-gate	/*
777c478bdstevel@tonic-gate	 * The following are used if logging to a buffer.
787c478bdstevel@tonic-gate	 */
797c478bdstevel@tonic-gate	char *log;	/* remaining log */
807c478bdstevel@tonic-gate	size_t loglen;	/* size of remaining log */
817c478bdstevel@tonic-gate	char *buf;	/* underlying storage */
827c478bdstevel@tonic-gate	size_t buflen;	/* total len of 'buf' */
837c478bdstevel@tonic-gate	char *locale;	/* locale to use for gettext() */
847c478bdstevel@tonic-gate} zlog_t;
857c478bdstevel@tonic-gate
862232148vpextern zlog_t logsys;
872232148vp
887c478bdstevel@tonic-gateextern mutex_t lock;
897c478bdstevel@tonic-gateextern mutex_t msglock;
907c478bdstevel@tonic-gateextern boolean_t in_death_throes;
917c478bdstevel@tonic-gateextern boolean_t bringup_failure_recovery;
927c478bdstevel@tonic-gateextern char *zone_name;
93efd4c9bSteve Lawrenceextern char pool_name[MAXNAMELEN];
946286801Steve Lawrenceextern char brand_name[MAXNAMELEN];
95e5816e3Edward Pilatowiczextern char default_brand[MAXNAMELEN];
963f2f09cdpextern char boot_args[BOOTARGS_MAX];
973f2f09cdpextern char bad_boot_arg[BOOTARGS_MAX];
989acbbeannextern boolean_t zone_isnative;
9984561e8tdextern boolean_t zone_iscluster;
1004ac67f0Anurag S. Maskeyextern dladm_handle_t dld_handle;
1017c478bdstevel@tonic-gate
1027c478bdstevel@tonic-gateextern void zerror(zlog_t *, boolean_t, const char *, ...);
1037c478bdstevel@tonic-gateextern char *localize_msg(char *locale, const char *msg);
1047c478bdstevel@tonic-gate
1057c478bdstevel@tonic-gate/*
1067c478bdstevel@tonic-gate * Eventstream interfaces.
1077c478bdstevel@tonic-gate */
1087c478bdstevel@tonic-gatetypedef enum {
1097c478bdstevel@tonic-gate	Z_EVT_NULL = 0,
1107c478bdstevel@tonic-gate	Z_EVT_ZONE_BOOTING,
1117c478bdstevel@tonic-gate	Z_EVT_ZONE_REBOOTING,
1127c478bdstevel@tonic-gate	Z_EVT_ZONE_HALTED,
1137c478bdstevel@tonic-gate	Z_EVT_ZONE_READIED,
114ffbafc5comay	Z_EVT_ZONE_UNINSTALLING,
1153f2f09cdp	Z_EVT_ZONE_BOOTFAILED,
1163f2f09cdp	Z_EVT_ZONE_BADARGS
1177c478bdstevel@tonic-gate} zone_evt_t;
1187c478bdstevel@tonic-gate
1197c478bdstevel@tonic-gateextern int eventstream_init();
1207c478bdstevel@tonic-gateextern void eventstream_write(zone_evt_t evt);
1217c478bdstevel@tonic-gate
1227c478bdstevel@tonic-gate/*
1236cfd72cgjelinek * Zone mount styles.  Boot is the standard mount we do when booting the zone,
1246cfd72cgjelinek * scratch is the standard scratch zone mount for upgrade and update is a
1256cfd72cgjelinek * variation on the scratch zone where we don't lofs mount the zone's /etc
1266cfd72cgjelinek * and /var back into the scratch zone so that we can then do an
1276cfd72cgjelinek * 'update on attach' within the scratch zone.
1286cfd72cgjelinek */
1296cfd72cgjelinektypedef enum {
1306cfd72cgjelinek	Z_MNT_BOOT = 0,
1316cfd72cgjelinek	Z_MNT_SCRATCH,
1326cfd72cgjelinek	Z_MNT_UPDATE
1336cfd72cgjelinek} zone_mnt_t;
1346cfd72cgjelinek
1356cfd72cgjelinek/*
1367c478bdstevel@tonic-gate * Virtual platform interfaces.
1377c478bdstevel@tonic-gate */
1386cfd72cgjelinekextern zoneid_t vplat_create(zlog_t *, zone_mnt_t);
1396cfd72cgjelinekextern int vplat_bringup(zlog_t *, zone_mnt_t, zoneid_t);
1400209230gjelinekextern int vplat_teardown(zlog_t *, boolean_t, boolean_t);
1412b24ab6Sebastien Royextern int vplat_get_iptype(zlog_t *, zone_iptype_t *);
1427c478bdstevel@tonic-gate
1437c478bdstevel@tonic-gate/*
144d314f03edp * Filesystem mounting interfaces.
145d314f03edp */
146d314f03edpextern int valid_mount_path(zlog_t *, const char *, const char *,
147d314f03edp    const char *, const char *);
148d314f03edpextern int make_one_dir(zlog_t *, const char *, const char *,
149d314f03edp    mode_t, uid_t, gid_t);
150910f48dedpextern void resolve_lofs(zlog_t *zlogp, char *path, size_t pathlen);
151d314f03edp
152d314f03edp/*
1537c478bdstevel@tonic-gate * Console subsystem routines.
1547c478bdstevel@tonic-gate */
1557c478bdstevel@tonic-gateextern int init_console(zlog_t *);
1567c478bdstevel@tonic-gateextern void serve_console(zlog_t *);
1577c478bdstevel@tonic-gate
158555afedcarlsonj/*
159555afedcarlsonj * Contract handling.
160555afedcarlsonj */
161555afedcarlsonjextern int init_template(void);
162555afedcarlsonj
1639acbbeann/*
1649acbbeann * Routine to manage child processes.
1659acbbeann */
166c5cd626<Gerald Jelinek>extern int do_subproc(zlog_t *, char *, char **);
1679acbbeann
1687c478bdstevel@tonic-gate#ifdef __cplusplus
1697c478bdstevel@tonic-gate}
1707c478bdstevel@tonic-gate#endif
1717c478bdstevel@tonic-gate
1727c478bdstevel@tonic-gate#endif /* _ZONEADMD_H */
173