rfc3017.txt

RFC 的详细文档！

   Syntax:
      <!-- The number to be dialed to contact customer support
           for this POP or provider -->
      <!ELEMENT supportTelephoneNumber (#PCDATA)>




Riegel & Zorn               Standards Track                    [Page 20]

RFC 3017           Roaming Access Phone Book XML DTD       December 2000


6.3.2.  Support Email Address

   The supportMailtoURL element contains a URL for the provider's
   customer support email address, e.g., mailto:[e-mail].  This
   URL could be used to contact customer support personnel regarding
   non-urgent issues.

   Syntax:
      <!-- A Uniform Resource Locator for the provider's customer
           support email address -->
      <!ELEMENT supportMailtoURL (#PCDATA)>

6.4.  Information elements defined for the provider element

6.4.1.  Provider Name

   The providerName element is a string containing the name of the
   provider (e.g., "BIGNET Corporation").

   Syntax:
      <!-- The name of the provider -->
      <!ELEMENT providerName (#PCDATA)>

6.4.2.  Provider Icon

   The providerIcon attribute contains a BASE64 encoded JPEG or GIF
   image which may be used for 'branding' phone book entries or
   displayed when dialing.

   Syntax:
      <!-- An icon in BASE64 encoded JPEG or GIF format -->
      <!ELEMENT providerIcon (#PCDATA)>
      <!ATTLIST providerIcon
              value NOTATION (B64JPG | B64GIF) #IMPLIED>

6.4.3.  Provider's World Wide Web URL

   The wwwURL element contains a Uniform Resource Locator (URL) for the
   provider's Web site, for example, http://www.uu.net.

   Syntax:
      <!-- A Uniform Resource Locator for the provider's home page -->
      <!ELEMENT wwwURL (#PCDATA)>








Riegel & Zorn               Standards Track                    [Page 21]

RFC 3017           Roaming Access Phone Book XML DTD       December 2000


6.4.4.  Provider's Main Email Address

   The generalMailtoURL element contains a URL for the provider's main
   email address, for example, mailto:[e-mail].  This URL could be
   used for general correspondence, complaints, etc.

   Syntax:
      <!-- A Uniform Resource Locator for the provider's
                  email address -->
      <!ELEMENT generalMailtoURL (#PCDATA)>

6.4.5.  Billing Inquiry Email Address

   The billingMailtoURL element contains a URL for the provider's
   billing support email address, for example, mailto:[e-mail].
   This URL could be used to for correspondence regarding billing and
   payment issues.

   Syntax:
      <!-- A Uniform Resource Locator for the email
                  address to be used for billing inquiries -->
      <!ELEMENT billingMailtoURL (#PCDATA)>

6.4.6.  Further elements

   The remainder of the information elements of the provider element are
   described in principle in [3].

7.  Complete XML DTD for the roaming phone book

   <?xml version="1.0" encoding="UTF-8"?>

   <!-- Parameter entity declaration -->
   <!-- ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
   <!-- This section will be maintained by IANA and can be direct
        referenced by the DTD specification by means of an external
        parameter entity. -->

   <!ENTITY % addressFamily "(E164|X121)" >

   <!ENTITY % mediaTypes "(viaMODEM|viaISDN|viaATM|viaFR|viaX25)+" >

   <!ENTITY % modemProtocols "(V21|V22|V29|V32|V32B|V34|V34B|V90)" >

   <!ENTITY % isdnProtocols "(V110L|V110H|V120L|V120H|X75|HDLC)">

   <!ENTITY % atmProtocols "(RFC2364)">




Riegel & Zorn               Standards Track                    [Page 22]

RFC 3017           Roaming Access Phone Book XML DTD       December 2000


   <!ENTITY % frProtocols "(RFC1973)">

   <!ENTITY % x25Protocols "(RFC1598)">

   <!ENTITY % popProperties "(MPPP|MOBIP|MCRX|MCTX)" >

   <!ENTITY % tunnelingProtocols
        "(L2TP|PPTP|L2F|ATMP|AHT|ESPT|IPIP|MIP|GRE)" >

   <!ENTITY % popInformation
        "address,
         media+,
         minBitsPerSecond?,
         maxBitsPerSecond?,
         popProperty*,
         tunnelProto*,
         dialScript?,
         pricingInformation?,
         city?,
         region?,
         country?,
         (setup|setupPtr)?,
         (support|supportPtr)?,
         (provider|providerPtr)?">

   <!ENTITY % setupInformation
        "dnsServerAddress*,
         nntpServerName*,
         smtpServerName*,
         popServerName*,
         imapServerName*,
         wwwProxyServerName*,
         ftpProxyServerName*,
         winsockProxyServerName*,
         defaultGatewayAddress?,
         userNamePrefix?,
         userNameSuffix?">

   <!ENTITY % supportInformation
        "(supportTelephoneNumber|supportMailtoURL)+">

   <!ENTITY % providerInformation
        "providerName?,
         providerIcon?,
         wwwURL?,
         generalMailtoURL?,
         billingMailtoURL?,
         businessCategory?,



Riegel & Zorn               Standards Track                    [Page 23]

RFC 3017           Roaming Access Phone Book XML DTD       December 2000


         x121Address?,
         registeredAddress?,
         destinationIndicator?,
         preferredDeliveryMethod?,
         telexNumber?,
         teletexTerminalIdentifier?,
         telephoneNumber?,
         internationalISDNNumber?,
         facsimileTelephoneNumber?,
         street?,
         postOfficeBox?,
         postalCode?,
         postalAddress?,
         physicalDeliveryOfficeName?,
         description?,
         supportPtr*">

   <!-- ++++++++++++++ End of IANA maintained section ++++++++++ -->

   <!-- Phone book value type notation declarations -->
   <!NOTATION FQDN PUBLIC "-//IETF/roamPhoneBook/NOTATION
   value Type Fully_qualified_domain_name">
   <!NOTATION IPADR PUBLIC "-//IETF/roamPhoneBook/NOTATION
   value Type IP_address">
   <!NOTATION B64JPG PUBLIC "-//IETF/roamPhoneBook/NOTATION
   value Type Base64_encoded_jpeg_image">
   <!NOTATION B64GIF PUBLIC "-//IETF/roamPhoneBook/NOTATION
   value Type Base64_encoded_gif_image">

   <!-- Phone book element declarations -->
   <!ELEMENT phoneBook (
         pop+,
         setup*,
         support*,
         provider*) >
   <!ATTLIST phoneBook
         name    CDATA   #REQUIRED
         version CDATA   #REQUIRED >

   <!ELEMENT pop ( %popInformation; )>
   <!ATTLIST pop
         entryVersion   CDATA   #REQUIRED>

   <!ELEMENT setup ( %setupInformation; )>
   <!ATTLIST setup
         id      ID      #REQUIRED>

   <!ELEMENT support ( %supportInformation; )>



Riegel & Zorn               Standards Track                    [Page 24]

RFC 3017           Roaming Access Phone Book XML DTD       December 2000


   <!ATTLIST support
         id          ID         #REQUIRED
         language    NMTOKENS   #IMPLIED >

   <!ELEMENT provider ( %providerInformation; )>
   <!ATTLIST provider
         id      ID      #REQUIRED>

   <!-- Information elements for pop -->
   <!ELEMENT address (#PCDATA)>
   <!ATTLIST address
           family       %addressFamily;  #REQUIRED
           countryCode  CDATA            #IMPLIED
           areaCode     CDATA            #IMPLIED >

   <!ELEMENT media %mediaTypes; >

   <!ELEMENT viaMODEM EMPTY>
   <!ATTLIST viaMODEM
           type %modemProtocols; #IMPLIED >

   <!ELEMENT viaISDN EMPTY>
   <!ATTLIST viaISDN
           type %isdnProtocols; #IMPLIED >

   <!ELEMENT viaATM EMPTY>
   <!ATTLIST viaATM
           type %atmProtocols; #IMPLIED >

   <!ELEMENT viaFR EMPTY>
   <!ATTLIST viaFR
           type %frProtocols; #IMPLIED >

   <!ELEMENT viaX25 EMPTY>
   <!ATTLIST viaX25
           type %x25Protocols; #IMPLIED >

   <!ELEMENT minBitsPerSecond (#PCDATA)>

   <!ELEMENT maxBitsPerSecond (#PCDATA)>

   <!ELEMENT popProperty EMPTY>
   <!ATTLIST popProperty
           type         %popProperties;  #REQUIRED >

   <!ELEMENT tunnelProto EMPTY>
   <!ATTLIST tunnelProto
           type   %tunnelingProtocols;   #REQUIRED >



Riegel & Zorn               Standards Track                    [Page 25]

RFC 3017           Roaming Access Phone Book XML DTD       December 2000


   <!ELEMENT dialScript (#PCDATA)>
   <!ATTLIST dialScript
           type CDATA #IMPLIED >

   <!ELEMENT pricing (#PCDATA)>

   <!ELEMENT city (#PCDATA)>

   <!ELEMENT region (#PCDATA)>

   <!ELEMENT country (#PCDATA)>

   <!ELEMENT setupPtr EMPTY>
   <!ATTLIST setupPtr
         setupID   IDREFS  #IMPLIED>

   <!ELEMENT supportPtr EMPTY>
   <!ATTLIST supportPtr
         supportID IDREFS  #IMPLIED>

   <!ELEMENT providerPtr EMPTY>
   <!ATTLIST providerPtr
         providerID IDREFS  #IMPLIED>

   <!-- Information elements for setup -->
   <!ELEMENT dnsServerAddress (#PCDATA)>
   <!ATTLIST dnsServerAddress
           value NOTATION (IPADR) #IMPLIED>

   <!ELEMENT nntpServerName (#PCDATA)>
   <!ATTLIST nntpServerName
           value NOTATION (FQDN) #IMPLIED>

   <!ELEMENT smtpServerName (#PCDATA)>
   <!ATTLIST smtpServerName
           value NOTATION (FQDN) #IMPLIED>

   <!ELEMENT popServerName (#PCDATA)>
   <!ATTLIST popServerName
           value NOTATION (FQDN) #IMPLIED>

   <!ELEMENT imapServerName (#PCDATA)>
   <!ATTLIST imapServerName
           value NOTATION (FQDN) #IMPLIED>

   <!ELEMENT wwwProxyServerName (#PCDATA)>
   <!ATTLIST wwwProxyServerName
           value NOTATION (FQDN) #IMPLIED>



Riegel & Zorn               Standards Track                    [Page 26]

RFC 3017           Roaming Access Phone Book XML DTD       December 2000


   <!ELEMENT ftpProxyServerName (#PCDATA)>
   <!ATTLIST ftpProxyServerName
           value NOTATION (FQDN) #IMPLIED>

   <!ELEMENT winsockProxyServerName (#PCDATA)>
   <!ATTLIST winsockProxyServerName
           value NOTATION (FQDN) #IMPLIED>

   <!ELEMENT defaultGatewayAddress (#PCDATA)>
   <!ATTLIST defaultGatewayAddress
           value NOTATION (IPADR) #IMPLIED>

   <!ELEMENT userNameSuffix (#PCDATA)>

   <!ELEMENT userNamePrefix (#PCDATA)>

   <!-- Information elements for support -->
   <!ELEMENT supportTelephoneNumber (#PCDATA)>

   <!ELEMENT supportMailtoURL (#PCDATA)>

   <!-- Information elements for provider -->