cynic           Mon Feb  5 04:42:50 2001 EDT

  Added files:                 
    /phpdoc/cs/functions        nis.xml 
  Log:
  should be completely translated
  
  

Index: phpdoc/cs/functions/nis.xml
+++ phpdoc/cs/functions/nis.xml
  <reference id="ref.nis">
  <title>Funkce pro práci s YP/NIS</title>
  <titleabbrev>YP/NIS</titleabbrev>

  <partintro>
   <para>
    NIS (dříve Yellow Pages) umožňuje síťovou správu důležitých administrativních
    souborů (např. soubory s hesly). Více informací viz NIS man stránka a
    <ulink url="&url.nis;">Introduction to YP/NIS</ulink>. Existuje také kniha
    <ulink url="&url.nis.book;">Managing NFS and NIS</ulink> od Hala Sterna.
   </para>
   <para>
    Pokud chcete tyto funkce zprovoznit, musíte PHP zkonfigurovat s
    <option role="configure">--with-yp</option>(PHP 3) nebo
    <option role="configure">--enable-yp</option>(PHP 4).
   </para>
  </partintro>

  <refentry id="function.yp-get-default-domain">
   <refnamediv>
    <refname>yp_get_default_domain</refname>
    <refpurpose>Zjistit defaultní NIS doménu stroje</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>int <function>yp_get_default_domain</function></funcdef>
      <paramdef>void <parameter></parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>yp_get_default_domain</function> vrací defaultní doménu uzlu
     nebo <literal>false</literal>. Dá se používat jako argument domény v
     následných voláních NIS.
    </para>
    <para>
     NIS doména se dá popsat jako skupina map NIS. Každý server, který potřebuje
     vyhledat informace se připojí k určité doméně. Detailnější informace viz
     dokumentace zmíněná v úvodu.
    </para>
    <para>
     <example>
      <title>Ukázka defaultní domény</title>
      <programlisting role="php">
&lt;?php
$domain = yp_get_default_domain();
echo "Defaultní NIS doména je: " . $domain;
?>
      </programlisting>
     </example>
    </para>
<!--
    <para>
     Viz také: <link linkend="function.yp-errno">yp_errno</link> and
     <link linkend="function.yp-err-string">yp_err_string</link>
    </para>
-->
   </refsect1>
  </refentry>

  <refentry id="function.yp-order">
   <refnamediv>
    <refname>yp_order</refname>
    <refpurpose>Returns the order number for a map</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>int <function>yp_order</function></funcdef>
      <paramdef>string <parameter>domain</parameter></paramdef>
      <paramdef>string <parameter>map</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>Yp_order</function> vrací pořadové číslo mapy nebo
     <literal>false</literal>.
    </para>
    <para>
     <example>
      <title>Ukázka NIS order</title>
      <programlisting role="php">
&lt;?php
    $number = yp_order($domain,$mapname);
    echo "Pořadové číslo této mapy je: " . $order;
?>
      </programlisting>
     </example>
    </para>
    <para>
     Viz také: <function>yp-get-default-domain</function>.
<!--
     linkend="function.yp-errno">yp_errno</link> and <link
     linkend="function.yp-err-string">yp_err_string</link>
-->
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.yp-master">
   <refnamediv>
    <refname>yp_master</refname>
    <refpurpose>Zjistit název master NIS serveru mapy</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>string <function>yp_master</function></funcdef>
      <paramdef>string <parameter>domain</parameter></paramdef>
      <paramdef>string <parameter>map</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>yp_master</function> vrací název master NIS serveru určité mapy.
    </para>
    <para>
     <example>
      <title>Ukázka NIS masteru</title>
      <programlisting role="php">
&lt;?php
$number = yp_master ($domain, $mapname);
echo "Master této mapy je: " . $master;
?>
      </programlisting>
     </example>
    </para>
    <para>
     Viz také <function>yp-get-default-domain</function>.
<!--
     linkend="function.yp-errno">yp_errno</link> and <link
     linkend="function.yp-err-string">yp_err_string</link>
-->
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.yp-match">
   <refnamediv>
    <refname>yp_match</refname>
    <refpurpose>Vrátit odpovídající záznam</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>string <function>yp_match</function></funcdef>
      <paramdef>string <parameter>domain</parameter></paramdef>
      <paramdef>string <parameter>map</parameter></paramdef>
      <paramdef>string <parameter>key</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>yp_match</function> vrací hodnotu asociovanou v dané mapě s
     předaným klíčem nebo <literal>false</literal>. Klíč musí být dán přesně.
    </para>
    <para>
     <example>
      <title>Ukázka NIS match</title>
      <programlisting role="php">
