/*
   BAREOS® - Backup Archiving REcovery Open Sourced

   Copyright (C) 2011-2015 Planets Communications B.V.
   Copyright (C) 2013-2025 Bareos GmbH & Co. KG

   This program is Free Software; you can redistribute it and/or
   modify it under the terms of version three of the GNU Affero General Public
   License as published by the Free Software Foundation, which is
   listed in the file LICENSE.

   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
   Affero General Public License for more details.

   You should have received a copy of the GNU Affero General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
   02110-1301, USA.
*/
/**
 * @file
 * Python plugin for the Bareos File Daemon
 */
#define PY_SSIZE_T_CLEAN
#define BUILD_PLUGIN

#if defined(HAVE_WIN32)
#  include "include/bareos.h"
#  include <Python.h>
#else
#  include <Python.h>
#  include "include/bareos.h"
#endif
#include "include/version_hex.h"

#define PLUGIN_DAEMON "fd"

#define PLUGIN_NAME "python3"
#define PLUGIN_DIR PY3MODDIR
#define LOGPREFIX PLUGIN_NAME "-" PLUGIN_DAEMON ": "

#include "filed/fd_plugins.h"

#include "include/filetypes.h"
#include "python-fd.h"
#include "module/bareosfd.h"
#include "lib/edit.h"

#include <vector>
#include <algorithm>

namespace filedaemon {

static const int debuglevel = 150;

#define PLUGIN_LICENSE "Bareos AGPLv3"
#define PLUGIN_AUTHOR "Bareos GmbH & Co. KG"
#define PLUGIN_DATE "May 2020"
#define PLUGIN_VERSION "4"
#define PLUGIN_DESCRIPTION "Python File Daemon Plugin"
#define PLUGIN_USAGE                                                           \
  PLUGIN_NAME                                                                  \
  ":module_name=<python-module-to-load>:module_path=<path-to-python-modules>:" \
  "...\n"                                                                      \
  "\n"                                                                         \
  "  module_name: The name of the Python module.\n"                            \
  "  module_path: Python search path for the module.\n"                        \
  "               The path '" PYTHON_MODULE_PATH                               \
  "' is always checked for modules.\n"                                         \
  "  Additional parameters are plugin specific."

namespace {
/* Pointers to Bareos functions */
CoreFunctions* bareos_core_functions = NULL;
PluginApiDefinition* bareos_plugin_interface_version = NULL;
}  // namespace

#include "plugin_private_context.h"

/* functions common to all plugins */
#include "plugins/include/python_plugins_common.inc"
#include "plugins/include/python_plugin_modules_common.inc"


namespace {
uint32_t PyVersion()
{
#if PY_VERSION_HEX < VERSION_HEX(3, 11, 0)
  // bake it in statically
  return PY_VERSION_HEX;
#else
  // determine it at runtime
  return Py_Version;
#endif
}

/* List of interpreters accessed by this thread.
 * We use a vector instead of a set here since we expect that each thread
 * only accesses very few interpreters (<= 1) at the same time.
 */
thread_local std::vector<PyThreadState*> tl_threadstates{};

/**
 * We don't actually use this but we need it to tear down the
 * final python interpreter on unload of the plugin. Each instance of
 * the plugin get its own interpreter.
 */
PyThreadState* mainThreadState{nullptr};

/* Return this threads thread state for interp if it exists.  Returns
 * nullptr otherwise */
PyThreadState* GetThreadStateForInterp(PyInterpreterState* interp)
{
  for (auto* thread : tl_threadstates) {
    if (thread->interp == interp) { return thread; }
  }
  return nullptr;
}

PyThreadState* PopThreadStateForInterp(PyInterpreterState* interp)
{
  auto iter = std::find_if(
      tl_threadstates.begin(), tl_threadstates.end(),
      [interp](const auto& thread) { return thread->interp == interp; });

  if (iter != tl_threadstates.end()) {
    auto* thread = *iter;

    tl_threadstates.erase(iter);

    return thread;
  } else {
    return nullptr;
  }
}

class locked_threadstate {
 private:
  locked_threadstate(PyThreadState* t_ts, bool t_owns) : ts{t_ts}, owns{t_owns}
  {
    // make the given thread state active
    // we assume that we are currently holding the gil
    (void)PyThreadState_Swap(t_ts);
  }

