goba Mon Aug 20 05:50:52 2001 EDT Modified files: /phpdoc/hu/functions network.xml Log: New translation, received from Heilig Szabolcs, with an actual revision number :)
Index: phpdoc/hu/functions/network.xml diff -u /dev/null phpdoc/hu/functions/network.xml:1.4 --- /dev/null Mon Aug 20 05:50:52 2001 +++ phpdoc/hu/functions/network.xml Mon Aug 20 05:50:52 2001 @@ -0,0 +1,1052 @@ +<?xml encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> +<reference id="ref.network"> + <title>Hálózatkezelési Függvények</title> + <titleabbrev>Hálózat</titleabbrev> + + <refentry id="function.checkdnsrr"> + <refnamediv> + <refname>checkdnsrr</refname> + <refpurpose> + Adott Internet domainnév vagy IP címnek megfelelő bejegyzés létének + vizsgálata a DNS rekordokban + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>checkdnsrr</function></funcdef> + <paramdef>string <parameter>host</parameter></paramdef> + <paramdef>string + <parameter><optional>típus</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + Keresést kér a névszervertől, a <parameter>típus</parameter> + paraméterben megadott típusú rekordokban, a <parameter>host</parameter> + paraméternek megfelelő bejegyzésekre. A visszatérési érték &true; + lesz, amennyiben volt találat. Ha nem volt találat, avagy hiba + merült fel a művelet során, a visszatérési érték &false; lesz. + </simpara> + <simpara> + A <parameter>típus</parameter> paraméter a következők közül választható: + A, MX, NS, SOA, PTR, CNAME, vagy ANY. Az alapértelmezés az MX. + </simpara> + <simpara> + A keresett <parameter>host</parameter> lehet IP cím és domainnév is. + </simpara> + <simpara> + A <function>checkdnsrr</function> függvény windows + alatt nem használható. + </simpara> + <simpara> + Lásd még: <function>getmxrr</function>, + <function>gethostbyaddr</function>, + <function>gethostbyname</function>, + <function>gethostbynamel</function>, valamint a man + <literal>named(8)</literal> oldala. + </simpara> + </refsect1> + </refentry> + + <refentry id="function.closelog"> + <refnamediv> + <refname>closelog</refname> + <refpurpose>Syslog (rendszer napló) kapcsolat zárása</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>closelog</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> + <para> + A <function>closelog</function> függvény zárja a rendszer naplózóval + való kapcsolatot. A függvény használata opcionális. + </para> + <para> + Lásd még: <function>define_syslog_variables</function>, + <function>syslog</function> és + <function>openlog</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.debugger-off"> + <refnamediv> + <refname>debugger_off</refname> + <refpurpose>A beépített PHP debugger letiltása</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>debugger_off</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> + <para> + Letiltja beépített PHP debuggert (hibakeresőt). A debugger + jelen pillanatban is fejlesztés alatt áll. + </para> + </refsect1> + </refentry> + + <refentry id="function.debugger-on"> + <refnamediv> + <refname>debugger_on</refname> + <refpurpose>A beépített PHP debugger engedélyezése</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>debugger_on</function></funcdef> + <paramdef>string <parameter>address</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Engedélyezi a beépített PHP debugger működését, az a + <parameter>address</parameter> paraméterben megadott + címhez kapcsolódik. A debugger jelen pillanatban is + fejlesztés alatt áll. + </para> + </refsect1> + </refentry> + + <refentry id="function.define-syslog-variables"> + <refnamediv> + <refname>define_syslog_variables</refname> + <refpurpose>A rendszer naplózóval kapcsolatos konstansok +inicializálása</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>define_syslog_variables</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> + <para> + Minden konstanst újrainicializál, aminek csak köze van a syslog + függvényekhez. + </para> + <para> + Lásd még: <function>openlog</function>, + <function>syslog</function> és + <function>closelog</function>. + </para> + </refsect1> + </refentry> + + + <refentry id="function.fsockopen"> + <refnamediv> + <refname>fsockopen</refname> + <refpurpose> + Internet vagy Unix domain socket megnyitása + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fsockopen</function></funcdef> + <paramdef> + string <parameter><optional>udp://</optional>hostnév</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>double + <parameter><optional>timeout</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Stream típusú kapcsolatot kezdeményez egy Internet (AF_INET, + TCP vagy UDP protokollal) vagy Unix (AF_UNIX) domain felé. + Internet domain megadása esetén TCP kapcsolatot nyit a + <parameter>hostnév</parameter> paraméterben megadott géppel, + a <parameter>port</parameter> paraméterben megadott porton. + Ez esetben a <parameter>hostnév</parameter> lehet domainnév vagy + IP cím is. + UDP kapcsolat esetén explicit meg kell adni a protokolt a + <parameter>hostnév</parameter> paraméterben, a következő + módon: <parameter>udp://hostnév</parameter>. + Unix domain esetén a <parameter>hostnév</parameter> paraméternek + kell tartalmaznia a socket elérési útját, ekkor a + <parameter>port</parameter> értékének nullának kell lennie. + A <parameter>timeout</parameter> paraméter opcionális, + értéke másodpercekben megadandó. + </para> + <para> + A <function>fsockopen</function> függvény egy fájl-azonosítót + af vissza, ami a rendes fájlkezelő parancsokkal együtt használható + átlátszó módon. Ezek a következőek: + <function>fgets</function>, <function>fgetss</function>, + <function>fputs</function>, <function>fclose</function>, és + <function>feof</function>). + </para> + <para> + Ha a kapcsolatfelvétel meghiúsul, a visszatérési érték &false; lesz, + és amennyiben az <parameter>errno</parameter> és <parameter>errstr</parameter> + opcionális paraméterek meg lettek adva, ezekben visszakapjuk + a <literal>connect()</literal> rendszerhívás hibaértékét és + hibaüzenetét. + Amennyiben az <parameter>errno</parameter> nulla értékkel + jön vissza, miközben a függvény értéke is &false;, akkor + a hiba még valahol a <literal>connect()</literal> rendszerhívás + előtt következett be. Ez általában annak köszönhető, hogy valami + probléma merül fel már az inicializáció közben. + Az <parameter>errno</parameter> és <parameter>errstr</parameter> + argumentumok referenciaként adják vissza a visszatérési értéket. + </para> + <para> + Bizonyos rendszereken előfordulhat, hogy a Unix domain + illetve a <parameter>timeout</parameter> nem használható. + </para> + <para> + Alapesetben a socket blokkolt módban nyílik meg. Amennyiben ez + nem megfelelő, ez átkapcsolható a + <function>socket_set_blocking</function> segítségével. + <example> + <title><function>fsockopen</function> Példa</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\r\n\r\n"); + while (!feof($fp)) { + echo fgets ($fp,128); + } + fclose ($fp); +} + </programlisting> + </example> + A következő példa bemutatja, hogy gyűjthető be a saját gépünkön levő + "daytime" nevű, 13-as porton figyelő szolgáltatástól információ. + <example> + <title>UDP kapcsolat használata</title> + <programlisting role="php"> +<?php +$fp = fsockopen("udp://127.0.0.1", 13, $errno, $errstr); +if (!$fp) { + echo "Hiba: $errno - $errstr<br>\n"; +} else { + fwrite($fp,"\n"); + echo fread($fp, 26); + fclose($fp); +} +?> + </programlisting> + </example> + <note> + <para>A timeout paraméter a 3.0.9-es verziótól felfele, + míg az UDP támogatás csak a 4-es verziókban elérhető. + </para> + </note> + Lásd még: <function>pfsockopen</function>, + <function>socket_set_blocking</function>, + <function>socket_set_timeout</function>, <function>fgets</function>, + <function>fgetss</function>, <function>fputs</function>, + <function>fclose</function>, és <function>feof</function>). + </para> + </refsect1> + </refentry> + + <refentry id="function.gethostbyaddr"> + <refnamediv> + <refname>gethostbyaddr</refname> + <refpurpose> + Adott IP címnek megfelelő hostnév kinyerése + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>gethostbyaddr</function></funcdef> + <paramdef>string <parameter>ip_cím</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <parameter>ip_cím</parameter>-nek megfelelő hostnevet + adja vissza. Hiba esetén a kapott IP címet adja vissza. + </para> + <para> + Lásd még: <function>gethostbyname</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.gethostbyname"> + <refnamediv> + <refname>gethostbyname</refname> + <refpurpose> + Kinyeri a megadott Internet hostnak megfelelő IP címet + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>gethostbyname</function></funcdef> + <paramdef>string <parameter>hostnév</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <parameter>hostname</parameter> paraméter által megadott + Internet host IP címét adja vissza. + </para> + <para> + Lásd még: <function>gethostbyaddr</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.gethostbynamel"> + <refnamediv> + <refname>gethostbynamel</refname> + <refpurpose> + Adott hostnévnek megfelelő összes IP cím listájának kinyerése + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>gethostbynamel</function></funcdef> + <paramdef>string <parameter>hostnév</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Tömbben adja vissza a megadott <parameter>hostnév</parameter>-re + illő IP címek listáját. + </para> + <para> + Lásd még: <function>gethostbyname</function>, + <function>gethostbyaddr</function>, + <function>checkdnsrr</function>, <function>getmxrr</function>, + valamint a man <literal>named(8)</literal> oldala. + </para> + </refsect1> + </refentry> + + <refentry id="function.getmxrr"> + <refnamediv> + <refname>getmxrr</refname> + <refpurpose> + Adott Internet hostnévhez tartozó MX rekordok kigyűjtése + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>getmxrr</function></funcdef> + <paramdef>string <parameter>hostnév</parameter></paramdef> + <paramdef>array <parameter>mxhosts</parameter></paramdef> + <paramdef>array + <parameter><optional>weight</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + Névszerver keresést kezdeményez a megadott + <parameter>hostnév</parameter>-re, + MX (Mail Exchanger - levélszerver) rekordok után + kutatva. Találat esetén &true; értékkel tér vissza, + míg hiba estén vagy találat hiányában &false; értékkel. + </simpara> + <simpara> + A talált MX rekordokat az <parameter>mxhosts</parameter> + argumentumban megadott tömbben kapjuk vissza. + A <parameter>weight</parameter> opcionális paramétert + megadva, az ott megjelölt tömbben + viszzakapjuk az egyes MX rekordok súlyozottságát. + </simpara> + <simpara> + Lásd még: <function>checkdnsrr</function>, + <function>gethostbyname</function>, + <function>gethostbynamel</function>, + <function>gethostbyaddr</function>, + valamint a man <literal>named(8)</literal> oldala. + </simpara> + </refsect1> + </refentry> + + <refentry id="function.getprotobyname"> + <refnamediv> + <refname>getprotobyname</refname> + <refpurpose> + Névvel megadott protokol számát adja vissza + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>getprotobyname</function></funcdef> + <paramdef>string <parameter>név</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>getprotobyname</function> függvény a + <parameter>név</parameter> paraméterben megadott + protokol számát adja vissza. A <parameter>név</parameter> + paraméternek az /etc/protocols alati névnek kell, hogy + megfeleljen. + </para> + <para> + Lásd még: <function>getprotobynumber</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.getprotobynumber"> + <refnamediv> + <refname>getprotobynumber</refname> + <refpurpose> + Számmal megadott protokol nevét adja vissza + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>getprotobynumber</function></funcdef> + <paramdef>int <parameter>protokolszám</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>getprotobynumber</function> visszaadja a + <parameter>protokolszám</parameter> paraméternek megfelelő + protokol /etc/protocols szerinti nevét. + </para> + <para> + Lásd még: <function>getprotobyname</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.getservbyname"> + <refnamediv> + <refname>getservbyname</refname> + <refpurpose> + Adott szolgáltatástípus portszámának megallapítása név alapján + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>getservbyname</function></funcdef> + <paramdef>string <parameter>szolgáltatás</parameter></paramdef> + <paramdef>string <parameter>protokol</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>getservbyname</function> a + <parameter>szolgáltatás</parameter> és a + <parameter>protokol</parameter> paraméterekre illő + portszámot adja vissza. A szolgáltatás neve az + /etc/services-nek megfelelő kell, hogy legyen. A + <parameter>protokol</parameter> paraméter értéke + <literal>TCP</literal> avagy <literal>UDP</literal> + lehet. + </para> + <para> + Lásd még: <function>getservbyport</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.getservbyport"> + <refnamediv> + <refname>getservbyport</refname> + <refpurpose> + Adott porton levő szolgáltatás nevének megállapítása + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>getservbyport</function></funcdef> + <paramdef>int <parameter>port</parameter></paramdef> + <paramdef>string <parameter>protokol</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>getservbyport</function> /etc/services + szerű nevét adja vissza az adott <parameter>port</parameter>-on + levő, adott <parameter>protokol</parameter>-ú szolgáltatásnak. + A <parameter>protokol</parameter> paraméter <literal>TCP</literal> + avagy <literal>UDP</literal> értéket vehet fel. + </para> + <para> + Lásd még: <function>getservbyname</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.ip2long"> + <refnamediv> + <refname>ip2long</refname> + <refpurpose> + Pontozott IP címet tartalmazó karakterláncot valódi IP cimmé alakít + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ip2long</function></funcdef> + <paramdef>string <parameter>ip_cím</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ip2long</function> függvény IPv4 formátumú IP + címmé alakítja az <parameter>ip_cím</parameter> paraméterben + megadott szabványos, pontozott formátumú IP-t. Az IP címek + valójában ebben a 4 byteos egész szám formátumban tárolódnak. + <example> + <title><function>ip2long</function> Példa</title> + <programlisting role="php"> +<?php +$ip = gethostbyname("www.php.net"); +$out = "Az alábbi URL-ek egyenértékűek:<br>\n"; +$out .= "http://hu.php.net/, http://".$ip."/, és +http://".ip2long($ip)."/<br>\n"; +echo $out; +?> + </programlisting> + </example> + </para> + <para> + Eme második példa pedig azt mutatja meg, hogy a + <function>printf</function> segítségével + hogy tudjuk ez a lekonvertált címet kiíratni: + <example> + <title>IP cím kiíratás</title> + <programlisting role="php"> +<?php +$ip = gethostbyname("hu.php.net"); +printf ("%u\n", ip2long ($ip)); +echo $out; +?> + </programlisting> + </example> + </para> + <para> + Lásd még: <function>long2ip</function> + </para> + </refsect1> + </refentry> + + <refentry id="function.long2ip"> + <refnamediv> + <refname>long2ip</refname> + <refpurpose> + Négy byteon tárolt (IPv4) hálózatcímet alakít az Internet szabványnak + megfelelő pontozott formára + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>long2ip</function></funcdef> + <paramdef>int <parameter>proper_address</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>long2ip</function> függvény pontozott formátumú + (aaa.bbb.ccc.ddd) Internet címet hoz létre a paraméterben megadott + valódi IP hálózati címből. + </para> + <para> + Lásd még: <function>ip2long</function> + </para> + </refsect1> + </refentry> + + <refentry id="function.openlog"> + <refnamediv> + <refname>openlog</refname> + <refpurpose>A rendszer naplózóval való kapcsolat nyitása</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>openlog</function></funcdef> + <paramdef>string <parameter>ident</parameter></paramdef> + <paramdef>int <parameter>option</parameter></paramdef> + <paramdef>int <parameter>facility</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>openlog</function> függvény segítségéval + nyithatunk egy program számára kapcsolatot a rendszer + naplózóval. Az <parameter>ident</parameter> argumentumban + megadott szöveg minden naplóüzenet elejére kerül. Az + <parameter>option</parameter> és a + <parameter>facility</parameter> lehetséges értékei alant + találhatóak. + Az <parameter>option</parameter> paraméterrel jelezhetőek + a különleges opciók, amik belejáthszhatnak a naplózás + mikéntjébe. Kicsit lejjebb található róluk táblázat. + A <parameter>facility</parameter> paraméterben adható meg, + milyen csoporthoz tartozó program küldte ezt a naplóüzenetet. + Azt, hogy milyen <parameter>facility</parameter> típussal + hogy bánjon a syslog, azt a gépünk syslog konfigurációjában + lehet részletezni. + Az <function>openlog</function> függvény használata nem + szükségszerű, mivel a <function>syslog</function> ezt + amúgy is megteszi, ha szükség van rá. Ebben az esetben + az <parameter>ident</parameter> paraméter &false; lesz. + </para> + <para> + <table> + <title><function>openlog</function> Opciók</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Konstans</entry> + <entry>Leírás</entry> + </row> + </thead> + <tbody> + <row> + <entry>LOG_CONS</entry> + <entry> + bárminemű hiba esetén, ami a rendszer naplózó felé adatot + küldés folyamán felmerül, küldje azt egyenesen a rendszer + konzoljára + </entry> + </row> + <row> + <entry>LOG_NDELAY</entry> + <entry> + azonnali kapcsolatnyitás a rendszer-naplózóhoz + </entry> + </row> + <row> + <entry>LOG_ODELAY</entry> + <entry> + (alapértelmezett) várjon a csatlakozással, amíg az első + naplóüzenet meg nem érkezik + </entry> + </row> + <row> + <entry>LOG_PERROR</entry> + <entry>a naplóüzeneteket az alapértelmezett hibakimenetre is küldje</entry> + </row> + <row> + <entry>LOG_PID</entry> + <entry>minden üzenethez mellékelje a processzazonosítót (PID) is</entry> + </row> + </tbody> + </tgroup> + </table> + Ezen opciók közül egyet, de akár többet is fel lehet használni. Több + opció megadása esetén az opciók közt 'vagy' kapcsolatot kell + létrehozni. Amennyiben például egy azonnal nyitandó kapcsolat + kell, ami írjon a konzolra és a PID-eket is mellékelje, azt igy kell + megadni: <literal>LOG_CONS | LOG_NDELAY | LOG_PID</literal> + </para> + <para> + <table> + <title><function>openlog</function> Szolgáltatás csoportok (facility +paraméter)</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Konstans</entry> + <entry>Leírás</entry> + </row> + </thead> + <tbody> + <row> + <entry>LOG_AUTH</entry> + <entry> + biztonsági/authorizációs üzenetek (ehelyett a LOG_AUTHPRIV-et + használja, amely rendszerekben ez lehetséges) + </entry> + </row> + <row> + <entry>LOG_AUTHPRIV</entry> + <entry>biytonsági/authorizációs üzenetek (privát)</entry> + </row> + <row> + <entry>LOG_CRON</entry> + <entry>clock daemon (cron és at)</entry> + </row> + <row> + <entry>LOG_DAEMON</entry> + <entry>egyéb rendszer daemon-ok</entry> + </row> + <row> + <entry>LOG_KERN</entry> + <entry>kernel üzenetek</entry> + </row> + <row> + <entry>LOG_LOCAL0 ... LOG_LOCAL7</entry> + <entry>helyi használatra fentartott</entry> + </row> + <row> + <entry>LOG_LPR</entry> + <entry>soros nyomtató alrendszer</entry> + </row> + <row> + <entry>LOG_MAIL</entry> + <entry>levél alrendszer</entry> + </row> + <row> + <entry>LOG_NEWS</entry> + <entry>USENET news alrendszer</entry> + </row> + <row> + <entry>LOG_SYSLOG</entry> + <entry>a syslogd saját belső üzenetei</entry> + </row> + <row> + <entry>LOG_USER</entry> + <entry>általános, felhasználó szinten történt bejegyzés</entry> + </row> + <row> + <entry>LOG_UUCP</entry> + <entry>UUCP alrendszer</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Lásd még: <function>define_syslog_variables</function>, + <function>syslog</function> és + <function>closelog</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.pfsockopen"> + <refnamediv> + <refname>pfsockopen</refname> + <refpurpose> + Tartós Internet vagy Unix domain socket-kapcsolat megnyitása + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pfsockopen</function></funcdef> + <paramdef>string <parameter>hostnév</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>timeout</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Teljességgel megegyezik eme függvény és a <function>fsockopen</function>, + csupán annyi különbséggel, hogy a <function>pfsockopen</function> + esetén a kapcsolat a php script futásának végeztével nem szűnik meg. + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-get-status"> + <refnamediv> + <refname>socket_get_status</refname> + <refpurpose> + Egy már meglévő socket adatainak kinyerése + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>socket_get_status</function></funcdef> + <paramdef>resource + <parameter>socket_get_status</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + A megadott socketről ad vissta információt. Jelen pillanatban ez egy + 4 elemes tömböt jelent: + </para> + <itemizedlist> + <listitem> + <para> + <parameter>timed_out</parameter> (bool) - időtúllépés történt + a socketen, adatra várás közben + </para> + </listitem> + <listitem> + <para> + <parameter>blocked</parameter> (bool) - A socket blokkolt + </para> + </listitem> + <listitem> + <para> + <parameter>eof</parameter> (bool) - fájl vége jelzés volt + </para> + </listitem> + <listitem> + <para> + <parameter>unread_bytes</parameter> (int) - A még be nem + olvasott byte-ok száma a pufferben + </para> + </listitem> + </itemizedlist> + <para> + Lásd még: + <function>accept_connect</function>, + <function>bind</function>, + <function>connect</function>, + <function>listen</function> és + <function>strerror</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-set-blocking"> + <refnamediv> + <refname>socket_set_blocking</refname> + <refpurpose>Adott socketen a blokkoló/nem blokkoló mód kapcsolgatása</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>socket_set_blocking</function></funcdef> + <paramdef>int <parameter>socket azonosító</parameter></paramdef> + <paramdef>int <parameter>mód</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Ha a <parameter>mód</parameter> paraméter értéke &false;, + a megadott socket nem blokkolt módba kapcsolódik. Ha ez + a paraméter &true; értéket vesz fel, az esetben blokkoló + módba lesz kapcsolva az adott socket, melyet a + <parameter>socket azonosító</parameter> paraméterrel + adhatunk meg. Ez például egy adott socketről + <function>fgets</function>-el való olvasásra lehet + hatással. Nem blokkolt módban azonnal visszatér az + <function>fgets</function> valamiféle értékkel, míg + blokkolt módban vár, amíg adatot nem kap. + </para> + <para> + Korábban ezt a függvényt <function>set_socket_blocking</function> + vezették be, de annak használata nem javallott. + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-set-timeout"> + <refnamediv> + <refname>socket_set_timeout</refname> + <refpurpose>Adott socket időtúllépési periódusának állítása</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_set_timeout</function></funcdef> + <paramdef>int <parameter>socket azonosító</parameter></paramdef> + <paramdef>int <parameter>másodpercek</parameter></paramdef> + <paramdef>int <parameter>ezredmásodpercek</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <parameter>socket azonosító</parameter> paraméterben + azonosított socket időtúllépési tartamát adhatjuk meg + vele, melyek értékét a <parameter>másodpercek</parameter>, + valamint az <parameter>ezredmásodpercek</parameter> + paraméterben adhatunk meg. + <example> + <title><function>socket_set_timeout</function> Example</title> + <programlisting role="php"> +<?php +$fp = fsockopen("www.php.net", 80); +if(!$fp) { + echo "Nem sikerült a webhely megnyitása\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> + E függvény korábbi neve <function>set_socket_timeout</function> + volt, annak használata nem javallott. + </para> + <para> + Lásd még: <function>fsockopen</function> és <function>fopen</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.syslog"> + <refnamediv> + <refname>syslog</refname> + <refpurpose>Syslog üzenet létrehozása</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>syslog</function></funcdef> + <paramdef>int <parameter>prioritás</parameter></paramdef> + <paramdef>string <parameter>üzenet</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>syslog</function> egy naplóüzenetet hoz létre, + amit a rendszer naplózó rendszeren keresztül tesz közzé. + A <parameter>prioritás</parameter> paraméter két dolog + keverékéből jön, egyrészt az állapotból, másrészt a + bejegyzési szintből, ennek részletezése az alant + látható táblázatban látható. + A másik paraméterben adható meg az üzenet konkrét + szövege, amit egy az egyben továbbít, kivéve a + <literal>%m</literal> karaktersot, ennek helyére + az <errortype>errno</errortype> aktuális értékének + megfelelő hibaüzenetet helyettesíti be. + </para> + <para> + <table> + <title><function>syslog</function> prioritási szintek (csökkenő +sorrendben)</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Konstans</entry> + <entry>Leírás</entry> + </row> + </thead> + <tbody> + <row> + <entry>LOG_EMERG</entry> + <entry>a rendszer használhatatlan</entry> + </row> + <row> + <entry>LOG_ALERT</entry> + <entry>azonnali beavatkozás szükségeltetik</entry> + </row> + <row> + <entry>LOG_CRIT</entry> + <entry>kritikus állapot</entry> + </row> + <row> + <entry>LOG_ERR</entry> + <entry>hibajellentést okozó állapot</entry> + </row> + <row> + <entry>LOG_WARNING</entry> + <entry>csak figyelmeztetést okozó állapot</entry> + </row> + <row> + <entry>LOG_NOTICE</entry> + <entry>normál, de említésre méltó körülmény</entry> + </row> + <row> + <entry>LOG_INFO</entry> + <entry>információs üzenet</entry> + </row> + <row> + <entry>LOG_DEBUG</entry> + <entry>debug szintű üzenet</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + <example> + <title>A <function>syslog</function> használata</title> + <programlisting role="php"> +<?php +define_syslog_variables(); +// syslog nyitása, processz azonosítóstól. A log +// menjen ki az alapértelmezett hibakimenetre is, +// valamint a felhasználó által definiált naplózó +// mechanizmus is kapja meg a logot +openlog("myScripLog", LOG_PID | LOG_PERROR, LOG_LOCAL0); + +// egy kis programkód + +if (authorized_client()) { + // itt lehet csinálni valami jogosultat :) +} else { + // nem azonosított felhsználó! + // a próbálkozás naplózásra kerül + $access = date("Y/m/d H:i:s"); + syslog(LOG_WARNING,"Unauthorized client: $access $REMOTE_ADDR +($HTTP_USER_AGENT)"); +} + +closelog(); +?> + </programlisting> + </example> + Saját definiálású syslog kezelő felállításához érdemes a + <citerefentry><refentrytitle>syslog.conf</refentrytitle> + <manvolnum>5</manvolnum></citerefentry> Unix man oldalt + olvasgatni. További információ a syslog többi állapotjelző + lehetőségeiről + a <citerefentry><refentrytitle>syslog</refentrytitle> + <manvolnum>3</manvolnum></citerefentry> man oldalon található + </para> + <para> + Windows NT alatt a syslog emulálva van, az Event Log segítségével. + </para> + <para> + Lásd még: <function>define_syslog_variables</function>, + <function>openlog</function> és + <function>closelog</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 +sgml-parent-document:nil +sgml-default-dtd-file:"../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +-->