runtimes/google/ipc/stream/vc/vc_test.go - release.go.x.ref - Git at Google

 // Use a different package for the tests to ensure that only the exported API is used.

 package vc_test

 import (
 	"bytes"
 	"fmt"
 	"io"
 	"net"
 	"reflect"
 	"runtime"
 	"strings"
 	"sync"
 	"testing"

 	"v.io/core/veyron/lib/testutil"
 	tsecurity "v.io/core/veyron/lib/testutil/security"
 	"v.io/core/veyron/runtimes/google/ipc/stream/id"
 	"v.io/core/veyron/runtimes/google/ipc/stream/vc"
 	"v.io/core/veyron/runtimes/google/lib/bqueue"
 	"v.io/core/veyron/runtimes/google/lib/bqueue/drrqueue"
 	"v.io/core/veyron/runtimes/google/lib/iobuf"

 	"v.io/core/veyron2/context"
 	"v.io/core/veyron2/ipc/stream"
 	"v.io/core/veyron2/ipc/version"
 	"v.io/core/veyron2/naming"
 	"v.io/core/veyron2/options"
 	"v.io/core/veyron2/security"
 )

 func init() { testutil.Init() }

 const (
 	// Convenience alias to avoid conflicts between the package name "vc" and variables called "vc".
 	DefaultBytesBufferedPerFlow = vc.DefaultBytesBufferedPerFlow
 	// Shorthands
 	SecurityNone = options.VCSecurityNone
 	SecurityTLS  = options.VCSecurityConfidential

 	LatestVersion = version.IPCVersion5
 )

 // testFlowEcho writes a random string of 'size' bytes on the flow and then
 // ensures that the same string is read back.
 func testFlowEcho(t *testing.T, flow stream.Flow, size int) {
 	defer flow.Close()
 	wrote := testutil.RandomBytes(size)
 	go func() {
 		buf := wrote
 		for len(buf) > 0 {
 			limit := 1 + testutil.Rand.Intn(len(buf)) // Random number in [1, n]
 			n, err := flow.Write(buf[:limit])
 			if n != limit || err != nil {
 				t.Errorf("Write returned (%d, %v) want (%d, nil)", n, err, limit)
 			}
 			buf = buf[limit:]
 		}
 	}()

 	total := 0
 	read := make([]byte, size)
 	buf := read
 	for total < size {
 		n, err := flow.Read(buf)
 		if err != nil {
 			t.Error(err)
 			return
 		}
 		total += n
 		buf = buf[n:]
 	}
 	if bytes.Compare(read, wrote) != 0 {
 		t.Errorf("Data read != data written")
 	}
 }

 func TestHandshake(t *testing.T) {
 	// When SecurityNone is used, the blessings should not be sent over the wire.
 	var (
 		client    = tsecurity.NewPrincipal("client")
 		server    = tsecurity.NewPrincipal("server")
 		h, vc     = New(SecurityNone, LatestVersion, client, server)
 		flow, err = vc.Connect()
 	)
 	defer h.Close()
 	if err != nil {
 		t.Fatal(err)
 	}
 	if flow.RemoteBlessings() != nil {
 		t.Errorf("Server sent blessing %v over insecure transport", flow.RemoteBlessings())
 	}
 	if flow.LocalBlessings() != nil {
 		t.Errorf("Client sent blessing %v over insecure transport", flow.LocalBlessings())
 	}
 }

 func testFlowAuthN(flow stream.Flow, serverBlessings security.Blessings, serverDischarges map[string]security.Discharge, clientBlessings security.Blessings) error {
 	if got, want := flow.RemoteBlessings(), serverBlessings; !reflect.DeepEqual(got, want) {
 		return fmt.Errorf("Got blessings %v from server, want %v", got, want)
 	}
 	if got, want := flow.RemoteDischarges(), serverDischarges; !reflect.DeepEqual(got, want) {
 		return fmt.Errorf("Got discharges %v from server, want %v", got, want)
 	}
 	if got, want := flow.LocalBlessings(), clientBlessings; !reflect.DeepEqual(got, want) {
 		return fmt.Errorf("Client shared %v, wanted %v", got, want)
 	}
 	return nil
 }

 func addToRoots(principals []security.Principal, blessings []security.Blessings) error {
 	for _, p := range principals {
 		for _, b := range blessings {
 			if err := p.AddToRoots(b); err != nil {
 				return fmt.Errorf("%v.AddToRoots(%v): %v", p, b, err)
 			}
 		}
 	}
 	return nil
 }

 func TestHandshakeTLS(t *testing.T) {
 	var (
 		client  = tsecurity.NewPrincipal("client")
 		server1 = tsecurity.NewPrincipal("server1")
 		server2 = tsecurity.NewPrincipal("server2")
 	)
 	// Setup client so that is has a specific blessing for S2.
 	forServer1 := client.BlessingStore().Default()
 	forServer2, err := client.BlessSelf("forS2")
 	if err != nil {
 		t.Fatal(err)
 	}
 	client.BlessingStore().Set(nil, security.AllPrincipals)
 	client.BlessingStore().Set(forServer1, security.BlessingPattern("server1"))
 	client.BlessingStore().Set(forServer2, security.BlessingPattern("server2"))

 	// Make the clients and servers recognize each other as valid root certificate providers.
 	if err := addToRoots([]security.Principal{client, server1, server2}, []security.Blessings{server1.BlessingStore().Default(), server2.BlessingStore().Default(), client.BlessingStore().Default()}); err != nil {
 		t.Fatal(err)
 	}

 	// Test handshake between client and server1
 	h, vc := New(SecurityTLS, LatestVersion, client, server1)
 	defer h.Close()
 	flow, err := vc.Connect()
 	if err != nil {
 		t.Fatalf("Unable to create flow: %v", err)
 	}
 	if err := testFlowAuthN(flow, server1.BlessingStore().Default(), nil, forServer1); err != nil {
 		t.Error(err)
 	}

 	// Test handshake between client and server2
 	h, vc = New(SecurityTLS, LatestVersion, client, server2)
 	defer h.Close()
 	flow, err = vc.Connect()
 	if err != nil {
 		t.Fatalf("Unable to create flow: %v", err)
 	}
 	if err := testFlowAuthN(flow, server2.BlessingStore().Default(), nil, forServer2); err != nil {
 		t.Error(err)
 	}
 }

 type mockDischargeClient []security.Discharge

 func (m mockDischargeClient) PrepareDischarges(_ context.T, forcaveats []security.ThirdPartyCaveat, impetus security.DischargeImpetus) []security.Discharge {
 	return m
 }
 func (mockDischargeClient) Invalidate(...security.Discharge) {}
 func (mockDischargeClient) IPCStreamListenerOpt()            {}
 func (mockDischargeClient) IPCStreamVCOpt()                  {}
 func (mockDischargeClient) IPCServerOpt()                    {}
 func (mockDischargeClient) IPCClientOpt()                    {}

 // Test that mockDischargeClient implements vc.DischargeClient.
 var _ vc.DischargeClient = (mockDischargeClient)(nil)

 func TestHandshakeWithDischargesTLS(t *testing.T) {
 	newCaveat := func(validator security.CaveatValidator) security.Caveat {
 		cav, err := security.NewCaveat(validator)
 		if err != nil {
 			t.Fatal(err)
 		}
 		return cav
 	}
 	var (
 		discharger = tsecurity.NewPrincipal("discharger")
 		client     = tsecurity.NewPrincipal()
 		server     = tsecurity.NewPrincipal()
 		root       = tsecurity.NewIDProvider("root")
 	)
 	tpcav, err := security.NewPublicKeyCaveat(discharger.PublicKey(), "irrelevant", security.ThirdPartyRequirements{}, security.UnconstrainedUse())
 	if err != nil {
 		t.Fatal(err)
 	}
 	dis, err := discharger.MintDischarge(tpcav, security.UnconstrainedUse())
 	if err != nil {
 		t.Fatal(err)
 	}

 	// Setup 'client' and 'server' so that they use a blessing from 'root' with a third-party caveat
 	// during VC handshake.
 	if err := root.Bless(client, "client", newCaveat(tpcav)); err != nil {
 		t.Fatal(err)
 	}
 	if err := root.Bless(server, "server", newCaveat(tpcav)); err != nil {
 		t.Fatal(err)
 	}

 	// Test handshake without Discharges
 	h, vc := New(SecurityTLS, LatestVersion, client, server, mockDischargeClient(nil))
 	defer h.Close()
 	flow, err := vc.Connect()
 	if err != nil {
 		t.Fatalf("Unable to create flow: %v", err)
 	}
 	if err := testFlowAuthN(flow, server.BlessingStore().Default(), nil, client.BlessingStore().Default()); err != nil {
 		t.Error(err)
 	}

 	// Test handshake with Discharges
 	h, vc = New(SecurityTLS, LatestVersion, client, server, mockDischargeClient([]security.Discharge{dis}))
 	defer h.Close()
 	flow, err = vc.Connect()
 	if err != nil {
 		t.Fatalf("Unable to create flow: %v", err)
 	}
 	if err := testFlowAuthN(flow, server.BlessingStore().Default(), map[string]security.Discharge{dis.ID(): dis}, client.BlessingStore().Default()); err != nil {
 		t.Error(err)
 	}
 }

 func testConnect_Small(t *testing.T, security options.VCSecurityLevel) {
 	h, vc := New(security, LatestVersion, tsecurity.NewPrincipal("client"), tsecurity.NewPrincipal("server"))
 	defer h.Close()
 	flow, err := vc.Connect()
 	if err != nil {
 		t.Fatal(err)
 	}
 	testFlowEcho(t, flow, 10)
 }
 func TestConnect_Small(t *testing.T)    { testConnect_Small(t, SecurityNone) }
 func TestConnect_SmallTLS(t *testing.T) { testConnect_Small(t, SecurityTLS) }

 func testConnect(t *testing.T, security options.VCSecurityLevel) {
 	h, vc := New(security, LatestVersion, tsecurity.NewPrincipal("client"), tsecurity.NewPrincipal("server"))
 	defer h.Close()
 	flow, err := vc.Connect()
 	if err != nil {
 		t.Fatal(err)
 	}
 	testFlowEcho(t, flow, 10*DefaultBytesBufferedPerFlow)
 }
 func TestConnect(t *testing.T)    { testConnect(t, SecurityNone) }
 func TestConnectTLS(t *testing.T) { testConnect(t, SecurityTLS) }

 func testConnect_Version4(t *testing.T, security options.VCSecurityLevel) {
 	h, vc := New(security, version.IPCVersion4, tsecurity.NewPrincipal("client"), tsecurity.NewPrincipal("server"))
 	defer h.Close()
 	flow, err := vc.Connect()
 	if err != nil {
 		t.Fatal(err)
 	}
 	testFlowEcho(t, flow, 10)
 }
 func TestConnect_Version4(t *testing.T)    { testConnect_Version4(t, SecurityNone) }
 func TestConnect_Version4TLS(t *testing.T) { testConnect_Version4(t, SecurityTLS) }

 // helper function for testing concurrent operations on multiple flows over the
 // same VC.  Such tests are most useful when running the race detector.
 // (go test -race ...)
 func testConcurrentFlows(t *testing.T, security options.VCSecurityLevel, flows, gomaxprocs int) {
 	mp := runtime.GOMAXPROCS(gomaxprocs)
 	defer runtime.GOMAXPROCS(mp)
 	h, vc := New(security, LatestVersion, tsecurity.NewPrincipal("client"), tsecurity.NewPrincipal("server"))
 	defer h.Close()

 	var wg sync.WaitGroup
 	wg.Add(flows)
 	for i := 0; i < flows; i++ {
 		go func(n int) {
 			defer wg.Done()
 			flow, err := vc.Connect()
 			if err != nil {
 				t.Error(err)
 			} else {
 				testFlowEcho(t, flow, (n+1)*DefaultBytesBufferedPerFlow)
 			}
 		}(i)
 	}
 	wg.Wait()
 }

 func TestConcurrentFlows_1(t *testing.T)    { testConcurrentFlows(t, SecurityNone, 10, 1) }
 func TestConcurrentFlows_1TLS(t *testing.T) { testConcurrentFlows(t, SecurityTLS, 10, 1) }

 func TestConcurrentFlows_10(t *testing.T)    { testConcurrentFlows(t, SecurityNone, 10, 10) }
 func TestConcurrentFlows_10TLS(t *testing.T) { testConcurrentFlows(t, SecurityTLS, 10, 10) }

 func testListen(t *testing.T, security options.VCSecurityLevel) {
 	data := "the dark knight"
 	h, vc := New(security, LatestVersion, tsecurity.NewPrincipal("client"), tsecurity.NewPrincipal("server"))
 	defer h.Close()
 	if err := h.VC.AcceptFlow(id.Flow(21)); err == nil {
 		t.Errorf("Expected AcceptFlow on a new flow to fail as Listen was not called")
 	}

 	ln, err := vc.Listen()
 	if err != nil {
 		t.Fatalf("vc.Listen failed: %v", err)
 		return
 	}
 	_, err = vc.Listen()
 	if err == nil {
 		t.Fatalf("Second call to vc.Listen should have failed")
 		return
 	}

 	if err := h.VC.AcceptFlow(id.Flow(23)); err != nil {
 		t.Fatal(err)
 	}
 	cipherdata, err := h.otherEnd.VC.Encrypt(id.Flow(23), iobuf.NewSlice([]byte(data)))
 	if err != nil {
 		t.Fatal(err)
 	}
 	if err := h.VC.DispatchPayload(id.Flow(23), cipherdata); err != nil {
 		t.Fatal(err)
 	}
 	flow, err := ln.Accept()
 	if err != nil {
 		t.Fatal(err)
 	}
 	if err := ln.Close(); err != nil {
 		t.Error(err)
 	}
 	flow.Close()
 	var buf [4096]byte
 	if n, err := flow.Read(buf[:]); n != len(data) || err != nil || string(buf[:n]) != data {
 		t.Errorf("Got (%d, %v) = %q, want (%d, nil) = %q", n, err, string(buf[:n]), len(data), data)
 	}
 	if n, err := flow.Read(buf[:]); n != 0 || err != io.EOF {
 		t.Errorf("Got (%d, %v) want (0, %v)", n, err, io.EOF)
 	}
 }
 func TestListen(t *testing.T)    { testListen(t, SecurityNone) }
 func TestListenTLS(t *testing.T) { testListen(t, SecurityTLS) }

 func testNewFlowAfterClose(t *testing.T, security options.VCSecurityLevel) {
 	h, _ := New(security, LatestVersion, tsecurity.NewPrincipal("client"), tsecurity.NewPrincipal("server"))
 	defer h.Close()
 	h.VC.Close("reason")
 	if err := h.VC.AcceptFlow(id.Flow(10)); err == nil {
 		t.Fatalf("New flows should not be accepted once the VC is closed")
 	}
 }
 func TestNewFlowAfterClose(t *testing.T)    { testNewFlowAfterClose(t, SecurityNone) }
 func TestNewFlowAfterCloseTLS(t *testing.T) { testNewFlowAfterClose(t, SecurityTLS) }

 func testConnectAfterClose(t *testing.T, security options.VCSecurityLevel) {
 	h, vc := New(security, LatestVersion, tsecurity.NewPrincipal("client"), tsecurity.NewPrincipal("server"))
 	defer h.Close()
 	h.VC.Close("myerr")
 	if f, err := vc.Connect(); f != nil || err == nil || !strings.Contains(err.Error(), "myerr") {
 		t.Fatalf("Got (%v, %v), want (nil, %q)", f, err, "myerr")
 	}
 }
 func TestConnectAfterClose(t *testing.T)    { testConnectAfterClose(t, SecurityNone) }
 func TestConnectAfterCloseTLS(t *testing.T) { testConnectAfterClose(t, SecurityTLS) }

 // helper implements vc.Helper and also sets up a single VC.
 type helper struct {
 	VC *vc.VC
 	bq bqueue.T

 	mu       sync.Mutex
 	otherEnd *helper // GUARDED_BY(mu)
 }

 // New creates both ends of a VC but returns only the "client" end (i.e., the
 // one that initiated the VC). The "server" end (the one that "accepted" the VC)
 // listens for flows and simply echoes data read.
 func New(security options.VCSecurityLevel, v version.IPCVersion, client, server security.Principal, dischargeClients ...vc.DischargeClient) (*helper, stream.VC) {
 	clientH := &helper{bq: drrqueue.New(vc.MaxPayloadSizeBytes)}
 	serverH := &helper{bq: drrqueue.New(vc.MaxPayloadSizeBytes)}
 	clientH.otherEnd = serverH
 	serverH.otherEnd = clientH

 	clientEP := endpoint(naming.FixedRoutingID(0xcccccccccccccccc))
 	serverEP := endpoint(naming.FixedRoutingID(0x5555555555555555))

 	vci := id.VC(1234)

 	clientParams := vc.Params{
 		VCI:      vci,
 		Dialed:   true,
 		LocalEP:  clientEP,
 		RemoteEP: serverEP,
 		Pool:     iobuf.NewPool(0),
 		Helper:   clientH,
 		Version:  v,
 	}
 	serverParams := vc.Params{
 		VCI:      vci,
 		LocalEP:  serverEP,
 		RemoteEP: clientEP,
 		Pool:     iobuf.NewPool(0),
 		Helper:   serverH,
 		Version:  v,
 	}

 	clientH.VC = vc.InternalNew(clientParams)
 	serverH.VC = vc.InternalNew(serverParams)
 	clientH.AddReceiveBuffers(vci, vc.SharedFlowID, vc.DefaultBytesBufferedPerFlow)

 	go clientH.pipeLoop(serverH.VC)
 	go serverH.pipeLoop(clientH.VC)

 	lopts := []stream.ListenerOpt{vc.LocalPrincipal{server}, security}
 	vcopts := []stream.VCOpt{vc.LocalPrincipal{client}, security}

 	if len(dischargeClients) > 0 {
 		lopts = append(lopts, dischargeClients[0])
 		vcopts = append(vcopts, dischargeClients[0])
 	}

 	c := serverH.VC.HandshakeAcceptedVC(lopts...)
 	if err := clientH.VC.HandshakeDialedVC(vcopts...); err != nil {
 		panic(err)
 	}
 	hr := <-c
 	if hr.Error != nil {
 		panic(hr.Error)
 	}
 	go acceptLoop(hr.Listener)
 	return clientH, clientH.VC
 }

 // pipeLoop forwards slices written to h.bq to dst.
 func (h *helper) pipeLoop(dst *vc.VC) {
 	for {
 		w, bufs, err := h.bq.Get(nil)
 		if err != nil {
 			return
 		}
 		fid := id.Flow(w.ID())
 		for _, b := range bufs {
 			cipher, err := h.VC.Encrypt(fid, b)
 			if err != nil {
 				panic(err)
 			}
 			if err := dst.DispatchPayload(fid, cipher); err != nil {
 				panic(err)
 				return
 			}
 		}
 		if w.IsDrained() {
 			h.VC.ShutdownFlow(fid)
 			dst.ShutdownFlow(fid)
 		}
 	}
 }

 func acceptLoop(ln stream.Listener) {
 	for {
 		f, err := ln.Accept()
 		if err != nil {
 			return
 		}
 		go echoLoop(f)
 	}
 }

 func echoLoop(flow stream.Flow) {
 	var buf [vc.DefaultBytesBufferedPerFlow * 20]byte
 	for {
 		n, err := flow.Read(buf[:])
 		if err == io.EOF {
 			return
 		}
 		if err == nil {
 			_, err = flow.Write(buf[:n])
 		}
 		if err != nil {
 			panic(err)
 		}
 	}
 }

 func (h *helper) NotifyOfNewFlow(vci id.VC, fid id.Flow, bytes uint) {
 	h.mu.Lock()
 	if h.otherEnd != nil {
 		if err := h.otherEnd.VC.AcceptFlow(fid); err != nil {
 			panic(err)
 		}
 		h.otherEnd.VC.ReleaseCounters(fid, uint32(bytes))
 	}
 	h.mu.Unlock()
 }

 func (h *helper) AddReceiveBuffers(vci id.VC, fid id.Flow, bytes uint) {
 	h.mu.Lock()
 	if h.otherEnd != nil {
 		h.otherEnd.VC.ReleaseCounters(fid, uint32(bytes))
 	}
 	h.mu.Unlock()
 }

 func (h *helper) NewWriter(vci id.VC, fid id.Flow) (bqueue.Writer, error) {
 	return h.bq.NewWriter(bqueue.ID(fid), 0, DefaultBytesBufferedPerFlow)
 }

 func (h *helper) Close() {
 	h.VC.Close("helper closed")
 	h.bq.Close()
 	h.mu.Lock()
 	otherEnd := h.otherEnd
 	h.otherEnd = nil
 	h.mu.Unlock()
 	if otherEnd != nil {
 		otherEnd.mu.Lock()
 		otherEnd.otherEnd = nil
 		otherEnd.mu.Unlock()
 		otherEnd.Close()
 	}
 }

 type endpoint naming.RoutingID

 func (e endpoint) Network() string             { return "test" }
 func (e endpoint) VersionedString(int) string  { return e.String() }
 func (e endpoint) String() string              { return naming.RoutingID(e).String() }
 func (e endpoint) RoutingID() naming.RoutingID { return naming.RoutingID(e) }
 func (e endpoint) Addr() net.Addr              { return nil }
 func (e endpoint) ServesMountTable() bool      { return false }
	// Use a different package for the tests to ensure that only the exported API is used.

	package vc_test

	import (
	"bytes"
	"fmt"
	"io"
	"net"
	"reflect"
	"runtime"
	"strings"
	"sync"
	"testing"

	"v.io/core/veyron/lib/testutil"
	tsecurity "v.io/core/veyron/lib/testutil/security"
	"v.io/core/veyron/runtimes/google/ipc/stream/id"
	"v.io/core/veyron/runtimes/google/ipc/stream/vc"
	"v.io/core/veyron/runtimes/google/lib/bqueue"
	"v.io/core/veyron/runtimes/google/lib/bqueue/drrqueue"
	"v.io/core/veyron/runtimes/google/lib/iobuf"

	"v.io/core/veyron2/context"
	"v.io/core/veyron2/ipc/stream"
	"v.io/core/veyron2/ipc/version"
	"v.io/core/veyron2/naming"
	"v.io/core/veyron2/options"
	"v.io/core/veyron2/security"
	)

	func init() { testutil.Init() }

	const (
	// Convenience alias to avoid conflicts between the package name "vc" and variables called "vc".
	DefaultBytesBufferedPerFlow = vc.DefaultBytesBufferedPerFlow
	// Shorthands
	SecurityNone = options.VCSecurityNone
	SecurityTLS = options.VCSecurityConfidential

	LatestVersion = version.IPCVersion5
	)

	// testFlowEcho writes a random string of 'size' bytes on the flow and then
	// ensures that the same string is read back.
	func testFlowEcho(t *testing.T, flow stream.Flow, size int) {
	defer flow.Close()
	wrote := testutil.RandomBytes(size)
	go func() {
	buf := wrote
	for len(buf) > 0 {
	limit := 1 + testutil.Rand.Intn(len(buf)) // Random number in [1, n]
	n, err := flow.Write(buf[:limit])
	if n != limit \|\| err != nil {
	t.Errorf("Write returned (%d, %v) want (%d, nil)", n, err, limit)
	}
	buf = buf[limit:]
	}
	}()

	total := 0
	read := make([]byte, size)
	buf := read
	for total < size {
	n, err := flow.Read(buf)
	if err != nil {
	t.Error(err)
	return
	}
	total += n
	buf = buf[n:]
	}
	if bytes.Compare(read, wrote) != 0 {
	t.Errorf("Data read != data written")
	}
	}

	func TestHandshake(t *testing.T) {
	// When SecurityNone is used, the blessings should not be sent over the wire.
	var (
	client = tsecurity.NewPrincipal("client")
	server = tsecurity.NewPrincipal("server")
	h, vc = New(SecurityNone, LatestVersion, client, server)
	flow, err = vc.Connect()
	)
	defer h.Close()
	if err != nil {
	t.Fatal(err)
	}
	if flow.RemoteBlessings() != nil {
	t.Errorf("Server sent blessing %v over insecure transport", flow.RemoteBlessings())
	}
	if flow.LocalBlessings() != nil {
	t.Errorf("Client sent blessing %v over insecure transport", flow.LocalBlessings())
	}
	}

	func testFlowAuthN(flow stream.Flow, serverBlessings security.Blessings, serverDischarges map[string]security.Discharge, clientBlessings security.Blessings) error {
	if got, want := flow.RemoteBlessings(), serverBlessings; !reflect.DeepEqual(got, want) {
	return fmt.Errorf("Got blessings %v from server, want %v", got, want)
	}
	if got, want := flow.RemoteDischarges(), serverDischarges; !reflect.DeepEqual(got, want) {
	return fmt.Errorf("Got discharges %v from server, want %v", got, want)
	}
	if got, want := flow.LocalBlessings(), clientBlessings; !reflect.DeepEqual(got, want) {
	return fmt.Errorf("Client shared %v, wanted %v", got, want)
	}
	return nil
	}

	func addToRoots(principals []security.Principal, blessings []security.Blessings) error {
	for _, p := range principals {
	for _, b := range blessings {
	if err := p.AddToRoots(b); err != nil {
	return fmt.Errorf("%v.AddToRoots(%v): %v", p, b, err)
	}
	}
	}
	return nil
	}

	func TestHandshakeTLS(t *testing.T) {
	var (
	client = tsecurity.NewPrincipal("client")
	server1 = tsecurity.NewPrincipal("server1")
	server2 = tsecurity.NewPrincipal("server2")
	)
	// Setup client so that is has a specific blessing for S2.
	forServer1 := client.BlessingStore().Default()
	forServer2, err := client.BlessSelf("forS2")
	if err != nil {
	t.Fatal(err)
	}
	client.BlessingStore().Set(nil, security.AllPrincipals)
	client.BlessingStore().Set(forServer1, security.BlessingPattern("server1"))
	client.BlessingStore().Set(forServer2, security.BlessingPattern("server2"))

	// Make the clients and servers recognize each other as valid root certificate providers.
	if err := addToRoots([]security.Principal{client, server1, server2}, []security.Blessings{server1.BlessingStore().Default(), server2.BlessingStore().Default(), client.BlessingStore().Default()}); err != nil {
	t.Fatal(err)
	}

	// Test handshake between client and server1
	h, vc := New(SecurityTLS, LatestVersion, client, server1)
	defer h.Close()
	flow, err := vc.Connect()
	if err != nil {
	t.Fatalf("Unable to create flow: %v", err)
	}
	if err := testFlowAuthN(flow, server1.BlessingStore().Default(), nil, forServer1); err != nil {
	t.Error(err)
	}

	// Test handshake between client and server2
	h, vc = New(SecurityTLS, LatestVersion, client, server2)
	defer h.Close()
	flow, err = vc.Connect()
	if err != nil {
	t.Fatalf("Unable to create flow: %v", err)
	}
	if err := testFlowAuthN(flow, server2.BlessingStore().Default(), nil, forServer2); err != nil {
	t.Error(err)
	}
	}

	type mockDischargeClient []security.Discharge

	func (m mockDischargeClient) PrepareDischarges(_ context.T, forcaveats []security.ThirdPartyCaveat, impetus security.DischargeImpetus) []security.Discharge {
	return m
	}
	func (mockDischargeClient) Invalidate(...security.Discharge) {}
	func (mockDischargeClient) IPCStreamListenerOpt() {}
	func (mockDischargeClient) IPCStreamVCOpt() {}
	func (mockDischargeClient) IPCServerOpt() {}
	func (mockDischargeClient) IPCClientOpt() {}

	// Test that mockDischargeClient implements vc.DischargeClient.
	var _ vc.DischargeClient = (mockDischargeClient)(nil)

	func TestHandshakeWithDischargesTLS(t *testing.T) {
	newCaveat := func(validator security.CaveatValidator) security.Caveat {
	cav, err := security.NewCaveat(validator)
	if err != nil {
	t.Fatal(err)
	}
	return cav
	}
	var (
	discharger = tsecurity.NewPrincipal("discharger")
	client = tsecurity.NewPrincipal()
	server = tsecurity.NewPrincipal()
	root = tsecurity.NewIDProvider("root")
	)
	tpcav, err := security.NewPublicKeyCaveat(discharger.PublicKey(), "irrelevant", security.ThirdPartyRequirements{}, security.UnconstrainedUse())
	if err != nil {
	t.Fatal(err)
	}
	dis, err := discharger.MintDischarge(tpcav, security.UnconstrainedUse())
	if err != nil {
	t.Fatal(err)
	}

	// Setup 'client' and 'server' so that they use a blessing from 'root' with a third-party caveat
	// during VC handshake.
	if err := root.Bless(client, "client", newCaveat(tpcav)); err != nil {
	t.Fatal(err)
	}
	if err := root.Bless(server, "server", newCaveat(tpcav)); err != nil {
	t.Fatal(err)
	}

	// Test handshake without Discharges
	h, vc := New(SecurityTLS, LatestVersion, client, server, mockDischargeClient(nil))
	defer h.Close()
	flow, err := vc.Connect()
	if err != nil {
	t.Fatalf("Unable to create flow: %v", err)
	}
	if err := testFlowAuthN(flow, server.BlessingStore().Default(), nil, client.BlessingStore().Default()); err != nil {
	t.Error(err)
	}

	// Test handshake with Discharges
	h, vc = New(SecurityTLS, LatestVersion, client, server, mockDischargeClient([]security.Discharge{dis}))
	defer h.Close()
	flow, err = vc.Connect()
	if err != nil {
	t.Fatalf("Unable to create flow: %v", err)
	}
	if err := testFlowAuthN(flow, server.BlessingStore().Default(), map[string]security.Discharge{dis.ID(): dis}, client.BlessingStore().Default()); err != nil {
	t.Error(err)
	}
	}

	func testConnect_Small(t *testing.T, security options.VCSecurityLevel) {
	h, vc := New(security, LatestVersion, tsecurity.NewPrincipal("client"), tsecurity.NewPrincipal("server"))
	defer h.Close()
	flow, err := vc.Connect()
	if err != nil {
	t.Fatal(err)
	}
	testFlowEcho(t, flow, 10)
	}
	func TestConnect_Small(t *testing.T) { testConnect_Small(t, SecurityNone) }
	func TestConnect_SmallTLS(t *testing.T) { testConnect_Small(t, SecurityTLS) }

	func testConnect(t *testing.T, security options.VCSecurityLevel) {
	h, vc := New(security, LatestVersion, tsecurity.NewPrincipal("client"), tsecurity.NewPrincipal("server"))
	defer h.Close()
	flow, err := vc.Connect()
	if err != nil {
	t.Fatal(err)
	}
	testFlowEcho(t, flow, 10*DefaultBytesBufferedPerFlow)
	}
	func TestConnect(t *testing.T) { testConnect(t, SecurityNone) }
	func TestConnectTLS(t *testing.T) { testConnect(t, SecurityTLS) }

	func testConnect_Version4(t *testing.T, security options.VCSecurityLevel) {
	h, vc := New(security, version.IPCVersion4, tsecurity.NewPrincipal("client"), tsecurity.NewPrincipal("server"))
	defer h.Close()
	flow, err := vc.Connect()
	if err != nil {
	t.Fatal(err)
	}
	testFlowEcho(t, flow, 10)
	}
	func TestConnect_Version4(t *testing.T) { testConnect_Version4(t, SecurityNone) }
	func TestConnect_Version4TLS(t *testing.T) { testConnect_Version4(t, SecurityTLS) }

	// helper function for testing concurrent operations on multiple flows over the
	// same VC. Such tests are most useful when running the race detector.
	// (go test -race ...)
	func testConcurrentFlows(t *testing.T, security options.VCSecurityLevel, flows, gomaxprocs int) {
	mp := runtime.GOMAXPROCS(gomaxprocs)
	defer runtime.GOMAXPROCS(mp)
	h, vc := New(security, LatestVersion, tsecurity.NewPrincipal("client"), tsecurity.NewPrincipal("server"))
	defer h.Close()

	var wg sync.WaitGroup
	wg.Add(flows)
	for i := 0; i < flows; i++ {
	go func(n int) {
	defer wg.Done()
	flow, err := vc.Connect()
	if err != nil {
	t.Error(err)
	} else {
	testFlowEcho(t, flow, (n+1)*DefaultBytesBufferedPerFlow)
	}
	}(i)
	}
	wg.Wait()
	}

	func TestConcurrentFlows_1(t *testing.T) { testConcurrentFlows(t, SecurityNone, 10, 1) }
	func TestConcurrentFlows_1TLS(t *testing.T) { testConcurrentFlows(t, SecurityTLS, 10, 1) }

	func TestConcurrentFlows_10(t *testing.T) { testConcurrentFlows(t, SecurityNone, 10, 10) }
	func TestConcurrentFlows_10TLS(t *testing.T) { testConcurrentFlows(t, SecurityTLS, 10, 10) }

	func testListen(t *testing.T, security options.VCSecurityLevel) {
	data := "the dark knight"
	h, vc := New(security, LatestVersion, tsecurity.NewPrincipal("client"), tsecurity.NewPrincipal("server"))
	defer h.Close()
	if err := h.VC.AcceptFlow(id.Flow(21)); err == nil {
	t.Errorf("Expected AcceptFlow on a new flow to fail as Listen was not called")
	}

	ln, err := vc.Listen()
	if err != nil {
	t.Fatalf("vc.Listen failed: %v", err)
	return
	}
	_, err = vc.Listen()
	if err == nil {
	t.Fatalf("Second call to vc.Listen should have failed")
	return
	}

	if err := h.VC.AcceptFlow(id.Flow(23)); err != nil {
	t.Fatal(err)
	}
	cipherdata, err := h.otherEnd.VC.Encrypt(id.Flow(23), iobuf.NewSlice([]byte(data)))
	if err != nil {
	t.Fatal(err)
	}
	if err := h.VC.DispatchPayload(id.Flow(23), cipherdata); err != nil {
	t.Fatal(err)
	}
	flow, err := ln.Accept()
	if err != nil {
	t.Fatal(err)
	}
	if err := ln.Close(); err != nil {
	t.Error(err)
	}
	flow.Close()
	var buf [4096]byte
	if n, err := flow.Read(buf[:]); n != len(data) \|\| err != nil \|\| string(buf[:n]) != data {
	t.Errorf("Got (%d, %v) = %q, want (%d, nil) = %q", n, err, string(buf[:n]), len(data), data)
	}
	if n, err := flow.Read(buf[:]); n != 0 \|\| err != io.EOF {
	t.Errorf("Got (%d, %v) want (0, %v)", n, err, io.EOF)
	}
	}
	func TestListen(t *testing.T) { testListen(t, SecurityNone) }
	func TestListenTLS(t *testing.T) { testListen(t, SecurityTLS) }

	func testNewFlowAfterClose(t *testing.T, security options.VCSecurityLevel) {
	h, _ := New(security, LatestVersion, tsecurity.NewPrincipal("client"), tsecurity.NewPrincipal("server"))
	defer h.Close()
	h.VC.Close("reason")
	if err := h.VC.AcceptFlow(id.Flow(10)); err == nil {
	t.Fatalf("New flows should not be accepted once the VC is closed")
	}
	}
	func TestNewFlowAfterClose(t *testing.T) { testNewFlowAfterClose(t, SecurityNone) }
	func TestNewFlowAfterCloseTLS(t *testing.T) { testNewFlowAfterClose(t, SecurityTLS) }

	func testConnectAfterClose(t *testing.T, security options.VCSecurityLevel) {
	h, vc := New(security, LatestVersion, tsecurity.NewPrincipal("client"), tsecurity.NewPrincipal("server"))
	defer h.Close()
	h.VC.Close("myerr")
	if f, err := vc.Connect(); f != nil \|\| err == nil \|\| !strings.Contains(err.Error(), "myerr") {
	t.Fatalf("Got (%v, %v), want (nil, %q)", f, err, "myerr")
	}
	}
	func TestConnectAfterClose(t *testing.T) { testConnectAfterClose(t, SecurityNone) }
	func TestConnectAfterCloseTLS(t *testing.T) { testConnectAfterClose(t, SecurityTLS) }

	// helper implements vc.Helper and also sets up a single VC.
	type helper struct {
	VC *vc.VC
	bq bqueue.T

	mu sync.Mutex
	otherEnd *helper // GUARDED_BY(mu)
	}

	// New creates both ends of a VC but returns only the "client" end (i.e., the
	// one that initiated the VC). The "server" end (the one that "accepted" the VC)
	// listens for flows and simply echoes data read.
	func New(security options.VCSecurityLevel, v version.IPCVersion, client, server security.Principal, dischargeClients ...vc.DischargeClient) (*helper, stream.VC) {
	clientH := &helper{bq: drrqueue.New(vc.MaxPayloadSizeBytes)}
	serverH := &helper{bq: drrqueue.New(vc.MaxPayloadSizeBytes)}
	clientH.otherEnd = serverH
	serverH.otherEnd = clientH

	clientEP := endpoint(naming.FixedRoutingID(0xcccccccccccccccc))
	serverEP := endpoint(naming.FixedRoutingID(0x5555555555555555))

	vci := id.VC(1234)

	clientParams := vc.Params{
	VCI: vci,
	Dialed: true,
	LocalEP: clientEP,
	RemoteEP: serverEP,
	Pool: iobuf.NewPool(0),
	Helper: clientH,
	Version: v,
	}
	serverParams := vc.Params{
	VCI: vci,
	LocalEP: serverEP,
	RemoteEP: clientEP,
	Pool: iobuf.NewPool(0),
	Helper: serverH,
	Version: v,
	}

	clientH.VC = vc.InternalNew(clientParams)
	serverH.VC = vc.InternalNew(serverParams)
	clientH.AddReceiveBuffers(vci, vc.SharedFlowID, vc.DefaultBytesBufferedPerFlow)

	go clientH.pipeLoop(serverH.VC)
	go serverH.pipeLoop(clientH.VC)

	lopts := []stream.ListenerOpt{vc.LocalPrincipal{server}, security}
	vcopts := []stream.VCOpt{vc.LocalPrincipal{client}, security}

	if len(dischargeClients) > 0 {
	lopts = append(lopts, dischargeClients[0])
	vcopts = append(vcopts, dischargeClients[0])
	}

	c := serverH.VC.HandshakeAcceptedVC(lopts...)
	if err := clientH.VC.HandshakeDialedVC(vcopts...); err != nil {
	panic(err)
	}
	hr := <-c
	if hr.Error != nil {
	panic(hr.Error)
	}
	go acceptLoop(hr.Listener)
	return clientH, clientH.VC
	}

	// pipeLoop forwards slices written to h.bq to dst.
	func (h helper) pipeLoop(dst vc.VC) {
	for {
	w, bufs, err := h.bq.Get(nil)
	if err != nil {
	return
	}
	fid := id.Flow(w.ID())
	for _, b := range bufs {
	cipher, err := h.VC.Encrypt(fid, b)
	if err != nil {
	panic(err)
	}
	if err := dst.DispatchPayload(fid, cipher); err != nil {
	panic(err)
	return
	}
	}
	if w.IsDrained() {
	h.VC.ShutdownFlow(fid)
	dst.ShutdownFlow(fid)
	}
	}
	}

	func acceptLoop(ln stream.Listener) {
	for {
	f, err := ln.Accept()
	if err != nil {
	return
	}
	go echoLoop(f)
	}
	}

	func echoLoop(flow stream.Flow) {
	var buf [vc.DefaultBytesBufferedPerFlow * 20]byte
	for {
	n, err := flow.Read(buf[:])
	if err == io.EOF {
	return
	}
	if err == nil {
	_, err = flow.Write(buf[:n])
	}
	if err != nil {
	panic(err)
	}
	}
	}

	func (h *helper) NotifyOfNewFlow(vci id.VC, fid id.Flow, bytes uint) {
	h.mu.Lock()
	if h.otherEnd != nil {
	if err := h.otherEnd.VC.AcceptFlow(fid); err != nil {
	panic(err)
	}
	h.otherEnd.VC.ReleaseCounters(fid, uint32(bytes))
	}
	h.mu.Unlock()
	}

	func (h *helper) AddReceiveBuffers(vci id.VC, fid id.Flow, bytes uint) {
	h.mu.Lock()
	if h.otherEnd != nil {
	h.otherEnd.VC.ReleaseCounters(fid, uint32(bytes))
	}
	h.mu.Unlock()
	}

	func (h *helper) NewWriter(vci id.VC, fid id.Flow) (bqueue.Writer, error) {
	return h.bq.NewWriter(bqueue.ID(fid), 0, DefaultBytesBufferedPerFlow)
	}

	func (h *helper) Close() {
	h.VC.Close("helper closed")
	h.bq.Close()
	h.mu.Lock()
	otherEnd := h.otherEnd
	h.otherEnd = nil
	h.mu.Unlock()
	if otherEnd != nil {
	otherEnd.mu.Lock()
	otherEnd.otherEnd = nil
	otherEnd.mu.Unlock()
	otherEnd.Close()
	}
	}

	type endpoint naming.RoutingID

	func (e endpoint) Network() string { return "test" }
	func (e endpoint) VersionedString(int) string { return e.String() }
	func (e endpoint) String() string { return naming.RoutingID(e).String() }
	func (e endpoint) RoutingID() naming.RoutingID { return naming.RoutingID(e) }
	func (e endpoint) Addr() net.Addr { return nil }
	func (e endpoint) ServesMountTable() bool { return false }