ctlib.h

/* FreeTDS - Library of routines accessing Sybase and Microsoft databases
 * Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004  Brian Bruns
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */

#ifndef _tdsguard_gH4tOYBTzynx4DgqFzOEbB_
#define _tdsguard_gH4tOYBTzynx4DgqFzOEbB_

#include <freetds/tds.h>
#include <freetds/convert.h>
#include <freetds/utils/string.h>
#include <freetds/bool.h>

/*
 * Internal (not part of the exposed API) prototypes and such.
 */

#include <freetds/pushvis.h>

#ifdef __cplusplus
extern "C"
{
#if 0
}
#endif
#endif

/* Fix a problem with Windows headers */
#undef small

/*
 * internal types
 */
struct _cs_config
{
    bool cs_expose_formats;
    bool cs_note_empty_data;
};

/* Code changed for error handling */
/* Code changes starts here - CT_DIAG - 01 */

/* This structure is used in CT_DIAG */

struct cs_diag_msg_client
{
    struct cs_diag_msg_client *next;
    CS_CLIENTMSG clientmsg;
};

typedef struct {
    CS_MSGNUM msgnumber;
    CS_INT state;
    CS_INT severity;
    CS_CHAR text[CS_MAX_MSG];
    CS_INT textlen;
    CS_CHAR svrname[132];
    CS_INT svrnlen;
    CS_CHAR proc[132];
    CS_INT proclen;
    CS_INT line;
    CS_INT status;
    CS_BYTE sqlstate[CS_SQLSTATE_SIZE];
    CS_INT sqlstatelen;
} CS_SERVERMSG_SMALL;

typedef struct {
    CS_MSGNUM msgnumber;
    CS_INT state;
    CS_INT severity;
    CS_CHAR text[CS_MAX_MSG];
    CS_INT textlen;
    CS_CHAR svrname[256];
    CS_INT svrnlen;
    CS_CHAR proc[256];
    CS_INT proclen;
    CS_INT line;
    CS_INT status;
    CS_BYTE sqlstate[CS_SQLSTATE_SIZE];
    CS_INT sqlstatelen;
} CS_SERVERMSG_LARGE;

typedef struct {
    CS_MSGNUM msgnumber;
    CS_INT state;
    CS_INT severity;
    CS_CHAR text[CS_MAX_MSG];
    CS_INT textlen;
} CS_SERVERMSG_COMMON1;

typedef struct {
    CS_INT line;
    CS_INT status;
    CS_BYTE sqlstate[CS_SQLSTATE_SIZE];
    CS_INT sqlstatelen;
} CS_SERVERMSG_COMMON2;

typedef union
{
    CS_SERVERMSG_SMALL small;
    CS_SERVERMSG_LARGE large;
    CS_SERVERMSG_COMMON1 common;
    CS_SERVERMSG user;
} CS_SERVERMSG_INTERNAL;

struct cs_diag_msg_svr
{
    struct cs_diag_msg_svr *next;
    CS_SERVERMSG_INTERNAL servermsg;
};

/* Code changes ends here - CT_DIAG - 01 */

struct cs_diag_msg
{
    CS_CLIENTMSG *msg;
    struct cs_diag_msg *next;
};

struct _cs_context
{
    CS_INT date_convert_fmt;
    CS_INT cs_errhandletype;
    CS_INT cs_diag_msglimit;

    /* added for storing the maximum messages limit CT_DIAG */
    /* code changes starts here - CT_DIAG - 02 */

    CS_INT cs_diag_msglimit_client;
    CS_INT cs_diag_msglimit_server;
    CS_INT cs_diag_msglimit_total;
    struct cs_diag_msg_client *clientstore;
    struct cs_diag_msg_svr *svrstore;

    /* code changes ends here - CT_DIAG - 02 */

    struct cs_diag_msg *msgstore;
    CS_CSLIBMSG_FUNC cslibmsg_cb;
    CS_CLIENTMSG_FUNC clientmsg_cb;
    CS_SERVERMSG_FUNC servermsg_cb;
    CS_INTERRUPT_FUNC interrupt_cb;
    /* code changes start here - CS_CONFIG - 01*/
    void *userdata;
    int userdata_len;
    /* code changes end here - CS_CONFIG - 01*/
    TDSCONTEXT *tds_ctx;
    CS_CONFIG config;
    int login_timeout;  
    int query_timeout;  
    bool use_large_identifiers;
};

