<?xml version="1.0" encoding="iso-8859-2"?>
  <reference id="ref.nis">
  <title>Funkce pro prci s YP/NIS</title>
  <titleabbrev>YP/NIS</titleabbrev>

  <partintro>
   <para>
    NIS (dve Yellow Pages) umouje sovou sprvu dleitch administrativnch
    soubor (nap. soubory s hesly). Vce informac viz NIS man strnka 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, muste 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 domnu stroje</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>yp_get_default_domain</methodname>
      <methodparam><type>void</type><parameter/></methodparam>
     </methodsynopsis>
    <para>
     <function>yp_get_default_domain</function> vrac defaultn domnu uzlu
     nebo &false;. D se pouvat jako argument domny v
     nslednch volnch NIS.
    </para>
    <para>
     NIS domna se d popsat jako skupina map NIS. Kad server, kter potebuje
     vyhledat informace se pipoj k urit domn. Detailnj informace viz
     dokumentace zmnn v vodu.
    </para>
    <para>
     <example>
      <title>Ukzka defaultn domny</title>
      <programlisting role="php">
&lt;?php
$domain = yp_get_default_domain();
echo "Defaultn NIS domna 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>
     <methodsynopsis>
      <type>int</type><methodname>yp_order</methodname>
      <methodparam><type>string</type><parameter>domain</parameter></methodparam>
      <methodparam><type>string</type><parameter>map</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>yp_order</function> vrac poadov slo mapy nebo
     &false;.
    </para>
    <para>
     <example>
      <title>Ukzka NIS order</title>
      <programlisting role="php">
&lt;?php
    $number = yp_order($domain,$mapname);
    echo "Poadov slo tto 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 nzev master NIS serveru mapy</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>yp_master</methodname>
      <methodparam><type>string</type><parameter>domain</parameter></methodparam>
      <methodparam><type>string</type><parameter>map</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>yp_master</function> vrac nzev master NIS serveru urit mapy.
    </para>
    <para>
     <example>
      <title>Ukzka NIS masteru</title>
      <programlisting role="php">
&lt;?php
$number = yp_master ($domain, $mapname);
echo "Master tto 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>Vrtit odpovdajc zznam</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>yp_match</methodname>
      <methodparam><type>string</type><parameter>domain</parameter></methodparam>
      <methodparam><type>string</type><parameter>map</parameter></methodparam>
      <methodparam><type>string</type><parameter>key</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>yp_match</function> vrac hodnotu asociovanou v dan map s
     pedanm klem nebo &false;. Kl mus bt dn pesn.
    </para>
    <para>
     <example>
      <title>Ukzka NIS match</title>
      <programlisting role="php">
&lt;?php
$entry = yp_match ($domain, "passwd.byname", "joe");
echo "Odpovdajc zznam je: " . $entry;
?>
      </programlisting>
     </example>
    </para>
    <para>
     V tomto ppad by to mohlo bt: 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>Vrtit pvn kl/hodnota pr mapy</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>array</type><methodname>yp_first</methodname>
      <methodparam><type>string</type><parameter>domain</parameter></methodparam>
      <methodparam><type>string</type><parameter>map</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>yp_first</function> vrac prvn kl/hodnota pr dan mapy v dan
     domn, nebo &false;.
    </para>
    <para>
     <example>
      <title>Ukzka NIS first</title>
      <programlisting role="php">
&lt;?php
    $entry = yp_first($domain, "passwd.byname");
    $key = key($entry);
    echo "Prvn zznam v tto 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>Vrtit dal kl/hodnota pr mapy</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>array</type><methodname>yp_next</methodname>
      <methodparam><type>string</type><parameter>domain</parameter></methodparam>
      <methodparam><type>string</type><parameter>map</parameter></methodparam>
      <methodparam><type>string</type><parameter>key</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>yp_next</function> vrac dal kl/hodnota pr v map po danm
     kli, nebo &false;.
    </para>
    <para>
     <example>
      <title>Ukzka 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 "Poloka nsledujc 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>
     <methodsynopsis>
      <type>int</type><methodname>yp_errno</methodname>
      <void/>
     </methodsynopsis>
    <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>
     <methodsynopsis>
      <type>string</type><methodname>yp_err_string</methodname>
      <methodparam><type>void</type><parameter/></methodparam>
     </methodsynopsis>
    <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
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:
-->