HostProcess.h revision 360784 
1//===-- HostProcess.h ------------------------------------------*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8
9#ifndef lldb_Host_HostProcess_h_
10#define lldb_Host_HostProcess_h_
11
12#include "lldb/Host/Host.h"
13#include "lldb/lldb-types.h"
14
15/// A class that represents a running process on the host machine.
16///
17/// HostProcess allows querying and manipulation of processes running on the
18/// host machine.  It is not intended to be represent a process which is being
19/// debugged, although the native debug engine of a platform may likely back
20/// inferior processes by a HostProcess.
21///
22/// HostProcess is implemented using static polymorphism so that on any given
23/// platform, an instance of HostProcess will always be able to bind
24/// statically to the concrete Process implementation for that platform.  See
25/// HostInfo for more details.
26///
27
28namespace lldb_private {
29
30class HostNativeProcessBase;
31class HostThread;
32
33class HostProcess {
34public:
35  HostProcess();
36  HostProcess(lldb::process_t process);
37  ~HostProcess();
38
39  Status Terminate();
40  Status GetMainModule(FileSpec &file_spec) const;
41
42  lldb::pid_t GetProcessId() const;
43  bool IsRunning() const;
44
45  llvm::Expected<HostThread>
46  StartMonitoring(const Host::MonitorChildProcessCallback &callback,
47                  bool monitor_signals);
48
49  HostNativeProcessBase &GetNativeProcess();
50  const HostNativeProcessBase &GetNativeProcess() const;
51
52private:
53  std::shared_ptr<HostNativeProcessBase> m_native_process;
54};
55}
56
57#endif
58