sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-16 00:48:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Two functions doesn't exist.

Browse source 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@19072 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Egon Schmid 2000-02-01 21:26:38 +00:00
parent 764683bbdd
commit 01c3cad9c9
1 changed files with 94 additions and 86 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

180
functions/nis.xml
View file

@ -6,13 +6,14 @@
<para>
NIS (formerly called Yellow Pages) allows network management of
important administrative files (e.g. the password file). For more
information refer to the NIS manpage and <ulink url="http://www.desy.de/~sieversm/ypdoku/ypdoku/ypdoku.html">
Introduction to YP/NIS</ulink>. There is also a book called <ulink url="http://www.oreilly.com/catalog/nfs/noframes.html">Managing
NFS and NIS</ulink> by Hal Stern.</para>
information refer to the NIS manpage and <ulink url="&url.nis;">
Introduction to YP/NIS</ulink>. There is also a book called <ulink
url="&url.nis.book;">Managing NFS and NIS</ulink> by Hal Stern.
</para>
<para>
To get these functions to work, you have to configure PHP with
<option role="configure">--with-yp</option>.</para>
<option role="configure">--with-yp</option>.
</para>
</partintro>
<refentry id="function.yp-get-default-domain">
@ -26,37 +27,34 @@
<funcdef>int <function>yp_get_default_domain</function></funcdef>
<paramdef>void <parameter></parameter></paramdef>
</funcsynopsis>
<para>
<function>yp_get_default_domain</function> returns the default
domain of the node or FALSE. Can be used as the domain parameter
for successive NIS calls.</para>
for successive NIS calls.
</para>
<para>
A NIS domain can be described a group of NIS maps. Every host
that needs to look up information binds itself to a certain
domain. Refer to the documents mentioned at the beginning for
more detailed information.</para>
more detailed information.
</para>
<para>
<example>
<title>Example for the default domain</title>
<programlisting role="php">
&lt;?php
$domain = yp_get_default_domain();
if(!$domain) {
echo yp_errno() . ": " . yp_err_string();
}
echo "Default NIS domain is: " . $domain;
?>
</programlisting>
</example></para>
</example>
</para>
<!--
<para>
See also: <link linkend="function.yp-errno">yp_errno</link> and
<link linkend="function.yp-err-string">yp_err_string</link></para>
<link linkend="function.yp-err-string">yp_err_string</link>
</para>
-->
</refsect1>
</refentry>
@ -72,30 +70,28 @@
<paramdef>string <parameter>domain</parameter></paramdef>
<paramdef>string <parameter>map</parameter></paramdef>
</funcsynopsis>
<para>
<function>yp_order</function> returns the order number for a map
or FALSE.</para>
or FALSE.
</para>
<para>
<example>
<title>Example for the NIS order</title>
<programlisting role="php">
&lt;?php
$number = yp_order($domain,$mapname);
if(!$number) {
echo yp_errno() . ": " . yp_err_string();
}
echo "Order number for this map is: " . $order;
?>
</programlisting>
</example></para>
</example>
</para>
<para>
See also: <link linkend="function.yp-get-default-domain">
yp_get_default_domain</link> <link linkend="function.yp-errno">yp_errno</link> and <link linkend="function.yp-err-string">yp_err_string</link></para>
See also <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>
@ -114,30 +110,29 @@
</funcsynopsis>
<para>
<function>yp_master</function> returns the machine name of
the master NIS server for a map.</para>
the master NIS server for a map.
</para>
<para>
<example>
<title>Example for the NIS master</title>
<programlisting role="php">
&lt;?php
$number = yp_master($domain, $mapname);
if(!$number) {
echo yp_errno() . ": " . yp_err_string();
}
echo "Master for this map is: " . $master;
?>
</programlisting>
</example></para>
</example>
</para>
<para>
See also: <link linkend="function.yp-get-default-domain">
yp_get_default_domain</link> <link linkend="function.yp-errno">yp_errno</link> and <link linkend="function.yp-err-string">yp_err_string</link></para>
</refsect1>
See also <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>
@ -161,27 +156,25 @@
<programlisting role="php">
&lt;?php
$entry = yp_match($domain, "passwd.byname", "joe");
if(!$entry) {
echo yp_errno() . ": " . yp_err_string();
}
echo "Matched entry is: " . $entry;
?>
</programlisting>
</example></para>
</example>
</para>
<para>
In this case this could be: joe:##joe:11111:100:Joe
User:/home/j/joe:/usr/local/bin/bash</para>
User:/home/j/joe:/usr/local/bin/bash
</para>
<para>
See also: <link linkend="function.yp-get-default-domain">
yp_get_default_domain</link> <link linkend="function.yp-errno">yp_errno</link> and <link linkend="function.yp-err-string">yp_err_string</link></para>
See also <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>
@ -195,33 +188,30 @@
<paramdef>string <parameter>domain</parameter></paramdef>
<paramdef>string <parameter>map</parameter></paramdef>
</funcsynopsis>
<para>
<function>yp_first</function> returns the first key-value
pair from the named map in the named domain, otherwise FALSE.</para>
pair from the named map in the named domain, otherwise FALSE.
</para>
<para>
<example>
<title>Example for the NIS first</title>
<programlisting role="php">
&lt;?php
$entry = yp_first($domain, "passwd.byname");
if(!$entry) {
echo yp_errno() . ": " . yp_err_string();
}
$key = key($entry);
echo "First entry in this map has key " . $key
. " and value " . $entry[$key];
?>
</programlisting>
</example></para>
</example>
</para>
<para>
See also: <link linkend="function.yp-get-default-domain">
yp_get_default_domain</link> <link linkend="function.yp-errno">yp_errno</link> and <link linkend="function.yp-err-string">yp_err_string</link></para>
See also <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>
@ -241,8 +231,8 @@
</funcsynopsis>
<para>
<function>yp_next</function> returns the next key-value pair in
the named map after the specified key or FALSE.</para>
the named map after the specified key or FALSE.
</para>
<para>
<example>
<title>Example for NIS next</title>
@ -260,13 +250,19 @@
. " and value " . $entry[$key];
?>
</programlisting>
</example></para>
</example>
</para>
<para>
See also: <link linkend="function.yp-get-default-domain">
yp_get_default_domain</link>, <link linkend="function.yp-errno">yp_errno</link> and <link linkend="function.yp-err-string">yp_err_string</link></para>
See also <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>
@ -281,9 +277,11 @@
</funcsynopsis>
<para>
<function>yp_errno</function> returns the error code of the
previous operation.</para>
previous operation.
</para>
<para>
Possible errors are:</para>
Possible errors are:
</para>
<para>
<simplelist>
<member>1 args to function are bad</member>
@ -302,18 +300,26 @@
<member>14 yp version mismatch</member>
<member>15 access violation</member>
<member>16 database busy</member>
</simplelist></para>
</simplelist>
</para>
<para>
See also: <link linkend="function.yp-err-string">
yp_err_string</link></para>
yp_err_string</link>
</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>
<refname>yp_err_string</refname>
<refpurpose>
Returns the error string associated with the previous
operation.
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@ -321,12 +327,11 @@
<funcdef>string <function>yp_err_string</function></funcdef>
<paramdef>void <parameter></parameter></paramdef>
</funcsynopsis>
<para>
<function>yp_err_string</function> returns the error message
associated with the previous operation. Useful to indicate what
exactly went wrong.</para>
exactly went wrong.
</para>
<para>
<example>
<title>Example for NIS errors</title>
@ -337,10 +342,13 @@
</programlisting>
</example></para>
<para>
See also: <link linkend="function.yp-errno"> yp_errno</link></para>
See also: <link linkend="function.yp-errno"> yp_errno</link>
</para>
</refsect1>
</refentry>
-->
</reference>
<!-- Keep this comment at the end of the file
@ -353,7 +361,7 @@ sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../manual.ced"
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil