pg_query 1.1.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (478) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +163 -52
  3. data/README.md +80 -69
  4. data/Rakefile +82 -1
  5. data/ext/pg_query/extconf.rb +3 -31
  6. data/ext/pg_query/guc-file.c +0 -0
  7. data/ext/pg_query/include/access/amapi.h +246 -0
  8. data/ext/pg_query/include/access/attmap.h +52 -0
  9. data/ext/pg_query/include/access/attnum.h +64 -0
  10. data/ext/pg_query/include/access/clog.h +61 -0
  11. data/ext/pg_query/include/access/commit_ts.h +77 -0
  12. data/ext/pg_query/include/access/detoast.h +92 -0
  13. data/ext/pg_query/include/access/genam.h +228 -0
  14. data/ext/pg_query/include/access/gin.h +78 -0
  15. data/ext/pg_query/include/access/htup.h +89 -0
  16. data/ext/pg_query/include/access/htup_details.h +819 -0
  17. data/ext/pg_query/include/access/itup.h +161 -0
  18. data/ext/pg_query/include/access/parallel.h +82 -0
  19. data/ext/pg_query/include/access/printtup.h +35 -0
  20. data/ext/pg_query/include/access/relation.h +28 -0
  21. data/ext/pg_query/include/access/relscan.h +176 -0
  22. data/ext/pg_query/include/access/rmgr.h +35 -0
  23. data/ext/pg_query/include/access/rmgrlist.h +49 -0
  24. data/ext/pg_query/include/access/sdir.h +58 -0
  25. data/ext/pg_query/include/access/skey.h +151 -0
  26. data/ext/pg_query/include/access/stratnum.h +83 -0
  27. data/ext/pg_query/include/access/sysattr.h +29 -0
  28. data/ext/pg_query/include/access/table.h +27 -0
  29. data/ext/pg_query/include/access/tableam.h +1825 -0
  30. data/ext/pg_query/include/access/transam.h +265 -0
  31. data/ext/pg_query/include/access/tupconvert.h +51 -0
  32. data/ext/pg_query/include/access/tupdesc.h +154 -0
  33. data/ext/pg_query/include/access/tupmacs.h +247 -0
  34. data/ext/pg_query/include/access/twophase.h +61 -0
  35. data/ext/pg_query/include/access/xact.h +463 -0
  36. data/ext/pg_query/include/access/xlog.h +398 -0
  37. data/ext/pg_query/include/access/xlog_internal.h +330 -0
  38. data/ext/pg_query/include/access/xlogdefs.h +109 -0
  39. data/ext/pg_query/include/access/xloginsert.h +64 -0
  40. data/ext/pg_query/include/access/xlogreader.h +327 -0
  41. data/ext/pg_query/include/access/xlogrecord.h +227 -0
  42. data/ext/pg_query/include/bootstrap/bootstrap.h +62 -0
  43. data/ext/pg_query/include/c.h +1322 -0
  44. data/ext/pg_query/include/catalog/catalog.h +42 -0
  45. data/ext/pg_query/include/catalog/catversion.h +58 -0
  46. data/ext/pg_query/include/catalog/dependency.h +275 -0
  47. data/ext/pg_query/include/catalog/genbki.h +64 -0
  48. data/ext/pg_query/include/catalog/index.h +199 -0
  49. data/ext/pg_query/include/catalog/indexing.h +366 -0
  50. data/ext/pg_query/include/catalog/namespace.h +188 -0
  51. data/ext/pg_query/include/catalog/objectaccess.h +197 -0
  52. data/ext/pg_query/include/catalog/objectaddress.h +84 -0
  53. data/ext/pg_query/include/catalog/pg_aggregate.h +176 -0
  54. data/ext/pg_query/include/catalog/pg_aggregate_d.h +77 -0
  55. data/ext/pg_query/include/catalog/pg_am.h +60 -0
  56. data/ext/pg_query/include/catalog/pg_am_d.h +45 -0
  57. data/ext/pg_query/include/catalog/pg_attribute.h +204 -0
  58. data/ext/pg_query/include/catalog/pg_attribute_d.h +59 -0
  59. data/ext/pg_query/include/catalog/pg_authid.h +58 -0
  60. data/ext/pg_query/include/catalog/pg_authid_d.h +49 -0
  61. data/ext/pg_query/include/catalog/pg_class.h +200 -0
  62. data/ext/pg_query/include/catalog/pg_class_d.h +103 -0
  63. data/ext/pg_query/include/catalog/pg_collation.h +73 -0
  64. data/ext/pg_query/include/catalog/pg_collation_d.h +45 -0
  65. data/ext/pg_query/include/catalog/pg_constraint.h +247 -0
  66. data/ext/pg_query/include/catalog/pg_constraint_d.h +67 -0
  67. data/ext/pg_query/include/catalog/pg_control.h +250 -0
  68. data/ext/pg_query/include/catalog/pg_conversion.h +72 -0
  69. data/ext/pg_query/include/catalog/pg_conversion_d.h +35 -0
  70. data/ext/pg_query/include/catalog/pg_depend.h +73 -0
  71. data/ext/pg_query/include/catalog/pg_depend_d.h +34 -0
  72. data/ext/pg_query/include/catalog/pg_event_trigger.h +51 -0
  73. data/ext/pg_query/include/catalog/pg_event_trigger_d.h +34 -0
  74. data/ext/pg_query/include/catalog/pg_index.h +80 -0
  75. data/ext/pg_query/include/catalog/pg_index_d.h +56 -0
  76. data/ext/pg_query/include/catalog/pg_language.h +67 -0
  77. data/ext/pg_query/include/catalog/pg_language_d.h +39 -0
  78. data/ext/pg_query/include/catalog/pg_namespace.h +59 -0
  79. data/ext/pg_query/include/catalog/pg_namespace_d.h +34 -0
  80. data/ext/pg_query/include/catalog/pg_opclass.h +85 -0
  81. data/ext/pg_query/include/catalog/pg_opclass_d.h +49 -0
  82. data/ext/pg_query/include/catalog/pg_operator.h +102 -0
  83. data/ext/pg_query/include/catalog/pg_operator_d.h +106 -0
  84. data/ext/pg_query/include/catalog/pg_opfamily.h +60 -0
  85. data/ext/pg_query/include/catalog/pg_opfamily_d.h +47 -0
  86. data/ext/pg_query/include/catalog/pg_partitioned_table.h +63 -0
  87. data/ext/pg_query/include/catalog/pg_partitioned_table_d.h +35 -0
  88. data/ext/pg_query/include/catalog/pg_proc.h +211 -0
  89. data/ext/pg_query/include/catalog/pg_proc_d.h +99 -0
  90. data/ext/pg_query/include/catalog/pg_publication.h +115 -0
  91. data/ext/pg_query/include/catalog/pg_publication_d.h +36 -0
  92. data/ext/pg_query/include/catalog/pg_replication_origin.h +57 -0
  93. data/ext/pg_query/include/catalog/pg_replication_origin_d.h +29 -0
  94. data/ext/pg_query/include/catalog/pg_statistic.h +275 -0
  95. data/ext/pg_query/include/catalog/pg_statistic_d.h +194 -0
  96. data/ext/pg_query/include/catalog/pg_statistic_ext.h +74 -0
  97. data/ext/pg_query/include/catalog/pg_statistic_ext_d.h +40 -0
  98. data/ext/pg_query/include/catalog/pg_transform.h +45 -0
  99. data/ext/pg_query/include/catalog/pg_transform_d.h +32 -0
  100. data/ext/pg_query/include/catalog/pg_trigger.h +137 -0
  101. data/ext/pg_query/include/catalog/pg_trigger_d.h +106 -0
  102. data/ext/pg_query/include/catalog/pg_ts_config.h +50 -0
  103. data/ext/pg_query/include/catalog/pg_ts_config_d.h +32 -0
  104. data/ext/pg_query/include/catalog/pg_ts_dict.h +54 -0
  105. data/ext/pg_query/include/catalog/pg_ts_dict_d.h +33 -0
  106. data/ext/pg_query/include/catalog/pg_ts_parser.h +57 -0
  107. data/ext/pg_query/include/catalog/pg_ts_parser_d.h +35 -0
  108. data/ext/pg_query/include/catalog/pg_ts_template.h +48 -0
  109. data/ext/pg_query/include/catalog/pg_ts_template_d.h +32 -0
  110. data/ext/pg_query/include/catalog/pg_type.h +372 -0
  111. data/ext/pg_query/include/catalog/pg_type_d.h +285 -0
  112. data/ext/pg_query/include/catalog/storage.h +48 -0
  113. data/ext/pg_query/include/commands/async.h +54 -0
  114. data/ext/pg_query/include/commands/dbcommands.h +35 -0
  115. data/ext/pg_query/include/commands/defrem.h +173 -0
  116. data/ext/pg_query/include/commands/event_trigger.h +88 -0
  117. data/ext/pg_query/include/commands/explain.h +127 -0
  118. data/ext/pg_query/include/commands/prepare.h +61 -0
  119. data/ext/pg_query/include/commands/tablespace.h +67 -0
  120. data/ext/pg_query/include/commands/trigger.h +277 -0
  121. data/ext/pg_query/include/commands/user.h +37 -0
  122. data/ext/pg_query/include/commands/vacuum.h +293 -0
  123. data/ext/pg_query/include/commands/variable.h +38 -0
  124. data/ext/pg_query/include/common/file_perm.h +56 -0
  125. data/ext/pg_query/include/common/hashfn.h +104 -0
  126. data/ext/pg_query/include/common/ip.h +37 -0
  127. data/ext/pg_query/include/common/keywords.h +33 -0
  128. data/ext/pg_query/include/common/kwlookup.h +44 -0
  129. data/ext/pg_query/include/common/relpath.h +90 -0
  130. data/ext/pg_query/include/common/string.h +19 -0
  131. data/ext/pg_query/include/common/unicode_combining_table.h +196 -0
  132. data/ext/pg_query/include/datatype/timestamp.h +197 -0
  133. data/ext/pg_query/include/executor/execdesc.h +70 -0
  134. data/ext/pg_query/include/executor/executor.h +614 -0
  135. data/ext/pg_query/include/executor/functions.h +41 -0
  136. data/ext/pg_query/include/executor/instrument.h +101 -0
  137. data/ext/pg_query/include/executor/spi.h +175 -0
  138. data/ext/pg_query/include/executor/tablefunc.h +67 -0
  139. data/ext/pg_query/include/executor/tuptable.h +487 -0
  140. data/ext/pg_query/include/fmgr.h +775 -0
  141. data/ext/pg_query/include/funcapi.h +348 -0
  142. data/ext/pg_query/include/getaddrinfo.h +162 -0
  143. data/ext/pg_query/include/jit/jit.h +105 -0
  144. data/ext/pg_query/include/kwlist_d.h +1072 -0
  145. data/ext/pg_query/include/lib/ilist.h +727 -0
  146. data/ext/pg_query/include/lib/pairingheap.h +102 -0
  147. data/ext/pg_query/include/lib/simplehash.h +1059 -0
  148. data/ext/pg_query/include/lib/stringinfo.h +161 -0
  149. data/ext/pg_query/include/libpq/auth.h +29 -0
  150. data/ext/pg_query/include/libpq/crypt.h +46 -0
  151. data/ext/pg_query/include/libpq/hba.h +140 -0
  152. data/ext/pg_query/include/libpq/libpq-be.h +326 -0
  153. data/ext/pg_query/include/libpq/libpq.h +133 -0
  154. data/ext/pg_query/include/libpq/pqcomm.h +208 -0
  155. data/ext/pg_query/include/libpq/pqformat.h +210 -0
  156. data/ext/pg_query/include/libpq/pqsignal.h +42 -0
  157. data/ext/pg_query/include/mb/pg_wchar.h +672 -0
  158. data/ext/pg_query/include/mb/stringinfo_mb.h +24 -0
  159. data/ext/pg_query/include/miscadmin.h +476 -0
  160. data/ext/pg_query/include/nodes/bitmapset.h +122 -0
  161. data/ext/pg_query/include/nodes/execnodes.h +2520 -0
  162. data/ext/pg_query/include/nodes/extensible.h +160 -0
  163. data/ext/pg_query/include/nodes/lockoptions.h +61 -0
  164. data/ext/pg_query/include/nodes/makefuncs.h +108 -0
  165. data/ext/pg_query/include/nodes/memnodes.h +108 -0
  166. data/ext/pg_query/include/nodes/nodeFuncs.h +162 -0
  167. data/ext/pg_query/include/nodes/nodes.h +842 -0
  168. data/ext/pg_query/include/nodes/params.h +170 -0
  169. data/ext/pg_query/include/nodes/parsenodes.h +3579 -0
  170. data/ext/pg_query/include/nodes/pathnodes.h +2556 -0
  171. data/ext/pg_query/include/nodes/pg_list.h +605 -0
  172. data/ext/pg_query/include/nodes/plannodes.h +1251 -0
  173. data/ext/pg_query/include/nodes/primnodes.h +1541 -0
  174. data/ext/pg_query/include/nodes/print.h +34 -0
  175. data/ext/pg_query/include/nodes/tidbitmap.h +75 -0
  176. data/ext/pg_query/include/nodes/value.h +61 -0
  177. data/ext/pg_query/include/optimizer/cost.h +206 -0
  178. data/ext/pg_query/include/optimizer/geqo.h +88 -0
  179. data/ext/pg_query/include/optimizer/geqo_gene.h +45 -0
  180. data/ext/pg_query/include/optimizer/optimizer.h +199 -0
  181. data/ext/pg_query/include/optimizer/paths.h +249 -0
  182. data/ext/pg_query/include/optimizer/planmain.h +119 -0
  183. data/ext/pg_query/include/parser/analyze.h +49 -0
  184. data/ext/pg_query/include/parser/gram.h +1067 -0
  185. data/ext/pg_query/include/parser/gramparse.h +75 -0
  186. data/ext/pg_query/include/parser/kwlist.h +477 -0
  187. data/ext/pg_query/include/parser/parse_agg.h +68 -0
  188. data/ext/pg_query/include/parser/parse_clause.h +54 -0
  189. data/ext/pg_query/include/parser/parse_coerce.h +97 -0
  190. data/ext/pg_query/include/parser/parse_collate.h +27 -0
  191. data/ext/pg_query/include/parser/parse_expr.h +26 -0
  192. data/ext/pg_query/include/parser/parse_func.h +73 -0
  193. data/ext/pg_query/include/parser/parse_node.h +327 -0
  194. data/ext/pg_query/include/parser/parse_oper.h +67 -0
  195. data/ext/pg_query/include/parser/parse_relation.h +123 -0
  196. data/ext/pg_query/include/parser/parse_target.h +46 -0
  197. data/ext/pg_query/include/parser/parse_type.h +60 -0
  198. data/ext/pg_query/include/parser/parser.h +41 -0
  199. data/ext/pg_query/include/parser/parsetree.h +61 -0
  200. data/ext/pg_query/include/parser/scanner.h +152 -0
  201. data/ext/pg_query/include/parser/scansup.h +30 -0
  202. data/ext/pg_query/include/partitioning/partdefs.h +26 -0
  203. data/ext/pg_query/include/pg_config.h +988 -0
  204. data/ext/pg_query/include/pg_config_ext.h +8 -0
  205. data/ext/pg_query/include/pg_config_manual.h +350 -0
  206. data/ext/pg_query/include/pg_config_os.h +8 -0
  207. data/ext/pg_query/include/pg_getopt.h +56 -0
  208. data/ext/pg_query/include/pg_query.h +121 -0
  209. data/ext/pg_query/include/pg_query_enum_defs.c +2454 -0
  210. data/ext/pg_query/include/pg_query_fingerprint_conds.c +875 -0
  211. data/ext/pg_query/include/pg_query_fingerprint_defs.c +12413 -0
  212. data/ext/pg_query/include/pg_query_json_helper.c +61 -0
  213. data/ext/pg_query/include/pg_query_outfuncs_conds.c +686 -0
  214. data/ext/pg_query/include/pg_query_outfuncs_defs.c +2437 -0
  215. data/ext/pg_query/include/pg_query_readfuncs_conds.c +222 -0
  216. data/ext/pg_query/include/pg_query_readfuncs_defs.c +2878 -0
  217. data/ext/pg_query/include/pg_trace.h +17 -0
  218. data/ext/pg_query/include/pgstat.h +1487 -0
  219. data/ext/pg_query/include/pgtime.h +84 -0
  220. data/ext/pg_query/include/pl_gram.h +385 -0
  221. data/ext/pg_query/include/pl_reserved_kwlist.h +52 -0
  222. data/ext/pg_query/include/pl_reserved_kwlist_d.h +114 -0
  223. data/ext/pg_query/include/pl_unreserved_kwlist.h +112 -0
  224. data/ext/pg_query/include/pl_unreserved_kwlist_d.h +246 -0
  225. data/ext/pg_query/include/plerrcodes.h +990 -0
  226. data/ext/pg_query/include/plpgsql.h +1347 -0
  227. data/ext/pg_query/include/port.h +524 -0
  228. data/ext/pg_query/include/port/atomics.h +524 -0
  229. data/ext/pg_query/include/port/atomics/arch-arm.h +26 -0
  230. data/ext/pg_query/include/port/atomics/arch-ppc.h +254 -0
  231. data/ext/pg_query/include/port/atomics/arch-x86.h +252 -0
  232. data/ext/pg_query/include/port/atomics/fallback.h +170 -0
  233. data/ext/pg_query/include/port/atomics/generic-gcc.h +286 -0
  234. data/ext/pg_query/include/port/atomics/generic.h +401 -0
  235. data/ext/pg_query/include/port/pg_bitutils.h +226 -0
  236. data/ext/pg_query/include/port/pg_bswap.h +161 -0
  237. data/ext/pg_query/include/port/pg_crc32c.h +101 -0
  238. data/ext/pg_query/include/portability/instr_time.h +256 -0
  239. data/ext/pg_query/include/postgres.h +764 -0
  240. data/ext/pg_query/include/postgres_ext.h +74 -0
  241. data/ext/pg_query/include/postmaster/autovacuum.h +83 -0
  242. data/ext/pg_query/include/postmaster/bgworker.h +161 -0
  243. data/ext/pg_query/include/postmaster/bgworker_internals.h +64 -0
  244. data/ext/pg_query/include/postmaster/bgwriter.h +45 -0
  245. data/ext/pg_query/include/postmaster/fork_process.h +17 -0
  246. data/ext/pg_query/include/postmaster/interrupt.h +32 -0
  247. data/ext/pg_query/include/postmaster/pgarch.h +39 -0
  248. data/ext/pg_query/include/postmaster/postmaster.h +77 -0
  249. data/ext/pg_query/include/postmaster/syslogger.h +98 -0
  250. data/ext/pg_query/include/postmaster/walwriter.h +21 -0
  251. data/ext/pg_query/include/protobuf-c.h +1106 -0
  252. data/ext/pg_query/include/protobuf-c/protobuf-c.h +1106 -0
  253. data/ext/pg_query/include/protobuf/pg_query.pb-c.h +10846 -0
  254. data/ext/pg_query/include/protobuf/pg_query.pb.h +124718 -0
  255. data/ext/pg_query/include/regex/regex.h +184 -0
  256. data/ext/pg_query/include/replication/logicallauncher.h +31 -0
  257. data/ext/pg_query/include/replication/logicalproto.h +110 -0
  258. data/ext/pg_query/include/replication/logicalworker.h +19 -0
  259. data/ext/pg_query/include/replication/origin.h +73 -0
  260. data/ext/pg_query/include/replication/reorderbuffer.h +467 -0
  261. data/ext/pg_query/include/replication/slot.h +219 -0
  262. data/ext/pg_query/include/replication/syncrep.h +115 -0
  263. data/ext/pg_query/include/replication/walreceiver.h +340 -0
  264. data/ext/pg_query/include/replication/walsender.h +74 -0
  265. data/ext/pg_query/include/rewrite/prs2lock.h +46 -0
  266. data/ext/pg_query/include/rewrite/rewriteHandler.h +40 -0
  267. data/ext/pg_query/include/rewrite/rewriteManip.h +87 -0
  268. data/ext/pg_query/include/rewrite/rewriteSupport.h +26 -0
  269. data/ext/pg_query/include/storage/backendid.h +37 -0
  270. data/ext/pg_query/include/storage/block.h +121 -0
  271. data/ext/pg_query/include/storage/buf.h +46 -0
  272. data/ext/pg_query/include/storage/bufmgr.h +292 -0
  273. data/ext/pg_query/include/storage/bufpage.h +459 -0
  274. data/ext/pg_query/include/storage/condition_variable.h +62 -0
  275. data/ext/pg_query/include/storage/dsm.h +61 -0
  276. data/ext/pg_query/include/storage/dsm_impl.h +75 -0
  277. data/ext/pg_query/include/storage/fd.h +168 -0
  278. data/ext/pg_query/include/storage/ipc.h +81 -0
  279. data/ext/pg_query/include/storage/item.h +19 -0
  280. data/ext/pg_query/include/storage/itemid.h +184 -0
  281. data/ext/pg_query/include/storage/itemptr.h +206 -0
  282. data/ext/pg_query/include/storage/large_object.h +100 -0
  283. data/ext/pg_query/include/storage/latch.h +190 -0
  284. data/ext/pg_query/include/storage/lmgr.h +114 -0
  285. data/ext/pg_query/include/storage/lock.h +612 -0
  286. data/ext/pg_query/include/storage/lockdefs.h +59 -0
  287. data/ext/pg_query/include/storage/lwlock.h +232 -0
  288. data/ext/pg_query/include/storage/lwlocknames.h +51 -0
  289. data/ext/pg_query/include/storage/off.h +57 -0
  290. data/ext/pg_query/include/storage/pg_sema.h +61 -0
  291. data/ext/pg_query/include/storage/pg_shmem.h +90 -0
  292. data/ext/pg_query/include/storage/pmsignal.h +94 -0
  293. data/ext/pg_query/include/storage/predicate.h +87 -0
  294. data/ext/pg_query/include/storage/proc.h +333 -0
  295. data/ext/pg_query/include/storage/proclist_types.h +51 -0
  296. data/ext/pg_query/include/storage/procsignal.h +75 -0
  297. data/ext/pg_query/include/storage/relfilenode.h +99 -0
  298. data/ext/pg_query/include/storage/s_lock.h +1047 -0
  299. data/ext/pg_query/include/storage/sharedfileset.h +45 -0
  300. data/ext/pg_query/include/storage/shm_mq.h +85 -0
  301. data/ext/pg_query/include/storage/shm_toc.h +58 -0
  302. data/ext/pg_query/include/storage/shmem.h +81 -0
  303. data/ext/pg_query/include/storage/sinval.h +153 -0
  304. data/ext/pg_query/include/storage/sinvaladt.h +43 -0
  305. data/ext/pg_query/include/storage/smgr.h +109 -0
  306. data/ext/pg_query/include/storage/spin.h +77 -0
  307. data/ext/pg_query/include/storage/standby.h +91 -0
  308. data/ext/pg_query/include/storage/standbydefs.h +74 -0
  309. data/ext/pg_query/include/storage/sync.h +62 -0
  310. data/ext/pg_query/include/tcop/cmdtag.h +58 -0
  311. data/ext/pg_query/include/tcop/cmdtaglist.h +217 -0
  312. data/ext/pg_query/include/tcop/deparse_utility.h +108 -0
  313. data/ext/pg_query/include/tcop/dest.h +149 -0
  314. data/ext/pg_query/include/tcop/fastpath.h +21 -0
  315. data/ext/pg_query/include/tcop/pquery.h +45 -0
  316. data/ext/pg_query/include/tcop/tcopprot.h +89 -0
  317. data/ext/pg_query/include/tcop/utility.h +108 -0
  318. data/ext/pg_query/include/tsearch/ts_cache.h +98 -0
  319. data/ext/pg_query/include/utils/acl.h +312 -0
  320. data/ext/pg_query/include/utils/aclchk_internal.h +45 -0
  321. data/ext/pg_query/include/utils/array.h +458 -0
  322. data/ext/pg_query/include/utils/builtins.h +127 -0
  323. data/ext/pg_query/include/utils/bytea.h +27 -0
  324. data/ext/pg_query/include/utils/catcache.h +231 -0
  325. data/ext/pg_query/include/utils/date.h +90 -0
  326. data/ext/pg_query/include/utils/datetime.h +343 -0
  327. data/ext/pg_query/include/utils/datum.h +68 -0
  328. data/ext/pg_query/include/utils/dsa.h +123 -0
  329. data/ext/pg_query/include/utils/dynahash.h +19 -0
  330. data/ext/pg_query/include/utils/elog.h +439 -0
  331. data/ext/pg_query/include/utils/errcodes.h +352 -0
  332. data/ext/pg_query/include/utils/expandeddatum.h +159 -0
  333. data/ext/pg_query/include/utils/expandedrecord.h +231 -0
  334. data/ext/pg_query/include/utils/float.h +356 -0
  335. data/ext/pg_query/include/utils/fmgroids.h +2657 -0
  336. data/ext/pg_query/include/utils/fmgrprotos.h +2646 -0
  337. data/ext/pg_query/include/utils/fmgrtab.h +48 -0
  338. data/ext/pg_query/include/utils/guc.h +443 -0
  339. data/ext/pg_query/include/utils/guc_tables.h +272 -0
  340. data/ext/pg_query/include/utils/hsearch.h +149 -0
  341. data/ext/pg_query/include/utils/inval.h +64 -0
  342. data/ext/pg_query/include/utils/lsyscache.h +197 -0
  343. data/ext/pg_query/include/utils/memdebug.h +82 -0
  344. data/ext/pg_query/include/utils/memutils.h +225 -0
  345. data/ext/pg_query/include/utils/numeric.h +76 -0
  346. data/ext/pg_query/include/utils/palloc.h +136 -0
  347. data/ext/pg_query/include/utils/partcache.h +102 -0
  348. data/ext/pg_query/include/utils/pg_locale.h +119 -0
  349. data/ext/pg_query/include/utils/pg_lsn.h +29 -0
  350. data/ext/pg_query/include/utils/pidfile.h +56 -0
  351. data/ext/pg_query/include/utils/plancache.h +235 -0
  352. data/ext/pg_query/include/utils/portal.h +241 -0
  353. data/ext/pg_query/include/utils/probes.h +114 -0
  354. data/ext/pg_query/include/utils/ps_status.h +25 -0
  355. data/ext/pg_query/include/utils/queryenvironment.h +74 -0
  356. data/ext/pg_query/include/utils/regproc.h +28 -0
  357. data/ext/pg_query/include/utils/rel.h +644 -0
  358. data/ext/pg_query/include/utils/relcache.h +151 -0
  359. data/ext/pg_query/include/utils/reltrigger.h +81 -0
  360. data/ext/pg_query/include/utils/resowner.h +86 -0
  361. data/ext/pg_query/include/utils/rls.h +50 -0
  362. data/ext/pg_query/include/utils/ruleutils.h +44 -0
  363. data/ext/pg_query/include/utils/sharedtuplestore.h +61 -0
  364. data/ext/pg_query/include/utils/snapmgr.h +158 -0
  365. data/ext/pg_query/include/utils/snapshot.h +206 -0
  366. data/ext/pg_query/include/utils/sortsupport.h +276 -0
  367. data/ext/pg_query/include/utils/syscache.h +219 -0
  368. data/ext/pg_query/include/utils/timeout.h +88 -0
  369. data/ext/pg_query/include/utils/timestamp.h +116 -0
  370. data/ext/pg_query/include/utils/tuplesort.h +277 -0
  371. data/ext/pg_query/include/utils/tuplestore.h +91 -0
  372. data/ext/pg_query/include/utils/typcache.h +202 -0
  373. data/ext/pg_query/include/utils/tzparser.h +39 -0
  374. data/ext/pg_query/include/utils/varlena.h +39 -0
  375. data/ext/pg_query/include/utils/xml.h +84 -0
  376. data/ext/pg_query/include/xxhash.h +5445 -0
  377. data/ext/pg_query/include/xxhash/xxhash.h +5445 -0
  378. data/ext/pg_query/pg_query.c +104 -0
  379. data/ext/pg_query/pg_query.pb-c.c +37628 -0
  380. data/ext/pg_query/pg_query_deparse.c +9953 -0
  381. data/ext/pg_query/pg_query_fingerprint.c +292 -0
  382. data/ext/pg_query/pg_query_fingerprint.h +8 -0
  383. data/ext/pg_query/pg_query_internal.h +24 -0
  384. data/ext/pg_query/pg_query_json_plpgsql.c +738 -0
  385. data/ext/pg_query/pg_query_json_plpgsql.h +9 -0
  386. data/ext/pg_query/pg_query_normalize.c +437 -0
  387. data/ext/pg_query/pg_query_outfuncs.h +10 -0
  388. data/ext/pg_query/pg_query_outfuncs_json.c +297 -0
  389. data/ext/pg_query/pg_query_outfuncs_protobuf.c +237 -0
  390. data/ext/pg_query/pg_query_parse.c +148 -0
  391. data/ext/pg_query/pg_query_parse_plpgsql.c +460 -0
  392. data/ext/pg_query/pg_query_readfuncs.h +11 -0
  393. data/ext/pg_query/pg_query_readfuncs_protobuf.c +142 -0
  394. data/ext/pg_query/pg_query_ruby.c +108 -12
  395. data/ext/pg_query/pg_query_scan.c +173 -0
  396. data/ext/pg_query/pg_query_split.c +221 -0
  397. data/ext/pg_query/protobuf-c.c +3660 -0
  398. data/ext/pg_query/src_backend_catalog_namespace.c +1051 -0
  399. data/ext/pg_query/src_backend_catalog_pg_proc.c +142 -0
  400. data/ext/pg_query/src_backend_commands_define.c +117 -0
  401. data/ext/pg_query/src_backend_libpq_pqcomm.c +651 -0
  402. data/ext/pg_query/src_backend_nodes_bitmapset.c +513 -0
  403. data/ext/pg_query/src_backend_nodes_copyfuncs.c +6013 -0
  404. data/ext/pg_query/src_backend_nodes_equalfuncs.c +4003 -0
  405. data/ext/pg_query/src_backend_nodes_extensible.c +99 -0
  406. data/ext/pg_query/src_backend_nodes_list.c +922 -0
  407. data/ext/pg_query/src_backend_nodes_makefuncs.c +417 -0
  408. data/ext/pg_query/src_backend_nodes_nodeFuncs.c +1363 -0
  409. data/ext/pg_query/src_backend_nodes_value.c +84 -0
  410. data/ext/pg_query/src_backend_parser_gram.c +47456 -0
  411. data/ext/pg_query/src_backend_parser_parse_expr.c +313 -0
  412. data/ext/pg_query/src_backend_parser_parser.c +497 -0
  413. data/ext/pg_query/src_backend_parser_scan.c +7091 -0
  414. data/ext/pg_query/src_backend_parser_scansup.c +160 -0
  415. data/ext/pg_query/src_backend_postmaster_postmaster.c +2230 -0
  416. data/ext/pg_query/src_backend_storage_ipc_ipc.c +192 -0
  417. data/ext/pg_query/src_backend_storage_lmgr_s_lock.c +370 -0
  418. data/ext/pg_query/src_backend_tcop_postgres.c +776 -0
  419. data/ext/pg_query/src_backend_utils_adt_datum.c +326 -0
  420. data/ext/pg_query/src_backend_utils_adt_expandeddatum.c +98 -0
  421. data/ext/pg_query/src_backend_utils_adt_format_type.c +136 -0
  422. data/ext/pg_query/src_backend_utils_adt_ruleutils.c +1683 -0
  423. data/ext/pg_query/src_backend_utils_error_assert.c +74 -0
  424. data/ext/pg_query/src_backend_utils_error_elog.c +1748 -0
  425. data/ext/pg_query/src_backend_utils_fmgr_fmgr.c +570 -0
  426. data/ext/pg_query/src_backend_utils_hash_dynahash.c +1086 -0
  427. data/ext/pg_query/src_backend_utils_init_globals.c +168 -0
  428. data/ext/pg_query/src_backend_utils_mb_mbutils.c +839 -0
  429. data/ext/pg_query/src_backend_utils_misc_guc.c +1831 -0
  430. data/ext/pg_query/src_backend_utils_mmgr_aset.c +1560 -0
  431. data/ext/pg_query/src_backend_utils_mmgr_mcxt.c +1006 -0
  432. data/ext/pg_query/src_common_encnames.c +158 -0
  433. data/ext/pg_query/src_common_keywords.c +39 -0
  434. data/ext/pg_query/src_common_kwlist_d.h +1081 -0
  435. data/ext/pg_query/src_common_kwlookup.c +91 -0
  436. data/ext/pg_query/src_common_psprintf.c +158 -0
  437. data/ext/pg_query/src_common_string.c +86 -0
  438. data/ext/pg_query/src_common_stringinfo.c +336 -0
  439. data/ext/pg_query/src_common_wchar.c +1651 -0
  440. data/ext/pg_query/src_pl_plpgsql_src_pl_comp.c +1133 -0
  441. data/ext/pg_query/src_pl_plpgsql_src_pl_funcs.c +877 -0
  442. data/ext/pg_query/src_pl_plpgsql_src_pl_gram.c +6533 -0
  443. data/ext/pg_query/src_pl_plpgsql_src_pl_handler.c +107 -0
  444. data/ext/pg_query/src_pl_plpgsql_src_pl_reserved_kwlist_d.h +123 -0
  445. data/ext/pg_query/src_pl_plpgsql_src_pl_scanner.c +671 -0
  446. data/ext/pg_query/src_pl_plpgsql_src_pl_unreserved_kwlist_d.h +255 -0
  447. data/ext/pg_query/src_port_erand48.c +127 -0
  448. data/ext/pg_query/src_port_pg_bitutils.c +246 -0
  449. data/ext/pg_query/src_port_pgsleep.c +69 -0
  450. data/ext/pg_query/src_port_pgstrcasecmp.c +83 -0
  451. data/ext/pg_query/src_port_qsort.c +240 -0
  452. data/ext/pg_query/src_port_random.c +31 -0
  453. data/ext/pg_query/src_port_snprintf.c +1449 -0
  454. data/ext/pg_query/src_port_strerror.c +324 -0
  455. data/ext/pg_query/src_port_strnlen.c +39 -0
  456. data/ext/pg_query/xxhash.c +43 -0
  457. data/lib/pg_query.rb +7 -4
  458. data/lib/pg_query/constants.rb +21 -0
  459. data/lib/pg_query/deparse.rb +16 -1117
  460. data/lib/pg_query/filter_columns.rb +86 -85
  461. data/lib/pg_query/fingerprint.rb +122 -87
  462. data/lib/pg_query/json_field_names.rb +1402 -0
  463. data/lib/pg_query/node.rb +31 -0
  464. data/lib/pg_query/param_refs.rb +42 -37
  465. data/lib/pg_query/parse.rb +220 -200
  466. data/lib/pg_query/parse_error.rb +1 -1
  467. data/lib/pg_query/pg_query_pb.rb +3211 -0
  468. data/lib/pg_query/scan.rb +23 -0
  469. data/lib/pg_query/treewalker.rb +24 -40
  470. data/lib/pg_query/truncate.rb +64 -43
  471. data/lib/pg_query/version.rb +2 -2
  472. metadata +473 -11
  473. data/ext/pg_query/pg_query_ruby.h +0 -10
  474. data/lib/pg_query/deep_dup.rb +0 -16
  475. data/lib/pg_query/deparse/alter_table.rb +0 -42
  476. data/lib/pg_query/deparse/interval.rb +0 -105
  477. data/lib/pg_query/legacy_parsetree.rb +0 -109
  478. data/lib/pg_query/node_types.rb +0 -284
