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