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,17 +1,16 @@
1
- //! Who a call is made for, as Linux's `struct cred`, and the hooks a security
2
- //! module answers, as `security_*` call each registered LSM. The VFS asks them
3
- //! where Linux does and knows nothing of what they decide.
1
+ //! The hooks a security module answers, as Linux's `lsm_hook_defs.h` lists
2
+ //! them, and the `security_*` calls that ask each module a caller's Cred
3
+ //! registers, as `security/security.c` does. The VFS and the socket layer ask
4
+ //! them where Linux does and know nothing of what they decide.
4
5
 
5
6
  use std::any::Any;
6
- use std::sync::atomic::{AtomicUsize, Ordering};
7
+ use std::net::SocketAddr;
7
8
  use std::sync::Arc;
8
9
 
9
- use super::dentry::Dentry;
10
- use super::file::FMode;
11
- use super::inode::Mask;
12
- use super::mount::VfsMount;
13
- use super::openat2::OpenHow;
14
- use super::{FileType, FilesystemError};
10
+ use crate::cred::Cred;
11
+ use crate::network::Connection;
12
+ use crate::vfs::{Dentry, FMode, FileType, Mask, OpenHow, VfsMount};
13
+ use crate::Errno;
15
14
 
16
15
  /// What one security module keeps on an open file, as Linux's `f_security`
17
16
  /// blob holds each module's part; `None` where it keeps nothing.
