.th TcpFind III 4/21/86
.sh "NAME"
TcpFind - find process SEID of a TCP Daemon
.sh "C SYNOPSIS"
.nf
 char        *Dir_Pathname;
 seid        *Daemon_Seid;
 int         stat;
 . . .
 stat = TcpFind (Dir_Pathname, Daemon_Seid);
.fi
.sh "DESCRIPTION"
The TcpFind primitive is used to obtain the process seid of an active
TCP Daemon.  This process seid can then be used for establishing a TCP
connection via the TcpOpen primitive.
.s3
The Dir_Pathname parameter is a pointer to a null-terminated character
string containing the ASCII UNIX directory pathname to be used by this
primitive to obtain the daemon's seid.  This pathname is a well-known
pathname established by the TCP Daemon upon initialization whereby the
seid associated with this pathname is the process seid of the TCP
Daemon.
.s3
If the pathname corresponds to an active TCP Daemon, the second
argument, Daemon_Seid, will be used as an address to store the daemon's
process seid and the primitive will return a successful status
(XtcpOK).  Otherwise, a null_seid will be stored at the address
specified by the Daemon_Seid parameter and will return a negative reply
(XtcpNoX).
.sh "EXCEPTIONS"
TcpFind
returns the following error codes:
.lp 10 0
.nf
XtcpOK    (0)      Successful
XtcpNoX   (3)      Non-existent TCP Daemon
.fi
.i0
.sh "FILES"
.nf
/ksb/include/tcp.h     TCP Interface Definitions for C
/ksb/lib/TCP.a   TCP Interface Library for C
.fi
.sh "SEE ALSO"
TcpOpen (III)

