gnutls_record_set_state(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_set_state(3) 💖

okay bestie, welcome to the gnutls manual page for gnutls_record_set_state ✨ — yes it's a mouthful, no you're not gonna forget it, let's go 🌸

🎀 NAME 🎀

gnutls_record_set_state — API function, and she's lowkey iconic for it 💅

✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

int gnutls_record_set_state(gnutls_session_t session, unsigned read,
       const unsigned char [8] seq_number);

there she is 🫶 look at her. three args, one return value, no drama.

🌸 ARGUMENTS 🌸

  • gnutls_session_t session — it's a gnutls_session_t type. that's the whole vibe, that's the whole description, we move 💜
  • unsigned read — if it's non-zero, you're talking about the read parameters. if it's zero, it's the write ones instead. pick your fighter 😌
  • const unsigned char [8] seq_number — a 64-bit sequence number, which is genuinely a lot of number fr fr

🦋 DESCRIPTION 🦋

so this function sets the sequence number in the current record state. that's it, that's the job 👑

and the way this is useful?? it's when sending and receiving get offloaded from gnutls — like, gnutls isn't the one doing the talking anymore, somebody else is, and you need to sync up the numbers. that is, if gnutls_record_get_state() was used. yes, the get one. this is the set one. they're a matching set, they're a duo, they ate 🔥

⭐ RETURNS ⭐

GNUTLS_E_SUCCESS on success, or an error code. classic. no notes 💖

since 3.4.0 — an old queen, respect her 🙈

💀 REPORTING BUGS 💀

found a bug? not on my watch — report it 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. (translation: share it, remix it, just keep the receipt 🧾💜)

🌈 SEE ALSO 🌈

the full documentation for gnutls is maintained as a Texinfo manual 📚 if the /usr/share/doc/gnutls/ directory does NOT have the HTML form, then bestie, you go here:

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

and that's the whole page, we're done, we're free 🦋 this was gnutls_record_set_state(3) from the gnutls 3.8.13 manual 💅 slay, go set some sequence numbers, i'm obsessed with you 🫶✨

📦 where this page comes from