BSD 4_4 release

[unix-history] / usr / src / share / man / man7 / mailaddr.7

diff --git a/usr/src/share/man/man7/mailaddr.7 b/usr/src/share/man/man7/mailaddr.7
index 26fdb60..96a98f9 100644 (file)
--- a/usr/src/share/man/man7/mailaddr.7
+++ b/usr/src/share/man/man7/mailaddr.7
@@ -1,95 +1,95 @@
-.\" Copyright (c) 1983, 1987, 1990 The Regents of the University of California.
-.\" All rights reserved.
+.\" Copyright (c) 1983, 1987, 1990, 1993
+.\"    The Regents of the University of California.  All rights reserved.

 .\"
 .\"

-.\" Redistribution and use in source and binary forms are permitted provided
-.\" that: (1) source distributions retain this entire copyright notice and
-.\" comment, and (2) distributions including binaries display the following
-.\" acknowledgement:  ``This product includes software developed by the
-.\" University of California, Berkeley and its contributors'' in the
-.\" documentation or other materials provided with the distribution and in
-.\" all advertising materials mentioning features or use of this software.
-.\" Neither the name of the University nor the names of its contributors may
-.\" be used to endorse or promote products derived from this software without
-.\" specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
-.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
-.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.\"     @(#)mailaddr.7 6.6 (Berkeley) 6/24/90
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.

 .\"
 .\"

-.Dd June 24, 1990
+.\"     @(#)mailaddr.7 8.1 (Berkeley) 6/16/93
+.\"
+.Dd June 16, 1993

 .Dt MAILADDR 7
 .Os BSD 4.2
 .Sh NAME
 .Nm mailaddr
 .Nd mail addressing description
 .Sh DESCRIPTION
 .Dt MAILADDR 7
 .Os BSD 4.2
 .Sh NAME
 .Nm mailaddr
 .Nd mail addressing description
 .Sh DESCRIPTION

-Mail addresses are based on the ARPANET protocol listed at the end of this
+Mail addresses are based on the Internet protocol listed at the end of this

 manual page.  These addresses are in the general format
 .Pp
 .Dl user@domain
 .Pp
 where a domain is a hierarchical dot separated list of subdomains.  For
 manual page.  These addresses are in the general format
 .Pp
 .Dl user@domain
 .Pp
 where a domain is a hierarchical dot separated list of subdomains.  For

-example, the address
-.Pp
-.Dl eric@monet.berkeley.edu
+example, a valid address is:

 .Pp
 .Pp

-is normally interpreted from right to left: the message should go to the
-ARPA name tables (which do not correspond exactly to the physical ARPANET),
-then to the Berkeley gateway, after which it should go to the local host
-monet.  When the message reaches monet it is delivered to the user ``eric''.
+.Dl eric@CS.Berkeley.EDU

 .Pp
 .Pp

-Unlike some other forms of addressing, this does not imply any routing.
-Thus, although this address is specified as an ARPA address, it might
+Unlike some other forms of addressing, domains do not imply any routing.
+Thus, although this address is specified as an Internet address, it might

 travel by an alternate route if that were more convenient or efficient.
 For example, at Berkeley, the associated message would probably go directly
 travel by an alternate route if that were more convenient or efficient.
 For example, at Berkeley, the associated message would probably go directly

-to monet over the Ethernet rather than going via the Berkeley ARPANET
+to CS over the Ethernet rather than going via the Berkeley Internet

 gateway.
 .Ss Abbreviation.
 Under certain circumstances it may not be necessary to type the entire
 domain name.  In general, anything following the first dot may be omitted
 if it is the same as the domain from which you are sending the message.
 gateway.
 .Ss Abbreviation.
 Under certain circumstances it may not be necessary to type the entire
 domain name.  In general, anything following the first dot may be omitted
 if it is the same as the domain from which you are sending the message.

-For example, a user on ``calder.berkeley.edu'' could send to ``eric@monet''
+For example, a user on ``calder.berkeley.edu'' could send to ``eric@CS''

 without adding the ``berkeley.edu'' since it is the same on both sending
 and receiving hosts.
 without adding the ``berkeley.edu'' since it is the same on both sending
 and receiving hosts.

-.Pp
-Certain other abbreviations may be permitted as special cases.  For
-example, at Berkeley, ARPANET hosts may be referenced without adding
-the ``berkeley.edu'' as long as their names do not conflict with a local
-host name.

 .Ss Compatibility.
 .Pp
 Certain old address formats are converted to the new format to provide
 compatibility with the previous mail system.  In particular,
 .Pp
 .Ss Compatibility.
 .Pp
 Certain old address formats are converted to the new format to provide
 compatibility with the previous mail system.  In particular,
 .Pp

-.Dl user@host.ARPA
+.Dl user@host

 .Pp
 .Pp

-is allowed and
+and
+.Dl user@host.domain

 .Pp
 .Pp

-.Dl host:user
+are allowed;

 .Pp
 .Pp

-is converted to
+.Dl host.domain!user

 .Pp
 .Pp

-.Dl user@host
+is converted to

 .Pp
 .Pp

-to be consistent with the
-.Xr rcp 1
-command.
+.Dl user@host.domain

 .Pp
 .Pp

-Also, the syntax
+and

 .Pp
 .Dl host!user
 .Pp
 .Pp
 .Dl host!user
 .Pp

-is converted to:
+is converted to

 .Pp
 .Dl user@host.UUCP
 .Pp
 This is normally converted back to the ``host!user'' form before being sent
 on for compatibility with older UUCP hosts.
 .Pp
 .Pp
 .Dl user@host.UUCP
 .Pp
 This is normally converted back to the ``host!user'' form before being sent
 on for compatibility with older UUCP hosts.
 .Pp

-The current implementation is not able to route messages automatically through
-the UUCP network.  Until that time you must explicitly tell the mail system
-which hosts to send your message through to get to your final destination.

 .Ss Case Distinctions.
 .Pp
 Domain names (i.e., anything after the ``@'' sign) may be given in any mixture
 .Ss Case Distinctions.
 .Pp
 Domain names (i.e., anything after the ``@'' sign) may be given in any mixture


@@ -112,8 +112,17 @@ path to hostc.
 .Pp
 Route-addrs occur frequently on return addresses, since these are generally
 augmented by the software at each host.  It is generally possible to ignore
 .Pp
 Route-addrs occur frequently on return addresses, since these are generally
 augmented by the software at each host.  It is generally possible to ignore

-all but the ``user@domain'' part of the address to determine the actual
+all but the ``user@hostc'' part of the address to determine the actual

 sender.
 sender.

+.Pp
+[Note: the route-addr syntax is officially deprecated
+in RFC 1123 and should not be used.]
+.Pp
+Many sites also support the ``percent hack'' for simplistic routing:
+.Pp
+.Dl user%hostc%hostb@hosta
+.Pp
+is routed as indicated in the previous example.

 .Ss Postmaster.
 .Pp
 Every site is required to have a user or user alias designated ``postmaster''
 .Ss Postmaster.
 .Pp
 Every site is required to have a user or user alias designated ``postmaster''


@@ -143,4 +152,4 @@ berknet-style addresses.
 .Pp
 Route-Address syntax is grotty.
 .Pp
 .Pp
 Route-Address syntax is grotty.
 .Pp

-UUCP- and ARPANET-style addresses do not coexist politely.
+UUCP- and Internet-style addresses do not coexist politely.