event.hpp

Go to the documentation of this file.

/*
 * Copyright (c) 2014-2026 Enrico M. Crisostomo
 *
 * This program is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License as published by the Free Software
 * Foundation; either version 3, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
 * details.
 *
 * You should have received a copy of the GNU General Public License along with
 * this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 
#ifndef FSW_EVENT_H
#  define FSW_EVENT_H
 
#  include <string>
#  include <ctime>
#  include <vector>
#  include <iostream>
#  include <optional>
#  include "../c/cevent.h"
 
namespace fsw
{
  enum class process_id_kind
  {
    none = 0,
    pid,
    tid
  };
 
  struct process_metadata
  {
    process_id_kind kind = process_id_kind::none;
    long long id = 0;
    int pidfd = -1;
    bool has_pidfd = false;
  };

  class event
  {
  public:
    event(std::string path, time_t evt_time, std::vector<fsw_event_flag> flags);

    event(std::string path, time_t evt_time, std::vector<fsw_event_flag> flags, unsigned long correlation_id);

    event(std::string path,
          time_t evt_time,
          std::vector<fsw_event_flag> flags,
          unsigned long correlation_id,
          process_metadata process);

    virtual ~event();

    std::string get_path() const;

    time_t get_time() const;

    std::vector<fsw_event_flag> get_flags() const;

    unsigned long get_correlation_id() const;

    bool has_process_id() const;

    long long get_process_id() const;

    process_id_kind get_process_id_kind() const;

    bool has_process_pidfd() const;

    int get_process_pidfd() const;

    static std::string get_process_id_kind_name(process_id_kind kind);

    static fsw_event_flag get_event_flag_by_name(const std::string& name);

    static std::string get_event_flag_name(const fsw_event_flag& flag);
 
  private:
    std::string path;
    time_t evt_time;
    std::vector<fsw_event_flag> evt_flags;
    unsigned long correlation_id = 0;
    process_metadata process;
  };

  std::ostream& operator<<(std::ostream& out, const fsw_event_flag flag);
}
 
#endif  /* FSW_EVENT_H */