<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
  <reference id="ref.nis">
  <title>NIS</title>
  <titleabbrev>NIS</titleabbrev>
  <partintro>
   <para>
    NIS (feu Yellow Pages / Pages jaunes) permet la gestion par le
    r&eacute;seau de fichiers d'administration importants (tel un
    fichier de mot de passe). Pour plus d'informations, reportez
    vous au manuel NIS, ou &agrave;
    <ulink url="&url.nis;">Introduction to YP/NIS</ulink>Introduction to YP/NIS
    (en anglais). Il existe un livre en anglais
    <ulink url="&url.nis.book;">Managing NFS and NIS</ulink>" par Hal Stern.
   </para>
   <para>
    Pour ajouter ces fonctionnalit&eacute;es, vous devez compiler PHP
    avec l'option <link linkend="install.configure.with-yp"><option role="configure">--with-yp</option></link>
    (PHP 3) ou <link linkend="install.configure.enable-yp"><option role="configure">--enable-yp</option></link>
    (PHP 4).
   </para>
  </partintro>
  <refentry id="function.yp-get-default-domain">
   <refnamediv>
    <refname>yp_get_default_domain</refname>
    <refpurpose>Retourne le domaine NIS par d&eacute;faut.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>yp_get_default_domain</methodname>
      <void/>
     </methodsynopsis>
    <para>
     <function>yp_get_default_domain</function> retourne le nom de domaine NIS
     par d&eacute;faut. Ce nom de domaine peut &ecirc;tre utilis&eacute; pour
     les futurs appels NIS.
    </para>
    <para>
     Un domaine NIS peut &ecirc;tre d&eacute;crit comme un regroupement
     de cartes NIS. Tous les h&ocirc;tes qui ont besoin d'informations,
     s'attachent &agrave; un domaine. R&eacute;f&eacute;rez-vous aux documents
     cit&eacute;s en d&eacute;but de document pour plus de d&eacute;tails.
    </para>
    <para>
     <example>
      <title>Exemple avec le domaine par d&eacute;faut</title>
      <programlisting role="php">
&lt;?php
    $domain = yp_get_default_domain();
    echo "Le domaine par d&eacute;faut est : " . $domain;
?&gt;
      </programlisting>
     </example>
    </para>
<!--
    <para>
     Voir aussi
     <link linkend="function.yp-errno">yp_errno</link> et
     <link linkend="function.yp-err-string">yp_err_string</link>.
    </para>
-->
   </refsect1>
  </refentry>
  <refentry id="function.yp-order">
   <refnamediv>
    <refname>yp_order</refname>
    <refpurpose>Retourne le num&eacute;ro d'ordre d'une carte.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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> retourne le num&eacute;ro d'ordre d'une
     carte ou &false;.
    </para>
    <para>
     <example>
      <title>Exemple d'ordre NIS </title>
      <programlisting role="php">
&lt;?php
$number = yp_order($domain,$mapname);
echo "Le num&eacute;ro d'ordre de cette carte est : " . $number;
?&gt;
      </programlisting>
     </example>
    </para>
    <para>
     Voir aussi 
     <function>yp-get-default-domain</function>.
<!--
     linkend="function.yp-errno">yp_errno</link> et <link
     linkend="function.yp-err-string">yp_err_string</link>
-->
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.yp-master">
   <refnamediv>
    <refname>yp_master</refname>
    <refpurpose>
     Retourne le nom de la machine ma&icirc;tre pour une carte.
   </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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> retourne le nom de la machine ma&icirc;tre
     d'une carte.
    </para>
    <para>
     <example>
      <title>Exemple de ma&icirc;tre NIS</title>
      <programlisting role="php">
&lt;?php
    $number = yp_master($domain, $mapname);
    echo "Master for this map is: " . $master;
?&gt;
      </programlisting>
     </example>
    </para>
    <para>
     Voir aussi 
     <function>yp-get-default-domain</function>.
<!--
     linkend="function.yp-errno">yp_errno</link> et <link
     linkend="function.yp-err-string">yp_err_string</link>
-->
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.yp-match">
   <refnamediv>
    <refname>yp_match</refname>
    <refpurpose>Retourne la ligne associ&eacute;e.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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> retourne la valeur associ&eacute;e
     &agrave; la cl&eacute; pass&eacute;e en argument, pour la carte
     sp&eacute;cifi&eacute;e, ou &false;. La cl&eacute; doit exister et
     &ecirc;tre exacte.
    </para>
    <para>
     <example>
      <title>Exemple de recherche NIS </title>
      <programlisting role="php">
&lt;?php
    $entry = yp_match($domain, "passwd.byname", "joe");
    echo "La valeur trouv&eacute;e est: " . $entry;
?&gt;
      </programlisting>
     </example>
    </para>
    <para>
      Dans le cas pr&eacute;sent, ce pourrait &ecirc;tre:
      joe:##joe:11111:100:Joe User:/home/j/joe:/usr/local/bin/bash
    </para>
    <para>
     Voir aussi 
     <function>yp-get-default-domain</function>.
