106 lines
3.2 KiB
Go
106 lines
3.2 KiB
Go
// Copyright 2012 The Go Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
package net
|
|
|
|
import (
|
|
"time"
|
|
)
|
|
|
|
// LookupHost looks up the given host using the local resolver.
|
|
// It returns an array of that host's addresses.
|
|
func LookupHost(host string) (addrs []string, err error) {
|
|
return lookupHost(host)
|
|
}
|
|
|
|
func lookupHostDeadline(host string, deadline time.Time) (addrs []string, err error) {
|
|
if deadline.IsZero() {
|
|
return lookupHost(host)
|
|
}
|
|
|
|
// TODO(bradfitz): consider pushing the deadline down into the
|
|
// name resolution functions. But that involves fixing it for
|
|
// the native Go resolver, cgo, Windows, etc.
|
|
//
|
|
// In the meantime, just use a goroutine. Most users affected
|
|
// by http://golang.org/issue/2631 are due to TCP connections
|
|
// to unresponsive hosts, not DNS.
|
|
timeout := deadline.Sub(time.Now())
|
|
if timeout <= 0 {
|
|
err = errTimeout
|
|
return
|
|
}
|
|
t := time.NewTimer(timeout)
|
|
defer t.Stop()
|
|
type res struct {
|
|
addrs []string
|
|
err error
|
|
}
|
|
resc := make(chan res, 1)
|
|
go func() {
|
|
a, err := lookupHost(host)
|
|
resc <- res{a, err}
|
|
}()
|
|
select {
|
|
case <-t.C:
|
|
err = errTimeout
|
|
case r := <-resc:
|
|
addrs, err = r.addrs, r.err
|
|
}
|
|
return
|
|
}
|
|
|
|
// LookupIP looks up host using the local resolver.
|
|
// It returns an array of that host's IPv4 and IPv6 addresses.
|
|
func LookupIP(host string) (addrs []IP, err error) {
|
|
return lookupIP(host)
|
|
}
|
|
|
|
// LookupPort looks up the port for the given network and service.
|
|
func LookupPort(network, service string) (port int, err error) {
|
|
return lookupPort(network, service)
|
|
}
|
|
|
|
// LookupCNAME returns the canonical DNS host for the given name.
|
|
// Callers that do not care about the canonical name can call
|
|
// LookupHost or LookupIP directly; both take care of resolving
|
|
// the canonical name as part of the lookup.
|
|
func LookupCNAME(name string) (cname string, err error) {
|
|
return lookupCNAME(name)
|
|
}
|
|
|
|
// LookupSRV tries to resolve an SRV query of the given service,
|
|
// protocol, and domain name. The proto is "tcp" or "udp".
|
|
// The returned records are sorted by priority and randomized
|
|
// by weight within a priority.
|
|
//
|
|
// LookupSRV constructs the DNS name to look up following RFC 2782.
|
|
// That is, it looks up _service._proto.name. To accommodate services
|
|
// publishing SRV records under non-standard names, if both service
|
|
// and proto are empty strings, LookupSRV looks up name directly.
|
|
func LookupSRV(service, proto, name string) (cname string, addrs []*SRV, err error) {
|
|
return lookupSRV(service, proto, name)
|
|
}
|
|
|
|
// LookupMX returns the DNS MX records for the given domain name sorted by preference.
|
|
func LookupMX(name string) (mx []*MX, err error) {
|
|
return lookupMX(name)
|
|
}
|
|
|
|
// LookupNS returns the DNS NS records for the given domain name.
|
|
func LookupNS(name string) (ns []*NS, err error) {
|
|
return lookupNS(name)
|
|
}
|
|
|
|
// LookupTXT returns the DNS TXT records for the given domain name.
|
|
func LookupTXT(name string) (txt []string, err error) {
|
|
return lookupTXT(name)
|
|
}
|
|
|
|
// LookupAddr performs a reverse lookup for the given address, returning a list
|
|
// of names mapping to that address.
|
|
func LookupAddr(addr string) (name []string, err error) {
|
|
return lookupAddr(addr)
|
|
}
|