Network Working Group                                       Marc A. Elvy
Request for Comments: 915                             Harvard University
                                                            Rudy Nedved
                                             Carnegie-Mellon University
                                                          December 1984

                      NETWORK MAIL PATH SERVICE


STATUS OF THIS MEMO

  This RFC proposes a new service for the ARPA-Internet community and
  requests discussion and suggestions for improvements.  Distribution
  of this memo is unlimited.

INTRODUCTION

  The network mail path service fills the current need of people to
  determine mailbox addresses for hosts that are not part of the
  ARPA-Internet but can be reached by one or more relay hosts that have
  Unix To Unix Copy (UUCP) mail, CSNET mail, MAILNET mail, BITNET mail,
  etc.

  Anyone can use the service if they have TCP/TELNET to one of the
  hosts with a mail path server.

DISCUSSION

  Currently many hosts that are not connected to the ARPA-Internet
  network can send mail to and receive mail from the ARPA-Internet
  community.  The ARPA-Internet community sends mail using mailbox
  addresses of the form "user@host" or "local-part@domain" [1, 5].  In
  an effort to provide service to hosts not connected directly to the
  ARPA-Internet, mail maintainers have used the feature that the
  "local-part" of the mailbox address is locally interpreted to imbed
  specially encoded mail routing or relaying information.  These
  encoded mailbox addresses have a variety of forms and have become
  common practice. For example:

     demco%ucb-ean.cdn%[email protected]

     "Rudy.Nedved%[email protected]"@MIT-MULTICS.ARPA

     [email protected]

     [email protected]

     nedved%[email protected]

  It is important that people be able to communicate, but it is clear
  from the rampant confusion and frustration that something must be


Elvy & Nedved                                                   [Page 1]



RFC 915                                                       Month Year
Network Mail Path Service


  provided to make it easier for people to address mail to
  non-ARPA-Internet hosts.  The result, for a variety of reasons, has
  been the work and development of the Domain Name system and
  facilities [2, 3, 7, 9], and it is expected to make mailbox addresses
  be as simple as the current ARPA-Internet mailbox format (e.g.,
  "user@domain").

  How do people discover the special encoded addresses for
  non-ARPA-Internet host mailboxes until the domain name system is
  working and covering the majority of hosts in the mail world?  The
  proposed solution to this problem is to provide a network service for
  the ARPA-Internet and a mail service for the non-ARPA-Internet hosts
  that, given a host and an optional addressing system or communication
  protocol or some other piece of information, supplies the mailbox
  address format for sending mail to that host.  For example,
  "[email protected]" would be translated by the server to
  "nedved%[email protected]". This memo covers the
  proposed network service.

DOCUMENT CONVENTIONS

  Unless otherwise noted, all numbers are in decimal.

  The term "host", as used in this document, describes one computer
  system which may have more than one name associated with it. It may
  have a name for each network or mail connection it supports and may
  have several nicknames or aliases for the computer and/or for each
  set of network names that the computer has acquired.

OVERVIEW

  The network service is a connection based application on TCP [4].  A
  server listens for TCP connections on the assigned port of 117 [8].
  It responds to the connection with a coded greeting message and waits
  for a command line. For each command line sent to the server, the
  server will respond with a coded message.  The special command QUIT
  causes the server to respond with a coded closing message and closes
  the connection.











Elvy & Nedved                                                   [Page 2]



RFC 915                                                       Month Year
Network Mail Path Service


DESIGN GOALS

  One of the goals is to provide the service to as many ARPA-Internet
  hosts as possible. In the current ARPA-Internet, experience has shown
  that software people first implement TELNET/TCP [6] before any other
  network application or protocol. Therefore, it is a sub-goal that
  people be able to access the service using available programs (with
  minimal modifications) that implement TELNET/TCP.  Therefore,
  TELNET/TCP on port 117 will work correctly.  The server understands
  TELNET options but refuses all option negotiations that disagree with
  the NVT characteristics defined by the TELNET protocol (see [6]),
  does not echo, and expects command lines to end with <CRLF> (ASCII
  code 13 (octal 15) followed by code 10 (octal 12)).  Character
  echoing and line editing is expected to be handled by the user host
  for the benefit of the user.

  Mail systems and other programs are also expected to be able to
  access and understand the service.  Each command reply can have
  multiple line responses with text understandable by the novice user.
  Each command is encoded so as to make it easy for a program to parse
  the lines and extract interesting information, such as whether the
  operation was successful.

