fb_config-Optionen

Verwenden Sie zum Ausführen des Skripts fb_config eine Befehlszeile ähnlich der folgenden:

fb_config <option> [ <option> [...]]

Das Skript verwendet eine oder mehrere Optionen in der Befehlszeile:

--help: Dieser Parameter zeigt die Liste der zulässigen Optionen an.Es sollte nicht zusätzlich zu anderen Optionen geliefert werden.
--cflags: Diese Option gibt die Liste der Verzeichnisse zurück, in denen Firebird-Include-Dateien gespeichert sind.Dies wird von den C- und C ++ - Compilern benötigt, damit die #include-Anweisungen des Compilers korrekt aufgelöst werden können.Auf meinem eigenen System gibt diese Option ‘-I/opt/firebird/include’ zurück.
--libs: Diese Option gibt die Liste der Verzeichnisse zurück, in denen sich Firebird-Bibliotheken befinden, sowie eine Liste der Bibliotheken, die vom Linker verknüpft werden müssen, um eine Client-Server-Firebird-Anwendung zu erstellen.Diese Option gibt auf meinem System ‘-L/opt/firebird/lib -lfbclient’ zurück.
--embedlibs: Diese Option gibt die Liste der Verzeichnisse zurück, in denen sich Firebird-Bibliotheken befinden, sowie eine Liste der Bibliotheken, die vom Linker verknüpft werden müssen, um eine eingebettete Firebird-Anwendung zu erstellen.Diese Option gibt auf meinem System ‘-L/opt/firebird/lib -lfbembed’ zurück.
--bindir: Diese Option gibt auf meinem System den vollen Pfad ‘/opt/firebird/bin’ für das /bin-Verzeichnis der Firebirdinstallation zurück.
--version: Diese Option gibt eine dreiteilige Versionszeichenfolge zurück, die aus der Verkettung der Firebird-Build-Version, einem Bindestrich, der Paketversion, einem Punkt und der Systemarchitektur besteht.Mein eigenes Linux-Notebook gibt ‘1.5.0.4290-0.i686’ zurück.

