GNURLINFO...SESSION_ID(3)

💖 NAME 💖

GNURLINFO...SESSION_ID(3) is the page, the manual is curl_easy_getinfo options, and the star of the show is CURLINFO_RTSP_SESSION_ID — get RTSP session ID. Periodt. 💅

🎀 SYNOPSIS 🎀

Okay bestie, the summoning circle looks like this:

#include <gnurl/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. That's the move. 🫶

Applications wishing to resume an RTSP session on another connection should retrieve this info before closing the active connection. Literally grab it before the connection dips, iykyk.

The id pointer will be NULL or pointing to private memory you MUST NOT free — it gets freed when you call curl_easy_cleanup(3) on the corresponding CURL handle.

⚠️ Do not free that id pointer! It's private memory. It gets freed when you call curl_easy_cleanup(3) on the corresponding CURL handle. Not me warning you twice — this is important, fr fr. 💅

🌈 PROTOCOLS 🌈

RTSP. That's the entire protocol guest list, no cap. 💜

🌸 EXAMPLE 🌸

Here's the code moment — keep it exact, bestie:

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

👑 AVAILABILITY 👑

Added in 7.20.0. Vintage but still iconic. 🎀

⭐ RETURN VALUE ⭐

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. Vibe check: supported = CURLE_OK, not supported = CURLE_UNKNOWN_OPTION. Periodt. 🔥

🧚 SEE ALSO 🧚

Go peek at curl_easy_getinfo(3), curl_easy_setopt(3), — yes, that trailing comma is canon. 🙈

xoxo 💖 — this page is from libcurl 7.44.0, dated 12 Sep 2015, and it's GNURLINFO...SESSION_ID(3), signing off. Stay hydrated and don't free private memory. 🧚💜