Manual Pages for UNIX Operating System command usage for man sip_get_num_via

Session Initiation Protocol Library Functions
                                            sip_get_num_via(3SIP)



NAME
     sip_get_num_via, sip_get_branchid - get VIA header  specific
     attributes

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

     int sip_get_num_via(sip_msg_t sip_msg,
          int *error);


     char *sip_get_branchid(sip_msg_t sip_msg,
          int *error);


DESCRIPTION
     The sip_get_num_via() function returns  the  number  of  VIA
     headers in the SIP message sip_msg.


     The sip_get_branchid() function returns the branch ID  value
     from  the  topmost VIA header. The caller is responsible for
     freeing the returned string.

RETURN VALUES
     The sip_get_num_via() function returns  the  number  of  VIA
     headers on success.


     The sip_get_branchid() function returns  the  branch  ID  on
     success and NULL on failure.


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

ERRORS
     If the error is non-null, one of  the  following  values  is
     set:

     EINVAL    The sip_msg is NULL.


     ENOENT    For the sip_get_branchid function, there is no VIA
               header or the VIA header has no branch parameter.


     EPROTO    For the  sip_sip_get_trans.3sipget_branchid  func-
               tion, the VIA value is invalid. The parser encoun-
               tered an error or errors  while  parsing  the  VIA



SunOS 5.11          Last change: 23 Jan 2007                    1






Session Initiation Protocol Library Functions
                                            sip_get_num_via(3SIP)



               header.


     ENOMEM    For the sip_get_branchid  function,  there  is  an
               error in allocating memory for the branch ID.



     On success, the value of the location pointed to by error is
     set to 0.

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: 23 Jan 2007                    2






Session Initiation Protocol Library Functions
                                            sip_get_num_via(3SIP)






















































SunOS 5.11          Last change: 23 Jan 2007                    3