Re: Question and suggestion about application binary compatibility policy - Mailing list pgsql-hackers

From Tsunakawa, Takayuki
Subject Re: Question and suggestion about application binary compatibility policy
Date
Msg-id 0A3221C70F24FB45833433255569204D1F57C18D@G01JPEXMBYT05
Whole thread Raw
In response to Re: Question and suggestion about application binary compatibility policy  (Michael Meskes <meskes@postgresql.org>)
Responses Re: Question and suggestion about application binary compatibility policy
Re: Question and suggestion about application binary compatibility policy
List pgsql-hackers
> From: Michael Meskes [mailto:meskes@postgresql.org]
> > Yes, but Windows users probably don't understand or know it.  So, I
> > suggested explicitly describing the application binary compatibility
> > policy in the PostgreSQL manual.  What do you think about it?
> 
> Couldn't you point your customer to the system documentation?
> 
> Personally I don't think standard system behavior should be documented for
> each application relying on it but ymmv.

I couldn't find appropriate system documentation.  Regarding Linux, I remember I saw some HOWTO on tldp.org website
whichexplains the concept of shared library soname, but it's not very friendly for users who just want to know the
applicationbinary compatibility policy of PostgreSQL.  And I don't think there's suitable documentation on Windows.
Evenif there is any, users will not be sure whether PostgreSQL follows those platform-specific conventions.  They may
havedoubts about it, because even the product version "PostgreSQL x.y.z" causes misconception that x is the major
versionand y is the minor one.
 

So, I suggested documenting the compatibility policy for clarification and user friendliness as in the Oracle Database
documentationbelow.
 

http://docs.oracle.com/database/121/UPGRD/app.htm#UPGRD12547


BTW, although this may be a separate topic, it may be better that we add the major version in the library names like
libpq5.dlland libecpg6.dll, so that the application can fail to run with the incompatible versions of libpq and
libecpg. FYI:
 

https://en.wikipedia.org/wiki/Side-by-side_assembly

[Excerpt]
Microsoft Visual C++ 2005 and 2008 employ SxS with all C runtime libraries. However, runtime libraries in Visual C++
2010no longer use this technology; instead, they include the version number of a DLL in its file name, which means that
differentversions of one DLL will technically be completely different DLLs now.
 


Any comments on these?  If there's no strong objection, I think I'll submit a documentation patch in the future.

Regards
Takayuki Tsunakawa


pgsql-hackers by date:

Previous
From: Amit Langote
Date:
Subject: Re: foreign table batch inserts
Next
From: Tatsuo Ishii
Date:
Subject: Re: Statement timeout