From owner-freebsd-doc Sun Nov 24 01:17:25 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.5/8.7.3) id BAA05312 for doc-outgoing; Sun, 24 Nov 1996 01:17:25 -0800 (PST) Received: from time.cdrom.com (time.cdrom.com [204.216.27.226]) by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id BAA05307; Sun, 24 Nov 1996 01:17:16 -0800 (PST) Received: from time.cdrom.com (localhost [127.0.0.1]) by time.cdrom.com (8.8.2/8.6.9) with ESMTP id BAA01178; Sun, 24 Nov 1996 01:17:26 -0800 (PST) To: doc@freebsd.org cc: roberto@freebsd.org Subject: FAQ... Date: Sun, 24 Nov 1996 01:17:25 -0800 Message-ID: <1175.848827045@time.cdrom.com> From: "Jordan K. Hubbard" Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk Is this dead now? Is anyone maintaining it? I notice that it still lists 2.1.5 as the latest release, among many many other out-of-date sections. If no one is updating it anymore, I'd like to move it into the attic. Jordan From owner-freebsd-doc Sun Nov 24 10:01:44 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.5/8.7.3) id KAA01912 for doc-outgoing; Sun, 24 Nov 1996 10:01:44 -0800 (PST) Received: from who.cdrom.com (who.cdrom.com [204.216.27.3]) by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id KAA01865 for ; Sun, 24 Nov 1996 10:01:38 -0800 (PST) Received: from mexico.brainstorm.eu.org (root@mexico.brainstorm.fr [193.56.58.253]) by who.cdrom.com (8.7.5/8.6.11) with ESMTP id GAA08146 for ; Sun, 24 Nov 1996 06:34:03 -0800 (PST) Received: from brasil.brainstorm.eu.org (brasil.brainstorm.fr [193.56.58.33]) by mexico.brainstorm.eu.org (8.7.5/8.7.3) with ESMTP id PAA19336 for ; Sun, 24 Nov 1996 15:20:49 +0100 Received: (from uucp@localhost) by brasil.brainstorm.eu.org (8.6.12/8.6.12) with UUCP id PAA14459 for doc@freebsd.org; Sun, 24 Nov 1996 15:20:24 +0100 Received: (from roberto@localhost) by keltia.freenix.fr (8.8.2/keltia-uucp-2.9) id OAA28511; Sun, 24 Nov 1996 14:24:08 +0100 (MET) Message-ID: Date: Sun, 24 Nov 1996 14:24:07 +0100 From: roberto@keltia.freenix.fr (Ollivier Robert) To: doc@freebsd.org Subject: Re: FAQ... References: <1175.848827045@time.cdrom.com> X-Mailer: Mutt 0.51 Mime-Version: 1.0 X-Operating-System: FreeBSD 3.0-CURRENT ctm#2686 In-Reply-To: <1175.848827045@time.cdrom.com>; from Jordan K. Hubbard on Nov 24, 1996 01:17:25 -0800 Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk According to Jordan K. Hubbard: > Is this dead now? Is anyone maintaining it? I notice that it still > lists 2.1.5 as the latest release, among many many other out-of-date > sections. I'm sorry I don't have time to update it but there was some talk to move some of it into the handbook (or deleting what was already in the handbook). Like John said, the FAQ should be for short answers and the handbook for more detailed ones. > If no one is updating it anymore, I'd like to move it into the attic. It would be nice if someone could take it in a smaller version and post it. Gary talked to me about posting it but I don't how it is going. James Raynard took over the FAQ a while ago (see at the end) but no news either. -- Ollivier ROBERT -=- The daemon is FREE! -=- roberto@keltia.freenix.fr FreeBSD keltia.freenix.fr 3.0-CURRENT #28: Sun Nov 10 13:37:41 MET 1996 From owner-freebsd-doc Sun Nov 24 10:11:04 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.5/8.7.3) id KAA03143 for doc-outgoing; Sun, 24 Nov 1996 10:11:04 -0800 (PST) Received: from time.cdrom.com (time.cdrom.com [204.216.27.226]) by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id KAA03101 for ; Sun, 24 Nov 1996 10:10:33 -0800 (PST) Received: from time.cdrom.com (localhost [127.0.0.1]) by time.cdrom.com (8.8.2/8.6.9) with ESMTP id KAA02585; Sun, 24 Nov 1996 10:10:31 -0800 (PST) To: roberto@keltia.freenix.fr (Ollivier Robert) cc: doc@freebsd.org Subject: Re: FAQ... In-reply-to: Your message of "Sun, 24 Nov 1996 14:24:07 +0100." Date: Sun, 24 Nov 1996 10:10:30 -0800 Message-ID: <2583.848859030@time.cdrom.com> From: "Jordan K. Hubbard" Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk > It would be nice if someone could take it in a smaller version and post > it. Gary talked to me about posting it but I don't how it is going. > > James Raynard took over the FAQ a while ago (see at the end) but no news > either. OK, well, if nobody claims it in the next 24 hours then I will simply remove it and all references to it in the handbook. Perhaps the total absence of a FAQ will motivate folks to update the relevant handbook sections. Jordan From owner-freebsd-doc Sun Nov 24 10:58:09 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.5/8.7.3) id KAA05372 for doc-outgoing; Sun, 24 Nov 1996 10:58:09 -0800 (PST) Received: from palrel1.hp.com (palrel1.hp.com [15.253.72.10]) by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id KAA05361 for ; Sun, 24 Nov 1996 10:58:05 -0800 (PST) Received: from srmail.sr.hp.com (srmail.sr.hp.com [15.4.45.14]) by palrel1.hp.com with ESMTP (8.7.5/8.7.3) id KAA01350; Sun, 24 Nov 1996 10:57:57 -0800 (PST) Received: from hpnmhjw.sr.hp.com by srmail.sr.hp.com with ESMTP (1.37.109.16/15.5+ECS 3.3) id AA196601876; Sun, 24 Nov 1996 10:57:56 -0800 Received: from mina.sr.hp.com by hpnmhjw.sr.hp.com with SMTP (1.37.109.16/15.5+ECS 3.3) id AA131091875; Sun, 24 Nov 1996 10:57:55 -0800 Message-Id: <199611241857.AA131091875@hpnmhjw.sr.hp.com> To: "Jordan K. Hubbard" Cc: roberto@keltia.freenix.fr (Ollivier Robert), doc@freebsd.org Subject: Re: FAQ... Reply-To: darrylo@sr.hp.com In-Reply-To: Your message of "Sun, 24 Nov 1996 10:10:30 PST." <2583.848859030@time.cdrom.com> Date: Sun, 24 Nov 1996 10:57:55 -0800 From: Darryl Okahata Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk > OK, well, if nobody claims it in the next 24 hours then I will simply > remove it and all references to it in the handbook. Perhaps the > total absence of a FAQ will motivate folks to update the relevant > handbook sections. What if the FAQ was merged into the handbook, and someone creates a "FAQ table of contents" that merely points to the appropriate handbook sections? -- Darryl Okahata Internet: darrylo@sr.hp.com DISCLAIMER: this message is the author's personal opinion and does not constitute the support, opinion, or policy of Hewlett-Packard, or of the little green men that have been following him all day. From owner-freebsd-doc Mon Nov 25 12:41:35 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.5/8.7.3) id MAA07485 for doc-outgoing; Mon, 25 Nov 1996 12:41:35 -0800 (PST) Received: from grace (grace.grace.se [193.14.11.2]) by freefall.freebsd.org (8.7.5/8.7.3) with SMTP id MAA07477 for ; Mon, 25 Nov 1996 12:41:27 -0800 (PST) Received: from 131.115.119.239 by grace via SMTP (940816.SGI.8.6.9/940406.SGI.AUTO) id VAA07192; Mon, 25 Nov 1996 21:42:49 +0100 Message-ID: <329A04E4.6173@grace.se> Date: Mon, 25 Nov 1996 21:43:16 +0100 From: Johan lundstrom X-Mailer: Mozilla 2.0 (Macintosh; I; PPC) MIME-Version: 1.0 To: doc@freebsd.org Subject: questions -> freebsd-questions!? X-URL: http://www.freebsd.org/mailto.html Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk Hi! I just tried to subscribe to a couple of the FreeBSD mailinglists via = the freebsd.org - website following the instructions qouted below: > 1.15. How can I get on the mailing lists? > = > Example: > = > To subscribe to the questions list, you'll to send a message >containing = the following command in the body of the message (the >subject will be igno= red): = > = > subscribe questions john.smith@foo.bar (John Smith) This is what I got in return: >>>> subscribe questions **** subscribe: unknown list 'questions'. I then changed my request to: subscribe freebsd-questions =2E..and got successful :-D Maybe you should change this in the FAQ. I=B4ve been surfing like mad to find a solution to some installation = problems I have (whithout success...:-( and I've probably seen the = mailinglist name "freebsd-questions" somewhere... regards /JOHAN From owner-freebsd-doc Mon Nov 25 23:25:47 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.5/8.7.3) id XAA17482 for doc-outgoing; Mon, 25 Nov 1996 23:25:47 -0800 (PST) Received: from crcrelay.crc.co.jp (crcnews.crc.co.jp [157.113.18.4]) by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id XAA17477 for ; Mon, 25 Nov 1996 23:25:42 -0800 (PST) Received: from ns.tky.crc.co.jp ([157.113.17.4]) by crcrelay.crc.co.jp (8.7.1+2.6Wbeta4/3.3W9-CRC-M1.7) with SMTP id QAA10486 for ; Tue, 26 Nov 1996 16:24:13 +0900 (JST) Received: from crcpce88.tky.crc.co.jp (crcpce88.tky.crc.co.jp [157.113.63.43]) by ns.tky.crc.co.jp (8.6.11/3.3W9-CRC-M1.2) with SMTP id QAA17045 for ; Tue, 26 Nov 1996 16:25:25 +0900 Message-ID: <329A9C67.48EA@yccig.crc.co.jp> Date: Tue, 26 Nov 1996 16:29:43 +0900 From: sekiguchi X-Mailer: Mozilla 3.0 [ja] (Win95; I) MIME-Version: 1.0 To: freebsd-doc@FreeBSD.ORG Subject: yryrty Content-Type: text/plain; charset=iso-2022-jp Content-Transfer-Encoding: 7bit Sender: owner-doc@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk 56tutuf olhjkio jkljkljiol njkljiolji From owner-freebsd-doc Wed Nov 27 12:35:09 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.5/8.7.3) id MAA10377 for doc-outgoing; Wed, 27 Nov 1996 12:35:09 -0800 (PST) Received: from tolstoy.mpd.ca (wlloyd.HIP.CAM.ORG [199.84.42.209]) by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id MAA10352 for ; Wed, 27 Nov 1996 12:34:43 -0800 (PST) Received: (from root@localhost) by tolstoy.mpd.ca (8.7.5/8.7.3) id PAA10951; Wed, 27 Nov 1996 15:37:40 -0500 (EST) Date: Wed, 27 Nov 1996 15:37:40 -0500 (EST) From: William Lloyd Message-Id: <199611272037.PAA10951@tolstoy.mpd.ca> To: freebsd-doc@freebsd.org Subject: handbook additions. Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk I have done some work moving information from the FAQ and integrating it into the handbook. As well, I have written some basic stuff for the mail section. The FAQ should be trimmed down as information is migrated to the handbook. I will do that when this stuff is finished. I am posting the complete changes that I have done. Diff's to 3 files and 3 new ones. If you don't want to bother fooling with the diffs, yu can see the changes in a modified handbook on my site I only have 14.4 connection, it will be SLOW I expect. All changes are in handbook section 11, and 14. Except for the addition of a search handbook link in the opening text. Please provide comments/additions/changes/complaints etc. -bill wlloyd@mpd.ca *** ../handbook.orig/Makefile Wed Nov 13 15:10:25 1996 --- Makefile Wed Nov 27 14:38:53 1996 *************** *** 2,15 **** SRCS= authors.sgml basics.sgml bibliography.sgml boothelp.sgml SRCS+= booting.sgml contrib.sgml crypt.sgml ctm.sgml current.sgml ! SRCS+= cyclades.sgml development.sgml dialup.sgml SRCS+= diskless.sgml dma.sgml eresources.sgml esdi.sgml SRCS+= firewalls.sgml glossary.sgml goals.sgml ! SRCS+= handbook.sgml history.sgml hw.sgml install.sgml isdn.sgml kerberos.sgml ! SRCS+= kernelconfig.sgml kerneldebug.sgml lists.sgml memoryuse.sgml SRCS+= mirrors.sgml nfs.sgml nutshell.sgml pgpkeys.sgml policies.sgml ! SRCS+= porting.sgml ports.sgml ppp.sgml printing.sgml quotas.sgml relnotes.sgml ! SRCS+= routing.sgml scsi.sgml sections.sgml sio.sgml skey.sgml slipc.sgml SRCS+= slips.sgml stable.sgml submitters.sgml sup.sgml synching.sgml SRCS+= term.sgml troubleshooting.sgml userppp.sgml uart.sgml linuxemu.sgml --- 2,17 ---- SRCS= authors.sgml basics.sgml bibliography.sgml boothelp.sgml SRCS+= booting.sgml contrib.sgml crypt.sgml ctm.sgml current.sgml ! SRCS+= cyclades.sgml development.sgml dialup.sgml dialout.sgml SRCS+= diskless.sgml dma.sgml eresources.sgml esdi.sgml SRCS+= firewalls.sgml glossary.sgml goals.sgml ! SRCS+= handbook.sgml history.sgml hw.sgml install.sgml isdn.sgml ! SRCS+= kerberos.sgml kernelconfig.sgml kerneldebug.sgml ! SRCS+= lists.sgml mail.sgml memoryuse.sgml SRCS+= mirrors.sgml nfs.sgml nutshell.sgml pgpkeys.sgml policies.sgml ! SRCS+= porting.sgml ports.sgml ppp.sgml printing.sgml ! SRCS+= quotas.sgml relnotes.sgml routing.sgml ! SRCS+= serial.sgml scsi.sgml sections.sgml sio.sgml skey.sgml slipc.sgml SRCS+= slips.sgml stable.sgml submitters.sgml sup.sgml synching.sgml SRCS+= term.sgml troubleshooting.sgml userppp.sgml uart.sgml linuxemu.sgml *** ../handbook.orig/handbook.sgml Sat Nov 16 16:11:04 1996 --- handbook.sgml Wed Nov 27 14:38:57 1996 *************** *** 47,55 **** Web server">. It may also be downloaded in ascii, LaTeX, postscript or HTML from the or one of the numerous ! . - --- 47,55 ---- Web server">. It may also be downloaded in ascii, LaTeX, postscript or HTML from the or one of the numerous ! . You may also want to . ! *************** *** 108,116 **** Basic Networking * Ethernet basics ! * Serial basics &term; &dialup; PPP and SLIP --- 108,117 ---- Basic Networking * Ethernet basics ! &serial; &term; &dialup; + &dialout; PPP and SLIP *************** *** 135,143 **** * Yellow Pages/NIS &isdn; ! * Mail ! ! --- 136,143 ---- * Yellow Pages/NIS &isdn; ! E-Mail ! &mail; *** ../handbook.orig/sections.sgml Sun Sep 8 21:56:58 1996 --- sections.sgml Wed Nov 27 14:38:54 1996 *************** *** 14,19 **** --- 14,20 ---- + *************** *** 30,35 **** --- 31,37 ---- + *************** *** 43,48 **** --- 45,51 ---- + ******************New file serial.sgml****************** Serial Basics

Assembled from FAQ. This section should give you some general information about serial ports. If you don't find what you want here, check into the Terminal and Dialup sections of the handbook. Default Port settings

The stty -a -f /dev/ttyd1 When you change the settings to this device, the settings are in effect until the device is closed. When it's reopened, it goes back to the default set. To make changes to the default set, you can open and adjust the settings of the ``initial state'' device. For example, to turn on XON/XOFF flow control by default for ttyd5, do: stty -f /dev/ttyid5 clocal cs8 ixon ixoff A good place to do this is in /etc/rc.serial. Now, an application will have these settings by default when it opens stty -f /dev/ttyld5 57600 Now, an application that opens

Mail <author> &a.wlloyd; <date> 24 Nov 1996, (c) 1996 <abstract> This section contains basic information on setting up E-Mail for you FreeBSD box. </abstract> <toc> --> <sect><heading>Basic Information<label id="mail"></heading> <p><em>Contributed by &a.wlloyd;.</em> <p> E-mail, as simple as the concept sounds, can be extremely complicated. If you plan on doing anything beyond setting up a simple one machine E-mail system, you should buy and refer to a book on Sendmail. <sect1><heading>Introduction</heading> <p> These are the major programs or components of an email exchange. <sect2><heading>User program</heading> <p> This is a program like <tt /elm, pine, mail/ , or something more sophisticated like a WWW browser. This program will simply pass off all email transactions to the local mailhost, either by calling <tt>sendmail</tt> or delivering it over TCP to your mailhost. <sect2><heading>Transport Agent - Sendmail</heading> <p> Usually this program is <tt /sendmail or smail/ running in the background. Turn it off or change the command line options in <tt> /etc/sysconfig </tt>. It's best to leave it on unless you have a specific reason to want it off. Ie: Firewall <p> You should be aware that <tt>sendmail</tt> is a potential weak link in a secure site. Some versions of <tt>sendmail</tt> have known security problems. <p> <tt> sendmail </tt> will look up in the DNS to determine the actual host that will receive mail for the destination. <p> Sendmail will take the message from the local queue and deliver it across the internet to another sendmail on the receivers computer. <p> Sendmail will also be able to do the reverse. It will accept messages and save them on your local machine. <sect2><heading>POP Servers</heading> <p> This program gets the mail from your mailbox and gives it to your browser. If you want to run a POP server on your computer, you will need to do 2 things. <verb> Get pop software from the ports or packages collection. Modify /etc/inetd.conf to load POP server. </verb> The pop program you get will have instructions with it. Read them. <sect1><heading>Configure</heading> <p> As your FreeBSD system comes "out of the box" you should be able to send email to external hosts. The problem is no mail will be able to get back to your host. This is not a problem if you are willing to make sure you hand edit the automatic <tt> reply to address </tt> every time you send a message. <p> It is relatively simple to get another host to receive your email under the same username. You can then pick it up over POP or telnet. A user account with the SAME USERNAME should exist on both machines. Please use <tt/adduser/ to do this if needed. If you set the <tt/shell/ to <tt>/nonexistant</tt> the user will not be allowed to login. The mailhost that you will be using must be designated the Mail eXchange for your host. This must be arranged in DNS (ie BIND, named). Please refer to a Networking book for more information. You basically need to add these lines in your DNS server. <verb> myhost.smalliap.com A xxx.xxx.xxx.xxx ; Your ip MX 10 smtp.smalliap.com ; your mailhost </verb> You cannot do this yourself unless you are running a DNS server. If you don't want to run a DNS server, get somebody else like your Internet Provider to do it. This will redirect mail for your host to the MX (Mail eXchange) host. It does not matter what machine the A record points to, the mail will be sent to the MX host. <p> This feature is used to implement Virtual Hosting. <p>Example <p> I have a customer with domain foo.bar and I want all mail for foo.bar to be sent to my machine smtp.smalliap.com. You must make an entry in your DNS server like: <verb> myhost.smalliap.com MX 10 smtp.smalliap.com ; your mailhost </verb> The A record is not needed if you only want email for the domain. On the mailhost that actually accepts mail for final delivery to a mailbox, sendmail must be told what hosts it will be accepting mail for. <p>Add myhost.smalliap.com to /etc/sendmail.cw (if you are using FEATURE(use_cw_file)), or add a "Cw myhost.smalliap.com" line to /etc/sendmail.cf. <p>To actually receive mail on your host, you need to have the MX entry above changed to point to your host. You also move the Cw line above in your <tt>sendmail.cf</tt>. <p> This is a Bad Idea if your connection to the internet is not permanent. Mail will bounce. <p> If you plan on doing anything serious with <tt/sendmail/ you should install the sendmail source. The source has plently of documentation with it. You will find information on getting <tt/sendmail/ source from <ref name="UUCP and sendmail" id="sendmailuucp">. </sect> <sect><heading>FAQ<label id="mailfaq"></heading> <sect1> <heading>Why do I have to use the FQDN for hosts on my site?</heading> <p> You will probably find that the host is actually in a different domain; for example, if you are in foo.bar.edu and you wish to reach a host called ``mumble'' in the bar.edu domain, you will have to refer to it by the fully-qualified domain name, ``mumble.bar.edu'', instead of just ``mumble''. <p> Traditionally, this was allowed by BSD BIND resolvers. However the current version of <em>BIND</em> that ships with FreeBSD no longer provides default abbreviations for non-fully qualified domain names other than the domain you are in. So an unqualified host <tt>mumble</tt> must either be found as <tt>mumble.foo.bar.edu</tt>, or it will be searched for in the root domain. <p> This is different from the previous behaviour, where the search continued across <tt>mumble.bar.edu</tt>, and <tt>mumble.edu</tt>. Have a look at RFC 1535 for why this was considered bad practice, or even a security hole. <p> As a good workaround, you can place the line <p><tt> search foo.bar.edu bar.edu </tt><p> instead of the previous <p><tt> domain foo.bar.edu </tt><p> into your <tt>/etc/resolv.conf</tt>. However, make sure that the search order does not go beyond the ``boundary between local and public administration'', as RFC 1535 calls it. </sect1> <sect1><heading>Sendmail says ``mail loops back to myself''</heading> <p> This is answered in the sendmail FAQ as follows:- <verb> * I'm getting "Local configuration error" messages, such as: 553 relay.domain.net config error: mail loops back to myself 554 <user@domain.net>... Local configuration error How can I solve this problem? You have asked mail to the domain (e.g., domain.net) to be forwarded to a specific host (in this case, relay.domain.net) by using an MX record, but the relay machine doesn't recognize itself as domain.net. Add domain.net to /etc/sendmail.cw (if you are using FEATURE(use_cw_file)) or add "Cw domain.net" to /etc/sendmail.cf. </verb> <p> The sendmail FAQ is in <tt>/usr/src/usr.sbin/sendmail</tt> and is recommended reading if you want to do any ``tweaking'' of your mail setup. <sect1> <heading>How do I use sendmail for mail delivery with UUCP?<label id="sendmailuucp"></heading> <p> The sendmail configuration that ships with FreeBSD is suited for sites that connect directly to the Internet. Sites that wish to exchange their mail via UUCP must install another sendmail configuration file. <p> Tweaking <tt>/etc/sendmail.cf</tt> manually is considered something for purists. Sendmail version 8 comes with a new approach of generating config files via some <tt>m4</tt> preprocessing, where the actual hand-crafted configuration is on a higher abstraction level. You should use the configuration files under <verb> /usr/src/usr.sbin/sendmail/cf </verb> If you didn't install your system with full sources, the sendmail config stuff has been broken out into a separate source distribution tarball just for you. Assuming you've got your CD-ROM mounted, do: <verb> cd /usr/src tar -xvzf /cdrom/dists/src/ssmailcf.aa </verb> Don't panic, this is only a few hundred kilobytes in size. The file <tt>README</tt> in the <tt>cf</tt> directory can serve as a basic introduction to m4 configuration. <p> For UUCP delivery, you are best advised to use the <em>mailertable</em> feature. This constitutes a database that sendmail can use to base its routing decision upon. <p> First, you have to create your <tt>.mc</tt> file. The directory <tt>/usr/src/usr.sbin/sendmail/cf/cf</tt> is the home of these files. Look around, there are already a few examples. Assuming you have named your file <tt>foo.mc</tt>, all you need to do in order to convert it into a valid <tt>sendmail.cf</tt> is: <verb> cd /usr/src/usr.sbin/sendmail/cf/cf make foo.cf cp foo.cf /etc/sendmail.cf </verb> A typical <tt>.mc</tt> file might look like: <verb> include(`../m4/cf.m4') VERSIONID(`Your version number') OSTYPE(bsd4.4) FEATURE(nodns) FEATURE(nocanonify) FEATURE(mailertable) define(`UUCP_RELAY', your.uucp.relay) define(`UUCP_MAX_SIZE', 200000) MAILER(local) MAILER(smtp) MAILER(uucp) Cw your.alias.host.name Cw youruucpnodename.UUCP </verb> The <em>nodns</em> and <em>nocanonify</em> features will prevent any usage of the DNS during mail delivery. The <em>UUCP_RELAY</em> clause is needed for bizarre reasons, don't ask. Simply put an Internet hostname there that is able to handle .UUCP pseudo-domain addresses; most likely, you will enter the mail relay of your ISP there. <p> Once you've got this, you need this file called <tt>/etc/mailertable</tt>. A typical example of this gender again: <verb> # # makemap hash /etc/mailertable.db < /etc/mailertable # horus.interface-business.de uucp-dom:horus .interface-business.de uucp-dom:if-bus interface-business.de uucp-dom:if-bus .heep.sax.de smtp8:%1 horus.UUCP uucp-dom:horus if-bus.UUCP uucp-dom:if-bus . uucp-dom:sax </verb> As you can see, this is part of a real-life file. The first three lines handle special cases where domain-addressed mail should not be sent out to the default route, but instead to some UUCP neighbour in order to ``shortcut'' the delivery path. The next line handles mail to the local Ethernet domain that can be delivered using SMTP. Finally, the UUCP neighbours are mentioned in the .UUCP pseudo-domain notation, to allow for a ``uucp-neighbour!recipient'' override of the default rules. The last line is always a single dot, matching everything else, with UUCP delivery to a UUCP neighbour that serves as your universal mail gateway to the world. All of the node names behind the <tt>uucp-dom:</tt> keyword must be valid UUCP neighbours, as you can verify using the command <tt>uuname</tt>. <p> As a reminder that this file needs to be converted into a DBM database file before being usable, the command line to accomplish this is best placed as a comment at the top of the mailertable. You always have to execute this command each time you change your mailertable. <p> Final hint: if you are uncertain whether some particular mail routing would work, remember the <tt>-bt</tt> option to sendmail. It starts sendmail in <em>address test mode</em>; simply enter ``0 '', followed by the address you wish to test for the mail routing. The last line tells you the used internal mail agent, the destination host this agent will be called with, and the (possibly translated) address. Leave this mode by typing Control-D. <verb> j@uriah 191% sendmail -bt ADDRESS TEST MODE (ruleset 3 NOT automatically invoked) Enter <ruleset> <address> > 0 foo@interface-business.de rewrite: ruleset 0 input: foo @ interface-business . de ... rewrite: ruleset 0 returns: $# uucp-dom $@ if-bus $: foo \ < @ interface-business . de > > ^D j@uriah 192% </verb> <sect1><heading>How can I do email with a dialup PPP host</heading> <p> You want to connect a FreeBSD box on a lan, to the internet. The FreeBSD box will be a mail gateway for the lan. The PPP connection is non-dedicated. There are at least two way to do this. The other is to use UUCP. The key is to get a internet site to provide secondary MX services for your domain. For example: <verb> bigco.com. MX 10 bigco.com. MX 20 smalliap.com. </verb> Only one host should be specified as the final recipient ( add ''Cw bigco.com'' in <tt>/etc/sendmail.cf</tt> on bigco.com). When the senders sendmail 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. Sendmail will automatically deliver it to the secondary MX site, ie your internet provider. The secondary MX site will try every (<tt>sendmail_flags = "-bd -q15m"</tt> in <tt>/etc/sysconfig</tt> ) 15 minutes to connect to your host to deliver the mail to the primary MX site. You might wat to use something like this as a login script. <verb> #!/bin/sh # Put me in /usr/local/bin/pppbigco ( sleep 60 ; /usr/sbin/sendmail -q ) & /usr/sbin/ppp -direct pppbigco </verb> If you are going to create a seperate login script for a user you could use <tt>sendmail -qRbigco.com</tt> instead in the script above. This will force all mail in your queue for bigco.com to be processed immediately. A further refinement of the situation is as follows. Message stolen from the freebsd-isp mailing list. <verb> > we provide the secondary mx for a customer. The customer connects to > our services several times a day automatically to get the mails to > his primary mx (We do not call his site when a mail for his domains > errived). Our sendmail sends the mailqueue every 30 minutes. At the > momen he has to stay 30 minutes online to be sure that all mail is > gone to the primary mx. > > Is there a command that would initiate sendmail to send all the mails > now? The user has not root-privilages on our machine of course. In the 'privacy flags' section of sendmail.cf, there is a definition Opgoaway,restrictqrun Remove restrictqrun to allow non-root users to start the queue processing. You might also like to rearrange the MXs. We are the 1st MX for our customers like this, and we have defined: # If we are the best MX for a host, try directly instead of generating # local config error. OwTrue That way a remote site will deliver straight to you, without trying the customer connection. You then send to your customer. Only works for 'hosts', so you need to get your customer to name their mail machine 'customer.com' as well as 'hostname.customer.com' in the DNS. Just put an A record in the DNS for 'customer.com'. </verb> </sect1> ******************New file dialout.sgml****************** <!-- This is an SGML document in the linuxdoc DTD of the Tutorial for Configuring a FreeBSD for Dialout Services. $Id$ The FreeBSD Documentation Project <!DOCTYPE linuxdoc PUBLIC "-//FreeBSD//DTD linuxdoc//EN"> <linuxdoc> <article> <title> Dialout <author> FAQ <date> 24 Nov 1996, (c) 1996 <abstract> This section contains some basic information on being able to dialout from your FreeBSD box with a modem. This information is really a stepping stone into PPP. </abstract> <toc> --> <sect><heading>Dialout<label id="dialout"></heading> <p><em>Information integrated from FAQ.</em> The following are tips to getting your host to be able to connect over the modem to another computer. This is appropriate for establishing a terminal session with a remote host. <p>This is usefull to log onto a BBS. <p>This kind of connection can be extremely helpfull to get a file on the internet if you have problems with PPP. If you need to ftp something and PPP is broken, use the terminal session to ftp it. Then use zmodem to transfer it to your machine. <sect1> <heading>Why can't I run <tt/tip/ or <tt/cu/?</heading> <p> On your system, the programs <tt/tip/ and <tt/cu/ are probably executable only by <tt/uucp/ and group <tt/dialer/. You can use the group <tt/dialer/ to control who has access to your modem or remote systems. Just add yourself to group dialer. Alternatively, you can let everyone on your system run <tt/tip/ and <tt/cu/ by typing: <verb> chmod 4511 /usr/bin/tip </verb> You don't have to run this command for <tt/cu/, since <tt/cu/ is just a hard link to <tt/tip/. <sect1> <heading>My stock Hayes modem isn't supported---what can I do?</heading> <p> Actually, the man page for <tt/tip/ is out of date. There is a generic Hayes dialer already built in. Just use ``<tt/at=hayes/'' in your <tt>/etc/remote</tt> file. The Hayes driver isn't smart enough to recognize some of the advanced features of newer modems---messages like <tt/BUSY/, <tt/NO DIALTONE/, or <tt/CONNECT 115200/ will just confuse it. You should turn those messages off when you use <tt/tip/ (using <tt/ATX0&W/). Also, the dial timeout for <tt/tip/ is 60 seconds. Your modem should use something less, or else tip will think there's a communication problem. Try <tt/ATS7=45&W/. Actually, as shipped <tt/tip/ doesn't yet support it fully. The solution is to edit the file <tt/tipconf.h/ in the directory <tt>/usr/src/usr.bin/tip/tip</tt> Obviously you need the source distribution to do this. Edit the line ``<tt/#define HAYES 0/'' to ``<tt/#define HAYES 1/''. Then ``<tt/make/'' and ``<tt/make install/''. Everything works nicely after that. <sect1> <heading>How am I expected to enter these AT commands?<label id="direct-at"></heading> <p> Make what's called a ``<tt/direct/'' entry in your <tt>/etc/remote</tt> file. For example, if your modem's hooked up to the first serial port, <tt>/dev/cuaa0</tt>, then put in the following line: <verb> cuaa0:dv=/dev/cuaa0:br#19200:pa=none </verb> Use the highest bps rate your modem supports in the br capability. Then, type ``<tt/tip cuaa0/'' and you'll be connected to your modem. If there is no <tt>/dev/cuaa0</tt> on your system, do this: <verb> cd /dev MAKEDEV cuaa0 </verb> <p> Or use cu as root with the following command: <verb> cu -l``line'' -s``speed'' </verb> with line being the serial port (e.g.<tt>/dev/cuaa0</tt>) and speed being the speed (e.g.<tt>57600</tt>). When you are done entering the AT commands hit <tt>~.</tt> to exit. <sect1> <heading>The <tt/@/ sign for the pn capability doesn't work!</heading> <p> The <tt/@/ sign in the phone number capability tells tip to look in <tt>/etc/phones</tt> for a phone number. But the <tt/@/ sign is also a special character in capability files like <tt>/etc/remote</tt>. Escape it with a backslash: <verb> pn=\@ </verb> <sect1> <heading>How can I dial a phone number on the command line?</heading> <p> Put what's called a ``<tt/generic/'' entry in your <tt>/etc/remote</tt> file. For example: <verb> tip115200|Dial any phone number at 115200 bps:\ :dv=/dev/cuaa0:br#115200:at=hayes:pa=none:du: tip57600|Dial any phone number at 57600 bps:\ :dv=/dev/cuaa0:br#57600:at=hayes:pa=none:du: </verb> Then you can things like ``<tt/tip -115200 5551234/''. If you prefer <tt/cu/ over <tt/tip/, use a generic cu entry: <verb> cu115200|Use cu to dial any number at 115200bps:\ :dv=/dev/cuaa1:br#57600:at=hayes:pa=none:du: </verb> and type ``<tt/cu 5551234 -s 115200/''. <sect1> <heading>Do I have to type in the bps rate every time I do that?</heading> <p> Put in an entry for <tt/tip1200/ or <tt/cu1200/, but go ahead and use whatever bps rate is appropriate with the br capability. <tt/tip/ thinks a good default is 1200 bps which is why it looks for a ``<tt/tip1200/'' entry. You don't have to use 1200 bps, though. <sect1> <heading>I access a number of hosts through a terminal server.</heading> <p> Rather than waiting until you're connected and typing ``<tt/CONNECT <host>/'' each time, use tip's <tt/cm/ capability. For example, these entries in <tt>/etc/remote</tt>: <verb> pain|pain.deep13.com|Forrester's machine:\ :cm=CONNECT pain\n:tc=deep13: muffin|muffin.deep13.com|Frank's machine:\ :cm=CONNECT muffin\n:tc=deep13: deep13:Gizmonics Institute terminal server:\ :dv=/dev/cua02:br#38400:at=hayes:du:pa=none:pn=5551234: </verb> will let you type ``<tt/tip pain/'' or ``<tt/tip muffin/'' to connect to the hosts pain or muffin; and ``<tt/tip deep13/'' to get to the terminal server. <sect1> <heading>Can tip try more than one line for each site?</heading> <p> This is often a problem where a university has several modem lines and several thousand students trying to use them... <p> Make an entry for your university in <tt>/etc/remote</tt> and use <tt>\@</tt> for the <tt/pn/ capability: <verb> big-university:\ :pn=\@:tc=dialout dialout:\ :dv=/dev/cuaa3:br#9600:at=courier:du:pa=none: </verb> Then, list the phone numbers for the university in <tt>/etc/phones</tt>: <verb> big-university 5551111 big-university 5551112 big-university 5551113 big-university 5551114 </verb> <tt/tip/ will try each one in the listed order, then give up. If you want to keep retrying, run <tt/tip/ in a while loop. <sect1> <heading>Why do I have to hit CTRL+P twice to send CTRL+P once?</heading> <p> CTRL+P is the default ``force'' character, used to tell <tt/tip/ that the next character is literal data. You can set the force character to any other character with the <tt/~s/ escape, which means ``set a variable.'' Type ``<tt/~sforce=<single-char>/'' followed by a newline. <tt/<single-char>/ is any single character. If you leave out <tt/<single-char>/, then the force character is the nul character, which you can get by typing CTRL+2 or CTRL+SPACE. A pretty good value for <tt/<single-char>/ is SHIFT+CTRL+6, which I've seen only used on some terminal servers. You can have the force character be whatever you want by specifying the following in your <tt>$HOME/.tiprc</tt> file: <verb> force=<single-char> </verb> <sect1> <heading>Suddenly everything I type is in UPPER CASE??</heading> <p> You must've pressed CTRL+A, <tt/tip/'s ``raise character,'' specially designed for people with broken caps-lock keys. Use <tt/~s/ as above and set the variable ``raisechar'' to something reasonable. In fact, you can set it to the same as the force character, if you never expect to use either of these features. Here's a sample .tiprc file perfect for Emacs users who need to type CTRL+2 and CTRL+A a lot: <verb> force=^^ raisechar=^^ </verb> The ^^ is SHIFT+CTRL+6. <sect1> <heading>How can I do file transfers with <tt/tip/?</heading> <p> If you're talking to another UNIX system, you can send and receive files with <tt/~p/ (put) and <tt/~t/ (take). These commands run ``<tt/cat/'' and ``<tt/echo/'' on the remote system to accept and send files. The syntax is: <verb> ~p <local-file> [<remote-file>] ~t <remote-file> [<local-file>] </verb> There's no error checking, so you probably should use another protocol, like zmodem. <sect1> <heading>How can I run zmodem with <tt/tip/?</heading> <p> To receive files, start the sending program on the remote end. Then, type ``<tt/~C rz/'' to begin receiving them locally. To send files, start the receiving program on the remote end. Then, type ``<tt/~C sz <files>/'' to send them to the remote system. </sect From owner-freebsd-doc Thu Nov 28 10:24:20 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.5/8.7.3) id KAA07591 for doc-outgoing; Thu, 28 Nov 1996 10:24:20 -0800 (PST) Received: from fallout.campusview.indiana.edu (fallout.campusview.indiana.edu [149.159.1.1]) by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id KAA07586 for <freebsd-doc@freebsd.org>; Thu, 28 Nov 1996 10:24:18 -0800 (PST) Received: from localhost (jfieber@localhost) by fallout.campusview.indiana.edu (8.7.6/8.7.3) with SMTP id NAA17576; Thu, 28 Nov 1996 13:23:02 -0500 (EST) Date: Thu, 28 Nov 1996 13:23:02 -0500 (EST) From: John Fieber <jfieber@indiana.edu> To: William Lloyd <wlloyd@tolstoy.mpd.ca> cc: freebsd-doc@freebsd.org Subject: Re: handbook additions. In-Reply-To: <199611272037.PAA10951@tolstoy.mpd.ca> Message-ID: <Pine.BSI.3.95.961128130932.9991E-100000@fallout.campusview.indiana.edu> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk On Wed, 27 Nov 1996, William Lloyd wrote: > I have done some work moving information from the FAQ and integrating > it into the handbook. As well, I have written some basic stuff for > the mail section. Thanks! I have committed them with a few tweaks, and with a few reservations. I think some aspects of the mail document are confusing and/or misleading. > These are the major programs or components of an email exchange. > <sect2><heading>User program</heading> For consistent use of terminology, you should probably call these "User Agents". > <sect2><heading>POP Servers</heading> IMAP should be mentioned here as well. > <sect1><heading>Configure</heading> > <p>As your FreeBSD system comes "out of the box" you should be able to > send email to external hosts. The problem is no mail will be able to > get back to your host. This is not a problem if you are willing to > make sure you hand edit the automatic <tt> reply to address </tt> > every time you send a message. If a machine has a DNS entry and appropriate network connection, an out of the box FreeBSD configuration can send *and* receive mail just fine. What you address in this section is a special case of sending mail from machine A, but receiving mail on machine B through the use of DNS MX records. This may be a desirable setup in some situations, but is hardly a requirement for using email on FreeBSD, yet this section leads me to believe that it is required. What is needed is a description of what situations an out of the box configuration works fine in (eg: a full time network connection, a static IP number and a DNS A record for the machine.), and then some common alternates (sending and receiving through a POP/IMAP mail server). -john == jfieber@indiana.edu =========================================== == http://fallout.campusview.indiana.edu/~jfieber ================ From owner-freebsd-doc Fri Nov 29 19:25:56 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.5/8.7.3) id TAA20668 for doc-outgoing; Fri, 29 Nov 1996 19:25:56 -0800 (PST) Received: from guardian.fortress.org (fortress.org [199.84.158.128]) by freefall.freebsd.org (8.7.5/8.7.3) with SMTP id TAA20661 for <doc@freebsd.org>; Fri, 29 Nov 1996 19:25:51 -0800 (PST) Received: (from andrew@localhost) by guardian.fortress.org (8.6.12/8.6.12) id WAA02778; Fri, 29 Nov 1996 22:27:49 -0500 Date: Fri, 29 Nov 1996 22:27:45 -0500 (EST) From: Andrew Webster <andrew@fortress.org> Reply-To: andrew@pubnix.net To: doc@freebsd.org Subject: Change to authors.sgml,v 1.37.2.1 Message-ID: <Pine.BSF.3.91.961129222219.29491O-100000@guardian.fortress.org> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk --- cut here --- *** authors.sgml.old Fri Nov 29 22:20:55 1996 --- authors.sgml Fri Nov 29 22:21:39 1996 *************** *** 12,19 **** name='<asami@FreeBSD.ORG>'></tt>"> <!ENTITY a.awebster "Andrew Webster ! <tt><htmlurl url='mailto:awebster@dataradio.com' ! name='<awebster@dataradio.com>'></tt>"> <!ENTITY a.davidg "David Greenman <tt><htmlurl url='mailto:davidg@FreeBSD.ORG' --- 12,19 ---- name='<asami@FreeBSD.ORG>'></tt>"> <!ENTITY a.awebster "Andrew Webster ! <tt><htmlurl url='mailto:awebster@pubnix.net' ! name='<awebster@pubnix.net>'></tt>"> <!ENTITY a.davidg "David Greenman <tt><htmlurl url='mailto:davidg@FreeBSD.ORG' --- cut here --- I haven't been in the employ of Dataradio since Feb '96. Apparently they still get lots of email for me. I hope that this will fix the problem. Thanks! Andrew Webster andrew@pubnix.net PubNIX Montreal Connected to the world Branche au monde P.O. Box 147 Cote Saint Luc, Quebec H4V 2Y3 tel 514.990.5911 http://www.pubnix.net fax 514.990.9443 From owner-freebsd-doc Sat Nov 30 20:19:09 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.5/8.7.3) id UAA29936 for doc-outgoing; Sat, 30 Nov 1996 20:19:09 -0800 (PST) Received: from mailserver.fiber-net.com (mailserver.fiber-net.com [207.30.120.4]) by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id UAA29930 for <freebsd-doc@FreeBSD.ORG>; Sat, 30 Nov 1996 20:19:05 -0800 (PST) Received: from home ([207.30.120.19]) by mailserver.fiber-net.com (post.office MTA v1.9.3b **** trial license expired ****) with SMTP id AAA177 for <freebsd-doc@FreeBSD.ORG>; Sat, 30 Nov 1996 22:40:23 +0000 Message-Id: <1.5.4.32.19961031041515.0066353c@mailserver.fiber-net.com> X-Sender: webdude@mailserver.fiber-net.com X-Mailer: Windows Eudora Light Version 1.5.4 (32) Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Date: Wed, 30 Oct 1996 23:15:15 -0500 To: freebsd-doc@FreeBSD.ORG From: webdude@fiber-net.com (Mark DeWar) Subject: Docs Sender: owner-doc@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk As a newbie to Freebsd the docs seemed good. However there was really not much refering to it on ftping it to a system. I could not get the modem to dial at all. I found no info on what to look for. Plus the term has only two commands avail. and to a newbie it is confusing and frustrating. More troubleshooting guides would be a GREAT benefit. thanks Mark DeWar Taking One Day At A Time, Valium By The Dozen.