EventConsumer.hxx

#pragma once
 
// cosmos
#include <cosmos/BitMask.hxx>
#include <cosmos/proc/process.hxx>
#include <cosmos/string.hxx>
 
// clues
#include <clues/types.hxx>
 
namespace clues {
 
class Tracee;
class SystemCall;


class EventConsumer {
        friend class Tracee;
        friend class Engine;
public: // types

        enum class StatusFlag {
                INTERRUPTED            = 1 << 0,
                RESUMED                = 1 << 1,
                LOST_TO_MT_EXIT        = 1 << 2,
                ABI_CHANGED            = 1 << 3,
                CLONED_THREAD          = 1 << 4,
        };
 
        using StatusFlags = cosmos::BitMask<StatusFlag>;
 
protected: // functions


        virtual void syscallEntry(Tracee &tracee, const SystemCall &sc, const StatusFlags flags) {
                (void)tracee;
                (void)sc;
                (void)flags;
        }


        virtual void syscallExit(Tracee &tracee, const SystemCall &sc, const StatusFlags flags) {
                (void)tracee;
                (void)sc;
                (void)flags;
        }


        virtual void attached(Tracee &tracee) {
                (void)tracee;
        }


        virtual void signaled(Tracee &tracee, const cosmos::SigInfo &info) {
                (void)tracee;
                (void)info;
        };

        virtual void stopped(Tracee &tracee) {
                (void)tracee;
        }

        virtual void resumed(Tracee &tracee) {
                (void)tracee;
        }


        virtual void exited(Tracee &tracee, const cosmos::WaitStatus status, const StatusFlags flags) {
                (void)tracee;
                (void)status;
                (void)flags;
        }


        virtual void disappeared(Tracee &tracee, const cosmos::ChildState &data) {
                (void)tracee;
                (void)data;
        }


        virtual void newExecutionContext(
                        Tracee &tracee,
                        const std::string &old_executable,
                        const cosmos::StringVector &old_cmdline,
                        const std::optional<cosmos::ProcessID> old_pid) {
                (void)tracee;
                (void)old_cmdline;
                (void)old_executable;
                (void)old_pid;
        }


        virtual void newChildProcess(
                        Tracee &parent,
                        Tracee &child,
                        const cosmos::ptrace::Event event,
                        const StatusFlags flags) {
                (void)parent;
                (void)child;
                (void)event;
                (void)flags;
        }


        virtual void vforkComplete(Tracee &parent, TraceePtr child) {
                (void)parent;
                (void)child;
        }
};
 
} // end ns