Index: sandbox/linux/services/namespace_sandbox.h |
diff --git a/sandbox/linux/services/namespace_sandbox.h b/sandbox/linux/services/namespace_sandbox.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..ddc4deefc4fc9bed3e2bc5a72f60d6aef29a8028 |
--- /dev/null |
+++ b/sandbox/linux/services/namespace_sandbox.h |
@@ -0,0 +1,58 @@ |
+// Copyright 2015 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_SERVICES_NAMESPACE_SANDBOX_H_ |
+#define SANDBOX_LINUX_SERVICES_NAMESPACE_SANDBOX_H_ |
+ |
+#include "base/command_line.h" |
+#include "base/macros.h" |
+#include "base/process/launch.h" |
+#include "base/process/process.h" |
+#include "sandbox/sandbox_export.h" |
+ |
+namespace sandbox { |
+ |
+// Helper class for starting a process inside a new user, PID, and network |
+// namespace. Before using a namespace sandbox, check for namespaces support |
+// using Credentials::CanCreateProcessInNewUserNS. |
+// |
+// A typical use for "A" launching a sandboxed process "B" would be: |
+// 1. A sets up a command line and launch options for process B. |
+// 2. A launches B with LaunchProcess. |
+// 3. B should be prepared to assume the role of init(1). In particular, apart |
+// from SIGKILL and SIGSTOP, B cannot receive any signal for which it does |
+// not have an explicit signal handler registered. |
+// If B dies, all the processes in the namespace will die. |
+// B can fork() and the parent can assume the role of init(1), by using |
+// CreateInitProcessReaper(). |
+// 4. B chroots using Credentials::MoveToNewUserNS() and |
+// Credentials::DropFileSystemAccess() |
+// 5. B drops capabilities gained by entering the new user namespace with |
+// Credentials::DropAllCapabilities(). |
+class SANDBOX_EXPORT NamespaceSandbox { |
+ public: |
+ // Launch a new process inside its own user/PID/network namespaces (depending |
+ // on kernel support). Requires at a minimum that user namespaces are |
+ // supported (use Credentials::CanCreateProcessInNewUserNS to check this). |
+ // |
+ // pre_exec_delegate and clone_flags fields of LaunchOptions should be nullptr |
+ // and 0, respectively, since this function makes a copy of options and |
+ // overrides them. |
+ static base::Process LaunchProcess(const base::CommandLine& cmdline, |
+ const base::LaunchOptions& options); |
+ |
+ // Returns whether the namespace sandbox created a new user, PID, and network |
+ // namespace. In particular, InNewUserNamespace should return true iff the |
+ // process was started via this class. |
+ static bool InNewUserNamespace(); |
+ static bool InNewPidNamespace(); |
+ static bool InNewNetNamespace(); |
+ |
+ private: |
+ DISALLOW_IMPLICIT_CONSTRUCTORS(NamespaceSandbox); |
+}; |
+ |
+} // namespace sandbox |
+ |
+#endif // SANDBOX_LINUX_SERVICES_NAMESPACE_SANDBOX_H_ |