%NAME: Bruce M. Corwin
%COMP: Bruce M. Corwin
%PROG: Process Control Sub
%CODE: procopen.c register.c
%FUNC: addutmp
This function is used to register an interactive session with the utmp system
file.  It varies between different types of UNIX systems so there are several
different #ifdefs to distinguish between the methods useds.  It stores the
utmp structure in a global varable for delutmp to access in the future.
addutmp and delutmp are not multithreaded compatable routines as a result of
this storage of global information.  This routine stores the time, userid,
ttyline and DISPLAY variable in the utmp structure.
%FUNC: delutmp
This function is used to unregister an interactive session with the utmp system
file.  It is the inverse function to addutmp.  It varies between different
types of UNIX systems so there are several different #ifdefs to distinguish
between the methods useds.  It uses the stored global utmp structure to
remove the utmp entry.
%FUNC: getuser
This function returns the current username as determined
from the real UID.
%FUNC: procopen
This library function is used to open a pseudo keyboard
for interface to an interactive process.  In conjunction
with the script function the UNIX script command can be
written.
%FUNC: program
This system is a new widget called Vt it emulates a VTXXX
DEC style terminal plus many other special GUI type
functions that can make a text based application look like
a full fledged Motif application.
%PARM: argv Input
Arguments passed from UNIX
%PARM: gid Input
GID value
%PARM: path Input
Path to a file.
%PARM: pid Input
Input pid to register.
%PARM: ptyfd Output
PTY file descriptor.
%PARM: retpid Output
Returned process Id for new process.
%PARM: ttyfd Output
TTY file descriptor.
%PARM: ttyxx Input
The tty line to register.
%PARM: uid Input
UID value
%PARM: user Input
Input username to register.
%HIST: addutmp
11-08-91    Bruce M Corwin   Initial Release
%HIST: delutmp
11-08-91    Bruce M Corwin   Initial Release
%HIST: getuser
08-10-93    Bruce M. Corwin  Initial Release
%HIST: procopen
08-30-91    Bruce M. Corwin  Initial Release
09-05-91    Bruce M. Corwin  Corrected search for valid pty