 public:
  explicit locked_threadstate(PyThreadState* t_ts)
      : locked_threadstate(t_ts, false)
  {
  }

  explicit locked_threadstate(PyInterpreterState* interp)
      : locked_threadstate(PyThreadState_New(interp), true)
  {
  }

  locked_threadstate(const locked_threadstate&) = delete;
  locked_threadstate& operator=(const locked_threadstate&) = delete;

  locked_threadstate(locked_threadstate&& other) { *this = std::move(other); }

  locked_threadstate& operator=(locked_threadstate&& other)
  {
    std::swap(ts, other.ts);
    std::swap(owns, other.owns);

    return *this;
  }

  PyThreadState* get() { return ts; }

  ~locked_threadstate()
  {
    if (ts) {
      if (owns) {
        // destroy the thread state and release the gil
        PyThreadState_Clear(ts);  // required before delete
        PyThreadState_DeleteCurrent();
      } else {
        // just release the gil and make ts inactive
        PyEval_ReleaseThread(ts);
      }
    }
  }

 private:
  PyThreadState* ts{nullptr};
  bool owns{false};
};

/* Acquire the gil for this thread.  If this thread does not have a thread
 * state for interp, a new one is created.  This newly created thread state
 * is destroyed by locked_threadstates destructor. */
locked_threadstate AcquireLock(PyInterpreterState* interp)
{
  // we lock the gil here to synchronize potential calls to PyThreadState_New().
  PyEval_RestoreThread(mainThreadState);
  auto* ts = GetThreadStateForInterp(interp);
  if (!ts) {
    // create a new thread state
    return locked_threadstate{interp};
  }

  return locked_threadstate{ts};
}

/**
 * Called here to make a new instance of the plugin -- i.e. when
 * a new Job is started. There can be multiple instances of
 * each plugin that are running at the same time.  Your
 * plugin instance must be thread safe and keep its own
 * local data.
 */
bRC newPlugin(PluginContext* plugin_ctx)
{
  struct plugin_private_context* plugin_priv_ctx
      = (struct plugin_private_context*)malloc(
          sizeof(struct plugin_private_context));
  if (!plugin_priv_ctx) { return bRC_Error; }
  memset(plugin_priv_ctx, 0, sizeof(struct plugin_private_context));
  plugin_ctx->plugin_private_context
      = (void*)plugin_priv_ctx; /* set our context pointer */

  /* For each plugin instance we instantiate a new Python interpreter. */
  PyEval_AcquireThread(mainThreadState);

  /* set bareos_plugin_context inside of bareosfd module */
  Bareosfd_set_plugin_context(plugin_ctx);

  auto* ts = Py_NewInterpreter();
  plugin_priv_ctx->interp = ts->interp;
  // register ts
  tl_threadstates.push_back(ts);
  PyEval_ReleaseThread(ts);

  /* Always register some events the python plugin itself can register
     any other events it is interested in. */
  bareos_core_functions->registerBareosEvents(
      plugin_ctx, 9, bEventLevel, bEventSince, bEventNewPluginOptions,
      bEventPluginCommand, bEventJobStart, bEventRestoreCommand,
      bEventEstimateCommand, bEventBackupCommand, bEventRestoreObject);

  return bRC_OK;
}

/**
 * Release everything concerning a particular instance of a
 * plugin. Normally called when the Job terminates.
 */
extern "C" bRC freePlugin(PluginContext* plugin_ctx)
{
  struct plugin_private_context* plugin_priv_ctx
      = (struct plugin_private_context*)plugin_ctx->plugin_private_context;

  if (!plugin_priv_ctx) { return bRC_Error; }

  if (plugin_priv_ctx->plugin_options) {
    free(plugin_priv_ctx->plugin_options);
  }

  if (plugin_priv_ctx->module_path) { free(plugin_priv_ctx->module_path); }

  if (plugin_priv_ctx->module_name) { free(plugin_priv_ctx->module_name); }

  if (plugin_priv_ctx->fname) { free(plugin_priv_ctx->fname); }

  if (plugin_priv_ctx->link) { free(plugin_priv_ctx->link); }

  if (plugin_priv_ctx->object_name) { free(plugin_priv_ctx->object_name); }

  if (plugin_priv_ctx->object) { free(plugin_priv_ctx->object); }

  // Stop any sub interpreter started per plugin instance.
  auto* ts = PopThreadStateForInterp(plugin_priv_ctx->interp);
  if (!ts) {
    Jmsg(plugin_ctx, M_FATAL, LOGPREFIX "No associated thread state found\n");
    free(plugin_priv_ctx);
    plugin_ctx->plugin_private_context = NULL;
    return bRC_Error;
  }
  PyEval_AcquireThread(ts);

  if (plugin_priv_ctx->pModule) { Py_DECREF(plugin_priv_ctx->pModule); }

  Py_EndInterpreter(ts);

  if (PyVersion() < VERSION_HEX(3, 12, 0)) {
    // release gil a different way
    PyThreadState_Swap(mainThreadState);
    // while we still have the gil, we need to make sure we clear the type cache
    // so that it does not contain outdated references
    if (PyVersion() < VERSION_HEX(3, 10, 0)) { PyType_ClearCache(); }
    PyEval_ReleaseThread(mainThreadState);
  } else {
    // endinterpreter releases the gil for us since 3.12
  }

  free(plugin_priv_ctx);
  plugin_ctx->plugin_private_context = NULL;

  return bRC_OK;
}


/**
 * Called when starting to backup a file. Here the plugin must
 * return the "stat" packet for the directory/file and provide
 * certain information so that Bareos knows what the file is.
 * The plugin can create "Virtual" files by giving them a
 * name that is not normally found on the file system.
 */
bRC startBackupFile(PluginContext* plugin_ctx, save_pkt* sp)
{
  bRC retval = bRC_Error;
  struct plugin_private_context* plugin_priv_ctx
      = (struct plugin_private_context*)plugin_ctx->plugin_private_context;

  if (!plugin_priv_ctx) { goto bail_out; }

  {
    auto l = AcquireLock(plugin_priv_ctx->interp);
    retval = Bareosfd_PyStartBackupFile(plugin_ctx, sp);
  }

  Dmsg(plugin_ctx, debuglevel, LOGPREFIX "StartBackupFile returned: %d\n",
       retval);
  if (retval != bRC_OK) { goto bail_out; }

  /* For Incremental and Differential backups use checkChanges method to
   * see if we need to backup this file. */
  switch (plugin_priv_ctx->backup_level) {
    case L_INCREMENTAL:
    case L_DIFFERENTIAL:
      /* If the plugin didn't set a save_time but we have a since time
       * from the bEventSince event we use that as basis for the actual
       * save_time to check. */
      if (sp->save_time == 0 && plugin_priv_ctx->since) {
        sp->save_time = plugin_priv_ctx->since;
      }

      switch (bareos_core_functions->checkChanges(plugin_ctx, sp)) {
        case bRC_Seen:
          switch (sp->type) {
            case FT_DIRBEGIN:
              sp->type = FT_DIRNOCHG;
              break;
            default:
              sp->type = FT_NOCHG;
              break;
          }
          break;
        default:
          break;
      }
  }

bail_out:
  return retval;
}

// Done backing up a file.
bRC endBackupFile(PluginContext* plugin_ctx)
{
  bRC retval = bRC_Error;
  struct plugin_private_context* plugin_priv_ctx
      = (struct plugin_private_context*)plugin_ctx->plugin_private_context;

  if (!plugin_priv_ctx) { goto bail_out; }

  {
    auto l = AcquireLock(plugin_priv_ctx->interp);
    retval = Bareosfd_PyEndBackupFile(plugin_ctx);
  }

bail_out:
  return retval;
}

/**
 * Do actual I/O. Bareos calls this after startBackupFile
 * or after startRestoreFile to do the actual file
 * input or output.
 */
bRC pluginIO(PluginContext* plugin_ctx, io_pkt* io)
{
  bRC retval = bRC_Error;
  struct plugin_private_context* plugin_priv_ctx
      = (struct plugin_private_context*)plugin_ctx->plugin_private_context;

  if (!plugin_priv_ctx) { goto bail_out; }

  if (!plugin_priv_ctx->python_loaded) { goto bail_out; }

  {
    auto l = AcquireLock(plugin_priv_ctx->interp);
    retval = Bareosfd_PyPluginIO(plugin_ctx, io);
  }

bail_out:
  return retval;
}

// Start restore of a file.
bRC startRestoreFile(PluginContext* plugin_ctx, const char* cmd)
{
  bRC retval = bRC_Error;
  struct plugin_private_context* plugin_priv_ctx
      = (struct plugin_private_context*)plugin_ctx->plugin_private_context;

  if (!plugin_priv_ctx) { goto bail_out; }

  {
    auto l = AcquireLock(plugin_priv_ctx->interp);
    retval = Bareosfd_PyStartRestoreFile(plugin_ctx, cmd);
  }

bail_out:
  return retval;
}

// Done restoring a file.
bRC endRestoreFile(PluginContext* plugin_ctx)
{
  bRC retval = bRC_Error;
  struct plugin_private_context* plugin_priv_ctx
      = (struct plugin_private_context*)plugin_ctx->plugin_private_context;

  if (!plugin_priv_ctx) { goto bail_out; }

  {
    auto l = AcquireLock(plugin_priv_ctx->interp);
    retval = Bareosfd_PyEndRestoreFile(plugin_ctx);
  }

bail_out:
  return retval;
}

/**
 * Called here to give the plugin the information needed to
 * re-create the file on a restore.  It basically gets the
 * stat packet that was created during the backup phase.
 * This data is what is needed to create the file, but does
 * not contain actual file data.
 */
bRC createFile(PluginContext* plugin_ctx, restore_pkt* rp)
{
  bRC retval = bRC_Error;
  struct plugin_private_context* plugin_priv_ctx
      = (struct plugin_private_context*)plugin_ctx->plugin_private_context;

  if (!plugin_priv_ctx) { goto bail_out; }

  {
    auto l = AcquireLock(plugin_priv_ctx->interp);
    retval = Bareosfd_PyCreateFile(plugin_ctx, rp);
  }

bail_out:
  return retval;
}

/**
 * Called after the file has been restored. This can be used to
 * set directory permissions, ...
 */
bRC setFileAttributes(PluginContext* plugin_ctx, restore_pkt* rp)
{
  bRC retval = bRC_Error;
  struct plugin_private_context* plugin_priv_ctx
      = (struct plugin_private_context*)plugin_ctx->plugin_private_context;

  if (!plugin_priv_ctx) { goto bail_out; }

  {
    auto l = AcquireLock(plugin_priv_ctx->interp);
    retval = Bareosfd_PySetFileAttributes(plugin_ctx, rp);
  }

bail_out:
  return retval;
}

// When using Incremental dump, all previous dumps are necessary
bRC checkFile(PluginContext* plugin_ctx, char* fname)
{
  bRC retval = bRC_Error;
  struct plugin_private_context* plugin_priv_ctx
      = (struct plugin_private_context*)plugin_ctx->plugin_private_context;

  if (!plugin_priv_ctx) { goto bail_out; }

  if (!plugin_priv_ctx->python_loaded) { return bRC_OK; }

  {
    auto l = AcquireLock(plugin_priv_ctx->interp);
    retval = Bareosfd_PyCheckFile(plugin_ctx, fname);
  }

bail_out:
  return retval;
}

/**
 */
bRC getAcl(PluginContext* plugin_ctx, acl_pkt* ap)
{
  bRC retval = bRC_Error;
  struct plugin_private_context* plugin_priv_ctx
      = (struct plugin_private_context*)plugin_ctx->plugin_private_context;

  if (!plugin_priv_ctx) { goto bail_out; }

  {
    auto l = AcquireLock(plugin_priv_ctx->interp);
    retval = Bareosfd_PyGetAcl(plugin_ctx, ap);
  }

bail_out:
  return retval;
}

/**
 */
bRC setAcl(PluginContext* plugin_ctx, acl_pkt* ap)
{
  bRC retval = bRC_Error;
  struct plugin_private_context* plugin_priv_ctx
      = (struct plugin_private_context*)plugin_ctx->plugin_private_context;

  if (!plugin_priv_ctx) { goto bail_out; }

  {
    auto l = AcquireLock(plugin_priv_ctx->interp);
    retval = Bareosfd_PySetAcl(plugin_ctx, ap);
  }

bail_out:
  return retval;
}

/**
 */
bRC getXattr(PluginContext* plugin_ctx, xattr_pkt* xp)
{
  bRC retval = bRC_Error;
  struct plugin_private_context* plugin_priv_ctx
      = (struct plugin_private_context*)plugin_ctx->plugin_private_context;

  if (!plugin_priv_ctx) { goto bail_out; }

  {
    auto l = AcquireLock(plugin_priv_ctx->interp);
    retval = Bareosfd_PyGetXattr(plugin_ctx, xp);
  }

bail_out:
  return retval;
}

/**
 */
bRC setXattr(PluginContext* plugin_ctx, xattr_pkt* xp)
{
  bRC retval = bRC_Error;
  struct plugin_private_context* plugin_priv_ctx
      = (struct plugin_private_context*)plugin_ctx->plugin_private_context;

  if (!plugin_priv_ctx) { goto bail_out; }

  {
    auto l = AcquireLock(plugin_priv_ctx->interp);
    retval = Bareosfd_PySetXattr(plugin_ctx, xp);
  }

bail_out:
  return retval;
}

// Only set destination to value when it has no previous setting.
void SetStringIfNull(char** destination, std::string_view val)
{
  if (!*destination) {
    *destination = CopyStringView(val);
    StripBackSlashes(*destination);
  }
}

// Allows one or both pointers to be NULL
static bool bstrcmp(const char* s1, const char* s2)
{
  if (s1 == s2) return true;
  if (s1 == NULL || s2 == NULL) return false;
  return strcmp(s1, s2) == 0;
}

/**
 * Parse the plugin definition passed in.
 *
 * The definition is in this form:
 *
 * python:module_path=<path>:module_name=<python_module_name>:...
 */
bRC parse_plugin_definition(PluginContext* plugin_ctx,
                            const void* value,
                            std::string& plugin_options)
{
  bool found;
  int i, cnt;
  bool keep_existing;
  std::string plugin_definition;
  const char *bp, *argument, *argument_value;
  plugin_private_context* plugin_priv_ctx
      = (plugin_private_context*)plugin_ctx->plugin_private_context;

  if (!value) { return bRC_Error; }

  /* Skip this plugin when getting plugin definition "*all*"
   * This allows to restore a Windows Backup on a Linux FD with
   * Python Plugins enabled. */
  if (bstrcmp((char*)value, "*all*")) {
    Dmsg(plugin_ctx, debuglevel,
         LOGPREFIX "Got plugin definition %s, skipping to ignore\n",
         (char*)value);
    return bRC_Skip;
  }

  keep_existing = (plugin_priv_ctx->plugin_options) ? true : false;

  /* Parse the plugin definition.
   * Make a private copy of the whole string. */
  if (!plugin_priv_ctx->python_loaded && plugin_priv_ctx->plugin_options) {
    /* We got some option string which got pushed before we actual were able to
     * send it to the python module as the entry point was not instantiated. So
     * we prepend that now in the option string and append the new option string
     * with the first argument being the pluginname removed as that is already
     * part of the other plugin option string. */
    plugin_definition = plugin_priv_ctx->plugin_options;

    bp = strchr((char*)value, ':');
    if (!bp) {
      Jmsg(plugin_ctx, M_FATAL, LOGPREFIX "Illegal plugin definition %s\n",
           (char*)value);
      Dmsg(plugin_ctx, debuglevel, LOGPREFIX "Illegal plugin definition %s\n",
           (char*)value);
      goto bail_out;
    }

    // See if option string end with ':'
    if (plugin_definition.size() == 0 || plugin_definition.back() != ':') {
      plugin_definition += bp;
    } else {
      plugin_definition += (bp + 1);
    }
  } else {
    plugin_definition = (const char*)value;
  }

  bp = strchr(plugin_definition.c_str(), ':');
  if (!bp) {
    Jmsg(plugin_ctx, M_FATAL, LOGPREFIX "Illegal plugin definition %s\n",
         plugin_definition.c_str());
    Dmsg(plugin_ctx, debuglevel, LOGPREFIX "Illegal plugin definition %s\n",
         plugin_definition.c_str());
    goto bail_out;
  }

  // Skip the first ':'
  bp++;

  cnt = 0;
  while (bp) {
    if (*bp == '\0') { break; }

    /* Each argument is in the form:
     *    <argument> = <argument_value>
     *
     * So we setup the right pointers here, argument to the beginning
     * of the argument, argument_value to the beginning of the argument_value.
     */
    argument = bp;
    const char* eq = strchr(bp, '=');
    if (!eq) {
      Jmsg(plugin_ctx, M_FATAL, LOGPREFIX "Illegal argument %s without value\n",
           argument);
      Dmsg(plugin_ctx, debuglevel,
           LOGPREFIX "Illegal argument %s without value\n", argument);
      goto bail_out;
    }
    argument_value = eq + 1;

    // See if there are more arguments and setup for the next run.
    const char* vend = argument_value;
    bp = argument_value;
    for (;;) {
      bp = strchr(bp, ':');
      if (bp) {
        if (*(bp - 1) != '\\') {
          vend = bp;
          bp += 1;
          break;
        } else {
          bp++;
        }
      } else {
        vend = &*plugin_definition.end();
        break;
      }
    }

    size_t arg_len = eq - argument;
    size_t val_len = vend - argument_value;

    found = false;
    for (i = 0; plugin_arguments[i].name; i++) {
      if (strncasecmp(argument, plugin_arguments[i].name, arg_len) == 0) {
        char** str_destination = NULL;
        bool* bool_destination = NULL;

        switch (plugin_arguments[i].type) {
          case argument_module_path:
            str_destination = &plugin_priv_ctx->module_path;
            break;
          case argument_module_name:
            str_destination = &plugin_priv_ctx->module_name;
            break;
          default:
            break;
        }

        // Keep the first value, ignore any next setting.
        if (str_destination) {
          if (keep_existing) {
            SetStringIfNull(str_destination,
                            std::string_view{argument_value, val_len});
          } else {
            SetString(str_destination,
                      std::string_view{argument_value, val_len});
          }
        }

        // Set any boolean variable.
        if (bool_destination) {
          *bool_destination = ParseBoolean(argument_value);
        }

        // When we have a match break the loop.
        found = true;
        break;
      }
    }

    // If we didn't consume this parameter we add it to the plugin_options list.
    if (!found) {
      if (cnt) { plugin_options += ":"; }
      plugin_options += std::string_view{argument, arg_len};
      plugin_options += "=";
      plugin_options += std::string_view{argument_value, val_len};
      cnt++;
    }
  }

  if (cnt > 0) { plugin_options += ":"; }

  return bRC_OK;

bail_out:
  return bRC_Error;
}

bRC handlePluginEvent(PluginContext* plugin_ctx, bEvent* event, void* value)
{
  bRC retval = bRC_Error;
  bool event_dispatched = false;
  std::string plugin_options;
  plugin_private_context* plugin_priv_ctx
      = (plugin_private_context*)plugin_ctx->plugin_private_context;

  if (!plugin_priv_ctx) { return bRC_Error; }

  /* First handle some events internally before calling python if it
   * want to do some special handling on the event triggered. */
  switch (event->eventType) {
    case bEventLevel:
      plugin_priv_ctx->backup_level = (int64_t)value;
      break;
    case bEventSince:
      plugin_priv_ctx->since = (int64_t)value;
      break;
    case bEventBackupCommand:
      /* Fall-through wanted */
    case bEventRestoreCommand:
      /* Fall-through wanted */
    case bEventEstimateCommand:
      /* Fall-through wanted */
    case bEventPluginCommand:
      event_dispatched = true;
      retval = parse_plugin_definition(plugin_ctx, value, plugin_options);
      break;
    case bEventNewPluginOptions:
      /* Free any previous value.  */
      if (plugin_priv_ctx->plugin_options) {
        free(plugin_priv_ctx->plugin_options);
        plugin_priv_ctx->plugin_options = NULL;
      }

      event_dispatched = true;
      retval = parse_plugin_definition(plugin_ctx, value, plugin_options);

      /* Save that we got a plugin override.  */
      plugin_priv_ctx->plugin_options = strdup((char*)value);
      break;
    case bEventRestoreObject: {
      restore_object_pkt* rop;

      rop = (restore_object_pkt*)value;

      /* Only use the plugin definition of a restore object if we
       * didn't get any other plugin definition from some other source before.*/
      if (!plugin_priv_ctx->python_loaded) {
        if (rop && *rop->plugin_name) {
          event_dispatched = true;
          retval = parse_plugin_definition(plugin_ctx, rop->plugin_name,
                                           plugin_options);
        }
      }
      break;
    }
    default:
      break;
  }

  /* See if we have been triggered in the previous switch if not we have to
   * always dispatch the event. If we already processed the event internally
   * we only do a dispatch to the python entry point when that internal
   * processing was successful (e.g. retval == bRC_OK). */
  if (!event_dispatched || retval == bRC_OK) {
    auto l = AcquireLock(plugin_priv_ctx->interp);
    Bareosfd_set_plugin_context(plugin_ctx);

    /* Now dispatch the event to Python.
     * First the calls that need special handling. */
    switch (event->eventType) {
      case bEventBackupCommand:
        /* Fall-through wanted */
      case bEventRestoreCommand:
        /* Fall-through wanted */
      case bEventEstimateCommand:
        /* Fall-through wanted */
      case bEventPluginCommand:
        /* Fall-through wanted */
      case bEventNewPluginOptions:
        /* See if we already loaded the Python modules. */
        if (!plugin_priv_ctx->python_loaded) {
          retval = PyLoadModule(plugin_ctx, plugin_options.c_str());
        }

        /* Only try to call when the loading succeeded. */
        if (retval == bRC_OK) {
          retval = Bareosfd_PyParsePluginDefinition(plugin_ctx,
                                                    plugin_options.data());
        }
        break;
      case bEventRestoreObject: {
        restore_object_pkt* rop;

        rop = (restore_object_pkt*)value;
        if (!rop) {
          /* If rop == NULL this means we got the last restore object.
           * No need to call into python so just return. */
          retval = bRC_OK;
        } else {
          /* See if we already loaded the Python modules. */
          if (!plugin_priv_ctx->python_loaded && *rop->plugin_name) {
            retval = PyLoadModule(plugin_ctx, plugin_options.c_str());

            /* Only try to call when the loading succeeded. */
            if (retval == bRC_OK) {
              retval = Bareosfd_PyParsePluginDefinition(plugin_ctx,
                                                        plugin_options.data());
              if (retval == bRC_OK) {
                retval = Bareosfd_PyRestoreObjectData(plugin_ctx, rop);
              }
            }
          } else {
            retval = Bareosfd_PyRestoreObjectData(plugin_ctx, rop);
          }
        }
        break;
      }
      case bEventHandleBackupFile:
        retval = Bareosfd_PyHandleBackupFile(plugin_ctx, (save_pkt*)value);
        break;
      default:
        /* Handle the generic events e.g. the ones which are just passed on.
         * We only try to call Python when we loaded the right module until
         * that time we pretend the call succeeded. */
        if (plugin_priv_ctx->python_loaded) {
          retval = Bareosfd_PyHandlePluginEvent(plugin_ctx, event, value);
        } else {
          retval = bRC_OK;
        }
        break;
    }
  }

  return retval;
}


bRC getPluginValue(PluginContext* bareos_plugin_ctx, pVariable var, void* value)
{
  struct plugin_private_context* plugin_priv_ctx
      = (struct plugin_private_context*)
            bareos_plugin_ctx->plugin_private_context;
  bRC retval = bRC_Error;

  if (!plugin_priv_ctx) { goto bail_out; }

  {
    auto l = AcquireLock(plugin_priv_ctx->interp);
    retval = Bareosfd_PyGetPluginValue(bareos_plugin_ctx, var, value);
  }

bail_out:
  return retval;
}

bRC setPluginValue(PluginContext* bareos_plugin_ctx, pVariable var, void* value)
{
  struct plugin_private_context* plugin_priv_ctx
      = (struct plugin_private_context*)
            bareos_plugin_ctx->plugin_private_context;
  bRC retval = bRC_Error;

  if (!plugin_priv_ctx) { return bRC_Error; }

  auto l = AcquireLock(plugin_priv_ctx->interp);
  retval = Bareosfd_PySetPluginValue(bareos_plugin_ctx, var, value);

  return retval;
}

PluginInformation pluginInfo = {sizeof(pluginInfo), FD_PLUGIN_INTERFACE_VERSION,
                                FD_PLUGIN_MAGIC,    PLUGIN_LICENSE,
                                PLUGIN_AUTHOR,      PLUGIN_DATE,
                                PLUGIN_VERSION,     PLUGIN_DESCRIPTION,
                                PLUGIN_USAGE};

PluginFunctions pluginFuncs
    = {sizeof(pluginFuncs), FD_PLUGIN_INTERFACE_VERSION,

       /* Entry points into plugin */
       newPlugin,  /* new plugin instance */
       freePlugin, /* free plugin instance */
       getPluginValue, setPluginValue, handlePluginEvent, startBackupFile,
       endBackupFile, startRestoreFile, endRestoreFile, pluginIO, createFile,
       setFileAttributes, checkFile, getAcl, setAcl, getXattr, setXattr};

}  // namespace

extern "C" {

// Plugin called here when it is first loaded
BAREOS_EXPORT bRC
loadPlugin(PluginApiDefinition* lbareos_plugin_interface_version,
           CoreFunctions* lbareos_core_functions,
           PluginInformation** plugin_information,
           PluginFunctions** plugin_functions)
{
  if (Py_IsInitialized()) { return bRC_Error; }

  Py_InitializeEx(0);
  // add bareos plugin path to python module search path
  PyObject* sysPath = PySys_GetObject((char*)"path");
  PyObject* pluginPath = PyUnicode_FromString(PLUGIN_DIR);
  PyList_Append(sysPath, pluginPath);
  Py_DECREF(pluginPath);

  /* import the bareosfd module */
  PyObject* bareosfdModule = PyImport_ImportModule("bareosfd");
  if (!bareosfdModule) {
    printf("loading of bareosfd extension module failed\n");
    if (PyErr_Occurred()) { PyErrorHandler(); }
  }

  /* import the CAPI from the bareosfd python module
   * afterwards, Bareosfd_* macros are initialized to
   * point to the corresponding functions in the bareosfd python
   * module */
  import_bareosfd();

  /* set bareos_core_functions inside of barosfd module */
  Bareosfd_set_bareos_core_functions(lbareos_core_functions);

  bareos_core_functions
      = lbareos_core_functions; /* Set Bareos funct pointers */
  bareos_plugin_interface_version = lbareos_plugin_interface_version;

  *plugin_information = &pluginInfo; /* Return pointer to our info */
  *plugin_functions = &pluginFuncs;  /* Return pointer to our functions */

#if PY_VERSION_HEX < VERSION_HEX(3, 7, 0)
  PyEval_InitThreads();
#endif

  mainThreadState = PyEval_SaveThread();
  return bRC_OK;
}

/**
 * Plugin called here when it is unloaded, normally when Bareos is going to
 * exit.
 */
BAREOS_EXPORT
bRC unloadPlugin()
{
  /* Terminate Python if it was initialized correctly */
  if (mainThreadState) {
    PyEval_RestoreThread(mainThreadState);
    Py_Finalize();
    mainThreadState = nullptr;
  }
  return bRC_OK;
}

}  //  extern "C"


} /* namespace filedaemon */
