postgresql/src/port
Andres Freund e6927270cd meson: Add initial version of meson based build system
Autoconf is showing its age, fewer and fewer contributors know how to wrangle
it. Recursive make has a lot of hard to resolve dependency issues and slow
incremental rebuilds. Our home-grown MSVC build system is hard to maintain for
developers not using Windows and runs tests serially. While these and other
issues could individually be addressed with incremental improvements, together
they seem best addressed by moving to a more modern build system.

After evaluating different build system choices, we chose to use meson, to a
good degree based on the adoption by other open source projects.

We decided that it's more realistic to commit a relatively early version of
the new build system and mature it in tree.

This commit adds an initial version of a meson based build system. It supports
building postgres on at least AIX, FreeBSD, Linux, macOS, NetBSD, OpenBSD,
Solaris and Windows (however only gcc is supported on aix, solaris). For
Windows/MSVC postgres can now be built with ninja (faster, particularly for
incremental builds) and msbuild (supporting the visual studio GUI, but
building slower).

Several aspects (e.g. Windows rc file generation, PGXS compatibility, LLVM
bitcode generation, documentation adjustments) are done in subsequent commits
requiring further review. Other aspects (e.g. not installing test-only
extensions) are not yet addressed.

When building on Windows with msbuild, builds are slower when using a visual
studio version older than 2019, because those versions do not support
MultiToolTask, required by meson for intra-target parallelism.

The plan is to remove the MSVC specific build system in src/tools/msvc soon
after reaching feature parity. However, we're not planning to remove the
autoconf/make build system in the near future. Likely we're going to keep at
least the parts required for PGXS to keep working around until all supported
versions build with meson.

Some initial help for postgres developers is at
https://wiki.postgresql.org/wiki/Meson

With contributions from Thomas Munro, John Naylor, Stone Tickle and others.

