]>
Commit | Line | Data |
---|---|---|
af92e385 ILT |
1 | // Copyright 2012 The Go Authors. All rights reserved. |
2 | // Use of this source code is governed by a BSD-style | |
3 | // license that can be found in the LICENSE file. | |
4 | ||
5 | package net | |
6 | ||
7 | // LookupHost looks up the given host using the local resolver. | |
8 | // It returns an array of that host's addresses. | |
9 | func LookupHost(host string) (addrs []string, err error) { | |
10 | return lookupHost(host) | |
11 | } | |
12 | ||
13 | // LookupIP looks up host using the local resolver. | |
14 | // It returns an array of that host's IPv4 and IPv6 addresses. | |
15 | func LookupIP(host string) (addrs []IP, err error) { | |
16 | return lookupIP(host) | |
17 | } | |
18 | ||
19 | // LookupPort looks up the port for the given network and service. | |
20 | func LookupPort(network, service string) (port int, err error) { | |
21 | return lookupPort(network, service) | |
22 | } | |
23 | ||
24 | // LookupCNAME returns the canonical DNS host for the given name. | |
25 | // Callers that do not care about the canonical name can call | |
26 | // LookupHost or LookupIP directly; both take care of resolving | |
27 | // the canonical name as part of the lookup. | |
28 | func LookupCNAME(name string) (cname string, err error) { | |
29 | return lookupCNAME(name) | |
30 | } | |
31 | ||
32 | // LookupSRV tries to resolve an SRV query of the given service, | |
33 | // protocol, and domain name. The proto is "tcp" or "udp". | |
34 | // The returned records are sorted by priority and randomized | |
35 | // by weight within a priority. | |
36 | // | |
37 | // LookupSRV constructs the DNS name to look up following RFC 2782. | |
38 | // That is, it looks up _service._proto.name. To accommodate services | |
39 | // publishing SRV records under non-standard names, if both service | |
40 | // and proto are empty strings, LookupSRV looks up name directly. | |
41 | func LookupSRV(service, proto, name string) (cname string, addrs []*SRV, err error) { | |
42 | return lookupSRV(service, proto, name) | |
43 | } | |
44 | ||
45 | // LookupMX returns the DNS MX records for the given domain name sorted by preference. | |
46 | func LookupMX(name string) (mx []*MX, err error) { | |
47 | return lookupMX(name) | |
48 | } | |
49 | ||
50 | // LookupTXT returns the DNS TXT records for the given domain name. | |
51 | func LookupTXT(name string) (txt []string, err error) { | |
52 | return lookupTXT(name) | |
53 | } | |
54 | ||
55 | // LookupAddr performs a reverse lookup for the given address, returning a list | |
56 | // of names mapping to that address. | |
57 | func LookupAddr(addr string) (name []string, err error) { | |
58 | return lookupAddr(addr) | |
59 | } |