include/llvm/Support/PluginLoader.h

   1 //===-- llvm/Support/PluginLoader.h - Plugin Loader for Tools ---*- 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 // A tool can #include this file to get a -load option that allows the user to
  10 // load arbitrary shared objects into the tool's address space.  Note that this
  11 // header can only be included by a program ONCE, so it should never to used by
  12 // library authors.
  13 //
  14 //===----------------------------------------------------------------------===//
  15
  16 #ifndef LLVM_SUPPORT_PLUGINLOADER_H
  17 #define LLVM_SUPPORT_PLUGINLOADER_H
  18
  19 #include "llvm/Support/CommandLine.h"
  20
  21 namespace llvm {
  22   struct PluginLoader {
  23     void operator=(const std::string &Filename);
  24     static unsigned getNumPlugins();
  25     static std::string& getPlugin(unsigned num);
  26   };
  27
  28 #ifndef DONT_GET_PLUGIN_LOADER_OPTION
  29   // This causes operator= above to be invoked for every -load option.
  30   static cl::opt<PluginLoader, false, cl::parser<std::string> >
  31     LoadOpt("load", cl::ZeroOrMore, cl::value_desc("pluginfilename"),
  32             cl::desc("Load the specified plugin"));
  33 #endif
  34 }
  35
  36 #endif