IP¶
Inherits: Object
Funciones de soporte del protocolo de Internet (IP) como la resolución del DNS.
Descripción¶
IP contiene funciones de apoyo al Protocolo de Internet (IP). El soporte de TCP/IP está en diferentes clases (ver StreamPeerTCP y TCP_Server). IP proporciona soporte para la resolución de nombres de host DNS, tanto de bloques como en hilos.
Métodos¶
void |
clear_cache ( String hostname="" ) |
void |
erase_resolve_item ( int id ) |
get_local_addresses ( ) const |
|
get_local_interfaces ( ) const |
|
get_resolve_item_address ( int id ) const |
|
get_resolve_item_addresses ( int id ) const |
|
get_resolve_item_status ( int id ) const |
|
resolve_hostname ( String host, Type ip_type=3 ) |
|
resolve_hostname_addresses ( String host, Type ip_type=3 ) |
|
resolve_hostname_queue_item ( String host, Type ip_type=3 ) |
Enumeraciones¶
enum ResolverStatus:
RESOLVER_STATUS_NONE = 0 --- Estado de la resolución del nombre de host del DNS: No hay estado.
RESOLVER_STATUS_WAITING = 1 --- Estado de la resolución del nombre de host del DNS: Esperando.
RESOLVER_STATUS_DONE = 2 --- Estado de la resolución del nombre de host del DNS: Hecho.
RESOLVER_STATUS_ERROR = 3 --- Estado de la resolución del nombre de host del DNS: Error.
enum Type:
TYPE_NONE = 0 --- Tipo de dirección: Ninguna.
TYPE_IPV4 = 1 --- Tipo de dirección: Protocolo de Internet versión 4 (IPv4).
TYPE_IPV6 = 2 --- Tipo de dirección: Protocolo de Internet versión 6 (IPv6).
TYPE_ANY = 3 --- Tipo de dirección: Cualquiera.
Constantes¶
RESOLVER_MAX_QUERIES = 32 --- El máximo número de consultas de resolución DNS concurrentes permitidas, RESOLVER_INVALID_ID se devuelve si se excede.
RESOLVER_INVALID_ID = -1 --- Constante de identificación inválida. Devuelta si se supera la constant RESOLVER_MAX_QUERIES.
Descripciones de Métodos¶
void clear_cache ( String hostname="" )
Elimina todas las referencias de un hostname
en la caché. Si no se da un hostname
, se eliminan todas las direcciones IP en caché.
void erase_resolve_item ( int id )
Elimina un determinado elemento id
de la cola. Esto debería usarse para liberar una cola después de que se haya completado para permitir que ocurran más consultas.
Array get_local_addresses ( ) const
Returns all the user's current IPv4 and IPv6 addresses as an array.
Array get_local_interfaces ( ) const
Devuelve todos los adaptadores de red como un array.
Cada adaptador es un diccionario de la forma:
{
"index": "1", # indice interfaz.
"name": "eth0", # nombre interfaz.
"friendly": "Ethernet One", # Un nombre amigable (puede ser vacio).
"addresses": ["192.168.1.101"], # Un array de direcciones IP asociadas a esta interfaz.
}
Devuelve una elemento encolado de una direccion IP de un hostname, dada su cola id
. Devuelve una string vacía en caso de error o si la resolución no se ha producido todavía (ver get_resolve_item_status).
Return resolved addresses, or an empty array if an error happened or resolution didn't happen yet (see get_resolve_item_status).
ResolverStatus get_resolve_item_status ( int id ) const
Devuelve el estado de un encolado de hostname como una constante de ResolverStatus, dada su cola id
.
Devuelve la dirección IPv4 o IPv6 de un determinado nombre de host cuando se resuelve (método de bloqueo). El tipo de dirección devuelto depende de la constante Type dada como ip_type
.
Resolves a given hostname in a blocking way. Addresses are returned as an Array of IPv4 or IPv6 depending on ip_type
.
Crea un elemento de cola para resolver un nombre de host a una dirección IPv4 o IPv6 dependiendo de la constante Type dada como ip_type
. Devuelve el ID de la cola si tiene éxito, o la constante RESOLVER_INVALID_ID en caso de error.