Network Working Group                                            M. Rose
Request for Comments: 1082                                           TWG
                                                          November 1988



                   Post Office Protocol - Version 3
                      Extended Service Offerings

Status of This Memo

  This memo suggests a simple method for workstations to dynamically
  access mail from a discussion group server, as an extension to an
  earlier memo which dealt with dynamically accessing mail from a
  mailbox server using the Post Office Protocol -  Version 3 (POP3).
  This RFC specifies a proposed protocol for the Internet community,
  and requests discussion and suggestions for improvements.  All of the
  extensions described in this memo to the POP3 are OPTIONAL.
  Distribution of this memo is unlimited.

Introduction and Motivation

  It is assumed that the reader is familiar with RFC 1081 that
  discusses the Post Office Protocol - Version 3 (POP3) [RFC1081].
  This memo describes extensions to the POP3 which enhance the service
  it offers to clients.  This additional service permits a client host
  to access discussion group mail, which is often kept in a separate
  spool area, using the general POP3 facilities.

  The next section describes the evolution of discussion groups and the
  technologies currently used to implement them.  To summarize:

      o An exploder is used to map from a single address to
      a list of addresses which subscribe to the list, and redirects
      any subsequent error reports associated with the delivery of
      each message.  This has two primary advantages:
            - Subscribers need know only a single address
            - Responsible parties get the error reports and not
              the subscribers












Rose                                                            [Page 1]

RFC 1082                 POP3 Extended Service             November 1988


      o Typically, each subscription address is not a person's private
      maildrop, but a system-wide maildrop, which can be accessed
      by more than one user.  This has several advantages:
            - Only a single copy of each message need traverse the
              net for a given site (which may contain several local
              hosts).  This conserves bandwidth and cycles.
            - Only a single copy of each message need reside on each
              subscribing host.  This conserves disk space.
            - The private maildrop for each user is not cluttered
              with discussion group mail.

  Despite this optimization of resources, further economy can be
  achieved at sites with more than one host.  Typically, sites with
  more than one host either:

       1.  Replicate discussion group mail on each host.  This
       results in literally gigabytes of disk space committed to
       unnecessarily store redundant information.

       2.  Keep discussion group mail on one host and give all users a
       login on that host (in addition to any other logins they may
       have).  This is usually a gross inconvenience for users who
       work on other hosts, or a burden to users who are forced to
       work on that host.

  As discussed in [RFC1081], the problem of giving workstations dynamic
  access to mail from a mailbox server has been explored in great
  detail (originally there was [RFC918], this prompted the author to
  write [RFC1081], independently of this [RFC918] was upgraded to
  [RFC937]).  A natural solution to the problem outlined above is to
  keep discussion group mail on a mailbox server at each site and
  permit different hosts at that site to employ the POP3 to access
  discussion group mail.  If implemented properly, this avoids the
  problems of both strategies outlined above.

       ASIDE:     It might be noted that a good distributed filesystem
                  could also solve this problem.  Sadly, "good"
                  distributed filesystems, which do not suffer
                  unacceptable response time for interactive use, are
                  few and far between these days!

  Given this motivation, now let's consider discussion groups, both in
  general and from the point of view of a user agent.  Following this,
  extensions to the POP3 defined in [RFC1081] are presented.  Finally,
  some additional policy details are discussed along with some initial
  experiences.





Rose                                                            [Page 2]

RFC 1082                 POP3 Extended Service             November 1988


What's in a Discussion Group

  Since mailers and user agents first crawled out of the primordial
  ARPAnet, the value of discussion groups have been appreciated,
  (though their implementation has not always been well-understood).

  Described simply, a discussion group is composed of a number of
  subscribers with a common interest.  These subscribers post mail to a
  single address, known as a distribution address.  From this
  distribution address, a copy of the message is sent to each
  subscriber.  Each group has a moderator, which is the person that
  administrates the group.  The moderator can usually be reached at a
  special address, known as a request address.  Usually, the
  responsibilities of the moderator are quite simple, since the mail
  system handles the distribution to subscribers automatically.  In
  some cases, the interest group, instead of being distributed directly
  to its subscribers, is put into a digest format by the moderator and
  then sent to the subscribers.  Although this requires more work on
  the part of the moderator, such groups tend to be better organized.

  Unfortunately, there are a few problems with the scheme outlined
  above.  First, if two users on the same host subscribe to the same
  interest group, two copies of the message get delivered.  This is
  wasteful of both processor and disk resources.

  Second, some of these groups carry a lot of traffic.  Although
  subscription to an group does indicate interest on the part of a
  subscriber, it is usually not interesting to get 50 messages or so
  delivered to the user's private maildrop each day, interspersed with
  personal mail, that is likely to be of a much more important and
  timely nature.

  Third, if a subscriber on the distribution list for a group becomes
  "bad" somehow, the originator of the message and not the moderator of
  the group is notified.  It is not uncommon for a large list to have
  10 or so bogus addresses present.  This results in the originator
  being flooded with "error messages" from mailers across the Internet
  stating that a given address on the list was bad.  Needless to say,
  the originator usually could not care less if the bogus addresses got
  a copy of the message or not.  The originator is merely interested in
  posting a message to the group at large.  Furthermore, the moderator
  of the group does care if there are bogus addresses on the list, but
  ironically does not receive notification.

  There are various approaches which can be used to solve some or all
  of these problems.  Usually these involve placing an exploder agent
  at the distribution source of the discussion group, which expands the
  name of the group into the list of subscription addresses for the



