--- parser3/src/sql/pa_sql_driver.h	2001/04/05 11:01:58	1.2
+++ parser3/src/sql/pa_sql_driver.h	2001/05/17 08:42:22	1.9
@@ -5,7 +5,7 @@
 
 	Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf)
 
-	$Id: pa_sql_driver.h,v 1.2 2001/04/05 11:01:58 paf Exp $
+	$Id: pa_sql_driver.h,v 1.9 2001/05/17 08:42:22 parser Exp $
 
 
 	driver dynamic library must look like this:
@@ -32,7 +32,7 @@
 #include <sys/types.h>
 
 /// service functions for SQL driver to use
-class Services_for_SQL_driver {
+class SQL_Driver_services {
 public:
 	/// allocates some bytes on pool
 	virtual void *malloc(size_t size) =0;
@@ -42,12 +42,13 @@ public:
 	virtual void _throw(const char *comment) =0;
 };
 
-#define SQL_DRIVER_API_VERSION 0x0300
+#define SQL_DRIVER_API_VERSION 0x0301
 
 /// SQL driver API
 class SQL_Driver {
 public:
 
+	/// row cell & column title  storage
 	struct Cell {
 		void *ptr;
 		size_t size;
@@ -56,20 +57,33 @@ public:
 public:
 
 	/// assignes services to driver. you can not use driver until this
-	void set_services(Services_for_SQL_driver *aservices) { fservices=aservices; }
+	void set_services(SQL_Driver_services *aservices) { services=aservices; }
 
 	SQL_Driver() :
-		fservices(0) {
+		services(0) {
 	}
 	/// get api version
 	virtual int api_version() =0;
-	/// connect. @returns true+'connection' on success. 'error' on failure
-	virtual void connect(char *url, void **connection) =0;
+	/// initialize driver by loading sql dynamic link library
+	virtual const char *initialize(const char *dlopen_file_spec) =0;
+	/**	connect to sql database using 
+		@param used_only_to_connect_url 
+			format is driver specific
+			WARNING: must be used only to connect, for buffer doesn't live long enough
+
+		@returns true+'connection' on success. 'error' on failure
+	*/
+	virtual void connect(char *used_only_to_connect_url, void **connection) =0;
 	virtual void disconnect(void *connection) =0;
 	virtual void commit(void *connection) =0;
 	virtual void rollback(void *connection) =0;
+	/// @returns true to indicate that connection still alive 
+	virtual bool ping(void *connection) =0;
+	/// encodes the string in 'from' to an escaped SQL string
+	virtual unsigned int quote(void *connection,
+		char *to, const char *from, unsigned int length) =0;
 	virtual void query(void *connection,
-		const char *statement, 
+		const char *statement, unsigned long offset, unsigned long limit,
 		unsigned int *column_count, Cell **columns,
 		unsigned long *row_count, Cell ***rows) =0;
 	/// log error message
@@ -77,7 +91,7 @@ public:
 
 protected:
 
-	Services_for_SQL_driver *fservices;
+	SQL_Driver_services *services;
 };
 
 typedef SQL_Driver *(*SQL_Driver_create_func)();