1
0
mirror of https://github.com/php/doc-tr.git synced 2026-03-24 07:12:18 +01:00
Files
archived-doc-tr/reference/sockets/functions/socket-get-option.xml
2022-11-17 16:43:57 +03:00

656 lines
22 KiB
XML
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: eb1f12738221677a2d94d94e8dbddd88c6143c94 Maintainer: nilgun Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.socket-get-option">
<refnamediv>
<refname>socket_get_option</refname>
<refpurpose>Soketle ilgili bir seçeneğin değerini döndürür</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>array</type><type>int</type><type>false</type></type><methodname>socket_get_option</methodname>
<methodparam><type>Socket</type><parameter>soket</parameter></methodparam>
<methodparam><type>int</type><parameter>seviye</parameter></methodparam>
<methodparam><type>int</type><parameter>seçenek</parameter></methodparam>
</methodsynopsis>
<para>
Belirtilen <parameter>soket</parameter> için ismi
<parameter>seçenek</parameter> ile belirtilen seçeneğin değerini döndürür.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>soket</parameter></term>
<listitem>
<para>
<function>socket_create</function> ile oluşturulmuş geçerli bir
<classname>Socket</classname> nesnesi.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>seviye</parameter></term>
<listitem>
<para>
Seçeneğin geçerli olacağı protokol seviyesi. Örneğin soket
seviyesindeki seçenekleri almak için bu bağımsız değişkende
<constant>SOL_SOCKET</constant> kullanılabilirdi.
<constant>TCP</constant> gibi diğer seviyeler, seviyenin protokol
numarası belirtilerek kullanılabilir. Protokol numaralarını
<function>getprotobyname</function> işleviyle alabilirsiniz.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>seçenek</parameter></term>
<listitem>
<table>
<title>Olası soket seçenekleri</title>
<tgroup cols="3">
<thead>
<row>
<entry>Seçenek</entry>
<entry>ıklama</entry>
<entry>Türü</entry>
</row>
</thead>
<tbody>
<row>
<entry><constant>SO_DEBUG</constant></entry>
<entry>
Hata ayıklama bilgilerinin kaydelip kaydedilmeyeceğini belirtir.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_BROADCAST</constant></entry>
<entry>
Yayın iletilerinin aktarılılp aktarılmayacağını belirtir.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_REUSEADDR</constant></entry>
<entry>
Yerel adresin yeniden kullanılabilir olup olmadığını belirtir.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_REUSEPORT</constant></entry>
<entry>
Yerel portların yeniden kullanılabilir olduğunu belirtir.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_KEEPALIVE</constant></entry>
<entry>
Belirli aralıklarla ileti aktarımlarında bağlantının kalıcı olup
olmayacağını belirtir. Eğer bağlı soket bu iletileri yanıtlamakta
başarısız olursa bağlantı kopar ve sokete yazan sürece bir SIGPIPE
sinyali gönderilir.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_LINGER</constant></entry>
<entry>
<para>
Veri mevcut olduğunda <function>socket_close</function> işlevinin
bekletilip bekletilmeyeceğini belirtir. Öntanımlı olarak soket
kapatılacağı zaman gönderilmemiş tüm veri gönderilmeye çalışılır.
Soketin bağlantı yönelimli olduğu durumda
<function>socket_close</function> karşı ucun alındısını bekler.
</para>
<para>
Eğer <varname>l_onoff</varname> sıfırdan farklı ve
<varname>l_linger</varname> sıfırsa gönderilmemiş tüm veri iptal
edilir ve soketin bağlantı yönelimli olması durumunda karşı uca
bir RST (sıfırla) gönderilir.
</para>
<para>
Diğer taraftan, <varname>l_onoff</varname> ve
<varname>l_linger</varname>'in ikisi de sıfırdan farklıysa tüm
veri gönderilinceye veya <varname>l_linger</varname> ile
belirtilen süre dolana kadar <function>socket_close</function>
bekletilir. Soket engellenmeyen kipte ise
<function>socket_close</function> başarısız olup bir hata
döndürür.
</para>
</entry>
<entry>
<type>array</type>. Dizi iki anahtar içerir:
<varname>l_onoff</varname> ve <varname>l_linger</varname>.
</entry>
</row>
<row>
<entry><constant>SO_OOBINLINE</constant></entry>
<entry>
Soketin band dışı veriyi hatta bırakıp bırakmayacağını belirtir.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_SNDBUF</constant></entry>
<entry>
Gönderim tamponunun boyunu belirtir.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_RCVBUF</constant></entry>
<entry>
Alım tamponunun boyunu belirtir.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_ERROR</constant></entry>
<entry>
Hata durumu hakkında bilgi verip hata kodunu siler.
</entry>
<entry>
<type>int</type> (<function>socket_set_option</function> ile
atanamayabilir.)
</entry>
</row>
<row>
<entry><constant>SO_TYPE</constant></entry>
<entry>
Soketin türünü belirtir (<constant>SOCK_STREAM</constant> gibi).
</entry>
<entry>
<type>int</type> (<function>socket_set_option</function> ile
atanamayabilir.)
</entry>
</row>
<row>
<entry><constant>SO_DONTROUTE</constant></entry>
<entry>
Giden iletilerin standart yönlendirme oluşumlarını es geçip
geçmeyeceğini belirtir.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_RCVLOWAT</constant></entry>
<entry>
Soket girdi işlemlerinde işlenecek en küçük bayt sayısını belirtir.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_RCVTIMEO</constant></entry>
<entry>
Soket girdi işlemleri için zaman aşımı değerini belirtir.
</entry>
<entry>
<type>array</type>. Dizi iki anahtar içerir:
Zaman aşımının saniye parçası <varname>sec</varname>, mikrosaniye
parçası <varname>usec</varname> anahtarına konur.
</entry>
</row>
<row>
<entry><constant>SO_SNDTIMEO</constant></entry>
<entry>
Akış denetiminin veri gönderimini engellemesi nedeniyle bir çıktı
işlevinin bekletileceği azami süreyi belirtir.
</entry>
<entry>
<type>array</type>. Dizi iki anahtar içerir:
Zaman aşımının saniye parçası <varname>sec</varname>, mikrosaniye
parçası <varname>usec</varname> anahtarına konur.
</entry>
</row>
<row>
<entry><constant>SO_SNDLOWAT</constant></entry>
<entry>
Soket çıktı işlemlerinde işlenecek en küçük bayt sayısını belirtir.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>TCP_NODELAY</constant></entry>
<entry>
Nagle TCP algoritmasının iptal edilmiş olup olmadığını belirtir.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>MCAST_JOIN_GROUP</constant></entry>
<entry>
Çok noktaya yayın grubuna katılır.
</entry>
<entry>
<type>array</type>.
IPv4 veya IPv6 çok noktaya yayın adresi içeren
<literal>"group"</literal> anahtarlı ve <literal>"eth0"</literal>
gibi arabirim adını veya <type>int</type> türünde
bir arabirim numarası (arabirimin yönlendirme kuralları
kullanılarak seçilmesi gerektiğini belirtmek için
<literal>0</literal> belirtilebilir) içeren
<literal>"interface"</literal> anahtarlı bir dizi
Sadece <function>socket_set_option</function> işlevinde
kullanılabilir.
</entry>
</row>
<row>
<entry><constant>MCAST_LEAVE_GROUP</constant></entry>
<entry>
Çok noktaya yayın grubunu terkeder.
</entry>
<entry>
<type>array</type>. Daha fazla bilgi için bkz:
<constant>MCAST_JOIN_GROUP</constant>
Sadece <function>socket_set_option</function> işlevinde
kullanılabilir.
</entry>
</row>
<row>
<entry><constant>MCAST_BLOCK_SOURCE</constant></entry>
<entry>
Evvelce bağlanılmış olması gereken belli bir çok noktaya yayın
grubuna belli bir kaynaktan gelen paketleri engeller.
</entry>
<entry>
<type>array</type>.
<constant>MCAST_JOIN_GROUP</constant> seçeneğindeki anahtarlara ek
olarak <literal>source</literal> anahtarına da sahip bir dizi.
<literal>source</literal> anahtarı, engellenen IPv4 veya IPv6
kaynak adresini belirten bir dizge içerir.
Sadece <function>socket_set_option</function> işlevinde
kullanılabilir.
</entry>
</row>
<row>
<entry><constant>MCAST_UNBLOCK_SOURCE</constant></entry>
<entry>
Evvelce bağlanılmış olması gereken belli bir çok noktaya yayın
grubuna belli bir kaynaktan gelen paketlerin engellemesini kaldırır
(yeniden almaya başlar).
</entry>
<entry>
<type>array</type>.
<constant>MCAST_BLOCK_SOURCE</constant> ile aynı biçemde bir dizi.
Sadece <function>socket_set_option</function> işlevinde
kullanılabilir.
</entry>
</row>
<row>
<entry><constant>MCAST_JOIN_SOURCE_GROUP</constant></entry>
<entry>
Kaynak adresi belli bir değerle eşleşen belli bir çok noktaya
yayın grubunu hedefleyen paketleri alır.
</entry>
<entry>
<type>array</type>.
<constant>MCAST_BLOCK_SOURCE</constant> ile aynı biçemde bir dizi.
Sadece <function>socket_set_option</function> işlevinde
kullanılabilir.
</entry>
</row>
<row>
<entry><constant>MCAST_LEAVE_SOURCE_GROUP</constant></entry>
<entry>
Kaynak adresi belli bir değerle eşleşen belli bir çok noktaya
yayın grubunu hedefleyen paketlerin alımını durdurur.
</entry>
<entry>
<type>array</type>.
<constant>MCAST_BLOCK_SOURCE</constant> ile aynı biçemde bir dizi.
Sadece <function>socket_set_option</function> işlevinde
kullanılabilir.
</entry>
</row>
<row>
<entry><constant>IP_MULTICAST_IF</constant></entry>
<entry>
IPv4 çok noktaya yayın giden paketleri için arabirim.
</entry>
<entry>
<type>int</type> veya <type>string</type>.
Arabirim numarasını içeren <type>int</type> türünde bir değer veya
<literal>eth0</literal> gibi arabirim adını içeren
<type>string</type> türünde bir değer. Arabirim seçiminde
yönlendirme tablosunun kullanılacağını ifade etmek için
<type>0</type> değeri belirtilebilir.
<function>socket_get_option</function> işlevi bir arabirim indisi
döndürür. C API'sinin tersine bu seçenek bir IP adresi almaz.
Bu, <constant>IP_MULTICAST_IF</constant> ile
<constant>IPV6_MULTICAST_IF</constant> arasındaki farkın
yoksayılmasını sağlar.
</entry>
</row>
<row>
<entry><constant>IPV6_MULTICAST_IF</constant></entry>
<entry>
IPv6 çok noktaya yayın giden paketleri için arabirim.
</entry>
<entry>
<type>int</type> veya <type>string</type>.
<constant>IP_MULTICAST_IF</constant> ile aynı.
</entry>
</row>
<row>
<entry><constant>IP_MULTICAST_LOOP</constant></entry>
<entry>
IPv4 paketleri için çok noktaya yayın geridönüş ilkesi, daha önce
katılmış olması gereken giden çok noktaya yayınların geridönüşünü
etkinleştirir veya devre dışı bırakır. Bununla birlikte, etki,
unix'lerde ve Windows'ta uygulamada farklılık gösterir; farklılık
unix'lerde alma yolunda, Windows'ta ise gönderme yolundadır.
</entry>
<entry>
<type>int</type>.
(<literal>0</literal> ya da <literal>1</literal>).
<function>socket_set_option</function> işlevi için kabul edilebilir
veya uygun PHP kurallarıyla mantıksal bir değere dönüştürülebilir
herhangi bir değer.
</entry>
</row>
<row>
<entry><constant>IPV6_MULTICAST_LOOP</constant></entry>
<entry>
IPv6 için olması dışında <constant>IP_MULTICAST_LOOP</constant> ile benzer.
</entry>
<entry>
<type>int</type>.
Bkz: <constant>IP_MULTICAST_LOOP</constant>.
</entry>
</row>
<row>
<entry><constant>IP_MULTICAST_TTL</constant></entry>
<entry>
Giden IPv4 çok noktaya yayın paketleri için yaşam süresi. 0 (arabirimi bırakma) ile 255 arasında bir değer. Öntanımlı değer
1'dir (sadece yerel ağa ulaşılır).
</entry>
<entry>
<type>int</type>. 0 ile 255 arası bir tamsayı.
</entry>
</row>
<row>
<entry><constant>IPV6_MULTICAST_HOPS</constant></entry>
<entry>
IPv6 için olması dışında <constant>IP_MULTICAST_TTL</constant> ile
benzer. Ayrıca, öntanımlı yol kullanılacak anlamında -1 de kabul
edilir.
</entry>
<entry>
<type>int</type>. -1 ile 255 arası bir tamsayı.
</entry>
</row>
<row>
<entry><constant>SO_MARK</constant></entry>
<entry>
Linux'ta' paketleri süzme amacıyla soket üzerinde bir tanıtıcı
tanımlar.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_ACCEPTFILTER</constant></entry>
<entry>
FreeBSD/NetBSD'de dinlenen sokete kabul süzgeci ekler.
FreeBSD'de kabul süzgecinin çekirdek modülü önceden yüklenmelidir
(örn, accf_http).
</entry>
<entry>
<type>string</type> name of the filter (length 15 max).
</entry>
</row>
<row>
<entry><constant>SO_USER_COOKIE</constant></entry>
<entry>
FreeBSD'de paketleri süzmek amacıyla soket üzerinde bir tanıtıcı
tanımlar.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_RTABLE</constant></entry>
<entry>
OpenBSD'de paketleri süzmek amacıyla soket üzerinde bir tanıtıcı
tanımlar.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_DONTTRUNC</constant></entry>
<entry>
Okunmamış veriler korunur.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_WANTMORE</constant></entry>
<entry>
Daha fazla veri hazır olduğunda bir ipucu verilir.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>TCP_DEFER_ACCEPT</constant></entry>
<entry>
Veri hazır olana kadar dinleme soketi uyarılmaz.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_INCOMING_CPU</constant></entry>
<entry>
Soketin CPU benzerliğini tanımlar.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_MEMINFO</constant></entry>
<entry>
Soketin tüm meminfo'ları.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_BPF_EXTENSIONS</constant></entry>
<entry>
Sokete eklenecek çekirdek tarafından desteklenen BPF uzantıları.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SO_SETFIB</constant></entry>
<entry>
Soketin route tablosunu (FIB) tanımlar. (Yalnızca FreeBSD)
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>SOL_FILTER</constant></entry>
<entry>
Bir sokete atfedilen süzgeçler. (Yalnızca Solaris/Illumos)
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>TCP_KEEPCNT</constant></entry>
<entry>
TCP'nin bağlantıyı kesmeden önce göndermesi gereken azami canlı
tutma sondalarının sayısını tanımlar.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>TCP_KEEPIDLE</constant></entry>
<entry>
Bağlantının boşta kalması için gereken süreyi ayarlar.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>TCP_KEEPINTVL</constant></entry>
<entry>
Bağımsız canlı tutma sondaları arasındaki süreyi tanımlar.
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>TCP_KEEPALIVE</constant></entry>
<entry>
Bağlantının boşta kalması için gereken süreyi ayarlar (Yalnızca macOS).
</entry>
<entry>
<type>int</type>
</entry>
</row>
<row>
<entry><constant>TCP_NOTSENT_LOWAT</constant></entry>
<entry>
Soket akımı tarafından yazma kuyruğundaki gönderilmemiş veri
sayısının sınırını tanımlar (Yalnızca Linux)
</entry>
<entry>
<type>int</type>
</entry>
</row>
</tbody>
</tgroup>
</table>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Hata durumunda &false; yoksa belirtilen seçeneğin değerini döndürür.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&sockets.changelog.socket-param;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>- <function>socket_get_option</function> örneği</title>
<programlisting role="php">
<![CDATA[
<?php
$socket = socket_create_listen(1223);
$linger = array('l_linger' => 1, 'l_onoff' => 1);
socket_set_option($socket, SOL_SOCKET, SO_LINGER, $linger);
var_dump(socket_get_option($socket, SOL_SOCKET, SO_REUSEADDR));
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>socket_create_listen</function></member>
<member><function>socket_set_option</function></member>
</simplelist>
</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:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->