Rose                                                            [Page 3]

RFC 1082                 POP3 Extended Service             November 1988


  group.  In the process, the exploder will also change the address
  that receives error notifications to be the request address or other
  responsible party.

  A complementary approach, used in order to cut down on resource
  utilization of all kinds, replaces all the subscribers at a single
  host (or group of hosts under a single administration) with a single
  address at that host.  This address maps to a file on the host,
  usually in a spool area, which all users can access.  (Advanced
  implementations can also implement private discussion groups this
  way, in which a single copy of each message is kept, but is
  accessible to only a select number of users on the host.)

  The two approaches can be combined to avoid all of the problems
  described above.

  Finally, a third approach can be taken, which can be used to aid user
  agents processing mail for the discussion group:  In order to speed
  querying of the maildrop which contains the local host's copy of the
  discussion group, two other items are usually associated with the
  discussion group, on a local basis.  These are the maxima and the
  last-date.  Each time a message is received for the group on the
  local host, the maxima is increased by at least one.  Furthermore,
  when a new maxima is generated, the current date is determined.  This
  is called the last date.  As the message is entered into the local
  maildrop, it is given the current maxima and last-date.  This permits
  the user agent to quickly determine if new messages are present in
  the maildrop.

      NOTE:      The maxima may be characterized as a monotonically
                 increasing quanity.  Although sucessive values of the
                 maxima need not be consecutive, any maxima assigned
                 is always greater than any previously assigned value.

Definition of Terms

  To formalize these notions somewhat, consider the following 7
  parameters which describe a given discussion group from the
  perspective of the user agent (the syntax given is from [RFC822]):












Rose                                                            [Page 4]

RFC 1082                 POP3 Extended Service             November 1988


        NAME            Meaning: the name of the discussion group
                        Syntax:  TOKEN (ALPHA *[ ALPHA / DIGIT / "-" ])
                                 (case-insensitive recognition)
                        Example: unix-wizards

        ALIASES         Meaning: alternates names for the group, which
                                 are locally meaningful; these are
                                 typically used to shorten user typein
                        Syntax:  TOKEN (case-insensitive recognition)
                        Example: uwiz

        ADDRESS         Meaning: the primary source of the group
                        Syntax:  822 address
                        Example: [email protected]

        REQUEST         Meaning: the primary moderator of the group
                        Syntax:  822 address
                        Example: [email protected]

        FLAGS           Meaning: locally meaningful flags associated
                                 with the discussion group; this memo
                                 leaves interpretation of this
                                 parameter to each POP3 implementation
                        Syntax:  octal number
                        Example: 01

        MAXIMA          Meaning: the magic cookie associated with the
                                 last message locally received for the
                                 group; it is the property of the magic
                                 cookie that it's value NEVER
                                 decreases, and increases by at least
                                 one each time a message is locally
                                 received
                        Syntax:  decimal number
                        Example: 1004

        LASTDATE        Meaning: the date that the last message was
                                 locally received
                        Syntax:  822 date
                        Example: Thu, 19 Dec 85 10:26:48 -0800

  Note that the last two values are locally determined for the maildrop
  associated with the discussion group and with each message in that
  maildrop.  Note however that the last message in the maildrop have a
  different MAXIMA and LASTDATE than the discussion group.  This often
  occurs when the maildrop has been archived.





Rose                                                            [Page 5]

RFC 1082                 POP3 Extended Service             November 1988


  Finally, some local systems provide mechanisms for automatically
  archiving discussion group mail.  In some cases, a two-level archive
  scheme is used:  current mail is kept in the standard maildrop,
  recent mail is kept in an archive maildrop, and older mail is kept
  off-line.  With this scheme, in addition to having a "standard"
  maildrop for each discussion group, an "archive" maildrop may also be
  available.  This permits a user agent to examine the most recent
  archive using the same mechanisms as those used on the current mail.

