DSA_SIG_NEW(3ossl)

📦 version 3.5.0, in opensuse-leap 16.0

💅 DSA_SIG_NEW(3ossl) — aka the DSA_SIG glow-up guide

okay bestie, so this is the OpenSSL manual page for DSA_SIG_get0, DSA_SIG_set0, DSA_SIG_new, and DSA_SIG_free — the whole little friend group that allocates and frees DSA signature objects. yes it's crypto, no you can't skip it, and yes it's lowkey iconic once you get it 🎀

✨ SYNOPSIS ✨

like, literally just include this and you're in:

#include <openssl/dsa.h>

DSA_SIG *DSA_SIG_new(void);
void DSA_SIG_free(DSA_SIG *a);
void DSA_SIG_get0(const DSA_SIG *sig, const BIGNUM **pr, const BIGNUM **ps);
int DSA_SIG_set0(DSA_SIG *sig, BIGNUM *r, BIGNUM *s);

no cap, that's the whole vibe right there 💅

🌸 DESCRIPTION 🌸

  • DSA_SIG_new() — this one's the birther fr fr. it allocates an empty DSA_SIG structure. that's it, that's the whole job. fresh out the box, no values, main character energy 👑
  • DSA_SIG_free() — the responsible friend who cleans up. it frees the DSA_SIG structure and its components. and here's the slay detail: the values get erased before the memory goes back to the system 🧹✨ like, security-conscious queen behavior. also! if the argument is NULL, nothing is done. it just shrugs and moves on, we love a graceful no-op 🫶
  • DSA_SIG_get0() — this one hands you the receipts, but not the real ones — it returns internal pointers to the r and s values contained in sig. so like, peek but don't touch kinda sitch 🙈
  • DSA_SIG_set0() — the setter. you pass in new values for r and s as parameters to the function and boom, they're set. BUT bestie, read this part twice: calling this function transfers the memory management of the values to the DSA_SIG object. so the values you passed in should not be freed directly after this function has been called ⚠️ like, hand over the keys and walk away, don't come back for them.

🔥 RETURN VALUES 🔥

  • if the allocation fails, DSA_SIG_new() returns NULL and sets an error code that you can get with ERR_get_error(3). otherwise it returns a pointer to the newly allocated structure 💖 (cute, functional, does exactly what it says)
  • DSA_SIG_free() returns no value. like, at all. nothing. void. it's giving "my work here is done" 💀
  • DSA_SIG_set0() returns 1 on success or 0 on failure. simple as that, iykyk ✅

🦋 SEE ALSO 🦋

go read these next, bestie, they're all connected:

Copyright 2000-2024 The OpenSSL Project Authors. All Rights Reserved.

Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at <https://www.openssl.org/source/license.html>.

💌 and that's the page!! this whole thing came from OpenSSL 3.5.0, dated 2026-09-25 — so when you cite your sources, cite DSA_SIG_NEW(3ossl) like the academic icon you are 🎓✨ periodt.
📦 where this page comes from