Session Initiation Protocol Library Functions
                                             sipmsgtostr(3SIP)



NAME
     sipmsgtostr,     siphdrtostr,      sipreqlinetostr,
     sipresplinetostr,   sipsentbytostr  -  return  string
     representations

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

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


     char *siphdrtostr(sipheadert sipheader,
          int *error);


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


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


     char *sipsentbytostr(int *error);


DESCRIPTION
     The sipmsgtostr() function returns the string representa-
     tion  of  the  SIP  message sipmsg. Deleted headers are not
     included in the returned string. The caller  is  responsible
     for freeing the returned string.


     The siphdrtostr() function returns the string representa-
     tion of the SIP header sipheader. The caller is responsible
     for freeing the returned string.


     The  sipreqlinetostr()  function   returns   the   string
     representation  of  the  request  line  from the SIP message
     sipmsg. The caller is responsible for freeing the  returned
     string.


     The  sipresplinetostr()  function  returns   the   string
     representation  of  the  response  line from the SIP message
     sipmsg. The caller is responsible for freeing the  returned
     string.




SunOS 5.11          Last change: 25 Jan 2007                    1






Session Initiation Protocol Library Functions
                                             sipmsgtostr(3SIP)



     The sipsentbytostr() function can be  used  to  retrieve
     the  list  of  sent-by values registered with the stack. The
     returned string is a comma separated list of sent-by values.
     The caller is responsible for freeing the returned string.

RETURN VALUES
     The           sipmsgtostr(),            siphdrtostr(),
     sipreqlinetostr(),       sipresplinetostr(),       and
     sipsentbytostr() functions return the relevant string on
     success and NUL on failure.


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

ERORS
     For      the       sipmsgtostr(),       siphdrtostr(),
     sipreqlinetostr(),  and sipresplinetostr(), one of the
     following values is set if the error is non-null:

     EINVAL    Input is null.


     ENOMEM    Memory allocation failure.



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






Session Initiation Protocol Library Functions
                                             sipmsgtostr(3SIP)






















































SunOS 5.11          Last change: 25 Jan 2007                    3