dane_raw_tlsa(3)

📦
version 3.8.13 · 7 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, fedora 43, fedora 44, ubuntu stonking

✨ dane_raw_tlsa ✨ (that's a section-3 gnutls manual page, bestie)

okay so welcome to the gnutls manpage corner of the internet, we're talking about dane_raw_tlsa(3) today and honestly? she's giving glue-code icon energy. let's get into it 💅

🌸 NAME 🌸

dane_raw_tlsa — it's an API function, that's the whole vibe. a whole API function. periodt.

🦋 SYNOPSIS 🦋

#include <gnutls/dane.h>

int dane_raw_tlsa(dane_state_t s, dane_query_t * r, char *const *
dane_data, const int * dane_data_len, int secure, int bogus);

like yes, the signature wraps across lines, that's just how she is, we respect it 💖

🎀 ARGUMENTS 🎀

  • dane_state_t s — the DANE state structure. she's the main character, everything flows through her.
  • dane_query_t * r — a structure where we place the result. she's the little container you're handing over so the function has somewhere to put her findings 🫶
  • char *const * dane_data — an array of DNS rdata items, and it's terminated with a NULL pointer. ⚠️ important, bestie: the caller has to guarantee that the data being pointed at stays valid until dane_query_deinit() gets called. so do NOT go freeing that memory early, that's a whole situation.
  • const int * dane_data_len — the length, in n bytes, of the dane_data items. it's the little measuring tape for each item 🎀
  • int secure — true if the result is validated securely, false if validation failed or the domain queried has no security info. iykyk.
  • int bogus — okay so this one's conditional: if the result was not secure (secure = 0) due to a security failure, and the result is due to a security failure, then bogus is true. yes, the original really does say "security failure" twice, no we are not editing it, we respect the source 💀

🌈 DESCRIPTION 🌈

This function will fill in the TLSA (DANE) structure from the given raw DNS record data. so you show up with raw DNS rdata, and she turns it into a proper TLSA/DANE structure for you. iconic behaviour, truly.

and again, because it bears repeating: the dane_data must be valid during the lifetime of the query. no cap. don't let it expire on her mid-query 🙈

⭐ RETURNS ⭐

On success, DANE_E_SUCCESS (0) is returned, otherwise a negative error value. so if you get a 0 back you're slaying, and if you get something negative... that's a vibe check that did not pass, bestie 😭

💀 REPORTING BUGS 💀

Found a bug? (rude of the code, honestly.) Report bugs to <bugs@gnutls.org>.

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

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. so like, go forth and redistribute, just bring the copyright notice with you 🫶

🔥 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/

like, the directory might have it, but if it doesn't, the link does. either way you're covered 💜

and that's the page!! this was dane_raw_tlsa(3), brought to you by gnutls 3.8.13 — mwah, no notes, go build something cute with it 🌸✨🎀🦋

📦 where this page comes from