THE PROTOCOL

  Given the developing nature of the protocol and its intent, the
  command lines are composed of a command (case ignored) followed by
  white space, the argument(s) and a <CRLF>. The white space is
  required if any arguments are supplied but the arguments are
  optional.  White space following the command and any optional
  arguments are ignored.

     <cmdline> := <cmd> [<WS> <args>] [<WS>] <CRLF>

     <WS> := [<WS>] <WS> | <TAB> | <SPACE>

  Coded response lines have the rigid format of a 3-digit decimal code
  followed by a space or a dash followed by text composed of characters
  within the ASCII range 32 to 126 (octal 40 to 176) with <CRLF> at the
  end of the line.  The dash after the 3-digit code indicates at least
  one more response line will be supplied while the space indicates the
  current response line is the last one.

     <rspline> := <digit><digit><digit><cont><rtext><CRLF>

     <cont> := <SPACE> | "-"



Elvy & Nedved                                                   [Page 3]



RFC 915                                                       Month Year
Network Mail Path Service


     <rtext> := ASCII characters in the range 32 to 126.

  Some of the successful response text to certain commands have rigid
  formats so programs can extract path information. The commands that
  have format restrictions are clearly noted and the response format is
  documented with the command.

  The response codes are in the range from 200 to 599 inclusively. The
  following paragraphs provide the break down for each digit.

  The first, most significant, digit is the success indicator. It
  breaks down into the simple success and total failure responses but
  includes the ability to communicate a temporary failure condition and
  the need for further information that has worked so well for SMTP [5]
  and other similiar protocols.  The codes are:

     2xx  Positive reply.

     3xx  Intermedate reply. Positive acknowlegement but more
          information is neccessary.

     4xx  Temporary error. Try again later.

     5xx  Permanent error. Do not retry.

  The second digit is used to classify the response to provide a flavor
  for certain types of success. The flavor is apparent in providing the
  response on whether a host name is known by a domain name server or
  not. The codes are:

     x0x  Command related response.

     x1x  Connection related response.

     x2x  Database related response.

     x3x  Domain transition related response.

     x4x  Data added response.

     x5x  Data deleted response.

     x6x  Data modified response.






Elvy & Nedved                                                   [Page 4]



RFC 915                                                       Month Year
Network Mail Path Service


BASIC IMPLEMENTATION

  The minimum implementation is the support of three commands: HELP,
  PATH and QUIT. The HELP command provides some level of documentation
  and possibly lists the known addressing or communication protocols.
  The PATH command takes as a required argument a user name or id
  followed by a "@", followed by a domain style host name whose domain
  components may be an addressing protocol, a communication
  environment, or an unofficial or colloquial domain.

     S: (server listens on port 117)
     U: (user connects to port 117)
     S: 210-Welcome to the CMU network mail path service.
     S: 210 Type 'HELP' for help.
     U: help
     S: 200-The server currently knows about the following mail worlds:
     S: 200-    BITNET,UUCP,CSNET,.AC.UK,EARNET,JANET,CDNNET
     S: 200-Use the PATH command with "[email protected]" to get the
     S: 200 ARPA-Internet mail address.
     U: path [email protected]
     S: 220 [email protected]
     U: quit
     S: 211 Bye bye.
     S: (server closes connection)

DETAILED PROTOCOL DESCRIPTION

  The protocol is designed to provide a flexible but conservative
  mechanism for providing responses and adding experimental or extended
  commands.

     <user connects to server>

        The server responds with a message indicating the status of the
        server and optional information.

           210  Greeting message indicating the server is ready.

           410  The server is down for some unknown reason for a short
                time.

           510  The server is unavailable.

     HELP [<arg>]

        The server can respond with general help information about the
        server, about the specific topic described by "arg", or it can


Elvy & Nedved                                                   [Page 5]



