kobako 0.30.0 → 0.31.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (266) hide show
  1. checksums.yaml +4 -4
  2. data/.release-please-manifest.json +1 -1
  3. data/CHANGELOG.md +335 -0
  4. data/Cargo.lock +469 -11
  5. data/README.md +43 -3
  6. data/ROADMAP.md +1 -1
  7. data/crates/kobako-runtime/CHANGELOG.md +219 -0
  8. data/crates/kobako-runtime/Cargo.toml +51 -3
  9. data/crates/kobako-runtime/README.md +7 -4
  10. data/crates/kobako-runtime/src/cred.rs +124 -0
  11. data/crates/kobako-runtime/src/dispatch.rs +4 -5
  12. data/crates/kobako-runtime/src/endpoint/buffer.rs +153 -44
  13. data/crates/kobako-runtime/src/endpoint/dispatch.rs +80 -41
  14. data/crates/kobako-runtime/src/endpoint/invoke.rs +23 -36
  15. data/crates/kobako-runtime/src/endpoint.rs +137 -36
  16. data/crates/kobako-runtime/src/errno.rs +391 -0
  17. data/crates/kobako-runtime/src/error.rs +31 -10
  18. data/crates/kobako-runtime/src/filesystem/anon_inodes.rs +52 -0
  19. data/crates/kobako-runtime/src/filesystem/bind/lookup.rs +52 -14
  20. data/crates/kobako-runtime/src/filesystem/bind/walk.rs +19 -20
  21. data/crates/kobako-runtime/src/filesystem/bind.rs +437 -245
  22. data/crates/kobako-runtime/src/filesystem/overlay/file.rs +6 -6
  23. data/crates/kobako-runtime/src/filesystem/overlay/path.rs +43 -65
  24. data/crates/kobako-runtime/src/filesystem/overlay/stack/copy_up.rs +9 -16
  25. data/crates/kobako-runtime/src/filesystem/overlay/stack/dir.rs +47 -72
  26. data/crates/kobako-runtime/src/filesystem/overlay/stack/namei.rs +12 -12
  27. data/crates/kobako-runtime/src/filesystem/overlay/stack/readdir.rs +4 -7
  28. data/crates/kobako-runtime/src/filesystem/overlay/stack.rs +121 -37
  29. data/crates/kobako-runtime/src/filesystem/overlay.rs +302 -343
  30. data/crates/kobako-runtime/src/filesystem/pipe.rs +12 -9
  31. data/crates/kobako-runtime/src/filesystem/rdir.rs +15 -32
  32. data/crates/kobako-runtime/src/filesystem/tmpfs/seed.rs +32 -0
  33. data/crates/kobako-runtime/src/filesystem/tmpfs/tmpfile.rs +3 -3
  34. data/crates/kobako-runtime/src/filesystem/tmpfs/whiteout.rs +57 -35
  35. data/crates/kobako-runtime/src/filesystem/tmpfs/xattr.rs +2 -2
  36. data/crates/kobako-runtime/src/filesystem/tmpfs.rs +172 -160
  37. data/crates/kobako-runtime/src/filesystem/wrap.rs +36 -52
  38. data/crates/kobako-runtime/src/filesystem.rs +6 -3
  39. data/crates/kobako-runtime/src/fork.rs +96 -0
  40. data/crates/kobako-runtime/src/grant.rs +3 -0
  41. data/crates/kobako-runtime/src/hashtable.rs +4 -2
  42. data/crates/kobako-runtime/src/lib.rs +18 -7
  43. data/crates/kobako-runtime/src/limits.rs +195 -0
  44. data/crates/kobako-runtime/src/locking.rs +10 -0
  45. data/crates/kobako-runtime/src/memcg.rs +383 -0
  46. data/crates/kobako-runtime/src/mount.rs +67 -9
  47. data/crates/kobako-runtime/src/net/backends.rs +43 -0
  48. data/crates/kobako-runtime/src/net/connections.rs +179 -0
  49. data/crates/kobako-runtime/src/net/credential.rs +125 -0
  50. data/crates/kobako-runtime/src/net/egress.rs +160 -0
  51. data/crates/kobako-runtime/src/net/family.rs +181 -0
  52. data/crates/kobako-runtime/src/net/http.rs +2733 -0
  53. data/crates/kobako-runtime/src/net/lookup.rs +285 -0
  54. data/crates/kobako-runtime/src/net/mock.rs +251 -0
  55. data/crates/kobako-runtime/src/net/namespace.rs +1366 -0
  56. data/crates/kobako-runtime/src/net/reactor.rs +531 -0
  57. data/crates/kobako-runtime/src/net/resolv/darwin.rs +275 -0
  58. data/crates/kobako-runtime/src/net/resolv/stub/tests.rs +469 -0
  59. data/crates/kobako-runtime/src/net/resolv/stub.rs +536 -0
  60. data/crates/kobako-runtime/src/net/resolv/windows.rs +248 -0
  61. data/crates/kobako-runtime/src/net/resolv.rs +227 -0
  62. data/crates/kobako-runtime/src/net/socket.rs +870 -0
  63. data/crates/kobako-runtime/src/net/tcp.rs +1588 -0
  64. data/crates/kobako-runtime/src/net/tls.rs +58 -0
  65. data/crates/kobako-runtime/src/net/transport.rs +279 -0
  66. data/crates/kobako-runtime/src/net/udp.rs +1003 -0
  67. data/crates/kobako-runtime/src/net.rs +42 -0
  68. data/crates/kobako-runtime/src/network/builder.rs +177 -0
  69. data/crates/kobako-runtime/src/network/ruleset.rs +777 -0
  70. data/crates/kobako-runtime/src/network.rs +551 -0
  71. data/crates/kobako-runtime/src/policy.rs +16 -0
  72. data/crates/kobako-runtime/src/profile.rs +29 -144
  73. data/crates/kobako-runtime/src/runtime.rs +3 -5
  74. data/crates/kobako-runtime/src/sched.rs +130 -29
  75. data/crates/kobako-runtime/src/security/entry_policy.rs +22 -0
  76. data/crates/kobako-runtime/src/{vfs/cred.rs → security/hooks.rs} +52 -144
  77. data/crates/kobako-runtime/src/security/mount_policy.rs +158 -0
  78. data/crates/kobako-runtime/src/security.rs +101 -196
  79. data/crates/kobako-runtime/src/snapshot.rs +121 -2
  80. data/crates/kobako-runtime/src/vfs/attr.rs +5 -5
  81. data/crates/kobako-runtime/src/vfs/dentry.rs +143 -89
  82. data/crates/kobako-runtime/src/vfs/file.rs +199 -203
  83. data/crates/kobako-runtime/src/vfs/inode.rs +41 -45
  84. data/crates/kobako-runtime/src/vfs/kern_path.rs +38 -42
  85. data/crates/kobako-runtime/src/vfs/mount.rs +10 -9
  86. data/crates/kobako-runtime/src/vfs/namei.rs +829 -700
  87. data/crates/kobako-runtime/src/vfs/namespace.rs +162 -0
  88. data/crates/kobako-runtime/src/vfs/open_files.rs +69 -0
  89. data/crates/kobako-runtime/src/vfs/openat2.rs +3 -3
  90. data/crates/kobako-runtime/src/vfs/path.rs +6 -6
  91. data/crates/kobako-runtime/src/vfs/readdir.rs +6 -6
  92. data/crates/kobako-runtime/src/vfs/stat.rs +159 -23
  93. data/crates/kobako-runtime/src/vfs/super_block.rs +18 -14
  94. data/crates/kobako-runtime/src/vfs/utimes.rs +37 -27
  95. data/crates/kobako-runtime/src/vfs.rs +9 -6
  96. data/crates/kobako-runtime/src/wait.rs +356 -0
  97. data/crates/kobako-transport/CHANGELOG.md +31 -0
  98. data/crates/kobako-transport/Cargo.toml +1 -1
  99. data/crates/kobako-transport/README.md +3 -4
  100. data/crates/kobako-transport/src/abi.rs +78 -72
  101. data/crates/kobako-transport/src/envelope/bytes.rs +17 -6
  102. data/crates/kobako-transport/src/envelope/call.rs +32 -4
  103. data/crates/kobako-transport/src/envelope/error_record.rs +21 -0
  104. data/crates/kobako-transport/src/envelope/name.rs +99 -0
  105. data/crates/kobako-transport/src/envelope/outcome.rs +9 -9
  106. data/crates/kobako-transport/src/envelope/preamble.rs +24 -21
  107. data/crates/kobako-transport/src/envelope/reply.rs +27 -27
  108. data/crates/kobako-transport/src/envelope/unsupported.rs +10 -10
  109. data/crates/kobako-transport/src/envelope.rs +13 -8
  110. data/crates/kobako-wasmtime/CHANGELOG.md +161 -0
  111. data/crates/kobako-wasmtime/Cargo.toml +26 -7
  112. data/crates/kobako-wasmtime/README.md +3 -2
  113. data/crates/kobako-wasmtime/build/preview2.rs +1339 -0
  114. data/crates/kobako-wasmtime/build.rs +16 -0
  115. data/crates/kobako-wasmtime/src/abi.rs +17 -37
  116. data/crates/kobako-wasmtime/src/ambient.rs +33 -18
  117. data/crates/kobako-wasmtime/src/cache.rs +23 -15
  118. data/crates/kobako-wasmtime/src/config.rs +52 -68
  119. data/crates/kobako-wasmtime/src/driver.rs +48 -63
  120. data/crates/kobako-wasmtime/src/exports.rs +143 -17
  121. data/crates/kobako-wasmtime/src/guest.rs +12 -6
  122. data/crates/kobako-wasmtime/src/guest_binary.rs +14 -0
  123. data/crates/kobako-wasmtime/src/imports.rs +42 -18
  124. data/crates/kobako-wasmtime/src/instance_pre.rs +4 -4
  125. data/crates/kobako-wasmtime/src/invocation.rs +74 -12
  126. data/crates/kobako-wasmtime/src/lib.rs +5 -3
  127. data/crates/kobako-wasmtime/src/limiter.rs +70 -5
  128. data/crates/kobako-wasmtime/src/preview1/descriptors.rs +309 -0
  129. data/crates/kobako-wasmtime/src/preview1/differential/mount.rs +5 -15
  130. data/crates/kobako-wasmtime/src/preview1/differential.rs +27 -31
  131. data/crates/kobako-wasmtime/src/preview1/errno.rs +55 -66
  132. data/crates/kobako-wasmtime/src/preview1/fd.rs +327 -296
  133. data/crates/kobako-wasmtime/src/preview1/memory.rs +21 -12
  134. data/crates/kobako-wasmtime/src/preview1/mount_view/wrap.rs +34 -53
  135. data/crates/kobako-wasmtime/src/preview1/mount_view.rs +231 -217
  136. data/crates/kobako-wasmtime/src/preview1/path.rs +56 -121
  137. data/crates/kobako-wasmtime/src/preview1/poll.rs +244 -120
  138. data/crates/kobako-wasmtime/src/preview1/sock.rs +10 -8
  139. data/crates/kobako-wasmtime/src/preview1/testsuite.rs +5 -15
  140. data/crates/kobako-wasmtime/src/preview1.rs +46 -42
  141. data/crates/kobako-wasmtime/src/preview2/abi.rs +227 -0
  142. data/crates/kobako-wasmtime/src/preview2/error.rs +118 -0
  143. data/crates/kobako-wasmtime/src/preview2/filesystem.rs +122 -0
  144. data/crates/kobako-wasmtime/src/preview2/host.rs +3959 -0
  145. data/crates/kobako-wasmtime/src/preview2/http.rs +1503 -0
  146. data/crates/kobako-wasmtime/src/preview2/io.rs +315 -0
  147. data/crates/kobako-wasmtime/src/preview2/sockets.rs +379 -0
  148. data/crates/kobako-wasmtime/src/preview2/table.rs +305 -0
  149. data/crates/kobako-wasmtime/src/preview2.rs +57 -0
  150. data/crates/kobako-wasmtime/src/trap.rs +24 -9
  151. data/crates/kobako-wasmtime/src/wasi.rs +210 -81
  152. data/crates/kobako-wasmtime/wit/deps/cli.wit +233 -0
  153. data/crates/kobako-wasmtime/wit/deps/clocks.wit +162 -0
  154. data/crates/kobako-wasmtime/wit/deps/filesystem.wit +589 -0
  155. data/crates/kobako-wasmtime/wit/deps/http.wit +733 -0
  156. data/crates/kobako-wasmtime/wit/deps/io.wit +299 -0
  157. data/crates/kobako-wasmtime/wit/deps/random.wit +92 -0
  158. data/crates/kobako-wasmtime/wit/deps/sockets.wit +949 -0
  159. data/data/kobako.wasm +0 -0
  160. data/ext/kobako/Cargo.toml +1 -1
  161. data/ext/kobako/src/{runtime/errors.rs → errors.rs} +34 -26
  162. data/ext/kobako/src/{runtime/escape.rs → escape.rs} +42 -11
  163. data/ext/kobako/src/{runtime/filesystem → filesystem}/grants.rs +30 -26
  164. data/ext/kobako/src/{runtime/filesystem → filesystem}/ruby.rs +149 -168
  165. data/ext/kobako/src/{runtime/filesystem.rs → filesystem.rs} +24 -15
  166. data/ext/kobako/src/gvl.rs +306 -0
  167. data/ext/kobako/src/lib.rs +64 -3
  168. data/ext/kobako/src/network/mock.rs +187 -0
  169. data/ext/kobako/src/network.rs +591 -0
  170. data/ext/kobako/src/runtime/bridge.rs +30 -29
  171. data/ext/kobako/src/runtime/snapshot.rs +4 -4
  172. data/ext/kobako/src/runtime.rs +221 -143
  173. data/ext/kobako/src/wire.rs +42 -0
  174. data/lib/kobako/catalog/extensions.rb +14 -2
  175. data/lib/kobako/catalog/flags.rb +3 -5
  176. data/lib/kobako/catalog/grants.rb +5 -4
  177. data/lib/kobako/catalog/handles.rb +5 -27
  178. data/lib/kobako/catalog/mount.rb +11 -3
  179. data/lib/kobako/catalog/network.rb +35 -0
  180. data/lib/kobako/catalog/replacements.rb +28 -0
  181. data/lib/kobako/catalog/services.rb +5 -19
  182. data/lib/kobako/catalog/snippets.rb +3 -18
  183. data/lib/kobako/catalog.rb +3 -0
  184. data/lib/kobako/codec/{utils.rb → boundary.rb} +4 -2
  185. data/lib/kobako/codec/decoder.rb +4 -4
  186. data/lib/kobako/codec/ext_types.rb +3 -3
  187. data/lib/kobako/codec/handle_walk.rb +3 -43
  188. data/lib/kobako/codec/value_budget.rb +132 -40
  189. data/lib/kobako/codec.rb +1 -1
  190. data/lib/kobako/context.rb +24 -11
  191. data/lib/kobako/errors.rb +15 -12
  192. data/lib/kobako/extension.rb +3 -2
  193. data/lib/kobako/filesystem.rb +9 -2
  194. data/lib/kobako/handle.rb +2 -2
  195. data/lib/kobako/names.rb +28 -0
  196. data/lib/kobako/network.rb +210 -0
  197. data/lib/kobako/outcome.rb +7 -7
  198. data/lib/kobako/pool.rb +45 -23
  199. data/lib/kobako/runtime.rb +3 -2
  200. data/lib/kobako/sandbox.rb +92 -35
  201. data/lib/kobako/sandbox_options.rb +41 -106
  202. data/lib/kobako/transport/argument_wrap.rb +64 -0
  203. data/lib/kobako/transport/block_failure.rb +1 -1
  204. data/lib/kobako/transport/dispatcher.rb +6 -6
  205. data/lib/kobako/transport/exposure.rb +26 -15
  206. data/lib/kobako/transport/reflection.rb +21 -4
  207. data/lib/kobako/transport/run.rb +8 -23
  208. data/lib/kobako/transport/yielder.rb +2 -9
  209. data/lib/kobako/transport.rb +1 -0
  210. data/lib/kobako/version.rb +1 -1
  211. data/lib/kobako.rb +6 -2
  212. data/release-please-config.json +15 -0
  213. data/sig/core/thread.rbs +6 -0
  214. data/sig/kobako/catalog/extensions.rbs +2 -0
  215. data/sig/kobako/catalog/grants.rbs +7 -4
  216. data/sig/kobako/catalog/handles.rbs +0 -2
  217. data/sig/kobako/catalog/mount.rbs +3 -1
  218. data/sig/kobako/catalog/network.rbs +20 -0
  219. data/sig/kobako/catalog/replacements.rbs +14 -0
  220. data/sig/kobako/catalog/services.rbs +0 -4
  221. data/sig/kobako/catalog/snippets.rbs +0 -2
  222. data/sig/kobako/codec/{utils.rbs → boundary.rbs} +2 -2
  223. data/sig/kobako/codec/handle_walk.rbs +0 -6
  224. data/sig/kobako/codec/value_budget.rbs +47 -4
  225. data/sig/kobako/context.rbs +3 -1
  226. data/sig/kobako/errors.rbs +4 -4
  227. data/sig/kobako/filesystem.rbs +21 -3
  228. data/sig/kobako/network.rbs +115 -0
  229. data/sig/kobako/outcome.rbs +1 -1
  230. data/sig/kobako/pool.rbs +7 -3
  231. data/sig/kobako/runtime.rbs +32 -3
  232. data/sig/kobako/sandbox.rbs +19 -2
  233. data/sig/kobako/sandbox_options.rbs +29 -38
  234. data/sig/kobako/transport/argument_wrap.rbs +15 -0
  235. data/sig/kobako/transport/error.rbs +1 -1
  236. data/sig/kobako/transport/exposure.rbs +2 -4
  237. data/sig/kobako/transport/reflection.rbs +10 -0
  238. data/sig/kobako/transport/run.rbs +0 -2
  239. data/sig/kobako/transport/yielder.rbs +0 -3
  240. data/sig/kobako/transport.rbs +1 -1
  241. data/sig/kobako.rbs +13 -0
  242. metadata +84 -35
  243. data/crates/kobako-runtime/src/endpoint/capture.rs +0 -115
  244. data/crates/kobako-runtime/src/endpoint/memory_cap.rs +0 -238
  245. data/crates/kobako-runtime/src/filesystem/path.rs +0 -21
  246. data/crates/kobako-runtime/src/vfs/errno.rs +0 -153
  247. data/crates/kobako-runtime/tests/linux_baseline/calls.rs +0 -171
  248. data/crates/kobako-runtime/tests/linux_baseline/concurrent.rs +0 -276
  249. data/crates/kobako-runtime/tests/linux_baseline/kobako.rs +0 -323
  250. data/crates/kobako-runtime/tests/linux_baseline/linux-baseline-expected.txt +0 -16
  251. data/crates/kobako-runtime/tests/linux_baseline/linux.rs +0 -449
  252. data/crates/kobako-runtime/tests/linux_baseline/main.rs +0 -611
  253. data/crates/kobako-runtime/tests/linux_baseline/permissions.rs +0 -236
  254. data/crates/kobako-wasmtime/src/descriptors.rs +0 -200
  255. data/crates/kobako-wasmtime/tests/integration/compile_posture.rs +0 -43
  256. data/crates/kobako-wasmtime/tests/integration/guest_file.rs +0 -1085
  257. data/crates/kobako-wasmtime/tests/integration/main.rs +0 -29
  258. data/crates/kobako-wasmtime/tests/integration/preamble_flags.rs +0 -70
  259. data/crates/kobako-wasmtime/tests/integration/snippet_compile.rs +0 -95
  260. data/crates/kobako-wasmtime/tests/integration/support/mod.rs +0 -30
  261. data/crates/kobako-wasmtime/tests/integration/unanswered_call.rs +0 -86
  262. data/crates/kobako-wasmtime/tests/integration/unsupported_call.rs +0 -51
  263. data/ext/kobako/src/runtime/gvl.rs +0 -147
  264. data/lib/kobako/constant_name.rb +0 -8
  265. data/sig/kobako/constant_name.rbs +0 -3
  266. /data/ext/kobako/src/{runtime/pinned_value.rs → pinned_value.rs} +0 -0
