svn: /phpdoc/de/trunk/reference/ibase/functions/ ibase-backup.xml ibase-restore.xml ibase-server-info.xml

Added: phpdoc/de/trunk/reference/ibase/functions/ibase-backup.xml
===================================================================
--- phpdoc/de/trunk/reference/ibase/functions/ibase-backup.xml	                        (rev 0)
+++ phpdoc/de/trunk/reference/ibase/functions/ibase-backup.xml	2019-08-15 14:08:35 UTC (rev 347854)
@@ -0,0 +1,173 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 347551 Maintainer: [email protected] Status: ready -->
+<!-- Reviewed: no -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ibase-backup">
+ <refnamediv>
+  <refname>ibase_backup</refname>
+  <refpurpose>Initiiert eine Sicherungsaufgabe im Service Manager und springt sofort zurück</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>mixed</type><methodname>ibase_backup</methodname>
+   <methodparam><type>resource</type><parameter>service_handle</parameter></methodparam>
+   <methodparam><type>string</type><parameter>source_db</parameter></methodparam>
+   <methodparam><type>string</type><parameter>dest_file</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>verbose</parameter><initializer>&false;</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   Diese Funktion übergibt die Argumente an den (entfernten) Datenbankserver. Dort startet sie einen neuen Sicherungsvorgang. Deshalb erhalten Sie keine Antwort.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>service_handle</parameter></term>
+     <listitem>
+      <para>
+       Eine zuvor geöffnete Verbindung zum Datenbankserver.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>source_db</parameter></term>
+     <listitem>
+      <para>
+       Der absolute Dateipfad zur Datenbank auf dem Datenbankserver. Sie können auch einen Datenbankalias verwenden.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>dest_file</parameter></term>
+     <listitem>
+      <para>
+       Der Pfad zur Sicherungsdatei auf dem Datenbankserver.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>options</parameter></term>
+     <listitem>
+      <para>
+       Zusätzliche Optionen, die zur Sicherung an den Datenbankserver übergeben werden.
+       Der Parameter <parameter>options</parameter> darf eine Kombination folgender Konstanten sein:
+       <constant>IBASE_BKP_IGNORE_CHECKSUMS</constant>,
+       <constant>IBASE_BKP_IGNORE_LIMBO</constant>,
+       <constant>IBASE_BKP_METADATA_ONLY</constant>,
+       <constant>IBASE_BKP_NO_GARBAGE_COLLECT</constant>,
+       <constant>IBASE_BKP_OLD_DESCRIPTIONS</constant>,
+       <constant>IBASE_BKP_NON_TRANSPORTABLE</constant> or
+       <constant>IBASE_BKP_CONVERT</constant>.
+       Vgl. auch den Abschnitt <xref linkend="ibase.constants" />.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>verbose</parameter></term>
+     <listitem>
+      <para>
+       Da der Sicherungsvorgang auf dem Datenbankserver ausgeführt wird, haben Sie keine Chance, die Ausgabe abzurufen. Dieses Argument ist sinnlos.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+  <para>
+   Da der Sicherungsvorgang auf dem (Remote-) Server durchgeführt wird, übergibt diese Funktion nur die Argumente an diesen. Solange die Argumente gültig sind, werden Sie niemals &false; zurückbekommen.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>ibase_backup</function>-Beispiel</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+// Mit Datenbankserver mittels IP-Adresse und Port verbinden
+$service = ibase_service_attach ('10.1.11.200/3050', 'sysdba', 'masterkey');
+
+// Sicherungsvorgang auf DB-Server starten
+// Sichern der Mitarbeiterdatenbank unter Verwendung des vollständigen Pfads nach /srv/backup/employees.fbk
+// Keine speziellen Paramter verwenden
+ibase_backup($service, '/srv/firebird/employees.fdb', '/srv/backup/employees.fbk');
+
+// Verbindung wieder freigeben
+ibase_service_detach ($service);
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+
+  <para>
+   <example>
+    <title><function>ibase_backup</function>-Beispiel mit Argumenten</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+// Stelle eine Verbindung zum Datenbankserver mit Namen und Standardport her
+$service = ibase_service_attach ('fb-server.contoso.local', 'sysdba', 'masterkey');
+
+// Sicherungsvorgang auf Datenbankserver starten
+// Sichern der Mitarbeiterdatenbank mittels Alias nach /srv/backup/employees.fbk.
+// Nur die Metadaten sichern. Kein transportables Backup erstellen.
+ibase_backup($service, 'employees.fdb', '/srv/backup/employees.fbk', IBASE_BKP_METADATA_ONLY | IBASE_BKP_NON_TRANSPORTABLE);
+
+// Verbindung wieder freigeben
+ibase_service_detach ($service);
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>ibase_restore</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->


