"Fossies" - the Fresh Open Source Software Archive

Member "libressl-2.9.2/man/DSA_SIG_new.3" (24 Mar 2018, 4256 Bytes) of package /linux/misc/libressl-2.9.2.tar.gz:


Caution: As a special service "Fossies" has tried to format the requested manual source page into HTML format but links to other man pages may be missing or even errorneous. Alternatively you can here view or download the uninterpreted manual source code. A member file download can also be achieved by clicking within a package contents listing on the according byte size field.

DSA_SIG_NEW(3) BSD Library Functions Manual DSA_SIG_NEW(3)

NAME

DSA_SIG_new, DSA_SIG_free, DSA_SIG_get0, DSA_SIG_set0 — manipulate DSA signature objects

SYNOPSIS

#include <openssl/dsa.h>

DSA_SIG *

DSA_SIG_new(void);

void

DSA_SIG_free(DSA_SIG *sig);

void

DSA_SIG_get0(const DSA_SIG *sig, const BIGNUM **r, const BIGNUM **s);

int

DSA_SIG_set0(DSA_SIG *sig, BIGNUM *r, BIGNUM *s);

DESCRIPTION

DSA_SIG_new() allocates an empty DSA_SIG structure.

DSA_SIG_free() frees the DSA_SIG structure and its components. The values are erased before the memory is returned to the system. If sig is a NULL pointer, no action occurs.

DSA_SIG_get0() retrieves internal pointers to the r and s values contained in sig.

The r and s values can be set by calling DSA_SIG_set0(). Calling this function transfers the memory management of the values to sig, and therefore they should not be freed by the caller.

RETURN VALUES

If the allocation fails, DSA_SIG_new() returns NULL and sets an error code that can be obtained by ERR_get_error(3). Otherwise it returns a pointer to the newly allocated structure.

DSA_SIG_set0() returns 1 on success or 0 on failure.

SEE ALSO

DSA_do_sign(3), DSA_new(3), ERR_get_error(3)

HISTORY

DSA_SIG_new() and DSA_SIG_free() first appeared in OpenSSL 0.9.3 and have been available since OpenBSD 2.6.

DSA_SIG_get0() and DSA_SIG_set0() first appeared in OpenSSL 1.1.0 and have been available since OpenBSD 6.3.

BSD March 23, 2018 BSD