mirror of
https://github.com/golang/go
synced 2024-10-05 06:21:24 -06:00
aa0dda767a
This CL provides IPv6 scoped addressing zone support as defined in RFC 4007 for internet protocol family connection setups. Follwoing types and functions allow a literal IPv6 address with zone identifer as theirs parameter. pkg net, func Dial(string, string) (Conn, error) pkg net, func DialOpt(string, ...DialOption) (Conn, error) pkg net, func DialTimeout(string, string, time.Duration) (Conn, error) pkg net, func Listen(string, string) (Listener, error) pkg net, func ListenPacket(string, string) (PacketConn, error) pkg net, func ResolveIPAddr(string, string) (*IPAddr, error) pkg net, func ResolveTCPAddr(string, string) (*TCPAddr, error) pkg net, func ResolveUDPAddr(string, string) (*UDPAddr, error) pkg net, type IPAddr struct, Zone string pkg net, type TCPAddr struct, Zone string pkg net, type UDPAddr struct, Zone string Also follwoing methods return a literal IPv6 address with zone identifier string if possible. pkg net, method (*IPAddr) String() string pkg net, method (*TCPAddr) String() string pkg net, method (*UDPAddr) String() string Fixes #4234. Fixes #4501. Update #5081. R=rsc, iant CC=golang-dev https://golang.org/cl/6816116
53 lines
1.4 KiB
Go
53 lines
1.4 KiB
Go
// Copyright 2009 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.
|
|
|
|
// UDP sockets
|
|
|
|
package net
|
|
|
|
import "errors"
|
|
|
|
var ErrWriteToConnected = errors.New("use of WriteTo with pre-connected UDP")
|
|
|
|
// UDPAddr represents the address of a UDP end point.
|
|
type UDPAddr struct {
|
|
IP IP
|
|
Port int
|
|
Zone string // IPv6 scoped addressing zone
|
|
}
|
|
|
|
// Network returns the address's network name, "udp".
|
|
func (a *UDPAddr) Network() string { return "udp" }
|
|
|
|
func (a *UDPAddr) String() string {
|
|
if a == nil {
|
|
return "<nil>"
|
|
}
|
|
if a.Zone != "" {
|
|
return JoinHostPort(a.IP.String()+"%"+a.Zone, itoa(a.Port))
|
|
}
|
|
return JoinHostPort(a.IP.String(), itoa(a.Port))
|
|
}
|
|
|
|
// ResolveUDPAddr parses addr as a UDP address of the form "host:port"
|
|
// or "[ipv6-host%zone]:port" and resolves a pair of domain name and
|
|
// port name on the network net, which must be "udp", "udp4" or
|
|
// "udp6". A literal address or host name for IPv6 must be enclosed
|
|
// in square brackets, as in "[::1]:80", "[ipv6-host]:http" or
|
|
// "[ipv6-host%zone]:80".
|
|
func ResolveUDPAddr(net, addr string) (*UDPAddr, error) {
|
|
switch net {
|
|
case "udp", "udp4", "udp6":
|
|
case "": // a hint wildcard for Go 1.0 undocumented behavior
|
|
net = "udp"
|
|
default:
|
|
return nil, UnknownNetworkError(net)
|
|
}
|
|
a, err := resolveInternetAddr(net, addr, noDeadline)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return a.(*UDPAddr), nil
|
|
}
|