Author: Andres Freund <andres@anarazel.de>
Author: Nazir Bilal Yavuz <byavuz81@gmail.com>
Author: Peter Eisentraut <peter@eisentraut.org>
Reviewed-By: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
Discussion: https://postgr.es/m/20211012083721.hvixq4pnh2pixr3j@alap3.anarazel.de
2022-09-21 22:37:17 -07:00
..
.gitignore Build src/port files as a library with -fPIC, and use that in libpq. 2018-09-27 11:23:43 -04:00
Makefile Remove replacement code for getaddrinfo. 2022-08-14 09:53:28 +12:00
README AIX: Fix missing libpq symbols by respecting SHLIB_EXPORTS. 2021-09-06 11:27:59 -07:00
bsearch_arg.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
chklocale.c Remove support for Visual Studio 2013 2022-07-14 11:22:49 +09:00
dirent.c Fix get_dirent_type() for Windows junction points. 2022-07-22 16:57:12 +12:00
dirmod.c Cleanup more code and comments related to Windows NT4 (XP days) 2022-08-30 09:52:58 +09:00
explicit_bzero.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
getopt.c Use our own getopt() on OpenBSD. 2019-01-18 15:06:26 -05:00
getopt_long.c Fix our getopt_long's behavior for a command line argument of just "-". 2020-03-23 11:58:00 -04:00
getpeereid.c Remove configure probes for sys/un.h and struct sockaddr_un. 2022-08-14 00:09:47 +12:00
inet_aton.c Correct include file name in inet_aton fallback. 2017-10-01 17:41:00 -07:00
inet_net_ntop.c Remove configure probe for sockaddr_in6 and require AF_INET6. 2022-08-26 10:18:30 +12:00
kill.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
meson.build meson: Add initial version of meson based build system 2022-09-21 22:37:17 -07:00
mkdtemp.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
noblock.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
open.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
path.c Simplify coding around path_contains_parent_reference(). 2022-01-31 13:53:38 -05:00
pg_bitutils.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
pg_crc32c_armv8.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
pg_crc32c_armv8_choose.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
pg_crc32c_sb8.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
pg_crc32c_sse42.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
pg_crc32c_sse42_choose.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
pg_strong_random.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
pgcheckdir.c Fix various typos, grammar and code style in comments and docs 2022-01-25 09:40:04 +09:00
pgmkdirp.c Fix various typos and grammar errors in comments. 2015-04-26 18:42:31 +02:00
pgsleep.c Remove configure probe for sys/select.h. 2022-08-14 00:09:47 +12:00
pgstrcasecmp.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
pgstrsignal.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
pqsignal.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
preadv.c Include c.h instead of postgres.h in src/port/*p{read,write}*.c 2022-09-17 09:21:59 -07:00
pthread-win32.h Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
pthread_barrier_wait.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
pwritev.c Include c.h instead of postgres.h in src/port/*p{read,write}*.c 2022-09-17 09:21:59 -07:00
qsort.c Use sort_template.h for qsort() and qsort_arg(). 2021-03-03 17:02:32 +13:00
qsort_arg.c Use sort_template.h for qsort() and qsort_arg(). 2021-03-03 17:02:32 +13:00
quotes.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
snprintf.c Replace many MemSet calls with struct initialization 2022-07-16 08:50:49 +02:00
strerror.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
strlcat.c pgindent run for 9.4 2014-05-06 12:12:18 -04:00
strlcpy.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
strnlen.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
strtof.c Simplify replacement code for strtof. 2022-08-07 12:42:41 +12:00
system.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
tar.c Make the order of the header file includes consistent in non-backend modules. 2019-10-25 07:41:52 +05:30
thread.c Remove dead getpwuid_r replacement code. 2022-07-24 09:44:29 +12:00
win32.ico Revert binary change in copyright year adjustment. 2012-01-01 19:40:13 -05:00
win32dlopen.c Remove configure probe for dlopen, and refactor. 2022-08-05 09:12:45 +12:00
win32env.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
win32error.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
win32fdatasync.c Remove configure probe for fdatasync. 2022-08-05 16:37:38 +12:00
win32getrusage.c Remove configure probe for sys/resource.h and refactor. 2022-08-14 00:09:47 +12:00
win32gettimeofday.c Simplify gettimeofday for Windows. 2022-08-07 12:35:36 +12:00
win32link.c Remove configure probe for link. 2022-08-05 09:36:50 +12:00
win32ntdll.c Add wal_sync_method=fdatasync for Windows. 2022-07-20 13:55:52 +12:00
win32pread.c Include c.h instead of postgres.h in src/port/*p{read,write}*.c 2022-09-17 09:21:59 -07:00
win32pwrite.c Include c.h instead of postgres.h in src/port/*p{read,write}*.c 2022-09-17 09:21:59 -07:00
win32security.c Clean up minor inconsistencies in pg_attribute_printf() usage. 2022-09-16 11:10:48 -04:00
win32setlocale.c Update copyright for 2022 2022-01-07 19:04:57 -05:00
win32stat.c Provide lstat() for Windows. 2022-08-06 12:50:11 +12:00
win32ver.rc Update copyright for 2022 2022-01-07 19:04:57 -05:00

README

src/port/README

libpgport
=========

libpgport must have special behavior.  It supplies functions to both
libraries and applications.  However, there are two complexities:

1)  Libraries need to use object files that are compiled with exactly
the same flags as the library.  libpgport might not use the same flags,
so it is necessary to recompile the object files for individual
libraries.  This is done by removing -lpgport from the link line:

        # Need to recompile any libpgport object files
        LIBS := $(filter-out -lpgport, $(LIBS))

and adding infrastructure to recompile the object files:

        OBJS= execute.o typename.o descriptor.o data.o error.o prepare.o memory.o \
                connect.o misc.o path.o exec.o \
                $(filter strlcat.o, $(LIBOBJS))

The problem is that there is no testing of which object files need to be
added, but missing functions usually show up when linking user
applications.

2) For applications, we use -lpgport before -lpq, so the static files
from libpgport are linked first.  This avoids having applications
dependent on symbols that are _used_ by libpq, but not intended to be
exported by libpq.  libpq's libpgport usage changes over time, so such a
dependency is a problem.  Windows, Linux, AIX, and macOS use an export
list to control the symbols exported by libpq.