Upgrade to 27.0.0

Changes to the C api:

Wasi file and directory permissions
Shared Memory support
Configuration changes from static/dynamic to a single guard region: https://docs.wasmtime.dev/api/wasmtime/struct.Config.html#method.memory_guard_size

All tests passing

Author: Bas Geertsema

Directory.Build.props

@@ -1,7 +1,7 @@
 <Project>
   <PropertyGroup>
     <DevBuild Condition="'$(DevBuild)'==''">false</DevBuild>
-    <WasmtimeVersion Condition="'$(WasmtimeVersion)'==''">26.0.1</WasmtimeVersion>
+    <WasmtimeVersion Condition="'$(WasmtimeVersion)'==''">27.0.0</WasmtimeVersion>
     <WasmtimeDotnetVersion Condition="'$(WasmtimeDotnetVersion)'==''"></WasmtimeDotnetVersion>
     <WasmtimePackageVersion Condition="'$(DevBuild)'=='true'">
       $(WasmtimeVersion)$(WasmtimeDotnetVersion)-dev</WasmtimePackageVersion>

src/Config.cs

@@ -303,24 +303,13 @@ public Config WithStaticMemoryMaximumSize(ulong size)
         }
 
         /// <summary>
-        /// Sets the maximum size of the guard region for static WebAssembly linear memories.
+        /// Sets the size of the guard region used at the end of a linear memory’s address space reservation
         /// </summary>
-        /// <param name="size">The maximum guard region size for static WebAssembly linear memories, in bytes.</param>
+        /// <param name="size">The size, in bytes, of the guard region used at the end of a linear memory’s address space reservation</param>
         /// <returns>Returns the current config.</returns>
-        public Config WithStaticMemoryGuardSize(ulong size)
+        public Config WithMemoryGuardSize(ulong size)
         {
-            Native.wasmtime_config_static_memory_guard_size_set(handle, size);
-            return this;
-        }
-
-        /// <summary>
-        /// Sets the maximum size of the guard region for dynamic WebAssembly linear memories.
-        /// </summary>
-        /// <param name="size">The maximum guard region size for dynamic WebAssembly linear memories, in bytes.</param>
-        /// <returns>Returns the current config.</returns>
-        public Config WithDynamicMemoryGuardSize(ulong size)
-        {
-            Native.wasmtime_config_dynamic_memory_guard_size_set(handle, size);
+            Native.wasmtime_config_memory_guard_size_set(handle, size);
             return this;
         }
 
@@ -457,10 +446,7 @@ private static class Native
             public static extern void wasmtime_config_static_memory_maximum_size_set(Handle config, ulong size);
 
             [DllImport(Engine.LibraryName)]
-            public static extern void wasmtime_config_static_memory_guard_size_set(Handle config, ulong size);
-
-            [DllImport(Engine.LibraryName)]
-            public static extern void wasmtime_config_dynamic_memory_guard_size_set(Handle config, ulong size);
+            public static extern void wasmtime_config_memory_guard_size_set(Handle config, ulong size);
 
             [DllImport(Engine.LibraryName)]
             public static extern IntPtr wasmtime_config_cache_config_load(Handle config, [MarshalAs(Extensions.LPUTF8Str)] string? path);

src/Memory.cs

@@ -17,7 +17,8 @@ public class Memory : IExternal
         /// <param name="minimum">The minimum number of WebAssembly pages.</param>
         /// <param name="maximum">The maximum number of WebAssembly pages, or <c>null</c> to not specify a maximum.</param>
         /// <param name="is64Bit"><c>true</c> when memory type represents a 64-bit memory, <c>false</c> when it represents a 32-bit memory.</param>
