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,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 `__kobako_upcall` to
4
- //! `dispatch::handle`.
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 capture::{clip_capture, pipe_capacity};
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, request_of,
25
- stdin_content, write_request,
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 ABI version it reports is the host's;
36
- /// `None` means it exports none. Only rebuilding the artifact fixes either
37
- /// refusal, so both are `Dead` and say so.
38
- pub fn verify_abi_version(reported: Option<u32>) -> Result<(), SetupError> {
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 does not export __kobako_abi_version; \
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 of an
59
- /// Engine, from the invocation body and from inside `__kobako_upcall` alike.
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
- /// Allocate `len` bytes through `__kobako_alloc`, answering the address,
73
- /// or 0 where the guest has none to give.
74
- fn alloc(&mut self, len: u32) -> Option<Result<u32, Self::Fault>>;
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 `__kobako_downcall` with a request at `ptr`, answering the packed
77
- /// `(ptr, len)` of its answer.
78
- fn downcall(&mut self, ptr: i32, len: i32) -> Option<Result<u64, Self::Fault>>;
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 cap_trap(fault: &Self::Fault) -> Option<Trap>;
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::abi::unpack_ptr_len;
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 alloc(&mut self, len: u32) -> Option<Result<u32, String>> {
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<u64, String>> {
132
+ fn downcall(&mut self, _ptr: i32, _len: i32) -> Option<Result<u32, String>> {
119
133
  None
120
134
  }
121
135
 
122
- fn cap_trap(_fault: &String) -> Option<Trap> {
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
- matches!(reply, Ok(Reply::Unsupported(_))),
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
+ }