17c478bd9Sstevel@tonic-gate /* 27c478bd9Sstevel@tonic-gate * CDDL HEADER START 37c478bd9Sstevel@tonic-gate * 47c478bd9Sstevel@tonic-gate * The contents of this file are subject to the terms of the 5ffbafc53Scomay * Common Development and Distribution License (the "License"). 6ffbafc53Scomay * You may not use this file except in compliance with the License. 77c478bd9Sstevel@tonic-gate * 87c478bd9Sstevel@tonic-gate * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 97c478bd9Sstevel@tonic-gate * or http://www.opensolaris.org/os/licensing. 107c478bd9Sstevel@tonic-gate * See the License for the specific language governing permissions 117c478bd9Sstevel@tonic-gate * and limitations under the License. 127c478bd9Sstevel@tonic-gate * 137c478bd9Sstevel@tonic-gate * When distributing Covered Code, include this CDDL HEADER in each 147c478bd9Sstevel@tonic-gate * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 157c478bd9Sstevel@tonic-gate * If applicable, add the following below this CDDL HEADER, with the 167c478bd9Sstevel@tonic-gate * fields enclosed by brackets "[]" replaced with your own identifying 177c478bd9Sstevel@tonic-gate * information: Portions Copyright [yyyy] [name of copyright owner] 187c478bd9Sstevel@tonic-gate * 197c478bd9Sstevel@tonic-gate * CDDL HEADER END 207c478bd9Sstevel@tonic-gate */ 21ffbafc53Scomay 227c478bd9Sstevel@tonic-gate /* 23*efd4c9b6SSteve Lawrence * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved. 247c478bd9Sstevel@tonic-gate */ 257c478bd9Sstevel@tonic-gate 267c478bd9Sstevel@tonic-gate #ifndef _ZONEADMD_H 277c478bd9Sstevel@tonic-gate #define _ZONEADMD_H 287c478bd9Sstevel@tonic-gate 297c478bd9Sstevel@tonic-gate #ifdef __cplusplus 307c478bd9Sstevel@tonic-gate extern "C" { 317c478bd9Sstevel@tonic-gate #endif 327c478bd9Sstevel@tonic-gate 334ac67f02SAnurag S. Maskey #include <libdladm.h> 344ac67f02SAnurag S. Maskey 357c478bd9Sstevel@tonic-gate /* 367c478bd9Sstevel@tonic-gate * Multi-threaded programs should avoid MT-unsafe library calls (i.e., any- 377c478bd9Sstevel@tonic-gate * thing which could try to acquire a user-level lock unprotected by an atfork 387c478bd9Sstevel@tonic-gate * handler) between fork(2) and exec(2). See the pthread_atfork(3THR) man 397c478bd9Sstevel@tonic-gate * page for details. In particular, we want to avoid calls to zerror() in 407c478bd9Sstevel@tonic-gate * such situations, as it calls setlocale(3c) which is susceptible to such 417c478bd9Sstevel@tonic-gate * problems. So instead we have the child use one of the special exit codes 427c478bd9Sstevel@tonic-gate * below when needed, and the parent look out for such possibilities and call 437c478bd9Sstevel@tonic-gate * zerror() there. 447c478bd9Sstevel@tonic-gate * 457c478bd9Sstevel@tonic-gate * Since 0, 1 and 2 are generally used for success, general error, and usage, 467c478bd9Sstevel@tonic-gate * we start with 3. 477c478bd9Sstevel@tonic-gate */ 487c478bd9Sstevel@tonic-gate #define ZEXIT_FORK 3 497c478bd9Sstevel@tonic-gate #define ZEXIT_EXEC 4 507c478bd9Sstevel@tonic-gate #define ZEXIT_ZONE_ENTER 5 517c478bd9Sstevel@tonic-gate 527c478bd9Sstevel@tonic-gate #define DEVFSADM "devfsadm" 537c478bd9Sstevel@tonic-gate #define DEVFSADM_PATH "/usr/sbin/devfsadm" 547c478bd9Sstevel@tonic-gate 559acbbeafSnn #define EXEC_PREFIX "exec " 569acbbeafSnn #define EXEC_LEN (strlen(EXEC_PREFIX)) 579acbbeafSnn 5884561e8cStd #define CLUSTER_BRAND_NAME "cluster" 599a5d73e0SRic Aleshire #define LABELED_BRAND_NAME "labeled" 6084561e8cStd 61d314f035Sedp /* 0755 is the default directory mode. */ 62d314f035Sedp #define DEFAULT_DIR_MODE \ 63d314f035Sedp (S_IRWXU | S_IRGRP | S_IXGRP | S_IROTH | S_IXOTH) 64d314f035Sedp #define DEFAULT_DIR_USER -1 /* user ID for chown: -1 means don't change */ 65d314f035Sedp #define DEFAULT_DIR_GROUP -1 /* grp ID for chown: -1 means don't change */ 66d314f035Sedp 67d314f035Sedp 687c478bd9Sstevel@tonic-gate typedef struct zlog { 697c478bd9Sstevel@tonic-gate FILE *logfile; /* file to log to */ 707c478bd9Sstevel@tonic-gate 717c478bd9Sstevel@tonic-gate /* 727c478bd9Sstevel@tonic-gate * The following are used if logging to a buffer. 737c478bd9Sstevel@tonic-gate */ 747c478bd9Sstevel@tonic-gate char *log; /* remaining log */ 757c478bd9Sstevel@tonic-gate size_t loglen; /* size of remaining log */ 767c478bd9Sstevel@tonic-gate char *buf; /* underlying storage */ 777c478bd9Sstevel@tonic-gate size_t buflen; /* total len of 'buf' */ 787c478bd9Sstevel@tonic-gate char *locale; /* locale to use for gettext() */ 797c478bd9Sstevel@tonic-gate } zlog_t; 807c478bd9Sstevel@tonic-gate 8122321485Svp extern zlog_t logsys; 8222321485Svp 837c478bd9Sstevel@tonic-gate extern mutex_t lock; 847c478bd9Sstevel@tonic-gate extern mutex_t msglock; 857c478bd9Sstevel@tonic-gate extern boolean_t in_death_throes; 867c478bd9Sstevel@tonic-gate extern boolean_t bringup_failure_recovery; 877c478bd9Sstevel@tonic-gate extern char *zone_name; 88*efd4c9b6SSteve Lawrence extern char pool_name[MAXNAMELEN]; 8962868012SSteve Lawrence extern char brand_name[MAXNAMELEN]; 90e5816e35SEdward Pilatowicz extern char default_brand[MAXNAMELEN]; 913f2f09c1Sdp extern char boot_args[BOOTARGS_MAX]; 923f2f09c1Sdp extern char bad_boot_arg[BOOTARGS_MAX]; 939acbbeafSnn extern boolean_t zone_isnative; 9484561e8cStd extern boolean_t zone_iscluster; 954ac67f02SAnurag S. Maskey extern dladm_handle_t dld_handle; 967c478bd9Sstevel@tonic-gate 977c478bd9Sstevel@tonic-gate extern void zerror(zlog_t *, boolean_t, const char *, ...); 987c478bd9Sstevel@tonic-gate extern char *localize_msg(char *locale, const char *msg); 997c478bd9Sstevel@tonic-gate 1007c478bd9Sstevel@tonic-gate /* 1017c478bd9Sstevel@tonic-gate * Eventstream interfaces. 1027c478bd9Sstevel@tonic-gate */ 1037c478bd9Sstevel@tonic-gate typedef enum { 1047c478bd9Sstevel@tonic-gate Z_EVT_NULL = 0, 1057c478bd9Sstevel@tonic-gate Z_EVT_ZONE_BOOTING, 1067c478bd9Sstevel@tonic-gate Z_EVT_ZONE_REBOOTING, 1077c478bd9Sstevel@tonic-gate Z_EVT_ZONE_HALTED, 1087c478bd9Sstevel@tonic-gate Z_EVT_ZONE_READIED, 109ffbafc53Scomay Z_EVT_ZONE_UNINSTALLING, 1103f2f09c1Sdp Z_EVT_ZONE_BOOTFAILED, 1113f2f09c1Sdp Z_EVT_ZONE_BADARGS 1127c478bd9Sstevel@tonic-gate } zone_evt_t; 1137c478bd9Sstevel@tonic-gate 1147c478bd9Sstevel@tonic-gate extern int eventstream_init(); 1157c478bd9Sstevel@tonic-gate extern void eventstream_write(zone_evt_t evt); 1167c478bd9Sstevel@tonic-gate 1176cfd72c6Sgjelinek /* 1186cfd72c6Sgjelinek * Zone mount styles. Boot is the standard mount we do when booting the zone, 1196cfd72c6Sgjelinek * scratch is the standard scratch zone mount for upgrade and update is a 1206cfd72c6Sgjelinek * variation on the scratch zone where we don't lofs mount the zone's /etc 1216cfd72c6Sgjelinek * and /var back into the scratch zone so that we can then do an 1226cfd72c6Sgjelinek * 'update on attach' within the scratch zone. 1236cfd72c6Sgjelinek */ 1246cfd72c6Sgjelinek typedef enum { 1256cfd72c6Sgjelinek Z_MNT_BOOT = 0, 1266cfd72c6Sgjelinek Z_MNT_SCRATCH, 1276cfd72c6Sgjelinek Z_MNT_UPDATE 1286cfd72c6Sgjelinek } zone_mnt_t; 1296cfd72c6Sgjelinek 1307c478bd9Sstevel@tonic-gate /* 1317c478bd9Sstevel@tonic-gate * Virtual platform interfaces. 1327c478bd9Sstevel@tonic-gate */ 1336cfd72c6Sgjelinek extern zoneid_t vplat_create(zlog_t *, zone_mnt_t); 1346cfd72c6Sgjelinek extern int vplat_bringup(zlog_t *, zone_mnt_t, zoneid_t); 1350209230bSgjelinek extern int vplat_teardown(zlog_t *, boolean_t, boolean_t); 1362b24ab6bSSebastien Roy extern int vplat_get_iptype(zlog_t *, zone_iptype_t *); 1377c478bd9Sstevel@tonic-gate 138d314f035Sedp /* 139d314f035Sedp * Filesystem mounting interfaces. 140d314f035Sedp */ 141d314f035Sedp extern int valid_mount_path(zlog_t *, const char *, const char *, 142d314f035Sedp const char *, const char *); 143d314f035Sedp extern int make_one_dir(zlog_t *, const char *, const char *, 144d314f035Sedp mode_t, uid_t, gid_t); 145910f48daSedp extern void resolve_lofs(zlog_t *zlogp, char *path, size_t pathlen); 146d314f035Sedp 1477c478bd9Sstevel@tonic-gate /* 1487c478bd9Sstevel@tonic-gate * Console subsystem routines. 1497c478bd9Sstevel@tonic-gate */ 1507c478bd9Sstevel@tonic-gate extern int init_console(zlog_t *); 1517c478bd9Sstevel@tonic-gate extern void serve_console(zlog_t *); 1527c478bd9Sstevel@tonic-gate 153555afedfScarlsonj /* 154555afedfScarlsonj * Contract handling. 155555afedfScarlsonj */ 156555afedfScarlsonj extern int init_template(void); 157555afedfScarlsonj 1589acbbeafSnn /* 1599acbbeafSnn * Routine to manage child processes. 1609acbbeafSnn */ 161c5cd6260S extern int do_subproc(zlog_t *, char *, char **); 1629acbbeafSnn 1637c478bd9Sstevel@tonic-gate #ifdef __cplusplus 1647c478bd9Sstevel@tonic-gate } 1657c478bd9Sstevel@tonic-gate #endif 1667c478bd9Sstevel@tonic-gate 1677c478bd9Sstevel@tonic-gate #endif /* _ZONEADMD_H */ 168