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,236 +0,0 @@
1
- //! Holds what a caller is refused to the Linux that refuses it: a Policy to the
2
- //! same rules under Landlock, and a Bind to a process of another user.
3
-
4
- use std::collections::BTreeMap;
5
- use std::ffi::CString;
6
- use std::fs;
7
- use std::io;
8
- use std::os::unix::fs::PermissionsExt;
9
- use std::sync::{Arc, PoisonError};
10
- use std::thread;
11
-
12
- use kobako_runtime::filesystem::Filesystem;
13
- use kobako_runtime::mount::{Access, Policy};
14
-
15
- use crate::calls::{Call, Rng};
16
- use crate::kobako::Kobako;
17
- use crate::linux::Linux;
18
- use crate::{assert_named, bind, class, note, seed_directory, Difference, Setup, BASE, SERIAL};
19
-
20
- /// Landlock's right to read a file and to list a directory.
21
- const LANDLOCK_READ: u64 = (1 << 2) | (1 << 3);
22
- /// Every right Landlock's filesystem rules name.
23
- const LANDLOCK_ALL: u64 = (1 << 16) - 1;
24
-
25
- const SYS_LANDLOCK_CREATE_RULESET: libc::c_long = 444;
26
- const SYS_LANDLOCK_ADD_RULE: libc::c_long = 445;
27
- const SYS_LANDLOCK_RESTRICT_SELF: libc::c_long = 446;
28
- const LANDLOCK_RULE_PATH_BENEATH: libc::c_long = 1;
29
-
30
- #[repr(C)]
31
- struct RulesetAttr {
32
- handled_access_fs: u64,
33
- handled_access_net: u64,
34
- scoped: u64,
35
- }
36
-
37
- #[repr(C, packed)]
38
- struct PathBeneath {
39
- allowed_access: u64,
40
- parent_fd: i32,
41
- }
42
-
43
- /// Reads anywhere, and changes only beneath `d`.
44
- struct WritesBeneathD;
45
-
46
- impl Policy for WritesBeneathD {
47
- fn allows(&self, path: &str, access: Access) -> bool {
48
- access == Access::Read || path.starts_with("/baseline/d/")
49
- }
50
- }
51
-
52
- /// Hold this thread to the rule `WritesBeneathD` states, over `root`, and leave it
53
- /// `unjudged` to do anything, as kobako's own host directory is no guest's.
54
- fn restrict_as_writes_beneath_d(root: &str, unjudged: &str) {
55
- let attr = RulesetAttr {
56
- handled_access_fs: LANDLOCK_ALL,
57
- handled_access_net: 0,
58
- scoped: 0,
59
- };
60
- // SAFETY: each pointer names a live value of the size its call is told, and
61
- // each descriptor is one this call opened.
62
- unsafe {
63
- assert_eq!(libc::prctl(libc::PR_SET_NO_NEW_PRIVS, 1, 0, 0, 0), 0);
64
- let size = size_of::<RulesetAttr>();
65
- let ruleset = libc::syscall(SYS_LANDLOCK_CREATE_RULESET, &raw const attr, size, 0);
66
- assert!(
67
- ruleset >= 0,
68
- "this kernel must enforce Landlock: {}",
69
- io::Error::last_os_error()
70
- );
71
- let rules = [
72
- (root.to_string(), LANDLOCK_READ),
73
- (format!("{root}/d"), LANDLOCK_ALL),
74
- (unjudged.to_string(), LANDLOCK_ALL),
75
- ];
76
- for (path, allowed_access) in rules {
77
- let path = CString::new(path).expect("no path holds a NUL");
78
- let parent_fd = libc::open(path.as_ptr(), libc::O_PATH | libc::O_CLOEXEC);
79
- assert!(parent_fd >= 0, "{}", io::Error::last_os_error());
80
- let rule = PathBeneath {
81
- allowed_access,
82
- parent_fd,
83
- };
84
- let added = libc::syscall(
85
- SYS_LANDLOCK_ADD_RULE,
86
- ruleset,
87
- LANDLOCK_RULE_PATH_BENEATH,
88
- &raw const rule,
89
- 0,
90
- );
91
- assert_eq!(added, 0, "{}", io::Error::last_os_error());
92
- libc::close(parent_fd);
93
- }
94
- assert_eq!(libc::syscall(SYS_LANDLOCK_RESTRICT_SELF, ruleset, 0), 0);
95
- libc::close(ruleset as i32);
96
- }
97
- }
98
-
99
- /// Run `sequence` through both sides until they disagree, as `differs` says of
100
- /// two answers, noting what it does.
101
- fn compare(
102
- sequence: &[Call],
103
- mut kobako: Kobako,
104
- mut linux: Linux,
105
- differs: impl Fn(&str, &str) -> bool,
106
- found: &mut BTreeMap<String, Difference>,
107
- ) {
108
- for (at, call) in sequence.iter().enumerate() {
109
- let (theirs, ours) = (linux.run(call), kobako.run(call));
110
- if differs(&ours, &theirs) {
111
- let detail = format!("kobako={ours} linux={theirs}");
112
- note(found, class(call, &ours, &theirs), &sequence[..=at], detail);
113
- return;
114
- }
115
- }
116
- }
117
-
118
- fn sequence(seed: u64, longest: u64, paths: &[String]) -> Vec<Call> {
119
- let mut rng = Rng::new(seed);
120
- let length = 1 + rng.random_below(longest);
121
- (0..length).map(|_| rng.call(paths)).collect()
122
- }
123
-
124
- #[test]
125
- #[ignore = "needs root and a mount namespace; run by rake crates:linux_baseline"]
126
- fn a_policy_answers_as_the_same_rules_under_landlock() {
127
- let _serial = SERIAL.lock().unwrap_or_else(PoisonError::into_inner);
128
- let setup = Setup::Bind;
129
- setup.prepare();
130
- let paths = setup.paths();
131
- let mut found = BTreeMap::new();
132
- for seed in 1..=15_000 {
133
- let (root, kobako_dir) = (setup.dir("linux"), setup.dir("kobako"));
134
- seed_directory(&kobako_dir);
135
- seed_directory(&root);
136
- let filesystem =
137
- Filesystem::new(Arc::new(bind(&kobako_dir))).expect("the instance must stand");
138
- let kobako = Kobako::with_policy(filesystem, Arc::new(WritesBeneathD));
139
- let linux = Linux::new(&root, false);
140
- let calls = sequence(seed, 30, &paths);
141
- let found = &mut found;
142
- thread::scope(|scope| {
143
- scope
144
- .spawn(|| {
145
- restrict_as_writes_beneath_d(&root, &kobako_dir);
146
- compare(&calls, kobako, linux, |ours, theirs| ours != theirs, found);
147
- })
148
- .join()
149
- .expect("a sequence must not panic");
150
- });
151
- }
152
- assert_named("policy", &found);
153
- }
154
-
155
- /// A tree another user meets refused in each way a mode refuses: a directory it
156
- /// may only read, search, or not reach, and files it may only read, only write,
157
- /// or not open.
158
- fn seed_permissions(dir: &str) {
159
- let mode = |path: String, mode| {
160
- fs::set_permissions(path, fs::Permissions::from_mode(mode)).expect("the mode must be set");
161
- };
162
- let _ = fs::remove_dir_all(dir);
163
- fs::create_dir_all(dir).expect("the host directory");
164
- mode(dir.to_string(), 0o777);
165
- for (name, bits) in [
166
- ("ro", 0o755),
167
- ("nox", 0o704),
168
- ("nor", 0o701),
169
- ("no", 0o700),
170
- ("w", 0o777),
171
- ] {
172
- let sub = format!("{dir}/{name}");
173
- fs::create_dir(&sub).expect("the host directory");
174
- fs::write(format!("{sub}/f"), "x").expect("the host file");
175
- mode(format!("{sub}/f"), 0o666);
176
- mode(sub, bits);
177
- }
178
- for (name, bits) in [("fro", 0o644), ("fwo", 0o602), ("fno", 0o600)] {
179
- fs::write(format!("{dir}/{name}"), "x").expect("the host file");
180
- mode(format!("{dir}/{name}"), bits);
181
- }
182
- }
183
-
184
- const PERMISSION_PATHS: [&str; 22] = [
185
- ".", "x", "ro", "ro/", "ro/f", "ro/x", "nox", "nox/", "nox/f", "nox/x", "nor", "nor/", "nor/f",
186
- "nor/x", "no", "no/", "no/f", "fro", "fwo", "fno", "w/f", "w/x",
187
- ];
188
-
189
- /// Whether one side succeeded where the other was refused. kobako has no layer
190
- /// of permissions, so which refusal answers first is the host's to reach, and two
191
- /// refusals of one call agree whatever each names.
192
- fn one_succeeded(ours: &str, theirs: &str) -> bool {
193
- let refused = |answer: &str| answer.starts_with('E');
194
- refused(ours) != refused(theirs)
195
- }
196
-
197
- #[test]
198
- #[ignore = "needs root and a mount namespace; run by rake crates:linux_baseline"]
199
- fn a_bind_refuses_another_user_as_its_host_does() {
200
- let _serial = SERIAL.lock().unwrap_or_else(PoisonError::into_inner);
201
- let setup = Setup::Bind;
202
- setup.prepare();
203
- fs::set_permissions(BASE, fs::Permissions::from_mode(0o755)).expect("the mode must be set");
204
- let paths = PERMISSION_PATHS.map(str::to_string);
205
- let mut found = BTreeMap::new();
206
- for seed in 1..=12_000 {
207
- let (root, kobako_dir) = (setup.dir("linux"), setup.dir("kobako"));
208
- seed_permissions(&kobako_dir);
209
- seed_permissions(&root);
210
- let filesystem =
211
- Filesystem::new(Arc::new(bind(&kobako_dir))).expect("the instance must stand");
212
- let calls = sequence(seed, 20, &paths);
213
- let found = &mut found;
214
- thread::scope(|scope| {
215
- scope
216
- .spawn(|| {
217
- // SAFETY: these change only this thread's credentials, as raw
218
- // syscalls do where libc's wrappers would change every thread's.
219
- unsafe {
220
- assert_eq!(
221
- libc::syscall(libc::SYS_setgroups, 0, std::ptr::null::<u32>()),
222
- 0
223
- );
224
- assert_eq!(libc::syscall(libc::SYS_setresgid, 1000, 1000, 1000), 0);
225
- assert_eq!(libc::syscall(libc::SYS_setresuid, 1000, 1000, 1000), 0);
226
- }
227
- let kobako = Kobako::new(filesystem, Access::ReadWrite, false);
228
- let linux = Linux::new(&root, false);
229
- compare(&calls, kobako, linux, one_succeeded, found);
230
- })
231
- .join()
232
- .expect("a sequence must not panic");
233
- });
234
- }
235
- assert_named("another-user", &found);
236
- }
@@ -1,200 +0,0 @@
1
- //! The guest's descriptor table: what each preview1 file descriptor
2
- //! stands for within one invocation.
3
- //!
4
- //! kobako answers every preview1 call that reads this table, so the guest
5
- //! sees one table and no call falls through to a second one that
6
- //! disagrees. Numbering follows Linux's `alloc_fd`: the lowest closed number
7
- //! is reused before a fresh one is taken.
8
-
9
- use std::collections::{BTreeMap, BTreeSet};
10
- use std::sync::Arc;
11
-
12
- use kobako_runtime::filesystem::FilesystemError;
13
- use kobako_runtime::mount::Mount;
14
- use kobako_runtime::profile::Profile;
15
- use kobako_runtime::security::{restrict_self, WalkGuard};
16
- use kobako_runtime::vfs::{Cred, File};
17
-
18
- /// What one descriptor stands for, as Linux's fd table holds a `struct file`.
19
- pub(crate) struct Descriptor {
20
- pub(crate) file: File,
21
- /// The guest path a preopen names; a Mount's own root has one.
22
- pub(crate) preopen_path: Option<String>,
23
- }
24
-
25
- impl Descriptor {
26
- /// The descriptor of `file`, naming no preopen.
27
- pub(crate) fn for_file(file: File) -> Self {
28
- Self {
29
- file,
30
- preopen_path: None,
31
- }
32
- }
33
- }
34
-
35
- pub(crate) struct Descriptors {
36
- used: BTreeMap<u32, Descriptor>,
37
- free: BTreeSet<u32>,
38
- limit: Option<usize>,
39
- /// Who the guest's calls are made for, as a task holds its `cred`.
40
- cred: Arc<Cred>,
41
- /// What a descriptor's call asks before it starts.
42
- walk_guard: WalkGuard,
43
- /// The isolation the guest runs under, which decides what it sees of
44
- /// the times a Filesystem reports.
45
- profile: Profile,
46
- }
47
-
48
- impl Descriptors {
49
- /// The table every invocation starts from: stdin, then the two
50
- /// Channels, then one preopen per Mount from descriptor 3. It holds at
51
- /// most `limit` descriptors, those included, as a process's
52
- /// `RLIMIT_NOFILE` counts every one it holds. Each Mount's root opens as
53
- /// `opener`, the Cred the Driver prepared, before its Policy applies.
54
- pub(crate) fn new(
55
- stdin: File,
56
- stdout: File,
57
- stderr: File,
58
- mounts: Vec<Mount>,
59
- limit: Option<usize>,
60
- opener: Arc<Cred>,
61
- profile: Profile,
62
- ) -> Result<Self, FilesystemError> {
63
- let mut used = BTreeMap::from([
64
- (0, Descriptor::for_file(stdin)),
65
- (1, Descriptor::for_file(stdout)),
66
- (2, Descriptor::for_file(stderr)),
67
- ]);
68
- // Each Mount's root opens before its Policy applies, as a Linux task
69
- // opens what it keeps and then calls `landlock_restrict_self`, so a
70
- // Policy judges only what the guest asks for.
71
- for (fd, mount) in (3..).zip(&mounts) {
72
- used.insert(
73
- fd,
74
- Descriptor {
75
- file: File::root(mount.mnt(), &opener)?,
76
- preopen_path: Some(mount.at().to_string()),
77
- },
78
- );
79
- }
80
- let cred = restrict_self(&opener, &mounts);
81
- let walk_guard = WalkGuard::new(&mounts);
82
- Ok(Self {
83
- used,
84
- free: BTreeSet::new(),
85
- limit,
86
- cred,
87
- walk_guard,
88
- profile,
89
- })
90
- }
91
-
92
- /// Who the guest's calls are made for.
93
- pub(crate) fn cred(&self) -> &Arc<Cred> {
94
- &self.cred
95
- }
96
-
97
- /// What every call through a descriptor asks first, so a Policy judges the
98
- /// path it stands at.
99
- pub(crate) fn walk_guard(&self) -> &WalkGuard {
100
- &self.walk_guard
101
- }
102
-
103
- /// The isolation the guest runs under.
104
- pub(crate) fn profile(&self) -> Profile {
105
- self.profile
106
- }
107
-
108
- pub(crate) fn get(&self, fd: u32) -> Option<&Descriptor> {
109
- self.used.get(&fd)
110
- }
111
-
112
- pub(crate) fn get_mut(&mut self, fd: u32) -> Option<&mut Descriptor> {
113
- self.used.get_mut(&fd)
114
- }
115
-
116
- /// Take `fd` out of the table, freeing its number for reuse.
117
- pub(crate) fn remove(&mut self, fd: u32) -> Option<Descriptor> {
118
- let descriptor = self.used.remove(&fd)?;
119
- self.free.insert(fd);
120
- Some(descriptor)
121
- }
122
-
123
- /// Place `descriptor` at `fd`, a number the caller has just freed or
124
- /// `lowest_unused` found, as Linux's `fd_install` does.
125
- pub(crate) fn place(&mut self, fd: u32, descriptor: Descriptor) {
126
- self.free.remove(&fd);
127
- self.used.insert(fd, descriptor);
128
- }
129
-
130
- /// The number the next descriptor takes, the lowest freed one or the one
131
- /// past the highest in use, as Linux's `get_unused_fd_flags` finds it;
132
- /// `None` when the table holds as many as it may. Nothing is placed
133
- /// until `place`, as `fd_install` fills what was found.
134
- pub(crate) fn lowest_unused(&self) -> Option<u32> {
135
- if self.limit.is_some_and(|limit| self.used.len() >= limit) {
136
- return None;
137
- }
138
- match self.free.first() {
139
- Some(fd) => Some(*fd),
140
- None => match self.used.last_key_value() {
141
- Some((last, _)) => last.checked_add(1),
142
- None => Some(0),
143
- },
144
- }
145
- }
146
-
147
- /// Add `descriptor` under the number `lowest_unused` finds; `None` when
148
- /// the table is full.
149
- #[cfg(test)]
150
- pub(crate) fn push(&mut self, descriptor: Descriptor) -> Option<u32> {
151
- let fd = self.lowest_unused()?;
152
- self.place(fd, descriptor);
153
- Some(fd)
154
- }
155
- }
156
-
157
- #[cfg(test)]
158
- mod tests {
159
- use super::*;
160
- use kobako_runtime::filesystem::{create_pipe_files, PipeInodeInfo};
161
- use kobako_runtime::security::prepare_creds_within;
162
-
163
- fn pipe_end() -> File {
164
- create_pipe_files(&PipeInodeInfo::new(1), &prepare_creds_within(&[], None)).1
165
- }
166
-
167
- // @behavior RT-189
168
- #[test]
169
- fn a_new_descriptor_takes_the_lowest_closed_number() {
170
- let mut table = Descriptors::new(
171
- pipe_end(),
172
- pipe_end(),
173
- pipe_end(),
174
- Vec::new(),
175
- None,
176
- prepare_creds_within(&[], None),
177
- Profile::Hermetic,
178
- )
179
- .unwrap_or_else(|_| panic!("a table holding no Mount must make"));
180
- let mut open = || {
181
- table
182
- .push(Descriptor::for_file(pipe_end()))
183
- .expect("a table with no limit takes every descriptor")
184
- };
185
- let numbers = [open(), open(), open()];
186
- assert_eq!(numbers, [3, 4, 5], "descriptors must number from 3");
187
- table.remove(3);
188
- table.remove(4);
189
- assert_eq!(
190
- (
191
- table.push(Descriptor::for_file(pipe_end())),
192
- table.push(Descriptor::for_file(pipe_end())),
193
- table.push(Descriptor::for_file(pipe_end())),
194
- ),
195
- (Some(3), Some(4), Some(6)),
196
- "path_open's descriptors must take the lowest closed number first, as Linux's alloc_fd \
197
- does, and then the one past the highest"
198
- );
199
- }
200
- }
@@ -1,43 +0,0 @@
1
- //! A compile reads no host time or entropy, whatever posture the Sandbox
2
- //! requested. Compiling runs no script, so the bundled guest has no way to
3
- //! show what its clock read; a fixture guest whose compile answers the
4
- //! ambient bytes it read shows it instead.
5
-
6
- use std::path::Path;
7
-
8
- use kobako_runtime::{Profile, Runtime};
9
- use kobako_transport::envelope::{Preamble, Snippet, Snippets};
10
- use kobako_wasmtime::{Config, Driver};
11
-
12
- const FIXTURE: &str = concat!(
13
- env!("CARGO_MANIFEST_DIR"),
14
- "/../../test/fixtures/minimal_compile_ambient.wat"
15
- );
16
-
17
- // @behavior RT-072
18
- #[test]
19
- fn a_compile_reads_no_host_time_or_entropy_under_a_permissive_request() {
20
- let mut config = Config::default();
21
- config.timeout = None;
22
- config.setup_timeout = None;
23
- config.memory_limit = None;
24
- config.stdout_limit = None;
25
- config.stderr_limit = None;
26
- config.open_file_limit = None;
27
- config.profile = Profile::Permissive;
28
- let driver = Driver::new(Path::new(FIXTURE), config).expect("the fixture guest must load");
29
- let mut preamble = Preamble::default();
30
- preamble.snippets = Snippets {
31
- entries: vec![Snippet::Source {
32
- name: "Only".into(),
33
- body: "1".into(),
34
- }],
35
- };
36
-
37
- assert_eq!(
38
- driver.compile(&preamble),
39
- Some(vec![vec![0; 16]]),
40
- "a permissive request through Driver#compile must read the Unix epoch and the \
41
- constant stream, not host time and entropy"
42
- );
43
- }