@@ -0,0 +1,227 @@
1
+ /*
2
+ * xlogrecord.h
3
+ *
4
+ * Definitions for the WAL record format.
5
+ *
6
+ * Portions Copyright (c) 1996-2020, PostgreSQL Global Development Group
7
+ * Portions Copyright (c) 1994, Regents of the University of California
8
+ *
9
+ * src/include/access/xlogrecord.h
10
+ */
11
+ #ifndef XLOGRECORD_H
12
+ #define XLOGRECORD_H
13
+
14
+ #include "access/rmgr.h"
15
+ #include "access/xlogdefs.h"
16
+ #include "port/pg_crc32c.h"
17
+ #include "storage/block.h"
18
+ #include "storage/relfilenode.h"
19
+
20
+ /*
21
+ * The overall layout of an XLOG record is:
22
+ * Fixed-size header (XLogRecord struct)
23
+ * XLogRecordBlockHeader struct
24
+ * XLogRecordBlockHeader struct
25
+ * ...
26
+ * XLogRecordDataHeader[Short|Long] struct
27
+ * block data
28
+ * block data
29
+ * ...
30
+ * main data
31
+ *
32
+ * There can be zero or more XLogRecordBlockHeaders, and 0 or more bytes of
33
+ * rmgr-specific data not associated with a block. XLogRecord structs
34
+ * always start on MAXALIGN boundaries in the WAL files, but the rest of
35
+ * the fields are not aligned.
36
+ *
37
+ * The XLogRecordBlockHeader, XLogRecordDataHeaderShort and
38
+ * XLogRecordDataHeaderLong structs all begin with a single 'id' byte. It's
39
+ * used to distinguish between block references, and the main data structs.
40
+ */
41
+ typedef struct XLogRecord
42
+ {
43
+ uint32 xl_tot_len; /* total len of entire record */
44
+ TransactionId xl_xid; /* xact id */
45
+ XLogRecPtr xl_prev; /* ptr to previous record in log */
46
+ uint8 xl_info; /* flag bits, see below */
47
+ RmgrId xl_rmid; /* resource manager for this record */
48
+ /* 2 bytes of padding here, initialize to zero */
49
+ pg_crc32c xl_crc; /* CRC for this record */
50
+
51
+ /* XLogRecordBlockHeaders and XLogRecordDataHeader follow, no padding */
52
+
53
+ } XLogRecord;
54
+
55
+ #define SizeOfXLogRecord (offsetof(XLogRecord, xl_crc) + sizeof(pg_crc32c))
56
+
57
+ /*
58
+ * The high 4 bits in xl_info may be used freely by rmgr. The
59
+ * XLR_SPECIAL_REL_UPDATE and XLR_CHECK_CONSISTENCY bits can be passed by
60
+ * XLogInsert caller. The rest are set internally by XLogInsert.
61
+ */
62
+ #define XLR_INFO_MASK 0x0F
63
+ #define XLR_RMGR_INFO_MASK 0xF0
64
+
65
+ /*
66
+ * If a WAL record modifies any relation files, in ways not covered by the
67
+ * usual block references, this flag is set. This is not used for anything
68
+ * by PostgreSQL itself, but it allows external tools that read WAL and keep
69
+ * track of modified blocks to recognize such special record types.
70
+ */
71
+ #define XLR_SPECIAL_REL_UPDATE 0x01
72
+
73
+ /*
74
+ * Enforces consistency checks of replayed WAL at recovery. If enabled,
75
+ * each record will log a full-page write for each block modified by the
76
+ * record and will reuse it afterwards for consistency checks. The caller
77
+ * of XLogInsert can use this value if necessary, but if
78
+ * wal_consistency_checking is enabled for a rmgr this is set unconditionally.
79
+ */
80
+ #define XLR_CHECK_CONSISTENCY 0x02
81
+
82
+ /*
83
+ * Header info for block data appended to an XLOG record.
84
+ *
85
+ * 'data_length' is the length of the rmgr-specific payload data associated
86
+ * with this block. It does not include the possible full page image, nor
87
+ * XLogRecordBlockHeader struct itself.
88
+ *
89
+ * Note that we don't attempt to align the XLogRecordBlockHeader struct!
90
+ * So, the struct must be copied to aligned local storage before use.
91
+ */
92
+ typedef struct XLogRecordBlockHeader
93
+ {
94
+ uint8 id; /* block reference ID */
95
+ uint8 fork_flags; /* fork within the relation, and flags */
96
+ uint16 data_length; /* number of payload bytes (not including page
97
+ * image) */
98
+
99
+ /* If BKPBLOCK_HAS_IMAGE, an XLogRecordBlockImageHeader struct follows */
100
+ /* If BKPBLOCK_SAME_REL is not set, a RelFileNode follows */
101
+ /* BlockNumber follows */
102
+ } XLogRecordBlockHeader;
103
+
104
+ #define SizeOfXLogRecordBlockHeader (offsetof(XLogRecordBlockHeader, data_length) + sizeof(uint16))
105
+
106
+ /*
107
+ * Additional header information when a full-page image is included
108
+ * (i.e. when BKPBLOCK_HAS_IMAGE is set).
109
+ *
110
+ * The XLOG code is aware that PG data pages usually contain an unused "hole"
111
+ * in the middle, which contains only zero bytes. Since we know that the
112
+ * "hole" is all zeros, we remove it from the stored data (and it's not counted
113
+ * in the XLOG record's CRC, either). Hence, the amount of block data actually
114
+ * present is (BLCKSZ - <length of "hole" bytes>).
115
+ *
116
+ * Additionally, when wal_compression is enabled, we will try to compress full
117
+ * page images using the PGLZ compression algorithm, after removing the "hole".
118
+ * This can reduce the WAL volume, but at some extra cost of CPU spent
119
+ * on the compression during WAL logging. In this case, since the "hole"
120
+ * length cannot be calculated by subtracting the number of page image bytes
121
+ * from BLCKSZ, basically it needs to be stored as an extra information.
122
+ * But when no "hole" exists, we can assume that the "hole" length is zero
123
+ * and no such an extra information needs to be stored. Note that
124
+ * the original version of page image is stored in WAL instead of the
125
+ * compressed one if the number of bytes saved by compression is less than
126
+ * the length of extra information. Hence, when a page image is successfully
127
+ * compressed, the amount of block data actually present is less than
128
+ * BLCKSZ - the length of "hole" bytes - the length of extra information.
129
+ */
130
+ typedef struct XLogRecordBlockImageHeader
131
+ {
132
+ uint16 length; /* number of page image bytes */
133
+ uint16 hole_offset; /* number of bytes before "hole" */
134
+ uint8 bimg_info; /* flag bits, see below */
135
+
136
+ /*
137
+ * If BKPIMAGE_HAS_HOLE and BKPIMAGE_IS_COMPRESSED, an
138
+ * XLogRecordBlockCompressHeader struct follows.
139
+ */
140
+ } XLogRecordBlockImageHeader;
141
+
142
+ #define SizeOfXLogRecordBlockImageHeader \
143
+ (offsetof(XLogRecordBlockImageHeader, bimg_info) + sizeof(uint8))
144
+
145
+ /* Information stored in bimg_info */
146
+ #define BKPIMAGE_HAS_HOLE 0x01 /* page image has "hole" */
147
+ #define BKPIMAGE_IS_COMPRESSED 0x02 /* page image is compressed */
148
+ #define BKPIMAGE_APPLY 0x04 /* page image should be restored during
149
+ * replay */
150
+
151
+ /*
152
+ * Extra header information used when page image has "hole" and
153
+ * is compressed.
154
+ */
155
+ typedef struct XLogRecordBlockCompressHeader
156
+ {
157
+ uint16 hole_length; /* number of bytes in "hole" */
158
+ } XLogRecordBlockCompressHeader;
159
+
160
+ #define SizeOfXLogRecordBlockCompressHeader \
161
+ sizeof(XLogRecordBlockCompressHeader)
162
+
163
+ /*
164
+ * Maximum size of the header for a block reference. This is used to size a
165
+ * temporary buffer for constructing the header.
166
+ */
167
+ #define MaxSizeOfXLogRecordBlockHeader \
168
+ (SizeOfXLogRecordBlockHeader + \
169
+ SizeOfXLogRecordBlockImageHeader + \
170
+ SizeOfXLogRecordBlockCompressHeader + \
171
+ sizeof(RelFileNode) + \
172
+ sizeof(BlockNumber))
173
+
174
+ /*
175
+ * The fork number fits in the lower 4 bits in the fork_flags field. The upper
176
+ * bits are used for flags.
177
+ */
178
+ #define BKPBLOCK_FORK_MASK 0x0F
179
+ #define BKPBLOCK_FLAG_MASK 0xF0
180
+ #define BKPBLOCK_HAS_IMAGE 0x10 /* block data is an XLogRecordBlockImage */
181
+ #define BKPBLOCK_HAS_DATA 0x20
182
+ #define BKPBLOCK_WILL_INIT 0x40 /* redo will re-init the page */
183
+ #define BKPBLOCK_SAME_REL 0x80 /* RelFileNode omitted, same as previous */
184
+
185
+ /*
186
+ * XLogRecordDataHeaderShort/Long are used for the "main data" portion of
187
+ * the record. If the length of the data is less than 256 bytes, the short
188
+ * form is used, with a single byte to hold the length. Otherwise the long
189
+ * form is used.
190
+ *
191
+ * (These structs are currently not used in the code, they are here just for
192
+ * documentation purposes).
193
+ */
194
+ typedef struct XLogRecordDataHeaderShort
195
+ {
196
+ uint8 id; /* XLR_BLOCK_ID_DATA_SHORT */
197
+ uint8 data_length; /* number of payload bytes */
198
+ } XLogRecordDataHeaderShort;
199
+
200
+ #define SizeOfXLogRecordDataHeaderShort (sizeof(uint8) * 2)
201
+
202
+ typedef struct XLogRecordDataHeaderLong
203
+ {
204
+ uint8 id; /* XLR_BLOCK_ID_DATA_LONG */
205
+ /* followed by uint32 data_length, unaligned */
206
+ } XLogRecordDataHeaderLong;
207
+
208
+ #define SizeOfXLogRecordDataHeaderLong (sizeof(uint8) + sizeof(uint32))
209
+
210
+ /*
211
+ * Block IDs used to distinguish different kinds of record fragments. Block
212
+ * references are numbered from 0 to XLR_MAX_BLOCK_ID. A rmgr is free to use
213
+ * any ID number in that range (although you should stick to small numbers,
214
+ * because the WAL machinery is optimized for that case). A couple of ID
215
+ * numbers are reserved to denote the "main" data portion of the record.
216
+ *
217
+ * The maximum is currently set at 32, quite arbitrarily. Most records only
218
+ * need a handful of block references, but there are a few exceptions that
219
+ * need more.
220
+ */
221
+ #define XLR_MAX_BLOCK_ID 32
222
+
223
+ #define XLR_BLOCK_ID_DATA_SHORT 255
224
+ #define XLR_BLOCK_ID_DATA_LONG 254
225
+ #define XLR_BLOCK_ID_ORIGIN 253
226
+
227
+ #endif /* XLOGRECORD_H */
@@ -0,0 +1,62 @@
1
+ /*-------------------------------------------------------------------------
2
+ *
3
+ * bootstrap.h
4
+ * include file for the bootstrapping code
5
+ *
6
+ *
7
+ * Portions Copyright (c) 1996-2020, PostgreSQL Global Development Group
8
+ * Portions Copyright (c) 1994, Regents of the University of California
9
+ *
10
+ * src/include/bootstrap/bootstrap.h
11
+ *
12
+ *-------------------------------------------------------------------------
13
+ */
14
+ #ifndef BOOTSTRAP_H
15
+ #define BOOTSTRAP_H
16
+
17
+ #include "nodes/execnodes.h"
18
+
19
+
20
+ /*
21
+ * MAXATTR is the maximum number of attributes in a relation supported
22
+ * at bootstrap time (i.e., the max possible in a system table).
23
+ */
24
+ #define MAXATTR 40
25
+
26
+ #define BOOTCOL_NULL_AUTO 1
27
+ #define BOOTCOL_NULL_FORCE_NULL 2
28
+ #define BOOTCOL_NULL_FORCE_NOT_NULL 3
29
+
30
+ extern Relation boot_reldesc;
31
+ extern Form_pg_attribute attrtypes[MAXATTR];
32
+ extern int numattr;
33
+
34
+
35
+ extern void AuxiliaryProcessMain(int argc, char *argv[]) pg_attribute_noreturn();
36
+
37
+ extern void closerel(char *name);
38
+ extern void boot_openrel(char *name);
39
+
40
+ extern void DefineAttr(char *name, char *type, int attnum, int nullness);
41
+ extern void InsertOneTuple(void);
42
+ extern void InsertOneValue(char *value, int i);
43
+ extern void InsertOneNull(int i);
44
+
45
+ extern void index_register(Oid heap, Oid ind, IndexInfo *indexInfo);
46
+ extern void build_indices(void);
47
+
48
+ extern void boot_get_type_io_data(Oid typid,
49
+ int16 *typlen,
50
+ bool *typbyval,
51
+ char *typalign,
52
+ char *typdelim,
53
+ Oid *typioparam,
54
+ Oid *typinput,
55
+ Oid *typoutput);
56
+
57
+ extern int boot_yyparse(void);
58
+
59
+ extern int boot_yylex(void);
60
+ extern void boot_yyerror(const char *str) pg_attribute_noreturn();
61
+
62
+ #endif /* BOOTSTRAP_H */
@@ -0,0 +1,1322 @@
1
+ /*-------------------------------------------------------------------------
2
+ *
3
+ * c.h
4
+ * Fundamental C definitions. This is included by every .c file in
5
+ * PostgreSQL (via either postgres.h or postgres_fe.h, as appropriate).
6
+ *
7
+ * Note that the definitions here are not intended to be exposed to clients
8
+ * of the frontend interface libraries --- so we don't worry much about
9
+ * polluting the namespace with lots of stuff...
10
+ *
11
+ *
12
+ * Portions Copyright (c) 1996-2020, PostgreSQL Global Development Group
13
+ * Portions Copyright (c) 1994, Regents of the University of California
14
+ *
15
+ * src/include/c.h
16
+ *
17
+ *-------------------------------------------------------------------------
18
+ */
19
+ /*
20
+ *----------------------------------------------------------------
21
+ * TABLE OF CONTENTS
22
+ *
23
+ * When adding stuff to this file, please try to put stuff
24
+ * into the relevant section, or add new sections as appropriate.
25
+ *
26
+ * section description
27
+ * ------- ------------------------------------------------
28
+ * 0) pg_config.h and standard system headers
29
+ * 1) compiler characteristics
30
+ * 2) bool, true, false
31
+ * 3) standard system types
32
+ * 4) IsValid macros for system types
33
+ * 5) offsetof, lengthof, alignment
34
+ * 6) assertions
35
+ * 7) widely useful macros
36
+ * 8) random stuff
37
+ * 9) system-specific hacks
38
+ *
39
+ * NOTE: since this file is included by both frontend and backend modules,
40
+ * it's usually wrong to put an "extern" declaration here, unless it's
41
+ * ifdef'd so that it's seen in only one case or the other.
42
+ * typedefs and macros are the kind of thing that might go here.
43
+ *
44
+ *----------------------------------------------------------------
45
+ */
46
+ #ifndef C_H
47
+ #define C_H
48
+
49
+ #include "postgres_ext.h"
50
+
51
+ /* Must undef pg_config_ext.h symbols before including pg_config.h */
52
+ #undef PG_INT64_TYPE
53
+
54
+ #include "pg_config.h"
55
+ #include "pg_config_manual.h" /* must be after pg_config.h */
56
+ #include "pg_config_os.h" /* must be before any system header files */
57
+
58
+ /* System header files that should be available everywhere in Postgres */
59
+ #include <stdio.h>
60
+ #include <stdlib.h>
61
+ #include <string.h>
62
+ #include <stddef.h>
63
+ #include <stdarg.h>
64
+ #ifdef HAVE_STRINGS_H
65
+ #include <strings.h>
66
+ #endif
67
+ #include <stdint.h>
68
+ #include <sys/types.h>
69
+ #include <errno.h>
70
+ #if defined(WIN32) || defined(__CYGWIN__)
71
+ #include <fcntl.h> /* ensure O_BINARY is available */
72
+ #endif
73
+ #include <locale.h>
74
+ #ifdef ENABLE_NLS
75
+ #include <libintl.h>
76
+ #endif
77
+
78
+
79
+ /* ----------------------------------------------------------------
80
+ * Section 1: compiler characteristics
81
+ *
82
+ * type prefixes (const, signed, volatile, inline) are handled in pg_config.h.
83
+ * ----------------------------------------------------------------
84
+ */
85
+
86
+ /*
87
+ * Disable "inline" if PG_FORCE_DISABLE_INLINE is defined.
88
+ * This is used to work around compiler bugs and might also be useful for
89
+ * investigatory purposes.
90
+ */
91
+ #ifdef PG_FORCE_DISABLE_INLINE
92
+ #undef inline
93
+ #define inline
94
+ #endif
95
+
96
+ /*
97
+ * Attribute macros
98
+ *
99
+ * GCC: https://gcc.gnu.org/onlinedocs/gcc/Function-Attributes.html
100
+ * GCC: https://gcc.gnu.org/onlinedocs/gcc/Type-Attributes.html
101
+ * Sunpro: https://docs.oracle.com/cd/E18659_01/html/821-1384/gjzke.html
102
+ * XLC: https://www.ibm.com/support/knowledgecenter/SSGH2K_13.1.2/com.ibm.xlc131.aix.doc/language_ref/function_attributes.html
103
+ * XLC: https://www.ibm.com/support/knowledgecenter/SSGH2K_13.1.2/com.ibm.xlc131.aix.doc/language_ref/type_attrib.html
104
+ */
105
+
106
+ /* only GCC supports the unused attribute */
107
+ #ifdef __GNUC__
108
+ #define pg_attribute_unused() __attribute__((unused))
109
+ #else
110
+ #define pg_attribute_unused()
111
+ #endif
112
+
113
+ /*
114
+ * Append PG_USED_FOR_ASSERTS_ONLY to definitions of variables that are only
115
+ * used in assert-enabled builds, to avoid compiler warnings about unused
116
+ * variables in assert-disabled builds.
117
+ */
118
+ #ifdef USE_ASSERT_CHECKING
119
+ #define PG_USED_FOR_ASSERTS_ONLY
120
+ #else
121
+ #define PG_USED_FOR_ASSERTS_ONLY pg_attribute_unused()
122
+ #endif
123
+
124
+ /* GCC and XLC support format attributes */
125
+ #if defined(__GNUC__) || defined(__IBMC__)
126
+ #define pg_attribute_format_arg(a) __attribute__((format_arg(a)))
127
+ #define pg_attribute_printf(f,a) __attribute__((format(PG_PRINTF_ATTRIBUTE, f, a)))
128
+ #else
129
+ #define pg_attribute_format_arg(a)
130
+ #define pg_attribute_printf(f,a)
131
+ #endif
132
+
133
+ /* GCC, Sunpro and XLC support aligned, packed and noreturn */
134
+ #if defined(__GNUC__) || defined(__SUNPRO_C) || defined(__IBMC__)
135
+ #define pg_attribute_aligned(a) __attribute__((aligned(a)))
136
+ #define pg_attribute_noreturn() __attribute__((noreturn))
137
+ #define pg_attribute_packed() __attribute__((packed))
138
+ #define HAVE_PG_ATTRIBUTE_NORETURN 1
139
+ #else
140
+ /*
141
+ * NB: aligned and packed are not given default definitions because they
142
+ * affect code functionality; they *must* be implemented by the compiler
143
+ * if they are to be used.
144
+ */
145
+ #define pg_attribute_noreturn()
146
+ #endif
147
+
148
+ /*
149
+ * Use "pg_attribute_always_inline" in place of "inline" for functions that
150
+ * we wish to force inlining of, even when the compiler's heuristics would
151
+ * choose not to. But, if possible, don't force inlining in unoptimized
152
+ * debug builds.
153
+ */
154
+ #if (defined(__GNUC__) && __GNUC__ > 3 && defined(__OPTIMIZE__)) || defined(__SUNPRO_C) || defined(__IBMC__)
155
+ /* GCC > 3, Sunpro and XLC support always_inline via __attribute__ */
156
+ #define pg_attribute_always_inline __attribute__((always_inline)) inline
157
+ #elif defined(_MSC_VER)
158
+ /* MSVC has a special keyword for this */
159
+ #define pg_attribute_always_inline __forceinline
160
+ #else
161
+ /* Otherwise, the best we can do is to say "inline" */
162
+ #define pg_attribute_always_inline inline
163
+ #endif
164
+
165
+ /*
166
+ * Forcing a function not to be inlined can be useful if it's the slow path of
167
+ * a performance-critical function, or should be visible in profiles to allow
168
+ * for proper cost attribution. Note that unlike the pg_attribute_XXX macros
169
+ * above, this should be placed before the function's return type and name.
170
+ */
171
+ /* GCC, Sunpro and XLC support noinline via __attribute__ */
172
+ #if (defined(__GNUC__) && __GNUC__ > 2) || defined(__SUNPRO_C) || defined(__IBMC__)
173
+ #define pg_noinline __attribute__((noinline))
174
+ /* msvc via declspec */
175
+ #elif defined(_MSC_VER)
176
+ #define pg_noinline __declspec(noinline)
177
+ #else
178
+ #define pg_noinline
179
+ #endif
180
+
181
+ /*
182
+ * Mark a point as unreachable in a portable fashion. This should preferably
183
+ * be something that the compiler understands, to aid code generation.
184
+ * In assert-enabled builds, we prefer abort() for debugging reasons.
185
+ */
186
+ #if defined(HAVE__BUILTIN_UNREACHABLE) && !defined(USE_ASSERT_CHECKING)
187
+ #define pg_unreachable() __builtin_unreachable()
188
+ #elif defined(_MSC_VER) && !defined(USE_ASSERT_CHECKING)
189
+ #define pg_unreachable() __assume(0)
190
+ #else
191
+ #define pg_unreachable() abort()
192
+ #endif
193
+
194
+ /*
195
+ * Hints to the compiler about the likelihood of a branch. Both likely() and
196
+ * unlikely() return the boolean value of the contained expression.
197
+ *
198
+ * These should only be used sparingly, in very hot code paths. It's very easy
199
+ * to mis-estimate likelihoods.
200
+ */
201
+ #if __GNUC__ >= 3
202
+ #define likely(x) __builtin_expect((x) != 0, 1)
203
+ #define unlikely(x) __builtin_expect((x) != 0, 0)
204
+ #else
205
+ #define likely(x) ((x) != 0)
206
+ #define unlikely(x) ((x) != 0)
207
+ #endif
208
+
209
+ /*
210
+ * CppAsString
211
+ * Convert the argument to a string, using the C preprocessor.
212
+ * CppAsString2
213
+ * Convert the argument to a string, after one round of macro expansion.
214
+ * CppConcat
215
+ * Concatenate two arguments together, using the C preprocessor.
216
+ *
217
+ * Note: There used to be support here for pre-ANSI C compilers that didn't
218
+ * support # and ##. Nowadays, these macros are just for clarity and/or
219
+ * backward compatibility with existing PostgreSQL code.
220
+ */
221
+ #define CppAsString(identifier) #identifier
222
+ #define CppAsString2(x) CppAsString(x)
223
+ #define CppConcat(x, y) x##y
224
+
225
+ /*
226
+ * VA_ARGS_NARGS
227
+ * Returns the number of macro arguments it is passed.
228
+ *
229
+ * An empty argument still counts as an argument, so effectively, this is
230
+ * "one more than the number of commas in the argument list".
231
+ *
232
+ * This works for up to 63 arguments. Internally, VA_ARGS_NARGS_() is passed
233
+ * 64+N arguments, and the C99 standard only requires macros to allow up to
234
+ * 127 arguments, so we can't portably go higher. The implementation is
235
+ * pretty trivial: VA_ARGS_NARGS_() returns its 64th argument, and we set up
236
+ * the call so that that is the appropriate one of the list of constants.
237
+ * This idea is due to Laurent Deniau.
238
+ */
239
+ #define VA_ARGS_NARGS(...) \
240
+ VA_ARGS_NARGS_(__VA_ARGS__, \
241
+ 63,62,61,60, \
242
+ 59,58,57,56,55,54,53,52,51,50, \
243
+ 49,48,47,46,45,44,43,42,41,40, \
244
+ 39,38,37,36,35,34,33,32,31,30, \
245
+ 29,28,27,26,25,24,23,22,21,20, \
246
+ 19,18,17,16,15,14,13,12,11,10, \
247
+ 9, 8, 7, 6, 5, 4, 3, 2, 1, 0)
248
+ #define VA_ARGS_NARGS_( \
249
+ _01,_02,_03,_04,_05,_06,_07,_08,_09,_10, \
250
+ _11,_12,_13,_14,_15,_16,_17,_18,_19,_20, \
251
+ _21,_22,_23,_24,_25,_26,_27,_28,_29,_30, \
252
+ _31,_32,_33,_34,_35,_36,_37,_38,_39,_40, \
253
+ _41,_42,_43,_44,_45,_46,_47,_48,_49,_50, \
254
+ _51,_52,_53,_54,_55,_56,_57,_58,_59,_60, \
255
+ _61,_62,_63, N, ...) \
256
+ (N)
257
+
258
+ /*
259
+ * dummyret is used to set return values in macros that use ?: to make
260
+ * assignments. gcc wants these to be void, other compilers like char
261
+ */
262
+ #ifdef __GNUC__ /* GNU cc */
263
+ #define dummyret void
264
+ #else
265
+ #define dummyret char
266
+ #endif
267
+
268
+ /*
269
+ * We require C99, hence the compiler should understand flexible array
270
+ * members. However, for documentation purposes we still consider it to be
271
+ * project style to write "field[FLEXIBLE_ARRAY_MEMBER]" not just "field[]".
272
+ * When computing the size of such an object, use "offsetof(struct s, f)"
273
+ * for portability. Don't use "offsetof(struct s, f[0])", as this doesn't
274
+ * work with MSVC and with C++ compilers.
275
+ */
276
+ #define FLEXIBLE_ARRAY_MEMBER /* empty */
277
+
278
+ /* Which __func__ symbol do we have, if any? */
279
+ #ifdef HAVE_FUNCNAME__FUNC
280
+ #define PG_FUNCNAME_MACRO __func__
281
+ #else
282
+ #ifdef HAVE_FUNCNAME__FUNCTION
283
+ #define PG_FUNCNAME_MACRO __FUNCTION__
284
+ #else
285
+ #define PG_FUNCNAME_MACRO NULL
286
+ #endif
287
+ #endif
288
+
289
+
290
+ /* ----------------------------------------------------------------
291
+ * Section 2: bool, true, false
292
+ * ----------------------------------------------------------------
293
+ */
294
+
295
+ /*
296
+ * bool
297
+ * Boolean value, either true or false.
298
+ *
299
+ * We use stdbool.h if available and its bool has size 1. That's useful for
300
+ * better compiler and debugger output and for compatibility with third-party
301
+ * libraries. But PostgreSQL currently cannot deal with bool of other sizes;
302
+ * there are static assertions around the code to prevent that.
303
+ *
304
+ * For C++ compilers, we assume the compiler has a compatible built-in
305
+ * definition of bool.
306
+ *
307
+ * See also the version of this code in src/interfaces/ecpg/include/ecpglib.h.
308
+ */
309
+
310
+ #ifndef __cplusplus
311
+
312
+ #ifdef PG_USE_STDBOOL
313
+ #include <stdbool.h>
314
+ #else
315
+
316
+ #ifndef bool
317
+ typedef unsigned char bool;
318
+ #endif
319
+
320
+ #ifndef true
321
+ #define true ((bool) 1)
322
+ #endif
323
+
324
+ #ifndef false
325
+ #define false ((bool) 0)
326
+ #endif
327
+
328
+ #endif /* not PG_USE_STDBOOL */
329
+ #endif /* not C++ */
330
+
331
+
332
+ /* ----------------------------------------------------------------
333
+ * Section 3: standard system types
334
+ * ----------------------------------------------------------------
335
+ */
336
+
337
+ /*
338
+ * Pointer
339
+ * Variable holding address of any memory resident object.
340
+ *
341
+ * XXX Pointer arithmetic is done with this, so it can't be void *
342
+ * under "true" ANSI compilers.
343
+ */
344
+ typedef char *Pointer;
345
+
346
+ /*
347
+ * intN
348
+ * Signed integer, EXACTLY N BITS IN SIZE,
349
+ * used for numerical computations and the
350
+ * frontend/backend protocol.
351
+ */
352
+ #ifndef HAVE_INT8
353
+ typedef signed char int8; /* == 8 bits */
354
+ typedef signed short int16; /* == 16 bits */
355
+ typedef signed int int32; /* == 32 bits */
356
+ #endif /* not HAVE_INT8 */
357
+
358
+ /*
359
+ * uintN
360
+ * Unsigned integer, EXACTLY N BITS IN SIZE,
361
+ * used for numerical computations and the
362
+ * frontend/backend protocol.
363
+ */
364
+ #ifndef HAVE_UINT8
365
+ typedef unsigned char uint8; /* == 8 bits */
366
+ typedef unsigned short uint16; /* == 16 bits */
367
+ typedef unsigned int uint32; /* == 32 bits */
368
+ #endif /* not HAVE_UINT8 */
369
+
370
+ /*
371
+ * bitsN
372
+ * Unit of bitwise operation, AT LEAST N BITS IN SIZE.
373
+ */
374
+ typedef uint8 bits8; /* >= 8 bits */
375
+ typedef uint16 bits16; /* >= 16 bits */
376
+ typedef uint32 bits32; /* >= 32 bits */
377
+
378
+ /*
379
+ * 64-bit integers
380
+ */
381
+ #ifdef HAVE_LONG_INT_64
382
+ /* Plain "long int" fits, use it */
383
+
384
+ #ifndef HAVE_INT64
385
+ typedef long int int64;
386
+ #endif
387
+ #ifndef HAVE_UINT64
388
+ typedef unsigned long int uint64;
389
+ #endif
390
+ #define INT64CONST(x) (x##L)
391
+ #define UINT64CONST(x) (x##UL)
392
+ #elif defined(HAVE_LONG_LONG_INT_64)
393
+ /* We have working support for "long long int", use that */
394
+
395
+ #ifndef HAVE_INT64
396
+ typedef long long int int64;
397
+ #endif
398
+ #ifndef HAVE_UINT64
399
+ typedef unsigned long long int uint64;
400
+ #endif
401
+ #define INT64CONST(x) (x##LL)
402
+ #define UINT64CONST(x) (x##ULL)
403
+ #else
404
+ /* neither HAVE_LONG_INT_64 nor HAVE_LONG_LONG_INT_64 */
405
+ #error must have a working 64-bit integer datatype
406
+ #endif
407
+
408
+ /* snprintf format strings to use for 64-bit integers */
409
+ #define INT64_FORMAT "%" INT64_MODIFIER "d"
410
+ #define UINT64_FORMAT "%" INT64_MODIFIER "u"
411
+
412
+ /*
413
+ * 128-bit signed and unsigned integers
414
+ * There currently is only limited support for such types.
415
+ * E.g. 128bit literals and snprintf are not supported; but math is.
416
+ * Also, because we exclude such types when choosing MAXIMUM_ALIGNOF,
417
+ * it must be possible to coerce the compiler to allocate them on no
418
+ * more than MAXALIGN boundaries.
419
+ */
420
+ #if defined(PG_INT128_TYPE)
421
+ #if defined(pg_attribute_aligned) || ALIGNOF_PG_INT128_TYPE <= MAXIMUM_ALIGNOF
422
+ #define HAVE_INT128 1
423
+
424
+ typedef PG_INT128_TYPE int128
425
+ #if defined(pg_attribute_aligned)
426
+ pg_attribute_aligned(MAXIMUM_ALIGNOF)
427
+ #endif
428
+ ;
429
+
430
+ typedef unsigned PG_INT128_TYPE uint128
431
+ #if defined(pg_attribute_aligned)
432
+ pg_attribute_aligned(MAXIMUM_ALIGNOF)
433
+ #endif
434
+ ;
435
+
436
+ #endif
437
+ #endif
438
+
439
+ /*
440
+ * stdint.h limits aren't guaranteed to have compatible types with our fixed
441
+ * width types. So just define our own.
442
+ */
443
+ #define PG_INT8_MIN (-0x7F-1)
444
+ #define PG_INT8_MAX (0x7F)
445
+ #define PG_UINT8_MAX (0xFF)
446
+ #define PG_INT16_MIN (-0x7FFF-1)
447
+ #define PG_INT16_MAX (0x7FFF)
448
+ #define PG_UINT16_MAX (0xFFFF)
449
+ #define PG_INT32_MIN (-0x7FFFFFFF-1)
450
+ #define PG_INT32_MAX (0x7FFFFFFF)
451
+ #define PG_UINT32_MAX (0xFFFFFFFFU)
452
+ #define PG_INT64_MIN (-INT64CONST(0x7FFFFFFFFFFFFFFF) - 1)
453
+ #define PG_INT64_MAX INT64CONST(0x7FFFFFFFFFFFFFFF)
454
+ #define PG_UINT64_MAX UINT64CONST(0xFFFFFFFFFFFFFFFF)
455
+
456
+ /*
457
+ * We now always use int64 timestamps, but keep this symbol defined for the
458
+ * benefit of external code that might test it.
459
+ */
460
+ #define HAVE_INT64_TIMESTAMP
461
+
462
+ /*
463
+ * Size
464
+ * Size of any memory resident object, as returned by sizeof.
465
+ */
466
+ typedef size_t Size;
467
+
468
+ /*
469
+ * Index
470
+ * Index into any memory resident array.
471
+ *
472
+ * Note:
473
+ * Indices are non negative.
474
+ */
475
+ typedef unsigned int Index;
476
+
477
+ /*
478
+ * Offset
479
+ * Offset into any memory resident array.
480
+ *
481
+ * Note:
482
+ * This differs from an Index in that an Index is always
483
+ * non negative, whereas Offset may be negative.
484
+ */
485
+ typedef signed int Offset;
486
+
487
+ /*
488
+ * Common Postgres datatype names (as used in the catalogs)
489
+ */
490
+ typedef float float4;
491
+ typedef double float8;
492
+
493
+ #ifdef USE_FLOAT8_BYVAL
494
+ #define FLOAT8PASSBYVAL true
495
+ #else
496
+ #define FLOAT8PASSBYVAL false
497
+ #endif
498
+
499
+ /*
500
+ * Oid, RegProcedure, TransactionId, SubTransactionId, MultiXactId,
501
+ * CommandId
502
+ */
503
+
504
+ /* typedef Oid is in postgres_ext.h */
505
+
506
+ /*
507
+ * regproc is the type name used in the include/catalog headers, but
508
+ * RegProcedure is the preferred name in C code.
509
+ */
510
+ typedef Oid regproc;
511
+ typedef regproc RegProcedure;
512
+
513
+ typedef uint32 TransactionId;
514
+
515
+ typedef uint32 LocalTransactionId;
516
+
517
+ typedef uint32 SubTransactionId;
518
+
519
+ #define InvalidSubTransactionId ((SubTransactionId) 0)
520
+ #define TopSubTransactionId ((SubTransactionId) 1)
521
+
522
+ /* MultiXactId must be equivalent to TransactionId, to fit in t_xmax */
523
+ typedef TransactionId MultiXactId;
524
+
525
+ typedef uint32 MultiXactOffset;
526
+
527
+ typedef uint32 CommandId;
528
+
529
+ #define FirstCommandId ((CommandId) 0)
530
+ #define InvalidCommandId (~(CommandId)0)
531
+
532
+ /*
533
+ * Array indexing support
534
+ */
535
+ #define MAXDIM 6
536
+ typedef struct
537
+ {
538
+ int indx[MAXDIM];
539
+ } IntArray;
540
+
541
+ /* ----------------
542
+ * Variable-length datatypes all share the 'struct varlena' header.
543
+ *
544
+ * NOTE: for TOASTable types, this is an oversimplification, since the value
545
+ * may be compressed or moved out-of-line. However datatype-specific routines
546
+ * are mostly content to deal with de-TOASTed values only, and of course
547
+ * client-side routines should never see a TOASTed value. But even in a
548
+ * de-TOASTed value, beware of touching vl_len_ directly, as its
549
+ * representation is no longer convenient. It's recommended that code always
550
+ * use macros VARDATA_ANY, VARSIZE_ANY, VARSIZE_ANY_EXHDR, VARDATA, VARSIZE,
551
+ * and SET_VARSIZE instead of relying on direct mentions of the struct fields.
552
+ * See postgres.h for details of the TOASTed form.
553
+ * ----------------
554
+ */
555
+ struct varlena
556
+ {
557
+ char vl_len_[4]; /* Do not touch this field directly! */
558
+ char vl_dat[FLEXIBLE_ARRAY_MEMBER]; /* Data content is here */
559
+ };
560
+
561
+ #define VARHDRSZ ((int32) sizeof(int32))
562
+
563
+ /*
564
+ * These widely-used datatypes are just a varlena header and the data bytes.
565
+ * There is no terminating null or anything like that --- the data length is
566
+ * always VARSIZE_ANY_EXHDR(ptr).
567
+ */
568
+ typedef struct varlena bytea;
569
+ typedef struct varlena text;
570
+ typedef struct varlena BpChar; /* blank-padded char, ie SQL char(n) */
571
+ typedef struct varlena VarChar; /* var-length char, ie SQL varchar(n) */
572
+
573
+ /*
574
+ * Specialized array types. These are physically laid out just the same
575
+ * as regular arrays (so that the regular array subscripting code works
576
+ * with them). They exist as distinct types mostly for historical reasons:
577
+ * they have nonstandard I/O behavior which we don't want to change for fear
578
+ * of breaking applications that look at the system catalogs. There is also
579
+ * an implementation issue for oidvector: it's part of the primary key for
580
+ * pg_proc, and we can't use the normal btree array support routines for that
581
+ * without circularity.
582
+ */
583
+ typedef struct
584
+ {
585
+ int32 vl_len_; /* these fields must match ArrayType! */
586
+ int ndim; /* always 1 for int2vector */
587
+ int32 dataoffset; /* always 0 for int2vector */
588
+ Oid elemtype;
589
+ int dim1;
590
+ int lbound1;
591
+ int16 values[FLEXIBLE_ARRAY_MEMBER];
592
+ } int2vector;
593
+
594
+ typedef struct
595
+ {
596
+ int32 vl_len_; /* these fields must match ArrayType! */
597
+ int ndim; /* always 1 for oidvector */
598
+ int32 dataoffset; /* always 0 for oidvector */
599
+ Oid elemtype;
600
+ int dim1;
601
+ int lbound1;
602
+ Oid values[FLEXIBLE_ARRAY_MEMBER];
603
+ } oidvector;
604
+
605
+ /*
606
+ * Representation of a Name: effectively just a C string, but null-padded to
607
+ * exactly NAMEDATALEN bytes. The use of a struct is historical.
608
+ */
609
+ typedef struct nameData
610
+ {
611
+ char data[NAMEDATALEN];
612
+ } NameData;
613
+ typedef NameData *Name;
614
+
615
+ #define NameStr(name) ((name).data)
616
+
617
+
618
+ /* ----------------------------------------------------------------
619
+ * Section 4: IsValid macros for system types
620
+ * ----------------------------------------------------------------
621
+ */
622
+ /*
623
+ * BoolIsValid
624
+ * True iff bool is valid.
625
+ */
626
+ #define BoolIsValid(boolean) ((boolean) == false || (boolean) == true)
627
+
628
+ /*
629
+ * PointerIsValid
630
+ * True iff pointer is valid.
631
+ */
632
+ #define PointerIsValid(pointer) ((const void*)(pointer) != NULL)
633
+
634
+ /*
635
+ * PointerIsAligned
636
+ * True iff pointer is properly aligned to point to the given type.
637
+ */
638
+ #define PointerIsAligned(pointer, type) \
639
+ (((uintptr_t)(pointer) % (sizeof (type))) == 0)
640
+
641
+ #define OffsetToPointer(base, offset) \
642
+ ((void *)((char *) base + offset))
643
+
644
+ #define OidIsValid(objectId) ((bool) ((objectId) != InvalidOid))
645
+
646
+ #define RegProcedureIsValid(p) OidIsValid(p)
647
+
648
+
649
+ /* ----------------------------------------------------------------
650
+ * Section 5: offsetof, lengthof, alignment
651
+ * ----------------------------------------------------------------
652
+ */
653
+ /*
654
+ * offsetof
655
+ * Offset of a structure/union field within that structure/union.
656
+ *
657
+ * XXX This is supposed to be part of stddef.h, but isn't on
658
+ * some systems (like SunOS 4).
659
+ */
660
+ #ifndef offsetof
661
+ #define offsetof(type, field) ((long) &((type *)0)->field)
662
+ #endif /* offsetof */
663
+
664
+ /*
665
+ * lengthof
666
+ * Number of elements in an array.
667
+ */
668
+ #define lengthof(array) (sizeof (array) / sizeof ((array)[0]))
669
+
670
+ /* ----------------
671
+ * Alignment macros: align a length or address appropriately for a given type.
672
+ * The fooALIGN() macros round up to a multiple of the required alignment,
673
+ * while the fooALIGN_DOWN() macros round down. The latter are more useful
674
+ * for problems like "how many X-sized structures will fit in a page?".
675
+ *
676
+ * NOTE: TYPEALIGN[_DOWN] will not work if ALIGNVAL is not a power of 2.
677
+ * That case seems extremely unlikely to be needed in practice, however.
678
+ *
679
+ * NOTE: MAXIMUM_ALIGNOF, and hence MAXALIGN(), intentionally exclude any
680
+ * larger-than-8-byte types the compiler might have.
681
+ * ----------------
682
+ */
683
+
684
+ #define TYPEALIGN(ALIGNVAL,LEN) \
685
+ (((uintptr_t) (LEN) + ((ALIGNVAL) - 1)) & ~((uintptr_t) ((ALIGNVAL) - 1)))
686
+
687
+ #define SHORTALIGN(LEN) TYPEALIGN(ALIGNOF_SHORT, (LEN))
688
+ #define INTALIGN(LEN) TYPEALIGN(ALIGNOF_INT, (LEN))
689
+ #define LONGALIGN(LEN) TYPEALIGN(ALIGNOF_LONG, (LEN))
690
+ #define DOUBLEALIGN(LEN) TYPEALIGN(ALIGNOF_DOUBLE, (LEN))
691
+ #define MAXALIGN(LEN) TYPEALIGN(MAXIMUM_ALIGNOF, (LEN))
692
+ /* MAXALIGN covers only built-in types, not buffers */
693
+ #define BUFFERALIGN(LEN) TYPEALIGN(ALIGNOF_BUFFER, (LEN))
694
+ #define CACHELINEALIGN(LEN) TYPEALIGN(PG_CACHE_LINE_SIZE, (LEN))
695
+
696
+ #define TYPEALIGN_DOWN(ALIGNVAL,LEN) \
697
+ (((uintptr_t) (LEN)) & ~((uintptr_t) ((ALIGNVAL) - 1)))
698
+
699
+ #define SHORTALIGN_DOWN(LEN) TYPEALIGN_DOWN(ALIGNOF_SHORT, (LEN))
700
+ #define INTALIGN_DOWN(LEN) TYPEALIGN_DOWN(ALIGNOF_INT, (LEN))
701
+ #define LONGALIGN_DOWN(LEN) TYPEALIGN_DOWN(ALIGNOF_LONG, (LEN))
702
+ #define DOUBLEALIGN_DOWN(LEN) TYPEALIGN_DOWN(ALIGNOF_DOUBLE, (LEN))
703
+ #define MAXALIGN_DOWN(LEN) TYPEALIGN_DOWN(MAXIMUM_ALIGNOF, (LEN))
704
+ #define BUFFERALIGN_DOWN(LEN) TYPEALIGN_DOWN(ALIGNOF_BUFFER, (LEN))
705
+
706
+ /*
707
+ * The above macros will not work with types wider than uintptr_t, like with
708
+ * uint64 on 32-bit platforms. That's not problem for the usual use where a
709
+ * pointer or a length is aligned, but for the odd case that you need to
710
+ * align something (potentially) wider, use TYPEALIGN64.
711
+ */
712
+ #define TYPEALIGN64(ALIGNVAL,LEN) \
713
+ (((uint64) (LEN) + ((ALIGNVAL) - 1)) & ~((uint64) ((ALIGNVAL) - 1)))
714
+
715
+ /* we don't currently need wider versions of the other ALIGN macros */
716
+ #define MAXALIGN64(LEN) TYPEALIGN64(MAXIMUM_ALIGNOF, (LEN))
717
+
718
+
719
+ /* ----------------------------------------------------------------
720
+ * Section 6: assertions
721
+ * ----------------------------------------------------------------
722
+ */
723
+
724
+ /*
725
+ * USE_ASSERT_CHECKING, if defined, turns on all the assertions.
726
+ * - plai 9/5/90
727
+ *
728
+ * It should _NOT_ be defined in releases or in benchmark copies
729
+ */
730
+
731
+ /*
732
+ * Assert() can be used in both frontend and backend code. In frontend code it
733
+ * just calls the standard assert, if it's available. If use of assertions is
734
+ * not configured, it does nothing.
735
+ */
736
+ #ifndef USE_ASSERT_CHECKING
737
+
738
+ #define Assert(condition) ((void)true)
739
+ #define AssertMacro(condition) ((void)true)
740
+ #define AssertArg(condition) ((void)true)
741
+ #define AssertState(condition) ((void)true)
742
+ #define AssertPointerAlignment(ptr, bndr) ((void)true)
743
+ #define Trap(condition, errorType) ((void)true)
744
+ #define TrapMacro(condition, errorType) (true)
745
+
746
+ #elif defined(FRONTEND)
747
+
748
+ #include <assert.h>
749
+ #define Assert(p) assert(p)
750
+ #define AssertMacro(p) ((void) assert(p))
751
+ #define AssertArg(condition) assert(condition)
752
+ #define AssertState(condition) assert(condition)
753
+ #define AssertPointerAlignment(ptr, bndr) ((void)true)
754
+
755
+ #else /* USE_ASSERT_CHECKING && !FRONTEND */
756
+
757
+ /*
758
+ * Trap
759
+ * Generates an exception if the given condition is true.
760
+ */
761
+ #define Trap(condition, errorType) \
762
+ do { \
763
+ if (condition) \
764
+ ExceptionalCondition(#condition, (errorType), \
765
+ __FILE__, __LINE__); \
766
+ } while (0)
767
+
768
+ /*
769
+ * TrapMacro is the same as Trap but it's intended for use in macros:
770
+ *
771
+ * #define foo(x) (AssertMacro(x != 0), bar(x))
772
+ *
773
+ * Isn't CPP fun?
774
+ */
775
+ #define TrapMacro(condition, errorType) \
776
+ ((bool) (! (condition) || \
777
+ (ExceptionalCondition(#condition, (errorType), \
778
+ __FILE__, __LINE__), 0)))
779
+
780
+ #define Assert(condition) \
781
+ do { \
782
+ if (!(condition)) \
783
+ ExceptionalCondition(#condition, "FailedAssertion", \
784
+ __FILE__, __LINE__); \
785
+ } while (0)
786
+
787
+ #define AssertMacro(condition) \
788
+ ((void) ((condition) || \
789
+ (ExceptionalCondition(#condition, "FailedAssertion", \
790
+ __FILE__, __LINE__), 0)))
791
+
792
+ #define AssertArg(condition) \
793
+ do { \
794
+ if (!(condition)) \
795
+ ExceptionalCondition(#condition, "BadArgument", \
796
+ __FILE__, __LINE__); \
797
+ } while (0)
798
+
799
+ #define AssertState(condition) \
800
+ do { \
801
+ if (!(condition)) \
802
+ ExceptionalCondition(#condition, "BadState", \
803
+ __FILE__, __LINE__); \
804
+ } while (0)
805
+
806
+ /*
807
+ * Check that `ptr' is `bndr' aligned.
808
+ */
809
+ #define AssertPointerAlignment(ptr, bndr) \
810
+ Trap(TYPEALIGN(bndr, (uintptr_t)(ptr)) != (uintptr_t)(ptr), \
811
+ "UnalignedPointer")
812
+
813
+ #endif /* USE_ASSERT_CHECKING && !FRONTEND */
814
+
815
+ /*
816
+ * ExceptionalCondition is compiled into the backend whether or not
817
+ * USE_ASSERT_CHECKING is defined, so as to support use of extensions
818
+ * that are built with that #define with a backend that isn't. Hence,
819
+ * we should declare it as long as !FRONTEND.
820
+ */
821
+ #ifndef FRONTEND
822
+ extern void ExceptionalCondition(const char *conditionName,
823
+ const char *errorType,
824
+ const char *fileName, int lineNumber) pg_attribute_noreturn();
825
+ #endif
826
+
827
+ /*
828
+ * Macros to support compile-time assertion checks.
829
+ *
830
+ * If the "condition" (a compile-time-constant expression) evaluates to false,
831
+ * throw a compile error using the "errmessage" (a string literal).
832
+ *
833
+ * gcc 4.6 and up supports _Static_assert(), but there are bizarre syntactic
834
+ * placement restrictions. Macros StaticAssertStmt() and StaticAssertExpr()
835
+ * make it safe to use as a statement or in an expression, respectively.
836
+ * The macro StaticAssertDecl() is suitable for use at file scope (outside of
837
+ * any function).
838
+ *
839
+ * Otherwise we fall back on a kluge that assumes the compiler will complain
840
+ * about a negative width for a struct bit-field. This will not include a
841
+ * helpful error message, but it beats not getting an error at all.
842
+ */
843
+ #ifndef __cplusplus
844
+ #ifdef HAVE__STATIC_ASSERT
845
+ #define StaticAssertStmt(condition, errmessage) \
846
+ do { _Static_assert(condition, errmessage); } while(0)
847
+ #define StaticAssertExpr(condition, errmessage) \
848
+ ((void) ({ StaticAssertStmt(condition, errmessage); true; }))
849
+ #define StaticAssertDecl(condition, errmessage) \
850
+ _Static_assert(condition, errmessage)
851
+ #else /* !HAVE__STATIC_ASSERT */
852
+ #define StaticAssertStmt(condition, errmessage) \
853
+ ((void) sizeof(struct { int static_assert_failure : (condition) ? 1 : -1; }))
854
+ #define StaticAssertExpr(condition, errmessage) \
855
+ StaticAssertStmt(condition, errmessage)
856
+ #define StaticAssertDecl(condition, errmessage) \
857
+ extern void static_assert_func(int static_assert_failure[(condition) ? 1 : -1])
858
+ #endif /* HAVE__STATIC_ASSERT */
859
+ #else /* C++ */
860
+ #if defined(__cpp_static_assert) && __cpp_static_assert >= 200410
861
+ #define StaticAssertStmt(condition, errmessage) \
862
+ static_assert(condition, errmessage)
863
+ #define StaticAssertExpr(condition, errmessage) \
864
+ ({ static_assert(condition, errmessage); })
865
+ #define StaticAssertDecl(condition, errmessage) \
866
+ static_assert(condition, errmessage)
867
+ #else /* !__cpp_static_assert */
868
+ #define StaticAssertStmt(condition, errmessage) \
869
+ do { struct static_assert_struct { int static_assert_failure : (condition) ? 1 : -1; }; } while(0)
870
+ #define StaticAssertExpr(condition, errmessage) \
871
+ ((void) ({ StaticAssertStmt(condition, errmessage); }))
872
+ #define StaticAssertDecl(condition, errmessage) \
873
+ extern void static_assert_func(int static_assert_failure[(condition) ? 1 : -1])
874
+ #endif /* __cpp_static_assert */
875
+ #endif /* C++ */
876
+
877
+
878
+ /*
879
+ * Compile-time checks that a variable (or expression) has the specified type.
880
+ *
881
+ * AssertVariableIsOfType() can be used as a statement.
882
+ * AssertVariableIsOfTypeMacro() is intended for use in macros, eg
883
+ * #define foo(x) (AssertVariableIsOfTypeMacro(x, int), bar(x))
884
+ *
885
+ * If we don't have __builtin_types_compatible_p, we can still assert that
886
+ * the types have the same size. This is far from ideal (especially on 32-bit
887
+ * platforms) but it provides at least some coverage.
888
+ */
889
+ #ifdef HAVE__BUILTIN_TYPES_COMPATIBLE_P
890
+ #define AssertVariableIsOfType(varname, typename) \
891
+ StaticAssertStmt(__builtin_types_compatible_p(__typeof__(varname), typename), \
892
+ CppAsString(varname) " does not have type " CppAsString(typename))
893
+ #define AssertVariableIsOfTypeMacro(varname, typename) \
894
+ (StaticAssertExpr(__builtin_types_compatible_p(__typeof__(varname), typename), \
895
+ CppAsString(varname) " does not have type " CppAsString(typename)))
896
+ #else /* !HAVE__BUILTIN_TYPES_COMPATIBLE_P */
897
+ #define AssertVariableIsOfType(varname, typename) \
898
+ StaticAssertStmt(sizeof(varname) == sizeof(typename), \
899
+ CppAsString(varname) " does not have type " CppAsString(typename))
900
+ #define AssertVariableIsOfTypeMacro(varname, typename) \
901
+ (StaticAssertExpr(sizeof(varname) == sizeof(typename), \
902
+ CppAsString(varname) " does not have type " CppAsString(typename)))
903
+ #endif /* HAVE__BUILTIN_TYPES_COMPATIBLE_P */
904
+
905
+
906
+ /* ----------------------------------------------------------------
907
+ * Section 7: widely useful macros
908
+ * ----------------------------------------------------------------
909
+ */
910
+ /*
911
+ * Max
912
+ * Return the maximum of two numbers.
913
+ */
914
+ #define Max(x, y) ((x) > (y) ? (x) : (y))
915
+
916
+ /*
917
+ * Min
918
+ * Return the minimum of two numbers.
919
+ */
920
+ #define Min(x, y) ((x) < (y) ? (x) : (y))
921
+
922
+ /*
923
+ * Abs
924
+ * Return the absolute value of the argument.
925
+ */
926
+ #define Abs(x) ((x) >= 0 ? (x) : -(x))
927
+
928
+ /*
929
+ * StrNCpy
930
+ * Like standard library function strncpy(), except that result string
931
+ * is guaranteed to be null-terminated --- that is, at most N-1 bytes
932
+ * of the source string will be kept.
933
+ * Also, the macro returns no result (too hard to do that without
934
+ * evaluating the arguments multiple times, which seems worse).
935
+ *
936
+ * BTW: when you need to copy a non-null-terminated string (like a text
937
+ * datum) and add a null, do not do it with StrNCpy(..., len+1). That
938
+ * might seem to work, but it fetches one byte more than there is in the
939
+ * text object. One fine day you'll have a SIGSEGV because there isn't
940
+ * another byte before the end of memory. Don't laugh, we've had real
941
+ * live bug reports from real live users over exactly this mistake.
942
+ * Do it honestly with "memcpy(dst,src,len); dst[len] = '\0';", instead.
943
+ */
944
+ #define StrNCpy(dst,src,len) \
945
+ do \
946
+ { \
947
+ char * _dst = (dst); \
948
+ Size _len = (len); \
949
+ \
950
+ if (_len > 0) \
951
+ { \
952
+ strncpy(_dst, (src), _len); \
953
+ _dst[_len-1] = '\0'; \
954
+ } \
955
+ } while (0)
956
+
957
+
958
+ /* Get a bit mask of the bits set in non-long aligned addresses */
959
+ #define LONG_ALIGN_MASK (sizeof(long) - 1)
960
+
961
+ /*
962
+ * MemSet
963
+ * Exactly the same as standard library function memset(), but considerably
964
+ * faster for zeroing small word-aligned structures (such as parsetree nodes).
965
+ * This has to be a macro because the main point is to avoid function-call
966
+ * overhead. However, we have also found that the loop is faster than
967
+ * native libc memset() on some platforms, even those with assembler
968
+ * memset() functions. More research needs to be done, perhaps with
969
+ * MEMSET_LOOP_LIMIT tests in configure.
970
+ */
971
+ #define MemSet(start, val, len) \
972
+ do \
973
+ { \
974
+ /* must be void* because we don't know if it is integer aligned yet */ \
975
+ void *_vstart = (void *) (start); \
976
+ int _val = (val); \
977
+ Size _len = (len); \
978
+ \
979
+ if ((((uintptr_t) _vstart) & LONG_ALIGN_MASK) == 0 && \
980
+ (_len & LONG_ALIGN_MASK) == 0 && \
981
+ _val == 0 && \
982
+ _len <= MEMSET_LOOP_LIMIT && \
983
+ /* \
984
+ * If MEMSET_LOOP_LIMIT == 0, optimizer should find \
985
+ * the whole "if" false at compile time. \
986
+ */ \
987
+ MEMSET_LOOP_LIMIT != 0) \
988
+ { \
989
+ long *_start = (long *) _vstart; \
990
+ long *_stop = (long *) ((char *) _start + _len); \
991
+ while (_start < _stop) \
992
+ *_start++ = 0; \
993
+ } \
994
+ else \
995
+ memset(_vstart, _val, _len); \
996
+ } while (0)
997
+
998
+ /*
999
+ * MemSetAligned is the same as MemSet except it omits the test to see if
1000
+ * "start" is word-aligned. This is okay to use if the caller knows a-priori
1001
+ * that the pointer is suitably aligned (typically, because he just got it
1002
+ * from palloc(), which always delivers a max-aligned pointer).
1003
+ */
1004
+ #define MemSetAligned(start, val, len) \
1005
+ do \
1006
+ { \
1007
+ long *_start = (long *) (start); \
1008
+ int _val = (val); \
1009
+ Size _len = (len); \
1010
+ \
1011
+ if ((_len & LONG_ALIGN_MASK) == 0 && \
1012
+ _val == 0 && \
1013
+ _len <= MEMSET_LOOP_LIMIT && \
1014
+ MEMSET_LOOP_LIMIT != 0) \
1015
+ { \
1016
+ long *_stop = (long *) ((char *) _start + _len); \
1017
+ while (_start < _stop) \
1018
+ *_start++ = 0; \
1019
+ } \
1020
+ else \
1021
+ memset(_start, _val, _len); \
1022
+ } while (0)
1023
+
1024
+
1025
+ /*
1026
+ * MemSetTest/MemSetLoop are a variant version that allow all the tests in
1027
+ * MemSet to be done at compile time in cases where "val" and "len" are
1028
+ * constants *and* we know the "start" pointer must be word-aligned.
1029
+ * If MemSetTest succeeds, then it is okay to use MemSetLoop, otherwise use
1030
+ * MemSetAligned. Beware of multiple evaluations of the arguments when using
1031
+ * this approach.
1032
+ */
1033
+ #define MemSetTest(val, len) \
1034
+ ( ((len) & LONG_ALIGN_MASK) == 0 && \
1035
+ (len) <= MEMSET_LOOP_LIMIT && \
1036
+ MEMSET_LOOP_LIMIT != 0 && \
1037
+ (val) == 0 )
1038
+
1039
+ #define MemSetLoop(start, val, len) \
1040
+ do \
1041
+ { \
1042
+ long * _start = (long *) (start); \
1043
+ long * _stop = (long *) ((char *) _start + (Size) (len)); \
1044
+ \
1045
+ while (_start < _stop) \
1046
+ *_start++ = 0; \
1047
+ } while (0)
1048
+
1049
+ /*
1050
+ * Macros for range-checking float values before converting to integer.
1051
+ * We must be careful here that the boundary values are expressed exactly
1052
+ * in the float domain. PG_INTnn_MIN is an exact power of 2, so it will
1053
+ * be represented exactly; but PG_INTnn_MAX isn't, and might get rounded
1054
+ * off, so avoid using that.
1055
+ * The input must be rounded to an integer beforehand, typically with rint(),
1056
+ * else we might draw the wrong conclusion about close-to-the-limit values.
1057
+ * These macros will do the right thing for Inf, but not necessarily for NaN,
1058
+ * so check isnan(num) first if that's a possibility.
1059
+ */
1060
+ #define FLOAT4_FITS_IN_INT16(num) \
1061
+ ((num) >= (float4) PG_INT16_MIN && (num) < -((float4) PG_INT16_MIN))
1062
+ #define FLOAT4_FITS_IN_INT32(num) \
1063
+ ((num) >= (float4) PG_INT32_MIN && (num) < -((float4) PG_INT32_MIN))
1064
+ #define FLOAT4_FITS_IN_INT64(num) \
1065
+ ((num) >= (float4) PG_INT64_MIN && (num) < -((float4) PG_INT64_MIN))
1066
+ #define FLOAT8_FITS_IN_INT16(num) \
1067
+ ((num) >= (float8) PG_INT16_MIN && (num) < -((float8) PG_INT16_MIN))
1068
+ #define FLOAT8_FITS_IN_INT32(num) \
1069
+ ((num) >= (float8) PG_INT32_MIN && (num) < -((float8) PG_INT32_MIN))
1070
+ #define FLOAT8_FITS_IN_INT64(num) \
1071
+ ((num) >= (float8) PG_INT64_MIN && (num) < -((float8) PG_INT64_MIN))
1072
+
1073
+
1074
+ /* ----------------------------------------------------------------
1075
+ * Section 8: random stuff
1076
+ * ----------------------------------------------------------------
1077
+ */
1078
+
1079
+ #ifdef HAVE_STRUCT_SOCKADDR_UN
1080
+ #define HAVE_UNIX_SOCKETS 1
1081
+ #endif
1082
+
1083
+ /*
1084
+ * Invert the sign of a qsort-style comparison result, ie, exchange negative
1085
+ * and positive integer values, being careful not to get the wrong answer
1086
+ * for INT_MIN. The argument should be an integral variable.
1087
+ */
1088
+ #define INVERT_COMPARE_RESULT(var) \
1089
+ ((var) = ((var) < 0) ? 1 : -(var))
1090
+
1091
+ /*
1092
+ * Use this, not "char buf[BLCKSZ]", to declare a field or local variable
1093
+ * holding a page buffer, if that page might be accessed as a page and not
1094
+ * just a string of bytes. Otherwise the variable might be under-aligned,
1095
+ * causing problems on alignment-picky hardware. (In some places, we use
1096
+ * this to declare buffers even though we only pass them to read() and
1097
+ * write(), because copying to/from aligned buffers is usually faster than
1098
+ * using unaligned buffers.) We include both "double" and "int64" in the
1099
+ * union to ensure that the compiler knows the value must be MAXALIGN'ed
1100
+ * (cf. configure's computation of MAXIMUM_ALIGNOF).
1101
+ */
1102
+ typedef union PGAlignedBlock
1103
+ {
1104
+ char data[BLCKSZ];
1105
+ double force_align_d;
1106
+ int64 force_align_i64;
1107
+ } PGAlignedBlock;
1108
+
1109
+ /* Same, but for an XLOG_BLCKSZ-sized buffer */
1110
+ typedef union PGAlignedXLogBlock
1111
+ {
1112
+ char data[XLOG_BLCKSZ];
1113
+ double force_align_d;
1114
+ int64 force_align_i64;
1115
+ } PGAlignedXLogBlock;
1116
+
1117
+ /* msb for char */
1118
+ #define HIGHBIT (0x80)
1119
+ #define IS_HIGHBIT_SET(ch) ((unsigned char)(ch) & HIGHBIT)
1120
+
1121
+ /*
1122
+ * Support macros for escaping strings. escape_backslash should be true
1123
+ * if generating a non-standard-conforming string. Prefixing a string
1124
+ * with ESCAPE_STRING_SYNTAX guarantees it is non-standard-conforming.
1125
+ * Beware of multiple evaluation of the "ch" argument!
1126
+ */
1127
+ #define SQL_STR_DOUBLE(ch, escape_backslash) \
1128
+ ((ch) == '\'' || ((ch) == '\\' && (escape_backslash)))
1129
+
1130
+ #define ESCAPE_STRING_SYNTAX 'E'
1131
+
1132
+
1133
+ #define STATUS_OK (0)
1134
+ #define STATUS_ERROR (-1)
1135
+ #define STATUS_EOF (-2)
1136
+ #define STATUS_WAITING (2)
1137
+
1138
+ /*
1139
+ * gettext support
1140
+ */
1141
+
1142
+ #ifndef ENABLE_NLS
1143
+ /* stuff we'd otherwise get from <libintl.h> */
1144
+ #define gettext(x) (x)
1145
+ #define dgettext(d,x) (x)
1146
+ #define ngettext(s,p,n) ((n) == 1 ? (s) : (p))
1147
+ #define dngettext(d,s,p,n) ((n) == 1 ? (s) : (p))
1148
+ #endif
1149
+
1150
+ #define _(x) gettext(x)
1151
+
1152
+ /*
1153
+ * Use this to mark string constants as needing translation at some later
1154
+ * time, rather than immediately. This is useful for cases where you need
1155
+ * access to the original string and translated string, and for cases where
1156
+ * immediate translation is not possible, like when initializing global
1157
+ * variables.
1158
+ * http://www.gnu.org/software/autoconf/manual/gettext/Special-cases.html
1159
+ */
1160
+ #define gettext_noop(x) (x)
1161
+
1162
+ /*
1163
+ * To better support parallel installations of major PostgreSQL
1164
+ * versions as well as parallel installations of major library soname
1165
+ * versions, we mangle the gettext domain name by appending those
1166
+ * version numbers. The coding rule ought to be that wherever the
1167
+ * domain name is mentioned as a literal, it must be wrapped into
1168
+ * PG_TEXTDOMAIN(). The macros below do not work on non-literals; but
1169
+ * that is somewhat intentional because it avoids having to worry
1170
+ * about multiple states of premangling and postmangling as the values
1171
+ * are being passed around.
1172
+ *
1173
+ * Make sure this matches the installation rules in nls-global.mk.
1174
+ */
1175
+ #ifdef SO_MAJOR_VERSION
1176
+ #define PG_TEXTDOMAIN(domain) (domain CppAsString2(SO_MAJOR_VERSION) "-" PG_MAJORVERSION)
1177
+ #else
1178
+ #define PG_TEXTDOMAIN(domain) (domain "-" PG_MAJORVERSION)
1179
+ #endif
1180
+
1181
+ /*
1182
+ * Macro that allows to cast constness and volatile away from an expression, but doesn't
1183
+ * allow changing the underlying type. Enforcement of the latter
1184
+ * currently only works for gcc like compilers.
1185
+ *
1186
+ * Please note IT IS NOT SAFE to cast constness away if the result will ever
1187
+ * be modified (it would be undefined behaviour). Doing so anyway can cause
1188
+ * compiler misoptimizations or runtime crashes (modifying readonly memory).
1189
+ * It is only safe to use when the result will not be modified, but API
1190
+ * design or language restrictions prevent you from declaring that
1191
+ * (e.g. because a function returns both const and non-const variables).
1192
+ *
1193
+ * Note that this only works in function scope, not for global variables (it'd
1194
+ * be nice, but not trivial, to improve that).
1195
+ */
1196
+ #if defined(HAVE__BUILTIN_TYPES_COMPATIBLE_P)
1197
+ #define unconstify(underlying_type, expr) \
1198
+ (StaticAssertExpr(__builtin_types_compatible_p(__typeof(expr), const underlying_type), \
1199
+ "wrong cast"), \
1200
+ (underlying_type) (expr))
1201
+ #define unvolatize(underlying_type, expr) \
1202
+ (StaticAssertExpr(__builtin_types_compatible_p(__typeof(expr), volatile underlying_type), \
1203
+ "wrong cast"), \
1204
+ (underlying_type) (expr))
1205
+ #else
1206
+ #define unconstify(underlying_type, expr) \
1207
+ ((underlying_type) (expr))
1208
+ #define unvolatize(underlying_type, expr) \
1209
+ ((underlying_type) (expr))
1210
+ #endif
1211
+
1212
+ /* ----------------------------------------------------------------
1213
+ * Section 9: system-specific hacks
1214
+ *
1215
+ * This should be limited to things that absolutely have to be
1216
+ * included in every source file. The port-specific header file
1217
+ * is usually a better place for this sort of thing.
1218
+ * ----------------------------------------------------------------
1219
+ */
1220
+
1221
+ /*
1222
+ * NOTE: this is also used for opening text files.
1223
+ * WIN32 treats Control-Z as EOF in files opened in text mode.
1224
+ * Therefore, we open files in binary mode on Win32 so we can read
1225
+ * literal control-Z. The other affect is that we see CRLF, but
1226
+ * that is OK because we can already handle those cleanly.
1227
+ */
1228
+ #if defined(WIN32) || defined(__CYGWIN__)
1229
+ #define PG_BINARY O_BINARY
1230
+ #define PG_BINARY_A "ab"
1231
+ #define PG_BINARY_R "rb"
1232
+ #define PG_BINARY_W "wb"
1233
+ #else
1234
+ #define PG_BINARY 0
1235
+ #define PG_BINARY_A "a"
1236
+ #define PG_BINARY_R "r"
1237
+ #define PG_BINARY_W "w"
1238
+ #endif
1239
+
1240
+ /*
1241
+ * Provide prototypes for routines not present in a particular machine's
1242
+ * standard C library.
1243
+ */
1244
+
1245
+ #if defined(HAVE_FDATASYNC) && !HAVE_DECL_FDATASYNC
1246
+ extern int fdatasync(int fildes);
1247
+ #endif
1248
+
1249
+ /* Older platforms may provide strto[u]ll functionality under other names */
1250
+ #if !defined(HAVE_STRTOLL) && defined(HAVE___STRTOLL)
1251
+ #define strtoll __strtoll
1252
+ #define HAVE_STRTOLL 1
1253
+ #endif
1254
+
1255
+ #if !defined(HAVE_STRTOLL) && defined(HAVE_STRTOQ)
1256
+ #define strtoll strtoq
1257
+ #define HAVE_STRTOLL 1
1258
+ #endif
1259
+
1260
+ #if !defined(HAVE_STRTOULL) && defined(HAVE___STRTOULL)
1261
+ #define strtoull __strtoull
1262
+ #define HAVE_STRTOULL 1
1263
+ #endif
1264
+
1265
+ #if !defined(HAVE_STRTOULL) && defined(HAVE_STRTOUQ)
1266
+ #define strtoull strtouq
1267
+ #define HAVE_STRTOULL 1
1268
+ #endif
1269
+
1270
+ #if defined(HAVE_STRTOLL) && !HAVE_DECL_STRTOLL
1271
+ extern long long strtoll(const char *str, char **endptr, int base);
1272
+ #endif
1273
+
1274
+ #if defined(HAVE_STRTOULL) && !HAVE_DECL_STRTOULL
1275
+ extern unsigned long long strtoull(const char *str, char **endptr, int base);
1276
+ #endif
1277
+
1278
+ /* no special DLL markers on most ports */
1279
+ #ifndef PGDLLIMPORT
1280
+ #define PGDLLIMPORT
1281
+ #endif
1282
+ #ifndef PGDLLEXPORT
1283
+ #define PGDLLEXPORT
1284
+ #endif
1285
+
1286
+ /*
1287
+ * The following is used as the arg list for signal handlers. Any ports
1288
+ * that take something other than an int argument should override this in
1289
+ * their pg_config_os.h file. Note that variable names are required
1290
+ * because it is used in both the prototypes as well as the definitions.
1291
+ * Note also the long name. We expect that this won't collide with
1292
+ * other names causing compiler warnings.
1293
+ */
1294
+
1295
+ #ifndef SIGNAL_ARGS
1296
+ #define SIGNAL_ARGS int postgres_signal_arg
1297
+ #endif
1298
+
1299
+ /*
1300
+ * When there is no sigsetjmp, its functionality is provided by plain
1301
+ * setjmp. Incidentally, nothing provides setjmp's functionality in
1302
+ * that case. We now support the case only on Windows.
1303
+ */
1304
+ #ifdef WIN32
1305
+ #define sigjmp_buf jmp_buf
1306
+ #define sigsetjmp(x,y) setjmp(x)
1307
+ #define siglongjmp longjmp
1308
+ #endif
1309
+
1310
+ /* EXEC_BACKEND defines */
1311
+ #ifdef EXEC_BACKEND
1312
+ #define NON_EXEC_STATIC
1313
+ #else
1314
+ #define NON_EXEC_STATIC static
1315
+ #endif
1316
+
1317
+ /* /port compatibility functions */
1318
+ #include "port.h"
1319
+
1320
+ #endif /* C_H */
1321
+ #undef StaticAssertDecl
1322
+ #define StaticAssertDecl(condition, errmessage)