Source file src/pkg/net/doc.go
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 }