static inline size_t cs_servermsg_len(CS_CONTEXT *ctx)
{
    if (ctx->use_large_identifiers)
        return sizeof(CS_SERVERMSG_LARGE);
    return sizeof(CS_SERVERMSG_SMALL);
}

/*
 * internal typedefs
 */
typedef struct _ct_colinfo
{
    TDS_SMALLINT *indicator;
}
CT_COLINFO;

typedef struct _cs_dynamic CS_DYNAMIC;

struct _cs_connection
{
    CS_CONTEXT *ctx;
    TDSLOGIN *tds_login;
    TDSSOCKET *tds_socket;
    CS_CLIENTMSG_FUNC clientmsg_cb;
    CS_SERVERMSG_FUNC servermsg_cb;
    CS_INTERRUPT_FUNC interrupt_cb;
    void *userdata;
    int userdata_len;
    CS_LOCALE *locale;
    CS_COMMAND *cmds;
    CS_DYNAMIC *dynlist;
    char *server_addr;
    bool network_auth;
};

/*
 * Formerly CSREMOTE_PROC_PARAM, this structure can be used in other
 * places, too.
 */

typedef struct _cs_param
{
    struct _cs_param *next;
    char *name;
    int status;
    int datatype;
    CS_INT maxlen;
    CS_INT scale;
    CS_INT precision;
    CS_INT *datalen;
    CS_SMALLINT *ind;
    CS_BYTE *value;
    int param_by_value;
    CS_INT datalen_value;
    CS_SMALLINT indicator_value;
} CS_PARAM;

/*
 * Code added for RPC functionality - SUHA
 * RPC Code changes starts here
 */

typedef CS_PARAM CSREMOTE_PROC_PARAM;

typedef struct _csremote_proc
{
    char *name;
    CS_SMALLINT options;
    CSREMOTE_PROC_PARAM *param_list;
} CSREMOTE_PROC;

/*
 * Structure CS_COMMAND changed for RPC functionality -SUHA
 * Added CSREMOTE_PROC *rpc to CS_COMMAND structure
 */

typedef CS_PARAM CS_DYNAMIC_PARAM;

struct _cs_dynamic
{
    struct _cs_dynamic *next;
    char *id;
    char *stmt;
    CS_DYNAMIC_PARAM *param_list;
    TDSDYNAMIC *tdsdyn;
}; 

/* specific FreeTDS commands */
#define CS_DYNAMIC_CMD   160
#define CS_CUR_CMD       161

/* values for cs_command.results_state */

#define _CS_RES_NONE            -1
#define _CS_RES_INIT            0
#define _CS_RES_RESULTSET_EMPTY 1
#define _CS_RES_RESULTSET_ROWS  2
#define _CS_RES_STATUS          3
#define _CS_RES_CMD_DONE        4
#define _CS_RES_CMD_SUCCEED     5
#define _CS_RES_END_RESULTS     6
#define _CS_RES_DESCRIBE_RESULT 7

/* values for cs_command.command_state */

#define _CS_COMMAND_IDLE        0
#define _CS_COMMAND_BUILDING    1
#define _CS_COMMAND_READY       2
#define _CS_COMMAND_SENT        3

/* values for cs_command.cancel_state */
#define _CS_CANCEL_NOCANCEL     0
#define _CS_CANCEL_PENDING      1

struct _cs_command
{
    struct _cs_command *next;
    CS_INT command_state;
    CS_INT results_state;
    CS_INT cancel_state;
    CS_INT cursor_state;
    CS_CONNECTION *con;
    CS_INT command_type;
    CS_CHAR *query;
    short dynamic_cmd;
    CS_DYNAMIC *dyn;
    int row_prefetched;
    int curr_result_type;
    int bind_count;
    int get_data_item;
    int get_data_bytes_returned;
    CS_IODESC *iodesc;
    CS_INT send_data_started;
    CSREMOTE_PROC *rpc;
    CS_PARAM *input_params;
    CS_INT client_cursor_id;
    TDSCURSOR *cursor;
    void *userdata;
    int userdata_len;
};

struct _cs_blkdesc
{
    TDSBCPINFO bcpinfo;
};


#define _CS_ERRHAND_INLINE 1
#define _CS_ERRHAND_CB     2

struct _cs_locale
{
    char *language;
    char *charset;
    char *time;
    char *collate;
};

/* internal defines for cursor processing */

