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,23 +1,19 @@
1
- //! Isolation profile — the posture a frontend requests and a runtime
2
- //! builds and declares.
1
+ //! Isolation profile — what a frontend requests and a runtime builds and
2
+ //! declares.
3
3
  //!
4
- //! A rung on an ordered ladder: the host application requests the
5
- //! posture it wants, the runtime builds it and declares the posture it
6
- //! actually built, and the frontend refuses a declaration below the
7
- //! request — so the request is also the floor.
4
+ //! One of an ordered set: the host application requests the profile it
5
+ //! wants, the runtime builds it and declares the profile it actually
6
+ //! built, and the frontend refuses a declaration below the request — so
7
+ //! the request is also the floor.
8
8
 
9
- use std::hash::{BuildHasher, RandomState};
10
- use std::sync::LazyLock;
11
- use std::time::{SystemTime, UNIX_EPOCH};
9
+ use std::time::Instant;
12
10
 
13
- use crate::vfs::{FileType, Identity, Kstat};
14
-
15
- /// The ordered isolation ladder a runtime builds one rung of.
11
+ /// The ordered isolation profiles a runtime builds one of.
16
12
  ///
17
- /// `Hermetic` is the full ambient-denial posture: ambient time and
18
- /// entropy denied at the WASI boundary, no ambient filesystem /
19
- /// environment / network reachability, and no host import beyond the wire ABI's
20
- /// `__kobako_upcall`. `Permissive` differs only in the ambient
13
+ /// `Hermetic` is the full ambient-denial profile: ambient time and
14
+ /// entropy denied at the WASI boundary, and no ambient filesystem /
15
+ /// environment / network reachability: only a Grant reaches a file or a
16
+ /// socket. `Permissive` differs only in the ambient
21
17
  /// authority it grants — live time and entropy at the WASI boundary — and in
22
18
  /// the times and inode numbers it shows of an entry. Ordering
23
19
  /// follows strength (`Permissive < Hermetic`), so a floor check is a
@@ -25,54 +21,31 @@ use crate::vfs::{FileType, Identity, Kstat};
25
21
  ///
26
22
  /// Deliberately not `#[non_exhaustive]`, unlike this crate's error
27
23
  /// types. A wildcard arm here would let a runtime silently keep building
28
- /// the posture it already knows while declaring it satisfied a rung it
29
- /// never implemented; the compile error a new rung causes is what forces
24
+ /// the profile it already knows while declaring it satisfied one it never
25
+ /// implemented; the compile error a new profile causes is what forces
30
26
  /// each runtime to answer for it. The ordering is the same reason — a
31
- /// rung inserted mid-ladder changes what every existing `>=` means, which
27
+ /// profile inserted between two changes what every existing `>=` means, which
32
28
  /// no wildcard could have absorbed either.
33
- #[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord)]
29
+ ///
30
+ /// A Sandbox defaults to the hermetic floor, so one whose Host App names
31
+ /// none runs under the most isolation.
32
+ #[derive(Debug, Clone, Copy, Default, PartialEq, Eq, PartialOrd, Ord)]
34
33
  pub enum Profile {
35
34
  Permissive,
35
+ #[default]
36
36
  Hermetic,
37
37
  }
38
38
 
