home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / telecom / uucp_442 / uucp2.lzh / uucp2 / man / Getty < prev    next >
Text File  |  1991-01-06  |  8KB  |  243 lines
  1.  
  2. NAME
  3.     Getty
  4.  
  5. SYNOPSIS
  6.     Getty -Sserialname -Uunit -Bbaud -Bbaud.. -Mc
  7.           -m1 -r0 -h0 -c0 -d0 -xn -A -7 -0 [modem-cmds]
  8.  
  9. FLASH!
  10.     Getty now works with multi-serial ports.  It now does strict
  11.     access control over the serial port.  UUCico no longer does
  12.     access control over the serial port (i.e. the function has been
  13.     moved into Getty)
  14.  
  15. DESCRIPTION
  16.     Getty hangs on the specified serial port (serial.device unit 0 by
  17.     default) waiting for connections via the connected modem.  Once
  18.     a connection is accepted Getty adjusts to the proper baud rate
  19.     using the CONNECT message, -B, -A options, then provides a
  20.     Login: request to the caller.
  21.  
  22.     NOTE: A CONNECT message from the modem with no baud rate specified
  23.     will cause Getty to use the first baud rate in the -B list.  If
  24.     the -A option is specified, Getty *always* uses the first baud
  25.     rate in the -B list and never switches to any other baud rate.
  26.  
  27.     If the caller sends a line-break Getty will switch to the next
  28.     baud rate in the specified list.  During the initialization phase
  29.     of the modem (before the first call and after a disconnect), Getty
  30.     readjusts the baud rate to the first specified rate.
  31.  
  32.     Getty disconnects any caller who cannot provide a legal Login and
  33.     Password within 60 seconds.
  34.  
  35.     Upon receiving a legal Login and and Password, verified via
  36.     GETTY:PASSWD, Getty will execute the program specified in
  37.     GETTY:PASSWD, usually UUCICO, and stay off the line until
  38.     UUCICO returns.  When UUCICO returns, Getty will disconnect
  39.     the caller and reset the modem, returning to its original state.
  40.  
  41.     The file GETTY:Getty-Header contains a couple lines of text
  42.     that are sent over the serial port before the Login: request.
  43.     In it you normally have your machine type, name, etc...
  44.  
  45.     Getty runs the specified program in the password entry adding
  46.     the following arguments:
  47.  
  48.         -Getty -DEVICE devicename -UNIT unitnumber
  49.  
  50.     (uucico will recognize said arguments and not attempt to
  51.      initialize / waitfor calls / hangup the modem itself)
  52.  
  53.     Getty also recognizes when other amiga programs open the
  54.     serial.device it is waiting on and will get off the line for
  55.     the duration of the other program's connect (i.e. you can run
  56.     terminal programs without having to BREAK Getty).
  57.  
  58.     NOTE 1:     Getty can only get off the line when it is idle,
  59.             waiting for carrier.  UUCP related programs will
  60.             also use a separate locking mechanism to properly
  61.             talk to Getty under other circumstances.
  62.  
  63.     NOTE 2:     Getty will attempt a disconnect sequence when it
  64.             reestablishes control after the other program
  65.             closes the serial.device .    Getty checks the
  66.             device count once a second.
  67.  
  68. TECH NOTES
  69.     Due to the fact that Getty intercepts the LIB_OPEN and LIB_CLOSE
  70.     device vectors, it cannot be made RESIDENT.
  71.  
  72.     If you run multiple Getty's on the same device, you should kill
  73.     them in reverse order.    If you do not, the getty's in question will
  74.     refuse to exit until able to (they must unwind the vector
  75.     intercepts in reverse order).  No crash will occur, but you might
  76.     get some strange log messages.
  77.  
  78.     Getty strictly enforces access over the serial port and unit it is
  79.     running on.  Only ONE application is allowed to override Getty.
  80.     If a second application is run while the first application is
  81.     running, the second's OpenDevice() call will fail.  These rules
  82.     apply regardless to whether the applications use the SERF_SHARED
  83.     flag or not.
  84.  
  85. OPTIONS
  86.     -Sserialname        Specify serial device, default "serial.device"
  87.  
  88.     -Uunit            Specify unit number, default 0
  89.  
  90.     -Bbaud            Specify up to 32 baud rates
  91.  
  92.     -A            Specify modem will adjust to a single baud
  93.                 rate (locks the serial.device at the first
  94.                 baud rate in the -B list)
  95.  
  96.     -7            Use SERF_7WIRE protocol while online,
  97.                 else uses no protocol while online.  If
  98.                 you are using a modem with speed conversion
  99.                 you need this option or you will most likely
  100.                 overflow the modem's buffer!
  101.  
  102.     -Mc            Select Modem type,
  103.  
  104.                 c = m   Multimodem
  105.                 h   Hays
  106.                 d   Dumb  (no AT or +++ commands are
  107.                        sent to the modem ever).
  108.  
  109.     -mn            Set modem speaker level, default 0.
  110.                 (ATMn command)
  111.  
  112.     -rn            Set modem to answer on the Nth ring
  113.                 (modem must support ATMn).  0 disables
  114.                 answer capability.    The default is to
  115.                 answer on the second ring.
  116.  
  117.     -h0            Ignore CD (carrier detect).  If this option
  118.                 is specified a continuous carrier detect is
  119.                 assumed, causing Getty to request Login:'s
  120.                 over the line as soon as it receives a CONNECT
  121.                 message.
  122.  
  123.                 It is suggested you ONLY use this option
  124.                 when combined with -c0
  125.  
  126.     -c0            Do NOT look for a CONNECT message from the
  127.                 modem... useful for dumb modems.
  128.  
  129.     -d0            Normally Getty will disconnect by dropping
  130.                 DTR.  If this option is specified, Getty will
  131.                 use the less reliable +++ ATH0 sequence.
  132.  
  133.                 NOTE: If your modem has the capability to LOCK
  134.                 the COMPUTER'S SERIAL PORT baud rate, it is
  135.                 *strongly* suggested that you do this for +++
  136.                 to be reliable.
  137.  
  138.     -xn            Set debugging level to n.  If specified
  139.                 debugging messages are sent to stdout instead
  140.                 of GETTY:LOGFILE
  141.  
  142.                 Note: to avoid GETTY:LOGFILE getting too
  143.                 large for busy systems, you can always add
  144.                 an entry to your crontab to delete it once
  145.                 a week (or whenever), or use 'trimfile' to
  146.                 trim it.
  147.  
  148.     -0            Kill any already-running Getty for this
  149.                 serial port and unit.
  150.  
  151.     modem-cmds        You may specify up to 16 specific commands
  152.                 to be sent to the modem whenever it is
  153.                 initialized (usually after a disconnect
  154.                 and on startup).  Each command will be
  155.                 sent to the modem with a CR on the end and
  156.                 a seconds delay afterwords.  Example:
  157.  
  158.                 ATS2=.
  159.  
  160.                 This is useful for provided specialized
  161.                 modems with the appropriate initialization
  162.                 strings.
  163.  
  164. EXAMPLE
  165.     ;   Run a Getty for a MultiModem
  166.  
  167.     run >nil: <nil: Getty -Mm -A -B19200
  168.  
  169.     ;   Run a Getty for a Hays Modem
  170.  
  171.     run >nil: <nil: Getty -Mh -B1200 -B2400
  172.  
  173.     ;   Run a Getty for a Hays Modem and use +++ instead of DTR to
  174.     ;   hangup.  NOTE, when using -d0 you should lock the serial port
  175.     ;   baud rate (if possible) or +++ may be unreliable as a hangup
  176.     ;   method.
  177.  
  178.     run >nil: <nil: Getty -Mh -B2400 -d0
  179.  
  180.     ;   Modify options to a Getty already running in the background
  181.  
  182.     Getty -m1        ; Set speaker on during dialing
  183.     Getty -m0        ; speaker off at all times.
  184.     Getty -0        ; kill background Getty
  185.  
  186. EXAMPLE CRONTAB ENTRIES
  187.     Assuming a getty has been run in the background from your
  188.     startup sequence, the most common desire is to disable the
  189.     modem speaker while you are asleep, and enable it at other
  190.     times.    The following crontab entry will accomplish this:
  191.  
  192. 0    23    *    *    *    getty -m0
  193. 0    11    *    *    *    getty -m1
  194.  
  195.     You can also kill (getty -0) or restart getty from your
  196.     crontab, though the prefered method is to leave it running
  197.     and only disable/enable the autoanswer (-r option) for those
  198.     times you wish your modem to not accept calls.
  199.  
  200. EXAMPLE HARDWIRED ENTRY
  201.     Lets say you have two amigas connected together via a permanent
  202.     serial line.  To run AmigaUUCP between them you want to run Getty
  203.     on one of them (NOT BOTH!).  On machine A you would run Getty
  204.     as follows:
  205.  
  206.     (Machine A):
  207.  
  208.         run >nil: <nil: Getty -B9600 -Md -h0 -c0
  209.  
  210.     The Passwd entry for the remote machine would be something like:
  211.     (Machine A)
  212.  
  213.         machb,uupc,203,0,(UUCP-NOPAS),ram:,uucico -h0 -o
  214.  
  215.     Machine B would have an L.sys entry that looks like:
  216.  
  217.         macha Any SER: 9600 "" "" \r\r\c ogin: machb sword: uupc
  218.  
  219.     In the above configuration, with Getty running on Machine A, Machine
  220.     B would run uucico (usually every X minutes from dcron) using:
  221.  
  222.         1> uucico -smacha -h0 -o -xx
  223.  
  224.     UNFORTUNATELY, with a permanent serial line you cannot run Getty
  225.     on BOTH machines.  This will cause one Getty to echo the other's
  226.     login message and vise versa, causing an infinite loop.  So only
  227.     one machine can poll.
  228.  
  229. FILES/REQUIRES
  230.     GETTY:PASSWD
  231.     GETTY:Getty-Header
  232.     GETTY:LOGFILE
  233.  
  234.     The NULL: handler must be mounted
  235.     The UUSER: handler must be mounted if Passwd file contains
  236.         *'d executable entries (don't confuse *'d executables
  237.         with using '*' for the password field).
  238.  
  239. REFERENCES
  240.     Getty
  241.     Passwd
  242.  
  243.