home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / uucp / wUUCP_0.0.23.lha / man / uucico.man < prev    next >
Encoding:
Text File  |  1993-02-18  |  16.1 KB  |  463 lines
  1.  
  2.  
  3.  
  4. UUCICO(1)                     wUUCP                     UUCICO(1)
  5.  
  6.  
  7. ¢1mNAME¢22m
  8.        uucico - core of the UUCP protocol
  9.  
  10. ¢1mSYNOPSIS¢22m
  11.        ¢1muucico¢22m  ¢1m-N¢22mhostname  ¢1m-D¢22m[¢1mEVICE¢22m] device ¢1m-U¢22m[¢1mNIT¢22m] unit ¢1m-ACU¢22m acu
  12.        ¢1m-Getty¢22m ¢1m-w¢22m ¢1m-r¢22mx ¢1m-x¢22mn ¢1m-X¢22mn ¢1m-xx¢22m ¢1m-h0¢22m ¢1m-o¢22m ¢1m-¢22m[¢1ms¢22m/¢1mS¢22m]system ¢1m-e¢22m ¢1m-s¢22m ¢1m-7¢22m ¢1m-p¢22m#
  13.        ¢1m-pri¢22m ¢1m-d0¢22m ¢1m-t¢22mtimeout ¢1m-T¢22mtimeout
  14.  
  15.  
  16. ¢1mDESCRIPTION¢22m
  17.        ¢4mUucico¢24m  is the basis for ¢4muucp¢24m. It can be run either from a
  18.        ¢4mgetty¢24m when somebody logs into the Amiga, or it can be  run
  19.        from ¢4mdcron¢24m or manually to originate connections.
  20.  
  21.        Some  options to ¢4muucico¢24m are now outdated and should not be
  22.        used. Specifically, earlier distributions did not  have  a
  23.        ¢4mgetty¢24m  and ¢4muucico¢24m had to deal with waiting for connections
  24.        itself.
  25.  
  26.        Either way, the final result is a connection between  your
  27.        machine  and some remote machine. ¢4muucico¢24m will retrieve any
  28.        queued work on the remote machine and send any queued work
  29.        on your machine. These work files are located in subdirec¡
  30.        tories of ¢1muuspool:¢22m, one directory for each system we regu¡
  31.        lary  connect to.  The names of these directories ¢1mmust¢22m ¢1mnot¢22m
  32.        exceed 7 characters in length, e. g. system ''straylight''
  33.        has  the directory ¢1muuspool:strayli¢22m.  If there is no subdi¡
  34.        rectory for a connected system, it's files are stored  and
  35.        searched for in ¢1muuspool:¢22m.
  36.  
  37.        The  term 'work' refers to items queued by other programs,
  38.        such as ¢4mnews¢24m and ¢4mmail¢24m.  These  programs  create  files  in
  39.        (subdirectories of) ¢1muuspool:¢22m that inform ¢4muucico¢24m what to do
  40.        with them and where to send them to.  On  the  flip  side,
  41.        when  ¢4muucico¢24m  receives a work file it will write it to the
  42.        appropriate place in or below ¢1muuspool:¢22m, then run ¢4muuxqt¢24m for
  43.        that system.
  44.  
  45.        ¢4muuxqt¢24m  scans  received  files  and determines how to break
  46.        them up (for example, append them to the appropriate  mail
  47.        box  or  news  directory).  The control files in ¢1muuspool:*¢22m
  48.        contain a line indicating the appropriate program required
  49.        to  unpack  the files.  ¢4muuxqt¢24m reads this line and runs the
  50.        proper unpacker (¢4mrmail¢24m, ¢4mrnews¢24m, ...).
  51.  
  52.  
  53. ¢1mCONFIGURATION¢22m ¢1mOPTIONS¢22m
  54.        You can control  ¢4muucico¢24m's  run¡time  behaviour  with  some
  55.        variables (specify them in ¢1muulib:Config¢22m).
  56.  
  57.           ¢1mCopyNotify¢22m 31
  58.                       let's you have ¢4muucico¢24m send you mail on sev¡
  59.                       eral events. The value is  bit¡mapped  with
  60.                       this Bitmask:
  61.  
  62.  
  63.  
  64. Villa Straylight Thu, 18 Feb 1993 07:45:33 +0100                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. UUCICO(1)                     wUUCP                     UUCICO(1)
  71.  
  72.  
  73.                   1  ¡  notify  of send failures that will not be
  74.                       retried (ie denied)
  75.                   2 ¡  notify  of  send  failures  that  will  be
  76.                       retried (ie protocol errors)
  77.                   4  ¡  notify  of successfull outgoing file copy
  78.                       (uucp'd copies only)
  79.                   8 ¡ notify of incoming file (uucp'd file copies
  80.                       only)
  81.                  16 ¡ notify of incoming failure of anykind
  82.  
  83.                       Thus,  to  get an email notification of any
  84.                       failures, use  16  or  19,  for  report  on
  85.                       incoming  and outgoing uucp'd files 12, set
  86.                       to 31 for all features.
  87.                       Mail is sent to ¢1mNotifyUser¢22m (see below),  if
  88.                       unset ¢1mpostmaster¢22m.
  89.  
  90.           ¢1mNotifyUser¢22m uucp
  91.                       sets  the  user  to  be bothered with mails
  92.                       created due to the  ¢1mCopyNotify¢22m  entry  (see
  93.                       above) to ¢1muucp¢22m. Default (if unset) is ¢1mpost¡¢22m
  94.                       ¢1mmaster¢22m.
  95.  
  96.           ¢1mUuxqtInterval¢22m 4
  97.                       causes a start of ¢4muuxqt¢24m in  the  background
  98.                       after  every  4th incoming file with a name
  99.                       starting with ¢1mX.¢22m*.
  100.  
  101.           ¢1mUUlogs¢22m xferstat
  102.                       controls which  logfiles  should  be  main¡
  103.                       tained; currently defined are ¢1mxferstat¢22m (for
  104.                       the ¢4mSoftware¢24m ¢4mBrewery¢24m's xferstat  file)  and
  105.                       ¢1mtimelog¢22m  (old  style DUUCP timelog, compare
  106.                       below). If absent, all logs are maintained.
  107.                       ¢1mNOTE¢22m that the values ARE case sensitive (i.
  108.                       e. ¢1mTimeLog¢22m is NOT recognised).
  109.  
  110.  
  111. ¢1mLOCKING¢22m
  112.        ¢4mUucico¢24m locks the serial port  in  the  same  manner  Getty
  113.        does,  but  doing the equivalent of the ¢4mlockserial¢24m command
  114.        before openning it. Thus, uucico's will  never  bump  into
  115.        each  other  on  the  port.  Any  terminal program you run
  116.        should lock the serial port as well. This is done by  run¡
  117.        ning  the  terminal program via ¢4mlockserial¢24m with the appro¡
  118.        priate arguments, see the manual pages for ¢4mgetty¢24m and ¢4mlock¡¢24m
  119.        ¢4mserial¢24m  for  more information (nowadays, a lot of terminal
  120.        programs support the ¢1mOwnDevUnit.library¢22m,  if  yours  does,
  121.        you don't need to use ¢4mlockserial¢24m).
  122.  
  123.  
  124. ¢1mGENERAL¢22m ¢1mOPTIONS¢22m
  125.        Options  marked with ╣ are supplied automatically on Getty
  126.        initiated connections.
  127.  
  128.  
  129.  
  130. Villa Straylight Thu, 18 Feb 1993 07:45:33 +0100                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. UUCICO(1)                     wUUCP                     UUCICO(1)
  137.  
  138.  
  139.           ¡¢1mD¢22m dev ╣
  140.                       Use device ¢4mdev¢24m;  default  is  ¢1mserial.device¢22m
  141.                       (space is required)
  142.  
  143.           ¡¢1mU¢22m unit ╣
  144.                       Use device's unit ¢4munit¢24m, default is ¢1m0¢22m (space
  145.                       is optional).
  146.  
  147.           ¡¢1mACU¢22m acu
  148.                       Call only entries with matching  ¢4mACU¢24m;  this
  149.                       may  be  used to differentiate between dif¡
  150.                       ferent devices ... Let's say you  have  the
  151.                       following ¢1mL.sys¢22m entries:
  152.  
  153.       imart Any isdn  64000 ATD555¡47120 ogin: bla word: fasel
  154.       imart Any isdn  64000 ATD555¡47121 ogin: bla word: fasel
  155.       imart Any ser2  57600 ATD555¡0815 ogin: bla word: fasel
  156.       imart Any ser   38400 ATD555¡4711 ogin: bla word: fasel
  157.  
  158.                       If  you ommit the ¢4m¡ACU¢24m switch, ¢4muucico¢24m would
  159.                       dial all entries with given ¢4mdevice¢24m and ¢4munit¢24m
  160.                       settings; usually this would result in much
  161.                       nonsense,  as  you  may  use  e.   g.   the
  162.                       ¢1misdn.device¢22m to call non¡ISDN ports, but you
  163.                       can't connect to the analouge modem  there.
  164.                       Vice  versa,  calling  an ISDN port from an
  165.                       analouge modem  doesn't  work.   Temporary,
  166.                       you can use the ¢4m¡ACU¢24m switch to filter ¢1mL.sys¢22m
  167.                       entries, i. e. ¢1muucico¢22m ¢1m¡simart¢22m ¢1m¡7¢22m ¢1m¡ACU¢22m  ¢1misdn¢22m
  168.                       ¢1m¡D¢22m  ¢1misdn.device¢22m ¢1m¡U¢22m ¢1m0¢22m ¢1m¡P7¢22m would force ¢4muucico¢24m
  169.                       only to dial the  first  two  entries  (the
  170.                       ones  with  an  ACU  of  ¢1misdn¢22m) and skip the
  171.                       remaing two.
  172.  
  173.                       I'm working on a separate file in which you
  174.                       can  specify which device/unit to use for a
  175.                       given ACU ...
  176.  
  177.           ¡¢1mx¢22mn
  178.                       Set log level for us and for remote  system
  179.                       to ¢4mn¢24m.
  180.  
  181.           ¡¢1mX¢22mn
  182.                       Set log level but do not tell remote system
  183.                       about it.
  184.  
  185.           ¡¢1mxx¢22m
  186.                       Debug handshake to  stdout  (but  not  once
  187.                       connection  is  established).   Useful  for
  188.                       debugging L.Sys send¡expect stuff.
  189.  
  190.           ¡¢1mh0¢22m
  191.                       Ignore Carrier Detect.
  192.  
  193.  
  194.  
  195.  
  196. Villa Straylight Thu, 18 Feb 1993 07:45:33 +0100                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. UUCICO(1)                     wUUCP                     UUCICO(1)
  203.  
  204.  
  205.           ¡¢1mb¢22m
  206.                       Run ¢4mbatchnews¢24m before anything else.
  207.  
  208.           ¡¢1m7¢22m
  209.                       Set ¢1m7WIRE¢22m mode for serial  connections  (i.
  210.                       e. hardware handshaking).
  211.  
  212.           ¡¢1mproto¢22m n
  213.                       Set  `protocol  hack' flag to ¢4mn¢24m (0..9); not
  214.                       well documented, better leave it alone  ...
  215.  
  216.           ¡¢1mp¢22mprotos
  217.                       Set  list  of  protocols,  defaults to ¢4mGqg¢24m.
  218.                       ¢4muucico¢24m will choose the first common both in
  219.                       orginate and answer mode.
  220.  
  221.           ¡¢1mpri¢22m
  222.                       ¢4muucico¢24m  ups its priority by 1 during trans¡
  223.                       fer, then downs it by 1 to run ¢4muuxqt¢24m  (i.e.
  224.                       +1 during transer, ¡1 for ¢4muuxqt¢24m).
  225.  
  226.           ¡¢1md0¢22m
  227.                       IGNORE  DTR switch forces ¢4muucico¢24m to use the
  228.                       +++ sequence to disconnect instead of drop¡
  229.                       ping DTR. This is a workaround for a possi¡
  230.                       ble bug in the serial device for those  who
  231.                       experience  crashes  when  ¢4muucico¢24m  tries to
  232.                       disconnect.
  233.  
  234.           ¡¢1mn¢22mwindows
  235.                       Set protocol window size.  If ¢4msize¢24m  is  not
  236.                       specified,  a  window  size of 1 is forced.
  237.                       The default (¡n option not specified) it  a
  238.                       window size of 7.
  239.                       Sometimes  it  is  necessary  to reduce the
  240.                       window size to 3 or 4  when  connecting  to
  241.                       heavily loaded UNIX systems.
  242.  
  243.           ¡¢1mt¢22mtimeout
  244.                       Set  GIO  protocol  timeout  before  packet
  245.                       retry.  Default is 5. In  many  cases  this
  246.                       can  cause  long  no¡activity delays due to
  247.                       small glitches when, in fact, the receiving
  248.                       host  is not loaded down. Setting the time¡
  249.                       out to 1 generally fixes this.
  250.  
  251.           ¡¢1mT¢22mtimeout
  252.                       Set  timeout   for   send¡expect   strings,
  253.                       default is 15 seconds.
  254.  
  255.           ¡¢1mP¢22msegsize
  256.                       Set  segment size, in powers of two where a
  257.                       segment size of 2 == 64 bytes. The  maximum
  258.                       segment size is 8 (4096 bytes).
  259.  
  260.  
  261.  
  262. Villa Straylight Thu, 18 Feb 1993 07:45:33 +0100                4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. UUCICO(1)                     wUUCP                     UUCICO(1)
  269.  
  270.  
  271.                       This  option should be used only by ¢1mEXPERI¡¢22m
  272.                       ¢1mENCED¢22m ¢1mUUCP¢22m ¢1musers¢22m.  Larger is not  necessar¡
  273.                       ily  better  since  all  packets  are fixed
  274.                       length.
  275.  
  276.           ¡¢1mN¢22mhostname
  277.                       Sets  the  ¢4mhostname¢24m  for  this  invocation;
  278.                       overrules  the  config  variable  ¢4mNodeName¢24m.
  279.                       ¢1mUSE¢22m ¢1mWITH¢22m ¢1mCARE!¢22m
  280.  
  281.           ¡¢1mG¢22mg
  282.                       Set the grade to ¢4mg¢24m; our  ¢4muucico¢24m  will  only
  283.                       transmit  jobs with a grade character lower
  284.                       (based on ASCII order) or equal to  ¢4mg¢24m;  the
  285.                       remote  ¢4muucico¢24m may or may not support this.
  286.                       Newsbatches usually (should) have  a  grade
  287.                       of ''N'', thus specifying ''¡GM'' makes our
  288.                       ¢4muucico¢24m transmit only jobs with grade  char¡
  289.                       acters '' '' to ''M''.  The grade character
  290.                       is the one following the, possibly abbrevi¡
  291.                       ated,  system  name in command files (e. g.
  292.                       in ''C.hactarB0815'' is ''B''  the  grade).
  293.                       Refer  to  the  ¢1muux¢22m  man  page  for further
  294.                       information.
  295.  
  296.  
  297. ¢1mGETTY¢22m ¢1mINITIATED¢22m ¢1mOPTIONS¢22m
  298.           ¡¢1mGetty¢22m ╣
  299.                       Tells ¢4muucico¢24m that it  was  started  from  a
  300.                       ¢4mgetty¢24m.
  301.  
  302.  
  303. ¢1mMANUAL¢22m ¢1mPOLL¢22m ¢1mOPTIONS¢22m
  304.           ¡¢1ms¢22msystem
  305.                       Poll (call¡up) the specified system.
  306.  
  307.           ¡¢1mS¢22msystem
  308.                       Same as ¡s but ignore time restrictions.
  309.  
  310.           ¡¢1mr1¢22m
  311.                       Call  all systems we have pending work for.
  312.  
  313.           ¡¢1mr1¢22m ¡¢1ms¢22msystem
  314.                       Call this specific system if we have  pend¡
  315.                       ing work.
  316.  
  317.           ¡¢1mo¢22m
  318.                       Tells  ¢4muucico¢24m  to  not search for a CONNECT
  319.                       message when carrier is detected (hardwired
  320.                       configuration).
  321.  
  322.  
  323. ¢1mOBSOLETE¢22m ¢1mOPTIONS/WAIT¢22m ¢1mMODE¢22m ¢1mOPTIONS,¢22m ¢1mdo¢22m ¢1mnot¢22m ¢1muse¢22m ¢1mif¢22m ¢1myou¢22m ¢1mcan¢22m ¢1mhelp¢22m ¢1mit¢22m
  324.           ¡¢1mw¢22m
  325.  
  326.  
  327.  
  328. Villa Straylight Thu, 18 Feb 1993 07:45:33 +0100                5
  329.  
  330.  
  331.  
  332.  
  333.  
  334. UUCICO(1)                     wUUCP                     UUCICO(1)
  335.  
  336.  
  337.                       Tells ¢4muucico¢24m to wait for one or  more  con¡
  338.                       nections  (depending  on  ¡e)  AFTER having
  339.                       previously polled one or more systems  (¢4m¡r¢24m,
  340.                       ¢4m¡s¢24m, ¢4m¡S¢24m).
  341.  
  342.           ¡¢1me¢22m
  343.                       Tells  ¢4muucico¢24m  to  loop forever waiting for
  344.                       connections.
  345.  
  346.           ¢1mnooptions¢22m
  347.                       If ¢4muucico¢24m is run without either ¢4m¡Getty¢24m, ¢4m¡s¢24m,
  348.                       or  ¢4m¡r¢24m,  it  will wait for a single connec¡
  349.                       tion.
  350.  
  351.  
  352. ¢1mTIMELOG¢22m ¢1mFORMAT¢22m
  353.        ¢1mUucico¢22m automatically appends an entry  to  ¢4mUUSPOOL:TimeLog¢24m
  354.        (if  config variable ¢1muulogs¢22m contains the word ''timelog'';
  355.        note that case IS significant) in the following format:
  356.  
  357.        dd¡mmm¡yy mm:ss mm:ss in=nnnnn out=nnnnn <system_name>
  358.  
  359.        The date, then two on¡line times.  The first is  the  con¡
  360.        nect  time from carrier detect, the second is connect time
  361.        from send¡expect success.  Use whichever one is  appropri¡
  362.        ate  for  bill calculations.  Following that is the number
  363.        of data bytes received (total of received file sizes)  and
  364.        the  number  of data bytes sent (total of transmitted file
  365.        sizes).  These numbers do not reflect additional  overhead
  366.        used  by  the G protocol (messages, acks, packet overhead,
  367.        or retries).
  368.  
  369.  
  370. ¢1mEXAMPLE¢22m
  371.        ; Place a line similar to this in your startup¡sequence!
  372.        ; See GETTY manual
  373.  
  374.        resident uucp:C/Getty
  375.        run <nil: >nil: Getty ¡A ¡B19200 ¡Mm
  376.                               ¡¡¡¡¡
  377.        ; Manually poll system 'foo'
  378.        UUCico ¡sfoo
  379.                               ¡¡¡¡¡
  380.        ; From DCRON  (DCRON ENTRY)
  381.        40      1       *       *       *       uucp:c/uucico ¡r1
  382.  
  383.  
  384. ¢1mFILES/REQUIRES¢22m
  385.        UULIB:Config
  386.        UUMAIL:
  387.        UUSPOOL:remote_systems/
  388.        UUSPOOL:logfile
  389.        UUSPOOL:xferstat
  390.        UUSPOOL:TimeLog
  391.  
  392.  
  393.  
  394. Villa Straylight Thu, 18 Feb 1993 07:45:33 +0100                6
  395.  
  396.  
  397.  
  398.  
  399.  
  400. UUCICO(1)                     wUUCP                     UUCICO(1)
  401.  
  402.  
  403. ¢1mACKNOWLEDGEMENTS¢22m
  404.        I  owe  a  lot   to   ¢1mMichael¢22m   ¢1m`Mick'¢22m   ¢1mHohmann¢22m   (EMail:
  405.        <mickh@imart.franken.de>)  for  all  his patience, support
  406.        and feedback while testing all the buggy alpha versions. I
  407.        have to express my gratitude to cbmger, causing me several
  408.        sleepless nights trying to find a malicious bug only show¡
  409.        ing up when this site tried to connect =:¡>
  410.  
  411.  
  412. ¢1mREFERENCES¢22m
  413.        man/L.Sys
  414.        man/Getty
  415.        man/DCron
  416.        man/Assigns
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460. Villa Straylight Thu, 18 Feb 1993 07:45:33 +0100                7
  461.  
  462.  
  463.