home *** CD-ROM | disk | FTP | other *** search
/ Freelog Special Edition 1: Linux / CD1.iso / doc / HOWTO / UUCP-HOWTO < prev    next >
Text File  |  1998-10-14  |  27KB  |  1,189 lines
  1.   The Linux UUCP HOWTO
  2.   Guylhem Aznar <guylhem at oeil.qc.ca>
  3.   v2.0, 6 February 1998
  4.  
  5.   This document describes the setup, care & feeding of UUCP under Linux.
  6.   You need to read this if you plan to connect to remote sites via UUCP
  7.   via a modem, via a direct-connection, or via Internet.  You probably
  8.   do *not* need to read this document if don't talk UUCP or if you don't
  9.   know what it means.
  10.   ______________________________________________________________________
  11.  
  12.   Table of Contents
  13.  
  14.  
  15.   1. Introduction, copyright & standard disclaimer
  16.  
  17.      1.1 Email & spamming
  18.      1.2 Goals
  19.      1.3 New versions
  20.      1.4 Feedback
  21.      1.5 Copyright
  22.      1.6 Limited warranty
  23.  
  24.   2. Other sources of information
  25.  
  26.      2.1 USENET
  27.      2.2 Mailing Lists
  28.      2.3 Other documents from LDP
  29.      2.4 Books
  30.  
  31.   3. Requirements
  32.  
  33.      3.1 Hardware
  34.      3.2 Software
  35.  
  36.   4. Setting up the config files
  37.  
  38.      4.1 Installing config. files
  39.      4.2 (IDX
  40.      4.3 (IDX
  41.      4.4 (IDX
  42.      4.5 (IDX
  43.      4.6 (IDX
  44.      4.7 (IDX
  45.      4.8 (IDX
  46.      4.9 (IDX
  47.      4.10 Now let's test all this
  48.      4.11 Additional informations
  49.  
  50.   5. It doesn't work - now what?
  51.  
  52.   6. Frequently Asked Questions about Linux UUCP
  53.  
  54.      6.1 Why is all the info here for UUCPs configured in "Taylor" rather than "HDB" mode?
  55.      6.2 Why do I get "timeout" on connections when I upgraded to uucp-1.04?
  56.      6.3 Why doesn't HDB anonymous uucp seem to work?
  57.      6.4 What does "no matching ports found" mean?
  58.      6.5 What are known good config files for HDB mode?
  59.      6.6 Getting uucico to call alternate numbers
  60.  
  61.   7. Acknowledgements
  62.  
  63.  
  64.  
  65.   ______________________________________________________________________
  66.  
  67.   1.  Introduction, copyright & standard disclaimer
  68.  
  69.  
  70.  
  71.   1.1.  Email & spamming
  72.  
  73.  
  74.   First, convert all "at" in Emails addresses given in this document
  75.   into "@".
  76.  
  77.   It's simple for humans, but not for bots searching the web to spam ;
  78.   therefore it's enough to protect generous contributors from being
  79.   spammed.
  80.  
  81.  
  82.   1.2.  Goals
  83.  
  84.  
  85.   The intent of this document is to answer some of the questions &
  86.   comments that appear to meet the definition of "frequently asked
  87.   questions" about UUCP software under Linux genrally & the version in
  88.   the Linux Debian and RedHat distributions in particular.
  89.  
  90.  
  91.   1.3.  New versions
  92.  
  93.  
  94.   New versions of this document will be periodically posted to
  95.   comp.os.linux.announce, comp.answers & news.answers.  They will also
  96.   be added to the various anonymous ftp sites who archive such
  97.   information including sunsite FTP
  98.   <http://sunsite.unc.edu:/pub/Linux/docs/HOWTO>.
  99.  
  100.   In addition, you should be generally able to find this document on the
  101.   Linux WorldWideWeb home page at the LDP page
  102.   <http://sunsite.unc.edu/LDP/>.
  103.  
  104.  
  105.   1.4.  Feedback
  106.  
  107.  
  108.   I am interested in any feedback (please e-mail), positive or negative,
  109.   regarding the content of this document.  Definitely contact me if you
  110.   find errors or obvious omissions.
  111.  
  112.   I read, but do not necessarily respond to, all e-mail I receive.
  113.   Requests for enhancements will be considered & acted upon based on
  114.   that day's combination of available time, merit of the request & daily
  115.   blood pressure :-)
  116.  
  117.   Flames will quietly go to /dev/null so don't bother.
  118.  
  119.   Feedback concerning the actual format of the document should go to the
  120.   HOWTO coordinator: Greg Hankins (gregh at sunsite.unc.edu).
  121.  
  122.  
  123.   1.5.  Copyright
  124.  
  125.  
  126.   The UUCP-HOWTO is copyrighted (c)1997 Guylhem Aznar.  Distributed
  127.   under LDP copyright license.  If you have questions, please contact
  128.   Greg Hankins, the Linux HOWTO coordinator, at gregh at
  129.   sunsite.unc.edu.
  130.  
  131.  
  132.  
  133.   1.6.  Limited warranty
  134.  
  135.  
  136.   Of course, I disavow any potential liability for the contents of this
  137.   document.  Use of the concepts, examples, &/ or other content of this
  138.   document is entirely at your own risk.
  139.  
  140.  
  141.   2.  Other sources of information
  142.  
  143.  
  144.  
  145.   2.1.  USENET
  146.  
  147.  
  148.   There is nothing "special" about configuring & running UUCP under
  149.   Linux (any more).  Accordingly, you almost certainly do *NOT* want to
  150.   be posting generic UUCP-related questions to the comp.os.linux.*
  151.   newsgroups.
  152.  
  153.   Don't post in comp.os.linux hierarchy unless it's really linux
  154.   specific, for example: "What's wrong with Debian 1.2 uucp?" or "RedHat
  155.   5.0 uucp crashes when I run it" ...
  156.  
  157.   Let me repeat that.
  158.  
  159.   There is virtually no reason to post anything uucp-related in the
  160.   comp.os.linux hierarchy any more.  There are existing newsgroups in
  161.   the comp.mail.* hierarchy to handle *ALL* your questions.
  162.  
  163.   IF YOU POST TO COMP.OS.LINUX.* FOR NON-LINUX-SPECIFIC QUESTIONS, YOU
  164.   ARE LOOKING IN THE WRONG PLACE FOR HELP.  THE UUCP EXPERTS HANG OUT IN
  165.   THE PLACES INDICATED ABOVE AND GENERALLY DO NOT RUN LINUX.
  166.  
  167.   POSTING TO THE LINUX HIERARCHY FOR NON-LINUX-SPECIFIC QUESTIONS WASTES
  168.   YOUR TIME AND EVERYONE ELSE'S AND IT FREQUENTLY DELAYS YOU FROM
  169.   GETTING THE ANSWER TO YOUR QUESTION.
  170.  
  171.   The GOOD PLACE is comp.mail.uucp since you can get answers for most of
  172.   your UUCP questions.
  173.  
  174.  
  175.   2.2.  Mailing Lists
  176.  
  177.  
  178.   There is a Taylor UUCP mailing list.
  179.  
  180.   To join (or get off) the list, send mail to
  181.  
  182.                 taylor-uucp-request@gnu.ai.mit.edu
  183.  
  184.  
  185.  
  186.   This request goes to a person, not to a program, so please make sure
  187.   that you include the address at which you want to receive mail in the
  188.   text of the message.
  189.  
  190.   To send a message to the list, send it to
  191.  
  192.                taylor-uucp@gnu.ai.mit.edu
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.   2.3.  Other documents from LDP
  200.  
  201.  
  202.   There is plenty of exceptional material provided in the other Linux
  203.   HOWTO documents & from the Linux DOC project.
  204.  
  205.   In particular, you might want to take a look at the following:
  206.  
  207.  
  208.   ╖  on your own computer in /usr/doc/uucp & /usr/info/uucp* :-)
  209.  
  210.   ╖  the Linux Networking Administrators' Guide
  211.  
  212.   ╖  the Serial Communications HOWTO
  213.  
  214.   ╖  the Ethernet HOWTO
  215.  
  216.   ╖  the News HOWTO
  217.  
  218.   ╖  the Mail HOWTO
  219.  
  220.  
  221.   2.4.  Books
  222.  
  223.  
  224.   HDB & V2 versions of UUCP are documented in about every vendor's
  225.   documentation as well as in almost all *nix communications books.
  226.  
  227.   Taylor config. files are currently only documented in the info files
  228.   provided with the sources (& in your distribution hopefully).  The
  229.   following is a non-inclusive set of books that will help.
  230.  
  231.  
  232.   ╖  "Managing UUCP & USENET" from O'Reilly & Associates is in my
  233.      opinion the best book out there for figuring out the programs &
  234.      protocols involved in being a USENET site.
  235.  
  236.   ╖  "Unix Communications" from The Waite Group contains a nice
  237.      description of all the pieces (& more) & how they fit together.
  238.  
  239.   ╖  "Practical Unix Security" from O'Reilly & Associates has a nice
  240.      discussion of how to secure UUCP.
  241.  
  242.   ╖  "The Internet Complete Reference" from Osborne is a fine reference
  243.      book that explains the various services available on Internet & is
  244.      a great source for information on news, mail & various other
  245.      Internet resources.
  246.  
  247.   ╖  "The Linux Networking Administrators' Guide" from Olaf Kirch of the
  248.      Linux DOC Project is available on the net & is also published by
  249.      (at least) O'Reilly & SSC.  It makes a fine one-stop shopping to
  250.      learn about everything you ever imagined you'd need to know about
  251.      Unix networking.
  252.  
  253.  
  254.   3.  Requirements
  255.  
  256.  
  257.  
  258.  
  259.   3.1.  Hardware
  260.  
  261.  
  262.   There are no specific hardware requirements for UUCP under Linux.
  263.   Basically any Hayes-compatible modem works painlessly with UUCP.
  264.  
  265.   In most cases, you'll want the fastest modem you can afford, i.e.
  266.   56000 bps actually.  In general, you want to have a 16550 UART on your
  267.   serial board or built into your modem to handle speeds of above 9600
  268.   baud.
  269.  
  270.   If you don't know what that last sentence means, please consult the
  271.   comp.dcom.modems group or the various fine modem & serial
  272.   communications FAQs & periodic postings on USENET.
  273.  
  274.  
  275.   3.2.  Software
  276.  
  277.  
  278.   UUCP for linux is available everywhere, for example on
  279.   sunsite.unc.edu.  But before trying to get any version, try to install
  280.   & make your current uucp work ; there're many little differences
  281.   between each linux distribution, therefore it's easier for you to
  282.   configure/install your distribution's UUCP package rather than editing
  283.   sources for some options, setting the right paths & permissions,
  284.   installing, etc.
  285.  
  286.   But if you prefer sources ...
  287.  
  288.  
  289.   1) Unpack
  290.  
  291.  
  292.   To extract a gzip'd tar archive, I do the following:
  293.  
  294.                   gunzip -c filename.tar.z | tar xvf -
  295.  
  296.  
  297.   A "modern" tar can just do a:
  298.  
  299.                  tar -zxvf filename.tgz
  300.  
  301.  
  302.  
  303.  
  304.   2) Run "configure"
  305.  
  306.  
  307.   Type "sh configure".
  308.  
  309.   The configure script will compile a number of test programs to see
  310.   what is available on your system & will calculate many things.
  311.  
  312.   The configure script will create conf.h from conf.h.in & Makefile from
  313.   Makefile.in.  It will also create config.status, which is a shell
  314.   script which actually creates the files.
  315.  
  316.  
  317.   3) Decide where to install
  318.  
  319.  
  320.   Rather than editing the Makefile.in file in the sources you can get
  321.   the same effect by:
  322.  
  323.  
  324.           "configure --prefix=/usr/lib"
  325.  
  326.  
  327.  
  328.  
  329.   4) Edit "policy.h" for your local system
  330.  
  331.   ╖  - set the type of lockfiles you want (HAVE_HDB_LOCKFILES)
  332.  
  333.   ╖  - set the type of config files you want built in
  334.      (HAVE_TAYLOR_CONFIG, HAVE_V2_CONFIG, HAVE_HDB_CONFIG)
  335.  
  336.   ╖  - set the type of spool directory structure you want (SPOOLDIR_HDB)
  337.  
  338.   ╖  - set the type of logging you want (HAVE_HDB_LOGGING)
  339.  
  340.   ╖  - set the default search path for commands (I added /usr/local/bin
  341.      to mine)
  342.  
  343.  
  344.   5) Then compile & install the software
  345.  
  346.  
  347.  
  348.   ╖  Type "make" to compile.
  349.  
  350.   ╖  Type "make install" to install.
  351.  
  352.  
  353.   4.  Setting up the config files
  354.  
  355.  
  356.   I recommend you start by installing the attached known-good config.
  357.   files included in the document.
  358.  
  359.  
  360.   4.1.  Installing config. files
  361.  
  362.  
  363.  
  364.   Put these file in their "standard" location: /etc/uucp on recent linux
  365.   distributions or /usr/lib/uucp on older ones.
  366.  
  367.   Then make sure that the permissions of the files are
  368.  
  369.  
  370.  
  371.        (guylhem@barberouge:uucp)$ ls -l
  372.        total 11
  373.        -rw-r--r--   1 uucp     uucp          501 Jan 23 11:33 Poll
  374.        -rw-r-----   1 uucp     uucp          589 Jan 23 11:34 call
  375.        -rw-r-----   1 uucp     uucp         1184 Jan 23 12:06 config
  376.        -rw-r-----   1 uucp     uucp          476 Jan 23 12:31 crontab
  377.        -rw-r-----   1 uucp     uucp         1256 Jan 23 11:47 dial
  378.        -rw-r-----   1 uucp     uucp          486 Jan 23 11:48 passwd
  379.        -rw-r-----   1 uucp     uucp          810 Jan 23 11:55 port
  380.        -rw-r--r--   1 uucp     uucp         1690 Jan 23 12:04 sys
  381.        (guylhem@barberouge:uucp)$
  382.  
  383.  
  384.  
  385.  
  386.   To change file owner, as root, type:
  387.  
  388.  
  389.        (root@barberouge:uucp)$ chown uucp.uucp *
  390.  
  391.  
  392.  
  393.  
  394.   Then you must change file permissions; as root once again, type:
  395.  
  396.  
  397.   (root@barberouge:uucp)# chmod 640 *
  398.   (root@barberouge:uucp)# chmod +r Poll sys
  399.  
  400.  
  401.  
  402.  
  403.  
  404.   4.2.  "Poll" file
  405.  
  406.  
  407.   This file is used to set polling timetables for any system.
  408.  
  409.  
  410.  
  411.        schedule polux 01
  412.        poll     polux 01
  413.  
  414.  
  415.  
  416.  
  417.   My machine calls polux at 01:00, that's all!
  418.  
  419.   You can add more line if you must call many other machines, but don't
  420.   forget to put the 2 lines (schedule & poll) for each.
  421.  
  422.  
  423.   4.3.  "call" file
  424.  
  425.  
  426.   It contains your login/password for each system you poll:
  427.  
  428.  
  429.        polux uudan password
  430.  
  431.  
  432.  
  433.  
  434.   My machine uses "uudan" login & "password" password :-) when it polls
  435.   "polux".
  436.  
  437.   As for Poll, adapt this to your situation.
  438.  
  439.  
  440.   4.4.  "config" file
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.   nodename barberouge                     # The UUCP name of this system
  464.  
  465.   spool /var/spool/uucp                   # The UUCP spool directory
  466.   pubdir /var/spool/uucppublic            # The UUCP public directory
  467.   logfile /var/log/uucp/log               # The UUCP log file
  468.   statfile /var/log/uucp/stats            # The UUCP statistics file
  469.   debugfile /var/log/uucp/debug           # The UUCP debugging file
  470.  
  471.   #sysfile        /etc/uucp/sys           # Default "sys"
  472.   #portfile       /etc/uucp/port          # Default "port"
  473.   #dialfile       /etc/uucp/dial          # Default "dial"
  474.   #dialcodefile   /etc/uucp/dialcode      # Default "dialcode"
  475.   #callfile       /etc/uucp/call          # Default "call"
  476.   #passwdfile     /etc/uucp/passwd        # Default "passwd"
  477.  
  478.   # No commands may be executed by unknowns (empty list of permitted commands)
  479.   # Upload is authorized in /var/spool/uucp
  480.   unknown commands
  481.   unknown pubdir /var/spool/uucp
  482.   unknown remote-send ~ !~/upload
  483.   unknown remote-receive ~/upload
  484.  
  485.  
  486.  
  487.  
  488.   Here just replace "barberouge" by your system name ; run "hostname" if
  489.   you can't remind it.
  490.  
  491.  
  492.   4.5.  "crontab" file
  493.  
  494.  
  495.  
  496.  
  497.        # Every day just before morning generate reports.
  498.        #
  499.        0 7 * * *     /usr/lib/uucp/uudemon.day root
  500.        #
  501.        # Every hour start the uudemon.hr. To actually poll a remote system,
  502.        # enter its name in /etc/uucp/Poll. You are encouraged to change the "8".
  503.        #
  504.        8 * * * *      /usr/lib/uucp/uudemon.hr
  505.  
  506.  
  507.  
  508.  
  509.   Just run "crontab -u uucp /etc/uucp/crontab" to add it to the others
  510.   crontabs.
  511.  
  512.  
  513.   4.6.  "dial" file
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.   # 1) expect nothing (i.e., continue with step 2)
  530.   # 2) send "ATZ", then a carriage return, then sleep for 1 to 2 seconds.
  531.   # The \c means to not send a final carriage return.
  532.   # 3) wait until the modem echoes "OK", then do the the same for "ATX4" & "OK"
  533.   # 4) send "ATDT", then the telephone number (after translating any dialcodes).
  534.   # 5) wait until the modem echoes "CONNECT"
  535.   # 6) if we get "BUSY", "NO CARRIER" ... during the chat script we abort dialing
  536.   # 7) when the call is over, we make sure we hangup the modem
  537.  
  538.  
  539.   dialer hayes
  540.   chat "" ATZ\r\d\c OK\r \dATX4\r\d\c OK\r ATDT\D CONNECT
  541.   chat-fail RING
  542.   chat-fail NO\sCARRIER
  543.   chat-fail ERROR
  544.   chat-fail NO\sDIALTONE
  545.   chat-fail BUSY
  546.   chat-fail NO\sANSWER
  547.   chat-fail VOICE
  548.   complete \d\d+++\d\dATH\r\c
  549.   abort \d\d+++\d\dATH\r\c
  550.  
  551.   # You can also add other dialers: inetd, nullmodem ...
  552.   #dialer nullmodem
  553.   #complete \d\dexit\r\c
  554.   #abort \d\dexit\r\c
  555.  
  556.  
  557.  
  558.  
  559.   Syntax is complicated ... you'd rather not touch anything here but
  560.   "ATZ" & "ATX4" which are my modem init string.
  561.  
  562.  
  563.   4.7.  "passwd" file
  564.  
  565.  
  566.  
  567.  
  568.        #uuguest                guestpassword
  569.  
  570.  
  571.  
  572.  
  573.   If you allow uucp dialin, just add system/passwords in this file.
  574.  
  575.   It's *that* simple.
  576.  
  577.   But it's recommended for security reasons to make sure each have a
  578.   separate account & home directory so you can track things.
  579.  
  580.  
  581.   4.8.  "port" file
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.   # Description for the modem entry
  596.   # Debianers, make SURE this device is root:dialout, mode 0660 (crw-rw---)
  597.  
  598.   port ACU
  599.   type modem
  600.   device /dev/ttyS0
  601.   dialer hayes
  602.   speed 57600
  603.   # hardflow n
  604.  
  605.  
  606.   # Description for the TCP port - pretty trivial. DON'T DELETE.
  607.   # Change service number if non standard, cf /etc/services
  608.  
  609.   port TCP
  610.   type tcp
  611.   #service 540
  612.  
  613.  
  614.   # Description for the nullmodem entry
  615.   # (ttyS1 means COM2)
  616.  
  617.   port nullmodem
  618.   type direct
  619.   device /dev/ttyS1
  620.   dialer nullmodem
  621.   speed 115200
  622.  
  623.  
  624.  
  625.  
  626.   You shouldn't change anything here ... except your modem port.
  627.  
  628.   On recent distributions with mgetty, it's /dev/ttySN while on older
  629.   distributions it's /dev/cuaN, where N is you serial port:
  630.  
  631.   N starts at 0 & ttyS(N) means COM(N+1), for example, my null-modem is
  632.   on ttyS1 (COM2) while my modem is on ttyS0 (COM1).
  633.  
  634.   Most of recent modems support hardware flow control, if your doesn't,
  635.   just uncomment the line "# hardflow n".
  636.  
  637.  
  638.   4.9.  "sys" file
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.   # First some defaults. These are for ALL other entries (unless overridden).
  662.   #
  663.   protocol gvG
  664.   protocol-parameter G packet-size 1024
  665.   # protocol-parameter G window 7
  666.   protocol-parameter G short-packets
  667.  
  668.   #
  669.   # Our remote uucp connection.
  670.   #
  671.   system polux
  672.   call-login *
  673.   call-password *
  674.   local-send /
  675.   local-receive /var/spool/uucppublic
  676.   remote-send /
  677.   remote-receive /var/spool/uucppublic
  678.   time any
  679.   phone 0111111110
  680.   port ACU
  681.   chat "" \r\c ogin:-BREAK-ogin:-BREAK- \L word: \P
  682.   #chat "" \d\d\r\c ogin: \d\L word: \P
  683.  
  684.   # This is an alternate - it means that if a connection using the above
  685.   # "system polux" fails it falls through to this entry.
  686.   # Only useful if your service provider has more then one phone number for UUCP.
  687.   #
  688.   #alternate polux-2
  689.   #alias polux-2
  690.   #phone 0222222220
  691.  
  692.   # Here's another alternate - we poll the system over TCP/IP.
  693.   # This is useful if we have a PPP connection to our provider.
  694.   # The first two entries will fail because the modem is busy & we will poll
  695.   # over TCP/IP.
  696.   #
  697.   #alternate polux-tcp
  698.   #alias polux-tcp
  699.   #time any
  700.   #address uucp.polux
  701.   #port TCP
  702.   #protocol t
  703.  
  704.   #
  705.   # Last example - a system that we poll over TCP/IP.
  706.   #
  707.   #system horizon
  708.   #call-login *
  709.   #call-password *
  710.   #time any
  711.   #chat "" \d\d\r\c ogin: \d\L word: \P
  712.   #address uucp.horizon.nl
  713.   #port TCP
  714.   #protocol t
  715.  
  716.  
  717.  
  718.  
  719.   Here, you must change "polux" by the name of the system you poll &
  720.   "0111111110" by its phone number.
  721.  
  722.   "polux-2", "polux-tcp" & "horizon" are just examples of user specific
  723.   needs ; if the system you poll has more than one line, define it as
  724.   "itsname-2" ; if you call it by PPP sometimes, just define "itsname-
  725.   tcp" also.
  726.  
  727.   It's useful when chat script fail (busy ...)
  728.  
  729.  
  730.   4.10.  Now let's test all this
  731.  
  732.  
  733.   First run:
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.   (root@barberouge:uucp)# su uucp
  794.   (uucp@barberouge:uucp)# /usr/lib/uucp/uuchk
  795.   Local node name barberouge
  796.   Spool directory /var/spool/uucp
  797.   Public directory /var/spool/uucppublic
  798.   Lock directory /var/lock
  799.   Log file /var/log/uucp/log
  800.   Statistics file /var/log/uucp/stats
  801.   Debug file /var/log/uucp/debug
  802.   Global debugging level
  803.   uucico -l will strip login names and passwords
  804.   uucico will strip UUCP protocol commands
  805.   Start uuxqt once per uucico invocation
  806.  
  807.   System: polux
  808.    When called using any login name
  809.    Call out using port ACU
  810.    The possible ports are:
  811.     Port name ACU
  812.      Port type modem
  813.      Device /dev/ttyS0
  814.      Speed 57600
  815.      Carrier available
  816.      Hardware flow control available
  817.      Dialer hayes
  818.       Chat script "" ATZ\r\d\c OK\r \dATX4\r\d\c OK\r ATDT\D CONNECT
  819.       Chat script timeout 60
  820.       Chat failure strings RING NO\sCARRIER ERROR NO\sDIALTONE BUSY NO\sANSWER VOICE
  821.       Chat script incoming bytes stripped to seven bits
  822.       Wait for dialtone ,
  823.       Pause while dialing ,
  824.       Carrier available
  825.       Wait 60 seconds for carrier
  826.       When complete chat script "" \d\d+++\d\dATH\r\c
  827.       When complete chat script timeout 60
  828.       When complete chat script incoming bytes stripped to seven bits
  829.       When aborting chat script "" \d\d+++\d\dATH\r\c
  830.       When aborting chat script timeout 60
  831.       When aborting chat script incoming bytes stripped to seven bits
  832.    Phone number 0111111110
  833.    Chat script "" \r\c ogin:-BREAK-ogin:-BREAK- \L word: \P
  834.    Chat script timeout 10
  835.    Chat script incoming bytes stripped to seven bits
  836.    Login name uudan
  837.    Password your_password_here
  838.    At any time may call if any work
  839.    May retry the call up to 26 times
  840.    May make local requests when calling
  841.    May make local requests when called
  842.    May send by local request: /
  843.    May send by remote request: /
  844.    May accept by local request: /var/spool/uucppublic
  845.    May receive by remote request: /var/spool/uucppublic
  846.    May execute /usr/bin/uucp /usr/bin/rmail /usr/bin/rnews
  847.    Execution path /bin /usr/bin /usr/local/bin /usr/sbin
  848.    Will leave 50000 bytes available
  849.    Public directory is /var/spool/uucppublic
  850.    Will use protocols gvG
  851.    For protocol G will use the following parameters
  852.     packet-size 1024
  853.     short-packets
  854.  
  855.  
  856.  
  857.  
  858.  
  859.   to check if all the informations you've set are correct.
  860.  
  861.   Warning: your mileage may vary ; different distributions use different
  862.   paths, regardless Linux FSSTD!
  863.  
  864.   If everything is correct, run:
  865.  
  866.  
  867.  
  868.                /usr/sbin/uucico -r 1 -x 9 -s remote_system_name
  869.  
  870.  
  871.  
  872.  
  873.   The -x 9 will have maximum debugging information written to the
  874.   /var/log/uucp/debug file for help in initial setup.
  875.  
  876.   I normally run -x 4 here since that level logs details that help me
  877.   with login problems.  Obviously, this text contains clear informations
  878.   from your systems file (account/password) so protect it against world-
  879.   read.
  880.  
  881.  
  882.   4.11.  Additional informations
  883.  
  884.  
  885.   >From Pierre.Beyssac at emeraude.syseca.fr
  886.  
  887.   Taylor has more logging levels.  Use -x all to get the highest level
  888.   possible.
  889.  
  890.   Also, do a "tail -f /var/log/uucp/debug" while debugging to watch
  891.   things happen on the fly.
  892.  
  893.  
  894.   5.  It doesn't work - now what?
  895.  
  896.   In general, you can refer to the documentation mentioned above if
  897.   things don't work.
  898.  
  899.   You can also refer to your more experienced UUCP neighbors for help.
  900.   Usually, it's something like a typo anyway.
  901.  
  902.  
  903.   6.  Frequently Asked Questions about Linux UUCP
  904.  
  905.  
  906.  
  907.   6.1.  "HDB" mode?  Why is all the info here for UUCPs configured in
  908.   "Taylor" rather than
  909.  
  910.   (religious mode on - I know some people are just as religious about
  911.   "ease of use" as I am about "being standard".  That's why they make
  912.   source code you can build your own from :-) )
  913.  
  914.   Because IMHO it's the de-facto standard UUCP implementation at this
  915.   time.  There are thousands of sites with experienced admins & there
  916.   are many places you can get incredibly good information concerning the
  917.   HDB setup.
  918.  
  919.   Moreover, if you know what HDB is, you shouldn't be reading this HOWTO
  920.   :-)
  921.  
  922.   Use the uuconv utility in /usr/sbin to convert config files from one
  923.   mode to another.
  924.  
  925.   6.2.  Why do I get "timeout" on connections when I upgraded to
  926.   uucp-1.04?
  927.  
  928.  
  929.   ╖  from Ed Carp - erc at apple.com
  930.  
  931.      If you use a "Direct" device in the Devices file, there's now a 10
  932.      second timeout compiled in.  Make the name of the Device anything
  933.      other than "Direct".  If you tweak the example /etc/uucp files
  934.      provided, you won't have problems with this one.
  935.  
  936.  
  937.   ╖  from Greg Naber - greg at squally.halcyon.com
  938.  
  939.      If you get chat script timeouts, you can tweak the sources by
  940.      editing at line 323 in uuconf/syssub.c & changing the default
  941.      timeouts from 10 seconds to something larger.
  942.  
  943.  
  944.   ╖  from Ed Rodda - ed at orca.wimsey.bc.ca
  945.  
  946.      If you get chat script timeouts, typically connecting to other
  947.      Taylor sites, a pause after login can fix this.
  948.  
  949.      feed Any ACU,ag 38400 5551212 ogin: \c\d "" yourname word: passwd
  950.  
  951.  
  952.  
  953.   ╖  from Dr. Eberhard W. Lisse - el at lisse.NA
  954.  
  955.      Some kernels experience modems hanging up after a couple of
  956.      seconds.  The following patch sent by Ian Taylor might help.
  957.  
  958.  
  959.        *** conn.c.orig Mon Feb 22 20:25:24 1993
  960.        --- conn.c      Mon Feb 22 20:33:10 1993
  961.        ***************
  962.        *** 204,209 ****
  963.        --- 204,212 ----
  964.  
  965.             /* Make sure any signal reporting has been done before we set
  966.               fLog_sighup back to TRUE.  */
  967.        +   /* SMR: it seems to me if we don't care about SIGHUPS, we should clear
  968.        +      the flag before we return  */
  969.        +   afSignal[INDEXSIG_SIGHUP] = FALSE;
  970.            ulog (LOG_ERROR, (const char *) NULL);
  971.            fLog_sighup = TRUE;
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.   6.3.  Why doesn't HDB anonymous uucp seem to work?
  979.  
  980.   Taylor in HDB mode seems to be sensitive to white space & blank lines.
  981.   To be safe, make sure that there are no blank lines or trailing spaces
  982.   in the Permissions file.
  983.  
  984.   Lastly, make sure that you have a file called remote.unknown in
  985.   /usr/lib/uucp or /etc/uucp & that it's *NOT* executable.
  986.  
  987.   See the O'Reilly & Associates book "Managing UUCP & USENET" for
  988.   details regarding this file.
  989.  
  990.  
  991.   6.4.  What does "no matching ports found" mean?
  992.  
  993.   In all probability, you are attempting to use a dialer that doesn't
  994.   exist, or the dialer you've specified in the port files doesn't match
  995.   up with any valid devices in the dial file.
  996.  
  997.  
  998.   6.5.  What are known good config files for HDB mode?
  999.  
  1000.   The following are "known-good" config files for Taylor 1.05 under
  1001.   Linux in HoneyDanBer mode.  They work on kernels of 0.99-8 or later.
  1002.   All files should be in /usr/lib/uucp or /etc/uucp unless you've
  1003.   tweaked the sources to put the uucp library elsewhere.
  1004.  
  1005.   If you *HAVE* put things in non-standard places, be aware that things
  1006.   like sendmail might get very confused. You need to ensure that all
  1007.   communications-related programs agree on your idea of "standard"
  1008.   paths.
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.   #------------- Devices -------------
  1058.   # make sure the device (cua1 here) matches your system
  1059.   # cua N = COM N+1
  1060.   #
  1061.   # here "scout" is the Digicom Scout Plus 19.2 modem I use
  1062.   # tbfast etc. is for a Telebit Trailblazer Plus modem's various speeds
  1063.   #
  1064.   ACU cua1 - 19200 scout
  1065.   ACU cua1 - 9600 tbfast
  1066.   ACU cua1 - 1200 tbslow
  1067.   ACU cua1 - 2400 tbmed
  1068.  
  1069.   #------------- dialers --------------
  1070.   # note the setting of the Trailblazer registers "on the fly"
  1071.   # "scout" is a Digicom Scout Plus (Hayes-like) modem I use here
  1072.   #
  1073.   scout   =W-,    "" ATM0DT\T CONNECT
  1074.   tbfast  =W-,    "" A\pA\pA\pT OK ATS50=255DT\T CONNECT\sFAST
  1075.   tbslow  =W-,    "" A\pA\pA\pT OK ATS50=2DT\T CONNECT\s1200
  1076.   tbmed   =W-,    "" A\pA\pA\pT OK ATS50=3DT\T CONNECT\s2400
  1077.  
  1078.   #-------------- Systems -------------
  1079.   # this is a very generic entry that will work for most systems
  1080.   #
  1081.   # the Any;1 means that you can call once per minute with using -f (force)
  1082.   # the ACU,g means force "g" protocol rather than Taylor's default "i"
  1083.   #
  1084.   fredsys Any;1 ACU,g 19200 scout5555555 "" \r ogin:--ogin: uanon word: uanon
  1085.  
  1086.   #-------------------------------- Permissions -------------------------
  1087.  
  1088.   # Taylor UUCP in HDB mode appears to be sensitive to blank lines.
  1089.   # Make sure all Permissions lines are real or commented out.
  1090.   #
  1091.   # this is a anonymous uucp entry
  1092.   #
  1093.   LOGNAME=nuucp MACHINE=OTHER \
  1094.   READ=/var/spool/uucp/nuucp \
  1095.   WRITE=/var/spool/uucp/nuucp \
  1096.   SENDFILES=yes REQUEST=yes \
  1097.   COMMANDS=/bin/rmail
  1098.   # # this is a normal setup for a remote system that talks to us
  1099.   # note the absolute path to rnews since this site puts things
  1100.   # in locations that aren't "standard"
  1101.   #
  1102.   LOGNAME=fredsys MACHINE=fredsys \
  1103.   READ=/var/spool/uucp/fredsys:/var/spool/uucp/uucppublic:/files \
  1104.   WRITE=/var/spool/uucp/fredsys:/var/spool/uucppublic \
  1105.   SENDFILES=yes REQUEST=yes \
  1106.   COMMANDS=/bin/rmail:/usr/bin/rnews
  1107.   #----------------------------------------------------------------------
  1108.  
  1109.  
  1110.  
  1111.   6.6.  Getting uucico to call alternate numbers
  1112.  
  1113.   The new v1.05 has an added '-z' switch to uucico that will try
  1114.   alternate numbers for a remote system.
  1115.  
  1116.   You can else use Taylor mode & "systemyouarecalling-2" (see "sys" in
  1117.   config.  files section for more details)
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.   7.  Acknowledgements
  1124.  
  1125.  
  1126.   The following people have helped in the assembly of the information &
  1127.   experience that helped make this document possible:
  1128.  
  1129.   Ed Carp, Steve Robbins, Ian Taylor, Greg Naber, Matt Welsh, Pierre
  1130.   Beyssac & especially many thanks to Vince Skahan for his huge
  1131.   contribution.
  1132.  
  1133.   If I forgot anybody, my apologies: just email me.
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.