Updates to delete "DRAFT" etc. and make more accurate for 4.2
authorEric Allman <eric@ucbvax.Berkeley.EDU>
Fri, 29 Jul 1983 01:56:29 +0000 (17:56 -0800)
committerEric Allman <eric@ucbvax.Berkeley.EDU>
Fri, 29 Jul 1983 01:56:29 +0000 (17:56 -0800)
SCCS-vsn: usr.sbin/sendmail/doc/op/op.me 4.2
SCCS-vsn: usr.sbin/sendmail/doc/syslog.8 4.2
SCCS-vsn: usr.sbin/sendmail/doc/mailaddr.7 4.1

usr/src/usr.sbin/sendmail/doc/mailaddr.7
usr/src/usr.sbin/sendmail/doc/op/op.me
usr/src/usr.sbin/sendmail/doc/syslog.8

index c873395..513eb0a 100644 (file)
@@ -1,10 +1,10 @@
-.\"    @(#)mailaddr.7  3.1             %G%
+.\"    @(#)mailaddr.7  4.1             %G%
 .TH MAILADDR 7
 .UC 4
 .SH NAME
 mailaddr \- mail addressing description
 .SH DESCRIPTION
 .TH MAILADDR 7
 .UC 4
 .SH NAME
 mailaddr \- mail addressing description
 .SH DESCRIPTION
-Mail addresses are based on the ARPANET protocols
+Mail addresses are based on the ARPANET protocol
 listed at the end of this manual page.
 These addresses are in the general format
 .PP
 listed at the end of this manual page.
 These addresses are in the general format
 .PP
@@ -89,7 +89,6 @@ 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.
 .PP
 The current implementation is not able to route messages
 automatically through the UUCP network.
-This feature is planned for the 4.2 release.
 Until that time you must explicitly tell the mail system
 which hosts to send your message through
 to get to your final destination.
 Until that time you must explicitly tell the mail system
 which hosts to send your message through
 to get to your final destination.
@@ -214,24 +213,21 @@ your address would be:
 .PP
 From UUCP, your address would be:
 .PP
 .PP
 From UUCP, your address would be:
 .PP
-               ucbvax!monet.yourname
+               ucbvax!yourname%monet
 .PP
 .I Computer Center.
 The Berkeley Computer Center
 .PP
 .I Computer Center.
 The Berkeley Computer Center
-is in a subdomain of Berkeley
-so that they may administer
-their own name space.
+is in a subdomain of Berkeley.
 Messages to the computer center
 Messages to the computer center
-should be addressed to one of:
+should be addressed to:
 .PP
 .PP
-               user@host.CC.Berkeley.ARPA
-.br
                user%host.CC@Berkeley.ARPA
 .PP
                user%host.CC@Berkeley.ARPA
 .PP
-depending on where the message is being sent from.
-The
-``.Berkeley.ARPA''
-may be omitted if the message is sent from inside Berkeley.
+The alternate syntax:
+.PP
+               user@host.CC
+.PP
+may be used if the message is sent from inside Berkeley.
 .PP
 For the time being
 Computer Center hosts
 .PP
 For the time being
 Computer Center hosts
@@ -250,4 +246,9 @@ Hosts on bitnet may be accessed using:
 .PP
                user@host.BITNET
 .PP
 .PP
                user@host.BITNET
 .PP
-This works from 4.2 machines.
+.SH SEE ALSO
+mail(1), sendmail(8);
+Crocker, D. H.,
+.ul
+Standard for the Format of Arpa Internet Text Messages,
+RFC822.
index 5ed218b..200de43 100644 (file)
@@ -1,6 +1,6 @@
 .if n .ls 2
 .he 'Sendmail Installation and Operation Guide''%'
 .if n .ls 2
 .he 'Sendmail Installation and Operation Guide''%'
-.fo 'Version 4.1'DRAFT'Last Mod %G%'
+.fo 'Version 4.2''Last Mod %G%'
 .nr si 3n
 .de $0
 .(x
 .nr si 3n
 .de $0
 .(x
 Eric Allman
 Britton-Lee, Inc.
 .sp
 Eric Allman
 Britton-Lee, Inc.
 .sp
-Version 4.1
-.)l
-.sp
-.(l F
-.b NOTE:
-.i
-This is a working paper, not a specification.
-Details of operation of
-.r sendmail
-may change as necessary
-before final release.
+Version 4.2
 .)l
 .sp 2
 .pp
 .)l
 .sp 2
 .pp
