pg_query 1.1.0 → 2.0.1

Sign up to get free protection for your applications and to get access to all the features.
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)