Session Initiation Protocol Library Functions  sipbranchid(3SIP)



NAME
     sipbranchid - generate a RFC 3261 complaint branch ID

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

     char *sipbranchid(sipmsgt sipmsg);


DESCRIPTION
     The sipbranchid() 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
     sipmsg  is  null  or  sipmsg does not have a VIA header, a
     random value is generated. Otherwise, the value is generated
     using  the  MD5 hash of the VIA, FROM, CAL-ID, CSEQ headers
     and the URI from the request line. The caller is responsible
     for freeing the returned string.

RETURN VALUES
     The sipbranchid() function returns a string on success  and
     NUL on failure.


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

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     libsip(3LIB)










SunOS 5.11          Last change: 25 Jan 2007                    1