Date: Sun, 19 May 2002 23:53:06 -0400 (EDT) From: Chris Pepper <pepper@rockefeller.edu> To: FreeBSD-gnats-submit@FreeBSD.org Cc: pepper@rockefeller.edu Subject: docs/38318: Many typo, grammar, and minor tag patches. Message-ID: <200205200353.g4K3r6f01755@guest.reppep.com>
index | next in thread | raw e-mail
>Number: 38318
>Category: docs
>Synopsis: Many typo, grammar, and minor tag patches.
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Sun May 19 21:00:07 PDT 2002
>Closed-Date:
>Last-Modified:
>Originator: Chris Pepper
>Release: FreeBSD 4.5-RELEASE i386
>Organization:
>Environment:
System: FreeBSD guest.reppep.com 4.5-RELEASE FreeBSD 4.5-RELEASE #0: Mon Jan 28 14:31:56 GMT 2002 murray@builder.freebsdmall.com:/usr/src/sys/compile/GENERIC i386
>Description:
Add hostid tags, and tag 'sendmail'; lower-case 'Sendmail' once.
Clarify that *sendmail* must be restarted (current wording is ambiguous).
A lot of minor clean up.
Clarify section about MXes, including static vs. dynamic, including a bit more on MX priotitization.
>How-To-Repeat:
>Fix:
Apply supplied patch.
--- chapter.sgml.diff begins here ---
Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/mail/chapter.sgml,v
retrieving revision 1.49
diff -u -r1.49 chapter.sgml
--- chapter.sgml 2002/05/12 23:34:30 1.49
+++ chapter.sgml 2002/05/20 03:51:28
@@ -397,7 +397,7 @@
the local host name. Place any domains or hosts that
<application>sendmail</application> is to be receiving mail for.
For example, if this mail server was to accept mail for the
- domain example.com and the host
+ domain <hostid role="domainname">example.com</hostid> and the host
<hostid>mail.example.com</hostid>, its
<filename>local-host-names</filename> might look something like
this:</para>
@@ -406,7 +406,7 @@
mail.example.com</programlisting>
<para>When this file is updated, &man.sendmail.8; needs to be
- restarted for it to read the changes.</para>
+ restarted to read the changes.</para>
</sect2>
@@ -416,15 +416,15 @@
<para><application>sendmail</application>'s master configuration
file, <filename>sendmail.cf</filename> controls the overall
behavior of <application>sendmail</application>, including everything
- from rewriting e-mail addresses to printing reject messages for
+ from rewriting e-mail addresses to printing rejection messages to
remote mail servers. Naturally, with such a diverse role, this
configuration file is quite complex and its details are a bit
out of the scope of this section. Fortunately, this file rarely
needs to be changed for standard mail servers.</para>
<para>The master <application>sendmail</application> configuration
- file can be built from &man.m4.1; macros that define features
- and behavior of sendmail. Please see
+ file can be built from &man.m4.1; macros that define the features
+ and behavior of <application>sendmail</application>. Please see
<filename>/usr/src/contrib/sendmail/cf/README</filename> for
some of the details.</para>
@@ -436,11 +436,11 @@
<sect2>
<title><filename>/etc/mail/virtusertable</filename></title>
- <para>The <filename>virtualusertable</filename> maps mail for
+ <para>The <filename>virtualusertable</filename> maps mail addresses for
virtual domains and
mailboxes to real mailboxes. These mailboxes can be local,
- remote, an alias defined in
- <filename>/etc/mail/aliases</filename> or a file.</para>
+ remote, aliases defined in
+ <filename>/etc/mail/aliases</filename> or files.</para>
<example>
<title>Example Virtual Domain Mail Map</title>
@@ -570,8 +570,8 @@
<application>sendmail</application>-compatible system. If
applications continue to use
<application>sendmail</application>'s binaries to try and send
- e-mail after you have disabled it, the mail may transparently
- queue forever.</para>
+ e-mail after you have disabled it, the mail may silently
+ wait forever.</para>
</warning>
<para>If you only want to disable
@@ -600,11 +600,9 @@
<filename>/usr/local/etc/rc.d/</filename> that
ends in <filename>.sh</filename> and is executable by
<username>root</username>. The script should also accept the
- parameters 'start' and 'stop'. So that you could, for example, execute
+ parameters 'start' and 'stop'. The system will execute it with these arguments at start and shutdown time, e.g.,
<filename>/usr/local/etc/rc.d/supermailer.sh start</filename>
- or <filename>/usr/local/etc/rc.d/supermailer.sh stop</filename>.
- The system will call your script using 'start' when the it
- boots and using 'stop' when the it shuts down.</para>
+ or <filename>/usr/local/etc/rc.d/supermailer.sh stop</filename>; you can also do this manually to start and stop your new MTA.</para>
</sect3>
@@ -613,13 +611,13 @@
(including 4.6-RELEASE and later)</title>
<para>With later versions of FreeBSD, you can use the
- above method or you can also set</para>
+ above method or you can set</para>
<programlisting>mta_start_script="filename"</programlisting>
<para>in <filename>/etc/rc.conf</filename>, where
<replaceable>filename</replaceable> is the name of some
- script that you want executed on boot to start your
+ script that you want executed at boot to start your
MTA.</para>
</sect3>
@@ -630,11 +628,10 @@
the system's default mailer</title>
<para><application>Sendmail</application> is so ubiquitous
- as standard software on Unix systems, that some software
- just presumes that it is already installed and configured.
+ as standard software on Unix systems that some software
+ just assumes it is already installed and configured.
For this reason, many alternative MTA's provide utilities
- that implement exactly the same command-line interface
- that <application>sendmail</application> provides.</para>
+ that implement the <application>sendmail</application> command-line interface exactly.</para>
<para>Therefore, if you are using an alternative mailer,
you will need to make sure that software trying to execute
@@ -655,18 +652,13 @@
hoststat /usr/libexec/sendmail/sendmail
purgestat /usr/libexec/sendmail/sendmail</programlisting>
- <para>This means that when any of these common commands
- are run, such as <filename>/usr/bin/sendmail</filename>
- the program that is actually sitting in that location
- checks <filename>mailer.conf</filename> and
- executes <filename>/usr/libexec/sendmail/sendmail</filename>
- instead. This system makes it easy to change what binaries
+ <para>This means, for example, that when <filename>sendmail</filename> is invoked, <filename>/usr/bin/mailwrapper</filename> is actually executed; mailwrapper checks <filename>mailer.conf</filename>, and based on what it finds there, executes <filename>/usr/libexec/sendmail/sendmail</filename>. This system makes it easy to change what binaries
are actually executed when these default system utilities
are run.</para>
<para>Therefore if you wanted
<filename>/usr/local/supermailer/bin/sendmail-compat</filename>
- to be run instead of sendmail, you would change
+ to be run instead of <application>sendmail</application>, you would change
<filename>/etc/mail/mailer.conf</filename> to read:</para>
<programlisting>sendmail /usr/local/supermailer/bin/sendmail-compat
@@ -681,12 +673,12 @@
<sect2>
<title>Finishing</title>
- <para>Once you have everything configured how you want it, you should
+ <para>Once you have everything configured the way you want it, you should
either kill the <application>sendmail</application> processes that
you no longer need and start the processes belonging to your new
- software. Or you should reboot your machine. Rebooting will also
+ software, or simply reboot. Rebooting will also
give you the opportunity to ensure that you have correctly
- configured your machine to start your new MTA on boot.</para>
+ configured your system to start your new MTA automatically on boot.</para>
</sect2>
</sect1>
@@ -801,9 +793,9 @@
<para>Only one host should be specified as the final recipient
(add <literal>Cw bigco.com</literal> in
- <filename>/etc/mail/sendmail.cf</filename> on bigco.com).</para>
+ <filename>/etc/mail/sendmail.cf</filename> on <hostid role="domainname">bigco.com</hostid>).</para>
- <para>When the senders' <command>sendmail</command> is trying to
+ <para>When the sender's <command>sendmail</command> is trying to
deliver the mail it will try to connect to you over the modem
link. It will most likely time out because you are not online.
<command>sendmail</command> will automatically deliver it to the
@@ -869,7 +861,7 @@
<answer>
<para>In default FreeBSD installations,
- <application>Sendmail</application> is configured to only
+ <application>sendmail</application> is configured to only
send mail from the host it is running on. For example, if
a POP3 server is installed, then users will be able to
check mail from school, work, or other remote locations
@@ -881,22 +873,22 @@
message.</para>
<para>There are several ways to get around this. The most
- straight forward solution is to put your ISP's address in
+ straightforward solution is to put your ISP's address in
a relay-domains file at
<filename>/etc/mail/relay-domains</filename>. A quick way
to do this would be:</para>
<screen>&prompt.root; <userinput>echo "your.isp.example.com" > /etc/mail/relay-domains</userinput></screen>
- <para>After creating this file you must restart
+ <para>After creating or editing this file you must restart
<application>sendmail</application>. This works great if
you are a server admin and don't wish to send mail
locally, or would like to use a point and click
client/system on another machine or even another ISP. It
is also very useful if you only have one or two email
- accounts setup. If there are a large number of addresses
+ accounts set up. If there are a large number of addresses
to add, you can simply open this file in your favorite
- text editor and then add the domains one per line:</para>
+ text editor and then add the domains, one per line:</para>
<programlisting>your.isp.example.com
other.isp.example.net
@@ -904,8 +896,8 @@
www.example.org</programlisting>
<para>Now any mail sent through your system, by any host in
- this list, providing the user has an account on your
- system, will succeed. This is a very nice way to allow
+ this list (provided the user has an account on your
+ system), will succeed. This is a very nice way to allow
users to send mail from your system remotely without
allowing people to send SPAM through your system.</para>
@@ -931,7 +923,7 @@
hosts as long as you have set up
<filename>/etc/resolv.conf</filename> or are running your own
name server. If you would like to have mail for your host
- delivered to that specific host, there are two methods:</para>
+ delivered to the MTA (e.g., <application>sendmail</application>) on your own FreeBSD host, there are two methods:</para>
<itemizedlist>
<listitem>
@@ -950,16 +942,16 @@
<indexterm><primary>SMTP</primary></indexterm>
<para>Regardless of which of the above you choose, in order to have
- mail delivered directly to your host, you must have a permanent
- (static) IP address (no dynamic PPP dial-up). If you are behind a
+ mail delivered directly to your host, it must have a permanent
+ static IP address (not a dynamic address, as with most PPP dial-up configurations). If you are behind a
firewall, it must pass SMTP traffic on to you. If you want to
- receive mail at your host itself, you need to be sure of one of two
+ receive mail directly at your host, you need to be sure of either of two
things:</para>
<itemizedlist>
<indexterm><primary>MX record</primary></indexterm>
<listitem>
- <para>Make sure that the MX record in your DNS points to your
+ <para>Make sure that the (lowest-numbered) MX record in your DNS points to your
host's IP address.</para>
</listitem>
@@ -981,7 +973,7 @@
<para>If that is what you see, mail directly to
<email>yourlogin@example.FreeBSD.org</email> should work without
- problems.</para>
+ problems (assuming <application>sendmail</application> is running correctly on <hostid role="fqdn">example.FreeBSD.org</hostid>).</para>
<para>If instead you see something like this:</para>
@@ -1010,12 +1002,10 @@
freefall MX 20 who.cdrom.com</programlisting>
<para>As you can see, <hostid>freefall</hostid> had many MX entries.
- The lowest MX number is the host that ends up receiving the mail in
- the end while the others will queue mail temporarily if
- <hostid>freefall</hostid> is busy or down.</para>
+ The lowest MX number is the host that receives mail directly if available; if it's not accessible for some reason, the others (sometimes called <quote>backup MXes</quote>) accept messages temporarily, and pass it along when a lower-numbered host becomes available, eventually to the lowest-numbered host.</para>
<para>Alternate MX sites should have separate Internet connections
- from your own in order to be the most useful. Your ISP or other
+ from your own in order to be most useful. Your ISP or another
friendly site should have no problem providing this service for
you.</para>
</sect2>
@@ -1023,13 +1013,13 @@
<sect2 id="mail-domain">
<title>Mail for Your Domain</title>
- <para>In order to set up a <quote>mailhost</quote> (a.k.a., mail
+ <para>In order to set up a <quote>mailhost</quote> (a.k.a. mail
server) you need to have any mail sent to various workstations
- directed to it. Basically, you want to <quote>hijack</quote> any
- mail for your domain (in this case <hostid
+ directed to it. Basically, you want to <quote>claim</quote> any
+ mail for any hostname in your domain (in this case <hostid
role="fqdn">*.FreeBSD.org</hostid>) and divert it to your mail
- server so your users can check their mail via POP or directly on
- the server.</para>
+ server so your users can receive their mail on
+ the master mail server.</para>
<indexterm><primary>DNS</primary></indexterm>
<para>To make life easiest, a user account with the same
@@ -1037,7 +1027,7 @@
<command>adduser</command> to do this.</para>
<para>The mailhost you will be using must be the designated mail
- exchange for each workstation on the network. This is done in
+ exchanger for each workstation on the network. This is done in
your DNS configuration like so:</para>
<programlisting>example.FreeBSD.org A 204.216.27.XX ; Workstation
@@ -1048,25 +1038,25 @@
host.</para>
<para>You cannot do this yourself unless you are running a DNS
- server. If you are not, or cannot, run your own DNS server, talk
- to your ISP or whoever does your DNS for you.</para>
+ server. If you are not, or cannot run your own DNS server, talk
+ to your ISP or whoever provides your DNS.</para>
<para>If you are doing virtual email hosting, the following
- information will come in handy. For the sake of an example, we
+ information will come in handy. For the example, we
will assume you have a customer with their own domain, in this
- case <hostid role="domainname">customer1.org</hostid> and you want
+ case <hostid role="domainname">customer1.org</hostid>, and you want
all the mail for <hostid role="domainname">customer1.org</hostid>
- sent to your mailhost, which is named <hostid
+ sent to your mailhost, <hostid
role="fqdn">mail.myhost.com</hostid>. The entry in your DNS
should look like this:</para>
<programlisting>customer1.org MX 10 mail.myhost.com</programlisting>
- <para>You do <emphasis>not</emphasis> need an A record if you only
- want to handle email for the domain.</para>
+ <para>You do <emphasis>not</emphasis> need an A record for <hostid role="domainname">customer1.org</hostid> if you only
+ want to handle email for that domain.</para>
<note>
- <para>Be aware that this means pinging <hostid
+ <para>Be aware that pinging <hostid
role="domainname">customer1.org</hostid> will not work unless
an A record exists for it.</para>
</note>
@@ -1082,7 +1072,7 @@
<para>Add the hosts to your
<filename>/etc/mail/local-host-names</filename> file if you are using the
<literal>FEATURE(use_cw_file)</literal>. If you are using
- a version of sendmail earlier than 8.10, the file is
+ a version of <application>sendmail</application> earlier than 8.10, the file is
<filename>/etc/sendmail.cw</filename>.</para>
</listitem>
@@ -1090,7 +1080,7 @@
<para>Add a <literal>Cwyour.host.com</literal> line to your
<filename>/etc/mail/sendmail.cf</filename> or
<filename>/etc/mail/sendmail.cf</filename> if you are using
- sendmail 8.10 or higher.</para>
+ <application>sendmail</application> 8.10 or higher.</para>
</listitem>
</itemizedlist>
</sect2>
--- chapter.sgml.diff ends here ---
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200205200353.g4K3r6f01755>