Firebird Shell Scripts | Changegdslibrarycompatiblelink

ChangeGDSLibraryCompatibleLink

This script, changeGdsLibraryCompatibleLink.sh, is available with Classic Server installations only, and is used to change the symlink libgds.so to point to the appropriate library for the installation.There are two possible libraries that the symlink can point to:

/opt/firebird/lib/libfbclient.so for client server applications
/opt/firebird/lib/libfbembed.so for embedded server applications.

After installation, the libgds.so symlink points to the client server library by default so if you are running an embedded application, you need to run this script to point libgds.so at the embedded library instead.

Note	This script must be run as root.

The following example shows how this script is used to change from embedded server to client server use:

# cd /opt/firebird/bin
# ./changeGdsCompatibleLibraryLink.sh
For classic server there are two optional backward compatible client
libraries. These are libfbclient.so and libfbembed.so.

libfbclient.so) enables your client to be multithreaded but must
                connect to a database via a server.
libfbembed.so)  allows the client to directly open the database file,
                but does not support multithreaded access

Your current setting is:
/usr/lib/libgds.so -> /opt/firebird/lib/libfbembed.so

Which option would you like to choose (client|embed|remove)
                                                       [client] client
#

The default option is client which will recreate the symlink to the client server library, embed will recreate the symlink to the embedded server, while remove will remove the symlink altogether.

There are no messages displayed to inform you of the success of the script, however, if you run it again, you will notice the current setting should be different to that displayed when you previously ran the script.

Document history

The exact file history is recorded in the firebird-documentation git repository; see https://github.com/FirebirdSQL/firebird-documentation

Revision History
0.1	22 Nov 2004	ND	Created as a chapter in the Command Line Utilities manual.
1.0	19 Oct 2009	ND	Updated for Firebird 2, minor changes to punctuation and then converted to a stand alone manual.
1.1	05 Jan 2010	ND	Spelling correction.
1.2	27 Apr 2010	ND	When changing the DBA password, it is no longer the case that the startup script is also amended.Other changed for version 2.1 added.
1.3	20 Jun 2020	MR	Conversion to AsciiDoc, minor copy-editing

Revision History

0.1

22 Nov 2004

ND

Created as a chapter in the Command Line Utilities manual.

1.0

19 Oct 2009

ND

Updated for Firebird 2, minor changes to punctuation and then converted to a stand alone manual.

1.1

05 Jan 2010

ND

Spelling correction.

1.2

27 Apr 2010

ND

When changing the DBA password, it is no longer the case that the startup script is also amended.Other changed for version 2.1 added.

1.3

20 Jun 2020

MR

Conversion to AsciiDoc, minor copy-editing

License notice

The contents of this Documentation are subject to the Public Documentation License Version 1.0 (the “License”); you may only use this Documentation if you comply with the terms of this License.Copies of the License are available at https://www.firebirdsql.org/pdfmanual/pdl.pdf (PDF) and https://www.firebirdsql.org/manual/pdl.html (HTML).

The Original Documentation is titled Firebird Shell Scripts.

The Initial Writer of the Original Documentation is: Norman Dunbar.

Changegdslibrarycompatiblelink

ChangeGDSLibraryCompatibleLink

Document history

docnext count = 1

License notice