IKVM.Runtime.NativeLibrary Class Reference

Provides methods to load libraries from standard .NET search locations. This class is not used to load native libraries for JNI. On platforms that have native NativeLibrary support, that support is used. On other platforms, libikvm is used to invoke the platform loader. More...

Static Public Member Functions
static string	MapLibraryName (string name)
	Returns a version of the library name with the OS specific prefix and suffix.
static NativeLibraryHandle	Load (string nameOrPath)
	Loads the given library in a platform dependent manner.

Detailed Description

Provides methods to load libraries from standard .NET search locations. This class is not used to load native libraries for JNI. On platforms that have native NativeLibrary support, that support is used. On other platforms, libikvm is used to invoke the platform loader.

Definition at line 15 of file NativeLibrary.cs.

Member Function Documentation

Load()

static NativeLibraryHandle IKVM.Runtime.NativeLibrary.Load ( string nameOrPath )

static

Loads the given library in a platform dependent manner.

Parameters

nameOrPath

Returns

Definition at line 66 of file NativeLibrary.cs.

        {
            if (Path.IsPathRooted(nameOrPath))
                return LoadImpl(nameOrPath);
 
            // give native loader a chance to load the library
            if (LoadImpl(nameOrPath) is NativeLibraryHandle h1)
                return h1;
 
            // start looking at assembly path, or path given by environmental variable
            var asml = typeof(NativeLibrary).Assembly.Location is string s && !string.IsNullOrEmpty(s) ? Path.GetDirectoryName(s) : null;
            var root = Environment.GetEnvironmentVariable("IKVM_LIBRARY_PATH") ?? asml;
 
            // assembly possible loaded in memory: we have no available search path
            if (string.IsNullOrEmpty(root))
                return null;
 
            // check in root directory
            if (Path.Combine(root, MapLibraryName(nameOrPath)) is string lib1)
                if (File.Exists(lib1) && LoadImpl(lib1) is NativeLibraryHandle h2)
                    return h2;
 
            // scan supported RIDs for current platform
            foreach (var rid in RuntimeUtil.SupportedRuntimeIdentifiers)
                if (Path.Combine(root, "runtimes", rid, "native", MapLibraryName(nameOrPath)) is string lib2)
                    if (File.Exists(lib2) && LoadImpl(lib2) is NativeLibraryHandle h3)
                        return h3;
 
            return null;
        }

MapLibraryName()

static string IKVM.Runtime.NativeLibrary.MapLibraryName ( string name )

static

Returns a version of the library name with the OS specific prefix and suffix.

Parameters

name

Returns

Definition at line 29 of file NativeLibrary.cs.

        {
            if (name == null)
                return null;
            if (Path.HasExtension(name))
                return name;
 
            if (RuntimeUtil.IsWindows)
                return name + ".dll";
            else if (RuntimeUtil.IsOSX)
                return "lib" + name + ".dylib";
            else
                return "lib" + name + ".so";
        }

---

The documentation for this class was generated from the following file:

• src/IKVM.Runtime/NativeLibrary.cs