TDKDIAL(3X) TDKDIAL(3X) NAME dkdial, dkerror - open a datakit connection to a remote server SYNOPSIS #include <dk.h> tdkdial(srvname, traffic) char *srvname; extern char *dkerror; DESCRIPTION These routines are loaded by option -ldk of ld(1). Tdkdial opens an available datakit channel, and attempts to connect it to the named server. The server is told the srvname string, the identity of the host computer originat- ing the call, and the effective userid of the process making the request. If successful, the file descriptor of the open circuit is returned. Traffic type tells the network the characteristics of the intended traffic on this circuit. Current defined values are 0 for terminal-like traffic, and 2 for high-speed host- host traffic. Srvname consists of a required network destination name, optionally followed by a period and some arbitrary parame- ters for the server being called. A general destination name has three components, separated by slashes. The first is an area code (e.g. mh) the second is a controller node in that area (e.g. astro) the last is a service offered in that node. A standard service offered by each machine attached to a node is remote login, and the service name is the same as the machine name (e.g. research). The additional information is of limited length, and should only be used to inform the server what type of session is desired and what higher level protocol should be used to exchange further information. FILES /dev/dk directory containing files naming each channel SEE ALSO dkmgr(3) DIAGNOSTICS Value -1 returned on error, and pointer to diagnostic TDKDIAL(3X) TDKDIAL(3X) message stored in dkerror.