CURLINFO_RTSP_SESSION_ID(3)

1CURLINFO_RTSP_SESSION_ID(3)         libcurl        CURLINFO_RTSP_SESSION_ID(3)
2
3
4

NAME

6       CURLINFO_RTSP_SESSION_ID - get RTSP session ID
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_RTSP_SESSION_ID, char **id);
12

DESCRIPTION

14       Pass a pointer to a char pointer to receive a pointer to a string hold‐
15       ing the most recent RTSP Session ID.
16
17       Applications wishing to resume an RTSP session  on  another  connection
18       should retrieve this info before closing the active connection.
19
20       The  id pointer will be NULL or pointing to private memory you MUST NOT
21       free - it gets freed when you call curl_easy_cleanup(3) on  the  corre‐
22       sponding CURL handle.
23

PROTOCOLS

25       RTSP
26

EXAMPLE

28       CURL *curl = curl_easy_init();
29       if(curl) {
30         CURLcode res;
31         curl_easy_setopt(curl, CURLOPT_URL, "rtsp://rtsp.example.com");
32         res = curl_easy_perform(curl);
33         if(res == CURLE_OK) {
34           char *id;
35           curl_easy_getinfo(curl, CURLINFO_RTSP_SESSION_ID, &id);
36         }
37         curl_easy_cleanup(curl);
38       }
39

AVAILABILITY

41       Added in 7.20.0
42

RETURN VALUE

44       Returns  CURLE_OK  if the option is supported, and CURLE_UNKNOWN_OPTION
45       if not.
46