5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * CDDL HEADER START
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * The contents of this file are subject to the terms of the
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Common Development and Distribution License (the "License").
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * You may not use this file except in compliance with the License.
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * or http://www.opensolaris.org/os/licensing.
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * See the License for the specific language governing permissions
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * and limitations under the License.
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * When distributing Covered Code, include this CDDL HEADER in each
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * If applicable, add the following below this CDDL HEADER, with the
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * fields enclosed by brackets "[]" replaced with your own identifying
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * information: Portions Copyright [yyyy] [name of copyright owner]
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * CDDL HEADER END
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Copyright 2009 Sun Microsystems, Inc. All rights reserved.
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Use is subject to license terms.
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland/* Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland/* All Rights Reserved */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * imported global variables
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland/* imported from main.c */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterlandextern struct pkgdev pkgdev; /* holds info about the installation device */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterlandextern int npkgs; /* the number of packages yet to be installed */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterlandextern int admnflag; /* != 0 if any pkgop admin setting failed (4) */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterlandextern int doreboot; /* != 0 if reboot required after installation */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterlandextern int failflag; /* != 0 if fatal error has occurred (1) */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterlandextern int intrflag; /* != 0 if user selected quit (3) */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterlandextern int ireboot; /* != 0 if immediate reboot required */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterlandextern int nullflag; /* != 0 if admin interaction required (5) */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterlandextern int warnflag; /* != 0 if non-fatal error has occurred (2) */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * forward declarations
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterlandstatic ckreturnFunc_t *ckreturnFunc = (ckreturnFunc_t *)NULL;
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterlandstatic zoneList_t zoneList = (zoneList_t)NULL;
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * exported functions
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterlandvoid quitSetCkreturnFunc(ckreturnFunc_t *a_ckreturnFunc);
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterlandvoid quitSetZoneTmpdir(char *z_zoneTempDir);
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * *****************************************************************************
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * global external (public) functions
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * *****************************************************************************
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Name: quitGetTrapHandler
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Description: return address of this modules "signal trap" handler
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Arguments: void
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Returns: sighdlrFunc_t
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * The address of the trap handler that can be passed to
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * the signal() type system calls
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Name: quitSetCkreturnFunc
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Description: set the ckreturn() interface to call when quit() is called
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Arguments: a_ckreturnFunc - pointer to function to call when quit() is
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Returns: void
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * NOTE: When quit() is called if a "ckreturnfunc" is set, then the first
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * action quit() takes is to call the "ckreturnfunc" specified with
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * the value passed to quit as the first argument. Quit will then
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * set the final return code to be used when exit() is called based
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * on the contents of these global variables:
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * - admnflag - != 0 if any pkgop admin setting failed (4)
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * - doreboot - != 0 if reboot required after installation
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * - failflag - != 0 if fatal error has occurred (1)
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * - intrflag - != 0 if user selected quit (3)
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * - ireboot - != 0 if immediate reboot required
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * - nullflag - != 0 if admin interaction required (5)
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * - warnflag - != 0 if non-fatal error has occurred (2)
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah WaterlandquitSetCkreturnFunc(ckreturnFunc_t *a_ckreturnFunc)
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Name: quitSetZonelist
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Description: set the list of zones that are "locked" so that the zones can
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * be unlocked if quit() is called to exit
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Arguments: a_zlst - list of zones that are "locked"
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Returns: void
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * NOTE: When quit() is called, if this list is set, then z_unlock_zones
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * is called to unlock all of the zones in the list. If this list
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * is NOT set, then z_unlock_this_zone is called to unlock this
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Name: quitSetZoneName
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Description: set the zone name the program is running in
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Arguments: a_zoneName - pointer to string representing the name of the zone
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * that the program is running in
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Returns: void
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland/* ARGSUSED */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Name: quitSetZoneTmpdir
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Description: set the path to the "zone temporary directory" in use
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Arguments: a_zoneTempDir - pointer to string representing the full path to
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * the temporary directory used to hold files used during
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * zone operations
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Returns: void
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * NOTE: If a zone temporary directory is set when quit() is called, the
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * directory is recursively removed before quit() calls exit
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Description: cleanup and exit
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Arguments: a_retcode - the code to use to determine final exit status;
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * if this is NOT "99" and if a "ckreturnFunc" is
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * set, then that function is called with a_retcode
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * to set the final exit status.
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Valid values are:
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * 0 - success
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * 1 - package operation failed (fatal error)
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * 2 - non-fatal error (warning)
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * 3 - user selected quit (operation interrupted)
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * 4 - admin settings prevented operation
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * 5 - interaction required and -n (non-interactive) specified
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * "10" is added to indicate "immediate reboot required"
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * "20" is be added to indicate "reboot after install required"
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * 99 - do not interpret the code - just exit "99"
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Returns: <<this function does not return - calls exit()>>
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland /* disable interrupts */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland /* process return code if not quit(99) */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland if (ckreturnFunc != (ckreturnFunc_t *)NULL) {
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland /* if set remove zone temporary directory */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland echoDebug(DBG_REMOVING_ZONE_TMPDIR, zoneTempDir);
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * issue final exit message depending on number of packages left
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland /* if a zone list exists, unlock all zones */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland (void) z_unlock_zones(zoneList, ZLOCKS_ALL);
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland /* final exit debugging message */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland /* NOTREACHED */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * *****************************************************************************
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * static internal (private) functions
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * *****************************************************************************
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Description: signal handler connected via quitGetTrapHandler()
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Arguments: signo - [RO, *RO] - (int)
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Integer representing the signal that caused the trap
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * to this function to occur
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * Returns: << NONE >>
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * NOTE: This function exits the program after doing mandatory cleanup.
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * NOTE: Even though quit() should NOT return, there is a call to _exit()
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * put after each call to quit() just in case quit() ever returned
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland * by mistake.
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland /* prevent reentrance */
5c51f1241dbbdf2656d0e10011981411ed0c9673Moriah Waterland if ((signo == SIGINT) || (signo == SIGHUP)) {