struct Socket::Addrinfo

Overview

Domain name resolver.

Defined in:

Class Method Summary

Instance Method Summary

Instance methods inherited from struct Struct

==(other) : Bool ==, hash(hasher) hash, inspect(io : IO) : Nil inspect, pretty_print(pp) : Nil pretty_print, to_s(io : IO) : Nil to_s

Instance methods inherited from struct Value

==(other : JSON::Any)
==(other : YAML::Any)
==(other)
==
, dup dup

Instance methods inherited from class Object

!=(other) !=, !~(other) !~, ==(other) ==, ===(other : JSON::Any)
===(other : YAML::Any)
===(other)
===
, =~(other) =~, __crystal_pseudo_! : Bool __crystal_pseudo_!, __crystal_pseudo_as(type : Class) __crystal_pseudo_as, __crystal_pseudo_as?(type : Class) __crystal_pseudo_as?, __crystal_pseudo_is_a?(type : Class) : Bool __crystal_pseudo_is_a?, __crystal_pseudo_nil? : Bool __crystal_pseudo_nil?, __crystal_pseudo_responds_to?(name : Symbol) : Bool __crystal_pseudo_responds_to?, class class, dup dup, hash(hasher)
hash
hash
, in?(*values : Object) : Bool
in?(collection) : Bool
in?
, inspect : String
inspect(io : IO) : Nil
inspect
, itself itself, not_nil! not_nil!, pretty_inspect(width = 79, newline = "\n", indent = 0) : String pretty_inspect, pretty_print(pp : PrettyPrint) : Nil pretty_print, tap(&) tap, to_json
to_json(io : IO)
to_json
, to_pretty_json(indent : String = " ")
to_pretty_json(io : IO, indent : String = " ")
to_pretty_json
, to_s : String
to_s(io : IO) : Nil
to_s
, to_yaml(io : IO)
to_yaml
to_yaml
, try(&) try, unsafe_as(type : T.class) forall T unsafe_as

Class methods inherited from class Object

from_json(string_or_io, root : String)
from_json(string_or_io)
from_json
, from_yaml(string_or_io : String | IO) from_yaml

Class Method Detail

def self.resolve(domain, service, family : Family? = nil, type : Type = nil, protocol : Protocol = Protocol::IP, timeout = nil) : Array(Addrinfo) #

Resolves a domain that best matches the given options.

  • domain may be an IP address or a domain name.
  • service may be a port number or a service name. It must be specified, because different servers may handle the mail or http services for example.
  • family is optional and defaults to Family::UNSPEC
  • type is the intended socket type (e.g. Type::STREAM) and must be specified.
  • protocol is the intended socket protocol (e.g. Protocol::TCP) and should be specified.

Example:

require "socket"

addrinfos = Socket::Addrinfo.resolve("example.org", "http", type: Socket::Type::STREAM, protocol: Socket::Protocol::TCP)

def self.resolve(domain, service, family : Family? = nil, type : Type = nil, protocol : Protocol = Protocol::IP, timeout = nil, &) #

Resolves a domain that best matches the given options.

Yields each possible Addrinfo resolution since a domain may resolve to many IP. Implementations are supposed to try all the addresses until the socket is connected (or bound) or there are no addresses to try anymore.

Raising is an expensive operation, so instead of raising on a connect or bind error, just to rescue it immediately after, the block is expected to return the error instead, which will be raised once there are no more addresses to try.

The iteration will be stopped once the block returns something that isn't an Exception (e.g. a Socket or nil).


def self.tcp(domain, service, family = Family::UNSPEC, timeout = nil) : Array(Addrinfo) #

Resolves domain for the UDP protocol and returns an Array of possible Addrinfo. See #resolve for details.

Example:

require "socket"

addrinfos = Socket::Addrinfo.tcp("example.org", 80)

def self.tcp(domain, service, family = Family::UNSPEC, timeout = nil, &) #

Resolves a domain for the TCP protocol with STREAM type, and yields each possible Addrinfo. See #resolve for details.


def self.udp(domain, service, family = Family::UNSPEC, timeout = nil) : Array(Addrinfo) #

Resolves domain for the UDP protocol and returns an Array of possible Addrinfo. See #resolve for details.

Example:

require "socket"

addrinfos = Socket::Addrinfo.udp("example.org", 53)

def self.udp(domain, service, family = Family::UNSPEC, timeout = nil, &) #

Resolves a domain for the UDP protocol with DGRAM type, and yields each possible Addrinfo. See #resolve for details.


Instance Method Detail

def family : Family #

def ip_address #

Returns an IPAddress matching this addrinfo.


def protocol : Protocol #

def size : Int32 #

def to_unsafe #

def type : Type #