<!--
     linkend="function.yp-errno">yp_errno</link> et <link
     linkend="function.yp-err-string">yp_err_string</link>
-->
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.yp-first">
   <refnamediv>
    <refname>yp_first</refname>
    <refpurpose>
     Retourne le premier couple (cl&eacute; ; valeur) d'une carte donn&eacute;e.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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> retourne le premier couple
     (cl&eacute; ; valeur) d'une carte donn&eacute;e, ou &false;.
    </para>
    <para>
     <example>
      <title>Exemple avec <function>yp_first</function></title>
      <programlisting role="php">
&lt;?php
$entree = yp_first($domain, "passwd.byname");
$cle = $entry ["key"];
$valeur = $entry ["value"];
echo "La premi&egrave;re entr&eacute;e de cette carte est " . $key
     . " et sa valeur est " . $entry[$key];
?&gt;
      </programlisting>
     </example>
    </para>
    <para>
     Voir aussi 
     <function>yp-get-default-domain</function>.
<!--
     <link linkend="function.yp-errno">yp_errno</link> et <link
     linkend="function.yp-err-string">yp_err_string</link>
-->
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.yp-next">
   <refnamediv>
    <refname>yp_next</refname>
    <refpurpose>
     Retourne le couple (cl&eacute; ; valeur) suivant d'une carte donn&eacute;e.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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> retourne le couple (cl&eacute; ; valeur)
     suivant la cl&eacute; donn&eacute;e d'une carte donn&eacute;e ou &false;.
    </para>
    <para>
     <example>
      <title>Exemple avec <function>yp_next</function></title>
      <programlisting role="php">
&lt;?php
    $entry = yp_next($domain, "passwd.byname", "joe");
    if(!$entry) {
		echo "Plus d'autres entr&eacute;es.\n";
    <!-- echo yp_errno() . ": " . yp_err_string(); -->    }
    $key = key($entry);
    echo "L'entr&eacute;e suivante apr&egrave;s "joe" a la cl&eacute; " . $key
          . " et la valeur " . $entry[$key];
?&gt;
      </programlisting>
     </example>
    </para>
    <para>
     Voir aussi 
     <function>yp-get-default-domain</function>.
<!--
     <link linkend="function.yp-errno">yp_errno</link> et <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>Retourne le code d'erreur de la derni&egrave;re op&eacute;ration.
      </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>yp_errno</methodname>
      <void/>
     </methodsynopsis>
    <para>
     <function>yp_errno</function> retourne le code d'erreur de la
     derni&egrave;re op&eacute;ration.
    </para>
    <para>
     Les erreurs possibles sont :
    </para>
    <para>
     <simplelist>
      <member>1 Mauvais arguments</member>
      <member>2 Erreur RPC - Le domaine n'existe pas</member>
      <member>3 Impossible de se connecter &agrave; ce domaine</member>
      <member>4 Impossible de trouver cette carte sur le serveur </member>
      <member>5 Cette cl&eacute; n'existe pas</member>
      <member>6 Erreur yp interne ou erreur client </member>
      <member>7 Erreur d'allocation de ressources</member>
      <member>8 Il n'y a plus d'enregistrements dans cette carte</member>
      <member>9 Impossible de communiquer avec le portmapper</member>
      <member>10 Impossible de communiquer avec ypbind</member>
      <member>11 Impossible de communiquer avec ypserv</member>
      <member>12 Le nom de domaine local n'est pas assign&eacute;</member>
      <member>13 La base de donn&eacute;es yp n'est pas valide</member>
      <member>14 Erreur de version yp </member>
      <member>15 Acc&egrave;s interdit</member>
      <member>16 Base de donn&eacute;es occup&eacute;e</member>
     </simplelist>
    </para>
    <para>
     Voir aussi
     <link linkend="function.yp-err-string">yp_err_string</link>.
    </para>
   </refsect1>
  </refentry>
-->
<!-- Function doesn't exist
  <refentry id="function.yp-err-string">
   <refnamediv>
   <refname>yp_err_string</refname>
   <refpurpose>
    Retourne la cha&icirc;ne d'erreur associ&eacute;e &agrave; la derni&egrave;re op&eacute;ration.
   </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>string</type><methodname>yp_err_string</methodname>
      <methodparam><type>void</type><parameter/></methodparam>
     </methodsynopsis>
    <para>
     <function>yp_err_string</function> Retourne la cha&icirc;ne d'erreur
     associ&eacute;e &agrave; la derni&egrave;re op&eacute;ration. Tr&egrave;s
     pratique pour savoir exactement ce qui n'est pas all&eacute;.
    </para>
    <para>
     <example>
      <title>Exemple</title>
      <programlisting role="php">
&lt;?php
    echo "Error: " . yp_err_string();
?&gt;
      </programlisting>
     </example>
    </para>
    <para>
     Voir aussi
     <link linkend="function.yp-errno"> yp_errno</link>.
    </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:
-->