home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / uucp / duucp-1.17 / AU-117b-man.lha / man / LockSerial < prev    next >
Encoding:
Text File  |  1993-12-29  |  1.7 KB  |  54 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 locks and unlocks the serial port internally to itself,
  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. WARNING
  30.     You cannot run auto-detach programs with LockSerial.  Such programs
  31.     will detach from the CLI and appear to have exited, causing
  32.     LockSerial to give Getty the serial port back.
  33.  
  34.     LockSerial utilizes the OwnDevUnit.Library.  Programs that directly
  35.     support this library do not need to be run with the LockSerial
  36.     program.
  37.  
  38. OPTIONS
  39.     -D device    The serial device, default serial.device
  40.  
  41.     -U unit     The unit number, default 0
  42.  
  43.     -A        Do not lock up waiting for access if someone else
  44.             has currently got the device locked.
  45.  
  46.     Command     The command to run (if the command takes args,
  47.             the entire thing should be in quotes)
  48.  
  49. EXAMPLE
  50.     1> LockSerial -U2 "XBBS UNIT 2"
  51.  
  52. REFERENCES
  53.     UUMan:Getty
  54.