xref: /freebsd/contrib/llvm-project/llvm/include/llvm/Support/PluginLoader.h (revision 162ae9c834f6d9f9cb443bd62cceb23e0b5fef48)
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
37