home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / rfc / rfc1386 < prev    next >
Text File  |  1992-12-24  |  62KB  |  1,739 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                          A. Cooper
  8. Request for Comments: 1386                                     J. Postel
  9.                                                            December 1992
  10.                              The US Domain
  11.  
  12. Status of this Memo
  13.  
  14.    This memo provides information for the Internet community. It does
  15.    not specify an Internet standard. Distribution of this memo is
  16.    unlimited.
  17.  
  18. Table of Contents
  19.  
  20.    1.  Introduction ................................................  2
  21.        1.1  The Internet Domain Name System.........................  2
  22.        1.2  Top Level Domains.......................................  3
  23.        1.3  The US Domain ..........................................  4
  24.    2.  Naming Structure ............................................  4
  25.        2.1  State Codes ............................................  5
  26.        2.2  City Codes or Locality Names............................  5
  27.        2.3  Examples of Names.......................................  5
  28.    3.  Registration ................................................  8
  29.        3.1  Requirements ...........................................  8
  30.        3.2  Direct Entries .........................................  9
  31.        3.2.1   UUCP Hosts ..........................................  9
  32.        3.2.2   Non-IP Hosts ........................................ 10
  33.        3.3  Delegated Subdomains ................................... 12
  34.        3.3.1   Schools ............................................. 12
  35.        3.3.2   State Agencies ...................................... 14
  36.        3.3.3   Federal Agencies .................................... 14
  37.        3.3.4   Delegation Requirement............................... 14
  38.        3.3.5   Delegation Procedures ............................... 15
  39.        3.3.6   Subdomain Contacts................................... 18
  40.    4.  Database Information......................................... 19
  41.        4.1  Name Servers ........................................... 19
  42.        4.2  Zone files ............................................. 20
  43.        4.3  Resource Records ....................................... 21
  44.        4.3.1   A Records ........................................... 22
  45.        4.3.2   CNAME Records ....................................... 22
  46.        4.3.3   MX Records .......................................... 22
  47.        4.3.4   HINFO Records ....................................... 23
  48.        4.3.5   PTR Records ......................................... 23
  49.        4.4  Wildcards .............................................. 23
  50.    5.  References .................................................. 24
  51.    6.  Security Considerations ..................................... 25
  52.    7.  Author's Address ............................................ 25
  53.    Appendix-I:  US Domain Names BNF................................. 26
  54.    Appendix-II: US Domain Questionnaire for Host Entry.............. 28
  55.  
  56.  
  57.  
  58. Cooper & Postel                                                 [Page 1]
  59.  
  60. RFC 1386                     The US Domain                 December 1992
  61.  
  62.  
  63. 1. INTRODUCTION
  64.  
  65.    1.1 The Internet Domain Name System
  66.  
  67.    The Domain Name System (DNS) provides for the translation between
  68.    host names and addresses.  Within the Internet, this means
  69.    translating from a name such as "venera.isi.edu", to an IP address
  70.    such as "128.9.0.32".  The DNS is a set of protocols and databases.
  71.    The protocols define the syntax and semantics for a query language to
  72.    ask questions about information located by DNS-style names.  The
  73.    databases are distributed and replicated.  There is no dependence on
  74.    a single central server, and each part of the database is provided in
  75.    at least two servers.
  76.  
  77.    The assignment of the 32-bit IP addresses is a separate activity.  IP
  78.    addresses are assigned by the Network Information Center
  79.    (Hostmaster@NIC.DDN.MIL).
  80.  
  81.    In addition to translating names to addresses for hosts that are on
  82.    the Internet, the DNS provides for registering DNS-style names for
  83.    other hosts reachable (via electronic mail) through gateways or mail
  84.    relays.  The records for such name registration point to an Internet
  85.    host (one with an IP address) that acts as a mail forwarder for the
  86.    registered host.  For example, the host "bah.rochester.ny.us" is
  87.    registered in the DNS with a pointer to the mail relay
  88.    "relay1.uu.net".  This type of pointer is called an MX record.
  89.  
  90.    This gives electronic mail users a uniform mail addressing syntax and
  91.    avoids making users aware of the underlying network boundaries.
  92.  
  93.    The reason for the development of the domain system was growth in the
  94.    Internet.  The host name to address mappings were maintained by the
  95.    Network Information Center (NIC) in a single file, called HOSTS.TXT,
  96.    which was FTPed by all the hosts on the Internet.  The network
  97.    population was changing in character.  The timeshared hosts that made
  98.    up the original ARPANET were being replaced with local networks of
  99.    workstations.  Local organizations were administering their own names
  100.    and addresses, but had to wait for the NIC to make changes in
  101.    HOSTS.TXT to make the changes visible to the Internet at large.
  102.    Organizations also wanted some local structure on the name space.
  103.    The applications on the Internet were getting more sophisticated and
  104.    creating a need for general purpose name service.  The idea of a
  105.    hierarchical name space, with the hierarchy roughly corresponding to
  106.    organizational structure, and names using "." as the character to
  107.    mark the boundary between hierarcy levels.  A design using a
  108.    distributed database and generalized resources was implemented.
  109.  
  110.    The domain system provides standard formats for resource data,
  111.  
  112.  
  113.  
  114. Cooper & Postel                                                 [Page 2]
  115.  
  116. RFC 1386                     The US Domain                 December 1992
  117.  
  118.  
  119.    standard methods for querying the database, and standard methods for
  120.    name servers to refresh local data from other name servers.
  121.  
  122.    1.2  Top-Level Domains
  123.  
  124.    The top-level domains in the DNS are EDU, COM, GOV, MIL, ORG, INT,
  125.    and NET, and all the 2-letter country codes from the list of
  126.    countries in ISO-3166.
  127.  
  128.    Even though the intention was that any educational institution any
  129.    where in the world could be registered under the EDU domain, in
  130.    practice it has turned out with few exceptions only those in the
  131.    United States have registered under EDU, similiary with COM (for
  132.    commercial). In other countries, everything is registered under the
  133.    2-letter country code, often with some subdivision.  For example, in
  134.    Korea (KR) the second level names are AC for academic community, CO
  135.    for commercial, GO for government, and RE for research.  However each
  136.    country may go it's own way about organizing its domain, and many
  137.    have.
  138.  
  139.    Their are no plans of putting all of the organizational domains .EDU
  140.     .GOV .COM etc., under .US.
  141.  
  142.    However, there are some states registered in the .GOV domain (11 by 2
  143.    letter code), and 3 by full names)
  144.  
  145.            ca.gov          la.gov          ohio.gov        va.gov
  146.            co.gov          md.gov          or.gov          wa.gov
  147.            hawaii.gov      nc.gov          sc.gov
  148.            ia.gov          ny.gov          texas.gov
  149.  
  150.    Other names sometimes appear as top-level domain names.  Some people
  151.    have made up names in the DNS style without coordinating or
  152.    registering  with the DNS management.  Some names that typically
  153.    appear are ".BITNET", ".UUCP", and two-letter codes for continents,
  154.    such as ".NA" for North America (this conflicts with the official
  155.    Internet code for Namibia).
  156.  
  157.    For example, the DNS style name "KA7EEJ.CO.USA.NA" is used in the
  158.    amateur radio network.  These addresses are never supposed to show up
  159.    on the Internet but they do occasionally.  The amateur radio network
  160.    people created their own naming scheme, and it interferes sometimes
  161.    with Internet addresses.
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170. Cooper & Postel                                                 [Page 3]
  171.  
  172. RFC 1386                     The US Domain                 December 1992
  173.  
  174.  
  175.    1.3  The US Domain
  176.  
  177.    The US Domain is an official top-level domain in the DNS of the
  178.    Internet community.  It is registered with the Network Information
  179.    Center.  The domain administrators are Jon Postel and Ann Westine
  180.    Cooper at the Information Sciences Institute of the University of
  181.    Southern California (USC-ISI).
  182.  
  183.    US is the ISO-3166 2-letter country code for the United States and
  184.    thus the US Domain is established as a top-level domain and
  185.    registered with the NIC the same way other country domains are.
  186.  
  187.    Because organizations in the United States have registered primarily
  188.    in the EDU and COM domains, little use was initially made of the US
  189.    domain.
  190.  
  191.    In the past, the computers registered in the US Domain were primarily
  192.    owned by small companies or individuals with computers at home.
  193.    However, the US Domain has grown and currently registers hosts in
  194.    federal government agencies, state government agencies, K12 schools,
  195.    community colleges, private schools, libraries, county agencies, and
  196.    city utilities, to name a few.
  197.  
  198.    The administration of the US Domain was managed solely by the Domain
  199.    Registrar in the past.  However, due to the increase of hosts,
  200.    administration of subdomains is being delegated to others.
  201.  
  202.    Any computer in the United States may be registered in the US Domain.
  203.  
  204. 2. NAMING STRUCTURE
  205.  
  206.    The US Domain hierarchy is based on political geography.  The
  207.    namespace under .US is the state namespace, then the city namespace,
  208.    then organization or computer name and so on.
  209.  
  210.    For example:
  211.  
  212.           SPK.WA.US
  213.          VANC.WA.US
  214.  
  215.    There is of course no problem with running out of names.
  216.  
  217.    The things that are named are individual computers.
  218.  
  219.    If you register now in one city and then move, the database can be
  220.    updated with a new name in your new city, and a pointer can be set up
  221.    from your old name to your new name.  This type of pointer is called
  222.    a CNAME record.
  223.  
  224.  
  225.  
  226. Cooper & Postel                                                 [Page 4]
  227.  
  228. RFC 1386                     The US Domain                 December 1992
  229.  
  230.  
  231.    The use of un-registered names is not effective and causes problems
  232.    for other users.  Inventing your own name and using it without
  233.    registering is not a good idea.
  234.  
  235.    2.1  State Codes
  236.  
  237.    The state codes are the two letter US Postal abbreviations.
  238.  
  239.    2.2  City Codes or Locality Names
  240.  
  241.    Cities may be named (designated) by their full name (spelled out with
  242.    hyphens replacing spaces (e.g., Los-Angeles or New-York)), or by a
  243.    city code.  The first choice is the full city name, the second choice
  244.    is the city codes from Western Union's "City Mnemonics" list, and a
  245.    third choice is a code for your city chosen by the applicant.
  246.    However, it is very desirable that all users in the same city use the
  247.    same designator for the city.
  248.  
  249.    Abbreviated city names are a good idea, particularly when the city
  250.    name is long, as there is much to type already.  One of the problems
  251.    is that the city codes in the Western Union City Mnemonics list are
  252.    sometimes not very good abbreviations.  Users sometimes tend to
  253.    prefer abbreviations that are commonly used already from that region.
  254.    Such as SF for San Francisco, MPK for Menlo Park.
  255.  
  256.    Exceptions have been made in the abbreviations, even though this
  257.    causes extra work to keep track of these abbreviations.  One
  258.    abbreviation for one city.  Applicants are told what codes are
  259.    currently in use, however, if a city code is not used yet, and they
  260.    would prefer to use a different code that is more common among the
  261.    natives, then the new code is allowed.  However, once it's
  262.    registered, then everyone else who registers in that city will have
  263.    to use that code or spell out the full city name.
  264.  
  265.    Some applicants have tried to get a copy of the Western Union City
  266.    Mnemonics code list but it is no longer available from Western Union.
  267.    However, we do have a copy but it is not online. If you are
  268.    requesting an abbreviated city code please let us know and we will
  269.    gladly look it up for you.
  270.  
  271.    2.3  Examples of Names
  272.  
  273.    For small entities like individuals or small businesses there is
  274.    usually no problem with selecting locality based names.
  275.  
  276.          For example:  Zuckys.Santa-Monica.CA.US
  277.  
  278.  
  279.  
  280.  
  281.  
  282. Cooper & Postel                                                 [Page 5]
  283.  
  284. RFC 1386                     The US Domain                 December 1992
  285.  
  286.  
  287.    For large entities like large corporations with multiple facilities
  288.    in several cities or states this often seems like a unreasonable
  289.    constraint (especially when compared with the alternative of
  290.    registering directly in the .COM domain).  However, a company does
  291.    have a headquarters office in a particular locality and so could
  292.    register with that name.
  293.  
  294.          For example:  IBM.Armonk.NY.US
  295.  
  296.  
  297.              EXAMPLES OF THE NAMING STRUCTURE IN THE US DOMAIN
  298.  
  299.    PRIVATE (business or individual)
  300.    ================================
  301.  
  302.    Camp-Curry.Yosemite.CA.US       <====  a business
  303.    IBM.Armonk.NY.US                <====  a business
  304.    Dogwood.atl.GA.US               <====  a business
  305.    Geo-Petrellis.Culver-City.CA.US <====  a restaurant
  306.    Zuckys-Santa-Monica.CA.US       <====  a restaurant
  307.    Joe-Josts.Long-Beach.CA.US      <====  a bar
  308.    Holodek.Santa-Cruz.CA.US        <====  a personal computer
  309.  
  310.    FEDERAL
  311.    =======
  312.  
  313.    Senate.FED.US           <====  US Senate
  314.    DOD.FED.US              <====  US Defense Dept.
  315.    DOT.FED.US              <====  US Transportation Dept.
  316.    USPS.FED.US             <====  US Postal Service
  317.    VA.FED.US               <====  US Veterans Administration
  318.    IRS.FED.US              <====  US Internal Revenue Service
  319.    Yosemite.NPS.Interior.FED.US    <====  a federal agency
  320.  
  321.    STATE
  322.    =====
  323.  
  324.    Senate.STATE.MN.US      <====  state Senate
  325.    House.STATE.MN.US       <====  state House of Reps
  326.    MDH.STATE.MN.US         <====  state Health Dept.
  327.    HUD.STATE.CA.US         <====  state House and Urban Dev. Dept.
  328.    DOT.STATE.MN.US         <====  state Transportation Dept.
  329.    Caltrans.STATE.CA.US    <====  state Transportation Dept.
  330.    DMV.STATE.CA.US         <====  state Motor Vehicles Dept.
  331.    Culver-City.DMV.STATE.CA.US  <====  a local office of DMV
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338. Cooper & Postel                                                 [Page 6]
  339.  
  340. RFC 1386                     The US Domain                 December 1992
  341.  
  342.  
  343.    CITY | COUNTY
  344.    ==============
  345.  
  346.    Police.CITY.Culver-City.CA.US       <====  a city department
  347.    Fire-Dept.CITY.Los-Angeles.CA.US    <====  a city department
  348.    Fire-Dept.COUNTY.Los-Angeles.CA.US  <====  a county department
  349.  
  350.    REGIONAL | DISTRICT | LIBRARY
  351.    =============================
  352.  
  353.    SCAQMD.DISTRICT.CA.US                     <====  a regional district
  354.    Bunker-Hill-Improvement.DISTRICT.LA.CA.US <====  a local district
  355.  
  356.    Huntington.LIB.LA.US                    <====  a private library
  357.    Venice.LA-City.LIB.CA.US                <====  a city library
  358.    MDR.LA-County.LIB.CA.US                 <====  a county library
  359.  
  360.    K12 | CC | STATE UNIV | PRIVATE SCHOOLS
  361.    =======================================
  362.  
  363.    Los-Angeles.UC.STATE.CA.US      <====  UCLA
  364.    Berkeley.UC.STATE.CA.US         <====  "CAL"
  365.    Irvine.UC.STATE.CA.US           <====  University of Calif. Irvine
  366.    Santa-Cruz.UC.STATE.CA.US       <====  University of Calif. Santa Cruz
  367.    Northridge.CSU.STATE.CA.US      <====  Calif. State. Univ. Northridge
  368.    Fullerton.CSU.STATE.CA.US       <====  Calif. State. Univ. Fullerton
  369.    Sonoma.CSU.STATE.CA.US          <====  Calif. State. Univ. Sonoma
  370.  
  371.    SMCC.Santa-Monica.CC.CA.US      <====  a public community college
  372.    Trade-Tech.Los-Angeles.CC.CA.US <====  a public community college
  373.  
  374.    Hamilton.High.LA-Unified.K12.CA.US      <====   a public K12 school
  375.    Sherman-Oaks.Elem.LA-Unified.K12.CA.US  <====   a public K12 school
  376.    John-Muir.Middle.Santa-Monica.K12.CA.US <====   a public K12 school
  377.  
  378.    St-Monica.High.Santa-Monica.CA.US       <====  a private high school
  379.    St-Monica.Elem.Santa-Monica.CA.US       <====  a private elem. school
  380.    Crossroads-School.Santa-Monica.CA.US    <====  a private school
  381.    Mary-Ellens.Montessori-School.LA.CA.US  <====  a private school
  382.    Leland-Stanford-Jr-Univ.Stanford.CA.US  <====  a private school
  383.    Loyola-Marymount-Univ.Los-Angeles.CA.US <====  a private school
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394. Cooper & Postel                                                 [Page 7]
  395.  
  396. RFC 1386                     The US Domain                 December 1992
  397.  
  398.  
  399.    When appropriate, subdomains are delegated and partioned in various
  400.    categories, such as:
  401.  
  402.                    K12.<state>.US   =   kindegarten thru 12th grade
  403.                     CC.<state>.US   =   community colleges
  404.                    LIB.<state>.US   =   libraries
  405.                  STATE.<state>.US   =   state government agencies
  406.                 <org-name>.FED.US   =   federal government agencies
  407.  
  408.    The Appendix-I contains the current US Domain Names BNF, but in
  409.    actuality, the names under these subdomains may vary according to the
  410.    decision of the administrators of these subdomains.
  411.  
  412.    Some users would like names associated with a greater metropolitan
  413.    area or region like the "Bay Area" or "Tri-Cities".  One problem with
  414.    this is that these names are not necessarily unique within a state.
  415.    The best thing to do in this case is to use the larger metropolitan
  416.    city in your host name.  Cities and in some cases counties are used.
  417.  
  418. 3. REGISTRATION
  419.  
  420.    3.1  Requirements
  421.  
  422.    Anyone requesting to register a host in the US Domain is sent a copy
  423.    of the US Domain policy and procedure, and must fill out a US Domain
  424.    questionnaire.
  425.  
  426.    The US Domain template, is similar to the NIC Domain template
  427.    however, it is not the same.  To request a copy of the US Domain
  428.    questionnaire, send a message to the US Domain registrar (us-
  429.    domain@isi.edu).
  430.  
  431.       Note:  If you are registering a name in a delegated zone
  432.              (see Section 3.3.6).  Please register with the
  433.              contact for that zone.
  434.  
  435.    The key people must have electronic mailboxes (that work).  Please
  436.    provide all the information indicated in the "Administrator" and
  437.    "Technical Contact" slot.  This person will be the point of contact
  438.    for any administrative and policy questions about the domain.
  439.  
  440.    The administrator is usually the person who manages the organization
  441.    being registered. The technical contact can also be administrator, or
  442.    the systems person, or someone who is familiar with the technical
  443.    details of the Internet. The technical contact should have a valid
  444.    working e-mail address. This is necessary in case something goes
  445.    wrong.
  446.  
  447.  
  448.  
  449.  
  450. Cooper & Postel                                                 [Page 8]
  451.  
  452. RFC 1386                     The US Domain                 December 1992
  453.  
  454.  
  455.    It is important that your "Return-Path" and "From" field indicate an
  456.    Internet style address.  UUCP style addresses such as "host1!user"
  457.    will not work. This is fine within the UUCP world, but not the
  458.    Internet.  If you want people on the Internet to be able to send mail
  459.    to you, your return path needs to be an Internet style address: such
  460.    as host1!user@internet.gateway.host or user@internet.gateway.host.
  461.  
  462.    It is also possible to register through one of the Internet service
  463.    providers that have established working relationships with the US
  464.    domain administrator.
  465.  
  466.    If everything checks out, turn around time for registering a host is
  467.    usually a day or two.  The nameservers are updated anywhere from 12
  468.    to 24 hours later.
  469.  
  470.    There are two ways to be registered in the US Domain, directly, or by
  471.    delegation.
  472.  
  473.    3.2  Direct Entries
  474.  
  475.    Direct entry in the database of the US Domain appeals most to
  476.    individuals and small companies.  Fill out the application and send
  477.    it directly to the US Domain administrator.  If you are in an area
  478.    where the zone is delegated to someone else your request will be
  479.    forwarded to the zone administrator for your registration.
  480.  
  481.    3.2.1 UUCP Hosts
  482.  
  483.    Many applicants have hosts in the UUCP world.  Some are one hop away,
  484.    some two and three hops away from their "Internet Forwarder", this is
  485.    ok.  What is important is getting an Internet host to be your
  486.    forwarder.  If you do not already have an Internet forwarder, there
  487.    are several businesses that provide this service for a fee, such as
  488.    UUNET.UU.NET (postmaster@uunet.uu.net), PSI (postmaster@UU2.PSI.COM)
  489.    and CERFNET (help@cerf.net).  Sometimes local colleges in your area
  490.    are already on the Internet and may be willing to act as an Internet
  491.    Forwarder.  You would need to work this out with the systems
  492.    administrator we cannot make these arrangements for you.
  493.  
  494.    Although we work with UUCP service providers, the Internet US Domain
  495.    registration is not affiliated with the registration of UUCP Map
  496.    entries.  The UUCP map entry does not provide us with sufficient
  497.    information.  If you do not have a copy of the US Domain
  498.    questionnaire template, please send a message to: us-domain@isi.edu
  499.    and request one.  See Appendix-II.
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506. Cooper & Postel                                                 [Page 9]
  507.  
  508. RFC 1386                     The US Domain                 December 1992
  509.  
  510.  
  511.    This is not an appropriate registration for the US Domain.
  512.  
  513.      #N starl
  514.      #S Amiga 2500; AmigaDOS 2.04; Dillon's AmigaUUCP 1.15D
  515.      #O Starlight BBS
  516.      #C Stephen Baker
  517.      #E starl!sbaker
  518.      #T +1 305 378 1161
  519.      #P 1107 SW 200th St #303B Miami, Fl. 33157
  520.      #L 25 47 N / 88 10 W [city]
  521.      #R
  522.      #U mthvax
  523.      #W starl!sbaker (Stephen Baker); Mon Feb 24 19:58:24 EST 1992
  524.       starl        mthvax(DAILY)
  525.  
  526.    If you are registering your host as a central site for a USENET group
  527.    where other UUCP sites will feed from you, that's fine.  These UUCP
  528.    sites do not need to register.  If however, the other sites become a
  529.    subdomain of your hostname, then we will need to register them
  530.    individually or add a wildcard record.
  531.  
  532.            For example:          bah.rochester.ny.us
  533.                            host1.bah.rochester.ny.us
  534.                            host2.bah.rochester.ny.us
  535.  
  536.    3.2.2 NON-IP Hosts
  537.  
  538.    To use US Domain names for non-IP hosts, there must be a forwarder
  539.    host that is an IP host.  There must be an adminstrative agreement
  540.    and a technical procedure for relaying mail between the non-IP host
  541.    and the forwarder host.
  542.  
  543.    Case 1:
  544.    -------
  545.  
  546.    Your host is not an IP host but does talk directly with a host that
  547.    is an IP host.
  548.                                                   +-----------------+
  549.    +----------+            +---------+            |                 |
  550.    |your-host |---UUCP-----|forwarder|----IP/TCP--|    INTERNET     |
  551.    +----------+            +---------+            |                 |
  552.                                                   +-----------------+
  553.    "Forwarder" must be an IP host on the Internet.
  554.  
  555.    You must ask "forwarder" if they are willing to be the internet
  556.    forwarder for "your-host".
  557.  
  558.    In the US Domain of the DNS data base there must be an entry like
  559.  
  560.  
  561.  
  562. Cooper & Postel                                                [Page 10]
  563.  
  564. RFC 1386                     The US Domain                 December 1992
  565.  
  566.  
  567.    this:
  568.           "your-host"  MX  10  "forwarder"
  569.  
  570.    This must be entered by the US Domain administrator.
  571.  
  572.    In the "forwarder" routing tables there must be information about
  573.    "your-host" with a rule like: If I see mail for "your-host" I will
  574.    send it via uucp by calling phone number "123-4567".
  575.  
  576.    Case 2:
  577.    -------
  578.  
  579.    In this case your hosts talks to another host that ... that talks to
  580.    an IP host.  In other words, there are multiple hops between your host
  581.    and the Internet.
  582.                                                   +-----------------+
  583.    +----------+            +---------+            |                 |
  584.    |path-host |---UUCP-----|forwarder|----IP/TCP--|    INTERNET     |
  585.    +----------+            +---------+            |                 |
  586.        |                                          +-----------------+
  587.       UUCP
  588.        |
  589.    +----------+
  590.    |your-host |
  591.    +----------+
  592.  
  593.    "Forwarder" must be an IP host on the internet.
  594.  
  595.    You must ask "forwarder" if they are willing to be the Internet
  596.    Forwarder for "Your-Host".  You must ask "path-host" to relay your
  597.    mail.
  598.  
  599.    In the US Domain of the DNS DataBase there must be an entry like this:
  600.  
  601.           "your-host"  MX  10  "forwarder"
  602.  
  603.    This must be entered by the US Domain Administrator.
  604.  
  605.    In the "forwarder" routing tables there must be information about
  606.    "your-host" with a rule like: If I see mail for "your-host" I will
  607.    send it via UUCP to "path-host" by calling phone number "123-4567".
  608.    and "path-host" must also know how to relay the mail to "your-host".
  609.  
  610.    Note: It is assumed that "path-host" is already MXed to "forwarder".
  611.    It is not appropriate to ask to MX "your-host" to "path-host" (this
  612.    is sometimes called double MXing).  The host on the right hand side
  613.    of an MX entry must be a host on the Internet with an IP address
  614.    (e.g., 128.9.2.32).
  615.  
  616.  
  617.  
  618. Cooper & Postel                                                [Page 11]
  619.  
  620. RFC 1386                     The US Domain                 December 1992
  621.  
  622.  
  623.    3.3  Delegated Subdomains
  624.  
  625.    The administrator of the US Domain is responsible for the assignment
  626.    of all the DNS names that end with ".US".  Of course, one person or
  627.    even one group can't handle all this in the long run so portions of
  628.    the name space are delegated to others.
  629.  
  630.    Delegation of cities, companies within cities, schools (K12),
  631.    community colleges (CC), libraries (LIB), state government (STATE),
  632.    and federal government agencies, departments, etc., is acceptable and
  633.    practical.
  634.  
  635.    For a delegated portion of the namespace, for example a city, no
  636.    alterations can be made to that name, no abbreviations added, etc.
  637.    unless applied for.
  638.  
  639.    Sometimes there may be two people running name servers in the same
  640.    city because different portions of the name space has been delegated
  641.    to them.  For example, someone may be delegated the <city>.<state>.US
  642.    name space, and someone else from a state government agency may have
  643.    the .STATE.<state>.US, portion.  For example, Fred may run the name
  644.    servers for Sacramento.CA.US and Joe may run the name servers for
  645.    STATE.CA.US in Sacramento.
  646.  
  647.    If a company would like to have wildcard records added, or run their
  648.    own name servers in a city that we have delegated name space to, this
  649.    is ok.
  650.  
  651.    Delegation of the whole State namespace is not yet implemented.  The
  652.    delegated part of the name space is in the form of:
  653.  
  654.                     .STATE.<state>.US.
  655.                       .K12.<state>.US.
  656.                        .CC.<state>.US.
  657.                       .LIB.<state>.US.
  658.         .<org-name>.<city>.<state>.US.
  659.          .CITY.<city-name>.<state>.US.
  660.                    .<org-name>.FED.US.
  661.  
  662.    3.3.1  Schools
  663.  
  664.    As schools begin to join the Internet, there ought to be a consistent
  665.    scheme for naming them.  A "K12" name branch has been established in
  666.    each state in the US Domain for this purpose.
  667.  
  668.    Public schools are usually organized by districts which can be larger
  669.    or smaller than a city or county.
  670.  
  671.  
  672.  
  673.  
  674. Cooper & Postel                                                [Page 12]
  675.  
  676. RFC 1386                     The US Domain                 December 1992
  677.  
  678.  
  679.    It makes sense to name schools within districts.  However districts
  680.    often have the same name as a city or county so there has to be a way
  681.    to distinguish a public school district name from some other type of
  682.    locality name.  The keyword "K12" is used for this.
  683.  
  684.    In some districts, the same school name is used at different levels,
  685.    for example, Washington Elementary School and Washington High School.
  686.    We suggest that when necessary the keywords "Elementary", "Middle",
  687.    and "High" be used to distinguish these schools.  These keywords
  688.    would only be used when they are needed, if the school's name is
  689.    unique without such keywords don't use them.
  690.  
  691.    Typical K12 school names currently used are like:
  692.  
  693.               IVY.PRS.K12.NJ.US
  694.               DMHS.JCPS.K12.KY.US
  695.               OHS.EUNION.K12.CA.US
  696.               BOHS.BREA.K12.CA.US
  697.  
  698.    These names could be long.  Given the large number of schools,
  699.    organizing by school district and state seems appropriate.  When
  700.    there are many things to name some of the names must be long.
  701.  
  702.    In some cases there may be appropriate abbreviations that can be
  703.    used.  For example Hamilton High School in Los Angeles could be:
  704.  
  705.               Hami.Hi.LA.K12.CA.US
  706.  
  707.       Some School Examples:
  708.       ---------------------
  709.  
  710.       Hamilton.High.LA-Unified.K12.CA.US        <== a public school
  711.       Sherman-Oaks.Elem.LA-Unified.K12.CA.US    <== a public school
  712.       John-Muir.Middle.Santa-Monica.K12.CA.US   <== a public school
  713.       Crossroads-School.Santa-Monica.CA.US      <== a private school
  714.       SMCC.CC.CA.US                             <== a community college
  715.       Northridge.CSU.STATE.CA.US                <== a state university
  716.  
  717.    If a school has a bunch of PCs, then each PC should have a name.
  718.    Suppose they are named "alpha", "beta", ... then if they belong to a
  719.    school named "Lincoln.High.Lakewood.K12.CA.US" their names would be:
  720.  
  721.                 alpha.Lincoln.High.Lakewood.K12.CA.US.
  722.                 beta.Lincoln.High.Lakewood.K12.CA.US
  723.            ...
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. Cooper & Postel                                                [Page 13]
  731.  
  732. RFC 1386                     The US Domain                 December 1992
  733.  
  734.  
  735.    3.2.2  State Agencies
  736.  
  737.    US Domain namespace has been delegated to the state goverment
  738.    agencies.  For example, in the State of Minnesota, the subdomain is
  739.    STATE.MN.US
  740.  
  741.    This means that the person running the namservers for state.mn.us are
  742.    responsible for naming agencies, of the state govermnent.  For
  743.    example:
  744.  
  745.       State Agencies:
  746.       ---------------
  747.  
  748.       Senate.STATE.MN.US      <== State Senate
  749.       MDH.STATE.MN.US         <== Dept. of Health
  750.       CALTRANS.STATE.CA.US    <== Dept. of Transportation
  751.       DMV.STATE.CA.US         <== Dept. of Motor Vehicles
  752.  
  753.    3.3.3  Federal Agencies
  754.  
  755.    A federal namespace has been delegated to the federal government
  756.    agencies.  For example the subdomain for the Federal Reserve Bank of
  757.    Minneapolis is MNPL.FRB.FED.US. Other examples are listed below.
  758.  
  759.       Federal Government Agencies:
  760.       ---------------------------
  761.  
  762.       Senate.FED.US   <====  US Senate
  763.       DOD.FED.US      <====  US Defense Dept.
  764.       USPS.FED.US     <====  US Postal Service
  765.       VA.FED.US       <====  US Veterans Administration
  766.       IRS.FED.US      <====  US Internal Revenue Service
  767.       Yosemite.NPS.Interior.FED.US    <====  A Federal agency
  768.  
  769.    3.3.4  Delegation Requirements
  770.  
  771.    When a subdomain is delegated, the following requirements must be
  772.    met:
  773.  
  774.       1)  There must be a knowledgeable and competent technical contact,
  775.           familiar with the Internet Domain Name System.  This
  776.           requirement is easily satisified if the technical contact
  777.           already runs some other nameservers.
  778.  
  779.       2)  Organizations requesting delegations must provide at least two
  780.           independent (robust and reliable) DNS name servers in
  781.           physically separate locations on the Internet.
  782.  
  783.  
  784.  
  785.  
  786. Cooper & Postel                                                [Page 14]
  787.  
  788. RFC 1386                     The US Domain                 December 1992
  789.  
  790.  
  791.       3)  The subdomain must accept all applicants on an equal basis.
  792.  
  793.       4)  The subdomain must provide timely processing of requests.  To
  794.           do this it is helpful to have several individuals
  795.           knowledgeable about the procedures so that the operations are
  796.           not delayed due to one persons unavailability (for example by
  797.           being on vacation).
  798.  
  799.    3.3.5  Delegation Procedures
  800.  
  801.    The procedure that is followed when a subdomain is delegated includes
  802.    the following steps:
  803.  
  804.       1)  Evaluate the technical contact's experience with DNS.  Make
  805.           sure there is a need for the proposed delegation.  Make sure
  806.           the technical contact has the information about the US Domain
  807.           and the suggested naming structure.
  808.  
  809.       2)  Note: In the past there was the concept of a "coordinator" for
  810.           a group or a club or "Domain Park". They would arrange to
  811.           coordinate the registration of all the computers used by
  812.           members of the club and forward all the information for the
  813.           group to the US Domain Administrator.  Most coordinators have
  814.           moved into the position of administrator of that now delegated
  815.           subdomain.
  816.  
  817.       3)  Add the new technical contact to the "us-dom-adm" mailing list
  818.           for distributing updates to the US Domain policies and
  819.           procedures, or other pertinent information.
  820.  
  821.       4)  Delete any hosts from our zone file that belongs in the newly
  822.           delegated subdomain and make sure they now have the hosts in
  823.           their zone file.
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842. Cooper & Postel                                                [Page 15]
  843.  
  844. RFC 1386                     The US Domain                 December 1992
  845.  
  846.  
  847.       5)  Send them a copy of the zone file so their initial zone file
  848.           is identical to ours. For example:
  849.  
  850.             mil.wi.us.   86400   SOA spool.mu.edu. manager.spool.mu.edu. (
  851.                                     920904  ;serial
  852.                                     28800   ;refresh
  853.                                     14400   ;retry
  854.                                     3600000 ;expire
  855.                                     86400 ) ;minim
  856.  
  857.             mil.wi.us.      86400   NS      spool.mu.edu.
  858.             spool.mu.edu.   50400   A       134.48.1.31
  859.             mil.wi.us.      86400   NS      sophie.mscs.mu.edu.
  860.  
  861.             sophie.mscs.mu.edu.     50400   A       134.48.4.6
  862.             solaria.mil.wi.us.      86400   HINFO   Sun 3/60 SunOs
  863.             solaria.mil.wi.us.      86400   MX      10 spool.mu.edu.
  864.             nthomas.mil.wi.us.      86400   HINFO   386 Clone DOS
  865.             nthomas.mil.wi.us.      86400   MX      10 spool.mu.edu.
  866.             rwmke.mil.wi.us.        86400   HINFO   UNIX PC UNIX
  867.             rwmke.mil.wi.us.        86400   MX      10 spool.mu.edu.
  868.             milestn.mil.wi.us.      86400   HINFO   PC AT ENIX
  869.             milestn.mil.wi.us.      86400   MX      10 spool.mu.edu.
  870.             dawley.mil.wi.us.       86400   HINFO   386 Clone DOS
  871.             dawley.mil.wi.us.       86400   MX      10 spool.mu.edu.
  872.             ...
  873.                       -------------------------------------
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898. Cooper & Postel                                                [Page 16]
  899.  
  900. RFC 1386                     The US Domain                 December 1992
  901.  
  902.  
  903.       6)  The US Domain zone file must have the following records,
  904.           showing the name, address, e-mail, and phone number of the
  905.           technical contact for the delegated subdomain and the name of
  906.           the delegated name space and the names of the nameservers.
  907.  
  908.             ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  909.             ;
  910.             ;Delegated zone: .mil.wi.us
  911.             ;Contact:  Steven Goodman
  912.             ;          manager@spool.mu.edu
  913.             ;          Marquette University
  914.             ;          (414) 288-6734
  915.  
  916.             mil.wi.us.      604800  NS      SPOOL.MU.EDU.
  917.                             604800  NS      SOPHIE.MSCS.MU.EDU.
  918.  
  919.             ; A glue record is not needed this time. Glue records are
  920.             ; needed when the name of the server is a subdomain of the
  921.             ; delegated domain.
  922.             ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  923.  
  924.       7)  Check to see that delegated subdomain name servers are up and
  925.           running, and make sure the delegated hosts are installed in
  926.           their zone file.  Now delete any hosts from the US Domain zone
  927.           file that belongs in the newly delegated subdomain.
  928.  
  929.       8)  Inform the technical contact of the newly delegated subdomain
  930.           that wildcard records are allowed in the zone file under the
  931.           organizational subdomain but no wildcard records are allowed
  932.           under the "city" or "state" domain.
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954. Cooper & Postel                                                [Page 17]
  955.  
  956. RFC 1386                     The US Domain                 December 1992
  957.  
  958.  
  959.    3.3.6   Subdomain Contacts
  960.  
  961.    Approximately 680 individual hosts are registered, but we have
  962.    delegated the following portions of the namespace.  We do not know
  963.    how many hosts are registered under each of these subsdomains.
  964.  
  965.            DELEGATED ZONE             CONTACT
  966.            ==============             =======
  967.  
  968.            TUCSON.AZ.US               leonard@arizona.edu
  969.            SF.CA.US                   sf-hostmaster@apple.com
  970.            PREMENOS.SF.CA.US          jenkins@premenos.sf.ca.us
  971.            SCVL.CA.US                 sinster@scintilla.capitola.ca.us
  972.            SANTA-CRUZ.CA.US           sinster@scintilla.capitola.ca.us
  973.            APTOS.CA.US                sinster@scintilla.capitola.ca.us
  974.            CAMPBELL.CA.US             sinster@scintilla.capitola.ca.us
  975.            CAPITOLA.CA.US             sinster@scintilla.capitola.ca.us
  976.            FELTON.CA.US               sinster@scintilla.capitola.ca.us
  977.            ZAYANTE.CA.US              sinster@scintilla.capitola.ca.us
  978.            BOULDER-CREEK.CA.US        sinster@scintilla.capitola.ca.us
  979.            DARWIN.PTVY.CA.US          brian@angband.stanford.edu
  980.            LOGAN-HS.UNIONCITY.CA.US   cjw@marmot.nersc.gov
  981.            BOULDER.CO.US              trent@XOR.COM
  982.            COLOSPGS.CO.US             trent@XOR.COM
  983.            DENVER.CO.US               trent@XOR.COM
  984.            DVR.CO.US                  trent@XOR.COM
  985.            CHI.IL.US                  matt@oddjob.uchicago.edu
  986.            EUGENE.OR.US               meyer@oregon.uoregon.edu
  987.            SPRINGFIELD.OR.US          meyer@oregon.uoregon.edu
  988.            MULTNOMAH.LIB.OR.US        brianw@polaris.admin.ogi.edu
  989.            PGH.PA.US                  ecd@CERT.ORG
  990.            SPK.WA.US                  root@dogear.spk.wa.us
  991.            MIL.WI.US                  manager@spool.mu.edu
  992.            ATL.GA.US                  charvey@gatech.gatech.edu
  993.            Mt-PARK.GA.US              charvey@gatech.gatech.edu
  994.            CLARKSTON.GA.US            charvey@gatech.gatech.edu
  995.            STATE.MN.US                dfazio@mr.net
  996.            MNPL.FRB.FED.US            dfazio@mr.net
  997.  
  998.            K12.CA.US                  mdm@NIC.CSU.NET
  999.            CC.CA.US                   mdm@NIC.CSU.NET
  1000.            K12.MI.US                  sandra.s.waite@um.cc.umich.edu
  1001.            K12.TX.US                  bmanning@is.rice.edu
  1002.            K12.NJ.US                  becker@nisc.jvnc.net
  1003.            K12.MS.US                  fwp@msstate.edu
  1004.            dmhs.jcps.K12.KY.US        lentner@sura.net
  1005.            TIES.K12.MN.US             dfazio@mr.net
  1006.  
  1007.  
  1008.  
  1009.  
  1010. Cooper & Postel                                                [Page 18]
  1011.  
  1012. RFC 1386                     The US Domain                 December 1992
  1013.  
  1014.  
  1015.         The following MD.US counties have been delegated to
  1016.         (butler@brl.mil).
  1017.  
  1018.            AL.MD.US.       Allegany
  1019.            AA.MD.US.       Anne Arundel
  1020.            BA.MD.US.       Baltimore
  1021.            CAL.MD.US.      Calvert
  1022.            CAR.MD.US.      Caroline
  1023.            CE.MD.US.       Cecil
  1024.            CH.MD.US.       Charles
  1025.            DO.MD.US.       Dorchester
  1026.            FR.MD.US.       Frederick
  1027.            GA.MD.US.       Garrett
  1028.            HA.MD.US.       Harford
  1029.            HO.MD.US.       Howard
  1030.            KE.MD.US.       Kent
  1031.            MO.MD.US.       Montgomery
  1032.            PG.MD.US.       Prince George"s
  1033.            QA.MD.US.       Queen Anne's
  1034.            SM.MD.US.       St. Mary's
  1035.            SO.MD.US.       Somerset
  1036.            TA.MD.US.       Talbot
  1037.            WA.MD.US.       Washington
  1038.            WI.MD.US.       Wicomico
  1039.            WO.MD.US.       Worcester
  1040.  
  1041. 4. DATABASE INFORMATION
  1042.  
  1043.    4.1. Name Servers
  1044.  
  1045.    Name servers are the repositories of information that make up the
  1046.    domain database.  The database is divided up into sections called
  1047.    zones, which are distributed among the name servers.  While name
  1048.    servers can have several optional functions and sources of data, the
  1049.    essential task of a name server is to answer queries using data in
  1050.    its zones.  The response to a query can always be generated using
  1051.    only local data, and either contains the answer to the question or a
  1052.    referral to other name servers "closer" to the desired information.
  1053.  
  1054.    A given zone will be available from several name servers to insure
  1055.    its availability in spite of host or communication link failure.
  1056.    Every zone is required to be available on at least two servers, and
  1057.    many zones have more redundancy than that.
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066. Cooper & Postel                                                [Page 19]
  1067.  
  1068. RFC 1386                     The US Domain                 December 1992
  1069.  
  1070.  
  1071.    The US Domain is currently supported by six name servers.
  1072.  
  1073.            venera.isi.edu
  1074.            ns.isi.edu
  1075.            ns.hercules.csl.sri.com
  1076.            nnsc.nsf.net
  1077.            ns.uu.net
  1078.            adm.brl.mil
  1079.  
  1080.    4.2 Zone Files
  1081.  
  1082.    A "zone" is a registry of domains kept by a particular organization.
  1083.    A zone registry is "authoritative", that is, the master copy of the
  1084.    registry is kept by the zone organization, and this copy is, by
  1085.    definition, always up-to-date.  Copies of this registry may be
  1086.    distributed to other places and kept in caches, but these caches are
  1087.    not authoritative, and may be out-of-date.
  1088.  
  1089.    Every zone has at least one node, and hence domain name, for which it
  1090.    is authoritative, and all of the nodes in a particular zone are
  1091.    connected.  Given the tree structure, every zone has a highest node
  1092.    which is closer to the root than any other node in the zone.  The
  1093.    name of this node is often used to identify the zone.  The data that
  1094.    describes a zone has four major parts:
  1095.  
  1096.         1) Authoritative data for all nodes within the zone.
  1097.  
  1098.         2) Data that defines the top node of the zone
  1099.            (can be thought of as part of the authoritative data).
  1100.  
  1101.         3) Data that describes delegated subzones, i.e., cuts
  1102.            around the bottom of the zone,
  1103.  
  1104.         4) Data that allows access to name servers for subzones
  1105.            (sometimes called "glue" data).
  1106.  
  1107.    The zone administrator has to maintain the zones at all the
  1108.    namservers which are authoritative for the zone.  When the changes
  1109.    are made they must be distributed to all of the name servers.
  1110.  
  1111.    Copies of the zone files are not available unless you are on the
  1112.    Internet.  To look at the zone files use the "dig" program of the DNS
  1113.    domain name system.
  1114.  
  1115.         dig   @nshost  host-your-checking  axfr
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122. Cooper & Postel                                                [Page 20]
  1123.  
  1124. RFC 1386                     The US Domain                 December 1992
  1125.  
  1126.  
  1127.    4.3 Resource Records
  1128.  
  1129.    Records in the zone data files are called resource records (RRs).
  1130.    The standard Resource records (RR) are specified in STD 13, RFC 1034
  1131.    and STD 13, RFC 1035 (3,4).  An RR has a standard format as shown.
  1132.  
  1133.                   <name> [<ttl>] [<class>] <type> <data>
  1134.  
  1135.    The first field is always the name of the domain record.  The second
  1136.    field is an optional time to live field.  This specifies how long
  1137.    this data will be stored in the data base.  The third field is the
  1138.    address class; the class field specifies the protocol group most
  1139.    often this is the Internet class "IN".  The fourth field states the
  1140.    type of the resource record.  The fields after that are dependent on
  1141.    the Type of RR. The fifth field is the data field which is defined
  1142.    differently for each type and class of data.  Here is a list of the
  1143.    current commonly used types.
  1144.  
  1145.            SOA     Start of Authority
  1146.            NS      Name Server
  1147.            A       Internet Address
  1148.            CNAME   Canonical Name (nickname pointer)
  1149.            HINFO   Host Information
  1150.            WKS     Well Known Services
  1151.            MX      Mail Exchanger
  1152.            PTR     Pointer
  1153.  
  1154.    What do the fields mean?
  1155.  
  1156.            foo.LA.CA.US.    604800    MX   10     Venera.ISI.EDU.
  1157.            (1)              (2)       (3)  (4)    (5)
  1158.  
  1159.            1)  domain name
  1160.            2)  time to live information
  1161.            3)  mail exchanger record
  1162.            4)  preference value to determine (if more than one
  1163.                forwarder) which mailer to use first, lower number
  1164.                higher preference
  1165.            5)  the Internet forwarding host.
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178. Cooper & Postel                                                [Page 21]
  1179.  
  1180. RFC 1386                     The US Domain                 December 1992
  1181.  
  1182.  
  1183.    4.3.1  A Records
  1184.  
  1185.    Internet (IP) Address.  The data for an "A" record is an Internet
  1186.    address in a dotted decimal form.  A sample "A" record might look
  1187.    like:
  1188.  
  1189.            venera.isi.edu.          A      128.9.0.32
  1190.               (name)               (A)     (address)
  1191.  
  1192.    The name field is the machine name, and the address is the network
  1193.    address. There should be only one "A" record for each address of a
  1194.    host.
  1195.  
  1196.    4.3.2  CNAME Records
  1197.  
  1198.    Canonical Name resource record, CNAME, specifies an alias for a
  1199.    canonical name. This is essentially a pointer to the official name
  1200.    for the requested name.  All other RRs appear under this official
  1201.    name.  A machine named FERNWOOD.MPK.CA.US may want to have the
  1202.    nickname ANTERIOR.MPK.CA.US.  In that case, the following RR would be
  1203.    used:
  1204.  
  1205.            anterior.mpk.ca.us.     CNAME      fernwood.mpk.ca.us.
  1206.             (alias nickname)                   (canonical name)
  1207.  
  1208.    Nicknames (the name associated with the RR is the nickname) may be
  1209.    added for awhile when a host changes its name, usually because it
  1210.    moves to another state.  It helps to have this CNAME pointer so if
  1211.    any mail comes to the old address it will get forwarded to the new
  1212.    one.  There cannot be any other RRs associated with a nickname of the
  1213.    same class.
  1214.  
  1215.    4.3.3  MX Records
  1216.  
  1217.    Mail Exchanger records, MX, are used to specify a machine that knows
  1218.    how to deliver mail to a machine that is not directly connected to
  1219.    the Internet.  For example, venera.isi.edu is the mail gateway that
  1220.    knows how to deliver mail to foo.la.ca.us, but other machines on the
  1221.    network cannot deliver mail directly to foo.la.ca.us.  These two
  1222.    machines may have a private connection or use a different transport
  1223.    medium (such as uucp).  The preference value (10) is the order that a
  1224.    mailer should follow when there is more than one way to deliver mail
  1225.    to a single machine.  The lower the number the higher the preference.
  1226.  
  1227.            foo.LA.CA.US.  604800  MX  10  Venera.ISI.EDU.
  1228.            foo.LA.CA.US.  604800  MX  20  relay1.uu.net.
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234. Cooper & Postel                                                [Page 22]
  1235.  
  1236. RFC 1386                     The US Domain                 December 1992
  1237.  
  1238.  
  1239.    4.3.4   HINFO Records
  1240.  
  1241.    Host information resource records, HINFO is for host specific data.
  1242.    This lists the hardware and operating system that are running at the
  1243.    listed host.  It should be noted that a space separates the hardware
  1244.    information and the operating system information.  If you want to
  1245.    include a space in the machine name you must quote the name.  Host
  1246.    information is not specific to any class, so ANY may be used for the
  1247.    address class.  There should be one HINFO record for each host.
  1248.  
  1249.    acb.la.ca.us.       HINFO       VAX-11/780      UNIX
  1250.                                    (Hardware)      (Operating System)
  1251.  
  1252.    The official HINFO types can be found in the latest Assigned Numbers
  1253.    RFC, the most recent edition being RFC 1340.  The hardware type is
  1254.    called the Machine Name, and the software type is called the System
  1255.    Name.
  1256.  
  1257.    The information users supply about this is often inconsistent or
  1258.    incomplete.  Please follow the terms in the current "Assigned
  1259.    Numbers".
  1260.  
  1261.    4.3.5  PTR Records
  1262.  
  1263.    A Domain Name Pointer record, PTR, allows special names to point to
  1264.    some other location in the domain data base.  These are typically
  1265.    used in setting up reverse pointers for the special IN-ADDR.ARPA
  1266.    domain.  PTR names should be unique to the zone.
  1267.  
  1268.          0.0.9.128.in-addr.arpa     PTR    isi-net.isi.edu.
  1269.              (special name)                  (real name)
  1270.  
  1271.    A PTR record is to be added to the IN-ADDR.ARPA domain for every A
  1272.    record registered in the US Domain.  These PTR records need to be
  1273.    added by the administrator of the network where the host is
  1274.    connected.  The US Domain administration does not administer the
  1275.    network and cannot make these entries in the DNS database.
  1276.  
  1277.    4.4  Wildcards
  1278.  
  1279.    The wildcard records are of the form "*.<anydomain>", where
  1280.    <anydomain> is any domain name.  The wildcards potentially apply to
  1281.    descendents of <anydomain>, but not to <anydomain> itself.
  1282.  
  1283.    For example, suppose a large company located in California with a
  1284.    large, non-IP/TCP, network wanted to create a mail gateway.  If the
  1285.    company was called DWP.LA.CA.US, and the IP/TCP capable gateway
  1286.    machine (Internet forwarder) was called ELROY.JPL.NASA.GOV, the
  1287.  
  1288.  
  1289.  
  1290. Cooper & Postel                                                [Page 23]
  1291.  
  1292. RFC 1386                     The US Domain                 December 1992
  1293.  
  1294.  
  1295.    following RRs might be entered into the .US zone.
  1296.  
  1297.            dwp.la.ca.us    MX      10       ELROY.JPL.NASA.GOV
  1298.          *.dwp.la.ca.us    MX      10       ELROY.JPL.NASA.GOV
  1299.  
  1300.    The wildcard record *.DWP.LA.CA.US would cause an MX query for any
  1301.    domain name ending in DWP.LA.CA.US to return an MX RR pointing at
  1302.    ELROY.JPL.NASA.GOV. The entry without the "*" is needed so the host
  1303.    dwp can be found.
  1304.  
  1305.    In the US Domain, wildcard records are allowed in our zone files
  1306.    under the organizational subdomain (and where noted otherwise) but no
  1307.    wildcard records are allowed under the "City" or "State" domain.
  1308.  
  1309.        The authors strongly believe that it is in everyone's
  1310.        interest and good for the Internet to have each host
  1311.        explicitly registered (that is, we believe that wildcards
  1312.        should not be used), we also realize that not everyone
  1313.        agrees with this belief.  Thus, we will allow wildcard
  1314.        records in the US Domain under groups or organizations.
  1315.        For example, *.DWP.LA.CA.US.
  1316.  
  1317.        The reason we feel single entries are the best is by the mere
  1318.        fact that if anyone wanted to find one of the hosts in the
  1319.        domain name system it would be there, and problems can be
  1320.        detected more easily.  When using wildcards records all the
  1321.        hosts under a subdomain are hidden.
  1322.  
  1323. 5. REFERENCES
  1324.  
  1325.    [1]  Stahl, M., "Domain Administrators Guide", RFC 1032, SRI
  1326.         International, November 1987.
  1327.  
  1328.    [2]  Lottor, M., "Domain Administrators Operations Guide" RFC 1033,
  1329.         SRI International, November 1987.
  1330.  
  1331.    [3]  Mockapetris, P., "Domain Names - Concepts and Facilities",
  1332.         STD 13, RFC 1034, ISI, November 1987.
  1333.  
  1334.    [4]  Mockapetris, P., "Domain Names - Implementation and
  1335.         Specification", STD 13, RFC 1035, ISI, November 1987.
  1336.  
  1337.    [5]  Dunlap, K., "Name Server Operations Guide for Bind,
  1338.         Release 4.3", UC Berkeley, SMM:11-3.
  1339.  
  1340.    [6]  Partridge, C., "Mail Routing and the Domain Name System",
  1341.         STD 14, RFC 974, BBN, January 1986.
  1342.  
  1343.  
  1344.  
  1345.  
  1346. Cooper & Postel                                                [Page 24]
  1347.  
  1348. RFC 1386                     The US Domain                 December 1992
  1349.  
  1350.  
  1351. 6. SECURITY CONSIDERATIONS
  1352.  
  1353.    Security issues are not discussed in this memo.
  1354.  
  1355. 7. AUTHORS' ADDRESSES
  1356.  
  1357.    Ann Cooper
  1358.    USC/Information Sciences Institute
  1359.    4676 Admiralty Way
  1360.    Marina del Rey, CA  90292
  1361.  
  1362.    Phone:  1-310-822-1511
  1363.    Email:  cooper@isi.edu
  1364.  
  1365.  
  1366.    Jon Postel
  1367.    USC/Information Sciences Institute
  1368.    4676 Admiralty Way
  1369.    Marina del Rey, CA  90292
  1370.  
  1371.    Phone:  1-310-822-1511
  1372.    Email:  postel@isi.edu
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402. Cooper & Postel                                                [Page 25]
  1403.  
  1404. RFC 1386                     The US Domain                 December 1992
  1405.  
  1406.  
  1407.                      APPENDIX-I:  US DOMAIN NAMES BNF
  1408.                      ================================
  1409.  
  1410.    <us-domain-name>    ::= <us-name><dot><us>
  1411.  
  1412.    <us-name>           ::= <state-name><dot><state-code> |
  1413.                            <fed-name><dot><fed>
  1414.  
  1415.    <state-code>        ::= <the two-letter code of a state from the
  1416.                             zip code directory>
  1417.  
  1418.    <state-name>        ::= <local-name><dot><locality> |
  1419.                            <state-agency-name><dot><state> |
  1420.                            <regional-agency-name><dot><agency>
  1421.  
  1422.    <fed-name>          ::= <the dotted hierarchical name of a US
  1423.                             federal government agency>
  1424.  
  1425.    <locality>          ::= <the full name of a city from the
  1426.                              zip code directory> |
  1427.                            <a short code name for a city> |
  1428.                            <the full name of a county, township,
  1429.                             or parish> |
  1430.                            <other well known and commonly used
  1431.                             locality name>
  1432.  
  1433.    <local-name>        ::= <entity-name> |
  1434.                            <city-name><dot><city> |
  1435.                            <county-name><dot><county> |
  1436.                            <local-agency-name><dot><agency>
  1437.  
  1438.    <state-agency-name> ::= <the dotted hierarchical name of a state
  1439.                             government agency>
  1440.  
  1441.    <regional-agency-name> ::= <the dotted hierarchical name of a special
  1442.                             agency or district not an element of the
  1443.                             state government and typically larger than
  1444.                             a single city or county, for example, the
  1445.                             Southern California Air Quality Management
  1446.                             District>
  1447.  
  1448.    <entity-name>       ::= <the dotted hierarchical name of an entity
  1449.                             within a city, for example: a company,
  1450.                             business, private school, club, organization,
  1451.                             or individual>
  1452.  
  1453.    <city-name>         ::= <the dotted hierarchical name of a city
  1454.                             government agency>
  1455.  
  1456.  
  1457.  
  1458. Cooper & Postel                                                [Page 26]
  1459.  
  1460. RFC 1386                     The US Domain                 December 1992
  1461.  
  1462.  
  1463.    <county-name>       ::= <the dotted hierarchical name of a county,
  1464.                              township, or parish government agency>
  1465.  
  1466.    <local-agency-name> ::= <the dotted hierarchical name of a special
  1467.                             agency or district not an element of a
  1468.                             city or county government and typically
  1469.                             equal or smaller than a single city or
  1470.                             county, for example, the Bunker Hill
  1471.                             Improvement District>
  1472.  
  1473.  
  1474.    <city> ::= "CITY"
  1475.  
  1476.    <county> ::= "COUNTY" | "TOWNSHIP" | "PARISH"
  1477.  
  1478.    <dot> ::= "."
  1479.  
  1480.    <fed> ::= "FED"
  1481.  
  1482.    <agency> ::= "AGENCY" | "DISTRICT" | "K12" | "CC" | "LIB"
  1483.  
  1484.    <state> ::= "STATE" | "COMMONWEALTH"
  1485.  
  1486.    <us> ::= "US"
  1487.  
  1488.  
  1489.    Note:  "K12" may be used for public school districts, only.
  1490.           and "CC" may be used only for public community colleges,
  1491.           and "LIB" can only be used by libraries.
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514. Cooper & Postel                                                [Page 27]
  1515.  
  1516. RFC 1386                     The US Domain                 December 1992
  1517.  
  1518.  
  1519.             APPENDIX-II: US DOMAIN QUESTIONNAIRE FOR HOST ENTRY
  1520.  
  1521.  
  1522. To register a host in the US domain, the following information must be
  1523. sent to the US Domain Registrar (Us-Domain@ISI.EDU).  Questions may be
  1524. sent by electronic mail to the above address, or by phone to
  1525. Ann Cooper (310-822-1511).
  1526.  
  1527.  
  1528. (1)  The name of the top-level domain to join.
  1529.  
  1530.            For example:  US
  1531.  
  1532.  
  1533. (2)  The name of the administrative head of the organization, including
  1534.      title, mailing address, phone number, organization, and network
  1535.      mailbox.  This is the contact point for administrative and policy
  1536.      questions about the domain.  In the case of a research project,
  1537.      this should be the principal investigator.
  1538.  
  1539.            For example:
  1540.  
  1541.               Administrator
  1542.  
  1543.                  Organization  The NetWorthy Corporation
  1544.                  Name          Penelope Q. Sassafrass
  1545.                  Title         President
  1546.                  Mail Address  The NetWorthy Corporation
  1547.                                4676 Andrews Way, Suite 100
  1548.                                Santa Clara, CA 94302-1212
  1549.                  Phone Number  (415) 123-4567
  1550.                  Net Mailbox   Sassafrass@ECHO.TNC.COM
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570. Cooper & Postel                                                [Page 28]
  1571.  
  1572. RFC 1386                     The US Domain                 December 1992
  1573.  
  1574.  
  1575. (3)  The name of the technical contact for the entry, including title,
  1576.      mailing address, phone number, organization, and network mailbox.
  1577.      This is the contact point for problems concerning the domain or
  1578.      zone, as well as for updating information about the domain or zone.
  1579.  
  1580.            For example:
  1581.  
  1582.               Technical Contact
  1583.  
  1584.                  Organization  The NetWorthy Corporation
  1585.                  Name          Ansel A. Aardvark
  1586.                  Title         Executive Director
  1587.                  Mail Address  The NetWorthy Corporation
  1588.                                4676 Andrews Way, Suite 100
  1589.                                Santa Clara, CA. 94302-1212
  1590.                  Phone Number  (415) 123-6789
  1591.                  Net Mailbox   Aardvark@ECHO.TNC.COM
  1592.  
  1593.  
  1594. (4)  The name of the host.  This is the name that will be used in tables
  1595.      and lists associating the domain with the domain server addresses.
  1596.      [While, from a technical standpoint, domain names can be quite long
  1597.      (programmers beware), shorter names are easier for people to cope
  1598.      with.]
  1599.  
  1600.            For example:  NetWorthy.Santa-Clara.CA.US
  1601.  
  1602.            Or:  Alpha.NetWorthy.Santa-Clara.CA.US
  1603.                 Beta.NetWorthy.Santa-Clara.CA.US
  1604.  
  1605.  
  1606. (5)  If this machine is not directly on the internet, how does it
  1607.      communicate with the Internet.  Through UUCP, CREN, etc?  Which
  1608.      forwarding host?
  1609.  
  1610.           For example:  The host "Networthy.Santa-Clara.CA.US" uses UUCP
  1611.           to connect to "RELAY.ISI.EDU" which is an Internet host.
  1612.  
  1613.           The administrator of RELAY.ISI.EDU must agree to be the
  1614.           forwarding host for Networthy.Santa-Clara.CA.US, and the
  1615.           forwarding host must know a delivery method and route to it.
  1616.           No double MXing.
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626. Cooper & Postel                                                [Page 29]
  1627.  
  1628. RFC 1386                     The US Domain                 December 1992
  1629.  
  1630.  
  1631.           If you are requesting an indirect connection, that is, a Mail
  1632.           Exchanger (MX) record, what is the name and mailbox of the
  1633.           administrator of the forwarding host.
  1634.  
  1635.           For example:John Smith
  1636.                js@RELAY.ISI.EDU
  1637.  
  1638.  
  1639. (6)  Please describe your organization briefly.
  1640.  
  1641.      For example: The NetWorthy Corporation is a consulting
  1642.      organization of people working with UNIX and the C language in an
  1643.      electronic networking environment.  It sponsors two technical
  1644.      conferences annually and distributes a bimonthly newsletter.
  1645.  
  1646.  
  1647. (7)  What Domain Name System (DNS) Resource Records (RR) and values are
  1648.      to be entered.
  1649.  
  1650.      a.  A       Internet Address (internet hosts only)
  1651.      b.  HINFO   Host Information, Machine System
  1652.      c.  WKS     Well Known Services, Protocols, Ports (internet hosts only)
  1653.      d.  MX      Mail Exchanger (required for UUCP, and CREN hosts)
  1654.  
  1655.      An example of RRs for an internet host.
  1656.  
  1657.      NetWorthy.Santa-Clara.CA.US   IN   A       128.9.3.123
  1658.                               IN   HINFO   SUN-3/11OC UNIX
  1659.                               IN   MX      10  ISI.EDU
  1660.                               IN   WKS     128.9.3.123. UDP (echo
  1661.                                                              tftp)
  1662.                               IN   WKS     128.9.3.133. TCP (telnet
  1663.                                                              ftp
  1664.                                                              tftp
  1665.                                                              finger)
  1666.  
  1667.      An example of RRs for a non-internet host.
  1668.  
  1669.      Beta.NetWorthy.Santa-Clara.CA.US   MX      10   RELAY.ISI.EDU
  1670.                                         HINFO   SUN-3/11OC UNIX
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682. Cooper & Postel                                                [Page 30]
  1683.  
  1684. RFC 1386                     The US Domain                 December 1992
  1685.  
  1686.  
  1687. (8)  Where is the IN-ADDR pointer record to be entered. (For internet
  1688.      hosts only.)  It is your responsibility to see that this is done.
  1689.      Contact the administrator of the IP network your host is on.  The
  1690.      US Domain administration does not administer the network and cannot
  1691.      make these entries in the DNS database.
  1692.  
  1693.         For example:
  1694.  
  1695.            123.3.9.128.IN-ADDR.ARPA.    PTR  NetWorthy.Santa-Clara.CA.US
  1696.  
  1697.      Who is the contact for the zone of the IN-ADDR.ARPA data, where
  1698.      this record will be entered?
  1699.  
  1700.  
  1701. (9)  What Time to Live (TTL)?  TTL is the time (in seconds) that a
  1702.      resolver will use the data it got from the domain server before it
  1703.      asks it again for the data.  A typical TTL is One Week 604800.
  1704.      (NOTE:  TTL is not applicable to non-Internet hosts.)
  1705.  
  1706.         For example:
  1707.  
  1708.            One Week   604800
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738. Cooper & Postel                                                [Page 31]
  1739.