Firebird 2.1 Release Notes

Changes to the Firebird API and ODS
New Function for Delivering Error Text
C. Valderrama
The new function fb_interpret() replaces the former isc_interprete() for extracting the text for a Firebird
error message from the error status vector to a client buffer.
Important
isc_interprete() is vulnerable to overruns and is deprecated as unsafe. The new function should be used instead.
Accommodation of New Shutdown Parameters
D. Yemanov
API Access to database shutdown is through flags appended to the isc_dpb_shutdown parameter in the DBP
argument passed to isc_attach_database(). The symbols for the flags are:
#define isc_dpb_shut_cache 0x1
#define isc_dpb_shut_attachment 0x2
#define isc_dpb_shut_transaction 0x4
#define isc_dpb_shut_force 0x8
#define isc_dpb_shut_mode_mask 0x70
#define isc_dpb_shut_default 0x0
#define isc_dpb_shut_normal 0x10
#define isc_dpb_shut_multi 0x20
#define isc_dpb_shut_single 0x30
#define isc_dpb_shut_full 0x40
Example of Use in C/C++
char dpb_buffer[256], *dpb, *p;
ISC_STATUS status_vector[ISC_STATUS_LENGTH];
isc_db_handle handle = NULL;
dpb = dpb_buffer;
*dpb++ = isc_dpb_version1;
const char* user_name = “SYSDBA”;
const int user_name_length = strlen(user_name);
*dpb++ = isc_dpb_user_name;
*dpb++ = user_name_length;
memcpy(dpb, user_name, user_name_length);
dpb += user_name_length;
const char* user_password = “masterkey”;
const int user_password_length = strlen(user_password);
*dpb++ = isc_dpb_password;
*dpb++ = user_password_length;
memcpy(dpb, user_password, user_password_length);
dpb += user_password_length;
21