Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

ERR_remove_state (3openssl)

Name

ERR_remove_state - free a thread's error queue

Synopsis

#include <openssl/err.h>

void ERR_remove_thread_state(const CRYPTO_THREADID *tid);

Deprecated:

void ERR_remove_state(unsigned long pid);

Description

OpenSSL                                             ERR_remove_state(3openssl)



NAME
       ERR_remove_thread_state, ERR_remove_state - free a thread's error queue

SYNOPSIS
        #include <openssl/err.h>

        void ERR_remove_thread_state(const CRYPTO_THREADID *tid);

       Deprecated:

        void ERR_remove_state(unsigned long pid);

DESCRIPTION
       ERR_remove_thread_state() frees the error queue associated with thread
       tid.  If tid == NULL, the current thread will have its error queue
       removed.

       Since error queue data structures are allocated automatically for new
       threads, they must be freed when threads are terminated in order to
       avoid memory leaks.

       ERR_remove_state is deprecated and has been replaced by
       ERR_remove_thread_state. Since threads in OpenSSL are no longer
       identified by unsigned long values any argument to this function is
       ignored. Calling ERR_remove_state is equivalent to
       ERR_remove_thread_state(NULL).

RETURN VALUE
       ERR_remove_thread_state and ERR_remove_state() return no value.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+--------------------------+
       |ATTRIBUTE TYPE |     ATTRIBUTE VALUE      |
       +---------------+--------------------------+
       |Availability   | library/security/openssl |
       +---------------+--------------------------+
       |Stability      | Pass-through uncommitted |
       +---------------+--------------------------+

SEE ALSO
       err(3)

HISTORY
       ERR_remove_state() is available in all versions of SSLeay and OpenSSL.
       It was deprecated in OpenSSL 1.0.0 when ERR_remove_thread_state was
       introduced and thread IDs were introduced to identify threads instead
       of 'unsigned long'.



NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       https://www.openssl.org/source/openssl-1.0.2ze.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.openssl.org/.



1.0.2ze                           2022-05-03
                                                    ERR_remove_state(3openssl)