From 9801989e860e4a1fd754ba6d1dfda898c899b0d4 Mon Sep 17 00:00:00 2001 From: Ard Biesheuvel Date: Sun, 30 May 2004 22:04:43 +0000 Subject: [PATCH] Added more elaborate description of transaction & fetch flags Added new service API constants git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@160105 c90b9560-bf6c-de11-be94-00142212c4b1 --- reference/ibase/constants.xml | 752 ++++++++++++++++++++++++++-------- 1 file changed, 584 insertions(+), 168 deletions(-) diff --git a/reference/ibase/constants.xml b/reference/ibase/constants.xml index 3a48d9c0c1..c39656479a 100644 --- a/reference/ibase/constants.xml +++ b/reference/ibase/constants.xml @@ -1,175 +1,591 @@ - +
&reftitle.constants; &extension.constants; - - - - IBASE_DEFAULT - (integer) - - - - - - - - - - IBASE_TEXT - (integer) - - - - - - - - - - IBASE_UNIXTIME - (integer) - - - - - - - - - - IBASE_WRITE - (integer) - - - - Access mode - - - - - - IBASE_READ - (integer) - - - - Access mode - - - - - - IBASE_COMMITTED - (integer) - - - - Isolation level - - - - - - IBASE_CONSISTENCY - (integer) - - - - Isolation level - - - - - - IBASE_CONCURRENCY - (integer) - - - - Isolation level (default) - - - - - - IBASE_REC_VERSION - (integer) - - - - - - - - - - IBASE_REC_NO_VERSION - (integer) - - - - - - - - - - IBASE_NOWAIT - (integer) - - - - Lock resolution - - - - - - IBASE_WAIT - (integer) - - - - Lock resolution (default) - - - - - - IBASE_TIMESTAMP - (integer) - - - - - - - - - - IBASE_DATE - (integer) - - - - - - - - - - IBASE_TIME - (integer) - - - - - - - - + + The following constants can be passed to ibase_trans + to specify transaction behaviour. + + Firebird/InterBase transaction flags + + + + Constant + Description + + + + + IBASE_DEFAULT + + The default transaction settings are to be used. This default is + determined by the client library, which defines it as + IBASE_WRITE|IBASE_CONCURRENCY|IBASE_WAIT in most cases. + + + IBASE_READ + Starts a read-only transaction. + + + IBASE_WRITE + Starts a read-write transaction. + + + IBASE_CONSISTENCY + Starts a transaction with the isolation level set to + 'consistency', which means the transaction cannot read from tables + that are being modified by other concurrent transactions. + + + IBASE_CONCURRENCY + Starts a transaction with the isolation level set to + 'concurrency' (or 'snapshot'), which means the transaction + has access to all tables, but cannot see changes that were committed + by other transactions after the transaction was started. + + + IBASE_COMMITTED + Starts a transaction with the isolation level set to + 'read committed'. This flag should be combined with either + IBASE_REC_VERSION or + IBASE_REC_NO_VERSION. This isolation level + allows access to changes that were committed after the transaction + was started. If IBASE_REC_NO_VERSION was + specified, only the latest version of a row can be read. If + IBASE_REC_VERSION was specified, a row can + even be read when a modification to it is pending in a concurrent + transaction. + + + + IBASE_WAIT + Indicated that a transaction should wait and retry when a + conflict occurs. + + + IBASE_NOWAIT + Indicated that a transaction should fail immediately when a + conflict occurs. + + + +
+ + + + The following constants can be passed to ibase_fetch_row, + ibase_fetch_assoc or ibase_fetch_object + to specify fetch behaviour. + + Firebird/InterBase fetch flags + + + + Constant + Description + + + + + IBASE_FETCH_BLOBS + Also available as IBASE_TEXTfor backward + compatibility. Causes BLOB contents to be fetched inline, instead of + being fetched as BLOB identifiers. + + + IBASE_FETCH_ARRAYS + Causes arrays to be fetched inline. Otherwise, array + identifiers are returned. Array identifiers can only be used as + arguments to INSERT operations, as no functions to handle array + identifiers are currently available. + + + + IBASE_UNIXTIME + Causes date and time fields not to be returned as strings, + but as UNIX timestamps (the number of seconds since the epoch, which + is 1-Jan-1970 0:00 UTC). Might be problematic if used with dates + before 1970 on some systems. + + + + +
+ + + The following constants are used to pass requests and options to the service + API functions (ibase_server_info, ibase_db_info + , ibase_backup, ibase_restore + and ibase_maintain_db). Please refer to + the Firebird/InterBase manuals for the meaning of these options. + + + + IBASE_BKP_IGNORE_CHECKSUMS + + + + + + + + + IBASE_BKP_IGNORE_LIMBO + + + + + + + + + IBASE_BKP_METADATA_ONLY + + + + + + + + + IBASE_BKP_NO_GARBAGE_COLLECT + + + + + + + + + IBASE_BKP_OLD_DESCRIPTIONS + + + + + + + + + IBASE_BKP_NON_TRANSPORTABLE + + + + + + + + + IBASE_BKP_CONVERT + + + + Options to ibase_backup() + + + + + + IBASE_RES_DEACTIVATE_IDX + + + + + + + + + IBASE_RES_NO_SHADOW + + + + + + + + + IBASE_RES_NO_VALIDITY + + + + + + + + + IBASE_RES_ONE_AT_A_TIME + + + + + + + + + IBASE_RES_REPLACE + + + + + + + + + IBASE_RES_CREATE + + + + + + + + + IBASE_RES_USE_ALL_SPACE + + + + Options to ibase_restore + + + + + + IBASE_PRP_PAGE_BUFFERS + + + + + + + + + IBASE_PRP_SWEEP_INTERVAL + + + + + + + + + IBASE_PRP_SHUTDOWN_DB + + + + + + + + + IBASE_PRP_DENY_NEW_TRANSACTIONS + + + + + + + + + IBASE_PRP_DENY_NEW_ATTACHMENTS + + + + + + + + + IBASE_PRP_RESERVE_SPACE + + + + + + + + + IBASE_PRP_RES_USE_FULL + + + + + + + + + IBASE_PRP_RES + + + + + + + + + IBASE_PRP_WRITE_MODE + + + + + + + + + IBASE_PRP_WM_ASYNC + + + + + + + + + IBASE_PRP_WM_SYNC + + + + + + + + + IBASE_PRP_ACCESS_MODE + + + + + + + + + IBASE_PRP_AM_READONLY + + + + + + + + + IBASE_PRP_AM_READWRITE + + + + + + + + + IBASE_PRP_SET_SQL_DIALECT + + + + + + + + + IBASE_PRP_ACTIVATE + + + + + + + + + IBASE_PRP_DB_ONLINE + + + + + + + + + IBASE_RPR_CHECK_DB + + + + + + + + + IBASE_RPR_IGNORE_CHECKSUM + + + + + + + + + IBASE_RPR_KILL_SHADOWS + + + + + + + + + IBASE_RPR_MEND_DB + + + + + + + + + IBASE_RPR_VALIDATE_DB + + + + + + + + + IBASE_RPR_FULL + + + + + + + + + IBASE_RPR_SWEEP_DB + + + + Options to ibase_maintain_db + + + + + + IBASE_STS_DATA_PAGES + + + + + + + + + IBASE_STS_DB_LOG + + + + + + + + + IBASE_STS_HDR_PAGES + + + + + + + + + IBASE_STS_IDX_PAGES + + + + + + + + + IBASE_STS_SYS_RELATIONS + + + + Options to ibase_db_info + + + + + + IBASE_SVC_SERVER_VERSION + + + + + + + + + IBASE_SVC_IMPLEMENTATION + + + + + + + + + IBASE_SVC_GET_ENV + + + + + + + + + IBASE_SVC_GET_ENV_LOCK + + + + + + + + + IBASE_SVC_GET_ENV_MSG + + + + + + + + + IBASE_SVC_USER_DBPATH + + + + + + + + + IBASE_SVC_SVR_DB_INFO + + + + + + + + + IBASE_SVC_GET_USERS + + + + Options to ibase_server_info + + + + +