php_getdns_context_set_namespaces

(PECL getdns >= 0.10.0)

php_getdns_context_set_namespaces — Set the namespaces used for basic resolution.

Description

int php_getdns_context_set_namespaces ( int $context , int $count , array $value )

This function sets the ordered list of namespaces that will be queried for basic resolution. Note that this context setting is ignored for the php_getdns_general() and php_getdns_general_sync() functions; it is used for the other funtions. When a normal lookup is done, the getdns library does the lookups in the order given and stops when it gets the first result; a different method with the same result would be to run the queries in parallel and return when it gets the first result. Since lookups might be done over different mechanisms because of the different namespaces, there can be information leakage that is similar to that seen with getaddrinfo(). The default set of namespaces is determined by the OS.

Parameters

context: The previously created DNS context that is to be used with this request.
count: The number of elements contained in the array of namespace values.
value: An indexed array of namespace values. Valid values include GETDNS_NAMESPACE_DNS, GETDNS_NAMESPACE_LOCALNAMES, GETDNS_NAMESPACE_NETBIOS, GETDNS_NAMESPACE_MDNS, and GETDNS_NAMESPACE_NIS.

Return Values

This function returns an integer response code. GETDNS_RETURN_GOOD indicates successful completion.