@@ -168,36 +158,12 @@ These are
 in
 .i m4
 format.
 in
 .i m4
 format.
-There are two parameters you will have to adjust
-in each of these files.
-The line beginning
-.q DH
-defines the canonical name of your host.
-The line beginning
-.q CH
-defines the names that your host might be known by;
-it should include the name listed in the
-.q DH
-line
-and any aliases that your host goes by.
-For example, a configuration might include the lines:
-.(b
-DHucsfcgl
-CHucsfcgl cgl
-.)b
-This would indicate that the
-.q standard
-name for the host is
-.q ucsfcgl
-and that it is known by the names
-.q ucsfcgl
-and
-.q cgl.
-.pp
-The changed file should be renamed;
-in the above example,
-the file might be renamed
-.i ucsfcgl.cf.
+The file you need should be copied to a file with the same name
+as your system,
+e.g.,
+.(b
+cp uucpproto.cf ucsfcgl.cf
+.)b
 This file
 is now ready for installation as
 .i /usr/lib/sendmail.cf .
 This file
 is now ready for installation as
 .i /usr/lib/sendmail.cf .
@@ -226,6 +192,12 @@ you can use the declaration
 on the
 .i make \|(1)
 command line.
 on the
 .i make \|(1)
 command line.
+You should also examine the file
+.i md/config.m4
+and change the
+.i m4
+macros there to reflect any libraries and compilation flags
+you may need.
 .pp
 The basic installation procedure is to type:
 .(b
 .pp
 The basic installation procedure is to type:
 .(b
@@ -384,8 +356,8 @@ as appropriate)
 in the area where it is starting up the daemons:
 .(b
 if [ \-f /usr/lib/sendmail ]; then
 in the area where it is starting up the daemons:
 .(b
 if [ \-f /usr/lib/sendmail ]; then
-       (cd /usr/spool/mqueue; rm \-f lf*)
-       /usr/lib/sendmail \-bd \-q10m &
+       (cd /usr/spool/mqueue; rm \-f [lnx]f*)
+       /usr/lib/sendmail \-bd \-q30m &
        echo \-n ' sendmail' >/dev/console
 fi
 .)b
        echo \-n ' sendmail' >/dev/console
 fi
 .)b
@@ -402,8 +374,8 @@ has two flags:
 .q \-bd
 causes it to listen on the SMTP port,
 and
 .q \-bd
 causes it to listen on the SMTP port,
 and
-.q \-q10m
-causes it to run the queue every ten minutes.
+.q \-q30m
+causes it to run the queue every half hour.
 .pp
 If you are not running a version of UNIX
 that supports Berkeley TCP/IP,
 .pp
 If you are not running a version of UNIX
 that supports Berkeley TCP/IP,
@@ -659,7 +631,7 @@ This is used to compute when to time out the job.
 The current message priority.
 This is used to order the queue.
 Higher numbers mean lower priorities.
 The current message priority.
 This is used to order the queue.
 Higher numbers mean lower priorities.
-The priority drops
+The priority increases
 as the message sits in the queue.
 The initial priority depends on the message class
 and the size of the message.
 as the message sits in the queue.
 The initial priority depends on the message class
 and the size of the message.
@@ -948,22 +920,22 @@ Others have interpretations built into
 .i sendmail
 that cannot be changed without changing the code.
 These builtins are described here.
 .i sendmail
 that cannot be changed without changing the code.
 These builtins are described here.
-.sh 3 "Return-receipt-to"
+.sh 3 "Return-Receipt-To:"
 .pp
 If this header is sent,
 a message will be sent to any specified addresses
 when the final delivery is complete.
 .pp
 If this header is sent,
 a message will be sent to any specified addresses
 when the final delivery is complete.
-This is determined by the
+if the mailer has the
 .b l
 .b l
-flag in the mailer descriptor.
-.sh 3 "Errors-to"
+flag (local delivery) set in the mailer descriptor.
+.sh 3 "Errors-To:"
 .pp
 If errors occur anywhere during processing,
 this header will cause error messages to go to
 the listed addresses
 rather than to the sender.
 This is intended for mailing lists.
 .pp
 If errors occur anywhere during processing,
 this header will cause error messages to go to
 the listed addresses
 rather than to the sender.
 This is intended for mailing lists.
-.sh 3 "Apparently-To:
+.sh 3 "Apparently-To:"
 .pp
 If a message comes in with no recipients listed in the message
 (in a To:, Cc:, or Bcc: line)
 .pp
 If a message comes in with no recipients listed in the message
 (in a To:, Cc:, or Bcc: line)
@@ -1017,7 +989,7 @@ flag and the
 .b \-q
 flag may be combined in one call:
 .(b
 .b \-q
 flag may be combined in one call:
 .(b
-/usr/lib/sendmail \-bd \-q10m
+/usr/lib/sendmail \-bd \-q30m
 .)b
 .sh 2 "Forcing the Queue"
 .pp
 .)b
 .sh 2 "Forcing the Queue"
 .pp
@@ -1026,7 +998,7 @@ You can force a queue run
 using the
 .b \-q
 flag (with no value).
 using the
 .b \-q
 flag (with no value).
-It is frequently entertaining to use the
+It is entertaining to use the
 .b \-v
 flag (verbose)
 when this is done to watch what happens:
 .b \-v
 flag (verbose)
 when this is done to watch what happens:
@@ -3155,21 +3127,30 @@ There are some configuration changes that can be made by
 recompiling
 .i sendmail .
 These are located in three places:
 recompiling
 .i sendmail .
 These are located in three places:
-.ip Makefile
-Changes in the makefile are operating-system dependent.
-These include information about what version of UNIX
-you are running, etc.
-.ip conf.h
+.ip md/config.m4
+These contain operating-system dependent descriptions.
+They are interpolated into the Makefiles in the
+.i src
+and
+.i aux
+directories.
+This includes information about what version of UNIX
+you are running,
+what libraries you have to include, etc.
+.ip src/conf.h
 Configuration parameters that may be tweaked by the installer
 are included in conf.h.
 Configuration parameters that may be tweaked by the installer
 are included in conf.h.
-.ip conf.c
+.ip src/conf.c
 Some special routines and a few variables
 may be defined in conf.c.
 For the most part these are selected from the settings
 in conf.h.
 Some special routines and a few variables
 may be defined in conf.c.
 For the most part these are selected from the settings
 in conf.h.
-.uh "Changes to the Makefile"
+.uh "Parameters in md/config.m4"
 .pp
 .pp
-The following compilation flags may be defined in the makefile
+The following compilation flags may be defined in the
+.i m4CONFIG
+macro in
+.i md/config.m4
 to define the environment in which you are operating.
 .ip V6
 If set,
 to define the environment in which you are operating.
 .ip V6
 If set,
@@ -3189,7 +3170,16 @@ etc.
 .lp
 If none of these flags are set,
 a version 7 system is assumed.
 .lp
 If none of these flags are set,
 a version 7 system is assumed.
-.uh "Parameters in conf.h"
+.pp
+You will also have to specify what libraries to link with
+.i sendmail
+in the
+.i m4LIBS
+macro.
+Most notably, you will have to include
+.B \-ljobs
+if you are running a 4.1BSD system.
+.uh "Parameters in src/conf.h"
 .pp
 Parameters and compilation options
 are defined in conf.h.
 .pp
 Parameters and compilation options
 are defined in conf.h.
@@ -3322,7 +3312,7 @@ you can set this flag to turn off special processing
 of UNIX-style
 .q "From "
 lines.
 of UNIX-style
 .q "From "
 lines.
-.uh "Configuration in conf.c"
+.uh "Configuration in src/conf.c"
 .pp
 Not all header semantics are defined in the configuration file.
 Header lines that should only be included by certain mailers
 .pp
 Not all header semantics are defined in the configuration file.
 Header lines that should only be included by certain mailers
@@ -3652,10 +3642,7 @@ INSTALLATION AND OPERATION GUIDE
 Eric Allman
 Britton-Lee, Inc.
 .sp
 Eric Allman
 Britton-Lee, Inc.
 .sp
-Version 4.1
-.sp 2
-.sz 14
-DRAFT
+Version 4.2
 .ce 0
 .bp 1
 .ce
 .ce 0
 .bp 1
 .ce
index dab6fd2..9741b74 100644 (file)
@@ -1,5 +1,5 @@
 .TH SYSLOG 8
 .TH SYSLOG 8
-.\"    @(#)syslog.8    4.1             %G%
+.\"    @(#)syslog.8    4.2             %G%
 .SH NAME
 syslog \- log systems messages
 .SH SYNOPSIS
 .SH NAME
 syslog \- log systems messages
 .SH SYNOPSIS
@@ -24,7 +24,9 @@ Each message is one line.
 A message can contain a priority code,
 marked by a digit in angle braces
 at the beginning of the line.
 A message can contain a priority code,
 marked by a digit in angle braces
 at the beginning of the line.
-Priorities are defined in <syslog.h>, as follows:
+Priorities are defined in
+.RI < syslog.h >,
+as follows:
 .IP LOG_ALERT \w'LOG_WARNING'u+2n
 this priority should essentially never
 be used.  It applies only to messages that
 .IP LOG_ALERT \w'LOG_WARNING'u+2n
 this priority should essentially never
 be used.  It applies only to messages that
@@ -48,7 +50,7 @@ disk failures, etc.
 .IP LOG_CRIT
 such messages contain critical information,
 but which can not be classed as errors, for example,
 .IP LOG_CRIT
 such messages contain critical information,
 but which can not be classed as errors, for example,
-'su' attempts.
+`su' attempts.
 Messages of this priority and higher
 are typically logged on the system console.
 .IP LOG_WARNING
 Messages of this priority and higher
 are typically logged on the system console.
 .IP LOG_WARNING
@@ -56,7 +58,7 @@ issued when an abnormal condition has been
 detected, but recovery can take place.
 .IP LOG_NOTICE
 something that falls in the class of
 detected, but recovery can take place.
 .IP LOG_NOTICE
 something that falls in the class of
-"important information"; this class is informational
+``important information''; this class is informational
 but important enough that you don't want to throw
 it away casually.
 Messages without any priority assigned to them
 but important enough that you don't want to throw
 it away casually.
 Messages without any priority assigned to them
@@ -92,7 +94,7 @@ informed on SALERT level messages.
 For example, the configuration file:
 .nf
 
 For example, the configuration file:
 .nf
 
-       5*/dev/tty8
+       5*/dev/console
        8/usr/spool/adm/syslog
        3/usr/adm/critical
 
        8/usr/spool/adm/syslog
        3/usr/adm/critical
 
@@ -112,13 +114,16 @@ The users ``eric'', ``kridle'', and ``kalash''
 will be informed on any subalert messages.
 .PP
 The flags are:
 will be informed on any subalert messages.
 .PP
 The flags are:
-.IP \-m 0.5i
+.TP 0.5i
+.B \-m
 Set the mark interval to
 .I N
 (default 20 minutes).
 Set the mark interval to
 .I N
 (default 20 minutes).
-.IP \-f
+.TP
+.B \-f
 Specify an alternate configuration file.
 Specify an alternate configuration file.
-.IP \-d
+.TP
+.B \-d
 Turn on debugging (if compiled in).
 .PP
 To bring
 Turn on debugging (if compiled in).
 .PP
 To bring
@@ -147,20 +152,20 @@ containing a single line
 with its process id.
 This can be used to kill or reconfigure
 .I syslog.
 with its process id.
 This can be used to kill or reconfigure
 .I syslog.
-.PP
-.I Syslog
-can also be compiled to use
-.IR mpx (2)
-files instead of datagrams
-if you are running V7.
-In this case it creates and reads the file
-/dev/log.
+.\".PP
+.\".I Syslog
+.\"can also be compiled to use
+.\".IR mpx (2)
+.\"files instead of datagrams
+.\"if you are running V7.
+.\"In this case it creates and reads the file
+.\"/dev/log.
 .SH FILES
 /etc/syslog.conf \- the configuration file
 .br
 /etc/syslog.pid \- the process id
 .SH FILES
 /etc/syslog.conf \- the configuration file
 .br
 /etc/syslog.pid \- the process id
-.br
-/dev/log \- under V7, the mpx file
+.\".br
+.\"/dev/log \- under V7, the mpx file
 .SH BUGS
 LOG_ALERT and LOG_SUBALERT messages
 should only be allowed to privileged programs.
 .SH BUGS
 LOG_ALERT and LOG_SUBALERT messages
 should only be allowed to privileged programs.