Manual Pages for UNIX Operating System command usage for man sip_add_branchid_to_via

Session Initiation Protocol Library Functions
                                    sip_add_branchid_to_via(3SIP)



NAME
     sip_add_branchid_to_via - add a branch parameter to the top-
     most VIA header in the SIP message

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

     int sip_add_branchid_to_via(sip_msg_t sip_msg, char *branchid);


DESCRIPTION
     The sip_add_branchid_to_via() function adds a  branch  param
     to  the  topmost VIA header in the SIP message sip_msg. Note
     that a new header is created  as  a  result  of  adding  the
     branch  parameter  and  the  old  header  is marked deleted.
     Applications with multiple threads working on the  same  VIA
     header need to take note of this.

RETURN VALUES
     These functions return 0  on  success  and  the  appropriate
     error value on failure.

ERRORS
     On failure, functions that return an error value may  return
     one of the following:

     EINVAL    Mandatory parameters are not provided or are NULL.

               For  sip_add_branchid_to_via(),  the  topmost  VIA
               header  already has a branch param or the SIP mes-
               sage does not have a VIA header.


     EPERM     The message cannot be modified.


     ENOMEM    There is an error allocating memory  for  creating
               headers/parameters.


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










SunOS 5.11          Last change: 25 Jan 2007                    1






Session Initiation Protocol Library Functions
                                    sip_add_branchid_to_via(3SIP)



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


SEE ALSO
     libsip(3LIB)











































SunOS 5.11          Last change: 25 Jan 2007                    2






Session Initiation Protocol Library Functions
                                    sip_add_branchid_to_via(3SIP)






















































SunOS 5.11          Last change: 25 Jan 2007                    3