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>
next in thread | raw e-mail | index | archive | help
>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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200205200353.g4K3r6f01755>