Session Initiation Protocol Library Functions
                                      sipdeletestartline(3SIP)



NAME
     sipdeletestartline,                    sipdeleteheader,
     sipdeleteheaderbyname,  sipdeletevalue  - delete a SIP
     header or a header value

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

     int sipdeletestartline(sipmsgt sipmsg);


     int sipdeleteheader(sipmsgt sipheader);


     int sipdeleteheaderbyname(sipmsgt msg,
          char *headername);


     int sipdeletevalue(sipheadert sipheader,
          sipheadervaluet sipheadervalue);


DESCRIPTION
     The sipdeletestartline() function deletes the start line,
     a request or a response line, from the SIP message sipmsg.


     The sipdeleteheader()  function  deletes  the  SIP  header
     specified  by  sipheader  from  the  associated SIP message
     sipmsg.


     The sipdeleteheaderbyname()  function  deletes  the  SIP
     header  name specified by headername (long or compact form)
     from the SIP message sipmsg.


     The sipdeletevalue() deletes the SIP header  value  speci-
     fied by sipheadervalue from the SIP header sipheader.


     When a SIP header or value  is  deleted,  the  corresponding
     header  or  value  is  marked  as  deleted.   Lookups ignore
     headers or values that are marked as deleted.

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





SunOS 5.11          Last change: 20 Jan 2007                    1






Session Initiation Protocol Library Functions
                                      sipdeletestartline(3SIP)



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

ERORS
     On failure, the returned error could be one of  the  follow-
     ing:

     EINVAL    If any of the required input is NUL.

               If the header or value  to  be  deleted  does  not
               exist.

               If the header or value to be deleted  has  already
               been deleted.


     EPERM     If the SIP message cannot be modified.


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






Session Initiation Protocol Library Functions
                                      sipdeletestartline(3SIP)






















































SunOS 5.11          Last change: 20 Jan 2007                    3