Das Folgende ist ein kurzer Auszug aus einem Makefile, der zeigt, wie zwei Makros, FBFLAGS und FBLIBS, definiert und mit fb_config auf die richtigen Werte initialisiert werden.Beachten Sie die Verwendung des Back-Tick-Zeichens (`) anstelle eines einfachen Anführungszeichens (').

...
FBFLAGS = `fb_config --cflags`
FBLIBS = `fb_config --libs`
...

ChangeRunUser

Unter Firebird 1.5 gibt es zwei Versionen des Skripts changeRunUser.sh, die mit dem Präfix SS für Super Server-Installationen und die mit dem Präfix CS für Classic Server-Installationen.Ab Firebird 2 lautet das Skript einfach changeRunUser.sh.

Note	Das Skript sollte als root ausgeführt werden.

Mit dem Skript changeRunUser.sh können der Benutzer und die Gruppe, unter denen der Firebird-Server ausgeführt wird, geändert werden.Standardmäßig ist dies jetzt der Firebird-Benutzer und die Firebird-Gruppe. In früheren Versionen wurde der Firebird-Server jedoch als Root-Benutzer ausgeführt, was aus Sicht der Systemsicherheit unerwünscht ist und das Erstellen von Datenbanken im gesamten Dateisystem ermöglichte.Mit dem neuen Firebird-Benutzer können Einschränkungen für die Erstellung von Datenbanken festgelegt werden.

Das Skript ändert den geschuldeten Benutzer und die Gruppe einer Reihe von Dateien im Firebird-Installationsverzeichnis, die Protokolldatei sowie das Startskript /etc/rc.d.init.d/firebird, mit dem der Firebird-Server gestartet und gestoppt wird.

docnext count = 5

ChangeRunUser.sh-Parameter

Verwenden Sie zum Ausführen des Skripts eine Befehlszeile, die der folgenden ähnelt:

changeRunUser.sh <username> <groupname>

Das Skript verwendet zwei Parameter in der Befehlszeile, die beide optional sind, da Sie aufgefordert werden, wenn beide weggelassen werden.Wenn Sie nur einen Parameter angeben, wird davon ausgegangen, dass es sich um den Benutzernamen handelt, und Sie werden zur Eingabe des Gruppennamens aufgefordert.

username: Dieser Parameter legt den Benutzernamen fest, unter dem der Firebird-Server ausgeführt werden soll.Der angegebene Wert wird gegen Einträge in /etc/passwd validiert.
groupname: Dieser Parameter legt den Gruppennamen fest, unter dem der Firebird-Server ausgeführt werden soll.Der angegebene Wert wird anhand von Einträgen in /etc/group überprüft.

Das folgende Beispiel zeigt die Verwendung von changeRunUser.sh, um den besitzenden Benutzer und die Gruppe in firebird zu ändern.Der Firebird-Benutzer und die Firebird-Gruppe sind bei der Installation von Firebird die Standardeinstellung. Sie müssen das Skript also nicht ausführen, es sei denn, Sie haben diese Details bereits geändert.

# cd /opt/firebird/bin
# ./changeRunUser.sh firebird firebird
Updating /opt/firebird
Updating startup script
Completed

Wenn Sie Firebird 2.1 oder höher ausführen, wird keine Eingabeaufforderung mehr angezeigt, wenn Sie dieses Skript ohne Parameter ausführen.Das Skript verwendet jetzt standardmäßig Firebird für den Benutzer und die Gruppe, wenn Sie keine Parameter angeben.Das Ausführen des Skripts unter 2.1 bietet Folgendes:

# cd /opt/firebird/bin
# ./changeRunUser.sh
Shutting down Firebird                                                done

Change Firebird install for /opt/firebird to uid=firebird gid=firebird
(User or group options can be changed by editing this script)

Press return to continue - or ^C to abort

Updating /etc file(s)
Updating /opt/firebird
Starting Firebird                                                     done
Completed.

Warning

Wenn Sie von diesem Skript eine Aufforderung "Press return to continue …" erhalten, werden alle mit dem Datenbankserver verbundenen VNC-Sitzungen beendet.Stellen Sie sicher, dass sich der Server in einer ruhigen Phase befindet und nicht während der normalen Betriebszeiten, wenn Sie diese Änderung vornehmen.Dies betrifft Suse Linux Enterprise 10, kann jedoch auch andere Linux-Distributionen betreffen.

RestoreRootRunUser

Unter Firebird 1.5 gibt es zwei Versionen des Skripts restoreRootRunUser.sh.Das Präfix 'SS' steht für Super Server-Installationen und das Präfix 'CS' für Classic Server-Installationen.Ab Firebird 2 lautet das Skript einfach "restoreRootRunUser.sh".

Note	Dieses Skript muss als root ausgeführt werden.

Dieses Skript stellt einfach das Installationsformat im alten Stil wieder her, bei dem der Firebird Super Server als Root-Benutzer und Gruppe ausgeführt wird.

ChangeGDSLibraryCompatibleLink

Das Skript changeGdsLibraryCompatibleLink.sh ist nur bei Classic Server-Installationen verfügbar und wird verwendet, um den Symlink libgds.so so zu ändern, dass er auf die entsprechende Bibliothek für die Installation verweist.Es gibt zwei mögliche Bibliotheken, auf die der Symlink verweisen kann:

/opt/firebird/lib/libfbclient.so für Client-Server-Anwendungen.
/opt/firebird/lib/libfbembed.so für Embedded-Server-Anwendungen.

Nach der Installation verweist der Symlink libgds.so standardmäßig auf die Client-Server-Bibliothek. Wenn Sie also eine eingebettete Anwendung ausführen, müssen Sie dieses Skript ausführen, um stattdessen libgds.so auf die eingebettete Bibliothek zu verweisen.

Note	Dieses Skript muss als root ausgeführt werden.

Das folgende Beispiel zeigt, wie dieses Skript verwendet wird, um vom eingebetteten Server zum Client-Server zu wechseln:

# cd /opt/firebird/bin
# ./changeGdsCompatibleLibraryLink.sh
Für klassische Server gibt es zwei optionale abwärtskompatible Clients
Bibliotheken. Dies sind libfbclient.so und libfbembed.so.

libfbclient.so) Ermöglicht Ihrem Client das Multithreading, muss jedoch über
                einen Server eine Verbindung zu einer Datenbank herstellen.
libfbembed.so)  Ermöglicht dem Client das direkte Öffnen der Datenbankdatei,
                unterstützt jedoch keinen Multithread-Zugriff

Ihre aktuelle Einstellung ist:
/usr/lib/libgds.so -> /opt/firebird/lib/libfbembed.so

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

Die Standardoption ist client, wodurch der Symlink zur Client-Server-Bibliothek neu erstellt wird. embed erstellt den Symlink zum eingebetteten Server neu, während remove den Symlink vollständig entfernt.

Es werden keine Meldungen angezeigt, die Sie über den Erfolg des Skripts informieren. Wenn Sie es jedoch erneut ausführen, werden Sie feststellen, dass die aktuelle Einstellung von der Einstellung abweichen sollte, die angezeigt wurde, als Sie das Skript zuvor ausgeführt haben.

Dokumentenhistorie

Der genaue Dateiversionsverlauf wird im Firebird-Dokumentations-Git-Repository aufgezeichnet; siehe https://github.com/FirebirdSQL/firebird-documentation

Revisionshistorie
0.1	22. Nov. 2004	ND	Erstellt als Kapitel im Handbuch der Befehlszeilen-Dienstprogramme.
1.0	19. Okt. 2009	ND	Für Firebird 2 aktualisiert, geringfügige Änderungen an der Zeichensetzung vorgenommen und dann in ein eigenständiges Handbuch konvertiert.
1.1	05. Jan. 2010	ND	Rechtschreibkorrektur.
1.2	27. Apr. 2010	ND	Beim Ändern des DBA-Passworts wird das Startskript nicht mehr geändert.Andere geändert für Version 2.1 hinzugefügt.
1.3	20. Jun. 2020	MR	Konvertierung in AsciiDoc, geringfügige Bearbeitung von Texten
1.3-de	31. Jul. 2020	MR	Übersetzung ins Deutsche.

Revisionshistorie

0.1

22. Nov. 2004

Erstellt als Kapitel im Handbuch der Befehlszeilen-Dienstprogramme.

1.0

19. Okt. 2009

Für Firebird 2 aktualisiert, geringfügige Änderungen an der Zeichensetzung vorgenommen und dann in ein eigenständiges Handbuch konvertiert.

1.1

05. Jan. 2010

Rechtschreibkorrektur.

1.2

27. Apr. 2010

Beim Ändern des DBA-Passworts wird das Startskript nicht mehr geändert.Andere geändert für Version 2.1 hinzugefügt.

1.3

20. Jun. 2020

Konvertierung in AsciiDoc, geringfügige Bearbeitung von Texten

1.3-de

31. Jul. 2020

Übersetzung ins Deutsche.

Lizenzhinweis

Der Inhalt dieser Dokumentation unterliegt der "Public Documentation License Version 1.0" (der “License”);die Dokumentation darf nur unter Respektierung dieser Lizenz genutzt werden.Kopien der Lizenz sind verfügbar unter https://www.firebirdsql.org/pdfmanual/pdl.pdf (PDF) und https://www.firebirdsql.org/manual/pdl.html (HTML).

Die Original-Dokumentation trägt den Titel Firebird Shell Scripts.

Der ursprüngliche Autor der Original-Dokumentation ist: Norman Dunbar.

Mitwirkende: Norman Dunbar; Mark Rotteveel; Martin Köditz - siehe Dokumenthistorie.

Fb_Config-Optionen