| Index: base/mac/mach_port_broker.h
|
| diff --git a/base/mac/mach_port_broker.h b/base/mac/mach_port_broker.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..ba08b6f67f9715588aa7ef46b11a472da38cc24b
|
| --- /dev/null
|
| +++ b/base/mac/mach_port_broker.h
|
| @@ -0,0 +1,108 @@
|
| +// Copyright 2016 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.
|
| +
|
| +#ifndef BASE_MAC_MACH_PORT_BROKER_H_
|
| +#define BASE_MAC_MACH_PORT_BROKER_H_
|
| +
|
| +#include <mach/mach.h>
|
| +
|
| +#include <map>
|
| +#include <string>
|
| +
|
| +#include "base/base_export.h"
|
| +#include "base/mac/dispatch_source_mach.h"
|
| +#include "base/mac/scoped_mach_port.h"
|
| +#include "base/macros.h"
|
| +#include "base/memory/scoped_ptr.h"
|
| +#include "base/process/port_provider_mac.h"
|
| +#include "base/process/process_handle.h"
|
| +#include "base/synchronization/lock.h"
|
| +
|
| +namespace base {
|
| +
|
| +// On OS X, the task port of a process is required to collect metrics about the
|
| +// process, and to insert Mach ports into the process. Running |task_for_pid()|
|
| +// is only allowed for privileged code. However, a process has port rights to
|
| +// all its subprocesses, so let the child processes send their Mach port to the
|
| +// parent over IPC.
|
| +//
|
| +// Mach ports can only be sent over Mach IPC, not over the |socketpair()| that
|
| +// the regular IPC system uses. Hence, the child processes opens a Mach
|
| +// connection shortly after launching and ipc their mach data to the parent
|
| +// process. A single |MachPortBroker| with a given name is expected to exist in
|
| +// the parent process.
|
| +//
|
| +// Since this data arrives over a separate channel, it is not available
|
| +// immediately after a child process has been started.
|
| +class BASE_EXPORT MachPortBroker : public base::PortProvider {
|
| + public:
|
| + // For use in child processes. This will send the task port of the current
|
| + // process over Mach IPC to the port registered by name (via this class) in
|
| + // the parent process. Returns true if the message was sent successfully
|
| + // and false if otherwise.
|
| + static bool ChildSendTaskPortToParent(const std::string& name);
|
| +
|
| + // Returns the Mach port name to use when sending or receiving messages.
|
| + // Does the Right Thing in the browser and in child processes.
|
| + static std::string GetMachPortName(const std::string& name, bool is_child);
|
| +
|
| + MachPortBroker(const std::string& name);
|
| + ~MachPortBroker() override;
|
| +
|
| + // Performs any initialization work.
|
| + bool Init();
|
| +
|
| + // Adds a placeholder to the map for the given pid with MACH_PORT_NULL.
|
| + // Callers are expected to later update the port with FinalizePid(). Callers
|
| + // MUST acquire the lock given by GetLock() before calling this method (and
|
| + // release the lock afterwards).
|
| + void AddPlaceholderForPid(base::ProcessHandle pid);
|
| +
|
| + // Removes |pid| from the task port map. Callers MUST acquire the lock given
|
| + // by GetLock() before calling this method (and release the lock afterwards).
|
| + void InvalidatePid(base::ProcessHandle pid);
|
| +
|
| + // The lock that protects this MachPortBroker object. Callers MUST acquire
|
| + // and release this lock around calls to AddPlaceholderForPid(),
|
| + // InvalidatePid(), and FinalizePid();
|
| + base::Lock& GetLock() { return lock_; }
|
| +
|
| + // Implement |base::PortProvider|.
|
| + mach_port_t TaskForPid(base::ProcessHandle process) const override;
|
| +
|
| + private:
|
| + friend class MachPortBrokerTest;
|
| +
|
| + // Message handler that is invoked on |dispatch_source_| when an
|
| + // incoming message needs to be received.
|
| + void HandleRequest();
|
| +
|
| + // Updates the mapping for |pid| to include the given |mach_info|. Does
|
| + // nothing if PlaceholderForPid() has not already been called for the given
|
| + // |pid|. Callers MUST acquire the lock given by GetLock() before calling
|
| + // this method (and release the lock afterwards).
|
| + void FinalizePid(base::ProcessHandle pid, mach_port_t task_port);
|
| +
|
| + // Name used to identify a particular port broker.
|
| + const std::string name_;
|
| +
|
| + // The Mach port on which the server listens.
|
| + base::mac::ScopedMachReceiveRight server_port_;
|
| +
|
| + // The dispatch source and queue on which Mach messages will be received.
|
| + scoped_ptr<base::DispatchSourceMach> dispatch_source_;
|
| +
|
| + // Stores mach info for every process in the broker.
|
| + typedef std::map<base::ProcessHandle, mach_port_t> MachMap;
|
| + MachMap mach_map_;
|
| +
|
| + // Mutex that guards |mach_map_|.
|
| + mutable base::Lock lock_;
|
| +
|
| + DISALLOW_COPY_AND_ASSIGN(MachPortBroker);
|
| +};
|
| +
|
| +} // namespace base
|
| +
|
| +#endif // BASE_MAC_MACH_PORT_BROKER_H_
|
|
|