Manual Pages for UNIX Operating System command usage for man sip_add_param

Session Initiation Protocol Library Functions
                                              sip_add_param(3SIP)



NAME
     sip_add_param - add a parameter to the SIP header

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

     sip_header_t sip_add_param(sip_header_t sip_header, char *param,
          int *error);


DESCRIPTION
     The sip_add_param() function adds the parameter provided  in
     param to the SIP header sip_header. The function returns the
     header with the parameter added. A new header is created  as
     a  result  of  adding  the  parameter  and the old header is
     marked deleted. Applications with multiple  threads  working
     on  the  same SIP header need to take note of this. If error
     is non-null, it (the location pointer by  the  variable)  is
     set  to  0  on  success  and  the appropriate error value on
     error.

RETURN VALUES
     The sip_add_param() function returns the new header on  suc-
     cess  and  null  on  failure. Further, if error is non-null,
     then on success the value in the location pointed  by  error
     is 0 and the appropriate error value on failure.

ERRORS
     On failure, functions that return an error value may  return
     one of the following:

     EINVAL    Mandatory parameters are not provided, i.e. null.

               For sip_add_param(), the header to be modified  is
               marked deleted.


     EPERM     The message cannot be modified.


     ENOMEM    There is an error allocating memory  for  creating
               headers/parameters.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:






SunOS 5.11          Last change: 25 Jan 2007                    1






Session Initiation Protocol Library Functions
                                              sip_add_param(3SIP)



______________________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE 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
                                              sip_add_param(3SIP)






















































SunOS 5.11          Last change: 25 Jan 2007                    3