DSA_SIG_NEW(3SSL)

📦
version 4.0.3 · 14 versions
, in ubuntu stonking

💖 DSA_SIG_NEW 💖

okay bestie, gather round, because we're doing the DSA_SIG_NEW(3SSL) page from the OpenSSL manual and it's genuinely so much less scary than it sounds ✨

this is the whole little family of functions that allocate and free DSA signature objects — your r and s, packaged up cute. let's get into it 💅

🎀 SYNOPSIS 🎀

first, the ritual. you gotta include the header or nothing works, no cap:

#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);

like... look at that. four little functions. one struct. main character energy fr fr 👑

🌸 DESCRIPTION 🌸

✨ DSA_SIG_new() — birth of a struct

it allocates an empty DSA_SIG structure. that's it. that's the job. a fresh, blank, hopeful little signature object 🦋

💀 DSA_SIG_free() — the farewell tour

this one frees the DSA_SIG structure and its components.

and here's the part that lowkey matters: the values are erased before the memory is returned to the system. so it's not just "eh, whatever, hand it back" — it scrubs first. icons only 🔥

also if the argument is NULL, nothing happens. it just... doesn't. no drama, no crash, nothing is done 🙈

👀 DSA_SIG_get0() — the peek

it returns internal pointers to the r and s values contained in sig. you're not getting copies, bestie — you're getting pointers into the thing. iykyk 🫶

🎁 DSA_SIG_set0() — the handoff

you set the r and s values by calling DSA_SIG_set0() and passing in the new values for r and s as parameters.

⚠️ okay this is the one you have to actually read. calling this function transfers the memory management of the values to the DSA_SIG object. which means the values you passed in should NOT be freed directly after this function has been called. the struct owns them now. hands off. periodt 💅

🌈 RETURN VALUES 🌈

  • DSA_SIG_new() — if the allocation fails it returns NULL and sets an error code that you can snag with ERR_get_error(3). otherwise it returns a pointer to the newly allocated structure. so: NULL = sad, pointer = slay 💖
  • DSA_SIG_free() — returns no value. it's a void. it gives you nothing back and that's fine, it's not that kind of function 😌
  • DSA_SIG_set0() — returns 1 on success or 0 on failure. classic. binary. decisive. we love a clear answer ✨

🧚 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>.

k that's the whole page, you ate it, i'm so proud 🥹💜

version 4.0.3 · dated 2026-09-29 · DSA_SIG_NEW(3SSL) — mwah, go write some secure code bestie 💅✨

📦 where this page comes from