Session Initiation Protocol Library Functions
                                       sipgetheadervalue(3SIP)



NAME
     sipgetheadervalue, sipgetnextvalue - get a SIP  header
     value

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

     const struct sipvalue *sipgetheadervalue
          (const struct sipheader *sipheader, int *error);


     const struct sipvalue *sipgetnextvalue
          (sipheadervaluet oldvalue, int *error);


DESCRIPTION
     The sipgetheadervalue() function returns the first  valid
     value from SIP header sipheader.


     The sipgetnextvalue() function  returns  the  next  valid
     value following the SIP value oldvalue.

RETURN VALUES
     These functions return the queried value 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    If any of the required input is  NUL  or  if  the
               specified SIP header value is marked deleted.


     EPROTO    If the returned SIP header value is invalid  (i.e.
               the  parser  encountered  errors  when parsing the
               value).



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

ATRIBUTES




SunOS 5.11          Last change: 25 Jan 2007                    1






Session Initiation Protocol Library Functions
                                       sipgetheadervalue(3SIP)



     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                    2






Session Initiation Protocol Library Functions
                                       sipgetheadervalue(3SIP)






















































SunOS 5.11          Last change: 25 Jan 2007                    3