RFC 915                                                       Month Year
Network Mail Path Service


        indicate that something is temporarily wrong with the HELP
        facility.  It is strongly recomended that the general HELP
        command documentation be implemented and expanded.

           200  General or specific documentation given.

           220  Documentation given from a database.

           421  Service temporarily unavailable.

           501  Command not implemented or topic not known.

     PATH <user>@<host>

        The server normally responds with either the mail path that
        will work for the given mailbox address or indicates the domain
        style host name is unknown. If the database is in transition or
        inconsistent, a temporary or permanent error can be supplied.

           220  Rigid format route given.

           230  Rigid format route given. Domain servers should be
                used.

           420  Database problems. Try again later.

           501  Invalid argument form or null argument given.

           520  No such host found in database.

           521  Host name is ambiguous.

     When a route is supplied with the 2xx success responses. It has a
     fixed format with a one-line response. The format is as follows:

        <3-digit-code><SP><local-part>@<domain><CRLF>

     The "local-part" and "domain" components are defined under the
     SMTP protocol [5] and are intended to be used over SMTP
     connections.

     QUIT

        Respond and close the server down.

           211  Close the connection down.



Elvy & Nedved                                                   [Page 6]



RFC 915                                                       Month Year
Network Mail Path Service


  One special code is reserved and is used for a special case. The code
  is 412 and is sent when the server has been waiting for a response
  for more then 2 minutes and has decided to timeout the connection.
  After the "412 <timeout msg>" is sent, the server may close or
  possibly abort the connection.

  Because of the somewhat experimental nature of the server, additional
  commands are expected to be added as they become needed. No
  restrictions are placed on the names of these experimental commands
  other then the must not conflict with the basic commands and are not
  allowed to be abbreviated (i.e., "SEAR" can not be used for
  "SEARCH").

PATH COMMAND ARGUMENTS

  It is important to understand that the server is an aid to users that
  may have minimal amount of information about the host. Therefore the
  PATH command takes domain style host names that may be complete or
  incomplete specifications for the host and may be common or
  colloquial domain names. The servers look through the entire database
  for anything that matches and try to find the best answer
  disregarding any local domain information.  If several hosts have the
  same nickname or alias and lack distinguishing domain components, the
  server returns an error response containing all of the hosts found.
  Some implementation may even break down the host name and indicate in
  error messages that even though it did not find the host, it found
  something else that might be what the user wanted.

MAIL PATH SERVICE AND DOMAINS

  As mentioned previously, the mail path service is not intended to be
  a replacement or a parallel service to the domain name system.  It is
  a stop gap measure and, when most of the domain name system is in
  place, will probably be disabled on some or most of the hosts with
  the service.

  Mail systems should check the domain name servers for the specified
  host before trying a mail path server. The mail path servers should
  be modified when one or more domain servers are in place to check if
  a host is part of the domain system and to generate an error or an
  indication (but still include the path information) if a host is
  found to be a part of the domain system.

  The names used by the mail path servers have no official standing in
  the ARPA-Internet community and have colloquial origins. The domain
  name components are based on the adminstrative entities involved
  whereas many of the current unofficial common domain style names for


Elvy & Nedved                                                   [Page 7]



RFC 915                                                       Month Year
Network Mail Path Service


  non-ARPA-Internet hosts are based on the protocol used, the relay
  host used, or some acronym that someone dreamed up.  Only a few of
  the current domain style names that are privately in use are expected
  to be used by the ARPA-Internet community when the domain name
  service is in use by the majority of the ARPA-Internet community.

CAVEATS

  The greatest problem with the new service, as implemented, is that it
  reports paths from the service host rather than from the user's host.
  This is due to the nature of software.  It would be more convenient
  if it reported a correct path from the caller's host, but this would
  require a different method of database management (a method which
  could quickly compute the path from the caller's machine or a machine
  which would be willing to keep updated databases for each host (which
  is impractical)).

  Two minor problems exist with the database used by the software. Many
  relay hosts exist in several different protocol or addressing name
  spaces but under different names. The current software cross
  referencing for the multiple protocol relay hosts is done by hand,
  but, given the seeming reliability of these relay hosts, the problem
  does not appear to be significant.  The second problem is that the
  data should be collected from the actual relay hosts to ensure
  correctness, but in many cases this is impossible.

EXAMPLES

  Find a route to CMU-CC-TE in the CARNEGIE part of MAILNET for user id
  EN0C:

     S: (server listens on port 117)
     U: (user connects to port 117)
     S: 210-Welcome to the CMU network mail path service
     S: 210 Type 'HELP' for help.
     U: path [email protected]
     S: 220 EN0C%CMU-CC-TE%[email protected]
     U: quit
     S: 211 Bye bye.
     S: (server closes connection)









Elvy & Nedved                                                   [Page 8]



