GNUTLS_PKCS7_PRINT_SIGNATURE_INFO(3)

πŸ’– gnutls_pkcs7_print_signature_info(3) πŸ’–

okay bestie, so this one lives in the gnutls manual (yes, that gnutls) and it's literally just "make this PKCS7 signature info look cute for a human to read". we love a glow-up function. ✨


🌸 NAME 🌸

gnutls_pkcs7_print_signature_info β€” an API function that pretty-prints your PKCS7 signature info πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

#include <gnutls/pkcs7.h>

int gnutls_pkcs7_print_signature_info(gnutls_pkcs7_signature_info_st *
info, gnutls_certificate_print_formats_t format, gnutls_datum_t * out);

like yes, that's the whole vibe. three args, one int. slay. πŸ’…


✨ ARGUMENTS ✨

  • gnutls_pkcs7_signature_info_st * info β€” the PKCS7 signature info struct you want printed, bestie. this is the main character of the operation. πŸ‘‘
  • gnutls_certificate_print_formats_t format β€” tells the function which format to use. pick your aesthetic. 🌈
  • gnutls_datum_t * out β€” a newly allocated datum holding a null-terminated string. it's fresh, it's new, it's yours. 🫢

πŸ’œ DESCRIPTION πŸ’œ

so basically this function will pretty print a PKCS 7 signature info structure, and it's suitable for display to a human β€” meaning it's not giving raw bytes energy, it's giving "here's something your eyeballs can actually read" energy. 😭

rn the supported formats are GNUTLS_CRT_PRINT_FULL and GNUTLS_CRT_PRINT_COMPACT. that's it. those two. no cap. πŸ”₯

okay important bestie: the output out needs to be deallocated using gnutls_free(). do not forget this. leaking memory is not the vibe. πŸ’€

⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned πŸŽ‰ β€” otherwise you get a negative error value, which is the function's way of saying "no ❀️".


🧚 SINCE 🧚

3.6.14 β€” she's been here since 3.6.14, iconic behavior honestly.


πŸ™ˆ REPORTING BUGS πŸ™ˆ

found a bug? don't be shy, 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: go off, 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, no crumbs left behind πŸ’… this was brought to you by gnutls 3.8.13 β€” gnutls_pkcs7_print_signature_info(3), signing off 🫢✨

πŸ“¦ where this page comes from