gnutls_record_recv_seq(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

💖 gnutls_record_recv_seq — the gnutls manual page, bestie edition 💖

okay so you're deep in the gnutls docs, huh? love that for you. this one lives in the gnutls manual (section 3, the library calls), and it's all about grabbing data off a session and peeking at which packet it came from. let's get into it 🫶

✨ NAME ✨

gnutls_record_recv_seq — it's an API function, babes. that's the whole name. iconic, honestly.

🌸 SYNOPSIS 🌸

#include <gnutls/gnutls.h>

ssize_t gnutls_record_recv_seq(gnutls_session_t session, void * data,
       size_t data_size, unsigned char * seq);

like… look at her. four little params and a dream ✨

🎀 ARGUMENTS 🎀

  • gnutls_session_t session — this is a gnutls_session_t type. that's it, that's the whole vibe. it's your session, your girl, your connection 💅
  • void * data — the buffer that the data will be read into. so like, the lil basket where the bytes land 🧺
  • size_t data_size — the number of requested bytes. how many you're asking for, bestie.
  • unsigned char * seq — this is the packet's 64-bit sequence number. it should have space for 8 bytes. yes, eight. count them. don't be stingy with the buffer 😭

🦋 DESCRIPTION 🦋

okay so picture gnutls_record_recv(). this function is literally the same thing, EXCEPT it also hands you back the sequence number of the data alongside the data itself. that's the whole plot twist.

why do you care? because in DTLS, record packets might be received out-of-order. the universe is chaos, packets show up whenever they want, no cap. so having that sequence number is lowkey essential.

the returned 8-byte sequence number is an integer in big-endian format, and you should treat it as a unique message identification. it's giving "this specific packet, and no other." periodt 💅

👑 RETURNS 👑

  • the number of bytes received, and zero on EOF
  • a negative error code is returned in case of an error
  • heads up: the number of bytes received might be less than data_size. don't come for her, that's just how it is 🙈

⭐ SINCE ⭐

3.0 — she's been here a minute. seasoned. veteran behavior 🌈

💀 REPORTING BUGS 💀

found a bug? don't suffer in silence, tell the people:

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 off, just 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, go visit:

https://www.gnutls.org/manual/
bestie reminder: if the local docs ghost you, the website will never ghost you 🫶

and that's the page, fr fr 💖 this was gnutls_record_recv_seq(3) from the gnutls manual, version 3.8.13 — mwah, slay, go read your packets in order (or don't, that's literally what seq is for) 💅🎀

📦 where this page comes from