@@ -1,29 +0,0 @@
1
- //! The driver's integration tests, built as one binary so a run links
2
- //! wasmtime once rather than once per file.
3
-
4
- mod support;
5
-
6
- mod compile_posture;
7
- mod guest_file;
8
- mod preamble_flags;
9
- mod snippet_compile;
10
- mod unanswered_call;
11
- mod unsupported_call;
12
-
13
- // Cargo compiles only the modules declared above, so a test file left out
14
- // would never run and nothing would say so.
15
- #[test]
16
- fn every_file_in_this_directory_is_a_declared_module() {
17
- let dir = concat!(env!("CARGO_MANIFEST_DIR"), "/tests/integration");
18
- for entry in std::fs::read_dir(dir).expect("the test directory must list") {
19
- let path = entry.expect("an entry must read").path();
20
- let name = path
21
- .file_stem()
22
- .and_then(|stem| stem.to_str())
23
- .expect("a UTF-8 name");
24
- assert!(
25
- name == "main" || include_str!("main.rs").contains(&format!("mod {name};")),
26
- "tests/integration/{name} must be declared in main.rs, or it never runs"
27
- );
28
- }
29
- }
@@ -1,70 +0,0 @@
1
- //! A flag the bundled guest does not recognise meets the unrecognised
2
- //! path: a critical one must refuse the invocation under
3
- //! its own class, and an advisory one must leave the run untouched.
4
-
5
- use crate::support;
6
-
7
- use kobako_runtime::{Completion, Entry, Runtime};
8
- use kobako_transport::envelope::{Flag, Origin, Outcome, Preamble};
9
-
10
- /// The Outcome and what the script printed, or `None` when the Guest
11
- /// Binary has not been built outside CI. The script prints before it
12
- /// answers, so empty stdout means it never ran.
13
- fn eval_with_flag(critical: bool) -> Option<(Outcome, Vec<u8>)> {
14
- let driver = support::bundled_driver()?;
15
- let mut preamble = Preamble::default();
16
- preamble.flags = vec![Flag {
17
- name: "no_such_flag".into(),
18
- value: String::new(),
19
- critical,
20
- }];
21
-
22
- let snapshot = driver
23
- .invoke(
24
- Entry::Eval {
25
- source: b"puts 'ran'; 1 + 1",
26
- },
27
- &preamble,
28
- None,
29
- &[],
30
- )
31
- .expect("the invocation must start");
32
- let Completion::Outcome(outcome) = snapshot.completion else {
33
- panic!("the invocation must answer rather than trap");
34
- };
35
- Some((outcome, snapshot.stdout.bytes))
36
- }
37
-
38
- // @behavior MR-017
39
- #[test]
40
- fn a_critical_flag_the_guest_does_not_recognise_refuses_the_invocation() {
41
- let Some((outcome, stdout)) = eval_with_flag(true) else {
42
- return;
43
- };
44
- let Outcome::Panic(panic) = outcome else {
45
- panic!("a critical flag the guest does not recognise must answer with a Panic");
46
- };
47
-
48
- assert_eq!(
49
- (panic.origin, panic.error.name.as_str(), stdout.as_slice()),
50
- (Origin::Sandbox, "Kobako::UnsupportedFlagError", &b""[..]),
51
- "a critical flag the bundled guest does not recognise through Driver#invoke must \
52
- refuse the invocation as the Sandbox's Kobako::UnsupportedFlagError before the \
53
- script runs"
54
- );
55
- }
56
-
57
- // @behavior MR-018
58
- #[test]
59
- fn an_advisory_flag_the_guest_does_not_recognise_is_skipped() {
60
- let Some(answer) = eval_with_flag(false) else {
61
- return;
62
- };
63
-
64
- assert_eq!(
65
- answer,
66
- (Outcome::Ok(vec![0x02]), b"ran\n".to_vec()),
67
- "an advisory flag the bundled guest does not recognise through Driver#invoke must be \
68
- skipped, leaving the invocation's value as it would be without the flag"
69
- );
70
- }
@@ -1,95 +0,0 @@
1
- //! The bundled guest compiles a Preamble's source snippets on an instance
2
- //! of their own. What comes back has to replay in a later invocation in
3
- //! place of the source, under the same flags a replay would apply, and
4
- //! two compiles of the same Preamble have to agree byte for byte so
5
- //! either can stand in for the other.
6
-
7
- use crate::support;
8
-
9
- use kobako_runtime::{Completion, Entry, Runtime};
10
- use kobako_transport::envelope::{Flag, Outcome, Preamble, Snippet, Snippets};
11
-
12
- use support::bundled_driver as driver;
13
-
14
- fn preamble_with(entries: Vec<Snippet>) -> Preamble {
15
- let mut preamble = Preamble::default();
16
- preamble.snippets = Snippets { entries };
17
- preamble
18
- }
19
-
20
- fn greeter() -> Preamble {
21
- preamble_with(vec![Snippet::Source {
22
- name: "Greeter".into(),
23
- body: "module Greeter; def self.hi = 'hi'; end".into(),
24
- }])
25
- }
26
-
27
- // @behavior MR-024
28
- #[test]
29
- fn compiled_snippets_replay_in_a_later_invocation() {
30
- let Some(driver) = driver() else {
31
- return;
32
- };
33
- let bytecodes = driver
34
- .compile(&greeter())
35
- .expect("a source snippet that parses must compile");
36
- let replay = preamble_with(
37
- bytecodes
38
- .into_iter()
39
- .map(|body| Snippet::Bytecode { body })
40
- .collect(),
41
- );
42
-
43
- let snapshot = driver
44
- .invoke(
45
- Entry::Eval {
46
- source: b"Greeter.hi",
47
- },
48
- &replay,
49
- None,
50
- &[],
51
- )
52
- .expect("the invocation must start");
53
-
54
- assert!(
55
- matches!(snapshot.completion, Completion::Outcome(Outcome::Ok(ref value)) if value == b"\xa2hi"),
56
- "bytecode from Driver#compile, sent back as bytecode snippets, must define what the \
57
- source did for a later invocation"
58
- );
59
- }
60
-
61
- // @behavior MR-023
62
- #[test]
63
- fn compiling_the_same_preamble_twice_yields_the_same_bytes() {
64
- let Some(driver) = driver() else {
65
- return;
66
- };
67
-
68
- assert_eq!(
69
- driver.compile(&greeter()),
70
- driver.compile(&greeter()),
71
- "the same Preamble through Driver#compile on two fresh instances must answer \
72
- byte-identical bytecode"
73
- );
74
- }
75
-
76
- // @behavior MR-025
77
- #[test]
78
- fn a_critical_flag_the_guest_does_not_recognise_leaves_nothing_compiled() {
79
- let Some(driver) = driver() else {
80
- return;
81
- };
82
- let mut preamble = greeter();
83
- preamble.flags = vec![Flag {
84
- name: "no_such_flag".into(),
85
- value: String::new(),
86
- critical: true,
87
- }];
88
-
89
- assert_eq!(
90
- driver.compile(&preamble),
91
- None,
92
- "a critical flag the bundled guest does not recognise through Driver#compile must \
93
- leave nothing compiled, since compiling applies the flags a replay would"
94
- );
95
- }
@@ -1,30 +0,0 @@
1
- //! The bundled Guest Binary every integration test drives.
2
-
3
- use std::path::Path;
4
- use std::time::Duration;
5
-
6
- use kobako_runtime::Profile;
7
- use kobako_wasmtime::{Config, Driver};
8
-
9
- const WASM: &str = concat!(env!("CARGO_MANIFEST_DIR"), "/../../data/kobako.wasm");
10
-
11
- /// A driver over the bundled Guest Binary, or `None` when it has not
12
- /// been built outside CI, where a missing build is a failure instead.
13
- pub fn bundled_driver() -> Option<Driver> {
14
- if !Path::new(WASM).exists() {
15
- assert!(
16
- std::env::var_os("CI").is_none(),
17
- "data/kobako.wasm missing under CI — run `bundle exec rake wasm:build`"
18
- );
19
- return None;
20
- }
21
- let mut config = Config::default();
22
- config.timeout = Some(Duration::from_secs(10));
23
- config.setup_timeout = Some(Duration::from_secs(10));
24
- config.memory_limit = None;
25
- config.stdout_limit = None;
26
- config.stderr_limit = None;
27
- config.open_file_limit = None;
28
- config.profile = Profile::Hermetic;
29
- Some(Driver::new(Path::new(WASM), config).expect("the Guest Binary must load"))
30
- }
@@ -1,86 +0,0 @@
1
- //! A Call the host could not answer as the Service meant still reaches the
2
- //! guest as an answer it can rescue, and the answer says why. The default
3
- //! frontends never hand the driver either failure, so only a handler
4
- //! written here reaches them.
5
-
6
- use crate::support;
7
-
8
- use std::sync::Arc;
9
-
10
- use kobako_runtime::{Completion, DispatchHandler, Entry, Runtime, Yielder};
11
- use kobako_transport::envelope::{Bindings, Call, Outcome, Preamble, Reply};
12
-
13
- /// Answers every Call with one byte more than a message carries.
14
- struct AnswersTooMuch;
15
-
16
- impl DispatchHandler for AnswersTooMuch {
17
- fn dispatch(&self, _call: Call<'_>, _yielder: &mut dyn Yielder) -> Option<Reply> {
18
- Some(Reply::Ok(vec![0xc0; (16 << 20) + 1]))
19
- }
20
- }
21
-
22
- /// Breaks the handler contract by answering nothing.
23
- struct AnswersNothing;
24
-
25
- impl DispatchHandler for AnswersNothing {
26
- fn dispatch(&self, _call: Call<'_>, _yielder: &mut dyn Yielder) -> Option<Reply> {
27
- None
28
- }
29
- }
30
-
31
- fn eval_against(handler: Arc<dyn DispatchHandler>, source: &[u8]) -> Option<Outcome> {
32
- let driver = support::bundled_driver()?;
33
- let mut preamble = Preamble::default();
34
- preamble.bindings = Bindings {
35
- paths: vec!["Svc".into()],
36
- };
37
- let snapshot = driver
38
- .invoke(Entry::Eval { source }, &preamble, Some(handler), &[])
39
- .expect("the invocation must start");
40
- let Completion::Outcome(outcome) = snapshot.completion else {
41
- panic!("the invocation must answer rather than trap");
42
- };
43
- Some(outcome)
44
- }
45
-
46
- // @behavior T-286
47
- #[test]
48
- fn an_answer_larger_than_a_message_raises_a_service_failure_naming_the_limit() {
49
- let source = b"begin; Svc.go; rescue Kobako::ServiceError => e; e.message; end";
50
- let Some(outcome) = eval_against(Arc::new(AnswersTooMuch), source) else {
51
- return;
52
- };
53
-
54
- let mut expected = vec![0xd9, 0x4e];
55
- expected.extend_from_slice(
56
- b"Sandbox could not write the Service's answer: payload exceeds the 16 MiB limit",
57
- );
58
- assert_eq!(
59
- outcome,
60
- Outcome::Ok(expected),
61
- "a Service answer past the message cap through Driver#invoke must raise a Service \
62
- failure in the guest naming the limit"
63
- );
64
- }
65
-
66
- // @behavior T-287
67
- #[test]
68
- fn a_call_the_host_could_not_answer_raises_a_transport_error_naming_why() {
69
- let source = b"begin; Svc.go; rescue Kobako::Transport::Error => e; e.message; end";
70
- let Some(outcome) = eval_against(Arc::new(AnswersNothing), source) else {
71
- return;
72
- };
73
-
74
- let mut expected = vec![0xd9, 0x6a];
75
- expected.extend_from_slice(
76
- "a Sandbox callback raised an exception instead of returning a fault — please report \
77
- this as a kobako bug"
78
- .as_bytes(),
79
- );
80
- assert_eq!(
81
- outcome,
82
- Outcome::Ok(expected),
83
- "a Call a handler answered with nothing through Driver#invoke must raise \
84
- Kobako::Transport::Error in the guest naming why"
85
- );
86
- }
@@ -1,51 +0,0 @@
1
- //! A host frontend of its own may answer a guest's Call as unsupported;
2
- //! the bundled guest must then hand its script a refusal it can rescue,
3
- //! rather than a broken exchange. The default frontends serve every Call,
4
- //! so only a handler written here reaches that answer.
5
-
6
- use crate::support;
7
-
8
- use std::sync::Arc;
9
-
10
- use kobako_runtime::{Completion, DispatchHandler, Entry, Runtime, Yielder};
11
- use kobako_transport::envelope::{Bindings, Call, Outcome, Preamble, Reply, Unsupported};
12
-
13
- struct ServesNoCall;
14
-
15
- impl DispatchHandler for ServesNoCall {
16
- fn dispatch(&self, _call: Call<'_>, _yielder: &mut dyn Yielder) -> Option<Reply> {
17
- Some(Reply::Unsupported(Unsupported::new("no calls here")))
18
- }
19
- }
20
-
21
- // @behavior T-279
22
- #[test]
23
- fn a_call_the_host_does_not_serve_raises_unsupported_error_in_the_guest() {
24
- let Some(driver) = support::bundled_driver() else {
25
- return;
26
- };
27
- let mut preamble = Preamble::default();
28
- preamble.bindings = Bindings {
29
- paths: vec!["Svc".into()],
30
- };
31
- let source = b"begin; Svc.go; rescue Kobako::UnsupportedError => e; e.message; end";
32
-
33
- let snapshot = driver
34
- .invoke(
35
- Entry::Eval { source },
36
- &preamble,
37
- Some(Arc::new(ServesNoCall)),
38
- &[],
39
- )
40
- .expect("the invocation must start");
41
-
42
- let Completion::Outcome(outcome) = snapshot.completion else {
43
- panic!("the invocation must answer rather than trap");
44
- };
45
- assert_eq!(
46
- outcome,
47
- Outcome::Ok(b"\xadno calls here".to_vec()),
48
- "a Service call answered as unsupported through Driver#invoke must raise \
49
- Kobako::UnsupportedError carrying the host's message"
50
- );
51
- }
@@ -1,147 +0,0 @@
1
- //! Releasing Ruby's GVL for an invocation's guest span so distinct Sandboxes on
2
- //! distinct Threads run their guest code in parallel.
3
- //!
4
- //! `region` brackets one invocation's guest span, releasing the GVL when the
5
- //! Sandbox asks for it; `reenter` re-acquires the GVL for a guest→host dispatch
6
- //! callback, which is ordinary Ruby and must hold the lock. A thread-local flag
7
- //! stops a nested dispatch from re-acquiring a second time, and both directions
8
- //! run their closure through a `catch_unwind` trampoline because a panic must
9
- //! never cross the C frame of `rb_thread_call_without_gvl2` /
10
- //! `rb_thread_call_with_gvl` (undefined behaviour). The flag is per-thread,
11
- //! matching the one-thread-one-Sandbox contract, and is restored through a drop
12
- //! guard so an unwinding panic cannot leave it corrupt for the next invocation.
13
- //!
14
- //! A release never raises where it returns, as `rb_thread_call_without_gvl`
15
- //! would, since that jumps over every Rust frame of the run and what they hold:
16
- //! a lock's guard, this flag. An interrupt waits for the run to end instead.
17
-
18
- use std::cell::Cell;
19
- use std::os::raw::c_void;
20
- use std::panic::{catch_unwind, resume_unwind, AssertUnwindSafe};
21
- use std::ptr;
22
-
23
- use kobako_runtime::sched::{Blocking, Task};
24
-
25
- use super::escape;
26
-
27
- thread_local! {
28
- // True while this thread sits inside a region whose GVL we released and
29
- // have not yet re-acquired. Drives `reenter`'s one-shot re-acquire.
30
- static GVL_RELEASED: Cell<bool> = const { Cell::new(false) };
31
- }
32
-
33
- pub(crate) fn region<F, R>(release: bool, f: F) -> R
34
- where
35
- F: FnOnce() -> R,
36
- {
37
- if !release {
38
- return f();
39
- }
40
- let _guard = ReleasedGuard::set(true);
41
- // An interrupt the thread receives meanwhile stops each wait for a lock the
42
- // run meets; the interrupt itself still waits for the run to end.
43
- let task = Task::current();
44
- let task_ptr = ptr::addr_of!(task).cast_mut().cast::<c_void>();
45
- call_via(f, |func, data| unsafe {
46
- rb_sys::rb_thread_call_without_gvl2(Some(func), data, Some(interrupt_task), task_ptr)
47
- })
48
- }
49
-
50
- /// Have the thread's run stop waiting for locks, called by Ruby without the GVL
51
- /// as the region's unblocking function.
52
- unsafe extern "C" fn interrupt_task(task: *mut c_void) {
53
- let task = unsafe { &*task.cast::<Task>() };
54
- task.interrupt();
55
- }
56
-
57
- /// Whether this thread holds the GVL: outside any released region, or
58
- /// inside a dispatch that re-acquired it.
59
- fn holds() -> bool {
60
- !GVL_RELEASED.with(|g| g.get())
61
- }
62
-
63
- /// A thread waits for a lock without the GVL, so a holder asking a
64
- /// Filesystem written in Ruby, or a mount's block, can take the GVL and
65
- /// finish.
66
- pub(crate) struct GvlFreeWait;
67
-
68
- impl Blocking for GvlFreeWait {
69
- fn wait(&self, wait: &mut dyn FnMut()) {
70
- region(holds(), wait);
71
- }
72
- }
73
-
74
- /// Runs inline when the GVL is already held — hold mode, or a nested
75
- /// dispatch whose outer frame re-acquired it.
76
- pub(crate) fn reenter<F, R>(f: F) -> R
77
- where
78
- F: FnOnce() -> R,
79
- {
80
- if !GVL_RELEASED.with(|g| g.get()) {
81
- return f();
82
- }
83
- let _guard = ReleasedGuard::set(false);
84
- call_via(f, |func, data| unsafe {
85
- rb_sys::rb_thread_call_with_gvl(Some(func), data)
86
- })
87
- }
88
-
89
- /// Restores `GVL_RELEASED` to its prior value on drop, so an unwinding panic
90
- /// through a released region cannot leave the flag stuck.
91
- struct ReleasedGuard {
92
- prev: bool,
93
- }
94
-
95
- impl ReleasedGuard {
96
- fn set(value: bool) -> Self {
97
- Self {
98
- prev: GVL_RELEASED.with(|g| g.replace(value)),
99
- }
100
- }
101
- }
102
-
103
- impl Drop for ReleasedGuard {
104
- fn drop(&mut self) {
105
- GVL_RELEASED.with(|g| g.set(self.prev));
106
- }
107
- }
108
-
109
- struct GvlCtx<F, R> {
110
- f: Option<F>,
111
- result: Option<std::thread::Result<R>>,
112
- }
113
-
114
- /// Runs the closure under `catch_unwind`, so a panic is captured here rather
115
- /// than unwinding across the C frame.
116
- unsafe extern "C" fn trampoline<F, R>(data: *mut c_void) -> *mut c_void
117
- where
118
- F: FnOnce() -> R,
119
- {
120
- let ctx = unsafe { &mut *data.cast::<GvlCtx<F, R>>() };
121
- let f = ctx.f.take().expect("gvl trampoline runs its closure once");
122
- ctx.result = Some(catch_unwind(AssertUnwindSafe(f)));
123
- ptr::null_mut()
124
- }
125
-
126
- fn call_via<F, R>(
127
- f: F,
128
- mut invoke: impl FnMut(unsafe extern "C" fn(*mut c_void) -> *mut c_void, *mut c_void) -> *mut c_void,
129
- ) -> R
130
- where
131
- F: FnOnce() -> R,
132
- {
133
- let mut ctx = GvlCtx::<F, R> {
134
- f: Some(f),
135
- result: None,
136
- };
137
- loop {
138
- invoke(trampoline::<F, R>, ptr::addr_of_mut!(ctx).cast::<c_void>());
139
- match ctx.result.take() {
140
- Some(Ok(value)) => return value,
141
- Some(Err(payload)) => resume_unwind(payload),
142
- // `rb_thread_call_without_gvl2` runs nothing while an interrupt
143
- // is pending, so that one is taken off the thread first.
144
- None => escape::hold_interrupts(),
145
- }
146
- }
147
- }
@@ -1,8 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- module Kobako
4
- # A bind-path segment, a snippet name and a #run entrypoint all take the
5
- # constant-name form, so they are refused alike. The guest interns each
6
- # one, and mruby holds a symbol of at most 65534 bytes.
7
- CONSTANT_NAME = /\A[A-Z]\w{0,65533}\z/ # :nodoc:
8
- end
@@ -1,3 +0,0 @@
1
- module Kobako
2
- CONSTANT_NAME: Regexp
3
- end