async_reference_driver.h

// Copyright 2022 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef IPCZ_SRC_DRIVERS_ASYNC_REFERENCE_DRIVER_H_
#define IPCZ_SRC_DRIVERS_ASYNC_REFERENCE_DRIVER_H_

#include <utility>

#include "ipcz/ipcz.h"

namespace ipcz::reference_drivers {

// An async driver for single-process tests. Each transport runs its own thread
// with a simple task queue. Transmission from a transport posts a task to its
// peer's queue. The resulting non-determinism effectively simulates a typical
// production driver, without the complexity of a multiprocess environment.
extern const IpczDriver kAsyncReferenceDriver;

// Mostly the same as kAsyncReferenceDriver, but rejects direct transmission of
// driver handles between non-broker nodes. This forces ipcz to relay such
// messages through the broker.
extern const IpczDriver kAsyncReferenceDriverWithForcedBrokering;

// Creates a new pair of async transport endpoints, one for a broker and one
// for a non-broker.
struct AsyncTransportPair {
  IpczDriverHandle broker;
  IpczDriverHandle non_broker;
};
AsyncTransportPair CreateAsyncTransportPair();

// Creates a new pair of async transport endpoints, one for each of two
// different brokers to be connected.
std::pair<IpczDriverHandle, IpczDriverHandle>
CreateAsyncTransportPairForBrokers();

}  // namespace ipcz::reference_drivers

#endif  // IPCZ_SRC_DRIVERS_ASYNC_REFERENCE_DRIVER_H_