gnutls_record_recv_packet(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_packet(3) 💖

okay bestie, welcome to the gnutls manual — this page is literally the gnutls_record_recv_packet API function and it's giving high-performance networking energy ✨

🌸 NAME 🌸

gnutls_record_recv_packet — API function. that's it, that's the name, short and iconic 💅

✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

ssize_t gnutls_record_recv_packet(gnutls_session_t session,
gnutls_packet_t * packet);

look at her. two args, one ssize_t return, no drama 🎀

🦋 ARGUMENTS 🦋

  • gnutls_session_t session — bestie this is a gnutls_session_t type. that's the whole vibe. your session, your rules 👑
  • gnutls_packet_t * packet — the structure that's gonna hold the packet data. it's the little container where your packet goes 🫶

💜 DESCRIPTION 💜

so. this is a lower-level function than gnutls_record_recv() and — hear me out — it lets you directly receive the whole decrypted packet. the way that it avoids a memory copy?? no cap, that's the entire point. it's intended to be used by applications seeking high performance 🔥

the received packet is accessed using gnutls_packet_get() and must be deinitialized using gnutls_packet_deinit(). like, please deinit her, she deserves closure 🙈

also: the returned packet will be NULL if the return value is zero (EOF). EOF means end of file, bestie, the packet is simply not there 💀

⭐ RETURNS ⭐

  • the number of bytes received 💖
  • zero on EOF (for stream connections)
  • a negative error code in case of an error 😭

🎀 SINCE 🎀

3.3.5 — she's been around a minute, a true veteran 👑

🌈 REPORTING BUGS 🌈

found a bug? don't be shy, tell the girlies:

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. (yes bestie, that's the actual legal text, keep it, it's the rule 🫶)

👑 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 page!! this was gnutls version 3.8.13, page gnutls_record_recv_packet(3), brought to you by the gnutls project. mwah, go write some high-performance code bestie 💖✨🎀🦋

📦 where this page comes from