Session Initiation Protocol Library Functions
                                            sipgetnumvia(3SIP)



NAME
     sipgetnumvia, sipgetbranchid - get VIA header  specific
     attributes

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

     int sipgetnumvia(sipmsgt sipmsg,
          int *error);


     char *sipgetbranchid(sipmsgt sipmsg,
          int *error);


DESCRIPTION
     The sipgetnumvia() function returns  the  number  of  VIA
     headers in the SIP message sipmsg.


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

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


     The sipgetbranchid() function returns  the  branch  ID  on
     success and NUL on failure.


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

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

     EINVAL    The sipmsg is NUL.


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


     EPROTO    For the  sipsipgettrans.3sipgetbranchid  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
                                            sipgetnumvia(3SIP)



               header.


     ENOMEM    For the sipgetbranchid  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.

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






Session Initiation Protocol Library Functions
                                            sipgetnumvia(3SIP)






















































SunOS 5.11          Last change: 23 Jan 2007                    3