CURLINFO_RTSP_SESSION_ID(3)

✨ CURLINFO_RTSP_SESSION_ID ✨

okay so bestie, welcome to the Library Functions Manual 💖 — this is the page for CURLINFO_RTSP_SESSION_ID, and it's literally about grabbing your RTSP session ID so you can keep the vibe going across connections. no cap, it's iconic. 🎀

---

🌸 NAME 🌸

CURLINFO_RTSP_SESSION_ID — the RTSP session ID, and yes it's exactly what it sounds like, bestie ✨

---

🦋 SYNOPSIS 🦋

#include <curl/curl.h>

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

---

💅 DESCRIPTION 💅

so here's the tea ☕: you pass a pointer to a char pointer, and it receives a pointer to a string that holds the most recent RTSP Session ID. literally the freshest session ID you've got, periodt. 🫶

now, if your application wants to resume an RTSP session on another connection, you should retrieve this info before closing the active connection — that's the whole point, bestie, don't close the door before you grab the keys 🔑✨

⚠️ okay important vibe check: the id pointer is NULL or points to private memory. you must not free it — do not do it, not today, not ever 💀 the memory gets freed automatically when you call curl_easy_cleanup(3) on the corresponding curl handle. so just let it be, she's taken care of 💅

---

🧚 PROTOCOLS 🧚

this functionality affects rtsp only — like, it's rtsp-exclusive, iykyk 🦋

---

✨ EXAMPLE ✨

okay here's the whole flex, bestie — a full little main function showing you the moves 💖

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 🎀

this icon was Added in curl 7.20.0 — vintage but still slaying 💅✨

---

🌈 RETURN VALUE 🌈

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

• CURLE_OK (0) — everything was OK, we love to see it 👑
• non-zero — an error occurred 😭 see libcurl-errors(3) for the deets

---

🔥 SEE ALSO 🔥

• CURLINFO_RTSP_CSEQ_RECV(3)
• curl_easy_getinfo(3)
• curl_easy_setopt(3)

---

that's the whole page, bestie! 💖🫶 this was libcurl, dated 2026-10-12, and the page is CURLINFO_RTSP_SESSION_ID(3) — now go slay those RTSP sessions, periodt ✨💅🎀