Session Initiation Protocol Library Functions
                                    sipgetrequesturistr(3SIP)



NAME
     sipgetrequesturistr - return request URI

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

     const sipstrt *sipgetrequesturistr(sipmsgt sipmsg,
          int *error);


DESCRIPTION
     For functions that  return  a  pointer  of  type  sipstrt,
     sipstrt is supplied by:

       typedef struct sipstr {
            char *sipstrptr;
            int  sipstrlen;
       }sipstrt;



     The  sipstrptr  parameter  points  to  the  start  of  the
     returned  value  and  sipstrlen supplies the length of the
     returned value.


     For example, given the following request line in a SIP  mes-
     sage input to sipgetrequesturistr():

       INVITE sip:marconi@radio.org SIP/2.0



     the return is a pointer to sipstrt  with  the  sipstrptr
     member   pointing   to   "s"  of  sip:marconi@radio.org  and
     sipstrlen   being   set   to    21,    the    length    of
     sip:marconi@radio.org.


     The  sipgetrequesturistr()  function  returns  the   URI
     string from the request line in the SIP message sipmsg.

RETURN VALUES
     The  sipgetrequesturistr()  function  returns  the   URI
     string. The function returns NUL on failure.


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




SunOS 5.11          Last change: 25 Jan 2007                    1






Session Initiation Protocol Library Functions
                                    sipgetrequesturistr(3SIP)



ERORS
     If the error is non-null, one of  the  following  values  is
     set:

     EINVAL    For the sipgetrequesturistr() function,  there
               is no request line is in the SIP message.


     EPROTO    For sipgetrequesturistr, the  request  URI  is
               invalid.



     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
                                    sipgetrequesturistr(3SIP)






















































SunOS 5.11          Last change: 25 Jan 2007                    3