Debian Codegraph @

src/vendor/azure-uamqp-c/uamqp_generator/amqp_definitions.dtd

raw
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <!--
4 Copyright OASIS Open 2012. All Rights Reserved.
5
6
7 All capitalized terms in the following text have the meanings assigned to them in the OASIS
8 Intellectual Property Rights Policy (the "OASIS IPR Policy"). The full Policy may be found at the
9 OASIS website.
10
11
12 This document and translations of it may be copied and furnished to others, and derivative works
13 that comment on or otherwise explain it or assist in its implementation may be prepared, copied,
14 published, and distributed, in whole or in part, without restriction of any kind, provided that
15 the above copyright notice and this section are included on all such copies and derivative works.
16 However, this document itself may not be modified in any way, including by removing the copyright
17 notice or references to OASIS, except as needed for the purpose of developing any document or
18 deliverable produced by an OASIS Technical Committee (in which case the rules applicable to
19 copyrights, as set forth in the OASIS IPR Policy, must be followed) or as required to translate
20 it into languages other than English.
21
22
23 The limited permissions granted above are perpetual and will not be revoked by OASIS or its
24 successors or assigns.
25
26
27 This document and the information contained herein is provided on an "AS IS" basis and OASIS
28 DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE
29 USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF
30 MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
31
32
33 OASIS requests that any OASIS Party or any other party that believes it has patent claims that
34 would necessarily be infringed by implementations of this OASIS Committee Specification or OASIS
35 Standard, to notify OASIS TC Administrator and provide an indication of its willingness to grant
36 patent licenses to such patent claims in a manner consistent with the IPR Mode of the OASIS
37 Technical Committee that produced this specification.
38
39
40 OASIS invites any party to contact the OASIS TC Administrator if it is aware of a claim of
41 ownership of any patent claims that would necessarily be infringed by implementations of this
42 specification by a patent holder that is not willing to provide a license to such patent claims in
43 a manner consistent with the IPR Mode of the OASIS Technical Committee that produced this
44 specification. OASIS may include such claims on its website, but disclaims any obligation to do
45 so.
46
47
48 OASIS takes no position regarding the validity or scope of any intellectual property or other
49 rights that might be claimed to pertain to the implementation or use of the technology described
50 in this document or the extent to which any license under such rights might or might not be
51 available; neither does it represent that it has made any effort to identify any such rights.
52 Information on OASIS' procedures with respect to rights in any document or deliverable produced
53 by an OASIS Technical Committee can be found on the OASIS website. Copies of claims of rights
54 made available for publication and any assurances of licenses to be made available, or the result
55 of an attempt made to obtain a general license or permission for the use of such proprietary
56 rights by implementers or users of this OASIS Committee Specification or OASIS Standard, can be
57 obtained from the OASIS TC Administrator. OASIS makes no representation that any information or
58 list of intellectual property rights will at any time be complete, or that any claims in such list
59 are, in fact, Essential Claims.
60
61
62 The name "OASIS" is a trademark of OASIS, the owner and developer of this specification, and
63 should be used only to refer to the organization and its official outputs. OASIS welcomes
64 reference to, and implementation and use of, specifications, while reserving the right to enforce
65 its marks against misleading uses. Please see http://www.oasis-open.org/who/trademark.php for above guidance.
66 -->
67
68 <!-- The AMQP specification is defined by a collection of XML source
69 files each conforming to the DTD defined below. Each file
70 specifies a distinct "part" of the specification.
71 -->
72
73 <!-- The amqp element is the root element for each source file and
74 thus identifies a distinct part of the AMQP specification. The
75 amqp element may contain any number of doc or section elements
76 and has the following attributes:
77
78 name - The name of the part of the specification defined within
79 this element.
80 label - A short label for the part of the specication defined
81 within this element
82 -->
83 <!ELEMENT amqp (doc|section)*>
84 <!ATTLIST amqp
85 xmlns CDATA #IMPLIED
86 name CDATA #REQUIRED
87 label CDATA #IMPLIED
88 >
89
90 <!-- The section element identifies a section within a part of the
91 AMQP specification. Sections provide a logical grouping of
92 content and definitions within a part of the specification. The
93 section element may contain any number of doc, definition, or
94 type elements and has the following attributes:
95
96 name - The name of the section.
97 title - A title for the section.
98 label - A short label for the section.
99 -->
100 <!ELEMENT section (doc|definition|type)*>
101 <!ATTLIST section
102 name CDATA #REQUIRED
103 title CDATA #IMPLIED
104 label CDATA #IMPLIED
105 >
106
107 <!-- The definition element formally defines a named constant. The
108 definition element may contain any number of doc elements and has
109 the following attributes:
110
111 name - The name of the constant.
112 value - The value of the constant.
113 label - A short label for the constant.
114 -->
115 <!ELEMENT definition (doc)*>
116 <!ATTLIST definition
117 name CDATA #REQUIRED
118 value CDATA #REQUIRED
119 label CDATA #IMPLIED
120 >
121
122 <!-- The type element formally defines a semantic type used to
123 exchange data on the wire. Every type definition may have the
124 following attributes:
125
126 name - The name of the type.
127 label - A short description of the type.
128 class - A string identifying what class of type is being
129 defined.
130 provides - A comma separated list of archetypes (see field
131 element).
132
133 There are four different classes of types identified by the
134 "class" attribute: primitive, composite, restricted, and union.
135 All classes of types may contain doc elements.
136
137 A "primitive" type will contain one or more encoding elements
138 that describe how the data is formatted on the wire. Primitive
139 types do not contain descriptor, field, or choice elements.
140
141 A "composite" type definition specifies a new kind of record
142 type, i.e. a type composed of a fixed number of fields whose
143 values are each of a specific type. A composite type does not
144 have a new encoding, but is sent on the wire as a list annotated
145 by a specific descriptor value that identifies it as a
146 representation of the defined composite type. A composite type
147 definition will contain a descriptor and zero or more field
148 elements. Composite types do not contain encoding or choice
149 elements. The source attribute of a composite type will always be
150 "list", other values are reserved for future use.
151
152 A "restricted" type definition specifies a new kind of type whose
153 values are restricted to a subset of the values that may be
154 represented with another type. The source attribute identifies
155 the base type from which a restricted type is derived. A
156 restricted type may have a descriptor element in which case it is
157 identified by a descriptor on the wire. The values permitted by a
158 restricted type may be specified either via documentation, or
159 directly limited to a fixed number of values by the choice
160 elements contained within the definition.
161
162 The "union" class of types is currently reserved.
163 -->
164 <!ELEMENT type (encoding|descriptor|field|choice|doc)*>
165 <!ATTLIST type
166 name CDATA #REQUIRED
167 class (primitive|composite|restricted|union) #REQUIRED
168 source CDATA #IMPLIED
169 provides CDATA #IMPLIED
170 label CDATA #IMPLIED
171 >
172
173 <!-- The encoding element defines how a primitive type is encoded. The
174 specification defines 4 general categories of encodings: fixed,
175 variable, compound, or array. A specific encoding provides
176 further details of how data is formatted within its general
177 category.
178
179 name - The name of the encoding.
180 label - A short description of the encoding.
181 code - The numeric value that prefixes the encoded data on
182 the wire.
183 category - The category of the encoding: "fixed", "variable",
184 "compound", or "array".
185 width - The width of the encoding or the size/count
186 prefixes depending on the category.
187 -->
188 <!ELEMENT encoding (doc)*>
189 <!ATTLIST encoding
190 name CDATA #IMPLIED
191 label CDATA #IMPLIED
192 code CDATA #REQUIRED
193 category (fixed|variable|compound|array) #REQUIRED
194 width CDATA #IMPLIED
195 >
196
197 <!-- The descriptor element specifies what annotation is used to
198 identify encoded values as representations of a described type.
199
200 name - A symbolic name for the representation.
201 code - The numeric value.
202 -->
203 <!ELEMENT descriptor (doc)*>
204 <!ATTLIST descriptor
205 name CDATA #IMPLIED
206 code CDATA #IMPLIED
207 >
208
209 <!-- The field element identifies a field within a composite type.
210 Every field has the following attributes:
211
212 name - A symbolic name that uniquely identifies the field
213 within the type.
214 type - The type of the field. This attribute defines the
215 range of values that are permitted to appear in
216 this field. It may name a specific type, in which
217 case the values are restricted to that type, or it
218 may be the special character "*", in which case a
219 value of any type is permitted. In the latter case
220 the range of values may be further restricted by
221 the requires attribute.
222 requires - A comma separated list of archetypes. Field values
223 are restricted to types providing at least one of
224 the specified archetypes.
225 default - A default value for the field if no value is encoded.
226 label - A short description of the field.
227 mandatory - "true" iff a non null value for the field is always encoded.
228 multiple - "true" iff the field may have multiple values of its specified type.
229 -->
230 <!ELEMENT field (doc)*>
231 <!ATTLIST field
232 name CDATA #REQUIRED
233 type CDATA #IMPLIED
234 requires CDATA #IMPLIED
235 default CDATA #IMPLIED
236 label CDATA #IMPLIED
237 mandatory CDATA #IMPLIED
238 multiple CDATA #IMPLIED
239 >
240
241 <!-- The choice element identifies a legal value for a restricted
242 type. The choice element has the following attributes:
243
244 name - A symbolic name for the value.
245 value - The permitted value.
246 -->
247 <!ELEMENT choice (doc)*>
248 <!ATTLIST choice
249 name CDATA #REQUIRED
250 value CDATA #REQUIRED
251 >
252
253 <!-- The doc element identifies the basic unit of documentation that
254 may appear at nearly any point within the specification. A doc
255 element may optionally have a symbolic name and a title for cross
256 reference:
257
258 name - The symbolic name of the doc element.
259 title - The title of the doc element.
260
261 A doc element may contain any number of the following
262 presentational sub elements:
263
264 doc - nested doc elements
265 p - paragraphs
266 ul - unordered lists
267 ol - ordered lists
268 dl - definition lists
269 picture - preformatted ascii art diagrams
270 -->
271
272 <!ELEMENT doc (doc|p|ul|ol|dl|picture)*>
273 <!ATTLIST doc
274 name CDATA #IMPLIED
275 title CDATA #IMPLIED
276 >
277
278 <!-- A paragraph element may be optionally titled and contains
279 freeform text with the following markup elements:
280
281 anchor - a reference point
282 xref - a cross reference
283 b - bold text
284 i - italic text
285 term - a formal term
286 sup - superscript
287 sub - subscript
288 br - line break
289 -->
290 <!ELEMENT p (#PCDATA|anchor|xref|b|i|term|sup|sub|br)*>
291 <!ATTLIST p
292 title CDATA #IMPLIED
293 >
294
295 <!-- A cross reference. -->
296 <!ELEMENT xref (#PCDATA)>
297 <!ATTLIST xref
298 type CDATA #IMPLIED
299 name CDATA #REQUIRED
300 choice CDATA #IMPLIED
301 >
302
303 <!-- A reference point. -->
304 <!ELEMENT anchor (#PCDATA)>
305 <!ATTLIST anchor
306 name CDATA #REQUIRED
307 >
308
309 <!-- A line break. -->
310 <!ELEMENT br EMPTY>
311
312 <!-- A span of boldface markup. -->
313 <!ELEMENT b (#PCDATA|sub|sup|i|br|anchor)*>
314 <!-- A span of italic markup. -->
315 <!ELEMENT i (#PCDATA|sub|sup|b|br|anchor)*>
316 <!-- A formal term. -->
317 <!ELEMENT term (#PCDATA)>
318 <!-- A span of superscript markup. -->
319 <!ELEMENT sup (#PCDATA|sup|sub|b|i)*>
320 <!-- A span of subscript markup. -->
321 <!ELEMENT sub (#PCDATA|sup|sub|b|i)*>
322
323 <!-- An unordered list. -->
324 <!ELEMENT ul (li)*>
325 <!ATTLIST ul
326 title CDATA #IMPLIED
327 >
328 <!-- An ordered list. -->
329 <!ELEMENT ol (li)*>
330 <!ATTLIST ol
331 title CDATA #IMPLIED
332 >
333
334 <!-- An item in an ordered or unordered list. -->
335 <!ELEMENT li (#PCDATA|p|ul|dl)*>
336
337 <!-- A definition list. -->
338 <!ELEMENT dl (dt, dd)*>
339 <!ATTLIST dl
340 title CDATA #IMPLIED
341 >
342 <!-- A definition term. -->
343 <!ELEMENT dt (#PCDATA)>
344 <!-- A definition description -->
345 <!ELEMENT dd (p|picture|ul|ol)*>
346
347 <!-- A preformatted ascii art diagram. -->
348 <!ELEMENT picture (#PCDATA)>
349 <!ATTLIST picture
350 title CDATA #IMPLIED
351 >