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,92 +1,138 @@
1
- //! The guest's WASI context for one instance: the Preamble on stdin,
2
- //! a capture pipe for each of stdout and stderr, the ambient authority
3
- //! the instance's purpose grants, and a preopen for each Mount an
4
- //! invocation was handed.
1
+ //! The guest's WASI context for one instance: what stdin holds, a capture
2
+ //! pipe for each of stdout and stderr, the ambient authority the instance's
3
+ //! purpose grants, a preopen for each outermost Mount an invocation was
4
+ //! handed, and the preview2 resources it holds, with the network its network
5
+ //! Grants open.
5
6
 
6
7
  use wasmtime_wasi::p1::WasiP1Ctx;
7
8
  use wasmtime_wasi::WasiCtxBuilder;
8
9
 
9
10
  use crate::ambient::{self, Clocks};
10
11
  use crate::config::Config;
11
- use crate::descriptors::Descriptors;
12
- use kobako_runtime::endpoint;
13
- use kobako_runtime::error::Trap;
12
+ use crate::preview1::descriptors::{Descriptors, FileRef, FileRefMut};
13
+ use crate::preview2;
14
+ use kobako_runtime::error::{InvokeError, Trap};
15
+ use kobako_runtime::snapshot::Capture;
14
16
  use std::sync::Arc;
15
17
 
18
+ use kobako_runtime::cred::Cred;
16
19
  use kobako_runtime::filesystem::{create_pipe_files, PipeInodeInfo};
17
20
  use kobako_runtime::grant::Grant;
18
- use kobako_runtime::mount::Mount;
21
+ use kobako_runtime::limits::Limits;
22
+ use kobako_runtime::mount::outermost_of;
23
+ use kobako_runtime::net::{Backends, Namespace, OpenConnections};
24
+ use kobako_runtime::network::EntryError;
19
25
  use kobako_runtime::profile::Profile;
20
- use kobako_runtime::security::prepare_creds_within;
21
- use kobako_runtime::vfs::Cred;
22
-
23
- /// The Cred an invocation's Mounts open as: kobako's own rules, then each
24
- /// module the Driver was built with, its Filesystems holding at most the
25
- /// memory the Driver allots, as Linux's `prepare_creds` gives a task the
26
- /// LSMs it booted with.
27
- fn prepare_creds(config: &Config) -> Arc<Cred> {
28
- prepare_creds_within(&config.security, config.memory_limit)
29
- }
26
+ use kobako_runtime::security::{prepare_creds, restrict_self, WalkGuard};
27
+ use kobako_runtime::vfs::{File, OpenFiles};
30
28
 
31
- /// One instance's WASI context: its descriptor table, the clocks its
32
- /// waits pass on, and the capture pipes stdout and stderr write into, so
33
- /// the captures are read back from the same owner that wired them.
29
+ /// One instance's WASI context: who its calls are made for, each encoding's
30
+ /// table, the clocks its waits pass on, and the capture pipes stdout and
31
+ /// stderr write into, so the captures are read back from the same owner that
32
+ /// wired them.
34
33
  pub(crate) struct Wasi {
35
34
  ctx: WasiP1Ctx,
35
+ /// Who the guest's calls are made for, through either encoding, as a
36
+ /// task holds its `cred`, and the isolation it runs under.
37
+ cred: Arc<Cred>,
38
+ /// What every call through a descriptor asks first, so a Policy judges
39
+ /// the path it stands at.
40
+ walk_guard: WalkGuard,
36
41
  descriptors: Descriptors,
42
+ table: preview2::Table,
43
+ /// The network the Invocation's Grants make, where every socket and
44
+ /// lookup is made; none without a network Grant.
45
+ network: Option<Namespace>,
37
46
  clocks: Clocks,
38
47
  stdout: Arc<PipeInodeInfo>,
39
48
  stderr: Arc<PipeInodeInfo>,
40
49
  }
41
50
 
