| Index: sandbox/linux/syscall_broker/broker_client.h
|
| diff --git a/sandbox/linux/syscall_broker/broker_client.h b/sandbox/linux/syscall_broker/broker_client.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..7d06175929b40679b99b054fbfa43605c4c9606e
|
| --- /dev/null
|
| +++ b/sandbox/linux/syscall_broker/broker_client.h
|
| @@ -0,0 +1,71 @@
|
| +// Copyright 2014 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 SANDBOX_LINUX_SYSCALL_BROKER_BROKER_CLIENT_H_
|
| +#define SANDBOX_LINUX_SYSCALL_BROKER_BROKER_CLIENT_H_
|
| +
|
| +#include "base/macros.h"
|
| +#include "sandbox/linux/syscall_broker/broker_common.h"
|
| +
|
| +namespace sandbox {
|
| +
|
| +namespace syscall_broker {
|
| +
|
| +class BrokerPolicy;
|
| +
|
| +// This class can be embedded in a sandboxed process and can be
|
| +// used to perform certain system calls in another, presumably
|
| +// non-sandboxed process (which embeds BrokerHost).
|
| +// A key feature of this class is the ability to use some of its methods in a
|
| +// thread-safe and async-signal safe way. The goal is to be able to use it to
|
| +// replace the open() or access() system calls happening anywhere in a process
|
| +// (as allowed for instance by seccomp-bpf's SIGSYS mechanism).
|
| +class BrokerClient {
|
| + public:
|
| + // |policy| needs to match the policy used by BrokerHost. This
|
| + // allows to predict some of the requests which will be denied
|
| + // and save an IPC round trip.
|
| + // |ipc_channel| needs to be a suitable SOCK_SEQPACKET unix socket.
|
| + // |fast_check_in_client| should be set to true and
|
| + // |quiet_failures_for_tests| to false unless you are writing tests.
|
| + BrokerClient(const BrokerPolicy& policy,
|
| + int ipc_channel,
|
| + bool fast_check_in_client,
|
| + bool quiet_failures_for_tests);
|
| + ~BrokerClient();
|
| +
|
| + // Can be used in place of access().
|
| + // X_OK will always return an error in practice since the broker process
|
| + // doesn't support execute permissions.
|
| + // It's similar to the access() system call and will return -errno on errors.
|
| + // This is async signal safe.
|
| + int Access(const char* pathname, int mode) const;
|
| + // Can be used in place of open().
|
| + // The implementation only supports certain white listed flags and will
|
| + // return -EPERM on other flags.
|
| + // It's similar to the open() system call and will return -errno on errors.
|
| + // This is async signal safe.
|
| + int Open(const char* pathname, int flags) const;
|
| +
|
| + private:
|
| + const BrokerPolicy& broker_policy_;
|
| + const int ipc_channel_;
|
| + const bool fast_check_in_client_; // Whether to forward a request that we
|
| + // know will be denied to the broker. (Used
|
| + // for tests).
|
| + const bool quiet_failures_for_tests_; // Disable certain error message when
|
| + // testing for failures.
|
| +
|
| + int PathAndFlagsSyscall(IPCCommand syscall_type,
|
| + const char* pathname,
|
| + int flags) const;
|
| +
|
| + DISALLOW_COPY_AND_ASSIGN(BrokerClient);
|
| +};
|
| +
|
| +} // namespace syscall_broker
|
| +
|
| +} // namespace sandbox
|
| +
|
| +#endif // SANDBOX_LINUX_SYSCALL_BROKER_BROKER_CLIENT_H_
|
|
|