The XTND Command

  The following commands are valid only in the TRANSACTION state of the
  POP3.  This implies that the POP3 server has already opened the
  user's maildrop (which may be empty).  This maildrop is called the
  "default maildrop".  The phrase "closes the current maildrop" has two
  meanings, depending on whether the current maildrop is the default
  maildrop or is a maildrop associated with a discussion group.

  In the former context, when the current maildrop is closed any
  messages marked as deleted are removed from the maildrop currently in
  use.  The exclusive-access lock on the maildrop is then released
  along with any implementation-specific resources (e.g., file-
  descriptors).

  In the latter context, a maildrop associated with a discussion group
  is considered to be read-only to the POP3 client.  In this case, the
  phrase "closes the current maildrop" merely means that any
  implementation-specific resources are released.  (Hence, the POP3
  command DELE is a no-op.)

  All the new facilities are introduced via a single POP3 command,
  XTND.  All positive reponses to the XTND command are multi-line.

  The most common multi-line response to the commands contains a
  "discussion group listing" which presents the name of the discussion
  group along with it's maxima.  In order to simplify parsing all POP3
  servers are required to use a certain format for discussion group
  listings:

                             NAME SP MAXIMA

  This memo makes no requirement on what follows the maxima in the
  listing.  Minimal implementations should just end that line of the
  response with a CRLF pair.  More advanced implementations may include
  other information, as parsed from the message.

      NOTE:      This memo STRONGLY discourages implementations from
                 supplying additional information in the listing.



Rose                                                            [Page 6]

RFC 1082                 POP3 Extended Service             November 1988


  XTND BBOARDS [name]
  Arguments: the name of a discussion group (optionally)
  Restrictions: may only be given in the TRANSACTION state.
  Discussion:

  If an argument was given, the POP3 server closes the current
  maildrop.  The POP3 server then validates the argument as the name of
  a discussion group.  If this is successful, it opens the maildrop
  associated with the group, and returns a multi-line response
  containing the discussion group listing.  If the discussion group
  named is not valid, or the associated archive maildrop is not
  readable by the user, then an error response is returned.

  If no argument was given, the POP3 server issues a multi-line
  response.  After the initial +OK, for each discussion group known,
  the POP3 server responds with a line containing the listing for that
  discussion group.  Note that only world-readable discussion groups
  are included in the multi-line response.

  In order to aid user agents, this memo requires an extension to the
  scan listing when an "XTND BBOARDS" command has been given.
  Normally, a scan listing, as generated by the LIST, takes the form:

         MSGNO SIZE

  where MSGNO is the number of the message being listed and SIZE is the
  size of the message in octets.  When reading a maildrop accessed via
  "XTND BBOARDS", the scan listing takes the form

         MSGNO SIZE MAXIMA

  where MAXIMA is the maxima that was assigned to the message when it
  was placed in the BBoard.

  Possible Responses:
      +OK XTND
      -ERR no such bboard
  Examples:
      C:    XTND BBOARDS
      S:    +OK XTND
      S:    system 10
      S:    mh-users 100
      S:    .
      C:    XTND BBOARDS system
      S:    + OK XTND
      S:    system 10
      S:    .




Rose                                                            [Page 7]

RFC 1082                 POP3 Extended Service             November 1988


  XTND ARCHIVE name
  Arguments: the name of a discussion group (required)
  Restrictions: may only be given in the TRANSACTION state.
  Discussion:

  The POP3 server closes the current maildrop.  The POP3 server then
  validates the argument as the name of a discussion group.  If this is
  successful, it opens the archive maildrop associated with the group,
  and returns a multi-line response containing the discussion group
  listing.  If the discussion group named is not valid, or the
  associated archive maildrop is not readable by the user, then an
  error response is returned.

  In addition, the scan listing generated by the LIST command is
  augmented (as described above).

  Possible Responses:
      +OK XTND
      -ERR no such bboard Examples:
      C:    XTND ARCHIVE system
      S:    + OK XTND
      S:    system 3
      S:    .

  XTND X-BBOARDS name
  Arguments: the name of a discussion group (required)
  Restrictions: may only be given in the TRANSACTION state.
  Discussion:

  The POP3 server validates the argument as the name of a
  discussion group.  If this is unsuccessful, then an error
  response is returned.  Otherwise a multi-line response is
  returned.  The first 14 lines of this response (after the
  initial +OK) are defined in this memo.  Minimal implementations
  need not include other information (and may omit certain
  information, outputing a bare CRLF pair).  More advanced
  implementations may include other information.

          Line    Information (refer to "Definition of Terms")
          ----    -----------
            1     NAME
            2     ALIASES, separated by SP
            3     system-specific: maildrop
            4     system-specific: archive maildrop
            5     system-specific: information
            6     system-specific: maildrop map
            7     system-specific: encrypted password
            8     system-specific: local leaders, separated by SP



Rose                                                            [Page 8]

