oracledb 3.0.0 → 3.1.2

package/odpi/src/dpiDebug.c

@@ -1,184 +0,0 @@
-//-----------------------------------------------------------------------------
-// Copyright (c) 2017, Oracle and/or its affiliates. All rights reserved.
-// This program is free software: you can modify it and/or redistribute it
-// under the terms of:
-//
-// (i)  the Universal Permissive License v 1.0 or at your option, any
-//      later version (http://oss.oracle.com/licenses/upl); and/or
-//
-// (ii) the Apache License v 2.0. (http://www.apache.org/licenses/LICENSE-2.0)
-//-----------------------------------------------------------------------------
-
-//-----------------------------------------------------------------------------
-// dpiDebug.c
-//   Methods used for debugging ODPI-C.
-//-----------------------------------------------------------------------------
-
-#include "dpiImpl.h"
-
-#define DPI_DEBUG_THREAD_FORMAT         "%.5" PRIu64
-#define DPI_DEBUG_DATE_FORMAT           "%.4d-%.2d-%.2d"
-#define DPI_DEBUG_TIME_FORMAT           "%.2d:%.2d:%.2d.%.3d"
-
-// debug level (populated by environment variable DPI_DEBUG_LEVEL)
-unsigned long dpiDebugLevel = 0;
-
-// debug prefix format (populated by environment variable DPI_DEBUG_PREFIX)
-static char dpiDebugPrefixFormat[64] = "ODPI [%i] %d %t: ";
-
-// debug file for printing (currently unchangeable)
-static FILE *dpiDebugStream = NULL;
-
-
-//-----------------------------------------------------------------------------
-// dpiDebug__getFormatWithPrefix() [INTERNAL]
-//   Adjust the provided format to include the prefix requested by the user.
-// This method is not permitted to fail, so if there is not enough space, the
-// prefix is truncated as needed -- although this is a very unlikely scenario.
-//-----------------------------------------------------------------------------
-static void dpiDebug__getFormatWithPrefix(const char *format,
-        char *formatWithPrefix, size_t maxFormatWithPrefixSize)
-{
-    char *sourcePtr, *targetPtr;
-    int gotTime, tempSize;
-    uint64_t threadId;
-    size_t size;
-#ifdef _WIN32
-    SYSTEMTIME time;
-#else
-    struct timeval timeOfDay;
-    struct tm time;
-#endif
-
-    gotTime = 0;
-    sourcePtr = dpiDebugPrefixFormat;
-    targetPtr = formatWithPrefix;
-    size = maxFormatWithPrefixSize - strlen(format);
-    while (*sourcePtr && size > 20) {
-
-        // all characters except '%' are copied verbatim to the target
-        if (*sourcePtr != '%') {
-            *targetPtr++ = *sourcePtr++;
-            maxFormatWithPrefixSize--;
-            continue;
-        }
-
-        // handle the different directives
-        sourcePtr++;
-        switch (*sourcePtr) {
-            case 'i':
-#ifdef _WIN32
-                threadId = (uint64_t) GetCurrentThreadId();
-#elif defined __linux
-                threadId = (uint64_t) syscall(SYS_gettid);
-#elif defined __APPLE__
-                pthread_threadid_np(NULL, &threadId);
-#else
-                threadId = (uint64_t) pthread_self();
-#endif
-                tempSize = sprintf(targetPtr, DPI_DEBUG_THREAD_FORMAT,
-                        threadId);
-                size -= tempSize;
-                targetPtr += tempSize;
-                sourcePtr++;
-                break;
-            case 'd':
-            case 't':
-                if (!gotTime) {
-                    gotTime = 1;
-#ifdef _WIN32
-                    GetLocalTime(&time);
-#else
-                    gettimeofday(&timeOfDay, NULL);
-                    localtime_r(&timeOfDay.tv_sec, &time);
-#endif
-                }
-#ifdef _WIN32
-                if (*sourcePtr == 'd')
-                    tempSize = sprintf(targetPtr, DPI_DEBUG_DATE_FORMAT,
-                            time.wYear, time.wMonth, time.wDay);
-                else tempSize = sprintf(targetPtr, DPI_DEBUG_TIME_FORMAT,
-                        time.wHour, time.wMinute, time.wSecond,
-                        time.wMilliseconds);
-#else
-                if (*sourcePtr == 'd')
-                    tempSize = sprintf(targetPtr, DPI_DEBUG_DATE_FORMAT,
-                            time.tm_year + 1900, time.tm_mon + 1,
-                            time.tm_mday);
-                else tempSize = sprintf(targetPtr, DPI_DEBUG_TIME_FORMAT,
-                        time.tm_hour, time.tm_min, time.tm_sec,
-                        (int) (timeOfDay.tv_usec / 1000));
-#endif
-                size -= tempSize;
-                targetPtr += tempSize;
-                sourcePtr++;
-                break;
-            case '\0':
-                break;
-            default:
-                *targetPtr++ = '%';
-                *targetPtr++ = *sourcePtr++;
-                break;
-        }
-    }
-
-    // append original format
-    strcpy(targetPtr, format);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDebug__initialize() [INTERNAL]
-//   Initialize debugging infrastructure. This reads the environment variables
-// and populates the global variables used for determining which messages to
-// print and what prefix should be placed in front of each message.
-//-----------------------------------------------------------------------------
-void dpiDebug__initialize(void)
-{
-    char *envValue;
-
-    // determine the value of the environment variable DPI_DEBUG_LEVEL and
-    // convert to an integer; if the value in the environment variable is not a
-    // valid integer, it is ignored
-    envValue = getenv("DPI_DEBUG_LEVEL");
-    if (envValue)
-        dpiDebugLevel = (unsigned long) strtol(envValue, NULL, 10);
-
-    // determine the value of the environment variable DPI_DEBUG_PREFIX and
-    // store it in the static buffer available for it; a static buffer is used
-    // since this runs during startup and may not fail; if the value of the
-    // environment variable is too large for the buffer, the value is ignored
-    // and the default value is used instead
-    envValue = getenv("DPI_DEBUG_PREFIX");
-    if (envValue && strlen(envValue) < sizeof(dpiDebugPrefixFormat))
-        strcpy(dpiDebugPrefixFormat, envValue);
-
-    // messages are written to stderr
-    dpiDebugStream = stderr;
-
-    // for any debugging level > 0 print a message indicating that tracing
-    // has started
-    if (dpiDebugLevel) {
-        dpiDebug__print("ODPI-C %s\n", DPI_VERSION_STRING);
-        dpiDebug__print("debugging messages initialized at level %lu\n",
-                dpiDebugLevel);
-    }
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDebug__print() [INTERNAL]
-//   Print the specified debugging message with a newly calculated prefix.
-//-----------------------------------------------------------------------------
-void dpiDebug__print(const char *format, ...)
-{
-    char formatWithPrefix[512];
-    va_list varArgs;
-
-    dpiDebug__getFormatWithPrefix(format, formatWithPrefix,
-            sizeof(formatWithPrefix));
-    va_start(varArgs, format);
-    (void) vfprintf(dpiDebugStream, formatWithPrefix, varArgs);
-    va_end(varArgs);
-}
-

package/odpi/src/dpiDeqOptions.c

@@ -1,370 +0,0 @@
-//-----------------------------------------------------------------------------
-// Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.
-// This program is free software: you can modify it and/or redistribute it
-// under the terms of:
-//
-// (i)  the Universal Permissive License v 1.0 or at your option, any
-//      later version (http://oss.oracle.com/licenses/upl); and/or
-//
-// (ii) the Apache License v 2.0. (http://www.apache.org/licenses/LICENSE-2.0)
-//-----------------------------------------------------------------------------
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions.c
-//   Implementation of AQ dequeue options.
-//-----------------------------------------------------------------------------
-
-#include "dpiImpl.h"
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions__create() [INTERNAL]
-//   Create a new subscription structure and return it. In case of error NULL
-// is returned.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions__create(dpiDeqOptions *options, dpiConn *conn,
-        dpiError *error)
-{
-    dpiGen__setRefCount(conn, error, 1);
-    options->conn = conn;
-    return dpiOci__descriptorAlloc(conn->env->handle, &options->handle,
-            DPI_OCI_DTYPE_AQDEQ_OPTIONS, "allocate descriptor", error);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions__free() [INTERNAL]
-//   Free the memory for a dequeue options structure.
-//-----------------------------------------------------------------------------
-void dpiDeqOptions__free(dpiDeqOptions *options, dpiError *error)
-{
-    if (options->handle) {
-        dpiOci__descriptorFree(options->handle, DPI_OCI_DTYPE_AQDEQ_OPTIONS);
-        options->handle = NULL;
-    }
-    if (options->conn) {
-        dpiGen__setRefCount(options->conn, error, -1);
-        options->conn = NULL;
-    }
-    dpiUtils__freeMemory(options);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions__getAttrValue() [INTERNAL]
-//   Get the attribute value in OCI.
-//-----------------------------------------------------------------------------
-static int dpiDeqOptions__getAttrValue(dpiDeqOptions *options,
-        uint32_t attribute, const char *fnName, void *value,
-        uint32_t *valueLength)
-{
-    dpiError error;
-    int status;
-
-    if (dpiGen__startPublicFn(options, DPI_HTYPE_DEQ_OPTIONS, fnName, 1,
-            &error) < 0)
-        return dpiGen__endPublicFn(options, DPI_FAILURE, &error);
-    DPI_CHECK_PTR_NOT_NULL(options, value)
-    DPI_CHECK_PTR_NOT_NULL(options, valueLength)
-    status = dpiOci__attrGet(options->handle, DPI_OCI_DTYPE_AQDEQ_OPTIONS,
-            value, valueLength, attribute, "get attribute value", &error);
-    return dpiGen__endPublicFn(options, status, &error);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions__setAttrValue() [INTERNAL]
-//   Set the attribute value in OCI.
-//-----------------------------------------------------------------------------
-static int dpiDeqOptions__setAttrValue(dpiDeqOptions *options,
-        uint32_t attribute, const char *fnName, const void *value,
-        uint32_t valueLength)
-{
-    dpiError error;
-    int status;
-
-    if (dpiGen__startPublicFn(options, DPI_HTYPE_DEQ_OPTIONS, fnName, 1,
-            &error) < 0)
-        return dpiGen__endPublicFn(options, DPI_FAILURE, &error);
-    DPI_CHECK_PTR_NOT_NULL(options, value)
-    status = dpiOci__attrSet(options->handle, DPI_OCI_DTYPE_AQDEQ_OPTIONS,
-            (void*) value, valueLength, attribute, "set attribute value",
-            &error);
-    return dpiGen__endPublicFn(options, status, &error);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_addRef() [PUBLIC]
-//   Add a reference to the dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_addRef(dpiDeqOptions *options)
-{
-    return dpiGen__addRef(options, DPI_HTYPE_DEQ_OPTIONS, __func__);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_getCondition() [PUBLIC]
-//   Return condition associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_getCondition(dpiDeqOptions *options, const char **value,
-        uint32_t *valueLength)
-{
-    return dpiDeqOptions__getAttrValue(options, DPI_OCI_ATTR_DEQCOND, __func__,
-            (void*) value, valueLength);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_getConsumerName() [PUBLIC]
-//   Return consumer name associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_getConsumerName(dpiDeqOptions *options, const char **value,
-        uint32_t *valueLength)
-{
-    return dpiDeqOptions__getAttrValue(options, DPI_OCI_ATTR_CONSUMER_NAME,
-            __func__, (void*) value, valueLength);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_getCorrelation() [PUBLIC]
-//   Return correlation associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_getCorrelation(dpiDeqOptions *options, const char **value,
-        uint32_t *valueLength)
-{
-    return dpiDeqOptions__getAttrValue(options, DPI_OCI_ATTR_CORRELATION,
-            __func__, (void*) value, valueLength);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_getMode() [PUBLIC]
-//   Return mode associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_getMode(dpiDeqOptions *options, dpiDeqMode *value)
-{
-    uint32_t valueLength = sizeof(uint32_t);
-
-    return dpiDeqOptions__getAttrValue(options, DPI_OCI_ATTR_DEQ_MODE,
-            __func__, value, &valueLength);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_getMsgId() [PUBLIC]
-//   Return message id associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_getMsgId(dpiDeqOptions *options, const char **value,
-        uint32_t *valueLength)
-{
-    dpiError error;
-    void *rawValue;
-
-    if (dpiGen__startPublicFn(options, DPI_HTYPE_DEQ_OPTIONS, __func__, 1,
-            &error) < 0)
-        return dpiGen__endPublicFn(options, DPI_FAILURE, &error);
-    DPI_CHECK_PTR_NOT_NULL(options, value)
-    DPI_CHECK_PTR_NOT_NULL(options, valueLength)
-    if (dpiOci__attrGet(options->handle, DPI_OCI_DTYPE_AQDEQ_OPTIONS,
-            &rawValue, NULL, DPI_OCI_ATTR_DEQ_MSGID, "get attribute value",
-            &error) < 0)
-        return dpiGen__endPublicFn(options, DPI_FAILURE, &error);
-    dpiOci__rawPtr(options->env->handle, rawValue, (void**) value);
-    dpiOci__rawSize(options->env->handle, rawValue, valueLength);
-    return dpiGen__endPublicFn(options, DPI_SUCCESS, &error);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_getNavigation() [PUBLIC]
-//   Return navigation associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_getNavigation(dpiDeqOptions *options,
-        dpiDeqNavigation *value)
-{
-    uint32_t valueLength = sizeof(uint32_t);
-
-    return dpiDeqOptions__getAttrValue(options, DPI_OCI_ATTR_NAVIGATION,
-            __func__, value, &valueLength);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_getTransformation() [PUBLIC]
-//   Return transformation associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_getTransformation(dpiDeqOptions *options, const char **value,
-        uint32_t *valueLength)
-{
-    return dpiDeqOptions__getAttrValue(options, DPI_OCI_ATTR_TRANSFORMATION,
-            __func__, (void*) value, valueLength);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_getVisibility() [PUBLIC]
-//   Return visibility associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_getVisibility(dpiDeqOptions *options, dpiVisibility *value)
-{
-    uint32_t valueLength = sizeof(uint32_t);
-
-    return dpiDeqOptions__getAttrValue(options, DPI_OCI_ATTR_VISIBILITY,
-            __func__, value, &valueLength);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_getWait() [PUBLIC]
-//   Return the number of seconds to wait for a message when dequeuing.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_getWait(dpiDeqOptions *options, uint32_t *value)
-{
-    uint32_t valueLength = sizeof(uint32_t);
-
-    return dpiDeqOptions__getAttrValue(options, DPI_OCI_ATTR_WAIT, __func__,
-            value, &valueLength);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_release() [PUBLIC]
-//   Release a reference to the dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_release(dpiDeqOptions *options)
-{
-    return dpiGen__release(options, DPI_HTYPE_DEQ_OPTIONS, __func__);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_setCondition() [PUBLIC]
-//   Set condition associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_setCondition(dpiDeqOptions *options, const char *value,
-        uint32_t valueLength)
-{
-    return dpiDeqOptions__setAttrValue(options, DPI_OCI_ATTR_DEQCOND, __func__,
-            value, valueLength);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_setConsumerName() [PUBLIC]
-//   Set consumer name associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_setConsumerName(dpiDeqOptions *options, const char *value,
-        uint32_t valueLength)
-{
-    return dpiDeqOptions__setAttrValue(options, DPI_OCI_ATTR_CONSUMER_NAME,
-            __func__, value, valueLength);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_setCorrelation() [PUBLIC]
-//   Set correlation associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_setCorrelation(dpiDeqOptions *options, const char *value,
-        uint32_t valueLength)
-{
-    return dpiDeqOptions__setAttrValue(options, DPI_OCI_ATTR_CORRELATION,
-            __func__, value, valueLength);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_setDeliveryMode() [PUBLIC]
-//   Set the delivery mode associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_setDeliveryMode(dpiDeqOptions *options,
-        dpiMessageDeliveryMode value)
-{
-    return dpiDeqOptions__setAttrValue(options, DPI_OCI_ATTR_MSG_DELIVERY_MODE,
-            __func__, &value, 0);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_setMode() [PUBLIC]
-//   Set the mode associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_setMode(dpiDeqOptions *options, dpiDeqMode value)
-{
-    return dpiDeqOptions__setAttrValue(options, DPI_OCI_ATTR_DEQ_MODE,
-            __func__, &value, 0);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_setMsgId() [PUBLIC]
-//   Set the message id associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_setMsgId(dpiDeqOptions *options, const char *value,
-        uint32_t valueLength)
-{
-    void *rawValue = NULL;
-    dpiError error;
-    int status;
-
-    if (dpiGen__startPublicFn(options, DPI_HTYPE_DEQ_OPTIONS, __func__, 1,
-            &error) < 0)
-        return dpiGen__endPublicFn(options, DPI_FAILURE, &error);
-    DPI_CHECK_PTR_NOT_NULL(options, value)
-    if (dpiOci__rawAssignBytes(options->env->handle, value, valueLength,
-            &rawValue, &error) < 0)
-        return dpiGen__endPublicFn(options, DPI_FAILURE, &error);
-    status = dpiOci__attrSet(options->handle, DPI_OCI_DTYPE_AQDEQ_OPTIONS,
-            (void*) &rawValue, valueLength, DPI_OCI_ATTR_DEQ_MSGID,
-            "set value", &error);
-    dpiOci__rawResize(options->env->handle, &rawValue, 0, &error);
-    return dpiGen__endPublicFn(options, status, &error);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_setNavigation() [PUBLIC]
-//   Set navigation associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_setNavigation(dpiDeqOptions *options, dpiDeqNavigation value)
-{
-    return dpiDeqOptions__setAttrValue(options, DPI_OCI_ATTR_NAVIGATION,
-            __func__, &value, 0);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_setTransformation() [PUBLIC]
-//   Set transformation associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_setTransformation(dpiDeqOptions *options, const char *value,
-        uint32_t valueLength)
-{
-    return dpiDeqOptions__setAttrValue(options, DPI_OCI_ATTR_TRANSFORMATION,
-            __func__, value, valueLength);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_setVisibility() [PUBLIC]
-//   Set visibility associated with dequeue options.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_setVisibility(dpiDeqOptions *options, dpiVisibility value)
-{
-    return dpiDeqOptions__setAttrValue(options, DPI_OCI_ATTR_VISIBILITY,
-            __func__, &value, 0);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiDeqOptions_setWait() [PUBLIC]
-//   Set the number of seconds to wait for a message when dequeuing.
-//-----------------------------------------------------------------------------
-int dpiDeqOptions_setWait(dpiDeqOptions *options, uint32_t value)
-{
-    return dpiDeqOptions__setAttrValue(options, DPI_OCI_ATTR_WAIT, __func__,
-            &value, 0);
-}
-