blob: 79193ea55640f795c7ea823558fb16cbb7b6a9e3 [file] [log] [blame]
// Copyright 2017 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include <memory>
#include "base/macros.h"
#include "mojo/edk/embedder/connection_params.h"
#include "mojo/edk/embedder/transport_protocol.h"
#include "mojo/edk/system/system_impl_export.h"
#include "mojo/public/cpp/system/message_pipe.h"
namespace mojo {
namespace edk {
// Mojo embedders may use this to accept a broker client invitation from another
// embedder in the system.
class MOJO_SYSTEM_IMPL_EXPORT IncomingBrokerClientInvitation {
// Accepts an incoming invitation received via the connection medium in
// |params|.
static std::unique_ptr<IncomingBrokerClientInvitation> Accept(
ConnectionParams params);
// Accepts an incoming invitation from the command line. The command line is
// expected to have a |PlatformChannelPair::kMojoPlatformChannelHandleSwitch|
// switch whose value is an integer platform handle identifier (e.g. FD or
// HANDLE) in the calling process. The handle should correspond to one end of
// an OS pipe whose other end was used by another process to send an
// OutgoingBrokerClientInvitation.
static std::unique_ptr<IncomingBrokerClientInvitation> AcceptFromCommandLine(
TransportProtocol protocol);
// Extracts a named message pipe from the accepted invitation. Must be called
// after Accept() or AcceptFromCommandLine().
// Note that while this returns a usable pipe handle immediately, extraction
// and internal pipe connection is an asynchronous process. Therefore this
// method always returns a valid handle even if no such pipe was attached; in
// such cases where there was no attached pipe named |name|, the returned pipe
// handle will imminently signal peer closure.
ScopedMessagePipeHandle ExtractMessagePipe(const std::string& name);
explicit IncomingBrokerClientInvitation(ConnectionParams params);
} // namespace edk
} // namespace mojo