#define _CS_CURS_TYPE_UNACTIONED TDS_CURSOR_STATE_UNACTIONED
#define _CS_CURS_TYPE_REQUESTED  TDS_CURSOR_STATE_REQUESTED
#define _CS_CURS_TYPE_SENT       TDS_CURSOR_STATE_SENT

typedef struct {
    CS_CHAR name[132];
    CS_INT namelen;
    CS_INT datatype;
    CS_INT format;
    CS_INT maxlength;
    CS_INT scale;
    CS_INT precision;
    CS_INT status;
    CS_INT count;
    CS_INT usertype;
    CS_LOCALE *locale;
} CS_DATAFMT_SMALL;

typedef struct {
    CS_CHAR name[256];
    CS_INT namelen;
    CS_INT datatype;
    CS_INT format;
    CS_INT maxlength;
    CS_INT scale;
    CS_INT precision;
    CS_INT status;
    CS_INT count;
    CS_INT usertype;
    CS_LOCALE *locale;
} CS_DATAFMT_LARGE;

typedef struct {
    CS_INT datatype;
    CS_INT format;
    CS_INT maxlength;
    CS_INT scale;
    CS_INT precision;
    CS_INT status;
    CS_INT count;
    CS_INT usertype;
    CS_LOCALE *locale;
} CS_DATAFMT_COMMON;

typedef union
{
    CS_DATAFMT_SMALL small;
    CS_DATAFMT_LARGE large;
    CS_DATAFMT user;
} CS_DATAFMT_INTERNAL;

#if ENABLE_EXTRA_CHECKS
#define CS_QUERY_HAS_FOR_UPDATE 9500
#endif

/*
 * internal prototypes
 */
TDSRET _ct_handle_server_message(const TDSCONTEXT * ctxptr, TDSSOCKET * tdsptr, TDSMESSAGE * msgptr);
int _ct_handle_client_message(const TDSCONTEXT * ctxptr, TDSSOCKET * tdsptr, TDSMESSAGE * msgptr);
int _ct_handle_interrupt(void * ptr);
TDS_SERVER_TYPE _ct_get_server_type(TDSSOCKET *tds, int datatype);
int _ct_bind_data(CS_CONTEXT *ctx, TDSRESULTINFO * resinfo, TDSRESULTINFO *bindinfo, CS_INT offset);
int _ct_get_client_type(const TDSCOLUMN *col, bool describe);
void _ctclient_msg(CS_CONTEXT *ctx, CS_CONNECTION * con, const char *funcname,
           int layer, int origin, int severity, int number,
           const char *fmt, ...);
CS_INT _ct_diag_clearmsg(CS_CONTEXT * context, CS_INT type);
void _cs_locale_free(CS_LOCALE *locale);
CS_LOCALE *_cs_locale_copy(CS_LOCALE *orig);
int _cs_locale_copy_inplace(CS_LOCALE *new_locale, CS_LOCALE *orig);
CS_INT _ct_get_string_length(const char *buf, CS_INT buflen);

int _cs_convert_not_client(CS_CONTEXT *ctx, const TDSCOLUMN *curcol, CONV_RESULT *convert_buffer, unsigned char **p_src);

CS_RETCODE _cs_convert(CS_CONTEXT * ctx, const CS_DATAFMT_COMMON * srcfmt, CS_VOID * srcdata,
    const CS_DATAFMT_COMMON * destfmt, CS_VOID * destdata, CS_INT * resultlen, TDS_SERVER_TYPE desttype);
bool _ct_is_large_identifiers_version(CS_INT version);
const CS_DATAFMT_COMMON * _ct_datafmt_common(CS_CONTEXT * ctx, const CS_DATAFMT * datafmt);
const CS_DATAFMT_LARGE *_ct_datafmt_conv_in(CS_CONTEXT * ctx, const CS_DATAFMT * datafmt, CS_DATAFMT_LARGE * fmtbuf);
CS_DATAFMT_LARGE *_ct_datafmt_conv_prepare(CS_CONTEXT * ctx, CS_DATAFMT * datafmt, CS_DATAFMT_LARGE * fmtbuf);
void _ct_datafmt_conv_back(CS_DATAFMT * datafmt, CS_DATAFMT_LARGE * fmtbuf);

CS_RETCODE _ct_props_dstr(CS_CONNECTION * con, DSTR *s, CS_INT action, CS_VOID * buffer, CS_INT buflen, CS_INT * outlen);

#ifdef __cplusplus
#if 0
{
#endif
}
#endif

#include <freetds/popvis.h>

#endif