gnutls_x509_crq_get_pk_oid(3)

✨ gnutls_x509_crq_get_pk_oid(3) ✨

okay bestie, gather round πŸ’– this one lives in the gnutls manual, and it's all about pulling the OID of a public key algorithm out of a certificate request. yes, an OID. the lil dotted-number situation. let's get into it πŸŽ€


🌸 NAME 🌸

gnutls_x509_crq_get_pk_oid β€” lowkey an API function, highkey useful πŸ‘‘


πŸ¦‹ SYNOPSIS πŸ¦‹

#include <gnutls/x509.h>

int gnutls_x509_crq_get_pk_oid(gnutls_x509_crq_t crq, char * oid, size_t
* oid_size);

πŸ’… ARGUMENTS πŸ’…

  • gnutls_x509_crq_t crq β€” bestie this should contain a gnutls_x509_crq_t type. that's the vibe check βœ…
  • char * oid β€” a pointer to a buffer to hold the OID. and no, it's not mandatory β€” it may be null πŸ™ˆ
  • size_t * oid_size β€” initially holds the size of oid. it's giving "tell me how much room you've got" πŸ“

🌈 DESCRIPTION 🌈

so like, this function will return the OID of the public key algorithm on that certificate request. periodt. 🫢

and why would you need that, you ask? because sometimes gnutls_x509_crq_get_pk_algorithm() comes back with GNUTLS_PK_UNKNOWN 😭 and when that happens, this is your main character move. it's the fallback bestie. the "the algorithm function didn't know so let me get the raw OID instead" situation. iconic honestly ✨


⭐ RETURNS ⭐

zero, or a negative error code on error. simple as that πŸ’€


πŸŽ€ SINCE πŸŽ€

3.5.0 β€” been here a minute, no cap 🧚


πŸ’œ REPORTING BUGS πŸ’œ

found something cursed? report bugs 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. (yep, all of that, verbatim, they're very serious about the notice staying put 🫑)


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


ok that's the whole thing, every flag, every arg, every line, nothing skipped πŸ’– go forth and fetch those OIDs, bestie πŸ¦‹

mwah πŸ’‹ β€” this page came to you from the gnutls 3.8.13 era, gnutls_x509_crq_get_pk_oid(3), and yes she ate and left no crumbs πŸ‘‘βœ¨

πŸ“¦ where this page comes from