pq_prepare.c File Reference

functions to connect to libpq (PostGres) More...

#include "platform.h"
#include "pq.h"

Include dependency graph for pq_prepare.c:

Go to the source code of this file.

Functions
struct GNUNET_PQ_PreparedStatement	GNUNET_PQ_make_prepare (const char *name, const char *sql)
	Create a struct GNUNET_PQ_PreparedStatement.
enum GNUNET_GenericReturnValue	GNUNET_PQ_prepare_once (struct GNUNET_PQ_Context *db, const struct GNUNET_PQ_PreparedStatement *ps)
	Request creation of prepared statements ps from Postgres, but do not automatically re-prepare the statement if we are disconnected from the database.
enum GNUNET_GenericReturnValue	GNUNET_PQ_prepare_anon (struct GNUNET_PQ_Context *pg, const char *sql)
	Prepares SQL statement sql under no name ("") for connection pg.
enum GNUNET_GenericReturnValue	GNUNET_PQ_prepare_statements (struct GNUNET_PQ_Context *db, const struct GNUNET_PQ_PreparedStatement *ps)
	Request creation of prepared statements ps from Postgres.

Detailed Description

functions to connect to libpq (PostGres)

Author

Christian Grothoff

Definition in file pq_prepare.c.

Function Documentation

GNUNET_PQ_make_prepare()

struct GNUNET_PQ_PreparedStatement GNUNET_PQ_make_prepare	(	const char *	name,
		const char *	sql
	)

Create a struct GNUNET_PQ_PreparedStatement.

Parameters

name	name of the statement
sql	actual SQL statement

Returns

initialized struct

Definition at line 30 of file pq_prepare.c.

{
  struct GNUNET_PQ_PreparedStatement ps = {
    .name = name,
    .sql = sql
  };
 
  return ps;
}

References name, ps, and GNUNET_PQ_PreparedStatement::sql.

Referenced by database_prepare(), database_setup(), init_connection(), and init_connection().

Here is the caller graph for this function:

GNUNET_PQ_prepare_once()

enum GNUNET_GenericReturnValue GNUNET_PQ_prepare_once	(	struct GNUNET_PQ_Context *	db,
		const struct GNUNET_PQ_PreparedStatement *	ps
	)

Request creation of prepared statements ps from Postgres, but do not automatically re-prepare the statement if we are disconnected from the database.

Parameters

db	database to prepare the statements for
ps	GNUNET_PQ_PREPARED_STATEMENT_END-terminated array of prepared statements.

Returns

GNUNET_OK on success, GNUNET_SYSERR on error

Definition at line 43 of file pq_prepare.c.

{
  for (unsigned int i = 0; NULL != ps[i].name; i++)
  {
    PGresult *ret;
 
    GNUNET_log_from (GNUNET_ERROR_TYPE_INFO,
                     "pq",
                     "Preparing SQL statement `%s' as `%s' on %p\n",
                     ps[i].sql,
                     ps[i].name,
                     db);
    ret = PQprepare (db->conn,
                     ps[i].name,
                     ps[i].sql,
                     0,
                     NULL);
    if (PGRES_COMMAND_OK != PQresultStatus (ret))
    {
      GNUNET_log_from (GNUNET_ERROR_TYPE_ERROR,
                       "pq",
                       "PQprepare (`%s' as `%s') failed with error: %s\n",
                       ps[i].sql,
                       ps[i].name,
                       PQerrorMessage (db->conn));
      PQclear (ret);
      ret = PQdescribePrepared (db->conn,
                                ps[i].name);
      if (PGRES_COMMAND_OK != PQresultStatus (ret))
      {
        PQclear (ret);
        return GNUNET_SYSERR;
      }
      GNUNET_log_from (GNUNET_ERROR_TYPE_WARNING,
                       "pq",
                       "Statement `%s' already known. Ignoring the issue in the hope that you are using connection pooling...\n",
                       ps[i].name);
    }
    PQclear (ret);
  }
  return GNUNET_OK;
}