&lt;?php
$entry = yp_match ($domain, "passwd.byname", "joe");
echo "Odpovídající záznam je: " . $entry;
?>
      </programlisting>
     </example>
    </para>
    <para>
     V tomto případě by to mohlo být: joe:##joe:11111:100:Joe
     User:/home/j/joe:/usr/local/bin/bash
    </para>
    <para>
     Viz také <function>yp-get-default-domain</function>
<!--
     linkend="function.yp-errno">yp_errno</link> and <link
     linkend="function.yp-err-string">yp_err_string</link>
-->
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.yp-first">
   <refnamediv>
    <refname>yp_first</refname>
    <refpurpose>Vrátit pvní klíč/hodnota pár mapy</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>array <function>yp_first</function></funcdef>
      <paramdef>string <parameter>domain</parameter></paramdef>
      <paramdef>string <parameter>map</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>Yp_first</function> vrací první klíč/hodnota pár dané mapy v dané
     doméně, nebo <literal>false</literal>.
    </para>
    <para>
     <example>
      <title>Ukázka NIS first</title>
      <programlisting role="php">
&lt;?php
    $entry = yp_first($domain, "passwd.byname");
    $key = key($entry);
    echo "První záznam v této mapě má klíč " . $key
          . " a hodnotu " . $entry[$key];
?>
      </programlisting>
     </example>
    </para>
    <para>
     Viz také <function>yp-get-default-domain</function>
<!--
     <link linkend="function.yp-errno">yp_errno</link> and <link
     linkend="function.yp-err-string">yp_err_string</link>
-->
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.yp-next">
   <refnamediv>
    <refname>yp_next</refname>
    <refpurpose>Vrátit další klíč/hodnota pár mapy</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>array <function>yp_next</function></funcdef>
      <paramdef>string <parameter>domain</parameter></paramdef>
      <paramdef>string <parameter>map</parameter></paramdef>
      <paramdef>string <parameter>key</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>yp_next</function> vrací další klíč/hodnota pár v mapě po daném
     klíči, nebo <literal>false</literal>.
    </para>
    <para>
     <example>
      <title>Ukázka NIS next</title>
      <programlisting role="php">
&lt;?php
$entry = yp_next ($domain, "passwd.byname", "joe");

if (!$entry) {
    echo yp_errno() . ": " . yp_err_string();
}

$key = key ($entry);

echo "Položka následující po joe má klíč " . $key
      . " a hodnotu " . $entry[$key];
?>
      </programlisting>
     </example>
    </para>
    <para>
     Viz také <function>yp-get-default-domain</function>.
<!--
     <link linkend="function.yp-errno">yp_errno</link> and <link
     linkend="function.yp-err-string">yp_err_string</link>
-->
    </para>
   </refsect1>
  </refentry>

<!-- Function doesn't exist

  <refentry id="function.yp-errno">
   <refnamediv>
   <refname>yp_errno</refname>
    <refpurpose>
     Returns the error code of the previous operation
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>int <function>yp_errno</function></funcdef>
      <void/>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>Yp_errno</function> returns the error code of the
     previous operation.
    </para>
    <para>
     Possible errors are:
    </para>
    <para>
     <simplelist>
      <member>1 args to function are bad</member>
      <member>2 RPC failure - domain has been unbound</member>
      <member>3 can't bind to server on this domain</member>
      <member>4 no such map in server's domain</member>
      <member>5 no such key in map</member>
      <member>6 internal yp server or client error</member>
      <member>7 resource allocation failure</member>
      <member>8 no more records in map database</member>
      <member>9 can't communicate with portmapper</member>
      <member>10 can't communicate with ypbind</member>
      <member>11 can't communicate with ypserv</member>
      <member>12 local domain name not set</member>
      <member>13 yp database is bad</member>
      <member>14 yp version mismatch</member>
      <member>15 access violation</member>
      <member>16 database busy</member>
     </simplelist>
    </para>
    <para>
     Viz také <function>yp_err_string</function>.
    </para>
   </refsect1>
  </refentry>

-->

<!-- Function doesn't exist

  <refentry id="function.yp-err-string">
   <refnamediv>
   <refname>yp_err_string</refname>
   <refpurpose>
    Returns the error string associated with the previous operation
   </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>string <function>yp_err_string</function></funcdef>
      <paramdef>void <parameter></parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>Yp_err_string</function> returns the error message
     associated with the previous operation.  Useful to indicate what
     exactly went wrong.
    </para>
    <para>
     <example>
      <title>Example for NIS errors</title>
      <programlisting role="php">
&lt;?php
    echo "Error: " . yp_err_string();
?>
      </programlisting>
     </example>
    </para>
    <para>
     Viz také <function>yp_errno</function>.
    </para>
   </refsect1>
  </refentry>

-->

 </reference>

<!-- 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
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->

Reply via email to