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_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, at most 64 characters allowed
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
  };
 
  /* PostgreSQL truncates prepared statements at 63 characters,
     assert this one is short enough or at least fail hard if
     it is not. */
  GNUNET_assert (strlen (name) < 64);
  return ps;
}

References GNUNET_assert, name, ps, and GNUNET_PQ_PreparedStatement::sql.

Referenced by reconnect_setup(), reconnect_setup(), reconnect_setup(), and reconnect_setup().

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 47 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 77 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'\n",
                     ps[i].sql,
                     ps[i].name);
    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 reconnect_setup(), reconnect_setup(), reconnect_setup(), and reconnect_setup().

Here is the caller graph for this function: