 |
 |
 |
 |
|
|
Date: 07/12/00
- Next message: Luca Perugini: "[PHP-DOC] cvs: phpdoc /it Translators"
- Previous message: Luca Perugini: "[PHP-DOC] cvs: phpdoc /it/functions mysql.xml"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
perugini Wed Jul 12 02:39:58 2000 EDT
Modified files:
/phpdoc/it/functions network.xml
Log:
Updated from english tree and start translation
Index: phpdoc/it/functions/network.xml
diff -u phpdoc/it/functions/network.xml:1.2 phpdoc/it/functions/network.xml:1.3
--- phpdoc/it/functions/network.xml:1.2 Sat Jun 24 00:38:44 2000
+++ phpdoc/it/functions/network.xml Wed Jul 12 02:39:58 2000
@@ -1,12 +1,14 @@
<reference id="ref.network">
- <title>Network functions</title>
+ <title>Network Functions</title>
<titleabbrev>Network</titleabbrev>
<refentry id="function.checkdnsrr">
<refnamediv>
<refname>checkdnsrr</refname>
- <refpurpose>Check DNS records corresponding to a given
- Internet host name or IP address.</refpurpose>
+ <refpurpose>
+ Check DNS records corresponding to a given Internet host name or
+ IP address
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -14,39 +16,39 @@
<funcprototype>
<funcdef>int <function>checkdnsrr</function></funcdef>
<paramdef>string <parameter>host</parameter></paramdef>
- <paramdef>string <parameter><optional>type</optional></parameter></paramdef>
+ <paramdef>string
+ <parameter><optional>type</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
-
<simpara>
Searches DNS for records of type <parameter>type</parameter>
corresponding to <parameter>host</parameter>. Returns true if any
records are found; returns false if no records were found or if
- an error occurred.</simpara>
-
+ an error occurred.
+ </simpara>
<simpara>
<parameter>type</parameter> may be any one of: A, MX, NS, SOA,
- PTR, CNAME, or ANY. The default is MX.</simpara>
-
+ PTR, CNAME, or ANY. The default is MX.
+ </simpara>
<simpara>
- <parameter>host</parameter> may either be the IP address in
- dotted-quad notation or the host name.</simpara>
-
+ <parameter>Host</parameter> may either be the IP address in
+ dotted-quad notation or the host name.
+ </simpara>
<simpara>
- See also
- <function>getmxrr</function>,
- <function>gethostbyaddr</function>,
- <function>gethostbyname</function>,
- <function>gethostbynamel</function>, and
- the named(8) manual page.</simpara>
-
+ See also <function>getmxrr</function>,
+ <function>gethostbyaddr</function>,
+ <function>gethostbyname</function>,
+ <function>gethostbynamel</function>, and the named(8) manual
+ page.
+ </simpara>
</refsect1>
</refentry>
<refentry id="function.closelog">
<refnamediv>
<refname>closelog</refname>
- <refpurpose>close connection to system logger</refpurpose>
+ <refpurpose>Close connection to system logger</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -57,16 +59,17 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>closelog</function> closes the descriptor being used to
+ <function>Closelog</function> closes the descriptor being used to
write to the system logger. The use of
- <function>closelog</function> is optional.</para>
+ <function>closelog</function> is optional.
+ </para>
</refsect1>
</refentry>
<refentry id="function.debugger-off">
<refnamediv>
<refname>debugger_off</refname>
- <refpurpose>disable internal PHP debugger</refpurpose>
+ <refpurpose>Disable internal PHP debugger</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -78,14 +81,15 @@
</funcsynopsis>
<para>
Disables the internal PHP debugger. The debugger is still under
- development.</para>
+ development.
+ </para>
</refsect1>
</refentry>
<refentry id="function.debugger-on">
<refnamediv>
<refname>debugger_on</refname>
- <refpurpose>enable internal PHP debugger</refpurpose>
+ <refpurpose>Enable internal PHP debugger</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -98,14 +102,17 @@
<para>
Enables the internal PHP debugger, connecting it to
<parameter>address</parameter>. The debugger is still under
- development.</para>
+ development.
+ </para>
</refsect1>
</refentry>
<refentry id="function.fsockopen">
<refnamediv>
<refname>fsockopen</refname>
- <refpurpose>Open Internet or Unix domain socket connection.</refpurpose>
+ <refpurpose>
+ Open Internet or Unix domain socket connection
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -114,72 +121,81 @@
<funcdef>int <function>fsockopen</function></funcdef>
<paramdef>string <parameter>hostname</parameter></paramdef>
<paramdef>int <parameter>port</parameter></paramdef>
- <paramdef>int <parameter><optional>errno</optional></parameter></paramdef>
- <paramdef>string <parameter><optional>errstr</optional></parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>errno</optional></parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter><optional>errstr</optional></parameter>
+ </paramdef>
<paramdef>double
- <parameter><optional>timeout</optional></parameter></paramdef>
+ <parameter><optional>timeout</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- Initiates a stream connection in the Internet (AF_INET) or Unix (AF_UNIX)
- domain. For the Internet domain, it will open a TCP socket connection to
- <parameter>hostname</parameter> on port <parameter>port</parameter>. For
- the Unix domain, <parameter>hostname</parameter> will be used as the path
- to the socket, <parameter>port</parameter> must be set to 0 in this case.
- The optional <parameter>timeout</parameter> can be used to set a timeout
- in seconds for the connect system call.</para>
-
+ Initiates a stream connection in the Internet (AF_INET) or Unix
+ (AF_UNIX) domain. For the Internet domain, it will open a TCP
+ socket connection to <parameter>hostname</parameter> on port
+ <parameter>port</parameter>. For the Unix domain,
+ <parameter>hostname</parameter> will be used as the path to the
+ socket, <parameter>port</parameter> must be set to 0 in this
+ case. The optional <parameter>timeout</parameter> can be used to
+ set a timeout in seconds for the connect system call.
+ </para>
<para>
- <function>fsockopen</function> returns a file pointer which may be used
- together with the other file functions (such as
+ <function>Fsockopen</function> returns a file pointer which may
+ be used together with the other file functions (such as
<function>fgets</function>, <function>fgetss</function>,
- <function>fputs</function>, <function>fclose</function>,
- <function>feof</function>).</para>
-
+ <function>fputs</function>, <function>fclose</function>, and
+ <function>feof</function>).
+ </para>
<para>
If the call fails, it will return false and if the optional
- <parameter>errno</parameter> and <parameter>errstr</parameter> arguments
- are present they will be set to indicate the actual system level error
- that occurred on the system-level connect() call. If the returned errno is
- 0 and the function returned false, it is an indication that the error
- occurred before the connect() call. This is most likely due to a problem
- initializing the socket. Note that the errno and errstr arguments must be
- passed by reference.</para>
-
- <para>
- Depending on the environment, the Unix domain or the optional connect
- timeout may not be available.</para>
-
- <para>
- The socket will by default be opened in blocking mode. You can switch it
- to non-blocking mode by using <function>set_socket_blocking</function>.
- <example>
- <title>fsockopen example</title>
- <programlisting>
-$fp = fsockopen("www.php.net", 80, &$errno, &$errstr, 30);
-if(!$fp) {
- echo "$errstr ($errno)<br>\n";
+ <parameter>errno</parameter> and <parameter>errstr</parameter>
+ arguments are present they will be set to indicate the actual
+ system level error that occurred on the system-level
+ <literal>connect()</literal> call. If the returned errno is 0 and
+ the function returned false, it is an indication that the error
+ occurred before the <literal>connect()</literal> call. This is
+ most likely due to a problem initializing the socket. Note that
+ the <parameter>errno</parameter> and
+ <parameter>errstr</parameter> arguments must be passed by
+ reference.
+ </para>
+ <para>
+ Depending on the environment, the Unix domain or the optional
+ connect timeout may not be available.
+ </para>
+ <para>
+ The socket will by default be opened in blocking mode. You can
+ switch it to non-blocking mode by using
+ <function><function>Set_socket_blocking</function></function>.
+ <example>
+ <title><function>Fsockopen</function> Example</title>
+ <programlisting role="php">
+$fp = fsockopen ("www.php.net", 80, &$errno, &$errstr, 30);
+if (!$fp) {
+ echo "$errstr ($errno)<br>\n";
} else {
- fputs($fp,"GET / HTTP/1.0\n\n");
- while(!feof($fp)) {
- echo fgets($fp,128);
- }
- fclose($fp);
+ fputs ($fp, "GET / HTTP/1.0\n\n");
+ while (!feof($fp)) {
+ echo fgets ($fp,128);
+ }
+ fclose ($fp);
}
- </programlisting>
- </example>
-
- See also: <function>pfsockopen</function></para>
-
+ </programlisting>
+ </example>
+ See also: <function>pfsockopen</function>
+ </para>
</refsect1>
</refentry>
-
+
<refentry id="function.gethostbyaddr">
<refnamediv>
<refname>gethostbyaddr</refname>
- <refpurpose>Get the Internet host name corresponding to a given
- IP address.</refpurpose>
+ <refpurpose>
+ Get the Internet host name corresponding to a given IP address
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -189,23 +205,23 @@
<paramdef>string <parameter>ip_address</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
Returns the host name of the Internet host specified by
<parameter>ip_address</parameter>. If an error occurs, returns
- <parameter>ip_address</parameter>.</para>
-
- <para>
- See also <function>gethostbyname</function>.</para>
-
+ <parameter>ip_address</parameter>.
+ </para>
+ <para>
+ See also <function>gethostbyname</function>.
+ </para>
</refsect1>
</refentry>
<refentry id="function.gethostbyname">
<refnamediv>
<refname>gethostbyname</refname>
- <refpurpose>Get the IP address corresponding to a given
- Internet host name.</refpurpose>
+ <refpurpose>
+ Get the IP address corresponding to a given Internet host name
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -215,22 +231,23 @@
<paramdef>string <parameter>hostname</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
Returns the IP address of the Internet host specified by
- <parameter>hostname</parameter>.</para>
-
- <para>
- See also <function>gethostbyaddr</function>.</para>
-
+ <parameter>hostname</parameter>.
+ </para>
+ <para>
+ See also <function>gethostbyaddr</function>.
+ </para>
</refsect1>
</refentry>
<refentry id="function.gethostbynamel">
<refnamediv>
<refname>gethostbynamel</refname>
- <refpurpose>Get a list of IP addresses corresponding to a given
- Internet host name.</refpurpose>
+ <refpurpose>
+ Get a list of IP addresses corresponding to a given Internet host
+ name
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -240,27 +257,25 @@
<paramdef>string <parameter>hostname</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
Returns a list of IP addresses to which the Internet host
- specified by <parameter>hostname</parameter> resolves.</para>
-
+ specified by <parameter>hostname</parameter> resolves.
+ </para>
<para>
- See also
- <function>gethostbyname</function>,
- <function>gethostbyaddr</function>,
- <function>checkdnsrr</function>,
- <function>getmxrr</function>, and
- the named(8) manual page.</para>
-
+ See also <function>gethostbyname</function>,
+ <function>gethostbyaddr</function>,
+ <function>checkdnsrr</function>, <function>getmxrr</function>,
+ and the <literal>named(8)</literal> manual page.
+ </para>
</refsect1>
</refentry>
<refentry id="function.getmxrr">
<refnamediv>
<refname>getmxrr</refname>
- <refpurpose>Get MX records corresponding to a given
- Internet host name.</refpurpose>
+ <refpurpose>
+ Get MX records corresponding to a given Internet host name
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -269,36 +284,39 @@
<funcdef>int <function>getmxrr</function></funcdef>
<paramdef>string <parameter>hostname</parameter></paramdef>
<paramdef>array <parameter>mxhosts</parameter></paramdef>
- <paramdef>array <parameter><optional>weight</optional></parameter></paramdef>
+ <paramdef>array
+ <parameter><optional>weight</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
-
<simpara>
Searches DNS for MX records corresponding to
<parameter>hostname</parameter>. Returns true if any records are
- found; returns false if no records were found or if an error occurred.</simpara>
-
+ found; returns false if no records were found or if an error
+ occurred.
+ </simpara>
<simpara>
A list of the MX records found is placed into the array
<parameter>mxhosts</parameter>. If the
<parameter>weight</parameter> array is given, it will be filled
- with the weight information gathered.</simpara>
-
+ with the weight information gathered.
+ </simpara>
<simpara>
- See also
- <function>checkdnsrr</function>,
+ See also <function>checkdnsrr</function>,
<function>gethostbyname</function>,
<function>gethostbynamel</function>,
- <function>gethostbyaddr</function>, and
- the named(8) manual page.</simpara>
-
+ <function>gethostbyaddr</function>, and the
+ <literal>named(8)</literal> manual page.
+ </simpara>
</refsect1>
</refentry>
<refentry id="function.getprotobyname">
<refnamediv>
<refname>getprotobyname</refname>
- <refpurpose>get protocol number associated with protocol name</refpurpose>
+ <refpurpose>
+ Get protocol number associated with protocol name
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -308,20 +326,23 @@
<paramdef>string <parameter>name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>getprotobyname</function> returns the protocol number
+ <function>Getprotobyname</function> returns the protocol number
associated with the protocol <parameter>name</parameter> as per
/etc/protocols.
-
- See also <function>getprotobynumber</function>.</para>
+ </para>
+ <para>
+ See also: <function>getprotobynumber</function>.
+ </para>
</refsect1>
</refentry>
<refentry id="function.getprotobynumber">
<refnamediv>
<refname>getprotobynumber</refname>
- <refpurpose>get protocol name associated with protocol number</refpurpose>
+ <refpurpose>
+ Get protocol name associated with protocol number
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -331,20 +352,23 @@
<paramdef>int <parameter>number</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>getprotobynumber</function> returns the protocol name
+ <function>Getprotobynumber</function> returns the protocol name
associated with protocol <parameter>number</parameter> as per
/etc/protocols.
-
- See also <function>getprotobyname</function>.</para>
+ </para>
+ <para>
+ See also: <function>getprotobyname</function>.
+ </para>
</refsect1>
</refentry>
<refentry id="function.getservbyname">
<refnamediv>
<refname>getservbyname</refname>
- <refpurpose>get port number associated with an Internet service and protocol</refpurpose>
+ <refpurpose>
+ Get port number associated with an Internet service and protocol
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -355,22 +379,26 @@
<paramdef>string <parameter>protocol</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>getservbyname</function> returns the Internet port which
- corresponds to <parameter>service</parameter> for the specified
- <parameter>protocol</parameter> as per /etc/services.
- <parameter>protocol</parameter> is either <literal>tcp</literal> or
- <literal>udp</literal>.
-
- See also <function>getservbyport</function>.</para>
+ <function>Getservbyname</function> returns the Internet port
+ which corresponds to <parameter>service</parameter> for the
+ specified <parameter>protocol</parameter> as per
+ <filename>/etc/services</filename>.
+ <parameter>protocol</parameter> is either <literal>TCP</literal>
+ or <literal>UDP</literal>.
+ </para>
+ <para>
+ See also: <function>getservbyport</function>.
+ </para>
</refsect1>
</refentry>
<refentry id="function.getservbyport">
<refnamediv>
<refname>getservbyport</refname>
- <refpurpose>get Internet service which corresponds to port and protocol</refpurpose>
+ <refpurpose>
+ Get Internet service which corresponds to port and protocol
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -381,22 +409,23 @@
<paramdef>string <parameter>protocol</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>getservbyport</function> returns the Internet service
- associated with <parameter>port</parameter> for the specified
- <parameter>protocol</parameter> as per /etc/services.
- <parameter>protocol</parameter> is either <literal>tcp</literal> or
- <literal>udp</literal>.
-
- See also <function>getservbyname</function>.</para>
+ <function>Getservbyport</function> returns the Internet service
+ associated with <parameter>port</parameter> for the specified
+ <parameter>protocol</parameter> as per /etc/services.
+ <parameter>protocol</parameter> is either <literal>TCP</literal>
+ or <literal>UDP</literal>.
+ </para>
+ <para>
+ See also: <function>getservbyname</function>.
+ </para>
</refsect1>
</refentry>
<refentry id="function.openlog">
<refnamediv>
<refname>openlog</refname>
- <refpurpose>open connection to system logger</refpurpose>
+ <refpurpose>Open connection to system logger</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -408,25 +437,29 @@
<paramdef>int <parameter>facility</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>openlog</function> opens a connection to the system
+ <function>Openlog</function> opens a connection to the system
logger for a program. The string <parameter>ident</parameter> is
added to each message. Values for <parameter>option</parameter>
and <parameter>facility</parameter> are given in the next
- section. The use of openlog() is optional; It will automatically
- be called by <function>syslog</function> if necessary, in which
- case ident will default to <literal>false</literal>.
-
+ section. The use of <function>openlog</function> is optional; It
+ will automatically be called by <function>syslog</function> if
+ necessary, in which case <parameter>ident</parameter> will default
+ to false.
+ </para>
+ <para>
See also <function>syslog</function> and
- <function>closelog</function>.</para>
+ <function>closelog</function>.
+ </para>
</refsect1>
</refentry>
<refentry id="function.pfsockopen">
<refnamediv>
<refname>pfsockopen</refname>
- <refpurpose>Open persistent Internet or Unix domain socket connection.</refpurpose>
+ <refpurpose>
+ Open persistent Internet or Unix domain socket connection
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -435,17 +468,23 @@
<funcdef>int <function>pfsockopen</function></funcdef>
<paramdef>string <parameter>hostname</parameter></paramdef>
<paramdef>int <parameter>port</parameter></paramdef>
- <paramdef>int <parameter><optional>errno</optional></parameter></paramdef>
- <paramdef>string <parameter><optional>errstr</optional></parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>errno</optional></parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter><optional>errstr</optional></parameter>
+ </paramdef>
<paramdef>int
- <parameter><optional>timeout</optional></parameter></paramdef>
+ <parameter><optional>timeout</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- This function behaves exactly as <function>fsockopen</function> with the
- difference that the connection is not closed after the script finishes.
- It is the persistent version of <function>fsockopen</function>.</para>
+ This function behaves exactly as <function>fsockopen</function>
+ with the difference that the connection is not closed after the
+ script finishes. It is the persistent version of
+ <function>fsockopen</function>.
+ </para>
</refsect1>
</refentry>
@@ -468,17 +507,17 @@
descriptor will be switched to non-blocking mode, and if true, it
will be switched to blocking mode. This affects calls like
<function>fgets</function> that read from the socket. In
- non-blocking mode an fgets() call will always return right away
- while in blocking mode it will wait for data to become available
- on the socket.</para>
-
+ non-blocking mode an <function>fgets</function> call will always
+ return right away while in blocking mode it will wait for data to
+ become available on the socket.
+ </para>
</refsect1>
</refentry>
<refentry id="function.syslog">
<refnamediv>
<refname>syslog</refname>
- <refpurpose>generate a system log message</refpurpose>
+ <refpurpose>Generate a system log message</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -490,24 +529,28 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>syslog</function> generates a log message that will be
+ <function>Syslog</function> generates a log message that will be
distributed by the system logger.
<parameter>priority</parameter> is a combination of the facility
and the level, values for which are given in the next section.
The remaining argument is the message to send, except that the
two characters <literal>%m</literal> will be replaced by the
error message string (strerror) corresponding to the present
- value of <errortype>errno</errortype>.</para>
+ value of <errortype>errno</errortype>.
+ </para>
<para>
- More information on the syslog facilities can be found in
- the man pages for syslog on Unix machines.</para>
- <para>
- On Windows NT, the syslog service is emulated using the
- Event Log.</para>
+ More information on the syslog facilities can be found in the man
+ pages for syslog on Unix machines.
+ </para>
+ <para>
+ On Windows NT, the syslog service is emulated using the Event
+ Log.
+ </para>
</refsect1>
</refentry>
</reference>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -518,7 +561,7 @@
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
- Next message: Luca Perugini: "[PHP-DOC] cvs: phpdoc /it Translators"
- Previous message: Luca Perugini: "[PHP-DOC] cvs: phpdoc /it/functions mysql.xml"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]