usr/src/lib/libbrand/dtd/zone_platform.dtd.1

   1 <?xml version='1.0' encoding='UTF-8' ?>
   2
   3 <!--
   4  CDDL HEADER START
   5
   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 2007 Sun Microsystems, Inc.  All rights reserved.
  24  Use is subject to license terms.
  25
  26  ident  "%Z%%M% %I%     %E% SMI"
  27
  28  DO NOT EDIT THIS FILE.
  29 -->
  30
  31 <!--
  32   device
  33
  34     Defines a device (or set of devices) to be exported into the zone.
  35
  36     Its attributes are
  37
  38       match     Pattern to match under /dev.  Follows fnmatch(3c) rules.
  39                 The following replacements are performed:
  40                         %z      Name of zone
  41
  42       name      Name of device in non-global zone.  This is optional; the
  43                 default is the same name as the global zone.
  44
  45       arch      Identifies devices only available for certain architectures.
  46                 Can be "sparc" or "i386".
  47
  48       ip-type   Optional, identifies devices only available for certain IP
  49                 types. Can be "shared" or "exclusive". If it's not specified,
  50                 the default value "all" will be used, which means it's
  51                 available regardless the IP type.
  52
  53     For example, the following entry:
  54         <device match="brand/windows/foo" name="bar" arch="sparc" />
  55     would result in mapping the following global zone device:
  56         /dev/brand/windows/foo
  57     into the zone (disregarding its IP type) as:
  58         /dev/bar
  59     but the mapping would only exist on sparc machines.
  60
  61 -->
  62 <!ELEMENT device        EMPTY >
  63
  64 <!ATTLIST device        match   CDATA #REQUIRED
  65                         name    CDATA ""
  66                         arch    ( sparc | i386 ) "all"
  67                         ip-type ( shared | exclusive ) "all" >
  68
  69 <!--
  70   symlink
  71
  72     Defines a symlink to be created under /dev.
  73
  74     Its attributes are
  75
  76       source    Link source
  77
  78       target    Link target
  79 -->
  80 <!ELEMENT symlink       EMPTY >
  81
  82 <!ATTLIST symlink       source  CDATA #REQUIRED
  83                         target  CDATA #REQUIRED >
  84
  85 <!--
  86   global_mount
  87
  88     Describes a filesystem that must be mounted before the zone is booted.
  89     This mount is performed by a thread executing in the the context of
  90     the global zone.
  91
  92     Its attributes are
  93
  94       special   The special device as used by the mount command.
  95                 This path is relative to the global zone.
  96                 The following replacements are performed:
  97                         %R      Root of zone
  98
  99       directory The directory where it will be mounted.
 100                 This path is relative to the non-global zone.
 101
 102       type      The filesystem type
 103 -->
 104 <!ELEMENT global_mount  EMPTY >
 105
 106 <!ATTLIST global_mount  special         CDATA #REQUIRED
 107                         directory       CDATA #REQUIRED
 108                         opt             CDATA ""
 109                         type            CDATA #REQUIRED>
 110
 111 <!--
 112   mount
 113
 114     Describes a filesystem that must be mounted before the zone is booted.
 115     This mount is performed by a thread executing in the the context of
 116     the non-global zone.
 117
 118     Its attributes are
 119
 120       special   The special device as used by the mount command
 121                 This path is relative to the non-global zone.
 122
 123       directory The directory where it will be mounted.
 124                 This path is relative to the non-global zone.
 125
 126       type      The filesystem type
 127 -->
 128 <!ELEMENT mount EMPTY >
 129
 130 <!ATTLIST mount special         CDATA #REQUIRED
 131                                 directory       CDATA #REQUIRED
 132                                 opt             CDATA ""
 133                                 type            CDATA #REQUIRED>
 134
 135 <!--
 136   platform
 137
 138     The toplevel container for a virtual platform configuration.  The virtual
 139     platform describes the basic elements to bring up the necessary services
 140     (filesystems, devices, etc) to boot the zone.
 141
 142     Its attributes are
 143
 144       name      The name of the brand.  This must match the name of the
 145                 directory in which this file is stored, as well as the name
 146                 of the brand that refers to it.
 147       allow-exclusive-ip        Whether the zones of this brand can have their
 148                                 own exclusive IP stack. It is a boolean value.
 149 -->
 150 <!ELEMENT platform      (device | global_mount | mount | symlink)* >
 151
 152 <!ATTLIST platform      name                    CDATA #REQUIRED
 153                         allow-exclusive-ip      (true | false) #REQUIRED>