dlm_TapConnect()

Indicates to the tap that the line is ready to provide data, should any monitor request it.

#include "dlmtap.h"

DlmResult dlm_TapConnect
    (
        DlmLine     line,
        DlmTimeout  timeout
    );

dlm_TapConnect() indicates to the tap that the line is ready to provide data, should any monitor request it.

If successful, dlm_TapConnect() returns a non-negative value. Otherwise, it returns a negative value indicating the reason it failed. Possible unsuccessful return values are:

• dlm_ERROR_CONNECTION_FAILURE
• dlm_ERROR_INVALID_ID

dlm_TapDisconnect()

if ((result = dlm_TapConnect(dlm_Line, 1000)) < 0)
{
    printf("Error: Failure connecting - %s.\n", dlm_ErrorMessage(result));
}
else
{
    /* do something */

    if ((result = dlm_TapDisconnect(dlm_Line)) < 0)
    {
        printf("Error: failure disconnecting - %s .\n", dlm_ErrorMessage(result));
    }
    else
    {
        printf("Tap disconnected.\n");
    }
}