<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- splitted from ./en/functions/fbsql.xml, last change in rev 1.10 -->
  <refentry id="function.fbsql-database-password">
   <refnamediv>
    <refname>fbsql_database_password</refname>
    <refpurpose>
     Sets or retrieves the password for a FrontBase database
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>string</type><methodname>fbsql_database_password</methodname>
      <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        database_password
       </parameter></methodparam>
     </methodsynopsis>
    <para> 
     Returns: The database password associated with the link identifier.
    </para>
    <para> 
     <function>fbsql_database_password</function> sets and retrieves
     the database password used by the connection. if a database is
     protected by a database password, the user must call this function
     before calling <function>fbsql_select_db</function>. if the second
     optional parameter is given the function sets the database
     password for the specified link identifier.  If no link identifier is
     specified, the last opened link is assumed.  If no link is open,
     the function will try to establish a link as if
     <function>fbsql_connect</function> was called, and use it.
    </para>
    <para> 
     This function does not change the database password in the database
     nor can it be used to retrive the database password for a database.
    </para>
    <example>
     <title><function>fbsql_create_clob</function> example</title>
     <programlisting role="php">
<![CDATA[
<?php
    $link = fbsql_pconnect ("localhost", "_SYSTEM", "secret")
        or die ("Could not connect");
    fbsql_database_password($link, "secret db password");
    fbsql_select_db($database, $link);
?>
]]>
     </programlisting>
    </example>
    <para> 
     See also: <function>fbsql_connect</function>,
     <function>fbsql_pconnect</function> and
     <function>fbsql_select_db</function>.
    </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:"../../../../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
-->