CRYPTOsetexdata(3) OpenSSL CRYPTOsetexdata(3)

NAME
       CRYPTOsetexdata, CRYPTOgetexdata - internal application specific
       data functions

SYNOPSIS
        int CRYPTOsetexdata(CRYPTOEXDATA *r, int idx, void *arg);

        void *CRYPTOgetexdata(CRYPTOEXDATA *r, int idx);

DESCRIPTION
       Several OpenSSL structures can have application specific data attached
       to them.  These functions are used internally by OpenSSL to manipulate
       application specific data attached to a specific structure.

       These functions should only be used by applications to manipulate
       CCRRYYPPTTOOEEXXDDAATTAA structures passed to the nneewwffuunncc(()), ffrreeeeffuunncc(()) and
       dduuppffuunncc(()) callbacks: as passed to RRSSAAggeetteexxnneewwiinnddeexx(()) for example.

       CCRRYYPPTTOOsseetteexxddaattaa(()) is used to set application specific data, the data
       is supplied in the aarrgg parameter and its precise meaning is up to the
       application.

       CCRRYYPPTTOOggeetteexxddaattaa(()) is used to retrieve application specific data. The
       data is returned to the application, this will be the same value as
       supplied to a previous CCRRYYPPTTOOsseetteexxddaattaa(()) call.

RETURN VALUES
       CCRRYYPPTTOOsseetteexxddaattaa(()) returns 1 on success or 0 on failure.

       CCRRYYPPTTOOggeetteexxddaattaa(()) returns the application data or 0 on failure. 0
       may also be valid application data but currently it can only fail if
       given an invalid iiddxx parameter.

       On failure an error code can be obtained from ERRgeterror(3).

SEE ALSO
       RSAgetexnewindex(3), DSAgetexnewindex(3),
       DHgetexnewindex(3)

HISTORY       CRYPTOsetexdata() and CRYPTOgetexdata() have been available since
       SSLeay 0.9.0.



0.9.7l                            2000-01-29             CRYPTOsetexdata(3)