// Copyright 2015 gRPC authors. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. #define GUICS using System; using System.IO; using System.Reflection; using System.Runtime.InteropServices; using System.Threading; namespace Unix.Terminal { /// /// Represents a dynamically loaded unmanaged library in a (partially) platform independent manner. /// First, the native library is loaded using dlopen (on Unix systems) or using LoadLibrary (on Windows). /// dlsym or GetProcAddress are then used to obtain symbol addresses. Marshal.GetDelegateForFunctionPointer /// transforms the addresses into delegates to native methods. /// See http://stackoverflow.com/questions/13461989/p-invoke-to-dynamically-loaded-library-on-mono. /// internal class UnmanagedLibrary { const string UnityEngineApplicationClassName = "UnityEngine.Application, UnityEngine"; const string XamarinAndroidObjectClassName = "Java.Lang.Object, Mono.Android"; const string XamarinIOSObjectClassName = "Foundation.NSObject, Xamarin.iOS"; static bool IsWindows, IsLinux, IsMacOS; static bool Is64Bit; #if GUICS static bool IsMono; #else static bool IsMono, IsUnity, IsXamarinIOS, IsXamarinAndroid, IsXamarin; #endif static bool IsNetCore; public static bool IsMacOSPlatform => IsMacOS; [DllImport ("libc")] static extern int uname (IntPtr buf); static string GetUname () { var buffer = Marshal.AllocHGlobal (8192); try { if (uname (buffer) == 0) { return Marshal.PtrToStringAnsi (buffer); } return string.Empty; } catch { return string.Empty; } finally { if (buffer != IntPtr.Zero) { Marshal.FreeHGlobal (buffer); } } } static UnmanagedLibrary () { var platform = Environment.OSVersion.Platform; IsMacOS = (platform == PlatformID.Unix && GetUname () == "Darwin"); IsLinux = (platform == PlatformID.Unix && !IsMacOS); IsWindows = (platform == PlatformID.Win32NT || platform == PlatformID.Win32S || platform == PlatformID.Win32Windows); Is64Bit = Marshal.SizeOf (typeof (IntPtr)) == 8; IsMono = Type.GetType ("Mono.Runtime") != null; if (!IsMono) { IsNetCore = Type.GetType ("System.MathF") != null; } #if GUICS //IsUnity = IsXamarinIOS = IsXamarinAndroid = IsXamarin = false; #else IsUnity = Type.GetType (UnityEngineApplicationClassName) != null; IsXamarinIOS = Type.GetType (XamarinIOSObjectClassName) != null; IsXamarinAndroid = Type.GetType (XamarinAndroidObjectClassName) != null; IsXamarin = IsXamarinIOS || IsXamarinAndroid; #endif } // flags for dlopen const int RTLD_LAZY = 1; const int RTLD_GLOBAL = 8; readonly string libraryPath; readonly IntPtr handle; public IntPtr NativeLibraryHandle => handle; // // if isFullPath is set to true, the provided array of libraries are full paths // and are tested for the file existing, otherwise the file is merely the name // of the shared library that we pass to dlopen // public UnmanagedLibrary (string [] libraryPathAlternatives, bool isFullPath) { if (isFullPath){ this.libraryPath = FirstValidLibraryPath (libraryPathAlternatives); this.handle = PlatformSpecificLoadLibrary (this.libraryPath); } else { foreach (var lib in libraryPathAlternatives){ this.handle = PlatformSpecificLoadLibrary (lib); if (this.handle != IntPtr.Zero) break; } } if (this.handle == IntPtr.Zero) { throw new IOException (string.Format ("Error loading native library \"{0}\"", this.libraryPath)); } } /// /// Loads symbol in a platform specific way. /// /// /// public IntPtr LoadSymbol (string symbolName) { if (IsWindows) { // See http://stackoverflow.com/questions/10473310 for background on this. if (Is64Bit) { return Windows.GetProcAddress (this.handle, symbolName); } else { // Yes, we could potentially predict the size... but it's a lot simpler to just try // all the candidates. Most functions have a suffix of @0, @4 or @8 so we won't be trying // many options - and if it takes a little bit longer to fail if we've really got the wrong // library, that's not a big problem. This is only called once per function in the native library. symbolName = "_" + symbolName + "@"; for (int stackSize = 0; stackSize < 128; stackSize += 4) { IntPtr candidate = Windows.GetProcAddress (this.handle, symbolName + stackSize); if (candidate != IntPtr.Zero) { return candidate; } } // Fail. return IntPtr.Zero; } } if (IsLinux) { if (IsMono) { return Mono.dlsym (this.handle, symbolName); } if (IsNetCore) { return CoreCLR.dlsym (this.handle, symbolName); } return Linux.dlsym (this.handle, symbolName); } if (IsMacOS) { return MacOSX.dlsym (this.handle, symbolName); } throw new InvalidOperationException ("Unsupported platform."); } public T GetNativeMethodDelegate (string methodName) where T : class { var ptr = LoadSymbol (methodName); if (ptr == IntPtr.Zero) { throw new MissingMethodException (string.Format ("The native method \"{0}\" does not exist", methodName)); } return Marshal.GetDelegateForFunctionPointer(ptr); // non-generic version is obsolete } /// /// Loads library in a platform specific way. /// static IntPtr PlatformSpecificLoadLibrary (string libraryPath) { if (IsWindows) { return Windows.LoadLibrary (libraryPath); } if (IsLinux) { if (IsMono) { return Mono.dlopen (libraryPath, RTLD_GLOBAL + RTLD_LAZY); } if (IsNetCore) { return CoreCLR.dlopen (libraryPath, RTLD_GLOBAL + RTLD_LAZY); } return Linux.dlopen (libraryPath, RTLD_GLOBAL + RTLD_LAZY); } if (IsMacOS) { return MacOSX.dlopen (libraryPath, RTLD_GLOBAL + RTLD_LAZY); } throw new InvalidOperationException ("Unsupported platform."); } static string FirstValidLibraryPath (string [] libraryPathAlternatives) { foreach (var path in libraryPathAlternatives) { if (File.Exists (path)) { return path; } } throw new FileNotFoundException ( String.Format ("Error loading native library. Not found in any of the possible locations: {0}", string.Join (",", libraryPathAlternatives))); } static class Windows { [DllImport ("kernel32.dll")] internal static extern IntPtr LoadLibrary (string filename); [DllImport ("kernel32.dll")] internal static extern IntPtr GetProcAddress (IntPtr hModule, string procName); } static class Linux { [DllImport ("libdl.so")] internal static extern IntPtr dlopen (string filename, int flags); [DllImport ("libdl.so")] internal static extern IntPtr dlsym (IntPtr handle, string symbol); } static class MacOSX { [DllImport ("libSystem.dylib")] internal static extern IntPtr dlopen (string filename, int flags); [DllImport ("libSystem.dylib")] internal static extern IntPtr dlsym (IntPtr handle, string symbol); } /// /// On Linux systems, using using dlopen and dlsym results in /// DllNotFoundException("libdl.so not found") if libc6-dev /// is not installed. As a workaround, we load symbols for /// dlopen and dlsym from the current process as on Linux /// Mono sure is linked against these symbols. /// static class Mono { [DllImport ("__Internal")] internal static extern IntPtr dlopen (string filename, int flags); [DllImport ("__Internal")] internal static extern IntPtr dlsym (IntPtr handle, string symbol); } /// /// Similarly as for Mono on Linux, we load symbols for /// dlopen and dlsym from the "libcoreclr.so", /// to avoid the dependency on libc-dev Linux. /// static class CoreCLR { #if NET5_0 // Custom resolver to support true single-file apps // (those which run directly from bundle; in-memory). // -1 on Unix means self-referencing binary (libcoreclr.so) // 0 means fallback to CoreCLR's internal resolution // Note: meaning of -1 stay the same even for non-single-file form factors. static CoreCLR() => NativeLibrary.SetDllImportResolver(typeof(CoreCLR).Assembly, (string libraryName, Assembly assembly, DllImportSearchPath? searchPath) => libraryName == "libcoreclr.so" ? (IntPtr)(-1) : IntPtr.Zero); #endif [DllImport ("libcoreclr.so")] internal static extern IntPtr dlopen (string filename, int flags); [DllImport ("libcoreclr.so")] internal static extern IntPtr dlsym (IntPtr handle, string symbol); } } }