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,30 +1,26 @@
|
|
|
1
1
|
//! The host ABI endpoint: everything the kobako ABI asks of a host that no
|
|
2
2
|
//! Engine decides, so a Wasm Driver for any Engine implements `GuestInstance`
|
|
3
|
-
//! over its own memory and exports, and links `
|
|
4
|
-
//! `
|
|
3
|
+
//! over its own memory and exports, and links the `upcall` and `preamble`
|
|
4
|
+
//! imports to `handle` and `hand_preamble`.
|
|
5
5
|
//!
|
|
6
6
|
//! Only this endpoint and its guest counterpart read or write an envelope's
|
|
7
7
|
//! bytes.
|
|
8
8
|
|
|
9
9
|
mod buffer;
|
|
10
|
-
mod capture;
|
|
11
10
|
mod dispatch;
|
|
12
11
|
mod invoke;
|
|
13
|
-
mod memory_cap;
|
|
14
12
|
|
|
15
13
|
use std::fmt::Display;
|
|
16
14
|
|
|
17
|
-
use kobako_transport::abi::ABI_VERSION;
|
|
15
|
+
use kobako_transport::abi::{ABI_VERSION, DOWNCALL_EXPORT, GUEST_INTERFACE};
|
|
18
16
|
|
|
19
17
|
use crate::error::{SetupError, Trap};
|
|
20
18
|
|
|
21
|
-
pub use
|
|
22
|
-
pub use dispatch::{handle, Calls, UpcallEnd, ABANDONED};
|
|
19
|
+
pub use dispatch::{hand_preamble, handle, Calls, ImportEnd, ABANDONED};
|
|
23
20
|
pub use invoke::{
|
|
24
|
-
compile_request, compiled_bytecodes, read_compile_reply, read_outcome,
|
|
25
|
-
|
|
21
|
+
compile_request, compiled_bytecodes, preamble_bytes, read_compile_reply, read_outcome,
|
|
22
|
+
request_of, write_request,
|
|
26
23
|
};
|
|
27
|
-
pub use memory_cap::{MemoryCap, MemoryLimitExceeded};
|
|
28
24
|
|
|
29
25
|
/// For a required guest export that is absent or mistyped, wherever it is
|
|
30
26
|
/// looked up. Names neither the export nor a frontend's artifact path;
|
|
@@ -32,13 +28,25 @@ pub use memory_cap::{MemoryCap, MemoryLimitExceeded};
|
|
|
32
28
|
pub const RUNTIME_INCOMPATIBLE: &str =
|
|
33
29
|
"the Sandbox runtime is incompatible; rebuild it against the kobako version in use";
|
|
34
30
|
|
|
35
|
-
/// Accept a Guest Binary only when the
|
|
36
|
-
///
|
|
37
|
-
/// refusal, so both are `Dead` and say so.
|
|
38
|
-
pub fn verify_abi_version
|
|
31
|
+
/// Accept a Guest Binary only when, among the names of its `exports`, its
|
|
32
|
+
/// downcall stands under the host's ABI version. Only rebuilding the artifact
|
|
33
|
+
/// fixes either refusal, so both are `Dead` and say so.
|
|
34
|
+
pub fn verify_abi_version<'a>(
|
|
35
|
+
exports: impl IntoIterator<Item = &'a str>,
|
|
36
|
+
) -> Result<(), SetupError> {
|
|
37
|
+
let interface = GUEST_INTERFACE
|
|
38
|
+
.strip_suffix(ABI_VERSION)
|
|
39
|
+
.expect("the guest interface carries the ABI version");
|
|
40
|
+
let downcall = DOWNCALL_EXPORT
|
|
41
|
+
.strip_prefix(GUEST_INTERFACE)
|
|
42
|
+
.expect("the downcall export stands under the guest interface");
|
|
43
|
+
let reported = exports.into_iter().find_map(|name| {
|
|
44
|
+
name.strip_prefix(interface)
|
|
45
|
+
.and_then(|rest| rest.strip_suffix(downcall))
|
|
46
|
+
});
|
|
39
47
|
match reported {
|
|
40
48
|
None => Err(SetupError::Dead(format!(
|
|
41
|
-
"the Guest Binary
|
|
49
|
+
"the Guest Binary exports no {DOWNCALL_EXPORT}; \
|
|
42
50
|
rebuild it against ABI version {ABI_VERSION}"
|
|
43
51
|
))),
|
|
44
52
|
Some(version) if version != ABI_VERSION => Err(SetupError::Dead(format!(
|
|
@@ -55,8 +63,8 @@ pub fn verify_abi_version(reported: Option<u32>) -> Result<(), SetupError> {
|
|
|
55
63
|
const SANDBOX_RUNTIME_NOT_KOBAKO: &str =
|
|
56
64
|
"the loaded Wasm module is not a Kobako-compatible runtime";
|
|
57
65
|
|
|
58
|
-
/// One guest instance as the endpoint drives it: what a Wasm Driver gives it
|
|
59
|
-
/// Engine, from the invocation body and from inside
|
|
66
|
+
/// One guest instance as the endpoint drives it: what a Wasm Driver gives it
|
|
67
|
+
/// of an Engine, from the invocation body and from inside a host import alike.
|
|
60
68
|
/// A method answering `None` names an export the module does not have.
|
|
61
69
|
pub trait GuestInstance {
|
|
62
70
|
/// What a call into the guest raises, kept as it is so an invocation ends
|
|
@@ -69,25 +77,31 @@ pub trait GuestInstance {
|
|
|
69
77
|
/// The guest's linear memory.
|
|
70
78
|
fn memory(&mut self) -> Option<&mut [u8]>;
|
|
71
79
|
|
|
72
|
-
///
|
|
73
|
-
///
|
|
74
|
-
|
|
80
|
+
/// Call the guest's `cabi_realloc` with `old_ptr`, `old_len`, `align`,
|
|
81
|
+
/// and `new_len`, as the Canonical ABI calls it, answering the room's
|
|
82
|
+
/// address. A guest with no room left traps.
|
|
83
|
+
fn realloc(
|
|
84
|
+
&mut self,
|
|
85
|
+
old_ptr: u32,
|
|
86
|
+
old_len: u32,
|
|
87
|
+
align: u32,
|
|
88
|
+
new_len: u32,
|
|
89
|
+
) -> Option<Result<u32, Self::Fault>>;
|
|
75
90
|
|
|
76
|
-
/// Call
|
|
77
|
-
///
|
|
78
|
-
fn downcall(&mut self, ptr: i32, len: i32) -> Option<Result<
|
|
91
|
+
/// Call the downcall with a request at `ptr`, answering the return area
|
|
92
|
+
/// that names its answer.
|
|
93
|
+
fn downcall(&mut self, ptr: i32, len: i32) -> Option<Result<u32, Self::Fault>>;
|
|
79
94
|
|
|
80
95
|
/// The cap `fault` carries, if one of the invocation's caps fired, which
|
|
81
96
|
/// names itself rather than the step it fired during.
|
|
82
|
-
fn
|
|
97
|
+
fn cap_trap_of(fault: &Self::Fault) -> Option<Trap>;
|
|
83
98
|
}
|
|
84
99
|
|
|
85
100
|
#[cfg(test)]
|
|
86
101
|
mod tests {
|
|
87
102
|
//! Witness that the endpoint needs nothing of an Engine: an instance made
|
|
88
103
|
//! of a plain buffer drives a whole request and upcall through it.
|
|
89
|
-
use kobako_transport::
|
|
90
|
-
use kobako_transport::envelope::Reply;
|
|
104
|
+
use kobako_transport::envelope::CallReply;
|
|
91
105
|
|
|
92
106
|
use super::*;
|
|
93
107
|
|
|
@@ -109,17 +123,17 @@ mod tests {
|
|
|
109
123
|
Some(&mut self.memory)
|
|
110
124
|
}
|
|
111
125
|
|
|
112
|
-
fn
|
|
126
|
+
fn realloc(&mut self, _: u32, _: u32, _: u32, len: u32) -> Option<Result<u32, String>> {
|
|
113
127
|
let ptr = self.next;
|
|
114
128
|
self.next += len;
|
|
115
129
|
Some(Ok(ptr))
|
|
116
130
|
}
|
|
117
131
|
|
|
118
|
-
fn downcall(&mut self, _ptr: i32, _len: i32) -> Option<Result<
|
|
132
|
+
fn downcall(&mut self, _ptr: i32, _len: i32) -> Option<Result<u32, String>> {
|
|
119
133
|
None
|
|
120
134
|
}
|
|
121
135
|
|
|
122
|
-
fn
|
|
136
|
+
fn cap_trap_of(_fault: &String) -> Option<Trap> {
|
|
123
137
|
None
|
|
124
138
|
}
|
|
125
139
|
}
|
|
@@ -132,6 +146,13 @@ mod tests {
|
|
|
132
146
|
}
|
|
133
147
|
}
|
|
134
148
|
|
|
149
|
+
/// The list the return area at `ret` names in `guest`.
|
|
150
|
+
fn named_by(guest: &InMemory, ret: usize) -> &[u8] {
|
|
151
|
+
let word = |at: usize| u32::from_le_bytes(guest.memory[at..at + 4].try_into().unwrap());
|
|
152
|
+
let (ptr, len) = (word(ret) as usize, word(ret + 4) as usize);
|
|
153
|
+
&guest.memory[ptr..ptr + len]
|
|
154
|
+
}
|
|
155
|
+
|
|
135
156
|
// @behavior RT-191
|
|
136
157
|
#[test]
|
|
137
158
|
fn a_request_lands_in_guest_memory_through_any_instance() {
|
|
@@ -151,16 +172,96 @@ mod tests {
|
|
|
151
172
|
fn an_upcall_answers_through_any_instance() {
|
|
152
173
|
let mut guest = instance();
|
|
153
174
|
let request = b"not a call";
|
|
154
|
-
guest.memory[..request.len()].copy_from_slice(request);
|
|
155
|
-
let packed = handle(&mut guest, 0, request.len() as i32)
|
|
156
|
-
.ok()
|
|
157
|
-
.expect("the upcall must answer");
|
|
158
|
-
let (ptr, len) = unpack_ptr_len(packed as u64);
|
|
159
|
-
let reply = Reply::decode(&guest.memory[ptr as usize..(ptr + len) as usize]);
|
|
175
|
+
guest.memory[512..512 + request.len()].copy_from_slice(request);
|
|
160
176
|
assert!(
|
|
161
|
-
|
|
177
|
+
handle(&mut guest, 512, request.len() as i32, 8).is_ok(),
|
|
178
|
+
"the upcall must answer"
|
|
179
|
+
);
|
|
180
|
+
let reply = CallReply::decode(named_by(&guest, 8));
|
|
181
|
+
assert!(
|
|
182
|
+
matches!(reply, Ok(CallReply::Unsupported(_))),
|
|
162
183
|
"endpoint::handle through an instance of a plain buffer must write the answer to a \
|
|
163
184
|
request under an unserved tag back into guest memory"
|
|
164
185
|
);
|
|
165
186
|
}
|
|
187
|
+
|
|
188
|
+
// @behavior RT-396
|
|
189
|
+
#[test]
|
|
190
|
+
fn the_preamble_is_the_same_however_often_the_guest_asks() {
|
|
191
|
+
let mut guest = instance();
|
|
192
|
+
let answers: Vec<Vec<u8>> = (0..2)
|
|
193
|
+
.map(|_| {
|
|
194
|
+
assert!(hand_preamble(&mut guest, b"setup", 8).is_ok());
|
|
195
|
+
named_by(&guest, 8).to_vec()
|
|
196
|
+
})
|
|
197
|
+
.collect();
|
|
198
|
+
assert_eq!(
|
|
199
|
+
answers,
|
|
200
|
+
[b"setup".to_vec(), b"setup".to_vec()],
|
|
201
|
+
"endpoint::hand_preamble asked twice within one Invocation must name the same \
|
|
202
|
+
Preamble bytes each time"
|
|
203
|
+
);
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
/// A host that gave the invocation up and answers no Call.
|
|
207
|
+
struct GaveUp;
|
|
208
|
+
|
|
209
|
+
impl crate::dispatch::DispatchHandler for GaveUp {
|
|
210
|
+
fn dispatch(
|
|
211
|
+
&self,
|
|
212
|
+
_call: kobako_transport::envelope::Call<'_>,
|
|
213
|
+
_yielder: &mut dyn crate::yielder::Yielder,
|
|
214
|
+
) -> Option<CallReply> {
|
|
215
|
+
None
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
fn abandoned(&self) -> bool {
|
|
219
|
+
true
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
// @behavior RT-398
|
|
224
|
+
#[test]
|
|
225
|
+
fn the_preamble_asked_for_after_the_host_gave_up_ends_the_invocation() {
|
|
226
|
+
let mut guest = instance();
|
|
227
|
+
guest.calls.bind(std::sync::Arc::new(GaveUp));
|
|
228
|
+
assert!(
|
|
229
|
+
matches!(
|
|
230
|
+
hand_preamble(&mut guest, b"setup", 8),
|
|
231
|
+
Err(ImportEnd::Abandoned)
|
|
232
|
+
),
|
|
233
|
+
"endpoint::hand_preamble for an invocation its host gave up must end the invocation \
|
|
234
|
+
rather than answer"
|
|
235
|
+
);
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
// @behavior RT-006
|
|
239
|
+
#[test]
|
|
240
|
+
fn a_guest_exporting_no_versioned_downcall_is_refused() {
|
|
241
|
+
assert!(
|
|
242
|
+
matches!(
|
|
243
|
+
verify_abi_version(["__kobako_downcall", "memory"]),
|
|
244
|
+
Err(SetupError::Dead(message)) if message.contains("exports no kobako:abi/guest@")
|
|
245
|
+
),
|
|
246
|
+
"a Guest Binary whose exports hold no kobako:abi/guest downcall must be refused, \
|
|
247
|
+
saying none is exported"
|
|
248
|
+
);
|
|
249
|
+
}
|
|
250
|
+
|
|
251
|
+
// @behavior RT-007
|
|
252
|
+
#[test]
|
|
253
|
+
fn a_guest_exporting_another_version_is_refused() {
|
|
254
|
+
assert!(
|
|
255
|
+
matches!(
|
|
256
|
+
verify_abi_version(["kobako:abi/guest@0.5.0#downcall"]),
|
|
257
|
+
Err(SetupError::Dead(message)) if message.contains("reports ABI version 0.5.0")
|
|
258
|
+
),
|
|
259
|
+
"a Guest Binary exporting its downcall under 0.5.0 must be refused, naming the \
|
|
260
|
+
version it reports"
|
|
261
|
+
);
|
|
262
|
+
assert!(
|
|
263
|
+
verify_abi_version([DOWNCALL_EXPORT]).is_ok(),
|
|
264
|
+
"a Guest Binary exporting its downcall under the host's version must be accepted"
|
|
265
|
+
);
|
|
266
|
+
}
|
|
166
267
|
}
|
|
@@ -0,0 +1,391 @@
|
|
|
1
|
+
//! Why a call failed, under the POSIX name each failure stands for, as Linux's
|
|
2
|
+
//! calls answer an errno, whether a Filesystem, a socket, or a wait refused it.
|
|
3
|
+
|
|
4
|
+
use std::io;
|
|
5
|
+
|
|
6
|
+
/// Why a call failed, for the ABI above to encode as its error code.
|
|
7
|
+
#[derive(Clone, Debug, PartialEq, Eq)]
|
|
8
|
+
#[non_exhaustive]
|
|
9
|
+
pub enum Errno {
|
|
10
|
+
NotFound,
|
|
11
|
+
AlreadyExists,
|
|
12
|
+
NotADirectory,
|
|
13
|
+
IsADirectory,
|
|
14
|
+
DirectoryNotEmpty,
|
|
15
|
+
PermissionDenied,
|
|
16
|
+
ReadOnlyFilesystem,
|
|
17
|
+
InvalidInput,
|
|
18
|
+
Unsupported,
|
|
19
|
+
/// A change past what the Filesystem can hold.
|
|
20
|
+
StorageFull,
|
|
21
|
+
/// A change past the space the host lets its user hold.
|
|
22
|
+
QuotaExceeded,
|
|
23
|
+
/// A file grown past the largest the Filesystem keeps.
|
|
24
|
+
FileTooLarge,
|
|
25
|
+
/// A link past the most a file may have.
|
|
26
|
+
TooManyLinks,
|
|
27
|
+
/// A write to a program the host is running.
|
|
28
|
+
ExecutableFileBusy,
|
|
29
|
+
/// A move that cannot happen in one step, as between two devices.
|
|
30
|
+
CrossesDevices,
|
|
31
|
+
/// A path that is absolute, climbs above the directory it is resolved
|
|
32
|
+
/// beneath, or holds a link that does either, as `openat2`'s
|
|
33
|
+
/// `RESOLVE_BENEATH` refuses one. Linux names it EXDEV as well, and an ABI
|
|
34
|
+
/// may have a code of its own for it.
|
|
35
|
+
Escape,
|
|
36
|
+
/// A call that would wait on a lock its own thread holds.
|
|
37
|
+
Deadlock,
|
|
38
|
+
/// A symbolic link where the call asked to follow none.
|
|
39
|
+
FilesystemLoop,
|
|
40
|
+
/// A call only a privileged caller may make, as apart from one the
|
|
41
|
+
/// file's permissions deny.
|
|
42
|
+
NotPermitted,
|
|
43
|
+
BadDescriptor,
|
|
44
|
+
ResourceBusy,
|
|
45
|
+
/// Bytes that are no valid character where the call needs one.
|
|
46
|
+
IllegalSequence,
|
|
47
|
+
Interrupted,
|
|
48
|
+
/// A call to make again, as a walk a move landed in answers.
|
|
49
|
+
WouldBlock,
|
|
50
|
+
TooManyOpenFiles,
|
|
51
|
+
/// A host whose own table of open files is full.
|
|
52
|
+
TooManyOpenFilesInSystem,
|
|
53
|
+
/// A name too long for the Filesystem.
|
|
54
|
+
InvalidFilename,
|
|
55
|
+
OutOfMemory,
|
|
56
|
+
NotASocket,
|
|
57
|
+
/// A value too large for the type the call answers in.
|
|
58
|
+
ValueTooLarge,
|
|
59
|
+
NotSeekable,
|
|
60
|
+
/// A call the kind of file it reached cannot take, as a device that
|
|
61
|
+
/// allocates nothing.
|
|
62
|
+
NoSuchDevice,
|
|
63
|
+
/// A directory a lookup found standing elsewhere, which could not be moved
|
|
64
|
+
/// to the name it was found under.
|
|
65
|
+
StaleNetworkFileHandle,
|
|
66
|
+
/// A peer that refused the connection.
|
|
67
|
+
ConnectionRefused,
|
|
68
|
+
/// A peer that reset the connection.
|
|
69
|
+
ConnectionReset,
|
|
70
|
+
/// A connection the host gave up on.
|
|
71
|
+
ConnectionAborted,
|
|
72
|
+
/// A connect or a read past its time.
|
|
73
|
+
TimedOut,
|
|
74
|
+
HostUnreachable,
|
|
75
|
+
NetworkUnreachable,
|
|
76
|
+
/// A network the host holds no working link to.
|
|
77
|
+
NetworkDown,
|
|
78
|
+
/// A peer host the network reports down.
|
|
79
|
+
HostDown,
|
|
80
|
+
/// A host that is on no network, an errno only Linux gives.
|
|
81
|
+
MachineNotOnNetwork,
|
|
82
|
+
/// Buffer room the host ran out of for a socket.
|
|
83
|
+
NoBufferSpace,
|
|
84
|
+
/// A local address the host cannot hand out.
|
|
85
|
+
AddressNotAvailable,
|
|
86
|
+
/// A local address another socket holds.
|
|
87
|
+
AddressInUse,
|
|
88
|
+
/// A write to a connection whose writing side is shut down.
|
|
89
|
+
BrokenPipe,
|
|
90
|
+
/// A call that needs a connection on a socket that has none.
|
|
91
|
+
NotConnected,
|
|
92
|
+
/// A send on a datagram socket naming no peer.
|
|
93
|
+
DestinationAddressRequired,
|
|
94
|
+
/// A datagram past what one can carry.
|
|
95
|
+
MessageTooLong,
|
|
96
|
+
/// A connect on a socket already connected.
|
|
97
|
+
AlreadyConnected,
|
|
98
|
+
/// A connect still under way.
|
|
99
|
+
InProgress,
|
|
100
|
+
/// A connect asked again while one is under way.
|
|
101
|
+
AlreadyInProgress,
|
|
102
|
+
AddressFamilyNotSupported,
|
|
103
|
+
/// A socket option its protocol does not have.
|
|
104
|
+
ProtocolNotAvailable,
|
|
105
|
+
/// Any other failure, with what the Filesystem knows of it.
|
|
106
|
+
Other(String),
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
/// A failure riding inside an I/O error through a library that carries only
|
|
110
|
+
/// `io::Error`, so `Errno::from_io_error` reads back the very one it was.
|
|
111
|
+
#[derive(Debug)]
|
|
112
|
+
pub(crate) struct CarriedErrno(pub(crate) Errno);
|
|
113
|
+
|
|
114
|
+
impl std::fmt::Display for CarriedErrno {
|
|
115
|
+
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
|
116
|
+
write!(f, "{:?}", self.0)
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
impl std::error::Error for CarriedErrno {}
|
|
121
|
+
|
|
122
|
+
/// Each failure a Filesystem can name under the POSIX error name it stands for.
|
|
123
|
+
/// `ENOTSUP` comes before `EOPNOTSUPP`, a name some hosts give the same error,
|
|
124
|
+
/// so `Unsupported` answers to the first.
|
|
125
|
+
const POSIX_NAMES: [(&str, Errno); 54] = [
|
|
126
|
+
("EAGAIN", Errno::WouldBlock),
|
|
127
|
+
("ENOENT", Errno::NotFound),
|
|
128
|
+
("EEXIST", Errno::AlreadyExists),
|
|
129
|
+
("ENOTDIR", Errno::NotADirectory),
|
|
130
|
+
("EISDIR", Errno::IsADirectory),
|
|
131
|
+
("ENOTEMPTY", Errno::DirectoryNotEmpty),
|
|
132
|
+
("EACCES", Errno::PermissionDenied),
|
|
133
|
+
("EROFS", Errno::ReadOnlyFilesystem),
|
|
134
|
+
("EINVAL", Errno::InvalidInput),
|
|
135
|
+
("ENOTSUP", Errno::Unsupported),
|
|
136
|
+
("EOPNOTSUPP", Errno::Unsupported),
|
|
137
|
+
("ENOSPC", Errno::StorageFull),
|
|
138
|
+
("EDQUOT", Errno::QuotaExceeded),
|
|
139
|
+
("EFBIG", Errno::FileTooLarge),
|
|
140
|
+
("EMLINK", Errno::TooManyLinks),
|
|
141
|
+
("ETXTBSY", Errno::ExecutableFileBusy),
|
|
142
|
+
("EXDEV", Errno::CrossesDevices),
|
|
143
|
+
("EDEADLK", Errno::Deadlock),
|
|
144
|
+
("ELOOP", Errno::FilesystemLoop),
|
|
145
|
+
("EPERM", Errno::NotPermitted),
|
|
146
|
+
("EBADF", Errno::BadDescriptor),
|
|
147
|
+
("EBUSY", Errno::ResourceBusy),
|
|
148
|
+
("EILSEQ", Errno::IllegalSequence),
|
|
149
|
+
("EINTR", Errno::Interrupted),
|
|
150
|
+
("EMFILE", Errno::TooManyOpenFiles),
|
|
151
|
+
("ENFILE", Errno::TooManyOpenFilesInSystem),
|
|
152
|
+
("ENAMETOOLONG", Errno::InvalidFilename),
|
|
153
|
+
("ENOMEM", Errno::OutOfMemory),
|
|
154
|
+
("ENOTSOCK", Errno::NotASocket),
|
|
155
|
+
("EOVERFLOW", Errno::ValueTooLarge),
|
|
156
|
+
("ESPIPE", Errno::NotSeekable),
|
|
157
|
+
("ENODEV", Errno::NoSuchDevice),
|
|
158
|
+
("ESTALE", Errno::StaleNetworkFileHandle),
|
|
159
|
+
("ECONNREFUSED", Errno::ConnectionRefused),
|
|
160
|
+
("ECONNRESET", Errno::ConnectionReset),
|
|
161
|
+
("ECONNABORTED", Errno::ConnectionAborted),
|
|
162
|
+
("ETIMEDOUT", Errno::TimedOut),
|
|
163
|
+
("EHOSTUNREACH", Errno::HostUnreachable),
|
|
164
|
+
("ENETUNREACH", Errno::NetworkUnreachable),
|
|
165
|
+
("ENETDOWN", Errno::NetworkDown),
|
|
166
|
+
("EHOSTDOWN", Errno::HostDown),
|
|
167
|
+
("ENONET", Errno::MachineNotOnNetwork),
|
|
168
|
+
("ENOBUFS", Errno::NoBufferSpace),
|
|
169
|
+
("EADDRNOTAVAIL", Errno::AddressNotAvailable),
|
|
170
|
+
("EADDRINUSE", Errno::AddressInUse),
|
|
171
|
+
("EPIPE", Errno::BrokenPipe),
|
|
172
|
+
("ENOTCONN", Errno::NotConnected),
|
|
173
|
+
("EDESTADDRREQ", Errno::DestinationAddressRequired),
|
|
174
|
+
("EMSGSIZE", Errno::MessageTooLong),
|
|
175
|
+
("EISCONN", Errno::AlreadyConnected),
|
|
176
|
+
("EINPROGRESS", Errno::InProgress),
|
|
177
|
+
("EALREADY", Errno::AlreadyInProgress),
|
|
178
|
+
("EAFNOSUPPORT", Errno::AddressFamilyNotSupported),
|
|
179
|
+
("ENOPROTOOPT", Errno::ProtocolNotAvailable),
|
|
180
|
+
];
|
|
181
|
+
|
|
182
|
+
impl Errno {
|
|
183
|
+
/// The failure a host call's `err` stands for: the one it carries through
|
|
184
|
+
/// a library, else the host's errno where std names no kind for it or
|
|
185
|
+
/// folds it into another's, as wasmtime-wasi reads a host errno first,
|
|
186
|
+
/// else its kind. One with none carries only its kind, so no host text reaches
|
|
187
|
+
/// the guest. A layer knowing what a failure means within it, as a Bind
|
|
188
|
+
/// names cap-std's refusal, answers that before asking this.
|
|
189
|
+
pub(crate) fn from_io_error(err: &io::Error) -> Self {
|
|
190
|
+
if let Some(CarriedErrno(carried)) = err
|
|
191
|
+
.get_ref()
|
|
192
|
+
.and_then(|inner| inner.downcast_ref::<CarriedErrno>())
|
|
193
|
+
{
|
|
194
|
+
return carried.clone();
|
|
195
|
+
}
|
|
196
|
+
use rustix::io::Errno as HostErrno;
|
|
197
|
+
match HostErrno::from_io_error(err) {
|
|
198
|
+
Some(HostErrno::NOBUFS) => return Self::NoBufferSpace,
|
|
199
|
+
Some(HostErrno::DESTADDRREQ) => return Self::DestinationAddressRequired,
|
|
200
|
+
Some(HostErrno::NOPROTOOPT) => return Self::ProtocolNotAvailable,
|
|
201
|
+
Some(HostErrno::MFILE) => return Self::TooManyOpenFiles,
|
|
202
|
+
#[cfg(not(windows))]
|
|
203
|
+
Some(HostErrno::NFILE) => return Self::TooManyOpenFilesInSystem,
|
|
204
|
+
Some(HostErrno::MSGSIZE) => return Self::MessageTooLong,
|
|
205
|
+
Some(HostErrno::AFNOSUPPORT) => return Self::AddressFamilyNotSupported,
|
|
206
|
+
Some(HostErrno::HOSTDOWN) => return Self::HostDown,
|
|
207
|
+
#[cfg(target_os = "linux")]
|
|
208
|
+
Some(HostErrno::NONET) => return Self::MachineNotOnNetwork,
|
|
209
|
+
#[cfg(not(windows))]
|
|
210
|
+
Some(HostErrno::PERM) => return Self::NotPermitted,
|
|
211
|
+
#[cfg(not(windows))]
|
|
212
|
+
Some(HostErrno::LOOP) => return Self::FilesystemLoop,
|
|
213
|
+
#[cfg(not(windows))]
|
|
214
|
+
Some(HostErrno::BADF) => return Self::BadDescriptor,
|
|
215
|
+
#[cfg(not(windows))]
|
|
216
|
+
Some(HostErrno::OVERFLOW) => return Self::ValueTooLarge,
|
|
217
|
+
#[cfg(not(windows))]
|
|
218
|
+
Some(HostErrno::NODEV) => return Self::NoSuchDevice,
|
|
219
|
+
#[cfg(not(windows))]
|
|
220
|
+
Some(HostErrno::STALE) => return Self::StaleNetworkFileHandle,
|
|
221
|
+
#[cfg(not(windows))]
|
|
222
|
+
Some(HostErrno::ILSEQ) => return Self::IllegalSequence,
|
|
223
|
+
#[cfg(not(windows))]
|
|
224
|
+
#[allow(
|
|
225
|
+
unreachable_patterns,
|
|
226
|
+
reason = "Linux gives EOPNOTSUPP ENOTSUP's number"
|
|
227
|
+
)]
|
|
228
|
+
Some(HostErrno::NOTSUP | HostErrno::OPNOTSUPP) => return Self::Unsupported,
|
|
229
|
+
_ => {}
|
|
230
|
+
}
|
|
231
|
+
// A file another process holds open without sharing it, which
|
|
232
|
+
// wasmtime-wasi answers as access denied.
|
|
233
|
+
#[cfg(windows)]
|
|
234
|
+
if err.raw_os_error()
|
|
235
|
+
== Some(windows_sys::Win32::Foundation::ERROR_SHARING_VIOLATION as i32)
|
|
236
|
+
{
|
|
237
|
+
return Self::PermissionDenied;
|
|
238
|
+
}
|
|
239
|
+
Self::from_io_kind(err.kind()).unwrap_or_else(|| Self::Other(format!("{:?}", err.kind())))
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
/// The failure a host call's `kind` stands for, as std names the errno it
|
|
243
|
+
/// read; `None` for a kind std names no POSIX error for.
|
|
244
|
+
pub(crate) fn from_io_kind(kind: io::ErrorKind) -> Option<Self> {
|
|
245
|
+
use io::ErrorKind as Kind;
|
|
246
|
+
Some(match kind {
|
|
247
|
+
Kind::NotFound => Self::NotFound,
|
|
248
|
+
Kind::AlreadyExists => Self::AlreadyExists,
|
|
249
|
+
Kind::NotADirectory => Self::NotADirectory,
|
|
250
|
+
Kind::IsADirectory => Self::IsADirectory,
|
|
251
|
+
Kind::DirectoryNotEmpty => Self::DirectoryNotEmpty,
|
|
252
|
+
Kind::PermissionDenied => Self::PermissionDenied,
|
|
253
|
+
Kind::ReadOnlyFilesystem => Self::ReadOnlyFilesystem,
|
|
254
|
+
Kind::InvalidInput => Self::InvalidInput,
|
|
255
|
+
Kind::Unsupported => Self::Unsupported,
|
|
256
|
+
Kind::StorageFull => Self::StorageFull,
|
|
257
|
+
Kind::QuotaExceeded => Self::QuotaExceeded,
|
|
258
|
+
Kind::FileTooLarge => Self::FileTooLarge,
|
|
259
|
+
Kind::TooManyLinks => Self::TooManyLinks,
|
|
260
|
+
Kind::ExecutableFileBusy => Self::ExecutableFileBusy,
|
|
261
|
+
Kind::CrossesDevices => Self::CrossesDevices,
|
|
262
|
+
Kind::Deadlock => Self::Deadlock,
|
|
263
|
+
Kind::ResourceBusy => Self::ResourceBusy,
|
|
264
|
+
Kind::InvalidFilename => Self::InvalidFilename,
|
|
265
|
+
Kind::NotSeekable => Self::NotSeekable,
|
|
266
|
+
Kind::Interrupted => Self::Interrupted,
|
|
267
|
+
Kind::WouldBlock => Self::WouldBlock,
|
|
268
|
+
Kind::OutOfMemory => Self::OutOfMemory,
|
|
269
|
+
Kind::NetworkDown => Self::NetworkDown,
|
|
270
|
+
Kind::ConnectionRefused => Self::ConnectionRefused,
|
|
271
|
+
Kind::ConnectionReset => Self::ConnectionReset,
|
|
272
|
+
Kind::ConnectionAborted => Self::ConnectionAborted,
|
|
273
|
+
Kind::TimedOut => Self::TimedOut,
|
|
274
|
+
Kind::HostUnreachable => Self::HostUnreachable,
|
|
275
|
+
Kind::NetworkUnreachable => Self::NetworkUnreachable,
|
|
276
|
+
Kind::AddrNotAvailable => Self::AddressNotAvailable,
|
|
277
|
+
Kind::AddrInUse => Self::AddressInUse,
|
|
278
|
+
Kind::BrokenPipe => Self::BrokenPipe,
|
|
279
|
+
Kind::NotConnected => Self::NotConnected,
|
|
280
|
+
_ => return None,
|
|
281
|
+
})
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
/// The POSIX error name this failure stands for, as `ENOENT`. `Other`
|
|
285
|
+
/// has none, and `Escape` shares `CrossesDevices`'s.
|
|
286
|
+
pub fn posix_name(&self) -> Option<&'static str> {
|
|
287
|
+
if *self == Self::Escape {
|
|
288
|
+
return Some("EXDEV");
|
|
289
|
+
}
|
|
290
|
+
POSIX_NAMES
|
|
291
|
+
.iter()
|
|
292
|
+
.find(|(_, error)| error == self)
|
|
293
|
+
.map(|(name, _)| *name)
|
|
294
|
+
}
|
|
295
|
+
|
|
296
|
+
/// The failure a POSIX error name stands for, if it is one of these.
|
|
297
|
+
pub fn from_posix_name(name: &str) -> Option<Self> {
|
|
298
|
+
POSIX_NAMES
|
|
299
|
+
.iter()
|
|
300
|
+
.find(|(known, _)| *known == name)
|
|
301
|
+
.map(|(_, error)| error.clone())
|
|
302
|
+
}
|
|
303
|
+
}
|
|
304
|
+
|
|
305
|
+
#[cfg(test)]
|
|
306
|
+
mod tests {
|
|
307
|
+
use super::*;
|
|
308
|
+
|
|
309
|
+
#[test]
|
|
310
|
+
fn every_posix_name_answers_back_to_its_failure() {
|
|
311
|
+
for (name, error) in &POSIX_NAMES {
|
|
312
|
+
assert_eq!(
|
|
313
|
+
Errno::from_posix_name(name)
|
|
314
|
+
.as_ref()
|
|
315
|
+
.and_then(Errno::posix_name)
|
|
316
|
+
.and_then(Errno::from_posix_name),
|
|
317
|
+
Some(error.clone()),
|
|
318
|
+
"{name} through Errno::from_posix_name and posix_name must name {error:?} again"
|
|
319
|
+
);
|
|
320
|
+
}
|
|
321
|
+
assert_eq!(
|
|
322
|
+
(
|
|
323
|
+
Errno::Unsupported.posix_name(),
|
|
324
|
+
Errno::Other("x".into()).posix_name()
|
|
325
|
+
),
|
|
326
|
+
(Some("ENOTSUP"), None),
|
|
327
|
+
"Unsupported through Errno::posix_name must answer ENOTSUP, and Other none"
|
|
328
|
+
);
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
// @behavior NW-074
|
|
332
|
+
#[test]
|
|
333
|
+
fn a_host_socket_failure_answers_the_posix_name_its_errno_holds() {
|
|
334
|
+
use rustix::io::Errno as HostErrno;
|
|
335
|
+
let answers = [
|
|
336
|
+
HostErrno::NETDOWN,
|
|
337
|
+
HostErrno::NOBUFS,
|
|
338
|
+
HostErrno::HOSTDOWN,
|
|
339
|
+
HostErrno::DESTADDRREQ,
|
|
340
|
+
HostErrno::NOPROTOOPT,
|
|
341
|
+
HostErrno::MFILE,
|
|
342
|
+
HostErrno::MSGSIZE,
|
|
343
|
+
HostErrno::AFNOSUPPORT,
|
|
344
|
+
HostErrno::AGAIN,
|
|
345
|
+
HostErrno::INVAL,
|
|
346
|
+
]
|
|
347
|
+
.map(|errno| Errno::from_io_error(&io::Error::from_raw_os_error(errno.raw_os_error())));
|
|
348
|
+
assert_eq!(
|
|
349
|
+
answers,
|
|
350
|
+
[
|
|
351
|
+
Errno::NetworkDown,
|
|
352
|
+
Errno::NoBufferSpace,
|
|
353
|
+
Errno::HostDown,
|
|
354
|
+
Errno::DestinationAddressRequired,
|
|
355
|
+
Errno::ProtocolNotAvailable,
|
|
356
|
+
Errno::TooManyOpenFiles,
|
|
357
|
+
Errno::MessageTooLong,
|
|
358
|
+
Errno::AddressFamilyNotSupported,
|
|
359
|
+
Errno::WouldBlock,
|
|
360
|
+
Errno::InvalidInput
|
|
361
|
+
],
|
|
362
|
+
"a host socket failing with ENETDOWN, ENOBUFS, EHOSTDOWN, EDESTADDRREQ, ENOPROTOOPT, \
|
|
363
|
+
EMFILE, EMSGSIZE, EAFNOSUPPORT, EAGAIN, or EINVAL must answer that same name on \
|
|
364
|
+
every host, read from its errno where std names no kind"
|
|
365
|
+
);
|
|
366
|
+
}
|
|
367
|
+
|
|
368
|
+
// @behavior NW-074
|
|
369
|
+
#[cfg(unix)]
|
|
370
|
+
#[test]
|
|
371
|
+
fn a_host_out_of_open_files_answers_enfile() {
|
|
372
|
+
let errno = rustix::io::Errno::NFILE.raw_os_error();
|
|
373
|
+
assert_eq!(
|
|
374
|
+
Errno::from_io_error(&io::Error::from_raw_os_error(errno)),
|
|
375
|
+
Errno::TooManyOpenFilesInSystem,
|
|
376
|
+
"a host socket failing with ENFILE must answer ENFILE, which Windows has no code for"
|
|
377
|
+
);
|
|
378
|
+
}
|
|
379
|
+
|
|
380
|
+
// @behavior NW-074
|
|
381
|
+
#[cfg(target_os = "linux")]
|
|
382
|
+
#[test]
|
|
383
|
+
fn a_host_off_the_network_answers_enonet() {
|
|
384
|
+
let errno = rustix::io::Errno::NONET.raw_os_error();
|
|
385
|
+
assert_eq!(
|
|
386
|
+
Errno::from_io_error(&io::Error::from_raw_os_error(errno)),
|
|
387
|
+
Errno::MachineNotOnNetwork,
|
|
388
|
+
"a host socket failing with ENONET must answer ENONET, an errno only Linux gives"
|
|
389
|
+
);
|
|
390
|
+
}
|
|
391
|
+
}
|