home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk1.iso / answers / linux / howto / uucp < prev    next >
Internet Message Format  |  1993-12-15  |  15KB
  1. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!gatech!news-feed-2.peachnet.edu!concert!samba.oit.unc.edu!sunSITE!mdw
  2. From: vince@victrola.wa.com (Vince Skahan)
  3. Newsgroups: comp.os.linux.announce,comp.os.linux.admin,comp.answers,news.answers
  4. Subject: Linux UUCP HOWTO
  5. Followup-To: poster
  6. Date: 15 Dec 1993 22:09:26 GMT
  7. Organization: The University of North Carolina at Chapel Hill
  8. Lines: 414
  9. Approved: linux-announce@tc.cornell.edu (Matt Welsh)
  10. Message-ID: <2eo1un$653@samba.oit.unc.edu>
  11. Reply-To: vince@victrola.wa.com (Vince Skahan)
  12. NNTP-Posting-Host: calypso.oit.unc.edu
  13. Originator: mdw@sunSITE
  14. Xref: senator-bedfellow.mit.edu comp.os.linux.announce:1571 comp.os.linux.admin:2504 comp.answers:3046 news.answers:15870
  15.  
  16. Archive-name: linux/howto/uucp
  17. Last modified:  10 September 1993
  18.  
  19. The Linux UUCP HOWTO
  20. by Vince Skahan, <vince@victrola.wa.com>
  21. v1.2, Last Modified 10 September 1993
  22. ---------------------------------------------------------------------------
  23.  
  24. This document describes the setup and care+feeding of UUCP under Linux.
  25.  
  26. You need to read this if you plan to connect to remote sites via UUCP
  27. via a modem, via a direct-connection, or via Internet.
  28.  
  29. You probably do *not* need to read this document if don't talk UUCP.
  30.  
  31.  
  32. 0.  Introduction
  33.  
  34.     The intent of this document is to answer some of the questions and
  35.     comments that appear to meet the definition of 'frequently asked
  36.     questions' about UUCP software under Linux in general, and the
  37.     version in the Linux SLS distribution in particular.
  38.  
  39.     This document and the corresponding Mail and News 'HOWTO' documents
  40.     collectively supersede the UUCP-NEWS-MAIL-FAQ that has previously
  41.     been posted to comp.os.linux.announce.
  42.  
  43.  
  44. 0.1 New versions of this document
  45.  
  46.     New versions of this document will be periodically posted to
  47.     comp.os.linux.announce, comp.answers, and news.answers.  They will
  48.     also be added to the various anonymous ftp sites who archive such
  49.     information including sunsite.unc.edu:/pub/Linux/docs/HOWTO.
  50.  
  51.  
  52. 0.2 Feedback
  53.  
  54.     I am interested in any feedback, positive or negative, regarding
  55.     the content of this document via e-mail.  Definitely contact me if
  56.     you find errors or obvious omissions.
  57.  
  58.     I read, but do not necessarily respond to, all e-mail I receive.
  59.     Requests for enhancements will be considered and acted upon based on
  60.     that day's combination of available time, merit of the request, and
  61.     daily blood pressure :-)
  62.  
  63.      Flames will quietly go to /dev/null so don't bother.
  64.  
  65.     Feedback concerning the actual format of the document should go to
  66.     the HOWTO coordinator - Matt Welsh (mdw@sunsite.unc.edu).
  67.  
  68.  
  69. 0.3 Other sources of information
  70.  
  71.     USENET:
  72.     =======
  73.         comp.mail.uucp can answer most of your UUCP questions
  74.  
  75.     Mailing Lists:
  76.     ==============
  77.  
  78.         There is a Taylor UUCP mailing list. 
  79.  
  80.         To join (or get off) the list, send mail to
  81.         taylor-uucp-request@gnu.ai.mit.edu  
  82.  
  83.         This request goes to a person, not to a program, so please
  84.         make sure that you include the address at which you want to
  85.         receive mail in the text of the message.
  86.  
  87.         To send a message to the list, send it to
  88.         taylor-uucp@gnu.ai.mit.edu.
  89.  
  90.     Books:
  91.     ======
  92.  
  93.     HDB and V2 versions of UUCP are documented in about every vendor's
  94.     documentation as well as in almost all *nix communications books.
  95.  
  96.     Taylor config files are currently only documented in the info files
  97.     provided with the sources (and in the SLS distribution hopefully).
  98.     To read them, you can grab the nice 'infosrc' program from the 
  99.     SLS 's' disks and compile it.
  100.  
  101.     The following is a non-inclusive set of books that will help...
  102.  
  103.     'Managing UUCP and USENET' from O'Reilly and Associates is in my
  104.         opinion the best book out there for figuring out the
  105.         programs and protocols involved in being a USENET site.
  106.  
  107.     'Unix Communications' from The Waite Group contains a nice
  108.         description of all the pieces (and more) and how they fit
  109.         together.
  110.  
  111.     'Practical Unix Security' from O'Reilly and Associates has a nice
  112.         discussion of how to secure UUCP in general.
  113.  
  114.  
  115. 0.4 Where *NOT* to look for help
  116.  
  117.     There is nothing 'special' about configuring and running UUCP under
  118.     Linux (any more).  Accordingly, you almost certainly do *NOT* want
  119.     to be posting generic UUCP-related questions to the comp.os.linux.*
  120.     newsgroups.
  121.  
  122.     Unless your posting is truly Linux-specific (ie, "please tell me
  123.     what routers are already compiled into the SLS1.03 version of
  124.     smail3.1.28") you should be asking your questions in comp.mail.uucp
  125.     or on the Taylor UUCP mailing list as indicated above.
  126.  
  127.  
  128. 1.0 Hardware Requirements
  129.  
  130.     There are no specific hardware requirements for UUCP under Linux.
  131.     Basically any Hayes-compatible modem works painlessly with UUCP.
  132.  
  133.     In most cases, you'll want the fastest modem you can afford.  In
  134.     general, you want to have a 16550 UART on your serial board or
  135.     built into your modem to handle speeds of above 9600 baud.
  136.  
  137.     If you don't know what that last sentence means, please consult the
  138.     comp.dcom.modems group or the various fine modem and serial
  139.     communications FAQs and periodic postings on USENET.
  140.  
  141.  
  142. 2.0 Getting UUCP 
  143.  
  144.     Taylor UUCP (current version 1.04) is available on prep.ai.mit.edu
  145.     in source form and in the Linux SLS distribution in binary form.
  146.  
  147.     The newspak-1.7.tar.z distribution contains config files and readme
  148.     files related to building uucp, news, and mail software under Linux
  149.     from the various freely-available sources.  It can usually be found 
  150.     on sunsite.unc.edu in the directory /pub/Linux/system/Mail.
  151.  
  152.  
  153. 3.0 Installing the Software
  154.  
  155.     [...much of this section is taken verbatim from the README file in
  156.         the Taylor UUCP v1.04 sources - it's provided here so I can
  157.         help you 'rtfm' instead of just telling you to do so...]
  158.  
  159.     Detailed compilation instructions are in uucp.texi in the sources.
  160.  
  161.     You can grab 'known good' conf.h and policy.h files for Linux 
  162.     from the newspak distribution referred to in the 'other sources of
  163.     information' section above.  In that case, you can probably go right
  164.     to typing 'make'.
  165.  
  166.     To extract a gzip'd tar archive, I do the following:
  167.         gunzip -c filename.tar.z | tar xvf -
  168.  
  169.  
  170. 3.1 Edit Makefile.in to set installation directories.
  171.     
  172.     Here, I set 'prefix' to "/usr" rather than the default
  173.     of "/usr/local"
  174.  
  175.  
  176. 3.2 Run 'configure'
  177.  
  178.     Type ``sh configure''. 
  179.  
  180.     The configure script will compile a number of test programs to see
  181.     what is available on your system and will calculate many things.
  182.  
  183.     The configure script will create conf.h from conf.h.in and
  184.     Makefile from Makefile.in.  It will also create config.status,
  185.     which is a shell script which actually creates the files.
  186.  
  187.  
  188. 3.2 Configure the future setup of the software
  189.  
  190.     Examine conf.h and Makefile to make sure they're right.
  191.     - I took the defaults
  192.  
  193.     Edit policy.h for your local system.
  194.     - set the type of lockfiles you want (HAVE_HDB_LOCKFILES) 
  195.     - set the type of config files you want built in
  196.         (HAVE_TAYLOR_CONFIG, HAVE_V2_CONFIG, HAVE_HDB_CONFIG)
  197.     - set the type of spool directory structure you want
  198.         (SPOOLDIR_HDB)
  199.     - set the type of locking you want (HAVE_HDB_LOGGING)
  200.     - set the default search path for commands
  201.         (I added /usr/local/bin to mine...)
  202.  
  203.         
  204. 3.3 Compile and install the software
  205.  
  206.     Type "make".
  207.  
  208.     Use "uuchk | more" to check configuration files.  You can use
  209.     ``uuconv'' to convert between configuration file formats.
  210.  
  211.     Type "make install" to install.
  212.  
  213.  
  214. 3.4 Set up the config files
  215.  
  216.     I'd recommend you start by taking the attached known-good
  217.     config files for HDB mode and installing them.  
  218.  
  219.     Make sure that the Permissions file indicates exactly where 
  220.     rmail and rnews are to be found if you put them anywhere 
  221.     other than in the path you specified in policy.h
  222.  
  223.     Make sure that your Devices files matches the actual location
  224.     of your modem (cua1=COM2 in the examples)
  225.  
  226.     Edit the Systems file to set up the system(s) you talk to
  227.     with their speed, phone number, username, and password.
  228.     *PROTECT THIS FILE AGAINST WORLD READ*
  229.  
  230.     Set up the Permissions file and add a set of lines for each
  231.     site you talk to.  For security reasons, it's recommended to
  232.     make sure they each have a separate account (if you allow dialin)
  233.     and home directory so you can track things.
  234.  
  235.  
  236. 3.5 Give it a try
  237.  
  238.     /usr/lib/uucp/uucico -r 1 -x 9 -s remote_system_name
  239.  
  240.     The -x 9 will have maximum debugging information written to
  241.     the /usr/spool/uucp/.Admin/audit.local file for help in initial
  242.     setup. I normally run -x 4 here since that level logs details
  243.     that help me with login problems. Obviously, this contains 
  244.     cleartext information from your Systems file (account/password)
  245.     so protect it against world-read. 
  246.  
  247.  
  248. 3.6 It doesn't work - now what ?
  249.  
  250.     In general, you can refer to the documentation mentioned above
  251.     if things don't work.  You can also refer to your more experienced
  252.     UUCP neighbors for help.  Usually, it's something like a typo
  253.     anyway.
  254.  
  255.  
  256. 4.0 Frequently Asked Questions about Linux UUCP
  257.  
  258.  
  259. 4.1 Why is SLS uucp configured in HDB rather than 'Taylor' mode?
  260.  
  261.     Because IMHO it's the de-facto standard UUCP implementation at
  262.     this time.  There are thousands of sites with experienced admins
  263.     and there are many places you can get incredibly good information
  264.     concerning the HDB setup.
  265.  
  266.     The uucp-1.04 that's in SLS 1.02 and later has all three modes of
  267.     config files built in.  While I can't test it, I did 'rtfm' and Ian
  268.     Taylor tells me that it should work.
  269.  
  270.     The search order for config files is Taylor...then V2 (L.sys)...  then
  271.     HDB.  Use the uuconv utility in /usr/lib/uucp to convert config files
  272.     from one mode to another.
  273.  
  274.     If you can't wait, grab the sources for uucp and specify
  275.     HAVE_BNU_CONFIG, HAVE_V2_CONFIG *and* HAVE_TAYLOR_CONFIG in the
  276.     policy.h file and type 'make'.
  277.     
  278.     The following workaround is ugly, but it does work, if you want 
  279.     to run Taylor configs from binaries that don't have it built in...
  280.  
  281.     [... From mbravo@tctube.spb.su (Michael E. Bravo) ...]
  282.  
  283.      - add  '-I /usr/local/lib/uucp/config' to _every_ invocation of 
  284.         whatever program in uucp package
  285.  
  286.  
  287. 4.1 Why do I get 'timeout' on connections when I upgraded to uucp-1.04 ?
  288.  
  289.     [... from Ed Carp - erc@apple.com ...]
  290.  
  291.     If you use a 'Direct' device in the Devices file, there's now a
  292.     10 second timeout compiled in.  Make the name of the Device anything
  293.     other than 'Direct'.  If you tweak the example /usr/lib/uucp files
  294.     provided with SLS, you won't have problems with this one.
  295.  
  296.     [... from Greg Naber - greg@squally.halcyon.com ...]
  297.  
  298.     If you get chat script timeouts, you can tweak the sources by 
  299.     editing at line 323 in uuconf/syssub.c and changing the default
  300.     timeouts from 10 seconds to something larger.
  301.  
  302.     [... from Ed Rodda - ed@orca.wimsey.bc.ca ...]
  303.     If you get chat script timeouts, typically connecting to other
  304.     Taylor sites, a pause after login can fix this.
  305.  
  306.     feed Any ACU,ag 38400 5551212 ogin: \c\d "" yourname word: passwd
  307.                                             ^^^^ 
  308.     [... from Dr. Eberhard W. Lisse - el@lisse.NA ...]
  309.     Some kernels experience modems hanging up after a couple of seconds.
  310.     The following patch sent by Ian Taylor might help...
  311.  
  312. *** conn.c.orig Mon Feb 22 20:25:24 1993
  313. --- conn.c      Mon Feb 22 20:33:10 1993
  314. ***************
  315. *** 204,209 ****
  316. --- 204,212 ----
  317.  
  318.      /* Make sure any signal reporting has been done before we set
  319.        fLog_sighup back to TRUE.  */
  320. +   /* SMR: it seems to me if we don't care about SIGHUPS, we should clear
  321. +      the flag before we return  */
  322. +   afSignal[INDEXSIG_SIGHUP] = FALSE;
  323.     ulog (LOG_ERROR, (const char *) NULL);
  324.     fLog_sighup = TRUE;
  325.  
  326.  
  327. 4.2 Why doesn't HDB anonymous uucp seem to work ?
  328.  
  329.     The SLS anonymous uucp only works in Taylor mode because it's
  330.     compiled with HAVE_TAYLOR_CONFIG.  If you want to do anon uucp in HDB
  331.     mode, you'll have to recompile the sources with just HDB defined.
  332.     Ian Taylor is considering which way to deal with this 'feature'...
  333.  
  334.     Also, Taylor in HDB mode seems to be sensitive to white space and
  335.     blank lines.  To be safe, make sure that there are no blank lines 
  336.     or trailing spaces in the Permissions file.
  337.  
  338.     Lastly, make sure that you have a file called remote.unknown in
  339.     /usr/lib/uucp and that it's *NOT* executable.  See the O'Reilly+Assoc
  340.     book "Managing UUCP and USENET" for details regarding this file.
  341.  
  342.  
  343. 4.3 What does 'no matching ports found' mean ?
  344.  
  345.     In all probability, you are attempting to use a device
  346.     (/usr/lib/uucp/Devices) that doesn't exist, or the device you've
  347.     specified in the /usr/lib/uucp/Systems file doesn't match up with
  348.     any valid devices in the Devices file.
  349.  
  350.     Following this are *sanitized* versions of my working Taylor 1.04
  351.     HDB config files that you can plug in and use...
  352.  
  353.     note the 'ACU' in the Systems ?  That tells which 'port' to use in
  354.     Devices
  355.  
  356.     see the 'scout' word in Systems ?  That tells which dialer to use
  357.     in Dialers.  
  358.  
  359.     If you had a ACU port, but none that matched the specified dialer
  360.     on the same line in Systems, you'll get that message.
  361.  
  362.  
  363. 4.4 What are known good config files for HDB mode ?
  364.  
  365.     The following are 'known-good' config files for Taylor 1.04 under
  366.     Linux in HoneyDanBer mode.  They work on kernels of 0.99-8 or
  367.     later. All files should be in /usr/lib/uucp unless you've tweaked
  368.     the sources to put the uucp library elsewhere.
  369.  
  370.     If you're running a kernel of 0.99-7 or earlier, change 'cua1' to
  371.     'ttyS1'.
  372.  
  373. #------------- Devices -------------
  374. # make sure the device (cua1 here) matches your system
  375. # cua1 = COM2 
  376. #
  377. ACU cua1 - 19200 scout
  378. ACU cua1 - 9600 tbfast
  379. ACU cua1 - 1200 tbslow
  380. ACU cua1 - 2400 tbmed
  381.  
  382. #------------- dialers --------------
  383. # note the setting of the Trailblazer registers 'on the fly'
  384. # 'scout' is a Digicom Scout Plus (Hayes-like) modem
  385. #
  386. scout    =W-,    "" ATM0DT\T CONNECT
  387. tbfast    =W-,    "" A\pA\pA\pT OK ATS50=255DT\T CONNECT\sFAST
  388. tbslow    =W-,    "" A\pA\pA\pT OK ATS50=2DT\T CONNECT\s1200
  389. tbmed    =W-,    "" A\pA\pA\pT OK ATS50=3DT\T CONNECT\s2400
  390.  
  391. #-------------- Systems -------------
  392. # this is a very generic entry that will work for most systems
  393. fredsys Any;1 ACU 19200 scout5555555 "" \r ogin:--ogin: uanon word: uanon 
  394.  
  395. #-------------------------------- Permissions -------------------------
  396.  
  397. # Taylor UUCP in HDB mode appears to be sensitive to blank lines.
  398. # Make sure all Permissions lines are real or commented out.
  399. #    
  400. # this is a anonymous uucp entry
  401. #
  402. LOGNAME=nuucp MACHINE=OTHER \
  403. READ=/usr/spool/uucp/nuucp \
  404. WRITE=/usr/spool/uucp/nuucp \
  405. SENDFILES=yes REQUEST=yes \
  406. COMMANDS=/bin/rmail
  407. #
  408. # this is a normal setup for a remote system that talks to us
  409. # note the absolute path to rnews since this site puts things
  410. # in locations that aren't "standard"
  411. #
  412. LOGNAME=fredsys MACHINE=fredsys \
  413. READ=/usr/spool/uucp/fredsys:/usr/spool/uucp/uucppublic:/files \
  414. WRITE=/usr/spool/uucp/fredsys:/usr/spool/uucppublic \
  415. SENDFILES=yes REQUEST=yes \
  416. COMMANDS=/bin/rmail:/usr/local/lib/news/bin/rnews
  417. #----------------------------------------------------------------------
  418.  
  419.  
  420. 5.0 Acknowledgements
  421.  
  422.     The following people have helped in the assembly of the information
  423.     (and experience) that helped make this document possible:
  424.  
  425.     Ed Carp, Steve Robbins, Ian Taylor, Greg Naber, Matt Welsh 
  426.  
  427.     If I forgot anybody, my apologies...
  428.  
  429.  
  430.