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.