One document matched: draft-legg-xed-asd-xerei-02.txt
Differences from draft-legg-xed-asd-xerei-01.txt
INTERNET-DRAFT S. Legg
draft-legg-xed-asd-xerei-02.txt eB2Bcom
Intended Category: Standards Track October 20, 2006
Abstract Syntax Notation X (ASN.X) Representation
of Encoding Instructions for
the XML Encoding Rules (XER)
Copyright (C) The Internet Society (2006).
Status of This Memo
By submitting this Internet-draft, each author represents that any
applicable patent or other IPR claims of which he or she is aware
have been or will be disclosed, and any of which he or she becomes
aware will be disclosed, in accordance with Section 6 of BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that
other groups may also distribute working documents as
Internet-Drafts.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress".
The list of current Internet-Drafts can be accessed at
http://www.ietf.org/1id-abstracts.html
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html
Technical discussion of this document should take place on the XED
developers mailing list <xeddev@eb2bcom.com>. Please send editorial
comments directly to the editor <steven.legg@eb2bcom.com>. Further
information is available on the XED website: www.xmled.info.
This Internet-Draft expires on 20 April 2007.
Abstract
Abstract Syntax Notation X (ASN.X) is an Extensible Markup Language
(XML) representation for Abstract Syntax Notation One (ASN.1)
specifications. This document specifies the ASN.X representation of
encoding instructions for the XML Encoding Rules (XER).
Legg Expires 20 April 2007 [Page 1]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
Table of Contents
1. Introduction ....................................................2
2. Conventions .....................................................3
3. Preprocessing of ImportedTypesIdentification ....................4
4. EncodingInstructionAssignmentList Translation ...................4
5. EncodingInstruction Translation .................................5
5.1. AnyAttributesInstruction Translation .......................6
5.1.1. NamespaceRestriction Translation ....................7
5.2. AnyElementInstruction Translation ..........................7
5.3. AttributeInstruction Translation ...........................7
5.4. Base64Instruction Translation ..............................7
5.5. DecimalInstruction Translation .............................8
5.6. DefaultForEmptyInstruction Translation .....................8
5.7. ElementInstruction Translation .............................8
5.8. EmbedValuesInstruction Translation .........................8
5.9. GlobalDefaultsInstruction Translation ......................8
5.10. ListInstruction Translation ...............................9
5.11. NameInstruction Translation ...............................9
5.12. NamespaceInstruction Translation .........................10
5.13. PIOrCommentInstruction Translation .......................10
5.14. TextInstruction Translation ..............................11
5.15. UntaggedInstruction Translation ..........................11
5.16. UseNilInstruction Translation ............................11
5.17. UseNumberInstruction Translation .........................11
5.18. UseOrderInstruction Translation ..........................11
5.19. UseQNameInstruction Translation ..........................12
5.20. UseTypeInstruction Translation ...........................12
5.21. UseUnionInstruction Translation ..........................12
5.22. WhiteSpaceInstruction Translation ........................12
6. TargetList Translation .........................................12
6.1. TypeIdentification Translation ............................13
6.2. BuiltInTypeIdentification Translation .....................14
6.3. IdentifiersInContext Translation ..........................16
7. Security Considerations ........................................17
8. IANA Considerations ............................................18
9. References .....................................................18
9.1. Normative References ......................................18
9.2. Informative References ....................................19
Appendix A. ASN.1 for XER Encoding Instruction Notation ...........19
Appendix B. ASN.1 for Target List Notation ........................23
Appendix C. ASN.X for XER Encoding Instruction Notation ...........25
Appendix D. ASN.X for Target List Notation ........................32
1. Introduction
Abstract Syntax Notation X (ASN.X) [ASN.X] is an Extensible Markup
Language (XML) [XML10][XML11] representation for Abstract Syntax
Legg Expires 20 April 2007 [Page 2]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
Notation One (ASN.1) [X.680] specifications. The ASN.X
representation for the ASN.1 basic notation [X.680] [X.680-1] is
described elsewhere [ASN.X].
The grammar of ASN.1 also permits the application of encoding
instructions [X.680-1], through type prefixes and encoding control
sections, that modify how abstract values are encoded by nominated
encoding rules.
The generic notation for type prefixes and encoding control sections
is defined by the ASN.1 basic notation, however the notation for
specific encoding instructions i.e., the EncodingInstruction and
EncodingInstructionAssignmentList productions of the notation, are
defined separately for each set of encoding rules using encoding
instructions. This document specifies the ASN.X representation for
EncodingInstructionAssignmentList and EncodingInstruction as they are
defined for the XML Encoding Rules (XER) [X.693][X.693-1].
ASN.X is defined in terms of rules for translating from an ASN.1
specification. This does not preclude an ASN.X document being
written directly without a pre-existing ASN.1 specification, however
such an ASN.X document is considered valid if and only if there
exists, in principle, an ASN.1 specification that when translated
would yield the ASN.X document.
By design, an ASN.X document is also the Robust XML Encoding Rules
(RXER) [RXER] encoding of an ASN.1 abstract value. The ASN.1 type
definitions for such abstract values, insofar as they pertain to the
ASN.1 basic notation, are provided elsewhere [ASN.X], however this
document provides the ASN.1 type definitions for representing XER
encoding instructions as abstract values. These definitions appear
in Appendix A.
The ASN.X translation of the ASN.1 module in Appendix A is presented
in Appendix B.
The General Considerations of the specification for ASN.X [ASN.X]
also apply here.
2. Conventions
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED" and "MAY" in this document are
to be interpreted as described in, BCP 14, RFC 2119 [BCP14]. The key
word "OPTIONAL" is exclusively used with its ASN.1 meaning.
A reference to an ASN.1 production [X.680] (e.g., Type, NamedType) is
a reference to the text in an ASN.1 specification corresponding to
Legg Expires 20 April 2007 [Page 3]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
that production.
The description of the translation of XER encoding instructions into
ASN.X makes use of definitions from the XML Information Set (Infoset)
[ISET]. In particular, information item property names follow the
Infoset convention of being shown in square brackets, e.g.,
[local name]. In the sections that follow, "information item" will
be abbreviated to "item", e.g., "element information item" is
abbreviated to "element item". Element items will be referred to by
their [local name] in angle brackets, e.g., "the <name> element item"
means the element item with the [local name] "name". Attribute items
will be referred to by their [local name], e.g., "the name attribute
item" means the attribute item with the [local name] "name".
Code points for characters [UNICODE] are expressed using the Unicode
convention U+n, where n is four to six hexadecimal digits, e.g., the
space character is U+0020.
3. Preprocessing of ImportedTypesIdentification
Interpretation of an ImportedTypesIdentification depends on a
SymbolList in the Imports of a module, but a SymbolList does not have
a direct translation into ASN.X. A module containing an
ImportedTypesIdentification must be preprocessed so that each
ImportedTypesIdentification has the intended effect.
If an EncodingInstruction in an XER EncodingInstructionAssignmentList
has a Targets that is an ImportedTypesIdentification then each Type
affected by the ImportedTypesIdentification MUST be replaced by an
EncodingPrefixedType where the Type in the EncodingPrefixedType is
the original Type and the EncodingPrefix contains the
EncodingInstruction minus the TargetList. The
ImportedTypesIdentification SHALL be removed. If the
EncodingInstruction in the EncodingInstructionAssignmentList has no
other Targets then it MUST be removed from the
EncodingInstructionAssignmentList.
4. EncodingInstructionAssignmentList Translation
As described in the specification for ASN.X [ASN.X], the translation
of an EncodingControlSection for XER is an element item with the
[local name] "XER". The translation of the
EncodingInstructionAssignmentList in such an EncodingControlSection
determines the content of the <XER> element item.
An element item with the [local name] "annotation" MAY be added to
the [children] of the <XER> element item.
Legg Expires 20 April 2007 [Page 4]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
The translation of each EncodingInstruction in the
EncodingInstructionAssignmentList SHALL be appended to the [children]
of the <XER> element item.
5. EncodingInstruction Translation
The translation of an EncodingInstruction for XER can appear in the
translation of an EncodingInstructionAssignmentList (see the previous
section) or an EncodingPrefix. The translation for an EncodingPrefix
is described by the specification for ASN.X [ASN.X].
The translation of an EncodingInstruction in an
EncodingInstructionAssignmentList for XER is an element with the
[local name] "targettedInstruction". The translation of the
PositiveInstruction or NegatingInstruction in the EncodingInstruction
SHALL be added to the [children] of the <targettedInstruction>
element item. The translation of the TargetList within the encoding
instruction SHALL be appended to the [children] of the
<targettedInstruction> element item.
Aside: The TargetList appears within an EncodingInstruction in an
EncodingInstructionAssignmentList, but its ASN.X translation
appears immediately after the translation of the
EncodingInstruction rather than within it.
Example
ENCODING-CONTROL XER
GLOBAL-DEFAULTS MODIFIED-ENCODINGS
ATTRIBUTE MyType
<encodingControls>
<XER>
<targettedInstruction>
<globalDefaults>
<modifiedEncodings/>
</globalDefaults>
</targettedInstruction>
<targettedInstruction>
<attribute/>
<target type="MyType"/>
</targettedInstruction>
</XER>
</encodingControls>
The translation of an EncodingInstruction for XER in an
EncodingPrefix is the translation of the contained
PositiveInstruction or NegatingInstruction.
Legg Expires 20 April 2007 [Page 5]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
Aside: The TargetList within an EncodingInstruction in an
EncodingPrefix is required to be empty and has no ASN.X
translation in this context.
The translation of a PositiveInstruction is the translation of the
contained AnyAttributeInstruction, AnyElementInstruction,
AttributeInstruction, Base64Instruction, DecimalInstruction,
DefaultForEmptyInstruction, EmbedValuesInstruction,
GlobalDefaultsInstruction, ListInstruction, NameInstruction,
NamespaceInstruction, PIOrCommentInstruction, TextInstruction,
UntaggedInstruction, UseNilInstruction, UseNumberInstruction,
UseOrderInstruction, UseQNameInstruction, UseTypeInstruction,
UseUnionInstruction or WhitespaceInstruction.
The translation of a NegatingInstruction that is an
ElementInstruction is the translation of that ElementInstruction.
The translation of a NegatingInstruction that is not an
ElementInstruction is an element item where the [local name] is the
concatenation of "not-" and the [local name] that would be used by
the translation of the PositiveInstruction in the
NegatingInstruction. No items are added to the [attributes] or
[children] of the element item resulting from the translation of a
NegatingInstruction.
Example
[XER:NOT ATTRIBUTE] MyType
<type>
<prefixed>
<XER><not-attribute/></XER>
<type ref="MyType"/>
</prefixed>
</type>
5.1. AnyAttributesInstruction Translation
The translation of an AnyAttributesInstruction is an element item
with the [local name] "anyAttributes". If a NamespaceRestriction is
present, then the translation of the NamespaceRestriction is added to
the [children] of the <anyAttributes> element item.
Example
ANY-ATTRIBUTES FROM "http://example.com" ABSENT
<anyAttributes>
Legg Expires 20 April 2007 [Page 6]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
<namespace>http://example.com</namespace>
<local/>
</anyAttributes>
5.1.1. NamespaceRestriction Translation
The NamespaceRestriction production is common to
AnyAttributesInstruction and AnyElementInstruction.
The translation of a NamespaceRestriction of the "FROM URIList" form
is an element item with the [local name] "from". The translation of
each QuotedURIorAbsent in the URIList is appended to the [children]
of the <from> element item.
The translation of a NamespaceRestriction of the "EXCEPT URIList"
form is an element item with the [local name] "except". The
translation of each QuotedURIorAbsent in the URIList is appended to
the [children] of the <except> element item.
The translation of a QuotedURIorAbsent that is a QuotedURI is an
element item with the [local name] "namespace". The sequence of
character items for the URI in the QuotedURI is added to the
[children] of the <namespace> element item.
The translation of a QuotedURIorAbsent of the "ABSENT" form is an
element item with the [local name] "local".
5.2. AnyElementInstruction Translation
The translation of an AnyElementInstruction is an element item with
the [local name] "anyElement". If a NamespaceRestriction is present,
then the translation of the NamespaceRestriction is added to the
[children] of the <anyElement> element item.
5.3. AttributeInstruction Translation
The translation of an AttributeInstruction is an element item with
the [local name] "attribute".
Example
ATTRIBUTE
<attribute/>
5.4. Base64Instruction Translation
The translation of a Base64Instruction is an element item with the
Legg Expires 20 April 2007 [Page 7]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
[local name] "base64".
5.5. DecimalInstruction Translation
The translation of a DecimalInstruction is an element item with the
[local name] "decimal".
5.6. DefaultForEmptyInstruction Translation
The translation of a DefaultForEmptyInstruction is an element item
with the [local name] "defaultForEmpty". The translation of the
Value in the DefaultForEmptyInstruction SHALL be added to the
[children] or [attributes] of the <defaultForEmpty> element item.
Example
DEFAULT-FOR-EMPTY AS "unspecified"
<defaultForEmpty literalValue="unspecified"/>
5.7. ElementInstruction Translation
The translation of an ElementInstruction is an element item with the
[local name] "element".
5.8. EmbedValuesInstruction Translation
The translation of an EmbedValuesInstruction is an element item with
the [local name] "embedValues".
5.9. GlobalDefaultsInstruction Translation
The translation of a GlobalDefaultsInstruction is an element item
with the [local name] "globalDefaults".
If the DefaultSetting in the GlobalDefaultsInstruction is "MODIFIED-
ENCODINGS", then an element item with the [local name]
"modifiedEncodings" SHALL be added to the [children] of the
<globalDefaults> element item.
If the DefaultSetting in the GlobalDefaultsInstruction is a
ControlNamespace, then the translation of the ControlNamespace SHALL
be added to the [children] of the <globalDefaults> element item.
The translation of a ControlNamespace is an element item with the
[local name] "controlNamespace". An attribute item with the
[local name] "name" SHALL be added to the [attributes] of the
<controlNamespace> element item. The [normalized value] of this
Legg Expires 20 April 2007 [Page 8]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
attribute item is the Uniform Resource Identifier (URI) [URI] in the
QuotedURI in the ControlNamespace. If the ControlNamespace contains
a Prefix, then an attribute item with the [local name] "prefix" SHALL
be added to the [attributes] of the <controlNamespace> element item.
The [normalized value] of this attribute item is the NCName in the
QuotedNCName in the Prefix.
Example
GLOBAL-DEFAULTS
CONTROL-NAMESPACE "http://example.com" PREFIX "ex"
<globalDefaults>
<controlNamespace name="http://example.com" prefix="ex"/>
</globalDefaults>
5.10. ListInstruction Translation
The translation of a ListInstruction is an element item with the
[local name] "list".
5.11. NameInstruction Translation
The translation of a NameInstruction is an element item with the
[local name] "name".
If the NewNameOrKeyword in the NameInstruction is a NewName, then an
attribute item with the [local name] "newName" SHALL be added to the
[attributes] of the <name> element item. The [normalized value] of
this attribute item is the character string value of the NewName.
If the NewNameOrKeyword in the NameInstruction is a Keyword, then an
attribute item with the [local name] "conversion" SHALL be added to
the [attributes] of the <name> element item. The [normalized value]
of this attribute item is the keyword in the Keyword with all letters
downcased, i.e., "capitalized", "uncapitalized", "uppercased" or
"lowercased".
Example
NAME AS UNCAPITALIZED
<name conversion="uncapitalized"/>
NAME AS "category"
<name newName="category"/>
Legg Expires 20 April 2007 [Page 9]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
5.12. NamespaceInstruction Translation
The translation of a NamespaceInstruction is an element item with the
[local name] "namespace".
If a NamespaceSpecification is present, then an attribute item with
the [local name] "name" SHALL be added to the [attributes] of the
<namespace> element item. The [normalized value] of this attribute
item is the URI in the QuotedURI in the NamespaceSpecification.
If a Prefix is present in the NamespaceSpecification, then an
attribute item with the [local name] "prefix" SHALL be added to the
[attributes] of the <namespace> element item. The [normalized value]
of this attribute item is the NCName in the QuotedNCName in the
Prefix.
Example
NAMESPACE AS "http://example.com" PREFIX "ex"
<namespace name="http://example.com" prefix="ex"/>
5.13. PIOrCommentInstruction Translation
The translation of a PIOrCommentInstruction is an element item with
the [local name] "piOrComment".
An attribute item with the [local name] "text" SHALL be added to the
[attributes] of the <piOrComment> element item. The
[normalized value] of this attribute item is the character string
value of the RestrictedCharacterStringValue in the
PIOrCommentInstruction.
An attribute item with the [local name] "position" SHALL be added to
the [attributes] of the <piOrComment> element item. The
[normalized value] of this attribute item is "beforeTag" if the
keyword in the Position in the PIOrCommentInstruction is BEFORE-TAG,
"beforeValue" if the keyword in the Position is BEFORE-VALUE,
"afterTag" if the keyword in the Position is AFTER-TAG, or
"afterValue" if the keyword in the Position is AFTER-VALUE.
Example
PI-OR-COMMENT AS "<!-- This is a comment. -->" BEFORE-TAG
<piOrComment text="<!-- This is a comment. -->"
position="beforeTag"/>
Legg Expires 20 April 2007 [Page 10]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
5.14. TextInstruction Translation
The translation of a TextInstruction is an element item with the
[local name] "text".
If a TextToBeUsed is present in the TextInstruction and the
NewNameOrKeyword in the TextToBeUsed is a NewName, then an attribute
item with the [local name] "newName" SHALL be added to the
[attributes] of the <text> element item. The [normalized value] of
this attribute item is the character string value of the NewName.
If a TextToBeUsed is present in the TextInstruction and the
NewNameOrKeyword in the TextToBeUsed is a Keyword, then an attribute
item with the [local name] "conversion" SHALL be added to the
[attributes] of the <name> element item. The [normalized value] of
this attribute item is the keyword in the Keyword with all letters
downcased, i.e., "capitalized", "uncapitalized", "uppercased" or
"lowercased".
Examples
TEXT AS UPPERCASED
<text conversion="uppercased"/>
TEXT AS "A4"
<text newName="A4"/>
5.15. UntaggedInstruction Translation
The translation of an UntaggedInstruction is an element item with the
[local name] "untagged".
5.16. UseNilInstruction Translation
The translation of a UseNilInstruction is an element item with the
[local name] "useNil".
5.17. UseNumberInstruction Translation
The translation of a UseNumberInstruction is an element item with the
[local name] "useNumber".
5.18. UseOrderInstruction Translation
The translation of a UseOrderInstruction is an element item with the
[local name] "useOrder".
Legg Expires 20 April 2007 [Page 11]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
5.19. UseQNameInstruction Translation
The translation of a UseQNameInstruction is an element item with the
[local name] "useQName".
5.20. UseTypeInstruction Translation
The translation of a UseTypeInstruction is an element item with the
[local name] "useType".
5.21. UseUnionInstruction Translation
The translation of a UseUnionInstruction is an element item with the
[local name] "useUnion".
5.22. WhiteSpaceInstruction Translation
The translation of a WhiteSpaceInstruction is an element item with
the [local name] "whiteSpace".
If a WhiteSpaceAction is present in the WhiteSpaceInstruction, then
An attribute item with the [local name] "action" SHALL be added to
the [attributes] of the <whiteSpace> element item. The
[normalized value] of this attribute item is the keyword in the
WhiteSpaceAction in the WhiteSpaceInstruction with all letters
downcased, i.e., "replace" or "collapse".
Example
WHITESPACE COLLAPSE
<whiteSpace action="collapse"/>
6. TargetList Translation
The TargetList production is common to all the encoding instructions.
The translation of a TargetList is the concatenation of the
translations of each of the contained Targets.
The translation of a Targets is an element item with the [local name]
"target". The translation of the contained TypeIdentification,
BuiltInTypeIdentification or IdentifiersInContext SHALL be added to
the [children] and/or [attributes] of the <target> element item.
Aside: A Targets that is an ImportedTypesIdentification will have
been removed by the preprocessing described in Section 3.
Legg Expires 20 April 2007 [Page 12]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
6.1. TypeIdentification Translation
The translation of a TypeIdentification of the "ALL" form is an
element item with the [local name] "allTypes", otherwise the
translation of a TypeIdentification is the translation of the
ModuleAndTypeReference followed by the translation of the
ComponentReference, if present, followed by the translation of the
QualifyingInformationPart, if present.
The translation of a ModuleAndTypeReference is an attribute item with
the [local name] "type". The [normalized value] of this attribute
item is the qualified name [XMLNS10] corresponding to the
typereference in the ModuleAndTypeReference (see Section 5.1 of the
specification for ASN.X [ASN.X]).
The translation of a ComponentReference is an element item with the
[local name] "component" and, if the final ComponentId in the
ComponentIdList in the ComponentReference is "ALL", an element item
with the [local name] "allTextuallyPresent". The [children] property
of the <component> element item is set to the sequence of character
items for a "/" (U+002F) separated list of the translations of the
ComponentId instances, excluding "ALL" if present. Leading and/or
trailing white space character items MAY be added to the [children]
of the <component> element item. White space character items MAY be
added immediately before and/or after any character item for the "/"
character.
If a ComponentId identifies the Type in a NamedType, then the
translation of the ComponentId is the RXER character data translation
[RXER] of the effective name [RXEREI] of the NamedType. If the
NamedType is subject to an RXER ATTRIBUTE or ATTRIBUTE-REF encoding
instruction [RXEREI], then a "@" (U+0040) character is prefixed to
the translation.
If a ComponentId identifies a Type that is not in a NamedType (the
component type for a SEQUENCE OF or SET OF type), then the
translation of the ComponentId is the character string "item".
If a ComponentId does not identify a Type and the ComponentId is an
identifier, then the translation of the ComponentId is the
identifier.
If a ComponentId does not identify a Type and the ComponentId is "*",
then the translation of the ComponentId is the character string
"item".
The <component> element item is required to be self-contained [RXER].
Legg Expires 20 April 2007 [Page 13]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
Aside: An element item is self-contained if all namespace prefixes
used by the element item and its contents are declared within the
element item.
The translation of a QualifyingInformationPart is the translation of
the contained QualifyingInformation.
The translation of a QualifyingInformation of the "identifier" form
is an element item with the [local name] "identifier". An attribute
item with the [local name] "name" SHALL be added to the [attributes]
of the <identifier> element item. If the ModuleTypeAndReference and
ComponentReference (if present) identify a BIT STRING, ENUMERATED, or
INTEGER type where the associated BitStringType, EnumeratedType or
IntegerType (respectively) is subject to an RXER VALUES encoding
instruction, then the [normalized value] of the attribute item is the
replacement name [RXEREI] for the identifier, otherwise the
[normalized value] is the identifier.
The translation of a QualifyingInformation of the "ALL" form is an
element item with the [local name] "allIdentifiers".
Examples
Assume this type assignment:
MyType ::= SEQUENCE {
a SEQUENCE OF CHOICE {
b ENUMERATED { red, green, blue },
c INTEGER
}
}
MyType.a.*.ALL
<target type="MyType">
<component> a / item </component>
<allTextuallyPresent/>
</target>
MyType.a.*.b:ALL
<target type="MyType">
<component> a / item / b </component>
<allIdentifiers/>
</target>
6.2. BuiltInTypeIdentification Translation
Legg Expires 20 April 2007 [Page 14]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
The translation of a BuiltInTypeIdentification is the translation of
the BuiltInTypeName followed by the translation of the
BuiltInTypeQualifyingInformationPart, if present.
If the BuiltInTypeName is "BIT STRING", "BOOLEAN",
"CHARACTER STRING", "EMBEDDED PDV", "EXTERNAL", "GeneralizedTime",
"INTEGER", "NULL", "ObjectDescriptor", "OBJECT IDENTIFIER",
"OCTET STRING", "REAL", "RELATIVE-OID" or "UTCTime", then the
translation of the BuiltInTypeName is an attribute item with the
[local name] "type". The [normalized value] of this attribute item
is a qualified name with the namespace name being
"urn:ietf:params:xml:ns:asnx" and the local part being the
BuiltInTypeName with any white space separators replaced by a single
hyphen character (U+002D), e.g. BIT STRING becomes BIT-STRING.
If the BuiltInTypeName is a RestrictedCharacterStringType, then the
translation of the BuiltInTypeName is an attribute item with the
[local name] "type". The [normalized value] of this attribute item
is a qualified name with the namespace name being
"urn:ietf:params:xml:ns:asnx" and the local part being the
RestrictedCharacterStringType, i.e., BMPString, GeneralString,
GraphicString, IA5String, ISO646String, NumericString,
PrintableString, TeletexString, T61String, UniversalString,
UTF8String, VideotexString or VisibleString.
If the BuiltInTypeName is "CHOICE", then the translation of the
BuiltInTypeName is an element item with the [local name] "choice".
If the BuiltInTypeName is "ENUMERATED", then the translation of the
BuiltInTypeName is an element item with the [local name]
"enumerated".
If the BuiltInTypeName is "INSTANCE OF", then the translation of the
BuiltInTypeName is an element item with the [local name]
"instanceOf".
If the BuiltInTypeName is "SEQUENCE", then the translation of the
BuiltInTypeName is an element item with the [local name] "sequence".
If the BuiltInTypeName is "SEQUENCE OF", then the translation of the
BuiltInTypeName is an element item with the [local name]
"sequenceOf".
If the BuiltInTypeName is "SET", then the translation of the
BuiltInTypeName is an element item with the [local name] "set".
If the BuiltInTypeName is "SET OF", then the translation of the
BuiltInTypeName is an element item with the [local name] "setOf".
Legg Expires 20 April 2007 [Page 15]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
The translation of a BuiltInTypeQualifyingInformationPart is the
translation of the contained BuiltInTypeQualifyingInformation.
The translation of a BuiltInTypeQualifyingInformation of the
"identifier" form is an element item with the [local name]
"identifier". An attribute item with the [local name] "name" SHALL
be added to the [attributes] of the <identifier> element item. The
[normalized value] of this attribute item is the actual identifier.
The translation of a BuiltInTypeQualifyingInformationPart of the
"ALL" form is an element item with the [local name] "allIdentifiers".
Examples
BOOLEAN:true
<target xmlns:asnx="urn:ietf:params:xml:ns:asnx"
type="asnx:BOOLEAN">
<identifier name="true"/>
</target>
ENUMERATED:ALL
<target>
<enumerated/>
<allIdentifiers/>
</target>
6.3. IdentifiersInContext Translation
The translation of an IdentifiersInContext is an element item with
the [local name] "components".
If the IdentifierList in the IdentifiersInContext is not of the "ALL"
or "COMPONENTS" form, then for each identifier in the IdentifierList,
an element item with the same [local name] (i.e., "attribute",
"element", "component", "group", "member" or "item") as the
translation of the NamedType corresponding to the identifier SHALL be
appended to the [children] of the <components> element item. An
attribute item with the [local name] "name" SHALL be added to the
[attributes] of each <attribute>, <element>, <component>, <group>,
<member> or <item> element item, as the case may be. The
[normalized value] of each of these attribute items is the RXER
character data translation [RXER] of the effective name [RXEREI] of
the NamedType corresponding to the identifier.
If the IdentifierList in the IdentifiersInContext is of the "ALL"
form, then an element item with the [local name]
Legg Expires 20 April 2007 [Page 16]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
"allTextuallyPresent" SHALL be appended to the [children] of the
<components> element item.
If the IdentifierList in the IdentifiersInContext is of the
"COMPONENTS" form, then an element item with the [local name]
"allFirstLevel" SHALL be appended to the [children] of the
<components> element item.
An element item with the [local name] "in" SHALL be appended to the
[children] of the <components> element item. The translation of the
TypeIdentification in the IdentifiersInContext SHALL be added to the
[children] and/or [attributes] of the <in> element item.
Example
Assume this type assignment:
MyType ::= SEQUENCE {
field INTEGER,
fieldAtt [RXER:NAME AS "field"][RXER:ATTRIBUTE] BOOLEAN
}
field, fieldAtt IN MyType
<target>
<components>
<element name="field"/>
<attribute name="field"/>
<in type="MyType"/>
</components>
</target>
7. Security Considerations
The ASN.X translation of an XER encoding instruction is semantically
equivalent to the original XER encoding instruction. The security
considerations that apply to an application built from an original
ASN.1 specification with XER encoding instructions apply equally to
an application built from the ASN.X translation of the ASN.1
specification.
Syntax-based canonicalization for XML documents (e.g., Canonical XML
[CXML]) depends on the Infoset of an XML document being preserved.
However, the Infoset representation of an ASN.X document (an abstract
value of the ModuleDefinition ASN.1 type) potentially changes if it
is decoded and re-encoded, disrupting the Canonical XML
representation. To avoid this problem, ASN.X documents must be
normalized prior to the application of syntax-based canonicalization.
Legg Expires 20 April 2007 [Page 17]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
The normalization rules can be found in Section 5.12 of the
specification for RXER [RXER].
8. IANA Considerations
This document has no actions for IANA.
9. References
9.1. Normative References
[BCP14] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[URI] Berners-Lee, T., Fielding, R. and L. Masinter, "Uniform
Resource Identifiers (URI): Generic Syntax", STD 66, RFC
3986, January 2005.
[RXER] Legg, S. and D. Prager, "Robust XML Encoding Rules (RXER)
for Abstract Syntax Notation One (ASN.1)",
draft-legg-xed-rxer-xx.txt, a work in progress, October
2006.
[RXEREI] Legg, S., "Encoding Instructions for the Robust XML
Encoding Rules (RXER)", draft-legg-xed-rxer-ei-xx.txt, a
work in progress, October 2006.
[ASN.X] Legg, S., "Abstract Syntax Notation X (ASN.X)",
draft-legg-xed-asd-xx.txt, a work in progress, October
2006.
[X.680] ITU-T Recommendation X.680 (07/02) | ISO/IEC 8824-1,
Information technology - Abstract Syntax Notation One
(ASN.1): Specification of basic notation.
[X.680-1] ITU-T Recommendation X.680 (2002) Amendment 1 (10/03) |
ISO/IEC 8824-1:2002/Amd 1:2004, Support for EXTENDED-XER.
[X.683] ITU-T Recommendation X.683 (07/02) | ISO/IEC 8824-4,
Information technology - Abstract Syntax Notation One
(ASN.1): Parameterization of ASN.1 specifications.
[X.693-1] Amendment 1: (to ITU-T Rec. X.693 | ISO/IEC 8825-4) XER
encoding instructions and EXTENDED-XER
[XML10] Bray, T., Paoli, J., Sperberg-McQueen, C., Maler, E. and
F. Yergeau, "Extensible Markup Language (XML) 1.0 (Fourth
Edition)", W3C Recommendation,
Legg Expires 20 April 2007 [Page 18]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
http://www.w3.org/TR/2006/REC-xml-20060816, August 2006.
[XML11] Bray, T., Paoli, J., Sperberg-McQueen, C., Maler, E.,
Yergeau, F., and J. Cowan, "Extensible Markup Language
(XML) 1.1 (Second Edition)", W3C Recommendation,
http://www.w3.org/TR/2006/REC-xml11-20060816, August 2006.
[XMLNS10] Bray, T., Hollander, D., Layman, A., and R. Tobin,
"Namespaces in XML 1.0 (Second Edition)", W3C
Recommendation,
http://www.w3.org/TR/2006/REC-xml-names-20060816, August
2006.
[ISET] Cowan, J. and R. Tobin, "XML Information Set (Second
Edition)", W3C Recommendation,
http://www.w3.org/TR/2004/REC-xml-infoset-20040204,
February 2004.
[UNICODE] The Unicode Consortium, "The Unicode Standard, Version
4.0", Boston, MA, Addison-Wesley Developers Press, 2003.
ISBN 0-321-18578-1.
9.2. Informative References
[X.693] ITU-T Recommendation X.693 (12/01) | ISO/IEC 8825-4:2002,
Information technology - ASN.1 encoding rules: XML
encoding rules (XER)
Appendix A. ASN.1 for XER Encoding Instruction Notation
This appendix is normative.
XER-EncodingInstructionNotation
{ iso(1) identified-organization(3) dod(6)
internet(1) private(4) enterprise(1)
xmled(21472) asnx(1) module(0) xer-ei-notation(3) }
-- Copyright (C) The Internet Society (2006). This version of
-- this ASN.1 module is part of RFC XXXX; see the RFC itself
-- for full legal notices.
DEFINITIONS
RXER INSTRUCTIONS
AUTOMATIC TAGS
EXTENSIBILITY IMPLIED ::= BEGIN
IMPORTS
AnyURI,
Legg Expires 20 April 2007 [Page 19]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
NCName
FROM AdditionalBasicDefinitions
{ iso(1) identified-organization(3) dod(6)
internet(1) private(4) enterprise(1)
xmled(21472) asnx(1) module(0) basic(0) }
Annotation,
Value
FROM AbstractSyntaxNotation-X
{ iso(1) identified-organization(3) dod(6)
internet(1) private(4) enterprise(1)
xmled(21472) asnx(1) module(0) notation(1) }
TargetList
FROM TargetListNotation
{ iso(1) identified-organization(3) dod(6)
internet(1) private(4) enterprise(1)
xmled(21472) asnx(1) module(0)
target-list-notation(4) }
;
XER-EncodingInstructionAssignmentList ::= SEQUENCE {
annotation Annotation OPTIONAL,
instructions [GROUP] XER-TargettedEncodingInstructions
}
XER-TargettedEncodingInstructions ::= SEQUENCE SIZE (1..MAX) OF
targettedInstruction XER-TargettedEncodingInstruction
XER-TargettedEncodingInstruction ::= SEQUENCE {
instruction [GROUP] XER-GeneralEncodingInstruction,
targetList [GROUP] TargetList OPTIONAL
}
XER-EncodingInstruction ::= XER-GeneralEncodingInstruction
(WITH COMPONENTS { ..., globalDefaults ABSENT })
XER-GeneralEncodingInstruction ::= [SINGULAR-INSERTIONS] CHOICE {
anyAttributes XER-WildcardInstruction,
not-anyAttributes XER-NegatingInstruction,
anyElement XER-WildcardInstruction,
not-anyElement XER-NegatingInstruction,
attribute XER-SimpleInstruction,
not-attribute XER-NegatingInstruction,
base64 XER-SimpleInstruction,
not-base64 XER-NegatingInstruction,
decimal XER-SimpleInstruction,
not-decimal XER-NegatingInstruction,
defaultForEmpty XER-DefaultForEmptyInstruction,
not-defaultForEmpty XER-NegatingInstruction,
Legg Expires 20 April 2007 [Page 20]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
embedValues XER-SimpleInstruction,
not-embedValues XER-NegatingInstruction,
globalDefaults XER-GlobalDefaultsInstruction,
list XER-SimpleInstruction,
not-list XER-NegatingInstruction,
name XER-NameInstruction,
not-name XER-NegatingInstruction,
namespace XER-NamespaceInstruction,
not-namespace XER-NegatingInstruction,
piOrComment XER-PIOrCommentInstruction,
not-piOrComment XER-NegatingInstruction,
text XER-TextInstruction,
not-text XER-NegatingInstruction,
untagged XER-SimpleInstruction,
not-untagged XER-NegatingInstruction,
element XER-NegatingInstruction,
useNil XER-SimpleInstruction,
not-useNil XER-NegatingInstruction,
useNumber XER-SimpleInstruction,
not-useNumber XER-NegatingInstruction,
useOrder XER-SimpleInstruction,
not-useOrder XER-NegatingInstruction,
useQName XER-SimpleInstruction,
not-useQName XER-NegatingInstruction,
useType XER-SimpleInstruction,
not-useType XER-NegatingInstruction,
useUnion XER-SimpleInstruction,
not-useUnion XER-NegatingInstruction,
whiteSpace XER-WhiteSpaceInstruction,
not-whiteSpace XER-NegatingInstruction
}
XER-SimpleInstruction ::= SEQUENCE { }
XER-NegatingInstruction ::= XER-SimpleInstruction
XER-WildcardInstruction ::= SEQUENCE {
namespaceRestriction [GROUP] XER-NamespaceRestriction OPTIONAL
}
XER-NamespaceRestriction ::= [NO-INSERTIONS] CHOICE {
from XER-URIList,
except XER-URIList
}
XER-URIList ::= SEQUENCE SIZE(1..MAX) OF
uriOrAbsent [GROUP] XER-QuotedURIorAbsent
Legg Expires 20 April 2007 [Page 21]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
XER-QuotedURIorAbsent ::= [SINGULAR-INSERTIONS] CHOICE {
namespace AnyURI,
local NULL
}
XER-DefaultForEmptyInstruction ::= SEQUENCE {
value [GROUP] Value
}
XER-GlobalDefaultsInstruction ::= SEQUENCE {
defaultSetting [GROUP] [SINGULAR-INSERTIONS] CHOICE {
modifiedEncodings NULL,
controlNamespace XER-ControlNamespace
}
}
XER-ControlNamespace ::= SEQUENCE {
name [ATTRIBUTE] AnyURI,
prefix [ATTRIBUTE] NCName OPTIONAL
}
XER-NameInstruction ::= SEQUENCE {
newNameOrKeyword [GROUP] XER-NewNameOrKeyword
}
XER-NewNameOrKeyword ::= [NO-INSERTIONS] CHOICE {
newName [ATTRIBUTE] UTF8String,
conversion [ATTRIBUTE] XER-Conversion
}
XER-Conversion ::= ENUMERATED {
capitalized (0),
uncapitalized (1),
uppercased (2),
lowercased (3)
}
XER-NamespaceInstruction ::= SEQUENCE {
namespace [GROUP] XER-NamespaceSpecification OPTIONAL
}
XER-NamespaceSpecification ::= [HOLLOW-INSERTIONS] SEQUENCE {
name [ATTRIBUTE] AnyURI,
prefix [ATTRIBUTE] NCName OPTIONAL
}
XER-PIOrCommentInstruction ::= SEQUENCE {
text [ATTRIBUTE] UTF8String,
Legg Expires 20 April 2007 [Page 22]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
position [ATTRIBUTE] XER-Position
}
XER-Position ::= ENUMERATED {
beforeTag (0),
beforeValue (1),
afterValue (2),
afterTag (3)
}
XER-TextInstruction ::= SEQUENCE {
newNameOrKeyword [GROUP] XER-NewNameOrKeyword OPTIONAL
}
XER-WhiteSpaceInstruction ::= SEQUENCE {
action [ATTRIBUTE] XER-WhiteSpaceAction
}
XER-WhiteSpaceAction ::= ENUMERATED {
replace (0),
collapse (1)
}
ENCODING-CONTROL RXER
SCHEMA-IDENTITY "urn:oid:1.3.6.1.4.1.21472.1.0.3"
TARGET-NAMESPACE "urn:ietf:params:xml:ns:asnx" PREFIX "asnx"
END
Appendix B. ASN.1 for Target List Notation
This appendix is normative.
TargetListNotation
{ iso(1) identified-organization(3) dod(6)
internet(1) private(4) enterprise(1)
xmled(21472) asnx(1) module(0) target-list-notation(4) }
-- Copyright (C) The Internet Society (2006). This version of
-- this ASN.1 module is part of RFC XXXX; see the RFC itself
-- for full legal notices.
DEFINITIONS
RXER INSTRUCTIONS
AUTOMATIC TAGS
EXTENSIBILITY IMPLIED ::= BEGIN
Legg Expires 20 April 2007 [Page 23]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
IMPORTS
Markup,
NCName,
QName
FROM AdditionalBasicDefinitions
{ iso(1) identified-organization(3) dod(6)
internet(1) private(4) enterprise(1)
xmled(21472) asnx(1) module(0) basic(0) }
;
TargetList ::= SEQUENCE SIZE (1..MAX) OF target Targets
Targets ::= [NO-INSERTIONS] CHOICE {
allTypes NULL,
identifiedTypes [GROUP] QualifiedTypeIdentification,
components IdentifiersInContext,
allImportsFrom SEQUENCE { }
-- allImportsFrom is not used in this version
}
-- TypeIdentification and BuiltInTypeIdentification
QualifiedTypeIdentification ::= [HOLLOW-INSERTIONS] SEQUENCE {
types [GROUP] [SINGULAR-INSERTIONS] CHOICE {
specificType [GROUP] SpecificTypeIdentification,
choice NULL,
enumerated NULL,
instanceOf NULL,
sequence NULL,
sequenceOf NULL,
set NULL,
setOf NULL
},
qualification [GROUP] QualifyingInformationPart OPTIONAL
}
SpecificTypeIdentification ::= [HOLLOW-INSERTIONS] SEQUENCE {
type [ATTRIBUTE] QName,
component Markup OPTIONAL,
allTextuallyPresent NULL OPTIONAL
}
QualifyingInformationPart ::= [NO-INSERTIONS] CHOICE {
allIdentifiers NULL,
identifier SEQUENCE {
name [ATTRIBUTE] NCName
}
}
Legg Expires 20 April 2007 [Page 24]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
IdentifiersInContext ::= SEQUENCE {
identifiers [GROUP] IdentifierList,
in CHOICE {
allTypes NULL,
specificType [GROUP] SpecificTypeIdentification
}
}
IdentifierList ::= [NO-INSERTIONS] CHOICE {
list [GROUP] IdentifiedComponents,
allTextuallyPresent NULL,
allFirstLevel NULL
}
IdentifiedComponents ::= SEQUENCE SIZE (1..MAX) OF
identifiedComponent [GROUP] IdentifiedComponent
IdentifiedComponent ::= [SINGULAR-INSERTIONS] CHOICE {
component GenericIdentifiedComponent,
element GenericIdentifiedComponent,
attribute GenericIdentifiedComponent,
group GenericIdentifiedComponent,
member GenericIdentifiedComponent,
item GenericIdentifiedComponent
}
GenericIdentifiedComponent ::= SEQUENCE {
name [ATTRIBUTE] QName
}
ENCODING-CONTROL RXER
SCHEMA-IDENTITY "urn:oid:1.3.6.1.4.1.21472.1.0.4"
TARGET-NAMESPACE "urn:ietf:params:xml:ns:asnx" PREFIX "tln"
END
Appendix C. ASN.X for XER Encoding Instruction Notation
This appendix is non-normative.
<?xml version="1.0"?>
<asnx:module xmlns:asnx="urn:ietf:params:xml:ns:asnx"
xmlns:tln="urn:ietf:params:xml:ns:asnx"
name="XER-EncodingInstructionNotation"
identifier="1.3.6.1.4.1.21472.1.0.3"
schemaIdentity="urn:oid:1.3.6.1.4.1.21472.1.0.3"
targetNamespace="urn:ietf:params:xml:ns:asnx"
Legg Expires 20 April 2007 [Page 25]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
targetPrefix="asnx"
extensibilityImplied="true">
<annotation>
Copyright (C) The Internet Society (2006). This version of
this ASN.X module is part of RFC XXXX; see the RFC itself
for full legal notices.
</annotation>
<import name="AbstractSyntaxNotation-X"
identifier="1.3.6.1.4.1.21472.1.0.1"
schemaIdentity="urn:oid:1.3.6.1.4.1.21472.1.0.1"
namespace="urn:ietf:params:xml:ns:asnx"/>
<import name="TargetListNotation"
identifier="1.3.6.1.4.1.21472.1.0.4"
schemaIdentity="urn:oid:1.3.6.1.4.1.21472.1.0.4"
namespace="urn:ietf:params:xml:ns:asnx"/>
<namedType name="XER-EncodingInstructionAssignmentList">
<type>
<sequence>
<optional>
<element name="annotation" type="asnx:Annotation"/>
</optional>
<group name="instructions"
type="asnx:XER-TargettedEncodingInstructions"/>
</sequence>
</type>
</namedType>
<namedType name="XER-TargettedEncodingInstructions">
<type>
<sequenceOf minSize="1">
<element name="targettedInstruction"
type="asnx:XER-TargettedEncodingInstruction"/>
</sequenceOf>
</type>
</namedType>
<namedType name="XER-TargettedEncodingInstruction">
<type>
<sequence>
<group name="instruction"
type="asnx:XER-GeneralEncodingInstruction"/>
<optional>
<group name="targetList" type="tln:TargetList"/>
</optional>
Legg Expires 20 April 2007 [Page 26]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
</sequence>
</type>
</namedType>
<namedType name="XER-EncodingInstruction">
<type>
<constrained type="asnx:XER-GeneralEncodingInstruction">
<withComponents partial="true">
<element name="globalDefaults" use="absent"/>
</withComponents>
</constrained>
</type>
</namedType>
<namedType name="XER-GeneralEncodingInstruction">
<type>
<choice insertions="singular">
<element name="anyAttributes"
type="asnx:XER-WildcardInstruction"/>
<element name="not-anyAttributes"
type="asnx:XER-NegatingInstruction"/>
<element name="anyElement" type="asnx:XER-WildcardInstruction"/>
<element name="not-anyElement"
type="asnx:XER-NegatingInstruction"/>
<element name="attribute" type="asnx:XER-SimpleInstruction"/>
<element name="not-attribute"
type="asnx:XER-NegatingInstruction"/>
<element name="base64" type="asnx:XER-SimpleInstruction"/>
<element name="not-base64" type="asnx:XER-NegatingInstruction"/>
<element name="decimal" type="asnx:XER-SimpleInstruction"/>
<element name="not-decimal" type="asnx:XER-NegatingInstruction"/>
<element name="defaultForEmpty"
type="asnx:XER-DefaultForEmptyInstruction"/>
<element name="not-defaultForEmpty"
type="asnx:XER-NegatingInstruction"/>
<element name="embedValues" type="asnx:XER-SimpleInstruction"/>
<element name="not-embedValues"
type="asnx:XER-NegatingInstruction"/>
<element name="globalDefaults"
type="asnx:XER-GlobalDefaultsInstruction"/>
<element name="list" type="asnx:XER-SimpleInstruction"/>
<element name="not-list" type="asnx:XER-NegatingInstruction"/>
<element name="name" type="asnx:XER-NameInstruction"/>
<element name="not-name" type="asnx:XER-NegatingInstruction"/>
<element name="namespace" type="asnx:XER-NamespaceInstruction"/>
<element name="not-namespace"
type="asnx:XER-NegatingInstruction"/>
<element name="piOrComment"
Legg Expires 20 April 2007 [Page 27]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
type="asnx:XER-PIOrCommentInstruction"/>
<element name="not-piOrComment"
type="asnx:XER-NegatingInstruction"/>
<element name="text" type="asnx:XER-TextInstruction"/>
<element name="not-text" type="asnx:XER-NegatingInstruction"/>
<element name="untagged" type="asnx:XER-SimpleInstruction"/>
<element name="not-untagged"
type="asnx:XER-NegatingInstruction"/>
<element name="element" type="asnx:XER-NegatingInstruction"/>
<element name="useNil" type="asnx:XER-SimpleInstruction"/>
<element name="not-useNil" type="asnx:XER-NegatingInstruction"/>
<element name="useNumber" type="asnx:XER-SimpleInstruction"/>
<element name="not-useNumber"
type="asnx:XER-NegatingInstruction"/>
<element name="useOrder" type="asnx:XER-SimpleInstruction"/>
<element name="not-useOrder"
type="asnx:XER-NegatingInstruction"/>
<element name="useQName" type="asnx:XER-SimpleInstruction"/>
<element name="not-useQName"
type="asnx:XER-NegatingInstruction"/>
<element name="useType" type="asnx:XER-SimpleInstruction"/>
<element name="not-useType" type="asnx:XER-NegatingInstruction"/>
<element name="useUnion" type="asnx:XER-SimpleInstruction"/>
<element name="not-useUnion"
type="asnx:XER-NegatingInstruction"/>
<element name="whiteSpace"
type="asnx:XER-WhiteSpaceInstruction"/>
<element name="not-whiteSpace"
type="asnx:XER-NegatingInstruction"/>
</choice>
</type>
</namedType>
<namedType name="XER-SimpleInstruction">
<type>
<sequence/>
</type>
</namedType>
<namedType name="XER-NegatingInstruction"
type="asnx:XER-SimpleInstruction"/>
<namedType name="XER-WildcardInstruction">
<type>
<sequence>
<optional>
<group name="namespaceRestriction"
type="asnx:XER-NamespaceRestriction"/>
Legg Expires 20 April 2007 [Page 28]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
</optional>
</sequence>
</type>
</namedType>
<namedType name="XER-NamespaceRestriction">
<type>
<choice insertions="none">
<element name="from" type="asnx:XER-URIList"/>
<element name="except" type="asnx:XER-URIList"/>
</choice>
</type>
</namedType>
<namedType name="XER-URIList">
<type>
<sequenceOf minSize="1">
<group name="uriOrAbsent" type="asnx:XER-QuotedURIorAbsent"/>
</sequenceOf>
</type>
</namedType>
<namedType name="XER-QuotedURIorAbsent">
<type>
<choice insertions="singular">
<element name="namespace" type="asnx:AnyURI"/>
<element name="local" type="asnx:NULL"/>
</choice>
</type>
</namedType>
<namedType name="XER-DefaultForEmptyInstruction">
<type>
<sequence>
<group name="value" type="asnx:Value"/>
</sequence>
</type>
</namedType>
<namedType name="XER-GlobalDefaultsInstruction">
<type>
<sequence>
<group name="defaultSetting">
<type>
<choice insertions="singular">
<element name="modifiedEncodings" type="asnx:NULL"/>
<element name="controlNamespace"
type="asnx:XER-ControlNamespace"/>
Legg Expires 20 April 2007 [Page 29]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
</choice>
</type>
</group>
</sequence>
</type>
</namedType>
<namedType name="XER-ControlNamespace">
<type>
<sequence>
<attribute name="name" type="asnx:AnyURI"/>
<optional>
<attribute name="prefix" type="asnx:NCName"/>
</optional>
</sequence>
</type>
</namedType>
<namedType name="XER-NameInstruction">
<type>
<sequence>
<group name="newNameOrKeyword" type="asnx:XER-NewNameOrKeyword"/>
</sequence>
</type>
</namedType>
<namedType name="XER-NewNameOrKeyword">
<type>
<choice insertions="none">
<attribute name="newName" type="asnx:UTF8String"/>
<attribute name="conversion" type="asnx:XER-Conversion"/>
</choice>
</type>
</namedType>
<namedType name="XER-Conversion">
<type>
<enumerated>
<enumeration name="capitalized" number="0"/>
<enumeration name="uncapitalized" number="1"/>
<enumeration name="uppercased" number="2"/>
<enumeration name="lowercased" number="3"/>
</enumerated>
</type>
</namedType>
<namedType name="XER-NamespaceInstruction">
<type>
Legg Expires 20 April 2007 [Page 30]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
<sequence>
<optional>
<group name="namespace" type="asnx:XER-NamespaceSpecification"/>
</optional>
</sequence>
</type>
</namedType>
<namedType name="XER-NamespaceSpecification">
<type>
<sequence insertions="hollow">
<attribute name="name" type="asnx:AnyURI"/>
<optional>
<attribute name="prefix" type="asnx:NCName"/>
</optional>
</sequence>
</type>
</namedType>
<namedType name="XER-PIOrCommentInstruction">
<type>
<sequence>
<attribute name="text" type="asnx:UTF8String"/>
<attribute name="position" type="asnx:XER-Position"/>
</sequence>
</type>
</namedType>
<namedType name="XER-Position">
<type>
<enumerated>
<enumeration name="beforeTag" number="0"/>
<enumeration name="beforeValue" number="1"/>
<enumeration name="afterValue" number="2"/>
<enumeration name="afterTag" number="3"/>
</enumerated>
</type>
</namedType>
<namedType name="XER-TextInstruction">
<type>
<sequence>
<optional>
<group name="newNameOrKeyword"
type="asnx:XER-NewNameOrKeyword"/>
</optional>
</sequence>
</type>
Legg Expires 20 April 2007 [Page 31]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
</namedType>
<namedType name="XER-WhiteSpaceInstruction">
<type>
<sequence>
<attribute name="action" type="asnx:XER-WhiteSpaceAction"/>
</sequence>
</type>
</namedType>
<namedType name="XER-WhiteSpaceAction">
<type>
<enumerated>
<enumeration name="replace" number="0"/>
<enumeration name="collapse" number="1"/>
</enumerated>
</type>
</namedType>
</asnx:module>
Appendix D. ASN.X for Target List Notation
This appendix is non-normative.
<?xml version="1.0"?>
<asnx:module xmlns:asnx="urn:ietf:params:xml:ns:asnx"
xmlns:tln="urn:ietf:params:xml:ns:asnx"
name="TargetListNotation"
identifier="1.3.6.1.4.1.21472.1.0.4"
schemaIdentity="urn:oid:1.3.6.1.4.1.21472.1.0.4"
targetNamespace="urn:ietf:params:xml:ns:asnx"
targetPrefix="tln"
extensibilityImplied="true">
<annotation>
Copyright (C) The Internet Society (2006). This version of
this ASN.X module is part of RFC XXXX; see the RFC itself
for full legal notices.
</annotation>
<namedType name="TargetList">
<type>
<sequenceOf minSize="1">
<element name="target" type="tln:Targets"/>
</sequenceOf>
</type>
</namedType>
Legg Expires 20 April 2007 [Page 32]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
<namedType name="Targets">
<type>
<choice insertions="none">
<element name="allTypes" type="asnx:NULL"/>
<group name="identifiedTypes"
type="tln:QualifiedTypeIdentification"/>
<element name="components" type="tln:IdentifiersInContext"/>
<element name="allImportsFrom">
<annotation>
allImportsFrom is not used in this version
</annotation>
<type>
<sequence/>
</type>
</element>
</choice>
</type>
</namedType>
<namedType name="QualifiedTypeIdentification">
<annotation>
TypeIdentification and BuiltInTypeIdentification
</annotation>
<type>
<sequence insertions="hollow">
<group name="types">
<type>
<choice insertions="singular">
<group name="specificType"
type="tln:SpecificTypeIdentification"/>
<element name="choice" type="asnx:NULL"/>
<element name="enumerated" type="asnx:NULL"/>
<element name="instanceOf" type="asnx:NULL"/>
<element name="sequence" type="asnx:NULL"/>
<element name="sequenceOf" type="asnx:NULL"/>
<element name="set" type="asnx:NULL"/>
<element name="setOf" type="asnx:NULL"/>
</choice>
</type>
</group>
<optional>
<group name="qualification"
type="tln:QualifyingInformationPart"/>
</optional>
</sequence>
</type>
</namedType>
Legg Expires 20 April 2007 [Page 33]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
<namedType name="SpecificTypeIdentification">
<type>
<sequence insertions="hollow">
<attribute name="type" type="asnx:QName"/>
<optional>
<element name="component" type="asnx:Markup"/>
</optional>
<optional>
<element name="allTextuallyPresent" type="asnx:NULL"/>
</optional>
</sequence>
</type>
</namedType>
<namedType name="QualifyingInformationPart">
<type>
<choice insertions="none">
<element name="allIdentifiers" type="asnx:NULL"/>
<element name="identifier">
<type>
<sequence>
<attribute name="name" type="asnx:NCName"/>
</sequence>
</type>
</element>
</choice>
</type>
</namedType>
<namedType name="IdentifiersInContext">
<type>
<sequence>
<group name="identifiers" type="tln:IdentifierList"/>
<element name="in">
<type>
<choice>
<element name="allTypes" type="asnx:NULL"/>
<group name="specificType"
type="tln:SpecificTypeIdentification"/>
</choice>
</type>
</element>
</sequence>
</type>
</namedType>
<namedType name="IdentifierList">
<type>
Legg Expires 20 April 2007 [Page 34]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
<choice insertions="none">
<group name="list" type="tln:IdentifiedComponents"/>
<element name="allTextuallyPresent" type="asnx:NULL"/>
<element name="allFirstLevel" type="asnx:NULL"/>
</choice>
</type>
</namedType>
<namedType name="IdentifiedComponents">
<type>
<sequenceOf minSize="1">
<group name="identifiedComponent"
type="tln:IdentifiedComponent"/>
</sequenceOf>
</type>
</namedType>
<namedType name="IdentifiedComponent">
<type>
<choice insertions="singular">
<element name="component" type="tln:GenericIdentifiedComponent"/>
<element name="element" type="tln:GenericIdentifiedComponent"/>
<element name="attribute" type="tln:GenericIdentifiedComponent"/>
<element name="group" type="tln:GenericIdentifiedComponent"/>
<element name="member" type="tln:GenericIdentifiedComponent"/>
<element name="item" type="tln:GenericIdentifiedComponent"/>
</choice>
</type>
</namedType>
<namedType name="GenericIdentifiedComponent">
<type>
<sequence>
<attribute name="name" type="asnx:QName"/>
</sequence>
</type>
</namedType>
</asnx:module>
Author's Address
Dr. Steven Legg
eB2Bcom
Suite 3, Woodhouse Corporate Centre
935 Station Street
Box Hill North, Victoria 3129
AUSTRALIA
Legg Expires 20 April 2007 [Page 35]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
Phone: +61 3 9896 7830
Fax: +61 3 9896 7801
EMail: steven.legg@eb2bcom.com
Full Copyright Statement
Copyright (C) The Internet Society (2006).
This document is subject to the rights, licenses and restrictions
contained in BCP 78, and except as set forth therein, the authors
retain all their rights.
This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Intellectual Property
The IETF takes no position regarding the validity or scope of any
Intellectual Property Rights or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; nor does it represent that it has
made any independent effort to identify any such rights. Information
on the procedures with respect to rights in RFC documents can be
found in BCP 78 and BCP 79.
Copies of IPR disclosures made to the IETF Secretariat and any
assurances of licenses to be made available, or the result of an
attempt made to obtain a general license or permission for the use of
such proprietary rights by implementers or users of this
specification can be obtained from the IETF on-line IPR repository at
http://www.ietf.org/ipr.
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights that may cover technology that may be required to implement
this standard. Please address the information to the IETF at
ietf-ipr@ietf.org.
Note to the RFC Editor: the remainder of this document is to be removed
before final publication.
Changes in Draft 01
Legg Expires 20 April 2007 [Page 36]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
ASN.1 Schema has been renamed to Abstract Syntax Notation X (ASN.X)
and the <asnx:schema> element has been renamed to <asnx:module>.
The XER-EncodingInstructionSchema module has been renamed to
XER-EncodingInstructionNotation. The schema identity for the module
has been similarly changed.
The component attribute in the SpecificTypeIdentification translation
has been changed to a <component> element.
Examples have been added.
The CONTENT encoding instruction has been renamed to GROUP and a
component subject to a GROUP encoding instruction is now an element
item with the [local name] "group" instead of "content".
The <encodingControl-XER> element has been renamed to <XER> and now
appears as a child element of an <encodingControls> element.
Insertion encoding instructions have been added to the ASN.1 for XER
Encoding Instruction Notation to remove extension ambiguity.
Changes in Draft 02
The AnyType ASN.1 type has been renamed to Markup.
Each EncodingInstruction in an EncodingInstructionAssignmentList is
now wrapped in a <targettedInstruction> element with the <target>
elements following the encoding instruction element instead of being
nested within it. This is better aligned with the improved syntax
for XER encoding instructions that will be introduced along with
encoding instructions for PER.
The ASN.1 for TargetList has been extracted into a separate ASN.1
module so that it can be more conveniently shared with encoding
instructions for PER.
The method for dealing with parameterized definitions has been
generalized for ASN.X, so a specific solution for module context
changes with respect to XER encoding instructions is no longer needed
and has been dropped.
The treatment of the GLOBAL-DEFAULTS encoding instruction has been
changed so that there is now an explicit <globalDefaults> element
item.
A negating instruction is now represented as an empty element item
with a name beginning with "not-" instead of being represented as a
Legg Expires 20 April 2007 [Page 37]
INTERNET-DRAFT ASN.X: XER Encoding Instructions October 20, 2006
positive instruction child of a <not> element item.
A preprocessing step has been added to deal with
ImportedTypesIdentification. The previous translation for
ImportedTypesIdentification was unable to account for symbols
imported from another module's import list.
The URL for the ASN.1 namespace has been replaced. A permanent URN
will be requested from IANA.
Legg Expires 20 April 2007 [Page 38]
| PAFTECH AB 2003-2026 | 2026-04-24 05:52:16 |