39
39
  impl Profile {
40
- /// The inode number a guest on this posture sees for `identity`. A
41
- /// hermetic guest sees none, as a Filesystem's device number depends on
42
- /// how many were made before it in the process. Any other sees a hash of
43
- /// it under a key the process draws once, so it can tell entries apart
44
- /// and cannot work back to a host's inode number.
45
- pub fn guest_ino(self, identity: Option<Identity>) -> u64 {
46
- static KEY: LazyLock<RandomState> = LazyLock::new(RandomState::new);
47
- match (self, identity) {
48
- (Self::Hermetic, _) | (_, None) => 0,
49
- (Self::Permissive, Some(identity)) => KEY.hash_one(identity),
50
- }
51
- }
52
-
53
- /// `stat` as a guest on this posture sees it, whichever ABI a Wasm
54
- /// Driver encodes it into. A Filesystem records the host's real time whatever
55
- /// the invocation writing to it runs under, so one shared across
56
- /// invocations keeps one record; a hermetic guest sees every time at the
57
- /// Unix epoch, where its wall clock stands, so a time a write left behind
58
- /// is no clock it can read. A link reports no size, so nothing of where it
59
- /// points reaches the guest, and an entry is told apart only by what
60
- /// `guest_ino` answers.
61
- pub fn guest_kstat(self, stat: Kstat) -> Kstat {
62
- let ino = self.guest_ino(Identity::of(&stat));
63
- let masked = match self {
64
- Self::Permissive => stat,
65
- Self::Hermetic => {
66
- let epoch = |time: Option<SystemTime>| time.map(|_| UNIX_EPOCH);
67
- stat.with_times(epoch(stat.atime), epoch(stat.mtime), epoch(stat.ctime))
68
- }
69
- };
70
- Kstat {
71
- size: match masked.file_type {
72
- FileType::Symlink => 0,
73
- _ => masked.size,
74
- },
75
- ..masked.with_identity(0, ino)
40
+ /// When a guest's clock, due `at` in host time, is due in a wait on this
41
+ /// profile, whichever ABI a Wasm Driver encodes the wait into. A hermetic
42
+ /// guest's clocks never advance, so a wait on them alone is due at once;
43
+ /// beside a host-side producer, which only host time brings, as
44
+ /// `has_producer` says, it is due at `at` as a live clock is.
45
+ pub fn clock_due(self, at: Instant, has_producer: bool) -> Instant {
46
+ match (self, has_producer) {
47
+ (Self::Hermetic, false) => Instant::now(),
48
+ _ => at,
76
49
  }
77
50
  }
78
51
  }
@@ -81,94 +54,6 @@ impl Profile {
81
54
  mod tests {
82
55
  use super::*;
83
56
 
84
- // The Wasm Driver only encodes this, so another one shows the same, and a
85
- // guest reads a link's size and a time here or nowhere.
86
- // @behavior RT-173 RT-183
87
- #[test]
88
- fn a_guest_sees_no_size_for_a_link_and_only_what_its_posture_allows() {
89
- let reported = Kstat::new(FileType::Symlink, 42)
90
- .with_identity(7, 9)
91
- .with_times(Some(SystemTime::now()), None, None);
92
- let (hermetic, permissive) = (
93
- Profile::Hermetic.guest_kstat(reported),
94
- Profile::Permissive.guest_kstat(reported),
95
- );
96
- assert_eq!(
97
- (hermetic.size, permissive.size, hermetic.ino, hermetic.atime),
98
- (0, 0, 0, Some(UNIX_EPOCH)),
99
- "Profile::guest_kstat of a link must report no size on any posture, and at the \
100
- hermetic rung no inode number and every time at the Unix epoch"
101
- );
102
- assert!(
103
- permissive.ino != 0 && permissive.ino != 9 && permissive.atime == reported.atime,
104
- "Profile::guest_kstat at the permissive rung must hash the inode number and keep \
105
- the time"
106
- );
107
- }
108
-
109
- // A device number depends on how many Filesystems the process made before,
110
- // so the inode number a guest reads folds it in and the device stays out.
111
- // @behavior RT-283
112
- #[test]
113
- fn a_guest_sees_one_device_for_every_entry() {
114
- let reported = Kstat::new(FileType::RegFile, 1).with_identity(7, 9);
115
- assert_eq!(
116
- [Profile::Hermetic, Profile::Permissive]
117
- .map(|profile| profile.guest_kstat(reported).dev),
118
- [0, 0],
119
- "Profile::guest_kstat of an entry a Filesystem reports on device 7 must report \
120
- device 0 on either posture"
121
- );
122
- }
123
-
124
- // An unkeyed hash answers what anyone can compute from a host's numbers,
125
- // so the hash a guest reads must differ from it.
126
- // @behavior RT-194
127
- #[test]
128
- fn a_guest_cannot_compute_the_inode_number_it_reads() {
129
- use std::collections::hash_map::DefaultHasher;
130
- use std::hash::{Hash, Hasher};
131
-
132
- let reported = Kstat::new(FileType::RegFile, 0).with_identity(7, 9);
133
- let identity = Identity::of(&reported);
134
- let mut unkeyed = DefaultHasher::new();
135
- identity
136
- .expect("an inode number names an identity")
137
- .hash(&mut unkeyed);
138
- let seen = Profile::Permissive.guest_ino(identity);
139
- assert_eq!(
140
- seen,
141
- Profile::Permissive.guest_ino(identity),
142
- "Profile::guest_ino of one identity must answer one number within a process"
143
- );
144
- assert_ne!(
145
- seen,
146
- unkeyed.finish(),
147
- "Profile::guest_ino at the permissive rung must not answer a hash anyone can compute \
148
- from the device and inode numbers"
149
- );
150
- }
151
-
152
- // A guest reads the count on any ABI, so the count starts in the runtime
153
- // rather than in what a Wasm Driver encodes.
154
- // @behavior RT-193
155
- #[test]
156
- fn an_entry_whose_filesystem_keeps_no_count_is_named_once() {
157
- let reported = Kstat::new(FileType::RegFile, 0);
158
- assert_eq!(
159
- (
160
- Profile::Hermetic.guest_kstat(reported).nlink,
161
- Profile::Permissive.guest_kstat(reported).nlink,
162
- Profile::Permissive
163
- .guest_kstat(reported.with_nlink(3))
164
- .nlink,
165
- ),
166
- (1, 1, 3),
167
- "Profile::guest_kstat of an entry reporting no count must show one name on each \
168
- posture, and of one reporting three must show three"
169
- );
170
- }
171
-
172
57
  // @behavior RT-014
173
58
  #[test]
174
59
  fn a_declaration_satisfies_any_floor_at_or_below_it() {
@@ -45,10 +45,8 @@ pub enum Entry<'a> {
45
45
  /// Safety contract for `handler`: the runtime only *borrows* the handler
46
46
  /// for the duration of `invoke` and never roots it. A frontend whose
47
47
  /// handler references a GC-managed object (e.g. a Ruby `Proc`) must keep
48
- /// that object alive — and, under a moving GC, pinned — for the whole call.
49
- /// The Ruby ext does this by holding the `Proc` on its long-lived Runtime
50
- /// wrapper and GC-marking it; the runtime itself touches no frontend
51
- /// value.
48
+ /// that object alive — and, under a moving GC, pinned — for the whole call;
49
+ /// the runtime itself touches no frontend value.
52
50
  pub trait Runtime {
53
51
  /// `grants` are this Invocation's, each of a kind `supports` declared;
54
52
  /// the runtime presents them to the guest and keeps none afterwards.
@@ -69,7 +67,7 @@ pub trait Runtime {
69
67
  }
70
68
 
71
69
  /// The isolation profile this runtime provides. Deliberately
72
- /// without a default: every engine states its posture explicitly,
70
+ /// without a default: every engine states its profile explicitly,
73
71
  /// and a frontend refuses construction when the declaration falls
74
72
  /// below the floor its host application requested.
75
73
  fn profile(&self) -> Profile;
@@ -7,16 +7,18 @@
7
7
 
8
8
  use std::cell::RefCell;
9
9
  use std::sync::atomic::{AtomicBool, Ordering};
10
- use std::sync::{Arc, OnceLock};
10
+ use std::sync::{Arc, Mutex, OnceLock, PoisonError};
11
11
  use std::thread::{self, ThreadId};
12
12
  use std::time::{Duration, Instant};
13
13
 
14
- /// How a thread waits for a lock another thread holds. A frontend whose
15
- /// threads share a lock of their own, as Ruby's threads share the GVL,
16
- /// gives that lock up for the wait, or a holder that needs it to finish
17
- /// never could.
14
+ use crate::wait::Waiter;
15
+
16
+ /// How a thread waits for a lock another thread holds, or for what another
17
+ /// thread brings. A frontend whose threads share a lock of their own, as
18
+ /// Ruby's threads share the GVL, gives that lock up for the wait, or a holder
19
+ /// that needs it to finish never could.
18
20
  pub trait Blocking: Send + Sync {
19
- /// Run `wait`, which returns once the lock is taken.
21
+ /// Run `wait`, which returns once the lock is taken or the event arrived.
20
22
  fn wait(&self, wait: &mut dyn FnMut());
21
23
  }
22
24
 
@@ -38,13 +40,9 @@ pub(crate) fn schedule(wait: &mut dyn FnMut()) {
38
40
  }
39
41
  }
40
42
 
41
- thread_local! {
42
- static CURRENT: ThreadId = thread::current().id();
43
- }
44
-
45
- /// Who is running, as Linux's `current`.
43
+ /// Who is running, as a lock records Linux's `current` as its owner.
46
44
  pub(crate) fn current() -> ThreadId {
47
- CURRENT.with(|current| *current)
45
+ TASK.with(|task| task.borrow().id)
48
46
  }
49
47
 
50
48
  /// A thread as its frontend may interrupt it from another thread, as a signal
@@ -52,6 +50,9 @@ pub(crate) fn current() -> ThreadId {
52
50
  #[derive(Clone, Default)]
53
51
  pub struct Task {
54
52
  interrupted: Arc<AtomicBool>,
53
+ /// The waiter the thread sleeps on, woken by an interrupt as
54
+ /// `signal_wake_up` wakes a sleeping task.
55
+ sleeping: Arc<Mutex<Option<Arc<Waiter>>>>,
55
56
  }
56
57
 
57
58
  impl Task {
@@ -64,37 +65,87 @@ impl Task {
64
65
  /// signal ends a killable wait; it holds until that run ends.
65
66
  pub fn interrupt(&self) {
66
67
  self.interrupted.store(true, Ordering::SeqCst);
68
+ if let Some(waiter) = self.sleeping().as_ref() {
69
+ waiter.wake();
70
+ }
71
+ }
72
+
73
+ fn sleeping(&self) -> std::sync::MutexGuard<'_, Option<Arc<Waiter>>> {
74
+ self.sleeping.lock().unwrap_or_else(PoisonError::into_inner)
75
+ }
76
+ }
77
+
78
+ /// Have an interrupt of the calling thread wake `waiter` while `sleep` runs,
79
+ /// as a task sleeping in `TASK_KILLABLE` is woken by a fatal signal.
80
+ pub(crate) fn sleep_on<T>(waiter: &Arc<Waiter>, sleep: impl FnOnce() -> T) -> T {
81
+ /// Takes the waiter back however `sleep` ends.
82
+ struct Awake(Task);
83
+
84
+ impl Drop for Awake {
85
+ fn drop(&mut self) {
86
+ *self.0.sleeping() = None;
87
+ }
67
88
  }
89
+
90
+ let task = Task::current();
91
+ *task.sleeping() = Some(waiter.clone());
92
+ let _awake = Awake(task);
93
+ sleep()
68
94
  }
69
95
 
70
96
  /// The task this thread carries out, as Linux's `current`, and when its run is
71
97
  /// to stop.
72
- #[derive(Default)]
73
98
  struct Current {
99
+ id: ThreadId,
74
100
  task: Task,
75
101
  deadline: Option<Instant>,
76
- /// How many runs the thread is inside, one within another where a
77
- /// Filesystem's own call starts another.
102
+ /// How many interruptible stretches the thread is inside: a frontend's
103
+ /// around its run, and a run within another where a Filesystem's own call
104
+ /// starts another.
78
105
  depth: usize,
79
106
  }
80
107
 
81
108
  thread_local! {
82
- static TASK: RefCell<Current> = RefCell::default();
109
+ static TASK: RefCell<Current> = RefCell::new(Current {
110
+ id: thread::current().id(),
111
+ task: Task::default(),
112
+ deadline: None,
113
+ depth: 0,
114
+ });
83
115
  }
84
116
 
85
117
  /// Run `run` as a run that stops waiting once `deadline` passes or its thread
86
118
  /// is interrupted, as a Linux task stops a killable wait on a fatal signal. A
87
119
  /// run within another keeps the outer one's interrupt.
88
120
  pub fn run_task<T>(deadline: Option<Instant>, run: impl FnOnce() -> T) -> T {
89
- /// Puts back the deadline of the run around this one, however `run` ends,
90
- /// and lets an interrupt go once no run is left.
121
+ /// Puts back the deadline of the run around this one, however `run` ends.
91
122
  struct Outer(Option<Instant>);
92
123
 
93
124
  impl Drop for Outer {
125
+ fn drop(&mut self) {
126
+ TASK.with(|task| task.borrow_mut().deadline = self.0);
127
+ }
128
+ }
129
+
130
+ run_interruptible(|| {
131
+ let _outer =
132
+ Outer(TASK.with(|task| std::mem::replace(&mut task.borrow_mut().deadline, deadline)));
133
+ run()
134
+ })
135
+ }
136
+
137
+ /// Run `run` as a stretch its frontend may interrupt, as a frontend brackets
138
+ /// all it does for one call around the run itself. An interrupt landing
139
+ /// anywhere in it lasts until the outermost stretch ends, so it stops the
140
+ /// waits of the run it was meant for and never those of the thread's next.
141
+ pub fn run_interruptible<T>(run: impl FnOnce() -> T) -> T {
142
+ /// Lets an interrupt go once no stretch is left, however `run` ends.
143
+ struct Stretch;
144
+
145
+ impl Drop for Stretch {
94
146
  fn drop(&mut self) {
95
147
  TASK.with(|task| {
96
148
  let mut running = task.borrow_mut();
97
- running.deadline = self.0;
98
149
  running.depth -= 1;
99
150
  if running.depth == 0 {
100
151
  running.task.interrupted.store(false, Ordering::SeqCst);
@@ -103,24 +154,47 @@ pub fn run_task<T>(deadline: Option<Instant>, run: impl FnOnce() -> T) -> T {
103
154
  }
104
155
  }
105
156
 
106
- let _outer = Outer(TASK.with(|task| {
107
- let mut running = task.borrow_mut();
108
- running.depth += 1;
109
- std::mem::replace(&mut running.deadline, deadline)
110
- }));
157
+ TASK.with(|task| task.borrow_mut().depth += 1);
158
+ let _stretch = Stretch;
111
159
  run()
112
160
  }
113
161
 
114
- /// Whether the calling thread's run is to stop waiting, as Linux's
115
- /// `fatal_signal_pending(current)` answers.
116
- pub(crate) fn fatal_signal_pending() -> bool {
162
+ /// Why a run is to stop, as the fatal signal pending on a Linux task says
163
+ /// what ended it.
164
+ #[derive(Clone, Copy, Debug, PartialEq, Eq)]
165
+ pub enum FatalSignal {
166
+ /// The run passed its deadline.
167
+ Deadline,
168
+ /// The run's frontend interrupted it.
169
+ Interrupt,
170
+ }
171
+
172
+ /// The fatal signal pending on the calling thread's run, its deadline read
173
+ /// first; `None` while the run may go on waiting.
174
+ pub fn pending_fatal_signal() -> Option<FatalSignal> {
117
175
  TASK.with(|task| {
118
176
  let running = task.borrow();
119
- running.task.interrupted.load(Ordering::SeqCst)
120
- || running.deadline.is_some_and(|at| Instant::now() >= at)
177
+ if running.deadline.is_some_and(|at| Instant::now() >= at) {
178
+ Some(FatalSignal::Deadline)
179
+ } else if running.task.interrupted.load(Ordering::SeqCst) {
180
+ Some(FatalSignal::Interrupt)
181
+ } else {
182
+ None
183
+ }
121
184
  })
122
185
  }
123
186
 
187
+ /// Whether the calling thread's run is to stop waiting, as Linux's
188
+ /// `fatal_signal_pending(current)` answers.
189
+ pub(crate) fn fatal_signal_pending() -> bool {
190
+ pending_fatal_signal().is_some()
191
+ }
192
+
193
+ /// When the calling thread's run is to stop, once it has a deadline.
194
+ pub(crate) fn deadline() -> Option<Instant> {
195
+ TASK.with(|task| task.borrow().deadline)
196
+ }
197
+
124
198
  /// The most a wait sleeps before it looks again whether its run is to stop.
125
199
  const MAX_SLEEP: Duration = Duration::from_millis(10);
126
200
 
@@ -208,3 +282,30 @@ pub(crate) mod testing {
208
282
  counts
209
283
  }
210
284
  }
285
+
286
+ #[cfg(test)]
287
+ mod tests {
288
+ use super::*;
289
+
290
+ // @behavior RT-403
291
+ #[test]
292
+ fn an_interrupt_around_a_run_stops_that_run_alone() {
293
+ let (during_setup, after_teardown) = run_interruptible(|| {
294
+ Task::current().interrupt();
295
+ let during_setup = run_task(None, pending_fatal_signal);
296
+ Task::current().interrupt();
297
+ (during_setup, pending_fatal_signal())
298
+ });
299
+ let next = run_task(None, pending_fatal_signal);
300
+ assert_eq!(
301
+ (during_setup, after_teardown, next),
302
+ (
303
+ Some(FatalSignal::Interrupt),
304
+ Some(FatalSignal::Interrupt),
305
+ None
306
+ ),
307
+ "an interrupt while a run is set up must stop that run's waits, and \
308
+ one while it is torn down must not stop the thread's next run"
309
+ );
310
+ }
311
+ }
@@ -0,0 +1,22 @@
1
+ //! A network entry's connect policy as a security module, as Landlock's
2
+ //! `net.c` answers the network rights of its domain.
3
+
4
+ use std::sync::Arc;
5
+
6
+ use super::SecurityOperations;
7
+ use crate::network::Connection;
8
+ use crate::policy::Policy;
9
+ use crate::Errno;
10
+
11
+ /// An entry's connect policy, judging what the guest named, as one more LSM
12
+ /// answers `security_socket_connect`.
13
+ pub(super) struct EntryPolicy(pub(super) Arc<dyn for<'a> Policy<Connection<'a>>>);
14
+
15
+ impl SecurityOperations for EntryPolicy {
16
+ fn socket_connect(&self, connection: &Connection<'_>) -> Result<(), Errno> {
17
+ match self.0.allows(connection) {
18
+ true => Ok(()),
19
+ false => Err(Errno::PermissionDenied),
20
+ }
21
+ }
22
+ }