[PHP-DOC] cvs: phpdoc /cs/functions nis.xml

[Roman Neuhauser]

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:
-->