2010-09-20 22:08:53 +02:00
|
|
|
src/port/README
|
2008-03-21 14:23:29 +01:00
|
|
|
|
|
|
|
libpgport
|
|
|
|
=========
|
|
|
|
|
2006-04-28 04:52:57 +02:00
|
|
|
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 \
|
2018-09-26 19:13:57 +02:00
|
|
|
$(filter strlcat.o, $(LIBOBJS))
|
2006-04-28 04:52:57 +02:00
|
|
|
|
|
|
|
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
|
Refer to OS X as "macOS", except for the port name which is still "darwin".
We weren't terribly consistent about whether to call Apple's OS "OS X"
or "Mac OS X", and the former is probably confusing to people who aren't
Apple users. Now that Apple has rebranded it "macOS", follow their lead
to establish a consistent naming pattern. Also, avoid the use of the
ancient project name "Darwin", except as the port code name which does not
seem desirable to change. (In short, this patch touches documentation and
comments, but no actual code.)
I didn't touch contrib/start-scripts/osx/, either. I suspect those are
obsolete and due for a rewrite, anyway.
I dithered about whether to apply this edit to old release notes, but
those were responsible for quite a lot of the inconsistencies, so I ended
up changing them too. Anyway, Apple's being ahistorical about this,
so why shouldn't we be?
2016-09-25 21:40:57 +02:00
|
|
|
dependency is a problem. Windows, Linux, and macOS use an export list to
|
2006-04-28 04:59:11 +02:00
|
|
|
control the symbols exported by libpq.
|