<?xml version="1.0" encoding="utf-8"?>

<!-- EN-Revision: 7be2426e49ee1c9131866f20b67a48aaea0a642a Maintainer: nilgun Status: ready -->

<refentry xml:id="function.dns-get-record" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<refnamediv>

<refname>dns_get_record</refname>

<refpurpose>Belirtilen konak adı ile ilgili DNS Özkaynak Kayıtlarını

getirir</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type class="union"><type>array</type><type>false</type></type><methodname>dns_get_record</methodname>

<methodparam><type>string</type><parameter>konakadı</parameter></methodparam>

<methodparam choice="opt"><type>int</type><parameter>tür</parameter><initializer><constant>DNS_ANY</constant></initializer></methodparam>

<methodparam choice="opt"><type>array</type><parameter role="reference">yetkili_isim_sunucuları</parameter><initializer>&null;</initializer></methodparam>

<methodparam choice="opt"><type>array</type><parameter role="reference">ek_kayıtlar</parameter><initializer>&null;</initializer></methodparam>

<methodparam choice="opt"><type>bool</type><parameter>ham</parameter><initializer>&false;</initializer></methodparam>

</methodsynopsis>

<para>

Belirtilen <parameter>konakadı</parameter> ile ilgili DNS Kayıtlarını

(DNS-RR) getirir.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>konakadı</parameter></term>

<listitem>

<para>

<parameter>konakadı</parameter>, "<literal>www.example.com</literal>"

gibi geçerli bir konak adı olmalıdır. Ters DNS sorguları

<literal>in-addr.arpa</literal> gösterimiyle üretilir, fakat

<function>gethostbyaddr</function> işlevi ters DNS sorguları için daha

kullanışlıdır.

</para>

<note>

<para>

DNS standartlarının amacı gereği, posta adresleri

<literal>kullanıcı.konak</literal> biçiminde verilir (örneğin,

<literal>[email protected]</literal> değil

<literal>hostmaster.example.com</literal>). Sorgudan böyle bir değer

aldıysanız, <function>mail</function> gibi bir işlevde kullanmadan

önce bunu normal eposta adresi haline getirmelisiniz.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>tür</parameter></term>

<listitem>

<para>

<function>dns_get_record</function> öntanımlı olarak,

<parameter>konakadı</parameter> ile ilgili bütün özkaynak kayıtlarını

arayacaktır. Sorguyu belli kayıtlarla sınırlamak için isteğe bağlı

<parameter>tür</parameter> bağımsız değişkenini kullanabilirsiniz.

<parameter>tür</parameter> olarak şunlardan biri belirtilebilir:

<constant>DNS_A</constant>, <constant>DNS_CNAME</constant>,

<constant>DNS_HINFO</constant>, <constant>DNS_CAA</constant>,

<constant>DNS_MX</constant>, <constant>DNS_NS</constant>,

<constant>DNS_PTR</constant>, <constant>DNS_SOA</constant>,

<constant>DNS_TXT</constant>, <constant>DNS_AAAA</constant>,

<constant>DNS_SRV</constant>, <constant>DNS_NAPTR</constant>,

<constant>DNS_A6</constant>, <constant>DNS_ALL</constant>

veya <constant>DNS_ANY</constant>.

</para>

<note>

<para>

Çeşitli platformlarda libresolv başarımının dışmerkezliliğinden

dolayı <constant>DNS_ANY</constant> her zaman bütün kayıtları

döndürmez. Daha yavaş fakat daha güvenilir olan

<constant>DNS_ALL</constant> tüm kayıtları toplayacaktır.

</para>

</note>

<note>

<para>

Windows: <constant>DNS_CAA</constant> desteklenmez.

<constant>DNS_A6</constant> desteği gerçeklenmedi.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>yetkili_isim_sunucuları</parameter></term>

<listitem>

<para>

Gönderimli aktarılır. Belirtilirse <emphasis>Yetkili Ad

Sunucuları</emphasis> ile ilgili Özkaynak Kayıtları bu diziye

