TCPSocket.gethostbyname

TCPSocket.gethostbyname(hostname) => [official_hostname, alias_hostnames, address_family, *address_list]

static VALUE
tcp_s_gethostbyname(VALUE obj, VALUE host)
{
    rb_warn("TCPSocket.gethostbyname is deprecated; use Addrinfo.getaddrinfo instead.");
    struct rb_addrinfo *res =
        rsock_addrinfo(host, Qnil, AF_UNSPEC, SOCK_STREAM, AI_CANONNAME);
    return rsock_make_hostent(host, res, tcp_sockaddr);
}

Use Addrinfo.getaddrinfo instead. This method is deprecated for the following reasons:

The 3rd element of the result is the address family of the first address. The address families of the rest of the addresses are not returned.
gethostbyname() may take a long time and it may block other threads. (GVL cannot be released since gethostbyname() is not thread safe.)
This method uses gethostbyname() function already removed from POSIX.

This method lookups host information by hostname.

Example

TCPSocket.gethostbyname("localhost")
#=> ["localhost", ["hal"], 2, "127.0.0.1"]

See also .new also in 4.0 · 3.4 · 3.2 · 3.1 · 3.0

next ›.new