luk Thu Jun 20 17:19:12 2002 EDT
Added files:
/phpdoc-cs/reference/network/functions socket-set-blocking.xml
socket-set-timeout.xml
syslog.xml
Log:
Index: phpdoc-cs/reference/network/functions/socket-set-blocking.xml
+++ phpdoc-cs/reference/network/functions/socket-set-blocking.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.2 Maintainer: luk Status: ready -->
<refentry id="function.socket-set-blocking">
<refnamediv>
<refname>socket_set_blocking</refname>
<refpurpose>Nastavuje blokující/neblokující režim socketu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<methodsynopsis>
<type>int</type><methodname>socket_set_blocking</methodname>
<methodparam><type>int</type><parameter>socket
descriptor</parameter></methodparam>
<methodparam><type>int</type><parameter>mode</parameter></methodparam>
</methodsynopsis>
<para>
Pokud má <parameter>mode</parameter> hodnotu &false;, příslušný deskriptor
socketu se přepne do neblokujícího režimu; je-li &true;, přepne se do
blokujícího režimu. To má vliv na volání jako je
<function>fgets</function>, která čtou ze socketu. V neblokujícím
režimu volání funkce <function>fgets</function> vždy předává řízení zpět,
zatímco v blokujícím režimu bude čekat na to, až budou na socketu dostupná
data.
</para>
<para>
Tato funkce se dříve jmenovala <function>set_socket_blocking</function>,
ale tento název je nyní zavržený.
</para>
</refsect1>
</refentry>
<!-- 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:
-->
Index: phpdoc-cs/reference/network/functions/socket-set-timeout.xml
+++ phpdoc-cs/reference/network/functions/socket-set-timeout.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.2 Maintainer: luk Status: ready -->
<refentry id="function.socket-set-timeout">
<refnamediv>
<refname>socket_set_timeout</refname>
<refpurpose>Nastaví časový limit (timeout) socketu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<methodsynopsis>
<type>bool</type><methodname>socket_set_timeout</methodname>
<methodparam><type>int</type><parameter>socket
descriptor</parameter></methodparam>
<methodparam><type>int</type><parameter>seconds</parameter></methodparam>
<methodparam><type>int</type><parameter>microseconds</parameter></methodparam>
</methodsynopsis>
<para>
Nastavuje velikost časového limitu socketu daného hodnotou
<parameter>socket descriptor</parameter>, ve formě součtu sekund
(<parameter>seconds</parameter>) a mikrosekund
(<parameter>microseconds</parameter>).
<example>
<title><function>socket_set_timeout</function> Příklad</title>
<programlisting role="php">
<![CDATA[
<?php
$fp = fsockopen("www.example.com", 80);
if(!$fp) {
echo "Nelze otevřít\n";
} else {
fputs($fp,"GET / HTTP/1.0\n\n");
$start = time();
socket_set_timeout($fp, 2);
$res = fread($fp, 2000);
var_dump(socket_get_status($fp));
fclose($fp);
print $res;
}
?>
]]>
</programlisting>
</example>
</para>
<para>
Tato funkce se dříve jmenovala <function>set_socket_timeout</function>,
ale tento název je nyní zavržený.
</para>
<para>
Viz také: <function>fsockopen</function> a <function>fopen</function>.
</para>
</refsect1>
</refentry>
<!-- 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:
-->
Index: phpdoc-cs/reference/network/functions/syslog.xml
+++ phpdoc-cs/reference/network/functions/syslog.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.2 Maintainer: luk Status: ready -->
<refentry id="function.syslog">
<refnamediv>
<refname>syslog</refname>
<refpurpose>Vygeneruje zprávu do systémového protokolu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<methodsynopsis>
<type>int</type><methodname>syslog</methodname>
<methodparam><type>int</type><parameter>priority</parameter></methodparam>
<methodparam><type>string</type><parameter>message</parameter></methodparam>
</methodsynopsis>
<para>
<function>syslog</function> vygeneruje zprávu do protokolu, která se
distribuuje prostřednictvím démona systémového protokolu.
<parameter>priority</parameter> představuje kombinaci charakteru a
úrovně zprávy; hodnoty popisuje následující sekce. Zbývající argument je
zpráva, která se má odeslat. Dva znaky ve zprávě (<literal>%m</literal>)
se však nahradí řetězcem chybové zprávy (strerror) odpovídající
aktuální hodnotě <errortype>errno</errortype>.
</para>
<para>
<table>
<title><function>syslog</function> Priority (v klesajícím pořádku)</title>
<tgroup cols="2">
<thead>
<row>
<entry>Konstanta</entry>
<entry>Popis</entry>
</row>
</thead>
<tbody>
<row>
<entry>LOG_EMERG</entry>
<entry>systém je nepoužitelný</entry>
</row>
<row>
<entry>LOG_ALERT</entry>
<entry>je nutný okamžitý zásah</entry>
</row>
<row>
<entry>LOG_CRIT</entry>
<entry>kritická situace</entry>
</row>
<row>
<entry>LOG_ERR</entry>
<entry>chyba</entry>
</row>
<row>
<entry>LOG_WARNING</entry>
<entry>varování</entry>
</row>
<row>
<entry>LOG_NOTICE</entry>
<entry>normální, avšak významná, zpráva</entry>
</row>
<row>
<entry>LOG_INFO</entry>
<entry>informativní zpráva</entry>
</row>
<row>
<entry>LOG_DEBUG</entry>
<entry>ladicí zpráva</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>
<example>
<title>Použití <function>syslog</function></title>
<programlisting role="php">
<![CDATA[
<?php
define_syslog_variables();
// otevře syslog, vloží ID procesu a odešle také na standardní chybový
// výstup; použije uživatelsky definovaný protokolovací mechanismus
openlog("myScripLog", LOG_PID | LOG_PERROR, LOG_LOCAL0);
// nějaký kód
if (authorized_client()) {
// něco udělej
} else {
// neautorizovaný klient!
// zaznamenej pokus o přístup
$access = date("Y/m/d H:i:s");
syslog(LOG_WARNING,"Neautorizovaný klient: $access $REMOTE_ADDR
($HTTP_USER_AGENT)");
}
closelog();
?>
]]>
</programlisting>
</example>
Více informací o nastavení uživatelské obsluhy protokolování -- viz
unixovou manuálovou stránku
<citerefentry><refentrytitle>syslog.conf</refentrytitle>
<manvolnum>5</manvolnum></citerefentry>. Více informací o možnostech
a volbách mechanismu syslog najdete (na unixových strojích) v manuálových
stránkách pro <citerefentry><refentrytitle>syslog</refentrytitle>
<manvolnum>3</manvolnum></citerefentry>.
</para>
<para>
Na Windows NT je služba syslog emulována pomocí služby Event Log.
</para>
<para>
Viz také <function>define_syslog_variables</function>,
<function>openlog</function> a
<function>closelog</function>.
</para>
</refsect1>
</refentry>
<!-- 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:
-->
