gnutls_x509_crt_get_pk_ecc_raw(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_x509_crt_get_pk_ecc_raw(3) ✨

okay bestie so this is a page from the gnutls manual, and today's main character is gnutls_x509_crt_get_pk_ecc_raw 💖 it's an API function, and it's about pulling the elliptic-curve public key parameters out of a certificate. yes, that kind of certificate. let's go 🦋

🌸 NAME 🌸

gnutls_x509_crt_get_pk_ecc_raw — literally just, API function 💅 no cap.

🎀 SYNOPSIS 🎀

#include <gnutls/x509.h>

int gnutls_x509_crt_get_pk_ecc_raw(gnutls_x509_crt_t crt,
gnutls_ecc_curve_t * curve, gnutls_datum_t * x, gnutls_datum_t * y);

like. look at her. four arguments, one return value, zero drama 🌈

💜 ARGUMENTS 💜

  • gnutls_x509_crt_t crt — holds the certificate. she's the one carrying the whole thing, respect her 👑
  • gnutls_ecc_curve_t * curve — will hold the curve. yep, she gets filled in for you ✨
  • gnutls_datum_t * x — will hold the x-coordinate 🍓
  • gnutls_datum_t * y — will hold the y-coordinate 💖

🧚 DESCRIPTION 🧚

so this function will export the ECC public key's parameters found in the given certificate. that's it, that's the vibe.

the new parameters will be allocated using gnutls_malloc() and will be stored in the appropriate datum. so like, you own that memory now — that's a you problem, bestie, don't forget to free it 🙈

and here's the lil plot twist: in EdDSA curves the y parameter will be NULL and the other parameters will be in the native format for the curve. not me finding that out the hard way 😭 it's giving "the rules are different here" and honestly? iconic.

⭐ RETURNS ⭐

GNUTLS_E_SUCCESS on success — slay 💅 otherwise a negative error code, which is the universe's way of saying "no <3" 💀

🦋 SINCE 🦋

3.4.1 — she's been around, she's not new here, lowkey a legend ⭐

😤 REPORTING BUGS 😤

found a bug? not the cute kind? report it, fr fr:

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, share it, 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 visit

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

and that's the whole page, bestie 💖 this was gnutls 3.8.13 energy, mwah, go read your certificate's curves, stay hydrated, and remember: free your datums 🎀✨

📦 where this page comes from