LLDB  mainline
HostProcess.h
Go to the documentation of this file.
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();
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>
47  bool monitor_signals);
48 
51 
52 private:
53  std::shared_ptr<HostNativeProcessBase> m_native_process;
54 };
55 }
56 
57 #endif
lldb_private::HostProcess
Definition: HostProcess.h:33
lldb_private::HostProcess::IsRunning
bool IsRunning() const
Definition: HostProcess.cpp:33
lldb_private::Host::MonitorChildProcessCallback
std::function< bool(lldb::pid_t pid, bool exited, int signal, int status)> MonitorChildProcessCallback
Definition: Host.h:68
Host.h
lldb_private::FileSpec
Definition: FileSpec.h:56
lldb_private::HostProcess::StartMonitoring
llvm::Expected< HostThread > StartMonitoring(const Host::MonitorChildProcessCallback &callback, bool monitor_signals)
Definition: HostProcess.cpp:36
lldb_private::HostProcess::GetProcessId
lldb::pid_t GetProcessId() const
Definition: HostProcess.cpp:29
lldb_private::HostProcess::GetNativeProcess
HostNativeProcessBase & GetNativeProcess()
Definition: HostProcess.cpp:41
lldb-types.h
lldb_private::HostProcess::m_native_process
std::shared_ptr< HostNativeProcessBase > m_native_process
Definition: HostProcess.h:53
lldb_private::Status
Definition: Status.h:44
lldb::pid_t
uint64_t pid_t
Definition: lldb-types.h:85
lldb::process_t
uint64_t process_t
Definition: lldb-types.h:57
lldb_private
A class that represents a running process on the host machine.
Definition: SBCommandInterpreterRunOptions.h:16
lldb_private::HostProcess::~HostProcess
~HostProcess()
lldb_private::HostProcess::GetMainModule
Status GetMainModule(FileSpec &file_spec) const
Definition: HostProcess.cpp:25
lldb_private::HostProcess::HostProcess
HostProcess()
Definition: HostProcess.cpp:16
lldb_private::HostNativeProcessBase
Definition: HostNativeProcessBase.h:21
lldb_private::HostProcess::Terminate
Status Terminate()
Definition: HostProcess.cpp:23