This commit was manufactured by cvs2svn to create branch 'glite-lb-

server_branch_1_2_4_2'.

Cherrypick from master 2005-06-07 15:57:26 UTC František Dvořák <valtri@civ.zcu.cz> 'Fixed documentation.':
    org.glite.lb.server/interface/lbs_db.h

diff --git a/org.glite.lb.server/interface/lbs_db.h b/org.glite.lb.server/interface/lbs_db.h
new file mode 100644 (file)
index 0000000..8b236f3
--- /dev/null
+++ b/org.glite.lb.server/interface/lbs_db.h
@@ -0,0 +1,88 @@
+#ifndef _LBS_DB_H
+#define _LBS_DB_H
+
+#ident "$Header$"
+
+#include <sys/types.h>
+#include <sys/time.h>
+
+#include "glite/lb/consumer.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#define EDG_WLL_MYSQL_VERSION  40001
+
+typedef struct _edg_wll_Stmt *edg_wll_Stmt;
+
+edg_wll_ErrorCode edg_wll_DBConnect(
+       edg_wll_Context,        /* INOUT: */
+       char *          /* IN: connect string user/password@host:database */
+);
+
+void edg_wll_DBClose(edg_wll_Context);
+
+
+/* Parse and execute SQL statement. Returns number of rows selected, created 
+ * or affected by update, or -1 on error */
+
+int edg_wll_ExecStmt(
+       edg_wll_Context,        /* INOUT: */
+       char *,         /* IN: SQL statement */
+       edg_wll_Stmt *  /* OUT: statement handle. Usable for select only */
+);
+
+
+/* Fetch next row of select statement. 
+ * All columns are returned as fresh allocated strings 
+ *
+ * return values:
+ *     >0 - number of fields of the retrieved row
+ *      0 - no more rows
+ *     -1 - error
+ *
+ * Errors are stored in context passed to previous edg_wll_ExecStmt() */
+
+int edg_wll_FetchRow(
+       edg_wll_Stmt,   /* IN: statement */
+       char **         /* OUT: array of fetched values. 
+                        *      As number of columns is fixed and known,
+                        *      expects allocated array of pointers here */
+);
+
+/* Retrieve column names of a query statement */
+
+int edg_wll_QueryColumns(
+       edg_wll_Stmt,   /* IN: statement */
+       char **         /* OUT: result set column names. Expects allocated array. */
+);
+
+/* Free the statement structure */
+
+void edg_wll_FreeStmt(
+       edg_wll_Stmt *    /* INOUT: statement */
+);
+
+
+/**
+ * convert time_t into database-specific time string
+ *
+ * returns pointer to dynamic area which should be freed 
+ */
+char *edg_wll_TimeToDB(time_t);
+time_t edg_wll_DBToTime(char *);
+
+extern edg_wll_ErrorCode edg_wll_Open(edg_wll_Context ctx, char *cs);
+
+/**
+ * Check database version.
+ */
+int edg_wll_DBCheckVersion(edg_wll_Context);
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif