Print this page
2594 implement graceful shutdown for local zones in zoneadm


   6  The contents of this file are subject to the terms of the
   7  Common Development and Distribution License (the "License").
   8  You may not use this file except in compliance with the License.
   9 
  10  You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  11  or http://www.opensolaris.org/os/licensing.
  12  See the License for the specific language governing permissions
  13  and limitations under the License.
  14 
  15  When distributing Covered Code, include this CDDL HEADER in each
  16  file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  17  If applicable, add the following below this CDDL HEADER, with the
  18  fields enclosed by brackets "[]" replaced with your own identifying
  19  information: Portions Copyright [yyyy] [name of copyright owner]
  20 
  21  CDDL HEADER END
  22 
  23  Copyright (c) 2006, 2010, Oracle and/or its affiliates. All rights reserved.
  24 
  25  DO NOT EDIT THIS FILE.


  26 -->
  27 
  28 <!--
  29   verify_cfg
  30 
  31     Identifies the program to be invoked by zonecfg to verify that the
  32     zone's configuration is legal, and that all the configured devices,
  33     attributes, etc. are legal for this brand.
  34 
  35     The program is called with a single argument: the path to a file
  36     containing a temporary config.xml file the zone.  It should return 0
  37     on success and non-0 on failure.  Any detailed error messages should be
  38     displayed to stderr.
  39 
  40     It has no attributes.
  41 
  42 -->
  43 <!ELEMENT verify_cfg (#PCDATA) >
  44 <!ATTLIST verify_cfg>
  45 <!--


 149     also be able to gracefully handle the case where resources that it
 150     expects to release are not actually allocated (or have been already
 151     released.)
 152 
 153     If this programs succeeds it should not generate any output.  If this
 154     program returns an error, any output generated by the program will be
 155     sent to the zoneadmd message log.
 156 
 157     The following replacements are performed:
 158 
 159       %z        Name of zone
 160       %R        Zonepath of zone
 161       Additional arguments, if any, are appended.
 162 
 163     It has no attributes.
 164 -->
 165 <!ELEMENT halt       (#PCDATA) >
 166 <!ATTLIST halt>
 167 
 168 <!--





















 169   modname
 170 
 171     Path to the kernel module that implements the kernel-level
 172     functionality of the brand.
 173 
 174     It has no attributes.
 175 -->
 176 <!ELEMENT modname    (#PCDATA) >
 177 <!ATTLIST modname>
 178 
 179 <!--
 180   initname
 181 
 182     Path to the initial executable that should be launched when booting a
 183     branded zone.
 184 
 185     It has no attributes.
 186 -->
 187 <!ELEMENT initname   (#PCDATA) >
 188 <!ATTLIST initname>


 590 
 591 -->
 592 <!ELEMENT privilege  (#PCDATA) >
 593 <!ATTLIST privilege  set     ( default | prohibited | required ) #REQUIRED 
 594                         name    CDATA #REQUIRED
 595                         ip-type ( shared | exclusive ) "all" >
 596 
 597 <!--
 598   brand
 599 
 600     The toplevel container for a brand configuration.
 601 
 602     Its attributes are
 603 
 604       name      The name of the brand.  This must match the name of the
 605                 directory in which the configuration file is stored.
 606 -->
 607 
 608 <!ELEMENT brand              (modname?, initname, login_cmd, forcedlogin_cmd,
 609                         user_cmd, install,
 610                         installopts?, boot?, sysboot?, halt?, verify_cfg?,
 611                         verify_adm?, postattach?, postclone?, postinstall?,
 612                         predetach?, attach?, detach?, clone?,
 613                         presnap?, postsnap?, validatesnap?,
 614                         preuninstall?, uninstall?,
 615                         prestatechange?, poststatechange?, query?,
 616                         privilege+)>
 617 
 618 <!ATTLIST brand              name            CDATA #REQUIRED>


   6  The contents of this file are subject to the terms of the
   7  Common Development and Distribution License (the "License").
   8  You may not use this file except in compliance with the License.
   9 
  10  You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  11  or http://www.opensolaris.org/os/licensing.
  12  See the License for the specific language governing permissions
  13  and limitations under the License.
  14 
  15  When distributing Covered Code, include this CDDL HEADER in each
  16  file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  17  If applicable, add the following below this CDDL HEADER, with the
  18  fields enclosed by brackets "[]" replaced with your own identifying
  19  information: Portions Copyright [yyyy] [name of copyright owner]
  20 
  21  CDDL HEADER END
  22 
  23  Copyright (c) 2006, 2010, Oracle and/or its affiliates. All rights reserved.
  24 
  25  DO NOT EDIT THIS FILE.
  26 
  27  Copyright 2014 Nexenta Systems, Inc. All rights reserved.
  28 -->
  29 
  30 <!--
  31   verify_cfg
  32 
  33     Identifies the program to be invoked by zonecfg to verify that the
  34     zone's configuration is legal, and that all the configured devices,
  35     attributes, etc. are legal for this brand.
  36 
  37     The program is called with a single argument: the path to a file
  38     containing a temporary config.xml file the zone.  It should return 0
  39     on success and non-0 on failure.  Any detailed error messages should be
  40     displayed to stderr.
  41 
  42     It has no attributes.
  43 
  44 -->
  45 <!ELEMENT verify_cfg (#PCDATA) >
  46 <!ATTLIST verify_cfg>
  47 <!--


 151     also be able to gracefully handle the case where resources that it
 152     expects to release are not actually allocated (or have been already
 153     released.)
 154 
 155     If this programs succeeds it should not generate any output.  If this
 156     program returns an error, any output generated by the program will be
 157     sent to the zoneadmd message log.
 158 
 159     The following replacements are performed:
 160 
 161       %z        Name of zone
 162       %R        Zonepath of zone
 163       Additional arguments, if any, are appended.
 164 
 165     It has no attributes.
 166 -->
 167 <!ELEMENT halt       (#PCDATA) >
 168 <!ATTLIST halt>
 169 
 170 <!--
 171   shutdown
 172 
 173     This is a program which gets run by zoneadmd when a zone is being
 174     shutdown gracefully. Currently only asynchronous mode is supported.
 175 
 176     If this program succeeds it should not generate any output. If this
 177     program returns an error, any output generated by the program will be
 178     sent to the zoneadmd message log.
 179 
 180     The following replacements are performed:
 181 
 182       %z        Name of zone
 183       %R        Zonepath of zone
 184       Additional arguments, if any, are appended.
 185 
 186     It has no attributes.
 187 -->
 188 <!ELEMENT shutdown   (#PCDATA) >
 189 <!ATTLIST shutdown>
 190 
 191 <!--
 192   modname
 193 
 194     Path to the kernel module that implements the kernel-level
 195     functionality of the brand.
 196 
 197     It has no attributes.
 198 -->
 199 <!ELEMENT modname    (#PCDATA) >
 200 <!ATTLIST modname>
 201 
 202 <!--
 203   initname
 204 
 205     Path to the initial executable that should be launched when booting a
 206     branded zone.
 207 
 208     It has no attributes.
 209 -->
 210 <!ELEMENT initname   (#PCDATA) >
 211 <!ATTLIST initname>


 613 
 614 -->
 615 <!ELEMENT privilege  (#PCDATA) >
 616 <!ATTLIST privilege  set     ( default | prohibited | required ) #REQUIRED 
 617                         name    CDATA #REQUIRED
 618                         ip-type ( shared | exclusive ) "all" >
 619 
 620 <!--
 621   brand
 622 
 623     The toplevel container for a brand configuration.
 624 
 625     Its attributes are
 626 
 627       name      The name of the brand.  This must match the name of the
 628                 directory in which the configuration file is stored.
 629 -->
 630 
 631 <!ELEMENT brand              (modname?, initname, login_cmd, forcedlogin_cmd,
 632                         user_cmd, install,
 633                         installopts?, boot?, sysboot?, halt?, shutdown?,
 634                         verify_cfg?, verify_adm?, postattach?, postclone?,
 635                         postinstall?, predetach?, attach?, detach?, clone?,
 636                         presnap?, postsnap?, validatesnap?,
 637                         preuninstall?, uninstall?,
 638                         prestatechange?, poststatechange?, query?,
 639                         privilege+)>
 640 
 641 <!ATTLIST brand              name            CDATA #REQUIRED>