Property changes on: phpdoc/de/trunk/reference/ibase/functions/ibase-backup.xml
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property
Added: phpdoc/de/trunk/reference/ibase/functions/ibase-restore.xml
===================================================================
--- phpdoc/de/trunk/reference/ibase/functions/ibase-restore.xml	                        (rev 0)
+++ phpdoc/de/trunk/reference/ibase/functions/ibase-restore.xml	2019-08-15 14:08:35 UTC (rev 347854)
@@ -0,0 +1,178 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 347551 Maintainer: [email protected] Status: ready -->
+<!-- Reviewed: no -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ibase-restore">
+ <refnamediv>
+  <refname>ibase_restore</refname>
+  <refpurpose>Leitet eine Wiederherstellungsaufgabe im Service Manager ein und kehrt sofort zurück</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>mixed</type><methodname>ibase_restore</methodname>
+   <methodparam><type>resource</type><parameter>service_handle</parameter></methodparam>
+   <methodparam><type>string</type><parameter>source_file</parameter></methodparam>
+   <methodparam><type>string</type><parameter>dest_db</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>verbose</parameter><initializer>&false;</initializer></methodparam>
+  </methodsynopsis>
+
+   <para>
+   Diese Funktion übergibt die Argumente an den (entfernten) Datenbankserver. Dort startet sie einen neuen Sicherungsvorgang. Deshalb erhalten Sie keine Antwort.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>service_handle</parameter></term>
+     <listitem>
+      <para>
+       Eine zuvor geöffnete Verbindung zum Datenbankserver.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>source_file</parameter></term>
+     <listitem>
+      <para>
+       Der absolute Pfad auf dem Server, auf dem sich die Sicherungsdatei befindet.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>dest_db</parameter></term>
+     <listitem>
+      <para>
+       Der Pfad zum Erstellen der neuen Datenbank auf dem Server. Sie können auch einen Datenbankalias verwenden.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>options</parameter></term>
+     <listitem>
+      <para>
+       Zusätzliche Optionen, die zur Wiederherstellung an den Datenbankserver übergeben werden.
+       Der Parameter <parameter>options</parameter> darf aus Kombinationen folgender Konstanten bestehen:
+       <constant>IBASE_RES_DEACTIVATE_IDX</constant>,
+       <constant>IBASE_RES_NO_SHADOW</constant>,
+       <constant>IBASE_RES_NO_VALIDITY</constant>,
+       <constant>IBASE_RES_ONE_AT_A_TIME</constant>,
+       <constant>IBASE_RES_REPLACE</constant>,
+       <constant>IBASE_RES_CREATE</constant>,
+       <constant>IBASE_RES_USE_ALL_SPACE</constant>,
+       <constant>IBASE_PRP_PAGE_BUFFERS</constant>,
+       <constant>IBASE_PRP_SWEEP_INTERVAL</constant>,
+       <constant>IBASE_RES_CREATE</constant>.
+       Vgl. den Abschnitt <xref linkend="ibase.constants" /> für weitere informationen.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>verbose</parameter></term>
+     <listitem>
+      <para>
+       Da der Wiederherstellungsvorgang auf dem Datenbankserver ausgeführt wird, haben Sie keine Chance, die Ausgabe abzurufen. Dieses Argument ist sinnlos.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+  <para>
+   Da der Sicherungsvorgang auf dem (Remote-) Server durchgeführt wird, übergibt diese Funktion nur die Argumente an diesen. Solange die Argumente gültig sind, werden Sie niemals &false; zurückbekommen.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>ibase_restore</function>-Beispiel</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+// Mit Datenbankserver mittels IP-Adresse und Port verbinden
+$service = ibase_service_attach ('10.1.11.200/3050', 'sysdba', 'masterkey');
+
+// Starte den Wiederherstellungsvorgang
+// Wiederherstellung der Mitarbeiter-DB in neue emps.fdb-Datenbank.
+// Keine Angabe weiterer Argumente.
+ibase_restore($service, '/srv/backup/employees.fbk', '/srv/firebird/emps.fdb');
+
+// Verbindung wieder freigeben
+ibase_service_detach ($service);
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+
+  <para>
+   <example>
+    <title><function>ibase_restore</function>-Beispiel mit Argumenten</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+// Mit Datenbankserver mittels Namen und Standardport verbinden
+$service = ibase_service_attach ('fb-server.contoso.local', 'sysdba', 'masterkey');
+
+// Starte den Wiederherstellungsprozess
+// Employee-Datenbank mittels Alias wiederherstellen
+// Wiederherstellung ohne Indizes. Existierende DB ersetzen.
+ibase_backup($service, '/srv/backup/employees.fbk', 'employees.fdb', IBASE_RES_DEACTIVATE_IDX | IBASE_RES_REPLACE);
+
+// Verbindung wieder freigeben.
+ibase_service_detach ($service);
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>ibase_backup</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->


