Manual Pages for UNIX Operating System command usage for man sip_branchid

Session Initiation Protocol Library Functions  sip_branchid(3SIP)



NAME
     sip_branchid - generate a RFC 3261 complaint branch ID

SYNOPSIS
     cc [ flag ... ] file ... -lsip [ library ... ]
     #include 

     char *sip_branchid(sip_msg_t sip_msg);


DESCRIPTION
     The sip_branchid() function can be used to generate a  value
     for  the  branch  parameter  for  a VIA header. The returned
     string is prefixed with z9hG4bK to conform to RFC  3261.  If
     sip_msg  is  null  or  sip_msg does not have a VIA header, a
     random value is generated. Otherwise, the value is generated
     using  the  MD5 hash of the VIA, FROM, CALL-ID, CSEQ headers
     and the URI from the request line. The caller is responsible
     for freeing the returned string.

RETURN VALUES
     The sip_branchid() function returns a string on success  and
     NULL on failure.


     The value of errno is not changed  by  these  calls  in  the
     event of an error.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     libsip(3LIB)










SunOS 5.11          Last change: 25 Jan 2007                    1