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 
28 namespace lldb_private {
29 
30 class HostNativeProcessBase;
31 class HostThread;
32 
33 class HostProcess {
34 public:
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 
52 private:
53   std::shared_ptr<HostNativeProcessBase> m_native_process;
54 };
55 }
56 
57 #endif
58