gnutls_certificate_type_get2(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_certificate_type_get2 ✨

okay bestie, welcome to the gnutls manual page for gnutls_certificate_type_get2(3) — yes it's a whole function and yes it's iconic 💅 let's get into it

🦋 SYNOPSIS 🦋

#include <gnutls/gnutls.h>

gnutls_certificate_type_t gnutls_certificate_type_get2(gnutls_session_t
session, gnutls_ctype_target_t target);

like. look at her. she's serving signature 🎀

🌸 ARGUMENTS 🌸

  • gnutls_session_t session — bestie this is a gnutls_session_t type. that's the whole vibe. it's your session 🫶
  • gnutls_ctype_target_t target — and this one is a gnutls_ctype_target_t type. mhm. exactly what it says on the tin ✨

💖 DESCRIPTION 💖

so what does she do. she returns the type of certificate that a side is negotiated to use. periodt 💅

by default the certificate type is X.509 — that's the default, no cap — unless an alternative certificate type got enabled by gnutls_init() and then negotiated during the session. so like, only if someone actually turned that on 🌈

now the target parameter? she's the one who decides whose negotiated certificate type you're asking about:

  • GNUTLS_CTYPE_CLIENT — gimme the negotiated cert type for the client 💙
  • GNUTLS_CTYPE_SERVER — gimme the negotiated cert type for the server 💜

and then, plot twist, in P2P mode connection setups where you genuinely don't know in advance who's gonna be the client and who's gonna be the server (main character chaos energy honestly 😭), you can use these flags instead:

  • GNUTLS_CTYPE_OURS — retrieves the corresponding cert type for us 👑
  • GNUTLS_CTYPE_PEERS — retrieves the corresponding cert type for our peers 🧚

also important bestie: resumed sessions will return the certificate type that was negotiated and used in the original session. the original one. not a new one. so that means this function can be used to reliably determine the type of the certificate returned by gnutls_certificate_get_peers(). slay 🔥 that's genuinely useful, fr fr.

⭐ RETURNS ⭐

the currently used gnutls_certificate_type_t certificate type — for the client or the server, depending on what you asked for. simple as 🎀

🕰️ SINCE 🕰️

3.6.4 — she's been here a minute, she's a seasoned queen 👑

🙈 REPORTING BUGS 🙈

found a bug? not me gatekeeping — report it, please and thank you 💌

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. keep the notice. that's the rule. respect the queen's paperwork 💅)

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

iykyk ✨

lowkey a reminder: the descriptions above are the whole truth and nothing but — don't go assuming extra behaviour, bestie, the manpage said what it said 🌸

and that's the page!! this lil beauty lives in the gnutls manual, version 3.8.13, dated alongside gnutls_certificate_type_get2(3) 🎀 go forth and negotiate your certificate types responsibly, mwah 💋🦋✨

📦 where this page comes from