dmnetconnect(3dm)

NAME
     dmNetConnect, dmNetListen, dmNetAccept, dmNetRegisterPool -
     DMNetConnection connection management

SYNOPSIS
     #include <dmedia/dmnet.h>

     DMstatus dmNetConnect(DMNetConnection connection, DMParams* params);

     DMstatus dmNetListen(DMNETConnection connection, DMParams* params);

     DMstatus dmNetAccept(DMNetConnection connection, DMParams* params);

     DMstatus dmNetRegisterPool(DMNetConnection connection, DMbufferpool pool);

DESCRIPTION
     dmNetConnect is the sender side (or server) routine which sets up a
     control connection.  It opens a socket descriptor and tries to connect to
     the specified address.  It calls connect and sets appropriate socket
     options.

     dmNetListen and dmNetAccept are the receiver (client) side calls that set
     up a control connection.  dmNetListen opens a socket descriptor for
     control, sets socket options as appropriate, calls bind to bind the
     control socket to a specified port and calls listen for an incoming
     connect request.  dmNetAccept blocks until a connection is made.

     dmNetRegisterPool registers a pool on the open DMNetConnection.  This is
     mandatory on the receive side (i.e. which calls dmNetAccept) because the
     dmNet library uses this pool to create dmBuffers when receiving data from
     the remote side of the connection.

DIAGNOSTICS
     dmNetListen , dmNetAccept and dmNetConnect return DM_SUCCESS if a
     connection to the remote socket is made and the apropriate socket options
     were set successfully and DM_FAILURE otherwise.

     dmNetListen returns DM_FAILURE and sets errno to EADDRINUSE if it cannot
     bind to the specified port. dmNetListen is idempotent, and can be called
     more than once, to bind to different ports, for instance.  dmNetAccept
     must be called only after dmNetListen returns DM_SUCCESS.

SEE ALSO
     dmBufferCreatePool(3dm), dmParamsCreate(3dm), dmNetOpen(3dm),