From owner-freebsd-doc@FreeBSD.ORG Fri Dec 12 11:10:51 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 82F5D16A4CE for ; Fri, 12 Dec 2003 11:10:51 -0800 (PST) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 44CA243D45 for ; Fri, 12 Dec 2003 11:10:21 -0800 (PST) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) hBCJALFR097335 for ; Fri, 12 Dec 2003 11:10:21 -0800 (PST) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.10/8.12.10/Submit) id hBCJALx4097334; Fri, 12 Dec 2003 11:10:21 -0800 (PST) (envelope-from gnats) Resent-Date: Fri, 12 Dec 2003 11:10:21 -0800 (PST) Resent-Message-Id: <200312121910.hBCJALx4097334@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Bill Moran Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7226516A4CE for ; Fri, 12 Dec 2003 11:07:49 -0800 (PST) Received: from mta10.adelphia.net (mta10.adelphia.net [68.168.78.202]) by mx1.FreeBSD.org (Postfix) with ESMTP id A3D7143D31 for ; Fri, 12 Dec 2003 11:07:47 -0800 (PST) (envelope-from wmoran@potentialtech.com) Received: from [68.68.113.33] by mta10.adelphia.net (InterMail vM.5.01.06.05 201-253-122-130-105-20030824) with SMTP id <20031212190747.BKSB25110.mta10.adelphia.net@[68.68.113.33]> for ; Fri, 12 Dec 2003 14:07:47 -0500 Received: by _HOSTNAME_ (sSMTP sendmail emulation); Fri, 12 Dec 2003 14:07:46 -0500 Message-Id: <20031212190747.BKSB25110.mta10.adelphia.net@[68.68.113.33]> Date: Fri, 12 Dec 2003 14:07:46 -0500 From: "Bill Moran" To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/60186: [patch] Addition of new section to mail chapter of handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Bill Moran List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 12 Dec 2003 19:10:51 -0000 >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 @@ > ^D + + + + + Bill + Moran + Contributed by + + + + Setting up to send only + + There are many instances where you may only want to send + mail through a relay. Some examples are: + + + + 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. + + + + The computer is a server that does not handle mail locally, but needs + to pass off all mail to a relay for processing. + + + + 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 sendmail and + postfix are largely overkill for this use. + + + Additionally, if you're using a typical Internet access service, your + agreement may forbid you from running a "mail server". + + The easiest way to fulfill these needs is to install the + mail/ssmtp port. Execute the + following commands as root: + + &prompt.root; cd /usr/ports/mail/ssmtp +&prompt.root; make install && make replace && make clean + + Once installed, mail/ssmtp can + be configured with a four-line file in + /usr/local/etc/ssmtp/ssmtp.conf + + +root=yourrealeamil@yourisp.com +mailhub=mail.yourisp.com +rewriteDomain=yourisp.com +hostname=_HOSTNAME_ + + Make sure you use your real email address for + root=. Enter your ISP's outgoing mail relay in place + of mail.yourisp.com (some ISPs call this the + "outgoing mail server" or "smtp server"). + + Make sure you disable sendmail by entering + sendmail_enable="NONE" in + /etc/rc.conf. + + mail/ssmtp has some other + options available. See the example config file in + /usr/local/etc/ssmtp or the manual page for + ssmtp. + + Setting up ssmtp 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. + + + Using Mail with a Dialup Connection --- chapter.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: