OSP Toolkit Code

/**************************************************************************
*** COPYRIGHT (c) 2002 by TransNexus, Inc.                              ***
***                                                                     ***
*** This software is property of TransNexus, Inc.                       ***
*** This software is freely available under license from TransNexus.    ***
*** The license terms and conditions for free use of this software by   ***
*** third parties are defined in the OSP Toolkit Software License       ***
*** Agreement (LICENSE.txt).  Any use of this software by third         ***
*** parties, which does not comply with the terms and conditions of the ***
*** OSP Toolkit Software License Agreement is prohibited without        ***
*** the prior, express, written consent of TransNexus, Inc.             ***
***                                                                     ***
*** Thank you for using the OSP ToolKit(TM).  Please report any bugs,   ***
*** suggestions or feedback to support@transnexus.com                   ***
***                                                                     ***
**************************************************************************/







/*
 * ospdest.c - OSP destination functions
 */

#include "osp/osp.h"
#include "osp/osperrno.h"
#include "osp/ospbfr.h"
#include "osp/osplist.h"
#include "osp/ospxmlattr.h"
#include "osp/ospxmlelem.h"
#include "osp/ospmsgattr.h"
#include "osp/ospmsgelem.h"
#include "osp/ospcallid.h"
#include "osp/osptoken.h"
#include "osp/ospdest.h"
#include "osp/ospusage.h"
#include "osp/ospaltinfo.h"

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestSetOSPVersion() - set the OSP Version for a destination
 *-----------------------------------------------------------------------*/
void                                       /* nothing returned */
OSPPDestSetOSPVersion(
    OSPTDEST            *ospvDest,         /* destination to set */
    const unsigned char *ospvVersion       /* Version (as string) */
)
{
    if (!(OSPM_STRCMP((const char *)ospvVersion,DEST_OSP_DIABLED)))
    {
        ospvDest->ospmDestOSPVersion = OSPE_OSP_FALSE;
    }
    else
    {
        if (!(OSPM_STRCMP((const char *)ospvVersion,DEST_OSP_UNKNOWN)))
        {
            ospvDest->ospmDestOSPVersion = OSPE_OSP_UNKNOWN;
        }
        else
        {
            ospvDest->ospmDestOSPVersion = OSPE_OSP_TRUE;
        }
    }
}


/**/
/*-----------------------------------------------------------------------*
 * OSPPDestSetProtocol() - set the Protocol for a destination
 *-----------------------------------------------------------------------*/
void                                       /* nothing returned */
OSPPDestSetProtocol(
    OSPTDEST            *ospvDest,         /* destination to set */
    const unsigned char *ospvProt           /* Protocol (as string) */
)
{
    if (!(OSPM_STRCMP((const char *)ospvProt,DEST_PROT_SIP)))
    {
        ospvDest->ospmDestProtocol = OSPE_DEST_PROT_SIP;
    }
    else
    {
        if (!(OSPM_STRCMP((const char *)ospvProt,DEST_PROT_H323_LRQ)))
        {
            ospvDest->ospmDestProtocol = OSPE_DEST_PROT_H323_LRQ;
        }
        else
        {
            if (!(OSPM_STRCMP((const char *)ospvProt,DEST_PROT_H323_Q931)))
            {
                ospvDest->ospmDestProtocol = OSPE_DEST_PROT_H323_SETUP;
            }
            else
            {
                ospvDest->ospmDestProtocol = OSPE_DEST_PROT_UNKNOWN;
            }
        }
    }
}


/**/
/*-----------------------------------------------------------------------*
 * OSPPDestHasNumber() - does the destination include a called number?
 *-----------------------------------------------------------------------*/
unsigned                            /* returns non-zero if number exists */
OSPPDestHasNumber(
    OSPTDEST *ospvDest              /* destination effected */
)
{
    unsigned ospvHasNumber = OSPC_FALSE;

    if (ospvDest != OSPC_OSNULL) 
    {
        ospvHasNumber = ((ospvDest)->ospmDestNumber[0] != '\0');
    }
    return(ospvHasNumber);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestHasSrcNumber() - does the destination include a calling number?
 *-----------------------------------------------------------------------*/
unsigned                            /* returns non-zero if number exists */
OSPPDestHasSrcNumber(
    OSPTDEST *ospvDest              /* destination effected */
)
{
    unsigned ospvHasSrcNumber = OSPC_FALSE;

    if (ospvDest != OSPC_OSNULL) 
    {
        ospvHasSrcNumber = ((ospvDest)->ospmSrcNumber[0] != '\0');
    }
    return(ospvHasSrcNumber);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestSetSrcNumber() - set the calling number for a destination
 *-----------------------------------------------------------------------*/
void                                       /* nothing returned */
OSPPDestSetSrcNumber(
    OSPTDEST            *ospvDest,         /* destination to set */
    const unsigned char *ospvNum           /* calling number (as string) */
)
{
    size_t  len = 0;

    len=0;
    if (ospvDest != OSPC_OSNULL) 
    {
        if (ospvNum  != OSPC_OSNULL) 
        {
            OSPM_MEMCPY((ospvDest)->ospmSrcNumber, 
                (ospvNum), 
                tr_min(OSPC_E164NUMSIZE,OSPM_STRLEN((const char *)ospvNum)+1));
        }
    }
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestGetSrcNumber() - returns the calling number for a destination
 *-----------------------------------------------------------------------*/
unsigned char *                     /* returns number as string */
OSPPDestGetSrcNumber(
    OSPTDEST *ospvDest                     /* destination */
)
{
    unsigned char *ospvNum = OSPC_OSNULL;

    if (ospvDest != OSPC_OSNULL) 
    {
        ospvNum = ospvDest->ospmSrcNumber;
    }
    return(ospvNum);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestSetNumber() - set the called number for a destination
 *-----------------------------------------------------------------------*/
void                                       /* nothing returned */
OSPPDestSetNumber(
    OSPTDEST            *ospvDest,         /* destination to set */
    const unsigned char *ospvNum           /* called number (as string) */
)
{
    size_t  len = 0;

    len=0;
    if (ospvDest != OSPC_OSNULL) 
    {
        if (ospvNum  != OSPC_OSNULL) 
        {
            OSPM_MEMCPY((ospvDest)->ospmDestNumber, 
                (ospvNum), 
                tr_min(OSPC_E164NUMSIZE,OSPM_STRLEN((const char *)ospvNum)+1));
        }
    }
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestGetNumber() - returns the called number for a destination
 *-----------------------------------------------------------------------*/
unsigned char *                     /* returns number as string */
OSPPDestGetNumber(
    OSPTDEST *ospvDest                     /* destination */
)
{
    unsigned char *ospvNum = OSPC_OSNULL;

    if (ospvDest != OSPC_OSNULL) 
    {
        ospvNum = ospvDest->ospmDestNumber;
    }
    return(ospvNum);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestHasAddr() - does a destination have a Addr?
 *-----------------------------------------------------------------------*/
unsigned                                   /* returns non-zero if exists */
OSPPDestHasAddr(
    OSPTDEST *ospvDest                     /* destination in question */
)
{
    unsigned ospvHasAddr = OSPC_FALSE;
    if (ospvDest != OSPC_OSNULL) 
    {
        ospvHasAddr = (ospvDest->ospmDestAddr[0] != '\0');
    }
    return(ospvHasAddr);
}


/**/
/*-----------------------------------------------------------------------*
 * OSPPDestSetAddr() - sets the signalling address for a destination
 *-----------------------------------------------------------------------*/
void                                       /* nothing returned */
OSPPDestSetAddr(
    OSPTDEST            *ospvDest,         /* destination */
    const unsigned char *ospvAddr          /* signal address as string */
)
{
    size_t  len;

    len=0;
    if (ospvDest != OSPC_OSNULL) 
    {
        if (ospvAddr != OSPC_OSNULL) 
        {
            OSPM_MEMCPY((ospvDest)->ospmDestAddr, (ospvAddr), 
                tr_min(OSPC_SIGNALADDRSIZE,OSPM_STRLEN((const char *)ospvAddr)+1));
        }
    }
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestGetAddr() - returns the signalling address for a destination
 *-----------------------------------------------------------------------*/
unsigned char *                      /* returns address as string */
OSPPDestGetAddr(
    OSPTDEST *ospvDest                     /* destination in question */
)
{
    unsigned char *ospvAddr = OSPC_OSNULL;
    if  (ospvDest != OSPC_OSNULL) 
    {
        ospvAddr = ((ospvDest)->ospmDestAddr);
    }
    return(ospvAddr);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestDevHasAddr() - does a destination have a Dev Addr?
 *-----------------------------------------------------------------------*/
unsigned                                   /* returns non-zero if exists */
OSPPDestDevHasAddr(
    OSPTDEST *ospvDest                     /* destination in question */
)
{
    unsigned ospvHasAddr = OSPC_FALSE;
    if (ospvDest != OSPC_OSNULL) 
    {
        ospvHasAddr = (ospvDest->ospmDestDevAddr[0] != '\0');
    }
    return(ospvHasAddr);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestHasNetworkAddr() - does a destination have a Network Addr?
 *-----------------------------------------------------------------------*/
unsigned                                   /* returns non-zero if exists */
OSPPDestHasNetworkAddr(
    OSPTDEST *ospvDest                     /* destination in question */
)
{
    unsigned ospvHasAddr = OSPC_FALSE;
    if (ospvDest != OSPC_OSNULL) 
    {
        ospvHasAddr = (ospvDest->ospmDestNetworkId[0] != '\0');
    }
    return(ospvHasAddr);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestSetNetworkAddr() - sets the network address for a destination 
 *  device
 *-----------------------------------------------------------------------*/
void                                       /* nothing returned */
OSPPDestSetNetworkAddr(
    OSPTDEST            *ospvDest,         /* destination */
    const unsigned char *ospvAddr          /* network address as string */
)
{
    size_t  len;

    len=0;
    if (ospvDest != OSPC_OSNULL) 
    {
        if (ospvAddr != OSPC_OSNULL) 
        {
            OSPM_MEMCPY((ospvDest)->ospmDestNetworkId, (ospvAddr), 
                tr_min(OSPC_NETWORKIDSIZE,OSPM_STRLEN((const char *)ospvAddr)+1));
        }
    }
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestGetNetworkAddr() - returns the network address for a destination
 *  device
 *-----------------------------------------------------------------------*/
unsigned char *                      /* returns address as string */
OSPPDestGetNetworkAddr(
    OSPTDEST *ospvDest                     /* destination in question */
)
{
    unsigned char *ospvAddr = OSPC_OSNULL;
    if  (ospvDest != OSPC_OSNULL) 
    {
        ospvAddr = ((ospvDest)->ospmDestNetworkId);
    }
    return(ospvAddr);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestDevSetAddr() - sets the signalling address for a destination 
 *  device
 *-----------------------------------------------------------------------*/
void                                       /* nothing returned */
OSPPDestDevSetAddr(
    OSPTDEST            *ospvDest,         /* destination */
    const unsigned char *ospvAddr          /* signal address as string */
)
{
    size_t  len;

    len=0;
    if (ospvDest != OSPC_OSNULL) 
    {
        if (ospvAddr != OSPC_OSNULL) 
        {
            OSPM_MEMCPY((ospvDest)->ospmDestDevAddr, (ospvAddr), 
                tr_min(OSPC_SIGNALADDRSIZE,OSPM_STRLEN((const char *)ospvAddr)+1));
        }
    }
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestDevGetAddr() - returns the signalling address for a destination
 *  device
 *-----------------------------------------------------------------------*/
unsigned char *                      /* returns address as string */
OSPPDestDevGetAddr(
    OSPTDEST *ospvDest                     /* destination in question */
)
{
    unsigned char *ospvAddr = OSPC_OSNULL;
    if  (ospvDest != OSPC_OSNULL) 
    {
        ospvAddr = ((ospvDest)->ospmDestDevAddr);
    }
    return(ospvAddr);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestHasValidAfter() - Does a destination have a valid after time?
 *-----------------------------------------------------------------------*/
unsigned                                   /* returns non-zero if time */
OSPPDestHasValidAfter(
    OSPTDEST *ospvDest                     /* destination in question */
)
{
    unsigned ospvHasTime = OSPC_FALSE;

    if(ospvDest != OSPC_OSNULL) 
    {
        ospvHasTime = ((ospvDest)->ospmDestValidAfter != OSPC_TIMEMIN);
    }
    return(ospvHasTime);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestSetValidAfter() - sets the valid after time for a destination
 *-----------------------------------------------------------------------*/
void                                       /* nothing returned */
OSPPDestSetValidAfter(
    OSPTDEST *ospvDest,
    OSPTTIME  ospvTime
)
{
    if (ospvDest != OSPC_OSNULL) 
    {
        (ospvDest)->ospmDestValidAfter = (ospvTime);
    }
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestGetValidAfter() - returns valid after time for a destination
 *-----------------------------------------------------------------------*/
OSPTTIME                                   /* returns the time value */
OSPPDestGetValidAfter(
    OSPTDEST *ospvDest                     /* destination in question */
    )
{
    OSPTTIME ospvTime = 0;

    if (ospvDest != OSPC_OSNULL) 
    {
        ospvTime = (ospvDest)->ospmDestValidAfter;
    }
    return(ospvTime);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestHasValidUntil() - does destination have a valid until time?
 *-----------------------------------------------------------------------*/
unsigned                                   /* returns non-zero if time */
OSPPDestHasValidUntil(
    OSPTDEST *ospvDest                     /* destination in question */
)
{
    unsigned ospvHasTime = OSPC_FALSE;

    if (ospvDest != OSPC_OSNULL) 
    {
        ospvHasTime = ((ospvDest)->ospmDestValidUntil != OSPC_TIMEMAX);
    }
    return(ospvHasTime);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestSetValidUntil() - sets valid until time for destination
 *-----------------------------------------------------------------------*/
void                                       /* nothing returned */
OSPPDestSetValidUntil(
    OSPTDEST *ospvDest,                    /* destination in question */
    OSPTTIME ospvTime                      /* time to set */
)
{
    if (ospvDest != OSPC_OSNULL) 
    {
        (ospvDest)->ospmDestValidUntil = (ospvTime);
    }
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestGetValidUntil() - returns valid until time for destination
 *-----------------------------------------------------------------------*/
OSPTTIME                                   /* returns time */
OSPPDestGetValidUntil(
    OSPTDEST *ospvDest                     /* destination in question */
    )
{
    OSPTTIME ospvTime = 0;

    if (ospvDest != OSPC_OSNULL) 
    {
        ospvTime = ospvDest->ospmDestValidUntil;
    }
    return(ospvTime);
}


/**/
/*-----------------------------------------------------------------------*
 * OSPPDestHasAuthority() - does an authority URL exist for destination?
 *-----------------------------------------------------------------------*/
unsigned                                   /* returns non-zero if exists */
OSPPDestHasAuthority(
    OSPTDEST *ospvDest                     /* destination in question */
)
{
    unsigned ospvHasAuth = OSPC_FALSE;

    if (ospvDest != OSPC_OSNULL) 
    {
        ospvHasAuth = (ospvDest->ospmDestAuthority[0] != '\0');
    }
    return(ospvHasAuth);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestSetAuthority() - sets authority URL for destination
 *-----------------------------------------------------------------------*/
void                                       /* nothing returned */
OSPPDestSetAuthority(
    OSPTDEST            *ospvDest,         /* destination in question */
    const unsigned char *ospvAuth          /* authority URL */
)
{
    if (ospvDest != OSPC_OSNULL) 
    {
        if (ospvAuth != OSPC_OSNULL) 
        {
            OSPM_STRNCPY((char *)((ospvDest)->ospmDestAuthority),
                (const char *)(ospvAuth), 
                tr_min(OSPM_STRLEN((const char *)ospvAuth)+1,OSPC_URLSIZE-1));
        }
    }
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestHasCallId() - does a destination have a Call ID?
 *-----------------------------------------------------------------------*/
unsigned                                   /* returns non-zero if exists */
OSPPDestHasCallId(
    OSPTDEST *ospvDest                     /* destination in question */
)
{

    unsigned ospvHasId = OSPC_FALSE;

    if (ospvDest != OSPC_OSNULL) 
    {
        ospvHasId = ((ospvDest)->ospmDestCallId != OSPC_OSNULL);
    }
    return(ospvHasId);

}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestGetCallId() - gets the call ID for a destination
 *-----------------------------------------------------------------------*/
OSPTCALLID *                               /* returns call ID pointer */
OSPPDestGetCallId(
    OSPTDEST *ospvDest                     /* destination in question */
    )
{

    OSPTCALLID *ospvCallId = OSPC_OSNULL;

    if (ospvDest != OSPC_OSNULL) 
    {
        ospvCallId = ((ospvDest)->ospmDestCallId);
    }
    return(ospvCallId);

}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestHasToken() - does a destination have a Token?
 *-----------------------------------------------------------------------*/
unsigned                                   /* returns non-zero if exists */
OSPPDestHasToken(
    OSPTDEST *ospvDest                     /* destination in question */
)
{

    unsigned ospvHasToken = OSPC_FALSE;

    if (ospvDest != OSPC_OSNULL) 
    {
        ospvHasToken = (OSPPListFirst(&(ospvDest->ospmDestTokens)) != OSPC_OSNULL);
    }
    return(ospvHasToken);

}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestAddToken() - adds a token to a destination
 *-----------------------------------------------------------------------*/
void                                       /* nothing returned */
OSPPDestAddToken(
    OSPTDEST  *ospvDest,                   /* destination in question */
    OSPTTOKEN *ospvToken                   /* token to add */
)
{
    if (ospvDest != OSPC_OSNULL) 
    {
        OSPPListAppend(&(ospvDest->ospmDestTokens), (ospvToken));
    }
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestFirstToken() - gets first token for destination
 *-----------------------------------------------------------------------*/
OSPTTOKEN *                                /* returns null if none */
OSPPDestFirstToken(
    OSPTDEST *ospvDest
    )
{
    OSPTTOKEN *ospvToken = OSPC_OSNULL;

    if (ospvDest != OSPC_OSNULL) 
    {
        ospvToken = (OSPTTOKEN *)OSPPListFirst(&(ospvDest)->ospmDestTokens);
    }
    return(ospvToken);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestNextToken() - gets next token (in list) for destination
 *-----------------------------------------------------------------------*/
OSPTTOKEN *                                /* returns NULL if no more */
OSPPDestNextToken(
    OSPTDEST  *ospvDest,                   /* destination in question */
    OSPTTOKEN *ospvToken                   /* current token */
    )
{

    OSPTTOKEN *ospvNextToken = OSPC_OSNULL;

    if (ospvDest  != OSPC_OSNULL) 
    {
        if (ospvToken != OSPC_OSNULL) 
        {
            ospvToken = (OSPTTOKEN *)OSPPListNext(&(ospvDest)->ospmDestTokens, ospvToken);
        }
    }
    return(ospvNextToken);

}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestHasLimit() - does a destination have a usage limit?
 *-----------------------------------------------------------------------*/
unsigned                                   /* returns non-zero if limit */
OSPPDestHasLimit(
    OSPTDEST *ospvDest                     /* destination in question */
)
{

    unsigned ospvHasLimit = OSPC_FALSE;

    if (ospvDest != OSPC_OSNULL) 
    {
        ospvHasLimit = (ospvDest->ospmDestHasLimit);
    }
    return(ospvHasLimit);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestSetLimit() -  sets usage limit for a destination
 *-----------------------------------------------------------------------*/
void                                       /* nothing returned */
OSPPDestSetLimit(
    OSPTDEST *ospvDest,                    /* destination in question */
    unsigned  ospvLimit                    /* limit to set */
)
{
    if (ospvDest != OSPC_OSNULL) 
    {
        ospvDest->ospmDestLimit=ospvLimit;
        ospvDest->ospmDestHasLimit=OSPC_TRUE;
    }
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestGetLimit() - returns the usage limit for a destination
 *-----------------------------------------------------------------------*/
unsigned                                   /* returns usage limit */
OSPPDestGetLimit(
    OSPTDEST *ospvDest                     /* destination in question */
)
{
    unsigned ospvLimit = 0;

    if (ospvDest != OSPC_OSNULL) 
    {
        ospvLimit = ((ospvDest)->ospmDestLimit);
    }
    return(ospvLimit);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestHasTNFailReason() - Does dest have a TransNexus Fail Rsn
 *-----------------------------------------------------------------------*/
unsigned                                   /* returns non-zero if time */
OSPPDestHasTNFailReason(
    OSPTDEST *ospvDest               /* dest in question */
)
{
    unsigned ospvHasTNFailReason = OSPC_FALSE;

    if (ospvDest != OSPC_OSNULL)
    {
        ospvHasTNFailReason = ((ospvDest)->ospmDestTNFailReasonInd);
    }
    return(ospvHasTNFailReason);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestSetTNFailReason() - Set TransNexus Fail Reason
 *-----------------------------------------------------------------------*/
void                                       /* nothing returned */
OSPPDestSetTNFailReason(
    OSPTDEST *ospvDest,
    unsigned     ospvTNFailReason
)
{
    if (ospvDest != OSPC_OSNULL)
    {
        (ospvDest)->ospmDestTNFailReason    = (ospvTNFailReason);
        (ospvDest)->ospmDestTNFailReasonInd = 1;
    }
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestGetTNFailReason() - returns TN Fail Rsn for a dest
 *-----------------------------------------------------------------------*/
unsigned                                 /* returns the fail reason value */
OSPPDestGetTNFailReason(
    OSPTDEST *ospvDest               /* usage request */
    )
{
    unsigned ospvTNFailReason = 0;

    if (ospvDest != OSPC_OSNULL)
    {
        ospvTNFailReason = (ospvDest)->ospmDestTNFailReason;
    }
    return(ospvTNFailReason);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestNew() - creates a new (empty) destination
 *-----------------------------------------------------------------------*/
OSPTDEST *                                 /* returns pointer or NULL */
OSPPDestNew()
{
    OSPTDEST *ospvDest = OSPC_OSNULL;

    OSPM_MALLOC(ospvDest, OSPTDEST,sizeof(OSPTDEST));
    if (ospvDest != OSPC_OSNULL)
    {
        /* start with setting all to 0 */
        OSPM_MEMSET(ospvDest, 0, sizeof(OSPTDEST));
        OSPPListLinkNew(&(ospvDest->ospmDestLink));
        ospvDest->ospmDestValidAfter = OSPC_TIMEMIN;
        ospvDest->ospmDestValidUntil = OSPC_TIMEMAX;
        ospvDest->ospmDestProtocol = OSPE_DEST_PROT_UNDEFINED;
        ospvDest->ospmDestOSPVersion = OSPE_OSP_UNDEFINED;
        OSPPListNew(&(ospvDest->ospmDestTokens));
        OSPPListNew(&(ospvDest->ospmUpdatedSourceAddr));
        OSPPListNew(&(ospvDest->ospmUpdatedDeviceInfo));
        ospvDest->ospmDestHasLimit = OSPC_FALSE;

    }

    return(ospvDest);
}

/*-----------------------------------------------------------------------*
 * OSPPDestDelete() - deletes a Destination structure
 *-----------------------------------------------------------------------*/
void
OSPPDestDelete(
    OSPTDEST **ospvDest)
{
    /*   OSPTTOKEN *token, *otoken = OSPC_OSNULL; */
    OSPTTOKEN *tmptoken = OSPC_OSNULL;
    OSPTALTINFO *altinfo        = OSPC_OSNULL;

    if (*ospvDest != OSPC_OSNULL) 
    {
        /* first delete the callid */
        if (((*ospvDest)->ospmDestCallId) != OSPC_OSNULL) 
        {
            OSPPCallIdDelete(&((*ospvDest)->ospmDestCallId));
        }

        while (!OSPPListEmpty((OSPTLIST *)&((*ospvDest)->ospmDestTokens))) 
        {
            tmptoken = (OSPTTOKEN *)OSPPListRemove(
                (OSPTLIST *)&((*ospvDest)->ospmDestTokens));
            if (tmptoken != (OSPTTOKEN *)OSPC_OSNULL) 
            {
                OSPPTokenDelete(&tmptoken);
            }
        }
        OSPPListDelete((OSPTLIST *)&((*ospvDest)->ospmDestTokens));

        while (!OSPPListEmpty((OSPTLIST *)&((*ospvDest)->ospmUpdatedSourceAddr))) 
        {
            altinfo = (OSPTALTINFO *)OSPPListRemove(
                (OSPTLIST *)&((*ospvDest)->ospmUpdatedSourceAddr));
            if (altinfo != (OSPTALTINFO *)OSPC_OSNULL) 
            {
                OSPM_FREE(altinfo);
                altinfo = OSPC_OSNULL;
            }
        }
        OSPPListDelete((OSPTLIST *)&((*ospvDest)->ospmUpdatedSourceAddr));

        while (!OSPPListEmpty((OSPTLIST *)&((*ospvDest)->ospmUpdatedDeviceInfo))) 
        {
            altinfo = (OSPTALTINFO *)OSPPListRemove(
                (OSPTLIST *)&((*ospvDest)->ospmUpdatedDeviceInfo));
            if (altinfo != (OSPTALTINFO *)OSPC_OSNULL) 
            {
                OSPM_FREE(altinfo);
                altinfo = OSPC_OSNULL;
            }
        }
        OSPPListDelete((OSPTLIST *)&((*ospvDest)->ospmUpdatedDeviceInfo));
        /* finally delete the object */
        OSPM_FREE(*ospvDest);
        *ospvDest = OSPC_OSNULL;
    }
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestFromElement() - get destination from an XML element
 *-----------------------------------------------------------------------*/
unsigned                          /* returns error code */
OSPPDestFromElement(
    OSPTXMLELEM *ospvElem,        /* input is XML element */
    OSPTDEST   **ospvDest         /* where to put destination pointer */
)
{
    unsigned      ospvErrCode   = OSPC_ERR_NO_ERROR;
    OSPTXMLELEM  *elem          = OSPC_OSNULL;
    OSPTDEST     *dest          = OSPC_OSNULL;
    OSPTTOKEN    *token         = OSPC_OSNULL;
    OSPTCALLID   *callId        = OSPC_OSNULL;
    unsigned      limit         = 0;
    unsigned long failure       = 0L;
    OSPTTIME      t             = 0L;

    if (ospvElem == OSPC_OSNULL)
    {
        ospvErrCode = OSPC_ERR_XML_NO_ELEMENT;
    }
    if (ospvDest == OSPC_OSNULL)
    {
        ospvErrCode = OSPC_ERR_DATA_NO_DEST;
    }

    if (ospvErrCode == OSPC_ERR_NO_ERROR)
    {
        /* create the destination object */
        dest = OSPPDestNew();

        if (dest == OSPC_OSNULL)
        {
            ospvErrCode = OSPC_ERR_DATA_NO_DEST;
        }

        /*
         * The Destination element should consist of several child
         * elements. We'll run through what's there and pick out
         * the information we need.
         */

        for ( elem = (OSPTXMLELEM *)OSPPXMLElemFirstChild(ospvElem);
            (elem != (OSPTXMLELEM *)OSPC_OSNULL) && (ospvErrCode == OSPC_ERR_NO_ERROR);
            elem = (OSPTXMLELEM *)OSPPXMLElemNextChild(ospvElem, elem) )
        {
            switch (OSPPMsgGetElemPart(OSPPXMLElemGetName(elem)))
            {
                case ospeElemDestProtocol:
                	OSPPDestSetProtocol(dest, (const unsigned char *)OSPPXMLElemGetValue(elem));
                	break;

                case ospeElemDestOSPVersion:
                	OSPPDestSetOSPVersion(dest, (const unsigned char *)OSPPXMLElemGetValue(elem));
                	break;

                case ospeElemSrcInfo:
                OSPPDestSetSrcNumber(dest, (const unsigned char *)OSPPXMLElemGetValue(elem));
                break;

                case ospeElemDestInfo:
                OSPPDestSetNumber(dest, (const unsigned char *)OSPPXMLElemGetValue(elem));
                break;
                case ospeElemDestAlt:
                /*                OSPPDestSetAddr(dest, (const unsigned char *)OSPPXMLElemGetValue(elem)); */
                OSPPDestSetNetworkAddr(dest, (const unsigned char *)OSPPXMLElemGetValue(elem));
                break;
                case ospeElemDestSigAddr:
                /*                OSPPDestDevSetAddr(dest, (const unsigned char *)OSPPXMLElemGetValue(elem)); */
                OSPPDestSetAddr(dest, (const unsigned char *)OSPPXMLElemGetValue(elem)); 
                break;
                case ospeElemToken:
                ospvErrCode = OSPPTokenFromElement(elem, &token);
                if (ospvErrCode == OSPC_ERR_NO_ERROR)
                {
                    OSPPDestAddToken(dest, token);
                }
                break;
                case ospeElemValidAfter:
                    t=0;
                    if(*(OSPPXMLElemGetValue(elem)) != 0)
                    {
                        ospvErrCode = OSPPMsgTimeFromElement(elem, &t);
                    }
                    else
                    {
                        t = OSPC_TIMEMIN;
                    }
                    if (ospvErrCode == OSPC_ERR_NO_ERROR)
                    {
                        OSPPDestSetValidAfter(dest,t);
                    }
                break;
                case ospeElemValidUntil:
                    t=0;
                    if(*(OSPPXMLElemGetValue(elem)) != 0)
                    {
                        ospvErrCode = OSPPMsgTimeFromElement(elem, &t);
                    }
                    else
                    {
                        t = OSPC_TIMEMAX;
                    }
                    if (ospvErrCode == OSPC_ERR_NO_ERROR)
                    {
                        OSPPDestSetValidUntil(dest,t);
                    }
                break;
                case ospeElemUsageDetail:
                ospvErrCode = OSPPUsageFromElement(elem, &limit);
                if (ospvErrCode == OSPC_ERR_NO_ERROR)
                {
                    OSPPDestSetLimit(dest,limit);
                }
                break;
                case ospeElemAuthURL:
                OSPPDestSetAuthority(dest, (const unsigned char *)OSPPXMLElemGetValue(elem));
                break;
                case ospeElemCallId:
                ospvErrCode = OSPPCallIdFromElement(elem, &callId);
                if (ospvErrCode == OSPC_ERR_NO_ERROR)
                {
                    OSPPDestSetCallId(dest, callId->ospmCallIdVal, callId->ospmCallIdLen);
                    OSPPCallIdDelete(&callId);
                }
                break;
                case ospeElemTNFailReason:
                ospvErrCode = OSPPMsgNumFromElement(elem, &failure);
                OSPPDestSetTNFailReason(dest, (unsigned)failure);
                break;
                default:
                /*
                 * This is an element we don't understand. If it's
                 * critical, then we have to report an error.
                 * Otherwise we can ignore it.
                 */
                if (OSPPMsgElemIsCritical(elem))
                {
                    ospvErrCode = OSPC_ERR_XML_BAD_ELEMENT;
                }
                break;
            }
        }

        if (ospvErrCode == OSPC_ERR_NO_ERROR)
        {
            *ospvDest = dest;
        }
    }
    return(ospvErrCode);
}

/**/
/*-----------------------------------------------------------------------*
 * OSPPDestSetCallId() - sets the call ID for a destination
 *-----------------------------------------------------------------------*/
void                                       /* nothing returned */
OSPPDestSetCallId(
    OSPTDEST            *ospvDest,  /* destination */
    const unsigned char *ospvValue, /* call ID value */
    unsigned            ospvLen
)
{
    if (ospvDest != OSPC_OSNULL)
    {
        if (ospvValue != OSPC_OSNULL)
        {
            if ((ospvDest)->ospmDestCallId != OSPC_OSNULL) 
            {
                OSPPCallIdDelete(&((ospvDest)->ospmDestCallId));
            }
            (ospvDest)->ospmDestCallId = 
                OSPPCallIdNew( ospvLen, (ospvValue));
        }
    }
}