PostgreSQL Source Code  git master
reloptions.h
Go to the documentation of this file.
1 /*-------------------------------------------------------------------------
2  *
3  * reloptions.h
4  * Core support for relation and tablespace options (pg_class.reloptions
5  * and pg_tablespace.spcoptions)
6  *
7  * Note: the functions dealing with text-array reloptions values declare
8  * them as Datum, not ArrayType *, to avoid needing to include array.h
9  * into a lot of low-level code.
10  *
11  *
12  * Portions Copyright (c) 1996-2024, PostgreSQL Global Development Group
13  * Portions Copyright (c) 1994, Regents of the University of California
14  *
15  * src/include/access/reloptions.h
16  *
17  *-------------------------------------------------------------------------
18  */
19 #ifndef RELOPTIONS_H
20 #define RELOPTIONS_H
21 
22 #include "access/amapi.h"
23 #include "access/htup.h"
24 #include "access/tupdesc.h"
25 #include "nodes/pg_list.h"
26 #include "storage/lock.h"
27 
28 /* types supported by reloptions */
29 typedef enum relopt_type
30 {
37 
38 /* kinds supported by reloptions */
39 typedef enum relopt_kind
40 {
42  RELOPT_KIND_HEAP = (1 << 0),
43  RELOPT_KIND_TOAST = (1 << 1),
44  RELOPT_KIND_BTREE = (1 << 2),
45  RELOPT_KIND_HASH = (1 << 3),
46  RELOPT_KIND_GIN = (1 << 4),
47  RELOPT_KIND_GIST = (1 << 5),
50  RELOPT_KIND_SPGIST = (1 << 8),
51  RELOPT_KIND_VIEW = (1 << 9),
52  RELOPT_KIND_BRIN = (1 << 10),
54  /* if you add a new kind, make sure you update "last_default" too */
56  /* some compilers treat enums as signed ints, so we can't use 1 << 31 */
57  RELOPT_KIND_MAX = (1 << 30)
59 
60 /* reloption namespaces allowed for heaps -- currently only TOAST */
61 #define HEAP_RELOPT_NAMESPACES { "toast", NULL }
62 
63 /* generic struct to hold shared data */
64 typedef struct relopt_gen
65 {
66  const char *name; /* must be first (used as list termination
67  * marker) */
68  const char *desc;
71  int namelen;
74 
75 /* holds a parsed value */
76 typedef struct relopt_value
77 {
79  bool isset;
80  union
81  {
82  bool bool_val;
83  int int_val;
84  double real_val;
85  int enum_val;
86  char *string_val; /* allocated separately */
87  } values;
89 
90 /* reloptions records for specific variable types */
91 typedef struct relopt_bool
92 {
96 
97 typedef struct relopt_int
98 {
101  int min;
102  int max;
104 
105 typedef struct relopt_real
106 {
108  double default_val;
109  double min;
110  double max;
112 
113 /*
114  * relopt_enum_elt_def -- One member of the array of acceptable values
115  * of an enum reloption.
116  */
117 typedef struct relopt_enum_elt_def
118 {
119  const char *string_val;
122 
123 typedef struct relopt_enum
124 {
128  const char *detailmsg;
129  /* null-terminated array of members */
131 
132 /* validation routines for strings */
133 typedef void (*validate_string_relopt) (const char *value);
134 typedef Size (*fill_string_relopt) (const char *value, void *ptr);
135 
136 /* validation routine for the whole option set */
137 typedef void (*relopts_validator) (void *parsed_options, relopt_value *vals, int nvals);
138 
139 typedef struct relopt_string
140 {
146  char *default_val;
148 
149 /* This is the table datatype for build_reloptions() */
150 typedef struct
151 {
152  const char *optname; /* option's name */
153  relopt_type opttype; /* option's datatype */
154  int offset; /* offset of field in result struct */
156 
157 /* Local reloption definition */
158 typedef struct local_relopt
159 {
160  relopt_gen *option; /* option definition */
161  int offset; /* offset of parsed value in bytea structure */
163 
164 /* Structure to hold local reloption data for build_local_reloptions() */
165 typedef struct local_relopts
166 {
167  List *options; /* list of local_relopt definitions */
168  List *validators; /* list of relopts_validator callbacks */
169  Size relopt_struct_size; /* size of parsed bytea structure */
171 
172 /*
173  * Utility macro to get a value for a string reloption once the options
174  * are parsed. This gets a pointer to the string value itself. "optstruct"
175  * is the StdRdOptions struct or equivalent, "member" is the struct member
176  * corresponding to the string option.
177  */
178 #define GET_STRING_RELOPTION(optstruct, member) \
179  ((optstruct)->member == 0 ? NULL : \
180  (char *)(optstruct) + (optstruct)->member)
181 
182 extern relopt_kind add_reloption_kind(void);
183 extern void add_bool_reloption(bits32 kinds, const char *name, const char *desc,
184  bool default_val, LOCKMODE lockmode);
185 extern void add_int_reloption(bits32 kinds, const char *name, const char *desc,
186  int default_val, int min_val, int max_val,
187  LOCKMODE lockmode);
188 extern void add_real_reloption(bits32 kinds, const char *name, const char *desc,
189  double default_val, double min_val, double max_val,
190  LOCKMODE lockmode);
191 extern void add_enum_reloption(bits32 kinds, const char *name, const char *desc,
192  relopt_enum_elt_def *members, int default_val,
193  const char *detailmsg, LOCKMODE lockmode);
194 extern void add_string_reloption(bits32 kinds, const char *name, const char *desc,
195  const char *default_val, validate_string_relopt validator,
196  LOCKMODE lockmode);
197 
198 extern void init_local_reloptions(local_relopts *relopts, Size relopt_struct_size);
199 extern void register_reloptions_validator(local_relopts *relopts,
200  relopts_validator validator);
201 extern void add_local_bool_reloption(local_relopts *relopts, const char *name,
202  const char *desc, bool default_val,
203  int offset);
204 extern void add_local_int_reloption(local_relopts *relopts, const char *name,
205  const char *desc, int default_val,
206  int min_val, int max_val, int offset);
207 extern void add_local_real_reloption(local_relopts *relopts, const char *name,
208  const char *desc, double default_val,
209  double min_val, double max_val,
210  int offset);
211 extern void add_local_enum_reloption(local_relopts *relopts,
212  const char *name, const char *desc,
213  relopt_enum_elt_def *members,
214  int default_val, const char *detailmsg,
215  int offset);
216 extern void add_local_string_reloption(local_relopts *relopts, const char *name,
217  const char *desc,
218  const char *default_val,
219  validate_string_relopt validator,
220  fill_string_relopt filler, int offset);
221 
222 extern Datum transformRelOptions(Datum oldOptions, List *defList,
223  const char *namspace, char *validnsps[],
224  bool acceptOidsOff, bool isReset);
226 extern bytea *extractRelOptions(HeapTuple tuple, TupleDesc tupdesc,
227  amoptions_function amoptions);
228 extern void *build_reloptions(Datum reloptions, bool validate,
229  relopt_kind kind,
230  Size relopt_struct_size,
231  const relopt_parse_elt *relopt_elems,
232  int num_relopt_elems);
233 extern void *build_local_reloptions(local_relopts *relopts, Datum options,
234  bool validate);
235 
236 extern bytea *default_reloptions(Datum reloptions, bool validate,
237  relopt_kind kind);
238 extern bytea *heap_reloptions(char relkind, Datum reloptions, bool validate);
239 extern bytea *view_reloptions(Datum reloptions, bool validate);
240 extern bytea *partitioned_table_reloptions(Datum reloptions, bool validate);
241 extern bytea *index_reloptions(amoptions_function amoptions, Datum reloptions,
242  bool validate);
243 extern bytea *attribute_reloptions(Datum reloptions, bool validate);
244 extern bytea *tablespace_reloptions(Datum reloptions, bool validate);
246 
247 #endif /* RELOPTIONS_H */
bytea *(* amoptions_function)(Datum reloptions, bool validate)
Definition: amapi.h:143
uint32 bits32
Definition: c.h:502
size_t Size
Definition: c.h:592
static struct @150 value
int LOCKMODE
Definition: lockdefs.h:26
uintptr_t Datum
Definition: postgres.h:64
void add_local_string_reloption(local_relopts *relopts, const char *name, const char *desc, const char *default_val, validate_string_relopt validator, fill_string_relopt filler, int offset)
Definition: reloptions.c:1118
void add_int_reloption(bits32 kinds, const char *name, const char *desc, int default_val, int min_val, int max_val, LOCKMODE lockmode)
Definition: reloptions.c:901
struct relopt_gen relopt_gen
bytea * index_reloptions(amoptions_function amoptions, Datum reloptions, bool validate)
Definition: reloptions.c:2054
void * build_reloptions(Datum reloptions, bool validate, relopt_kind kind, Size relopt_struct_size, const relopt_parse_elt *relopt_elems, int num_relopt_elems)
Definition: reloptions.c:1908
bytea * tablespace_reloptions(Datum reloptions, bool validate)
Definition: reloptions.c:2086
void add_string_reloption(bits32 kinds, const char *name, const char *desc, const char *default_val, validate_string_relopt validator, LOCKMODE lockmode)
Definition: reloptions.c:1098
struct relopt_real relopt_real
Size(* fill_string_relopt)(const char *value, void *ptr)
Definition: reloptions.h:134
struct relopt_bool relopt_bool
List * untransformRelOptions(Datum options)
Definition: reloptions.c:1331
relopt_kind
Definition: reloptions.h:40
@ RELOPT_KIND_LAST_DEFAULT
Definition: reloptions.h:55
@ RELOPT_KIND_ATTRIBUTE
Definition: reloptions.h:48
@ RELOPT_KIND_TOAST
Definition: reloptions.h:43
@ RELOPT_KIND_LOCAL
Definition: reloptions.h:41
@ RELOPT_KIND_SPGIST
Definition: reloptions.h:50
@ RELOPT_KIND_MAX
Definition: reloptions.h:57
@ RELOPT_KIND_GIST
Definition: reloptions.h:47
@ RELOPT_KIND_VIEW
Definition: reloptions.h:51
@ RELOPT_KIND_HEAP
Definition: reloptions.h:42
@ RELOPT_KIND_TABLESPACE
Definition: reloptions.h:49
@ RELOPT_KIND_GIN
Definition: reloptions.h:46
@ RELOPT_KIND_HASH
Definition: reloptions.h:45
@ RELOPT_KIND_PARTITIONED
Definition: reloptions.h:53
@ RELOPT_KIND_BRIN
Definition: reloptions.h:52
@ RELOPT_KIND_BTREE
Definition: reloptions.h:44
void add_enum_reloption(bits32 kinds, const char *name, const char *desc, relopt_enum_elt_def *members, int default_val, const char *detailmsg, LOCKMODE lockmode)
Definition: reloptions.c:1018
Datum transformRelOptions(Datum oldOptions, List *defList, const char *namspace, char *validnsps[], bool acceptOidsOff, bool isReset)
Definition: reloptions.c:1156
bytea * heap_reloptions(char relkind, Datum reloptions, bool validate)
Definition: reloptions.c:2019
void add_real_reloption(bits32 kinds, const char *name, const char *desc, double default_val, double min_val, double max_val, LOCKMODE lockmode)
Definition: reloptions.c:954
struct relopt_string relopt_string
void add_local_bool_reloption(local_relopts *relopts, const char *name, const char *desc, bool default_val, int offset)
Definition: reloptions.c:865
void init_local_reloptions(local_relopts *relopts, Size relopt_struct_size)
Definition: reloptions.c:734
void add_local_real_reloption(local_relopts *relopts, const char *name, const char *desc, double default_val, double min_val, double max_val, int offset)
Definition: reloptions.c:972
void(* validate_string_relopt)(const char *value)
Definition: reloptions.h:133
void add_bool_reloption(bits32 kinds, const char *name, const char *desc, bool default_val, LOCKMODE lockmode)
Definition: reloptions.c:849
void add_local_enum_reloption(local_relopts *relopts, const char *name, const char *desc, relopt_enum_elt_def *members, int default_val, const char *detailmsg, int offset)
Definition: reloptions.c:1036
bytea * view_reloptions(Datum reloptions, bool validate)
Definition: reloptions.c:1998
bytea * partitioned_table_reloptions(Datum reloptions, bool validate)
Definition: reloptions.c:1984
struct local_relopts local_relopts
relopt_kind add_reloption_kind(void)
Definition: reloptions.c:683
struct relopt_enum relopt_enum
void register_reloptions_validator(local_relopts *relopts, relopts_validator validator)
Definition: reloptions.c:747
LOCKMODE AlterTableGetRelOptionsLockLevel(List *defList)
Definition: reloptions.c:2108
bytea * extractRelOptions(HeapTuple tuple, TupleDesc tupdesc, amoptions_function amoptions)
Definition: reloptions.c:1379
bytea * default_reloptions(Datum reloptions, bool validate, relopt_kind kind)
Definition: reloptions.c:1838
bytea * attribute_reloptions(Datum reloptions, bool validate)
Definition: reloptions.c:2069
void add_local_int_reloption(local_relopts *relopts, const char *name, const char *desc, int default_val, int min_val, int max_val, int offset)
Definition: reloptions.c:918
struct relopt_value relopt_value
void(* relopts_validator)(void *parsed_options, relopt_value *vals, int nvals)
Definition: reloptions.h:137
struct relopt_enum_elt_def relopt_enum_elt_def
struct relopt_int relopt_int
void * build_local_reloptions(local_relopts *relopts, Datum options, bool validate)
Definition: reloptions.c:1945
relopt_type
Definition: reloptions.h:30
@ RELOPT_TYPE_ENUM
Definition: reloptions.h:34
@ RELOPT_TYPE_INT
Definition: reloptions.h:32
@ RELOPT_TYPE_BOOL
Definition: reloptions.h:31
@ RELOPT_TYPE_REAL
Definition: reloptions.h:33
@ RELOPT_TYPE_STRING
Definition: reloptions.h:35
struct local_relopt local_relopt
Definition: pg_list.h:54
relopt_gen * option
Definition: reloptions.h:160
List * validators
Definition: reloptions.h:168
List * options
Definition: reloptions.h:167
Size relopt_struct_size
Definition: reloptions.h:169
bool default_val
Definition: reloptions.h:94
relopt_gen gen
Definition: reloptions.h:93
const char * string_val
Definition: reloptions.h:119
int default_val
Definition: reloptions.h:127
const char * detailmsg
Definition: reloptions.h:128
relopt_gen gen
Definition: reloptions.h:125
relopt_enum_elt_def * members
Definition: reloptions.h:126
const char * desc
Definition: reloptions.h:68
bits32 kinds
Definition: reloptions.h:69
const char * name
Definition: reloptions.h:66
LOCKMODE lockmode
Definition: reloptions.h:70
relopt_type type
Definition: reloptions.h:72
int namelen
Definition: reloptions.h:71
int default_val
Definition: reloptions.h:100
relopt_gen gen
Definition: reloptions.h:99
const char * optname
Definition: reloptions.h:152
relopt_type opttype
Definition: reloptions.h:153
relopt_gen gen
Definition: reloptions.h:107
double min
Definition: reloptions.h:109
double max
Definition: reloptions.h:110
double default_val
Definition: reloptions.h:108
char * default_val
Definition: reloptions.h:146
validate_string_relopt validate_cb
Definition: reloptions.h:144
fill_string_relopt fill_cb
Definition: reloptions.h:145
bool default_isnull
Definition: reloptions.h:143
relopt_gen gen
Definition: reloptions.h:141
relopt_gen * gen
Definition: reloptions.h:78
union relopt_value::@46 values
bool bool_val
Definition: reloptions.h:82
double real_val
Definition: reloptions.h:84
char * string_val
Definition: reloptions.h:86
Definition: c.h:674
const char * name