RFC 1082                 POP3 Extended Service             November 1988


            9     ADDRESS
           10     REQUEST
           11     system-specific: incoming feed
           12     system-specific: outgoing feeds
           13     FLAGS SP MAXIMA
           14     LASTDATE

  Most of this information is entirely too specific to the UCI Version
  of the Rand MH Message Handling System [MRose85].  Nevertheless,
  lines 1, 2, 9, 10, 13, and 14 are of general interest, regardless of
  the implementation.

          Possible Responses:
              +OK XTND
              -ERR no such bboard
          Examples:
              C:    XTND X-BBOARDS system
              S:    + OK XTND
              S:    system
              S:    local general
              S:    /usr/bboards/system.mbox
              S:    /usr/bboards/archive/system.mbox
              S:    /usr/bboards/.system.cnt
              S:    /usr/bboards/.system.map
              S:    *
              S:    mother
              S:    [email protected]
              S:    [email protected]
              S:
              S:    [email protected]
              S:    01 10
              S:    Thu, 19 Dec 85 00:08:49 -0800
              S:    .

Policy Notes

  Depending on the particular entity administrating the POP3 service
  host, two additional policies might be implemented:

  1.  Private Discussion Groups

  In the general case, discussion groups are world-readable, any user,
  once logged in (via a terminal, terminal server, or POP3, etc.), is
  able to read the maildrop for each discussion group known to the POP3
  service host.  Nevertheless, it is desirable, usually for privacy
  reasons, to implement private discussion groups as well.

  Support of this is consistent with the extensions outlined in this



Rose                                                            [Page 9]

RFC 1082                 POP3 Extended Service             November 1988


  memo.  Once the AUTHORIZATION state has successfully concluded, the
  POP3 server grants the user access to exactly those discussion groups
  the POP3 service host permits the authenticated user to access.  As a
  "security" feature, discussion groups associated with unreadable
  maildrops should not be listed in a positive response to the XTND
  BBOARDS command.

  2.  Anonymous POP3 Users

  In order to minimize the authentication problem, a policy permitting
  "anonymous" access to the world-readable maildrops for discussion
  groups on the POP3 server may be implemented.

  Support of this is consistent with the extensions outlined in this
  memo.  The POP3 server can be modified to accept a USER command for a
  well-known pseudonym (i.e., "anonymous") which is valid with any PASS
  command.  As a "security" feature, it is advisable to limit this kind
  of access to only hosts at the local site, or to hosts named in an
  access list.

Experiences and Conclusions

  All of the facilities described in this memo and in [RFC1081] have
  been implemented in MH #6.1.  Initial experiences have been, on the
  whole, very positive.

  After the first implementation, some performance tuning was required.
  This consisted primarily of caching the datastructures which describe
  discussion groups in the POP3 server.  A second optimization
  pertained to the client:  the program most commonly used to read
  BBoards in MH was modified to retrieve messages only when needed.
  Two schemes are used:

        o If only the headers (and the first few lines of the body) of
          the message are required (e.g., for a scan listing), then only
          these are retrieved.  The resulting output is then cached, on
          a per-message basis.

        o If the entire message is required, then it is retrieved intact,
           and cached locally.

  With these optimizations, response time is quite adequate when the
  POP3 server and client are connected via a high-speed local area
  network.  In fact, the author uses this mechanism to access certain
  private discussion groups over the Internet.  In this case, response
  is still good.  When a 9.6Kbps modem is inserted in the path,
  response went from good to almost tolerable (fortunately the author
  only reads a few discussion groups in this fashion).



Rose                                                           [Page 10]

RFC 1082                 POP3 Extended Service             November 1988


  To conclude: the POP3 is a good thing, not only for personal mail but
  for discussion group mail as well.


References

    [RFC1081] Rose, M., "Post Office Protocol - Verison 3 (POP3)", RFC
              1081, TWG, November 1988.

    [MRose85] Rose, M., and J. Romine, "The Rand MH Message Handling
              System: User's Manual", University of California, Irvine,
              November 1985.

    [RFC822]  Crocker, D., "Standard for the Format of ARPA-Internet
              Text Messages", RFC 822, University of Delaware, August
              1982.

    [RFC918]  Reynolds, J., "Post Office Protocol", RFC 918,
              USC/Information Sciences Institute, October 1984.

    [RFC937]  Butler, M., J. Postel, D. Chase, J. Goldberger, and J.
              Reynolds, "Post Office Protocol - Version 2", RFC 937,
              USC/Information Sciences Institute, February 1985.

Author's Address:


  Marshall Rose
  The Wollongong Group
  1129 San Antonio Rd.
  Palo Alto, California 94303

  Phone: (415) 962-7100

  Email: [email protected]
















Rose                                                           [Page 11]