CURLOPT_RTSP_TRANSPORT(3)

📦
version 8.18.0 · 24 versions
, in fedora 44

💅 CURLOPT_RTSP_TRANSPORT(3) — the RTSP Transport: header glow-up

okay so bestie, welcome to the CURLOPT_RTSP_TRANSPORT(3) page from the Library Functions Manual — yes we're in libcurl land and this one is lowkey iconic if you're doing RTSP stuff 🎀

✨ SYNOPSIS ✨

like, here's the whole vibe in code:

#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RTSP_TRANSPORT,
                          char *transport);

🌸 DESCRIPTION 🌸

so you pass a char pointer and it literally tells libcurl what to send as the Transport: header for this RTSP session 🦋

it's mainly a convenience method — the whole point is to avoid needing to set a custom Transport: header for every single SETUP request. imagine doing that manually every time, no thank you 💀

⚠️ important bestie: the application must set a Transport: header before issuing a SETUP request. that's not optional, periodt.

and the slay part? the application does not have to keep the string around after setting this option. set it and forget it, main character energy 👑

🧚 DEFAULT 🧚

NULL

🌈 PROTOCOLS 🌈

this functionality affects rtsp only. rtsp girlies only, iykyk 💅

⭐ EXAMPLE ⭐

here's how it's giving in practice:

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL, "rtsp://example.com/");
    curl_easy_setopt(curl, CURLOPT_RTSP_REQUEST, CURL_RTSPREQ_SETUP);
    curl_easy_setopt(curl, CURLOPT_RTSP_TRANSPORT,
                     "RTP/AVP;unicast;client_port=4588-4589");
    result = curl_easy_perform(curl);
    curl_easy_cleanup(curl);
  }
}

💜 HISTORY 💜

fun little lore drop: CURL_RTSPREQ_* enums became long types in 8.13.0. before that version, a long cast was necessary when passed to curl_easy_setopt(3). the more you know 🌟

🫶 AVAILABILITY 🫶

added in curl 7.20.0 — vintage but cute ✨

🔥 RETURN VALUE 🔥

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

  • CURLE_OK (0) means everything was OK 😌
  • non-zero means an error occurred — go check libcurl-errors(3) bestie 😭

👑 SEE ALSO 👑

and that's the whole page, no cap 💖 this libcurl page is dated 2026-10-12 and comes to you from the libcurl fam — talk soon bestie, mwah 🍓💅

📦 where this page comes from