Network Working Group M. Riegel Internet-Draft Siemens AG Category: Standards Track G. Zorn <draft-ietf-roamops-phonebook-xml-00.txt> Microsoft Corporation Feb 1999 XML DTD for Phone Books 1. Status of this Memo This document is an Internet-Draft and is in full conformance with all provisions of Section 10 of RFC2026. 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/ietf/1id-abstracts.txt The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. The distribution of this memo is unlimited. It is filed as <draft-ietf-roamops-phonebook-xml-00.txt>, and expires August 15, 1999. Please send comments to the Roaming Operations Working Group mailing list (roamops@tdmx.rutgers.edu) or to the editor of this draft (maximilian.riegel@icn.siemens.de). 2. Abstract This document describes the information to be included in the standard phone book for roaming applications. All data is described in XML [5] (Extensible Markup Language) syntax leading to a concise XML DTD (Document Type Declaration) for the phone book. Goals of this document include: - Creating a flexible, extensible and robust framework upon which to build a standard phone book - Promoting a standard phone book format, to enhance interoperability between ISPs and roaming consortia Riegel, Zorn Expires August 1999 [Page 1] Internet-Draft Phone Book XML DTD February 1999 Non-goals of this document include: - Attempting to create a "Swiss army knife", with phone book elements to please everyone on Earth - Definition of either server-server or client-server phone book update or transfer protocols 3. Rationale for XML Usage XML is rapidly becoming a standard format for data exchange between different applications also taking into account the transfer and access of data over the web. XML is used as syntax for expressing the structure and content of a roaming phone book to enable widespread usage and access to many different kind of media (e.g. paper, CDROM, www) using a widespread selection of access devices. Furthermore XML enables: - Extensibility - Flexibility - Integration with directories Extensibility is important because phone books are living documents; as such, it is unlikely that all the semantic requirements of arbitrary Internet service providers (ISPs) would be met by a fixed scheme, no matter how well thought out. Phone book designers must be free to create new attributes in a well-understood fashion to meet changing business needs. Flexibility is required of the attribute definition syntax for many of the same reasons that semantic extensibility is necessary. If we assume that phone book designers may need to define elements of arbitrary type, the syntax chosen must be able to represent these data objects cleanly. Using XML for describing the data content of the phone book fits this bill nicely, since it can be used to unambiguously describe virtually any data type. Integration with directories: although it is unlikely that phone books will be stored in the directory due to performance considerations, the creation of a XML DTD describing phone book content leaves that option open, with relatively little incremental effort required to implement it. 4. Specification of Requirements In this document, the key words "MAY", "MUST, "MUST NOT", "optional", "recommended", "SHOULD", and "SHOULD NOT", are to be interpreted as described in [1]. Riegel, Zorn Expires August 1999 [Page 2] Internet-Draft Phone Book XML DTD February 1999 5. Value type notations for 'stronger' typing XML does not have capabilities for 'strong typing' of the content of elements. The only type definition foreseen in the base specification is "#PCDATA", 'parseable character data' comprising everything. To enable a more concise description of the content of particular elements several value type notations are introduced. This allows for a more detailed type description of the content of elements. <?xml version="1.0" encoding="UTF-8"?> <!-- Phone book value type notation declarations --> <!NOTATION TEXT PUBLIC "-//IETF/roamPhoneBook/NOTATION value Type Text"> <!NOTATION INTEGER PUBLIC "-//IETF/roamPhoneBook/NOTATION value Type Integer"> <!NOTATION URL PUBLIC "-//IETF/roamPhoneBook/NOTATION value Type Uri"> <!NOTATION BITSTRING PUBLIC "-//IETF/roamPhoneBook/NOTATION value Type BitString"> <!NOTATION PHONENBR PUBLIC "-//IETF/roamPhoneBook/NOTATION value Type PhoneNumber"> <!NOTATION B64JPG PUBLIC "-//IETF/roamPhoneBook/NOTATION value Type Base64_encoded_JPEG_image"> 6. Phone Book Element Definitions This document includes definitions of the following components: - Phone Book - Provider - POP - Support - Setup 6.1. Phone Book 6.1.1. Description The Phone Book element is the basic container for phone book entries. It always contains a phone book version number (applying to the phone book as a whole), a phone book name and one or more references to POP objects. A Phone Book element may also contain multiple references to Provider and Setup elements (described below). Riegel, Zorn Expires August 1999 [Page 3] Internet-Draft Phone Book XML DTD February 1999 6.1.2. Syntax <!ELEMENT phoneBook phoneBookVersion, phoneBookName, popPtr+, setupPtr*, providerPtr*, supportPtr*> 6.2. Provider 6.2.1. Description The Provider element contains child elements pertaining to the general business operations of a given network service provider. The child elements include such things as telephone number, mailing address, etc., as well as URLs for e-mail and a World Wide Web site. A Provider element may also contain a reference to support information. 6.2.2. Syntax <!ELEMENT provider providerName?, providerIcon?, wwwURL?, generalMailtoURL?, billingMailtoURL?, businessCategory?, x121Address?, registeredAddress?, destinationIndicator?, preferredDeliveryMethod?, telexNumber?, teletexTerminalIdentifier?, telephoneNumber?, internationalISDNNumber?, facsimileTelephoneNumber?, street?, postOfficeBox?, postalCode?, postalAddress?, physicalDeliveryOfficeName?, description?, supportPtr* > <!ATTLIST provider id ID #REQUIRED> Riegel, Zorn Expires August 1999 [Page 4] Internet-Draft Phone Book XML DTD February 1999 6.3. POP 6.3.1. Description The POP element contains child elements relevant to individual network points of presence (POPs). The required child elements are addrFamily, address, media and entryVersion. The media element represents the media types supported by the POP, while the entryVersion element is a monotonically-increasing integer which should be incremented whenever the object is modified. 6.3.2. Syntax <!ELEMENT pop entryVersion, addrFamily, address, media+, encodingType?, modemProtocols?, isdnProtocols?, city?, region?, country?, countryCode?, minBitsPerSecond?, maxBitsPerSecond?, areaCode?, unicastRoutingProtocols?, multicastRoutingProtocols?, dialScriptType?, dialScript?, pricing?, vpnProtocols?, popProperties?, popSetupPointer?, popSupportPointer?, popProviderPointer? > <!ATTLIST pop id ID #REQUIRED> 6.4. Support 6.4.1. Description The Support element includes those child elements that are pertinent to the provision of customer support for a POP or provider. Riegel, Zorn Expires August 1999 [Page 5] Internet-Draft Phone Book XML DTD February 1999 6.4.2. Syntax <!ELEMENT support supportTelephoneNumber?, supportLanguages?, supportMailtoURL? > <!ATTLIST support id ID #REQUIRED> 6.5. Setup 6.5.1. Description The Setup element includes child elements which describe services which may change from provider to provider or even from POP to POP. Many of the values contained in these child elements may be available by other means (e.g., DHCP), but others may not. 6.5.2. Syntax in +0.3i <!ELEMENT setup dnsServerAddress?, nntpServerName?, smtpServerName?, popServerName?, imapServerName?, wwwProxyServerName?, ftpProxyServerName?, winsockProxyServerName?, defaultGatewayAddress?, userNamePrefix?, userNameSuffix? > <!ATTLIST setup id ID #REQUIRED> 7. Child Element Definitions 7.1. Child elements defined for the Phone Book element 7.1.1. Phone Book Version 7.1.1.1. Description The phoneBookVersion attribute is an integer representing the version of the phone book; it is a monotonically increasing counter which should be incremented each time the phone book is modified. This element can be used by a server to help decide what (if any) actions are required to bring a client's phone book up to date. For example, the client can, at connect time, send an update request to the server including in the request the version number of its current phone Riegel, Zorn Expires August 1999 [Page 6] Internet-Draft Phone Book XML DTD February 1999 book. If the client's phone book version is not the same as the server's current phone book version, the server can easily take appropriate action, e.g., reply with a URL pointing to a file containing the differences between the client and server phone books. 7.1.1.2. Syntax <!-- Version number of the phone book --> <!ELEMENT phoneBookVersion (#PCDATA)> <!ATTLIST phoneBookVersion value NOTATION (INTEGER) #IMPLIED> 7.1.2. Phone Book Name 7.1.2.1. Description The phoneBookName element is an arbitrary string assigned as an identifier for a phone book. 7.1.2.2. Syntax <!-- The name of the phone book --> <!ELEMENT phoneBookName (#PCDATA)> <!ATTLIST phoneBookName value NOTATION (TEXT) #IMPLIED> 7.1.3. POP Pointer 7.1.3.1. Description The popPointer element is a reference pointing to a POP element for this phone book. 7.1.3.2. Syntax <!-- A pointer to a POP element --> <!ELEMENT popPtr EMPTY> <!ATTLIST popPtr popID IDREFS #REQUIRED> 7.1.4. Setup Pointer 7.1.4.1. Description The setupPointer element is a reference pointing to a Setup element for this phone book. 7.1.4.2. Syntax <!-- A pointer to a Setup element for this phone book --> <!ELEMENT setupPtr EMPTY> <!ATTLIST setupPtr Riegel, Zorn Expires August 1999 [Page 7] Internet-Draft Phone Book XML DTD February 1999 setupID IDREFS #IMPLIED> 7.1.5. Provider Pointer 7.1.5.1. Description The providerPointer element is a reference pointing to a Provider element for this phone book. 7.1.5.2. Syntax <!-- A pointer to a Provider element for this phonebook --> <!ELEMENT providerPtr EMPTY> <!ATTLIST providerPtr providerID IDREFS #IMPLIED> 7.1.6. Support Pointer 7.1.6.1. Description The supportPointer element is a reference pointing to a Support element for this phone book. 7.1.6.2. Syntax <!-- A pointer to a Support element for this phone book --> <!ELEMENT supportPtr EMPTY> <!ATTLIST supportPtr supportID IDREFS #IMPLIED> 7.2. New child elements defined for the Provider element 7.2.1. Provider Name 7.2.1.1. Description The providerName element is a string containing the name of the provider (e.g., "BIGNET Corporation"). 7.2.1.2. Syntax <!-- The name of the provider --> <!ELEMENT providerName (#PCDATA)> <!ATTLIST providerName value NOTATION (TEXT) #IMPLIED> 7.2.2. Provider Icon Riegel, Zorn Expires August 1999 [Page 8] Internet-Draft Phone Book XML DTD February 1999 7.2.2.1. Description The providerIcon attribute contains a JPEG graphic which may be used for 'branding' phone book entries or displayed when dialing. 7.2.2.2. Syntax <!-- An icon in JPEG format --> <!ELEMENT providerIcon (#PCDATA)> <!ATTLIST providerIcon value NOTATION (B64JPG) #IMPLIED> 7.2.3. Provider's World Wide Web URL 7.2.3.1. Description The wwwURL element contains a Uniform Resource Locator (URL) for the provider's Web site, for example, http://www.uu.net. 7.2.3.2. Syntax <!-- A Uniform Resource Locator for the provider's home page --> <!ELEMENT wwwURL (#PCDATA)> <!ATTLIST wwwURL value NOTATION (URL) #IMPLIED> 7.2.4. Provider's Main Email Address 7.2.4.1. Description The generalMailtoURL element contains a URL for the provider's main email address, for example, mailto://contact@uu.net. This URL could be used for general correspondence, complaints, etc. 7.2.4.2. Syntax <!-- A Uniform Resource Locator for the provider's email address --> <!ELEMENT generalMailtoURL (#PCDATA)> <!ATTLIST generalMailtoURL value NOTATION (URL) #IMPLIED> 7.2.5. Billing Inquiry Email Address 7.2.5.1. Description The billingMailtoURL element contains a URL for the provider's billing support email address, for example, mailto://billing@uu.net. This URL could be used to for correspondence regarding billing and payment issues. Riegel, Zorn Expires August 1999 [Page 9] Internet-Draft Phone Book XML DTD February 1999 7.2.5.2. Syntax <!-- A Uniform Resource Locator for the email address to be used for billing inquiries --> <!ELEMENT billingMailtoURL (#PCDATA)> <!ATTLIST billingMailtoURL value NOTATION (URL) #IMPLIED> 7.2.6. Further elements The remainder of the child elements of the Provider element are described in [3]. 7.3. New child elements defined for the POP element 7.3.1. Address Family 7.3.1.1. Description The addrFamily element is an integer which represents the address family to which the value in the address attribute (below) belongs. For POPs offering dial-up network access, the addrFamily attribute will generally contain a value for a telephone network based address family. The current list of IANA-assigned address family numbers is reproduced below for convenience; for an up-to-date list, see [2]. Number Description ------ -------------------------------------- 0 Reserved 1 IP (IP version 4) 2 IP6 (IP version 6) 3 NSAP 4 HDLC (8-bit multidrop) 5 BBN 1822 6 802 (includes all 802 media plus Ethernet "canonical format") 7 E.163 8 E.164 (SMDS, Frame Relay, ATM) 9 F.69 (Telex) 10 X.121 (X.25, Frame Relay) 11 IPX 12 Appletalk 13 Decnet IV 14 Banyan Vines 65535 Reserved Riegel, Zorn Expires August 1999 [Page 10] Internet-Draft Phone Book XML DTD February 1999 7.3.1.2. Syntax <!-- The address family to which the address element below belongs --> <!ELEMENT addrFamily (#PCDATA)> <!ATTLIST addrFamily value NOTATION (INTEGER) #IMPLIED> 7.3.2. Address 7.3.2.1. Description The address element in a binary quantity representing the address of the POP. For POPs offering dial-up network access, the address attribute will generally contain an IA5 string representing a telephone number, formatted in standard fashion [4] (e.g. "+ 1 234 5678"). 7.3.2.2. Syntax <!-- A network address for this POP --> <!ELEMENT address (#PCDATA)> <!ATTLIST address value NOTATION (BITSTRING) #IMPLIED> 7.3.3. Media 7.3.3.1. Description The media element describes the types of media supported by this POP. The following values are defined: in +0.3i Type Value ----------- ----- Modem 1 ISDN 2 ATM 3 Frame Relay 4 X.25 5 SMDS 6 NH 4 Syntax <!-- The types of media supported by this POP --> <!ELEMENT media (#PCDATA)> <!ATTLIST media value NOTATION (INTEGER) #IMPLIED> Riegel, Zorn Expires August 1999 [Page 11] Internet-Draft Phone Book XML DTD February 1999 7.3.4. Entry Version NH 4 Description The entryVersion element is an integer representing the version of the POP object; it is a monotonically increasing counter which should be incremented each time the object is modified. This attribute may be useful in merging and updating phone books. 7.3.4.1. Syntax <!-- version number of POP object --> <!ELEMENT entryVersion (#PCDATA)> <!ATTLIST entryVersion value NOTATION (INTEGER) #IMPLIED> 7.3.5. Encoding Type 7.3.5.1. Description The encodingType element is an integer representing the type of encoding used within a specific address family The value '0' is reserved and represents the native encoding. 7.3.5.2. Syntax <!-- The type of encoding used within this address family --> <!ELEMENT entryVersion (#PCDATA)> <!ATTLIST entryVersion value NOTATION (INTEGER) #IMPLIED> 7.3.6. Modem Protocols 7.3.6.1. Description in +0.3i The modemProtocols element is a bit string representing the modem protocols supported by the access devices that can be reached at address. The initially defined modem protocol flags are listed in the table below. All 'Position' values are in hexadecimal, all 'Speed' values are in bits per second. If the bit in 'Position' is 1, 'Protocol' is supported; otherwise, 'Protocol' is unsupported. For example, the string 00110001 (0x31) means that V.21, V.32bis and V.34 are supported while V.22, V.29 and V.32 are not. Name Position Duplex Speed Protocol ---- -------- ------ ----- ------------- V21 0x0001 Full 300 ITU-T V.21 V22 0x0002 Full 1200 ITU-T V.22 V29 0x0004 Half 9600 ITU-T V.29 V32 0x0008 Full 9600 ITU-T V.32 V32b 0x0010 Full 14.4k ITU-T V.32bis V34 0x0020 Full 28.8k ITU-T V.34 VF 0x0040 Full V.FAST Riegel, Zorn Expires August 1999 [Page 12] Internet-Draft Phone Book XML DTD February 1999 Question: Are these flags useful? If so, are there more that need to be added? 7.3.6.2. Syntax <!-- A bit string representing the modem protocols supported by the access devices at this POP --> <!ELEMENT modemProtocols (#PCDATA)> <!ATTLIST modemProtocols value NOTATION (BITSTRING) #IMPLIED> 7.3.7. ISDN Protocols 7.3.7.1. Description The isdnProtocols element is a bit string representing the ISDN protocols supported by the access devices that can be reached at address. The initially defined ISDN protocols are listed in the table below. All 'Value. values are in hexadecimal, all 'Speed' values are in bits per second. If the bit in 'Position' is 1, 'Protocol' is supported; otherwise, 'Protocol' is unsupported. For example, the string 00001101 (0x0d) means that V.120 is supported at both 56K and 64K bps while V.110 is supported only at 19.2K bps. Name Value Speed Meaning ----- ------ ----- ----------- V110L 0x0001 19.2k ITU-T V.110 V110H 0x0002 38.4k ITU-T V.110 V120L 0x0004 56k ITU-T V.120 V120H 0x0008 64k ITU-T V.120 Question: Are the ISDN flags useful? If so, should there be more? 7.3.7.2. Syntax <!-- A bit string representing the ISDN flavors supported by the access devices at this POP --> <!ELEMENT isdnProtocols (#PCDATA)> <!ATTLIST isdnProtocols value NOTATION (BITSTRING) #IMPLIED> 7.3.8. City 7.3.8.1. Description in +0.3i The city element contains the name of the city in which the POP is located (not the city(s) from which it is accessible by a local call). Riegel, Zorn Expires August 1999 [Page 13] Internet-Draft Phone Book XML DTD February 1999 7.3.8.2. Syntax <!-- The name of the city in which this POP is located --> <!ELEMENT city (#PCDATA)> <!ATTLIST city value NOTATION (TEXT) #IMPLIED> 7.3.9. Region NH 4 Description The region element contains the name of the region in which the POP is located. In the United States, this would be the name of a state or (for Washington, D.C.) administrative district. In other countries, it might be the name of a province, parish or county. 7.3.9.1. Syntax <!-- The name of the region in which this POP is located --> <!ELEMENT region (#PCDATA)> <!ATTLIST region value NOTATION (TEXT) #IMPLIED> 7.3.10. Country 7.3.10.1. Description The country element contains the name of the country in which the POP is located. The country name may be abbreviated (e.g., "USA" for the United States of America or "UK" for the United Kingdom) but if abbreviations are used the usage must be consistent within a given phone book. 7.3.10.2. Syntax <!-- The name of the country in which this POP is located --> <!ELEMENT country (#PCDATA)> <!ATTLIST country value NOTATION (TEXT) #IMPLIED> 7.3.11. Country Code 7.3.11.1. Description The countryCode element indicates the international dialing prefix for the country in which the POP is located. NH 4 Syntax <!-- ITU dialing code for the country in which this POP is located --> <!ELEMENT countryCode (#PCDATA)> <!ATTLIST countryCode value NOTATION (INTEGER) #IMPLIED> Riegel, Zorn Expires August 1999 [Page 14] Internet-Draft Phone Book XML DTD February 1999 7.3.12. Minimum Data Rate 7.3.12.1. Description The minBitsPerSecond element indicates the minimum data rate (in bits/second) supported by the access devices at the POP. 7.3.12.2. Syntax <!-- Minimum data rate supported by this POP' in bits/second --> <!ELEMENT minBitsPerSecond (#PCDATA)> <!ATTLIST minBitsPerSecond value NOTATION (INTEGER) #IMPLIED> 7.3.13. Maximum Data Rate 7.3.13.1. Description The maxBitsPerSecond element indicates the maximum data rate (in bits/second) supported by the access devices at the POP. 7.3.13.2. Syntax <!-- Maximum data rate supported by this POP, in bits/second --> <!ELEMENT maxBitsPerSecond (#PCDATA)> <!ATTLIST maxBitsPerSecond value NOTATION (INTEGER) #IMPLIED> 7.3.14. Area Code 7.3.14.1. Description The areaCode element contains the area or city code component of the telephone number in the 'address' element (if any) associated with this POP. 7.3.14.2. Syntax <!-- Area or city code component of the telephone number in the accessTelephoneNumber element associated with this POP --> <!ELEMENT areaCode (#PCDATA)> <!ATTLIST areaCode value NOTATION (INTEGER) #IMPLIED> 7.3.15. Unicast Routing Protocols 7.3.15.1. Description The unicastRoutingProtocols element is a bitstring representing the unicast routing protocols supported by this POP. The initially defined values are listed in the table below. If the bit in 'Position' is 1, 'Protocol' is supported; otherwise, 'Protocol' is Riegel, Zorn Expires August 1999 [Page 15] Internet-Draft Phone Book XML DTD February 1999 unsupported. Position Protocol -------- -------- 0x0001 Static 0x0002 RIP v1 0x0004 RIP v2 0x0008 OSPF 0x0010 IS-IS 0x0020 IGRP 0x0040 EIGRP 0x0080 BGP 7.3.15.2. Syntax <!-- A bit string representing the unicast routing protocols supported by the access devices at this POP --> <!ELEMENT unicastRoutingProtocols (#PCDATA)> <!ATTLIST unicastRoutingProtocols value NOTATION (BITSTRING) #IMPLIED> 7.3.16. Multicast Routing Protocols 7.3.16.1. Description The multicastRoutingProtocols element is a bitstring representing the multicast routing protocols supported by this POP. The initially defined values are listed in the table below. If the bit in 'Position' is 1, 'Protocol' is supported; otherwise, 'Protocol' is unsupported. Position Protocol -------- ---------- 0x0001 Static 0x0002 DVMRP 0x0004 SM-PIM 0x0008 DM-PIM 0x0010 CBT v1 0x0020 CBT v2 0x0040 BGMP 0x0080 Proxy IGMP 7.3.16.2. Syntax <!-- A bit string representing the multicast routing protocols supported by the access devices at this POP --> <!ELEMENT multicastRoutingProtocols (#PCDATA)> <!ATTLIST multicastRoutingProtocols value NOTATION (BITSTRING) #IMPLIED> Riegel, Zorn Expires August 1999 [Page 16] Internet-Draft Phone Book XML DTD February 1999 7.3.17. Dial Script Type 7.3.17.1. Description The dialScript element indicates the type of dialing script that should be used when connecting to this POP. Question: What kinds of scripts are there? 7.3.17.2. Syntax <!-- Type of the dial script to be used --> <!ELEMENT dialScriptType (#PCDATA)> <!ATTLIST dialScriptType value NOTATION (TEXT) #IMPLIED> 7.3.18. Dialing Script 7.3.18.1. Description The dialScript element contains the dialing script to be used when connecting to this POP. 7.3.18.2. Syntax <!-- The dial script to be used --> <!ELEMENT dialScript (#PCDATA)> <!ATTLIST dialScript value NOTATION (TEXT) #IMPLIED> 7.3.19. Pricing Information 7.3.19.1. Description The pricing element is a free-form string representing pricing information for this POP. It may be anything from a simple string indicating relative expense (e.g., "$$$$" for a very expensive POP) to a paragraph describing time-of-day and other differential pricing variables. 7.3.19.2. Syntax <!-- Pricing information for this POP --> <!ELEMENT pricing (#PCDATA)> <!ATTLIST pricing value NOTATION (TEXT) #IMPLIED> 7.3.20. Tunneling Protocols Riegel, Zorn Expires August 1999 [Page 17] Internet-Draft Phone Book XML DTD February 1999 7.3.20.1. Description The tunnelingProtocols element is a bitstring representing the tunneling protocols supported by this POP. The initially defined values are listed in the table below. If the bit in 'Position' is 1, 'Protocol' is supported; otherwise, 'Protocol' is unsupported. Position Protocol -------- ------------------ 0x0001 PPTP 0x0002 L2F 0x0004 L2TP 0x0008 ATMP 0x0010 VTP 0x0020 IP AH Tunnel Mode 0x0040 IP-IP 0x0080 Minimal IP-IP 0x0100 IP ESP Tunnel Mode 0x0200 GRE 0x0400 Bay DVS 7.3.20.2. Syntax <!-- A bit string representing the tunneling protocols supported by the access devices at this POP --> <!ELEMENT (#PCDATA)> <!ATTLIST value NOTATION (BITSTRING) #IMPLIED> 7.3.21. POP Properties 7.3.21.1. Description The popProperties element is a bitstring representing a variety of Boolean properties characterizing this POP. The initially defined properties are listed in the table below. If the bit in 'Position' is 1, 'Property' is supported; otherwise, 'Property' is unsupported. in +0.3i Position Property -------- ---------------------- 0x0001 Multilink 0x0002 Mobile IP 0x0004 Multicast Reception 0x0008 Multicast Transmission 7.3.21.2. Syntax <!-- A bit string representing a variety of Boolean properties characterizing this POP --> <!ELEMENT popProperties (#PCDATA)> Riegel, Zorn Expires August 1999 [Page 18] Internet-Draft Phone Book XML DTD February 1999 <!ATTLIST popProperties value NOTATION (BITSTRING) #IMPLIED> 7.3.22. POP Setup Pointer 7.3.22.1. Description The popSetupPointer element is a Distinguished Name which points to a Setup object for this POP. 7.3.22.2. Syntax <!-- A pointer to a Setup object for this POP --> <!ELEMENT popSetupPointer EMPTY> <!ATTLIST popSetupPointer popSetupID IDREF #REQUIRED> 7.3.23. POP Support Pointer 7.3.23.1. Description The popSupportPointer element is a Distinguished Name which points to a Support object for this POP. 7.3.23.2. Syntax <!-- A pointer to a Support object for this POP --> <!ELEMENT popSupportPointer EMPTY> <!ATTLIST popSupportPointer popSupportID IDREF #REQUIRED> 7.3.24. POP Provider Pointer 7.3.24.1. Description The popProviderPointer element is a Distinguished Name which points to a Provider object for this POP. 7.3.24.2. Syntax <!-- A pointer to a Provider object for this POP --> <!ELEMENT popProviderPointer EMPTY> <!ATTLIST popProviderPointer popProviderID IDREF #REQUIRED> 7.4. New child elements defined for the Support element Riegel, Zorn Expires August 1999 [Page 19] Internet-Draft Phone Book XML DTD February 1999 7.4.1. Support Telephone Number 7.4.1.1. Description The supportTelephoneNumber element contains a number that may be called to reach the support center for a particular provider or POP. This element is basically a string and should contain the entire telephone number in international form, e.g., "+1 425 838 8080". 7.4.1.2. Syntax in +0.3i <!-- The number to be dialed to contact customer support for this POP or provider --> <!ELEMENT supportTelephoneNumber (#PCDATA)> <!ATTLIST supportTelephoneNumber value NOTATION (PHONENBR) #IMPLIED> 7.4.2. Support Languages 7.4.2.1. Description The supportLanguages element contains a comma-separated list of languages spoken by the staff at the support center at supportTelephoneNumber. Question: Is there a standard way to represent languages (like country codes for phone numbers)? 7.4.2.2. Syntax <!-- A comma-separated list of languages spoken by support personnel for this POP or provider --> <!ELEMENT supportLanguages (#PCDATA)> <!ATTLIST supportLanguages value NOTATION (TEXT) #IMPLIED> 7.4.3. Support Email Address 7.4.3.1. Description The supportMailtoURL element contains a URL for the provider's customer support email address, for example, mailto://support@uu.net. This URL could be used to contact customer support personnel regarding non-urgent issues. 7.4.3.2. Syntax <!-- A Uniform Resource Locator for the provider's customer support email address --> <!ELEMENT supportMailtoURL (#PCDATA)> <!ATTLIST supportMailtoURL value NOTATION (URL) #IMPLIED> Riegel, Zorn Expires August 1999 [Page 20] Internet-Draft Phone Book XML DTD February 1999 7.5. New child elements defined for the Setup element 7.5.1. DNS Server Address 7.5.1.1. Description The dnsServerAddress element represents the IP address of the Domain Name Service (DNS) server which should be used when connected to this POP. The address is represented in the form of a string in dotted- decimal notation (e.g., 192.168.101.1). 7.5.1.2. Syntax <!-- Domain Name Server IP address in dotted decimal notation --> <!ELEMENT dnsServerAddress (#PCDATA)> <!ATTLIST dnsServerAddress value NOTATION (TEXT) #IMPLIED> 7.5.2. NNTP Server Name 7.5.2.1. Description The nntpServerName element contains the fully qualified domain name (FQDN) of the Network News Transfer Protocol (NNTP) server which should be used when connected to this POP. 7.5.2.2. Syntax <!-- Name of an NNTP server --> <!ELEMENT nntpServerName (#PCDATA)> <!ATTLIST nntpServerName value NOTATION (TEXT) #IMPLIED> 7.5.3. SMTP Server Name 7.5.3.1. Description The smtpServerName element contains the FQDN of the Simple Mail Transfer Protocol (SMTP) server which should be used when connected to this POP. 7.5.3.2. Syntax <!-- Name of an SMTP mail server --> <!ELEMENT smtpServerName (#PCDATA)> <!ATTLIST smtpServerName value NOTATION (TEXT) #IMPLIED> Riegel, Zorn Expires August 1999 [Page 21] Internet-Draft Phone Book XML DTD February 1999 7.5.4. POP3 Server Name 7.5.4.1. Description The popServerName element contains the FQDN of the Post Office Protocol (POP) server which should be used when connected to this POP. 7.5.4.2. Syntax <!-- Name of an POP3 mail server --> <!ELEMENT popServerName (#PCDATA)> <!ATTLIST popServerName value NOTATION (TEXT) #IMPLIED> 7.5.5. IMAP Server Name 7.5.5.1. Description The imapServerName element contains the FQDN of the Internet Mail Access Protocol (IMAP) server which should be used when connected to this POP. 7.5.5.2. Syntax <!-- Name of an IMAP4 server --> <!ELEMENT imapServerName (#PCDATA)> <!ATTLIST imapServerName value NOTATION (TEXT) #IMPLIED> 7.5.6. WWW Proxy 7.5.6.1. Description The wwwProxyServerName element contains the FQDN of the World Wide Web (WWW) proxy server which should be used when connected to this POP. 7.5.6.2. Syntax <!-- Name of an WWW Proxy --> <!ELEMENT wwwProxyServerName (#PCDATA)> <!ATTLIST wwwProxyServerName value NOTATION (TEXT) #IMPLIED> 7.5.7. FTP Proxy 7.5.7.1. Description The ftpProxyServerName element contains the FQDN of the File Transfer Protocol (FTP) proxy server which should be used when connected to this POP. Riegel, Zorn Expires August 1999 [Page 22] Internet-Draft Phone Book XML DTD February 1999 7.5.7.2. Syntax <!-- Name of an FTP Proxy --> <!ELEMENT ftpProxyServerName (#PCDATA)> <!ATTLIST ftpProxyServerName value NOTATION (TEXT) #IMPLIED> 7.5.8. Winsock Proxy 7.5.8.1. Description ThewinsockProxyServerName element contains the FQDN of the Windows Socket (Winsock) proxy server which should be used when connected to this POP. 7.5.8.2. Syntax <!-- Name of an Winsock Proxy --> <!ELEMENT winsockProxyServerName (#PCDATA)> <!ATTLIST winsockProxyServerName value NOTATION (TEXT) #IMPLIED> 7.5.9. Default Gateway Address 7.5.9.1. Description The defaulttGatewayAddress element represents the address of the default gateway which should be used when connected to this POP. The address is represented in the form of a string in dotted-decimal notation (e.g., 192.168.101.1). 7.5.9.2. Syntax <!-- Default Gateway IP address (in dotted decimal notation) --> NAME '<!ELEMENT defaultGatewayAddress (#PCDATA)> <!ATTLIST defaultGatewayAddress value NOTATION (TEXT) #IMPLIED> 7.5.10. User Name Suffix 7.5.10.1. Description The userNameSuffix element represents a string which should be concatenated to the base username. For example, if the base username is "userA" and the value of this element is "@bigco.com", the resulting augmented username would be "userA@bigco.com". An intelligent dialer may concatenate the string automatically. Note that both the userNameSuffix and the userNamePrefix (below) may be applied to the same base username. NH 4 Syntax <!-- User Name suffix --> <!ELEMENT userNameSuffix (#PCDATA)> Riegel, Zorn Expires August 1999 [Page 23] Internet-Draft Phone Book XML DTD February 1999 <!ATTLIST userNameSuffix value NOTATION (TEXT) #IMPLIED> 7.5.11. User Name Prefix 7.5.11.1. Description The userNamePrefix element represents a string to which the base username should be concatenated. For example, if the base username is "userB" and the value of this element is "BIGCO/" the resulting augmented username would be "BIGCO/userB". An intelligent dialer may perform the concatenation automatically. Note that both the userNameSuffix (above) and the userNamePrefix may be applied to the same base username. 7.5.11.2. Syntax <!-- User Name prefix --> <!ELEMENT userNamePrefix (#PCDATA)> <!ATTLIST userNamePrefix value NOTATION (TEXT) #IMPLIED> 8. Complete XML DTD for the roaming phone book <?xml version="1.0" encoding="UTF-8"?> <!-- XML DTD for Roaming Phone Book --> <!-- Phone book value type notation declarations --> <!NOTATION TEXT PUBLIC "-//IETF/roamPhoneBook/NOTATION value Type Text"> <!NOTATION INTEGER PUBLIC "-//IETF/roamPhoneBook/NOTATION value Type Integer"> <!NOTATION URL PUBLIC "-//IETF/roamPhoneBook/NOTATION value Type Uri"> <!NOTATION BITSTRING PUBLIC "-//IETF/roamPhoneBook/NOTATION value Type BitString"> <!NOTATION PHONENBR PUBLIC "-//IETF/roamPhoneBook/NOTATION value Type PhoneNumber"> <!NOTATION B64JPG PUBLIC "-//IETF/roamPhoneBook/NOTATION value Type Base64_encoded_JPEG_image"> <!ELEMENT phoneBook phoneBookVersion, phoneBookName, popPtr+, setupPtr?, providerPtr?, Riegel, Zorn Expires August 1999 [Page 24] Internet-Draft Phone Book XML DTD February 1999 supportPtr?> <!ELEMENT provider providerName, providerIcon?, wwwURL?, generalMailtoURL?, billingMailtoURL?, businessCategory*, x121Address*, registeredAddress*, destinationIndicator?, preferredDeliveryMethod?, telexNumber?, teletexTerminalIdentifier?, telephoneNumber?, internationalISDNNumber?, facsimileTelephoneNumber?, street?, postOfficeBox?, postalCode?, postalAddress?, physicalDeliveryOfficeName?, description?, supportPtr* > <!ATTLIST provider id ID #REQUIRED> <!ELEMENT pop addrFamily, address, media+, entryVersion, encodingType?, modemProtocols?, isdnProtocols?, city?, region?, country?, countryCode?, minBitsPerSecond?, maxBitsPerSecond?, areaCode?, unicastRoutingProtocols?, multicastRoutingProtocols?, dialScriptType?, dialScript?, pricing*, Riegel, Zorn Expires August 1999 [Page 25] Internet-Draft Phone Book XML DTD February 1999 vpnProtocols?, popProperties?, popSetupPointer?, popSupportPointer?, popProviderPointer? > <!ATTLIST pop id ID #REQUIRED> <!ELEMENT support supportTelephoneNumber?, supportLanguages*, supportMailtoURL? > <!ATTLIST support id ID #REQUIRED> <!ELEMENT setup dnsServerAddress?, nntpServerName?, smtpServerName?, popServerName?, imapServerName?, wwwProxyServerName?, ftpProxyServerName?, winsockProxyServerName?, defaultGatewayAddress?, userNamePrefix?, userNameSuffix? > <!ATTLIST setup id ID #REQUIRED> <!-- Version number of the phone book --> <!ELEMENT phoneBookVersion (#PCDATA)> <!ATTLIST phoneBookVersion value NOTATION (INTEGER) #IMPLIED> <!-- The name of the phone book --> <!ELEMENT phoneBookName (#PCDATA)> <!ATTLIST phoneBookName value NOTATION (TEXT) #IMPLIED> <!-- A pointer to a POP object --> <!ELEMENT popPtr EMPTY> <!ATTLIST popPtr popID IDREFS #REQUIRED> <!-- A pointer to a Setup object for this phone book --> <!ELEMENT setupPtr EMPTY> <!ATTLIST setupPtr Riegel, Zorn Expires August 1999 [Page 26] Internet-Draft Phone Book XML DTD February 1999 setupID IDREFS #IMPLIED> <!-- A pointer to a Provider object for this phonebook --> <!ELEMENT providerPtr EMPTY> <!ATTLIST providerPtr providerID IDREFS #IMPLIED> <!-- A pointer to a Support object for this phone book --> <!ELEMENT supportPtr EMPTY> <!ATTLIST supportPtr supportID IDREFS #IMPLIED> <!-- The name of the provider --> <!ELEMENT providerName (#PCDATA)> <!ATTLIST providerName value NOTATION (TEXT) #IMPLIED> <!-- An icon in JPEG format --> <!ELEMENT providerIcon (#PCDATA)> <!ATTLIST providerIcon value NOTATION (B64JPG) #IMPLIED> <!-- A Uniform Resource Locator for the provider's home page --> <!ELEMENT wwwURL (#PCDATA)> <!ATTLIST wwwURL value NOTATION (URL) #IMPLIED> <!-- A Uniform Resource Locator for the provider's email address --> <!ELEMENT generalMailtoURL (#PCDATA)> <!ATTLIST generalMailtoURL value NOTATION (URL) #IMPLIED> <!-- A Uniform Resource Locator for the email address to be used for billing inquiries --> <!ELEMENT billingMailtoURL (#PCDATA)> <!ATTLIST billingMailtoURL value NOTATION (URL) #IMPLIED> <!-- Declaration of further Provider elements --> <!ELEMENT businessCategory (#PCDATA)> <!ELEMENT x121Address (#PCDATA)> <!ELEMENT registeredAddress (#PCDATA)> <!ELEMENT destinationIndicator (#PCDATA)> Riegel, Zorn Expires August 1999 [Page 27] Internet-Draft Phone Book XML DTD February 1999 <!ELEMENT preferredDeliveryMethod (#PCDATA)> <!ELEMENT telexNumber (#PCDATA)> <!ATTLIST telexNumber value NOTATION (PHONENBR) #IMPLIED> <!ELEMENT teletexTerminalIdentifier (#PCDATA)> <!ATTLIST teletexTerminalIdentifier value NOTATION (PHONENBR) #IMPLIED> <!ELEMENT telephoneNumber (#PCDATA)> <!ATTLIST telephoneNumber value NOTATION (PHONENBR) #IMPLIED> <!ELEMENT internationalISDNNumber (#PCDATA)> <!ATTLIST internationalISDNNumber value NOTATION (PHONENBR) #IMPLIED> <!ELEMENT facsimileTelephoneNumber (#PCDATA)> <!ATTLIST facsimileTelephoneNumber value NOTATION (PHONENBR) #IMPLIED> <!ELEMENT street (#PCDATA)> <!ELEMENT postOfficeBox (#PCDATA)> <!ELEMENT postalCode (#PCDATA)> <!ELEMENT postalAddress (#PCDATA)> <!ELEMENT physicalDeliveryOfficeName (#PCDATA)> <!ELEMENT description (#PCDATA)> <!-- The address family to which the address attribute below belongs --> <!ELEMENT addrFamily (#PCDATA)> <!ATTLIST addrFamily value NOTATION (INTEGER) #IMPLIED> <!-- A network address for this POP --> <!ELEMENT address (#PCDATA)> <!ATTLIST address value NOTATION (BITSTRING) #IMPLIED> <!-- The types of media supported by this POP --> <!ELEMENT media (#PCDATA)> Riegel, Zorn Expires August 1999 [Page 28] Internet-Draft Phone Book XML DTD February 1999 <!ATTLIST media value NOTATION (INTEGER) #IMPLIED> <!-- version number of POP object --> <!ELEMENT entryVersion (#PCDATA)> <!ATTLIST entryVersion value NOTATION (INTEGER) #IMPLIED> <!-- The type of encoding used within this address family --> <!ELEMENT entryVersion (#PCDATA)> <!ATTLIST entryVersion value NOTATION (INTEGER) #IMPLIED> <!-- A bit string representing the modem protocols supported by the access devices at this POP --> <!ELEMENT modemProtocols (#PCDATA)> <!ATTLIST modemProtocols value NOTATION (BITSTRING) #IMPLIED> <!-- A bit string representing the ISDN flavors supported by the access devices at this POP --> <!ELEMENT isdnProtocols (#PCDATA)> <!ATTLIST isdnProtocols value NOTATION (BITSTRING) #IMPLIED> <!-- The name of the city in which this POP is located --> <!ELEMENT city (#PCDATA)> <!ATTLIST city value NOTATION (TEXT) #IMPLIED> <!-- The name of the region in which this POP is located --> <!ELEMENT region (#PCDATA)> <!ATTLIST region value NOTATION (TEXT) #IMPLIED> <!-- The name of the country in which this POP is located --> <!ELEMENT country (#PCDATA)> <!ATTLIST country value NOTATION (TEXT) #IMPLIED> <!-- ITU dialing code for the country in which this POP is located --> <!ELEMENT countryCode (#PCDATA)> <!ATTLIST countryCode value NOTATION (INTEGER) #IMPLIED> <!-- Minimum data rate supported by this POP' in bits/second --> Riegel, Zorn Expires August 1999 [Page 29] Internet-Draft Phone Book XML DTD February 1999 <!ELEMENT minBitsPerSecond (#PCDATA)> <!ATTLIST minBitsPerSecond value NOTATION (INTEGER) #IMPLIED> <!-- Maximum data rate supported by this POP, in bits/second --> <!ELEMENT maxBitsPerSecond (#PCDATA)> <!ATTLIST maxBitsPerSecond value NOTATION (INTEGER) #IMPLIED> <!-- Area or city code component of the telephone number in the accessTelephoneNumber attribute associated with this POP --> <!ELEMENT areaCode (#PCDATA)> <!ATTLIST areaCode value NOTATION (INTEGER) #IMPLIED> <!-- A bit string representing the unicast routing protocols supported by the access devices at this POP --> <!ELEMENT unicastRoutingProtocols (#PCDATA)> <!ATTLIST unicastRoutingProtocols value NOTATION (BITSTRING) #IMPLIED> <!-- A bit string representing the multicast routing protocols supported by the access devices at this POP --> <!ELEMENT multicastRoutingProtocols (#PCDATA)> <!ATTLIST multicastRoutingProtocols value NOTATION (BITSTRING) #IMPLIED> <!-- Type of the dial script to be used --> <!ELEMENT dialScriptType (#PCDATA)> <!ATTLIST dialScriptType value NOTATION (TEXT) #IMPLIED> <!-- The dial script to be used --> <!ELEMENT dialScript (#PCDATA)> <!ATTLIST dialScript value NOTATION (TEXT) #IMPLIED> <!-- Pricing information for this POP --> <!ELEMENT pricing (#PCDATA)> <!ATTLIST pricing value NOTATION (TEXT) #IMPLIED> <!-- A bit string representing the tunneling protocols supported by the access devices at this POP --> <!ELEMENT (#PCDATA)> <!ATTLIST value NOTATION (BITSTRING) #IMPLIED> Riegel, Zorn Expires August 1999 [Page 30] Internet-Draft Phone Book XML DTD February 1999 <!-- A bit string representing a variety of Boolean properties characterizing this POP --> <!ELEMENT popProperties (#PCDATA)> <!ATTLIST popProperties value NOTATION (BITSTRING) #IMPLIED> <!-- A pointer to a Setup object for this POP --> <!ELEMENT popSetupPointer EMPTY> <!ATTLIST popSetupPointer popSetupID IDREF #REQUIRED> <!-- A pointer to a Support object for this POP --> <!ELEMENT popSupportPointer EMPTY> <!ATTLIST popSupportPointer popSupportID IDREF #REQUIRED> <!-- A pointer to a Provider object for this POP --> <!ELEMENT popProviderPointer EMPTY> <!ATTLIST popProviderPointer popProviderID IDREF #REQUIRED> <!-- The number to be dialed to contact customer support for this POP or provider --> <!ELEMENT supportTelephoneNumber (#PCDATA)> <!ATTLIST supportTelephoneNumber value NOTATION (PHONENBR) #IMPLIED> <!-- A comma-separated list of languages spoken by support personnel for this POP or provider --> <!ELEMENT supportLanguages (#PCDATA)> <!ATTLIST supportLanguages value NOTATION (TEXT) #IMPLIED> <!-- A Uniform Resource Locator for the provider's customer support email address --> <!ELEMENT supportMailtoURL (#PCDATA)> <!ATTLIST supportMailtoURL value NOTATION (URL) #IMPLIED> <!-- Domain Name Server IP address in dotted decimal notation --> <!ELEMENT dnsServerAddress (#PCDATA)> <!ATTLIST dnsServerAddress value NOTATION (TEXT) #IMPLIED> <!-- Name of an NNTP server --> <!ELEMENT nntpServerName (#PCDATA)> <!ATTLIST nntpServerName value NOTATION (TEXT) #IMPLIED> Riegel, Zorn Expires August 1999 [Page 31] Internet-Draft Phone Book XML DTD February 1999 <!-- Name of an SMTP mail server --> <!ELEMENT smtpServerName (#PCDATA)> <!ATTLIST smtpServerName value NOTATION (TEXT) #IMPLIED> <!-- Name of an POP3 mail server --> <!ELEMENT popServerName (#PCDATA)> <!ATTLIST popServerName value NOTATION (TEXT) #IMPLIED> <!-- Name of an IMAP4 server --> <!ELEMENT imapServerName (#PCDATA)> <!ATTLIST imapServerName value NOTATION (TEXT) #IMPLIED> <!-- Name of an WWW Proxy --> <!ELEMENT wwwProxyServerName (#PCDATA)> <!ATTLIST wwwProxyServerName value NOTATION (TEXT) #IMPLIED> <!-- Name of an FTP Proxy --> <!ELEMENT ftpProxyServerName (#PCDATA)> <!ATTLIST ftpProxyServerName value NOTATION (TEXT) #IMPLIED> <!-- Name of an Winsock Proxy --> <!ELEMENT winsockProxyServerName (#PCDATA)> <!ATTLIST winsockProxyServerName value NOTATION (TEXT) #IMPLIED> <!-- Default Gateway IP address (in dotted decimal notation) --> NAME '<!ELEMENT defaultGatewayAddress (#PCDATA)> <!ATTLIST defaultGatewayAddress value NOTATION (TEXT) #IMPLIED> <!-- User Name suffix --> <!ELEMENT userNameSuffix (#PCDATA)> <!ATTLIST userNameSuffix value NOTATION (TEXT) #IMPLIED> <!-- User Name prefix --> <!ELEMENT userNamePrefix (#PCDATA)> <!ATTLIST userNamePrefix value NOTATION (TEXT) #IMPLIED> <!-- end of dtd --> Riegel, Zorn Expires August 1999 [Page 32] Internet-Draft Phone Book XML DTD February 1999 9. Security Considerations None (submissions welcome). 10. References [1] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997 [2] Reynolds, J. and Postel, J., "ASSIGNED NUMBERS", STD 2, RFC 1700, October 1994 [3] Barker, P. and Kille, S., "The COSINE and Internet X.500 Schema", RFC 1274, November 1991 [4] ITU Rec. E.123, "Notation for national and international telephone numbers", 1988 [5] "Extensible Markup Language (XML) 1.0" W3C Recommendation 10-February-1998 http://www.w3org.org/TR/1998/REC-xml-19980210 11. Acknowledgements Thanks to Bernard Aboba (aboba@internaut.com), Jay Farhat (jfarhat@ipass.com), Butch Anton (butch@ipass.com), Quentin Miller (quentinm@microsoft.com), and Ken Crocker (kcrocker@microsoft.com) for salient input and review. 12. Author's Addresses Questions about this memo can be directed to: Max Riegel Siemens AG Hofmannstr. 51 Munich, 81359 Germany Phone: +49 89 722 49557 E-Mail: maximilian.riegel@icn.siemens.de Riegel, Zorn Expires August 1999 [Page 33] Internet-Draft Phone Book XML DTD February 1999 Glen Zorn Microsoft Corporation One Microsoft Way Redmond, Washington 98052 Phone: +1 425 703 1559 E-Mail: glennz@microsoft.com 13. Expiration Date This memo is filed as draft-ietf-roamops-phonebook-xml-00.txt and expires on August 15, 1999. Riegel, Zorn Expires August 1999 [Page 34]