/usr/include/gnunet/gnunet_postgres_lib.h is in gnunet-dev 0.10.1-4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 | /*
This file is part of GNUnet
(C) 2012 Christian Grothoff (and other contributing authors)
GNUnet is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published
by the Free Software Foundation; either version 3, or (at your
option) any later version.
GNUnet is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNUnet; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
*/
/**
* @file include/gnunet_postgres_lib.h
* @brief library to help with access to a Postgres database
* @author Christian Grothoff
*/
#ifndef GNUNET_POSTGRES_LIB_H
#define GNUNET_POSTGRES_LIB_H
#include "gnunet_util_lib.h"
#include <postgresql/libpq-fe.h>
#ifdef __cplusplus
extern "C"
{
#if 0 /* keep Emacsens' auto-indent happy */
}
#endif
#endif
/**
* Check if the result obtained from Postgres has
* the desired status code. If not, log an error, clear the
* result and return GNUNET_SYSERR.
*
* @param dbh database handle
* @param ret return value from database operation to check
* @param expected_status desired status
* @param command description of the command that was run
* @param args arguments given to the command
* @param filename name of the source file where the command was run
* @param line line number in the source file
* @return GNUNET_OK if the result is acceptable
*/
int
GNUNET_POSTGRES_check_result_ (PGconn *dbh, PGresult * ret, int expected_status,
const char *command, const char *args,
const char *filename, int line);
/**
* Check if the result obtained from Postgres has
* the desired status code. If not, log an error, clear the
* result and return GNUNET_SYSERR.
*
* @param dbh database handle
* @param ret return value from database operation to check
* @param expected_status desired status
* @param command description of the command that was run
* @param args arguments given to the command
* @return GNUNET_OK if the result is acceptable
*/
#define GNUNET_POSTGRES_check_result(dbh,ret,expected_status,command,args) GNUNET_POSTGRES_check_result_(dbh,ret,expected_status,command,args,__FILE__,__LINE__)
/**
* Run simple SQL statement (without results).
*
* @param dbh database handle
* @param sql statement to run
* @param filename filename for error reporting
* @param line code line for error reporting
* @return GNUNET_OK on success
*/
int
GNUNET_POSTGRES_exec_ (PGconn *dbh, const char *sql, const char *filename, int line);
/**
* Run simple SQL statement (without results).
*
* @param dbh database handle
* @param sql statement to run
* @return GNUNET_OK on success
*/
#define GNUNET_POSTGRES_exec(dbh,sql) GNUNET_POSTGRES_exec_(dbh,sql,__FILE__,__LINE__)
/**
* Prepare SQL statement.
*
* @param dbh database handle
* @param name name for the prepared SQL statement
* @param sql SQL code to prepare
* @param nparams number of parameters in sql
* @param filename filename for error reporting
* @param line code line for error reporting
* @return GNUNET_OK on success
*/
int
GNUNET_POSTGRES_prepare_ (PGconn *dbh, const char *name, const char *sql,
int nparams,
const char *filename, int line);
/**
* Prepare SQL statement.
*
* @param dbh database handle
* @param name name for the prepared SQL statement
* @param sql SQL code to prepare
* @param nparams number of parameters in sql
* @return GNUNET_OK on success
*/
#define GNUNET_POSTGRES_prepare(dbh,name,sql,nparams) GNUNET_POSTGRES_prepare_(dbh,name,sql,nparams,__FILE__,__LINE__)
/**
* Connect to a postgres database
*
* @param cfg configuration
* @param section configuration section to use to get Postgres configuration options
* @return the postgres handle
*/
PGconn *
GNUNET_POSTGRES_connect (const struct GNUNET_CONFIGURATION_Handle *cfg,
const char *section);
/**
* Delete the row identified by the given rowid (qid
* in postgres).
*
* @param dbh database handle
* @param stmt name of the prepared statement
* @param rowid which row to delete
* @return GNUNET_OK on success
*/
int
GNUNET_POSTGRES_delete_by_rowid (PGconn *dbh,
const char *stmt,
uint32_t rowid);
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
#ifdef __cplusplus
}
#endif
/* end of gnunet_postgres_lib.h */
#endif
|