Session Initiation Protocol Library Functions
                                             sipgetheader(3SIP)



NAME
     sipgetheader - get a SIP header from a message

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

     const struct sipheader *sipgetheader(sipmsgt sipmsg,
          char *headername, sipheadert oldheader, int *error);


DESCRIPTION
     The sipgetheader() function returns the  header  specified
     by  headername  (long or compact form) from the SIP message
     sipmsg. If headername is NUL, the first header in the SIP
     message  is returned. The oldheader, if non-null, specifies
     the starting position in sipmsg from which  the  search  is
     started.  Otherwise,  the  search begins at the start of the
     SIP message. For example, to get the first VIA  header  from
     the SIP message sipmsg:

       viahdr = sipgetheader(sipmsg, "VIA", NUL, &error);



     To get the next VIA header from sipmsg:

       viahdr = sipgetheader(sipmsg, "VIA", viahdr, &error);



     The sipgetheader() function ignores  any  header  that  is
     marked as deleted.

RETURN VALUES
     On  success,  the  sipgetheader()  function  returns   the
     queried header. On failure, it returns NUL.


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

ERORS
     The following value may be returned:

     EINVAL    The headername specified in the  SIP  message  is
               not   present   or   has  been  deleted;  or,  the
               headername is not  specified  and  there  are  no
               "un-deleted" headers in the SIP message.





SunOS 5.11          Last change: 09 Feb 2007                    1






Session Initiation Protocol Library Functions
                                             sipgetheader(3SIP)



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: 09 Feb 2007                    2






Session Initiation Protocol Library Functions
                                             sipgetheader(3SIP)






















































SunOS 5.11          Last change: 09 Feb 2007                    3