mirror of
https://github.com/golang/net.git
synced 2026-03-31 18:37:08 +09:00
48359f4f60
This change provides message IO functionality that may support the construction of modern datagram transport protocols. The modern datagram transport protocols on a multihomed node basically need to control each packet path for traffic engineering by using information belongs to network- or link-layer implementation. In addtion, it's desirable to be able to do simultaneous transmission across multiple network- or link-layer adjacencies wihtout any additional cost. The ReadBatch and WriteBatch methods of PacketConn can be used to read and write an IO message that contains the information of network- or link-layer implementation, and read and write a batch of IO messages on Linux. The Marshal and Parse methods of ControlMessage can help to marshal and parse information contained in IO messages. Updates golang/go#3661. Change-Id: I94484e2e135f4969ddf5c2548bf6be0cc16888bf Reviewed-on: https://go-review.googlesource.com/38276 Run-TryBot: Mikio Hara <mikioh.mikioh@gmail.com> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Ian Lance Taylor <iant@golang.org>
36 lines
1.1 KiB
Go
36 lines
1.1 KiB
Go
// 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.
|
|
|
|
// +build !nacl,!plan9,!windows
|
|
|
|
package ipv6
|
|
|
|
import (
|
|
"net"
|
|
"syscall"
|
|
)
|
|
|
|
// ReadFrom reads a payload of the received IPv6 datagram, from the
|
|
// endpoint c, copying the payload into b. It returns the number of
|
|
// bytes copied into b, the control message cm and the source address
|
|
// src of the received datagram.
|
|
func (c *payloadHandler) ReadFrom(b []byte) (n int, cm *ControlMessage, src net.Addr, err error) {
|
|
if !c.ok() {
|
|
return 0, nil, nil, syscall.EINVAL
|
|
}
|
|
return c.readFrom(b)
|
|
}
|
|
|
|
// WriteTo writes a payload of the IPv6 datagram, to the destination
|
|
// address dst through the endpoint c, copying the payload from b. It
|
|
// returns the number of bytes written. The control message cm allows
|
|
// the IPv6 header fields and the datagram path to be specified. The
|
|
// cm may be nil if control of the outgoing datagram is not required.
|
|
func (c *payloadHandler) WriteTo(b []byte, cm *ControlMessage, dst net.Addr) (n int, err error) {
|
|
if !c.ok() {
|
|
return 0, syscall.EINVAL
|
|
}
|
|
return c.writeTo(b, cm, dst)
|
|
}
|