base/native_library.h

   1 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef BASE_NATIVE_LIBRARY_H_
   6 #define BASE_NATIVE_LIBRARY_H_
   7
   8 // This file defines a cross-platform "NativeLibrary" type which represents
   9 // a loadable module.
  10
  11 #include "base/base_export.h"
  12 #include "build/build_config.h"
  13
  14 #if defined(OS_WIN)
  15 #include <windows.h>
  16 #elif defined(OS_MACOSX)
  17 #import <CoreFoundation/CoreFoundation.h>
  18 #endif  // OS_*
  19
  20 #include "base/string16.h"
  21
  22 // Macro useful for writing cross-platform function pointers.
  23 #if defined(OS_WIN) && !defined(CDECL)
  24 #define CDECL __cdecl
  25 #else
  26 #define CDECL
  27 #endif
  28
  29 class FilePath;
  30
  31 namespace base {
  32
  33 #if defined(OS_WIN)
  34 typedef HMODULE NativeLibrary;
  35 #elif defined(OS_MACOSX)
  36 enum NativeLibraryType {
  37   BUNDLE,
  38   DYNAMIC_LIB
  39 };
  40 struct NativeLibraryStruct {
  41   NativeLibraryType type;
  42   CFBundleRefNum bundle_resource_ref;
  43   union {
  44     CFBundleRef bundle;
  45     void* dylib;
  46   };
  47 };
  48 typedef NativeLibraryStruct* NativeLibrary;
  49 #elif defined(OS_POSIX)
  50 typedef void* NativeLibrary;
  51 #endif  // OS_*
  52
  53 // Loads a native library from disk.  Release it with UnloadNativeLibrary when
  54 // you're done.  Returns NULL on failure.
  55 // If |err| is not NULL, it may be filled in with an error message on
  56 // error.
  57 BASE_EXPORT NativeLibrary LoadNativeLibrary(const FilePath& library_path,
  58                                             std::string* error);
  59
  60 #if defined(OS_WIN)
  61 // Loads a native library from disk.  Release it with UnloadNativeLibrary when
  62 // you're done.
  63 // This function retrieves the LoadLibrary function exported from kernel32.dll
  64 // and calls it instead of directly calling the LoadLibrary function via the
  65 // import table.
  66 BASE_EXPORT NativeLibrary LoadNativeLibraryDynamically(
  67     const FilePath& library_path);
  68 #endif  // OS_WIN
  69
  70 // Unloads a native library.
  71 BASE_EXPORT void UnloadNativeLibrary(NativeLibrary library);
  72
  73 // Gets a function pointer from a native library.
  74 BASE_EXPORT void* GetFunctionPointerFromNativeLibrary(NativeLibrary library,
  75                                                       const char* name);
  76
  77 // Returns the full platform specific name for a native library.
  78 // For example:
  79 // "mylib" returns "mylib.dll" on Windows, "libmylib.so" on Linux,
  80 // "mylib.dylib" on Mac.
  81 BASE_EXPORT string16 GetNativeLibraryName(const string16& name);
  82
  83 }  // namespace base
  84
  85 #endif  // BASE_NATIVE_LIBRARY_H_