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
|
/*
This file is part of GNUnet
Copyright (C) 2017, 2019 GNUnet e.V.
GNUnet is free software: you can redistribute it and/or modify it
under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License,
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
Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
SPDX-License-Identifier: AGPL3.0-or-later
*/
/**
* @file pq/pq.h
* @brief shared internal data structures of libgnunetpq
* @author Christian Grothoff
*/
#ifndef PQ_H
#define PQ_H
#include "gnunet_util_lib.h"
#include "gnunet_pq_lib.h"
/**
* Handle to Postgres database.
*/
struct GNUNET_PQ_Context
{
/**
* Actual connection.
*/
PGconn *conn;
/**
* Statements to execute upon connection.
*/
struct GNUNET_PQ_ExecuteStatement *es;
/**
* Prepared statements.
*/
struct GNUNET_PQ_PreparedStatement *ps;
/**
* Length of the @e ps array.
*/
unsigned int ps_len;
/**
* Last used offset in the @e ps array.
*/
unsigned int ps_off;
/**
* Configuration to use to connect to the DB.
*/
char *config_str;
/**
* Path to load SQL files from.
*/
char *load_path;
/**
* Suffix to append to path to load on startup.
*/
char *auto_suffix;
/**
* Map managing event subscriptions.
*/
struct GNUNET_CONTAINER_MultiShortmap *channel_map;
/**
* Task responsible for processing events.
*/
struct GNUNET_SCHEDULER_Task *event_task;
/**
* File descriptor wrapper for @e event_task.
*/
struct GNUNET_NETWORK_Handle *rfd;
/**
* How fast should we resubscribe again?
*/
struct GNUNET_TIME_Relative resubscribe_backoff;
/**
* Flags controlling the connection.
*/
enum GNUNET_PQ_Options flags;
/**
* Mapping between array types and Oid's, filled at reconnect
*/
Oid oids[GNUNET_PQ_DATATYPE_MAX];
};
/**
* Internal types that are supported as array types.
*/
enum array_types
{
array_of_bool,
array_of_uint16,
array_of_uint32,
array_of_uint64,
array_of_byte, /* buffers of (char *), (void *), ... */
array_of_string, /* NULL-terminated (char *) */
array_of_abs_time,
array_of_rel_time,
array_of_timestamp,
array_of_MAX, /* must be last */
};
/**
* the header for a postgresql array in binary format. note that this a
* simplified special case of the general structure (which contains pointers),
* as we only support one-dimensional arrays.
*/
struct pq_array_header
{
uint32_t ndim; /* number of dimensions. we only support ndim = 1 */
uint32_t has_null;
uint32_t oid;
uint32_t dim; /* size of the array */
uint32_t lbound; /* index value of first element in the db (default: 1). */
} __attribute__((packed));
/**
* Internal API. Reconnect should re-register notifications
* after a disconnect.
*
* @param db the DB handle
* @param fd socket to listen on
*/
void
GNUNET_PQ_event_reconnect_ (struct GNUNET_PQ_Context *db,
int fd);
#endif
|
