Date: Fri, 12 Dec 2003 14:07:46 -0500 From: "Bill Moran" <wmoran@potentialtech.com> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/60186: [patch] Addition of new section to mail chapter of handbook Message-ID: <20031212190747.BKSB25110.mta10.adelphia.net@[68.68.113.33]> Resent-Message-ID: <200312121910.hBCJALx4097334@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 60186 >Category: docs >Synopsis: [patch] Addition of new section to mail chapter of handbook >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Fri Dec 12 11:10:20 PST 2003 >Closed-Date: >Last-Modified: >Originator: Bill Moran >Release: FreeBSD 5.1-RELEASE i386 >Organization: Potential Technologies >Environment: System: FreeBSD working.pt.com 5.1-RELEASE FreeBSD 5.1-RELEASE #0: Tue Sep 9 08:41:45 EDT 2003 wmoran@working.pt.com:/usr/obj/usr/src/sys/GENERIC i386 >Description: Mail section of the handbook does not offer information no how to set up FreeBSD for send-only configuration. >How-To-Repeat: Peruse handbook for information on how to configure for outgoing mail only. >Fix: Apply provided patch to mail/chapter.sgml (diff against 1.88) A rendered view of this is available: http://www.potentialtech.com/wmoran/handbook/outgoing-only.html This has been discussed on the doc mailing list: http://www.freebsd.org/cgi/getmsg.cgi?fetch=118774+121447+/usr/local/www/db/text/2003/freebsd-doc/20031207.freebsd-doc --- chapter.diff begins here --- --- chapter.orig.sgml Sun Nov 30 19:11:42 2003 +++ chapter.sgml Fri Dec 12 12:38:22 2003 @@ -1278,6 +1278,82 @@ <prompt>></prompt> <userinput>^D</userinput></screen> </sect1> + <sect1 id="outgoing-only"> + <sect1info> + <authorgroup> + <author> + <firstname>Bill</firstname> + <surname>Moran</surname> + <contrib>Contributed by </contrib> + </author> + </authorgroup> + </sect1info> + <title>Setting up to send only</title> + + <para>There are many instances where you may only want to send + mail through a relay. Some examples are:</para> + + <itemizedlist> + <listitem> + <para>Your computer is a desktop machine, but you'll want to use FreeBSD + programs such as &man.send-pr.1;. To do so, you should use your ISP's + mail relay.</para> + </listitem> + + <listitem> + <para>The computer is a server that does not handle mail locally, but needs + to pass off all mail to a relay for processing.</para> + </listitem> + </itemizedlist> + + <para>Just about any MTA is capable of filling this particular niche. + Unfortunately, it can be very difficult to properly configure a full- + featured MTA to properly handle just offloading mail. Programs such + as <application>sendmail</application> and + <application>postfix</application> are largely overkill for this use. + </para> + + <para>Additionally, if you're using a typical Internet access service, your + agreement may forbid you from running a "mail server".</para> + + <para>The easiest way to fulfill these needs is to install the + <filename role="package">mail/ssmtp</filename> port. Execute the + following commands as root:</para> + + <screen>&prompt.root; <userinput>cd /usr/ports/mail/ssmtp +&prompt.root; make install && make replace && make clean</userinput></screen> + + <para>Once installed, <filename role="package">mail/ssmtp</filename> can + be configured with a four-line file in + <filename>/usr/local/etc/ssmtp/ssmtp.conf</filename></para> + + <programlisting> +root=yourrealeamil@yourisp.com +mailhub=mail.yourisp.com +rewriteDomain=yourisp.com +hostname=_HOSTNAME_</programlisting> + + <para>Make sure you use your real email address for + <literal>root=</literal>. Enter your ISP's outgoing mail relay in place + of <literal>mail.yourisp.com</literal> (some ISPs call this the + "outgoing mail server" or "smtp server").</para> + + <para>Make sure you disable <application>sendmail</application> by entering + <programlisting>sendmail_enable="NONE"</programlisting> in + <filename>/etc/rc.conf</filename>.</para> + + <para><filename role="package">mail/ssmtp</filename> has some other + options available. See the example config file in + <filename>/usr/local/etc/ssmtp</filename> or the manual page for + <application>ssmtp</application>.</para> + + <para>Setting up <application>ssmtp</application> in this manner will allow any + software on your computer that needs to send mail to function properly, + while not violating your ISP's usage policy or allowing your computer to + be hijacked for spamming.</para> + + </sect1> + <sect1 id="SMTP-dialup"> <title>Using Mail with a Dialup Connection</title> --- chapter.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20031212190747.BKSB25110.mta10.adelphia.net>