xref: /illumos-gate/usr/src/lib/libbrand/dtd/zone_platform.dtd.1 (revision 2b24ab6b3865caeede9eeb9db6b83e1d89dcd1ea)
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>
154