* exceed INITIAL_EXPBUFFER_SIZE (currently 256 bytes).
*
* IDENTIFICATION
- * $Header: /cvsroot/pgsql/src/interfaces/libpq/fe-auth.c,v 1.53 2001/08/17 15:02:18 momjian Exp $
+ * $Header: /cvsroot/pgsql/src/interfaces/libpq/fe-auth.c,v 1.54 2001/08/17 15:11:15 momjian Exp $
*
*-------------------------------------------------------------------------
*/
#endif
-/*----------------------------------------------------------------
+/*
* common definitions for generic fe/be routines
- *----------------------------------------------------------------
*/
struct authsvc
static const int n_authsvcs = sizeof(authsvcs) / sizeof(struct authsvc);
#ifdef KRB4
-/*----------------------------------------------------------------
+/*
* MIT Kerberos authentication system - protocol version 4
- *----------------------------------------------------------------
*/
#include "krb.h"
#endif /* KRB4 */
#ifdef KRB5
-/*----------------------------------------------------------------
+/*
* MIT Kerberos authentication system - protocol version 5
- *----------------------------------------------------------------
*/
#include <krb5.h>
*
*
* IDENTIFICATION
- * $Header: /cvsroot/pgsql/src/interfaces/libpq/fe-connect.c,v 1.174 2001/08/17 02:59:20 momjian Exp $
+ * $Header: /cvsroot/pgsql/src/interfaces/libpq/fe-connect.c,v 1.175 2001/08/17 15:11:15 momjian Exp $
*
*-------------------------------------------------------------------------
*/
PQExpBuffer errorMessage);
-/* ----------------
+/*
* Connecting to a Database
*
* There are now four different ways a user of this API can connect to the
*
* Internally, the static functions connectDBStart, connectDBComplete
* are part of the connection procedure.
- *
- * ----------------
*/
-/* ----------------
+/*
* PQconnectdb
*
* establishes a connection to a postgres backend through the postmaster
*
* You should call PQfinish (if conn is not NULL) regardless of whether this
* call succeeded.
- *
- * ----------------
*/
PGconn *
PQconnectdb(const char *conninfo)
return conn;
}
-/* ----------------
+/*
* PQconnectStart
*
* Begins the establishment of a connection to a postgres backend through the
* this is necessary.
*
* See PQconnectPoll for more info.
- *
- * ----------------
*/
PGconn *
PQconnectStart(const char *conninfo)
return conn;
}
-/* ----------------
+/*
* PQconndefaults
*
* Parse an empty string like PQconnectdb() would do and return the
* versions, the returned array was static, but that's not thread-safe.)
* Pre-7.0 applications that use this function will see a small memory leak
* until they are updated to call PQconninfoFree.
- * ----------------
*/
PQconninfoOption *
PQconndefaults(void)
* the database name to lower case if it is not surrounded by double quotes.
* Otherwise, strip the double quotes but leave the reset of the string intact.
* - thomas 1997-11-08
- *
* ----------------
*/
PGconn *
}
-/* ----------------
+/*
* connectDBComplete
*
* Block and complete a connection.
*
* Returns 1 on success, 0 on failure.
- * ----------------
*/
static int
connectDBComplete(PGconn *conn)
}
-/* ----------------
+/*
* PQsetenvStart
*
* Starts the process of passing the values of a standard set of environment
* variables to the backend.
- *
- * ----------------
*/
static bool
PQsetenvStart(PGconn *conn)
return true;
}
-/* ----------------
+/*
* PQsetenvPoll
*
* Polls the process of passing the values of a standard set of environment
* variables to the backend.
- *
- * ----------------
*/
static PostgresPollingStatusType
PQsetenvPoll(PGconn *conn)
#ifdef NOT_USED
-/* ----------------
+/*
* PQsetenv
*
* Passes the values of a standard set of environment variables to the
* This function used to be exported for no particularly good reason.
* Since it's no longer used by libpq itself, let's try #ifdef'ing it out
* and see if anyone complains.
- * ----------------
*/
static bool
PQsetenv(PGconn *conn)
}
-/* ----------------
+/*
* Conninfo parser routine
*
* If successful, a malloc'd PQconninfoOption array is returned.
* If not successful, NULL is returned and an error message is
* left in errorMessage.
- * ----------------
*/
static PQconninfoOption *
conninfo_parse(const char *conninfo, PQExpBuffer errorMessage)
*
*
* IDENTIFICATION
- * $Header: /cvsroot/pgsql/src/interfaces/libpq/fe-exec.c,v 1.106 2001/08/15 18:42:15 momjian Exp $
+ * $Header: /cvsroot/pgsql/src/interfaces/libpq/fe-exec.c,v 1.107 2001/08/17 15:11:15 momjian Exp $
*
*-------------------------------------------------------------------------
*/
* combine it with the first allocation block, but that would waste space
* for the common case that no extra storage is actually needed (that is,
* the SQL command did not return tuples).
+ *
* We also malloc the top-level array of tuple pointers separately, because
* we need to be able to enlarge it via realloc, and our trivial space
* allocator doesn't handle that effectively. (Too bad the FE/BE protocol
* A query returning a small amount of data will thus require three malloc
* calls: one for the PGresult, one for the tuples pointer array, and one
* PGresult_data block.
+ *
* Only the most recently allocated PGresult_data block is a candidate to
* have more stuff added to it --- any extra space left over in older blocks
* is wasted. We could be smarter and search the whole chain, but the point
*
*
* IDENTIFICATION
- * $Header: /cvsroot/pgsql/src/interfaces/libpq/fe-lobj.c,v 1.36 2001/08/03 22:11:39 tgl Exp $
+ * $Header: /cvsroot/pgsql/src/interfaces/libpq/fe-lobj.c,v 1.37 2001/08/17 15:11:15 momjian Exp $
*
*-------------------------------------------------------------------------
*/
}
-/* ----------------
+/*
* lo_initialize
*
* Initialize the large object interface for an existing connection.
* We ask the backend about the functions OID's in pg_proc for all
* functions that are required for large object operations.
- * ----------------
*/
static int
lo_initialize(PGconn *conn)
*
*
* IDENTIFICATION
- * $Header: /cvsroot/pgsql/src/interfaces/libpq/fe-misc.c,v 1.52 2001/07/20 17:45:06 momjian Exp $
+ * $Header: /cvsroot/pgsql/src/interfaces/libpq/fe-misc.c,v 1.53 2001/08/17 15:11:15 momjian Exp $
*
*-------------------------------------------------------------------------
*/
static int pqPutBytes(const char *s, size_t nbytes, PGconn *conn);
-/* --------------------------------------------------------------------- */
-/* pqGetc:
- get a character from the connection
-
- All these routines return 0 on success, EOF on error.
- Note that for the Get routines, EOF only means there is not enough
- data in the buffer, not that there is necessarily a hard error.
-*/
+/*
+ * pqGetc:
+ * get a character from the connection
+ *
+ * All these routines return 0 on success, EOF on error.
+ * Note that for the Get routines, EOF only means there is not enough
+ * data in the buffer, not that there is necessarily a hard error.
+ */
int
pqGetc(char *result, PGconn *conn)
{
}
-/* --------------------------------------------------------------------- */
-/* pqPutBytes: local routine to write N bytes to the connection,
- with buffering
+/*
+ * pqPutBytes: local routine to write N bytes to the connection,
+ * with buffering
*/
static int
pqPutBytes(const char *s, size_t nbytes, PGconn *conn)
return 0;
}
-/* --------------------------------------------------------------------- */
-/* pqGets:
- get a null-terminated string from the connection,
- and store it in an expansible PQExpBuffer.
- If we run out of memory, all of the string is still read,
- but the excess characters are silently discarded.
-*/
+/*
+ * pqGets:
+ * get a null-terminated string from the connection,
+ * and store it in an expansible PQExpBuffer.
+ * If we run out of memory, all of the string is still read,
+ * but the excess characters are silently discarded.
+ */
int
pqGets(PQExpBuffer buf, PGconn *conn)
{
return 0;
}
-/* --------------------------------------------------------------------- */
+
int
pqPuts(const char *s, PGconn *conn)
{
return 0;
}
-/* --------------------------------------------------------------------- */
-/* pqGetnchar:
- get a string of exactly len bytes in buffer s, no null termination
-*/
+/*
+ * pqGetnchar:
+ * get a string of exactly len bytes in buffer s, no null termination
+ */
int
pqGetnchar(char *s, size_t len, PGconn *conn)
{
return 0;
}
-/* --------------------------------------------------------------------- */
-/* pqPutnchar:
- send a string of exactly len bytes, no null termination needed
-*/
+/*
+ * pqPutnchar:
+ * send a string of exactly len bytes, no null termination needed
+ */
int
pqPutnchar(const char *s, size_t len, PGconn *conn)
{
return 0;
}
-/* --------------------------------------------------------------------- */
-/* pgGetInt
- read a 2 or 4 byte integer and convert from network byte order
- to local byte order
-*/
+/*
+ * pgGetInt
+ * read a 2 or 4 byte integer and convert from network byte order
+ * to local byte order
+ */
int
pqGetInt(int *result, size_t bytes, PGconn *conn)
{
return 0;
}
-/* --------------------------------------------------------------------- */
-/* pgPutInt
- send an integer of 2 or 4 bytes, converting from host byte order
- to network byte order.
-*/
+/*
+ * pgPutInt
+ * send an integer of 2 or 4 bytes, converting from host byte order
+ * to network byte order.
+ */
int
pqPutInt(int value, size_t bytes, PGconn *conn)
{
return 0;
}
-/* --------------------------------------------------------------------- */
-/* pqReadReady: is select() saying the file is ready to read?
+/*
+ * pqReadReady: is select() saying the file is ready to read?
* Returns -1 on failure, 0 if not ready, 1 if ready.
*/
int
return FD_ISSET(conn->sock, &input_mask) ? 1 : 0;
}
-/* --------------------------------------------------------------------- */
-/* pqWriteReady: is select() saying the file is ready to write?
+/*
+ * pqWriteReady: is select() saying the file is ready to write?
* Returns -1 on failure, 0 if not ready, 1 if ready.
*/
int
return FD_ISSET(conn->sock, &input_mask) ? 1 : 0;
}
-/* --------------------------------------------------------------------- */
-/* pqReadData: read more data, if any is available
+/* ----------
+ * pqReadData: read more data, if any is available
* Possible return values:
* 1: successfully loaded at least one more byte
* 0: no data is presently available, but no error detected
* conn->errorMessage set
* NOTE: callers must not assume that pointers or indexes into conn->inBuffer
* remain valid across this call!
+ * ----------
*/
int
pqReadData(PGconn *conn)
return -1;
}
-/* --------------------------------------------------------------------- */
-/* pqFlush: send any data waiting in the output buffer
+/*
+ * pqFlush: send any data waiting in the output buffer
*/
int
pqFlush(PGconn *conn)
return 0;
}
-/* --------------------------------------------------------------------- */
-/* pqWait: wait until we can read or write the connection socket
+/*
+ * pqWait: wait until we can read or write the connection socket
*
* We also stop waiting and return if the kernel flags an exception condition
* on the socket. The actual error condition will be detected and reported
* Portions Copyright (c) 1996-2001, PostgreSQL Global Development Group
* Portions Copyright (c) 1994, Regents of the University of California
*
- * $Header: /cvsroot/pgsql/src/interfaces/libpq/pqexpbuffer.c,v 1.10 2001/03/22 06:16:20 momjian Exp $
+ * $Header: /cvsroot/pgsql/src/interfaces/libpq/pqexpbuffer.c,v 1.11 2001/08/17 15:11:15 momjian Exp $
*
*-------------------------------------------------------------------------
*/
}
}
-/*------------------------
+/*
* destroyPQExpBuffer(str);
+ *
* free()s both the data buffer and the PQExpBufferData.
* This is the inverse of createPQExpBuffer().
*/
}
}
-/*------------------------
+/*
* termPQExpBuffer(str)
* free()s the data buffer but not the PQExpBufferData itself.
* This is the inverse of initPQExpBuffer().
str->len = 0;
}
-/*------------------------
+/*
* resetPQExpBuffer
* Reset a PQExpBuffer to empty
*/
}
}
-/*------------------------
+/*
* enlargePQExpBuffer
* Make sure there is enough space for 'needed' more bytes in the buffer
* ('needed' does not include the terminating null).
return 0;
}
-/*------------------------
+/*
* printfPQExpBuffer
* Format text data under the control of fmt (an sprintf-like format string)
* and insert it into str. More space is allocated to str if necessary.
}
}
-/*------------------------
+/*
* appendPQExpBuffer
*
* Format text data under the control of fmt (an sprintf-like format string)
}
}
-/*------------------------
+/*
* appendPQExpBufferStr
* Append the given string to a PQExpBuffer, allocating more space
* if necessary.
appendBinaryPQExpBuffer(str, data, strlen(data));
}
-/*------------------------
+/*
* appendPQExpBufferChar
* Append a single byte to str.
* Like appendPQExpBuffer(str, "%c", ch) but much faster.
projects / postgresql / commitdiff