postgresql/src/port
Tom Lane 5c02a00d44 Move CRC tables to libpgport, and provide them in a separate include file.
This makes it much more convenient to build tools for Postgres that are
separately compiled and require a matching CRC implementation.

To prevent multiple copies of the CRC polynomial tables being introduced
into the postgres binaries, they are now included in the static library
libpgport that is mainly meant for replacement system functions.  That
seems like a bit of a kludge, but there's no better place.

This cleans up building of the tools pg_controldata and pg_resetxlog,
which previously had to build their own copies of pg_crc.o.

In the future, external programs that need access to the CRC tables can
include the tables directly from the new header file pg_crc_tables.h.

Daniel Farina, reviewed by Abhijit Menon-Sen and Tom Lane
2012-02-28 19:53:39 -05:00
..
.gitignore Convert cvsignore to gitignore, and add .gitignore for build targets. 2010-09-22 12:57:04 +02:00
Makefile Move CRC tables to libpgport, and provide them in a separate include file. 2012-02-28 19:53:39 -05:00
README Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
chklocale.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
crypt.c pgindent run before PG 9.1 beta 1. 2011-04-10 11:42:00 -04:00
dirent.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
dirmod.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
erand48.c Fix typo in pg_srand48 (srand48 in older branches). 2011-09-03 16:17:34 -04:00
exec.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
fls.c Fix typo in comment. 2012-02-07 21:21:50 +02:00
fseeko.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
getaddrinfo.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
gethostname.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
getopt.c Pgindent run before 9.1 beta2. 2011-06-09 14:32:50 -04:00
getopt_long.c Remove optreset from src/port/ implementations of getopt and getopt_long. 2010-12-16 16:23:05 -05:00
getpeereid.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
getrusage.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
gettimeofday.c Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
inet_aton.c Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
inet_net_ntop.c Pgindent run before 9.1 beta2. 2011-06-09 14:32:50 -04:00
isinf.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
kill.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
memcmp.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
noblock.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
open.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
path.c Use abort() instead of exit() to abort library functions 2012-01-30 21:34:00 +02:00
pg_crc.c Move CRC tables to libpgport, and provide them in a separate include file. 2012-02-28 19:53:39 -05:00
pgcheckdir.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
pgmkdirp.c pgindent run before PG 9.1 beta 1. 2011-04-10 11:42:00 -04:00
pgsleep.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
pgstrcasecmp.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
pthread-win32.h Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
qsort.c Speed up in-memory tuplesorting. 2012-02-15 12:13:32 -05:00
qsort_arg.c Speed up in-memory tuplesorting. 2012-02-15 12:13:32 -05:00
random.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
rint.c Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
snprintf.c pgindent run before PG 9.1 beta 1. 2011-04-10 11:42:00 -04:00
sprompt.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
srandom.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
strdup.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
strerror.c Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
strlcat.c Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
strlcpy.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
strtol.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
strtoul.c Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
thread.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
unsetenv.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
win32.ico Revert binary change in copyright year adjustment. 2012-01-01 19:40:13 -05:00
win32env.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
win32error.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
win32setlocale.c Update copyright notices for year 2012. 2012-01-01 18:01:58 -05:00
win32ver.rc Update copyright notices for year 2012. 2012-01-01 18:01:58 -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 snprintf.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.  Win32, Linux, and Darwin use an export list to
control the symbols exported by libpq.