manpagez: man pages & more
man CURLINFO_RTSP_SESSION_ID(3)
Home | html | info | man
CURLINFO_RTSP_SESSION_ID(3)                           Library Functions Manual


NAME

       CURLINFO_RTSP_SESSION_ID - RTSP session ID


SYNOPSIS

       #include <curl/curl.h>

       CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_RTSP_SESSION_ID, char **id);


DESCRIPTION

       Pass a pointer to a char pointer to receive a pointer to a string
       holding the most recent RTSP Session ID.

       Applications wishing to resume an RTSP session on another connection
       should retrieve this info before closing the active connection.

       The id pointer is NULL or points to private memory. You must not free
       it. The memory gets freed automatically when you call
       curl_easy_cleanup(3) on the corresponding curl handle.


PROTOCOLS

       This functionality affects rtsp only


EXAMPLE

       int main(void)
       {
         CURL *curl = curl_easy_init();
         if(curl) {
           CURLcode result;
           curl_easy_setopt(curl, CURLOPT_URL, "rtsp://rtsp.example.com");
           result = curl_easy_perform(curl);
           if(result == CURLE_OK) {
             char *id;
             curl_easy_getinfo(curl, CURLINFO_RTSP_SESSION_ID, &id);
           }
           curl_easy_cleanup(curl);
         }
       }


AVAILABILITY

       Added in curl 7.20.0


RETURN VALUE

       curl_easy_getinfo(3) returns a CURLcode indicating success or error.

       CURLE_OK (0) means everything was OK, non-zero means an error occurred,
       see libcurl-errors(3).


SEE ALSO

       CURLINFO_RTSP_CSEQ_RECV(3), curl_easy_getinfo(3), curl_easy_setopt(3)

libcurl                           2026-03-23       CURLINFO_RTSP_SESSION_ID(3)

curl 8.19.0 - Generated Thu Mar 26 15:57:40 CDT 2026
© manpagez.com 2000-2026
Individual documents may contain additional copyright information.