home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / comms / network / amigauuc.lha / AmigaUUCP / man / LockSerial < prev    next >
Text File  |  1992-05-06  |  2KB  |  74 lines
  1.  
  2. NAME
  3.     LockSerial    - SERIAL PORT ACCESS CONTROL FOR NON-UUCP PROGRAMS
  4.  
  5. SYNOPSIS
  6.     LockSerial [-D device] [-U unit] [-A] "command"
  7.  
  8. DESCRIPTION
  9.     LockSerial is used to run programs (e.g. terminal programs)
  10.     after ensuring that a given serial port and unit is free.  It
  11.     locks the port, runs the program, then unlocks the port.  The
  12.     "command" argument should NOT run things in the background,
  13.     since the port will be unlocked too early.  You can RUN the
  14.     lockserial command itself, if you wish.
  15.  
  16.     Getty need not be running, but if it is it will maintain a
  17.     port lock.  When getty sees the lock request it will close
  18.     the device and relinquish control to the requesting program.
  19.  
  20.     UUCico runs LockSerialPort()/UnLockSerialPort() internally,
  21.     DO NOT RUN UUCICO WITH THIS COMMAND.
  22.  
  23.     This change was made because the hacks in Getty to track individual
  24.     units within a serial device were broken and had to be removed.
  25.     This also allows getty to close its reference on the device before
  26.     another program opens it, thereby avoiding some well known bugs
  27.     in the A2232 serial device.
  28.  
  29.  
  30. TECH NOTES
  31.     There are two AmigaUUCP locks (LockFile() and UnLockFile() type)
  32.     associated with obtaining a serial port.  Here is an example for
  33.     the serial.device, unit 0:
  34.  
  35.         P.serial.device.0
  36.         R.serial.device.0
  37.  
  38.     LockSerial first obtains the R. lock, then the P. lock.  After
  39.     obtaining the P. lock it immediately releases the R. lock, then
  40.     runs the program in question.  When the program is through,
  41.     it releases the P. lock.
  42.  
  43.     Getty monitors the R. lock to determine if another program (UUCico
  44.     or LockSerial) wishes to gain the serial port.    When this returns
  45.     true Getty will release the P. lock and loop until the R. lock is
  46.     released, then attempt to get the P. lock again.
  47.  
  48. WARNING
  49.     You cannot run auto-detach programs with LockSerial.  Such programs
  50.     will detach from the CLI and appear to have exited, causing
  51.     LockSerial to give Getty the serial port back.
  52.  
  53.     LockSerial utilizes the OwnDevUnit.Library.  Programs that directly
  54.     support this library do not need to be run with the LockSerial
  55.     program.
  56.  
  57. OPTIONS
  58.     -D device    The serial device, default serial.device
  59.  
  60.     -U unit     The unit number, default 0
  61.  
  62.     -A        Do not lock up waiting for access if someone else
  63.             has currently got the device locked.
  64.  
  65.     Command     The command to run (if the command takes args,
  66.             the entire thing should be in quotes)
  67.  
  68. EXAMPLE
  69.     1> LockSerial -U2 "XBBS UNIT 2"
  70.  
  71. REFERENCES
  72.     Getty
  73.  
  74.