-        public Memory(Store store, long minimum = 0, long? maximum = null, bool is64Bit = false)
+        /// <param name="isShared"><c>true</c> when memory is shared, <c>false</c> when it is not shared.</param>
+        public Memory(Store store, long minimum = 0, long? maximum = null, bool is64Bit = false, bool isShared = false)
         {
             if (store is null)
             {
@@ -43,8 +44,9 @@ public Memory(Store store, long minimum = 0, long? maximum = null, bool is64Bit
             Minimum = minimum;
             Maximum = maximum;
             Is64Bit = is64Bit;
+            IsShared = isShared;
 
-            var typeHandle = Native.wasmtime_memorytype_new((ulong)minimum, maximum is not null, (ulong)(maximum ?? 0), is64Bit);
+            var typeHandle = Native.wasmtime_memorytype_new((ulong)minimum, maximum is not null, (ulong)(maximum ?? 0), is64Bit, isShared);
             try
             {
 
@@ -61,7 +63,7 @@ public Memory(Store store, long minimum = 0, long? maximum = null, bool is64Bit
                 Native.wasm_memorytype_delete(typeHandle);
             }
         }
-
+        
         /// <summary>
         /// The size, in bytes, of a WebAssembly memory page.
         /// </summary>
@@ -85,6 +87,12 @@ public Memory(Store store, long minimum = 0, long? maximum = null, bool is64Bit
         /// <value><c>true</c> if this type of memory represents a 64-bit memory, <c>false</c> otherwise.</value>
         public bool Is64Bit { get; }
 
+        /// <summary>
+        /// Gets a value that indicates whether this memory is shared.
+        /// </summary>
+        /// <value><c>true</c> if this memory is shared, <c>false</c> otherwise.</value>
+        public bool IsShared { get; }
+
         /// <summary>
         /// Gets the current size of the memory, in WebAssembly page units.
         /// </summary>
@@ -595,7 +603,7 @@ internal static class Native
             public static extern IntPtr wasmtime_memory_type(IntPtr context, in ExternMemory memory);
 
             [DllImport(Engine.LibraryName)]
-            public static extern IntPtr wasmtime_memorytype_new(ulong min, [MarshalAs(UnmanagedType.I1)] bool max_present, ulong max, [MarshalAs(UnmanagedType.I1)] bool is_64);
+            public static extern IntPtr wasmtime_memorytype_new(ulong min, [MarshalAs(UnmanagedType.I1)] bool max_present, ulong max, [MarshalAs(UnmanagedType.I1)] bool is_64, [MarshalAs(UnmanagedType.I1)] bool shared);
 
             [DllImport(Engine.LibraryName)]
             public static extern ulong wasmtime_memorytype_minimum(IntPtr type);

src/WasiConfiguration.cs

@@ -7,6 +7,40 @@
 
 namespace Wasmtime
 {
+    /// <summary>
+    /// The permissions granted for a directory when preopening it.
+    /// </summary>
+    [Flags]
+    public enum WasiDirectoryPermissions
+    {
+        /// <summary>
+        /// This directory can be read, for example its entries can be iterated.
+        /// </summary>
+        Read = 1,
+        
+        /// <summary>
+        /// This directory can be written to, for example new files can be created within it.
+        /// </summary>
+        Write = 2
+    }
+    
+    /// <summary>
+    /// The permissions granted for files when preopening a directory.
+    /// </summary>
+    [Flags]
+    public enum WasiFilePermissions
+    {
+        /// <summary>
+        /// Files can be read.
+        /// </summary>
+        Read = 1,
+        
+        /// <summary>
+        /// Files can be written to.
+        /// </summary>
+        Write = 2
+    }
+    
     /// <summary>
     /// Represents a WASI configuration.
     /// </summary>
@@ -249,13 +283,19 @@ public WasiConfiguration WithInheritedStandardError()
             return this;
         }
 
+        
+            
         /// <summary>
         /// Adds a preopen directory to the configuration.
         /// </summary>
         /// <param name="path">The path to the directory to add.</param>
         /// <param name="guestPath">The path the guest will use to open the directory.</param>
+        /// <param name="directoryPermissions">The permissions that wasm will have to operate on <paramref name="guestPath"/>. This can be used, for example, to provide readonly access to a directory.</param>
+        /// <param name="filePermissions">The permissions that wasm will have for any file in this directory.</param>
         /// <returns>Returns the current configuration.</returns>
-        public WasiConfiguration WithPreopenedDirectory(string path, string guestPath)
+        public WasiConfiguration WithPreopenedDirectory(
+            string path, string guestPath, 
+            WasiDirectoryPermissions directoryPermissions, WasiFilePermissions filePermissions)
         {
             if (string.IsNullOrEmpty(path))
             {
@@ -266,7 +306,7 @@ public WasiConfiguration WithPreopenedDirectory(string path, string guestPath)
                 throw new ArgumentException("The guest path cannot be null or empty.", nameof(guestPath));
             }
 
-            _preopenDirs.Add((path, guestPath));
+            _preopenDirs.Add((path, guestPath, directoryPermissions, filePermissions));
             return this;
         }
 
@@ -404,7 +444,7 @@ private void SetPreopenDirectories(Handle config)
         {
             foreach (var dir in _preopenDirs)
             {
-                if (!Native.wasi_config_preopen_dir(config, dir.Path, dir.GuestPath))
+                if (!Native.wasi_config_preopen_dir(config, dir.Path, dir.GuestPath, (nuint)dir.directoryPermissions, (nuint)dir.filePermissions))
                 {
                     throw new InvalidOperationException($"Failed to preopen directory '{dir.Path}'.");
                 }
@@ -504,7 +544,9 @@ public static extern bool wasi_config_set_stderr_file(
             public static extern bool wasi_config_preopen_dir(
                 Handle config,
                 [MarshalAs(Extensions.LPUTF8Str)] string path,
-                [MarshalAs(Extensions.LPUTF8Str)] string guestPath
+                [MarshalAs(Extensions.LPUTF8Str)] string guestPath,
+                nuint dirPerms,
+                nuint filePerms
             );
         }
 
@@ -513,7 +555,7 @@ public static extern bool wasi_config_preopen_dir(
         private string? _standardInputPath;
         private string? _standardOutputPath;
         private string? _standardErrorPath;
-        private readonly List<(string Path, string GuestPath)> _preopenDirs = new List<(string, string)>();
+        private readonly List<(string Path, string GuestPath, WasiDirectoryPermissions directoryPermissions, WasiFilePermissions filePermissions)> _preopenDirs = new List<(string, string, WasiDirectoryPermissions, WasiFilePermissions)>();
         private bool _inheritArgs = false;
         private bool _inheritEnv = false;
         private bool _inheritStandardInput = false;

tests/WasiTests.cs

@@ -287,7 +287,7 @@ public void ItSetsPreopenDirectories(string path)
             using var file = new TempFile();
 
             var config = new WasiConfiguration()
-                .WithPreopenedDirectory(Path.GetDirectoryName(file.Path), "/foo");
+                .WithPreopenedDirectory(Path.GetDirectoryName(file.Path), "/foo", WasiDirectoryPermissions.Read | WasiDirectoryPermissions.Write, WasiFilePermissions.Read | WasiFilePermissions.Write);
 
             using var engine = new Engine();
             using var module = Module.FromTextFile(engine, Path.Combine("Modules", path));