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.
- checksums.yaml +4 -4
- data/.release-please-manifest.json +1 -1
- data/CHANGELOG.md +335 -0
- data/Cargo.lock +469 -11
- data/README.md +43 -3
- data/ROADMAP.md +1 -1
- data/crates/kobako-runtime/CHANGELOG.md +219 -0
- data/crates/kobako-runtime/Cargo.toml +51 -3
- data/crates/kobako-runtime/README.md +7 -4
- data/crates/kobako-runtime/src/cred.rs +124 -0
- data/crates/kobako-runtime/src/dispatch.rs +4 -5
- data/crates/kobako-runtime/src/endpoint/buffer.rs +153 -44
- data/crates/kobako-runtime/src/endpoint/dispatch.rs +80 -41
- data/crates/kobako-runtime/src/endpoint/invoke.rs +23 -36
- data/crates/kobako-runtime/src/endpoint.rs +137 -36
- data/crates/kobako-runtime/src/errno.rs +391 -0
- data/crates/kobako-runtime/src/error.rs +31 -10
- data/crates/kobako-runtime/src/filesystem/anon_inodes.rs +52 -0
- data/crates/kobako-runtime/src/filesystem/bind/lookup.rs +52 -14
- data/crates/kobako-runtime/src/filesystem/bind/walk.rs +19 -20
- data/crates/kobako-runtime/src/filesystem/bind.rs +437 -245
- data/crates/kobako-runtime/src/filesystem/overlay/file.rs +6 -6
- data/crates/kobako-runtime/src/filesystem/overlay/path.rs +43 -65
- data/crates/kobako-runtime/src/filesystem/overlay/stack/copy_up.rs +9 -16
- data/crates/kobako-runtime/src/filesystem/overlay/stack/dir.rs +47 -72
- data/crates/kobako-runtime/src/filesystem/overlay/stack/namei.rs +12 -12
- data/crates/kobako-runtime/src/filesystem/overlay/stack/readdir.rs +4 -7
- data/crates/kobako-runtime/src/filesystem/overlay/stack.rs +121 -37
- data/crates/kobako-runtime/src/filesystem/overlay.rs +302 -343
- data/crates/kobako-runtime/src/filesystem/pipe.rs +12 -9
- data/crates/kobako-runtime/src/filesystem/rdir.rs +15 -32
- data/crates/kobako-runtime/src/filesystem/tmpfs/seed.rs +32 -0
- data/crates/kobako-runtime/src/filesystem/tmpfs/tmpfile.rs +3 -3
- data/crates/kobako-runtime/src/filesystem/tmpfs/whiteout.rs +57 -35
- data/crates/kobako-runtime/src/filesystem/tmpfs/xattr.rs +2 -2
- data/crates/kobako-runtime/src/filesystem/tmpfs.rs +172 -160
- data/crates/kobako-runtime/src/filesystem/wrap.rs +36 -52
- data/crates/kobako-runtime/src/filesystem.rs +6 -3
- data/crates/kobako-runtime/src/fork.rs +96 -0
- data/crates/kobako-runtime/src/grant.rs +3 -0
- data/crates/kobako-runtime/src/hashtable.rs +4 -2
- data/crates/kobako-runtime/src/lib.rs +18 -7
- data/crates/kobako-runtime/src/limits.rs +195 -0
- data/crates/kobako-runtime/src/locking.rs +10 -0
- data/crates/kobako-runtime/src/memcg.rs +383 -0
- data/crates/kobako-runtime/src/mount.rs +67 -9
- data/crates/kobako-runtime/src/net/backends.rs +43 -0
- data/crates/kobako-runtime/src/net/connections.rs +179 -0
- data/crates/kobako-runtime/src/net/credential.rs +125 -0
- data/crates/kobako-runtime/src/net/egress.rs +160 -0
- data/crates/kobako-runtime/src/net/family.rs +181 -0
- data/crates/kobako-runtime/src/net/http.rs +2733 -0
- data/crates/kobako-runtime/src/net/lookup.rs +285 -0
- data/crates/kobako-runtime/src/net/mock.rs +251 -0
- data/crates/kobako-runtime/src/net/namespace.rs +1366 -0
- data/crates/kobako-runtime/src/net/reactor.rs +531 -0
- data/crates/kobako-runtime/src/net/resolv/darwin.rs +275 -0
- data/crates/kobako-runtime/src/net/resolv/stub/tests.rs +469 -0
- data/crates/kobako-runtime/src/net/resolv/stub.rs +536 -0
- data/crates/kobako-runtime/src/net/resolv/windows.rs +248 -0
- data/crates/kobako-runtime/src/net/resolv.rs +227 -0
- data/crates/kobako-runtime/src/net/socket.rs +870 -0
- data/crates/kobako-runtime/src/net/tcp.rs +1588 -0
- data/crates/kobako-runtime/src/net/tls.rs +58 -0
- data/crates/kobako-runtime/src/net/transport.rs +279 -0
- data/crates/kobako-runtime/src/net/udp.rs +1003 -0
- data/crates/kobako-runtime/src/net.rs +42 -0
- data/crates/kobako-runtime/src/network/builder.rs +177 -0
- data/crates/kobako-runtime/src/network/ruleset.rs +777 -0
- data/crates/kobako-runtime/src/network.rs +551 -0
- data/crates/kobako-runtime/src/policy.rs +16 -0
- data/crates/kobako-runtime/src/profile.rs +29 -144
- data/crates/kobako-runtime/src/runtime.rs +3 -5
- data/crates/kobako-runtime/src/sched.rs +130 -29
- data/crates/kobako-runtime/src/security/entry_policy.rs +22 -0
- data/crates/kobako-runtime/src/{vfs/cred.rs → security/hooks.rs} +52 -144
- data/crates/kobako-runtime/src/security/mount_policy.rs +158 -0
- data/crates/kobako-runtime/src/security.rs +101 -196
- data/crates/kobako-runtime/src/snapshot.rs +121 -2
- data/crates/kobako-runtime/src/vfs/attr.rs +5 -5
- data/crates/kobako-runtime/src/vfs/dentry.rs +143 -89
- data/crates/kobako-runtime/src/vfs/file.rs +199 -203
- data/crates/kobako-runtime/src/vfs/inode.rs +41 -45
- data/crates/kobako-runtime/src/vfs/kern_path.rs +38 -42
- data/crates/kobako-runtime/src/vfs/mount.rs +10 -9
- data/crates/kobako-runtime/src/vfs/namei.rs +829 -700
- data/crates/kobako-runtime/src/vfs/namespace.rs +162 -0
- data/crates/kobako-runtime/src/vfs/open_files.rs +69 -0
- data/crates/kobako-runtime/src/vfs/openat2.rs +3 -3
- data/crates/kobako-runtime/src/vfs/path.rs +6 -6
- data/crates/kobako-runtime/src/vfs/readdir.rs +6 -6
- data/crates/kobako-runtime/src/vfs/stat.rs +159 -23
- data/crates/kobako-runtime/src/vfs/super_block.rs +18 -14
- data/crates/kobako-runtime/src/vfs/utimes.rs +37 -27
- data/crates/kobako-runtime/src/vfs.rs +9 -6
- data/crates/kobako-runtime/src/wait.rs +356 -0
- data/crates/kobako-transport/CHANGELOG.md +31 -0
- data/crates/kobako-transport/Cargo.toml +1 -1
- data/crates/kobako-transport/README.md +3 -4
- data/crates/kobako-transport/src/abi.rs +78 -72
- data/crates/kobako-transport/src/envelope/bytes.rs +17 -6
- data/crates/kobako-transport/src/envelope/call.rs +32 -4
- data/crates/kobako-transport/src/envelope/error_record.rs +21 -0
- data/crates/kobako-transport/src/envelope/name.rs +99 -0
- data/crates/kobako-transport/src/envelope/outcome.rs +9 -9
- data/crates/kobako-transport/src/envelope/preamble.rs +24 -21
- data/crates/kobako-transport/src/envelope/reply.rs +27 -27
- data/crates/kobako-transport/src/envelope/unsupported.rs +10 -10
- data/crates/kobako-transport/src/envelope.rs +13 -8
- data/crates/kobako-wasmtime/CHANGELOG.md +161 -0
- data/crates/kobako-wasmtime/Cargo.toml +26 -7
- data/crates/kobako-wasmtime/README.md +3 -2
- data/crates/kobako-wasmtime/build/preview2.rs +1339 -0
- data/crates/kobako-wasmtime/build.rs +16 -0
- data/crates/kobako-wasmtime/src/abi.rs +17 -37
- data/crates/kobako-wasmtime/src/ambient.rs +33 -18
- data/crates/kobako-wasmtime/src/cache.rs +23 -15
- data/crates/kobako-wasmtime/src/config.rs +52 -68
- data/crates/kobako-wasmtime/src/driver.rs +48 -63
- data/crates/kobako-wasmtime/src/exports.rs +143 -17
- data/crates/kobako-wasmtime/src/guest.rs +12 -6
- data/crates/kobako-wasmtime/src/guest_binary.rs +14 -0
- data/crates/kobako-wasmtime/src/imports.rs +42 -18
- data/crates/kobako-wasmtime/src/instance_pre.rs +4 -4
- data/crates/kobako-wasmtime/src/invocation.rs +74 -12
- data/crates/kobako-wasmtime/src/lib.rs +5 -3
- data/crates/kobako-wasmtime/src/limiter.rs +70 -5
- data/crates/kobako-wasmtime/src/preview1/descriptors.rs +309 -0
- data/crates/kobako-wasmtime/src/preview1/differential/mount.rs +5 -15
- data/crates/kobako-wasmtime/src/preview1/differential.rs +27 -31
- data/crates/kobako-wasmtime/src/preview1/errno.rs +55 -66
- data/crates/kobako-wasmtime/src/preview1/fd.rs +327 -296
- data/crates/kobako-wasmtime/src/preview1/memory.rs +21 -12
- data/crates/kobako-wasmtime/src/preview1/mount_view/wrap.rs +34 -53
- data/crates/kobako-wasmtime/src/preview1/mount_view.rs +231 -217
- data/crates/kobako-wasmtime/src/preview1/path.rs +56 -121
- data/crates/kobako-wasmtime/src/preview1/poll.rs +244 -120
- data/crates/kobako-wasmtime/src/preview1/sock.rs +10 -8
- data/crates/kobako-wasmtime/src/preview1/testsuite.rs +5 -15
- data/crates/kobako-wasmtime/src/preview1.rs +46 -42
- data/crates/kobako-wasmtime/src/preview2/abi.rs +227 -0
- data/crates/kobako-wasmtime/src/preview2/error.rs +118 -0
- data/crates/kobako-wasmtime/src/preview2/filesystem.rs +122 -0
- data/crates/kobako-wasmtime/src/preview2/host.rs +3959 -0
- data/crates/kobako-wasmtime/src/preview2/http.rs +1503 -0
- data/crates/kobako-wasmtime/src/preview2/io.rs +315 -0
- data/crates/kobako-wasmtime/src/preview2/sockets.rs +379 -0
- data/crates/kobako-wasmtime/src/preview2/table.rs +305 -0
- data/crates/kobako-wasmtime/src/preview2.rs +57 -0
- data/crates/kobako-wasmtime/src/trap.rs +24 -9
- data/crates/kobako-wasmtime/src/wasi.rs +210 -81
- data/crates/kobako-wasmtime/wit/deps/cli.wit +233 -0
- data/crates/kobako-wasmtime/wit/deps/clocks.wit +162 -0
- data/crates/kobako-wasmtime/wit/deps/filesystem.wit +589 -0
- data/crates/kobako-wasmtime/wit/deps/http.wit +733 -0
- data/crates/kobako-wasmtime/wit/deps/io.wit +299 -0
- data/crates/kobako-wasmtime/wit/deps/random.wit +92 -0
- data/crates/kobako-wasmtime/wit/deps/sockets.wit +949 -0
- data/data/kobako.wasm +0 -0
- data/ext/kobako/Cargo.toml +1 -1
- data/ext/kobako/src/{runtime/errors.rs → errors.rs} +34 -26
- data/ext/kobako/src/{runtime/escape.rs → escape.rs} +42 -11
- data/ext/kobako/src/{runtime/filesystem → filesystem}/grants.rs +30 -26
- data/ext/kobako/src/{runtime/filesystem → filesystem}/ruby.rs +149 -168
- data/ext/kobako/src/{runtime/filesystem.rs → filesystem.rs} +24 -15
- data/ext/kobako/src/gvl.rs +306 -0
- data/ext/kobako/src/lib.rs +64 -3
- data/ext/kobako/src/network/mock.rs +187 -0
- data/ext/kobako/src/network.rs +591 -0
- data/ext/kobako/src/runtime/bridge.rs +30 -29
- data/ext/kobako/src/runtime/snapshot.rs +4 -4
- data/ext/kobako/src/runtime.rs +221 -143
- data/ext/kobako/src/wire.rs +42 -0
- data/lib/kobako/catalog/extensions.rb +14 -2
- data/lib/kobako/catalog/flags.rb +3 -5
- data/lib/kobako/catalog/grants.rb +5 -4
- data/lib/kobako/catalog/handles.rb +5 -27
- data/lib/kobako/catalog/mount.rb +11 -3
- data/lib/kobako/catalog/network.rb +35 -0
- data/lib/kobako/catalog/replacements.rb +28 -0
- data/lib/kobako/catalog/services.rb +5 -19
- data/lib/kobako/catalog/snippets.rb +3 -18
- data/lib/kobako/catalog.rb +3 -0
- data/lib/kobako/codec/{utils.rb → boundary.rb} +4 -2
- data/lib/kobako/codec/decoder.rb +4 -4
- data/lib/kobako/codec/ext_types.rb +3 -3
- data/lib/kobako/codec/handle_walk.rb +3 -43
- data/lib/kobako/codec/value_budget.rb +132 -40
- data/lib/kobako/codec.rb +1 -1
- data/lib/kobako/context.rb +24 -11
- data/lib/kobako/errors.rb +15 -12
- data/lib/kobako/extension.rb +3 -2
- data/lib/kobako/filesystem.rb +9 -2
- data/lib/kobako/handle.rb +2 -2
- data/lib/kobako/names.rb +28 -0
- data/lib/kobako/network.rb +210 -0
- data/lib/kobako/outcome.rb +7 -7
- data/lib/kobako/pool.rb +45 -23
- data/lib/kobako/runtime.rb +3 -2
- data/lib/kobako/sandbox.rb +92 -35
- data/lib/kobako/sandbox_options.rb +41 -106
- data/lib/kobako/transport/argument_wrap.rb +64 -0
- data/lib/kobako/transport/block_failure.rb +1 -1
- data/lib/kobako/transport/dispatcher.rb +6 -6
- data/lib/kobako/transport/exposure.rb +26 -15
- data/lib/kobako/transport/reflection.rb +21 -4
- data/lib/kobako/transport/run.rb +8 -23
- data/lib/kobako/transport/yielder.rb +2 -9
- data/lib/kobako/transport.rb +1 -0
- data/lib/kobako/version.rb +1 -1
- data/lib/kobako.rb +6 -2
- data/release-please-config.json +15 -0
- data/sig/core/thread.rbs +6 -0
- data/sig/kobako/catalog/extensions.rbs +2 -0
- data/sig/kobako/catalog/grants.rbs +7 -4
- data/sig/kobako/catalog/handles.rbs +0 -2
- data/sig/kobako/catalog/mount.rbs +3 -1
- data/sig/kobako/catalog/network.rbs +20 -0
- data/sig/kobako/catalog/replacements.rbs +14 -0
- data/sig/kobako/catalog/services.rbs +0 -4
- data/sig/kobako/catalog/snippets.rbs +0 -2
- data/sig/kobako/codec/{utils.rbs → boundary.rbs} +2 -2
- data/sig/kobako/codec/handle_walk.rbs +0 -6
- data/sig/kobako/codec/value_budget.rbs +47 -4
- data/sig/kobako/context.rbs +3 -1
- data/sig/kobako/errors.rbs +4 -4
- data/sig/kobako/filesystem.rbs +21 -3
- data/sig/kobako/network.rbs +115 -0
- data/sig/kobako/outcome.rbs +1 -1
- data/sig/kobako/pool.rbs +7 -3
- data/sig/kobako/runtime.rbs +32 -3
- data/sig/kobako/sandbox.rbs +19 -2
- data/sig/kobako/sandbox_options.rbs +29 -38
- data/sig/kobako/transport/argument_wrap.rbs +15 -0
- data/sig/kobako/transport/error.rbs +1 -1
- data/sig/kobako/transport/exposure.rbs +2 -4
- data/sig/kobako/transport/reflection.rbs +10 -0
- data/sig/kobako/transport/run.rbs +0 -2
- data/sig/kobako/transport/yielder.rbs +0 -3
- data/sig/kobako/transport.rbs +1 -1
- data/sig/kobako.rbs +13 -0
- metadata +84 -35
- data/crates/kobako-runtime/src/endpoint/capture.rs +0 -115
- data/crates/kobako-runtime/src/endpoint/memory_cap.rs +0 -238
- data/crates/kobako-runtime/src/filesystem/path.rs +0 -21
- data/crates/kobako-runtime/src/vfs/errno.rs +0 -153
- data/crates/kobako-runtime/tests/linux_baseline/calls.rs +0 -171
- data/crates/kobako-runtime/tests/linux_baseline/concurrent.rs +0 -276
- data/crates/kobako-runtime/tests/linux_baseline/kobako.rs +0 -323
- data/crates/kobako-runtime/tests/linux_baseline/linux-baseline-expected.txt +0 -16
- data/crates/kobako-runtime/tests/linux_baseline/linux.rs +0 -449
- data/crates/kobako-runtime/tests/linux_baseline/main.rs +0 -611
- data/crates/kobako-runtime/tests/linux_baseline/permissions.rs +0 -236
- data/crates/kobako-wasmtime/src/descriptors.rs +0 -200
- data/crates/kobako-wasmtime/tests/integration/compile_posture.rs +0 -43
- data/crates/kobako-wasmtime/tests/integration/guest_file.rs +0 -1085
- data/crates/kobako-wasmtime/tests/integration/main.rs +0 -29
- data/crates/kobako-wasmtime/tests/integration/preamble_flags.rs +0 -70
- data/crates/kobako-wasmtime/tests/integration/snippet_compile.rs +0 -95
- data/crates/kobako-wasmtime/tests/integration/support/mod.rs +0 -30
- data/crates/kobako-wasmtime/tests/integration/unanswered_call.rs +0 -86
- data/crates/kobako-wasmtime/tests/integration/unsupported_call.rs +0 -51
- data/ext/kobako/src/runtime/gvl.rs +0 -147
- data/lib/kobako/constant_name.rb +0 -8
- data/sig/kobako/constant_name.rbs +0 -3
- /data/ext/kobako/src/{runtime/pinned_value.rs → pinned_value.rs} +0 -0
|
@@ -1,23 +1,19 @@
|
|
|
1
|
-
//! Isolation profile —
|
|
2
|
-
//!
|
|
1
|
+
//! Isolation profile — what a frontend requests and a runtime builds and
|
|
2
|
+
//! declares.
|
|
3
3
|
//!
|
|
4
|
-
//!
|
|
5
|
-
//!
|
|
6
|
-
//!
|
|
7
|
-
//!
|
|
4
|
+
//! One of an ordered set: the host application requests the profile it
|
|
5
|
+
//! wants, the runtime builds it and declares the profile it actually
|
|
6
|
+
//! built, and the frontend refuses a declaration below the request — so
|
|
7
|
+
//! the request is also the floor.
|
|
8
8
|
|
|
9
|
-
use std::
|
|
10
|
-
use std::sync::LazyLock;
|
|
11
|
-
use std::time::{SystemTime, UNIX_EPOCH};
|
|
9
|
+
use std::time::Instant;
|
|
12
10
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
/// The ordered isolation ladder a runtime builds one rung of.
|
|
11
|
+
/// The ordered isolation profiles a runtime builds one of.
|
|
16
12
|
///
|
|
17
|
-
/// `Hermetic` is the full ambient-denial
|
|
18
|
-
/// entropy denied at the WASI boundary, no ambient filesystem /
|
|
19
|
-
/// environment / network reachability
|
|
20
|
-
///
|
|
13
|
+
/// `Hermetic` is the full ambient-denial profile: ambient time and
|
|
14
|
+
/// entropy denied at the WASI boundary, and no ambient filesystem /
|
|
15
|
+
/// environment / network reachability: only a Grant reaches a file or a
|
|
16
|
+
/// socket. `Permissive` differs only in the ambient
|
|
21
17
|
/// authority it grants — live time and entropy at the WASI boundary — and in
|
|
22
18
|
/// the times and inode numbers it shows of an entry. Ordering
|
|
23
19
|
/// follows strength (`Permissive < Hermetic`), so a floor check is a
|
|
@@ -25,54 +21,31 @@ use crate::vfs::{FileType, Identity, Kstat};
|
|
|
25
21
|
///
|
|
26
22
|
/// Deliberately not `#[non_exhaustive]`, unlike this crate's error
|
|
27
23
|
/// types. A wildcard arm here would let a runtime silently keep building
|
|
28
|
-
/// the
|
|
29
|
-
///
|
|
24
|
+
/// the profile it already knows while declaring it satisfied one it never
|
|
25
|
+
/// implemented; the compile error a new profile causes is what forces
|
|
30
26
|
/// each runtime to answer for it. The ordering is the same reason — a
|
|
31
|
-
///
|
|
27
|
+
/// profile inserted between two changes what every existing `>=` means, which
|
|
32
28
|
/// no wildcard could have absorbed either.
|
|
33
|
-
|
|
29
|
+
///
|
|
30
|
+
/// A Sandbox defaults to the hermetic floor, so one whose Host App names
|
|
31
|
+
/// none runs under the most isolation.
|
|
32
|
+
#[derive(Debug, Clone, Copy, Default, PartialEq, Eq, PartialOrd, Ord)]
|
|
34
33
|
pub enum Profile {
|
|
35
34
|
Permissive,
|
|
35
|
+
#[default]
|
|
36
36
|
Hermetic,
|
|
37
37
|
}
|
|
38
38
|
|
|
39
39
|
impl Profile {
|
|
40
|
-
///
|
|
41
|
-
///
|
|
42
|
-
///
|
|
43
|
-
///
|
|
44
|
-
///
|
|
45
|
-
pub fn
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
(Self::Permissive, Some(identity)) => KEY.hash_one(identity),
|
|
50
|
-
}
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
/// `stat` as a guest on this posture sees it, whichever ABI a Wasm
|
|
54
|
-
/// Driver encodes it into. A Filesystem records the host's real time whatever
|
|
55
|
-
/// the invocation writing to it runs under, so one shared across
|
|
56
|
-
/// invocations keeps one record; a hermetic guest sees every time at the
|
|
57
|
-
/// Unix epoch, where its wall clock stands, so a time a write left behind
|
|
58
|
-
/// is no clock it can read. A link reports no size, so nothing of where it
|
|
59
|
-
/// points reaches the guest, and an entry is told apart only by what
|
|
60
|
-
/// `guest_ino` answers.
|
|
61
|
-
pub fn guest_kstat(self, stat: Kstat) -> Kstat {
|
|
62
|
-
let ino = self.guest_ino(Identity::of(&stat));
|
|
63
|
-
let masked = match self {
|
|
64
|
-
Self::Permissive => stat,
|
|
65
|
-
Self::Hermetic => {
|
|
66
|
-
let epoch = |time: Option<SystemTime>| time.map(|_| UNIX_EPOCH);
|
|
67
|
-
stat.with_times(epoch(stat.atime), epoch(stat.mtime), epoch(stat.ctime))
|
|
68
|
-
}
|
|
69
|
-
};
|
|
70
|
-
Kstat {
|
|
71
|
-
size: match masked.file_type {
|
|
72
|
-
FileType::Symlink => 0,
|
|
73
|
-
_ => masked.size,
|
|
74
|
-
},
|
|
75
|
-
..masked.with_identity(0, ino)
|
|
40
|
+
/// When a guest's clock, due `at` in host time, is due in a wait on this
|
|
41
|
+
/// profile, whichever ABI a Wasm Driver encodes the wait into. A hermetic
|
|
42
|
+
/// guest's clocks never advance, so a wait on them alone is due at once;
|
|
43
|
+
/// beside a host-side producer, which only host time brings, as
|
|
44
|
+
/// `has_producer` says, it is due at `at` as a live clock is.
|
|
45
|
+
pub fn clock_due(self, at: Instant, has_producer: bool) -> Instant {
|
|
46
|
+
match (self, has_producer) {
|
|
47
|
+
(Self::Hermetic, false) => Instant::now(),
|
|
48
|
+
_ => at,
|
|
76
49
|
}
|
|
77
50
|
}
|
|
78
51
|
}
|
|
@@ -81,94 +54,6 @@ impl Profile {
|
|
|
81
54
|
mod tests {
|
|
82
55
|
use super::*;
|
|
83
56
|
|
|
84
|
-
// The Wasm Driver only encodes this, so another one shows the same, and a
|
|
85
|
-
// guest reads a link's size and a time here or nowhere.
|
|
86
|
-
// @behavior RT-173 RT-183
|
|
87
|
-
#[test]
|
|
88
|
-
fn a_guest_sees_no_size_for_a_link_and_only_what_its_posture_allows() {
|
|
89
|
-
let reported = Kstat::new(FileType::Symlink, 42)
|
|
90
|
-
.with_identity(7, 9)
|
|
91
|
-
.with_times(Some(SystemTime::now()), None, None);
|
|
92
|
-
let (hermetic, permissive) = (
|
|
93
|
-
Profile::Hermetic.guest_kstat(reported),
|
|
94
|
-
Profile::Permissive.guest_kstat(reported),
|
|
95
|
-
);
|
|
96
|
-
assert_eq!(
|
|
97
|
-
(hermetic.size, permissive.size, hermetic.ino, hermetic.atime),
|
|
98
|
-
(0, 0, 0, Some(UNIX_EPOCH)),
|
|
99
|
-
"Profile::guest_kstat of a link must report no size on any posture, and at the \
|
|
100
|
-
hermetic rung no inode number and every time at the Unix epoch"
|
|
101
|
-
);
|
|
102
|
-
assert!(
|
|
103
|
-
permissive.ino != 0 && permissive.ino != 9 && permissive.atime == reported.atime,
|
|
104
|
-
"Profile::guest_kstat at the permissive rung must hash the inode number and keep \
|
|
105
|
-
the time"
|
|
106
|
-
);
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
// A device number depends on how many Filesystems the process made before,
|
|
110
|
-
// so the inode number a guest reads folds it in and the device stays out.
|
|
111
|
-
// @behavior RT-283
|
|
112
|
-
#[test]
|
|
113
|
-
fn a_guest_sees_one_device_for_every_entry() {
|
|
114
|
-
let reported = Kstat::new(FileType::RegFile, 1).with_identity(7, 9);
|
|
115
|
-
assert_eq!(
|
|
116
|
-
[Profile::Hermetic, Profile::Permissive]
|
|
117
|
-
.map(|profile| profile.guest_kstat(reported).dev),
|
|
118
|
-
[0, 0],
|
|
119
|
-
"Profile::guest_kstat of an entry a Filesystem reports on device 7 must report \
|
|
120
|
-
device 0 on either posture"
|
|
121
|
-
);
|
|
122
|
-
}
|
|
123
|
-
|
|
124
|
-
// An unkeyed hash answers what anyone can compute from a host's numbers,
|
|
125
|
-
// so the hash a guest reads must differ from it.
|
|
126
|
-
// @behavior RT-194
|
|
127
|
-
#[test]
|
|
128
|
-
fn a_guest_cannot_compute_the_inode_number_it_reads() {
|
|
129
|
-
use std::collections::hash_map::DefaultHasher;
|
|
130
|
-
use std::hash::{Hash, Hasher};
|
|
131
|
-
|
|
132
|
-
let reported = Kstat::new(FileType::RegFile, 0).with_identity(7, 9);
|
|
133
|
-
let identity = Identity::of(&reported);
|
|
134
|
-
let mut unkeyed = DefaultHasher::new();
|
|
135
|
-
identity
|
|
136
|
-
.expect("an inode number names an identity")
|
|
137
|
-
.hash(&mut unkeyed);
|
|
138
|
-
let seen = Profile::Permissive.guest_ino(identity);
|
|
139
|
-
assert_eq!(
|
|
140
|
-
seen,
|
|
141
|
-
Profile::Permissive.guest_ino(identity),
|
|
142
|
-
"Profile::guest_ino of one identity must answer one number within a process"
|
|
143
|
-
);
|
|
144
|
-
assert_ne!(
|
|
145
|
-
seen,
|
|
146
|
-
unkeyed.finish(),
|
|
147
|
-
"Profile::guest_ino at the permissive rung must not answer a hash anyone can compute \
|
|
148
|
-
from the device and inode numbers"
|
|
149
|
-
);
|
|
150
|
-
}
|
|
151
|
-
|
|
152
|
-
// A guest reads the count on any ABI, so the count starts in the runtime
|
|
153
|
-
// rather than in what a Wasm Driver encodes.
|
|
154
|
-
// @behavior RT-193
|
|
155
|
-
#[test]
|
|
156
|
-
fn an_entry_whose_filesystem_keeps_no_count_is_named_once() {
|
|
157
|
-
let reported = Kstat::new(FileType::RegFile, 0);
|
|
158
|
-
assert_eq!(
|
|
159
|
-
(
|
|
160
|
-
Profile::Hermetic.guest_kstat(reported).nlink,
|
|
161
|
-
Profile::Permissive.guest_kstat(reported).nlink,
|
|
162
|
-
Profile::Permissive
|
|
163
|
-
.guest_kstat(reported.with_nlink(3))
|
|
164
|
-
.nlink,
|
|
165
|
-
),
|
|
166
|
-
(1, 1, 3),
|
|
167
|
-
"Profile::guest_kstat of an entry reporting no count must show one name on each \
|
|
168
|
-
posture, and of one reporting three must show three"
|
|
169
|
-
);
|
|
170
|
-
}
|
|
171
|
-
|
|
172
57
|
// @behavior RT-014
|
|
173
58
|
#[test]
|
|
174
59
|
fn a_declaration_satisfies_any_floor_at_or_below_it() {
|
|
@@ -45,10 +45,8 @@ pub enum Entry<'a> {
|
|
|
45
45
|
/// Safety contract for `handler`: the runtime only *borrows* the handler
|
|
46
46
|
/// for the duration of `invoke` and never roots it. A frontend whose
|
|
47
47
|
/// handler references a GC-managed object (e.g. a Ruby `Proc`) must keep
|
|
48
|
-
/// that object alive — and, under a moving GC, pinned — for the whole call
|
|
49
|
-
///
|
|
50
|
-
/// wrapper and GC-marking it; the runtime itself touches no frontend
|
|
51
|
-
/// value.
|
|
48
|
+
/// that object alive — and, under a moving GC, pinned — for the whole call;
|
|
49
|
+
/// the runtime itself touches no frontend value.
|
|
52
50
|
pub trait Runtime {
|
|
53
51
|
/// `grants` are this Invocation's, each of a kind `supports` declared;
|
|
54
52
|
/// the runtime presents them to the guest and keeps none afterwards.
|
|
@@ -69,7 +67,7 @@ pub trait Runtime {
|
|
|
69
67
|
}
|
|
70
68
|
|
|
71
69
|
/// The isolation profile this runtime provides. Deliberately
|
|
72
|
-
/// without a default: every engine states its
|
|
70
|
+
/// without a default: every engine states its profile explicitly,
|
|
73
71
|
/// and a frontend refuses construction when the declaration falls
|
|
74
72
|
/// below the floor its host application requested.
|
|
75
73
|
fn profile(&self) -> Profile;
|
|
@@ -7,16 +7,18 @@
|
|
|
7
7
|
|
|
8
8
|
use std::cell::RefCell;
|
|
9
9
|
use std::sync::atomic::{AtomicBool, Ordering};
|
|
10
|
-
use std::sync::{Arc, OnceLock};
|
|
10
|
+
use std::sync::{Arc, Mutex, OnceLock, PoisonError};
|
|
11
11
|
use std::thread::{self, ThreadId};
|
|
12
12
|
use std::time::{Duration, Instant};
|
|
13
13
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
///
|
|
17
|
-
///
|
|
14
|
+
use crate::wait::Waiter;
|
|
15
|
+
|
|
16
|
+
/// How a thread waits for a lock another thread holds, or for what another
|
|
17
|
+
/// thread brings. A frontend whose threads share a lock of their own, as
|
|
18
|
+
/// Ruby's threads share the GVL, gives that lock up for the wait, or a holder
|
|
19
|
+
/// that needs it to finish never could.
|
|
18
20
|
pub trait Blocking: Send + Sync {
|
|
19
|
-
/// Run `wait`, which returns once the lock is taken.
|
|
21
|
+
/// Run `wait`, which returns once the lock is taken or the event arrived.
|
|
20
22
|
fn wait(&self, wait: &mut dyn FnMut());
|
|
21
23
|
}
|
|
22
24
|
|
|
@@ -38,13 +40,9 @@ pub(crate) fn schedule(wait: &mut dyn FnMut()) {
|
|
|
38
40
|
}
|
|
39
41
|
}
|
|
40
42
|
|
|
41
|
-
|
|
42
|
-
static CURRENT: ThreadId = thread::current().id();
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
/// Who is running, as Linux's `current`.
|
|
43
|
+
/// Who is running, as a lock records Linux's `current` as its owner.
|
|
46
44
|
pub(crate) fn current() -> ThreadId {
|
|
47
|
-
|
|
45
|
+
TASK.with(|task| task.borrow().id)
|
|
48
46
|
}
|
|
49
47
|
|
|
50
48
|
/// A thread as its frontend may interrupt it from another thread, as a signal
|
|
@@ -52,6 +50,9 @@ pub(crate) fn current() -> ThreadId {
|
|
|
52
50
|
#[derive(Clone, Default)]
|
|
53
51
|
pub struct Task {
|
|
54
52
|
interrupted: Arc<AtomicBool>,
|
|
53
|
+
/// The waiter the thread sleeps on, woken by an interrupt as
|
|
54
|
+
/// `signal_wake_up` wakes a sleeping task.
|
|
55
|
+
sleeping: Arc<Mutex<Option<Arc<Waiter>>>>,
|
|
55
56
|
}
|
|
56
57
|
|
|
57
58
|
impl Task {
|
|
@@ -64,37 +65,87 @@ impl Task {
|
|
|
64
65
|
/// signal ends a killable wait; it holds until that run ends.
|
|
65
66
|
pub fn interrupt(&self) {
|
|
66
67
|
self.interrupted.store(true, Ordering::SeqCst);
|
|
68
|
+
if let Some(waiter) = self.sleeping().as_ref() {
|
|
69
|
+
waiter.wake();
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
fn sleeping(&self) -> std::sync::MutexGuard<'_, Option<Arc<Waiter>>> {
|
|
74
|
+
self.sleeping.lock().unwrap_or_else(PoisonError::into_inner)
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/// Have an interrupt of the calling thread wake `waiter` while `sleep` runs,
|
|
79
|
+
/// as a task sleeping in `TASK_KILLABLE` is woken by a fatal signal.
|
|
80
|
+
pub(crate) fn sleep_on<T>(waiter: &Arc<Waiter>, sleep: impl FnOnce() -> T) -> T {
|
|
81
|
+
/// Takes the waiter back however `sleep` ends.
|
|
82
|
+
struct Awake(Task);
|
|
83
|
+
|
|
84
|
+
impl Drop for Awake {
|
|
85
|
+
fn drop(&mut self) {
|
|
86
|
+
*self.0.sleeping() = None;
|
|
87
|
+
}
|
|
67
88
|
}
|
|
89
|
+
|
|
90
|
+
let task = Task::current();
|
|
91
|
+
*task.sleeping() = Some(waiter.clone());
|
|
92
|
+
let _awake = Awake(task);
|
|
93
|
+
sleep()
|
|
68
94
|
}
|
|
69
95
|
|
|
70
96
|
/// The task this thread carries out, as Linux's `current`, and when its run is
|
|
71
97
|
/// to stop.
|
|
72
|
-
#[derive(Default)]
|
|
73
98
|
struct Current {
|
|
99
|
+
id: ThreadId,
|
|
74
100
|
task: Task,
|
|
75
101
|
deadline: Option<Instant>,
|
|
76
|
-
/// How many
|
|
77
|
-
/// Filesystem's own call
|
|
102
|
+
/// How many interruptible stretches the thread is inside: a frontend's
|
|
103
|
+
/// around its run, and a run within another where a Filesystem's own call
|
|
104
|
+
/// starts another.
|
|
78
105
|
depth: usize,
|
|
79
106
|
}
|
|
80
107
|
|
|
81
108
|
thread_local! {
|
|
82
|
-
static TASK: RefCell<Current> = RefCell::
|
|
109
|
+
static TASK: RefCell<Current> = RefCell::new(Current {
|
|
110
|
+
id: thread::current().id(),
|
|
111
|
+
task: Task::default(),
|
|
112
|
+
deadline: None,
|
|
113
|
+
depth: 0,
|
|
114
|
+
});
|
|
83
115
|
}
|
|
84
116
|
|
|
85
117
|
/// Run `run` as a run that stops waiting once `deadline` passes or its thread
|
|
86
118
|
/// is interrupted, as a Linux task stops a killable wait on a fatal signal. A
|
|
87
119
|
/// run within another keeps the outer one's interrupt.
|
|
88
120
|
pub fn run_task<T>(deadline: Option<Instant>, run: impl FnOnce() -> T) -> T {
|
|
89
|
-
/// Puts back the deadline of the run around this one, however `run` ends
|
|
90
|
-
/// and lets an interrupt go once no run is left.
|
|
121
|
+
/// Puts back the deadline of the run around this one, however `run` ends.
|
|
91
122
|
struct Outer(Option<Instant>);
|
|
92
123
|
|
|
93
124
|
impl Drop for Outer {
|
|
125
|
+
fn drop(&mut self) {
|
|
126
|
+
TASK.with(|task| task.borrow_mut().deadline = self.0);
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
run_interruptible(|| {
|
|
131
|
+
let _outer =
|
|
132
|
+
Outer(TASK.with(|task| std::mem::replace(&mut task.borrow_mut().deadline, deadline)));
|
|
133
|
+
run()
|
|
134
|
+
})
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
/// Run `run` as a stretch its frontend may interrupt, as a frontend brackets
|
|
138
|
+
/// all it does for one call around the run itself. An interrupt landing
|
|
139
|
+
/// anywhere in it lasts until the outermost stretch ends, so it stops the
|
|
140
|
+
/// waits of the run it was meant for and never those of the thread's next.
|
|
141
|
+
pub fn run_interruptible<T>(run: impl FnOnce() -> T) -> T {
|
|
142
|
+
/// Lets an interrupt go once no stretch is left, however `run` ends.
|
|
143
|
+
struct Stretch;
|
|
144
|
+
|
|
145
|
+
impl Drop for Stretch {
|
|
94
146
|
fn drop(&mut self) {
|
|
95
147
|
TASK.with(|task| {
|
|
96
148
|
let mut running = task.borrow_mut();
|
|
97
|
-
running.deadline = self.0;
|
|
98
149
|
running.depth -= 1;
|
|
99
150
|
if running.depth == 0 {
|
|
100
151
|
running.task.interrupted.store(false, Ordering::SeqCst);
|
|
@@ -103,24 +154,47 @@ pub fn run_task<T>(deadline: Option<Instant>, run: impl FnOnce() -> T) -> T {
|
|
|
103
154
|
}
|
|
104
155
|
}
|
|
105
156
|
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
running.depth += 1;
|
|
109
|
-
std::mem::replace(&mut running.deadline, deadline)
|
|
110
|
-
}));
|
|
157
|
+
TASK.with(|task| task.borrow_mut().depth += 1);
|
|
158
|
+
let _stretch = Stretch;
|
|
111
159
|
run()
|
|
112
160
|
}
|
|
113
161
|
|
|
114
|
-
///
|
|
115
|
-
///
|
|
116
|
-
|
|
162
|
+
/// Why a run is to stop, as the fatal signal pending on a Linux task says
|
|
163
|
+
/// what ended it.
|
|
164
|
+
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
|
|
165
|
+
pub enum FatalSignal {
|
|
166
|
+
/// The run passed its deadline.
|
|
167
|
+
Deadline,
|
|
168
|
+
/// The run's frontend interrupted it.
|
|
169
|
+
Interrupt,
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
/// The fatal signal pending on the calling thread's run, its deadline read
|
|
173
|
+
/// first; `None` while the run may go on waiting.
|
|
174
|
+
pub fn pending_fatal_signal() -> Option<FatalSignal> {
|
|
117
175
|
TASK.with(|task| {
|
|
118
176
|
let running = task.borrow();
|
|
119
|
-
running.
|
|
120
|
-
|
|
177
|
+
if running.deadline.is_some_and(|at| Instant::now() >= at) {
|
|
178
|
+
Some(FatalSignal::Deadline)
|
|
179
|
+
} else if running.task.interrupted.load(Ordering::SeqCst) {
|
|
180
|
+
Some(FatalSignal::Interrupt)
|
|
181
|
+
} else {
|
|
182
|
+
None
|
|
183
|
+
}
|
|
121
184
|
})
|
|
122
185
|
}
|
|
123
186
|
|
|
187
|
+
/// Whether the calling thread's run is to stop waiting, as Linux's
|
|
188
|
+
/// `fatal_signal_pending(current)` answers.
|
|
189
|
+
pub(crate) fn fatal_signal_pending() -> bool {
|
|
190
|
+
pending_fatal_signal().is_some()
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
/// When the calling thread's run is to stop, once it has a deadline.
|
|
194
|
+
pub(crate) fn deadline() -> Option<Instant> {
|
|
195
|
+
TASK.with(|task| task.borrow().deadline)
|
|
196
|
+
}
|
|
197
|
+
|
|
124
198
|
/// The most a wait sleeps before it looks again whether its run is to stop.
|
|
125
199
|
const MAX_SLEEP: Duration = Duration::from_millis(10);
|
|
126
200
|
|
|
@@ -208,3 +282,30 @@ pub(crate) mod testing {
|
|
|
208
282
|
counts
|
|
209
283
|
}
|
|
210
284
|
}
|
|
285
|
+
|
|
286
|
+
#[cfg(test)]
|
|
287
|
+
mod tests {
|
|
288
|
+
use super::*;
|
|
289
|
+
|
|
290
|
+
// @behavior RT-403
|
|
291
|
+
#[test]
|
|
292
|
+
fn an_interrupt_around_a_run_stops_that_run_alone() {
|
|
293
|
+
let (during_setup, after_teardown) = run_interruptible(|| {
|
|
294
|
+
Task::current().interrupt();
|
|
295
|
+
let during_setup = run_task(None, pending_fatal_signal);
|
|
296
|
+
Task::current().interrupt();
|
|
297
|
+
(during_setup, pending_fatal_signal())
|
|
298
|
+
});
|
|
299
|
+
let next = run_task(None, pending_fatal_signal);
|
|
300
|
+
assert_eq!(
|
|
301
|
+
(during_setup, after_teardown, next),
|
|
302
|
+
(
|
|
303
|
+
Some(FatalSignal::Interrupt),
|
|
304
|
+
Some(FatalSignal::Interrupt),
|
|
305
|
+
None
|
|
306
|
+
),
|
|
307
|
+
"an interrupt while a run is set up must stop that run's waits, and \
|
|
308
|
+
one while it is torn down must not stop the thread's next run"
|
|
309
|
+
);
|
|
310
|
+
}
|
|
311
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
//! A network entry's connect policy as a security module, as Landlock's
|
|
2
|
+
//! `net.c` answers the network rights of its domain.
|
|
3
|
+
|
|
4
|
+
use std::sync::Arc;
|
|
5
|
+
|
|
6
|
+
use super::SecurityOperations;
|
|
7
|
+
use crate::network::Connection;
|
|
8
|
+
use crate::policy::Policy;
|
|
9
|
+
use crate::Errno;
|
|
10
|
+
|
|
11
|
+
/// An entry's connect policy, judging what the guest named, as one more LSM
|
|
12
|
+
/// answers `security_socket_connect`.
|
|
13
|
+
pub(super) struct EntryPolicy(pub(super) Arc<dyn for<'a> Policy<Connection<'a>>>);
|
|
14
|
+
|
|
15
|
+
impl SecurityOperations for EntryPolicy {
|
|
16
|
+
fn socket_connect(&self, connection: &Connection<'_>) -> Result<(), Errno> {
|
|
17
|
+
match self.0.allows(connection) {
|
|
18
|
+
true => Ok(()),
|
|
19
|
+
false => Err(Errno::PermissionDenied),
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
}
|