yerleştirilir.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>ek_kayıtlar</parameter></term>

<listitem>

<para>

Gönderimli aktarılır. Belirtilirse <emphasis>Ek Kayıtlar</emphasis> ile

ilgili Özkaynak Kayıtları bu diziye yerleştirilir.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>ham</parameter></term>

<listitem>

<para>

&true; belirtilirse, <parameter>tür</parameter>ham DNS tür kimliği

olarak yorumlanır (<literal>DNS_*</literal> sabitleri kullanılamaz).

Dönen dizi, kendinizin çözümleyeceği bir <literal>data</literal>

anahtarı içerir.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Bu işlev ilişkisel diziler içeren bir dizi ile,&return.falseforfailure;.

Her ilişkisel dizi en azından aşağıdaki anahtarları

<emphasis>mutlaka</emphasis> içerir:

<table>

<title>Temel DNS öznitelikleri</title>

<tgroup cols="2">

<thead>

<row>

<entry>Öznitelik</entry>

<entry>Anlamı</entry>

</row>

</thead>

<tbody>

<row>

<entry>host</entry>

<entry>

DNS isim alanındaki, ilişkili tüm verinin atfedildiği kayıt.

</entry>

</row>

<row>

<entry>class</entry>

<entry>

<function>dns_get_record</function> daima sadece İnternet sınıfı

kayıtları döndürdüğünden bu üyenin değeri daima

<literal>IN</literal>'dir.

</entry>

</row>

<row>

<entry>type</entry>

<entry>

Kayıt türünü içeren dizge. Tür değerine bağlı olarak dizide ek

öznitelikler bulunabilir. Aşağıdaki tabloya bakınız.

</entry>

</row>

<row>

<entry>ttl</entry>

<entry>

<literal>"Time To Live"</literal>.

Bu kayıt için kalan yaşam süresi. Bu değer, özgün ttl ile aynı

değildir. Özgün ttl'den yetkili isim sunucu sorgulandığından beri

geçen süre düşüldükten sonra kalan değerdir.

</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

<para>

<table>

<title>İlişkisel dizide 'type' anahtarına bağlı diğer anahtarlar</title>

<tgroup cols="2">

<thead>

<row>

<entry>Tür</entry>

<entry>Ek Sütunlar</entry>

</row>

</thead>

<tbody>

<row>

<entry><literal>A</literal></entry>

<entry>

<literal>ip</literal>: Noktalı sayısal gösterimle bir IPv4 adresi.

</entry>

</row>

<row>

<entry morerows="1"><literal>MX</literal></entry>

<entry>

<literal>pri</literal>: Posta alıcısının önceliği. Düşük sayılar daha

yüksek öncelik belirtir.

</entry>

</row>

<row>

<entry>

<literal>target</literal>: Posta alıcısının tamamen nitelenmiş alan

adı. Ayrıca bakınız: <function>dns_get_mx</function>.

</entry>

</row>

<row>

<entry><literal>CNAME</literal></entry>

<entry>

<literal>target</literal>: Kaydın takma ad olduğu DNS isim alanındaki

konumun tamamen nitelenmiş alan adı.

</entry>

</row>

<row>

<entry><literal>NS</literal></entry>

<entry>

<literal>target</literal>: Bu konak adı için yetkili olan isim

sunucusunun tamamen nitelenmiş alan adı.

</entry>

</row>

<row>

<entry><literal>PTR</literal></entry>

<entry>

<literal>target</literal>: DNS isim alanında bu kayda işaret eden

konum.

</entry>

</row>

<row>

<entry><literal>TXT</literal></entry>

<entry>

<literal>txt</literal>: Bu kayıtla ilişkili dizge türünde keyfi bir

veri.

</entry>

</row>

<row>

<entry morerows="1"><literal>HINFO</literal></entry>

<entry>

<literal>cpu</literal>: Bu kaydın gösterdiği makinenin işlemcisi için

IANA ismi.

</entry>

</row>

<row>

<entry>

<literal>os</literal>: Bu kaydın gösterdiği makinenin işletim sistemi

