The DFPAL Library, version 2.20 © Copyright IBM Corporation, 2007. All rights reserved. |
|
[previous | contents | next] | [printer friendly] |
dfpalInit()
.
malloc()
for the application memory allocation. Instead, such applications have their own memory management layer based on shared memory, for example. This function shall be called before dfpalInit()
to determine amount of memory needed by the DFPAL.
dfpalInit()
before any of its service is accessed. The input context
is pointer to allocated memory. This function either returns DFPAL_ERR_NO_ERROR
or an error code indicating error condition. List of possible errors and error codes can be found in dfpalerr.h
. For multi-threaded application, each thread using DFPAL service must initialize using this service. Additionally, application is responsible for making sure that memory passed as an argument is thread safe.
dfpalInit()
reads environment variable DFPAL_EXE_MODE
. Possible values for this environment variable are DNSW
(force DFPAL to use decNumber software mode), PPCHW
(force DFPAL to use PowerPC hardware mode; dfpalInit()
will return error if no hardware support available), or AUTO
(auto detect). Default value, in absence of the environment variable or undefined value, is AUTO
.
dlopen()/dlsym()
. Applications not using runtime linking and loading do not have to use this.
dfpalInit()
call earlier. It takes a pointer to function performing memory de-allocation. Typically, memory de-allocation function is corresponding to one used to allocate memory for the dfpalInit()
.
DNSW
(decNumber Software) if DFPAL is using decNumber software implementation for the decimal floating point arithmetic. Returns PPCHW
(Power PC Hardware) if DFPAL is using hardware decimal floating point arithmetic.
dfpalGetError()
after this function call will return “No error”.
dfpalGetError()
but only returns DFPAL error code.
dfpalInit()
on Unix platforms. On Windows platform, if DFPAL is integrated into some other container module, use that container module’s DllMain()
equivalent facility to call dfpalInitProcessContext()
for DLL_PROCESS_ATTACH
event. Refer to How to compile DFPAL? for more details.
DFPAL is authored by Punit Shah (punit@us.ibm.com).
Please send any corrections, comments or questions to dfpal-l@austin.ibm.com.
This page was updated on 21 Dec 2007. |