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.