için IANA ismi. Bu değerlerin anlamları için IANA'nın <link

xlink:href="&url.iana.system-names;">İşletim Sistemi İsimleri</link>

belgesine bakınız.

</entry>

</row>

<row>

<entry><literal>CAA</literal></entry>

<entry>

<literal>flags</literal>: Tek baytlık bit alanı; şu an sadece

'critical' anlamına gelen bit 0 tanımlıdır; diğer bitler ileride

kullanım için ayrılmış olup yok sayılmalıdır.

<literal>tag</literal>: CAA etiket adı (abecesayısal ASCII dizge).

<literal>value</literal>: CAA etiket değeri (ikil dizge, alt biçemleri

olabilir). Ek olarak bkz: <link xlink:href="&url.rfc;6844">RFC 6844</link>

</entry>

</row>

<row>

<entry><literal>SOA</literal></entry>

<entry>

<literal>mname</literal>: Özkaynak kaydının kaynaklandığı makinenin

tamamen nitelenmiş alan adı.

</entry>

</row>

<row>

<entry>

<literal>rname</literal>: Bu alanın idari yetkilisinin eposta adresi.

</entry>

</row>

<row>

<entry>

<literal>serial</literal>: İstenen alanın bu sürümünün sıra numarası.

</entry>

</row>

<row>

<entry>

<literal>refresh</literal>: Bu alanın uzak kopyaları güncellenirken

ikincil isim sunucularının tazelenme süresi (saniye cinsinden).

</entry>

</row>

<row>

<entry>

<literal>retry</literal>: Tekrar bir tazeleme yapmadan önce beklenecek

süre (saniye cinsinden).

</entry>

</row>

<row>

<entry>

<literal>expire</literal>: Başarısız bir tazelemenin ardından bölge

verisinin uzak kopyalarını silmeden önce DNS sunucusunun bekleyeceği

azami süre (saniye cinsinden).

</entry>

</row>

<row>

<entry>

<literal>minimum-ttl</literal>: Bir istemcinin sunucudan yeni bir

çözünürlük isteği yapmadan önce mevcut DNS çözünürlüğünü kullanmaya

devam edebileceği asgari süre (saniye cinsinden). Özkaynak

kayıtlarının her biri kendi süresini belirleyerek bunu geçersiz

kılabilir.

</entry>

</row>

<row>

<entry><literal>AAAA</literal></entry>

<entry>

<literal>ipv6</literal>: IPv6 adresi.

</entry>

</row>

<row>

<entry morerows="2"><literal>A6</literal></entry>

<entry>

<literal>masklen</literal>: <literal>chain</literal> ile belirtilen

hedeften miras alınan uzunluk (bit cinsinden).

</entry>

</row>

<row>

<entry>

<literal>ipv6</literal>: <literal>chain</literal>'e katıştırılacak bu

özel kayıt için adres.

</entry>

</row>

<row>

<entry>

<literal>chain</literal>: <literal>ipv6</literal> verisi ile

katıştırılacak ebeveyn kayıt.

</entry>

</row>

<row>

<entry morerows="2"><literal>SRV</literal></entry>

<entry>

<literal>pri</literal>: (Priority kısaltması) En düşük değerin

önceliği en yüksektir.

</entry>

</row>

<row>

<entry>

<literal>weight</literal>: Ortak önceliklerin tercih sıralaması.

</entry>

</row>

<row>

<entry>

<literal>targets</literal> rasgele seçilmelidir.

<literal>target</literal> ve <literal>port</literal>: İstenen hizmetin

bulunabileceği konak adı ve port. Ek bilgi için

<link xlink:href="&url.rfc;2782">RFC 2782</link>'ye bakınız.

</entry>

</row>

<row>

<entry morerows="1"><literal>NAPTR</literal></entry>

<entry>

<literal>order</literal> ve <literal>pref</literal>: Yukarıdaki

<literal>pri</literal> ve <literal>weight</literal> ile eşdeğerdirler.

</entry>

</row>

<row>

<entry>

<literal>flags</literal>, <literal>services</literal>,