42
51
  impl Wasi {
43
- /// An invocation's context, granting the posture the Sandbox requested
44
- /// and presenting each of the invocation's Mounts as a preopen, from
45
- /// descriptor 3 in order.
46
- pub(crate) fn for_invocation(
47
- config: &Config,
48
- stdin: Vec<u8>,
49
- grants: &[Grant],
50
- ) -> Result<Self, Trap> {
52
+ /// An invocation's context, granting the profile the Sandbox requested
53
+ /// and presenting each of the invocation's outermost Mounts as a preopen,
54
+ /// from descriptor 3 in order. A network entry whose endpoints the ruleset
55
+ /// refuses answers `InvokeError::Entry`, the Host App's argument, and a
56
+ /// nested Mount Linux's `mount` would refuse answers `InvokeError::Setup`,
57
+ /// as a container fails to start. Descriptor 0 reads nothing.
58
+ pub(crate) fn for_invocation(config: &Config, grants: &[Grant]) -> Result<Self, InvokeError> {
59
+ let mut wasi = Self::new(
60
+ Vec::new(),
61
+ config.limits.stdout_limit,
62
+ config.limits.stderr_limit,
63
+ config.limits.open_file_limit,
64
+ prepare_creds(&config.security, config.limits.memory_limit),
65
+ config.profile,
66
+ grants,
67
+ )?;
68
+ wasi.network = to_network(grants, &config.network, &config.limits)?;
69
+ Ok(wasi)
70
+ }
71
+
72
+ /// An invocation's context with no grants whose descriptor 0 reads
73
+ /// `stdin`, for comparing a stdin read with wasmtime-wasi's.
74
+ #[cfg(test)]
75
+ pub(crate) fn reading_stdin(config: &Config, stdin: Vec<u8>) -> Self {
51
76
  Self::new(
52
77
  stdin,
53
- config.stdout_limit,
54
- config.stderr_limit,
55
- config.open_file_limit,
56
- prepare_creds(config),
78
+ config.limits.stdout_limit,
79
+ config.limits.stderr_limit,
80
+ config.limits.open_file_limit,
81
+ prepare_creds(&config.security, config.limits.memory_limit),
57
82
  config.profile,
58
- grants.iter().filter_map(to_mount).collect(),
83
+ &[],
59
84
  )
85
+ .expect("a context with no grants builds")
60
86
  }
61
87
 
62
- /// A compile's context, at the strongest posture whatever the Sandbox
88
+ /// A compile's context, on the hermetic profile whatever the Sandbox
63
89
  /// requested: compiling the Snippets needs no ambient authority, so
64
90
  /// it is granted none.
65
- pub(crate) fn for_compile(config: &Config, stdin: Vec<u8>) -> Result<Self, Trap> {
91
+ pub(crate) fn for_compile(config: &Config) -> Result<Self, InvokeError> {
66
92
  Self::new(
67
- stdin,
68
- config.stdout_limit,
69
- config.stderr_limit,
70
- config.open_file_limit,
71
- prepare_creds(config),
72
- Profile::Hermetic,
73
93
  Vec::new(),
94
+ config.limits.stdout_limit,
95
+ config.limits.stderr_limit,
96
+ config.limits.open_file_limit,
97
+ prepare_creds(&config.security, config.limits.memory_limit),
98
+ Profile::Hermetic,
99
+ &[],
74
100
  )
75
101
  }
76
102
 
77
103
  /// The ABI version probe's context. Instantiating it runs the
78
104
  /// artifact's start section, yet reading a version needs no input, no
79
105
  /// ambient authority, and no output: the probe takes an empty stdin, the
80
- /// strongest posture, and pipes sized to keep nothing.
81
- pub(crate) fn for_probe() -> Result<Self, Trap> {
106
+ /// hermetic profile, and pipes sized to keep nothing.
107
+ pub(crate) fn for_probe() -> Result<Self, InvokeError> {
82
108
  Self::new(
83
109
  Vec::new(),
84
110
  Some(0),
85
111
  Some(0),
86
112
  None,
87
- prepare_creds_within(&[], None),
113
+ prepare_creds(&[], None),
88
114
  Profile::Hermetic,
115
+ &[],
116
+ )
117
+ }
118
+
119
+ /// A hermetic context presenting the outermost of `mounts` as preopens
120
+ /// from descriptor 3, at most `open_file_limit` files open, so a test
121
+ /// reaches preview1's calls as an invocation does.
122
+ #[cfg(test)]
123
+ pub(crate) fn with_mounts(
124
+ mounts: Vec<kobako_runtime::mount::Mount>,
125
+ open_file_limit: Option<usize>,
126
+ ) -> Result<Self, InvokeError> {
127
+ let grants = mounts.into_iter().map(Grant::Mount).collect::<Vec<_>>();
128
+ Self::new(
89
129
  Vec::new(),
130
+ None,
131
+ None,
132
+ open_file_limit,
133
+ prepare_creds(&[], None),
134
+ Profile::Hermetic,
135
+ &grants,
90
136
  )
91
137
  }
92
138
 
@@ -99,32 +145,55 @@ impl Wasi {
99
145
  open_file_limit: Option<usize>,
100
146
  opener: Arc<Cred>,
101
147
  profile: Profile,
102
- mounts: Vec<Mount>,
103
- ) -> Result<Self, Trap> {
104
- let stdout = PipeInodeInfo::new(endpoint::pipe_capacity(stdout_limit));
105
- let stderr = PipeInodeInfo::new(endpoint::pipe_capacity(stderr_limit));
148
+ grants: &[Grant],
149
+ ) -> Result<Self, InvokeError> {
150
+ // The guest sees entries as its profile allows, through whichever
151
+ // encoding asks.
152
+ let opener = opener.with_profile(profile);
153
+ let stdout = PipeInodeInfo::new(Capture::pipe_capacity_of(stdout_limit));
154
+ let stderr = PipeInodeInfo::new(Capture::pipe_capacity_of(stderr_limit));
106
155
 
107
156
  // stdio lives in kobako's descriptor table, which answers every
108
157
  // call that reads a descriptor (`crate::preview1`); the builder
109
- // keeps only what the remaining imports read.
158
+ // keeps only what the remaining imports read. preview2's resource
159
+ // table holds every file, the descriptors' included, and counts each
160
+ // against the open files.
161
+ let mut table = preview2::Table::new(
162
+ OpenFiles::new(open_file_limit),
163
+ opener.memory_budget().clone(),
164
+ );
165
+ let mounts = grants
166
+ .iter()
167
+ .filter_map(|grant| match grant {
168
+ Grant::Mount(mount) => Some(mount),
169
+ _ => None,
170
+ })
171
+ .collect::<Vec<_>>();
172
+ // The opener Cred opens each preopen's root before any Policy judges
173
+ // it, as a Landlock sandboxer opens what it keeps and then calls
174
+ // `landlock_restrict_self`, so a Policy judges only what the guest
175
+ // asks for; the guest's Cred, with the hooks `restrict_self` adds,
176
+ // decides what each walk reaches from there.
177
+ let cred = restrict_self(&opener, grants)?;
110
178
  let descriptors = Descriptors::new(
111
179
  create_pipe_files(&PipeInodeInfo::from_bytes(stdin), &opener).0,
112
180
  create_pipe_files(&stdout, &opener).1,
113
181
  create_pipe_files(&stderr, &opener).1,
114
- mounts,
115
- open_file_limit,
116
- opener,
117
- profile,
182
+ &outermost_of(&mounts),
183
+ &mut table,
184
+ (&opener, &cred),
118
185
  )
119
186
  .map_err(|err| Trap::Other(format!("a Mount's root did not open: {err:?}")))?;
187
+ let walk_guard = WalkGuard::new(mounts);
120
188
 
121
189
  let mut builder = WasiCtxBuilder::new();
122
- // The profile decides the ambient authority granted: the
123
- // hermetic rung denies the preview1 time and entropy imports (see
124
- // `ambient`), the permissive rung leaves the live WASI sources.
125
- // Ambient filesystem, environment, and network stay absent on both rungs —
126
- // the builder grants none unless asked. The exhaustive match makes
127
- // a future ladder rung a compile error here, not authority granted
190
+ // The profile decides the ambient authority granted: the hermetic
191
+ // profile denies the preview1 time and entropy imports (see
192
+ // `ambient`), the permissive one wires the live clocks that the
193
+ // guest's waits read too, and leaves the live entropy. Ambient
194
+ // filesystem, environment, and network stay absent on both; the
195
+ // builder grants none unless asked. The exhaustive match makes a
196
+ // future profile a compile error here, not authority granted
128
197
  // silently.
129
198
  let clocks = match profile {
130
199
  Profile::Hermetic => {
@@ -135,14 +204,20 @@ impl Wasi {
135
204
  }
136
205
  Profile::Permissive => {
137
206
  let monotonic = ambient::LiveMonotonicClock::new();
207
+ let wall = ambient::LiveWallClock;
138
208
  builder.monotonic_clock(monotonic);
139
- Clocks::Live(monotonic)
209
+ builder.wall_clock(wall);
210
+ Clocks::Live { monotonic, wall }
140
211
  }
141
212
  };
142
213
 
143
214
  Ok(Self {
144
215
  ctx: builder.build_p1(),
216
+ cred,
217
+ walk_guard,
145
218
  descriptors,
219
+ table,
220
+ network: None,
146
221
  clocks,
147
222
  stdout,
148
223
  stderr,
@@ -153,14 +228,59 @@ impl Wasi {
153
228
  &mut self.ctx
154
229
  }
155
230
 
231
+ pub(crate) fn cred(&self) -> &Arc<Cred> {
232
+ &self.cred
233
+ }
234
+
235
+ pub(crate) fn walk_guard(&self) -> &WalkGuard {
236
+ &self.walk_guard
237
+ }
238
+
239
+ pub(crate) fn profile(&self) -> Profile {
240
+ self.cred.profile()
241
+ }
242
+
156
243
  pub(crate) fn descriptors(&self) -> &Descriptors {
157
244
  &self.descriptors
158
245
  }
159
246
 
247
+ pub(crate) fn table(&self) -> &preview2::Table {
248
+ &self.table
249
+ }
250
+
251
+ pub(crate) fn table_mut(&mut self) -> &mut preview2::Table {
252
+ &mut self.table
253
+ }
254
+
255
+ pub(crate) fn network(&self) -> Option<&Namespace> {
256
+ self.network.as_ref()
257
+ }
258
+
160
259
  pub(crate) fn descriptors_mut(&mut self) -> &mut Descriptors {
161
260
  &mut self.descriptors
162
261
  }
163
262
 
263
+ /// The file `fd` stands for.
264
+ pub(crate) fn file(&self, fd: u32) -> Option<FileRef<'_>> {
265
+ self.descriptors.file(fd, &self.table)
266
+ }
267
+
268
+ /// The file `fd` stands for, to change.
269
+ pub(crate) fn file_mut(&mut self, fd: u32) -> Option<FileRefMut<'_>> {
270
+ self.descriptors.file_mut(fd, &mut self.table)
271
+ }
272
+
273
+ /// Open `file` under the lowest free descriptor, for a test.
274
+ #[cfg(test)]
275
+ pub(crate) fn push_file(&mut self, file: File) -> Option<u32> {
276
+ self.descriptors.push_file(file, &mut self.table)
277
+ }
278
+
279
+ /// Take `fd` out of the descriptor table: the file to close, if any.
280
+ pub(crate) fn take(&mut self, fd: u32) -> Option<Option<File>> {
281
+ self.descriptors.take(fd, &mut self.table)
282
+ }
283
+
164
284
  pub(crate) fn clocks(&self) -> Clocks {
165
285
  self.clocks
166
286
  }
@@ -174,19 +294,37 @@ impl Wasi {
174
294
  }
175
295
  }
176
296
 
177
- /// A Mount as this invocation presents it. A kind this driver does not
178
- /// support has no descriptor to stand behind; `Driver::supports` keeps a
179
- /// frontend from handing one over.
180
- fn to_mount(grant: &Grant) -> Option<Mount> {
181
- match grant {
182
- Grant::Mount(mount) => Some(mount.clone()),
183
- _ => None,
297
+ /// The network an invocation's Grants make, one namespace for every entry,
298
+ /// dialed and looked up through `backends`, each connection counted against
299
+ /// the run's `open_connection_limit` while open and its `connection_limit`
300
+ /// in all. No network Grant makes none.
301
+ fn to_network(
302
+ grants: &[Grant],
303
+ backends: &Backends,
304
+ limits: &Limits,
305
+ ) -> Result<Option<Namespace>, EntryError> {
306
+ let entries = grants
307
+ .iter()
308
+ .filter_map(|grant| match grant {
309
+ Grant::Network(network) => Some(network),
310
+ _ => None,
311
+ })
312
+ .collect::<Vec<_>>();
313
+ if entries.is_empty() {
314
+ return Ok(None);
184
315
  }
316
+ Namespace::new(
317
+ entries,
318
+ backends,
319
+ OpenConnections::new(limits.open_connection_limit),
320
+ limits.connection_limit,
321
+ )
322
+ .map(Some)
185
323
  }
186
324
 
187
325
  #[cfg(test)]
188
326
  mod tests {
189
- //! Witness what an invocation's context grants at each profile rung:
327
+ //! Witness what an invocation's context grants on each profile:
190
328
  //! `wasi:clocks` / `wasi:random` frozen under `Hermetic` and live
191
329
  //! under `Permissive`, and no ambient filesystem, environment, or
192
330
  //! socket under either.
@@ -238,18 +376,9 @@ mod tests {
238
376
  /// `profile` and return a reader for its exports.
239
377
  fn probe(profile: Profile) -> impl FnMut(&str) -> i64 {
240
378
  let engine = load_engine().expect("shared engine must be constructible");
241
- let config = Config {
242
- timeout: None,
243
- setup_timeout: None,
244
- memory_limit: None,
245
- stdout_limit: None,
246
- stderr_limit: None,
247
- open_file_limit: None,
248
- profile,
249
- security: Vec::new(),
250
- };
251
- let wasi = Wasi::for_invocation(&config, Vec::new(), &[]).expect("WASI context must build");
252
- let mut store = Store::new(engine, Invocation::new(None, wasi));
379
+ let config = Config::for_profile(profile);
380
+ let wasi = Wasi::for_invocation(&config, &[]).expect("WASI context must build");
381
+ let mut store = Store::new(engine, Invocation::new(wasi));
253
382
  store.set_epoch_deadline(crate::trap::NO_TIMEOUT_EPOCH_DELTA);
254
383
 
255
384
  let linker = imports::linker().expect("host imports must link");
@@ -0,0 +1,233 @@
1
+ package wasi:cli@0.2.12;
2
+
3
+ @since(version = 0.2.0)
4
+ interface environment {
5
+ /// Get the POSIX-style environment variables.
6
+ ///
7
+ /// Each environment variable is provided as a pair of string variable names
8
+ /// and string value.
9
+ ///
10
+ /// Morally, these are a value import, but until value imports are available
11
+ /// in the component model, this import function should return the same
12
+ /// values each time it is called.
13
+ @since(version = 0.2.0)
14
+ get-environment: func() -> list<tuple<string, string>>;
15
+
16
+ /// Get the POSIX-style arguments to the program.
17
+ @since(version = 0.2.0)
18
+ get-arguments: func() -> list<string>;
19
+
20
+ /// Return a path that programs should use as their initial current working
21
+ /// directory, interpreting `.` as shorthand for this.
22
+ @since(version = 0.2.0)
23
+ initial-cwd: func() -> option<string>;
24
+ }
25
+
26
+ @since(version = 0.2.0)
27
+ interface exit {
28
+ /// Exit the current instance and any linked instances.
29
+ @since(version = 0.2.0)
30
+ exit: func(status: result);
31
+
32
+ /// Exit the current instance and any linked instances, reporting the
33
+ /// specified status code to the host.
34
+ ///
35
+ /// The meaning of the code depends on the context, with 0 usually meaning
36
+ /// "success", and other values indicating various types of failure.
37
+ ///
38
+ /// This function does not return; the effect is analogous to a trap, but
39
+ /// without the connotation that something bad has happened.
40
+ @since(version = 0.2.12)
41
+ exit-with-code: func(status-code: u8);
42
+ }
43
+
44
+ @since(version = 0.2.0)
45
+ interface run {
46
+ /// Run the program.
47
+ @since(version = 0.2.0)
48
+ run: func() -> result;
49
+ }
50
+
51
+ @since(version = 0.2.0)
52
+ interface stdin {
53
+ @since(version = 0.2.0)
54
+ use wasi:io/streams@0.2.12.{input-stream};
55
+
56
+ @since(version = 0.2.0)
57
+ get-stdin: func() -> input-stream;
58
+ }
59
+
60
+ @since(version = 0.2.0)
61
+ interface stdout {
62
+ @since(version = 0.2.0)
63
+ use wasi:io/streams@0.2.12.{output-stream};
64
+
65
+ @since(version = 0.2.0)
66
+ get-stdout: func() -> output-stream;
67
+ }
68
+
69
+ @since(version = 0.2.0)
70
+ interface stderr {
71
+ @since(version = 0.2.0)
72
+ use wasi:io/streams@0.2.12.{output-stream};
73
+
74
+ @since(version = 0.2.0)
75
+ get-stderr: func() -> output-stream;
76
+ }
77
+
78
+ /// Terminal input.
79
+ ///
80
+ /// In the future, this may include functions for disabling echoing,
81
+ /// disabling input buffering so that keyboard events are sent through
82
+ /// immediately, querying supported features, and so on.
83
+ @since(version = 0.2.0)
84
+ interface terminal-input {
85
+ /// The input side of a terminal.
86
+ @since(version = 0.2.0)
87
+ resource terminal-input;
88
+ }
89
+
90
+ /// Terminal output.
91
+ ///
92
+ /// In the future, this may include functions for querying the terminal
93
+ /// size, being notified of terminal size changes, querying supported
94
+ /// features, and so on.
95
+ @since(version = 0.2.0)
96
+ interface terminal-output {
97
+ /// The output side of a terminal.
98
+ @since(version = 0.2.0)
99
+ resource terminal-output;
100
+ }
101
+
102
+ /// An interface providing an optional `terminal-input` for stdin as a
103
+ /// link-time authority.
104
+ @since(version = 0.2.0)
105
+ interface terminal-stdin {
106
+ @since(version = 0.2.0)
107
+ use terminal-input.{terminal-input};
108
+
109
+ /// If stdin is connected to a terminal, return a `terminal-input` handle
110
+ /// allowing further interaction with it.
111
+ @since(version = 0.2.0)
112
+ get-terminal-stdin: func() -> option<terminal-input>;
113
+ }
114
+
115
+ /// An interface providing an optional `terminal-output` for stdout as a
116
+ /// link-time authority.
117
+ @since(version = 0.2.0)
118
+ interface terminal-stdout {
119
+ @since(version = 0.2.0)
120
+ use terminal-output.{terminal-output};
121
+
122
+ /// If stdout is connected to a terminal, return a `terminal-output` handle
123
+ /// allowing further interaction with it.
124
+ @since(version = 0.2.0)
125
+ get-terminal-stdout: func() -> option<terminal-output>;
126
+ }
127
+
128
+ /// An interface providing an optional `terminal-output` for stderr as a
129
+ /// link-time authority.
130
+ @since(version = 0.2.0)
131
+ interface terminal-stderr {
132
+ @since(version = 0.2.0)
133
+ use terminal-output.{terminal-output};
134
+
135
+ /// If stderr is connected to a terminal, return a `terminal-output` handle
136
+ /// allowing further interaction with it.
137
+ @since(version = 0.2.0)
138
+ get-terminal-stderr: func() -> option<terminal-output>;
139
+ }
140
+
141
+ @since(version = 0.2.0)
142
+ world imports {
143
+ @since(version = 0.2.0)
144
+ import environment;
145
+ @since(version = 0.2.0)
146
+ import exit;
147
+ @since(version = 0.2.0)
148
+ import wasi:io/error@0.2.12;
149
+ @since(version = 0.2.0)
150
+ import wasi:io/poll@0.2.12;
151
+ @since(version = 0.2.0)
152
+ import wasi:io/streams@0.2.12;
153
+ @since(version = 0.2.0)
154
+ import stdin;
155
+ @since(version = 0.2.0)
156
+ import stdout;
157
+ @since(version = 0.2.0)
158
+ import stderr;
159
+ @since(version = 0.2.0)
160
+ import terminal-input;
161
+ @since(version = 0.2.0)
162
+ import terminal-output;
163
+ @since(version = 0.2.0)
164
+ import terminal-stdin;
165
+ @since(version = 0.2.0)
166
+ import terminal-stdout;
167
+ @since(version = 0.2.0)
168
+ import terminal-stderr;
169
+ import wasi:clocks/monotonic-clock@0.2.12;
170
+ import wasi:clocks/wall-clock@0.2.12;
171
+ @unstable(feature = clocks-timezone)
172
+ import wasi:clocks/timezone@0.2.12;
173
+ import wasi:filesystem/types@0.2.12;
174
+ import wasi:filesystem/preopens@0.2.12;
175
+ import wasi:sockets/network@0.2.12;
176
+ import wasi:sockets/instance-network@0.2.12;
177
+ import wasi:sockets/udp@0.2.12;
178
+ import wasi:sockets/udp-create-socket@0.2.12;
179
+ import wasi:sockets/tcp@0.2.12;
180
+ import wasi:sockets/tcp-create-socket@0.2.12;
181
+ import wasi:sockets/ip-name-lookup@0.2.12;
182
+ import wasi:random/random@0.2.12;
183
+ import wasi:random/insecure@0.2.12;
184
+ import wasi:random/insecure-seed@0.2.12;
185
+ }
186
+ @since(version = 0.2.0)
187
+ world command {
188
+ @since(version = 0.2.0)
189
+ import environment;
190
+ @since(version = 0.2.0)
191
+ import exit;
192
+ @since(version = 0.2.0)
193
+ import wasi:io/error@0.2.12;
194
+ @since(version = 0.2.0)
195
+ import wasi:io/poll@0.2.12;
196
+ @since(version = 0.2.0)
197
+ import wasi:io/streams@0.2.12;
198
+ @since(version = 0.2.0)
199
+ import stdin;
200
+ @since(version = 0.2.0)
201
+ import stdout;
202
+ @since(version = 0.2.0)
203
+ import stderr;
204
+ @since(version = 0.2.0)
205
+ import terminal-input;
206
+ @since(version = 0.2.0)
207
+ import terminal-output;
208
+ @since(version = 0.2.0)
209
+ import terminal-stdin;
210
+ @since(version = 0.2.0)
211
+ import terminal-stdout;
212
+ @since(version = 0.2.0)
213
+ import terminal-stderr;
214
+ import wasi:clocks/monotonic-clock@0.2.12;
215
+ import wasi:clocks/wall-clock@0.2.12;
216
+ @unstable(feature = clocks-timezone)
217
+ import wasi:clocks/timezone@0.2.12;
218
+ import wasi:filesystem/types@0.2.12;
219
+ import wasi:filesystem/preopens@0.2.12;
220
+ import wasi:sockets/network@0.2.12;
221
+ import wasi:sockets/instance-network@0.2.12;
222
+ import wasi:sockets/udp@0.2.12;
223
+ import wasi:sockets/udp-create-socket@0.2.12;
224
+ import wasi:sockets/tcp@0.2.12;
225
+ import wasi:sockets/tcp-create-socket@0.2.12;
226
+ import wasi:sockets/ip-name-lookup@0.2.12;
227
+ import wasi:random/random@0.2.12;
228
+ import wasi:random/insecure@0.2.12;
229
+ import wasi:random/insecure-seed@0.2.12;
230
+
231
+ @since(version = 0.2.0)
232
+ export run;
233
+ }