scoped_process.h revision c5cede9ae108bb15f6b7a8aea21c7e1fefa2834c
1// Copyright 2014 The Chromium Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5#ifndef SANDBOX_LINUX_SERVICES_SCOPED_PROCESS_H_
6#define SANDBOX_LINUX_SERVICES_SCOPED_PROCESS_H_
7
8#include "base/basictypes.h"
9#include "base/callback_forward.h"
10#include "base/process/process_handle.h"
11#include "sandbox/linux/sandbox_export.h"
12
13namespace sandbox {
14
15// fork() a child process that will run a Closure.
16// After the Closure has run, the child will pause forever. If this object
17// is detroyed, the child will be destroyed, even if the closure did not
18// finish running. It's ok to signal the child from outside of this class to
19// destroy it.
20// This class cannot be instanciated from a multi-threaded process, as it needs
21// to fork().
22class SANDBOX_EXPORT ScopedProcess {
23 public:
24  // A new process will be created and |child_callback| will run in the child
25  // process. This callback is allowed to terminate the process or to simply
26  // return. If the callback returns, the process will wait forever.
27  explicit ScopedProcess(const base::Closure& child_callback);
28  ~ScopedProcess();
29
30  // Wait for the process to exit.
31  // |got_signaled| tells how to interpret the return value: either as an exit
32  // code, or as a signal number.
33  // When this returns, the process will still not have been reaped and will
34  // survive as a zombie for the lifetime of this object. This method can be
35  // called multiple times.
36  int WaitForExit(bool* got_signaled);
37
38  // Wait for the |child_callback| passed at construction to run. Return false
39  // if |child_callback| did not finish running and we know it never will (for
40  // instance the child crashed or used _exit()).
41  bool WaitForClosureToRun();
42  base::ProcessId GetPid() { return child_process_id_; }
43
44 private:
45  bool IsOriginalProcess();
46
47  base::ProcessId child_process_id_;
48  base::ProcessId process_id_;
49  int pipe_fds_[2];
50  DISALLOW_COPY_AND_ASSIGN(ScopedProcess);
51};
52
53}  // namespace sandbox
54
55#endif  // SANDBOX_LINUX_SERVICES_SCOPED_PROCESS_H_
56