<literal>regex</literal> ve <literal>replacement</literal>:

<link xlink:href="&url.rfc;2915">RFC 2915</link> tarafından tanımlanmış

bağımsız değişkenlerdir.

</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>7.0.16, 7.1.2</entry>

<entry>

CAA kaydı için destek eklendi.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>- <function>dns_get_record</function> kullanımı</title>

<programlisting role="php">

<![CDATA[

<?php

$result = dns_get_record("php.net");

print_r($result);

?>

]]>

</programlisting>

&example.outputs.similar;

<screen>

<![CDATA[

Array

(

[0] => Array

(

[host] => php.net

[type] => MX

[pri] => 5

[target] => pair2.php.net

[class] => IN

[ttl] => 6765

)

[1] => Array

(

[host] => php.net

[type] => A

[ip] => 64.246.30.37

[class] => IN

[ttl] => 8125

)

)

]]>

</screen>

</example>

<example>

<title>- <function>dns_get_record</function> ve DNS_ANY kullanımı</title>

<para>

MX kaydı çözümlendikten sonra normal olarak posta sunucusunun adresi

istenir. <function>dns_get_record</function> işlevi ayrıca, ilişkili

kayıtları <parameter>ek_kayıtlar</parameter> dizisinde döndürür. Bunun

yanında, <parameter>yetkili_isim_sunucuları</parameter> dizisinde de

yetkili isim sunucularının listesini döndürür.

</para>

<programlisting role="php">

<![CDATA[

<?php

/* php.net için "ANY" kayıt isteği yaparken

isim sunucularının ve ek kayıtların listeleri için

$yetkiliNS ve $ekkayıtlar dizilerini kullanalım */

$yetkilins=array(); $ekler=array();

$sonuç = dns_get_record("php.net", DNS_ANY, $yetkilins, $ekler);

echo "Sonuç = ";

print_r($sonuç);

echo "Yetkili NS = ";

print_r($yetkilins);

echo "Ek Kayıtlar = ";

print_r($ekler);

?>

]]>

</programlisting>

&example.outputs.similar;

<screen>

<![CDATA[

Sonuç = Array

(

[0] => Array

(

[host] => php.net

[type] => MX

[pri] => 5

[target] => pair2.php.net

[class] => IN

[ttl] => 6765

)

[1] => Array

(

[host] => php.net

[type] => A

[ip] => 64.246.30.37

[class] => IN

[ttl] => 8125

)

)

Yetkili NS = Array

(

[0] => Array

(

[host] => php.net

[type] => NS

[target] => remote1.easydns.com

[class] => IN

[ttl] => 10722

)

[1] => Array

(

[host] => php.net

[type] => NS

[target] => remote2.easydns.com

[class] => IN

[ttl] => 10722

)

[2] => Array

(

[host] => php.net

[type] => NS

[target] => ns1.easydns.com

[class] => IN

[ttl] => 10722

)

[3] => Array

(

[host] => php.net

[type] => NS

[target] => ns2.easydns.com

[class] => IN

[ttl] => 10722

)

)

Ek Kayıtlar = Array

(

[0] => Array

(

[host] => pair2.php.net

[type] => A

[ip] => 216.92.131.5

[class] => IN

[ttl] => 6766

)

[1] => Array

(

[host] => remote1.easydns.com

[type] => A

[ip] => 64.39.29.212

[class] => IN

[ttl] => 100384

)

[2] => Array

(

[host] => remote2.easydns.com

[type] => A

[ip] => 212.100.224.80

[class] => IN

[ttl] => 81241

)

[3] => Array

(

[host] => ns1.easydns.com

[type] => A

[ip] => 216.220.40.243

[class] => IN

[ttl] => 81241

)

[4] => Array

(

[host] => ns2.easydns.com

[type] => A

[ip] => 216.220.40.244

[class] => IN

[ttl] => 81241

)

)

]]>

</screen>

</example>

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>dns_get_mx</function></member>

<member><function>dns_check_record</function></member>

</simplelist>

</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:"~/.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

-->