term% cat index.txt 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 iden‐
tity of the host computer originating the call, and the effective
userid of the process making the request. If successful, the file de‐
scriptor 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 parameters 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 con‐
troller 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 message stored in
dkerror.
TDKDIAL(3X)