dlm_TapOpen()

Opens a new session for monitoring.

#include "dlmtap.h"

DlmResult dlm_TapOpen
    (
        DlmLine  line
    );

dlm_TapOpen() opens a new session for monitoring.

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

• dlm_ERROR_INVALID_COMMAND
• dlm_ERROR_INVALID_LINE_ID

dlm_TapClose()

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

    if ((result = dlm_TapClose(dlm_Line)) < 0)
    {
        printf("Error: failure closing - %s.\n", dlm_ErrorMessage(result));
    }
    else
    {
        printf("Closed.\n");
    }
}