RFC 915                                                       Month Year
Network Mail Path Service


  Find a route to a host which has an unknown addressing system or
  communication protocol and for which the name may be an alias:

     S: (server listens on port 117)
     U: (user connects to port 117)
     S: 210-Welcome to the CMU network mail path service
     S: 210 Type 'HELP' for help.
     U: path mss@dartvax
     S: 220 mss%[email protected]
     U: quit
     S: 211 Bye bye.
     S: (server closes connection)

  Find a route to a host that is known by a very long domain style name
  but is not in the current ARPA-Internet host tables:

     S: (server listens on port 117)
     U: (user connects to port 117)
     S: 210-Welcome to the CMU network mail path service
     S: 210 Type 'HELP' for help.
     U: path [email protected]
     S: 220 rob%[email protected]
     U: quit
     S: 211 Bye bye.
     S: (server closes connection)

  Find a route to a host without any additional information and the
  name is discovered to be ambiguous:

     S: (server listens on port 117)
     U: (user connects to port 117)
     S: 210-Welcome to the CMU network mail path service
     S: 210 Type 'HELP' for help.
     U: path brad@pitt
     S: 521-Several hosts found under the name of 'pitt', try one of:
     S: [email protected]
     S: [email protected]
     U: path [email protected]
     S: 220 brad%[email protected]
     U: quit
     S: 211 Bye bye.
     S: (server closes connection)







Elvy & Nedved                                                   [Page 9]



RFC 915                                                       Month Year
Network Mail Path Service


ACKNOWLEDGEMENTS

  The original protocol was documented by Marc Elvy for a server that
  he and Alan Langerman built.  The server used the pathalias software
  created by Steve Bellovin, as modified by Peter Honeyman and Robert
  T. Morris, to maintain the host to host connection database.  The
  software provided a way for people to make sense out of the jungle of
  UUCP hosts. The Info-Nets@MIT-MC mailing list, created and maintained
  by Robert Krawitz, made the CMU and Harvard mail path projects aware
  of each other and the people on the list provided many of the mail
  relay databases that are in use by the mail path servers.  The
  original server may be accessed through TCP port 117 on harvard.arpa
  -- the "pathto" program that runs under 4.2BSD UNIX may be obtained
  as a front end to the server from [email protected].

  The current protocol scope was changed by Rudy Nedved to cover
  BITNET, CSNET, MAILNET and other "mail networks" and further refined
  by Marc Elvy, Alan Langerman and others.

  Comments should be sent to [email protected] or mailed (via the
  U.S.  Postal Service) to:

     Marc A. Elvy
     108 Aiken Computation Laboratory
     33 Oxford Street
     Harvard University
     Cambridge, MA 02138

     (617) 495-5849

     Rudy Nedved
     Department of Computer Science
     Carnegie-Mellon University
     Schenley Park
     Pittsburgh, PA 15213

     (412) 578-7685












Elvy & Nedved                                                  [Page 10]



RFC 915                                                       Month Year
Network Mail Path Service


REFERENCES

  [1]   Crocker, D. "Standard for the Format of ARPA Internet Text
        Messages". RFC 822, Department of Electrical Engineering,
        University of Delaware, August, 1982.

  [2]   Mockapetris, P. "Domain Names - Concepts and Facilities".
        RFC 882, USC/Information Sciences Institute, Novemeber, 1983.

  [3]   Mockapetris, P. "Domain Names - Implementation Specification".
        RFC 883, USC/Information Sciences Institute, Novemeber, 1983.

  [4]   Postel, J. "Transmission Control Protocol- DARPA Internet
        Program Protocol Specification". RFC 793, USC/Information
        Sciences Institute, September, 1981.

  [5]   Postel, J. "Simple Mail Transfer Prootcol". RFC 821,
        USC/Information Sciences Institute, August, 1982.

  [6]   Postel, J., and J. Reynolds. "Telnet Protocol Specification".
        RFC 854, USC/Information Sciences Institute, May, 1983.

  [7]   Postel, J. "Domain Name System Implementation Schedule".
        RFC 897, USC/Information Sciences Institute, Feburary, 1984.

  [8]   Reynolds, J., and J. Postel. "Assigned Numbers". RFC 923,
        USC/Information Sciences Institute, October, 1984.

  [9]   Su, Z., and Postel, J. "The Domain Naming Convention for
        Internet User Applications". RFC 819, SRI International,
        August, 1982.


















Elvy & Nedved                                                  [Page 11]