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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +163 -52
- data/README.md +80 -69
- data/Rakefile +82 -1
- data/ext/pg_query/extconf.rb +3 -31
- data/ext/pg_query/guc-file.c +0 -0
- data/ext/pg_query/include/access/amapi.h +246 -0
- data/ext/pg_query/include/access/attmap.h +52 -0
- data/ext/pg_query/include/access/attnum.h +64 -0
- data/ext/pg_query/include/access/clog.h +61 -0
- data/ext/pg_query/include/access/commit_ts.h +77 -0
- data/ext/pg_query/include/access/detoast.h +92 -0
- data/ext/pg_query/include/access/genam.h +228 -0
- data/ext/pg_query/include/access/gin.h +78 -0
- data/ext/pg_query/include/access/htup.h +89 -0
- data/ext/pg_query/include/access/htup_details.h +819 -0
- data/ext/pg_query/include/access/itup.h +161 -0
- data/ext/pg_query/include/access/parallel.h +82 -0
- data/ext/pg_query/include/access/printtup.h +35 -0
- data/ext/pg_query/include/access/relation.h +28 -0
- data/ext/pg_query/include/access/relscan.h +176 -0
- data/ext/pg_query/include/access/rmgr.h +35 -0
- data/ext/pg_query/include/access/rmgrlist.h +49 -0
- data/ext/pg_query/include/access/sdir.h +58 -0
- data/ext/pg_query/include/access/skey.h +151 -0
- data/ext/pg_query/include/access/stratnum.h +83 -0
- data/ext/pg_query/include/access/sysattr.h +29 -0
- data/ext/pg_query/include/access/table.h +27 -0
- data/ext/pg_query/include/access/tableam.h +1825 -0
- data/ext/pg_query/include/access/transam.h +265 -0
- data/ext/pg_query/include/access/tupconvert.h +51 -0
- data/ext/pg_query/include/access/tupdesc.h +154 -0
- data/ext/pg_query/include/access/tupmacs.h +247 -0
- data/ext/pg_query/include/access/twophase.h +61 -0
- data/ext/pg_query/include/access/xact.h +463 -0
- data/ext/pg_query/include/access/xlog.h +398 -0
- data/ext/pg_query/include/access/xlog_internal.h +330 -0
- data/ext/pg_query/include/access/xlogdefs.h +109 -0
- data/ext/pg_query/include/access/xloginsert.h +64 -0
- data/ext/pg_query/include/access/xlogreader.h +327 -0
- data/ext/pg_query/include/access/xlogrecord.h +227 -0
- data/ext/pg_query/include/bootstrap/bootstrap.h +62 -0
- data/ext/pg_query/include/c.h +1322 -0
- data/ext/pg_query/include/catalog/catalog.h +42 -0
- data/ext/pg_query/include/catalog/catversion.h +58 -0
- data/ext/pg_query/include/catalog/dependency.h +275 -0
- data/ext/pg_query/include/catalog/genbki.h +64 -0
- data/ext/pg_query/include/catalog/index.h +199 -0
- data/ext/pg_query/include/catalog/indexing.h +366 -0
- data/ext/pg_query/include/catalog/namespace.h +188 -0
- data/ext/pg_query/include/catalog/objectaccess.h +197 -0
- data/ext/pg_query/include/catalog/objectaddress.h +84 -0
- data/ext/pg_query/include/catalog/pg_aggregate.h +176 -0
- data/ext/pg_query/include/catalog/pg_aggregate_d.h +77 -0
- data/ext/pg_query/include/catalog/pg_am.h +60 -0
- data/ext/pg_query/include/catalog/pg_am_d.h +45 -0
- data/ext/pg_query/include/catalog/pg_attribute.h +204 -0
- data/ext/pg_query/include/catalog/pg_attribute_d.h +59 -0
- data/ext/pg_query/include/catalog/pg_authid.h +58 -0
- data/ext/pg_query/include/catalog/pg_authid_d.h +49 -0
- data/ext/pg_query/include/catalog/pg_class.h +200 -0
- data/ext/pg_query/include/catalog/pg_class_d.h +103 -0
- data/ext/pg_query/include/catalog/pg_collation.h +73 -0
- data/ext/pg_query/include/catalog/pg_collation_d.h +45 -0
- data/ext/pg_query/include/catalog/pg_constraint.h +247 -0
- data/ext/pg_query/include/catalog/pg_constraint_d.h +67 -0
- data/ext/pg_query/include/catalog/pg_control.h +250 -0
- data/ext/pg_query/include/catalog/pg_conversion.h +72 -0
- data/ext/pg_query/include/catalog/pg_conversion_d.h +35 -0
- data/ext/pg_query/include/catalog/pg_depend.h +73 -0
- data/ext/pg_query/include/catalog/pg_depend_d.h +34 -0
- data/ext/pg_query/include/catalog/pg_event_trigger.h +51 -0
- data/ext/pg_query/include/catalog/pg_event_trigger_d.h +34 -0
- data/ext/pg_query/include/catalog/pg_index.h +80 -0
- data/ext/pg_query/include/catalog/pg_index_d.h +56 -0
- data/ext/pg_query/include/catalog/pg_language.h +67 -0
- data/ext/pg_query/include/catalog/pg_language_d.h +39 -0
- data/ext/pg_query/include/catalog/pg_namespace.h +59 -0
- data/ext/pg_query/include/catalog/pg_namespace_d.h +34 -0
- data/ext/pg_query/include/catalog/pg_opclass.h +85 -0
- data/ext/pg_query/include/catalog/pg_opclass_d.h +49 -0
- data/ext/pg_query/include/catalog/pg_operator.h +102 -0
- data/ext/pg_query/include/catalog/pg_operator_d.h +106 -0
- data/ext/pg_query/include/catalog/pg_opfamily.h +60 -0
- data/ext/pg_query/include/catalog/pg_opfamily_d.h +47 -0
- data/ext/pg_query/include/catalog/pg_partitioned_table.h +63 -0
- data/ext/pg_query/include/catalog/pg_partitioned_table_d.h +35 -0
- data/ext/pg_query/include/catalog/pg_proc.h +211 -0
- data/ext/pg_query/include/catalog/pg_proc_d.h +99 -0
- data/ext/pg_query/include/catalog/pg_publication.h +115 -0
- data/ext/pg_query/include/catalog/pg_publication_d.h +36 -0
- data/ext/pg_query/include/catalog/pg_replication_origin.h +57 -0
- data/ext/pg_query/include/catalog/pg_replication_origin_d.h +29 -0
- data/ext/pg_query/include/catalog/pg_statistic.h +275 -0
- data/ext/pg_query/include/catalog/pg_statistic_d.h +194 -0
- data/ext/pg_query/include/catalog/pg_statistic_ext.h +74 -0
- data/ext/pg_query/include/catalog/pg_statistic_ext_d.h +40 -0
- data/ext/pg_query/include/catalog/pg_transform.h +45 -0
- data/ext/pg_query/include/catalog/pg_transform_d.h +32 -0
- data/ext/pg_query/include/catalog/pg_trigger.h +137 -0
- data/ext/pg_query/include/catalog/pg_trigger_d.h +106 -0
- data/ext/pg_query/include/catalog/pg_ts_config.h +50 -0
- data/ext/pg_query/include/catalog/pg_ts_config_d.h +32 -0
- data/ext/pg_query/include/catalog/pg_ts_dict.h +54 -0
- data/ext/pg_query/include/catalog/pg_ts_dict_d.h +33 -0
- data/ext/pg_query/include/catalog/pg_ts_parser.h +57 -0
- data/ext/pg_query/include/catalog/pg_ts_parser_d.h +35 -0
- data/ext/pg_query/include/catalog/pg_ts_template.h +48 -0
- data/ext/pg_query/include/catalog/pg_ts_template_d.h +32 -0
- data/ext/pg_query/include/catalog/pg_type.h +372 -0
- data/ext/pg_query/include/catalog/pg_type_d.h +285 -0
- data/ext/pg_query/include/catalog/storage.h +48 -0
- data/ext/pg_query/include/commands/async.h +54 -0
- data/ext/pg_query/include/commands/dbcommands.h +35 -0
- data/ext/pg_query/include/commands/defrem.h +173 -0
- data/ext/pg_query/include/commands/event_trigger.h +88 -0
- data/ext/pg_query/include/commands/explain.h +127 -0
- data/ext/pg_query/include/commands/prepare.h +61 -0
- data/ext/pg_query/include/commands/tablespace.h +67 -0
- data/ext/pg_query/include/commands/trigger.h +277 -0
- data/ext/pg_query/include/commands/user.h +37 -0
- data/ext/pg_query/include/commands/vacuum.h +293 -0
- data/ext/pg_query/include/commands/variable.h +38 -0
- data/ext/pg_query/include/common/file_perm.h +56 -0
- data/ext/pg_query/include/common/hashfn.h +104 -0
- data/ext/pg_query/include/common/ip.h +37 -0
- data/ext/pg_query/include/common/keywords.h +33 -0
- data/ext/pg_query/include/common/kwlookup.h +44 -0
- data/ext/pg_query/include/common/relpath.h +90 -0
- data/ext/pg_query/include/common/string.h +19 -0
- data/ext/pg_query/include/common/unicode_combining_table.h +196 -0
- data/ext/pg_query/include/datatype/timestamp.h +197 -0
- data/ext/pg_query/include/executor/execdesc.h +70 -0
- data/ext/pg_query/include/executor/executor.h +614 -0
- data/ext/pg_query/include/executor/functions.h +41 -0
- data/ext/pg_query/include/executor/instrument.h +101 -0
- data/ext/pg_query/include/executor/spi.h +175 -0
- data/ext/pg_query/include/executor/tablefunc.h +67 -0
- data/ext/pg_query/include/executor/tuptable.h +487 -0
- data/ext/pg_query/include/fmgr.h +775 -0
- data/ext/pg_query/include/funcapi.h +348 -0
- data/ext/pg_query/include/getaddrinfo.h +162 -0
- data/ext/pg_query/include/jit/jit.h +105 -0
- data/ext/pg_query/include/kwlist_d.h +1072 -0
- data/ext/pg_query/include/lib/ilist.h +727 -0
- data/ext/pg_query/include/lib/pairingheap.h +102 -0
- data/ext/pg_query/include/lib/simplehash.h +1059 -0
- data/ext/pg_query/include/lib/stringinfo.h +161 -0
- data/ext/pg_query/include/libpq/auth.h +29 -0
- data/ext/pg_query/include/libpq/crypt.h +46 -0
- data/ext/pg_query/include/libpq/hba.h +140 -0
- data/ext/pg_query/include/libpq/libpq-be.h +326 -0
- data/ext/pg_query/include/libpq/libpq.h +133 -0
- data/ext/pg_query/include/libpq/pqcomm.h +208 -0
- data/ext/pg_query/include/libpq/pqformat.h +210 -0
- data/ext/pg_query/include/libpq/pqsignal.h +42 -0
- data/ext/pg_query/include/mb/pg_wchar.h +672 -0
- data/ext/pg_query/include/mb/stringinfo_mb.h +24 -0
- data/ext/pg_query/include/miscadmin.h +476 -0
- data/ext/pg_query/include/nodes/bitmapset.h +122 -0
- data/ext/pg_query/include/nodes/execnodes.h +2520 -0
- data/ext/pg_query/include/nodes/extensible.h +160 -0
- data/ext/pg_query/include/nodes/lockoptions.h +61 -0
- data/ext/pg_query/include/nodes/makefuncs.h +108 -0
- data/ext/pg_query/include/nodes/memnodes.h +108 -0
- data/ext/pg_query/include/nodes/nodeFuncs.h +162 -0
- data/ext/pg_query/include/nodes/nodes.h +842 -0
- data/ext/pg_query/include/nodes/params.h +170 -0
- data/ext/pg_query/include/nodes/parsenodes.h +3579 -0
- data/ext/pg_query/include/nodes/pathnodes.h +2556 -0
- data/ext/pg_query/include/nodes/pg_list.h +605 -0
- data/ext/pg_query/include/nodes/plannodes.h +1251 -0
- data/ext/pg_query/include/nodes/primnodes.h +1541 -0
- data/ext/pg_query/include/nodes/print.h +34 -0
- data/ext/pg_query/include/nodes/tidbitmap.h +75 -0
- data/ext/pg_query/include/nodes/value.h +61 -0
- data/ext/pg_query/include/optimizer/cost.h +206 -0
- data/ext/pg_query/include/optimizer/geqo.h +88 -0
- data/ext/pg_query/include/optimizer/geqo_gene.h +45 -0
- data/ext/pg_query/include/optimizer/optimizer.h +199 -0
- data/ext/pg_query/include/optimizer/paths.h +249 -0
- data/ext/pg_query/include/optimizer/planmain.h +119 -0
- data/ext/pg_query/include/parser/analyze.h +49 -0
- data/ext/pg_query/include/parser/gram.h +1067 -0
- data/ext/pg_query/include/parser/gramparse.h +75 -0
- data/ext/pg_query/include/parser/kwlist.h +477 -0
- data/ext/pg_query/include/parser/parse_agg.h +68 -0
- data/ext/pg_query/include/parser/parse_clause.h +54 -0
- data/ext/pg_query/include/parser/parse_coerce.h +97 -0
- data/ext/pg_query/include/parser/parse_collate.h +27 -0
- data/ext/pg_query/include/parser/parse_expr.h +26 -0
- data/ext/pg_query/include/parser/parse_func.h +73 -0
- data/ext/pg_query/include/parser/parse_node.h +327 -0
- data/ext/pg_query/include/parser/parse_oper.h +67 -0
- data/ext/pg_query/include/parser/parse_relation.h +123 -0
- data/ext/pg_query/include/parser/parse_target.h +46 -0
- data/ext/pg_query/include/parser/parse_type.h +60 -0
- data/ext/pg_query/include/parser/parser.h +41 -0
- data/ext/pg_query/include/parser/parsetree.h +61 -0
- data/ext/pg_query/include/parser/scanner.h +152 -0
- data/ext/pg_query/include/parser/scansup.h +30 -0
- data/ext/pg_query/include/partitioning/partdefs.h +26 -0
- data/ext/pg_query/include/pg_config.h +988 -0
- data/ext/pg_query/include/pg_config_ext.h +8 -0
- data/ext/pg_query/include/pg_config_manual.h +350 -0
- data/ext/pg_query/include/pg_config_os.h +8 -0
- data/ext/pg_query/include/pg_getopt.h +56 -0
- data/ext/pg_query/include/pg_query.h +121 -0
- data/ext/pg_query/include/pg_query_enum_defs.c +2454 -0
- data/ext/pg_query/include/pg_query_fingerprint_conds.c +875 -0
- data/ext/pg_query/include/pg_query_fingerprint_defs.c +12413 -0
- data/ext/pg_query/include/pg_query_json_helper.c +61 -0
- data/ext/pg_query/include/pg_query_outfuncs_conds.c +686 -0
- data/ext/pg_query/include/pg_query_outfuncs_defs.c +2437 -0
- data/ext/pg_query/include/pg_query_readfuncs_conds.c +222 -0
- data/ext/pg_query/include/pg_query_readfuncs_defs.c +2878 -0
- data/ext/pg_query/include/pg_trace.h +17 -0
- data/ext/pg_query/include/pgstat.h +1487 -0
- data/ext/pg_query/include/pgtime.h +84 -0
- data/ext/pg_query/include/pl_gram.h +385 -0
- data/ext/pg_query/include/pl_reserved_kwlist.h +52 -0
- data/ext/pg_query/include/pl_reserved_kwlist_d.h +114 -0
- data/ext/pg_query/include/pl_unreserved_kwlist.h +112 -0
- data/ext/pg_query/include/pl_unreserved_kwlist_d.h +246 -0
- data/ext/pg_query/include/plerrcodes.h +990 -0
- data/ext/pg_query/include/plpgsql.h +1347 -0
- data/ext/pg_query/include/port.h +524 -0
- data/ext/pg_query/include/port/atomics.h +524 -0
- data/ext/pg_query/include/port/atomics/arch-arm.h +26 -0
- data/ext/pg_query/include/port/atomics/arch-ppc.h +254 -0
- data/ext/pg_query/include/port/atomics/arch-x86.h +252 -0
- data/ext/pg_query/include/port/atomics/fallback.h +170 -0
- data/ext/pg_query/include/port/atomics/generic-gcc.h +286 -0
- data/ext/pg_query/include/port/atomics/generic.h +401 -0
- data/ext/pg_query/include/port/pg_bitutils.h +226 -0
- data/ext/pg_query/include/port/pg_bswap.h +161 -0
- data/ext/pg_query/include/port/pg_crc32c.h +101 -0
- data/ext/pg_query/include/portability/instr_time.h +256 -0
- data/ext/pg_query/include/postgres.h +764 -0
- data/ext/pg_query/include/postgres_ext.h +74 -0
- data/ext/pg_query/include/postmaster/autovacuum.h +83 -0
- data/ext/pg_query/include/postmaster/bgworker.h +161 -0
- data/ext/pg_query/include/postmaster/bgworker_internals.h +64 -0
- data/ext/pg_query/include/postmaster/bgwriter.h +45 -0
- data/ext/pg_query/include/postmaster/fork_process.h +17 -0
- data/ext/pg_query/include/postmaster/interrupt.h +32 -0
- data/ext/pg_query/include/postmaster/pgarch.h +39 -0
- data/ext/pg_query/include/postmaster/postmaster.h +77 -0
- data/ext/pg_query/include/postmaster/syslogger.h +98 -0
- data/ext/pg_query/include/postmaster/walwriter.h +21 -0
- data/ext/pg_query/include/protobuf-c.h +1106 -0
- data/ext/pg_query/include/protobuf-c/protobuf-c.h +1106 -0
- data/ext/pg_query/include/protobuf/pg_query.pb-c.h +10846 -0
- data/ext/pg_query/include/protobuf/pg_query.pb.h +124718 -0
- data/ext/pg_query/include/regex/regex.h +184 -0
- data/ext/pg_query/include/replication/logicallauncher.h +31 -0
- data/ext/pg_query/include/replication/logicalproto.h +110 -0
- data/ext/pg_query/include/replication/logicalworker.h +19 -0
- data/ext/pg_query/include/replication/origin.h +73 -0
- data/ext/pg_query/include/replication/reorderbuffer.h +467 -0
- data/ext/pg_query/include/replication/slot.h +219 -0
- data/ext/pg_query/include/replication/syncrep.h +115 -0
- data/ext/pg_query/include/replication/walreceiver.h +340 -0
- data/ext/pg_query/include/replication/walsender.h +74 -0
- data/ext/pg_query/include/rewrite/prs2lock.h +46 -0
- data/ext/pg_query/include/rewrite/rewriteHandler.h +40 -0
- data/ext/pg_query/include/rewrite/rewriteManip.h +87 -0
- data/ext/pg_query/include/rewrite/rewriteSupport.h +26 -0
- data/ext/pg_query/include/storage/backendid.h +37 -0
- data/ext/pg_query/include/storage/block.h +121 -0
- data/ext/pg_query/include/storage/buf.h +46 -0
- data/ext/pg_query/include/storage/bufmgr.h +292 -0
- data/ext/pg_query/include/storage/bufpage.h +459 -0
- data/ext/pg_query/include/storage/condition_variable.h +62 -0
- data/ext/pg_query/include/storage/dsm.h +61 -0
- data/ext/pg_query/include/storage/dsm_impl.h +75 -0
- data/ext/pg_query/include/storage/fd.h +168 -0
- data/ext/pg_query/include/storage/ipc.h +81 -0
- data/ext/pg_query/include/storage/item.h +19 -0
- data/ext/pg_query/include/storage/itemid.h +184 -0
- data/ext/pg_query/include/storage/itemptr.h +206 -0
- data/ext/pg_query/include/storage/large_object.h +100 -0
- data/ext/pg_query/include/storage/latch.h +190 -0
- data/ext/pg_query/include/storage/lmgr.h +114 -0
- data/ext/pg_query/include/storage/lock.h +612 -0
- data/ext/pg_query/include/storage/lockdefs.h +59 -0
- data/ext/pg_query/include/storage/lwlock.h +232 -0
- data/ext/pg_query/include/storage/lwlocknames.h +51 -0
- data/ext/pg_query/include/storage/off.h +57 -0
- data/ext/pg_query/include/storage/pg_sema.h +61 -0
- data/ext/pg_query/include/storage/pg_shmem.h +90 -0
- data/ext/pg_query/include/storage/pmsignal.h +94 -0
- data/ext/pg_query/include/storage/predicate.h +87 -0
- data/ext/pg_query/include/storage/proc.h +333 -0
- data/ext/pg_query/include/storage/proclist_types.h +51 -0
- data/ext/pg_query/include/storage/procsignal.h +75 -0
- data/ext/pg_query/include/storage/relfilenode.h +99 -0
- data/ext/pg_query/include/storage/s_lock.h +1047 -0
- data/ext/pg_query/include/storage/sharedfileset.h +45 -0
- data/ext/pg_query/include/storage/shm_mq.h +85 -0
- data/ext/pg_query/include/storage/shm_toc.h +58 -0
- data/ext/pg_query/include/storage/shmem.h +81 -0
- data/ext/pg_query/include/storage/sinval.h +153 -0
- data/ext/pg_query/include/storage/sinvaladt.h +43 -0
- data/ext/pg_query/include/storage/smgr.h +109 -0
- data/ext/pg_query/include/storage/spin.h +77 -0
- data/ext/pg_query/include/storage/standby.h +91 -0
- data/ext/pg_query/include/storage/standbydefs.h +74 -0
- data/ext/pg_query/include/storage/sync.h +62 -0
- data/ext/pg_query/include/tcop/cmdtag.h +58 -0
- data/ext/pg_query/include/tcop/cmdtaglist.h +217 -0
- data/ext/pg_query/include/tcop/deparse_utility.h +108 -0
- data/ext/pg_query/include/tcop/dest.h +149 -0
- data/ext/pg_query/include/tcop/fastpath.h +21 -0
- data/ext/pg_query/include/tcop/pquery.h +45 -0
- data/ext/pg_query/include/tcop/tcopprot.h +89 -0
- data/ext/pg_query/include/tcop/utility.h +108 -0
- data/ext/pg_query/include/tsearch/ts_cache.h +98 -0
- data/ext/pg_query/include/utils/acl.h +312 -0
- data/ext/pg_query/include/utils/aclchk_internal.h +45 -0
- data/ext/pg_query/include/utils/array.h +458 -0
- data/ext/pg_query/include/utils/builtins.h +127 -0
- data/ext/pg_query/include/utils/bytea.h +27 -0
- data/ext/pg_query/include/utils/catcache.h +231 -0
- data/ext/pg_query/include/utils/date.h +90 -0
- data/ext/pg_query/include/utils/datetime.h +343 -0
- data/ext/pg_query/include/utils/datum.h +68 -0
- data/ext/pg_query/include/utils/dsa.h +123 -0
- data/ext/pg_query/include/utils/dynahash.h +19 -0
- data/ext/pg_query/include/utils/elog.h +439 -0
- data/ext/pg_query/include/utils/errcodes.h +352 -0
- data/ext/pg_query/include/utils/expandeddatum.h +159 -0
- data/ext/pg_query/include/utils/expandedrecord.h +231 -0
- data/ext/pg_query/include/utils/float.h +356 -0
- data/ext/pg_query/include/utils/fmgroids.h +2657 -0
- data/ext/pg_query/include/utils/fmgrprotos.h +2646 -0
- data/ext/pg_query/include/utils/fmgrtab.h +48 -0
- data/ext/pg_query/include/utils/guc.h +443 -0
- data/ext/pg_query/include/utils/guc_tables.h +272 -0
- data/ext/pg_query/include/utils/hsearch.h +149 -0
- data/ext/pg_query/include/utils/inval.h +64 -0
- data/ext/pg_query/include/utils/lsyscache.h +197 -0
- data/ext/pg_query/include/utils/memdebug.h +82 -0
- data/ext/pg_query/include/utils/memutils.h +225 -0
- data/ext/pg_query/include/utils/numeric.h +76 -0
- data/ext/pg_query/include/utils/palloc.h +136 -0
- data/ext/pg_query/include/utils/partcache.h +102 -0
- data/ext/pg_query/include/utils/pg_locale.h +119 -0
- data/ext/pg_query/include/utils/pg_lsn.h +29 -0
- data/ext/pg_query/include/utils/pidfile.h +56 -0
- data/ext/pg_query/include/utils/plancache.h +235 -0
- data/ext/pg_query/include/utils/portal.h +241 -0
- data/ext/pg_query/include/utils/probes.h +114 -0
- data/ext/pg_query/include/utils/ps_status.h +25 -0
- data/ext/pg_query/include/utils/queryenvironment.h +74 -0
- data/ext/pg_query/include/utils/regproc.h +28 -0
- data/ext/pg_query/include/utils/rel.h +644 -0
- data/ext/pg_query/include/utils/relcache.h +151 -0
- data/ext/pg_query/include/utils/reltrigger.h +81 -0
- data/ext/pg_query/include/utils/resowner.h +86 -0
- data/ext/pg_query/include/utils/rls.h +50 -0
- data/ext/pg_query/include/utils/ruleutils.h +44 -0
- data/ext/pg_query/include/utils/sharedtuplestore.h +61 -0
- data/ext/pg_query/include/utils/snapmgr.h +158 -0
- data/ext/pg_query/include/utils/snapshot.h +206 -0
- data/ext/pg_query/include/utils/sortsupport.h +276 -0
- data/ext/pg_query/include/utils/syscache.h +219 -0
- data/ext/pg_query/include/utils/timeout.h +88 -0
- data/ext/pg_query/include/utils/timestamp.h +116 -0
- data/ext/pg_query/include/utils/tuplesort.h +277 -0
- data/ext/pg_query/include/utils/tuplestore.h +91 -0
- data/ext/pg_query/include/utils/typcache.h +202 -0
- data/ext/pg_query/include/utils/tzparser.h +39 -0
- data/ext/pg_query/include/utils/varlena.h +39 -0
- data/ext/pg_query/include/utils/xml.h +84 -0
- data/ext/pg_query/include/xxhash.h +5445 -0
- data/ext/pg_query/include/xxhash/xxhash.h +5445 -0
- data/ext/pg_query/pg_query.c +104 -0
- data/ext/pg_query/pg_query.pb-c.c +37628 -0
- data/ext/pg_query/pg_query_deparse.c +9953 -0
- data/ext/pg_query/pg_query_fingerprint.c +292 -0
- data/ext/pg_query/pg_query_fingerprint.h +8 -0
- data/ext/pg_query/pg_query_internal.h +24 -0
- data/ext/pg_query/pg_query_json_plpgsql.c +738 -0
- data/ext/pg_query/pg_query_json_plpgsql.h +9 -0
- data/ext/pg_query/pg_query_normalize.c +437 -0
- data/ext/pg_query/pg_query_outfuncs.h +10 -0
- data/ext/pg_query/pg_query_outfuncs_json.c +297 -0
- data/ext/pg_query/pg_query_outfuncs_protobuf.c +237 -0
- data/ext/pg_query/pg_query_parse.c +148 -0
- data/ext/pg_query/pg_query_parse_plpgsql.c +460 -0
- data/ext/pg_query/pg_query_readfuncs.h +11 -0
- data/ext/pg_query/pg_query_readfuncs_protobuf.c +142 -0
- data/ext/pg_query/pg_query_ruby.c +108 -12
- data/ext/pg_query/pg_query_scan.c +173 -0
- data/ext/pg_query/pg_query_split.c +221 -0
- data/ext/pg_query/protobuf-c.c +3660 -0
- data/ext/pg_query/src_backend_catalog_namespace.c +1051 -0
- data/ext/pg_query/src_backend_catalog_pg_proc.c +142 -0
- data/ext/pg_query/src_backend_commands_define.c +117 -0
- data/ext/pg_query/src_backend_libpq_pqcomm.c +651 -0
- data/ext/pg_query/src_backend_nodes_bitmapset.c +513 -0
- data/ext/pg_query/src_backend_nodes_copyfuncs.c +6013 -0
- data/ext/pg_query/src_backend_nodes_equalfuncs.c +4003 -0
- data/ext/pg_query/src_backend_nodes_extensible.c +99 -0
- data/ext/pg_query/src_backend_nodes_list.c +922 -0
- data/ext/pg_query/src_backend_nodes_makefuncs.c +417 -0
- data/ext/pg_query/src_backend_nodes_nodeFuncs.c +1363 -0
- data/ext/pg_query/src_backend_nodes_value.c +84 -0
- data/ext/pg_query/src_backend_parser_gram.c +47456 -0
- data/ext/pg_query/src_backend_parser_parse_expr.c +313 -0
- data/ext/pg_query/src_backend_parser_parser.c +497 -0
- data/ext/pg_query/src_backend_parser_scan.c +7091 -0
- data/ext/pg_query/src_backend_parser_scansup.c +160 -0
- data/ext/pg_query/src_backend_postmaster_postmaster.c +2230 -0
- data/ext/pg_query/src_backend_storage_ipc_ipc.c +192 -0
- data/ext/pg_query/src_backend_storage_lmgr_s_lock.c +370 -0
- data/ext/pg_query/src_backend_tcop_postgres.c +776 -0
- data/ext/pg_query/src_backend_utils_adt_datum.c +326 -0
- data/ext/pg_query/src_backend_utils_adt_expandeddatum.c +98 -0
- data/ext/pg_query/src_backend_utils_adt_format_type.c +136 -0
- data/ext/pg_query/src_backend_utils_adt_ruleutils.c +1683 -0
- data/ext/pg_query/src_backend_utils_error_assert.c +74 -0
- data/ext/pg_query/src_backend_utils_error_elog.c +1748 -0
- data/ext/pg_query/src_backend_utils_fmgr_fmgr.c +570 -0
- data/ext/pg_query/src_backend_utils_hash_dynahash.c +1086 -0
- data/ext/pg_query/src_backend_utils_init_globals.c +168 -0
- data/ext/pg_query/src_backend_utils_mb_mbutils.c +839 -0
- data/ext/pg_query/src_backend_utils_misc_guc.c +1831 -0
- data/ext/pg_query/src_backend_utils_mmgr_aset.c +1560 -0
- data/ext/pg_query/src_backend_utils_mmgr_mcxt.c +1006 -0
- data/ext/pg_query/src_common_encnames.c +158 -0
- data/ext/pg_query/src_common_keywords.c +39 -0
- data/ext/pg_query/src_common_kwlist_d.h +1081 -0
- data/ext/pg_query/src_common_kwlookup.c +91 -0
- data/ext/pg_query/src_common_psprintf.c +158 -0
- data/ext/pg_query/src_common_string.c +86 -0
- data/ext/pg_query/src_common_stringinfo.c +336 -0
- data/ext/pg_query/src_common_wchar.c +1651 -0
- data/ext/pg_query/src_pl_plpgsql_src_pl_comp.c +1133 -0
- data/ext/pg_query/src_pl_plpgsql_src_pl_funcs.c +877 -0
- data/ext/pg_query/src_pl_plpgsql_src_pl_gram.c +6533 -0
- data/ext/pg_query/src_pl_plpgsql_src_pl_handler.c +107 -0
- data/ext/pg_query/src_pl_plpgsql_src_pl_reserved_kwlist_d.h +123 -0
- data/ext/pg_query/src_pl_plpgsql_src_pl_scanner.c +671 -0
- data/ext/pg_query/src_pl_plpgsql_src_pl_unreserved_kwlist_d.h +255 -0
- data/ext/pg_query/src_port_erand48.c +127 -0
- data/ext/pg_query/src_port_pg_bitutils.c +246 -0
- data/ext/pg_query/src_port_pgsleep.c +69 -0
- data/ext/pg_query/src_port_pgstrcasecmp.c +83 -0
- data/ext/pg_query/src_port_qsort.c +240 -0
- data/ext/pg_query/src_port_random.c +31 -0
- data/ext/pg_query/src_port_snprintf.c +1449 -0
- data/ext/pg_query/src_port_strerror.c +324 -0
- data/ext/pg_query/src_port_strnlen.c +39 -0
- data/ext/pg_query/xxhash.c +43 -0
- data/lib/pg_query.rb +7 -4
- data/lib/pg_query/constants.rb +21 -0
- data/lib/pg_query/deparse.rb +16 -1117
- data/lib/pg_query/filter_columns.rb +86 -85
- data/lib/pg_query/fingerprint.rb +122 -87
- data/lib/pg_query/json_field_names.rb +1402 -0
- data/lib/pg_query/node.rb +31 -0
- data/lib/pg_query/param_refs.rb +42 -37
- data/lib/pg_query/parse.rb +220 -200
- data/lib/pg_query/parse_error.rb +1 -1
- data/lib/pg_query/pg_query_pb.rb +3211 -0
- data/lib/pg_query/scan.rb +23 -0
- data/lib/pg_query/treewalker.rb +24 -40
- data/lib/pg_query/truncate.rb +64 -43
- data/lib/pg_query/version.rb +2 -2
- metadata +473 -11
- data/ext/pg_query/pg_query_ruby.h +0 -10
- data/lib/pg_query/deep_dup.rb +0 -16
- data/lib/pg_query/deparse/alter_table.rb +0 -42
- data/lib/pg_query/deparse/interval.rb +0 -105
- data/lib/pg_query/legacy_parsetree.rb +0 -109
- 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)
|