| // Copyright 2013 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 ipv6 | |
| import ( | |
| "net" | |
| "time" | |
| "golang.org/x/net/internal/socket" | |
| ) | |
| // BUG(mikio): On Windows, the JoinSourceSpecificGroup, | |
| // LeaveSourceSpecificGroup, ExcludeSourceSpecificGroup and | |
| // IncludeSourceSpecificGroup methods of PacketConn are not | |
| // implemented. | |
| // A Conn represents a network endpoint that uses IPv6 transport. | |
| // It allows to set basic IP-level socket options such as traffic | |
| // class and hop limit. | |
| type Conn struct { | |
| genericOpt | |
| } | |
| type genericOpt struct { | |
| *socket.Conn | |
| } | |
| func (c *genericOpt) ok() bool { return c != nil && c.Conn != nil } | |
| // PathMTU returns a path MTU value for the destination associated | |
| // with the endpoint. | |
| func (c *Conn) PathMTU() (int, error) { | |
| if !c.ok() { | |
| return 0, errInvalidConn | |
| } | |
| so, ok := sockOpts[ssoPathMTU] | |
| if !ok { | |
| return 0, errNotImplemented | |
| } | |
| _, mtu, err := so.getMTUInfo(c.Conn) | |
| if err != nil { | |
| return 0, err | |
| } | |
| return mtu, nil | |
| } | |
| // NewConn returns a new Conn. | |
| func NewConn(c net.Conn) *Conn { | |
| cc, _ := socket.NewConn(c) | |
| return &Conn{ | |
| genericOpt: genericOpt{Conn: cc}, | |
| } | |
| } | |
| // A PacketConn represents a packet network endpoint that uses IPv6 | |
| // transport. It is used to control several IP-level socket options | |
| // including IPv6 header manipulation. It also provides datagram | |
| // based network I/O methods specific to the IPv6 and higher layer | |
| // protocols such as OSPF, GRE, and UDP. | |
| type PacketConn struct { | |
| genericOpt | |
| dgramOpt | |
| payloadHandler | |
| } | |
| type dgramOpt struct { | |
| *socket.Conn | |
| } | |
| func (c *dgramOpt) ok() bool { return c != nil && c.Conn != nil } | |
| // SetControlMessage allows to receive the per packet basis IP-level | |
| // socket options. | |
| func (c *PacketConn) SetControlMessage(cf ControlFlags, on bool) error { | |
| if !c.payloadHandler.ok() { | |
| return errInvalidConn | |
| } | |
| return setControlMessage(c.dgramOpt.Conn, &c.payloadHandler.rawOpt, cf, on) | |
| } | |
| // SetDeadline sets the read and write deadlines associated with the | |
| // endpoint. | |
| func (c *PacketConn) SetDeadline(t time.Time) error { | |
| if !c.payloadHandler.ok() { | |
| return errInvalidConn | |
| } | |
| return c.payloadHandler.SetDeadline(t) | |
| } | |
| // SetReadDeadline sets the read deadline associated with the | |
| // endpoint. | |
| func (c *PacketConn) SetReadDeadline(t time.Time) error { | |
| if !c.payloadHandler.ok() { | |
| return errInvalidConn | |
| } | |
| return c.payloadHandler.SetReadDeadline(t) | |
| } | |
| // SetWriteDeadline sets the write deadline associated with the | |
| // endpoint. | |
| func (c *PacketConn) SetWriteDeadline(t time.Time) error { | |
| if !c.payloadHandler.ok() { | |
| return errInvalidConn | |
| } | |
| return c.payloadHandler.SetWriteDeadline(t) | |
| } | |
| // Close closes the endpoint. | |
| func (c *PacketConn) Close() error { | |
| if !c.payloadHandler.ok() { | |
| return errInvalidConn | |
| } | |
| return c.payloadHandler.Close() | |
| } | |
| // NewPacketConn returns a new PacketConn using c as its underlying | |
| // transport. | |
| func NewPacketConn(c net.PacketConn) *PacketConn { | |
| cc, _ := socket.NewConn(c.(net.Conn)) | |
| return &PacketConn{ | |
| genericOpt: genericOpt{Conn: cc}, | |
| dgramOpt: dgramOpt{Conn: cc}, | |
| payloadHandler: payloadHandler{PacketConn: c, Conn: cc}, | |
| } | |
| } |