@@ -46,41 +45,37 @@ pub(crate) fn on_path<T>(
46
45
  pub trait SecurityOperations: Send + Sync {
47
46
  /// Whether a call may do what `mask` asks of what `dentry` names, as
48
47
  /// `security_inode_permission` is asked once the entry itself allowed it.
49
- fn inode_permission(&self, _dentry: &Dentry, _mask: Mask) -> Result<(), FilesystemError> {
48
+ fn inode_permission(&self, _dentry: &Dentry, _mask: Mask) -> Result<(), Errno> {
50
49
  Ok(())
51
50
  }
52
51
 
53
52
  /// Whether a file may be made at `path`, as `security_path_mknod`.
54
- fn path_mknod(&self, _path: SecurityPath<'_>) -> Result<(), FilesystemError> {
53
+ fn path_mknod(&self, _path: SecurityPath<'_>) -> Result<(), Errno> {
55
54
  Ok(())
56
55
  }
57
56
 
58
57
  /// Whether a directory may be made at `path`, as `security_path_mkdir`.
59
- fn path_mkdir(&self, _path: SecurityPath<'_>) -> Result<(), FilesystemError> {
58
+ fn path_mkdir(&self, _path: SecurityPath<'_>) -> Result<(), Errno> {
60
59
  Ok(())
61
60
  }
62
61
 
63
62
  /// Whether the directory at `path` may go, as `security_path_rmdir`.
64
- fn path_rmdir(&self, _path: SecurityPath<'_>) -> Result<(), FilesystemError> {
63
+ fn path_rmdir(&self, _path: SecurityPath<'_>) -> Result<(), Errno> {
65
64
  Ok(())
66
65
  }
67
66
 
68
67
  /// Whether the file at `path` may go, as `security_path_unlink`.
69
- fn path_unlink(&self, _path: SecurityPath<'_>) -> Result<(), FilesystemError> {
68
+ fn path_unlink(&self, _path: SecurityPath<'_>) -> Result<(), Errno> {
70
69
  Ok(())
71
70
  }
72
71
 
73
72
  /// Whether a link may be made at `path`, as `security_path_symlink`.
74
- fn path_symlink(&self, _path: SecurityPath<'_>) -> Result<(), FilesystemError> {
73
+ fn path_symlink(&self, _path: SecurityPath<'_>) -> Result<(), Errno> {
75
74
  Ok(())
76
75
  }
77
76
 
78
77
  /// Whether what `old` names may also go by `new`, as `security_path_link`.
79
- fn path_link(
80
- &self,
81
- _old: SecurityPath<'_>,
82
- _new: SecurityPath<'_>,
83
- ) -> Result<(), FilesystemError> {
78
+ fn path_link(&self, _old: SecurityPath<'_>, _new: SecurityPath<'_>) -> Result<(), Errno> {
84
79
  Ok(())
85
80
  }
86
81
 
@@ -91,7 +86,7 @@ pub trait SecurityOperations: Send + Sync {
91
86
  _old: SecurityPath<'_>,
92
87
  _new: SecurityPath<'_>,
93
88
  _dentries: (&Arc<Dentry>, &Arc<Dentry>),
94
- ) -> Result<(), FilesystemError> {
89
+ ) -> Result<(), Errno> {
95
90
  Ok(())
96
91
  }
97
92
 
@@ -103,103 +98,53 @@ pub trait SecurityOperations: Send + Sync {
103
98
  fn file_open(
104
99
  &self,
105
100
  _path: SecurityPath<'_>,
106
- _kind: FileType,
101
+ _file_type: FileType,
107
102
  _mode: FMode,
108
103
  _how: &OpenHow,
109
- ) -> Result<FileSecurity, FilesystemError> {
104
+ ) -> Result<FileSecurity, Errno> {
110
105
  Ok(None)
111
106
  }
112
107
 
113
108
  /// Whether the open file may be truncated, judged from what this module kept
114
109
  /// on it as it opened, as Landlock's `hook_file_truncate` reads the file's
115
110
  /// blob.
116
- fn file_truncate(&self, _kept: &FileSecurity) -> Result<(), FilesystemError> {
111
+ fn file_truncate(&self, _kept: &FileSecurity) -> Result<(), Errno> {
117
112
  Ok(())
118
113
  }
119
114
 
120
115
  /// Whether times may be set on the entry at `path`. Linux has no path hook
121
116
  /// for times, so this is kobako's own, beside `path_truncate` and
122
117
  /// `path_chmod` in kind, letting a module judge the path a call names.
123
- fn path_utimes(&self, _path: SecurityPath<'_>) -> Result<(), FilesystemError> {
118
+ fn path_utimes(&self, _path: SecurityPath<'_>) -> Result<(), Errno> {
124
119
  Ok(())
125
120
  }
126
121
 
127
122
  /// Whether where the link `dentry` names points may be read, as
128
123
  /// `security_inode_readlink` is handed the link.
129
- fn inode_readlink(&self, _dentry: &Dentry) -> Result<(), FilesystemError> {
124
+ fn inode_readlink(&self, _dentry: &Dentry) -> Result<(), Errno> {
130
125
  Ok(())
131
126
  }
132
- }
133
127
 
134
- /// How many bytes Filesystems hold on one caller's behalf between calls, and the
135
- /// most they may, as Linux's `__vm_enough_memory` weighs what `vm_committed_as`
136
- /// counts against its limit, so a guest's descriptors cannot multiply a directory
137
- /// past what it was allotted.
138
- pub(crate) struct VmCommitted {
139
- limit: usize,
140
- used: AtomicUsize,
141
- }
142
-
143
- impl VmCommitted {
144
- pub(crate) fn new(limit: usize) -> Arc<Self> {
145
- Arc::new(Self {
146
- limit,
147
- used: AtomicUsize::new(0),
148
- })
128
+ /// Whether a socket may connect where `connection` names, judged on what
129
+ /// the guest named, as `security_socket_connect`.
130
+ fn socket_connect(&self, _connection: &Connection<'_>) -> Result<(), Errno> {
131
+ Ok(())
149
132
  }
150
- }
151
133
 
152
- /// Who a call is made for, holding the security modules registered for it, as
153
- /// `cred->security` holds a Landlock domain, and the memory held on its behalf,
154
- /// which every Cred restricted from it shares, as a task's memory cgroup does.
155
- pub struct Cred {
156
- security: Vec<Arc<dyn SecurityOperations>>,
157
- committed: Option<Arc<VmCommitted>>,
158
- }
159
-
160
- /// One no module is registered for, which this crate's tests make calls as.
161
- #[cfg(test)]
162
- impl Default for Cred {
163
- fn default() -> Self {
164
- Self {
165
- security: Vec::new(),
166
- committed: None,
167
- }
134
+ /// Whether a socket may bind `address`, as `security_socket_bind`.
135
+ fn socket_bind(&self, _address: SocketAddr) -> Result<(), Errno> {
136
+ Ok(())
168
137
  }
169
138
  }
170
139
 
140
+ /// The `security_*` calls, each asking the modules `self` registers.
171
141
  impl Cred {
172
- /// One with `security` registered.
173
- pub(crate) fn new(security: Vec<Arc<dyn SecurityOperations>>) -> Arc<Self> {
174
- Self::within(security, None)
175
- }
176
-
177
- /// One with `security` registered and the memory held on its behalf counted
178
- /// in `committed`, without bound where none.
179
- pub(crate) fn within(
180
- security: Vec<Arc<dyn SecurityOperations>>,
181
- committed: Option<Arc<VmCommitted>>,
182
- ) -> Arc<Self> {
183
- Arc::new(Self {
184
- security,
185
- committed,
186
- })
187
- }
188
-
189
- /// This Cred with `more` modules registered after its own, sharing the
190
- /// memory held on its behalf, as `landlock_restrict_self` adds a domain.
191
- pub(crate) fn with_modules(&self, more: Vec<Arc<dyn SecurityOperations>>) -> Arc<Self> {
192
- let mut security = self.security.clone();
193
- security.extend(more);
194
- Self::within(security, self.committed.clone())
195
- }
196
-
197
142
  /// Ask each module in turn, the first refusal answering, as `call_int_hook`.
198
143
  fn call_int_hook(
199
144
  &self,
200
- hook: impl Fn(&dyn SecurityOperations) -> Result<(), FilesystemError>,
201
- ) -> Result<(), FilesystemError> {
202
- self.security
145
+ hook: impl Fn(&dyn SecurityOperations) -> Result<(), Errno>,
146
+ ) -> Result<(), Errno> {
147
+ self.modules()
203
148
  .iter()
204
149
  .try_for_each(|module| hook(module.as_ref()))
205
150
  }
@@ -208,42 +153,27 @@ impl Cred {
208
153
  &self,
209
154
  dentry: &Dentry,
210
155
  mask: Mask,
211
- ) -> Result<(), FilesystemError> {
156
+ ) -> Result<(), Errno> {
212
157
  self.call_int_hook(|module| module.inode_permission(dentry, mask))
213
158
  }
214
159
 
215
- pub(crate) fn security_path_mknod(
216
- &self,
217
- path: SecurityPath<'_>,
218
- ) -> Result<(), FilesystemError> {
160
+ pub(crate) fn security_path_mknod(&self, path: SecurityPath<'_>) -> Result<(), Errno> {
219
161
  self.call_int_hook(|module| module.path_mknod(path))
220
162
  }
221
163
 
222
- pub(crate) fn security_path_mkdir(
223
- &self,
224
- path: SecurityPath<'_>,
225
- ) -> Result<(), FilesystemError> {
164
+ pub(crate) fn security_path_mkdir(&self, path: SecurityPath<'_>) -> Result<(), Errno> {
226
165
  self.call_int_hook(|module| module.path_mkdir(path))
227
166
  }
228
167
 
229
- pub(crate) fn security_path_rmdir(
230
- &self,
231
- path: SecurityPath<'_>,
232
- ) -> Result<(), FilesystemError> {
168
+ pub(crate) fn security_path_rmdir(&self, path: SecurityPath<'_>) -> Result<(), Errno> {
233
169
  self.call_int_hook(|module| module.path_rmdir(path))
234
170
  }
235
171
 
236
- pub(crate) fn security_path_unlink(
237
- &self,
238
- path: SecurityPath<'_>,
239
- ) -> Result<(), FilesystemError> {
172
+ pub(crate) fn security_path_unlink(&self, path: SecurityPath<'_>) -> Result<(), Errno> {
240
173
  self.call_int_hook(|module| module.path_unlink(path))
241
174
  }
242
175
 
243
- pub(crate) fn security_path_symlink(
244
- &self,
245
- path: SecurityPath<'_>,
246
- ) -> Result<(), FilesystemError> {
176
+ pub(crate) fn security_path_symlink(&self, path: SecurityPath<'_>) -> Result<(), Errno> {
247
177
  self.call_int_hook(|module| module.path_symlink(path))
248
178
  }
249
179
 
@@ -251,7 +181,7 @@ impl Cred {
251
181
  &self,
252
182
  old: SecurityPath<'_>,
253
183
  new: SecurityPath<'_>,
254
- ) -> Result<(), FilesystemError> {
184
+ ) -> Result<(), Errno> {
255
185
  self.call_int_hook(|module| module.path_link(old, new))
256
186
  }
257
187
 
@@ -260,14 +190,14 @@ impl Cred {
260
190
  old: SecurityPath<'_>,
261
191
  new: SecurityPath<'_>,
262
192
  dentries: (&Arc<Dentry>, &Arc<Dentry>),
263
- ) -> Result<(), FilesystemError> {
193
+ ) -> Result<(), Errno> {
264
194
  self.call_int_hook(|module| module.path_rename(old, new, dentries))
265
195
  }
266
196
 
267
197
  /// A file's room for what each module keeps on it, empty until an open
268
198
  /// fills it, as `security_file_alloc` gives every file one blob per module.
269
199
  pub(crate) fn security_file_alloc(&self) -> Vec<FileSecurity> {
270
- vec![None; self.security.len()]
200
+ vec![None; self.modules().len()]
271
201
  }
272
202
 
273
203
  /// Ask each module about the open, keeping what each keeps on the file in
@@ -278,8 +208,8 @@ impl Cred {
278
208
  kind: FileType,
279
209
  mode: FMode,
280
210
  how: &OpenHow,
281
- ) -> Result<Vec<FileSecurity>, FilesystemError> {
282
- self.security
211
+ ) -> Result<Vec<FileSecurity>, Errno> {
212
+ self.modules()
283
213
  .iter()
284
214
  .map(|module| module.file_open(path, kind, mode, how))
285
215
  .collect()
@@ -287,48 +217,26 @@ impl Cred {
287
217
 
288
218
  /// Ask each module whether the file may be truncated, handing each what it
289
219
  /// kept on the file as it opened.
290
- pub(crate) fn security_file_truncate(
291
- &self,
292
- kept: &[FileSecurity],
293
- ) -> Result<(), FilesystemError> {
294
- self.security
220
+ pub(crate) fn security_file_truncate(&self, kept: &[FileSecurity]) -> Result<(), Errno> {
221
+ self.modules()
295
222
  .iter()
296
223
  .zip(kept)
297
224
  .try_for_each(|(module, kept)| module.file_truncate(kept))
298
225
  }
299
226
 
300
- pub(crate) fn security_path_utimes(
301
- &self,
302
- path: SecurityPath<'_>,
303
- ) -> Result<(), FilesystemError> {
227
+ pub(crate) fn security_path_utimes(&self, path: SecurityPath<'_>) -> Result<(), Errno> {
304
228
  self.call_int_hook(|module| module.path_utimes(path))
305
229
  }
306
230
 
307
- pub(crate) fn security_inode_readlink(&self, dentry: &Dentry) -> Result<(), FilesystemError> {
231
+ pub(crate) fn security_inode_readlink(&self, dentry: &Dentry) -> Result<(), Errno> {
308
232
  self.call_int_hook(|module| module.inode_readlink(dentry))
309
233
  }
310
234
 
311
- /// Count `bytes` more held on this caller's behalf, refusing them past its
312
- /// limit, as `security_vm_enough_memory_mm` ends in `__vm_enough_memory`.
313
- pub(crate) fn security_vm_enough_memory(&self, bytes: usize) -> Result<(), FilesystemError> {
314
- let Some(committed) = &self.committed else {
315
- return Ok(());
316
- };
317
- committed
318
- .used
319
- .fetch_update(Ordering::Relaxed, Ordering::Relaxed, |used| {
320
- used.checked_add(bytes)
321
- .filter(|&total| total <= committed.limit)
322
- })
323
- .map(|_| ())
324
- .map_err(|_| FilesystemError::OutOfMemory)
235
+ pub(crate) fn security_socket_connect(&self, connection: &Connection<'_>) -> Result<(), Errno> {
236
+ self.call_int_hook(|module| module.socket_connect(connection))
325
237
  }
326
238
 
327
- /// `bytes` counted earlier are held no more, as `vm_unacct_memory` gives
328
- /// them back.
329
- pub(crate) fn vm_unacct_memory(&self, bytes: usize) {
330
- if let Some(committed) = &self.committed {
331
- committed.used.fetch_sub(bytes, Ordering::Relaxed);
332
- }
239
+ pub(crate) fn security_socket_bind(&self, address: SocketAddr) -> Result<(), Errno> {
240
+ self.call_int_hook(|module| module.socket_bind(address))
333
241
  }
334
242
  }
@@ -0,0 +1,158 @@
1
+ //! A Mount's Policy as a security module, answering the path hooks for that
2
+ //! Mount alone, as Landlock's `fs.c` answers the filesystem rights of its
3
+ //! domain.
4
+
5
+ use std::sync::Arc;
6
+
7
+ use super::{FileSecurity, SecurityOperations, SecurityPath};
8
+ use crate::mount::{Access, Mount, MountRequest};
9
+ use crate::policy::Policy;
10
+ use crate::vfs::{Dentry, FMode, FileType, OpenHow, VfsMount, PATH_MAX};
11
+ use crate::Errno;
12
+
13
+ /// What a Mount's Policy allowed a file as it opened, kept on the open file, as
14
+ /// Landlock's file blob keeps `allowed_access`.
15
+ struct AllowedAccess(Access);
16
+
17
+ /// A Mount's Policy, answering only for that Mount.
18
+ pub(super) struct MountPolicy {
19
+ mnt: Arc<VfsMount>,
20
+ at: String,
21
+ policy: Arc<dyn for<'a> Policy<MountRequest<'a>>>,
22
+ }
23
+
24
+ impl MountPolicy {
25
+ /// `mount`'s Policy, when it has one.
26
+ pub(super) fn of(mount: &Mount) -> Option<Self> {
27
+ Some(Self {
28
+ mnt: mount.mnt().clone(),
29
+ at: mount.at().to_string(),
30
+ policy: mount.policy()?.clone(),
31
+ })
32
+ }
33
+
34
+ fn guards(&self, mnt: &Arc<VfsMount>) -> bool {
35
+ Arc::ptr_eq(&self.mnt, mnt)
36
+ }
37
+
38
+ /// The absolute guest path `path`, from the Mount's root, stands for.
39
+ fn guest_path(&self, path: &str) -> String {
40
+ match (self.at.as_str(), path) {
41
+ (at, "/") => at.to_string(),
42
+ ("/", path) => path.to_string(),
43
+ (at, path) => format!("{at}{path}"),
44
+ }
45
+ }
46
+
47
+ /// Judge `path` as AppArmor's `aa_path_perm` judges a whole path once, each
48
+ /// hook below reaching it as AppArmor's do. The Policy judges the path as the
49
+ /// Filesystem stores its names, so a host folding case or Unicode form cannot
50
+ /// hand it one spelling of an entry it refuses by another. One a Policy could
51
+ /// not be handed within `PATH_MAX` is refused as too long, as AppArmor's
52
+ /// `aa_path_name` refuses one past its buffer.
53
+ fn path_perm(&self, path: SecurityPath<'_>, access: Access) -> Result<(), Errno> {
54
+ if !self.guards(path.mnt) {
55
+ return Ok(());
56
+ }
57
+ let path = self.guest_path(&(path.name)());
58
+ if path.len() >= PATH_MAX {
59
+ return Err(Errno::InvalidFilename);
60
+ }
61
+ match self.policy.allows(&MountRequest {
62
+ path: &path,
63
+ access,
64
+ }) {
65
+ true => Ok(()),
66
+ false => Err(Errno::PermissionDenied),
67
+ }
68
+ }
69
+ }
70
+
71
+ impl SecurityOperations for MountPolicy {
72
+ fn path_mknod(&self, path: SecurityPath<'_>) -> Result<(), Errno> {
73
+ self.path_perm(path, Access::ReadWrite)
74
+ }
75
+
76
+ fn path_mkdir(&self, path: SecurityPath<'_>) -> Result<(), Errno> {
77
+ self.path_perm(path, Access::ReadWrite)
78
+ }
79
+
80
+ fn path_rmdir(&self, path: SecurityPath<'_>) -> Result<(), Errno> {
81
+ self.path_perm(path, Access::ReadWrite)
82
+ }
83
+
84
+ fn path_unlink(&self, path: SecurityPath<'_>) -> Result<(), Errno> {
85
+ self.path_perm(path, Access::ReadWrite)
86
+ }
87
+
88
+ fn path_symlink(&self, path: SecurityPath<'_>) -> Result<(), Errno> {
89
+ self.path_perm(path, Access::ReadWrite)
90
+ }
91
+
92
+ fn path_link(&self, old: SecurityPath<'_>, new: SecurityPath<'_>) -> Result<(), Errno> {
93
+ self.path_perm(old, Access::ReadWrite)?;
94
+ self.path_perm(new, Access::ReadWrite)
95
+ }
96
+
97
+ /// Asked once for each open, for what the open may change, and kept on the
98
+ /// file, as Landlock keeps the rights it allowed. A file the open made was
99
+ /// judged as a change already, through `path_mknod`.
100
+ fn file_open(
101
+ &self,
102
+ path: SecurityPath<'_>,
103
+ _kind: FileType,
104
+ mode: FMode,
105
+ how: &OpenHow,
106
+ ) -> Result<FileSecurity, Errno> {
107
+ if !self.guards(path.mnt) {
108
+ return Ok(None);
109
+ }
110
+ let created = mode.contains(FMode::CREATED);
111
+ let access = match created || mode.contains(FMode::WRITE) || how.truncate {
112
+ true => Access::ReadWrite,
113
+ false => Access::Read,
114
+ };
115
+ if !created {
116
+ self.path_perm(path, access)?;
117
+ }
118
+ Ok(Some(Arc::new(AllowedAccess(access))))
119
+ }
120
+
121
+ /// A truncate follows what the Policy allowed as the file opened, wherever
122
+ /// the file stands now, as Landlock's `hook_file_truncate` reads the file's
123
+ /// rights.
124
+ fn file_truncate(&self, kept: &FileSecurity) -> Result<(), Errno> {
125
+ match kept
126
+ .as_deref()
127
+ .and_then(|kept| kept.downcast_ref::<AllowedAccess>())
128
+ {
129
+ Some(AllowedAccess(Access::Read)) => Err(Errno::PermissionDenied),
130
+ _ => Ok(()),
131
+ }
132
+ }
133
+
134
+ fn path_utimes(&self, path: SecurityPath<'_>) -> Result<(), Errno> {
135
+ self.path_perm(path, Access::ReadWrite)
136
+ }
137
+
138
+ /// Both paths are judged. Everything beneath a directory would take paths the
139
+ /// Policy never judged, and a Policy answers for one path, not a tree, so its
140
+ /// move is refused as one across devices and the guest copies entry by entry
141
+ /// instead, as Landlock answers a move it cannot show keeps each right beneath.
142
+ /// A move onto its own name takes no new path.
143
+ fn path_rename(
144
+ &self,
145
+ old: SecurityPath<'_>,
146
+ new: SecurityPath<'_>,
147
+ (old_dentry, new_dentry): (&Arc<Dentry>, &Arc<Dentry>),
148
+ ) -> Result<(), Errno> {
149
+ self.path_perm(old, Access::ReadWrite)?;
150
+ self.path_perm(new, Access::ReadWrite)?;
151
+ let moves_dir =
152
+ old_dentry.file_type() == Ok(FileType::Dir) && !Arc::ptr_eq(old_dentry, new_dentry);
153
+ match moves_dir && self.guards(old.mnt) {
154
+ true => Err(Errno::CrossesDevices),
155
+ false => Ok(()),
156
+ }
157
+ }
158
+ }