blob: 7ec683585f8e080631b47d4515cc5657a6ae9d95 [file] [log] [blame]
//===-- UnixSignals.h -------------------------------------------*- C++ -*-===//
//
// The LLVM Compiler Infrastructure
//
// This file is distributed under the University of Illinois Open Source
// License. See LICENSE.TXT for details.
//
//===----------------------------------------------------------------------===//
#ifndef lldb_UnixSignals_h_
#define lldb_UnixSignals_h_
// C Includes
// C++ Includes
#include <map>
#include <string>
#include <vector>
// Other libraries and framework includes
// Project includes
#include "lldb/Utility/ConstString.h"
#include "lldb/lldb-private.h"
#include "llvm/ADT/Optional.h"
namespace lldb_private {
class UnixSignals {
public:
static lldb::UnixSignalsSP Create(const ArchSpec &arch);
//------------------------------------------------------------------
// Constructors and Destructors
//------------------------------------------------------------------
UnixSignals();
virtual ~UnixSignals();
const char *GetSignalAsCString(int32_t signo) const;
bool SignalIsValid(int32_t signo) const;
int32_t GetSignalNumberFromName(const char *name) const;
const char *GetSignalInfo(int32_t signo, bool &should_suppress,
bool &should_stop, bool &should_notify) const;
bool GetShouldSuppress(int32_t signo) const;
bool SetShouldSuppress(int32_t signo, bool value);
bool SetShouldSuppress(const char *signal_name, bool value);
bool GetShouldStop(int32_t signo) const;
bool SetShouldStop(int32_t signo, bool value);
bool SetShouldStop(const char *signal_name, bool value);
bool GetShouldNotify(int32_t signo) const;
bool SetShouldNotify(int32_t signo, bool value);
bool SetShouldNotify(const char *signal_name, bool value);
// These provide an iterator through the signals available on this system.
// Call GetFirstSignalNumber to get the first entry, then iterate on
// GetNextSignalNumber till you get back LLDB_INVALID_SIGNAL_NUMBER.
int32_t GetFirstSignalNumber() const;
int32_t GetNextSignalNumber(int32_t current_signal) const;
int32_t GetNumSignals() const;
int32_t GetSignalAtIndex(int32_t index) const;
ConstString GetShortName(ConstString name) const;
// We assume that the elements of this object are constant once it is
// constructed, since a process should never need to add or remove symbols as
// it runs. So don't call these functions anywhere but the constructor of
// your subclass of UnixSignals or in your Process Plugin's GetUnixSignals
// method before you return the UnixSignal object.
void AddSignal(int signo, const char *name, bool default_suppress,
bool default_stop, bool default_notify,
const char *description, const char *alias = nullptr);
void RemoveSignal(int signo);
// Returns a current version of the data stored in this class. Version gets
// incremented each time Set... method is called.
uint64_t GetVersion() const;
// Returns a vector of signals that meet criteria provided in arguments. Each
// should_[suppress|stop|notify] flag can be None - no filtering by this
// flag true - only signals that have it set to true are returned false -
// only signals that have it set to true are returned
std::vector<int32_t> GetFilteredSignals(llvm::Optional<bool> should_suppress,
llvm::Optional<bool> should_stop,
llvm::Optional<bool> should_notify);
protected:
//------------------------------------------------------------------
// Classes that inherit from UnixSignals can see and modify these
//------------------------------------------------------------------
struct Signal {
ConstString m_name;
ConstString m_alias;
std::string m_description;
bool m_suppress : 1, m_stop : 1, m_notify : 1;
Signal(const char *name, bool default_suppress, bool default_stop,
bool default_notify, const char *description, const char *alias);
~Signal() {}
};
virtual void Reset();
typedef std::map<int32_t, Signal> collection;
collection m_signals;
// This version gets incremented every time something is changing in this
// class, including when we call AddSignal from the constructor. So after the
// object is constructed m_version is going to be > 0 if it has at least one
// signal registered in it.
uint64_t m_version = 0;
// GDBRemote signals need to be copyable.
UnixSignals(const UnixSignals &rhs);
const UnixSignals &operator=(const UnixSignals &rhs) = delete;
};
} // Namespace lldb
#endif // lldb_UnixSignals_h_