Property changes on: phpdoc/de/trunk/reference/ibase/functions/ibase-restore.xml
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property
Added: phpdoc/de/trunk/reference/ibase/functions/ibase-server-info.xml
===================================================================
--- phpdoc/de/trunk/reference/ibase/functions/ibase-server-info.xml	                        (rev 0)
+++ phpdoc/de/trunk/reference/ibase/functions/ibase-server-info.xml	2019-08-15 14:08:35 UTC (rev 347854)
@@ -0,0 +1,145 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 347551 Maintainer: [email protected] Status: ready -->
+<!-- Reviewed: no -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ibase-server-info">
+ <refnamediv>
+  <refname>ibase_server_info</refname>
+  <refpurpose>Informationen zu einem Datenbankserver anfordern</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>string</type><methodname>ibase_server_info</methodname>
+   <methodparam><type>resource</type><parameter>service_handle</parameter></methodparam>
+   <methodparam><type>int</type><parameter>action</parameter></methodparam>
+  </methodsynopsis>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>service_handle</parameter></term>
+     <listitem>
+      <para>
+       Eine zuvor erstellte Verbindung zum Datenbankserver.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>action</parameter></term>
+     <listitem>
+      <para>
+       Eine gültige Konstante.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Gibt je nach Kontext gemischte Typen zurück.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>ibase_service_attach</function>-Beispiel</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+    // Stelle eine Verbindung zum entfernten Firebird-Server her
+    if (($service = ibase_service_attach('10.1.1.254/3050', 'sysdba', 'masterkey')) != FALSE) {
+
+        // Verbidung erfolgreich
+
+        // Infos ausgeben
+        echo "Server version: " . ibase_server_info($service, IBASE_SVC_SERVER_VERSION) . "\n";
+        echo "Server implementation: " . ibase_server_info($service, IBASE_SVC_IMPLEMENTATION) . "\n";
+        echo "Server users: " . print_r(ibase_server_info($service, IBASE_SVC_GET_USERS), true) . "\n";
+        echo "Server directory: " . ibase_server_info($service, IBASE_SVC_GET_ENV) . "\n";
+        echo "Server lock path: " . ibase_server_info($service, IBASE_SVC_GET_ENV_LOCK) . "\n";
+        echo "Server lib path: " . ibase_server_info($service, IBASE_SVC_GET_ENV_MSG) . "\n";
+        echo "Path of user db: " . ibase_server_info($service, IBASE_SVC_USER_DBPATH) . "\n";
+        echo "Established connections: " . print_r(ibase_server_info($service, IBASE_SVC_SVR_DB_INFO),true) . "\n";
+
+        // Serververbindung lösen (disconnect)
+        ibase_service_detach($service);
+
+    }
+    else {
+        // Fehler ausgeben
+        $conn_error = ibase_errmsg();
+        die($conn_error);
+    }
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+Server version: LI-V3.0.4.33054 Firebird 3.0
+Server implementation: Firebird/Linux/AMD/Intel/x64
+Server users: Array
+(
+    [0] => Array
+        (
+            [user_name] => SYSDBA
+            [first_name] => Sql
+            [middle_name] => Server
+            [last_name] => Administrator
+            [user_id] => 0
+            [group_id] => 0
+        )
+
+)
+
+Server directory: /etc/firebird/
+Server lock path: /tmp/firebird/
+Server lib path: /usr/lib64/firebird/lib/
+Path of user db: /var/lib/firebird/secdb/security3.fdb
+Established connections: Array
+(
+    [attachments] => 3
+    [databases] => 2
+    [0] => /srv/firebird/poss.fdb
+    [1] => /srv/firebird/employees.fdb
+)
+]]>
+    </screen>
+   </example>
+  </para>
+
+ </refsect1>
+
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->


Property changes on: phpdoc/de/trunk/reference/ibase/functions/ibase-server-info.xml
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property