References db, GNUNET_ERROR_TYPE_ERROR, GNUNET_ERROR_TYPE_INFO, GNUNET_ERROR_TYPE_WARNING, GNUNET_log_from, GNUNET_OK, GNUNET_SYSERR, name, ps, ret, and GNUNET_PQ_PreparedStatement::sql.

Referenced by GNUNET_PQ_prepare_statements().

Here is the caller graph for this function:

GNUNET_PQ_prepare_anon()

enum GNUNET_GenericReturnValue GNUNET_PQ_prepare_anon	(	struct GNUNET_PQ_Context *	pg,
		const char *	sql
	)

Prepares SQL statement sql under no name ("") for connection pg.

Useful for prepared statements that should not be cached.

Parameters

pg	database handle
sql	actual SQL text

Returns

GNUNET_OK on success

Definition at line 89 of file pq_prepare.c.

{
  PGresult *ret;
 
  GNUNET_log_from (GNUNET_ERROR_TYPE_INFO,
                   "pq",
                   "Preparing SQL: %s\n",
                   sql);
  ret = PQprepare (pg->conn,
                   "",
                   sql,
                   0,
                   NULL);
  if (PGRES_COMMAND_OK != PQresultStatus (ret))
  {
    GNUNET_log_from (GNUNET_ERROR_TYPE_ERROR,
                     "pq",
                     "PQprepare (`%s') failed with error: %s\n",
                     sql,
                     PQerrorMessage (pg->conn));
    PQclear (ret);
    return GNUNET_SYSERR;
  }
  PQclear (ret);
  return GNUNET_OK;
}

References GNUNET_PQ_Context::conn, GNUNET_ERROR_TYPE_ERROR, GNUNET_ERROR_TYPE_INFO, GNUNET_log_from, GNUNET_OK, GNUNET_SYSERR, ret, and GNUNET_PQ_PreparedStatement::sql.

GNUNET_PQ_prepare_statements()

enum GNUNET_GenericReturnValue GNUNET_PQ_prepare_statements	(	struct GNUNET_PQ_Context *	db,
		const struct GNUNET_PQ_PreparedStatement *	ps
	)

Request creation of prepared statements ps from Postgres.

Parameters

db	database to prepare the statements for
ps	GNUNET_PQ_PREPARED_STATEMENT_END-terminated array of prepared statements.

Returns

GNUNET_OK on success, GNUNET_SYSERR on error

Definition at line 119 of file pq_prepare.c.

{
  if (db->ps != ps)
  {
    /* add 'ps' to list db->ps of prepared statements to run on reconnect! */
    unsigned int nlen = 0; /* length of 'ps' array */
    unsigned int xlen;
    struct GNUNET_PQ_PreparedStatement *rps; /* combined array */
 
    while (NULL != ps[nlen].name)
      nlen++;
    xlen = nlen + db->ps_off;
    if (xlen > db->ps_len)
    {
      xlen = 2 * xlen + 1;
      rps = GNUNET_new_array (xlen,
                              struct GNUNET_PQ_PreparedStatement);
      if (NULL != db->ps)
        memcpy (rps,
                db->ps,
                db->ps_off * sizeof (struct GNUNET_PQ_PreparedStatement));
      GNUNET_free (db->ps);
      db->ps_len = xlen;
      db->ps = rps;
    }
    memcpy (&db->ps[db->ps_off],
            ps,
            nlen * sizeof (struct GNUNET_PQ_PreparedStatement));
    db->ps_off += nlen;
  }
 
  return GNUNET_PQ_prepare_once (db,
                                 ps);
}

References db, GNUNET_free, GNUNET_new_array, GNUNET_PQ_prepare_once(), name, and ps.

Referenced by database_prepare(), and GNUNET_PQ_reconnect().

Here is the call graph for this function:

Here is the caller graph for this function: