gnutls_srtp_get_keys(3)

✨ gnutls_srtp_get_keys(3) ✨

okay so bestie, welcome to the gnutls manual 💖 this one's all about gnutls_srtp_get_keys, and yes it's the SRTP key-material helper you've been looking for, no cap.

---

🌸 NAME 🌸

gnutls_srtp_get_keys — it's an API function, periodt 💅

---

🦋 SYNOPSIS 🦋

#include <gnutls/gnutls.h>

int gnutls_srtp_get_keys(gnutls_session_t session, void * key_material,
unsigned int key_material_size, gnutls_datum_t * client_key,
gnutls_datum_t * client_salt, gnutls_datum_t * server_key,
gnutls_datum_t * server_salt);

---

🎀 ARGUMENTS 🎀

• gnutls_session_t session — bestie this is a gnutls_session_t type, that's the whole vibe 🌈
• void * key_material — the space where the generated key material goes 🫶
• unsigned int key_material_size — the maximum size of the key material, like the ceiling, the limit, the moment 🙈
• gnutls_datum_t * client_key — the master client write key, and it points inside the key material 👑
• gnutls_datum_t * client_salt — the master client write salt, also pointing inside the key material ✨
• gnutls_datum_t * server_key — the master server write key, pointing inside the key material too 💜
• gnutls_datum_t * server_salt — the master server write salt, yep, pointing inside the key material 🍓

---

💖 DESCRIPTION 💖

so this is a lil helper function that generates the keying material for SRTP 🌸 it's giving "let me handle the keys for you" energy.

the way that it works: you gotta pre-allocate the space for the key material yourself. and it should be at least 2x the maximum key size and salt size — do not skimp on the buffer, bestie, that's the vibe check right there.

then client_key, client_salt, server_key and server_salt are convenience datums that point inside the key material. lowkey iconic. and plot twist: they may be NULL 💅

---

⭐ RETURNS ⭐

on success, the size of the key material is returned 🎉 slay.

otherwise you get GNUTLS_E_SHORT_MEMORY_BUFFER if the buffer you gave is not sufficient (oof, not enough room 😭), or a negative error code.

since 3.1.4 — an OG, fr fr.

---

🐛 REPORTING BUGS 🐛

found a bug? don't be shy, report it to <bugs@gnutls.org> 🫶

home page: https://www.gnutls.org

---

👑 COPYRIGHT 👑

Copyright © 2001-2023 Free Software Foundation, Inc., and others.

copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. (basically: be nice, keep the receipts 💜)

---

🌈 SEE ALSO 🌈

the full documentation for gnutls is maintained as a Texinfo manual 📚 if the /usr/share/doc/gnutls/ directory does not contain the HTML form, visit:

https://www.gnutls.org/manual/

---

and that's the whole page, bestie ✨ that was gnutls manual, version 3.8.13, for gnutls_srtp_get_keys(3) — go forth and generate that key material, you absolute main character 💅🎀🦋