src/pq/pq_prepare.c

   1 /*
   2   This file is part of GNUnet
   3   Copyright (C) 2017 GNUnet e.V.
   4
   5   GNUnet is free software: you can redistribute it and/or modify it
   6   under the terms of the GNU Affero General Public License as published
   7   by the Free Software Foundation, either version 3 of the License,
   8   or (at your option) any later version.
   9
  10   GNUnet is distributed in the hope that it will be useful, but
  11   WITHOUT ANY WARRANTY; without even the implied warranty of
  12   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13   Affero General Public License for more details.
  14
  15   You should have received a copy of the GNU Affero General Public License
  16   along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17
  18      SPDX-License-Identifier: AGPL3.0-or-later
  19 */
  20 /**
  21  * @file pq/pq_prepare.c
  22  * @brief functions to connect to libpq (PostGres)
  23  * @author Christian Grothoff
  24  */
  25 #include "platform.h"
  26 #include "gnunet_util_lib.h"
  27 #include "gnunet_pq_lib.h"
  28
  29
  30 /**
  31  * Create a `struct GNUNET_PQ_PreparedStatement`.
  32  *
  33  * @param name name of the statement
  34  * @param sql actual SQL statement
  35  * @param num_args number of arguments in the statement
  36  * @return initialized struct
  37  */
  38 struct GNUNET_PQ_PreparedStatement
  39 GNUNET_PQ_make_prepare (const char *name,
  40                         const char *sql,
  41                         unsigned int num_args)
  42 {
  43   struct GNUNET_PQ_PreparedStatement ps = {
  44     .name = name,
  45     .sql = sql,
  46     .num_arguments = num_args
  47   };
  48
  49   return ps;
  50 }
  51
  52
  53 /**
  54  * Request creation of prepared statements @a ps from Postgres.
  55  *
  56  * @param connection connection to prepare the statements for
  57  * @param ps #GNUNET_PQ_PREPARED_STATEMENT_END-terminated array of prepared
  58  *            statements.
  59  * @return #GNUNET_OK on success,
  60  *         #GNUNET_SYSERR on error
  61  */
  62 int
  63 GNUNET_PQ_prepare_statements (PGconn *connection,
  64                               const struct GNUNET_PQ_PreparedStatement *ps)
  65 {
  66   for (unsigned int i=0;NULL != ps[i].name;i++)
  67   {
  68     PGresult *ret;
  69
  70     GNUNET_log_from (GNUNET_ERROR_TYPE_DEBUG,
  71                      "pq",
  72                      "Preparing SQL statement `%s' as `%s'\n",
  73                      ps[i].sql,
  74                      ps[i].name);
  75     ret = PQprepare (connection,
  76                      ps[i].name,
  77                      ps[i].sql,
  78                      ps[i].num_arguments,
  79                      NULL);
  80     if (PGRES_COMMAND_OK != PQresultStatus (ret))
  81     {
  82       GNUNET_log_from (GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
  83                        "pq",
  84                        _("PQprepare (`%s' as `%s') failed with error: %s\n"),
  85                        ps[i].sql,
  86                        ps[i].name,
  87                        PQerrorMessage (connection));
  88       PQclear (ret);
  89       return GNUNET_SYSERR;
  90     }
  91     PQclear (ret);
  92   }
  93   return GNUNET_OK;
  94 }
  95
  96
  97 /* end of pq/pq_prepare.c */