NAME

ERR_new, ERR_set_debug, ERR_set_error, ERR_vset_error - Error recording building blocks

SYNOPSIS

 #include <openssl/err.h>

 void ERR_new(void);
 void ERR_set_debug(const char *file, int line, const char *func);
 void ERR_set_error(int lib, int reason, const char *fmt, ...);
 void ERR_vset_error(int lib, int reason, const char *fmt, va_list args);

DESCRIPTION

The functions described here are generally not used directly, but rather through macros such as BIO_snprintf(3) to form the additional data string, which is allocated and store in the error record.

ERR_vset_error() works like ERR_set_error(), but takes a va_list argument instead of a variable number of arguments.

RETURN VALUES

ERR_new, ERR_set_debug, ERR_set_error and ERR_vset_error do not return any values.

NOTES

The library number is unique to each unit that records errors. OpenSSL has a number of pre-allocated ones for its own uses, but others may allocate their own library number dynamically with ERR_load_strings(3).

Provider authors are supplied with core versions of these functions, see SEE ALSO

ERR_get_next_error_library(3), BIO_snprintf(3), COPYRIGHT

Copyright 2000-2019 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.