pskc_sign_x509(3)

πŸ’… pskc_sign_x509

okay so bestie, welcome to pskc_sign_x509 β€” part of the libpskc family (that's the manual name, not me being extra). this is the one that puts a signature on your PSKC data using an X.509 certificate, and honestly? iconic behaviour. let's get into it πŸŽ€


✨ SYNOPSIS ✨

#include <pskc.h>

int pskc_sign_x509(pskc_t * container, const char * key_file, const char * cert_file);

like, that's the whole vibe. three args, one int back. slay.


🌸 ARGUMENTS 🌸

  • pskc_t * container β€” a pskc_t handle, which you get from pskc_init(). this is your main character, the actual container object you're signing 🫢
  • const char * key_file β€” filename of the file containing the private key. yes, the private one. guard it with your life, bestie πŸ’€
  • const char * cert_file β€” filename of the file containing the corresponding X.509 certificate. this is the public-facing bestie that matches the key ✨

πŸ’– DESCRIPTION πŸ’–

Sign PSKC data using X.509 certificate and private key.

that's it, that's the whole thing. it takes your container, pairs it up with the private key from key_file and the X.509 cert from cert_file, and signs the PSKC data. it's giving cryptographic commitment. no cap πŸ”₯


⭐ RETURNS ⭐

On success, PSKC_OK (zero) is returned, or an error code.

so like β€” zero means you ate and left no crumbs πŸ‘‘. anything that isn't zero is an error code telling you something went sideways. do a vibe check on it, don't just ignore it 😭


πŸ¦‹ REPORTING BUGS πŸ¦‹

found a bug? don't suffer in silence, bestie. Report bugs to <oath-toolkit-help@nongnu.org>.

literally just tell them. they want to know 🫢


Copyright Β© 2009-2026 Simon Josefsson.

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.

(read that again β€” royalty-free distribution, just keep the notice. generous icon behaviour honestly 🌈)


and that's the page! brought to you by libpskc, version 2.6.15 β€” and since the page itself doesn't stamp a date on it, just know this is the 2.6.15 era libpskc energy πŸ’« go forth and sign your containers, bestie πŸ’…βœ¨

πŸ“¦ where this page comes from