mirror of
https://github.com/VallierDev/uu-remote-linux.git
synced 2026-11-16 16:50:41 +01:00
Compare commits
No files matched your search
@@ -32,8 +32,8 @@ body:
|
|||||||
attributes:
|
attributes:
|
||||||
label: 诊断信息 / Diagnostics
|
label: 诊断信息 / Diagnostics
|
||||||
description: |
|
description: |
|
||||||
先复现一次问题,然后在被控的 Linux 上运行下面的命令,把输出粘贴到这里(IP 会被自动抹掉,不包含密码、令牌或剪贴板内容)。
|
先复现一次问题,然后在被控 Linux 的**图形桌面里打开的终端**中运行下面的命令(SSH 或 tty 里缺少桌面环境变量,doctor 结果不准),把输出粘贴到这里(IPv4/IPv6/MAC 地址会被自动抹掉,不包含密码、令牌或剪贴板内容)。
|
||||||
Reproduce the problem, then run this on the Linux host and paste the output (IPs are masked; no passwords, tokens or clipboard data).
|
Reproduce the problem, then run this in a terminal **inside the Linux graphical session** (SSH/tty lacks the desktop environment, so doctor would be misleading) and paste the output (IPv4/IPv6/MAC addresses are masked; no passwords, tokens or clipboard data).
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
{
|
{
|
||||||
@@ -45,8 +45,9 @@ body:
|
|||||||
echo "== 显卡"; lspci 2>/dev/null | grep -iE 'vga|3d'
|
echo "== 显卡"; lspci 2>/dev/null | grep -iE 'vga|3d'
|
||||||
echo "== FFmpeg"; ffmpeg -hide_banner -encoders 2>/dev/null | grep -E 'h264_nvenc|libx264'
|
echo "== FFmpeg"; ffmpeg -hide_banner -encoders 2>/dev/null | grep -E 'h264_nvenc|libx264'
|
||||||
echo "== 日志"; journalctl --user -u uuremote-native.service --since "-30min" --no-pager -o cat \
|
echo "== 日志"; journalctl --user -u uuremote-native.service --since "-30min" --no-pager -o cat \
|
||||||
| grep -E 'Starting|backend|Selected capture|Desktop encoder|Capture setting request|Desktop video settings|Offer for connection|WARN|ERROR' | tail -n 80
|
| grep -E 'Starting|backend|Selected capture|Desktop encoder|Capture setting request|Desktop video settings|Offer for connection|PeerConnection State|Remote controller disconnected|ICE path|Port mapping|WARN|ERROR' \
|
||||||
} 2>&1 | sed -E 's/[0-9]{1,3}(\.[0-9]{1,3}){3}/x.x.x.x/g'
|
| grep -vE 'webrtc_ice|webrtc_dtls|webrtc::mux' | tail -n 120
|
||||||
|
} 2>&1 | sed -E 's/[0-9]{1,3}(\.[0-9]{1,3}){3}/x.x.x.x/g; s/([0-9a-fA-F]{1,4}:){4,7}[0-9a-fA-F]{1,4}|[0-9a-fA-F]{0,4}::[0-9a-fA-F:]*[0-9a-fA-F]/x:x::x/g'
|
||||||
```
|
```
|
||||||
render: text
|
render: text
|
||||||
validations:
|
validations:
|
||||||
|
|||||||
@@ -117,8 +117,9 @@ viewer does not reconnect them automatically.
|
|||||||
| Item | Meaning |
|
| Item | Meaning |
|
||||||
|---|---|
|
|---|---|
|
||||||
| `~/.config/uuremote/config.json` | user_id, device_id, client_id, system_id, machine_guid, token, csrf; optional `sign_key`, `ffmpeg_root`. `$UU_CONFIG` overrides the path |
|
| `~/.config/uuremote/config.json` | user_id, device_id, client_id, system_id, machine_guid, token, csrf; optional `sign_key`, `ffmpeg_root`. `$UU_CONFIG` overrides the path |
|
||||||
| `~/.config/uuremote/host_settings.json` | persisted 安全 settings: auto_lock, keep_mute, mute_permanent; optional `video_encoder` (`auto`/`cpu`/`vaapi`/`nvenc`) and `video_codec` (`auto`/`h264`/`h265`), written by `set-encoder` / `set-codec` (0600, merge write). Non-`auto` beats `UU_VIDEO_ENCODER` / `UU_VIDEO_CODEC`. Applied on the next desktop stream |
|
| `~/.config/uuremote/host_settings.json` | persisted 安全 settings: auto_lock, keep_mute, mute_permanent; optional `video_encoder` (`auto`/`cpu`/`vaapi`/`nvenc`) and `video_codec` (`auto`/`h264`/`h265`), written by `set-encoder` / `set-codec` (0600, merge write). Non-`auto` beats `UU_VIDEO_ENCODER` / `UU_VIDEO_CODEC`. `set-encoder` and `set-codec` both send `SIGUSR2` to the pid in `host.pid` (same binary). Live desktop streams restart the encoder (`EncoderTask::restart`, sequence kept, first frame IDR) without dropping the peer. Codec preference is logged and applies on the next desktop stream. `SIGUSR2` does not re-probe. Hand edits: `kill -USR2 $(cat ~/.config/uuremote/host.pid)` |
|
||||||
| `UU_DESKTOP_BACKEND` | `auto` (default) / `x11` / `wayland` / `portal` / `kms` (experimental feature) / `none` (headless: no display; desktop offers ignored; tool peers get a nominal 1920x1080 screen + Allow permissions, which the port-mapping viewer requires) |
|
| `UU_DESKTOP_BACKEND` | `auto` (default) / `x11` / `wayland` / `portal` / `kms` (experimental feature) / `none` (headless: no display; desktop offers ignored; tool peers get a nominal 1920x1080 screen + Allow permissions, which the port-mapping viewer requires) |
|
||||||
|
| `UU_X11_MULTISCREEN=1`, `UU_X11_OUTPUT` | X11: advertise each RandR monitor (`xrandr --listmonitors`, read once at start; primary or `UU_X11_OUTPUT` is id 0) through the same screen-switch path as `UU_WAYLAND_MULTISCREEN` (`wayland::outputs`/`select`). x11grab reads `display+x,y` at the monitor size, XTest/uinput absolute input adds the monitor offset, the in-process engine and `desktop_mode` resize are skipped (分辨率 scales). Needs two or more monitors |
|
||||||
| `UU_DESKTOP_RESIZE=0` | X11: the viewer's 分辨率 choice scales the encoded stream instead of changing the display mode. Default: `src/desktop_mode.rs` switches the primary output via xrandr (adds a CVT-RB mode when missing, re-applies once if mutter resets it), restores the original mode for resolution_type 3 and 2 s after the last desktop stream ends |
|
| `UU_DESKTOP_RESIZE=0` | X11: the viewer's 分辨率 choice scales the encoded stream instead of changing the display mode. Default: `src/desktop_mode.rs` switches the primary output via xrandr (adds a CVT-RB mode when missing, re-applies once if mutter resets it), restores the original mode for resolution_type 3 and 2 s after the last desktop stream ends |
|
||||||
| `UU_NVENC_RGB=0` / `=1` | NVENC 4:2:0 without scaling takes packed BGRA/BGR0 directly (no CPU swscale). Default: on, except when a connected DRM connector belongs to an nvidia-bound card (desktop composited on the encoding GPU; #16 measured 82.6 vs 98 fps at 4K). `0` forces CPU conversion, `1` forces the direct path |
|
| `UU_NVENC_RGB=0` / `=1` | NVENC 4:2:0 without scaling takes packed BGRA/BGR0 directly (no CPU swscale). Default: on, except when a connected DRM connector belongs to an nvidia-bound card (desktop composited on the encoding GPU; #16 measured 82.6 vs 98 fps at 4K). `0` forces CPU conversion, `1` forces the direct path |
|
||||||
| `UU_INPUT_BACKEND` | `auto` (uinput on Wayland/portal when `/dev/uinput` is accessible, udev `uaccess` rule in README) / `uinput` / `native`. X11 keeps XTest (held-key autorepeat handling) |
|
| `UU_INPUT_BACKEND` | `auto` (uinput on Wayland/portal when `/dev/uinput` is accessible, udev `uaccess` rule in README) / `uinput` / `native`. X11 keeps XTest (held-key autorepeat handling) |
|
||||||
@@ -132,7 +133,7 @@ viewer does not reconnect them automatically.
|
|||||||
| `UU_LOGIN_WINDOW=0` | don't auto-open the login window |
|
| `UU_LOGIN_WINDOW=0` | don't auto-open the login window |
|
||||||
| `UU_ENGINE_DIR` | directory holding `libuu-wayland.so` / `libuu-portal.so` (`--features engine-plugins`, used by release packages: engines are dlopen'ed only on Wayland sessions; also searched next to the binary, `../lib/uu-remote-linux`, `~/.local/lib/uu-remote-linux`, `/usr/lib/uu-remote-linux`) |
|
| `UU_ENGINE_DIR` | directory holding `libuu-wayland.so` / `libuu-portal.so` (`--features engine-plugins`, used by release packages: engines are dlopen'ed only on Wayland sessions; also searched next to the binary, `../lib/uu-remote-linux`, `~/.local/lib/uu-remote-linux`, `/usr/lib/uu-remote-linux`) |
|
||||||
| `UU_WOL_HELPER=1` | experimental: report LAN info (`api-ipv4…/api/v1/device/wake_on_lan/info` {mac, ip, subnet_mask}) after sign-in and answer `wake_on_lan` pushes (`target_device` {mac, ip, subnet_mask}) with a magic packet, like the official Windows host (field names from its log strings; not verified end to end). `wake_on_lan` push key names are always logged |
|
| `UU_WOL_HELPER=1` | experimental: report LAN info (`api-ipv4…/api/v1/device/wake_on_lan/info` {mac, ip, subnet_mask}) after sign-in and answer `wake_on_lan` pushes (`target_device` {mac, ip, subnet_mask}) with a magic packet, like the official Windows host (field names from its log strings; not verified end to end). `wake_on_lan` push key names are always logged |
|
||||||
| `UU_USE_PROXY=1` | honor HTTP/SOCKS proxy env vars; cloud API clients bypass env proxies by default |
|
| `UU_USE_PROXY=1` | honor HTTP/HTTPS proxy env vars for REST and WebSocket signaling, and also gather TURN relays over TCP/TLS through that proxy (`vendor/webrtc-ice/PATCHES.md`; chain-verified, name mismatch tolerated for IP TURN URLs); clients bypass env proxies by default |
|
||||||
| `UU_REMOTE_ASSIST=0`, `UU_ASSIST_ALLOW=1`, `UU_ASSIST_UI=tty`, `UU_ASSIST_DEBUG=1` | disable assistance / allow at start / terminal UI for `assist` / include the server's short error message in assist errors |
|
| `UU_REMOTE_ASSIST=0`, `UU_ASSIST_ALLOW=1`, `UU_ASSIST_UI=tty`, `UU_ASSIST_DEBUG=1` | disable assistance / allow at start / terminal UI for `assist` / include the server's short error message in assist errors |
|
||||||
|
|
||||||
Token has no expiry field; API code 1120 (HTTP 422) means invalid/expired → re-login. `config.json` is parsed once
|
Token has no expiry field; API code 1120 (HTTP 422) means invalid/expired → re-login. `config.json` is parsed once
|
||||||
@@ -168,7 +169,7 @@ for a new QR login.
|
|||||||
| `src/viewer_main.rs`, `src/viewer/` | experimental viewer (`--features native-viewer,viewer-sdl`): cloud join, WebRTC offer side, SDL desktop window (ffmpeg CLI decode), files/terminal/portmap/power/assist tools, device removal (`POST /api/v1/device/{id}/unbind`, verified live; shared devices use `/api/v1/device/share/{id}/unbind`, strings only), GTK launcher |
|
| `src/viewer_main.rs`, `src/viewer/` | experimental viewer (`--features native-viewer,viewer-sdl`): cloud join, WebRTC offer side, SDL desktop window (ffmpeg CLI decode), files/terminal/portmap/power/assist tools, device removal (`POST /api/v1/device/{id}/unbind`, verified live; shared devices use `/api/v1/device/share/{id}/unbind`, strings only), GTK launcher |
|
||||||
| `c_engine/viewer_window.c`, `c_engine/viewer_tools.c` | viewer GTK launcher and tool windows (files, port mapping, terminal list) |
|
| `c_engine/viewer_window.c`, `c_engine/viewer_tools.c` | viewer GTK launcher and tool windows (files, port mapping, terminal list) |
|
||||||
|
|
||||||
Diagnostic subcommands: `doctor` (paste-safe report: session, selected backend, engine plugins, uinput, encoder and codec with source, sign-in/service state; booleans and names only), `set-encoder auto|cpu|vaapi|nvenc`, `set-codec auto|h264|h265` (next desktop stream; illegal values exit 2), `login [--no-gui]`, `unlock-check` (password on stdin, prints only accepted/rejected),
|
Diagnostic subcommands: `doctor` (paste-safe report: session, selected backend, engine plugins, uinput, encoder and codec with source, sign-in/service state; booleans and names only), `set-encoder auto|cpu|vaapi|nvenc` and `set-codec auto|h264|h265` (both notify a running host with SIGUSR2; live encoder switch, negotiated codec unchanged, codec preference on the next desktop stream; illegal values exit 2), `login [--no-gui]`, `unlock-check` (password on stdin, prints only accepted/rejected),
|
||||||
`desktop-probe [new.png]`, `desktop-video-probe` (`UU_PROBE_FPS`, `UU_PROBE_FRAMES`, `UU_PROBE_QUALITY` 1-5 = viewer bitrate preset, 5 auto; `UU_PROBE_CHROMA=444` 真彩; `UU_PROBE_INPUT` fixed video/image sequence, `UU_PROBE_LOOP=1` repeats), `wayland-input-probe`, `clipboard-acceptance`,
|
`desktop-probe [new.png]`, `desktop-video-probe` (`UU_PROBE_FPS`, `UU_PROBE_FRAMES`, `UU_PROBE_QUALITY` 1-5 = viewer bitrate preset, 5 auto; `UU_PROBE_CHROMA=444` 真彩; `UU_PROBE_INPUT` fixed video/image sequence, `UU_PROBE_LOOP=1` repeats), `wayland-input-probe`, `clipboard-acceptance`,
|
||||||
`portal-acceptance`, `help`. Unknown arguments exit with code 2. Builds up to v0.1.0 did **not** reject them and
|
`portal-acceptance`, `help`. Unknown arguments exit with code 2. Builds up to v0.1.0 did **not** reject them and
|
||||||
started a second full host server instead, so check that a subcommand exists in the binary you run.
|
started a second full host server instead, so check that a subcommand exists in the binary you run.
|
||||||
|
|||||||
Generated
+5
-3
@@ -2741,7 +2741,7 @@ checksum = "06abde3611657adf66d383f00b093d7faecc7fa57071cce2578660c9f1010821"
|
|||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "uu-remote-linux"
|
name = "uu-remote-linux"
|
||||||
version = "0.2.28"
|
version = "0.2.37"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"async-trait",
|
"async-trait",
|
||||||
"base64 0.22.1",
|
"base64 0.22.1",
|
||||||
@@ -2758,12 +2758,14 @@ dependencies = [
|
|||||||
"nix 0.29.0",
|
"nix 0.29.0",
|
||||||
"qrcode",
|
"qrcode",
|
||||||
"rand 0.8.8",
|
"rand 0.8.8",
|
||||||
|
"rcgen",
|
||||||
"reqwest",
|
"reqwest",
|
||||||
"sdl2",
|
"sdl2",
|
||||||
"serde",
|
"serde",
|
||||||
"serde_json",
|
"serde_json",
|
||||||
"sha2",
|
"sha2",
|
||||||
"tokio",
|
"tokio",
|
||||||
|
"tokio-rustls",
|
||||||
"tokio-tungstenite",
|
"tokio-tungstenite",
|
||||||
"webrtc",
|
"webrtc",
|
||||||
"x11rb",
|
"x11rb",
|
||||||
@@ -3008,8 +3010,6 @@ dependencies = [
|
|||||||
[[package]]
|
[[package]]
|
||||||
name = "webrtc-ice"
|
name = "webrtc-ice"
|
||||||
version = "0.10.1"
|
version = "0.10.1"
|
||||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
||||||
checksum = "a1bbd6b3dea22cc6e961e22b012e843d8869e2ac8e76b96e54d4a25e311857ad"
|
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"arc-swap",
|
"arc-swap",
|
||||||
"async-trait",
|
"async-trait",
|
||||||
@@ -3021,10 +3021,12 @@ dependencies = [
|
|||||||
"stun",
|
"stun",
|
||||||
"thiserror 1.0.69",
|
"thiserror 1.0.69",
|
||||||
"tokio",
|
"tokio",
|
||||||
|
"tokio-rustls",
|
||||||
"turn",
|
"turn",
|
||||||
"url",
|
"url",
|
||||||
"uuid",
|
"uuid",
|
||||||
"waitgroup",
|
"waitgroup",
|
||||||
|
"webpki-roots 1.0.9",
|
||||||
"webrtc-mdns",
|
"webrtc-mdns",
|
||||||
"webrtc-util",
|
"webrtc-util",
|
||||||
]
|
]
|
||||||
|
|||||||
+8
-1
@@ -1,6 +1,6 @@
|
|||||||
[package]
|
[package]
|
||||||
name = "uu-remote-linux"
|
name = "uu-remote-linux"
|
||||||
version = "0.2.28"
|
version = "0.2.37"
|
||||||
edition = "2021"
|
edition = "2021"
|
||||||
default-run = "uuremote-server"
|
default-run = "uuremote-server"
|
||||||
authors = ["uu-remote-linux contributors"]
|
authors = ["uu-remote-linux contributors"]
|
||||||
@@ -60,6 +60,11 @@ x11rb = { version = "0.13", features = ["damage", "shm", "allow-unsafe-code"], o
|
|||||||
|
|
||||||
sdl2 = { version = "0.37", optional = true, features = ["use-pkgconfig"] }
|
sdl2 = { version = "0.37", optional = true, features = ["use-pkgconfig"] }
|
||||||
|
|
||||||
|
[dev-dependencies]
|
||||||
|
# Synthetic loopback WSS certificates only; both crates already occur in Cargo.lock.
|
||||||
|
rcgen = "0.11.3"
|
||||||
|
tokio-rustls = { version = "0.26.6", default-features = false, features = ["ring", "tls12"] }
|
||||||
|
|
||||||
[build-dependencies]
|
[build-dependencies]
|
||||||
cc = "1.0"
|
cc = "1.0"
|
||||||
|
|
||||||
@@ -69,6 +74,8 @@ webrtc-srtp = { path = "vendor/webrtc-srtp" }
|
|||||||
webrtc-dtls = { path = "vendor/webrtc-dtls" }
|
webrtc-dtls = { path = "vendor/webrtc-dtls" }
|
||||||
# Larger data-channel receive buffer (see vendor/webrtc/src/data_channel/mod.rs).
|
# Larger data-channel receive buffer (see vendor/webrtc/src/data_channel/mod.rs).
|
||||||
webrtc = { path = "vendor/webrtc" }
|
webrtc = { path = "vendor/webrtc" }
|
||||||
|
# TURN over TCP/TLS through an HTTP CONNECT proxy (vendor/webrtc-ice/PATCHES.md).
|
||||||
|
webrtc-ice = { path = "vendor/webrtc-ice" }
|
||||||
|
|
||||||
[[bench]]
|
[[bench]]
|
||||||
name = "nvenc_pipeline_bench"
|
name = "nvenc_pipeline_bench"
|
||||||
|
|||||||
+27
-5
@@ -45,7 +45,7 @@
|
|||||||
| Mouse / keyboard | Absolute and relative motion, clicks, wheel, keys; no spurious key repeat on high-latency links; optional uinput virtual devices on Wayland (layout independent, see below) |
|
| Mouse / keyboard | Absolute and relative motion, clicks, wheel, keys; no spurious key repeat on high-latency links; optional uinput virtual devices on Wayland (layout independent, see below) |
|
||||||
| Mac shortcuts | **Recommended**: turn off 「使用 macOS 快捷键」 (use macOS shortcuts) in the Mac viewer's remote-window menu; then Cmd+C/V/A/F/X/Z work as on a Mac (Cmd+C/V become Ctrl+Shift+C/V in terminals) and Ctrl+C always interrupts. With the option on, the viewer sends Cmd as Ctrl: in a terminal Ctrl+V / Cmd+V paste, Ctrl+C interrupts, copy is Cmd+Shift+C (X11) |
|
| Mac shortcuts | **Recommended**: turn off 「使用 macOS 快捷键」 (use macOS shortcuts) in the Mac viewer's remote-window menu; then Cmd+C/V/A/F/X/Z work as on a Mac (Cmd+C/V become Ctrl+Shift+C/V in terminals) and Ctrl+C always interrupts. With the option on, the viewer sends Cmd as Ctrl: in a terminal Ctrl+V / Cmd+V paste, Ctrl+C interrupts, copy is Cmd+Shift+C (X11) |
|
||||||
| Pointer shape | Remote cursor shape is mirrored to the viewer (X11) |
|
| Pointer shape | Remote cursor shape is mirrored to the viewer (X11) |
|
||||||
| Clipboard | Two-way text sync |
|
| Clipboard | Two-way text sync; Wayland mobile IME text inputs use clipboard paste fallback (see below) |
|
||||||
| Quality / frame rate / resolution | Auto, Original 20M, Ultra 8M, HD 2M, custom; 30/60/90/144 fps; on X11 a resolution choice changes the desktop resolution itself like the official Windows host (xrandr, adding the mode when missing; restored for "original" or on disconnect), `UU_DESKTOP_RESIZE=0` scales in the encoder instead; Wayland scales in the encoder |
|
| Quality / frame rate / resolution | Auto, Original 20M, Ultra 8M, HD 2M, custom; 30/60/90/144 fps; on X11 a resolution choice changes the desktop resolution itself like the official Windows host (xrandr, adding the mode when missing; restored for "original" or on disconnect), `UU_DESKTOP_RESIZE=0` scales in the encoder instead; Wayland scales in the encoder |
|
||||||
| Sound | System audio captured from PulseAudio / PipeWire and sent as Opus |
|
| Sound | System audio captured from PulseAudio / PipeWire and sent as Opus |
|
||||||
| File transfer | Upload, download (including folders), create folder, rename, delete |
|
| File transfer | Upload, download (including folders), create folder, rename, delete |
|
||||||
@@ -84,6 +84,8 @@ plugins, permissions and encoders only, no account data, tokens or addresses) an
|
|||||||
Wayland limits: captures one screen by default; Hyprland can enable monitor switching as described below. Resolution is fixed. The native Hyprland backend now pipelines two shm screencopy buffers and passes the viewer's requested fps to both capture pacing and the encoder. Actual fps remains limited by the compositor, rendering and readback (the old serial path measured about 16–22 fps at 2560x1600; the pipeline is VM-measured only, not a hardware guarantee). The portal backend does not support dynamic resolution; see below for GNOME wake and lock recovery; the clipboard syncs while the viewer's remote window has focus. On the first connection the desktop asks for "Remote Desktop / Screen Sharing"
|
Wayland limits: captures one screen by default; Hyprland can enable monitor switching as described below. Resolution is fixed. The native Hyprland backend now pipelines two shm screencopy buffers and passes the viewer's requested fps to both capture pacing and the encoder. Actual fps remains limited by the compositor, rendering and readback (the old serial path measured about 16–22 fps at 2560x1600; the pipeline is VM-measured only, not a hardware guarantee). The portal backend does not support dynamic resolution; see below for GNOME wake and lock recovery; the clipboard syncs while the viewer's remote window has focus. On the first connection the desktop asks for "Remote Desktop / Screen Sharing"
|
||||||
permission; the permission is remembered once granted.
|
permission; the permission is remembered once granted.
|
||||||
|
|
||||||
|
**Mobile IME typing and clipboard on Wayland**: Mobile IME text (`text_input`) on Wayland is typed through spare keycodes on wlroots compositors. On Portal (GNOME / KDE) or compositors where keycodes are exhausted, it automatically falls back to typing via "system clipboard write + `Shift+Insert` (or `UU_WAYLAND_PASTE_KEY=ctrl_v`)". **Note**: This fallback replaces the host's existing clipboard contents and may echo back to the viewer's clipboard via two-way sync; set `UU_WAYLAND_TEXT=0` to completely disable Wayland mobile text input and clipboard paste fallback.
|
||||||
|
|
||||||
Scaled GNOME desktops using native Portal input use EIS on the same authorized session when `ConnectToEIS` and a screen `mapping_id` are available. Each axis is mapped using the matched region and actual frame dimensions, with no fixed resolution or scale factor. This avoids scaled-coordinate rejection by `NotifyPointerMotionAbsolute`. Portal builds require libei >= 1.1. Missing EIS support retains the legacy input path and its existing scaling limitations; other initialization failures are reported and trigger session recovery. After a successful EIS connection, all input uses EIS. Capture alone and uinput do not initialize EIS; missing optional logical dimensions do not block capture. Keyboard input uses the existing Windows VK to evdev mapping. Recovery keeps the encoder frame dimensions fixed but accepts logical-size changes after scaling. On GNOME, a display-change notification enables earlier recovery when previously streaming Portal capture remains paused without a valid format for a 200 ms grace after both conditions are present. Healthy renegotiation cancels the early check; repeated notifications do not postpone the same interruption. The five-second fallback remains without a related notification. Static video and valid-format pauses do not trigger recovery. Tested while connected on Ubuntu 26.04, GNOME Wayland, one 3840x2160 display: 200% -> 166.67% -> 200%, with continuously updating video and full-screen pointer control after recovery. Switching briefly freezes and goes black before recovering; five seconds is the fallback threshold, not total recovery time. See [#35](../../pull/35) for timing measurements and validation limits. Lock recovery still needs hardware acceptance testing; multi-monitor support, live resolution changes, and rotation/reflection transforms are outside this fix's scope. Capture settings remain at protocol version 4: advertised resolutions use pixel coordinates and DPR 1; Portal logical dimensions are used only for local input mapping.
|
Scaled GNOME desktops using native Portal input use EIS on the same authorized session when `ConnectToEIS` and a screen `mapping_id` are available. Each axis is mapped using the matched region and actual frame dimensions, with no fixed resolution or scale factor. This avoids scaled-coordinate rejection by `NotifyPointerMotionAbsolute`. Portal builds require libei >= 1.1. Missing EIS support retains the legacy input path and its existing scaling limitations; other initialization failures are reported and trigger session recovery. After a successful EIS connection, all input uses EIS. Capture alone and uinput do not initialize EIS; missing optional logical dimensions do not block capture. Keyboard input uses the existing Windows VK to evdev mapping. Recovery keeps the encoder frame dimensions fixed but accepts logical-size changes after scaling. On GNOME, a display-change notification enables earlier recovery when previously streaming Portal capture remains paused without a valid format for a 200 ms grace after both conditions are present. Healthy renegotiation cancels the early check; repeated notifications do not postpone the same interruption. The five-second fallback remains without a related notification. Static video and valid-format pauses do not trigger recovery. Tested while connected on Ubuntu 26.04, GNOME Wayland, one 3840x2160 display: 200% -> 166.67% -> 200%, with continuously updating video and full-screen pointer control after recovery. Switching briefly freezes and goes black before recovering; five seconds is the fallback threshold, not total recovery time. See [#35](../../pull/35) for timing measurements and validation limits. Lock recovery still needs hardware acceptance testing; multi-monitor support, live resolution changes, and rotation/reflection transforms are outside this fix's scope. Capture settings remain at protocol version 4: advertised resolutions use pixel coordinates and DPR 1; Portal logical dimensions are used only for local input mapping.
|
||||||
|
|
||||||
GNOME Portal CONTROL no longer waits for a consent dialog or the first video frame. It announces the selected desktop before reporting secure-desktop state and receiving the official viewer's “auto unlock host” request. The official Android viewer requires this desktop selection before entering its auto-unlock flow, so the notification must precede capture readiness; actual screen dimensions, codec information and capture permissions still follow their real readiness state. Enable auto unlock in the viewer and use the current Linux user's login password. The host verifies it with PAM, unlocks the existing GNOME session, requests display wake, and restores capture, input and clipboard through the shared Portal session. Initial consent or revoked permissions still require local approval. Reconnect if physical or logical dimensions change.
|
GNOME Portal CONTROL no longer waits for a consent dialog or the first video frame. It announces the selected desktop before reporting secure-desktop state and receiving the official viewer's “auto unlock host” request. The official Android viewer requires this desktop selection before entering its auto-unlock flow, so the notification must precede capture readiness; actual screen dimensions, codec information and capture permissions still follow their real readiness state. Enable auto unlock in the viewer and use the current Linux user's login password. The host verifies it with PAM, unlocks the existing GNOME session, requests display wake, and restores capture, input and clipboard through the shared Portal session. Initial consent or revoked permissions still require local approval. Reconnect if physical or logical dimensions change.
|
||||||
@@ -104,19 +106,21 @@ failure falls back to SHM. The virgl VM verified fallback only: successful impor
|
|||||||
mapping and hardware acceleration remain unverified. This is not zero-copy VAAPI;
|
mapping and hardware acceleration remain unverified. This is not zero-copy VAAPI;
|
||||||
`UU_VIDEO_ENCODER=vaapi` still uploads CPU frames through FFmpeg.
|
`UU_VIDEO_ENCODER=vaapi` still uploads CPU frames through FFmpeg.
|
||||||
|
|
||||||
### Hyprland monitor switching (experimental)
|
### Monitor switching (experimental)
|
||||||
|
|
||||||
Native Wayland absolute pointer motion now targets the captured output by default, fixing multi-monitor click offsets. uinput may still handle keyboard, buttons and relative motion.
|
Native Wayland absolute pointer motion now targets the captured output by default, fixing multi-monitor click offsets. uinput may still handle keyboard, buttons and relative motion.
|
||||||
|
|
||||||
Set `UU_WAYLAND_MULTISCREEN=1` to select physical monitors from the phone client. `UU_WAYLAND_OUTPUT` chooses the initial output. Capture and absolute pointer targeting switch together across different resolutions, scales and desktop positions.
|
Set `UU_WAYLAND_MULTISCREEN=1` to select physical monitors from the phone client. `UU_WAYLAND_OUTPUT` chooses the initial output. Capture and absolute pointer targeting switch together across different resolutions, scales and desktop positions.
|
||||||
|
|
||||||
|
X11 sessions send all monitors as one combined picture by default. With `UU_X11_MULTISCREEN=1` the host lists the monitors from `xrandr --listmonitors`; the viewer selects one, only that region is captured, and absolute pointer positions are offset to that monitor. The primary monitor is the default; `UU_X11_OUTPUT` picks another (e.g. `HDMI-1`). The layout is read when the host starts; restart the service after changing it. In this mode the viewer's resolution setting scales the stream instead of changing the display mode. Experimental: unit tests and Xvfb virtual monitors only, not yet accepted with the official clients.
|
||||||
|
|
||||||
Switching reuses one video track and pauses input until the new source sends a frame. Capture/encoder failure or a first-frame timeout requests restoration of the previous source. The inventory uses `hyprctl` and supports unrotated outputs; restart the host after monitor hotplug or layout changes. Phone-side switching and clicks were tested on Omarchy / Hyprland with 2560×1440 at 125% and 1920×1080 at 133.33%.
|
Switching reuses one video track and pauses input until the new source sends a frame. Capture/encoder failure or a first-frame timeout requests restoration of the previous source. The inventory uses `hyprctl` and supports unrotated outputs; restart the host after monitor hotplug or layout changes. Phone-side switching and clicks were tested on Omarchy / Hyprland with 2560×1440 at 125% and 1920×1080 at 133.33%.
|
||||||
|
|
||||||
## Not implemented / not supported
|
## Not implemented / not supported
|
||||||
|
|
||||||
| Feature | Status |
|
| Feature | Status |
|
||||||
|---|---|
|
|---|---|
|
||||||
| Switching between multiple monitors | Experimental on native Hyprland Wayland; see above |
|
| Switching between multiple monitors | Experimental on native Hyprland Wayland and on X11 (`UU_X11_MULTISCREEN=1`); see above |
|
||||||
| True color (4:4:4) | Supported (v0.1.15): the default FFmpeg pipeline with NVENC / libx264 encodes H.264 High 4:4:4; `inproc-av` native NVENC encodes H.264 High 4:4:4 / HEVC FRExt; VAAPI stays 4:2:0 and reports that to the client |
|
| True color (4:4:4) | Supported (v0.1.15): the default FFmpeg pipeline with NVENC / libx264 encodes H.264 High 4:4:4; `inproc-av` native NVENC encodes H.264 High 4:4:4 / HEVC FRExt; VAAPI stays 4:2:0 and reports that to the client |
|
||||||
| HDR | Not implemented |
|
| HDR | Not implemented |
|
||||||
| Super screen / virtual display | Not implemented |
|
| Super screen / virtual display | Not implemented |
|
||||||
@@ -208,6 +212,10 @@ Run inside your graphical session:
|
|||||||
Scan the code with the **NetEase UU Remote mobile app** and confirm. Credentials are stored only on this
|
Scan the code with the **NetEase UU Remote mobile app** and confirm. Credentials are stored only on this
|
||||||
machine, in `~/.config/uuremote/config.json` (mode 0600).
|
machine, in `~/.config/uuremote/config.json` (mode 0600).
|
||||||
|
|
||||||
|
A failed status query or the 60-second request timeout does not prove that the QR expired or that the phone confirmed login. The official-client refresh policy is unchanged: after a query error, click Refresh QR (Enter in a terminal; refresh after 60 seconds with neither a window nor a terminal). QR request diagnostics contain only the request phase, error category, elapsed time, HTTP/API status and last known scan state—not tickets, URLs or response content. A `connect` category alone does not identify a DNS, TLS or proxy cause.
|
||||||
|
|
||||||
|
The same file holds this machine's device identity (`device_id`, `client_id`, `system_id`), which reinstalls and new QR logins keep. **Do not copy `config.json` between machines or clone a second host from a snapshot/disk that includes the home directory**: two host instances with one identity, on the same or different machines, kick each other out of the room. The log then shows `Cloud room leave without peer identifier` every few seconds with reconnects, and viewers disconnect right after connecting. On a cloned or copied machine, stop the service, remove those three keys plus `token`, `csrf` and `user_id`, and run `uuremote-server login` to register a new device. A leftover instance on the same machine (for example an old `~/.local/bin/uuremote-server` started by hand) has the same effect; `uuremote-server doctor` warns when more than one host instance is running.
|
||||||
|
|
||||||
### 4. Run as a user service
|
### 4. Run as a user service
|
||||||
|
|
||||||
`~/.config/systemd/user/uuremote-native.service`:
|
`~/.config/systemd/user/uuremote-native.service`:
|
||||||
@@ -339,11 +347,14 @@ Common environment variables:
|
|||||||
| `UU_NVENC_RGB=0` / `=1` | NVENC encodes BGRA directly (saves CPU). Off by default when a monitor is connected to the NVIDIA card (slower when the desktop is composited on the same GPU); `0` forces off, `1` forces on |
|
| `UU_NVENC_RGB=0` / `=1` | NVENC encodes BGRA directly (saves CPU). Off by default when a monitor is connected to the NVIDIA card (slower when the desktop is composited on the same GPU); `0` forces off, `1` forces on |
|
||||||
| `UU_WAYLAND_MULTISCREEN=1` | Enable Hyprland physical monitor switching (off by default) |
|
| `UU_WAYLAND_MULTISCREEN=1` | Enable Hyprland physical monitor switching (off by default) |
|
||||||
| `UU_WAYLAND_OUTPUT` | Initial native Wayland output name, e.g. `HDMI-A-1` |
|
| `UU_WAYLAND_OUTPUT` | Initial native Wayland output name, e.g. `HDMI-A-1` |
|
||||||
|
| `UU_X11_MULTISCREEN=1` | Select and capture X11 monitors separately (experimental, off by default, needs `xrandr`) |
|
||||||
|
| `UU_X11_OUTPUT` | Initial X11 monitor name (`xrandr --listmonitors`); default: the primary |
|
||||||
| `UU_WAYLAND_NO_VIRTUAL_KEYBOARD=1` | Native Wayland skips the virtual keyboard (e.g. Denial reserves it for its input method); keys go through uinput. Without wlr-virtual-pointer the pointer also uses uinput (#72) |
|
| `UU_WAYLAND_NO_VIRTUAL_KEYBOARD=1` | Native Wayland skips the virtual keyboard (e.g. Denial reserves it for its input method); keys go through uinput. Without wlr-virtual-pointer the pointer also uses uinput (#72) |
|
||||||
| `UU_INPUT_BACKEND` | `auto` (default: uinput on Wayland when accessible) / `uinput` / `native` |
|
| `UU_INPUT_BACKEND` | `auto` (default: uinput on Wayland when accessible) / `uinput` / `native` |
|
||||||
| `UU_TERMINAL_SHORTCUTS=0` | Disable the Ctrl+V paste rewrite in terminal windows |
|
| `UU_TERMINAL_SHORTCUTS=0` | Disable the Ctrl+V paste rewrite in terminal windows |
|
||||||
| `UU_VIDEO_ENCODER` | `cpu`: libx264; `vaapi`: opt-in Intel/AMD; `nvenc`: force NVENC; unset or `auto`: a background probe (one synthetic IDR per candidate, 3 s each). With an NVIDIA driver the order is NVENC then CPU; without one the only candidate is CPU and the probe is skipped. A session that starts before the probe finishes uses the previous rule (NVENC if NVIDIA is present, else CPU). On a self-built `--features inproc-av` binary, a process-only failure of NVENC when the in-process engine would try it first on X11 is logged `native_unprobed` and keeps the previous NVENC choice (Wayland, portal, and KMS fall back to CPU). The skipped CPU-only probe is logged `not probed (only candidate)`. A successful probe and that CPU-only skip stay cached while NVIDIA presence matches the report. A later desktop connection whose presence differs starts one background re-probe and still uses the cached encoder until the new result is stored. A hardware-candidate failure (NVENC failed, CPU chosen) is kept for 10 minutes; the next desktop connection after that starts the same re-probe and still uses the cached encoder until the new result is stored. Explicit `cpu` / `vaapi` / `nvenc` does not start the probe. Another failure restarts the 10 minutes. `native_unprobed` is not a temporary failure. A non-`auto` `video_encoder` in `host_settings.json` wins. VAAPI stays out of auto until #33 |
|
| `UU_VIDEO_ENCODER` | `cpu`: libx264; `vaapi`: opt-in Intel/AMD; `nvenc`: force NVENC; unset or `auto`: a background probe (one synthetic IDR per candidate, 3 s each). With an NVIDIA driver the order is NVENC then CPU; without one the only candidate is CPU and the probe is skipped. A session that starts before the probe finishes uses the previous rule (NVENC if NVIDIA is present, else CPU). On a self-built `--features inproc-av` binary, a process-only failure of NVENC when the in-process engine would try it first on X11 is logged `native_unprobed` and keeps the previous NVENC choice (Wayland, portal, and KMS fall back to CPU). The skipped CPU-only probe is logged `not probed (only candidate)`. A successful probe and that CPU-only skip stay cached while NVIDIA presence matches the report. A later desktop connection whose presence differs starts one background re-probe and still uses the cached encoder until the new result is stored. A hardware-candidate failure (NVENC failed, CPU chosen) is kept for 10 minutes; the next desktop connection after that starts the same re-probe and still uses the cached encoder until the new result is stored. Explicit `cpu` / `vaapi` / `nvenc` does not start the probe. Another failure restarts the 10 minutes. `native_unprobed` is not a temporary failure. A non-`auto` `video_encoder` in `host_settings.json` wins. VAAPI stays out of auto until #33 |
|
||||||
| `UU_VAAPI_BUFFER_MS` | VAAPI VBV buffer in ms (10-1000, VAAPI only); raise it when keyframes are squeezed into a blur at high resolution |
|
| `UU_VAAPI_BUFFER_MS` | VAAPI VBV buffer in ms (10-1000, VAAPI only); raise it when keyframes are squeezed into a blur at high resolution |
|
||||||
|
| `UU_NVENC_BUFFER_MS` | NVENC VBV buffer in ms (10-1000, NVENC only, including the in-process engine); the default is 100-500 kbit, set `1000` when high-resolution keyframes blur and flicker once per GOP (#103) |
|
||||||
| `UU_FFMPEG_ROOT` | Use FFmpeg from this prefix |
|
| `UU_FFMPEG_ROOT` | Use FFmpeg from this prefix |
|
||||||
| `UU_AUDIO=0` | Disable sound; `UU_AUDIO_SOURCE` picks the PulseAudio source |
|
| `UU_AUDIO=0` | Disable sound; `UU_AUDIO_SOURCE` picks the PulseAudio source |
|
||||||
| `UU_REMOTE_ASSIST=0` | Disable remote assistance (no guest assistance before sign-in either) |
|
| `UU_REMOTE_ASSIST=0` | Disable remote assistance (no guest assistance before sign-in either) |
|
||||||
@@ -351,7 +362,12 @@ Common environment variables:
|
|||||||
| `UU_LOGIN_WINDOW=0` | Do not open the login window automatically when credentials are missing |
|
| `UU_LOGIN_WINDOW=0` | Do not open the login window automatically when credentials are missing |
|
||||||
| `UU_PORT_MAPPING=0` | Disable port mapping (the official host's controlled-side switch) |
|
| `UU_PORT_MAPPING=0` | Disable port mapping (the official host's controlled-side switch) |
|
||||||
| `UU_WOL_HELPER=1` | Experimental: act as a remote-boot helper like the official Windows host — report this host's LAN info after sign-in and send a magic packet to the LAN when the cloud asks to wake a PC (not verified end to end) |
|
| `UU_WOL_HELPER=1` | Experimental: act as a remote-boot helper like the official Windows host — report this host's LAN info after sign-in and send a magic packet to the LAN when the cloud asks to wake a PC (not verified end to end) |
|
||||||
| `UU_USE_PROXY=1` | Honor HTTP/SOCKS proxy environment variables; by default proxies are ignored and NetEase servers are reached directly |
|
| `UU_USE_PROXY=1` | Share environment HTTP/HTTPS proxy policy between REST and host/viewer WebSocket signaling; proxies are ignored by default |
|
||||||
|
|
||||||
|
|
||||||
|
`UU_USE_PROXY=1` uses only proxy settings already available to the current process. `HTTP_PROXY` / `HTTPS_PROXY` / `ALL_PROXY` (and lowercase forms) and `NO_PROXY` follow reqwest's standard selection, with uppercase taking precedence. Signaling rejects invalid/unsupported values in the selected variables (HTTP/HTTPS only, not SOCKS), proxy URLs with paths/queries/fragments, and CGI environments that would ignore proxies; this validation is intentionally stricter than silently ignoring bad values. No matching proxy or a `NO_PROXY` match still means direct access; a selected proxy failing does not trigger direct fallback. Certificate verification remains enabled and redirects are not followed, so room authentication is not forwarded to a redirect target.
|
||||||
|
|
||||||
|
With it the host also reaches the cloud TURN relays over TCP/TLS (CONNECT through the unauthenticated `http://` proxy in `HTTPS_PROXY`/`ALL_PROXY`, or directly without one), for hosts whose UDP cannot reach the TURN servers but whose TCP/proxy can. TURN certificates are chain-verified; a name mismatch is tolerated only when the cloud-supplied TURN address is an IP (media itself is end-to-end DTLS-SRTP). Without the setting only UDP relays are used, as before. **This creates no new network access**: login, signaling and media each still need an allowed network path. Connector errors expose only fixed categories/HTTP status; do not enable dependency TRACE logs that may record URLs or authentication information.
|
||||||
|
|
||||||
Host settings such as "lock after remote session" and "mute host" are stored in
|
Host settings such as "lock after remote session" and "mute host" are stored in
|
||||||
`~/.config/uuremote/host_settings.json`. The same file stores `video_encoder`
|
`~/.config/uuremote/host_settings.json`. The same file stores `video_encoder`
|
||||||
@@ -365,7 +381,13 @@ stays cached until the process exits, except when NVIDIA presence (`/proc/driver
|
|||||||
or `/dev/nvidia0`) no longer matches the report: the next desktop connection then starts one
|
or `/dev/nvidia0`) no longer matches the report: the next desktop connection then starts one
|
||||||
background re-probe (`warm_auto_probe`) and still uses the cached encoder until the new result
|
background re-probe (`warm_auto_probe`) and still uses the cached encoder until the new result
|
||||||
is stored. An NVENC failure is kept for 10 minutes, and the next desktop connection after that
|
is stored. An NVENC failure is kept for 10 minutes, and the next desktop connection after that
|
||||||
starts the same background re-probe while still using the cached encoder. They take effect the next time a desktop connection starts. Explicit `vaapi` with 真彩 stays on VAAPI,
|
starts the same background re-probe while still using the cached encoder. `set-encoder` and
|
||||||
|
`set-codec` both send `SIGUSR2` to the host in `host.pid` when that process is this program.
|
||||||
|
An encoder change switches each live desktop stream without disconnecting and keeps the codec
|
||||||
|
negotiated for that session. A failed start follows the existing fallback (in-process, then the
|
||||||
|
FFmpeg process, then CPU). After a hand edit, `kill -USR2 $(cat ~/.config/uuremote/host.pid)`
|
||||||
|
does the same. `SIGUSR2` does not re-probe. A codec change takes effect the next time a desktop
|
||||||
|
connection starts; the running host only logs it. Explicit `vaapi` with 真彩 stays on VAAPI,
|
||||||
encodes 4:2:0, and reports chroma 4:2:0 in CaptureSettingSync field 3. If the chosen encoder
|
encodes 4:2:0, and reports chroma 4:2:0 in CaptureSettingSync field 3. If the chosen encoder
|
||||||
cannot start, the stream falls back to CPU and logs a warning. VAAPI is not an auto candidate
|
cannot start, the stream falls back to CPU and logs a warning. VAAPI is not an auto candidate
|
||||||
until #33.
|
until #33.
|
||||||
|
|||||||
@@ -39,7 +39,7 @@
|
|||||||
| 鼠标 / 键盘 | 绝对/相对移动、点击、滚轮、按键;修复了网络延迟导致的按键连发;Wayland 下可用 uinput 虚拟键鼠(不依赖键盘布局,见下文) |
|
| 鼠标 / 键盘 | 绝对/相对移动、点击、滚轮、按键;修复了网络延迟导致的按键连发;Wayland 下可用 uinput 虚拟键鼠(不依赖键盘布局,见下文) |
|
||||||
| Mac 快捷键 | **推荐**:在 Mac 远控窗口菜单里关闭「使用 macOS 快捷键」,之后和在 Mac 上一样:Cmd+C/V/A/F/X/Z 是复制、粘贴、全选、查找、剪切、撤销(终端里 Cmd+C/V 自动变成 Ctrl+Shift+C/V),Ctrl+C 在终端里始终是中断。保持开启时,客户端会把 Cmd 和 Ctrl 都当成 Ctrl 发送:终端里 Ctrl+V / Cmd+V 自动转成粘贴,Ctrl+C 是中断,复制用 Cmd+Shift+C(X11) |
|
| Mac 快捷键 | **推荐**:在 Mac 远控窗口菜单里关闭「使用 macOS 快捷键」,之后和在 Mac 上一样:Cmd+C/V/A/F/X/Z 是复制、粘贴、全选、查找、剪切、撤销(终端里 Cmd+C/V 自动变成 Ctrl+Shift+C/V),Ctrl+C 在终端里始终是中断。保持开启时,客户端会把 Cmd 和 Ctrl 都当成 Ctrl 发送:终端里 Ctrl+V / Cmd+V 自动转成粘贴,Ctrl+C 是中断,复制用 Cmd+Shift+C(X11) |
|
||||||
| 鼠标指针样式 | 远端指针形状实时同步(X11) |
|
| 鼠标指针样式 | 远端指针形状实时同步(X11) |
|
||||||
| 剪贴板 | 双向文本同步 |
|
| 剪贴板 | 双向文本同步;Wayland 手机输入法输入通过剪贴板兜底粘贴,见下文 |
|
||||||
| 画质 / 帧率 / 分辨率 | 自动、原画 20M、超清 8M、高清 2M、自定义;30/60/90/144 帧;X11 下切换分辨率会像官方 Windows 被控端一样真正修改桌面分辨率(xrandr,缺少该模式时自动添加;选「原始」或断开后恢复),`UU_DESKTOP_RESIZE=0` 改为仅由编码器缩放;Wayland 仍由编码器缩放 |
|
| 画质 / 帧率 / 分辨率 | 自动、原画 20M、超清 8M、高清 2M、自定义;30/60/90/144 帧;X11 下切换分辨率会像官方 Windows 被控端一样真正修改桌面分辨率(xrandr,缺少该模式时自动添加;选「原始」或断开后恢复),`UU_DESKTOP_RESIZE=0` 改为仅由编码器缩放;Wayland 仍由编码器缩放 |
|
||||||
| 声音 | 采集系统声音(PulseAudio / PipeWire),Opus 编码传到控制端 |
|
| 声音 | 采集系统声音(PulseAudio / PipeWire),Opus 编码传到控制端 |
|
||||||
| 文件传输 | 上传、下载(含文件夹)、新建文件夹、重命名、删除 |
|
| 文件传输 | 上传、下载(含文件夹)、新建文件夹、重命名、删除 |
|
||||||
@@ -75,6 +75,8 @@ GNOME Wayland 的 Portal/EIS 路径已在 Ubuntu 26.04、GNOME 50、单屏 4K/20
|
|||||||
|
|
||||||
Wayland 下的限制:默认采集单屏,Hyprland 可按上文启用切屏;分辨率固定;Hyprland 原生后端默认使用双缓冲流水线 shm screencopy,控制端帧率设置会同步到采集节拍和编码器,但实际帧率仍受合成器、渲染和读回速度限制(旧串行路径在 2560x1600 曾测得约 16~22 帧;流水线只在虚拟机里测量过,不代表实机保证);portal 后端暂不支持动态分辨率;GNOME 的屏幕唤醒与锁屏恢复见下;剪贴板只在控制端的远控窗口处于前台时同步。
|
Wayland 下的限制:默认采集单屏,Hyprland 可按上文启用切屏;分辨率固定;Hyprland 原生后端默认使用双缓冲流水线 shm screencopy,控制端帧率设置会同步到采集节拍和编码器,但实际帧率仍受合成器、渲染和读回速度限制(旧串行路径在 2560x1600 曾测得约 16~22 帧;流水线只在虚拟机里测量过,不代表实机保证);portal 后端暂不支持动态分辨率;GNOME 的屏幕唤醒与锁屏恢复见下;剪贴板只在控制端的远控窗口处于前台时同步。
|
||||||
|
|
||||||
|
**Wayland 手机输入法打字与剪贴板**:Wayland 下手机端输入法提交的文字(`text_input`)优先通过虚拟键盘空闲键码上屏;在 Portal(GNOME / KDE)或键码耗尽的环境下,自动通过「写系统剪贴板 + 触发 `Shift+Insert`(或 `UU_WAYLAND_PASTE_KEY=ctrl_v`)」兜底粘贴。**注意**:此兜底过程会覆盖被控端原有的剪贴板内容,且会被双向同步回传到控制端剪贴板;设置 `UU_WAYLAND_TEXT=0` 可完全关闭 Wayland 文字输入及该粘贴兜底。
|
||||||
|
|
||||||
GNOME 缩放桌面在使用 Portal 原生键鼠时,若支持 `ConnectToEIS` 和屏幕 `mapping_id`,通过同一授权会话的 EIS 接口注入输入,按匹配的区域与实际帧尺寸分别映射横纵坐标,没有固定分辨率或缩放倍率,可避免 `NotifyPointerMotionAbsolute` 在缩放时拒绝坐标。Portal 构建需要 libei ≥ 1.1。缺少 EIS 支持时保留旧输入路径及其既有缩放限制;其他初始化错误会明确报告并触发会话恢复。EIS 连接成功后全部输入统一使用 EIS。只采集画面或使用 uinput 时不会初始化 EIS;缺少可选的逻辑尺寸也不阻断采集。键盘沿用项目现有的 Windows VK → evdev 映射。恢复时保持编码器的采集帧尺寸不变,允许缩放后的逻辑尺寸变化。GNOME 显示配置变化后,已推流的 Portal 采集若持续「暂停且无有效格式」,会在关联通知后的 200 毫秒宽限结束后提前进入现有恢复流程;正常重协商恢复会取消提前判定,连续通知不会推迟同次异常的判定。未收到相关通知时保留五秒兜底;静态画面或有效格式下的暂停不会触发恢复。Ubuntu 26.04、GNOME Wayland 单屏 3840×2160 已实测保持连接切换 200%→166.67%→200%,恢复后画面持续更新且鼠标可控制全屏;切换期间会短暂停顿、黑屏后恢复,五秒是兜底判定阈值,并非总恢复时间。提前恢复的测量结果和验证范围见 [#35](../../pull/35)。此路径仍需实机验证锁屏恢复;多屏、连接中改变分辨率及旋转/镜像变换不属于本次修复范围。 捕获设置协议仍为版本 4:对客户端上报的分辨率统一使用像素坐标、DPR 为 1;Portal 逻辑尺寸仅用于本地输入映射。
|
GNOME 缩放桌面在使用 Portal 原生键鼠时,若支持 `ConnectToEIS` 和屏幕 `mapping_id`,通过同一授权会话的 EIS 接口注入输入,按匹配的区域与实际帧尺寸分别映射横纵坐标,没有固定分辨率或缩放倍率,可避免 `NotifyPointerMotionAbsolute` 在缩放时拒绝坐标。Portal 构建需要 libei ≥ 1.1。缺少 EIS 支持时保留旧输入路径及其既有缩放限制;其他初始化错误会明确报告并触发会话恢复。EIS 连接成功后全部输入统一使用 EIS。只采集画面或使用 uinput 时不会初始化 EIS;缺少可选的逻辑尺寸也不阻断采集。键盘沿用项目现有的 Windows VK → evdev 映射。恢复时保持编码器的采集帧尺寸不变,允许缩放后的逻辑尺寸变化。GNOME 显示配置变化后,已推流的 Portal 采集若持续「暂停且无有效格式」,会在关联通知后的 200 毫秒宽限结束后提前进入现有恢复流程;正常重协商恢复会取消提前判定,连续通知不会推迟同次异常的判定。未收到相关通知时保留五秒兜底;静态画面或有效格式下的暂停不会触发恢复。Ubuntu 26.04、GNOME Wayland 单屏 3840×2160 已实测保持连接切换 200%→166.67%→200%,恢复后画面持续更新且鼠标可控制全屏;切换期间会短暂停顿、黑屏后恢复,五秒是兜底判定阈值,并非总恢复时间。提前恢复的测量结果和验证范围见 [#35](../../pull/35)。此路径仍需实机验证锁屏恢复;多屏、连接中改变分辨率及旋转/镜像变换不属于本次修复范围。 捕获设置协议仍为版本 4:对客户端上报的分辨率统一使用像素坐标、DPR 为 1;Portal 逻辑尺寸仅用于本地输入映射。
|
||||||
|
|
||||||
GNOME Portal 的控制通道不再等待授权窗口或第一帧画面:先通知客户端当前选择桌面,再上报锁屏状态、接收官方客户端的「自动解锁被控端」请求。官方 Android 客户端需要桌面目标通知才会进入自动解锁流程,因此该通知不能等待采集就绪;真实屏幕尺寸、编码信息及采集权限仍按实际就绪状态上报。请在客户端启用自动解锁,使用当前 Linux 用户的登录密码;主机通过 PAM 验证后解锁当前 GNOME 会话、请求点亮屏幕,并恢复同一 Portal 会话中的画面、键鼠和剪贴板。首次授权或权限被撤销时仍需本机确认。物理或逻辑分辨率变化后需要重连。
|
GNOME Portal 的控制通道不再等待授权窗口或第一帧画面:先通知客户端当前选择桌面,再上报锁屏状态、接收官方客户端的「自动解锁被控端」请求。官方 Android 客户端需要桌面目标通知才会进入自动解锁流程,因此该通知不能等待采集就绪;真实屏幕尺寸、编码信息及采集权限仍按实际就绪状态上报。请在客户端启用自动解锁,使用当前 Linux 用户的登录密码;主机通过 PAM 验证后解锁当前 GNOME 会话、请求点亮屏幕,并恢复同一 Portal 会话中的画面、键鼠和剪贴板。首次授权或权限被撤销时仍需本机确认。物理或逻辑分辨率变化后需要重连。
|
||||||
@@ -90,19 +92,21 @@ GNOME Portal 的控制通道不再等待授权窗口或第一帧画面:先通
|
|||||||
原生 Wayland 实验选项:`UU_WAYLAND_PIPELINE=0` 可关闭流水线做对照。`UU_WAYLAND_DMABUF=1` 显式尝试 dma-buf→GBM CPU 映射(默认关闭,需要运行时 libgbm;可用 `UU_WAYLAND_DMABUF_DEVICE` 指定 render node,默认 `/dev/dri/renderD128`)。仅支持显式线性修饰符、单平面 8-bit RGB,失败回退 SHM;virgl VM 中只验证了回退,成功导入/映射和硬件加速均未验证。这不是零拷贝 VAAPI 路径;选择 `UU_VIDEO_ENCODER=vaapi` 时仍由 FFmpeg 上传 CPU 帧。
|
原生 Wayland 实验选项:`UU_WAYLAND_PIPELINE=0` 可关闭流水线做对照。`UU_WAYLAND_DMABUF=1` 显式尝试 dma-buf→GBM CPU 映射(默认关闭,需要运行时 libgbm;可用 `UU_WAYLAND_DMABUF_DEVICE` 指定 render node,默认 `/dev/dri/renderD128`)。仅支持显式线性修饰符、单平面 8-bit RGB,失败回退 SHM;virgl VM 中只验证了回退,成功导入/映射和硬件加速均未验证。这不是零拷贝 VAAPI 路径;选择 `UU_VIDEO_ENCODER=vaapi` 时仍由 FFmpeg 上传 CPU 帧。
|
||||||
首次连接时,桌面会弹窗请求「远程桌面 / 屏幕共享」授权,同意后会记住授权。
|
首次连接时,桌面会弹窗请求「远程桌面 / 屏幕共享」授权,同意后会记住授权。
|
||||||
|
|
||||||
### Hyprland 多显示器切换(实验性)
|
### 多显示器切换(实验性)
|
||||||
|
|
||||||
原生 Wayland 的绝对鼠标定位默认绑定正在采集的输出,修复双屏桌面下的点击偏移。uinput 可继续用于键盘、按键和相对移动。
|
原生 Wayland 的绝对鼠标定位默认绑定正在采集的输出,修复双屏桌面下的点击偏移。uinput 可继续用于键盘、按键和相对移动。
|
||||||
|
|
||||||
设置 `UU_WAYLAND_MULTISCREEN=1` 后,手机端可选择并切换物理显示器;`UU_WAYLAND_OUTPUT` 指定默认屏幕。画面与绝对鼠标定位同步切换,支持不同分辨率、缩放和桌面位置。
|
设置 `UU_WAYLAND_MULTISCREEN=1` 后,手机端可选择并切换物理显示器;`UU_WAYLAND_OUTPUT` 指定默认屏幕。画面与绝对鼠标定位同步切换,支持不同分辨率、缩放和桌面位置。
|
||||||
|
|
||||||
|
X11 会话默认把所有显示器拼成一张画面。设置 `UU_X11_MULTISCREEN=1` 后,主机按 `xrandr --listmonitors` 列出各个显示器,控制端可选择其中一块,只采集该区域,绝对鼠标坐标加上该屏幕在桌面中的偏移;默认屏幕为主显示器,`UU_X11_OUTPUT` 可指定其他屏幕(如 `HDMI-1`)。显示器布局在主机启动时读取,改动后需重启服务。此模式下控制端的「分辨率」改为缩放画面,不再修改显示模式。实验性:目前只有单元测试与 Xvfb 虚拟显示器实测,尚未经官方客户端实机验收。
|
||||||
|
|
||||||
切屏复用同一条视频轨道,过渡期间暂停输入,发送新屏首帧后恢复;采集或编码失败、等待首帧超时会请求恢复原屏。当前通过 `hyprctl` 枚举未旋转的显示器,显示器插拔或布局变化后需重启服务。已在 Omarchy / Hyprland 上用官方手机客户端实测 2560×1440(125%)与 1920×1080(133.33%)双屏切换及点击。
|
切屏复用同一条视频轨道,过渡期间暂停输入,发送新屏首帧后恢复;采集或编码失败、等待首帧超时会请求恢复原屏。当前通过 `hyprctl` 枚举未旋转的显示器,显示器插拔或布局变化后需重启服务。已在 Omarchy / Hyprland 上用官方手机客户端实测 2560×1440(125%)与 1920×1080(133.33%)双屏切换及点击。
|
||||||
|
|
||||||
## 尚未实现 / 不支持
|
## 尚未实现 / 不支持
|
||||||
|
|
||||||
| 功能 | 状态 |
|
| 功能 | 状态 |
|
||||||
|---|---|
|
|---|---|
|
||||||
| 多显示器切换 | Hyprland 原生 Wayland 后端实验性支持,见上文 |
|
| 多显示器切换 | Hyprland 原生 Wayland 后端与 X11(`UU_X11_MULTISCREEN=1`)实验性支持,见上文 |
|
||||||
| 真彩(4:4:4) | 支持(v0.1.15):NVENC / libx264 的默认 FFmpeg 管线输出 H.264 High 4:4:4;`inproc-av` 原生 NVENC 输出 H.264 High 4:4:4 / HEVC FRExt;VAAPI 管线仍为 4:2:0,并如实回报给客户端 |
|
| 真彩(4:4:4) | 支持(v0.1.15):NVENC / libx264 的默认 FFmpeg 管线输出 H.264 High 4:4:4;`inproc-av` 原生 NVENC 输出 H.264 High 4:4:4 / HEVC FRExt;VAAPI 管线仍为 4:2:0,并如实回报给客户端 |
|
||||||
| HDR | 未实现 |
|
| HDR | 未实现 |
|
||||||
| 超级屏 / 虚拟显示器 | 未实现 |
|
| 超级屏 / 虚拟显示器 | 未实现 |
|
||||||
@@ -191,6 +195,10 @@ cargo build --release --features wayland,portal # + GNOME/KDE Wayland
|
|||||||
用手机上的 **网易 UU 远程 App** 扫码并确认即可。登录信息只保存在本机的
|
用手机上的 **网易 UU 远程 App** 扫码并确认即可。登录信息只保存在本机的
|
||||||
`~/.config/uuremote/config.json`(权限 0600)里。
|
`~/.config/uuremote/config.json`(权限 0600)里。
|
||||||
|
|
||||||
|
登录状态查询失败或达到 60 秒请求超时不代表二维码已过期,也不代表手机已经确认。程序保留官方客户端的刷新策略:查询出错后点击「刷新二维码」(终端按回车;无窗口且无终端时 60 秒后刷新)。二维码请求诊断只包含请求阶段、错误类别、耗时、HTTP/API 状态及最后已知扫码状态,不输出票据、URL 或响应内容;`connect` 类别本身不能确定是 DNS、TLS 还是代理问题。
|
||||||
|
|
||||||
|
这个文件里还有本机的设备身份(`device_id`、`client_id`、`system_id`),重装软件和重新扫码登录都会沿用它。**不要在机器之间拷贝 `config.json`,也不要从带着家目录的快照/数据盘克隆出第二台主机**:同一身份的两个主机实例(不论在同一台还是不同机器上)会互相把对方踢出房间,日志表现为每隔几秒出现 `Cloud room leave without peer identifier` 并反复重连,控制端一连就断。克隆或拷贝出来的机器先停掉服务,删掉配置里这三个键和 `token`、`csrf`、`user_id`,再运行 `uuremote-server login` 注册为新设备。同一台机器上残留的旧实例(例如以前手动启动的 `~/.local/bin/uuremote-server`)也会这样,`uuremote-server doctor` 发现多个主机实例时会提示。
|
||||||
|
|
||||||
### 4. 作为用户服务常驻
|
### 4. 作为用户服务常驻
|
||||||
|
|
||||||
`~/.config/systemd/user/uuremote-native.service`:
|
`~/.config/systemd/user/uuremote-native.service`:
|
||||||
@@ -307,11 +315,14 @@ systemctl --user restart uuremote-native.service
|
|||||||
| `UU_NVENC_RGB=0` / `=1` | NVENC 直接编码 BGRA(省 CPU)。显示器接在 NVIDIA 卡上时默认关闭(同卡合成时直吃反而更慢),`0` 强制关,`1` 强制开 |
|
| `UU_NVENC_RGB=0` / `=1` | NVENC 直接编码 BGRA(省 CPU)。显示器接在 NVIDIA 卡上时默认关闭(同卡合成时直吃反而更慢),`0` 强制关,`1` 强制开 |
|
||||||
| `UU_WAYLAND_MULTISCREEN=1` | 启用 Hyprland 物理显示器切换(默认关闭) |
|
| `UU_WAYLAND_MULTISCREEN=1` | 启用 Hyprland 物理显示器切换(默认关闭) |
|
||||||
| `UU_WAYLAND_OUTPUT` | 原生 Wayland 默认采集输出名称,例如 `HDMI-A-1` |
|
| `UU_WAYLAND_OUTPUT` | 原生 Wayland 默认采集输出名称,例如 `HDMI-A-1` |
|
||||||
|
| `UU_X11_MULTISCREEN=1` | X11 下按显示器分别选择和采集(实验性,默认关闭,需要 `xrandr`) |
|
||||||
|
| `UU_X11_OUTPUT` | X11 默认采集的显示器名称(`xrandr --listmonitors`),默认主显示器 |
|
||||||
| `UU_WAYLAND_NO_VIRTUAL_KEYBOARD=1` | 原生 Wayland 不创建虚拟键盘(如 Denial 只把它给自己的输入法),键盘改走 uinput。合成器没有 wlr-virtual-pointer 时鼠标也自动改走 uinput(#72) |
|
| `UU_WAYLAND_NO_VIRTUAL_KEYBOARD=1` | 原生 Wayland 不创建虚拟键盘(如 Denial 只把它给自己的输入法),键盘改走 uinput。合成器没有 wlr-virtual-pointer 时鼠标也自动改走 uinput(#72) |
|
||||||
| `UU_INPUT_BACKEND` | `auto`(默认,Wayland 下可用时用 uinput)/ `uinput` / `native` |
|
| `UU_INPUT_BACKEND` | `auto`(默认,Wayland 下可用时用 uinput)/ `uinput` / `native` |
|
||||||
| `UU_TERMINAL_SHORTCUTS=0` | 关闭终端窗口里的 Ctrl+V 粘贴转换 |
|
| `UU_TERMINAL_SHORTCUTS=0` | 关闭终端窗口里的 Ctrl+V 粘贴转换 |
|
||||||
| `UU_VIDEO_ENCODER` | `cpu` 强制 CPU;`vaapi` 显式启用 Intel/AMD 硬编;`nvenc` 强制 NVENC;未设置或 `auto` 时后台探测(每个候选编码一帧,限时 3 秒)。有 NVIDIA 驱动时顺序是 NVENC → CPU;没有 NVIDIA 时只有 CPU,不探测。探测未完成就建流则沿用旧规则(有 NVIDIA 用 NVENC,否则 CPU)。自行编译的 `--features inproc-av` 上,仅 X11 会先走进程内引擎:外部 FFmpeg 探测失败时记为 `native_unprobed`,沿用旧规则(NVENC);Wayland、portal、KMS 回退 CPU。只有 CPU 时跳过探测,记为 `not probed (only candidate)`。探测成功和这种只含 CPU 的跳过会缓存到 NVIDIA 是否存在发生变化为止(`/proc/driver/nvidia/version` 或 `/dev/nvidia0`)。之后的桌面连接在后台再探测一次(不挡住这一路,仍用缓存的编码器)。NVENC 探测失败、选用 CPU 时只缓存 10 分钟;到期后下一次桌面连接同样在后台再探测一次,再次失败则重新计 10 分钟。显式 `cpu` / `vaapi` / `nvenc` 不启动探测。`native_unprobed` 不算失败缓存。优先级低于 `host_settings.json` 里非 `auto` 的 `video_encoder`。VAAPI 要等 #33 解决后才会进入 auto |
|
| `UU_VIDEO_ENCODER` | `cpu` 强制 CPU;`vaapi` 显式启用 Intel/AMD 硬编;`nvenc` 强制 NVENC;未设置或 `auto` 时后台探测(每个候选编码一帧,限时 3 秒)。有 NVIDIA 驱动时顺序是 NVENC → CPU;没有 NVIDIA 时只有 CPU,不探测。探测未完成就建流则沿用旧规则(有 NVIDIA 用 NVENC,否则 CPU)。自行编译的 `--features inproc-av` 上,仅 X11 会先走进程内引擎:外部 FFmpeg 探测失败时记为 `native_unprobed`,沿用旧规则(NVENC);Wayland、portal、KMS 回退 CPU。只有 CPU 时跳过探测,记为 `not probed (only candidate)`。探测成功和这种只含 CPU 的跳过会缓存到 NVIDIA 是否存在发生变化为止(`/proc/driver/nvidia/version` 或 `/dev/nvidia0`)。之后的桌面连接在后台再探测一次(不挡住这一路,仍用缓存的编码器)。NVENC 探测失败、选用 CPU 时只缓存 10 分钟;到期后下一次桌面连接同样在后台再探测一次,再次失败则重新计 10 分钟。显式 `cpu` / `vaapi` / `nvenc` 不启动探测。`native_unprobed` 不算失败缓存。优先级低于 `host_settings.json` 里非 `auto` 的 `video_encoder`。VAAPI 要等 #33 解决后才会进入 auto |
|
||||||
| `UU_VAAPI_BUFFER_MS` | VAAPI 的 VBV 缓冲(10–1000 ms,仅 `UU_VIDEO_ENCODER=vaapi` 时生效);高分辨率下关键帧被压糊时用它换稳定画质 |
|
| `UU_VAAPI_BUFFER_MS` | VAAPI 的 VBV 缓冲(10–1000 ms,仅 `UU_VIDEO_ENCODER=vaapi` 时生效);高分辨率下关键帧被压糊时用它换稳定画质 |
|
||||||
|
| `UU_NVENC_BUFFER_MS` | NVENC 的 VBV 缓冲(10–1000 ms,仅 NVENC 生效,含进程内引擎);默认 100–500 kbit,1440p 等高分辨率下关键帧被压糊、按 GOP 周期闪烁时设 `1000`(#103) |
|
||||||
| `UU_FFMPEG_ROOT` | 使用指定目录下的 FFmpeg |
|
| `UU_FFMPEG_ROOT` | 使用指定目录下的 FFmpeg |
|
||||||
| `UU_AUDIO=0` | 关闭声音转发;`UU_AUDIO_SOURCE` 指定 PulseAudio 采集源 |
|
| `UU_AUDIO=0` | 关闭声音转发;`UU_AUDIO_SOURCE` 指定 PulseAudio 采集源 |
|
||||||
| `UU_LOGIN_WINDOW=0` | 凭证缺失时不自动弹出登录窗口 |
|
| `UU_LOGIN_WINDOW=0` | 凭证缺失时不自动弹出登录窗口 |
|
||||||
@@ -319,9 +330,14 @@ systemctl --user restart uuremote-native.service
|
|||||||
| `UU_ASSIST_ALLOW=1` | 启动时就允许他人远程协助(覆盖窗口里保存的开关状态) |
|
| `UU_ASSIST_ALLOW=1` | 启动时就允许他人远程协助(覆盖窗口里保存的开关状态) |
|
||||||
| `UU_PORT_MAPPING=0` | 关闭端口映射(对应官方被控端的开关) |
|
| `UU_PORT_MAPPING=0` | 关闭端口映射(对应官方被控端的开关) |
|
||||||
| `UU_WOL_HELPER=1` | 实验性:让这台主机像官方 Windows 被控端一样充当「远程开机」辅助设备——登录后向网易上报本机局域网信息,收到云端唤醒请求时向同一局域网发送唤醒包(未经端到端验证) |
|
| `UU_WOL_HELPER=1` | 实验性:让这台主机像官方 Windows 被控端一样充当「远程开机」辅助设备——登录后向网易上报本机局域网信息,收到云端唤醒请求时向同一局域网发送唤醒包(未经端到端验证) |
|
||||||
| `UU_USE_PROXY=1` | 使用环境变量里的 HTTP/SOCKS 代理;默认忽略代理、直连网易服务器 |
|
| `UU_USE_PROXY=1` | REST API 与 host/viewer WebSocket 信令共用环境 HTTP/HTTPS 代理策略;默认忽略代理、直连 |
|
||||||
|
|
||||||
「远程结束后自动锁屏」「静音运行」等设置保存在 `~/.config/uuremote/host_settings.json`。同一文件里的 `video_encoder`(`auto`/`cpu`/`vaapi`/`nvenc`)和 `video_codec`(`auto`/`h264`/`h265`)用 `uuremote-server set-encoder`、`uuremote-server set-codec` 写入(非法参数退出码 2)。非 `auto` 的值优先于 `UU_VIDEO_ENCODER` / `UU_VIDEO_CODEC`;`auto` 或留空则落到环境变量,再落到 auto(有 NVIDIA 时 NVENC 优先,失败再 CPU;没有 NVIDIA 时就是 CPU,不探测;codec 仍是硬件优先 H.265、CPU 用 H.264)。探测在启动时后台进行,不挡住第一路出图。成功结果缓存到进程退出,但 NVIDIA 是否存在(`/proc/driver/nvidia/version` 或 `/dev/nvidia0`)与报告不一致时,下一次桌面连接会在后台再探测一次(`warm_auto_probe`),这一路仍用缓存的编码器,直到新结果写入。NVENC 失败只缓存 10 分钟,到期后的桌面连接同样在后台再探测一次,这一路仍用当前结果。下次建立桌面连接时生效。显式 `vaapi` 请求真彩时仍用 VAAPI、编码 4:2:0,并在 CaptureSettingSync 的 field 3 回报 4:2:0。所选编码器在本机不可用时,建流回退 CPU 并记 warning。VAAPI 进入 auto 要等 #33。
|
|
||||||
|
`UU_USE_PROXY=1` 仅使用当前进程已有的代理配置;`HTTP_PROXY` / `HTTPS_PROXY` / `ALL_PROXY`(及小写形式)和 `NO_PROXY` 按 reqwest 的标准规则选择,大写优先。信令拒绝选定变量中的无效/不支持的代理 URL(仅 HTTP/HTTPS;不支持 SOCKS)、带路径/查询/片段的代理 URL,以及会忽略代理的 CGI 环境;此校验比 reqwest 默默忽略坏值更严格。未配置匹配代理或命中 `NO_PROXY` 时仍正常直连,选中代理后连接失败不会改为直连。信令保留 TLS 证书校验,不跟随重定向,也不转发认证头到重定向目标。
|
||||||
|
|
||||||
|
开启后主机还会经 TCP/TLS 连接云端 TURN 中继(使用 `HTTPS_PROXY`/`ALL_PROXY` 里的无认证 `http://` 代理做 CONNECT,没有代理则直连),适用于 UDP 到不了 TURN 服务器、只有 TCP/代理能出网的主机;TURN 证书按 CA 链校验,云端下发的 TURN 地址是 IP 时容忍名称不匹配(媒体本身由 DTLS-SRTP 端到端加密)。默认(不开代理)只用 UDP 中继,行为不变。**这不创建任何新的网络出口**:登录、信令和媒体仍需各自有允许使用的网络路径。连接器只返回固定错误类别/HTTP 状态;不要为诊断开启会记录 URL/认证信息的依赖库 TRACE 日志。
|
||||||
|
|
||||||
|
「远程结束后自动锁屏」「静音运行」等设置保存在 `~/.config/uuremote/host_settings.json`。同一文件里的 `video_encoder`(`auto`/`cpu`/`vaapi`/`nvenc`)和 `video_codec`(`auto`/`h264`/`h265`)用 `uuremote-server set-encoder`、`uuremote-server set-codec` 写入(非法参数退出码 2)。非 `auto` 的值优先于 `UU_VIDEO_ENCODER` / `UU_VIDEO_CODEC`;`auto` 或留空则落到环境变量,再落到 auto(有 NVIDIA 时 NVENC 优先,失败再 CPU;没有 NVIDIA 时就是 CPU,不探测;codec 仍是硬件优先 H.265、CPU 用 H.264)。探测在启动时后台进行,不挡住第一路出图。成功结果缓存到进程退出,但 NVIDIA 是否存在(`/proc/driver/nvidia/version` 或 `/dev/nvidia0`)与报告不一致时,下一次桌面连接会在后台再探测一次(`warm_auto_probe`),这一路仍用缓存的编码器,直到新结果写入。NVENC 失败只缓存 10 分钟,到期后的桌面连接同样在后台再探测一次,这一路仍用当前结果。`set-encoder` 和 `set-codec` 写完后若 `host.pid` 指向正在运行的本程序,都会发 `SIGUSR2`:编码器变化时进行中的桌面流立刻换编码器(不断开,沿用本会话已协商的 codec;新编码器起不来时按进程内 → FFmpeg 进程 → CPU 回退)。手改文件后可 `kill -USR2 $(cat ~/.config/uuremote/host.pid)`。`SIGUSR2` 不重新探测。codec 偏好仍在下次建立桌面连接时生效(运行中的 host 只记日志,不重开编码)。显式 `vaapi` 请求真彩时仍用 VAAPI、编码 4:2:0,并在 CaptureSettingSync 的 field 3 回报 4:2:0。所选编码器在本机不可用时,建流回退 CPU 并记 warning。VAAPI 进入 auto 要等 #33。
|
||||||
|
|
||||||
自定义码率按客户端选择的 Mbps 生效,例如 1 Mbps 对应 1000 kbit/s 的编码上限。
|
自定义码率按客户端选择的 Mbps 生效,例如 1 Mbps 对应 1000 kbit/s 的编码上限。
|
||||||
|
|
||||||
|
|||||||
@@ -732,7 +732,9 @@ int vaapi_encode_frame(
|
|||||||
rc.window_size = 1000;
|
rc.window_size = 1000;
|
||||||
rc.initial_qp = 28;
|
rc.initial_qp = 28;
|
||||||
rc.min_qp = 16;
|
rc.min_qp = 16;
|
||||||
rc.max_qp = 44;
|
// The driver's VBR raises QP only up to max_qp; 44 blocked the capped presets from reaching
|
||||||
|
// the QP 51 hardware floor on hard content (2560x1600 testsrc2: 4.16 -> 2.60 Mbps, #33)
|
||||||
|
rc.max_qp = 51;
|
||||||
rc.rc_flags.bits.disable_frame_skip = 1; // a remote desktop must not drop frames silently
|
rc.rc_flags.bits.disable_frame_skip = 1; // a remote desktop must not drop frames silently
|
||||||
b.misc[b.misc_n++] = vaapi_create_misc_buffer(engine, VAEncMiscParameterTypeRateControl, &rc, sizeof(rc));
|
b.misc[b.misc_n++] = vaapi_create_misc_buffer(engine, VAEncMiscParameterTypeRateControl, &rc, sizeof(rc));
|
||||||
|
|
||||||
|
|||||||
+17
-2
@@ -56,6 +56,15 @@ static void track_injected_key(int keycode, int is_press) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/* XShmAttach fails asynchronously (BadAccess when the X server cannot reach our segment, e.g. a
|
||||||
|
* server in another container); Xlib's default handler would exit the process before the XGetImage fallback. */
|
||||||
|
static volatile int g_shm_attach_failed = 0;
|
||||||
|
static int shm_attach_error(Display *display, XErrorEvent *event) {
|
||||||
|
(void)display; (void)event;
|
||||||
|
g_shm_attach_failed = 1;
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
static void shm_open_image(void) {
|
static void shm_open_image(void) {
|
||||||
g_use_shm = 0;
|
g_use_shm = 0;
|
||||||
if (!XShmQueryExtension(g_display)) return;
|
if (!XShmQueryExtension(g_display)) return;
|
||||||
@@ -66,9 +75,15 @@ static void shm_open_image(void) {
|
|||||||
if (g_shminfo.shmid == -1) return;
|
if (g_shminfo.shmid == -1) return;
|
||||||
g_shminfo.shmaddr = g_shm_image->data = (char *)shmat(g_shminfo.shmid, 0, 0);
|
g_shminfo.shmaddr = g_shm_image->data = (char *)shmat(g_shminfo.shmid, 0, 0);
|
||||||
g_shminfo.readOnly = False;
|
g_shminfo.readOnly = False;
|
||||||
if (g_shminfo.shmaddr != (char *)-1 && XShmAttach(g_display, &g_shminfo)) {
|
if (g_shminfo.shmaddr != (char *)-1) {
|
||||||
XSync(g_display, False);
|
XSync(g_display, False);
|
||||||
g_use_shm = 1;
|
g_shm_attach_failed = 0;
|
||||||
|
int (*previous)(Display *, XErrorEvent *) = XSetErrorHandler(shm_attach_error);
|
||||||
|
Status attached = XShmAttach(g_display, &g_shminfo);
|
||||||
|
XSync(g_display, False);
|
||||||
|
XSetErrorHandler(previous);
|
||||||
|
if (attached && !g_shm_attach_failed) g_use_shm = 1;
|
||||||
|
else fprintf(stderr, "X11 shared-memory capture unavailable; using XGetImage\n");
|
||||||
}
|
}
|
||||||
shmctl(g_shminfo.shmid, IPC_RMID, 0); // 标记删除,进程退出时自动回收;失败时也不遗留段
|
shmctl(g_shminfo.shmid, IPC_RMID, 0); // 标记删除,进程退出时自动回收;失败时也不遗留段
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,22 @@
|
|||||||
|
运行中切换编码器不再断开连接;X11 双屏/多屏可以只看其中一块屏幕(实验性)。/ Switch the encoder without dropping the session; select one monitor on X11 (experimental).
|
||||||
|
|
||||||
|
### 新增 / Added
|
||||||
|
- **运行中切换编码器(#85 第③步,#96,感谢 @ferstar)**:`uuremote-server set-encoder auto|cpu|vaapi|nvenc` 和 `set-codec` 写入设置后会通知正在运行的宿主(`SIGUSR2`),
|
||||||
|
已连接的桌面在下一帧边界换用新编码器,不用断开重连;VAAPI 不支持真彩 4:4:4 时自动降为 4:2:0 并通知客户端。只通知完整路径相同的宿主程序,
|
||||||
|
避免误杀旧版本宿主;没有通知到宿主时会打印提示(下次连接或重启服务后生效)。编码格式(H.264/H.265)偏好仍在下次连接时生效。
|
||||||
|
- **X11 单屏选择(#98,实验性)**:设置 `UU_X11_MULTISCREEN=1` 后,主机按 `xrandr --listmonitors` 列出各显示器,控制端可选择其中一块,只采集该区域,
|
||||||
|
鼠标绝对坐标加上该屏幕的偏移;默认主显示器,`UU_X11_OUTPUT` 可指定其他屏幕。显示器布局在启动时读取,改动后需重启服务;此模式下「分辨率」改为缩放画面。默认关闭,单屏用户不受影响。
|
||||||
|
- `set-encoder` / `set-codec` now switch a live desktop stream's encoder via `SIGUSR2` (same binary only) without reconnecting.
|
||||||
|
`UU_X11_MULTISCREEN=1` lets the viewer pick one X11 monitor (RandR monitors; capture and absolute input follow the selected monitor).
|
||||||
|
|
||||||
|
### 其他 / Other
|
||||||
|
- Issue 模板的诊断命令:保留连接状态和端口映射日志、过滤 WebRTC 内部噪音,并抹掉 IPv6 和 MAC 地址。
|
||||||
|
|
||||||
|
### 验证范围 / Validation
|
||||||
|
运行中切换编码器:单元测试与 CI,官方客户端下的切换时序尚未实机验证。X11 单屏选择:单元测试;在 Debian 13 上用两块 RandR 虚拟显示器实测,
|
||||||
|
鼠标落点与按区域采集正确;官方客户端在真实双屏上的切换尚未实机验证,欢迎反馈。
|
||||||
|
|
||||||
|
### 下载 / Download
|
||||||
|
`uu-remote-linux_0.2.29_<amd64|arm64>.deb`,或 `uu-remote-linux-v0.2.29-<x86_64|aarch64>-linux.tar.gz`(解压后运行 `./install.sh`),或 `docker pull ghcr.io/vallierdev/uu-remote-linux:v0.2.29`(x86_64)。
|
||||||
|
|
||||||
|
**非官方项目,与网易无关。** / **Unofficial, not affiliated with NetEase.**
|
||||||
@@ -0,0 +1,18 @@
|
|||||||
|
先开端口映射再打开桌面时不再黑屏;VAAPI 低码率档能压到更低码率。/ Opening the desktop after a port mapping no longer shows a black screen; VAAPI low-bitrate presets go lower.
|
||||||
|
|
||||||
|
### 修复 / Fixed
|
||||||
|
- **端口映射后打开桌面黑屏(#99)**:已有端口映射连接时,Mac 控制端打开桌面不会新建连接,而是在原连接上发送 `capture_desktop`。
|
||||||
|
宿主现在会把这条连接转为桌面:画面、光标、剪贴板和会话计数都会启动,剪贴板能力也会重新通告。之后再打开新的桌面时,旧连接只停掉桌面,
|
||||||
|
端口映射照常可用。若此前 X11 分辨率有变化,会按新尺寸重建采集。限制:Wayland Portal 后端暂不支持这种方式;这条连接上没有声音。
|
||||||
|
- **VAAPI 低档码率(#33,#102,感谢 @ferstar)**:in-process VAAPI 编码的最大 QP 从 44 放宽到 51,复杂画面下低档可降到硬件能达到的最低码率;中高档不受影响。
|
||||||
|
- A viewer that opens the desktop on an existing port-mapping connection (`capture_desktop`) now gets video, cursor, clipboard and session handling on that connection;
|
||||||
|
a later desktop stops it without closing the port mappings. In-process VAAPI `max_qp` raised from 44 to 51.
|
||||||
|
|
||||||
|
### 验证范围 / Validation
|
||||||
|
#99:根因由报告者日志证实;修复只有单元测试与 CI,官方 Mac 控制端下尚未实机验证,欢迎反馈。#102:贡献者在 AMD 核显上实测(2560×1600 复杂画面最低档 4.16→2.60 Mbps,
|
||||||
|
中高档输出一致),我们这边仅 CI。
|
||||||
|
|
||||||
|
### 下载 / Download
|
||||||
|
`uu-remote-linux_0.2.30_<amd64|arm64>.deb`,或 `uu-remote-linux-v0.2.30-<x86_64|aarch64>-linux.tar.gz`(解压后运行 `./install.sh`),或 `docker pull ghcr.io/vallierdev/uu-remote-linux:v0.2.30`(x86_64)。
|
||||||
|
|
||||||
|
**非官方项目,与网易无关。** / **Unofficial, not affiliated with NetEase.**
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
NVENC 新增可选 VBV 缓冲开关,缓解高分辨率下关键帧按 GOP 周期闪烁。/ Opt-in NVENC VBV buffer for high-resolution keyframe pulsing.
|
||||||
|
|
||||||
|
### 新增 / Added
|
||||||
|
- **`UU_NVENC_BUFFER_MS`(#103,感谢 @zhl-HFUT 的分析)**:NVENC 的 VBV 缓冲(10–1000 ms,缓冲 = 码率上限 × 毫秒 / 1000),FFmpeg 进程管线和进程内引擎都生效。
|
||||||
|
默认缓冲(100–500 kbit)在 1440p 等高分辨率下会把关键帧压糊,画面按 GOP 周期“糊一下再变清”;遇到时可设 `UU_NVENC_BUFFER_MS=1000`。默认行为不变。
|
||||||
|
- New `UU_NVENC_BUFFER_MS` (10–1000 ms of the bitrate cap) for NVENC, applied to both the FFmpeg pipeline and the in-process engine. Default unchanged.
|
||||||
|
|
||||||
|
### 验证范围 / Validation
|
||||||
|
仅单元测试与 CI,尚未在 NVENC 实机上验证,欢迎反馈。
|
||||||
|
|
||||||
|
### 下载 / Download
|
||||||
|
`uu-remote-linux_0.2.31_<amd64|arm64>.deb`,或 `uu-remote-linux-v0.2.31-<x86_64|aarch64>-linux.tar.gz`(解压后运行 `./install.sh`),或 `docker pull ghcr.io/vallierdev/uu-remote-linux:v0.2.31`(x86_64)。
|
||||||
|
|
||||||
|
**非官方项目,与网易无关。** / **Unofficial, not affiliated with NetEase.**
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
修复端口映射在 ICE 瞬断恢复后被续房拆掉、信令卡死后长时间假在线,以及查看器 CLI 的指针偏移与滚轮。/ Fixes port-mapping teardown after ICE recovery, stalled signaling, and viewer CLI pointer/wheel input.
|
||||||
|
|
||||||
|
### 修复 / Fixed
|
||||||
|
- **ICE 瞬断恢复后连接被拆(#109,感谢 @sinoyster 的细致分析)**:WebRTC 的 ICE 状态回调读到的是占位 DTLS 对象,ICE `Disconnected → Connected` 恢复后 PeerConnection 停在 `New`,15 分钟续房把仍在使用的端口映射当成空闲,拆房并断开所有映射 TCP 流。现在恢复后会回到 `Connected`。
|
||||||
|
After a brief ICE drop the peer state settled on `New` instead of `Connected`, so the idle room renewal tore down live port-mapping streams.
|
||||||
|
- **信令投递卡住时心跳检测失效(#104,感谢 @RiverOnVenus)**:事件队列阻塞时 Engine.IO 超时不再执行,主机可能带着半关闭的连接“在线”数小时。现在有独立看门狗、发送超时和关闭超时。
|
||||||
|
Heartbeat detection keeps running when event delivery stalls; the host reconnects instead of staying half-online.
|
||||||
|
- **查看器 CLI**:16:10 等非 16:9 主机的指针按内容区域映射,不再内偏(#107,感谢 @liuyanghejerry);鼠标滚轮/触控板转发为滚动(#108,感谢 @liuyanghejerry)。
|
||||||
|
Viewer CLI: pointer mapped to the content rectangle of the padded canvas; mouse wheel forwarded.
|
||||||
|
|
||||||
|
### 验证范围 / Validation
|
||||||
|
单元测试与 CI;#109 的 ICE 恢复场景尚未实机复现,欢迎反馈。
|
||||||
|
|
||||||
|
### 下载 / Download
|
||||||
|
`uu-remote-linux_0.2.32_<amd64|arm64>.deb`,或 `uu-remote-linux-v0.2.32-<x86_64|aarch64>-linux.tar.gz`(解压后运行 `./install.sh`),或 `docker pull ghcr.io/vallierdev/uu-remote-linux:v0.2.32`(x86_64)。
|
||||||
|
|
||||||
|
**非官方项目,与网易无关。** / **Unofficial, not affiliated with NetEase.**
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
修复 Wayland 锁屏或熄屏后,由工具连接(端口映射)升级的桌面视频结束后无法再次打开。/ Fixes a promoted tool connection whose desktop video could not be reopened after the screen locked or blanked.
|
||||||
|
|
||||||
|
### 修复 / Fixed
|
||||||
|
- **锁屏/熄屏后桌面无法重新打开(#114,感谢 @sinoyster 的完整报告)**:通过 capture_desktop 升级为桌面的工具连接上,若 Wayland 采集因锁屏或 DPMS 关闭而结束,再次 capture_desktop 不会重建视频,查看器只剩黑屏。现在会重新请求桌面并在原连接上重启视频,保留原输入租约。
|
||||||
|
On a tool connection promoted with capture_desktop, a desktop stream that ended (e.g. Wayland capture failing on lock/DPMS) is now restarted on the next capture_desktop, keeping the original input lease.
|
||||||
|
|
||||||
|
### 验证范围 / Validation
|
||||||
|
单元测试与 CI;#114 的锁屏场景尚未实机复现,欢迎反馈。
|
||||||
|
|
||||||
|
### 下载 / Download
|
||||||
|
`uu-remote-linux_0.2.33_<amd64|arm64>.deb`,或 `uu-remote-linux-v0.2.33-<x86_64|aarch64>-linux.tar.gz`(解压后运行 `./install.sh`),或 `docker pull ghcr.io/vallierdev/uu-remote-linux:v0.2.33`(x86_64)。
|
||||||
|
|
||||||
|
**非官方项目,与网易无关。** / **Unofficial, not affiliated with NetEase.**
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
修复网络波动后信令重连卡住,以及 Linux 控制端在平铺窗口管理器下画面空白。/ Fixes signaling reconnect stalling after a network hiccup, and the Linux viewer showing a blank window under tiling compositors.
|
||||||
|
|
||||||
|
### 修复 / Fixed
|
||||||
|
- **网络异常后停在 Acquired room signaling credentials(#115,感谢 @Changxi-M)**:信令 WebSocket 握手没有超时,网络半断时会无限等待,重连不再重试。现在握手限时 20 秒,超时后按原有退避重试。
|
||||||
|
The signaling WebSocket handshake is now bounded to 20 s, so a stalled handshake falls back to the normal reconnect retry instead of hanging forever.
|
||||||
|
- **控制端窗口平铺后画面空白(#118,感谢 @shao-zhijie)**:Linux 控制端只在收到新解码帧时绘制,合成器调整窗口尺寸后静止画面不会重绘;在尚未收到首帧时,Wayland 也不会映射没有提交缓冲的窗口。现在窗口尺寸变化/重新显示时用最后一帧重绘,无帧时先画黑底。
|
||||||
|
The Linux viewer now repaints the last frame after a compositor resize/expose, and paints a black frame before the first decoded frame so Wayland maps the window.
|
||||||
|
|
||||||
|
### 验证范围 / Validation
|
||||||
|
单元测试与 CI;#115、#118 的场景尚未实机复现,欢迎反馈。
|
||||||
|
|
||||||
|
### 下载 / Download
|
||||||
|
`uu-remote-linux_0.2.34_<amd64|arm64>.deb`,或 `uu-remote-linux-v0.2.34-<x86_64|aarch64>-linux.tar.gz`(解压后运行 `./install.sh`),或 `docker pull ghcr.io/vallierdev/uu-remote-linux:v0.2.34`(x86_64)。
|
||||||
|
|
||||||
|
**非官方项目,与网易无关。** / **Unofficial, not affiliated with NetEase.**
|
||||||
@@ -0,0 +1,21 @@
|
|||||||
|
信令可走 HTTP 代理、二维码登录错误分类、重复主机实例诊断,以及 Wayland 手机端文字输入兜底。/ Signaling through an opt-in HTTP proxy, clearer QR login errors, duplicate-host diagnostics, and a Wayland fallback for mobile text input.
|
||||||
|
|
||||||
|
### 新增 / Added
|
||||||
|
- **信令遵循 `UU_USE_PROXY=1`(#123)**:主机和 Linux 控制端的 WebSocket 信令改用与 REST 接口相同的 HTTP 客户端,开启 `UU_USE_PROXY=1` 后也走环境里的 HTTP/HTTPS 代理(不支持 SOCKS;选中的代理失败不会改为直连;不跟随重定向)。不代理 ICE/WebRTC 媒体。默认(不开代理)行为不变。
|
||||||
|
Host and viewer signaling now use the same HTTP client as the REST API, so `UU_USE_PROXY=1` applies to signaling too (HTTP/HTTPS proxies only, no direct fallback, no redirects). Media is not proxied; the default is unchanged.
|
||||||
|
- **Wayland/Portal 手机端文字输入兜底(#119,感谢 @shofukantkts)**:没有空闲键码的合成器和 Portal 后端上,手机端输入的文字经剪贴板 + Shift+Insert 粘贴;`UU_WAYLAND_TEXT=0` 可关闭。
|
||||||
|
Mobile text input on Portal and compositors without spare keycodes is pasted via the clipboard and Shift+Insert; `UU_WAYLAND_TEXT=0` disables it.
|
||||||
|
|
||||||
|
### 修复 / Fixed
|
||||||
|
- **二维码登录错误分类(#121)**:状态查询失败不再一律提示「网络超时」,区分超时、连接失败、响应异常与二维码过期;诊断只含阶段、类别、耗时和状态码,不输出票据、URL 或服务器内容。
|
||||||
|
QR polling failures are no longer all reported as a network timeout; timeouts, connection failures, bad responses and expiry are distinguished, with diagnostics that never include tickets, URLs or server content.
|
||||||
|
- **重复主机实例(#122)**:同一身份的两个主机实例(拷贝了 `config.json`,或残留的旧手动实例)会互相把对方踢出房间,表现为控制端一连就断。`doctor` 现在能数到重新执行后进程名为 `exe` 的实例并给出提示;README 说明不要在机器之间拷贝 `config.json`;日志会记录无 peer id 的 leave 事件结构(仅键名/类型/长度)。
|
||||||
|
Two host instances sharing one identity kick each other out of the room. `doctor` now counts re-executed instances and warns about extras, the README explains not to copy `config.json` between machines, and leave events without a peer id log their shape (keys/types/lengths only).
|
||||||
|
|
||||||
|
### 验证范围 / Validation
|
||||||
|
单元测试与 CI。#123 在真实 Linux X11 主机上实测不开代理时信令与 iPhone 桌面连接正常;经真实代理的信令尚未实测。#122 的修复在报告环境实机验证。
|
||||||
|
|
||||||
|
### 下载 / Download
|
||||||
|
`uu-remote-linux_0.2.35_<amd64|arm64>.deb`,或 `uu-remote-linux-v0.2.35-<x86_64|aarch64>-linux.tar.gz`(解压后运行 `./install.sh`),或 `docker pull ghcr.io/vallierdev/uu-remote-linux:v0.2.35`(x86_64)。
|
||||||
|
|
||||||
|
**非官方项目,与网易无关。** / **Unofficial, not affiliated with NetEase.**
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
修复 X11 共享内存被拒时主机直接退出,以及 Linux 控制端加入已有会话时可能永久黑屏。/ Fixes the host exiting when X11 refuses shared memory, and a possible black screen when the Linux viewer joins a host that already streams to another session.
|
||||||
|
|
||||||
|
### 修复 / Fixed
|
||||||
|
- **X11 MIT-SHM 被拒时直接退出**:X 服务器无法访问本程序的共享内存段时(例如 X 服务器在另一个容器里),`XShmAttach` 返回 BadAccess,Xlib 默认错误处理直接结束了进程,原有的 `XGetImage` 退路没有机会执行。现在捕获该错误并改用 `XGetImage` 抓屏。
|
||||||
|
When `XShmAttach` is refused (BadAccess, e.g. an X server in another container), the host now falls back to `XGetImage` instead of being terminated by Xlib's default error handler.
|
||||||
|
- **控制端加入已有会话时黑屏(#124,感谢 @shao-zhijie)**:Linux 控制端过去只在丢包或解码出错时请求关键帧;加入一条已在推流的干净 H.264 流时永远等不到 IDR。现在首帧显示前每 30 个访问单元请求一次关键帧(PLI),300 个仍无画面时日志给出提示。
|
||||||
|
The Linux viewer now requests key frames (PLI) every 30 access units until the first frame is shown, and logs a warning after 300.
|
||||||
|
|
||||||
|
### 验证范围 / Validation
|
||||||
|
单元测试与 CI。共享内存退路尚待在报告环境实机确认;#124 中官方 Mac 主机是否响应 PLI 尚未实测。
|
||||||
|
|
||||||
|
### 下载 / Download
|
||||||
|
`uu-remote-linux_0.2.36_<amd64|arm64>.deb`,或 `uu-remote-linux-v0.2.36-<x86_64|aarch64>-linux.tar.gz`(解压后运行 `./install.sh`),或 `docker pull ghcr.io/vallierdev/uu-remote-linux:v0.2.36`(x86_64)。
|
||||||
|
|
||||||
|
**非官方项目,与网易无关。** / **Unofficial, not affiliated with NetEase.**
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
`UU_USE_PROXY=1` 时经 TCP/TLS(可走 HTTP 代理)连接 TURN 中继,供 UDP 到不了中继服务器的主机使用。/ With `UU_USE_PROXY=1`, TURN relays are also reached over TCP/TLS (optionally through the HTTP proxy) for hosts whose UDP cannot reach the relay servers.
|
||||||
|
|
||||||
|
### 新增 / Added
|
||||||
|
- **TURN over TCP/TLS**:云端在强制中继的会话里也会下发 `turns:<IP>:<端口>?transport=tcp`,原来使用的 webrtc-ice 只支持 UDP 中继,UDP 被限制、只能经 HTTP 代理出网的主机因此拿不到任何中继候选,控制端一直"正在尝试重连"。现在开启 `UU_USE_PROXY=1` 后,主机会经 `HTTPS_PROXY`/`ALL_PROXY` 中的无认证 `http://` 代理(没有则直连)建立 TCP/TLS 中继连接。TURN 证书按 CA 链校验,仅在云端下发的地址为 IP 时容忍名称不匹配;媒体仍由 DTLS-SRTP 端到端加密。未开启时只用 UDP 中继,行为不变(`vendor/webrtc-ice/PATCHES.md`)。
|
||||||
|
With `UU_USE_PROXY=1` the host also opens TURN relays over TCP/TLS through the unauthenticated `http://` proxy (or directly), chain-verifying certificates and tolerating a name mismatch only for IP TURN URLs. The default stays UDP-only.
|
||||||
|
|
||||||
|
### 验证范围 / Validation
|
||||||
|
单元测试(经模拟代理的 CONNECT 与 STUN/ChannelData 分帧)与 CI;与真实 TURN 服务器的 TCP/TLS 分配尚待在报告环境实机确认。
|
||||||
|
|
||||||
|
### 下载 / Download
|
||||||
|
`uu-remote-linux_0.2.37_<amd64|arm64>.deb`,或 `uu-remote-linux-v0.2.37-<x86_64|aarch64>-linux.tar.gz`(解压后运行 `./install.sh`),或 `docker pull ghcr.io/vallierdev/uu-remote-linux:v0.2.37`(x86_64)。
|
||||||
|
|
||||||
|
**非官方项目,与网易无关。** / **Unofficial, not affiliated with NetEase.**
|
||||||
+109
-9
@@ -91,6 +91,48 @@ pub struct UUAuthClient {
|
|||||||
guest_id: Option<String>,
|
guest_id: Option<String>,
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// QR failures are safe to display: never retain a URL, source error or response body.
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||||||
|
pub enum QrRequestErrorKind { Timeout, Connect, Decode, Body, Request }
|
||||||
|
impl QrRequestErrorKind {
|
||||||
|
fn from_reqwest(error: &reqwest::Error) -> Self {
|
||||||
|
if error.is_timeout() { Self::Timeout }
|
||||||
|
else if error.is_connect() { Self::Connect }
|
||||||
|
else if error.is_decode() { Self::Decode }
|
||||||
|
else if error.is_body() { Self::Body }
|
||||||
|
else { Self::Request }
|
||||||
|
}
|
||||||
|
fn label(self) -> &'static str {
|
||||||
|
match self { Self::Timeout => "timeout", Self::Connect => "connect", Self::Decode => "decode",
|
||||||
|
Self::Body => "body", Self::Request => "request" }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#[derive(Debug)]
|
||||||
|
pub struct QrRequestError {
|
||||||
|
pub kind: QrRequestErrorKind,
|
||||||
|
phase: &'static str,
|
||||||
|
elapsed_ms: u128,
|
||||||
|
http_status: Option<u16>,
|
||||||
|
}
|
||||||
|
impl std::fmt::Display for QrRequestError {
|
||||||
|
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
||||||
|
write!(f, "phase={} kind={} elapsed_ms={} http_status={:?}",
|
||||||
|
self.phase, self.kind.label(), self.elapsed_ms, self.http_status)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
impl QrRequestError {
|
||||||
|
pub fn response_received(&self) -> bool { self.http_status.is_some() }
|
||||||
|
fn new(kind: QrRequestErrorKind, phase: &'static str, started: std::time::Instant, http_status: Option<u16>) -> Self {
|
||||||
|
Self { kind, phase, elapsed_ms: started.elapsed().as_millis(), http_status }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
async fn send_qr_request(request: reqwest::RequestBuilder, started: std::time::Instant) -> Result<(u16, serde_json::Value), QrRequestError> {
|
||||||
|
let resp = request.send().await.map_err(|e| QrRequestError::new(QrRequestErrorKind::from_reqwest(&e), "send", started, None))?;
|
||||||
|
let status = resp.status().as_u16();
|
||||||
|
let value = resp.json().await.map_err(|e| QrRequestError::new(QrRequestErrorKind::from_reqwest(&e), "response", started, Some(status)))?;
|
||||||
|
Ok((status, value))
|
||||||
|
}
|
||||||
|
|
||||||
/// Transport failures name only the outer request; the cause (certificate, proxy, DNS,
|
/// Transport failures name only the outer request; the cause (certificate, proxy, DNS,
|
||||||
/// timeout) lives in the source chain. URL user-info (proxy credentials) and query
|
/// timeout) lives in the source chain. URL user-info (proxy credentials) and query
|
||||||
/// strings are removed before the chain is shown.
|
/// strings are removed before the chain is shown.
|
||||||
@@ -121,17 +163,20 @@ fn redact_urls(text: &str) -> String {
|
|||||||
out
|
out
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Cloud API clients ignore ambient HTTP/SOCKS proxy settings by default: a local
|
/// Cloud API and signaling clients ignore ambient HTTP/HTTPS proxy settings by default: a local
|
||||||
/// proxy that intercepts TLS breaks login and signaling. `UU_USE_PROXY=1` opts back
|
/// proxy that intercepts TLS breaks login and signaling. `UU_USE_PROXY=1` opts back
|
||||||
/// into reqwest's standard proxy environment handling.
|
/// into reqwest's standard proxy environment handling.
|
||||||
pub fn http_client_builder() -> reqwest::ClientBuilder {
|
pub fn http_client_builder() -> reqwest::ClientBuilder {
|
||||||
let builder = reqwest::Client::builder();
|
let builder = reqwest::Client::builder();
|
||||||
if std::env::var("UU_USE_PROXY").ok().as_deref().is_some_and(proxy_requested) {
|
if proxy_enabled() {
|
||||||
builder
|
builder
|
||||||
} else {
|
} else {
|
||||||
builder.no_proxy()
|
builder.no_proxy()
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
pub(crate) fn proxy_enabled() -> bool {
|
||||||
|
std::env::var("UU_USE_PROXY").ok().as_deref().is_some_and(proxy_requested)
|
||||||
|
}
|
||||||
fn proxy_requested(value: &str) -> bool {
|
fn proxy_requested(value: &str) -> bool {
|
||||||
matches!(value.trim().to_ascii_lowercase().as_str(), "1" | "true" | "yes" | "on")
|
matches!(value.trim().to_ascii_lowercase().as_str(), "1" | "true" | "yes" | "on")
|
||||||
}
|
}
|
||||||
@@ -253,13 +298,13 @@ impl UUAuthClient {
|
|||||||
|
|
||||||
/// Signed POST with an optional JSON body (None = empty body, like Moya `requestPlain`) and an
|
/// Signed POST with an optional JSON body (None = empty body, like Moya `requestPlain`) and an
|
||||||
/// explicit timeout. The official clients long-poll the QR status with a 60 s request timeout.
|
/// explicit timeout. The official clients long-poll the QR status with a 60 s request timeout.
|
||||||
pub async fn post_with_timeout(&self, path: &str, body: Option<&serde_json::Value>, timeout: std::time::Duration) -> Result<(u16, serde_json::Value), String> {
|
pub async fn post_with_timeout(&self, path: &str, body: Option<&serde_json::Value>, timeout: std::time::Duration) -> Result<(u16, serde_json::Value), QrRequestError> {
|
||||||
let body_str = body.map(serde_json::to_string).transpose().map_err(|e| e.to_string())?.unwrap_or_default();
|
let started = std::time::Instant::now();
|
||||||
let resp = self.http.post(format!("{}{}", BASE_URL, path)).timeout(timeout)
|
let body_str = body.map(serde_json::to_string).transpose()
|
||||||
.headers(self.build_headers("POST", path, &body_str)).body(body_str)
|
.map_err(|_| QrRequestError::new(QrRequestErrorKind::Request, "encode", started, None))?.unwrap_or_default();
|
||||||
.send().await.map_err(|e| format!("HTTP post {path} failed: {}", transport_error(&e)))?;
|
let request = self.http.post(format!("{}{}", BASE_URL, path)).timeout(timeout)
|
||||||
let status = resp.status().as_u16();
|
.headers(self.build_headers("POST", path, &body_str)).body(body_str);
|
||||||
Ok((status, resp.json().await.unwrap_or(serde_json::Value::Null)))
|
send_qr_request(request, started).await
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Signed JSON POST to another API host (the signature covers the path only).
|
/// Signed JSON POST to another API host (the signature covers the path only).
|
||||||
@@ -389,3 +434,58 @@ mod guest_tests {
|
|||||||
for value in ["", "0", "false", "no", "off", "2"] { assert!(!super::proxy_requested(value)); }
|
for value in ["", "0", "false", "no", "off", "2"] { assert!(!super::proxy_requested(value)); }
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod qr_request_tests {
|
||||||
|
use super::*;
|
||||||
|
use std::time::{Duration, Instant};
|
||||||
|
use tokio::io::{AsyncReadExt, AsyncWriteExt};
|
||||||
|
|
||||||
|
// Synthetic, loopback-only responses: no account, device, proxy or live login API.
|
||||||
|
async fn response(reply: &'static [u8], stall: bool) -> QrRequestError {
|
||||||
|
let listener = tokio::net::TcpListener::bind("127.0.0.1:0").await.unwrap();
|
||||||
|
let addr = listener.local_addr().unwrap();
|
||||||
|
let server = tokio::spawn(async move {
|
||||||
|
let (mut socket, _) = listener.accept().await.unwrap();
|
||||||
|
let mut request = [0u8; 4096];
|
||||||
|
let _ = socket.read(&mut request).await.unwrap();
|
||||||
|
socket.write_all(reply).await.unwrap();
|
||||||
|
if stall { std::future::pending::<()>().await; }
|
||||||
|
});
|
||||||
|
let request = reqwest::Client::builder().no_proxy().build().unwrap()
|
||||||
|
.post(format!("http://fixture-user:fixture-password@{addr}/fixture-path?token=fixture-ticket"))
|
||||||
|
.timeout(Duration::from_secs(2));
|
||||||
|
let error = send_qr_request(request, Instant::now()).await.unwrap_err();
|
||||||
|
server.abort();
|
||||||
|
let output = format!("{error} {error:?}");
|
||||||
|
for secret in ["fixture-user", "fixture-password", "fixture-path", "fixture-ticket", "fixture-body", "127.0.0.1", "http://"] {
|
||||||
|
assert!(!output.contains(secret));
|
||||||
|
}
|
||||||
|
error
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn qr_request_distinguishes_send_timeout_body_timeout_and_bad_json_without_secrets() {
|
||||||
|
let error = response(b"", true).await;
|
||||||
|
assert_eq!((error.kind, error.phase, error.http_status), (QrRequestErrorKind::Timeout, "send", None));
|
||||||
|
assert!(!error.response_received());
|
||||||
|
let error = response(b"HTTP/1.1 200 OK\r\nContent-Length: 100\r\n\r\n", true).await;
|
||||||
|
assert_eq!((error.kind, error.phase, error.http_status), (QrRequestErrorKind::Timeout, "response", Some(200)));
|
||||||
|
assert!(error.response_received());
|
||||||
|
let error = response(b"HTTP/1.1 502 Bad Gateway\r\nContent-Length: 12\r\n\r\nfixture-body", false).await;
|
||||||
|
assert_eq!((error.kind, error.phase, error.http_status), (QrRequestErrorKind::Decode, "response", Some(502)));
|
||||||
|
assert!(error.response_received());
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn qr_connection_failure_is_not_a_timeout() {
|
||||||
|
let listener = tokio::net::TcpListener::bind("127.0.0.1:0").await.unwrap();
|
||||||
|
let addr = listener.local_addr().unwrap();
|
||||||
|
drop(listener);
|
||||||
|
let request = reqwest::Client::builder().no_proxy().build().unwrap()
|
||||||
|
.post(format!("http://{addr}/fixture-ticket")).timeout(Duration::from_secs(2));
|
||||||
|
let error = send_qr_request(request, Instant::now()).await.unwrap_err();
|
||||||
|
assert_eq!((error.kind, error.phase, error.http_status), (QrRequestErrorKind::Connect, "send", None));
|
||||||
|
assert!(!format!("{error} {error:?}").contains("fixture-ticket"));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -56,6 +56,12 @@ pub fn x11_size() -> Option<(u32, u32)> {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/// The root size from the last refresh, without an X round trip (pointer mapping).
|
/// The root size from the last refresh, without an X round trip (pointer mapping).
|
||||||
|
/// Display the X11 engine opened, once a capture has initialized it.
|
||||||
|
pub fn x11_display() -> Option<String> {
|
||||||
|
let name = unsafe { x11_display_name() };
|
||||||
|
if name.is_null() { None } else { Some(unsafe { std::ffi::CStr::from_ptr(name) }.to_string_lossy().into_owned()) }
|
||||||
|
}
|
||||||
|
|
||||||
pub fn x11_last_size() -> Option<(u32, u32)> {
|
pub fn x11_last_size() -> Option<(u32, u32)> {
|
||||||
let (mut w, mut h): (libc::c_int, libc::c_int) = (0, 0);
|
let (mut w, mut h): (libc::c_int, libc::c_int) = (0, 0);
|
||||||
if unsafe { x11_get_dimensions(&mut w, &mut h) } != 0 || w <= 0 || h <= 0 { return None; }
|
if unsafe { x11_get_dimensions(&mut w, &mut h) } != 0 || w <= 0 || h <= 0 { return None; }
|
||||||
|
|||||||
@@ -215,3 +215,56 @@ async fn locked_control_unlock_requests_and_tools_work_without_a_video_frame() {
|
|||||||
drop(lock);
|
drop(lock);
|
||||||
}).await.expect("locked bootstrap/tool regression exceeded deadline");
|
}).await.expect("locked bootstrap/tool regression exceeded deadline");
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn capture_desktop_on_a_port_mapping_peer_promotes_it_once() {
|
||||||
|
tokio::time::timeout(Duration::from_secs(25), async {
|
||||||
|
let input = Arc::new(InputInjector::without_desktop());
|
||||||
|
let (host, mut viewer) = connect(input.clone(), false, None, &["CONTROL_DATA_CHANNEL", "FILE_DATA_CHANNEL"]).await;
|
||||||
|
let (requests, mut requested) = mpsc::unbounded_channel();
|
||||||
|
host.on_desktop_request(move || { let _ = requests.send(()); });
|
||||||
|
receive(&mut viewer.messages, "CONTROL_DATA_CHANNEL", 13).await;
|
||||||
|
assert!(!host.role.is_desktop() && host.role.input().is_none());
|
||||||
|
// The Mac viewer opens the desktop on its existing port-mapping peer (#99).
|
||||||
|
send(&viewer, "CONTROL_DATA_CHANNEL", crate::initialization::envelope(5, 0, 3, &[8, 4])).await;
|
||||||
|
tokio::time::timeout(Duration::from_secs(5), requested.recv()).await.unwrap().unwrap();
|
||||||
|
host.promote(None);
|
||||||
|
assert!(host.role.is_desktop());
|
||||||
|
assert!(host.role.input().is_some_and(|session| session.is_current()));
|
||||||
|
// CONTROL repeats the desktop initialization for the same viewer.
|
||||||
|
receive(&mut viewer.messages, "CONTROL_DATA_CHANNEL", 13).await;
|
||||||
|
// The port-mapping session on this peer still answers.
|
||||||
|
send(&viewer, "FILE_DATA_CHANNEL", mapping(2, b"still mapped")).await;
|
||||||
|
receive(&mut viewer.messages, "FILE_DATA_CHANNEL", 27).await;
|
||||||
|
// A repeated capture_desktop does not ask again, and a later promote is a no-op.
|
||||||
|
send(&viewer, "CONTROL_DATA_CHANNEL", crate::initialization::envelope(6, 0, 3, &[8, 4])).await;
|
||||||
|
send(&viewer, "CONTROL_DATA_CHANNEL", crate::initialization::envelope(7, 0, 3, &[8, 0])).await;
|
||||||
|
receive(&mut viewer.messages, "CONTROL_DATA_CHANNEL", 3).await;
|
||||||
|
assert!(requested.try_recv().is_err());
|
||||||
|
let lease = host.role.input().unwrap();
|
||||||
|
host.promote(None);
|
||||||
|
assert!(lease.is_current());
|
||||||
|
// Its video ended on its own (capture failed while locked, #114): capture_desktop restarts it
|
||||||
|
// on the same input lease.
|
||||||
|
let ended = tokio::spawn(async {});
|
||||||
|
*host.role.stream_task.lock().unwrap() = Some(ended.abort_handle());
|
||||||
|
ended.await.unwrap();
|
||||||
|
send(&viewer, "CONTROL_DATA_CHANNEL", crate::initialization::envelope(9, 0, 3, &[8, 4])).await;
|
||||||
|
tokio::time::timeout(Duration::from_secs(5), requested.recv()).await.unwrap().unwrap();
|
||||||
|
host.promote(None);
|
||||||
|
assert!(host.role.is_desktop() && !host.role.stream_ended() && lease.is_current());
|
||||||
|
// A newer desktop demotes it; the port mapping stays, and capture_desktop promotes it again.
|
||||||
|
host.demote();
|
||||||
|
assert!(!host.role.is_desktop() && host.role.input().is_none());
|
||||||
|
send(&viewer, "FILE_DATA_CHANNEL", mapping(2, b"after demotion")).await;
|
||||||
|
receive(&mut viewer.messages, "FILE_DATA_CHANNEL", 27).await;
|
||||||
|
send(&viewer, "CONTROL_DATA_CHANNEL", crate::initialization::envelope(8, 0, 3, &[8, 4])).await;
|
||||||
|
tokio::time::timeout(Duration::from_secs(5), requested.recv()).await.unwrap().unwrap();
|
||||||
|
host.promote(None);
|
||||||
|
assert!(host.role.is_desktop() && host.role.input().is_some_and(|session| session.is_current()));
|
||||||
|
receive(&mut viewer.messages, "CONTROL_DATA_CHANNEL", 13).await;
|
||||||
|
host.pc.close().await.unwrap();
|
||||||
|
viewer.pc.close().await.unwrap();
|
||||||
|
viewer.router.lock().await.stop().await.unwrap();
|
||||||
|
}).await.expect("capture_desktop promotion exceeded deadline");
|
||||||
|
}
|
||||||
+50
-2
@@ -147,11 +147,39 @@ pub async fn run() -> Result<(), String> {
|
|||||||
Err(_) => line("config mode", "missing (run `uuremote-server login`)"),
|
Err(_) => line("config mode", "missing (run `uuremote-server login`)"),
|
||||||
}
|
}
|
||||||
line("service", command_output("systemctl", &["--user", "is-active", "uuremote-native.service"]).await.unwrap_or_else(|| "systemctl unavailable".into()));
|
line("service", command_output("systemctl", &["--user", "is-active", "uuremote-native.service"]).await.unwrap_or_else(|| "systemctl unavailable".into()));
|
||||||
let running = command_output("pgrep", &["-c", "-x", "uuremote-server"]).await.filter(|n| !n.is_empty()).unwrap_or_else(|| "unknown".into());
|
let running = host_processes();
|
||||||
line("uuremote-server procs", format!("{running} (including this one; more than 2 means duplicates)"));
|
line("uuremote-server procs", format!("{} (including this one; more than 2 means duplicates)", running.map_or_else(|| "unknown".into(), |n| n.to_string())));
|
||||||
|
if running.is_some_and(|n| n > 2) {
|
||||||
|
println!(" ! another host instance is running (check `pgrep -af uuremote`); stop the extra one, e.g. an old copy started by hand");
|
||||||
|
println!(" instances sharing one identity, on this or another machine, kick each other out of the room: never copy config.json between machines");
|
||||||
|
}
|
||||||
Ok(())
|
Ok(())
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Hosts re-exec through /proc/self/exe (comm "exe"), so match the executable's file name, not the process name.
|
||||||
|
/// Helpers a host spawns (Wayland capture, login window) are its children and are not separate instances.
|
||||||
|
fn host_processes() -> Option<usize> {
|
||||||
|
let hosts: Vec<(u32, u32)> = std::fs::read_dir("/proc").ok()?.flatten()
|
||||||
|
.filter_map(|entry| Some((entry.file_name().to_str()?.parse::<u32>().ok()?, entry.path())))
|
||||||
|
.filter(|(_, dir)| std::fs::read_link(dir.join("exe")).is_ok_and(|exe| is_host_executable(&exe)))
|
||||||
|
.filter_map(|(pid, dir)| Some((pid, parent_pid(&std::fs::read_to_string(dir.join("stat")).ok()?)?)))
|
||||||
|
.collect();
|
||||||
|
Some(top_level(&hosts))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Field 4 of /proc/<pid>/stat; the command name in field 2 may contain spaces and parentheses.
|
||||||
|
fn parent_pid(stat: &str) -> Option<u32> {
|
||||||
|
stat.rsplit_once(')')?.1.split_whitespace().nth(1)?.parse().ok()
|
||||||
|
}
|
||||||
|
|
||||||
|
fn top_level(hosts: &[(u32, u32)]) -> usize {
|
||||||
|
hosts.iter().filter(|(_, parent)| !hosts.iter().any(|(pid, _)| pid == parent)).count()
|
||||||
|
}
|
||||||
|
|
||||||
|
fn is_host_executable(exe: &std::path::Path) -> bool {
|
||||||
|
exe.file_name().and_then(|name| name.to_str()).is_some_and(|name| name.trim_end_matches(" (deleted)") == "uuremote-server")
|
||||||
|
}
|
||||||
|
|
||||||
#[cfg(test)]
|
#[cfg(test)]
|
||||||
mod tests {
|
mod tests {
|
||||||
#[test]
|
#[test]
|
||||||
@@ -174,4 +202,24 @@ mod tests {
|
|||||||
assert!(!super::missing_display(DesktopBackend::Wayland, false, None, None));
|
assert!(!super::missing_display(DesktopBackend::Wayland, false, None, None));
|
||||||
assert!(!super::missing_display(DesktopBackend::X11, true, None, None));
|
assert!(!super::missing_display(DesktopBackend::X11, true, None, None));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn host_processes_match_the_executable_even_after_reexec() {
|
||||||
|
use std::path::Path;
|
||||||
|
for exe in ["/usr/bin/uuremote-server", "/home/u/.local/bin/uuremote-server", "/usr/bin/uuremote-server (deleted)"] {
|
||||||
|
assert!(super::is_host_executable(Path::new(exe)));
|
||||||
|
}
|
||||||
|
for exe in ["/usr/bin/uuremote-viewer", "/usr/bin/bash", "/usr/bin/uuremote-server-old"] {
|
||||||
|
assert!(!super::is_host_executable(Path::new(exe)));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn host_helpers_are_not_counted_as_instances() {
|
||||||
|
assert_eq!(super::parent_pid("8943 (exe) S 1699 8943 1699 0 -1"), Some(1699));
|
||||||
|
assert_eq!(super::parent_pid("12 (a) b (c) R 7 12"), Some(7));
|
||||||
|
// service 10 with a login window 11, a stale copy 20, doctor 30
|
||||||
|
assert_eq!(super::top_level(&[(10, 1), (11, 10), (20, 5), (30, 9)]), 3);
|
||||||
|
assert_eq!(super::top_level(&[(10, 1), (11, 10), (30, 9)]), 2);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
+163
-5
@@ -334,9 +334,12 @@ impl InputInjector {
|
|||||||
let result=crate::wayland::move_pointer(x,y,false);
|
let result=crate::wayland::move_pointer(x,y,false);
|
||||||
if result!=-2 { return result; }
|
if result!=-2 { return result; }
|
||||||
}
|
}
|
||||||
|
// X11 multi-screen: the point is inside the selected monitor; XTest and uinput span the root.
|
||||||
|
let placement=if relative || self.backend!=crate::desktop_backend::DesktopBackend::X11 {None} else {crate::wayland::x11_placement()};
|
||||||
|
let (x,y)=placement.map_or((x,y),|(ox,oy)|(x+ox,y+oy));
|
||||||
if let Some(uinput)=&self.uinput {
|
if let Some(uinput)=&self.uinput {
|
||||||
if relative { return Self::uinput_result(uinput.move_relative(x,y)); }
|
if relative { return Self::uinput_result(uinput.move_relative(x,y)); }
|
||||||
let (w,h)=*self.screen.lock().unwrap();
|
let (w,h)=placement.and_then(|_|crate::capture::x11_last_size()).unwrap_or(*self.screen.lock().unwrap());
|
||||||
if w > 1 && h > 1 {
|
if w > 1 && h > 1 {
|
||||||
let scale = |v: i32, extent: u32| (i64::from(v) * i64::from(crate::uinput::ABS_MAX) / i64::from(extent - 1)) as i32;
|
let scale = |v: i32, extent: u32| (i64::from(v) * i64::from(crate::uinput::ABS_MAX) / i64::from(extent - 1)) as i32;
|
||||||
return Self::uinput_result(uinput.move_absolute(scale(x,w),scale(y,h)));
|
return Self::uinput_result(uinput.move_absolute(scale(x,w),scale(y,h)));
|
||||||
@@ -369,8 +372,93 @@ impl InputInjector {
|
|||||||
if self.backend==crate::desktop_backend::DesktopBackend::Wayland { crate::wayland::key(symbol,pressed) }
|
if self.backend==crate::desktop_backend::DesktopBackend::Wayland { crate::wayland::key(symbol,pressed) }
|
||||||
else { unsafe { x11_key_symbol(symbol as libc::c_ulong,i32::from(pressed)) } }
|
else { unsafe { x11_key_symbol(symbol as libc::c_ulong,i32::from(pressed)) } }
|
||||||
}
|
}
|
||||||
|
/// Set clipboard content for text injection on Wayland / Portal.
|
||||||
|
/// Tries Portal RemoteDesktop.SetSelection first, then wl-copy as fallback.
|
||||||
|
fn set_clipboard_text(&self, text: &str) -> bool {
|
||||||
|
if text.is_empty() || text.len() > crate::clipboard::MAX_TEXT {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
// In unit tests, never invoke external clipboard binaries (wl-copy)
|
||||||
|
// or alter the system clipboard to prevent side effects on developer desktops.
|
||||||
|
#[cfg(test)]
|
||||||
|
{
|
||||||
|
let _ = text;
|
||||||
|
false
|
||||||
|
}
|
||||||
|
#[cfg(not(test))]
|
||||||
|
{
|
||||||
|
// 1. Try Portal clipboard if session is bound and active
|
||||||
|
if let Some(portal) = self.portal.lock().unwrap().as_ref() {
|
||||||
|
if portal.clipboard_set(text).is_ok() {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// 2. Try wl-copy in Wayland session
|
||||||
|
if std::env::var_os("WAYLAND_DISPLAY").is_some() {
|
||||||
|
if let Ok(mut child) = std::process::Command::new("wl-copy")
|
||||||
|
.args(["--type", "text/plain;charset=utf-8"])
|
||||||
|
.stdin(std::process::Stdio::piped())
|
||||||
|
.stdout(std::process::Stdio::null())
|
||||||
|
.stderr(std::process::Stdio::null())
|
||||||
|
.spawn()
|
||||||
|
{
|
||||||
|
if let Some(mut stdin) = child.stdin.take() {
|
||||||
|
use std::io::Write;
|
||||||
|
let _ = stdin.write_all(text.as_bytes());
|
||||||
|
}
|
||||||
|
if let Ok(status) = child.wait() {
|
||||||
|
if status.success() {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Injects text by copying it to the clipboard and simulating a paste shortcut.
|
||||||
|
/// Uses Shift+Insert by default (broadest Linux compatibility across GUI apps and terminals),
|
||||||
|
/// or Ctrl+V if configured via UU_WAYLAND_PASTE_KEY=ctrl_v.
|
||||||
|
fn paste_text_via_clipboard(&self, text: &str) -> bool {
|
||||||
|
if !self.set_clipboard_text(text) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Give the clipboard daemon / compositor a brief moment to register the selection.
|
||||||
|
std::thread::sleep(std::time::Duration::from_millis(25));
|
||||||
|
|
||||||
|
let use_ctrl_v = std::env::var("UU_WAYLAND_PASTE_KEY")
|
||||||
|
.is_ok_and(|v| v.eq_ignore_ascii_case("ctrl_v") || v.eq_ignore_ascii_case("ctrl+v"));
|
||||||
|
|
||||||
|
if use_ctrl_v {
|
||||||
|
// Control_L (0xffe3) + 'v' (0x76)
|
||||||
|
self.inject_key(0xffe3, true);
|
||||||
|
std::thread::sleep(std::time::Duration::from_millis(15));
|
||||||
|
self.inject_key(0x76, true);
|
||||||
|
std::thread::sleep(std::time::Duration::from_millis(20));
|
||||||
|
self.inject_key(0x76, false);
|
||||||
|
std::thread::sleep(std::time::Duration::from_millis(15));
|
||||||
|
self.inject_key(0xffe3, false);
|
||||||
|
} else {
|
||||||
|
// Shift_L (0xffe1) + Insert (0xff63)
|
||||||
|
self.inject_key(0xffe1, true);
|
||||||
|
std::thread::sleep(std::time::Duration::from_millis(15));
|
||||||
|
self.inject_key(0xff63, true);
|
||||||
|
std::thread::sleep(std::time::Duration::from_millis(20));
|
||||||
|
self.inject_key(0xff63, false);
|
||||||
|
std::thread::sleep(std::time::Duration::from_millis(15));
|
||||||
|
self.inject_key(0xffe1, false);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Brief delay allowing the target application to consume the paste event
|
||||||
|
std::thread::sleep(std::time::Duration::from_millis(25));
|
||||||
|
true
|
||||||
|
}
|
||||||
|
|
||||||
/// Mobile input-method text (`text_input`). X11 types it directly; Wayland re-maps a spare
|
/// Mobile input-method text (`text_input`). X11 types it directly; Wayland re-maps a spare
|
||||||
/// keycode in the virtual keyboard's keymap. Other backends log once.
|
/// keycode in the virtual keyboard's keymap. Portal and other Wayland environments inject
|
||||||
|
/// via clipboard paste (Shift+Insert). Set UU_WAYLAND_TEXT=0 to disable Wayland text injection.
|
||||||
pub fn text_input(&self, text: &str) {
|
pub fn text_input(&self, text: &str) {
|
||||||
let _serial=self.serial.lock().unwrap();
|
let _serial=self.serial.lock().unwrap();
|
||||||
let Ok(c_text)=std::ffi::CString::new(text.replace('\0',"")) else { return };
|
let Ok(c_text)=std::ffi::CString::new(text.replace('\0',"")) else { return };
|
||||||
@@ -378,17 +466,31 @@ impl InputInjector {
|
|||||||
let typed=unsafe { x11_type_utf8(c_text.as_ptr()) };
|
let typed=unsafe { x11_type_utf8(c_text.as_ptr()) };
|
||||||
log::info!("Desktop text input: chars={} result={}", text.chars().count(), typed);
|
log::info!("Desktop text input: chars={} result={}", text.chars().count(), typed);
|
||||||
} else if self.backend==crate::desktop_backend::DesktopBackend::Wayland {
|
} else if self.backend==crate::desktop_backend::DesktopBackend::Wayland {
|
||||||
// Escape hatch: keep the old behaviour without rebuilding.
|
// Escape hatch: disable Wayland text typing/pasting entirely without rebuilding.
|
||||||
if std::env::var("UU_WAYLAND_TEXT").is_ok_and(|v|v=="0") { return; }
|
if std::env::var("UU_WAYLAND_TEXT").is_ok_and(|v|v=="0") { return; }
|
||||||
let typed=crate::wayland::type_utf8(text);
|
let typed=crate::wayland::type_utf8(text);
|
||||||
if typed>=0 {
|
if typed>=0 {
|
||||||
log::info!("Desktop text input: chars={} result={}", text.chars().count(), typed);
|
log::info!("Desktop text input: chars={} result={}", text.chars().count(), typed);
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
// A keymap whose keycodes are all mapped cannot carry text; report it once.
|
// Fallback to clipboard paste if keymap has no spare keycodes or native typing failed
|
||||||
|
if self.paste_text_via_clipboard(text) {
|
||||||
|
log::info!("Desktop text input (Wayland clipboard paste fallback): chars={} result=ok", text.chars().count());
|
||||||
|
return;
|
||||||
|
}
|
||||||
static WARNED:std::sync::atomic::AtomicBool=std::sync::atomic::AtomicBool::new(false);
|
static WARNED:std::sync::atomic::AtomicBool=std::sync::atomic::AtomicBool::new(false);
|
||||||
if !WARNED.swap(true,std::sync::atomic::Ordering::Relaxed) {
|
if !WARNED.swap(true,std::sync::atomic::Ordering::Relaxed) {
|
||||||
log::warn!("Mobile text input unavailable on the Wayland backend (no spare keycode in this keymap)");
|
log::warn!("Mobile text input unavailable on the Wayland backend (native and clipboard fallback failed)");
|
||||||
|
}
|
||||||
|
} else if self.backend==crate::desktop_backend::DesktopBackend::Portal {
|
||||||
|
if std::env::var("UU_WAYLAND_TEXT").is_ok_and(|v|v=="0") { return; }
|
||||||
|
if self.paste_text_via_clipboard(text) {
|
||||||
|
log::info!("Desktop text input (Portal clipboard paste): chars={} result=ok", text.chars().count());
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
static WARNED:std::sync::atomic::AtomicBool=std::sync::atomic::AtomicBool::new(false);
|
||||||
|
if !WARNED.swap(true,std::sync::atomic::Ordering::Relaxed) {
|
||||||
|
log::warn!("Portal clipboard text paste failed: ensure clipboard permission or wl-copy is available");
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
static WARNED:std::sync::atomic::AtomicBool=std::sync::atomic::AtomicBool::new(false);
|
static WARNED:std::sync::atomic::AtomicBool=std::sync::atomic::AtomicBool::new(false);
|
||||||
@@ -700,3 +802,59 @@ mod output_pointer_tests {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[cfg(all(test,target_os="linux"))]
|
||||||
|
mod x11_monitor_pointer_tests {
|
||||||
|
use super::*;
|
||||||
|
#[test]
|
||||||
|
#[ignore="requires an X11 display with two or more RandR monitors and UU_X11_MULTISCREEN=1; moves pointer only"]
|
||||||
|
fn absolute_pointer_lands_on_the_selected_x11_monitor() {
|
||||||
|
let _capture=crate::capture::ScreenCapture::new().unwrap();
|
||||||
|
let input=InputInjector::new();
|
||||||
|
assert_eq!(input.backend,crate::desktop_backend::DesktopBackend::X11);
|
||||||
|
let outputs=crate::wayland::outputs();assert!(crate::wayland::x11_multiscreen() && outputs.len()>=2,"needs two X11 monitors");
|
||||||
|
for (id,output) in outputs.iter().enumerate().chain(outputs.iter().enumerate().rev()) {
|
||||||
|
crate::wayland::select(id).unwrap();
|
||||||
|
for (x,y) in [(0.0,0.0),(0.5,0.5),(0.999,0.999),(0.1,0.9)] {
|
||||||
|
let size=(output.width,output.height);
|
||||||
|
let pixels=crate::input_mapping::normalized_pointer(x,y,size.0,size.1).unwrap();
|
||||||
|
input.mouse_absolute_normalized(x,y,size);input.flush_pointer();
|
||||||
|
let (mut ax,mut ay,mut mask)=(0,0,0);
|
||||||
|
assert_eq!(unsafe {x11_pointer_state(&mut ax,&mut ay,&mut mask)},0);
|
||||||
|
assert_eq!((ax,ay),(output.x+pixels.0,output.y+pixels.1),"monitor={} normalized=({x},{y})",output.name);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
crate::wayland::select(0).unwrap();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod clipboard_paste_text_tests {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn rejects_empty_and_oversized_text() {
|
||||||
|
let input = InputInjector::new();
|
||||||
|
assert!(!input.set_clipboard_text(""));
|
||||||
|
let oversized = "a".repeat(crate::clipboard::MAX_TEXT + 1);
|
||||||
|
assert!(!input.set_clipboard_text(&oversized));
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn text_input_handles_portal_backend_safely_without_side_effects() {
|
||||||
|
let mut input = InputInjector::new();
|
||||||
|
input.backend = crate::desktop_backend::DesktopBackend::Portal;
|
||||||
|
// In unit tests, set_clipboard_text avoids external commands so this
|
||||||
|
// will not mutate the host's actual clipboard.
|
||||||
|
input.text_input("测试输入法文字");
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn text_input_respects_disable_env() {
|
||||||
|
let mut input = InputInjector::new();
|
||||||
|
input.backend = crate::desktop_backend::DesktopBackend::Portal;
|
||||||
|
std::env::set_var("UU_WAYLAND_TEXT", "0");
|
||||||
|
input.text_input("测试输入法文字");
|
||||||
|
std::env::remove_var("UU_WAYLAND_TEXT");
|
||||||
|
}
|
||||||
|
}
|
||||||
+108
-19
@@ -8,7 +8,7 @@
|
|||||||
//! (analysis/tools-fix-20261013/viewer-fieldmd.json). Results are written to the private
|
//! (analysis/tools-fix-20261013/viewer-fieldmd.json). Results are written to the private
|
||||||
//! config file (chmod 600). Tokens and tickets are never printed or logged.
|
//! config file (chmod 600). Tokens and tickets are never printed or logged.
|
||||||
|
|
||||||
use crate::auth::{Credentials, UUAuthClient};
|
use crate::auth::{Credentials, QrRequestErrorKind, UUAuthClient};
|
||||||
use crate::login_ui::{LoginUi, Tone};
|
use crate::login_ui::{LoginUi, Tone};
|
||||||
use serde_json::{json, Value};
|
use serde_json::{json, Value};
|
||||||
use std::time::Duration;
|
use std::time::Duration;
|
||||||
@@ -127,6 +127,35 @@ fn render_qr(content: &str) -> Result<String, String> {
|
|||||||
/// API code for an expired login QR code.
|
/// API code for an expired login QR code.
|
||||||
const QR_EXPIRED: i64 = 1190;
|
const QR_EXPIRED: i64 = 1190;
|
||||||
|
|
||||||
|
/// QR API errors must not echo server messages/validation fields: they may contain credentials.
|
||||||
|
fn qr_data<'a>(stage: &str, status: u16, body: &'a Value) -> Result<&'a Value, String> {
|
||||||
|
let code = body.get("code").and_then(Value::as_i64);
|
||||||
|
if status == 200 && code == Some(0) { return Ok(body.get("data").unwrap_or(&Value::Null)); }
|
||||||
|
Err(format!("{stage}: http_status={status} api_code={code:?}"))
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Debug, PartialEq, Eq)]
|
||||||
|
enum QrPollAction { Wait(i64), Scanned, Confirmed, Refresh(Duration), Failed(&'static str) }
|
||||||
|
|
||||||
|
/// Preserve the official refresh policy; a failed query says nothing about QR expiry.
|
||||||
|
fn qr_poll_action(last_status: i64, http_status: u16, body: &Value) -> QrPollAction {
|
||||||
|
if body.get("code").and_then(Value::as_i64) == Some(QR_EXPIRED) {
|
||||||
|
return QrPollAction::Failed("二维码已失效");
|
||||||
|
}
|
||||||
|
let Ok(data) = qr_data("qrcode status", http_status, body) else {
|
||||||
|
return QrPollAction::Failed("二维码状态查询失败");
|
||||||
|
};
|
||||||
|
match data.get("status").and_then(Value::as_i64) {
|
||||||
|
Some(1) => QrPollAction::Wait(1),
|
||||||
|
Some(2) if last_status != 2 => QrPollAction::Scanned,
|
||||||
|
Some(2) => QrPollAction::Wait(2),
|
||||||
|
Some(0) => QrPollAction::Refresh(Duration::from_millis(350)),
|
||||||
|
Some(3) => QrPollAction::Refresh(Duration::ZERO),
|
||||||
|
Some(4) => QrPollAction::Confirmed,
|
||||||
|
_ => QrPollAction::Failed("二维码状态响应异常"),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/// QR modules as RGBA pixels: `scale` pixels per module, `quiet` light modules around the code.
|
/// QR modules as RGBA pixels: `scale` pixels per module, `quiet` light modules around the code.
|
||||||
fn qr_rgba(content: &str, scale: usize, quiet: usize) -> Result<(Vec<u8>, usize), String> {
|
fn qr_rgba(content: &str, scale: usize, quiet: usize) -> Result<(Vec<u8>, usize), String> {
|
||||||
let code = qrcode::QrCode::new(content.as_bytes()).map_err(|e| format!("QR encode failed: {e}"))?;
|
let code = qrcode::QrCode::new(content.as_bytes()).map_err(|e| format!("QR encode failed: {e}"))?;
|
||||||
@@ -276,8 +305,16 @@ pub(crate) async fn flow(ui: &LoginUi) -> Result<String, String> {
|
|||||||
// every QR within seconds (#68).
|
// every QR within seconds (#68).
|
||||||
let timeout = Duration::from_secs(60);
|
let timeout = Duration::from_secs(60);
|
||||||
loop {
|
loop {
|
||||||
let (status, resp) = client.post_with_timeout("/api/v1/qrcode/gen/login", None, timeout).await?;
|
let (status, resp) = match client.post_with_timeout("/api/v1/qrcode/gen/login", None, timeout).await {
|
||||||
let d = match data("qrcode gen", status, &resp) {
|
Ok(r) => r,
|
||||||
|
Err(e) if e.response_received() => {
|
||||||
|
eprintln!("QR generation response failed: {e}");
|
||||||
|
wait_for_refresh(ui, "二维码加载失败").await;
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
Err(e) => return Err(format!("QR generation failed: {e}")),
|
||||||
|
};
|
||||||
|
let d = match qr_data("qrcode gen", status, &resp) {
|
||||||
Ok(d) => d.clone(),
|
Ok(d) => d.clone(),
|
||||||
Err(e) => { println!("QR code could not be loaded ({e})"); wait_for_refresh(ui, "二维码加载失败").await; continue; }
|
Err(e) => { println!("QR code could not be loaded ({e})"); wait_for_refresh(ui, "二维码加载失败").await; continue; }
|
||||||
};
|
};
|
||||||
@@ -303,24 +340,42 @@ pub(crate) async fn flow(ui: &LoginUi) -> Result<String, String> {
|
|||||||
let query = json!({"token": ticket, "qrcode_jump_url": url, "login_status": login_status});
|
let query = json!({"token": ticket, "qrcode_jump_url": url, "login_status": login_status});
|
||||||
let (status, resp) = match client.post_with_timeout("/api/v1/qrcode/login/status", Some(&query), timeout).await {
|
let (status, resp) = match client.post_with_timeout("/api/v1/qrcode/login/status", Some(&query), timeout).await {
|
||||||
Ok(r) => r,
|
Ok(r) => r,
|
||||||
Err(_) => break "网络超时,二维码已停止刷新",
|
Err(e) => {
|
||||||
|
eprintln!("QR status query failed: {e}; last_status={login_status}");
|
||||||
|
break match e.kind {
|
||||||
|
QrRequestErrorKind::Timeout => "二维码状态查询超时(不代表二维码已失效)",
|
||||||
|
_ => "二维码状态查询失败(不代表二维码已失效)",
|
||||||
|
};
|
||||||
|
}
|
||||||
};
|
};
|
||||||
let code = resp.get("code").and_then(|c| c.as_i64());
|
match qr_poll_action(login_status, status, &resp) {
|
||||||
if code == Some(QR_EXPIRED) { break "二维码已失效"; }
|
QrPollAction::Wait(st) => {
|
||||||
let Ok(d) = data("qrcode status", status, &resp) else { break "二维码状态查询失败"; };
|
if st == 1 && login_status != 1 { ui.status("等待扫码…", Tone::Info); }
|
||||||
let st = d.get("status").and_then(|v| v.as_i64()).unwrap_or(login_status);
|
login_status = st;
|
||||||
match st {
|
}
|
||||||
1 => {}
|
QrPollAction::Scanned => {
|
||||||
2 => if login_status != 2 {
|
login_status = 2;
|
||||||
println!("已扫码,请在手机上确认 (scanned, confirm on the phone)");
|
println!("已扫码,请在手机上确认 (scanned, confirm on the phone)");
|
||||||
ui.status("已扫码,请在手机上确认登录", Tone::Ok);
|
ui.status("已扫码,请在手机上确认登录", Tone::Ok);
|
||||||
},
|
}
|
||||||
3 => { println!("QR code expired; generating a new one"); break ""; }
|
QrPollAction::Refresh(delay) => {
|
||||||
0 => { tokio::time::sleep(Duration::from_millis(350)).await; break ""; }
|
if delay.is_zero() { println!("QR code expired; generating a new one"); }
|
||||||
4 => {
|
else { tokio::time::sleep(delay).await; }
|
||||||
|
break "";
|
||||||
|
}
|
||||||
|
QrPollAction::Confirmed => {
|
||||||
|
println!("已确认,正在完成登录 (confirmed, completing login)");
|
||||||
|
ui.status("已确认,正在完成登录…", Tone::Info);
|
||||||
let body = json!({"token": ticket, "qrcode_jump_url": url});
|
let body = json!({"token": ticket, "qrcode_jump_url": url});
|
||||||
let (status, resp) = client.post_with_timeout("/api/v1/login/by_qrcode", Some(&body), timeout).await?;
|
let (status, resp) = match client.post_with_timeout("/api/v1/login/by_qrcode", Some(&body), timeout).await {
|
||||||
let d = match data("qrcode login", status, &resp) {
|
Ok(r) => r,
|
||||||
|
Err(e) if e.response_received() => {
|
||||||
|
eprintln!("QR login exchange response failed: {e}");
|
||||||
|
break "登录失败";
|
||||||
|
}
|
||||||
|
Err(e) => return Err(format!("QR login exchange failed: {e}")),
|
||||||
|
};
|
||||||
|
let d = match qr_data("qrcode login", status, &resp) {
|
||||||
Ok(d) => d,
|
Ok(d) => d,
|
||||||
Err(e) => { println!("QR login not granted ({e})"); break "登录失败"; }
|
Err(e) => { println!("QR login not granted ({e})"); break "登录失败"; }
|
||||||
};
|
};
|
||||||
@@ -339,9 +394,12 @@ pub(crate) async fn flow(ui: &LoginUi) -> Result<String, String> {
|
|||||||
println!("Logged in as {} ({}); saved to {}", nickname, user, path.display());
|
println!("Logged in as {} ({}); saved to {}", nickname, user, path.display());
|
||||||
return Ok(if nickname.is_empty() { user.to_string() } else { nickname.to_string() });
|
return Ok(if nickname.is_empty() { user.to_string() } else { nickname.to_string() });
|
||||||
}
|
}
|
||||||
other => { println!("QR status: {other}"); break "二维码已失效"; }
|
QrPollAction::Failed(reason) => {
|
||||||
|
eprintln!("QR status query stopped: http_status={status} api_code={:?} status={:?} last_status={login_status}",
|
||||||
|
resp.get("code").and_then(Value::as_i64), resp.get("data").and_then(|d| d.get("status")).and_then(Value::as_i64));
|
||||||
|
break reason;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
login_status = st;
|
|
||||||
};
|
};
|
||||||
if !failure.is_empty() { wait_for_refresh(ui, failure).await; }
|
if !failure.is_empty() { wait_for_refresh(ui, failure).await; }
|
||||||
}
|
}
|
||||||
@@ -376,6 +434,37 @@ async fn wait_for_refresh(ui: &LoginUi, reason: &str) {
|
|||||||
#[cfg(test)]
|
#[cfg(test)]
|
||||||
mod tests {
|
mod tests {
|
||||||
use super::*;
|
use super::*;
|
||||||
|
#[test]
|
||||||
|
fn qr_poll_keeps_waiting_scanned_and_confirmed_distinct() {
|
||||||
|
let reply = |status| json!({"code": 0, "data": {"status": status}});
|
||||||
|
assert_eq!(qr_poll_action(1, 200, &reply(1)), QrPollAction::Wait(1));
|
||||||
|
assert_eq!(qr_poll_action(1, 200, &reply(2)), QrPollAction::Scanned);
|
||||||
|
assert_eq!(qr_poll_action(2, 200, &reply(2)), QrPollAction::Wait(2));
|
||||||
|
assert_eq!(qr_poll_action(2, 200, &reply(4)), QrPollAction::Confirmed);
|
||||||
|
assert_eq!(qr_poll_action(1, 200, &reply(0)), QrPollAction::Refresh(Duration::from_millis(350)));
|
||||||
|
assert_eq!(qr_poll_action(2, 200, &reply(3)), QrPollAction::Refresh(Duration::ZERO));
|
||||||
|
assert_eq!(qr_poll_action(2, 400, &json!({"code": 1190})), QrPollAction::Failed("二维码已失效"));
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn qr_poll_failures_do_not_imply_expiry_or_confirmation() {
|
||||||
|
for last in [1, 2] {
|
||||||
|
for body in [json!(null), json!({"code": 1}), json!({"code": 0, "data": {"status": 4}})] {
|
||||||
|
assert_eq!(qr_poll_action(last, 503, &body), QrPollAction::Failed("二维码状态查询失败"));
|
||||||
|
}
|
||||||
|
assert_eq!(qr_poll_action(last, 200, &json!({"code": 1})), QrPollAction::Failed("二维码状态查询失败"));
|
||||||
|
for data in [json!(null), json!({}), json!({"status": "4"}), json!({"status": 99}), json!({"status": -1})] {
|
||||||
|
assert_eq!(qr_poll_action(last, 200, &json!({"code": 0, "data": data})), QrPollAction::Failed("二维码状态响应异常"));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn qr_api_errors_do_not_echo_server_content() {
|
||||||
|
let body = json!({"code": 1001, "msg": "fixture-token", "data": [{"loc": "fixture-ticket"}]});
|
||||||
|
assert_eq!(qr_data("qrcode gen", 400, &body).unwrap_err(), "qrcode gen: http_status=400 api_code=Some(1001)");
|
||||||
|
}
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn status_ticket_prefers_status_query_ticket() {
|
fn status_ticket_prefers_status_query_ticket() {
|
||||||
assert_eq!(qr_ticket(&json!({"token": "old", "status_query_ticket": "new"})), Some("new"));
|
assert_eq!(qr_ticket(&json!({"token": "old", "status_query_ticket": "new"})), Some("new"));
|
||||||
|
|||||||
+176
-17
@@ -1,6 +1,7 @@
|
|||||||
//! UU Remote Pure Native Linux Server (Rust Edition)
|
//! UU Remote Pure Native Linux Server (Rust Edition)
|
||||||
//! Zero-Wine, Zero-Python, Single-Binary, 5 Native Tools Integrated
|
//! Zero-Wine, Zero-Python, Single-Binary, 5 Native Tools Integrated
|
||||||
|
|
||||||
|
mod ws_transport;
|
||||||
mod engine_plugin;
|
mod engine_plugin;
|
||||||
mod doctor;
|
mod doctor;
|
||||||
mod wol;
|
mod wol;
|
||||||
@@ -73,6 +74,14 @@ fn superseded_peer_ids(sessions: &HashMap<String, WebRtcSession>, ice: &str, des
|
|||||||
sessions.iter().filter(|(id, peer)| id.as_str() == ice || (desktop && peer.desktop))
|
sessions.iter().filter(|(id, peer)| id.as_str() == ice || (desktop && peer.desktop))
|
||||||
.map(|(id, _)| id.clone()).collect()
|
.map(|(id, _)| id.clone()).collect()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// A peer whose transport is already broken can leave `PeerConnection::close`
|
||||||
|
/// waiting indefinitely; signaling must keep flowing without it.
|
||||||
|
async fn close_peer(pc: &::webrtc::peer_connection::RTCPeerConnection) {
|
||||||
|
if tokio::time::timeout(std::time::Duration::from_secs(5), pc.close()).await.is_err() {
|
||||||
|
log::warn!("Peer connection close timed out; continuing");
|
||||||
|
}
|
||||||
|
}
|
||||||
fn released_peer_ids<T>(sessions: &HashMap<String, T>, ice: Option<&serde_json::Value>) -> Vec<String> {
|
fn released_peer_ids<T>(sessions: &HashMap<String, T>, ice: Option<&serde_json::Value>) -> Vec<String> {
|
||||||
let ice = ice.map(|id| id.as_str().map(str::to_owned).unwrap_or_else(|| id.to_string()));
|
let ice = ice.map(|id| id.as_str().map(str::to_owned).unwrap_or_else(|| id.to_string()));
|
||||||
sessions.keys().filter(|id| ice.as_deref().map_or(true, |ice| id.as_str() == ice)).cloned().collect()
|
sessions.keys().filter(|id| ice.as_deref().map_or(true, |ice| id.as_str() == ice)).cloned().collect()
|
||||||
@@ -144,10 +153,46 @@ fn set_video_pref() -> Result<(), Box<dyn std::error::Error>> {
|
|||||||
let selection = video_select::selection();
|
let selection = video_select::selection();
|
||||||
let codec = match selection.codec_pref { video_select::CodecPref::Auto => "auto", video_select::CodecPref::H264 => "h264", video_select::CodecPref::H265 => "h265" };
|
let codec = match selection.codec_pref { video_select::CodecPref::Auto => "auto", video_select::CodecPref::H264 => "h264", video_select::CodecPref::H265 => "h265" };
|
||||||
println!("encoder={:?} source={} codec_pref={codec} source={}", selection.encoder, video_select::encoder_source_label(selection.encoder_source), video_select::source_label(selection.codec_source));
|
println!("encoder={:?} source={} codec_pref={codec} source={}", selection.encoder, video_select::encoder_source_label(selection.encoder_source), video_select::source_label(selection.codec_source));
|
||||||
println!("takes effect the next time a desktop connection starts");
|
// Both subcommands wake the host. Encoder changes restart live desktop streams; codec changes are logged only.
|
||||||
|
match notify_host(libc::SIGUSR2) {
|
||||||
|
Ok(()) => println!("notified the running host"),
|
||||||
|
Err(_) => println!(
|
||||||
|
"host not running, or the running host is not this binary: takes effect the next time a desktop connection starts, or after restarting the service"
|
||||||
|
),
|
||||||
|
}
|
||||||
|
if which == "set-codec" {
|
||||||
|
println!("takes effect the next time a desktop connection starts");
|
||||||
|
}
|
||||||
Ok(())
|
Ok(())
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Signal the host recorded in host.pid only when `/proc/<pid>/exe` is exactly
|
||||||
|
/// `canonicalize(current_exe())`. A filename match is not enough: an older host
|
||||||
|
/// has no SIGUSR2 handler, and the default action terminates the process.
|
||||||
|
/// A replaced binary reads back as `… (deleted)` and does not match.
|
||||||
|
fn notify_host(signal: i32) -> Result<(), ()> {
|
||||||
|
let pid = std::fs::read_to_string(host_pid_path())
|
||||||
|
.ok()
|
||||||
|
.and_then(|s| s.trim().parse::<i32>().ok())
|
||||||
|
.filter(|p| *p > 1)
|
||||||
|
.ok_or(())?;
|
||||||
|
let exe = std::fs::read_link(format!("/proc/{pid}/exe")).map_err(|_| ())?;
|
||||||
|
let own = std::fs::canonicalize(std::env::current_exe().map_err(|_| ())?).map_err(|_| ())?;
|
||||||
|
if !same_host_binary(&exe, &own) {
|
||||||
|
return Err(());
|
||||||
|
}
|
||||||
|
if unsafe { libc::kill(pid, signal) } == 0 {
|
||||||
|
Ok(())
|
||||||
|
} else {
|
||||||
|
Err(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// `/proc/<pid>/exe` must equal the canonical path of this binary. A trailing ` (deleted)` does not match.
|
||||||
|
fn same_host_binary(proc_exe: &std::path::Path, own: &std::path::Path) -> bool {
|
||||||
|
proc_exe == own
|
||||||
|
}
|
||||||
|
|
||||||
/// Explicit command words for set-encoder / set-codec. Empty and whitespace are illegal.
|
/// Explicit command words for set-encoder / set-codec. Empty and whitespace are illegal.
|
||||||
pub(crate) fn cli_pref_ok(which: &str, value: &str) -> bool {
|
pub(crate) fn cli_pref_ok(which: &str, value: &str) -> bool {
|
||||||
let value = value.trim();
|
let value = value.trim();
|
||||||
@@ -196,13 +241,75 @@ mod cli_exit_tests {
|
|||||||
assert_eq!(super::reject_cli(Some("set-encoder"), 3, super::cli_pref_ok("set-encoder", "")), Some(2));
|
assert_eq!(super::reject_cli(Some("set-encoder"), 3, super::cli_pref_ok("set-encoder", "")), Some(2));
|
||||||
assert_eq!(super::reject_cli(Some("set-codec"), 3, super::cli_pref_ok("set-codec", " ")), Some(2));
|
assert_eq!(super::reject_cli(Some("set-codec"), 3, super::cli_pref_ok("set-codec", " ")), Some(2));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// SIGUSR1 and SIGUSR2 are installed with no assist UI. `host.pid` is written only after both exist.
|
||||||
|
#[test]
|
||||||
|
fn signal_handlers_install_without_assist() {
|
||||||
|
let rt = tokio::runtime::Builder::new_current_thread().enable_all().build().unwrap();
|
||||||
|
rt.block_on(async {
|
||||||
|
let _guard = crate::config::test_env_lock().lock().unwrap();
|
||||||
|
let dir =
|
||||||
|
std::env::temp_dir().join(format!("uuremote-signal-test-{}", std::process::id()));
|
||||||
|
let _ = std::fs::remove_dir_all(&dir);
|
||||||
|
std::env::set_var("UU_CONFIG", dir.join("config.json"));
|
||||||
|
assert!(super::install_host_signals(None));
|
||||||
|
let pid = std::fs::read_to_string(super::host_pid_path()).unwrap();
|
||||||
|
assert_eq!(pid.trim(), std::process::id().to_string());
|
||||||
|
std::env::remove_var("UU_CONFIG");
|
||||||
|
let _ = std::fs::remove_dir_all(&dir);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn sigusr2_requires_the_same_canonical_binary() {
|
||||||
|
let own = std::path::Path::new("/home/user/.local/bin/uuremote-server");
|
||||||
|
assert!(super::same_host_binary(own, own));
|
||||||
|
assert!(!super::same_host_binary(
|
||||||
|
std::path::Path::new("/tmp/unpack/uuremote-server"),
|
||||||
|
own
|
||||||
|
));
|
||||||
|
assert!(!super::same_host_binary(
|
||||||
|
std::path::Path::new("/home/user/.local/bin/uuremote-server (deleted)"),
|
||||||
|
own
|
||||||
|
));
|
||||||
|
}
|
||||||
}
|
}
|
||||||
/// SIGUSR1 (`uuremote-server show`) opens the host window.
|
/// SIGUSR1 (`uuremote-server show`) opens the host window.
|
||||||
fn present_on_usr1(ui: std::sync::Arc<assist::LocalUi>) {
|
/// SIGUSR2 (set-encoder, set-codec, or `kill -USR2`) re-reads host_settings. Encoder changes switch live desktop streams; codec changes are logged for the next connection.
|
||||||
// Install the handler before publishing the pid: SIGUSR1's default action terminates the process.
|
/// The default action of either signal terminates the process, so both handlers are installed before `host.pid` is written.
|
||||||
let Ok(mut usr1) = tokio::signal::unix::signal(tokio::signal::unix::SignalKind::user_defined1()) else { return };
|
/// SIGUSR2 is independent of remote assistance: `UU_REMOTE_ASSIST=0` and a failed assist setup still switch live encoders.
|
||||||
|
/// SIGUSR1 is installed first as a no-op so `show` cannot terminate a host that has no assist window yet.
|
||||||
|
fn install_host_signals(ui: Option<std::sync::Arc<assist::LocalUi>>) -> bool {
|
||||||
|
static USR1: std::sync::Once = std::sync::Once::new();
|
||||||
|
static USR2: std::sync::Once = std::sync::Once::new();
|
||||||
|
let mut usr1_ok = true;
|
||||||
|
USR1.call_once(|| {
|
||||||
|
match tokio::signal::unix::signal(tokio::signal::unix::SignalKind::user_defined1()) {
|
||||||
|
Ok(mut usr1) => { tokio::spawn(async move { while usr1.recv().await.is_some() {} }); }
|
||||||
|
Err(_) => usr1_ok = false,
|
||||||
|
}
|
||||||
|
});
|
||||||
|
if !usr1_ok { return false; }
|
||||||
|
let mut usr2_ok = true;
|
||||||
|
USR2.call_once(|| {
|
||||||
|
match tokio::signal::unix::signal(tokio::signal::unix::SignalKind::user_defined2()) {
|
||||||
|
Ok(mut usr2) => { tokio::spawn(async move { while usr2.recv().await.is_some() { crate::video_select::publish_reload(); } }); }
|
||||||
|
Err(_) => usr2_ok = false,
|
||||||
|
}
|
||||||
|
});
|
||||||
|
if !usr2_ok { return false; }
|
||||||
|
// Assist attaches later and replaces the no-op with the window. A second registration replaces the first.
|
||||||
|
if let Some(ui) = ui {
|
||||||
|
if let Ok(mut usr1) = tokio::signal::unix::signal(tokio::signal::unix::SignalKind::user_defined1()) {
|
||||||
|
tokio::spawn(async move { while usr1.recv().await.is_some() { ui.present(); } });
|
||||||
|
}
|
||||||
|
}
|
||||||
write_host_pid();
|
write_host_pid();
|
||||||
tokio::spawn(async move { while usr1.recv().await.is_some() { ui.present(); } });
|
true
|
||||||
|
}
|
||||||
|
|
||||||
|
fn present_on_usr1(ui: std::sync::Arc<assist::LocalUi>) {
|
||||||
|
let _ = install_host_signals(Some(ui));
|
||||||
}
|
}
|
||||||
|
|
||||||
fn host_pid_path() -> std::path::PathBuf { config::path().with_file_name("host.pid") }
|
fn host_pid_path() -> std::path::PathBuf { config::path().with_file_name("host.pid") }
|
||||||
@@ -210,7 +317,9 @@ fn host_pid_path() -> std::path::PathBuf { config::path().with_file_name("host.p
|
|||||||
fn write_host_pid() {
|
fn write_host_pid() {
|
||||||
use std::os::unix::fs::OpenOptionsExt;
|
use std::os::unix::fs::OpenOptionsExt;
|
||||||
use std::io::Write;
|
use std::io::Write;
|
||||||
if let Ok(mut f) = std::fs::OpenOptions::new().write(true).create(true).truncate(true).mode(0o600).open(host_pid_path()) {
|
let path = host_pid_path();
|
||||||
|
if let Some(dir) = path.parent() { let _ = std::fs::create_dir_all(dir); }
|
||||||
|
if let Ok(mut f) = std::fs::OpenOptions::new().write(true).create(true).truncate(true).mode(0o600).open(path) {
|
||||||
let _ = write!(f, "{}", std::process::id());
|
let _ = write!(f, "{}", std::process::id());
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -521,6 +630,9 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
|
|||||||
virtual_audio::init();
|
virtual_audio::init();
|
||||||
let _audio_cleanup=virtual_audio::Cleanup;
|
let _audio_cleanup=virtual_audio::Cleanup;
|
||||||
log::info!("Starting uu-remote-linux host v{}...", env!("CARGO_PKG_VERSION"));
|
log::info!("Starting uu-remote-linux host v{}...", env!("CARGO_PKG_VERSION"));
|
||||||
|
session_ice::configure_relay_transport();
|
||||||
|
// Before host.pid, and before assist: a missing or failed assist session must still handle SIGUSR2.
|
||||||
|
let _ = install_host_signals(None);
|
||||||
video::warm_auto_probe();
|
video::warm_auto_probe();
|
||||||
video::check_ffmpeg_usable();
|
video::check_ffmpeg_usable();
|
||||||
|
|
||||||
@@ -583,7 +695,7 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
|
|||||||
if let Some(task) = command_task { task.abort(); }
|
if let Some(task) = command_task { task.abort(); }
|
||||||
// One exit path for commands, signals, transport failures and UI failures.
|
// One exit path for commands, signals, transport failures and UI failures.
|
||||||
if let Some(session) = assist.as_mut() { session.allowed = false; }
|
if let Some(session) = assist.as_mut() { session.allowed = false; }
|
||||||
for (_, old) in webrtc_sessions.lock().await.drain() { let _ = old.pc.close().await; }
|
for (_, old) in webrtc_sessions.lock().await.drain() { close_peer(&old.pc).await; }
|
||||||
virtual_audio::disable(); input.shutdown(); terminal::shutdown_all();
|
virtual_audio::disable(); input.shutdown(); terminal::shutdown_all();
|
||||||
// Switching identity (signed in / out) restarts at once and the new identity republishes the same
|
// Switching identity (signed in / out) restarts at once and the new identity republishes the same
|
||||||
// device share: logout already withdrew it, and after a QR login the cloud moved it to the account
|
// device share: logout already withdrew it, and after a QR login the cloud moved it to the account
|
||||||
@@ -635,6 +747,8 @@ async fn serve(mut capture: Arc<ScreenCapture>, input: Arc<InputInjector>, shutd
|
|||||||
let mut capture_types: HashMap<String, (u64,crate::session_ice::SessionIce)> = HashMap::new();
|
let mut capture_types: HashMap<String, (u64,crate::session_ice::SessionIce)> = HashMap::new();
|
||||||
let mut mac_by_ice: HashMap<String, bool> = HashMap::new();
|
let mut mac_by_ice: HashMap<String, bool> = HashMap::new();
|
||||||
let mut next_mac = false;
|
let mut next_mac = false;
|
||||||
|
// Tool peers ask here to become the desktop (capture_desktop on an existing connection, #99).
|
||||||
|
let (desktop_requests, mut desktop_requested) = mpsc::unbounded_channel::<String>();
|
||||||
|
|
||||||
loop {
|
loop {
|
||||||
if *shutdown.borrow() {
|
if *shutdown.borrow() {
|
||||||
@@ -719,6 +833,7 @@ async fn serve(mut capture: Arc<ScreenCapture>, input: Arc<InputInjector>, shutd
|
|||||||
_ = shutdown.changed() => Some(SignalingEvent::Stop),
|
_ = shutdown.changed() => Some(SignalingEvent::Stop),
|
||||||
command = commands.recv(), if assist.is_some() => Some(SignalingEvent::AssistCommand(command.unwrap_or(assist::Command::Stop))),
|
command = commands.recv(), if assist.is_some() => Some(SignalingEvent::AssistCommand(command.unwrap_or(assist::Command::Stop))),
|
||||||
_ = assist_tick.tick(), if assist.is_some() => Some(SignalingEvent::AssistTick),
|
_ = assist_tick.tick(), if assist.is_some() => Some(SignalingEvent::AssistTick),
|
||||||
|
Some(ice) = desktop_requested.recv() => Some(SignalingEvent::DesktopRequested(ice)),
|
||||||
event = rx_event.recv() => event,
|
event = rx_event.recv() => event,
|
||||||
};
|
};
|
||||||
let Some(evt) = event else { break; };
|
let Some(evt) = event else { break; };
|
||||||
@@ -753,8 +868,8 @@ async fn serve(mut capture: Arc<ScreenCapture>, input: Arc<InputInjector>, shutd
|
|||||||
::webrtc::peer_connection::peer_connection_state::RTCPeerConnectionState::Closed |
|
::webrtc::peer_connection::peer_connection_state::RTCPeerConnectionState::Closed |
|
||||||
::webrtc::peer_connection::peer_connection_state::RTCPeerConnectionState::Failed)).map(|(id, _)| id.clone()).collect();
|
::webrtc::peer_connection::peer_connection_state::RTCPeerConnectionState::Failed)).map(|(id, _)| id.clone()).collect();
|
||||||
let mut desktop_ended = false;
|
let mut desktop_ended = false;
|
||||||
for id in ended { if let Some(s) = sessions.remove(&id) { desktop_ended |= s.desktop; let _ = s.pc.close().await; } }
|
for id in ended { if let Some(s) = sessions.remove(&id) { desktop_ended |= s.role.is_desktop(); close_peer(&s.pc).await; } }
|
||||||
if desktop_ended && !sessions.values().any(|s| s.desktop) { if let Some(s) = assist.as_mut() { s.session_ended()?; } }
|
if desktop_ended && !sessions.values().any(|s| s.role.is_desktop()) { if let Some(s) = assist.as_mut() { s.session_ended()?; } }
|
||||||
if let Some(s) = assist.as_mut() { s.tick()?; }
|
if let Some(s) = assist.as_mut() { s.tick()?; }
|
||||||
}
|
}
|
||||||
SignalingEvent::Connected => {
|
SignalingEvent::Connected => {
|
||||||
@@ -841,8 +956,8 @@ async fn serve(mut capture: Arc<ScreenCapture>, input: Arc<InputInjector>, shutd
|
|||||||
::webrtc::peer_connection::peer_connection_state::RTCPeerConnectionState::Closed |
|
::webrtc::peer_connection::peer_connection_state::RTCPeerConnectionState::Closed |
|
||||||
::webrtc::peer_connection::peer_connection_state::RTCPeerConnectionState::Failed)).map(|(k, _)| k.clone()).collect();
|
::webrtc::peer_connection::peer_connection_state::RTCPeerConnectionState::Failed)).map(|(k, _)| k.clone()).collect();
|
||||||
let mut desktop_ended = false;
|
let mut desktop_ended = false;
|
||||||
for k in ended { if let Some(old) = sessions.remove(&k) { desktop_ended |= old.desktop; let _ = old.pc.close().await; } }
|
for k in ended { if let Some(old) = sessions.remove(&k) { desktop_ended |= old.role.is_desktop(); close_peer(&old.pc).await; } }
|
||||||
if desktop_ended && !sessions.values().any(|s| s.desktop) { if let Some(s) = assist.as_mut() { s.session_ended()?; } }
|
if desktop_ended && !sessions.values().any(|s| s.role.is_desktop()) { if let Some(s) = assist.as_mut() { s.session_ended()?; } }
|
||||||
if let Some(s) = assist.as_mut() { s.tick()?; }
|
if let Some(s) = assist.as_mut() { s.tick()?; }
|
||||||
|
|
||||||
if soac.msg_type == "offer" {
|
if soac.msg_type == "offer" {
|
||||||
@@ -856,8 +971,10 @@ async fn serve(mut capture: Arc<ScreenCapture>, input: Arc<InputInjector>, shutd
|
|||||||
if desktop { video::warm_auto_probe(); video::check_ffmpeg_usable(); }
|
if desktop { video::warm_auto_probe(); video::check_ffmpeg_usable(); }
|
||||||
// Replace only this ICE id or a previous desktop, never tool peers.
|
// Replace only this ICE id or a previous desktop, never tool peers.
|
||||||
for id in superseded_peer_ids(&sessions, &ice, desktop) {
|
for id in superseded_peer_ids(&sessions, &ice, desktop) {
|
||||||
if let Some(old) = sessions.remove(&id) { let _ = old.pc.close().await; }
|
if let Some(old) = sessions.remove(&id) { close_peer(&old.pc).await; }
|
||||||
}
|
}
|
||||||
|
// A tool peer promoted by capture_desktop stops its desktop but keeps its tools.
|
||||||
|
if desktop { for old in sessions.values() { old.demote(); } }
|
||||||
if desktop && desktop_backend::headless() {
|
if desktop && desktop_backend::headless() {
|
||||||
log::info!("Desktop connection ignored: headless mode (terminal, file transfer and port mapping remain available)");
|
log::info!("Desktop connection ignored: headless mode (terminal, file transfer and port mapping remain available)");
|
||||||
continue;
|
continue;
|
||||||
@@ -879,7 +996,12 @@ async fn serve(mut capture: Arc<ScreenCapture>, input: Arc<InputInjector>, shutd
|
|||||||
if desktop { if let Some(portal) = &portal_desktop { portal.begin(); } }
|
if desktop { if let Some(portal) = &portal_desktop { portal.begin(); } }
|
||||||
match WebRtcSession::new(session_capture, input.clone(), signaling_client.clone(), desktop, transport,
|
match WebRtcSession::new(session_capture, input.clone(), signaling_client.clone(), desktop, transport,
|
||||||
if desktop { portal_desktop.clone() } else { None }).await {
|
if desktop { portal_desktop.clone() } else { None }).await {
|
||||||
Ok(sess) => {
|
Ok(mut sess) => {
|
||||||
|
sess.controller_mac = controller_mac;
|
||||||
|
if !desktop {
|
||||||
|
let (requests, peer) = (desktop_requests.clone(), ice.clone());
|
||||||
|
sess.on_desktop_request(move || { let _ = requests.send(peer.clone()); });
|
||||||
|
}
|
||||||
// Register before awaiting SDP: shutdown can always close
|
// Register before awaiting SDP: shutdown can always close
|
||||||
// a peer whose answer may already be queued to the viewer.
|
// a peer whose answer may already be queued to the viewer.
|
||||||
sessions.insert(ice.clone(), sess);
|
sessions.insert(ice.clone(), sess);
|
||||||
@@ -902,7 +1024,7 @@ async fn serve(mut capture: Arc<ScreenCapture>, input: Arc<InputInjector>, shutd
|
|||||||
}
|
}
|
||||||
Err(_) => {
|
Err(_) => {
|
||||||
log::error!("Failed to handle offer (details omitted)");
|
log::error!("Failed to handle offer (details omitted)");
|
||||||
if let Some(session) = sessions.remove(&ice) { let _ = session.pc.close().await; }
|
if let Some(session) = sessions.remove(&ice) { close_peer(&session.pc).await; }
|
||||||
}
|
}
|
||||||
}},
|
}},
|
||||||
Err(_) => log::error!("Create peer failed (details omitted)"),
|
Err(_) => log::error!("Create peer failed (details omitted)"),
|
||||||
@@ -924,13 +1046,50 @@ async fn serve(mut capture: Arc<ScreenCapture>, input: Arc<InputInjector>, shutd
|
|||||||
let mut desktop_ended = false;
|
let mut desktop_ended = false;
|
||||||
for k in targets {
|
for k in targets {
|
||||||
if let Some(old) = sessions.remove(&k) {
|
if let Some(old) = sessions.remove(&k) {
|
||||||
desktop_ended |= old.desktop;
|
desktop_ended |= old.role.is_desktop();
|
||||||
if let Err(e) = old.pc.close().await { log::warn!("Close released peer failed: {}", e); }
|
close_peer(&old.pc).await;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
if desktop_ended && !sessions.values().any(|s| s.desktop) { if let Some(s) = assist.as_mut() { s.session_ended()?; } }
|
if desktop_ended && !sessions.values().any(|s| s.role.is_desktop()) { if let Some(s) = assist.as_mut() { s.session_ended()?; } }
|
||||||
if let Some(s) = assist.as_mut() { s.tick()?; }
|
if let Some(s) = assist.as_mut() { s.tick()?; }
|
||||||
}
|
}
|
||||||
|
SignalingEvent::DesktopRequested(ice) => {
|
||||||
|
let mut sessions = webrtc_sessions.lock().await;
|
||||||
|
let Some(peer) = sessions.get(&ice).filter(|peer| !peer.role.is_desktop()) else { continue; };
|
||||||
|
if desktop_backend::headless() {
|
||||||
|
log::info!("Desktop request on a tool connection ignored: headless mode");
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
if portal_desktop.is_some() {
|
||||||
|
log::info!("Desktop request on a tool connection not supported with the Portal backend; open the desktop before port mapping");
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
let controller_mac = peer.controller_mac;
|
||||||
|
let current = peer.desktop_capture();
|
||||||
|
// Same recovery as a desktop offer: the display may have come up or been resized after this peer.
|
||||||
|
let resized = current.init_error.is_none() && current.backend == desktop_backend::DesktopBackend::X11
|
||||||
|
&& tokio::task::spawn_blocking(crate::capture::x11_size).await.ok().flatten().is_some_and(|size| size != (current.width, current.height));
|
||||||
|
if resized { log::info!("Desktop geometry changed since this connection opened; reinitializing capture"); }
|
||||||
|
let screen = if current.init_error.is_some() || resized {
|
||||||
|
match tokio::task::spawn_blocking(ScreenCapture::new).await {
|
||||||
|
Ok(Ok(screen)) => { capture = Arc::new(screen); Some(capture.clone()) },
|
||||||
|
Ok(Err(error)) => { log::info!("Desktop request on a tool connection ignored: {error}"); continue; },
|
||||||
|
Err(_) => { log::warn!("Desktop initialization worker failed"); continue; },
|
||||||
|
}
|
||||||
|
} else { None };
|
||||||
|
video::warm_auto_probe(); video::check_ffmpeg_usable();
|
||||||
|
input.set_mac_controller(controller_mac);
|
||||||
|
input.bind_portal(screen.as_ref().map_or_else(|| sessions[&ice].capture.portal.clone(), |screen| screen.portal.clone()));
|
||||||
|
// One desktop at a time, as for a new desktop offer. Peers offered as desktops
|
||||||
|
// close; a promoted tool peer only stops its desktop and keeps its tools.
|
||||||
|
let superseded: Vec<String> = sessions.iter().filter(|(id, old)| id.as_str() != ice && old.role.is_desktop())
|
||||||
|
.map(|(id, _)| id.clone()).collect();
|
||||||
|
for id in superseded {
|
||||||
|
if sessions[&id].desktop { if let Some(old) = sessions.remove(&id) { close_peer(&old.pc).await; } }
|
||||||
|
else { sessions[&id].demote(); }
|
||||||
|
}
|
||||||
|
if let Some(peer) = sessions.get(&ice) { peer.promote(screen); }
|
||||||
|
}
|
||||||
SignalingEvent::Disconnected => {
|
SignalingEvent::Disconnected => {
|
||||||
capture_types.clear();
|
capture_types.clear();
|
||||||
next_capture_type=None;
|
next_capture_type=None;
|
||||||
|
|||||||
@@ -56,6 +56,31 @@ impl SessionIce {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// With `UU_USE_PROXY=1`, also gather TURN relays over TCP/TLS (through the HTTP proxy when
|
||||||
|
/// one is configured); hosts whose UDP cannot reach the TURN servers then still get a relay.
|
||||||
|
pub fn configure_relay_transport() {
|
||||||
|
if !crate::auth::proxy_enabled() { return; }
|
||||||
|
let value = ["HTTPS_PROXY", "https_proxy", "ALL_PROXY", "all_proxy"].iter().find_map(|name| std::env::var(name).ok()).filter(|v| !v.is_empty());
|
||||||
|
let proxy = match value.as_deref().map(relay_proxy) {
|
||||||
|
Some(Ok(proxy)) => Some(proxy),
|
||||||
|
Some(Err(reason)) => { log::warn!("TURN over TCP/TLS disabled: {reason}"); return; }
|
||||||
|
None => None,
|
||||||
|
};
|
||||||
|
log::info!("TURN over TCP/TLS enabled: via_http_proxy={}", proxy.is_some());
|
||||||
|
webrtc::ice::agent::turn_tcp::set_relay_transport(webrtc::ice::agent::turn_tcp::RelayTransport { http_proxy: proxy });
|
||||||
|
}
|
||||||
|
|
||||||
|
/// `host:port` of an unauthenticated HTTP proxy URL; never echoes the value.
|
||||||
|
fn relay_proxy(value: &str) -> Result<String, &'static str> {
|
||||||
|
let url = reqwest::Url::parse(&if value.contains("://") { value.to_owned() } else { format!("http://{value}") })
|
||||||
|
.map_err(|_| "invalid proxy URL")?;
|
||||||
|
if url.scheme() != "http" { return Err("only http:// proxies are supported for TURN"); }
|
||||||
|
if !url.username().is_empty() || url.password().is_some() { return Err("proxy authentication is not supported for TURN"); }
|
||||||
|
let host = url.host_str().ok_or("invalid proxy URL")?;
|
||||||
|
let port = url.port_or_known_default().ok_or("invalid proxy URL")?;
|
||||||
|
Ok(format!("{host}:{port}")) // host_str() keeps IPv6 brackets
|
||||||
|
}
|
||||||
|
|
||||||
#[cfg(test)]
|
#[cfg(test)]
|
||||||
mod tests {
|
mod tests {
|
||||||
use super::*;
|
use super::*;
|
||||||
@@ -74,4 +99,54 @@ mod tests {
|
|||||||
assert_eq!(config.ice_servers.len(),1);
|
assert_eq!(config.ice_servers.len(),1);
|
||||||
assert!(config.ice_servers[0].urls.iter().all(|s|s.starts_with("stun:")));
|
assert!(config.ice_servers[0].urls.iter().all(|s|s.starts_with("stun:")));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn relay_proxy_accepts_plain_http_only() {
|
||||||
|
assert_eq!(super::relay_proxy("http://proxy.invalid:8889").unwrap(), "proxy.invalid:8889");
|
||||||
|
assert_eq!(super::relay_proxy("proxy.invalid:8889/").unwrap(), "proxy.invalid:8889");
|
||||||
|
assert_eq!(super::relay_proxy("http://[::1]:3128").unwrap(), "[::1]:3128");
|
||||||
|
for bad in ["socks5://proxy.invalid:1080", "https://proxy.invalid:443", "http://user:[email protected]:8889", "::"] {
|
||||||
|
assert!(super::relay_proxy(bad).is_err());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn turn_tcp_frames_stun_and_padded_channel_data() {
|
||||||
|
use webrtc::ice::agent::turn_tcp::frame_len;
|
||||||
|
assert_eq!(frame_len([0x01, 0x01, 0x00, 0x08]), Some(28));
|
||||||
|
assert_eq!(frame_len([0x40, 0x00, 0x00, 0x05]), Some(12));
|
||||||
|
assert_eq!(frame_len([0x40, 0x00, 0x00, 0x08]), Some(12));
|
||||||
|
assert_eq!(frame_len([0x80, 0x00, 0x00, 0x00]), None);
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn turn_tcp_connects_through_the_proxy_and_frames_the_stream() {
|
||||||
|
use tokio::io::{AsyncReadExt, AsyncWriteExt};
|
||||||
|
use webrtc::ice::agent::turn_tcp::{dial, set_relay_transport, RelayTransport};
|
||||||
|
use webrtc::util::Conn;
|
||||||
|
let proxy = tokio::net::TcpListener::bind("127.0.0.1:0").await.unwrap();
|
||||||
|
let proxy_addr = proxy.local_addr().unwrap();
|
||||||
|
let server = tokio::spawn(async move {
|
||||||
|
let (mut socket, _) = proxy.accept().await.unwrap();
|
||||||
|
let mut head = Vec::new();
|
||||||
|
while !head.ends_with(b"\r\n\r\n") { let mut b = [0u8; 1]; socket.read_exact(&mut b).await.unwrap(); head.push(b[0]); }
|
||||||
|
assert!(String::from_utf8_lossy(&head).starts_with("CONNECT 192.0.2.1:2483 HTTP/1.1\r\n"));
|
||||||
|
socket.write_all(b"HTTP/1.1 200 Connection established\r\n\r\n").await.unwrap();
|
||||||
|
let mut frames = [0u8; 20 + 12];
|
||||||
|
socket.read_exact(&mut frames).await.unwrap();
|
||||||
|
socket.write_all(&frames).await.unwrap();
|
||||||
|
});
|
||||||
|
set_relay_transport(RelayTransport { http_proxy: Some(proxy_addr.to_string()) });
|
||||||
|
let target: std::net::SocketAddr = "192.0.2.1:2483".parse().unwrap();
|
||||||
|
let conn = dial("192.0.2.1", 2483, target, false).await.unwrap();
|
||||||
|
let mut stun = [0u8; 20]; stun[1] = 0x01;
|
||||||
|
let channel = [0x40, 0x00, 0x00, 0x05, 1, 2, 3, 4, 5, 0, 0, 0];
|
||||||
|
conn.send_to(&stun, target).await.unwrap();
|
||||||
|
conn.send_to(&channel, target).await.unwrap();
|
||||||
|
let mut buf = [0u8; 64];
|
||||||
|
assert_eq!(conn.recv_from(&mut buf).await.unwrap(), (20, target));
|
||||||
|
assert_eq!(conn.recv_from(&mut buf).await.unwrap(), (12, target));
|
||||||
|
assert_eq!(&buf[..12], &channel);
|
||||||
|
server.await.unwrap();
|
||||||
|
}
|
||||||
}
|
}
|
||||||
+193
-41
@@ -3,12 +3,22 @@
|
|||||||
use futures_util::{SinkExt, StreamExt};
|
use futures_util::{SinkExt, StreamExt};
|
||||||
use serde::{Deserialize, Serialize};
|
use serde::{Deserialize, Serialize};
|
||||||
use serde_json::Value;
|
use serde_json::Value;
|
||||||
|
use std::sync::atomic::{AtomicBool, AtomicU64, Ordering};
|
||||||
use std::sync::Arc;
|
use std::sync::Arc;
|
||||||
|
use std::time::{Duration, Instant};
|
||||||
use tokio::sync::mpsc;
|
use tokio::sync::mpsc;
|
||||||
use tokio_tungstenite::connect_async;
|
|
||||||
use tokio_tungstenite::tungstenite::client::IntoClientRequest;
|
use tokio_tungstenite::tungstenite::client::IntoClientRequest;
|
||||||
use tokio_tungstenite::tungstenite::Message;
|
use tokio_tungstenite::tungstenite::Message;
|
||||||
|
|
||||||
|
/// A peer that stops reading must not park the heartbeat loop on a full queue.
|
||||||
|
/// Kept below the Engine.IO window so the protocol deadline still fires.
|
||||||
|
const SEND_STALL_TIMEOUT: Duration = Duration::from_secs(10);
|
||||||
|
// DNS/TCP/TLS/WebSocket upgrade must finish in bounded time: after a network
|
||||||
|
// change the handshake can stall forever and the reconnect loop never retries.
|
||||||
|
const CONNECT_TIMEOUT: Duration = Duration::from_secs(20);
|
||||||
|
/// How often the watchdog checks the last inbound frame.
|
||||||
|
const WATCHDOG_TICK: Duration = Duration::from_secs(1);
|
||||||
|
|
||||||
#[derive(Debug, Clone, Serialize, Deserialize)]
|
#[derive(Debug, Clone, Serialize, Deserialize)]
|
||||||
pub struct SoacMessage {
|
pub struct SoacMessage {
|
||||||
#[serde(rename = "type")]
|
#[serde(rename = "type")]
|
||||||
@@ -46,6 +56,8 @@ pub enum SignalingEvent {
|
|||||||
Released(Value),
|
Released(Value),
|
||||||
Left(Value),
|
Left(Value),
|
||||||
Disconnected,
|
Disconnected,
|
||||||
|
/// capture_desktop on this tool peer (ice_id); raised by the peer, not by signaling.
|
||||||
|
DesktopRequested(String),
|
||||||
}
|
}
|
||||||
|
|
||||||
pub struct SignalingClient {
|
pub struct SignalingClient {
|
||||||
@@ -68,6 +80,11 @@ fn refreshed_key(ack:&Value)->Option<String> {
|
|||||||
(!key.is_empty() && key.len()<=16384).then(||key.to_owned())
|
(!key.is_empty() && key.len()<=16384).then(||key.to_owned())
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Deliver an event without letting a stalled consumer hide a dead socket.
|
||||||
|
async fn send_event(sender: &mpsc::Sender<SignalingEvent>, event: SignalingEvent) -> bool {
|
||||||
|
matches!(tokio::time::timeout(SEND_STALL_TIMEOUT, sender.send(event)).await, Ok(Ok(())))
|
||||||
|
}
|
||||||
|
|
||||||
#[cfg(test)]
|
#[cfg(test)]
|
||||||
mod refresh_tests {
|
mod refresh_tests {
|
||||||
use super::refreshed_key;
|
use super::refreshed_key;
|
||||||
@@ -126,6 +143,95 @@ mod refresh_tests {
|
|||||||
assert!(disconnected.is_ok(),"a socket without pings must be reported dead");
|
assert!(disconnected.is_ok(),"a socket without pings must be reported dead");
|
||||||
drop(hold_tx);
|
drop(hold_tx);
|
||||||
}
|
}
|
||||||
|
#[tokio::test]
|
||||||
|
async fn blocked_event_consumer_does_not_hide_a_dead_socket() {
|
||||||
|
use futures_util::{SinkExt,StreamExt};
|
||||||
|
use tokio_tungstenite::tungstenite::Message;
|
||||||
|
let listener=tokio::net::TcpListener::bind("127.0.0.1:0").await.unwrap();
|
||||||
|
let address=listener.local_addr().unwrap();
|
||||||
|
let (closed_tx,closed_rx)=tokio::sync::oneshot::channel::<()>();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let (tcp,_)=listener.accept().await.unwrap();
|
||||||
|
let socket=tokio_tungstenite::accept_async(tcp).await.unwrap();
|
||||||
|
let (mut sink,mut stream)=socket.split();
|
||||||
|
// Shortest accepted window (clamped to 5 s); never ping, only events.
|
||||||
|
sink.send(Message::Text(r#"0{"pingInterval":1000,"pingTimeout":1000}"#.into())).await.unwrap();
|
||||||
|
let _=stream.next().await;
|
||||||
|
sink.send(Message::Text("40{}".into())).await.unwrap();
|
||||||
|
loop {
|
||||||
|
tokio::select! {
|
||||||
|
r=stream.next()=>match r {
|
||||||
|
None|Some(Err(_))|Some(Ok(Message::Close(_)))=>{let _=closed_tx.send(());return;}
|
||||||
|
_=>{}
|
||||||
|
},
|
||||||
|
_=tokio::time::sleep(std::time::Duration::from_millis(50))=>{
|
||||||
|
if sink.send(Message::Text(r#"42["bmsg_push",{}]"#.into())).await.is_err() {
|
||||||
|
let _=closed_tx.send(());return;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
// Capacity 1 and no reader: the first event fills the queue, so the
|
||||||
|
// receive loop would park inside `send().await` without the watchdog.
|
||||||
|
let (sender,_events)=tokio::sync::mpsc::channel(1);
|
||||||
|
let _client=super::SignalingClient::connect(&format!("ws://{address}"),"synthetic-only",sender).await.unwrap();
|
||||||
|
let closed=tokio::time::timeout(std::time::Duration::from_secs(15),closed_rx).await;
|
||||||
|
assert!(closed.is_ok(),"a blocked consumer must not keep a dead signaling socket open");
|
||||||
|
}
|
||||||
|
#[tokio::test]
|
||||||
|
async fn stalled_handshake_times_out() {
|
||||||
|
use tokio_tungstenite::tungstenite::client::IntoClientRequest;
|
||||||
|
// Accepts TCP but never answers the upgrade, like a stalled path after a network change.
|
||||||
|
let listener=tokio::net::TcpListener::bind("127.0.0.1:0").await.unwrap();
|
||||||
|
let address=listener.local_addr().unwrap();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let (_tcp,_)=listener.accept().await.unwrap();
|
||||||
|
tokio::time::sleep(std::time::Duration::from_secs(30)).await;
|
||||||
|
});
|
||||||
|
let req=format!("ws://{address}/socket.io/").into_client_request().unwrap();
|
||||||
|
let result=tokio::time::timeout(std::time::Duration::from_secs(5),super::open_socket(req,std::time::Duration::from_secs(1))).await;
|
||||||
|
assert!(matches!(result,Ok(Err(_))),"a stalled handshake must fail within the connect timeout");
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn stalled_event_delivery_still_reports_disconnected() {
|
||||||
|
use futures_util::{SinkExt,StreamExt};
|
||||||
|
use tokio_tungstenite::tungstenite::Message;
|
||||||
|
let listener=tokio::net::TcpListener::bind("127.0.0.1:0").await.unwrap();
|
||||||
|
let address=listener.local_addr().unwrap();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let (tcp,_)=listener.accept().await.unwrap();
|
||||||
|
let socket=tokio_tungstenite::accept_async(tcp).await.unwrap();
|
||||||
|
let (mut sink,mut stream)=socket.split();
|
||||||
|
// A long window: the send stall must fire before the heartbeat deadline.
|
||||||
|
sink.send(Message::Text(r#"0{"pingInterval":30000,"pingTimeout":30000}"#.into())).await.unwrap();
|
||||||
|
let _=stream.next().await;
|
||||||
|
sink.send(Message::Text("40{}".into())).await.unwrap();
|
||||||
|
loop {
|
||||||
|
tokio::select! {
|
||||||
|
r=stream.next()=>{ if matches!(r,None|Some(Err(_))|Some(Ok(Message::Close(_)))){return} }
|
||||||
|
_=tokio::time::sleep(std::time::Duration::from_millis(50))=>{
|
||||||
|
if sink.send(Message::Text(r#"42["bmsg_push",{}]"#.into())).await.is_err(){return}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
let (sender,mut events)=tokio::sync::mpsc::channel(1);
|
||||||
|
let _client=super::SignalingClient::connect(&format!("ws://{address}"),"synthetic-only",sender).await.unwrap();
|
||||||
|
// Let SEND_STALL_TIMEOUT expire while nothing drains the queue.
|
||||||
|
tokio::time::sleep(std::time::Duration::from_secs(12)).await;
|
||||||
|
assert!(matches!(events.recv().await,Some(super::SignalingEvent::Connected)));
|
||||||
|
let disconnected=tokio::time::timeout(std::time::Duration::from_secs(5),events.recv()).await;
|
||||||
|
assert!(matches!(disconnected,Ok(Some(super::SignalingEvent::Disconnected))),"a stalled delivery must still report Disconnected");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn open_socket(
|
||||||
|
req: tokio_tungstenite::tungstenite::handshake::client::Request,
|
||||||
|
limit: Duration,
|
||||||
|
) -> Result<crate::ws_transport::Socket, String> {
|
||||||
|
crate::ws_transport::connect(req, limit).await
|
||||||
}
|
}
|
||||||
|
|
||||||
impl SignalingClient {
|
impl SignalingClient {
|
||||||
@@ -149,24 +255,30 @@ impl SignalingClient {
|
|||||||
room_token.parse().map_err(|_| "Invalid token header")?,
|
room_token.parse().map_err(|_| "Invalid token header")?,
|
||||||
);
|
);
|
||||||
|
|
||||||
let (ws_stream, _) = connect_async(req)
|
let ws_stream = open_socket(req, CONNECT_TIMEOUT).await?;
|
||||||
.await
|
|
||||||
.map_err(|e| format!("WS connect failed: {}", e))?;
|
|
||||||
|
|
||||||
log::info!("Connected to Engine.IO / Socket.IO");
|
log::info!("Connected to Engine.IO / Socket.IO");
|
||||||
let (mut write, mut read) = ws_stream.split();
|
let (mut write, mut read) = ws_stream.split();
|
||||||
let (tx_outgoing, mut rx_outgoing) = mpsc::channel::<String>(32);
|
let (tx_outgoing, mut rx_outgoing) = mpsc::channel::<String>(32);
|
||||||
|
let started = Instant::now();
|
||||||
|
let last_rx = Arc::new(AtomicU64::new(0));
|
||||||
|
let ping_window_ms = Arc::new(AtomicU64::new(45_000));
|
||||||
|
let receiver_done = Arc::new(AtomicBool::new(false));
|
||||||
|
|
||||||
// 发送协程
|
// 发送协程
|
||||||
let writer=tokio::spawn(async move {
|
let writer=tokio::spawn(async move {
|
||||||
while let Some(msg) = rx_outgoing.recv().await {
|
while let Some(msg) = rx_outgoing.recv().await {
|
||||||
if let Err(e) = write.send(Message::Text(msg)).await {
|
match tokio::time::timeout(SEND_STALL_TIMEOUT, write.send(Message::Text(msg))).await {
|
||||||
let _ = e;
|
Ok(Ok(())) => {}
|
||||||
log::warn!("WS send failed (details omitted)");
|
Ok(Err(_)) | Err(_) => {
|
||||||
break;
|
// A peer that stopped reading must not park every producer.
|
||||||
|
log::warn!("WS send failed or stalled (details omitted)");
|
||||||
|
break;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
let writer_abort = writer.abort_handle();
|
||||||
|
|
||||||
let tx_out_clone = tx_outgoing.clone();
|
let tx_out_clone = tx_outgoing.clone();
|
||||||
static GENERATION: std::sync::atomic::AtomicU64 = std::sync::atomic::AtomicU64::new(1);
|
static GENERATION: std::sync::atomic::AtomicU64 = std::sync::atomic::AtomicU64::new(1);
|
||||||
@@ -175,9 +287,12 @@ impl SignalingClient {
|
|||||||
let refreshed=reconnect_key.clone();
|
let refreshed=reconnect_key.clone();
|
||||||
|
|
||||||
// 接收与状态机协程
|
// 接收与状态机协程
|
||||||
tokio::spawn(async move {
|
let watchdog_events = event_sender.clone();
|
||||||
|
let watchdog_last_rx = last_rx.clone();
|
||||||
|
let watchdog_ping_window_ms = ping_window_ms.clone();
|
||||||
|
let watchdog_done = receiver_done.clone();
|
||||||
|
let receiver = tokio::spawn(async move {
|
||||||
let mut req_counter = 10;
|
let mut req_counter = 10;
|
||||||
let started=std::time::Instant::now();
|
|
||||||
let mut last_ping=started;
|
let mut last_ping=started;
|
||||||
let mut pings=0u64;
|
let mut pings=0u64;
|
||||||
let mut pong_queued=0u64;
|
let mut pong_queued=0u64;
|
||||||
@@ -200,7 +315,7 @@ impl SignalingClient {
|
|||||||
_=event_sender.closed()=>break,
|
_=event_sender.closed()=>break,
|
||||||
_=tokio::time::sleep_until(ping_deadline) => {
|
_=tokio::time::sleep_until(ping_deadline) => {
|
||||||
log::warn!("Signaling heartbeat lost: generation={} age_s={} pings={} last_ping_gap_s={}",generation,started.elapsed().as_secs(),pings,last_ping.elapsed().as_secs());
|
log::warn!("Signaling heartbeat lost: generation={} age_s={} pings={} last_ping_gap_s={}",generation,started.elapsed().as_secs(),pings,last_ping.elapsed().as_secs());
|
||||||
let _ = event_sender.send(SignalingEvent::Disconnected).await;
|
let _ = send_event(&event_sender, SignalingEvent::Disconnected).await;
|
||||||
break;
|
break;
|
||||||
},
|
},
|
||||||
// Official ControlledSession RefreshSignalTokenLoop: first
|
// Official ControlledSession RefreshSignalTokenLoop: first
|
||||||
@@ -211,8 +326,8 @@ impl SignalingClient {
|
|||||||
refresh_acks.push_back(req_counter);
|
refresh_acks.push_back(req_counter);
|
||||||
if refresh_acks.len()>16 { refresh_acks.pop_front(); }
|
if refresh_acks.len()>16 { refresh_acks.pop_front(); }
|
||||||
let packet=format!("42{}[\"refresh_reconnect_key\"]",req_counter);
|
let packet=format!("42{}[\"refresh_reconnect_key\"]",req_counter);
|
||||||
if tx_out_clone.send(packet).await.is_err() {
|
if tx_out_clone.try_send(packet).is_err() {
|
||||||
let _=event_sender.send(SignalingEvent::Disconnected).await;break;
|
let _=send_event(&event_sender, SignalingEvent::Disconnected).await;break;
|
||||||
}
|
}
|
||||||
next_refresh=tokio::time::Instant::now()+std::time::Duration::from_secs(30);
|
next_refresh=tokio::time::Instant::now()+std::time::Duration::from_secs(30);
|
||||||
log::info!("Signaling reconnect-key refresh requested: generation={} age_s={}",generation,started.elapsed().as_secs());
|
log::info!("Signaling reconnect-key refresh requested: generation={} age_s={}",generation,started.elapsed().as_secs());
|
||||||
@@ -220,9 +335,14 @@ impl SignalingClient {
|
|||||||
},
|
},
|
||||||
msg=read.next()=>match msg {
|
msg=read.next()=>match msg {
|
||||||
Some(msg)=>msg,
|
Some(msg)=>msg,
|
||||||
None=>{let _=event_sender.send(SignalingEvent::Disconnected).await;break;}
|
None=>{let _=send_event(&event_sender, SignalingEvent::Disconnected).await;break;}
|
||||||
},
|
},
|
||||||
};
|
};
|
||||||
|
// Any inbound frame proves the socket is alive. A reader parked on
|
||||||
|
// event delivery stops updating this, which the watchdog catches.
|
||||||
|
if msg_res.is_ok() {
|
||||||
|
last_rx.store(started.elapsed().as_millis() as u64, Ordering::Relaxed);
|
||||||
|
}
|
||||||
match msg_res {
|
match msg_res {
|
||||||
Ok(Message::Text(txt)) => {
|
Ok(Message::Text(txt)) => {
|
||||||
// Engine.IO 报文处理
|
// Engine.IO 报文处理
|
||||||
@@ -231,16 +351,20 @@ impl SignalingClient {
|
|||||||
log::info!("Signaling heartbeat config: generation={} ping_interval_ms={:?} ping_timeout_ms={:?}",generation,open.get("pingInterval").and_then(Value::as_u64),open.get("pingTimeout").and_then(Value::as_u64));
|
log::info!("Signaling heartbeat config: generation={} ping_interval_ms={:?} ping_timeout_ms={:?}",generation,open.get("pingInterval").and_then(Value::as_u64),open.get("pingTimeout").and_then(Value::as_u64));
|
||||||
if let (Some(interval),Some(timeout))=(open.get("pingInterval").and_then(Value::as_u64),open.get("pingTimeout").and_then(Value::as_u64)) {
|
if let (Some(interval),Some(timeout))=(open.get("pingInterval").and_then(Value::as_u64),open.get("pingTimeout").and_then(Value::as_u64)) {
|
||||||
ping_window=std::time::Duration::from_millis(interval.saturating_add(timeout).clamp(5_000,300_000));
|
ping_window=std::time::Duration::from_millis(interval.saturating_add(timeout).clamp(5_000,300_000));
|
||||||
|
ping_window_ms.store(ping_window.as_millis() as u64, Ordering::Relaxed);
|
||||||
ping_deadline=tokio::time::Instant::now()+ping_window;
|
ping_deadline=tokio::time::Instant::now()+ping_window;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
// Open packet -> 发送 Socket.IO connect
|
// Open packet -> 发送 Socket.IO connect
|
||||||
let _ = tx_out_clone.send("40".into()).await;
|
if tx_out_clone.try_send("40".into()).is_err() {
|
||||||
|
let _=send_event(&event_sender, SignalingEvent::Disconnected).await;break;
|
||||||
|
}
|
||||||
} else if txt == "2" {
|
} else if txt == "2" {
|
||||||
// Ping -> 回复 Pong
|
// Ping -> 回复 Pong
|
||||||
let gap=last_ping.elapsed().as_secs();last_ping=std::time::Instant::now();pings+=1;
|
let gap=last_ping.elapsed().as_secs();last_ping=std::time::Instant::now();pings+=1;
|
||||||
ping_deadline=tokio::time::Instant::now()+ping_window;
|
ping_deadline=tokio::time::Instant::now()+ping_window;
|
||||||
if tx_out_clone.send("3".into()).await.is_ok() { pong_queued+=1; }
|
if tx_out_clone.try_send("3".into()).is_ok() { pong_queued+=1; }
|
||||||
|
else { let _=send_event(&event_sender, SignalingEvent::Disconnected).await;break; }
|
||||||
if pings==1 || pings%12==0 {
|
if pings==1 || pings%12==0 {
|
||||||
log::info!("Signaling heartbeat progress: generation={} age_s={} pings={} pong_queued={} gap_s={}",generation,started.elapsed().as_secs(),pings,pong_queued,gap);
|
log::info!("Signaling heartbeat progress: generation={} age_s={} pings={} pong_queued={} gap_s={}",generation,started.elapsed().as_secs(),pings,pong_queued,gap);
|
||||||
}
|
}
|
||||||
@@ -250,8 +374,10 @@ impl SignalingClient {
|
|||||||
// Socket.IO connected -> 发送 room_info 请求
|
// Socket.IO connected -> 发送 room_info 请求
|
||||||
req_counter += 1;
|
req_counter += 1;
|
||||||
let room_req = format!("42{}[\"room_info\"]", req_counter);
|
let room_req = format!("42{}[\"room_info\"]", req_counter);
|
||||||
let _ = tx_out_clone.send(room_req).await;
|
if tx_out_clone.try_send(room_req).is_err() {
|
||||||
let _ = event_sender.send(SignalingEvent::Connected).await;
|
let _=send_event(&event_sender, SignalingEvent::Disconnected).await;break;
|
||||||
|
}
|
||||||
|
if !send_event(&event_sender, SignalingEvent::Connected).await { break; }
|
||||||
} else if txt.starts_with("43") {
|
} else if txt.starts_with("43") {
|
||||||
// Socket.IO ack 回调
|
// Socket.IO ack 回调
|
||||||
let begin=txt.find('[').unwrap_or(2);
|
let begin=txt.find('[').unwrap_or(2);
|
||||||
@@ -270,7 +396,7 @@ impl SignalingClient {
|
|||||||
next_refresh=tokio::time::Instant::now()+std::time::Duration::from_secs(300);
|
next_refresh=tokio::time::Instant::now()+std::time::Duration::from_secs(300);
|
||||||
}
|
}
|
||||||
log::info!("Signaling reconnect-key refresh acknowledged: generation={} age_s={} success={}",generation,started.elapsed().as_secs(),success);
|
log::info!("Signaling reconnect-key refresh acknowledged: generation={} age_s={} success={}",generation,started.elapsed().as_secs(),success);
|
||||||
} else { let _ = event_sender.send(SignalingEvent::RoomInfoAck(v)).await; }
|
} else if !send_event(&event_sender, SignalingEvent::RoomInfoAck(v)).await { break; }
|
||||||
}
|
}
|
||||||
} else if txt.starts_with("45") || txt.starts_with("46") {
|
} else if txt.starts_with("45") || txt.starts_with("46") {
|
||||||
// Socket.IO binary event/ack: header text, attachments follow as binary frames.
|
// Socket.IO binary event/ack: header text, attachments follow as binary frames.
|
||||||
@@ -294,14 +420,10 @@ impl SignalingClient {
|
|||||||
|
|
||||||
match event_name {
|
match event_name {
|
||||||
"bmsg_push" => {
|
"bmsg_push" => {
|
||||||
let _ = event_sender
|
if !send_event(&event_sender, SignalingEvent::DeviceInfoChanged(data.clone())).await { break; }
|
||||||
.send(SignalingEvent::DeviceInfoChanged(data.clone()))
|
|
||||||
.await;
|
|
||||||
}
|
}
|
||||||
"be-controlled" => {
|
"be-controlled" => {
|
||||||
let _ = event_sender
|
if !send_event(&event_sender, SignalingEvent::BeControlled(data.clone())).await { break; }
|
||||||
.send(SignalingEvent::BeControlled(data.clone()))
|
|
||||||
.await;
|
|
||||||
}
|
}
|
||||||
"soac" => {
|
"soac" => {
|
||||||
// Offers only: structure (keys, types, lengths), never SDP text or ids.
|
// Offers only: structure (keys, types, lengths), never SDP text or ids.
|
||||||
@@ -324,9 +446,7 @@ impl SignalingClient {
|
|||||||
if soac.client_id.is_none() {
|
if soac.client_id.is_none() {
|
||||||
soac.client_id = client_id_opt;
|
soac.client_id = client_id_opt;
|
||||||
}
|
}
|
||||||
let _ = event_sender
|
if !send_event(&event_sender, SignalingEvent::Soac(soac)).await { break; }
|
||||||
.send(SignalingEvent::Soac(soac))
|
|
||||||
.await;
|
|
||||||
}
|
}
|
||||||
Err(e) => {
|
Err(e) => {
|
||||||
let _ = e;
|
let _ = e;
|
||||||
@@ -336,20 +456,17 @@ impl SignalingClient {
|
|||||||
}
|
}
|
||||||
"released" => {
|
"released" => {
|
||||||
log::info!("Cloud peer event: generation={} event=released age_s={} pings={} last_ping_gap_s={} ice_id_present={}",generation,started.elapsed().as_secs(),pings,last_ping.elapsed().as_secs(),data.get("ice_id").is_some());
|
log::info!("Cloud peer event: generation={} event=released age_s={} pings={} last_ping_gap_s={} ice_id_present={}",generation,started.elapsed().as_secs(),pings,last_ping.elapsed().as_secs(),data.get("ice_id").is_some());
|
||||||
let _ = event_sender
|
if !send_event(&event_sender, SignalingEvent::Released(data.clone())).await { break; }
|
||||||
.send(SignalingEvent::Released(data.clone()))
|
|
||||||
.await;
|
|
||||||
}
|
}
|
||||||
"left" | "leave" => {
|
"left" | "leave" => {
|
||||||
log::info!("Cloud peer event: generation={} event={} age_s={} pings={} last_ping_gap_s={} ice_id_present={}",generation,event_name,started.elapsed().as_secs(),pings,last_ping.elapsed().as_secs(),data.get("ice_id").is_some());
|
log::info!("Cloud peer event: generation={} event={} age_s={} pings={} last_ping_gap_s={} ice_id_present={}",generation,event_name,started.elapsed().as_secs(),pings,last_ping.elapsed().as_secs(),data.get("ice_id").is_some());
|
||||||
let ice_id = data.get("ice_id").and_then(|v| v.as_str()).unwrap_or("");
|
let ice_id = data.get("ice_id").and_then(|v| v.as_str()).unwrap_or("");
|
||||||
if ice_id.is_empty() {
|
if ice_id.is_empty() {
|
||||||
|
log::info!("Cloud room leave shape: {}", crate::protocol::json_shape(data, 3));
|
||||||
log::warn!("Cloud room leave without peer identifier; renewing signaling (expiry cause unknown)");
|
log::warn!("Cloud room leave without peer identifier; renewing signaling (expiry cause unknown)");
|
||||||
let _ = event_sender.send(SignalingEvent::Disconnected).await;
|
if !send_event(&event_sender, SignalingEvent::Disconnected).await { break; }
|
||||||
} else {
|
} else {
|
||||||
let _ = event_sender
|
if !send_event(&event_sender, SignalingEvent::Left(data.clone())).await { break; }
|
||||||
.send(SignalingEvent::Left(data.clone()))
|
|
||||||
.await;
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
_ => {
|
_ => {
|
||||||
@@ -399,28 +516,60 @@ impl SignalingClient {
|
|||||||
let controller_mac = platform.is_some_and(|v| v.as_i64() == Some(4)
|
let controller_mac = platform.is_some_and(|v| v.as_i64() == Some(4)
|
||||||
|| v.as_str().is_some_and(|s| s == "4" || s.to_ascii_lowercase().contains("mac") || s.to_ascii_lowercase().contains("darwin")));
|
|| v.as_str().is_some_and(|s| s == "4" || s.to_ascii_lowercase().contains("mac") || s.to_ascii_lowercase().contains("darwin")));
|
||||||
log::info!("Controller platform: {} mac={}", platform.map(|v| v.to_string()).unwrap_or_default().chars().take(24).collect::<String>(), controller_mac);
|
log::info!("Controller platform: {} mac={}", platform.map(|v| v.to_string()).unwrap_or_default().chars().take(24).collect::<String>(), controller_mac);
|
||||||
let _ = event_sender.send(SignalingEvent::ConnectRequest { capture_type, ice_id, transport:crate::session_ice::SessionIce::from_header(&header), controller_mac }).await;
|
if !send_event(&event_sender, SignalingEvent::ConnectRequest { capture_type, ice_id, transport:crate::session_ice::SessionIce::from_header(&header), controller_mac }).await { break; }
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
Ok(Message::Close(frame)) => {
|
Ok(Message::Close(frame)) => {
|
||||||
log::warn!("Signaling socket closed: generation={} age_s={} close_code={:?} pings={} last_ping_gap_s={}",generation,started.elapsed().as_secs(),frame.map(|f|u16::from(f.code)),pings,last_ping.elapsed().as_secs());
|
log::warn!("Signaling socket closed: generation={} age_s={} close_code={:?} pings={} last_ping_gap_s={}",generation,started.elapsed().as_secs(),frame.map(|f|u16::from(f.code)),pings,last_ping.elapsed().as_secs());
|
||||||
let _ = event_sender.send(SignalingEvent::Disconnected).await;
|
let _ = send_event(&event_sender, SignalingEvent::Disconnected).await;
|
||||||
break;
|
break;
|
||||||
}
|
}
|
||||||
Err(_) => {
|
Err(_) => {
|
||||||
log::warn!("Signaling socket receive failed: generation={} age_s={} pings={} last_ping_gap_s={}",generation,started.elapsed().as_secs(),pings,last_ping.elapsed().as_secs());
|
log::warn!("Signaling socket receive failed: generation={} age_s={} pings={} last_ping_gap_s={}",generation,started.elapsed().as_secs(),pings,last_ping.elapsed().as_secs());
|
||||||
let _ = event_sender.send(SignalingEvent::Disconnected).await;
|
let _ = send_event(&event_sender, SignalingEvent::Disconnected).await;
|
||||||
break;
|
break;
|
||||||
}
|
}
|
||||||
_ => {}
|
_ => {}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
// A stalled event queue or a writer that already stopped can end this
|
||||||
|
// loop without a delivered Disconnected. Hand one off from a detached
|
||||||
|
// task so the main loop always learns the room is dead; duplicates are
|
||||||
|
// harmless because it breaks on the first one.
|
||||||
|
let events = event_sender.clone();
|
||||||
|
tokio::spawn(async move { let _ = events.send(SignalingEvent::Disconnected).await; });
|
||||||
|
receiver_done.store(true, Ordering::Relaxed);
|
||||||
log::info!("Signaling receiver stopped: generation={} age_s={}",generation,started.elapsed().as_secs());
|
log::info!("Signaling receiver stopped: generation={} age_s={}",generation,started.elapsed().as_secs());
|
||||||
// Live peer callbacks can retain the old SignalingClient sender.
|
// Live peer callbacks can retain the old SignalingClient sender.
|
||||||
// Explicitly drop its write half too when this room stops reading.
|
// Explicitly drop its write half too when this room stops reading.
|
||||||
writer.abort();
|
writer.abort();
|
||||||
});
|
});
|
||||||
|
let receiver_abort = receiver.abort_handle();
|
||||||
|
|
||||||
|
// Independent of the receive loop: a consumer that stops draining events
|
||||||
|
// parks the loop inside an `.await`, where the ping deadline can no longer
|
||||||
|
// be observed. The watchdog closes the socket anyway.
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let mut tick = tokio::time::interval(WATCHDOG_TICK);
|
||||||
|
tick.set_missed_tick_behavior(tokio::time::MissedTickBehavior::Delay);
|
||||||
|
loop {
|
||||||
|
tick.tick().await;
|
||||||
|
if watchdog_done.load(Ordering::Relaxed) || watchdog_events.is_closed() { return; }
|
||||||
|
let window_ms = watchdog_ping_window_ms.load(Ordering::Relaxed);
|
||||||
|
let idle_ms = (started.elapsed().as_millis() as u64)
|
||||||
|
.saturating_sub(watchdog_last_rx.load(Ordering::Relaxed));
|
||||||
|
if idle_ms <= window_ms { continue; }
|
||||||
|
log::warn!("Signaling heartbeat lost (watchdog): idle_s={} window_ms={}", idle_ms/1000, window_ms);
|
||||||
|
// Deliver from a detached task: the receiver may be the one parked
|
||||||
|
// on a full queue, and the main loop still needs this event.
|
||||||
|
let events = watchdog_events.clone();
|
||||||
|
tokio::spawn(async move { let _ = events.send(SignalingEvent::Disconnected).await; });
|
||||||
|
receiver_abort.abort();
|
||||||
|
writer_abort.abort();
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
Ok(Self { tx_outgoing, _reconnect_key:reconnect_key })
|
Ok(Self { tx_outgoing, _reconnect_key:reconnect_key })
|
||||||
}
|
}
|
||||||
@@ -428,7 +577,10 @@ impl SignalingClient {
|
|||||||
pub async fn emit_event(&self, event: &str, payload: serde_json::Value) -> Result<(), String> {
|
pub async fn emit_event(&self, event: &str, payload: serde_json::Value) -> Result<(), String> {
|
||||||
let packet = format!("42{}", serde_json::json!([event, payload]));
|
let packet = format!("42{}", serde_json::json!([event, payload]));
|
||||||
log::info!("Emitting signaling event: {}", event);
|
log::info!("Emitting signaling event: {}", event);
|
||||||
self.tx_outgoing.send(packet).await.map_err(|e| e.to_string())
|
tokio::time::timeout(SEND_STALL_TIMEOUT, self.tx_outgoing.send(packet))
|
||||||
|
.await
|
||||||
|
.map_err(|_| "signaling send stalled".to_string())?
|
||||||
|
.map_err(|e| e.to_string())
|
||||||
}
|
}
|
||||||
|
|
||||||
/// 发送 SOAC 消息(Answer 或 Candidate)
|
/// 发送 SOAC 消息(Answer 或 Candidate)
|
||||||
@@ -443,9 +595,9 @@ impl SignalingClient {
|
|||||||
};
|
};
|
||||||
let msg = format!("42[\"soac\",{}]", payload);
|
let msg = format!("42[\"soac\",{}]", payload);
|
||||||
log::info!("Emitting soac packet: type={}", soac.msg_type);
|
log::info!("Emitting soac packet: type={}", soac.msg_type);
|
||||||
self.tx_outgoing
|
tokio::time::timeout(SEND_STALL_TIMEOUT, self.tx_outgoing.send(msg))
|
||||||
.send(msg)
|
|
||||||
.await
|
.await
|
||||||
|
.map_err(|_| "Send soac timed out".to_string())?
|
||||||
.map_err(|e| format!("Send soac error: {}", e))
|
.map_err(|e| format!("Send soac error: {}", e))
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -12,6 +12,8 @@ pub const FF_SIMPLE_ACTION: u8 = 2;
|
|||||||
pub const FF_SYSTEM_METRICS: u8 = 2;
|
pub const FF_SYSTEM_METRICS: u8 = 2;
|
||||||
|
|
||||||
pub const SHOW_DESKTOP: u64 = 2;
|
pub const SHOW_DESKTOP: u64 = 2;
|
||||||
|
/// Opens the desktop on an existing connection (the viewer's port mapping reuses its peer, #99).
|
||||||
|
pub const CAPTURE_DESKTOP: u64 = 4;
|
||||||
pub const REBOOT_SYSTEM: u64 = 9;
|
pub const REBOOT_SYSTEM: u64 = 9;
|
||||||
pub const LOCK_SYSTEM: u64 = 10;
|
pub const LOCK_SYSTEM: u64 = 10;
|
||||||
pub const SHUTDOWN_SYSTEM: u64 = 12;
|
pub const SHUTDOWN_SYSTEM: u64 = 12;
|
||||||
|
|||||||
+83
-28
@@ -780,19 +780,20 @@ async fn read_inprocess(
|
|||||||
/// whole IDR frame, otherwise large desktops get near-grey keyframes that sharpen over the GOP (#8).
|
/// whole IDR frame, otherwise large desktops get near-grey keyframes that sharpen over the GOP (#8).
|
||||||
/// Half a second of bitrate still starved repeated 0.5 s-GOP keyframes at 3296x2036/2M; one second did not.
|
/// Half a second of bitrate still starved repeated 0.5 s-GOP keyframes at 3296x2036/2M; one second did not.
|
||||||
fn buffer_kbits(max_kbps: u32, encoder: Encoder) -> u32 {
|
fn buffer_kbits(max_kbps: u32, encoder: Encoder) -> u32 {
|
||||||
if encoder == Encoder::Cpu { max_kbps.clamp(500, 8000) }
|
let env = match encoder {
|
||||||
else if encoder == Encoder::Vaapi {
|
Encoder::Cpu => return max_kbps.clamp(500, 8000),
|
||||||
let requested = std::env::var("UU_VAAPI_BUFFER_MS").ok();
|
Encoder::Vaapi => "UU_VAAPI_BUFFER_MS",
|
||||||
vaapi_buffer_kbits(max_kbps, requested.as_deref()).unwrap_or((max_kbps / 8).clamp(100, 500))
|
Encoder::Nvenc => "UU_NVENC_BUFFER_MS",
|
||||||
}
|
};
|
||||||
else { (max_kbps / 8).clamp(100, 500) }
|
let requested = std::env::var(env).ok();
|
||||||
|
buffer_ms_kbits(max_kbps, requested.as_deref()).unwrap_or((max_kbps / 8).clamp(100, 500))
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Opt-in VAAPI VBV buffer: `码率上限 × 毫秒 / 1000` for `UU_VAAPI_BUFFER_MS` in 10-1000 ms.
|
/// Opt-in hardware VBV buffer: `码率上限 × 毫秒 / 1000` for `UU_VAAPI_BUFFER_MS` /
|
||||||
/// The 100-500 kbit default is sized for NVENC; VAAPI quantizes a whole desktop keyframe when
|
/// `UU_NVENC_BUFFER_MS` in 10-1000 ms. With the 100-500 kbit default the encoder quantizes a
|
||||||
/// the buffer is that small, which reads as a blur that sharpens over each GOP (#42).
|
/// whole desktop keyframe, which reads as a blur that sharpens over each GOP (#42 VAAPI, #103 NVENC).
|
||||||
/// Unset, out of range or unparsable values keep the default buffer.
|
/// Unset, out of range or unparsable values keep the default buffer.
|
||||||
fn vaapi_buffer_kbits(max_kbps: u32, value: Option<&str>) -> Option<u32> {
|
fn buffer_ms_kbits(max_kbps: u32, value: Option<&str>) -> Option<u32> {
|
||||||
let ms = value?.trim().parse::<u32>().ok().filter(|ms| (10..=1000).contains(ms))?;
|
let ms = value?.trim().parse::<u32>().ok().filter(|ms| (10..=1000).contains(ms))?;
|
||||||
Some((max_kbps.saturating_mul(ms) / 1000).max(1))
|
Some((max_kbps.saturating_mul(ms) / 1000).max(1))
|
||||||
}
|
}
|
||||||
@@ -814,10 +815,12 @@ async fn read_encoder_with(
|
|||||||
settings: VideoSettings, #[cfg_attr(not(feature = "inproc-av"), allow(unused_variables))] idr: Arc<AtomicBool>, budget: Arc<Semaphore>,
|
settings: VideoSettings, #[cfg_attr(not(feature = "inproc-av"), allow(unused_variables))] idr: Arc<AtomicBool>, budget: Arc<Semaphore>,
|
||||||
selection: crate::video_select::Selection,
|
selection: crate::video_select::Selection,
|
||||||
)->Result<(),String>{
|
)->Result<(),String>{
|
||||||
let selected_output=if display.starts_with("wayland:") {crate::wayland::source(settings.source_id)} else {None};
|
let selected_output=crate::wayland::capture_source(&display,portal.is_some(),settings.source_id);
|
||||||
let size=selected_output.map_or(size,|s|(s.width,s.height));
|
let size=selected_output.map_or(size,|s|(s.width,s.height));
|
||||||
let kms=display.starts_with("kms:");
|
let kms=display.starts_with("kms:");
|
||||||
let wayland=kms || display.starts_with("wayland:");
|
let wayland=kms || display.starts_with("wayland:");
|
||||||
|
// X11 multi-screen: x11grab reads only the selected monitor's region of the root.
|
||||||
|
let x11_region=selected_output.filter(|_|!wayland);
|
||||||
let (permits_tx,mut permits_rx)=mpsc::channel::<OwnedSemaphorePermit>(4);
|
let (permits_tx,mut permits_rx)=mpsc::channel::<OwnedSemaphorePermit>(4);
|
||||||
let kms_capture=if kms {
|
let kms_capture=if kms {
|
||||||
let capture=tokio::task::spawn_blocking(crate::kms::Capture::open).await.map_err(|_|"KMS worker failed")??;
|
let capture=tokio::task::spawn_blocking(crate::kms::Capture::open).await.map_err(|_|"KMS worker failed")??;
|
||||||
@@ -825,7 +828,7 @@ async fn read_encoder_with(
|
|||||||
Some(Arc::new(capture))
|
Some(Arc::new(capture))
|
||||||
} else { None };
|
} else { None };
|
||||||
#[cfg(feature = "inproc-av")]
|
#[cfg(feature = "inproc-av")]
|
||||||
if allow_inproc && native_inproc(&display, portal.is_some(), encoder) {
|
if allow_inproc && x11_region.is_none() && native_inproc(&display, portal.is_some(), encoder) {
|
||||||
let max_kbps = settings.max_kbps().unwrap_or(30_000) as i64;
|
let max_kbps = settings.max_kbps().unwrap_or(30_000) as i64;
|
||||||
let config = crate::inproc_encoder::Config {
|
let config = crate::inproc_encoder::Config {
|
||||||
display: display.clone(), input: size, output: settings.output, fps: u32::from(settings.fps),
|
display: display.clone(), input: size, output: settings.output, fps: u32::from(settings.fps),
|
||||||
@@ -859,8 +862,9 @@ async fn read_encoder_with(
|
|||||||
"-framerate",&fps,"-i","pipe:0","-an"]);
|
"-framerate",&fps,"-i","pipe:0","-an"]);
|
||||||
} else {
|
} else {
|
||||||
// The viewer draws its local pointer; do not bake a second into video.
|
// The viewer draws its local pointer; do not bake a second into video.
|
||||||
|
let input=x11_region.map_or_else(||display.clone(),|o|format!("{display}+{},{}",o.x,o.y));
|
||||||
command.args(["-f","x11grab","-draw_mouse","0","-framerate",&fps,
|
command.args(["-f","x11grab","-draw_mouse","0","-framerate",&fps,
|
||||||
"-video_size",&size,"-i",&display,"-an"]);
|
"-video_size",&size,"-i",&input,"-an"]);
|
||||||
}
|
}
|
||||||
// 其他分辨率: scale the captured desktop (the host display mode is left untouched).
|
// 其他分辨率: scale the captured desktop (the host display mode is left untouched).
|
||||||
command.args(scale_options(&settings, encoder, Some(source_size)));
|
command.args(scale_options(&settings, encoder, Some(source_size)));
|
||||||
@@ -1140,9 +1144,16 @@ fn keep_stream_display_awake() {
|
|||||||
if result.is_err() { log::warn!("Display wake failed; continuing desktop stream and retrying next interval"); }
|
if result.is_err() { log::warn!("Display wake failed; continuing desktop stream and retrying next interval"); }
|
||||||
}
|
}
|
||||||
|
|
||||||
pub async fn stream_desktop(pc: Arc<RTCPeerConnection>, track: Arc<crate::video_track::VideoTrack>, mut size: (u32, u32), display: String, portal:Option<Arc<crate::portal::PortalSession>>,
|
/// `sync_tx` receives a Message 25 payload when a live encoder switch changes the encoded chroma.
|
||||||
|
pub async fn stream_desktop(pc: Arc<RTCPeerConnection>, track: Arc<crate::video_track::VideoTrack>, size: (u32, u32), display: String, portal:Option<Arc<crate::portal::PortalSession>>,
|
||||||
|
settings: tokio::sync::watch::Receiver<VideoSettings>, applied: Arc<tokio::sync::watch::Sender<VideoSettings>>, idr: Arc<AtomicBool>,
|
||||||
|
selection: crate::video_select::Selection, sync_tx: Option<tokio::sync::mpsc::UnboundedSender<Vec<u8>>>) -> Result<(), String> {
|
||||||
|
stream_desktop_at(pc, track, size, display, portal, settings, applied, idr, selection, sync_tx, crate::video_select::reload_generation_value()).await
|
||||||
|
}
|
||||||
|
|
||||||
|
pub async fn stream_desktop_at(pc: Arc<RTCPeerConnection>, track: Arc<crate::video_track::VideoTrack>, mut size: (u32, u32), display: String, portal:Option<Arc<crate::portal::PortalSession>>,
|
||||||
mut settings: tokio::sync::watch::Receiver<VideoSettings>, applied: Arc<tokio::sync::watch::Sender<VideoSettings>>, idr: Arc<AtomicBool>,
|
mut settings: tokio::sync::watch::Receiver<VideoSettings>, applied: Arc<tokio::sync::watch::Sender<VideoSettings>>, idr: Arc<AtomicBool>,
|
||||||
selection: crate::video_select::Selection) -> Result<(), String> {
|
selection: crate::video_select::Selection, sync_tx: Option<tokio::sync::mpsc::UnboundedSender<Vec<u8>>>, reload_at_session: u64) -> Result<(), String> {
|
||||||
let _desktop_mode = crate::desktop_mode::StreamGuard::new();
|
let _desktop_mode = crate::desktop_mode::StreamGuard::new();
|
||||||
loop {
|
loop {
|
||||||
if transport_closed(&pc) { return Ok(()); }
|
if transport_closed(&pc) { return Ok(()); }
|
||||||
@@ -1163,7 +1174,14 @@ pub async fn stream_desktop(pc: Arc<RTCPeerConnection>, track: Arc<crate::video_
|
|||||||
applied.send_replace(current);
|
applied.send_replace(current);
|
||||||
settings.borrow_and_update();
|
settings.borrow_and_update();
|
||||||
}
|
}
|
||||||
// Reader restarts reuse this snapshot, so set-encoder waits for the next desktop connection.
|
// SIGUSR2 re-reads host_settings and restarts this encoder when the effective encoder changes.
|
||||||
|
// The negotiated codec stays; a codec-only change is logged and applied on the next connection.
|
||||||
|
let mut live_selection = selection;
|
||||||
|
let mut seen_codec_pref = selection.codec_pref;
|
||||||
|
let mut reload = crate::video_select::subscribe_reload();
|
||||||
|
// Only a SIGUSR2 since the session snapshot. A probe that finishes during setup is not a reload
|
||||||
|
// (sessions started before the probe keep the legacy encoder for their lifetime).
|
||||||
|
let mut reload_pending = crate::video_select::reload_since_session(reload_at_session, *reload.borrow());
|
||||||
let open = {
|
let open = {
|
||||||
let display = display.clone();
|
let display = display.clone();
|
||||||
let portal = portal.clone();
|
let portal = portal.clone();
|
||||||
@@ -1175,7 +1193,7 @@ pub async fn stream_desktop(pc: Arc<RTCPeerConnection>, track: Arc<crate::video_
|
|||||||
read_encoder(size, display.clone(), portal.clone(), latest.clone(), settings, sequence.clone(), idr.clone(), budget.clone(), selection)
|
read_encoder(size, display.clone(), portal.clone(), latest.clone(), settings, sequence.clone(), idr.clone(), budget.clone(), selection)
|
||||||
}
|
}
|
||||||
};
|
};
|
||||||
let mut reader = EncoderTask(tokio::spawn(open(size, selection, current)));
|
let mut reader = EncoderTask(tokio::spawn(open(size, live_selection, current)));
|
||||||
let mut previous = None;
|
let mut previous = None;
|
||||||
let mut timeline = RtpTimeline { fps: u64::from(current.fps), ..Default::default() };
|
let mut timeline = RtpTimeline { fps: u64::from(current.fps), ..Default::default() };
|
||||||
let mut settings_open = true;
|
let mut settings_open = true;
|
||||||
@@ -1190,6 +1208,43 @@ pub async fn stream_desktop(pc: Arc<RTCPeerConnection>, track: Arc<crate::video_
|
|||||||
let (mut window_frames, mut window_skipped) = (0u64, 0u64);
|
let (mut window_frames, mut window_skipped) = (0u64, 0u64);
|
||||||
let mut send_interrupted=false;
|
let mut send_interrupted=false;
|
||||||
'stream: loop {
|
'stream: loop {
|
||||||
|
if reload.has_changed().unwrap_or(false) || reload_pending {
|
||||||
|
reload_pending = false;
|
||||||
|
// Mark the watch seen. An unconsumed has_changed stays true and restarts every frame.
|
||||||
|
let _ = reload.borrow_and_update();
|
||||||
|
let fresh = crate::video_select::selection();
|
||||||
|
let plan = crate::video_select::plan_switch(live_selection.encoder, seen_codec_pref, &fresh, current.chroma);
|
||||||
|
if let Some(plan) = plan.filter(|plan| plan.encoder.is_some()) {
|
||||||
|
let encoder = plan.encoder.unwrap();
|
||||||
|
let chroma = if plan.chroma_downgraded { "420" } else if current.chroma == crate::capture_setting::CHROMA_444 { "444" } else { "420" };
|
||||||
|
log::info!("Encoder switch: {} -> {} reason={} chroma={chroma}",
|
||||||
|
format!("{:?}", live_selection.encoder).to_ascii_lowercase(),
|
||||||
|
format!("{encoder:?}").to_ascii_lowercase(),
|
||||||
|
crate::video_select::encoder_source_label(fresh.encoder_source));
|
||||||
|
live_selection.encoder = encoder;
|
||||||
|
live_selection.encoder_source = fresh.encoder_source;
|
||||||
|
seen_codec_pref = fresh.codec_pref;
|
||||||
|
if plan.chroma_downgraded {
|
||||||
|
applied.send_modify(|value| value.chroma = plan.chroma);
|
||||||
|
current.chroma = plan.chroma;
|
||||||
|
settings.borrow_and_update();
|
||||||
|
if let Some(sync) = sync_tx.as_ref() {
|
||||||
|
// Wayland: x11_resized is None, and the connection size can be a previous output.
|
||||||
|
let native = x11_resized(&display, portal_stream, size).unwrap_or_else(|| crate::wayland::sync_native(&display, current.source_id, size));
|
||||||
|
let payload = crate::capture_setting::sync_payload(¤t, native);
|
||||||
|
let _ = sync.send(payload);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// In-process engines honor this on the first frame; the process pipeline starts on an IDR.
|
||||||
|
idr.store(true, std::sync::atomic::Ordering::Relaxed);
|
||||||
|
reader.restart(open(size, live_selection, current)).await;
|
||||||
|
} else if plan.is_some() {
|
||||||
|
log::info!("Codec preference changed; takes effect the next time a desktop connection starts");
|
||||||
|
seen_codec_pref = fresh.codec_pref;
|
||||||
|
live_selection.codec_pref = fresh.codec_pref;
|
||||||
|
live_selection.codec_source = fresh.codec_source;
|
||||||
|
}
|
||||||
|
}
|
||||||
let next = *settings.borrow_and_update();
|
let next = *settings.borrow_and_update();
|
||||||
if next != current || send_interrupted {
|
if next != current || send_interrupted {
|
||||||
let discard = next.codec != current.codec || next.source_generation != current.source_generation || next.source_id != current.source_id || send_interrupted;
|
let discard = next.codec != current.codec || next.source_generation != current.source_generation || next.source_id != current.source_id || send_interrupted;
|
||||||
@@ -1201,9 +1256,9 @@ pub async fn stream_desktop(pc: Arc<RTCPeerConnection>, track: Arc<crate::video_
|
|||||||
reader.0.abort();
|
reader.0.abort();
|
||||||
let _ = (&mut reader.0).await;
|
let _ = (&mut reader.0).await;
|
||||||
while receiver.try_recv().is_ok() {}
|
while receiver.try_recv().is_ok() {}
|
||||||
reader.0 = tokio::spawn(open(size, selection, next));
|
reader.0 = tokio::spawn(open(size, live_selection, next));
|
||||||
} else {
|
} else {
|
||||||
reader.restart(open(size, selection, next)).await;
|
reader.restart(open(size, live_selection, next)).await;
|
||||||
}
|
}
|
||||||
send_interrupted=false;
|
send_interrupted=false;
|
||||||
}
|
}
|
||||||
@@ -1214,7 +1269,7 @@ pub async fn stream_desktop(pc: Arc<RTCPeerConnection>, track: Arc<crate::video_
|
|||||||
log::info!("Desktop geometry changed during the stream ({}x{} -> {}x{}); restarting capture", size.0, size.1, resized.0, resized.1);
|
log::info!("Desktop geometry changed during the stream ({}x{} -> {}x{}); restarting capture", size.0, size.1, resized.0, resized.1);
|
||||||
size = resized;
|
size = resized;
|
||||||
while receiver.try_recv().is_ok() {}
|
while receiver.try_recv().is_ok() {}
|
||||||
reader.0 = tokio::spawn(open(size, selection, current));
|
reader.0 = tokio::spawn(open(size, live_selection, current));
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
if let (Err(error), VideoCodec::H265, true) = (&result, current.codec, track.supports(VideoCodec::H264)) {
|
if let (Err(error), VideoCodec::H265, true) = (&result, current.codec, track.supports(VideoCodec::H264)) {
|
||||||
@@ -1222,7 +1277,7 @@ pub async fn stream_desktop(pc: Arc<RTCPeerConnection>, track: Arc<crate::video_
|
|||||||
applied.send_modify(|value| value.codec = VideoCodec::H264);
|
applied.send_modify(|value| value.codec = VideoCodec::H264);
|
||||||
current = *settings.borrow_and_update();
|
current = *settings.borrow_and_update();
|
||||||
while receiver.try_recv().is_ok() {}
|
while receiver.try_recv().is_ok() {}
|
||||||
reader.0 = tokio::spawn(open(size, selection, current));
|
reader.0 = tokio::spawn(open(size, live_selection, current));
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
if result.is_err() && !crate::wayland::outputs().is_empty() && !crate::wayland::input_ready() {
|
if result.is_err() && !crate::wayland::outputs().is_empty() && !crate::wayland::input_ready() {
|
||||||
@@ -1516,17 +1571,17 @@ mod tests {
|
|||||||
}
|
}
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn vaapi_buffer_env_is_opt_in_and_bounded() {
|
fn hw_buffer_env_is_opt_in_and_bounded() {
|
||||||
assert_eq!(vaapi_buffer_kbits(30_000, None), None);
|
assert_eq!(buffer_ms_kbits(30_000, None), None);
|
||||||
assert_eq!(vaapi_buffer_kbits(30_000, Some("250")), Some(7500));
|
assert_eq!(buffer_ms_kbits(30_000, Some("250")), Some(7500));
|
||||||
assert_eq!(vaapi_buffer_kbits(30_000, Some(" 10 ")), Some(300));
|
assert_eq!(buffer_ms_kbits(30_000, Some(" 10 ")), Some(300));
|
||||||
assert_eq!(vaapi_buffer_kbits(30_000, Some("1000")), Some(30_000));
|
assert_eq!(buffer_ms_kbits(30_000, Some("1000")), Some(30_000));
|
||||||
// Out of the documented range, empty or unparsable keeps the default buffer.
|
// Out of the documented range, empty or unparsable keeps the default buffer.
|
||||||
for value in ["", "9", "1001", "0", "abc", "-250", "250ms"] {
|
for value in ["", "9", "1001", "0", "abc", "-250", "250ms"] {
|
||||||
assert_eq!(vaapi_buffer_kbits(30_000, Some(value)), None, "{value}");
|
assert_eq!(buffer_ms_kbits(30_000, Some(value)), None, "{value}");
|
||||||
}
|
}
|
||||||
// A tiny cap must not produce a zero-sized buffer.
|
// A tiny cap must not produce a zero-sized buffer.
|
||||||
assert_eq!(vaapi_buffer_kbits(1, Some("10")), Some(1));
|
assert_eq!(buffer_ms_kbits(1, Some("10")), Some(1));
|
||||||
}
|
}
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
|
|||||||
@@ -234,11 +234,103 @@ pub fn cached_probe() -> Option<ProbeReport> {
|
|||||||
#[cfg(test)]
|
#[cfg(test)]
|
||||||
pub(crate) static PROBE_TEST_LOCK: std::sync::Mutex<()> = std::sync::Mutex::new(());
|
pub(crate) static PROBE_TEST_LOCK: std::sync::Mutex<()> = std::sync::Mutex::new(());
|
||||||
|
|
||||||
|
/// Tests that read or bump the process-global reload generation share this lock.
|
||||||
|
#[cfg(test)]
|
||||||
|
pub(crate) static RELOAD_TEST_LOCK:std::sync::Mutex<()> = std::sync::Mutex::new(());
|
||||||
|
|
||||||
#[cfg(test)]
|
#[cfg(test)]
|
||||||
pub fn clear_probe() {
|
pub fn clear_probe() {
|
||||||
if let Ok(mut slot) = cache().lock() { *slot = None; }
|
if let Ok(mut slot) = cache().lock() { *slot = None; }
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Why a live desktop encoder was asked to change.
|
||||||
|
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
|
||||||
|
pub enum SwitchReason {
|
||||||
|
/// Effective encoder differs. The log line uses `Selection::encoder_source`, not this variant.
|
||||||
|
Encoder,
|
||||||
|
/// Codec preference changed. The negotiated codec stays until the next stream.
|
||||||
|
CodecDeferred,
|
||||||
|
}
|
||||||
|
|
||||||
|
/// What SIGUSR2 should do to one live desktop stream.
|
||||||
|
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
|
||||||
|
pub struct SwitchPlan {
|
||||||
|
/// Restart the encoder. None keeps the running encoder (codec-only or no change).
|
||||||
|
pub encoder: Option<Encoder>,
|
||||||
|
pub reason: SwitchReason,
|
||||||
|
/// Chroma the restarted encoder can actually produce. VAAPI has no 4:4:4.
|
||||||
|
pub chroma: u64,
|
||||||
|
/// True when the request was 4:4:4 and the new encoder must report 4:2:0.
|
||||||
|
pub chroma_downgraded: bool,
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Compare the selection this stream is using with a freshly read one.
|
||||||
|
/// Codec preference is the stored preference, not the negotiated m-line codec.
|
||||||
|
pub fn plan_switch(active_encoder: Encoder, previous_codec: CodecPref, next: &Selection, active_chroma: u64) -> Option<SwitchPlan> {
|
||||||
|
if next.encoder != active_encoder {
|
||||||
|
let chroma = if active_chroma == crate::capture_setting::CHROMA_444 && !crate::video::full_chroma_for(next.encoder) {
|
||||||
|
crate::capture_setting::CHROMA_420
|
||||||
|
} else {
|
||||||
|
active_chroma
|
||||||
|
};
|
||||||
|
return Some(SwitchPlan {
|
||||||
|
encoder: Some(next.encoder),
|
||||||
|
reason: SwitchReason::Encoder,
|
||||||
|
chroma,
|
||||||
|
chroma_downgraded: chroma != active_chroma,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
if next.codec_pref != previous_codec {
|
||||||
|
return Some(SwitchPlan {
|
||||||
|
encoder: None,
|
||||||
|
reason: SwitchReason::CodecDeferred,
|
||||||
|
chroma: active_chroma,
|
||||||
|
chroma_downgraded: false,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
None
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Monotonic generation bumped by SIGUSR2. Streams watch it and re-read `selection()`.
|
||||||
|
fn reload_generation() -> &'static std::sync::atomic::AtomicU64 {
|
||||||
|
static GEN: std::sync::atomic::AtomicU64 = std::sync::atomic::AtomicU64::new(0);
|
||||||
|
&GEN
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn reload_generation_value() -> u64 {
|
||||||
|
reload_generation().load(std::sync::atomic::Ordering::Relaxed)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// SIGUSR2: ask live desktop streams to re-read host_settings. Does not clear the probe cache.
|
||||||
|
pub fn notify_reload() {
|
||||||
|
reload_generation().fetch_add(1, std::sync::atomic::Ordering::Relaxed);
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn reload_watch() -> &'static tokio::sync::watch::Sender<u64> {
|
||||||
|
static WATCH: std::sync::OnceLock<tokio::sync::watch::Sender<u64>> = std::sync::OnceLock::new();
|
||||||
|
WATCH.get_or_init(|| {
|
||||||
|
let (tx, _) = tokio::sync::watch::channel(reload_generation_value());
|
||||||
|
tx
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn subscribe_reload() -> tokio::sync::watch::Receiver<u64> {
|
||||||
|
reload_watch().subscribe()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// True when SIGUSR2 has bumped the generation since the session snapshot.
|
||||||
|
/// A background auto probe that finishes during setup does not bump it.
|
||||||
|
pub fn reload_since_session(at_session: u64, current: u64) -> bool {
|
||||||
|
current != at_session
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Publish the generation so every subscribed desktop stream wakes.
|
||||||
|
pub fn publish_reload() {
|
||||||
|
notify_reload();
|
||||||
|
// send() drops the value when nobody is subscribed (the gap between desktop connections).
|
||||||
|
reload_watch().send_replace(reload_generation_value());
|
||||||
|
}
|
||||||
|
|
||||||
/// Setting (non-auto) beats the environment, which beats the NVIDIA/CPU default.
|
/// Setting (non-auto) beats the environment, which beats the NVIDIA/CPU default.
|
||||||
pub fn selection() -> Selection {
|
pub fn selection() -> Selection {
|
||||||
selection_with(cached_probe().as_ref())
|
selection_with(cached_probe().as_ref())
|
||||||
@@ -486,6 +578,78 @@ mod tests {
|
|||||||
assert_eq!(resolve_pair(None, None, None, Some("h264"), false, Some(&va)).codec_pref, CodecPref::H264);
|
assert_eq!(resolve_pair(None, None, None, Some("h264"), false, Some(&va)).codec_pref, CodecPref::H264);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
fn selection_of(encoder: Encoder, codec: CodecPref) -> Selection {
|
||||||
|
Selection { encoder, encoder_source: Source::Setting, codec_pref: codec, codec_source: Source::Setting }
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn live_switch_restarts_encoder_and_defers_codec() {
|
||||||
|
let nv = selection_of(Encoder::Nvenc, CodecPref::Auto);
|
||||||
|
assert!(plan_switch(Encoder::Nvenc, CodecPref::Auto, &nv, crate::capture_setting::CHROMA_420).is_none());
|
||||||
|
let to_cpu = plan_switch(Encoder::Nvenc, CodecPref::Auto, &selection_of(Encoder::Cpu, CodecPref::Auto), crate::capture_setting::CHROMA_444).unwrap();
|
||||||
|
assert_eq!(to_cpu.encoder, Some(Encoder::Cpu));
|
||||||
|
assert_eq!(to_cpu.reason, SwitchReason::Encoder);
|
||||||
|
assert!(!to_cpu.chroma_downgraded);
|
||||||
|
assert_eq!(to_cpu.chroma, crate::capture_setting::CHROMA_444);
|
||||||
|
let to_vaapi = plan_switch(Encoder::Nvenc, CodecPref::H265, &selection_of(Encoder::Vaapi, CodecPref::H265), crate::capture_setting::CHROMA_444).unwrap();
|
||||||
|
assert_eq!(to_vaapi.encoder, Some(Encoder::Vaapi));
|
||||||
|
assert!(to_vaapi.chroma_downgraded);
|
||||||
|
assert_eq!(to_vaapi.chroma, crate::capture_setting::CHROMA_420);
|
||||||
|
let codec = plan_switch(Encoder::Nvenc, CodecPref::Auto, &selection_of(Encoder::Nvenc, CodecPref::H264), crate::capture_setting::CHROMA_420).unwrap();
|
||||||
|
assert_eq!(codec.encoder, None);
|
||||||
|
assert_eq!(codec.reason, SwitchReason::CodecDeferred);
|
||||||
|
let both = plan_switch(Encoder::Cpu, CodecPref::Auto, &selection_of(Encoder::Nvenc, CodecPref::H264), crate::capture_setting::CHROMA_420).unwrap();
|
||||||
|
assert_eq!(both.encoder, Some(Encoder::Nvenc));
|
||||||
|
assert_eq!(both.reason, SwitchReason::Encoder);
|
||||||
|
// The log reason is the source of the new selection (setting / env / auto), not a fixed word.
|
||||||
|
for (source, label) in [(Source::Setting, "setting"), (Source::Env, "env"), (Source::Auto, "auto")] {
|
||||||
|
let mut next = selection_of(Encoder::Vaapi, CodecPref::Auto);
|
||||||
|
next.encoder_source = source;
|
||||||
|
let plan = plan_switch(Encoder::Nvenc, CodecPref::Auto, &next, crate::capture_setting::CHROMA_420).unwrap();
|
||||||
|
assert!(plan.encoder.is_some());
|
||||||
|
assert_eq!(encoder_source_label(next.encoder_source), label);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn reload_does_not_clear_the_probe_cache() {
|
||||||
|
let _reload = RELOAD_TEST_LOCK.lock().unwrap_or_else(|e| e.into_inner());
|
||||||
|
let _guard = PROBE_TEST_LOCK.lock().unwrap_or_else(|e| e.into_inner());
|
||||||
|
let report = probe_report(true, &[ProbeOutcome::Ok, ProbeOutcome::Ok]);
|
||||||
|
store_probe(report.clone());
|
||||||
|
let before = reload_generation_value();
|
||||||
|
notify_reload();
|
||||||
|
assert_eq!(reload_generation_value(), before + 1);
|
||||||
|
assert_eq!(cached_probe(), Some(report));
|
||||||
|
assert!(reload_since_session(before, reload_generation_value()));
|
||||||
|
assert!(!reload_since_session(reload_generation_value(), reload_generation_value()));
|
||||||
|
clear_probe();
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn probe_finish_is_not_a_reload_since_the_session_snapshot() {
|
||||||
|
let _reload = RELOAD_TEST_LOCK.lock().unwrap_or_else(|e| e.into_inner());
|
||||||
|
let at_session = reload_generation_value();
|
||||||
|
// A finished background probe updates the cache only. It does not bump the generation.
|
||||||
|
assert!(!reload_since_session(at_session, reload_generation_value()));
|
||||||
|
notify_reload();
|
||||||
|
assert!(reload_since_session(at_session, reload_generation_value()));
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn mark_reload_seen_clears_has_changed() {
|
||||||
|
let _reload = RELOAD_TEST_LOCK.lock().unwrap_or_else(|e| e.into_inner());
|
||||||
|
let rt = tokio::runtime::Builder::new_current_thread().enable_all().build().unwrap();
|
||||||
|
rt.block_on(async {
|
||||||
|
let mut watch = subscribe_reload();
|
||||||
|
let _ = watch.borrow_and_update();
|
||||||
|
publish_reload();
|
||||||
|
assert!(watch.has_changed().unwrap());
|
||||||
|
let _ = watch.borrow_and_update();
|
||||||
|
assert!(!watch.has_changed().unwrap());
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
/// Codec at CONTROL open is `preferred_codec_for` on the session snapshot.
|
/// Codec at CONTROL open is `preferred_codec_for` on the session snapshot.
|
||||||
/// Auto + CPU uses H.264 when both codecs are negotiated; auto + NVENC keeps H.265.
|
/// Auto + CPU uses H.264 when both codecs are negotiated; auto + NVENC keeps H.265.
|
||||||
/// Forced codec ignores the encoder. 真彩 does not switch codec (true_color_keeps_codec_and_vaapi_reports_420).
|
/// Forced codec ignores the encoder. 真彩 does not switch codec (true_color_keeps_codec_and_vaapi_reports_420).
|
||||||
|
|||||||
@@ -78,7 +78,7 @@ async fn exercise(fail_wake: usize, fail_capture: bool) {
|
|||||||
let (settings_tx, settings_rx) = tokio::sync::watch::channel(settings);
|
let (settings_tx, settings_rx) = tokio::sync::watch::channel(settings);
|
||||||
let selection = crate::video_select::resolve_pair(Some("cpu"), None, Some("h264"), None, false, None);
|
let selection = crate::video_select::resolve_pair(Some("cpu"), None, Some("h264"), None, false, None);
|
||||||
let mut task = tokio::spawn(stream_desktop(host.clone(), track.clone(), (640, 480),
|
let mut task = tokio::spawn(stream_desktop(host.clone(), track.clone(), (640, 480),
|
||||||
DISPLAY.into(), None, settings_rx, Arc::new(settings_tx), Arc::new(AtomicBool::new(false)), selection));
|
DISPLAY.into(), None, settings_rx, Arc::new(settings_tx), Arc::new(AtomicBool::new(false)), selection, None));
|
||||||
let result = if fail_capture {
|
let result = if fail_capture {
|
||||||
Some((&mut task).await.unwrap())
|
Some((&mut task).await.unwrap())
|
||||||
} else {
|
} else {
|
||||||
|
|||||||
@@ -37,7 +37,7 @@ impl Decoder for Ffmpeg {
|
|||||||
let mut rgb=av::frame::Video::empty();scaler.run(&decoded,&mut rgb).map_err(|_|"Frame conversion failed")?;
|
let mut rgb=av::frame::Video::empty();scaler.run(&decoded,&mut rgb).map_err(|_|"Frame conversion failed")?;
|
||||||
let mut data=Vec::with_capacity(w as usize*h as usize*3);
|
let mut data=Vec::with_capacity(w as usize*h as usize*3);
|
||||||
for row in 0..h as usize {let start=row*rgb.stride(0);data.extend_from_slice(&rgb.data(0)[start..start+w as usize*3]);}
|
for row in 0..h as usize {let start=row*rgb.stride(0);data.extend_from_slice(&rgb.data(0)[start..start+w as usize*3]);}
|
||||||
frames.push(Frame{width:w,height:h,rgb:data});
|
frames.push(Frame{width:w,height:h,rgb:data,content:None});
|
||||||
} Ok(frames)
|
} Ok(frames)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -1,13 +1,16 @@
|
|||||||
//! H.264/H.265 decoding through an external `ffmpeg` process, like the host's encoder pipeline.
|
//! H.264/H.265 decoding through an external `ffmpeg` process, like the host's encoder pipeline.
|
||||||
//! Needs only the ffmpeg CLI, not FFmpeg development libraries.
|
//! Needs only the ffmpeg CLI, not FFmpeg development libraries.
|
||||||
//! Output is scaled into a fixed letterboxed size so every frame has a known byte length.
|
//! Output is scaled into a fixed letterboxed canvas so every frame has a known byte length; the
|
||||||
|
//! source size from ffmpeg's stream line tells the window which sub-rectangle is picture content.
|
||||||
use super::desktop::{Decoder,Frame};
|
use super::desktop::{Decoder,Frame};
|
||||||
use super::media::Codec;
|
use super::media::Codec;
|
||||||
use std::io::{Read,Write};
|
use std::io::{BufRead,Read,Write};
|
||||||
use std::process::{Child,ChildStdin,Command,Stdio};
|
use std::process::{Child,ChildStdin,Command,Stdio};
|
||||||
|
use std::sync::Arc;
|
||||||
|
use std::sync::atomic::{AtomicU64,Ordering};
|
||||||
use std::sync::mpsc::{Receiver,TryRecvError};
|
use std::sync::mpsc::{Receiver,TryRecvError};
|
||||||
|
|
||||||
pub struct Cli { child:Child, input:Option<ChildStdin>, codec:Codec, frames:Receiver<Vec<u8>>, width:u32, height:u32 }
|
pub struct Cli { child:Child, input:Option<ChildStdin>, codec:Codec, frames:Receiver<Vec<u8>>, width:u32, height:u32, source:Arc<AtomicU64> }
|
||||||
|
|
||||||
impl Cli {
|
impl Cli {
|
||||||
/// `UU_VIEWER_SIZE=WxH` picks the decoded size (default 1920x1080); `UU_VIEWER_FFMPEG` the binary.
|
/// `UU_VIEWER_SIZE=WxH` picks the decoded size (default 1920x1080); `UU_VIEWER_FFMPEG` the binary.
|
||||||
@@ -23,16 +26,27 @@ impl Cli {
|
|||||||
let filter=format!("scale={width}:{height}:force_original_aspect_ratio=decrease,pad={width}:{height}:(ow-iw)/2:(oh-ih)/2");
|
let filter=format!("scale={width}:{height}:force_original_aspect_ratio=decrease,pad={width}:{height}:(ow-iw)/2:(oh-ih)/2");
|
||||||
let passthrough=passthrough_args(&ffmpeg);
|
let passthrough=passthrough_args(&ffmpeg);
|
||||||
let mut child=Command::new(&ffmpeg)
|
let mut child=Command::new(&ffmpeg)
|
||||||
.args(["-hide_banner","-loglevel","error","-nostdin","-threads","1","-probesize","32","-analyzeduration","0",
|
.args(["-hide_banner","-loglevel","info","-nostats","-nostdin","-threads","1","-probesize","32","-analyzeduration","0",
|
||||||
"-fflags","nobuffer","-flags","low_delay","-f",codec.demuxer(),"-i","pipe:0","-an","-vf",&filter,
|
"-fflags","nobuffer","-flags","low_delay","-f",codec.demuxer(),"-i","pipe:0","-an","-vf",&filter,
|
||||||
"-pix_fmt","rgb24",
|
"-pix_fmt","rgb24",
|
||||||
// Raw H.264/H.265 carries no timestamps; constant-rate output dropped almost every frame of
|
// Raw H.264/H.265 carries no timestamps; constant-rate output dropped almost every frame of
|
||||||
// the official Mac host's stream (270 → 2). Pass frames through unchanged.
|
// the official Mac host's stream (270 → 2). Pass frames through unchanged.
|
||||||
passthrough.0,passthrough.1,"-f","rawvideo","pipe:1"])
|
passthrough.0,passthrough.1,"-f","rawvideo","pipe:1"])
|
||||||
.stdin(Stdio::piped()).stdout(Stdio::piped()).stderr(Stdio::null())
|
.stdin(Stdio::piped()).stdout(Stdio::piped()).stderr(Stdio::piped())
|
||||||
.spawn().map_err(|e|format!("Start ffmpeg decoder: {e}"))?;
|
.spawn().map_err(|e|format!("Start ffmpeg decoder: {e}"))?;
|
||||||
let input=child.stdin.take().ok_or("ffmpeg stdin missing")?;
|
let input=child.stdin.take().ok_or("ffmpeg stdin missing")?;
|
||||||
let mut output=child.stdout.take().ok_or("ffmpeg stdout missing")?;
|
let mut output=child.stdout.take().ok_or("ffmpeg stdout missing")?;
|
||||||
|
// Source picture size from the one-time stream line; 0 until parsed. Only the numbers are kept.
|
||||||
|
let source=Arc::new(AtomicU64::new(0));
|
||||||
|
if let Some(stderr)=child.stderr.take() {
|
||||||
|
let source=source.clone();
|
||||||
|
let _=std::thread::Builder::new().name("uu-viewer-ffmpeg-info".into()).spawn(move||{
|
||||||
|
for line in std::io::BufReader::new(stderr).lines().map_while(Result::ok) {
|
||||||
|
if source.load(Ordering::Relaxed)!=0 {continue}
|
||||||
|
if let Some((w,h))=parse_video_size(&line) {source.store((u64::from(w)<<32)|u64::from(h),Ordering::Relaxed);}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
let size=width as usize*height as usize*3;
|
let size=width as usize*height as usize*3;
|
||||||
// Bounded: a slow window drops decoded frames instead of growing memory.
|
// Bounded: a slow window drops decoded frames instead of growing memory.
|
||||||
let (tx,frames)=std::sync::mpsc::sync_channel(2);
|
let (tx,frames)=std::sync::mpsc::sync_channel(2);
|
||||||
@@ -43,10 +57,23 @@ impl Cli {
|
|||||||
match tx.try_send(frame) { Ok(())|Err(std::sync::mpsc::TrySendError::Full(_))=>{}, Err(_)=>break }
|
match tx.try_send(frame) { Ok(())|Err(std::sync::mpsc::TrySendError::Full(_))=>{}, Err(_)=>break }
|
||||||
}
|
}
|
||||||
}).map_err(|e|format!("Decoder reader: {e}"))?;
|
}).map_err(|e|format!("Decoder reader: {e}"))?;
|
||||||
Ok(Self{child,input:Some(input),codec,frames,width,height})
|
Ok(Self{child,input:Some(input),codec,frames,width,height,source})
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// `30000/1001`-style or display strings are irrelevant here: the first WxH on a `Video:` line is the
|
||||||
|
/// coded picture size, which is the aspect the scale+pad filter letterboxes into the canvas.
|
||||||
|
fn parse_video_size(line:&str)->Option<(u32,u32)> {
|
||||||
|
let rest=line.split_once("Video:")?.1;
|
||||||
|
rest.split(|c:char|c==','||c==' '||c=='('||c==')'||c=='['||c==']').find_map(|token|{
|
||||||
|
let token=token.trim_matches(|c:char|!c.is_ascii_digit()&&c!='x');
|
||||||
|
let (w,h)=token.split_once('x')?;
|
||||||
|
if w.is_empty()||h.is_empty()||!w.bytes().all(|b|b.is_ascii_digit())||!h.bytes().all(|b|b.is_ascii_digit()) {return None}
|
||||||
|
let (w,h)=(w.parse::<u32>().ok()?,h.parse::<u32>().ok()?);
|
||||||
|
((16..=16384).contains(&w)&&(16..=16384).contains(&h)).then_some((w,h))
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
/// FFmpeg ≥ 5.1 has `-fps_mode`; FFmpeg 8+ removed `-vsync`, and Ubuntu 22.04's 4.4 lacks `-fps_mode`.
|
/// FFmpeg ≥ 5.1 has `-fps_mode`; FFmpeg 8+ removed `-vsync`, and Ubuntu 22.04's 4.4 lacks `-fps_mode`.
|
||||||
/// Probe once per binary with a one-frame null run instead of parsing version strings.
|
/// Probe once per binary with a one-frame null run instead of parsing version strings.
|
||||||
fn passthrough_args(ffmpeg:&str)->(&'static str,&'static str) {
|
fn passthrough_args(ffmpeg:&str)->(&'static str,&'static str) {
|
||||||
@@ -75,7 +102,11 @@ impl Decoder for Cli {
|
|||||||
let mut out=Vec::new();
|
let mut out=Vec::new();
|
||||||
loop {
|
loop {
|
||||||
match self.frames.try_recv() {
|
match self.frames.try_recv() {
|
||||||
Ok(rgb)=>out.push(Frame{width:self.width,height:self.height,rgb}),
|
Ok(rgb)=>{
|
||||||
|
let source=self.source.load(Ordering::Relaxed);
|
||||||
|
let content=(source!=0).then(||((source>>32) as u32,source as u32));
|
||||||
|
out.push(Frame{width:self.width,height:self.height,rgb,content})
|
||||||
|
},
|
||||||
Err(TryRecvError::Empty)=>break,
|
Err(TryRecvError::Empty)=>break,
|
||||||
Err(TryRecvError::Disconnected)=>return Err("ffmpeg decoder exited".into()),
|
Err(TryRecvError::Disconnected)=>return Err("ffmpeg decoder exited".into()),
|
||||||
}
|
}
|
||||||
@@ -115,7 +146,7 @@ impl Drop for Cli { fn drop(&mut self) { let _=self.child.kill(); let _=self.chi
|
|||||||
// Exercise the same streaming process and RGB conversion as SDL, then drain at EOF.
|
// Exercise the same streaming process and RGB conversion as SDL, then drain at EOF.
|
||||||
let mut frames=cli.decode(data).unwrap();drop(cli.input.take());
|
let mut frames=cli.decode(data).unwrap();drop(cli.input.take());
|
||||||
loop {match cli.frames.recv_timeout(std::time::Duration::from_secs(5)) {
|
loop {match cli.frames.recv_timeout(std::time::Duration::from_secs(5)) {
|
||||||
Ok(rgb)=>frames.push(Frame{width:32,height:32,rgb}),
|
Ok(rgb)=>frames.push(Frame{width:32,height:32,rgb,content:None}),
|
||||||
Err(std::sync::mpsc::RecvTimeoutError::Disconnected)=>break,
|
Err(std::sync::mpsc::RecvTimeoutError::Disconnected)=>break,
|
||||||
Err(e)=>panic!("{codec:?} decoder did not finish: {e}"),
|
Err(e)=>panic!("{codec:?} decoder did not finish: {e}"),
|
||||||
}}
|
}}
|
||||||
@@ -128,4 +159,11 @@ impl Drop for Cli { fn drop(&mut self) { let _=self.child.kill(); let _=self.chi
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
#[test] fn source_size_is_read_from_the_ffmpeg_stream_line(){
|
||||||
|
assert_eq!(super::parse_video_size(" Stream #0:0: Video: h264 (High), yuv420p(progressive), 3024x1964, 25 fps"),Some((3024,1964)));
|
||||||
|
assert_eq!(super::parse_video_size("Stream #0:0: Video: hevc, yuv420p, 1920x1080 [SAR 1:1 DAR 16:9]"),Some((1920,1080)));
|
||||||
|
assert_eq!(super::parse_video_size("Stream #0:0: Audio: opus, 48000 Hz, stereo"),None);
|
||||||
|
assert_eq!(super::parse_video_size("frame= 1 fps=0.0 q=0.0"),None);
|
||||||
|
assert_eq!(super::parse_video_size("Stream #0:0: Video: h264, 1920xsynth"),None);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
+14
-3
@@ -5,13 +5,20 @@ pub struct Desktop { pub units:Latest<super::media::AccessUnit>, pub pli:Arc<Ato
|
|||||||
impl Default for Desktop {
|
impl Default for Desktop {
|
||||||
fn default()->Self {Self{units:Latest::new(3),pli:Arc::new(AtomicBool::new(false)),reset:Arc::new(AtomicBool::new(false)),ssrc:Arc::new(AtomicU32::new(0))}}
|
fn default()->Self {Self{units:Latest::new(3),pli:Arc::new(AtomicBool::new(false)),reset:Arc::new(AtomicBool::new(false)),ssrc:Arc::new(AtomicU32::new(0))}}
|
||||||
}
|
}
|
||||||
pub struct Frame { pub width:u32, pub height:u32, pub rgb:Vec<u8> }
|
/// `content` is the source picture size inside the (possibly padded) RGB canvas; None = full frame.
|
||||||
|
pub struct Frame { pub width:u32, pub height:u32, pub rgb:Vec<u8>, pub content:Option<(u32,u32)> }
|
||||||
pub trait Decoder { fn set_codec(&mut self,codec:super::media::Codec)->Result<(),String>; fn decode(&mut self, au:&[u8])->Result<Vec<Frame>,String>; fn reset(&mut self); }
|
pub trait Decoder { fn set_codec(&mut self,codec:super::media::Codec)->Result<(),String>; fn decode(&mut self, au:&[u8])->Result<Vec<Frame>,String>; fn reset(&mut self); }
|
||||||
pub trait FrameSink { fn present(&mut self,frame:&Frame)->Result<(),String>; }
|
pub trait FrameSink { fn present(&mut self,frame:&Frame)->Result<(),String>; }
|
||||||
/// Counts only (access units, presented frames, decode errors) for the periodic stats line.
|
/// Counts only (access units, presented frames, decode errors) for the periodic stats line.
|
||||||
pub static STATS:[std::sync::atomic::AtomicU64;3]=[std::sync::atomic::AtomicU64::new(0),std::sync::atomic::AtomicU64::new(0),std::sync::atomic::AtomicU64::new(0)];
|
pub static STATS:[std::sync::atomic::AtomicU64;3]=[std::sync::atomic::AtomicU64::new(0),std::sync::atomic::AtomicU64::new(0),std::sync::atomic::AtomicU64::new(0)];
|
||||||
|
fn wants_key_frame(units:u64,presented:u64)->bool {presented==0 && units%30==0}
|
||||||
pub fn display(decoder:&mut dyn Decoder,sink:&mut dyn FrameSink,au:&[u8],codec:super::media::Codec,pli:&AtomicBool)->Result<(),String> {
|
pub fn display(decoder:&mut dyn Decoder,sink:&mut dyn FrameSink,au:&[u8],codec:super::media::Codec,pli:&AtomicBool)->Result<(),String> {
|
||||||
STATS[0].fetch_add(1,Ordering::Relaxed);
|
let units=STATS[0].fetch_add(1,Ordering::Relaxed)+1;
|
||||||
|
// A later session can join a clean stream with no IDR in flight (#124): keep asking until a frame shows.
|
||||||
|
if wants_key_frame(units,STATS[1].load(Ordering::Relaxed)) {
|
||||||
|
pli.store(true,Ordering::Release);
|
||||||
|
if units==300 { log::warn!("Viewer desktop: no decodable frame after {units} access units; requesting key frames (another session may hold the host)"); }
|
||||||
|
}
|
||||||
// Local diagnostic: UU_VIEWER_DUMP_H264=path appends the first 300 access units (owner's own stream).
|
// Local diagnostic: UU_VIEWER_DUMP_H264=path appends the first 300 access units (owner's own stream).
|
||||||
if codec==super::media::Codec::H264 && STATS[0].load(Ordering::Relaxed)<=300 { if let Some(path)=std::env::var_os("UU_VIEWER_DUMP_H264") {
|
if codec==super::media::Codec::H264 && STATS[0].load(Ordering::Relaxed)<=300 { if let Some(path)=std::env::var_os("UU_VIEWER_DUMP_H264") {
|
||||||
use std::io::Write; if let Ok(mut f)=std::fs::OpenOptions::new().create(true).append(true).open(path){let _=f.write_all(au);}
|
use std::io::Write; if let Ok(mut f)=std::fs::OpenOptions::new().create(true).append(true).open(path){let _=f.write_all(au);}
|
||||||
@@ -29,7 +36,11 @@ pub fn display(decoder:&mut dyn Decoder,sink:&mut dyn FrameSink,au:&[u8],codec:s
|
|||||||
}
|
}
|
||||||
#[cfg(test)] mod tests {
|
#[cfg(test)] mod tests {
|
||||||
use super::*;
|
use super::*;
|
||||||
struct Mock(bool);impl Decoder for Mock {fn set_codec(&mut self,_:crate::viewer::media::Codec)->Result<(),String>{Ok(())} fn decode(&mut self,_:&[u8])->Result<Vec<Frame>,String>{if self.0{Err("synthetic".into())}else{Ok(vec![Frame{width:1,height:1,rgb:vec![0;3]}])}} fn reset(&mut self){self.0=false;}}
|
struct Mock(bool);impl Decoder for Mock {fn set_codec(&mut self,_:crate::viewer::media::Codec)->Result<(),String>{Ok(())} fn decode(&mut self,_:&[u8])->Result<Vec<Frame>,String>{if self.0{Err("synthetic".into())}else{Ok(vec![Frame{width:1,height:1,rgb:vec![0;3],content:None}])}} fn reset(&mut self){self.0=false;}}
|
||||||
struct Sink(usize);impl FrameSink for Sink{fn present(&mut self,f:&Frame)->Result<(),String>{assert_eq!(f.rgb.len(),3);self.0+=1;Ok(())}}
|
struct Sink(usize);impl FrameSink for Sink{fn present(&mut self,f:&Frame)->Result<(),String>{assert_eq!(f.rgb.len(),3);self.0+=1;Ok(())}}
|
||||||
|
#[test] fn requests_key_frames_until_the_first_frame(){
|
||||||
|
assert_eq!((1..=90).filter(|&n|wants_key_frame(n,0)).count(),3);
|
||||||
|
assert!(!(1..=90).any(|n|wants_key_frame(n,1)));
|
||||||
|
}
|
||||||
#[test] fn decode_error_requests_pli_and_recovers(){let mut d=Mock(true);let mut s=Sink(0);let p=AtomicBool::new(false);display(&mut d,&mut s,&[],crate::viewer::media::Codec::H264,&p).unwrap();assert!(p.load(Ordering::Acquire));display(&mut d,&mut s,&[],crate::viewer::media::Codec::H264,&p).unwrap();assert_eq!(s.0,1);}
|
#[test] fn decode_error_requests_pli_and_recovers(){let mut d=Mock(true);let mut s=Sink(0);let p=AtomicBool::new(false);display(&mut d,&mut s,&[],crate::viewer::media::Codec::H264,&p).unwrap();assert!(p.load(Ordering::Acquire));display(&mut d,&mut s,&[],crate::viewer::media::Codec::H264,&p).unwrap();assert_eq!(s.0,1);}
|
||||||
}
|
}
|
||||||
@@ -35,6 +35,15 @@ pub fn mac_keycode(scan:i32)->Option<i32>{
|
|||||||
_=>return None,
|
_=>return None,
|
||||||
})
|
})
|
||||||
}
|
}
|
||||||
|
/// The content rectangle inside a decoder canvas padded to a fixed size (ffmpeg's scale+pad).
|
||||||
|
/// Mirrors `force_original_aspect_ratio=decrease,pad=…:(ow-iw)/2:(oh-ih)/2` so pointer input
|
||||||
|
/// ignores the padding instead of compressing the valid area.
|
||||||
|
pub fn content_rect(canvas:(u32,u32),content:(u32,u32))->Option<(f64,f64,f64,f64)> {
|
||||||
|
if canvas.0==0||canvas.1==0||content.0==0||content.1==0 {return None}
|
||||||
|
let scale=(canvas.0 as f64/content.0 as f64).min(canvas.1 as f64/content.1 as f64);
|
||||||
|
let(w,h)=(content.0 as f64*scale,content.1 as f64*scale);
|
||||||
|
Some(((canvas.0 as f64-w)/2.,(canvas.1 as f64-h)/2.,w,h))
|
||||||
|
}
|
||||||
#[derive(Clone,Copy,Debug,PartialEq)]
|
#[derive(Clone,Copy,Debug,PartialEq)]
|
||||||
pub struct Viewport { pub x:f64, pub y:f64, pub width:f64, pub height:f64 }
|
pub struct Viewport { pub x:f64, pub y:f64, pub width:f64, pub height:f64 }
|
||||||
impl Viewport {
|
impl Viewport {
|
||||||
@@ -75,6 +84,14 @@ impl Input {
|
|||||||
let changed=if down{self.buttons.insert(button)}else{self.buttons.remove(&button)};
|
let changed=if down{self.buttons.insert(button)}else{self.buttons.remove(&button)};
|
||||||
changed.then(||json!({"action":if down{"mouse_press"}else{"mouse_release"},"button":button}))
|
changed.then(||json!({"action":if down{"mouse_press"}else{"mouse_release"},"button":button}))
|
||||||
}
|
}
|
||||||
|
/// SDL wheel units are notches; the wire uses the Mac convention (one notch = 120).
|
||||||
|
/// Positive y is wheel-up, matching the host's `mouse_scroll` (button 4).
|
||||||
|
pub fn scroll(&mut self,x:f64,y:f64)->Option<Value> {
|
||||||
|
if self.view_only {return None}
|
||||||
|
let(dx,dy)=((x*120.).round() as i32,(y*120.).round() as i32);
|
||||||
|
if dx==0&&dy==0 {return None}
|
||||||
|
Some(json!({"action":"mouse_scroll","delta_x":dx,"delta_y":dy}))
|
||||||
|
}
|
||||||
pub fn release_all(&mut self)->Vec<Value> {
|
pub fn release_all(&mut self)->Vec<Value> {
|
||||||
let mut out=Vec::new();
|
let mut out=Vec::new();
|
||||||
for key in std::mem::take(&mut self.keys).into_values().collect::<BTreeSet<_>>() {out.push(json!({"action":"kbd_release","key":key}));}
|
for key in std::mem::take(&mut self.keys).into_values().collect::<BTreeSet<_>>() {out.push(json!({"action":"kbd_release","key":key}));}
|
||||||
@@ -117,6 +134,15 @@ impl Input {
|
|||||||
assert!(view_only(None,Some("1")).unwrap());assert!(view_only(Some("--view-only"),Some("0")).unwrap());
|
assert!(view_only(None,Some("1")).unwrap());assert!(view_only(Some("--view-only"),Some("0")).unwrap());
|
||||||
assert!(view_only(Some("invalid"),None).is_err());
|
assert!(view_only(Some("invalid"),None).is_err());
|
||||||
}
|
}
|
||||||
|
#[test] fn wheel_notches_use_mac_wire_units(){
|
||||||
|
let mut i=Input::default();
|
||||||
|
assert_eq!(i.scroll(0.,1.).unwrap(),json!({"action":"mouse_scroll","delta_x":0,"delta_y":120}));
|
||||||
|
assert_eq!(i.scroll(0.,-1.).unwrap()["delta_y"],-120);
|
||||||
|
assert_eq!(i.scroll(1.,-2.).unwrap(),json!({"action":"mouse_scroll","delta_x":120,"delta_y":-240}));
|
||||||
|
assert_eq!(i.scroll(0.,0.1).unwrap()["delta_y"],12); // precise trackpad deltas
|
||||||
|
assert!(i.scroll(0.,0.).is_none());
|
||||||
|
assert!(Input::new(true).scroll(0.,1.).is_none());
|
||||||
|
}
|
||||||
#[test] fn mappings_encoding_and_focus() {
|
#[test] fn mappings_encoding_and_focus() {
|
||||||
for (scan,vk) in [(4,65),(29,90),(39,48),(58,112),(80,37),(224,162),(230,165),(52,222)] {assert_eq!(windows_vk(scan),Some(vk));}
|
for (scan,vk) in [(4,65),(29,90),(39,48),(58,112),(80,37),(224,162),(230,165),(52,222)] {assert_eq!(windows_vk(scan),Some(vk));}
|
||||||
assert_eq!(windows_vk(100),None);
|
assert_eq!(windows_vk(100),None);
|
||||||
@@ -138,4 +164,21 @@ assert!(i.release_all().is_empty());
|
|||||||
assert_eq!(v.motion(1010.,1000.).unwrap()["abs_x"],1.0);
|
assert_eq!(v.motion(1010.,1000.).unwrap()["abs_x"],1.0);
|
||||||
assert!(v.motion(f64::NAN,0.).is_none());
|
assert!(v.motion(f64::NAN,0.).is_none());
|
||||||
}
|
}
|
||||||
|
#[test] fn padded_canvas_maps_only_its_content_rectangle(){
|
||||||
|
// 16:10 picture inside the default 16:9 canvas: 1728x1080 centred, 96 px pillarbox each side.
|
||||||
|
assert_eq!(content_rect((1920,1080),(1280,800)),Some((96.,0.,1728.,1080.)));
|
||||||
|
assert_eq!(content_rect((1920,1080),(1920,1080)),Some((0.,0.,1920.,1080.)));
|
||||||
|
// 4:3 picture: 1440x1080 centred, 240 px each side.
|
||||||
|
assert_eq!(content_rect((1920,1080),(640,480)),Some((240.,0.,1440.,1080.)));
|
||||||
|
assert_eq!(content_rect((0,1080),(640,480)),None);
|
||||||
|
// The content rectangle's edges are the screen edges, not the canvas edges.
|
||||||
|
let (x,y,w,h)=content_rect((1920,1080),(1280,800)).unwrap();
|
||||||
|
let v=Viewport::fit((1920,1080),(1280,800));
|
||||||
|
assert_eq!((x,y,w,h),(v.x,v.y,v.width,v.height));
|
||||||
|
let abs=|px:f64|v.motion(px,540.).unwrap();
|
||||||
|
assert_eq!(abs(96.)["abs_x"],0.0);
|
||||||
|
assert_eq!(abs(960.)["abs_x"],0.5);
|
||||||
|
assert_eq!(abs(1824.)["abs_x"],1.0);
|
||||||
|
assert_eq!(abs(0.)["abs_x"],0.0); // padding is clamped to the screen edge
|
||||||
|
}
|
||||||
}
|
}
|
||||||
+60
-9
@@ -8,7 +8,10 @@ impl Window {
|
|||||||
pub fn new()->Result<Self,String>{
|
pub fn new()->Result<Self,String>{
|
||||||
let sdl=sdl2::init()?;let video=sdl.video()?;
|
let sdl=sdl2::init()?;let video=sdl.video()?;
|
||||||
let window=video.window("Native viewer (experimental)",1280,720).position_centered().resizable().build().map_err(|_|"Window creation failed")?;
|
let window=video.window("Native viewer (experimental)",1280,720).position_centered().resizable().build().map_err(|_|"Window creation failed")?;
|
||||||
let canvas=window.into_canvas().build().map_err(|_|"Renderer creation failed")?;
|
let mut canvas=window.into_canvas().build().map_err(|_|"Renderer creation failed")?;
|
||||||
|
// Wayland maps a toplevel only after its first buffer; without this the window stays
|
||||||
|
// invisible until the first decoded frame, which a stalled stream never delivers.
|
||||||
|
canvas.set_draw_color(sdl2::pixels::Color::BLACK);canvas.clear();canvas.present();
|
||||||
let events=sdl.event_pump()?;let clipboard=video.clipboard();
|
let events=sdl.event_pump()?;let clipboard=video.clipboard();
|
||||||
let(clipboard_tx,clipboard_requests)=tokio::sync::mpsc::channel(16);
|
let(clipboard_tx,clipboard_requests)=tokio::sync::mpsc::channel(16);
|
||||||
Ok(Self{canvas,events,_sdl:sdl,frame:(1920,1080),focused:true,files:false,mac:false,clipboard,clipboard_dirty:true,clipboard_tx,clipboard_requests,last_frame:None})
|
Ok(Self{canvas,events,_sdl:sdl,frame:(1920,1080),focused:true,files:false,mac:false,clipboard,clipboard_dirty:true,clipboard_tx,clipboard_requests,last_frame:None})
|
||||||
@@ -38,11 +41,32 @@ impl Window {
|
|||||||
}
|
}
|
||||||
pub fn poll(&mut self,input:&mut Input)->(bool,Vec<serde_json::Value>){
|
pub fn poll(&mut self,input:&mut Input)->(bool,Vec<serde_json::Value>){
|
||||||
let viewport=self.viewport();
|
let viewport=self.viewport();
|
||||||
let dirty=&mut self.clipboard_dirty;
|
let dirty=&mut self.clipboard_dirty;let mut redraw=false;
|
||||||
let events=self.events.poll_iter().inspect(|event|{
|
let events=self.events.poll_iter().inspect(|event|{
|
||||||
if matches!(event,Event::ClipboardUpdate{..}|Event::Window{win_event:WindowEvent::FocusGained,..}){*dirty=true;}
|
if matches!(event,Event::ClipboardUpdate{..}|Event::Window{win_event:WindowEvent::FocusGained,..}){*dirty=true;}
|
||||||
|
redraw|=needs_redraw(event);
|
||||||
});
|
});
|
||||||
translate_actions(events,input,viewport,&mut self.focused,&mut self.files)
|
let result=translate_actions(events,input,viewport,&mut self.focused,&mut self.files);
|
||||||
|
// A compositor resize (tiling, maximize) leaves the surface without a buffer of the new size
|
||||||
|
// until the next frame; a static remote desktop sends none, so repaint the last frame now.
|
||||||
|
if redraw {if let Some(frame)=self.last_frame.take(){
|
||||||
|
log::debug!("Viewer window resized: {:?}",self.canvas.window().size());
|
||||||
|
if let Err(e)=self.draw(&frame){log::warn!("Viewer redraw failed: {e}");}
|
||||||
|
self.last_frame=Some(frame);
|
||||||
|
}else{self.canvas.set_draw_color(sdl2::pixels::Color::BLACK);self.canvas.clear();self.canvas.present();}}
|
||||||
|
result
|
||||||
|
}
|
||||||
|
fn draw(&mut self,frame:&Frame)->Result<(),String>{
|
||||||
|
// Pad bars belong to the decoded canvas, not the remote picture: viewport and input use the
|
||||||
|
// content aspect, and only the content sub-rectangle of the texture is drawn.
|
||||||
|
let content=frame.content.unwrap_or((frame.width,frame.height));
|
||||||
|
self.frame=content;let v=self.viewport();let creator=self.canvas.texture_creator();
|
||||||
|
let mut texture=creator.create_texture_streaming(PixelFormatEnum::RGB24,frame.width,frame.height).map_err(|_|"Texture creation failed")?;
|
||||||
|
texture.update(None,&frame.rgb,frame.width as usize*3).map_err(|_|"Texture update failed")?;
|
||||||
|
self.canvas.set_draw_color(sdl2::pixels::Color::BLACK);self.canvas.clear();
|
||||||
|
let src=super::input::content_rect((frame.width,frame.height),content)
|
||||||
|
.map(|(x,y,w,h)|Rect::new(x.round() as i32,y.round() as i32,w.round().max(1.) as u32,h.round().max(1.) as u32));
|
||||||
|
self.canvas.copy(&texture,src,Some(Rect::new(v.x.round() as i32,v.y.round() as i32,v.width.round().max(1.) as u32,v.height.round().max(1.) as u32)))?;self.canvas.present();Ok(())
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
fn clipboard_text(bytes:&[u8])->Option<String>{
|
fn clipboard_text(bytes:&[u8])->Option<String>{
|
||||||
@@ -81,20 +105,24 @@ fn translate_actions(events:impl IntoIterator<Item=Event>,input:&mut Input,viewp
|
|||||||
Event::MouseMotion{x,y,..}=>viewport.motion(x as f64,y as f64),
|
Event::MouseMotion{x,y,..}=>viewport.motion(x as f64,y as f64),
|
||||||
Event::MouseButtonDown{mouse_btn,..}=>button(mouse_btn).and_then(|b|input.button(b,true)),
|
Event::MouseButtonDown{mouse_btn,..}=>button(mouse_btn).and_then(|b|input.button(b,true)),
|
||||||
Event::MouseButtonUp{mouse_btn,..}=>button(mouse_btn).and_then(|b|input.button(b,false)),
|
Event::MouseButtonUp{mouse_btn,..}=>button(mouse_btn).and_then(|b|input.button(b,false)),
|
||||||
|
Event::MouseWheel{x,y,precise_x,precise_y,direction,..}=>{
|
||||||
|
let(dx,dy)=if precise_x!=0.||precise_y!=0.{(f64::from(precise_x),f64::from(precise_y))}else{(f64::from(x),f64::from(y))};
|
||||||
|
let(dx,dy)=match direction{sdl2::mouse::MouseWheelDirection::Flipped=>(-dx,-dy),_=>(dx,dy)};
|
||||||
|
input.scroll(dx,dy)
|
||||||
|
},
|
||||||
_=>None,
|
_=>None,
|
||||||
};if let Some(m)=message{messages.push(m);}
|
};if let Some(m)=message{messages.push(m);}
|
||||||
} (quit,messages)
|
} (quit,messages)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
fn needs_redraw(event:&Event)->bool{
|
||||||
|
matches!(event,Event::Window{win_event:WindowEvent::SizeChanged(..)|WindowEvent::Resized(..)|WindowEvent::Exposed|WindowEvent::Maximized|WindowEvent::Restored,..})
|
||||||
|
}
|
||||||
fn button(b:MouseButton)->Option<i32>{match b{MouseButton::Left=>Some(1),MouseButton::Right=>Some(2),MouseButton::Middle=>Some(4),_=>None}}
|
fn button(b:MouseButton)->Option<i32>{match b{MouseButton::Left=>Some(1),MouseButton::Right=>Some(2),MouseButton::Middle=>Some(4),_=>None}}
|
||||||
impl FrameSink for Window {
|
impl FrameSink for Window {
|
||||||
fn present(&mut self,frame:&Frame)->Result<(),String>{
|
fn present(&mut self,frame:&Frame)->Result<(),String>{
|
||||||
self.last_frame=Some(Frame{width:frame.width,height:frame.height,rgb:frame.rgb.clone()});
|
self.last_frame=Some(Frame{width:frame.width,height:frame.height,rgb:frame.rgb.clone(),content:frame.content});
|
||||||
self.frame=(frame.width,frame.height);let v=self.viewport();let creator=self.canvas.texture_creator();
|
self.draw(frame)
|
||||||
let mut texture=creator.create_texture_streaming(PixelFormatEnum::RGB24,frame.width,frame.height).map_err(|_|"Texture creation failed")?;
|
|
||||||
texture.update(None,&frame.rgb,frame.width as usize*3).map_err(|_|"Texture update failed")?;
|
|
||||||
self.canvas.set_draw_color(sdl2::pixels::Color::BLACK);self.canvas.clear();
|
|
||||||
self.canvas.copy(&texture,None,Some(Rect::new(v.x as i32,v.y as i32,v.width as u32,v.height as u32)))?;self.canvas.present();Ok(())
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
pub async fn run(session:&mut Session,window:&mut Window,decoder:&mut dyn super::desktop::Decoder,view_only:bool,device:&str)->Result<(),String>{
|
pub async fn run(session:&mut Session,window:&mut Window,decoder:&mut dyn super::desktop::Decoder,view_only:bool,device:&str)->Result<(),String>{
|
||||||
@@ -432,6 +460,29 @@ async fn pump_type_job(job: &mut TypeJob, session: &mut Session, window: &mut Wi
|
|||||||
assert!(input.release_all().is_empty());
|
assert!(input.release_all().is_empty());
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
#[test] fn compositor_resize_and_expose_repaint_the_last_frame(){
|
||||||
|
let w=|win_event|Event::Window{timestamp:0,window_id:1,win_event};
|
||||||
|
for e in [WindowEvent::SizeChanged(1280,800),WindowEvent::Resized(1280,800),WindowEvent::Exposed,WindowEvent::Maximized,WindowEvent::Restored]{assert!(needs_redraw(&w(e)));}
|
||||||
|
for e in [WindowEvent::FocusGained,WindowEvent::Moved(0,0)]{assert!(!needs_redraw(&w(e)));}
|
||||||
|
}
|
||||||
|
#[test] fn wheel_events_become_scroll_messages(){
|
||||||
|
use sdl2::mouse::MouseWheelDirection;
|
||||||
|
let mut input=Input::default();let mut focused=true;
|
||||||
|
let v=Viewport::fit((800,600),(1920,1080));
|
||||||
|
let wheel=|direction,x,y|Event::MouseWheel{timestamp:0,window_id:1,which:0,mouse_x:0,mouse_y:0,x,y,precise_x:0.,precise_y:0.,direction};
|
||||||
|
let(_,out)=translate([wheel(MouseWheelDirection::Normal,0,1),wheel(MouseWheelDirection::Flipped,0,1),wheel(MouseWheelDirection::Normal,0,0)],&mut input,v,&mut focused);
|
||||||
|
assert_eq!(out.len(),2);
|
||||||
|
assert_eq!(out[0]["action"],"mouse_scroll");
|
||||||
|
assert_eq!(out[0]["delta_y"],120);
|
||||||
|
assert_eq!(out[1]["delta_y"],-120);
|
||||||
|
// Trackpads report fractional precise deltas; a quarter notch is 30 wire units.
|
||||||
|
let precise=Event::MouseWheel{timestamp:0,window_id:1,which:0,mouse_x:0,mouse_y:0,x:0,y:0,precise_x:0.,precise_y:-0.25,direction:MouseWheelDirection::Normal};
|
||||||
|
let(_,out)=translate([precise],&mut input,v,&mut focused);
|
||||||
|
assert_eq!(out[0]["delta_y"],-30);
|
||||||
|
let mut watch=Input::new(true);let mut watching=true;
|
||||||
|
let(_,out)=translate([wheel(MouseWheelDirection::Normal,0,1)],&mut watch,v,&mut watching);
|
||||||
|
assert!(out.is_empty());
|
||||||
|
}
|
||||||
#[test] fn watch_events_never_emit_input_and_still_close(){
|
#[test] fn watch_events_never_emit_input_and_still_close(){
|
||||||
let mut input=Input::new(true);let mut focused=true;
|
let mut input=Input::new(true);let mut focused=true;
|
||||||
assert!(input.key(4,true).is_none());assert!(input.button(1,true).is_none());assert!(!input.enabled());
|
assert!(input.key(4,true).is_none());assert!(input.button(1,true).is_none());assert!(!input.enabled());
|
||||||
|
|||||||
@@ -3,13 +3,11 @@
|
|||||||
use base64::Engine as _;
|
use base64::Engine as _;
|
||||||
use futures_util::{SinkExt, StreamExt};
|
use futures_util::{SinkExt, StreamExt};
|
||||||
use serde_json::Value;
|
use serde_json::Value;
|
||||||
use tokio::net::TcpStream;
|
|
||||||
use tokio_tungstenite::{connect_async, MaybeTlsStream, WebSocketStream};
|
|
||||||
use tokio_tungstenite::tungstenite::{client::IntoClientRequest, Message};
|
use tokio_tungstenite::tungstenite::{client::IntoClientRequest, Message};
|
||||||
use std::{collections::VecDeque,time::Duration};
|
use std::{collections::VecDeque,time::Duration};
|
||||||
|
|
||||||
pub struct Signal {
|
pub struct Signal {
|
||||||
ws: WebSocketStream<MaybeTlsStream<TcpStream>>,
|
ws: crate::ws_transport::Socket,
|
||||||
next_ack:u64,
|
next_ack:u64,
|
||||||
pending:VecDeque<Value>,
|
pending:VecDeque<Value>,
|
||||||
legacy_prefix:bool,
|
legacy_prefix:bool,
|
||||||
@@ -17,14 +15,14 @@ pub struct Signal {
|
|||||||
impl Signal {
|
impl Signal {
|
||||||
pub async fn connect(urls:&[String], token:&str, timeout:Duration, legacy_prefix:bool)->Result<Self,String> {
|
pub async fn connect(urls:&[String], token:&str, timeout:Duration, legacy_prefix:bool)->Result<Self,String> {
|
||||||
for url in urls {
|
for url in urls {
|
||||||
if let Ok(Ok(signal))=tokio::time::timeout(timeout,Self::one(url,token,legacy_prefix)).await {return Ok(signal)}
|
if let Ok(Ok(signal))=tokio::time::timeout(timeout,Self::one(url,token,legacy_prefix,timeout)).await {return Ok(signal)}
|
||||||
}
|
}
|
||||||
Err("Signaling connection failed (details omitted)".into())
|
Err("Signaling connection failed (details omitted)".into())
|
||||||
}
|
}
|
||||||
async fn one(url:&str,token:&str,legacy_prefix:bool)->Result<Self,String> {
|
async fn one(url:&str,token:&str,legacy_prefix:bool,timeout:Duration)->Result<Self,String> {
|
||||||
let mut request=format!("{}/socket.io/?transport=websocket&EIO=4",url.trim_end_matches('/')).into_client_request().map_err(|_|"Invalid signaling endpoint")?;
|
let mut request=format!("{}/socket.io/?transport=websocket&EIO=4",url.trim_end_matches('/')).into_client_request().map_err(|_|"Invalid signaling endpoint")?;
|
||||||
request.headers_mut().insert("X-NRD-AUTH",token.parse().map_err(|_|"Invalid room authentication header")?);
|
request.headers_mut().insert("X-NRD-AUTH",token.parse().map_err(|_|"Invalid room authentication header")?);
|
||||||
let (ws,_)=connect_async(request).await.map_err(|_|"Signaling transport failed")?;
|
let ws=crate::ws_transport::connect(request,timeout).await?;
|
||||||
let mut s=Self{ws,next_ack:10,pending:VecDeque::new(),legacy_prefix};
|
let mut s=Self{ws,next_ack:10,pending:VecDeque::new(),legacy_prefix};
|
||||||
let mut opened=false;
|
let mut opened=false;
|
||||||
loop {
|
loop {
|
||||||
|
|||||||
@@ -3,6 +3,7 @@
|
|||||||
#[path = "auth.rs"] mod auth;
|
#[path = "auth.rs"] mod auth;
|
||||||
#[path = "config.rs"] mod config;
|
#[path = "config.rs"] mod config;
|
||||||
#[path = "protocol.rs"] mod protocol;
|
#[path = "protocol.rs"] mod protocol;
|
||||||
|
mod ws_transport;
|
||||||
mod viewer;
|
mod viewer;
|
||||||
#[cfg(test)] #[path="hevc.rs"] mod hevc;
|
#[cfg(test)] #[path="hevc.rs"] mod hevc;
|
||||||
use viewer::clipboard;
|
use viewer::clipboard;
|
||||||
|
|||||||
+136
-9
@@ -204,11 +204,13 @@ pub fn text_probe()->Result<(),String> {
|
|||||||
Ok(())
|
Ok(())
|
||||||
}
|
}
|
||||||
|
|
||||||
// Opt-in single-track monitor switching for Hyprland. The existing native engine owns
|
// Opt-in single-track monitor switching: Hyprland outputs (UU_WAYLAND_MULTISCREEN) or X11 RandR
|
||||||
// capture/pointer binding; no compositor layout or user credentials are modified.
|
// monitors (UU_X11_MULTISCREEN). The existing engines own capture/pointer binding; X11 crops the
|
||||||
|
// root to the selected monitor. No compositor layout or user credentials are modified.
|
||||||
#[derive(Clone, Debug)]
|
#[derive(Clone, Debug)]
|
||||||
pub struct Output { pub name:String, pub width:u32, pub height:u32, pub fps:i32 }
|
pub struct Output { pub name:String, pub width:u32, pub height:u32, pub fps:i32, pub x:i32, pub y:i32 }
|
||||||
static OUTPUTS: std::sync::OnceLock<Vec<Output>> = std::sync::OnceLock::new();
|
struct Inventory { outputs:Vec<Output>, x11:bool }
|
||||||
|
static OUTPUTS: std::sync::OnceLock<Inventory> = std::sync::OnceLock::new();
|
||||||
#[derive(Default)]
|
#[derive(Default)]
|
||||||
struct Selection { id:usize, generation:u64, presented:Option<u64>, failed:bool }
|
struct Selection { id:usize, generation:u64, presented:Option<u64>, failed:bool }
|
||||||
impl Selection {
|
impl Selection {
|
||||||
@@ -221,19 +223,77 @@ impl Selection {
|
|||||||
fn ready(&self)->bool {self.presented==Some(self.generation)}
|
fn ready(&self)->bool {self.presented==Some(self.generation)}
|
||||||
}
|
}
|
||||||
static SELECTION:std::sync::Mutex<Selection>=std::sync::Mutex::new(Selection {id:0,generation:0,presented:None,failed:false});
|
static SELECTION:std::sync::Mutex<Selection>=std::sync::Mutex::new(Selection {id:0,generation:0,presented:None,failed:false});
|
||||||
pub fn outputs() -> &'static [Output] {
|
fn inventory() -> &'static Inventory {
|
||||||
OUTPUTS.get_or_init(|| {
|
OUTPUTS.get_or_init(|| {
|
||||||
|
let backend=crate::desktop_backend::detect().ok();
|
||||||
|
if backend==Some(crate::desktop_backend::DesktopBackend::X11) && !crate::desktop_backend::headless()
|
||||||
|
&& std::env::var("UU_X11_MULTISCREEN").ok().as_deref()==Some("1") {
|
||||||
|
let outputs=x11_outputs();
|
||||||
|
return Inventory {x11:!outputs.is_empty(),outputs};
|
||||||
|
}
|
||||||
if !cfg!(all(target_os="linux",feature="wayland"))
|
if !cfg!(all(target_os="linux",feature="wayland"))
|
||||||
|| std::env::var("UU_WAYLAND_MULTISCREEN").ok().as_deref()!=Some("1")
|
|| std::env::var("UU_WAYLAND_MULTISCREEN").ok().as_deref()!=Some("1")
|
||||||
|| crate::desktop_backend::detect().ok()!=Some(crate::desktop_backend::DesktopBackend::Wayland) {return Vec::new();}
|
|| backend!=Some(crate::desktop_backend::DesktopBackend::Wayland) {return Inventory {outputs:Vec::new(),x11:false};}
|
||||||
let output=std::process::Command::new("hyprctl").args(["monitors","-j"]).output();
|
let output=std::process::Command::new("hyprctl").args(["monitors","-j"]).output();
|
||||||
let result=output.map_err(|_|"hyprctl unavailable").and_then(|output| {
|
let result=output.map_err(|_|"hyprctl unavailable").and_then(|output| {
|
||||||
if !output.status.success() {return Err("hyprctl failed");}
|
if !output.status.success() {return Err("hyprctl failed");}
|
||||||
parse_outputs(&output.stdout,&std::env::var("UU_WAYLAND_OUTPUT").unwrap_or_default())
|
parse_outputs(&output.stdout,&std::env::var("UU_WAYLAND_OUTPUT").unwrap_or_default())
|
||||||
});
|
});
|
||||||
match result {Ok(outputs)=>outputs,Err(reason)=>{log::warn!("Wayland multi-screen disabled: {}",reason);Vec::new()}}
|
let outputs=match result {Ok(outputs)=>outputs,Err(reason)=>{log::warn!("Wayland multi-screen disabled: {}",reason);Vec::new()}};
|
||||||
|
Inventory {outputs,x11:false}
|
||||||
})
|
})
|
||||||
}
|
}
|
||||||
|
pub fn outputs() -> &'static [Output] {&inventory().outputs}
|
||||||
|
/// X11 monitors are advertised: the stream captures the selected monitor's region of the root.
|
||||||
|
pub fn x11_multiscreen()->bool {inventory().x11}
|
||||||
|
/// Read once, like the Hyprland inventory: a changed monitor layout needs a host restart.
|
||||||
|
fn x11_outputs()->Vec<Output> {
|
||||||
|
let mut command=std::process::Command::new("xrandr");
|
||||||
|
if let Some(display)=crate::capture::x11_display().or_else(||std::env::var("DISPLAY").ok()).filter(|d|!d.is_empty()) {
|
||||||
|
command.arg("--display").arg(display);
|
||||||
|
}
|
||||||
|
let result=command.arg("--listmonitors").output().map_err(|_|"xrandr unavailable").and_then(|output| {
|
||||||
|
if !output.status.success() {return Err("xrandr failed");}
|
||||||
|
parse_x11_monitors(&String::from_utf8_lossy(&output.stdout),&std::env::var("UU_X11_OUTPUT").unwrap_or_default(),crate::video::display_fps() as i32)
|
||||||
|
});
|
||||||
|
match result {
|
||||||
|
Ok(outputs) if outputs.len()>=2=>{log::info!("X11 multi-screen: {} monitors",outputs.len());outputs},
|
||||||
|
Ok(_)=>{log::warn!("X11 multi-screen disabled: fewer than two monitors");Vec::new()},
|
||||||
|
Err(reason)=>{log::warn!("X11 multi-screen disabled: {}",reason);Vec::new()},
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/// `xrandr --listmonitors`: ` 0: +*HDMI-0 1920/527x1080/296+1920+0 HDMI-0` (`*` = primary).
|
||||||
|
/// The preferred monitor (UU_X11_OUTPUT, else the primary) is id 0; the rest go left to right.
|
||||||
|
fn parse_x11_monitors(text:&str,preferred:&str,fps:i32)->Result<Vec<Output>,&'static str> {
|
||||||
|
fn geometry(text:&str)->Option<(u32,u32,i32,i32)> {
|
||||||
|
let (width,rest)=text.split_once('x')?;
|
||||||
|
let split=rest.find('+')?;
|
||||||
|
let (height,offsets)=rest.split_at(split);
|
||||||
|
let mut offsets=offsets[1..].split('+');
|
||||||
|
let size=|v:&str|v.split('/').next()?.parse::<u32>().ok();
|
||||||
|
let (x,y)=(offsets.next()?.parse::<i32>().ok()?,offsets.next()?.parse::<i32>().ok()?);
|
||||||
|
if offsets.next().is_some() || x<0 || y<0 {return None;}
|
||||||
|
Some((size(width)?,size(height)?,x,y))
|
||||||
|
}
|
||||||
|
let mut seen=std::collections::HashSet::new();
|
||||||
|
let mut primary=String::new();
|
||||||
|
let mut outputs=Vec::new();
|
||||||
|
for line in text.lines().skip(1) {
|
||||||
|
let mut fields=line.split_whitespace();
|
||||||
|
let (Some(_),Some(tag),Some(rect))=(fields.next(),fields.next(),fields.next()) else {continue};
|
||||||
|
let name=tag.trim_start_matches(['+','*']);
|
||||||
|
let Some((width,height,x,y))=geometry(rect) else {continue};
|
||||||
|
if name.is_empty() || name.len()>127 || !seen.insert(name.to_owned())
|
||||||
|
|| width<2 || height<2 || width>16384 || height>16384 || u64::from(width)*u64::from(height)*4>256*1024*1024 {continue;}
|
||||||
|
if tag.contains('*') {primary=name.to_owned();}
|
||||||
|
outputs.push(Output {name:name.into(),width,height,fps,x,y});
|
||||||
|
}
|
||||||
|
let first=if preferred.is_empty() {primary} else {preferred.to_owned()};
|
||||||
|
outputs.sort_by_key(|m| (m.name!=first,m.x,m.y));
|
||||||
|
outputs.truncate(16);
|
||||||
|
if outputs.is_empty() || (!preferred.is_empty() && outputs[0].name!=preferred) {return Err("No capturable preferred output");}
|
||||||
|
Ok(outputs)
|
||||||
|
}
|
||||||
fn parse_outputs(json:&[u8],preferred:&str)->Result<Vec<Output>,&'static str> {
|
fn parse_outputs(json:&[u8],preferred:&str)->Result<Vec<Output>,&'static str> {
|
||||||
let monitors=serde_json::from_slice::<Vec<serde_json::Value>>(json).map_err(|_|"Invalid monitor inventory")?;
|
let monitors=serde_json::from_slice::<Vec<serde_json::Value>>(json).map_err(|_|"Invalid monitor inventory")?;
|
||||||
let mut seen=std::collections::HashSet::new();
|
let mut seen=std::collections::HashSet::new();
|
||||||
@@ -244,7 +304,7 @@ fn parse_outputs(json:&[u8],preferred:&str)->Result<Vec<Output>,&'static str> {
|
|||||||
let height=u32::try_from(m["height"].as_u64()?).ok()?;
|
let height=u32::try_from(m["height"].as_u64()?).ok()?;
|
||||||
if name.is_empty() || name.len()>127 || name.contains('\0') || !seen.insert(name.to_owned())
|
if name.is_empty() || name.len()>127 || name.contains('\0') || !seen.insert(name.to_owned())
|
||||||
|| width<2 || height<2 || width>16384 || height>16384 || u64::from(width)*u64::from(height)*4>256*1024*1024 {return None;}
|
|| width<2 || height<2 || width>16384 || height>16384 || u64::from(width)*u64::from(height)*4>256*1024*1024 {return None;}
|
||||||
Some(Output {name:name.into(),width,height,fps:m["refreshRate"].as_f64()?.round().clamp(1.0,240.0) as i32})
|
Some(Output {name:name.into(),width,height,fps:m["refreshRate"].as_f64()?.round().clamp(1.0,240.0) as i32,x:0,y:0})
|
||||||
}).collect();
|
}).collect();
|
||||||
outputs.sort_by_key(|m| (m.name!=preferred,m.name.clone()));
|
outputs.sort_by_key(|m| (m.name!=preferred,m.name.clone()));
|
||||||
outputs.truncate(16);
|
outputs.truncate(16);
|
||||||
@@ -255,6 +315,35 @@ pub fn selection()->(usize,u64) {let s=SELECTION.lock().unwrap();(s.id,s.generat
|
|||||||
pub fn selected()->usize {selection().0}
|
pub fn selected()->usize {selection().0}
|
||||||
pub fn source(id:usize)->Option<&'static Output> {outputs().get(id)}
|
pub fn source(id:usize)->Option<&'static Output> {outputs().get(id)}
|
||||||
pub fn input_size(fallback:(u32,u32))->(u32,u32) {source(selected()).map_or(fallback,|s|(s.width,s.height))}
|
pub fn input_size(fallback:(u32,u32))->(u32,u32) {source(selected()).map_or(fallback,|s|(s.width,s.height))}
|
||||||
|
/// Region the encoder captures for this display: the Wayland output, or the selected X11 monitor.
|
||||||
|
pub fn capture_source(display:&str,portal:bool,id:usize)->Option<&'static Output> {
|
||||||
|
if display.starts_with("wayland:") || (!portal && !display.starts_with("kms:") && x11_multiscreen()) {source(id)} else {None}
|
||||||
|
}
|
||||||
|
/// Offset of the selected X11 monitor in the root: absolute input is relative to that monitor.
|
||||||
|
pub fn x11_placement()->Option<(i32,i32)> {
|
||||||
|
if !x11_multiscreen() {return None;}
|
||||||
|
source(selected()).map(|s|(s.x,s.y))
|
||||||
|
}
|
||||||
|
/// Pixel size of one advertised output. Unknown ids keep `fallback` (connection size).
|
||||||
|
pub fn source_size(id:usize,fallback:(u32,u32))->(u32,u32) {
|
||||||
|
#[cfg(test)]
|
||||||
|
if let Some(outputs)=*test_outputs().lock().unwrap_or_else(|e|e.into_inner()) {
|
||||||
|
return outputs.get(id).map_or(fallback,|s|(s.width,s.height));
|
||||||
|
}
|
||||||
|
source(id).map_or(fallback,|s|(s.width,s.height))
|
||||||
|
}
|
||||||
|
#[cfg(test)]
|
||||||
|
fn test_outputs()->&'static std::sync::Mutex<Option<&'static [Output]>> {
|
||||||
|
static SLOT:std::sync::OnceLock<std::sync::Mutex<Option<&'static [Output]>>>=std::sync::OnceLock::new();
|
||||||
|
SLOT.get_or_init(||std::sync::Mutex::new(None))
|
||||||
|
}
|
||||||
|
/// Native size written into CaptureSettingSync. Wayland uses the output the encoder is reading
|
||||||
|
/// (`source_id`), which can differ from the size captured when the connection opened; so does an
|
||||||
|
/// X11 monitor with UU_X11_MULTISCREEN. Otherwise X11, portal and KMS keep the connection size
|
||||||
|
/// (X11 mode changes go through `x11_resized`).
|
||||||
|
pub fn sync_native(display:&str,source_id:usize,connection:(u32,u32))->(u32,u32) {
|
||||||
|
if display.starts_with("wayland:") || (!display.starts_with("kms:") && x11_multiscreen()) {source_size(source_id,connection)} else {connection}
|
||||||
|
}
|
||||||
pub fn input_ready()->bool {outputs().is_empty() || SELECTION.lock().unwrap().ready()}
|
pub fn input_ready()->bool {outputs().is_empty() || SELECTION.lock().unwrap().ready()}
|
||||||
pub fn switch_failed()->bool {SELECTION.lock().unwrap().failed}
|
pub fn switch_failed()->bool {SELECTION.lock().unwrap().failed}
|
||||||
pub fn presented(id:usize,generation:u64) {SELECTION.lock().unwrap().sent(id,generation);}
|
pub fn presented(id:usize,generation:u64) {SELECTION.lock().unwrap().sent(id,generation);}
|
||||||
@@ -263,7 +352,12 @@ pub fn failed(id:usize,generation:u64) {
|
|||||||
if (state.id,state.generation)==(id,generation) {state.failed=true;}
|
if (state.id,state.generation)==(id,generation) {state.failed=true;}
|
||||||
}
|
}
|
||||||
pub fn select(id:usize)->Result<(),String> {
|
pub fn select(id:usize)->Result<(),String> {
|
||||||
let output=source(id).ok_or("Unknown Wayland screen")?;
|
let output=source(id).ok_or("Unknown screen")?;
|
||||||
|
if x11_multiscreen() {
|
||||||
|
SELECTION.lock().unwrap().begin(id);
|
||||||
|
log::info!("X11 screen selected: id={} source={}x{}+{}+{}",id,output.width,output.height,output.x,output.y);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
#[cfg(all(target_os="linux",feature="wayland"))]
|
#[cfg(all(target_os="linux",feature="wayland"))]
|
||||||
{
|
{
|
||||||
let name=std::ffi::CString::new(output.name.as_str()).map_err(|_|"Invalid output name")?;
|
let name=std::ffi::CString::new(output.name.as_str()).map_err(|_|"Invalid output name")?;
|
||||||
@@ -353,4 +447,37 @@ mod selection_regressions {
|
|||||||
assert_eq!(outputs.len(),1);assert_eq!(outputs[0].name,"normal");
|
assert_eq!(outputs.len(),1);assert_eq!(outputs[0].name,"normal");
|
||||||
assert!(parse_outputs(b"not JSON","").is_err());
|
assert!(parse_outputs(b"not JSON","").is_err());
|
||||||
}
|
}
|
||||||
|
#[test]
|
||||||
|
fn x11_monitors_keep_their_root_offsets() {
|
||||||
|
// #98: GNOME/X11, two 1920x1080 monitors side by side, primary on the right.
|
||||||
|
let text="Monitors: 2\n 0: +*HDMI-0 1920/527x1080/296+1920+0 HDMI-0\n 1: +HDMI-1 1920/521x1080/293+0+0 HDMI-1\n";
|
||||||
|
let outputs=parse_x11_monitors(text,"",60).unwrap();
|
||||||
|
assert_eq!(outputs.iter().map(|m|(m.name.as_str(),m.width,m.height,m.x,m.y)).collect::<Vec<_>>(),
|
||||||
|
vec![("HDMI-0",1920,1080,1920,0),("HDMI-1",1920,1080,0,0)]);
|
||||||
|
let outputs=parse_x11_monitors(text,"HDMI-1",60).unwrap();
|
||||||
|
assert_eq!((outputs[0].name.as_str(),outputs[1].name.as_str()),("HDMI-1","HDMI-0"));
|
||||||
|
assert!(parse_x11_monitors(text,"DP-9",60).is_err());
|
||||||
|
// xrandr --setmonitor virtual monitors (output "none"); no primary: left to right.
|
||||||
|
let virtual_monitors="Monitors: 3\n 0: +A 1280/338x1024/270+1280+0 none\n 1: +B 1280/338x1024/270+0+0 none\n 2: C 0/0x0/0+0+0 none\n";
|
||||||
|
let outputs=parse_x11_monitors(virtual_monitors,"",30).unwrap();
|
||||||
|
assert_eq!(outputs.iter().map(|m|(m.name.as_str(),m.x)).collect::<Vec<_>>(),vec![("B",0),("A",1280)]);
|
||||||
|
assert!(parse_x11_monitors("Monitors: 1\n 0: +*X 1920/1x1080/1-10+0 X\n","",60).is_err());
|
||||||
|
assert!(parse_x11_monitors("garbage","",60).is_err());
|
||||||
|
}
|
||||||
|
#[test]
|
||||||
|
fn sync_native_follows_the_wayland_source_id() {
|
||||||
|
assert_eq!(sync_native(":0",1,(1920,1080)),(1920,1080));
|
||||||
|
assert_eq!(sync_native("kms:/dev/dri/card0",1,(1920,1080)),(1920,1080));
|
||||||
|
let inventory:&'static [Output]=Box::leak(vec![
|
||||||
|
Output {name:"eDP-1".into(),width:1920,height:1080,fps:60,x:0,y:0},
|
||||||
|
Output {name:"HDMI-A-1".into(),width:2560,height:1440,fps:75,x:0,y:0},
|
||||||
|
].into_boxed_slice());
|
||||||
|
*test_outputs().lock().unwrap()=Some(inventory);
|
||||||
|
// Connection opened on the first output; the encoder is reading the second.
|
||||||
|
assert_eq!(sync_native("wayland:wayland-0",1,(1920,1080)),(2560,1440));
|
||||||
|
assert_eq!(source_size(0,(800,600)),(1920,1080));
|
||||||
|
assert_eq!(sync_native("wayland:wayland-0",9,(800,600)),(800,600));
|
||||||
|
assert_eq!(sync_native(":0",1,(1920,1080)),(1920,1080));
|
||||||
|
*test_outputs().lock().unwrap()=None;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
+451
-190
@@ -42,12 +42,173 @@ pub struct SessionContext {
|
|||||||
pub bundle_media: Option<(String, u16)>,
|
pub bundle_media: Option<(String, u16)>,
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Desktop role of one peer. A tool peer (file transfer, terminal, port mapping) gains it
|
||||||
|
/// when the viewer opens the desktop on that same connection with SimpleAction 4
|
||||||
|
/// capture_desktop instead of a new desktop offer (#99).
|
||||||
|
pub struct DesktopRole {
|
||||||
|
active: tokio::sync::watch::Sender<bool>,
|
||||||
|
input: std::sync::Mutex<Option<Arc<crate::input::DesktopInputSession>>>,
|
||||||
|
stream: std::sync::Mutex<Option<DesktopStream>>,
|
||||||
|
/// The running stream of a promoted peer; aborted on demotion so a quick re-promotion
|
||||||
|
/// never leaves two encoders on one track.
|
||||||
|
stream_task: std::sync::Mutex<Option<tokio::task::AbortHandle>>,
|
||||||
|
/// Capture reinitialized at promotion; the peer's own capture was unavailable when offered.
|
||||||
|
screen: std::sync::Mutex<Option<Arc<ScreenCapture>>>,
|
||||||
|
/// One session tracker per peer follows every promotion and demotion.
|
||||||
|
tracking: std::sync::atomic::AtomicBool,
|
||||||
|
request: std::sync::OnceLock<Box<dyn Fn() + Send + Sync>>,
|
||||||
|
}
|
||||||
|
impl DesktopRole {
|
||||||
|
fn new(desktop: bool) -> Self {
|
||||||
|
Self { active: tokio::sync::watch::channel(desktop).0, input: Default::default(),
|
||||||
|
stream: Default::default(), stream_task: Default::default(), screen: Default::default(), tracking: Default::default(), request: Default::default() }
|
||||||
|
}
|
||||||
|
pub fn is_desktop(&self) -> bool { *self.active.borrow() }
|
||||||
|
/// A promoted peer whose video ended on its own (capture failed while locked or off, #114);
|
||||||
|
/// capture_desktop on it starts the video again.
|
||||||
|
fn stream_ended(&self) -> bool { self.stream_task.lock().unwrap().as_ref().is_some_and(|task| task.is_finished()) }
|
||||||
|
fn input(&self) -> Option<Arc<crate::input::DesktopInputSession>> { self.input.lock().unwrap().clone() }
|
||||||
|
fn screen_or(&self, screen: &Arc<ScreenCapture>) -> Arc<ScreenCapture> {
|
||||||
|
self.screen.lock().unwrap().clone().unwrap_or_else(|| screen.clone())
|
||||||
|
}
|
||||||
|
/// Waits until this peer is a desktop; false once the channel closes first.
|
||||||
|
async fn wait_desktop(&self, channel: &RTCDataChannel) -> bool {
|
||||||
|
let mut active = self.active.subscribe();
|
||||||
|
loop {
|
||||||
|
if *active.borrow_and_update() { return true; }
|
||||||
|
tokio::select! {
|
||||||
|
changed = active.changed() => if changed.is_err() { return false; },
|
||||||
|
_ = tokio::time::sleep(std::time::Duration::from_millis(200)) => {
|
||||||
|
if matches!(channel.ready_state(), webrtc::data_channel::data_channel_state::RTCDataChannelState::Closing
|
||||||
|
| webrtc::data_channel::data_channel_state::RTCDataChannelState::Closed) { return false; }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Live desktop video for one peer; a tool peer keeps it unstarted until it becomes a desktop.
|
||||||
|
#[derive(Clone)]
|
||||||
|
struct DesktopStream {
|
||||||
|
pc: std::sync::Weak<RTCPeerConnection>,
|
||||||
|
track: Arc<crate::video_track::VideoTrack>,
|
||||||
|
portal_desktop: Option<Arc<crate::desktop_session::PortalDesktop>>,
|
||||||
|
capture_size: (u32, u32),
|
||||||
|
capture_display: String,
|
||||||
|
portal: Option<Arc<crate::portal::PortalSession>>,
|
||||||
|
settings_rx: tokio::sync::watch::Receiver<crate::capture_setting::VideoSettings>,
|
||||||
|
settings: Arc<tokio::sync::watch::Sender<crate::capture_setting::VideoSettings>>,
|
||||||
|
idr_request: Arc<std::sync::atomic::AtomicBool>,
|
||||||
|
selection: crate::video_select::Selection,
|
||||||
|
chroma_sync: Option<tokio::sync::mpsc::UnboundedSender<Vec<u8>>>,
|
||||||
|
reload_at_session: u64,
|
||||||
|
}
|
||||||
|
|
||||||
pub struct WebRtcSession {
|
pub struct WebRtcSession {
|
||||||
pub pc: Arc<RTCPeerConnection>,
|
pub pc: Arc<RTCPeerConnection>,
|
||||||
pub capture: Arc<ScreenCapture>,
|
pub capture: Arc<ScreenCapture>,
|
||||||
pub input: Arc<InputInjector>,
|
pub input: Arc<InputInjector>,
|
||||||
|
/// The role this peer was offered with; `role` also covers a later capture_desktop.
|
||||||
pub desktop: bool,
|
pub desktop: bool,
|
||||||
|
pub role: Arc<DesktopRole>,
|
||||||
|
pub controller_mac: bool,
|
||||||
pub context: Arc<Mutex<SessionContext>>,
|
pub context: Arc<Mutex<SessionContext>>,
|
||||||
|
actions: Arc<crate::system_actions::PeerActions>,
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Counts a desktop session once it is connected (a failed offer is not a session), while the
|
||||||
|
/// peer is the desktop. Started once per peer, so a quick demote and re-promote cannot end the
|
||||||
|
/// count of a session that is still streaming.
|
||||||
|
fn track_session(end_pc: Arc<RTCPeerConnection>, actions: Arc<crate::system_actions::PeerActions>, role: &DesktopRole) {
|
||||||
|
if role.tracking.swap(true, std::sync::atomic::Ordering::AcqRel) { return; }
|
||||||
|
let active = role.active.subscribe();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
use webrtc::peer_connection::peer_connection_state::RTCPeerConnectionState as State;
|
||||||
|
loop {
|
||||||
|
while end_pc.connection_state() != State::Connected || !*active.borrow() {
|
||||||
|
if matches!(end_pc.connection_state(), State::Closed | State::Failed) { return; }
|
||||||
|
tokio::time::sleep(std::time::Duration::from_millis(200)).await;
|
||||||
|
}
|
||||||
|
let starting = actions.clone();
|
||||||
|
let _ = tokio::task::spawn_blocking(move || starting.session_started()).await;
|
||||||
|
while !matches!(end_pc.connection_state(), State::Closed | State::Failed) && *active.borrow() {
|
||||||
|
tokio::time::sleep(std::time::Duration::from_secs(1)).await;
|
||||||
|
}
|
||||||
|
let closed = matches!(end_pc.connection_state(), State::Closed | State::Failed);
|
||||||
|
let ending = actions.clone();
|
||||||
|
let _ = tokio::task::spawn_blocking(move || ending.session_ended()).await;
|
||||||
|
if closed { return; }
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
type EchoReplay = (Arc<std::sync::atomic::AtomicU64>, Arc<std::sync::atomic::AtomicBool>, Arc<std::sync::atomic::AtomicBool>);
|
||||||
|
|
||||||
|
/// A promoted tool peer starts its TEXT clipboard after the viewer's echo was answered without
|
||||||
|
/// ff_clipboard; declare it again on CONTROL once the bridge is ready, as the Portal path does.
|
||||||
|
fn replay_clipboard_echo(channel: Arc<RTCDataChannel>, sequence: Arc<std::sync::atomic::AtomicU64>,
|
||||||
|
(echo_request, echo_seen, clipboard_ready): EchoReplay, role: Arc<DesktopRole>) {
|
||||||
|
tokio::spawn(async move {
|
||||||
|
for _ in 0..100 {
|
||||||
|
tokio::time::sleep(std::time::Duration::from_millis(100)).await;
|
||||||
|
if !role.is_desktop() || channel.ready_state() != webrtc::data_channel::data_channel_state::RTCDataChannelState::Open { return; }
|
||||||
|
if !clipboard_ready.load(std::sync::atomic::Ordering::Acquire) { continue; }
|
||||||
|
// echo_seen is published after the request seq, so reading it first gives a current seq.
|
||||||
|
if echo_seen.load(std::sync::atomic::Ordering::Acquire) {
|
||||||
|
let request_seq = echo_request.load(std::sync::atomic::Ordering::Acquire);
|
||||||
|
let timestamp = std::time::SystemTime::now().duration_since(std::time::UNIX_EPOCH).unwrap_or_default().as_secs();
|
||||||
|
let response = crate::control_protocol::encode_echo_response_with_clipboard(
|
||||||
|
sequence.fetch_add(1, std::sync::atomic::Ordering::Relaxed), timestamp, request_seq, true);
|
||||||
|
let _ = channel.send(&bytes::Bytes::from(response)).await;
|
||||||
|
log::info!("CONTROL clipboard capability declared after capture_desktop");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
impl DesktopStream {
|
||||||
|
/// Encode current frames only while the peer is connected and still the desktop.
|
||||||
|
fn spawn(self, screen: Option<Arc<ScreenCapture>>, mut active: tokio::sync::watch::Receiver<bool>) -> Option<tokio::task::AbortHandle> {
|
||||||
|
let streaming_pc = self.pc.upgrade()?;
|
||||||
|
let DesktopStream { track: video_track, portal_desktop, capture_size, capture_display, portal,
|
||||||
|
settings_rx, settings, idr_request, selection, chroma_sync, reload_at_session, .. } = self;
|
||||||
|
let (capture_size, capture_display, portal) = screen.map_or((capture_size, capture_display, portal),
|
||||||
|
|screen| ((screen.width, screen.height), screen.display.clone(), screen.portal.clone()));
|
||||||
|
Some(tokio::spawn(async move { tokio::select! {
|
||||||
|
_ = active.wait_for(|active| !*active) => log::info!("Live desktop stream stopped: a newer desktop took over"),
|
||||||
|
_ = async move {
|
||||||
|
let screen = if let Some(desktop) = portal_desktop {
|
||||||
|
if let Err(error) = crate::locked_video::run(&streaming_pc, &video_track, &desktop, selection).await {
|
||||||
|
log::warn!("Locked desktop video unavailable: {error}");
|
||||||
|
}
|
||||||
|
let mut updates = desktop.subscribe();
|
||||||
|
loop {
|
||||||
|
let state = updates.borrow_and_update().clone();
|
||||||
|
if state.ready() { break Some(state.screen); }
|
||||||
|
if !state.waiting { return; }
|
||||||
|
if crate::video::transport_closed(&streaming_pc) { return; }
|
||||||
|
tokio::select! {
|
||||||
|
changed = updates.changed() => if changed.is_err() { return; },
|
||||||
|
_ = tokio::time::sleep(std::time::Duration::from_millis(100)) => {},
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else { None };
|
||||||
|
let (capture_size, capture_display, portal) = screen.as_ref().map_or(
|
||||||
|
(capture_size, capture_display, portal),
|
||||||
|
|screen| ((screen.width, screen.height), screen.display.clone(), screen.portal.clone()));
|
||||||
|
let state_pc = streaming_pc.clone();
|
||||||
|
if let Err(e) = crate::video::stream_desktop_at(streaming_pc, video_track, capture_size, capture_display, portal, settings_rx, settings, idr_request, selection, chroma_sync, reload_at_session).await {
|
||||||
|
// A send racing the viewer's close fails with a misleading track error.
|
||||||
|
if matches!(state_pc.connection_state(), RTCPeerConnectionState::Closed | RTCPeerConnectionState::Failed) {
|
||||||
|
log::info!("Live desktop stream ended: peer connection closed ({})", e);
|
||||||
|
} else {
|
||||||
|
log::error!("Live desktop stream stopped: {}", e);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} => {},
|
||||||
|
} }).abort_handle())
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl WebRtcSession {
|
impl WebRtcSession {
|
||||||
@@ -65,6 +226,8 @@ impl WebRtcSession {
|
|||||||
|
|
||||||
// Encoder, codec preference and 4:4:4 stay fixed for this peer (codec is negotiated at CONTROL open).
|
// Encoder, codec preference and 4:4:4 stay fixed for this peer (codec is negotiated at CONTROL open).
|
||||||
// Read once before the HEVC probe so a concurrent set-encoder/set-codec cannot split capability from CONTROL.
|
// Read once before the HEVC probe so a concurrent set-encoder/set-codec cannot split capability from CONTROL.
|
||||||
|
// reload_at_session is the generation at that snapshot. A probe that finishes later is not a reload.
|
||||||
|
let reload_at_session = crate::video_select::reload_generation_value();
|
||||||
let video_selection = crate::video_select::selection();
|
let video_selection = crate::video_select::selection();
|
||||||
let hevc = desktop && crate::video::hevc_available(video_selection.encoder).await;
|
let hevc = desktop && crate::video::hevc_available(video_selection.encoder).await;
|
||||||
if hevc { crate::video_track::register_hevc(&mut m).map_err(|e| format!("Register HEVC failed: {e}"))?; }
|
if hevc { crate::video_track::register_hevc(&mut m).map_err(|e| format!("Register HEVC failed: {e}"))?; }
|
||||||
@@ -104,7 +267,8 @@ impl WebRtcSession {
|
|||||||
.map_err(|e| format!("Create PeerConnection failed: {}", e))?,
|
.map_err(|e| format!("Create PeerConnection failed: {}", e))?,
|
||||||
);
|
);
|
||||||
|
|
||||||
let input_session=desktop.then(||input.desktop_session());
|
let role = Arc::new(DesktopRole::new(desktop));
|
||||||
|
if desktop { *role.input.lock().unwrap() = Some(input.desktop_session()); }
|
||||||
let context = Arc::new(Mutex::new(SessionContext::default()));
|
let context = Arc::new(Mutex::new(SessionContext::default()));
|
||||||
crate::network_diagnostics::start(Arc::downgrade(&pc));
|
crate::network_diagnostics::start(Arc::downgrade(&pc));
|
||||||
|
|
||||||
@@ -162,13 +326,13 @@ impl WebRtcSession {
|
|||||||
}));
|
}));
|
||||||
|
|
||||||
let connected_context = context.clone();
|
let connected_context = context.clone();
|
||||||
let connection_input=input_session.clone();
|
let connection_role=role.clone();
|
||||||
let connected_signal = signaling_client.clone();
|
let connected_signal = signaling_client.clone();
|
||||||
let notified = Arc::new(std::sync::atomic::AtomicBool::new(false));
|
let notified = Arc::new(std::sync::atomic::AtomicBool::new(false));
|
||||||
let connected_selection = video_selection;
|
let connected_selection = video_selection;
|
||||||
pc.on_peer_connection_state_change(Box::new(move |state| {
|
pc.on_peer_connection_state_change(Box::new(move |state| {
|
||||||
let ctx = connected_context.clone();
|
let ctx = connected_context.clone();
|
||||||
let input=connection_input.clone();
|
let input=connection_role.input();
|
||||||
let sig = connected_signal.clone();
|
let sig = connected_signal.clone();
|
||||||
let notified = notified.clone();
|
let notified = notified.clone();
|
||||||
let video_selection = connected_selection;
|
let video_selection = connected_selection;
|
||||||
@@ -280,68 +444,24 @@ impl WebRtcSession {
|
|||||||
let video_settings = Arc::new(video_settings);
|
let video_settings = Arc::new(video_settings);
|
||||||
// Per-connection mute / lock-after-session settings (安全 menu).
|
// Per-connection mute / lock-after-session settings (安全 menu).
|
||||||
let peer_actions = Arc::new(crate::system_actions::PeerActions::default());
|
let peer_actions = Arc::new(crate::system_actions::PeerActions::default());
|
||||||
|
let session_actions = peer_actions.clone();
|
||||||
let desktop_sound = desktop && crate::audio::enabled();
|
let desktop_sound = desktop && crate::audio::enabled();
|
||||||
if desktop && !cfg!(test) {
|
if desktop && !cfg!(test) { track_session(pc.clone(), peer_actions.clone(), &role); }
|
||||||
let (end_pc, actions) = (pc.clone(), peer_actions.clone());
|
// Live encoder switch (SIGUSR2) sends CaptureSettingSync when chroma is downgraded.
|
||||||
tokio::spawn(async move {
|
let (chroma_sync_tx, chroma_sync_rx) = tokio::sync::mpsc::unbounded_channel::<Vec<u8>>();
|
||||||
{
|
let chroma_sync_rx = Arc::new(std::sync::Mutex::new((!cfg!(test)).then_some(chroma_sync_rx)));
|
||||||
use webrtc::peer_connection::peer_connection_state::RTCPeerConnectionState as State;
|
// File/terminal/port-mapping connections carry no desktop video until capture_desktop.
|
||||||
// Count the session once it is actually connected (a failed offer is not a session).
|
|
||||||
while end_pc.connection_state() != State::Connected {
|
|
||||||
if matches!(end_pc.connection_state(), State::Closed | State::Failed) { return; }
|
|
||||||
tokio::time::sleep(std::time::Duration::from_millis(200)).await;
|
|
||||||
}
|
|
||||||
let starting = actions.clone();
|
|
||||||
let _ = tokio::task::spawn_blocking(move || starting.session_started()).await;
|
|
||||||
}
|
|
||||||
use webrtc::peer_connection::peer_connection_state::RTCPeerConnectionState as State;
|
|
||||||
while !matches!(end_pc.connection_state(), State::Closed | State::Failed) {
|
|
||||||
tokio::time::sleep(std::time::Duration::from_secs(1)).await;
|
|
||||||
}
|
|
||||||
drop(end_pc);
|
|
||||||
let _ = tokio::task::spawn_blocking(move || actions.session_ended()).await;
|
|
||||||
});
|
|
||||||
}
|
|
||||||
let portal=capture.portal.clone();
|
|
||||||
let stream_desktop = portal_desktop.clone();
|
|
||||||
let stream_selection = video_selection;
|
|
||||||
// File/terminal/port-mapping connections carry no desktop video.
|
|
||||||
let control_video_track = video_track.clone();
|
let control_video_track = video_track.clone();
|
||||||
let stream_settings = video_settings.clone();
|
let stream = DesktopStream {
|
||||||
if desktop && !cfg!(test) {
|
pc: Arc::downgrade(&streaming_pc), track: video_track, portal_desktop: portal_desktop.clone(),
|
||||||
let state_pc = streaming_pc.clone();
|
capture_size, capture_display, portal: capture.portal.clone(), settings_rx: video_settings_rx,
|
||||||
tokio::spawn(async move {
|
settings: video_settings.clone(), idr_request, selection: video_selection,
|
||||||
let screen = if let Some(desktop) = stream_desktop {
|
chroma_sync: (!cfg!(test)).then_some(chroma_sync_tx), reload_at_session,
|
||||||
if let Err(error) = crate::locked_video::run(&streaming_pc, &video_track, &desktop, stream_selection).await {
|
};
|
||||||
log::warn!("Locked desktop video unavailable: {error}");
|
drop(streaming_pc);
|
||||||
}
|
if cfg!(test) { drop(stream); }
|
||||||
let mut updates = desktop.subscribe();
|
else if desktop { let _ = stream.spawn(None, role.active.subscribe()); }
|
||||||
loop {
|
else { *role.stream.lock().unwrap() = Some(stream); }
|
||||||
let state = updates.borrow_and_update().clone();
|
|
||||||
if state.ready() { break Some(state.screen); }
|
|
||||||
if !state.waiting { return; }
|
|
||||||
if crate::video::transport_closed(&streaming_pc) { return; }
|
|
||||||
tokio::select! {
|
|
||||||
changed = updates.changed() => if changed.is_err() { return; },
|
|
||||||
_ = tokio::time::sleep(std::time::Duration::from_millis(100)) => {},
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} else { None };
|
|
||||||
let (capture_size, capture_display, portal) = screen.as_ref().map_or(
|
|
||||||
(capture_size, capture_display, portal),
|
|
||||||
|screen| ((screen.width, screen.height), screen.display.clone(), screen.portal.clone()));
|
|
||||||
if let Err(e) = crate::video::stream_desktop(streaming_pc, video_track, capture_size, capture_display, portal, video_settings_rx, stream_settings, idr_request, stream_selection).await {
|
|
||||||
// A send racing the viewer's close fails with a misleading track error.
|
|
||||||
if matches!(state_pc.connection_state(), RTCPeerConnectionState::Closed | RTCPeerConnectionState::Failed) {
|
|
||||||
log::info!("Live desktop stream ended: peer connection closed ({})", e);
|
|
||||||
} else {
|
|
||||||
log::error!("Live desktop stream stopped: {}", e);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
} else {
|
|
||||||
drop((streaming_pc, video_track, capture_size, capture_display, video_settings_rx));
|
|
||||||
}
|
|
||||||
let input_clone = input.clone();
|
let input_clone = input.clone();
|
||||||
let control_capture = capture.clone();
|
let control_capture = capture.clone();
|
||||||
let desktop_pc = Arc::downgrade(&pc);
|
let desktop_pc = Arc::downgrade(&pc);
|
||||||
@@ -399,6 +519,7 @@ impl WebRtcSession {
|
|||||||
|
|
||||||
// Settings arrive on CONTROL or TEXT; serialize both queues for this peer.
|
// Settings arrive on CONTROL or TEXT; serialize both queues for this peer.
|
||||||
let settings_serial=Arc::new(Mutex::new(()));
|
let settings_serial=Arc::new(Mutex::new(()));
|
||||||
|
let data_role = role.clone();
|
||||||
// 监听 DataChannel
|
// 监听 DataChannel
|
||||||
pc.on_data_channel(Box::new(move |d: Arc<RTCDataChannel>| {
|
pc.on_data_channel(Box::new(move |d: Arc<RTCDataChannel>| {
|
||||||
let label = d.label().to_string();
|
let label = d.label().to_string();
|
||||||
@@ -406,7 +527,7 @@ impl WebRtcSession {
|
|||||||
|
|
||||||
let peer_settings_serial=settings_serial.clone();
|
let peer_settings_serial=settings_serial.clone();
|
||||||
let input_inst = input_clone.clone();
|
let input_inst = input_clone.clone();
|
||||||
let channel_input_session=input_session.clone();
|
let channel_role=data_role.clone();
|
||||||
let screen = control_capture.clone();
|
let screen = control_capture.clone();
|
||||||
let portal_desktop = portal_desktop.clone();
|
let portal_desktop = portal_desktop.clone();
|
||||||
let desktop_pc = desktop_pc.clone();
|
let desktop_pc = desktop_pc.clone();
|
||||||
@@ -421,6 +542,7 @@ impl WebRtcSession {
|
|||||||
let peer_video_track = control_video_track.clone();
|
let peer_video_track = control_video_track.clone();
|
||||||
let peer_actions = peer_actions.clone();
|
let peer_actions = peer_actions.clone();
|
||||||
let peer_selection = video_selection;
|
let peer_selection = video_selection;
|
||||||
|
let chroma_sync_rx = chroma_sync_rx.clone();
|
||||||
if label == "FILE_DATA_CHANNEL" { *file_channel.lock().unwrap() = Some(d.clone()); }
|
if label == "FILE_DATA_CHANNEL" { *file_channel.lock().unwrap() = Some(d.clone()); }
|
||||||
|
|
||||||
Box::pin(async move {
|
Box::pin(async move {
|
||||||
@@ -435,24 +557,54 @@ impl WebRtcSession {
|
|||||||
let rich_state=Arc::new(std::sync::Mutex::new(crate::clipboard_rich::State::default()));
|
let rich_state=Arc::new(std::sync::Mutex::new(crate::clipboard_rich::State::default()));
|
||||||
let clipboard_enabled = shared_clipboard_ready.clone();
|
let clipboard_enabled = shared_clipboard_ready.clone();
|
||||||
if label=="CONTROL_DATA_CHANNEL" {
|
if label=="CONTROL_DATA_CHANNEL" {
|
||||||
let closing=channel_input_session.clone();
|
let closing=channel_role.clone();
|
||||||
d.on_close(Box::new(move || {
|
d.on_close(Box::new(move || {
|
||||||
let closing=closing.clone();
|
let closing=closing.input();
|
||||||
Box::pin(async move {if let Some(session)=closing {session.disconnected();}})
|
Box::pin(async move {if let Some(session)=closing {session.disconnected();}})
|
||||||
}));
|
}));
|
||||||
}
|
}
|
||||||
// Ordered outbound queue for protocol replies produced outside this callback.
|
// Ordered outbound queue for protocol replies produced outside this callback.
|
||||||
let (outbound, mut outbound_rx) = tokio::sync::mpsc::unbounded_channel::<Vec<u8>>();
|
// webrtc-rs announces the channel before handle_open (ready_state Connecting);
|
||||||
|
// send() returns ErrClosedPipe until Open. Draining CONTROL here would drop
|
||||||
|
// Message 25 and every later reply. Start CONTROL from the on_open below
|
||||||
|
// (one handler; a second on_open replaces it). Receiver taken once.
|
||||||
|
let mut control_drain: Option<Box<dyn (FnOnce() -> std::pin::Pin<Box<dyn std::future::Future<Output = ()> + Send>>) + Send + Sync>> = None;
|
||||||
|
let (outbound, outbound_rx) = tokio::sync::mpsc::unbounded_channel::<Vec<u8>>();
|
||||||
|
let outbound_rx = Arc::new(tokio::sync::Mutex::new(Some(outbound_rx)));
|
||||||
|
if label == "CONTROL_DATA_CHANNEL" {
|
||||||
|
if let Some(mut chroma_sync_rx) = chroma_sync_rx.lock().unwrap().take() {
|
||||||
|
let sync_out = outbound.clone();
|
||||||
|
let sync_seq = reply_sequence.clone();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
while let Some(payload) = chroma_sync_rx.recv().await {
|
||||||
|
let timestamp = std::time::SystemTime::now().duration_since(std::time::UNIX_EPOCH).unwrap_or_default().as_secs();
|
||||||
|
let seq = sync_seq.fetch_add(1, std::sync::atomic::Ordering::Relaxed);
|
||||||
|
let _ = sync_out.send(crate::initialization::envelope(seq, timestamp, 25, &payload));
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
{
|
{
|
||||||
let out_channel = d.clone();
|
let out_channel = d.clone();
|
||||||
let out_label = label.clone();
|
let out_label = label.clone();
|
||||||
tokio::spawn(async move {
|
let outbound_rx = outbound_rx.clone();
|
||||||
while let Some(message) = outbound_rx.recv().await {
|
let start_drain = move || {
|
||||||
if let Err(e) = out_channel.send(&bytes::Bytes::from(message)).await {
|
let out_channel = out_channel.clone();
|
||||||
log::warn!("{} send failed: {}", out_label, e); break;
|
let out_label = out_label.clone();
|
||||||
}
|
let outbound_rx = outbound_rx.clone();
|
||||||
}
|
Box::pin(async move {
|
||||||
});
|
let Some(mut outbound_rx) = take_outbound_once(&outbound_rx).await else { return; };
|
||||||
|
tokio::spawn(async move {
|
||||||
|
while let Some(message) = outbound_rx.recv().await {
|
||||||
|
if let Err(e) = out_channel.send(&bytes::Bytes::from(message)).await {
|
||||||
|
log::warn!("{} send failed: {}", out_label, e); break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}) as std::pin::Pin<Box<dyn std::future::Future<Output = ()> + Send>>
|
||||||
|
};
|
||||||
|
if label != "CONTROL_DATA_CHANNEL" { tokio::spawn(start_drain()); }
|
||||||
|
else { control_drain = Some(Box::new(start_drain)); }
|
||||||
}
|
}
|
||||||
let (capture_tx, mut capture_rx) = tokio::sync::mpsc::channel::<Vec<u8>>(16);
|
let (capture_tx, mut capture_rx) = tokio::sync::mpsc::channel::<Vec<u8>>(16);
|
||||||
if matches!(label.as_str(),"CONTROL_DATA_CHANNEL"|"TEXT_DATA_CHANNEL") {
|
if matches!(label.as_str(),"CONTROL_DATA_CHANNEL"|"TEXT_DATA_CHANNEL") {
|
||||||
@@ -463,7 +615,7 @@ impl WebRtcSession {
|
|||||||
let manager = portal_desktop.clone();
|
let manager = portal_desktop.clone();
|
||||||
let channel = Arc::downgrade(&d);
|
let channel = Arc::downgrade(&d);
|
||||||
let initial_screen = screen.clone();
|
let initial_screen = screen.clone();
|
||||||
let switch_owner=channel_input_session.clone();
|
let capture_role=channel_role.clone();
|
||||||
let settings_serial=peer_settings_serial.clone();
|
let settings_serial=peer_settings_serial.clone();
|
||||||
let capture_selection = peer_selection;
|
let capture_selection = peer_selection;
|
||||||
tokio::spawn(async move {
|
tokio::spawn(async move {
|
||||||
@@ -481,6 +633,7 @@ impl WebRtcSession {
|
|||||||
}
|
}
|
||||||
};
|
};
|
||||||
let _serial=settings_serial.lock().await;
|
let _serial=settings_serial.lock().await;
|
||||||
|
let (desktop,switch_owner)=(capture_role.is_desktop(),capture_role.input());
|
||||||
if desktop && switch_owner.as_ref().is_none_or(|owner|!owner.is_current()) {continue;}
|
if desktop && switch_owner.as_ref().is_none_or(|owner|!owner.is_current()) {continue;}
|
||||||
let reject=|reason:&str| {
|
let reject=|reason:&str| {
|
||||||
if let Some(response)=crate::capture_setting::rejected_request(&request,reason) {
|
if let Some(response)=crate::capture_setting::rejected_request(&request,reason) {
|
||||||
@@ -526,10 +679,10 @@ impl WebRtcSession {
|
|||||||
if channel.upgrade().is_none_or(|channel| channel.ready_state() != webrtc::data_channel::data_channel_state::RTCDataChannelState::Open) { return; }
|
if channel.upgrade().is_none_or(|channel| channel.ready_state() != webrtc::data_channel::data_channel_state::RTCDataChannelState::Open) { return; }
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
Some(initial_screen.clone())
|
Some(capture_role.screen_or(&initial_screen))
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
Some(initial_screen.clone())
|
Some(capture_role.screen_or(&initial_screen))
|
||||||
};
|
};
|
||||||
let Some(active_screen) = active_screen else { continue; };
|
let Some(active_screen) = active_screen else { continue; };
|
||||||
let input_size = if active_screen.init_error.is_none() {
|
let input_size = if active_screen.init_error.is_none() {
|
||||||
@@ -569,9 +722,11 @@ impl WebRtcSession {
|
|||||||
}) else { continue; };
|
}) else { continue; };
|
||||||
let Ok(rpc_fields) = crate::protocol::decode_wire(rpc) else { continue; };
|
let Ok(rpc_fields) = crate::protocol::decode_wire(rpc) else { continue; };
|
||||||
// X11: 分辨率 changes the display mode itself, like the official Windows host; the stream
|
// X11: 分辨率 changes the display mode itself, like the official Windows host; the stream
|
||||||
// then carries the new native size instead of a scaled one (desktop_mode).
|
// then carries the new native size instead of a scaled one (desktop_mode). With
|
||||||
|
// UU_X11_MULTISCREEN the monitor layout stays as it is and the stream is scaled.
|
||||||
let resized = if desktop && active_screen.init_error.is_none() && active_screen.portal.is_none()
|
let resized = if desktop && active_screen.init_error.is_none() && active_screen.portal.is_none()
|
||||||
&& active_screen.backend == crate::desktop_backend::DesktopBackend::X11 && crate::desktop_mode::enabled() {
|
&& active_screen.backend == crate::desktop_backend::DesktopBackend::X11 && crate::desktop_mode::enabled()
|
||||||
|
&& !crate::wayland::x11_multiscreen() {
|
||||||
match crate::capture_setting::requested_resolution(&rpc_fields) {
|
match crate::capture_setting::requested_resolution(&rpc_fields) {
|
||||||
Some(request) => {
|
Some(request) => {
|
||||||
let display = active_screen.display.clone();
|
let display = active_screen.display.clone();
|
||||||
@@ -636,10 +791,12 @@ impl WebRtcSession {
|
|||||||
let open_video = channel_video_settings.clone();
|
let open_video = channel_video_settings.clone();
|
||||||
let open_track = peer_video_track.clone();
|
let open_track = peer_video_track.clone();
|
||||||
let open_desktop = portal_desktop.clone();
|
let open_desktop = portal_desktop.clone();
|
||||||
let open_owner = channel_input_session.clone();
|
let open_owner = channel_role.input();
|
||||||
|
let open_role = channel_role.clone();
|
||||||
let open_screen = screen.clone();
|
let open_screen = screen.clone();
|
||||||
let open_selection = peer_selection;
|
let open_selection = peer_selection;
|
||||||
d.on_open(Box::new(move || {
|
d.on_open(Box::new(move || {
|
||||||
|
if let Some(start_drain) = control_drain { tokio::spawn(start_drain()); }
|
||||||
let init_actions = open_actions.clone();
|
let init_actions = open_actions.clone();
|
||||||
let init_video = open_video.clone();
|
let init_video = open_video.clone();
|
||||||
let init_track = open_track.clone();
|
let init_track = open_track.clone();
|
||||||
@@ -651,82 +808,91 @@ impl WebRtcSession {
|
|||||||
let rich_outgoing=rich_outgoing.clone();
|
let rich_outgoing=rich_outgoing.clone();
|
||||||
let portal_desktop = open_desktop.clone();
|
let portal_desktop = open_desktop.clone();
|
||||||
let owner = open_owner.clone();
|
let owner = open_owner.clone();
|
||||||
|
let role = open_role.clone();
|
||||||
let pc = desktop_pc.upgrade();
|
let pc = desktop_pc.upgrade();
|
||||||
Box::pin(async move {
|
Box::pin(async move {
|
||||||
// Permission dialogs and first-frame waits must not occupy the
|
// Permission dialogs and first-frame waits must not occupy the
|
||||||
// channel-open callback or delay CONTROL message dispatch.
|
// channel-open callback or delay CONTROL message dispatch.
|
||||||
tokio::spawn(async move {
|
tokio::spawn(async move {
|
||||||
if channel.label() == "TEXT_DATA_CHANNEL" {
|
if channel.label() == "TEXT_DATA_CHANNEL" {
|
||||||
if !desktop { return; }
|
loop {
|
||||||
let screen = if let Some(desktop) = &portal_desktop {
|
if !role.is_desktop() && !role.wait_desktop(&channel).await { return; }
|
||||||
let mut updates = desktop.subscribe();
|
let screen = if let Some(desktop) = &portal_desktop {
|
||||||
let Some(_) = crate::desktop_session::wait_ready(&mut updates, &channel).await else { return; };
|
let mut updates = desktop.subscribe();
|
||||||
let mut locked = desktop.lock_state();
|
let Some(_) = crate::desktop_session::wait_ready(&mut updates, &channel).await else { return; };
|
||||||
loop {
|
let mut locked = desktop.lock_state();
|
||||||
let state = desktop.snapshot();
|
loop {
|
||||||
if !state.waiting && state.screen.init_error.is_some() { return; }
|
let state = desktop.snapshot();
|
||||||
if let Some(session) = state.screen.portal.as_ref() {
|
if !state.waiting && state.screen.init_error.is_some() { return; }
|
||||||
if session.is_alive() && *locked.borrow() == Some(false) {
|
if let Some(session) = state.screen.portal.as_ref() {
|
||||||
break state.screen;
|
if session.is_alive() && *locked.borrow() == Some(false) {
|
||||||
}
|
break state.screen;
|
||||||
}
|
}
|
||||||
tokio::select! {
|
}
|
||||||
_ = tokio::time::sleep(std::time::Duration::from_millis(100)) => {},
|
tokio::select! {
|
||||||
changed = locked.changed() => if changed.is_err() { return; },
|
_ = tokio::time::sleep(std::time::Duration::from_millis(100)) => {},
|
||||||
_ = async {
|
changed = locked.changed() => if changed.is_err() { return; },
|
||||||
loop {
|
_ = async {
|
||||||
if matches!(channel.ready_state(), webrtc::data_channel::data_channel_state::RTCDataChannelState::Closing
|
loop {
|
||||||
| webrtc::data_channel::data_channel_state::RTCDataChannelState::Closed) { return; }
|
if matches!(channel.ready_state(), webrtc::data_channel::data_channel_state::RTCDataChannelState::Closing
|
||||||
tokio::time::sleep(std::time::Duration::from_millis(100)).await;
|
| webrtc::data_channel::data_channel_state::RTCDataChannelState::Closed) { return; }
|
||||||
}
|
tokio::time::sleep(std::time::Duration::from_millis(100)).await;
|
||||||
} => return,
|
}
|
||||||
}
|
} => return,
|
||||||
}
|
}
|
||||||
} else { screen };
|
}
|
||||||
let bridge = if let Some(session)=screen.portal.clone() { crate::clipboard::start_portal(session) } else { crate::clipboard::start(screen.display.clone()) };
|
} else { role.screen_or(&screen) };
|
||||||
*clipboard_sink.lock().unwrap() = Some(bridge.incoming);
|
let bridge = if let Some(session)=screen.portal.clone() { crate::clipboard::start_portal(session) } else { crate::clipboard::start(screen.display.clone()) };
|
||||||
let clipboard_channel = channel.clone();
|
*clipboard_sink.lock().unwrap() = Some(bridge.incoming);
|
||||||
let clipboard_sequence = sequence.clone();
|
let clipboard_channel = channel.clone();
|
||||||
let clipboard_cleanup = clipboard_sink.clone();
|
let clipboard_sequence = sequence.clone();
|
||||||
let ready = bridge.ready.await.unwrap_or(false);
|
let clipboard_cleanup = clipboard_sink.clone();
|
||||||
clipboard_ready.store(ready,std::sync::atomic::Ordering::Relaxed);
|
let rich_outgoing = rich_outgoing.clone();
|
||||||
tokio::spawn(async move {
|
let ready = bridge.ready.await.unwrap_or(false);
|
||||||
if !ready {
|
clipboard_ready.store(ready,std::sync::atomic::Ordering::Relaxed);
|
||||||
*clipboard_cleanup.lock().unwrap() = None;
|
{
|
||||||
log::warn!("Native text clipboard unavailable"); return;
|
if !ready {
|
||||||
}
|
*clipboard_cleanup.lock().unwrap() = None;
|
||||||
log::info!("Native text clipboard bridge ready");
|
log::warn!("Native text clipboard unavailable"); return;
|
||||||
let mut updates = bridge.outgoing;
|
}
|
||||||
let mut health = tokio::time::interval(std::time::Duration::from_millis(200));
|
log::info!("Native text clipboard bridge ready");
|
||||||
loop {
|
let mut updates = bridge.outgoing;
|
||||||
tokio::select! {
|
let mut health = tokio::time::interval(std::time::Duration::from_millis(200));
|
||||||
_ = health.tick() => {
|
let mut active = role.active.subscribe();
|
||||||
if clipboard_channel.ready_state() != webrtc::data_channel::data_channel_state::RTCDataChannelState::Open { break; }
|
loop {
|
||||||
},
|
tokio::select! {
|
||||||
changed = updates.changed() => {
|
_ = health.tick() => {
|
||||||
if changed.is_err() { break; }
|
if clipboard_channel.ready_state() != webrtc::data_channel::data_channel_state::RTCDataChannelState::Open { break; }
|
||||||
let text = updates.borrow_and_update().clone();
|
},
|
||||||
let Some(text) = text else { continue; };
|
_ = async { let _ = active.wait_for(|active| !*active).await; } => break,
|
||||||
{
|
changed = updates.changed() => {
|
||||||
let request_id=clipboard_sequence.fetch_add(1,std::sync::atomic::Ordering::Relaxed);
|
if changed.is_err() { break; }
|
||||||
let payload = match rich_outgoing.lock().unwrap().offer(request_id,text.clone()) {
|
let text = updates.borrow_and_update().clone();
|
||||||
Ok(payload)=>payload,Err(reason)=>{log::warn!("Clipboard offer rejected: {}",reason);continue;}
|
let Some(text) = text else { continue; };
|
||||||
};
|
{
|
||||||
let timestamp = std::time::SystemTime::now().duration_since(std::time::UNIX_EPOCH).unwrap_or_default().as_secs();
|
let request_id=clipboard_sequence.fetch_add(1,std::sync::atomic::Ordering::Relaxed);
|
||||||
let message = crate::initialization::envelope(clipboard_sequence.fetch_add(1,std::sync::atomic::Ordering::Relaxed),timestamp,21,&payload);
|
let payload = match rich_outgoing.lock().unwrap().offer(request_id,text.clone()) {
|
||||||
if !matches!(tokio::time::timeout(std::time::Duration::from_secs(2),clipboard_channel.send(&bytes::Bytes::from(message))).await,Ok(Ok(_))) {
|
Ok(payload)=>payload,Err(reason)=>{log::warn!("Clipboard offer rejected: {}",reason);continue;}
|
||||||
log::warn!("Native clipboard RPC send failed"); break;
|
};
|
||||||
}
|
let timestamp = std::time::SystemTime::now().duration_since(std::time::UNIX_EPOCH).unwrap_or_default().as_secs();
|
||||||
}
|
let message = crate::initialization::envelope(clipboard_sequence.fetch_add(1,std::sync::atomic::Ordering::Relaxed),timestamp,21,&payload);
|
||||||
log::info!("Native clipboard text format offered: bytes={}",text.len());
|
if !matches!(tokio::time::timeout(std::time::Duration::from_secs(2),clipboard_channel.send(&bytes::Bytes::from(message))).await,Ok(Ok(_))) {
|
||||||
}
|
log::warn!("Native clipboard RPC send failed"); break;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
*clipboard_cleanup.lock().unwrap() = None;
|
log::info!("Native clipboard text format offered: bytes={}",text.len());
|
||||||
clipboard_ready.store(false,std::sync::atomic::Ordering::Relaxed);
|
}
|
||||||
});
|
}
|
||||||
return;
|
}
|
||||||
|
*clipboard_cleanup.lock().unwrap() = None;
|
||||||
|
clipboard_ready.store(false,std::sync::atomic::Ordering::Relaxed);
|
||||||
|
}
|
||||||
|
if channel.ready_state() != webrtc::data_channel::data_channel_state::RTCDataChannelState::Open { return; }
|
||||||
|
// A newer desktop took over this promoted tool peer; capture_desktop restarts the clipboard.
|
||||||
|
log::info!("Native text clipboard stopped: a newer desktop took over");
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
let replay = (last_echo_request.clone(), echo_seen.clone(), clipboard_ready.clone());
|
||||||
let early_desktop_selection = desktop && portal_desktop.is_some();
|
let early_desktop_selection = desktop && portal_desktop.is_some();
|
||||||
if early_desktop_selection {
|
if early_desktop_selection {
|
||||||
// Android 4.43.0's unlock presenter requires CaptureChange
|
// Android 4.43.0's unlock presenter requires CaptureChange
|
||||||
@@ -813,58 +979,75 @@ impl WebRtcSession {
|
|||||||
}
|
}
|
||||||
} else { snapshot.screen }
|
} else { snapshot.screen }
|
||||||
} else { screen };
|
} else { screen };
|
||||||
let timestamp = std::time::SystemTime::now()
|
|
||||||
.duration_since(std::time::UNIX_EPOCH).unwrap_or_default().as_secs();
|
|
||||||
let next_seq = || sequence.fetch_add(1, std::sync::atomic::Ordering::Relaxed);
|
let next_seq = || sequence.fetch_add(1, std::sync::atomic::Ordering::Relaxed);
|
||||||
// Default file-transfer folder: the desktop user's home directory.
|
// Default file-transfer folder: the desktop user's home directory.
|
||||||
let home = std::env::var("HOME").unwrap_or_else(|_| "/".into());
|
let home = std::env::var("HOME").unwrap_or_else(|_| "/".into());
|
||||||
// Tool peers are permitted without a desktop; the port-mapping viewer aborts on Reject.
|
let (mut desktop, mut promoted, mut lock_reported) = (desktop, false, desktop);
|
||||||
let desktop_permission=if screen.init_error.is_none() || !desktop {
|
let mut screen = screen;
|
||||||
crate::system_metrics::Permission::Allow
|
loop {
|
||||||
} else { crate::system_metrics::Permission::Reject };
|
loop {
|
||||||
// Without a desktop (headless/portal before consent) the port-mapping tool still waits
|
let timestamp = std::time::SystemTime::now()
|
||||||
// for ScreenSources/CaptureChange and aborts otherwise: tool peers get a nominal screen.
|
.duration_since(std::time::UNIX_EPOCH).unwrap_or_default().as_secs();
|
||||||
let screen_size=crate::wayland::input_size(if screen.init_error.is_none() { (screen.width, screen.height) } else { (1920, 1080) });
|
// Tool peers are permitted without a desktop; the port-mapping viewer aborts on Reject.
|
||||||
let messages = [
|
let desktop_permission=if screen.init_error.is_none() || !desktop {
|
||||||
(8, crate::initialization::encode_capture_change(next_seq(), timestamp, 0, crate::wayland::selected() as i32, "Linux desktop")),
|
crate::system_metrics::Permission::Allow
|
||||||
(13, Ok(crate::initialization::envelope(next_seq(), timestamp, 13, &init_actions.metrics_payload(desktop_sound, desktop_permission)))),
|
} else { crate::system_metrics::Permission::Reject };
|
||||||
(26, Ok(crate::initialization::envelope(next_seq(), timestamp, 26,
|
// Without a desktop (headless/portal before consent) the port-mapping tool still waits
|
||||||
&crate::system_metrics::remote_download_path(&home)))),
|
// for ScreenSources/CaptureChange and aborts otherwise: tool peers get a nominal screen.
|
||||||
(18, Ok(crate::initialization::envelope(next_seq(), timestamp, 18,
|
let screen_size=crate::wayland::input_size(if screen.init_error.is_none() { (screen.width, screen.height) } else { (1920, 1080) });
|
||||||
&crate::capture_setting::codec_negotiation(screen_size, crate::video::display_fps(), init_track.supports(crate::capture_setting::VideoCodec::H265))))),
|
let messages = [
|
||||||
(7, crate::capture_setting::screen_sources(next_seq(), timestamp, screen_size, init_video.borrow().output, "Linux desktop")),
|
(8, crate::initialization::encode_capture_change(next_seq(), timestamp, 0, crate::wayland::selected() as i32, "Linux desktop")),
|
||||||
];
|
(13, Ok(crate::initialization::envelope(next_seq(), timestamp, 13, &init_actions.metrics_payload(desktop_sound, desktop_permission)))),
|
||||||
if desktop && screen.init_error.is_none() {
|
(26, Ok(crate::initialization::envelope(next_seq(), timestamp, 26,
|
||||||
let codec = crate::capture_setting::preferred_codec_for(init_track.supports(crate::capture_setting::VideoCodec::H264),
|
&crate::system_metrics::remote_download_path(&home)))),
|
||||||
init_track.supports(crate::capture_setting::VideoCodec::H265), open_selection);
|
(18, Ok(crate::initialization::envelope(next_seq(), timestamp, 18,
|
||||||
init_video.send_if_modified(|current| if current.codec != codec {
|
&crate::capture_setting::codec_negotiation(screen_size, crate::video::display_fps(), init_track.supports(crate::capture_setting::VideoCodec::H265))))),
|
||||||
log::info!("Desktop codec selected: {:?}", codec); current.codec = codec; true } else { false });
|
(7, crate::capture_setting::screen_sources(next_seq(), timestamp, screen_size, init_video.borrow().output, "Linux desktop")),
|
||||||
}
|
];
|
||||||
for (field, message) in messages {
|
if desktop && screen.init_error.is_none() {
|
||||||
if early_desktop_selection && field == 8 { continue; }
|
let codec = crate::capture_setting::preferred_codec_for(init_track.supports(crate::capture_setting::VideoCodec::H264),
|
||||||
if (!desktop || screen.init_error.is_some()) && field == 18 { continue; }
|
init_track.supports(crate::capture_setting::VideoCodec::H265), open_selection);
|
||||||
if desktop && screen.init_error.is_some() && matches!(field,7|8) { continue; }
|
init_video.send_if_modified(|current| if current.codec != codec {
|
||||||
let message = match message {
|
log::info!("Desktop codec selected: {:?}", codec); current.codec = codec; true } else { false });
|
||||||
Ok(message) => message,
|
|
||||||
Err(e) => { log::error!("CONTROL initialization encode failed: {}", e); return; }
|
|
||||||
};
|
|
||||||
if let Err(e) = channel.send(&bytes::Bytes::from(message)).await {
|
|
||||||
log::error!("CONTROL initialization field {} failed: {}", field, e);
|
|
||||||
return;
|
|
||||||
}
|
}
|
||||||
log::info!("CONTROL initialization field {} sent", field);
|
for (field, message) in messages {
|
||||||
|
if early_desktop_selection && field == 8 { continue; }
|
||||||
|
if promoted && field == 26 { continue; }
|
||||||
|
if (!desktop || screen.init_error.is_some()) && field == 18 { continue; }
|
||||||
|
if desktop && screen.init_error.is_some() && matches!(field,7|8) { continue; }
|
||||||
|
let message = match message {
|
||||||
|
Ok(message) => message,
|
||||||
|
Err(e) => { log::error!("CONTROL initialization encode failed: {}", e); return; }
|
||||||
|
};
|
||||||
|
if let Err(e) = channel.send(&bytes::Bytes::from(message)).await {
|
||||||
|
log::error!("CONTROL initialization field {} failed: {}", field, e);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
log::info!("CONTROL initialization field {} sent", field);
|
||||||
|
}
|
||||||
|
if desktop { break; }
|
||||||
|
// The viewer opened the desktop on this tool connection (#99): repeat the
|
||||||
|
// desktop initialization once the host has started its video and input.
|
||||||
|
if !role.wait_desktop(&channel).await { return; }
|
||||||
|
(desktop, promoted) = (true, true);
|
||||||
|
screen = role.screen_or(&screen);
|
||||||
|
replay_clipboard_echo(channel.clone(), sequence.clone(), replay.clone(), role.clone());
|
||||||
|
}
|
||||||
|
if !lock_reported {
|
||||||
|
lock_reported = true;
|
||||||
|
tokio::spawn(crate::session_lock::report_states(channel.clone(), sequence.clone(), crate::session_lock::watch_locked()));
|
||||||
}
|
}
|
||||||
// Mirror the Linux pointer shape; the video itself carries no pointer.
|
// Mirror the Linux pointer shape; the video itself carries no pointer.
|
||||||
if !desktop { return; }
|
|
||||||
let mut shapes = crate::cursor::monitor(&screen.display);
|
let mut shapes = crate::cursor::monitor(&screen.display);
|
||||||
let mut health = tokio::time::interval(std::time::Duration::from_millis(200));
|
let mut health = tokio::time::interval(std::time::Duration::from_millis(200));
|
||||||
let mut sent = 0usize;
|
let mut sent = 0usize;
|
||||||
loop {
|
let mut active = role.active.subscribe();
|
||||||
|
'cursor: loop {
|
||||||
let current = shapes.borrow_and_update().clone();
|
let current = shapes.borrow_and_update().clone();
|
||||||
if let Some(cursor) = current {
|
if let Some(cursor) = current {
|
||||||
let timestamp = std::time::SystemTime::now().duration_since(std::time::UNIX_EPOCH).unwrap_or_default().as_secs();
|
let timestamp = std::time::SystemTime::now().duration_since(std::time::UNIX_EPOCH).unwrap_or_default().as_secs();
|
||||||
let message = crate::cursor::encode_cursor_shape(next_seq(), timestamp, &cursor);
|
let message = crate::cursor::encode_cursor_shape(next_seq(), timestamp, &cursor);
|
||||||
if channel.send(&bytes::Bytes::from(message)).await.is_err() { break; }
|
if channel.send(&bytes::Bytes::from(message)).await.is_err() { return; }
|
||||||
sent += 1;
|
sent += 1;
|
||||||
if sent <= 3 || sent % 100 == 0 {
|
if sent <= 3 || sent % 100 == 0 {
|
||||||
log::info!("Cursor shape sent: count={} size={}x{} hotspot={},{} png_bytes={}", sent, cursor.width, cursor.height, cursor.hot_x, cursor.hot_y, cursor.png.len());
|
log::info!("Cursor shape sent: count={} size={}x{} hotspot={},{} png_bytes={}", sent, cursor.width, cursor.height, cursor.hot_x, cursor.hot_y, cursor.png.len());
|
||||||
@@ -873,12 +1056,18 @@ impl WebRtcSession {
|
|||||||
loop {
|
loop {
|
||||||
tokio::select! {
|
tokio::select! {
|
||||||
changed = shapes.changed() => { if changed.is_err() { return; } break; },
|
changed = shapes.changed() => { if changed.is_err() { return; } break; },
|
||||||
|
_ = active.wait_for(|active| !*active) => break 'cursor,
|
||||||
_ = health.tick() => {
|
_ = health.tick() => {
|
||||||
if channel.ready_state() != webrtc::data_channel::data_channel_state::RTCDataChannelState::Open { return; }
|
if channel.ready_state() != webrtc::data_channel::data_channel_state::RTCDataChannelState::Open { return; }
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
// A newer desktop took over this promoted tool peer; wait for capture_desktop again.
|
||||||
|
if !role.wait_desktop(&channel).await { return; }
|
||||||
|
screen = role.screen_or(&screen);
|
||||||
|
replay_clipboard_echo(channel.clone(), sequence.clone(), replay.clone(), role.clone());
|
||||||
|
}
|
||||||
});
|
});
|
||||||
})
|
})
|
||||||
}));
|
}));
|
||||||
@@ -887,14 +1076,15 @@ impl WebRtcSession {
|
|||||||
|
|
||||||
d.on_message(Box::new(move |msg: DataChannelMessage| {
|
d.on_message(Box::new(move |msg: DataChannelMessage| {
|
||||||
// Keep the whole state: a cached screen waiting for a closed Portal is not ready for input.
|
// Keep the whole state: a cached screen waiting for a closed Portal is not ready for input.
|
||||||
let (screen, desktop_ready) = portal_desktop.as_ref().map_or_else(|| (screen.clone(), true), |desktop| {
|
let (screen, desktop_ready) = portal_desktop.as_ref().map_or_else(|| (channel_role.screen_or(&screen), true), |desktop| {
|
||||||
let state = desktop.snapshot();
|
let state = desktop.snapshot();
|
||||||
let ready = state.ready();
|
let ready = state.ready();
|
||||||
(state.screen, ready)
|
(state.screen, ready)
|
||||||
});
|
});
|
||||||
let channel_name = lbl.clone();
|
let channel_name = lbl.clone();
|
||||||
let input_worker = inp.clone();
|
let input_worker = inp.clone();
|
||||||
let message_input_session=channel_input_session.clone();
|
let message_input_session=channel_role.input();
|
||||||
|
let message_role=channel_role.clone();
|
||||||
let terminal_worker = terminal_conn.clone();
|
let terminal_worker = terminal_conn.clone();
|
||||||
let rpc_out = outbound.clone();
|
let rpc_out = outbound.clone();
|
||||||
let reply_chan = d_reply.clone();
|
let reply_chan = d_reply.clone();
|
||||||
@@ -1128,6 +1318,19 @@ impl WebRtcSession {
|
|||||||
if let Err(e) = chan.send(&bytes::Bytes::from(message)).await { log::warn!("Settings report failed: {}", e); }
|
if let Err(e) = chan.send(&bytes::Bytes::from(message)).await { log::warn!("Settings report failed: {}", e); }
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
} else if action == sa::CAPTURE_DESKTOP && channel_name == "CONTROL_DATA_CHANNEL" {
|
||||||
|
if message_role.is_desktop() && !message_role.stream_ended() {
|
||||||
|
log::info!("SimpleAction 4 (capture_desktop) received on a desktop connection");
|
||||||
|
} else if let Some(request) = message_role.request.get() {
|
||||||
|
if message_role.is_desktop() {
|
||||||
|
log::info!("SimpleAction 4 (capture_desktop) received on a tool connection whose desktop video ended; restarting it");
|
||||||
|
} else {
|
||||||
|
log::info!("SimpleAction 4 (capture_desktop) received on a tool connection; starting the desktop");
|
||||||
|
}
|
||||||
|
request();
|
||||||
|
} else {
|
||||||
|
log::info!("SimpleAction 4 (capture_desktop) not handled: tool connection without a desktop route");
|
||||||
|
}
|
||||||
} else if action > 1 && action != 15 {
|
} else if action > 1 && action != 15 {
|
||||||
let args = action_fields.iter().find_map(|f| match (&f.value, f.number) { (WireValue::Bytes(v), 2) => Some(*v), _ => None }).unwrap_or(&[]);
|
let args = action_fields.iter().find_map(|f| match (&f.value, f.number) { (WireValue::Bytes(v), 2) => Some(*v), _ => None }).unwrap_or(&[]);
|
||||||
log::info!("SimpleAction {} ({}) not handled: args={}", action, crate::control_protocol::simple_action_name(action).unwrap_or("?"), sa::args_shape(args));
|
log::info!("SimpleAction {} ({}) not handled: args={}", action, crate::control_protocol::simple_action_name(action).unwrap_or("?"), sa::args_shape(args));
|
||||||
@@ -1250,10 +1453,53 @@ impl WebRtcSession {
|
|||||||
capture,
|
capture,
|
||||||
input,
|
input,
|
||||||
desktop,
|
desktop,
|
||||||
|
role,
|
||||||
|
controller_mac: false,
|
||||||
context,
|
context,
|
||||||
|
actions: session_actions,
|
||||||
})
|
})
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Route for capture_desktop on this tool peer; the caller decides whether it may become the desktop.
|
||||||
|
pub fn on_desktop_request(&self, request: impl Fn() + Send + Sync + 'static) {
|
||||||
|
let _ = self.role.request.set(Box::new(request));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Makes this tool peer the desktop: it takes the input lease, starts the video it negotiated
|
||||||
|
/// (H.264; audio was never negotiated) and repeats the desktop CONTROL initialization.
|
||||||
|
/// `screen` replaces a capture that was unavailable when the peer was offered.
|
||||||
|
/// A promoted peer whose video ended keeps its input lease and only restarts the video.
|
||||||
|
pub fn promote(&self, screen: Option<Arc<ScreenCapture>>) {
|
||||||
|
let restart = self.role.is_desktop();
|
||||||
|
if restart && !self.role.stream_ended() { return; }
|
||||||
|
if let Some(screen) = screen { *self.role.screen.lock().unwrap() = Some(screen); }
|
||||||
|
if !restart {
|
||||||
|
let session = self.input.desktop_session();
|
||||||
|
if self.pc.connection_state() == RTCPeerConnectionState::Connected { session.connected(); }
|
||||||
|
*self.role.input.lock().unwrap() = Some(session);
|
||||||
|
self.role.active.send_replace(true);
|
||||||
|
}
|
||||||
|
let stream = self.role.stream.lock().unwrap().clone();
|
||||||
|
let task = stream.and_then(|stream| stream.spawn(self.role.screen.lock().unwrap().clone(), self.role.active.subscribe()));
|
||||||
|
if let Some(old) = std::mem::replace(&mut *self.role.stream_task.lock().unwrap(), task) { old.abort(); }
|
||||||
|
if restart { log::info!("Desktop video restarted on a tool connection after its stream ended"); return; }
|
||||||
|
if !cfg!(test) { track_session(self.pc.clone(), self.actions.clone(), &self.role); }
|
||||||
|
log::info!("Desktop started on an existing tool connection");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// The capture this peer's desktop uses: its own, or the one reinitialized at promotion.
|
||||||
|
pub fn desktop_capture(&self) -> Arc<ScreenCapture> { self.role.screen_or(&self.capture) }
|
||||||
|
|
||||||
|
/// A newer desktop took over a promoted tool peer: stop its video, input and session count,
|
||||||
|
/// keep the connection's tools. capture_desktop on it promotes it again.
|
||||||
|
pub fn demote(&self) {
|
||||||
|
if self.desktop || !self.role.is_desktop() { return; }
|
||||||
|
self.role.active.send_replace(false);
|
||||||
|
if let Some(task) = self.role.stream_task.lock().unwrap().take() { task.abort(); }
|
||||||
|
if let Some(session) = self.role.input.lock().unwrap().take() { session.disconnected(); }
|
||||||
|
log::info!("Desktop on a tool connection stopped: a newer desktop took over");
|
||||||
|
}
|
||||||
|
|
||||||
/// 应用远端 Offer,生成并返回 Answer
|
/// 应用远端 Offer,生成并返回 Answer
|
||||||
pub async fn handle_offer(&self, soac: &SoacMessage) -> Result<String, String> {
|
pub async fn handle_offer(&self, soac: &SoacMessage) -> Result<String, String> {
|
||||||
// 同步当前的客户端与房间会话上下文
|
// 同步当前的客户端与房间会话上下文
|
||||||
@@ -1422,6 +1668,11 @@ fn negotiated_bundle_media(sdp: &str) -> Option<(String, u16)> {
|
|||||||
None
|
None
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// First drain owns the outbound receiver; a later open must not start another.
|
||||||
|
async fn take_outbound_once<T>(slot: &tokio::sync::Mutex<Option<tokio::sync::mpsc::UnboundedReceiver<T>>>) -> Option<tokio::sync::mpsc::UnboundedReceiver<T>> {
|
||||||
|
slot.lock().await.take()
|
||||||
|
}
|
||||||
|
|
||||||
#[cfg(test)]
|
#[cfg(test)]
|
||||||
mod tests {
|
mod tests {
|
||||||
use super::negotiated_bundle_media;
|
use super::negotiated_bundle_media;
|
||||||
@@ -1444,6 +1695,16 @@ mod tests {
|
|||||||
let sdp = "a=group:BUNDLE data video\nm=video 9 RTP 98\na=mid:video\nm=application 9 SCTP 0\na=mid:data\n";
|
let sdp = "a=group:BUNDLE data video\nm=video 9 RTP 98\na=mid:video\nm=application 9 SCTP 0\na=mid:data\n";
|
||||||
assert_eq!(negotiated_bundle_media(sdp), Some(("data".into(), 1)));
|
assert_eq!(negotiated_bundle_media(sdp), Some(("data".into(), 1)));
|
||||||
}
|
}
|
||||||
|
#[tokio::test]
|
||||||
|
async fn outbound_receiver_is_taken_once() {
|
||||||
|
let (tx, rx) = tokio::sync::mpsc::unbounded_channel::<Vec<u8>>();
|
||||||
|
let slot = std::sync::Arc::new(tokio::sync::Mutex::new(Some(rx)));
|
||||||
|
let first = super::take_outbound_once(&slot).await;
|
||||||
|
let second = super::take_outbound_once(&slot).await;
|
||||||
|
assert!(first.is_some());
|
||||||
|
assert!(second.is_none());
|
||||||
|
drop(tx);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
#[cfg(test)]
|
#[cfg(test)]
|
||||||
|
|||||||
@@ -0,0 +1,105 @@
|
|||||||
|
//! Socket.IO's WebSocket transport uses the same opt-in proxy policy as the REST client.
|
||||||
|
//! No proxy addresses, room headers, response text or underlying errors are displayed.
|
||||||
|
use std::time::Duration;
|
||||||
|
use reqwest::header::{HeaderMap, CONNECTION, UPGRADE, SEC_WEBSOCKET_ACCEPT, SEC_WEBSOCKET_KEY,
|
||||||
|
SEC_WEBSOCKET_EXTENSIONS, SEC_WEBSOCKET_PROTOCOL};
|
||||||
|
use tokio_tungstenite::{WebSocketStream, tungstenite::{handshake::{client::Request, derive_accept_key}, protocol::Role}};
|
||||||
|
|
||||||
|
pub type Socket = WebSocketStream<reqwest::Upgraded>;
|
||||||
|
|
||||||
|
/// Validate configuration rather than let reqwest silently ignore an unsupported proxy URL.
|
||||||
|
/// Selection/NO_PROXY matching still belongs to reqwest, not a second proxy implementation.
|
||||||
|
fn validate_proxy_url(value: &str) -> Result<(), &'static str> {
|
||||||
|
if value.is_empty() { return Ok(()); }
|
||||||
|
// Match reqwest's system-proxy parser before URL normalization (which would accept
|
||||||
|
// whitespace/Unicode that http::Uri rejects and the connector would silently ignore).
|
||||||
|
let uri: tokio_tungstenite::tungstenite::http::Uri = value.parse().map_err(|_| "Invalid signaling proxy configuration")?;
|
||||||
|
if uri.authority().is_none() { return Err("Invalid signaling proxy configuration"); }
|
||||||
|
let url = if value.contains("://") { reqwest::Url::parse(value) }
|
||||||
|
else { reqwest::Url::parse(&format!("http://{value}")) }
|
||||||
|
.map_err(|_| "Invalid signaling proxy configuration")?;
|
||||||
|
if !matches!(url.scheme(), "http" | "https") || url.host_str().is_none()
|
||||||
|
|| url.port_or_known_default().is_none() || url.path() != "/" || url.query().is_some() || url.fragment().is_some() {
|
||||||
|
return Err("Unsupported signaling proxy configuration (HTTP/HTTPS only)");
|
||||||
|
}
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
fn client() -> Result<reqwest::Client, String> {
|
||||||
|
if crate::auth::proxy_enabled() {
|
||||||
|
let mut configured = false;
|
||||||
|
for names in [["HTTP_PROXY", "http_proxy"], ["HTTPS_PROXY", "https_proxy"], ["ALL_PROXY", "all_proxy"]] {
|
||||||
|
if let Some(value) = names.iter().find_map(std::env::var_os) {
|
||||||
|
let value = value.to_str().ok_or("Invalid signaling proxy configuration")?;
|
||||||
|
validate_proxy_url(value)?;
|
||||||
|
configured |= !value.is_empty();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// reqwest disables environment proxies in CGI contexts; don't silently ignore an opt-in.
|
||||||
|
if configured && std::env::var_os("REQUEST_METHOD").is_some() {
|
||||||
|
return Err("Signaling environment proxies are disabled in CGI contexts".into());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
crate::auth::http_client_builder().http1_only().redirect(reqwest::redirect::Policy::none())
|
||||||
|
.retry(reqwest::retry::never()).build().map_err(|_| "Signaling HTTP client setup failed".into())
|
||||||
|
}
|
||||||
|
|
||||||
|
pub async fn connect(request: Request, timeout: Duration) -> Result<Socket, String> {
|
||||||
|
let client = client()?;
|
||||||
|
match tokio::time::timeout(timeout, connect_with_client(&client, request)).await {
|
||||||
|
Ok(result) => result,
|
||||||
|
Err(_) => Err("WS connect failed: timeout".into()),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn connect_with_client(client: &reqwest::Client, request: Request) -> Result<Socket, String> {
|
||||||
|
let (mut parts, _) = request.into_parts();
|
||||||
|
if parts.method != reqwest::Method::GET || parts.headers.contains_key(SEC_WEBSOCKET_EXTENSIONS)
|
||||||
|
|| parts.headers.contains_key(SEC_WEBSOCKET_PROTOCOL) || parts.headers.contains_key("proxy-authorization") {
|
||||||
|
return Err("Unsupported signaling WebSocket request".into());
|
||||||
|
}
|
||||||
|
let mut url = reqwest::Url::parse(&parts.uri.to_string()).map_err(|_| "Invalid signaling endpoint")?;
|
||||||
|
if !url.username().is_empty() || url.password().is_some() || url.fragment().is_some() {
|
||||||
|
return Err("Invalid signaling endpoint".into());
|
||||||
|
}
|
||||||
|
let scheme = match url.scheme() { "ws" => "http", "wss" => "https", _ => return Err("Unsupported signaling endpoint scheme".into()) };
|
||||||
|
url.set_scheme(scheme).map_err(|_| "Invalid signaling endpoint")?;
|
||||||
|
let key = parts.headers.get(SEC_WEBSOCKET_KEY).ok_or("Missing WebSocket handshake key")?;
|
||||||
|
let accept = derive_accept_key(key.as_bytes());
|
||||||
|
for name in ["x-nrd-auth", "authorization", "cookie"] {
|
||||||
|
if let Some(value) = parts.headers.get_mut(name) { value.set_sensitive(true); }
|
||||||
|
}
|
||||||
|
// reqwest owns DNS/TCP/proxy CONNECT/TLS. No custom relay, direct fallback or redirect.
|
||||||
|
let response = client.get(url).version(reqwest::Version::HTTP_11).headers(parts.headers).send().await
|
||||||
|
.map_err(|e| if e.is_timeout() { "WS connect failed: timeout" } else if e.is_connect() { "WS connect failed: connection" } else { "WS connect failed: request" })?;
|
||||||
|
if response.status() != reqwest::StatusCode::SWITCHING_PROTOCOLS {
|
||||||
|
return Err(format!("WS upgrade refused: http_status={}", response.status().as_u16()));
|
||||||
|
}
|
||||||
|
verify_upgrade(response.version(), response.headers(), &accept)?;
|
||||||
|
let stream = response.upgrade().await.map_err(|_| "WS upgrade failed")?;
|
||||||
|
Ok(WebSocketStream::from_raw_socket(stream, Role::Client, None).await)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// RFC 6455 §4.1: validate before handing upgraded bytes to the frame codec. Socket.IO
|
||||||
|
/// requests no extensions/subprotocols. Unlike a generic HTTP client we never follow redirects.
|
||||||
|
fn verify_upgrade(version: reqwest::Version, headers: &HeaderMap, accept: &str) -> Result<(), &'static str> {
|
||||||
|
let single = |name: reqwest::header::HeaderName| {
|
||||||
|
let mut values = headers.get_all(name).iter();
|
||||||
|
let value = values.next()?.to_str().ok()?;
|
||||||
|
values.next().is_none().then_some(value)
|
||||||
|
};
|
||||||
|
let connection_upgrade = headers.get_all(CONNECTION).iter().all(|value| value.to_str().is_ok())
|
||||||
|
&& headers.get_all(CONNECTION).iter().any(|value|
|
||||||
|
value.to_str().is_ok_and(|value| value.split(',').any(|token| token.trim().eq_ignore_ascii_case("upgrade"))));
|
||||||
|
if version != reqwest::Version::HTTP_11 || !connection_upgrade
|
||||||
|
|| !single(UPGRADE).is_some_and(|v| v.eq_ignore_ascii_case("websocket"))
|
||||||
|
|| single(SEC_WEBSOCKET_ACCEPT) != Some(accept)
|
||||||
|
|| headers.contains_key(SEC_WEBSOCKET_EXTENSIONS) || headers.contains_key(SEC_WEBSOCKET_PROTOCOL) {
|
||||||
|
return Err("Invalid signaling WebSocket upgrade response");
|
||||||
|
}
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
#[path = "ws_transport_tests.rs"]
|
||||||
|
mod tests;
|
||||||
@@ -0,0 +1,245 @@
|
|||||||
|
use super::*;
|
||||||
|
use futures_util::{SinkExt, StreamExt};
|
||||||
|
use tokio::{io::{AsyncRead, AsyncReadExt, AsyncWriteExt}, net::{TcpListener, TcpStream}};
|
||||||
|
use tokio_tungstenite::tungstenite::{client::IntoClientRequest, Message};
|
||||||
|
|
||||||
|
fn request(url: &str) -> Request {
|
||||||
|
let mut request = url.into_client_request().unwrap();
|
||||||
|
request.headers_mut().insert("x-nrd-auth", "fixture-room-secret".parse().unwrap());
|
||||||
|
request
|
||||||
|
}
|
||||||
|
|
||||||
|
fn test_client() -> reqwest::ClientBuilder {
|
||||||
|
reqwest::Client::builder().no_proxy().http1_only()
|
||||||
|
.redirect(reqwest::redirect::Policy::none()).retry(reqwest::retry::never())
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn read_headers<S: AsyncRead + Unpin>(socket: &mut S) -> String {
|
||||||
|
let mut bytes = Vec::new();
|
||||||
|
while !bytes.ends_with(b"\r\n\r\n") {
|
||||||
|
let mut byte = [0];
|
||||||
|
socket.read_exact(&mut byte).await.unwrap();
|
||||||
|
bytes.push(byte[0]);
|
||||||
|
assert!(bytes.len() < 16384);
|
||||||
|
}
|
||||||
|
String::from_utf8(bytes).unwrap()
|
||||||
|
}
|
||||||
|
|
||||||
|
fn header<'a>(request: &'a str, name: &str) -> Option<&'a str> {
|
||||||
|
request.lines().filter_map(|line| line.split_once(':'))
|
||||||
|
.find(|(key, _)| key.eq_ignore_ascii_case(name)).map(|(_, value)| value.trim())
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn accept_upgrade(listener: TcpListener, proxy: bool) -> TcpStream {
|
||||||
|
let (mut socket, _) = listener.accept().await.unwrap();
|
||||||
|
let received = read_headers(&mut socket).await;
|
||||||
|
assert!(received.starts_with(if proxy { "GET http://" } else { "GET /" }));
|
||||||
|
assert!(header(&received, "x-nrd-auth") == Some("fixture-room-secret"));
|
||||||
|
if !proxy { assert!(header(&received, "proxy-authorization").is_none()); }
|
||||||
|
let accept = derive_accept_key(header(&received, "sec-websocket-key").unwrap().as_bytes());
|
||||||
|
let mut response = format!("HTTP/1.1 101 Switching Protocols\r\nConnection: keep-alive, Upgrade\r\nUpgrade: websocket\r\nSec-WebSocket-Accept: {accept}\r\n\r\n").into_bytes();
|
||||||
|
// The first Engine.IO frame shares a single write with the HTTP response.
|
||||||
|
response.extend_from_slice(&[0x81, 3, b'0', b'{', b'}']);
|
||||||
|
socket.write_all(&response).await.unwrap();
|
||||||
|
socket
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn no_connection(listener: &TcpListener) {
|
||||||
|
assert!(tokio::time::timeout(Duration::from_millis(150), listener.accept()).await.is_err());
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn strict_upgrade_validation_accepts_tokens_and_rejects_unsolicited_or_ambiguous_headers() {
|
||||||
|
let mut headers = HeaderMap::new();
|
||||||
|
headers.insert(CONNECTION, "keep-alive, Upgrade".parse().unwrap());
|
||||||
|
headers.insert(UPGRADE, "WebSocket".parse().unwrap());
|
||||||
|
headers.insert(SEC_WEBSOCKET_ACCEPT, "fixture-accept".parse().unwrap());
|
||||||
|
assert!(verify_upgrade(reqwest::Version::HTTP_11, &headers, "fixture-accept").is_ok());
|
||||||
|
headers.append(CONNECTION, "keep-alive".parse().unwrap());
|
||||||
|
assert!(verify_upgrade(reqwest::Version::HTTP_11, &headers, "fixture-accept").is_ok());
|
||||||
|
assert!(verify_upgrade(reqwest::Version::HTTP_2, &headers, "fixture-accept").is_err());
|
||||||
|
assert!(verify_upgrade(reqwest::Version::HTTP_11, &headers, "wrong").is_err());
|
||||||
|
for name in [CONNECTION, UPGRADE, SEC_WEBSOCKET_ACCEPT] {
|
||||||
|
let mut missing = headers.clone(); missing.remove(name);
|
||||||
|
assert!(verify_upgrade(reqwest::Version::HTTP_11, &missing, "fixture-accept").is_err());
|
||||||
|
}
|
||||||
|
for name in [UPGRADE, SEC_WEBSOCKET_ACCEPT, SEC_WEBSOCKET_EXTENSIONS, SEC_WEBSOCKET_PROTOCOL] {
|
||||||
|
let mut invalid = headers.clone(); invalid.append(name, "fixture-server-secret".parse().unwrap());
|
||||||
|
let error = verify_upgrade(reqwest::Version::HTTP_11, &invalid, "fixture-accept").unwrap_err();
|
||||||
|
assert!(!error.contains("fixture"));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn proxy_configuration_errors_never_echo_proxy_values() {
|
||||||
|
for proxy in ["", "127.0.0.1:3128", "http://127.0.0.1:3128", "https://fixture-user:[email protected]:3128"] {
|
||||||
|
assert!(validate_proxy_url(proxy).is_ok());
|
||||||
|
}
|
||||||
|
for proxy in ["socks5://fixture-user:[email protected]:3128", "http://127.0.0.1:3128/?fixture-token", "http://127.0.0.1:3128/#fixture-token", "http://127.0.0.1:3128/fixture-secret", "http://[fixture-invalid", " http://127.0.0.1:3128", "http://127.0.0.1:3128 ", "http://例子.invalid:3128"] {
|
||||||
|
let error = validate_proxy_url(proxy).unwrap_err();
|
||||||
|
assert!(!error.contains("fixture"));
|
||||||
|
assert!(!error.contains("127.0.0.1"));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn upgrade_keeps_prefetched_frame_and_does_not_limit_socket_lifetime() {
|
||||||
|
let listener = TcpListener::bind("127.0.0.1:0").await.unwrap();
|
||||||
|
let url = format!("ws://{}/socket.io/?fixture-query-secret", listener.local_addr().unwrap());
|
||||||
|
let server = tokio::spawn(async move {
|
||||||
|
let socket = accept_upgrade(listener, false).await;
|
||||||
|
let mut socket = WebSocketStream::from_raw_socket(socket, Role::Server, None).await;
|
||||||
|
tokio::time::sleep(Duration::from_millis(1200)).await;
|
||||||
|
assert!(matches!(socket.next().await, Some(Ok(Message::Text(value))) if value == "fixture-client-frame"));
|
||||||
|
socket.send(Message::Text("fixture-late-frame".into())).await.unwrap();
|
||||||
|
});
|
||||||
|
let http = test_client().build().unwrap();
|
||||||
|
let mut socket = tokio::time::timeout(Duration::from_secs(1), connect_with_client(&http, request(&url))).await.unwrap().unwrap();
|
||||||
|
assert!(matches!(socket.next().await, Some(Ok(Message::Text(value))) if value == "0{}"));
|
||||||
|
// A one-second establishment deadline must not remain attached to the upgraded stream.
|
||||||
|
tokio::time::sleep(Duration::from_millis(1300)).await;
|
||||||
|
socket.send(Message::Text("fixture-client-frame".into())).await.unwrap();
|
||||||
|
let message = tokio::time::timeout(Duration::from_secs(3), socket.next()).await.unwrap();
|
||||||
|
assert!(matches!(message, Some(Ok(Message::Text(value))) if value == "fixture-late-frame"));
|
||||||
|
server.await.unwrap();
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn proxy_refusal_never_falls_back_to_origin_or_echoes_server_content() {
|
||||||
|
let origin = TcpListener::bind("127.0.0.1:0").await.unwrap();
|
||||||
|
let proxy = TcpListener::bind("127.0.0.1:0").await.unwrap();
|
||||||
|
let proxy_url = format!("http://{}", proxy.local_addr().unwrap());
|
||||||
|
let server = tokio::spawn(async move {
|
||||||
|
let (mut socket, _) = proxy.accept().await.unwrap();
|
||||||
|
let received = read_headers(&mut socket).await;
|
||||||
|
assert!(received.starts_with("GET http://"));
|
||||||
|
assert!(header(&received, "proxy-authorization").is_some());
|
||||||
|
socket.write_all(b"HTTP/1.1 407 Proxy Authentication Required\r\nContent-Length: 19\r\n\r\nfixture-body-secret").await.unwrap();
|
||||||
|
});
|
||||||
|
let proxy = reqwest::Proxy::all(proxy_url).unwrap().basic_auth("fixture-user", "fixture-proxy-secret");
|
||||||
|
let http = test_client().proxy(proxy).build().unwrap();
|
||||||
|
let result = tokio::time::timeout(Duration::from_secs(5),
|
||||||
|
connect_with_client(&http, request(&format!("ws://{}/fixture-path-secret", origin.local_addr().unwrap()))))
|
||||||
|
.await.expect("proxy refusal must not wait on a fallback origin");
|
||||||
|
let error = result.err().expect("proxy refusal must fail");
|
||||||
|
assert!(error.contains("407")); assert!(!error.contains("fixture"));
|
||||||
|
no_connection(&origin).await;
|
||||||
|
server.await.unwrap();
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn redirects_are_not_followed_with_room_credentials() {
|
||||||
|
let origin = TcpListener::bind("127.0.0.1:0").await.unwrap();
|
||||||
|
let destination = TcpListener::bind("127.0.0.1:0").await.unwrap();
|
||||||
|
let url = format!("ws://{}/socket.io/", origin.local_addr().unwrap());
|
||||||
|
let location = format!("http://{}/fixture-redirect-secret", destination.local_addr().unwrap());
|
||||||
|
let server = tokio::spawn(async move {
|
||||||
|
let (mut socket, _) = origin.accept().await.unwrap();
|
||||||
|
let _ = read_headers(&mut socket).await;
|
||||||
|
socket.write_all(format!("HTTP/1.1 302 Found\r\nLocation: {location}\r\nContent-Length: 0\r\n\r\n").as_bytes()).await.unwrap();
|
||||||
|
});
|
||||||
|
let result = tokio::time::timeout(Duration::from_secs(5),
|
||||||
|
connect_with_client(&test_client().build().unwrap(), request(&url)))
|
||||||
|
.await.expect("redirect must not wait on its destination");
|
||||||
|
let error = result.err().expect("redirect must fail");
|
||||||
|
assert!(error.contains("302")); assert!(!error.contains("fixture"));
|
||||||
|
no_connection(&destination).await;
|
||||||
|
server.await.unwrap();
|
||||||
|
}
|
||||||
|
|
||||||
|
// No global environment mutation: the subprocess has only synthetic loopback configuration.
|
||||||
|
#[test]
|
||||||
|
fn environment_policy_probe() {
|
||||||
|
let Ok(url) = std::env::var("UU_WS_TEST_ENDPOINT") else { return; };
|
||||||
|
assert!(url.starts_with("ws://127.0.0.1:"));
|
||||||
|
let runtime = tokio::runtime::Builder::new_current_thread().enable_all().build().unwrap();
|
||||||
|
runtime.block_on(async {
|
||||||
|
let mut socket = connect(request(&url), Duration::from_secs(5)).await.expect("fixture connection failed");
|
||||||
|
let message = tokio::time::timeout(Duration::from_secs(3), socket.next()).await.unwrap();
|
||||||
|
assert!(matches!(message, Some(Ok(Message::Text(value))) if value == "0{}"));
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn environment_proxy_opt_in_and_no_proxy_match_rest_policy() {
|
||||||
|
for (opt_in, bypass, via_proxy) in [(false, false, false), (true, false, true), (true, true, false)] {
|
||||||
|
let origin = TcpListener::bind("127.0.0.1:0").await.unwrap();
|
||||||
|
let proxy = TcpListener::bind("127.0.0.1:0").await.unwrap();
|
||||||
|
let url = format!("ws://{}/socket.io/", origin.local_addr().unwrap());
|
||||||
|
let proxy_url = format!("http://fixture-user:fixture-proxy-secret@{}", proxy.local_addr().unwrap());
|
||||||
|
let (selected, unused) = if via_proxy { (proxy, origin) } else { (origin, proxy) };
|
||||||
|
let server = tokio::spawn(async move { let _socket = accept_upgrade(selected, via_proxy).await; });
|
||||||
|
let mut child = tokio::process::Command::new(std::env::current_exe().unwrap());
|
||||||
|
child.args(["--exact", "ws_transport::tests::environment_policy_probe", "--nocapture"])
|
||||||
|
.env_clear().env("UU_WS_TEST_ENDPOINT", url).env("HTTP_PROXY", proxy_url);
|
||||||
|
if opt_in { child.env("UU_USE_PROXY", "1"); }
|
||||||
|
if bypass { child.env("NO_PROXY", "127.0.0.1"); }
|
||||||
|
let output = tokio::time::timeout(Duration::from_secs(10), child.output()).await.unwrap().unwrap();
|
||||||
|
assert!(output.status.success(), "isolated proxy-policy subprocess failed");
|
||||||
|
assert!(!output.stdout.windows(b"fixture-room-secret".len()).any(|s| s == b"fixture-room-secret"));
|
||||||
|
assert!(!output.stderr.windows(b"fixture-proxy-secret".len()).any(|s| s == b"fixture-proxy-secret"));
|
||||||
|
no_connection(&unused).await;
|
||||||
|
server.await.unwrap();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn wss_connect_keeps_origin_auth_inside_tls_and_requires_trusted_certificate() {
|
||||||
|
use std::sync::Arc;
|
||||||
|
use tokio_rustls::{rustls, TlsAcceptor};
|
||||||
|
use rustls::pki_types::{CertificateDer, PrivateKeyDer, PrivatePkcs8KeyDer};
|
||||||
|
// A fresh test certificate/key, kept only in memory. The mock does not relay anywhere:
|
||||||
|
// it accepts CONNECT and then speaks TLS + WebSocket on that same loopback socket.
|
||||||
|
let cert = rcgen::generate_simple_self_signed(vec!["localhost".into()]).unwrap();
|
||||||
|
let cert_der = cert.serialize_der().unwrap();
|
||||||
|
let root = reqwest::Certificate::from_der(&cert_der).unwrap();
|
||||||
|
let config = rustls::ServerConfig::builder_with_provider(Arc::new(rustls::crypto::ring::default_provider()))
|
||||||
|
.with_safe_default_protocol_versions().unwrap().with_no_client_auth()
|
||||||
|
.with_single_cert(vec![CertificateDer::from(cert_der)],
|
||||||
|
PrivateKeyDer::Pkcs8(PrivatePkcs8KeyDer::from(cert.serialize_private_key_der()))).unwrap();
|
||||||
|
let acceptor = TlsAcceptor::from(Arc::new(config));
|
||||||
|
for trusted in [false, true] {
|
||||||
|
let origin = TcpListener::bind("127.0.0.1:0").await.unwrap();
|
||||||
|
let proxy = TcpListener::bind("127.0.0.1:0").await.unwrap();
|
||||||
|
let port = origin.local_addr().unwrap().port();
|
||||||
|
let proxy_url = format!("http://{}", proxy.local_addr().unwrap());
|
||||||
|
let acceptor = acceptor.clone();
|
||||||
|
let server = tokio::spawn(async move {
|
||||||
|
let (mut socket, _) = proxy.accept().await.unwrap();
|
||||||
|
let received = read_headers(&mut socket).await;
|
||||||
|
assert!(received.starts_with(&format!("CONNECT localhost:{port} HTTP/1.1\r\n")));
|
||||||
|
assert!(header(&received, "x-nrd-auth").is_none());
|
||||||
|
assert!(header(&received, "proxy-authorization").is_some());
|
||||||
|
assert!(!received.contains("fixture-room-secret"));
|
||||||
|
socket.write_all(b"HTTP/1.1 200 Connection Established\r\n\r\n").await.unwrap();
|
||||||
|
let tls = acceptor.accept(socket).await;
|
||||||
|
if !trusted { assert!(tls.is_err()); return; }
|
||||||
|
let mut tls = tls.expect("fixture TLS handshake failed");
|
||||||
|
let received = read_headers(&mut tls).await;
|
||||||
|
assert!(received.starts_with("GET /socket.io/"));
|
||||||
|
assert!(header(&received, "x-nrd-auth") == Some("fixture-room-secret"));
|
||||||
|
assert!(header(&received, "proxy-authorization").is_none());
|
||||||
|
assert!(!received.contains("fixture-proxy-secret"));
|
||||||
|
let accept = derive_accept_key(header(&received, "sec-websocket-key").unwrap().as_bytes());
|
||||||
|
let mut response = format!("HTTP/1.1 101 Switching Protocols\r\nConnection: Upgrade\r\nUpgrade: websocket\r\nSec-WebSocket-Accept: {accept}\r\n\r\n").into_bytes();
|
||||||
|
response.extend_from_slice(&[0x81, 3, b'0', b'{', b'}']);
|
||||||
|
tls.write_all(&response).await.unwrap();
|
||||||
|
});
|
||||||
|
let proxy = reqwest::Proxy::all(proxy_url).unwrap().basic_auth("fixture-user", "fixture-proxy-secret");
|
||||||
|
let mut builder = test_client().proxy(proxy);
|
||||||
|
if trusted { builder = builder.add_root_certificate(root.clone()); }
|
||||||
|
let client = builder.build().unwrap();
|
||||||
|
let result = tokio::time::timeout(Duration::from_secs(5),
|
||||||
|
connect_with_client(&client, request(&format!("wss://localhost:{port}/socket.io/?fixture-query-secret")))).await.unwrap();
|
||||||
|
if trusted {
|
||||||
|
let mut socket = result.expect("trusted fixture WebSocket failed");
|
||||||
|
let message = tokio::time::timeout(Duration::from_secs(3), socket.next()).await.unwrap();
|
||||||
|
assert!(matches!(message, Some(Ok(Message::Text(value))) if value == "0{}"));
|
||||||
|
} else {
|
||||||
|
let error = result.err().expect("untrusted fixture certificate must fail");
|
||||||
|
assert!(!error.contains("fixture")); assert!(!error.contains("localhost"));
|
||||||
|
}
|
||||||
|
no_connection(&origin).await;
|
||||||
|
tokio::time::timeout(Duration::from_secs(5), server).await.unwrap().unwrap();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
# Generated by Cargo
|
||||||
|
# will have compiled files and executables
|
||||||
|
/target/
|
||||||
|
/.idea/
|
||||||
|
|
||||||
|
# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
|
||||||
|
# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
|
||||||
|
Cargo.lock
|
||||||
|
|
||||||
|
# These are backup files generated by rustfmt
|
||||||
|
**/*.rs.bk
|
||||||
Vendored
+49
@@ -0,0 +1,49 @@
|
|||||||
|
# webrtc-ice changelog
|
||||||
|
|
||||||
|
## Unreleased
|
||||||
|
|
||||||
|
### Breaking changes
|
||||||
|
|
||||||
|
* remove non used `MulticastDnsMode::Unspecified` variant [#404](https://github.com/webrtc-rs/webrtc/pull/404):
|
||||||
|
|
||||||
|
## v0.9.0
|
||||||
|
|
||||||
|
* Increased minimum support rust version to `1.60.0`.
|
||||||
|
|
||||||
|
### Breaking changes
|
||||||
|
|
||||||
|
* Make functions non-async [#338](https://github.com/webrtc-rs/webrtc/pull/338):
|
||||||
|
- `Agent`:
|
||||||
|
- `get_bytes_received`;
|
||||||
|
- `get_bytes_sent`;
|
||||||
|
- `on_connection_state_change`;
|
||||||
|
- `on_selected_candidate_pair_change`;
|
||||||
|
- `on_candidate`;
|
||||||
|
- `add_remote_candidate`;
|
||||||
|
- `gather_candidates`.
|
||||||
|
- `unmarshal_candidate`;
|
||||||
|
- `CandidateHostConfig::new_candidate_host`;
|
||||||
|
- `CandidatePeerReflexiveConfig::new_candidate_peer_reflexive`;
|
||||||
|
- `CandidateRelayConfig::new_candidate_relay`;
|
||||||
|
- `CandidateServerReflexiveConfig::new_candidate_server_reflexive`;
|
||||||
|
- `Candidate`:
|
||||||
|
- `addr`;
|
||||||
|
- `set_ip`.
|
||||||
|
|
||||||
|
## v0.8.2
|
||||||
|
|
||||||
|
* Add IP filter to ICE `AgentConfig` [#306](https://github.com/webrtc-rs/webrtc/pull/306) and [#318](https://github.com/webrtc-rs/webrtc/pull/318).
|
||||||
|
* Add `rust-version` at 1.57.0 to `Cargo.toml`. This was already the minimum version so does not constitute a change.
|
||||||
|
|
||||||
|
## v0.8.1
|
||||||
|
|
||||||
|
This release was released in error and contains no changes from 0.8.0.
|
||||||
|
|
||||||
|
## v0.8.0
|
||||||
|
|
||||||
|
* Increased min version of `log` dependency to `0.4.16`. [#250 Fix log at ^0.4.16 to make tests compile](https://github.com/webrtc-rs/webrtc/pull/250) by [@k0nserv](https://github.com/k0nserv).
|
||||||
|
* Increased serde's minimum version to 1.0.102 [#243 Fixes for cargo minimal-versions](https://github.com/webrtc-rs/webrtc/pull/243) contributed by [algesten](https://github.com/algesten)
|
||||||
|
|
||||||
|
## Prior to 0.8.0
|
||||||
|
|
||||||
|
Before 0.8.0 there was no changelog, previous changes are sometimes, but not always, available in the [GitHub Releases](https://github.com/webrtc-rs/ice/releases).
|
||||||
Vendored
+122
@@ -0,0 +1,122 @@
|
|||||||
|
# THIS FILE IS AUTOMATICALLY GENERATED BY CARGO
|
||||||
|
#
|
||||||
|
# When uploading crates to the registry Cargo will automatically
|
||||||
|
# "normalize" Cargo.toml files for maximal compatibility
|
||||||
|
# with all versions of Cargo and also rewrite `path` dependencies
|
||||||
|
# to registry (e.g., crates.io) dependencies.
|
||||||
|
#
|
||||||
|
# If you are reading this file be aware that the original Cargo.toml
|
||||||
|
# will likely look very different (and much more reasonable).
|
||||||
|
# See Cargo.toml.orig for the original contents.
|
||||||
|
|
||||||
|
[package]
|
||||||
|
edition = "2021"
|
||||||
|
name = "webrtc-ice"
|
||||||
|
version = "0.10.1"
|
||||||
|
authors = ["Rain Liu <[email protected]>"]
|
||||||
|
description = "A pure Rust implementation of ICE"
|
||||||
|
homepage = "https://webrtc.rs"
|
||||||
|
documentation = "https://docs.rs/webrtc-ice"
|
||||||
|
readme = "README.md"
|
||||||
|
license = "MIT OR Apache-2.0"
|
||||||
|
repository = "https://github.com/webrtc-rs/ice"
|
||||||
|
|
||||||
|
[[example]]
|
||||||
|
name = "ping_pong"
|
||||||
|
path = "examples/ping_pong.rs"
|
||||||
|
bench = false
|
||||||
|
|
||||||
|
[dependencies.arc-swap]
|
||||||
|
version = "1"
|
||||||
|
|
||||||
|
[dependencies.async-trait]
|
||||||
|
version = "0.1"
|
||||||
|
|
||||||
|
[dependencies.crc]
|
||||||
|
version = "3"
|
||||||
|
|
||||||
|
[dependencies.log]
|
||||||
|
version = "0.4"
|
||||||
|
|
||||||
|
[dependencies.mdns]
|
||||||
|
version = "0.6.1"
|
||||||
|
package = "webrtc-mdns"
|
||||||
|
|
||||||
|
[dependencies.rand]
|
||||||
|
version = "0.8"
|
||||||
|
|
||||||
|
[dependencies.serde]
|
||||||
|
version = "1"
|
||||||
|
features = ["derive"]
|
||||||
|
|
||||||
|
[dependencies.serde_json]
|
||||||
|
version = "1"
|
||||||
|
|
||||||
|
[dependencies.stun]
|
||||||
|
version = "0.5.1"
|
||||||
|
|
||||||
|
[dependencies.thiserror]
|
||||||
|
version = "1"
|
||||||
|
|
||||||
|
[dependencies.tokio]
|
||||||
|
version = "1.32.0"
|
||||||
|
features = ["full"]
|
||||||
|
|
||||||
|
[dependencies.tokio-rustls]
|
||||||
|
version = "0.26.6"
|
||||||
|
default-features = false
|
||||||
|
features = ["ring", "tls12"]
|
||||||
|
|
||||||
|
[dependencies.turn]
|
||||||
|
version = "0.7.1"
|
||||||
|
|
||||||
|
[dependencies.url]
|
||||||
|
version = "2"
|
||||||
|
|
||||||
|
[dependencies.util]
|
||||||
|
version = "0.8.1"
|
||||||
|
features = [
|
||||||
|
"conn",
|
||||||
|
"vnet",
|
||||||
|
"sync",
|
||||||
|
]
|
||||||
|
default-features = false
|
||||||
|
package = "webrtc-util"
|
||||||
|
|
||||||
|
[dependencies.uuid]
|
||||||
|
version = "1"
|
||||||
|
features = ["v4"]
|
||||||
|
|
||||||
|
[dependencies.waitgroup]
|
||||||
|
version = "0.1"
|
||||||
|
|
||||||
|
[dependencies.webpki-roots]
|
||||||
|
version = "1"
|
||||||
|
|
||||||
|
[dev-dependencies.chrono]
|
||||||
|
version = "0.4.28"
|
||||||
|
|
||||||
|
[dev-dependencies.clap]
|
||||||
|
version = "3"
|
||||||
|
|
||||||
|
[dev-dependencies.env_logger]
|
||||||
|
version = "0.10"
|
||||||
|
|
||||||
|
[dev-dependencies.hyper]
|
||||||
|
version = "0.14.27"
|
||||||
|
features = ["full"]
|
||||||
|
|
||||||
|
[dev-dependencies.ipnet]
|
||||||
|
version = "2"
|
||||||
|
|
||||||
|
[dev-dependencies.lazy_static]
|
||||||
|
version = "1"
|
||||||
|
|
||||||
|
[dev-dependencies.regex]
|
||||||
|
version = "1.9.5"
|
||||||
|
|
||||||
|
[dev-dependencies.sha1]
|
||||||
|
version = "0.10"
|
||||||
|
|
||||||
|
[dev-dependencies.tokio-test]
|
||||||
|
version = "0.4"
|
||||||
+45
@@ -0,0 +1,45 @@
|
|||||||
|
[package]
|
||||||
|
name = "webrtc-ice"
|
||||||
|
version = "0.10.1"
|
||||||
|
authors = ["Rain Liu <[email protected]>"]
|
||||||
|
edition = "2021"
|
||||||
|
description = "A pure Rust implementation of ICE"
|
||||||
|
license = "MIT OR Apache-2.0"
|
||||||
|
documentation = "https://docs.rs/webrtc-ice"
|
||||||
|
homepage = "https://webrtc.rs"
|
||||||
|
repository = "https://github.com/webrtc-rs/ice"
|
||||||
|
|
||||||
|
[dependencies]
|
||||||
|
util = { version = "0.8.1", path = "../util", package = "webrtc-util", default-features = false, features = ["conn", "vnet", "sync"] }
|
||||||
|
turn = { version = "0.7.1", path = "../turn" }
|
||||||
|
stun = { version = "0.5.1", path = "../stun" }
|
||||||
|
mdns = { version = "0.6.1", path = "../mdns", package = "webrtc-mdns" }
|
||||||
|
|
||||||
|
arc-swap = "1"
|
||||||
|
async-trait = "0.1"
|
||||||
|
crc = "3"
|
||||||
|
log = "0.4"
|
||||||
|
rand = "0.8"
|
||||||
|
serde = { version = "1", features = ["derive"] }
|
||||||
|
serde_json = "1"
|
||||||
|
thiserror = "1"
|
||||||
|
tokio = { version = "1.32.0", features = ["full"] }
|
||||||
|
url = "2"
|
||||||
|
uuid = { version = "1", features = ["v4"] }
|
||||||
|
waitgroup = "0.1"
|
||||||
|
|
||||||
|
[dev-dependencies]
|
||||||
|
tokio-test = "0.4"
|
||||||
|
regex = "1.9.5"
|
||||||
|
env_logger = "0.10"
|
||||||
|
chrono = "0.4.28"
|
||||||
|
ipnet = "2"
|
||||||
|
clap = "3"
|
||||||
|
lazy_static = "1"
|
||||||
|
hyper = { version = "0.14.27", features = ["full"] }
|
||||||
|
sha1 = "0.10"
|
||||||
|
|
||||||
|
[[example]]
|
||||||
|
name = "ping_pong"
|
||||||
|
path = "examples/ping_pong.rs"
|
||||||
|
bench = false
|
||||||
Vendored
+201
@@ -0,0 +1,201 @@
|
|||||||
|
Apache License
|
||||||
|
Version 2.0, January 2004
|
||||||
|
http://www.apache.org/licenses/
|
||||||
|
|
||||||
|
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
||||||
|
|
||||||
|
1. Definitions.
|
||||||
|
|
||||||
|
"License" shall mean the terms and conditions for use, reproduction,
|
||||||
|
and distribution as defined by Sections 1 through 9 of this document.
|
||||||
|
|
||||||
|
"Licensor" shall mean the copyright owner or entity authorized by
|
||||||
|
the copyright owner that is granting the License.
|
||||||
|
|
||||||
|
"Legal Entity" shall mean the union of the acting entity and all
|
||||||
|
other entities that control, are controlled by, or are under common
|
||||||
|
control with that entity. For the purposes of this definition,
|
||||||
|
"control" means (i) the power, direct or indirect, to cause the
|
||||||
|
direction or management of such entity, whether by contract or
|
||||||
|
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
||||||
|
outstanding shares, or (iii) beneficial ownership of such entity.
|
||||||
|
|
||||||
|
"You" (or "Your") shall mean an individual or Legal Entity
|
||||||
|
exercising permissions granted by this License.
|
||||||
|
|
||||||
|
"Source" form shall mean the preferred form for making modifications,
|
||||||
|
including but not limited to software source code, documentation
|
||||||
|
source, and configuration files.
|
||||||
|
|
||||||
|
"Object" form shall mean any form resulting from mechanical
|
||||||
|
transformation or translation of a Source form, including but
|
||||||
|
not limited to compiled object code, generated documentation,
|
||||||
|
and conversions to other media types.
|
||||||
|
|
||||||
|
"Work" shall mean the work of authorship, whether in Source or
|
||||||
|
Object form, made available under the License, as indicated by a
|
||||||
|
copyright notice that is included in or attached to the work
|
||||||
|
(an example is provided in the Appendix below).
|
||||||
|
|
||||||
|
"Derivative Works" shall mean any work, whether in Source or Object
|
||||||
|
form, that is based on (or derived from) the Work and for which the
|
||||||
|
editorial revisions, annotations, elaborations, or other modifications
|
||||||
|
represent, as a whole, an original work of authorship. For the purposes
|
||||||
|
of this License, Derivative Works shall not include works that remain
|
||||||
|
separable from, or merely link (or bind by name) to the interfaces of,
|
||||||
|
the Work and Derivative Works thereof.
|
||||||
|
|
||||||
|
"Contribution" shall mean any work of authorship, including
|
||||||
|
the original version of the Work and any modifications or additions
|
||||||
|
to that Work or Derivative Works thereof, that is intentionally
|
||||||
|
submitted to Licensor for inclusion in the Work by the copyright owner
|
||||||
|
or by an individual or Legal Entity authorized to submit on behalf of
|
||||||
|
the copyright owner. For the purposes of this definition, "submitted"
|
||||||
|
means any form of electronic, verbal, or written communication sent
|
||||||
|
to the Licensor or its representatives, including but not limited to
|
||||||
|
communication on electronic mailing lists, source code control systems,
|
||||||
|
and issue tracking systems that are managed by, or on behalf of, the
|
||||||
|
Licensor for the purpose of discussing and improving the Work, but
|
||||||
|
excluding communication that is conspicuously marked or otherwise
|
||||||
|
designated in writing by the copyright owner as "Not a Contribution."
|
||||||
|
|
||||||
|
"Contributor" shall mean Licensor and any individual or Legal Entity
|
||||||
|
on behalf of whom a Contribution has been received by Licensor and
|
||||||
|
subsequently incorporated within the Work.
|
||||||
|
|
||||||
|
2. Grant of Copyright License. Subject to the terms and conditions of
|
||||||
|
this License, each Contributor hereby grants to You a perpetual,
|
||||||
|
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
||||||
|
copyright license to reproduce, prepare Derivative Works of,
|
||||||
|
publicly display, publicly perform, sublicense, and distribute the
|
||||||
|
Work and such Derivative Works in Source or Object form.
|
||||||
|
|
||||||
|
3. Grant of Patent License. Subject to the terms and conditions of
|
||||||
|
this License, each Contributor hereby grants to You a perpetual,
|
||||||
|
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
||||||
|
(except as stated in this section) patent license to make, have made,
|
||||||
|
use, offer to sell, sell, import, and otherwise transfer the Work,
|
||||||
|
where such license applies only to those patent claims licensable
|
||||||
|
by such Contributor that are necessarily infringed by their
|
||||||
|
Contribution(s) alone or by combination of their Contribution(s)
|
||||||
|
with the Work to which such Contribution(s) was submitted. If You
|
||||||
|
institute patent litigation against any entity (including a
|
||||||
|
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
||||||
|
or a Contribution incorporated within the Work constitutes direct
|
||||||
|
or contributory patent infringement, then any patent licenses
|
||||||
|
granted to You under this License for that Work shall terminate
|
||||||
|
as of the date such litigation is filed.
|
||||||
|
|
||||||
|
4. Redistribution. You may reproduce and distribute copies of the
|
||||||
|
Work or Derivative Works thereof in any medium, with or without
|
||||||
|
modifications, and in Source or Object form, provided that You
|
||||||
|
meet the following conditions:
|
||||||
|
|
||||||
|
(a) You must give any other recipients of the Work or
|
||||||
|
Derivative Works a copy of this License; and
|
||||||
|
|
||||||
|
(b) You must cause any modified files to carry prominent notices
|
||||||
|
stating that You changed the files; and
|
||||||
|
|
||||||
|
(c) You must retain, in the Source form of any Derivative Works
|
||||||
|
that You distribute, all copyright, patent, trademark, and
|
||||||
|
attribution notices from the Source form of the Work,
|
||||||
|
excluding those notices that do not pertain to any part of
|
||||||
|
the Derivative Works; and
|
||||||
|
|
||||||
|
(d) If the Work includes a "NOTICE" text file as part of its
|
||||||
|
distribution, then any Derivative Works that You distribute must
|
||||||
|
include a readable copy of the attribution notices contained
|
||||||
|
within such NOTICE file, excluding those notices that do not
|
||||||
|
pertain to any part of the Derivative Works, in at least one
|
||||||
|
of the following places: within a NOTICE text file distributed
|
||||||
|
as part of the Derivative Works; within the Source form or
|
||||||
|
documentation, if provided along with the Derivative Works; or,
|
||||||
|
within a display generated by the Derivative Works, if and
|
||||||
|
wherever such third-party notices normally appear. The contents
|
||||||
|
of the NOTICE file are for informational purposes only and
|
||||||
|
do not modify the License. You may add Your own attribution
|
||||||
|
notices within Derivative Works that You distribute, alongside
|
||||||
|
or as an addendum to the NOTICE text from the Work, provided
|
||||||
|
that such additional attribution notices cannot be construed
|
||||||
|
as modifying the License.
|
||||||
|
|
||||||
|
You may add Your own copyright statement to Your modifications and
|
||||||
|
may provide additional or different license terms and conditions
|
||||||
|
for use, reproduction, or distribution of Your modifications, or
|
||||||
|
for any such Derivative Works as a whole, provided Your use,
|
||||||
|
reproduction, and distribution of the Work otherwise complies with
|
||||||
|
the conditions stated in this License.
|
||||||
|
|
||||||
|
5. Submission of Contributions. Unless You explicitly state otherwise,
|
||||||
|
any Contribution intentionally submitted for inclusion in the Work
|
||||||
|
by You to the Licensor shall be under the terms and conditions of
|
||||||
|
this License, without any additional terms or conditions.
|
||||||
|
Notwithstanding the above, nothing herein shall supersede or modify
|
||||||
|
the terms of any separate license agreement you may have executed
|
||||||
|
with Licensor regarding such Contributions.
|
||||||
|
|
||||||
|
6. Trademarks. This License does not grant permission to use the trade
|
||||||
|
names, trademarks, service marks, or product names of the Licensor,
|
||||||
|
except as required for reasonable and customary use in describing the
|
||||||
|
origin of the Work and reproducing the content of the NOTICE file.
|
||||||
|
|
||||||
|
7. Disclaimer of Warranty. Unless required by applicable law or
|
||||||
|
agreed to in writing, Licensor provides the Work (and each
|
||||||
|
Contributor provides its Contributions) on an "AS IS" BASIS,
|
||||||
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
||||||
|
implied, including, without limitation, any warranties or conditions
|
||||||
|
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
||||||
|
PARTICULAR PURPOSE. You are solely responsible for determining the
|
||||||
|
appropriateness of using or redistributing the Work and assume any
|
||||||
|
risks associated with Your exercise of permissions under this License.
|
||||||
|
|
||||||
|
8. Limitation of Liability. In no event and under no legal theory,
|
||||||
|
whether in tort (including negligence), contract, or otherwise,
|
||||||
|
unless required by applicable law (such as deliberate and grossly
|
||||||
|
negligent acts) or agreed to in writing, shall any Contributor be
|
||||||
|
liable to You for damages, including any direct, indirect, special,
|
||||||
|
incidental, or consequential damages of any character arising as a
|
||||||
|
result of this License or out of the use or inability to use the
|
||||||
|
Work (including but not limited to damages for loss of goodwill,
|
||||||
|
work stoppage, computer failure or malfunction, or any and all
|
||||||
|
other commercial damages or losses), even if such Contributor
|
||||||
|
has been advised of the possibility of such damages.
|
||||||
|
|
||||||
|
9. Accepting Warranty or Additional Liability. While redistributing
|
||||||
|
the Work or Derivative Works thereof, You may choose to offer,
|
||||||
|
and charge a fee for, acceptance of support, warranty, indemnity,
|
||||||
|
or other liability obligations and/or rights consistent with this
|
||||||
|
License. However, in accepting such obligations, You may act only
|
||||||
|
on Your own behalf and on Your sole responsibility, not on behalf
|
||||||
|
of any other Contributor, and only if You agree to indemnify,
|
||||||
|
defend, and hold each Contributor harmless for any liability
|
||||||
|
incurred by, or claims asserted against, such Contributor by reason
|
||||||
|
of your accepting any such warranty or additional liability.
|
||||||
|
|
||||||
|
END OF TERMS AND CONDITIONS
|
||||||
|
|
||||||
|
APPENDIX: How to apply the Apache License to your work.
|
||||||
|
|
||||||
|
To apply the Apache License to your work, attach the following
|
||||||
|
boilerplate notice, with the fields enclosed by brackets "[]"
|
||||||
|
replaced with your own identifying information. (Don't include
|
||||||
|
the brackets!) The text should be enclosed in the appropriate
|
||||||
|
comment syntax for the file format. We also recommend that a
|
||||||
|
file or class name and description of purpose be included on the
|
||||||
|
same "printed page" as the copyright notice for easier
|
||||||
|
identification within third-party archives.
|
||||||
|
|
||||||
|
Copyright [yyyy] [name of copyright owner]
|
||||||
|
|
||||||
|
Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
you may not use this file except in compliance with the License.
|
||||||
|
You may obtain a copy of the License at
|
||||||
|
|
||||||
|
http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
|
||||||
|
Unless required by applicable law or agreed to in writing, software
|
||||||
|
distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
See the License for the specific language governing permissions and
|
||||||
|
limitations under the License.
|
||||||
Vendored
+21
@@ -0,0 +1,21 @@
|
|||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) 2021 WebRTC.rs
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all
|
||||||
|
copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||||
|
SOFTWARE.
|
||||||
Vendored
+13
@@ -0,0 +1,13 @@
|
|||||||
|
# Local patch to webrtc-ice 0.10.1
|
||||||
|
|
||||||
|
Source: crates.io webrtc-ice 0.10.1 (MIT / Apache-2.0; upstream licenses retained).
|
||||||
|
|
||||||
|
Upstream gathers relay candidates only for `turn:` over UDP and logs "Unable to handle URL" for
|
||||||
|
`turn:?transport=tcp` and `turns:`. NetEase sessions that force relaying also offer
|
||||||
|
`turns:<host>:<port>?transport=tcp`, which is the only media path on hosts whose UDP cannot reach
|
||||||
|
the TURN servers but whose TCP goes through an HTTP proxy.
|
||||||
|
|
||||||
|
`src/agent/turn_tcp.rs` opens TCP (directly, or through an HTTP CONNECT proxy set by the
|
||||||
|
application with `set_relay_transport`), adds TLS for `turns:`, and exposes the stream to the
|
||||||
|
unchanged `turn` client as datagrams: one STUN message or ChannelData frame (with its 4-byte TCP
|
||||||
|
padding) per read. `agent_gather.rs` uses it for `ProtoType::Tcp` URLs. UDP gathering is unchanged.
|
||||||
Vendored
+30
@@ -0,0 +1,30 @@
|
|||||||
|
<h1 align="center">
|
||||||
|
<a href="https://webrtc.rs"><img src="./doc/webrtc.rs.png" alt="WebRTC.rs"></a>
|
||||||
|
<br>
|
||||||
|
</h1>
|
||||||
|
<p align="center">
|
||||||
|
<a href="https://github.com/webrtc-rs/ice/actions">
|
||||||
|
<img src="https://github.com/webrtc-rs/ice/workflows/cargo/badge.svg">
|
||||||
|
</a>
|
||||||
|
<a href="https://codecov.io/gh/webrtc-rs/ice">
|
||||||
|
<img src="https://codecov.io/gh/webrtc-rs/ice/branch/main/graph/badge.svg">
|
||||||
|
</a>
|
||||||
|
<a href="https://deps.rs/repo/github/webrtc-rs/ice">
|
||||||
|
<img src="https://deps.rs/repo/github/webrtc-rs/ice/status.svg">
|
||||||
|
</a>
|
||||||
|
<a href="https://crates.io/crates/webrtc-ice">
|
||||||
|
<img src="https://img.shields.io/crates/v/webrtc-ice.svg">
|
||||||
|
</a>
|
||||||
|
<a href="https://docs.rs/webrtc-ice">
|
||||||
|
<img src="https://docs.rs/webrtc-ice/badge.svg">
|
||||||
|
</a>
|
||||||
|
<a href="https://doc.rust-lang.org/1.6.0/complement-project-faq.html#why-dual-mitasl2-license">
|
||||||
|
<img src="https://img.shields.io/badge/license-MIT%2FApache--2.0-blue" alt="License: MIT/Apache 2.0">
|
||||||
|
</a>
|
||||||
|
<a href="https://discord.gg/4Ju8UHdXMs">
|
||||||
|
<img src="https://img.shields.io/discord/800204819540869120?logo=discord" alt="Discord">
|
||||||
|
</a>
|
||||||
|
</p>
|
||||||
|
<p align="center">
|
||||||
|
A pure Rust implementation of ICE. Rewrite <a href="https://github.com/pion/ice/releases/tag/v2.0.14">Pion</a> ICE in Rust
|
||||||
|
</p>
|
||||||
Vendored
+23
@@ -0,0 +1,23 @@
|
|||||||
|
codecov:
|
||||||
|
require_ci_to_pass: yes
|
||||||
|
max_report_age: off
|
||||||
|
token: 4bd5cec1-2807-4cd6-8430-d5f3efe32ce0
|
||||||
|
|
||||||
|
coverage:
|
||||||
|
precision: 2
|
||||||
|
round: down
|
||||||
|
range: 50..90
|
||||||
|
status:
|
||||||
|
project:
|
||||||
|
default:
|
||||||
|
enabled: no
|
||||||
|
threshold: 0.2
|
||||||
|
if_not_found: success
|
||||||
|
patch:
|
||||||
|
default:
|
||||||
|
enabled: no
|
||||||
|
if_not_found: success
|
||||||
|
changes:
|
||||||
|
default:
|
||||||
|
enabled: no
|
||||||
|
if_not_found: success
|
||||||
Vendored
BIN
Binary file not shown.
|
After Width: | Height: | Size: 32 KiB |
+424
@@ -0,0 +1,424 @@
|
|||||||
|
use std::io;
|
||||||
|
use std::sync::Arc;
|
||||||
|
use std::time::Duration;
|
||||||
|
|
||||||
|
use clap::{App, AppSettings, Arg};
|
||||||
|
use hyper::service::{make_service_fn, service_fn};
|
||||||
|
use hyper::{Body, Client, Method, Request, Response, Server, StatusCode};
|
||||||
|
use ice::agent::agent_config::AgentConfig;
|
||||||
|
use ice::agent::Agent;
|
||||||
|
use ice::candidate::candidate_base::*;
|
||||||
|
use ice::candidate::*;
|
||||||
|
use ice::network_type::*;
|
||||||
|
use ice::state::*;
|
||||||
|
use ice::udp_network::UDPNetwork;
|
||||||
|
use ice::Error;
|
||||||
|
use rand::{thread_rng, Rng};
|
||||||
|
use tokio::net::UdpSocket;
|
||||||
|
use tokio::sync::{mpsc, watch, Mutex};
|
||||||
|
use util::Conn;
|
||||||
|
use webrtc_ice as ice;
|
||||||
|
|
||||||
|
#[macro_use]
|
||||||
|
extern crate lazy_static;
|
||||||
|
|
||||||
|
type SenderType = Arc<Mutex<mpsc::Sender<String>>>;
|
||||||
|
type ReceiverType = Arc<Mutex<mpsc::Receiver<String>>>;
|
||||||
|
|
||||||
|
lazy_static! {
|
||||||
|
// ErrUnknownType indicates an error with Unknown info.
|
||||||
|
static ref REMOTE_AUTH_CHANNEL: (SenderType, ReceiverType ) = {
|
||||||
|
let (tx, rx) = mpsc::channel::<String>(3);
|
||||||
|
(Arc::new(Mutex::new(tx)), Arc::new(Mutex::new(rx)))
|
||||||
|
};
|
||||||
|
|
||||||
|
static ref REMOTE_CAND_CHANNEL: (SenderType, ReceiverType) = {
|
||||||
|
let (tx, rx) = mpsc::channel::<String>(10);
|
||||||
|
(Arc::new(Mutex::new(tx)), Arc::new(Mutex::new(rx)))
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
// HTTP Listener to get ICE Credentials/Candidate from remote Peer
|
||||||
|
async fn remote_handler(req: Request<Body>) -> Result<Response<Body>, hyper::Error> {
|
||||||
|
//println!("received {:?}", req);
|
||||||
|
match (req.method(), req.uri().path()) {
|
||||||
|
(&Method::POST, "/remoteAuth") => {
|
||||||
|
let full_body =
|
||||||
|
match std::str::from_utf8(&hyper::body::to_bytes(req.into_body()).await?) {
|
||||||
|
Ok(s) => s.to_owned(),
|
||||||
|
Err(err) => panic!("{}", err),
|
||||||
|
};
|
||||||
|
let tx = REMOTE_AUTH_CHANNEL.0.lock().await;
|
||||||
|
//println!("body: {:?}", full_body);
|
||||||
|
let _ = tx.send(full_body).await;
|
||||||
|
|
||||||
|
let mut response = Response::new(Body::empty());
|
||||||
|
*response.status_mut() = StatusCode::OK;
|
||||||
|
Ok(response)
|
||||||
|
}
|
||||||
|
|
||||||
|
(&Method::POST, "/remoteCandidate") => {
|
||||||
|
let full_body =
|
||||||
|
match std::str::from_utf8(&hyper::body::to_bytes(req.into_body()).await?) {
|
||||||
|
Ok(s) => s.to_owned(),
|
||||||
|
Err(err) => panic!("{}", err),
|
||||||
|
};
|
||||||
|
let tx = REMOTE_CAND_CHANNEL.0.lock().await;
|
||||||
|
//println!("body: {:?}", full_body);
|
||||||
|
let _ = tx.send(full_body).await;
|
||||||
|
|
||||||
|
let mut response = Response::new(Body::empty());
|
||||||
|
*response.status_mut() = StatusCode::OK;
|
||||||
|
Ok(response)
|
||||||
|
}
|
||||||
|
|
||||||
|
// Return the 404 Not Found for other routes.
|
||||||
|
_ => {
|
||||||
|
let mut not_found = Response::default();
|
||||||
|
*not_found.status_mut() = StatusCode::NOT_FOUND;
|
||||||
|
Ok(not_found)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Controlled Agent:
|
||||||
|
// cargo run --color=always --package webrtc-ice --example ping_pong
|
||||||
|
// Controlling Agent:
|
||||||
|
// cargo run --color=always --package webrtc-ice --example ping_pong -- --controlling
|
||||||
|
|
||||||
|
#[tokio::main]
|
||||||
|
async fn main() -> Result<(), Error> {
|
||||||
|
env_logger::init();
|
||||||
|
// .format(|buf, record| {
|
||||||
|
// writeln!(
|
||||||
|
// buf,
|
||||||
|
// "{}:{} [{}] {} - {}",
|
||||||
|
// record.file().unwrap_or("unknown"),
|
||||||
|
// record.line().unwrap_or(0),
|
||||||
|
// record.level(),
|
||||||
|
// chrono::Local::now().format("%H:%M:%S.%6f"),
|
||||||
|
// record.args()
|
||||||
|
// )
|
||||||
|
// })
|
||||||
|
// .filter(None, log::LevelFilter::Trace)
|
||||||
|
// .init();
|
||||||
|
|
||||||
|
let mut app = App::new("ICE Demo")
|
||||||
|
.version("0.1.0")
|
||||||
|
.author("Rain Liu <[email protected]>")
|
||||||
|
.about("An example of ICE")
|
||||||
|
.setting(AppSettings::DeriveDisplayOrder)
|
||||||
|
.setting(AppSettings::SubcommandsNegateReqs)
|
||||||
|
.arg(
|
||||||
|
Arg::with_name("use-mux")
|
||||||
|
.takes_value(false)
|
||||||
|
.long("use-mux")
|
||||||
|
.short('m')
|
||||||
|
.help("Use a muxed UDP connection over a single listening port"),
|
||||||
|
)
|
||||||
|
.arg(
|
||||||
|
Arg::with_name("FULLHELP")
|
||||||
|
.help("Prints more detailed help information")
|
||||||
|
.long("fullhelp"),
|
||||||
|
)
|
||||||
|
.arg(
|
||||||
|
Arg::with_name("controlling")
|
||||||
|
.takes_value(false)
|
||||||
|
.long("controlling")
|
||||||
|
.help("is ICE Agent controlling"),
|
||||||
|
);
|
||||||
|
|
||||||
|
let matches = app.clone().get_matches();
|
||||||
|
|
||||||
|
if matches.is_present("FULLHELP") {
|
||||||
|
app.print_long_help().unwrap();
|
||||||
|
std::process::exit(0);
|
||||||
|
}
|
||||||
|
|
||||||
|
let is_controlling = matches.is_present("controlling");
|
||||||
|
let use_mux = matches.is_present("use-mux");
|
||||||
|
|
||||||
|
let (local_http_port, remote_http_port) = if is_controlling {
|
||||||
|
(9000, 9001)
|
||||||
|
} else {
|
||||||
|
(9001, 9000)
|
||||||
|
};
|
||||||
|
|
||||||
|
let (weak_conn, weak_agent) = {
|
||||||
|
let (done_tx, done_rx) = watch::channel(());
|
||||||
|
|
||||||
|
println!("Listening on http://localhost:{local_http_port}");
|
||||||
|
let mut done_http_server = done_rx.clone();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let addr = ([0, 0, 0, 0], local_http_port).into();
|
||||||
|
let service =
|
||||||
|
make_service_fn(|_| async { Ok::<_, hyper::Error>(service_fn(remote_handler)) });
|
||||||
|
let server = Server::bind(&addr).serve(service);
|
||||||
|
tokio::select! {
|
||||||
|
_ = done_http_server.changed() => {
|
||||||
|
println!("receive cancel http server!");
|
||||||
|
}
|
||||||
|
result = server => {
|
||||||
|
// Run this server for... forever!
|
||||||
|
if let Err(e) = result {
|
||||||
|
eprintln!("server error: {e}");
|
||||||
|
}
|
||||||
|
println!("exit http server!");
|
||||||
|
}
|
||||||
|
};
|
||||||
|
});
|
||||||
|
|
||||||
|
if is_controlling {
|
||||||
|
println!("Local Agent is controlling");
|
||||||
|
} else {
|
||||||
|
println!("Local Agent is controlled");
|
||||||
|
};
|
||||||
|
println!("Press 'Enter' when both processes have started");
|
||||||
|
let mut input = String::new();
|
||||||
|
let _ = io::stdin().read_line(&mut input)?;
|
||||||
|
|
||||||
|
let udp_network = if use_mux {
|
||||||
|
use ice::udp_mux::*;
|
||||||
|
let port = if is_controlling { 4000 } else { 4001 };
|
||||||
|
|
||||||
|
let udp_socket = UdpSocket::bind(("0.0.0.0", port)).await?;
|
||||||
|
let udp_mux = UDPMuxDefault::new(UDPMuxParams::new(udp_socket));
|
||||||
|
|
||||||
|
UDPNetwork::Muxed(udp_mux)
|
||||||
|
} else {
|
||||||
|
UDPNetwork::Ephemeral(Default::default())
|
||||||
|
};
|
||||||
|
|
||||||
|
let ice_agent = Arc::new(
|
||||||
|
Agent::new(AgentConfig {
|
||||||
|
network_types: vec![NetworkType::Udp4],
|
||||||
|
udp_network,
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.await?,
|
||||||
|
);
|
||||||
|
|
||||||
|
let client = Arc::new(Client::new());
|
||||||
|
|
||||||
|
// When we have gathered a new ICE Candidate send it to the remote peer
|
||||||
|
let client2 = Arc::clone(&client);
|
||||||
|
ice_agent.on_candidate(Box::new(
|
||||||
|
move |c: Option<Arc<dyn Candidate + Send + Sync>>| {
|
||||||
|
let client3 = Arc::clone(&client2);
|
||||||
|
Box::pin(async move {
|
||||||
|
if let Some(c) = c {
|
||||||
|
println!("posting remoteCandidate with {}", c.marshal());
|
||||||
|
|
||||||
|
let req = match Request::builder()
|
||||||
|
.method(Method::POST)
|
||||||
|
.uri(format!(
|
||||||
|
"http://localhost:{remote_http_port}/remoteCandidate"
|
||||||
|
))
|
||||||
|
.body(Body::from(c.marshal()))
|
||||||
|
{
|
||||||
|
Ok(req) => req,
|
||||||
|
Err(err) => {
|
||||||
|
println!("{err}");
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
let resp = match client3.request(req).await {
|
||||||
|
Ok(resp) => resp,
|
||||||
|
Err(err) => {
|
||||||
|
println!("{err}");
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
println!("Response from remoteCandidate: {}", resp.status());
|
||||||
|
}
|
||||||
|
})
|
||||||
|
},
|
||||||
|
));
|
||||||
|
|
||||||
|
let (ice_done_tx, mut ice_done_rx) = mpsc::channel::<()>(1);
|
||||||
|
// When ICE Connection state has change print to stdout
|
||||||
|
ice_agent.on_connection_state_change(Box::new(move |c: ConnectionState| {
|
||||||
|
println!("ICE Connection State has changed: {c}");
|
||||||
|
if c == ConnectionState::Failed {
|
||||||
|
let _ = ice_done_tx.try_send(());
|
||||||
|
}
|
||||||
|
Box::pin(async move {})
|
||||||
|
}));
|
||||||
|
|
||||||
|
// Get the local auth details and send to remote peer
|
||||||
|
let (local_ufrag, local_pwd) = ice_agent.get_local_user_credentials().await;
|
||||||
|
|
||||||
|
println!("posting remoteAuth with {local_ufrag}:{local_pwd}");
|
||||||
|
let req = match Request::builder()
|
||||||
|
.method(Method::POST)
|
||||||
|
.uri(format!("http://localhost:{remote_http_port}/remoteAuth"))
|
||||||
|
.body(Body::from(format!("{local_ufrag}:{local_pwd}")))
|
||||||
|
{
|
||||||
|
Ok(req) => req,
|
||||||
|
Err(err) => return Err(Error::Other(format!("{err}"))),
|
||||||
|
};
|
||||||
|
let resp = match client.request(req).await {
|
||||||
|
Ok(resp) => resp,
|
||||||
|
Err(err) => return Err(Error::Other(format!("{err}"))),
|
||||||
|
};
|
||||||
|
println!("Response from remoteAuth: {}", resp.status());
|
||||||
|
|
||||||
|
let (remote_ufrag, remote_pwd) = {
|
||||||
|
let mut rx = REMOTE_AUTH_CHANNEL.1.lock().await;
|
||||||
|
if let Some(s) = rx.recv().await {
|
||||||
|
println!("received: {s}");
|
||||||
|
let fields: Vec<String> = s.split(':').map(|s| s.to_string()).collect();
|
||||||
|
(fields[0].clone(), fields[1].clone())
|
||||||
|
} else {
|
||||||
|
panic!("rx.recv() empty");
|
||||||
|
}
|
||||||
|
};
|
||||||
|
println!("remote_ufrag: {remote_ufrag}, remote_pwd: {remote_pwd}");
|
||||||
|
|
||||||
|
let ice_agent2 = Arc::clone(&ice_agent);
|
||||||
|
let mut done_cand = done_rx.clone();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let mut rx = REMOTE_CAND_CHANNEL.1.lock().await;
|
||||||
|
loop {
|
||||||
|
tokio::select! {
|
||||||
|
_ = done_cand.changed() => {
|
||||||
|
println!("receive cancel remote cand!");
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
result = rx.recv() => {
|
||||||
|
if let Some(s) = result {
|
||||||
|
if let Ok(c) = unmarshal_candidate(&s) {
|
||||||
|
println!("add_remote_candidate: {c}");
|
||||||
|
let c: Arc<dyn Candidate + Send + Sync> = Arc::new(c);
|
||||||
|
let _ = ice_agent2.add_remote_candidate(&c);
|
||||||
|
}else{
|
||||||
|
println!("unmarshal_candidate error!");
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}else{
|
||||||
|
println!("REMOTE_CAND_CHANNEL done!");
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
ice_agent.gather_candidates()?;
|
||||||
|
println!("Connecting...");
|
||||||
|
|
||||||
|
let (_cancel_tx, cancel_rx) = mpsc::channel(1);
|
||||||
|
// Start the ICE Agent. One side must be controlled, and the other must be controlling
|
||||||
|
let conn: Arc<dyn Conn + Send + Sync> = if is_controlling {
|
||||||
|
ice_agent.dial(cancel_rx, remote_ufrag, remote_pwd).await?
|
||||||
|
} else {
|
||||||
|
ice_agent
|
||||||
|
.accept(cancel_rx, remote_ufrag, remote_pwd)
|
||||||
|
.await?
|
||||||
|
};
|
||||||
|
|
||||||
|
let weak_conn = Arc::downgrade(&conn);
|
||||||
|
|
||||||
|
// Send messages in a loop to the remote peer
|
||||||
|
let conn_tx = Arc::clone(&conn);
|
||||||
|
let mut done_send = done_rx.clone();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
const RANDOM_STRING: &[u8] = b"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
|
||||||
|
loop {
|
||||||
|
tokio::time::sleep(Duration::from_secs(3)).await;
|
||||||
|
|
||||||
|
let val: String = (0..15)
|
||||||
|
.map(|_| {
|
||||||
|
let idx = thread_rng().gen_range(0..RANDOM_STRING.len());
|
||||||
|
RANDOM_STRING[idx] as char
|
||||||
|
})
|
||||||
|
.collect();
|
||||||
|
|
||||||
|
tokio::select! {
|
||||||
|
_ = done_send.changed() => {
|
||||||
|
println!("receive cancel ice send!");
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
result = conn_tx.send(val.as_bytes()) => {
|
||||||
|
if let Err(err) = result {
|
||||||
|
eprintln!("conn_tx send error: {err}");
|
||||||
|
break;
|
||||||
|
}else{
|
||||||
|
println!("Sent: '{val}'");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
let mut done_recv = done_rx.clone();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
// Receive messages in a loop from the remote peer
|
||||||
|
let mut buf = vec![0u8; 1500];
|
||||||
|
loop {
|
||||||
|
tokio::select! {
|
||||||
|
_ = done_recv.changed() => {
|
||||||
|
println!("receive cancel ice recv!");
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
result = conn.recv(&mut buf) => {
|
||||||
|
match result {
|
||||||
|
Ok(n) => {
|
||||||
|
println!("Received: '{}'", std::str::from_utf8(&buf[..n]).unwrap());
|
||||||
|
}
|
||||||
|
Err(err) => {
|
||||||
|
eprintln!("conn_tx send error: {err}");
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
println!("Press ctrl-c to stop");
|
||||||
|
/*let d = if is_controlling {
|
||||||
|
Duration::from_secs(500)
|
||||||
|
} else {
|
||||||
|
Duration::from_secs(5)
|
||||||
|
};
|
||||||
|
let timeout = tokio::time::sleep(d);
|
||||||
|
tokio::pin!(timeout);*/
|
||||||
|
|
||||||
|
tokio::select! {
|
||||||
|
/*_ = timeout.as_mut() => {
|
||||||
|
println!("received timeout signal!");
|
||||||
|
let _ = done_tx.send(());
|
||||||
|
}*/
|
||||||
|
_ = ice_done_rx.recv() => {
|
||||||
|
println!("ice_done_rx");
|
||||||
|
let _ = done_tx.send(());
|
||||||
|
}
|
||||||
|
_ = tokio::signal::ctrl_c() => {
|
||||||
|
println!();
|
||||||
|
let _ = done_tx.send(());
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
let _ = ice_agent.close().await;
|
||||||
|
|
||||||
|
(weak_conn, Arc::downgrade(&ice_agent))
|
||||||
|
};
|
||||||
|
|
||||||
|
let mut int = tokio::time::interval(Duration::from_secs(1));
|
||||||
|
loop {
|
||||||
|
int.tick().await;
|
||||||
|
println!(
|
||||||
|
"weak_conn: weak count = {}, strong count = {}, weak_agent: weak count = {}, strong count = {}",
|
||||||
|
weak_conn.weak_count(),
|
||||||
|
weak_conn.strong_count(),
|
||||||
|
weak_agent.weak_count(),
|
||||||
|
weak_agent.strong_count(),
|
||||||
|
);
|
||||||
|
if weak_conn.strong_count() == 0 && weak_agent.strong_count() == 0 {
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
+255
@@ -0,0 +1,255 @@
|
|||||||
|
use std::net::IpAddr;
|
||||||
|
use std::time::Duration;
|
||||||
|
|
||||||
|
use util::vnet::net::*;
|
||||||
|
|
||||||
|
use super::*;
|
||||||
|
use crate::error::*;
|
||||||
|
use crate::mdns::*;
|
||||||
|
use crate::network_type::*;
|
||||||
|
use crate::udp_network::UDPNetwork;
|
||||||
|
use crate::url::*;
|
||||||
|
|
||||||
|
/// The interval at which the agent performs candidate checks in the connecting phase.
|
||||||
|
pub(crate) const DEFAULT_CHECK_INTERVAL: Duration = Duration::from_millis(200);
|
||||||
|
|
||||||
|
/// The interval used to keep candidates alive.
|
||||||
|
pub(crate) const DEFAULT_KEEPALIVE_INTERVAL: Duration = Duration::from_secs(2);
|
||||||
|
|
||||||
|
/// The default time till an Agent transitions disconnected.
|
||||||
|
pub(crate) const DEFAULT_DISCONNECTED_TIMEOUT: Duration = Duration::from_secs(5);
|
||||||
|
|
||||||
|
/// The default time till an Agent transitions to failed after disconnected.
|
||||||
|
pub(crate) const DEFAULT_FAILED_TIMEOUT: Duration = Duration::from_secs(25);
|
||||||
|
|
||||||
|
/// Wait time before nominating a host candidate.
|
||||||
|
pub(crate) const DEFAULT_HOST_ACCEPTANCE_MIN_WAIT: Duration = Duration::from_secs(0);
|
||||||
|
|
||||||
|
/// Wait time before nominating a srflx candidate.
|
||||||
|
pub(crate) const DEFAULT_SRFLX_ACCEPTANCE_MIN_WAIT: Duration = Duration::from_millis(500);
|
||||||
|
|
||||||
|
/// Wait time before nominating a prflx candidate.
|
||||||
|
pub(crate) const DEFAULT_PRFLX_ACCEPTANCE_MIN_WAIT: Duration = Duration::from_millis(1000);
|
||||||
|
|
||||||
|
/// Wait time before nominating a relay candidate.
|
||||||
|
pub(crate) const DEFAULT_RELAY_ACCEPTANCE_MIN_WAIT: Duration = Duration::from_millis(2000);
|
||||||
|
|
||||||
|
/// Max binding request before considering a pair failed.
|
||||||
|
pub(crate) const DEFAULT_MAX_BINDING_REQUESTS: u16 = 7;
|
||||||
|
|
||||||
|
/// The number of bytes that can be buffered before we start to error.
|
||||||
|
pub(crate) const MAX_BUFFER_SIZE: usize = 1000 * 1000; // 1MB
|
||||||
|
|
||||||
|
/// Wait time before binding requests can be deleted.
|
||||||
|
pub(crate) const MAX_BINDING_REQUEST_TIMEOUT: Duration = Duration::from_millis(4000);
|
||||||
|
|
||||||
|
pub(crate) fn default_candidate_types() -> Vec<CandidateType> {
|
||||||
|
vec![
|
||||||
|
CandidateType::Host,
|
||||||
|
CandidateType::ServerReflexive,
|
||||||
|
CandidateType::Relay,
|
||||||
|
]
|
||||||
|
}
|
||||||
|
|
||||||
|
pub type InterfaceFilterFn = Box<dyn (Fn(&str) -> bool) + Send + Sync>;
|
||||||
|
pub type IpFilterFn = Box<dyn (Fn(IpAddr) -> bool) + Send + Sync>;
|
||||||
|
|
||||||
|
/// Collects the arguments to `ice::Agent` construction into a single structure, for
|
||||||
|
/// future-proofness of the interface.
|
||||||
|
#[derive(Default)]
|
||||||
|
pub struct AgentConfig {
|
||||||
|
pub urls: Vec<Url>,
|
||||||
|
|
||||||
|
/// Controls how the UDP network stack works.
|
||||||
|
/// See [`UDPNetwork`]
|
||||||
|
pub udp_network: UDPNetwork,
|
||||||
|
|
||||||
|
/// It is used to perform connectivity checks. The values MUST be unguessable, with at least
|
||||||
|
/// 128 bits of random number generator output used to generate the password, and at least 24
|
||||||
|
/// bits of output to generate the username fragment.
|
||||||
|
pub local_ufrag: String,
|
||||||
|
/// It is used to perform connectivity checks. The values MUST be unguessable, with at least
|
||||||
|
/// 128 bits of random number generator output used to generate the password, and at least 24
|
||||||
|
/// bits of output to generate the username fragment.
|
||||||
|
pub local_pwd: String,
|
||||||
|
|
||||||
|
/// Controls mDNS behavior for the ICE agent.
|
||||||
|
pub multicast_dns_mode: MulticastDnsMode,
|
||||||
|
|
||||||
|
/// Controls the hostname for this agent. If none is specified a random one will be generated.
|
||||||
|
pub multicast_dns_host_name: String,
|
||||||
|
|
||||||
|
/// Control mDNS destination address
|
||||||
|
pub multicast_dns_dest_addr: String,
|
||||||
|
|
||||||
|
/// Defaults to 5 seconds when this property is nil.
|
||||||
|
/// If the duration is 0, the ICE Agent will never go to disconnected.
|
||||||
|
pub disconnected_timeout: Option<Duration>,
|
||||||
|
|
||||||
|
/// Defaults to 25 seconds when this property is nil.
|
||||||
|
/// If the duration is 0, we will never go to failed.
|
||||||
|
pub failed_timeout: Option<Duration>,
|
||||||
|
|
||||||
|
/// Determines how often should we send ICE keepalives (should be less then connectiontimeout
|
||||||
|
/// above) when this is nil, it defaults to 10 seconds.
|
||||||
|
/// A keepalive interval of 0 means we never send keepalive packets
|
||||||
|
pub keepalive_interval: Option<Duration>,
|
||||||
|
|
||||||
|
/// An optional configuration for disabling or enabling support for specific network types.
|
||||||
|
pub network_types: Vec<NetworkType>,
|
||||||
|
|
||||||
|
/// An optional configuration for disabling or enabling support for specific candidate types.
|
||||||
|
pub candidate_types: Vec<CandidateType>,
|
||||||
|
|
||||||
|
//LoggerFactory logging.LoggerFactory
|
||||||
|
/// Controls how often our internal task loop runs when in the connecting state.
|
||||||
|
/// Only useful for testing.
|
||||||
|
pub check_interval: Duration,
|
||||||
|
|
||||||
|
/// The max amount of binding requests the agent will send over a candidate pair for validation
|
||||||
|
/// or nomination, if after max_binding_requests the candidate is yet to answer a binding
|
||||||
|
/// request or a nomination we set the pair as failed.
|
||||||
|
pub max_binding_requests: Option<u16>,
|
||||||
|
|
||||||
|
pub is_controlling: bool,
|
||||||
|
|
||||||
|
/// lite agents do not perform connectivity check and only provide host candidates.
|
||||||
|
pub lite: bool,
|
||||||
|
|
||||||
|
/// It is used along with nat1to1ips to specify which candidate type the 1:1 NAT IP addresses
|
||||||
|
/// should be mapped to. If unspecified or CandidateTypeHost, nat1to1ips are used to replace
|
||||||
|
/// host candidate IPs. If CandidateTypeServerReflexive, it will insert a srflx candidate (as
|
||||||
|
/// if it was derived from a STUN server) with its port number being the one for the actual host
|
||||||
|
/// candidate. Other values will result in an error.
|
||||||
|
pub nat_1to1_ip_candidate_type: CandidateType,
|
||||||
|
|
||||||
|
/// Contains a list of public IP addresses that are to be used as a host candidate or srflx
|
||||||
|
/// candidate. This is used typically for servers that are behind 1:1 D-NAT (e.g. AWS EC2
|
||||||
|
/// instances) and to eliminate the need of server reflexisive candidate gathering.
|
||||||
|
pub nat_1to1_ips: Vec<String>,
|
||||||
|
|
||||||
|
/// Specify a minimum wait time before selecting host candidates.
|
||||||
|
pub host_acceptance_min_wait: Option<Duration>,
|
||||||
|
/// Specify a minimum wait time before selecting srflx candidates.
|
||||||
|
pub srflx_acceptance_min_wait: Option<Duration>,
|
||||||
|
/// Specify a minimum wait time before selecting prflx candidates.
|
||||||
|
pub prflx_acceptance_min_wait: Option<Duration>,
|
||||||
|
/// Specify a minimum wait time before selecting relay candidates.
|
||||||
|
pub relay_acceptance_min_wait: Option<Duration>,
|
||||||
|
|
||||||
|
/// Net is the our abstracted network interface for internal development purpose only
|
||||||
|
/// (see (github.com/pion/transport/vnet)[github.com/pion/transport/vnet]).
|
||||||
|
pub net: Option<Arc<Net>>,
|
||||||
|
|
||||||
|
/// A function that you can use in order to whitelist or blacklist the interfaces which are
|
||||||
|
/// used to gather ICE candidates.
|
||||||
|
pub interface_filter: Arc<Option<InterfaceFilterFn>>,
|
||||||
|
|
||||||
|
/// A function that you can use in order to whitelist or blacklist
|
||||||
|
/// the ips which are used to gather ICE candidates.
|
||||||
|
pub ip_filter: Arc<Option<IpFilterFn>>,
|
||||||
|
|
||||||
|
/// Controls if self-signed certificates are accepted when connecting to TURN servers via TLS or
|
||||||
|
/// DTLS.
|
||||||
|
pub insecure_skip_verify: bool,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl AgentConfig {
|
||||||
|
/// Populates an agent and falls back to defaults if fields are unset.
|
||||||
|
pub(crate) fn init_with_defaults(&self, a: &mut AgentInternal) {
|
||||||
|
if let Some(max_binding_requests) = self.max_binding_requests {
|
||||||
|
a.max_binding_requests = max_binding_requests;
|
||||||
|
} else {
|
||||||
|
a.max_binding_requests = DEFAULT_MAX_BINDING_REQUESTS;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(host_acceptance_min_wait) = self.host_acceptance_min_wait {
|
||||||
|
a.host_acceptance_min_wait = host_acceptance_min_wait;
|
||||||
|
} else {
|
||||||
|
a.host_acceptance_min_wait = DEFAULT_HOST_ACCEPTANCE_MIN_WAIT;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(srflx_acceptance_min_wait) = self.srflx_acceptance_min_wait {
|
||||||
|
a.srflx_acceptance_min_wait = srflx_acceptance_min_wait;
|
||||||
|
} else {
|
||||||
|
a.srflx_acceptance_min_wait = DEFAULT_SRFLX_ACCEPTANCE_MIN_WAIT;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(prflx_acceptance_min_wait) = self.prflx_acceptance_min_wait {
|
||||||
|
a.prflx_acceptance_min_wait = prflx_acceptance_min_wait;
|
||||||
|
} else {
|
||||||
|
a.prflx_acceptance_min_wait = DEFAULT_PRFLX_ACCEPTANCE_MIN_WAIT;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(relay_acceptance_min_wait) = self.relay_acceptance_min_wait {
|
||||||
|
a.relay_acceptance_min_wait = relay_acceptance_min_wait;
|
||||||
|
} else {
|
||||||
|
a.relay_acceptance_min_wait = DEFAULT_RELAY_ACCEPTANCE_MIN_WAIT;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(disconnected_timeout) = self.disconnected_timeout {
|
||||||
|
a.disconnected_timeout = disconnected_timeout;
|
||||||
|
} else {
|
||||||
|
a.disconnected_timeout = DEFAULT_DISCONNECTED_TIMEOUT;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(failed_timeout) = self.failed_timeout {
|
||||||
|
a.failed_timeout = failed_timeout;
|
||||||
|
} else {
|
||||||
|
a.failed_timeout = DEFAULT_FAILED_TIMEOUT;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(keepalive_interval) = self.keepalive_interval {
|
||||||
|
a.keepalive_interval = keepalive_interval;
|
||||||
|
} else {
|
||||||
|
a.keepalive_interval = DEFAULT_KEEPALIVE_INTERVAL;
|
||||||
|
}
|
||||||
|
|
||||||
|
if self.check_interval == Duration::from_secs(0) {
|
||||||
|
a.check_interval = DEFAULT_CHECK_INTERVAL;
|
||||||
|
} else {
|
||||||
|
a.check_interval = self.check_interval;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) fn init_ext_ip_mapping(
|
||||||
|
&self,
|
||||||
|
mdns_mode: MulticastDnsMode,
|
||||||
|
candidate_types: &[CandidateType],
|
||||||
|
) -> Result<Option<ExternalIpMapper>> {
|
||||||
|
if let Some(ext_ip_mapper) =
|
||||||
|
ExternalIpMapper::new(self.nat_1to1_ip_candidate_type, &self.nat_1to1_ips)?
|
||||||
|
{
|
||||||
|
if ext_ip_mapper.candidate_type == CandidateType::Host {
|
||||||
|
if mdns_mode == MulticastDnsMode::QueryAndGather {
|
||||||
|
return Err(Error::ErrMulticastDnsWithNat1to1IpMapping);
|
||||||
|
}
|
||||||
|
let mut candi_host_enabled = false;
|
||||||
|
for candi_type in candidate_types {
|
||||||
|
if *candi_type == CandidateType::Host {
|
||||||
|
candi_host_enabled = true;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if !candi_host_enabled {
|
||||||
|
return Err(Error::ErrIneffectiveNat1to1IpMappingHost);
|
||||||
|
}
|
||||||
|
} else if ext_ip_mapper.candidate_type == CandidateType::ServerReflexive {
|
||||||
|
let mut candi_srflx_enabled = false;
|
||||||
|
for candi_type in candidate_types {
|
||||||
|
if *candi_type == CandidateType::ServerReflexive {
|
||||||
|
candi_srflx_enabled = true;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if !candi_srflx_enabled {
|
||||||
|
return Err(Error::ErrIneffectiveNat1to1IpMappingSrflx);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(Some(ext_ip_mapper))
|
||||||
|
} else {
|
||||||
|
Ok(None)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
+911
@@ -0,0 +1,911 @@
|
|||||||
|
use std::net::{Ipv4Addr, Ipv6Addr};
|
||||||
|
use std::str::FromStr;
|
||||||
|
use std::sync::Arc;
|
||||||
|
|
||||||
|
use util::vnet::net::*;
|
||||||
|
use util::Conn;
|
||||||
|
use waitgroup::WaitGroup;
|
||||||
|
|
||||||
|
use super::*;
|
||||||
|
use crate::candidate::candidate_base::CandidateBaseConfig;
|
||||||
|
use crate::candidate::candidate_host::CandidateHostConfig;
|
||||||
|
use crate::candidate::candidate_relay::CandidateRelayConfig;
|
||||||
|
use crate::candidate::candidate_server_reflexive::CandidateServerReflexiveConfig;
|
||||||
|
use crate::candidate::*;
|
||||||
|
use crate::error::*;
|
||||||
|
use crate::network_type::*;
|
||||||
|
use crate::udp_network::UDPNetwork;
|
||||||
|
use crate::url::{ProtoType, SchemeType, Url};
|
||||||
|
use crate::util::*;
|
||||||
|
|
||||||
|
const STUN_GATHER_TIMEOUT: Duration = Duration::from_secs(5);
|
||||||
|
|
||||||
|
pub(crate) struct GatherCandidatesInternalParams {
|
||||||
|
pub(crate) udp_network: UDPNetwork,
|
||||||
|
pub(crate) candidate_types: Vec<CandidateType>,
|
||||||
|
pub(crate) urls: Vec<Url>,
|
||||||
|
pub(crate) network_types: Vec<NetworkType>,
|
||||||
|
pub(crate) mdns_mode: MulticastDnsMode,
|
||||||
|
pub(crate) mdns_name: String,
|
||||||
|
pub(crate) net: Arc<Net>,
|
||||||
|
pub(crate) interface_filter: Arc<Option<InterfaceFilterFn>>,
|
||||||
|
pub(crate) ip_filter: Arc<Option<IpFilterFn>>,
|
||||||
|
pub(crate) ext_ip_mapper: Arc<Option<ExternalIpMapper>>,
|
||||||
|
pub(crate) agent_internal: Arc<AgentInternal>,
|
||||||
|
pub(crate) gathering_state: Arc<AtomicU8>,
|
||||||
|
pub(crate) chan_candidate_tx: ChanCandidateTx,
|
||||||
|
}
|
||||||
|
|
||||||
|
struct GatherCandidatesLocalParams {
|
||||||
|
udp_network: UDPNetwork,
|
||||||
|
network_types: Vec<NetworkType>,
|
||||||
|
mdns_mode: MulticastDnsMode,
|
||||||
|
mdns_name: String,
|
||||||
|
interface_filter: Arc<Option<InterfaceFilterFn>>,
|
||||||
|
ip_filter: Arc<Option<IpFilterFn>>,
|
||||||
|
ext_ip_mapper: Arc<Option<ExternalIpMapper>>,
|
||||||
|
net: Arc<Net>,
|
||||||
|
agent_internal: Arc<AgentInternal>,
|
||||||
|
}
|
||||||
|
|
||||||
|
struct GatherCandidatesLocalUDPMuxParams {
|
||||||
|
network_types: Vec<NetworkType>,
|
||||||
|
interface_filter: Arc<Option<InterfaceFilterFn>>,
|
||||||
|
ip_filter: Arc<Option<IpFilterFn>>,
|
||||||
|
ext_ip_mapper: Arc<Option<ExternalIpMapper>>,
|
||||||
|
net: Arc<Net>,
|
||||||
|
agent_internal: Arc<AgentInternal>,
|
||||||
|
udp_mux: Arc<dyn UDPMux + Send + Sync>,
|
||||||
|
}
|
||||||
|
|
||||||
|
struct GatherCandidatesSrflxMappedParasm {
|
||||||
|
network_types: Vec<NetworkType>,
|
||||||
|
port_max: u16,
|
||||||
|
port_min: u16,
|
||||||
|
ext_ip_mapper: Arc<Option<ExternalIpMapper>>,
|
||||||
|
net: Arc<Net>,
|
||||||
|
agent_internal: Arc<AgentInternal>,
|
||||||
|
}
|
||||||
|
|
||||||
|
struct GatherCandidatesSrflxParams {
|
||||||
|
urls: Vec<Url>,
|
||||||
|
network_types: Vec<NetworkType>,
|
||||||
|
port_max: u16,
|
||||||
|
port_min: u16,
|
||||||
|
net: Arc<Net>,
|
||||||
|
agent_internal: Arc<AgentInternal>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Agent {
|
||||||
|
pub(crate) async fn gather_candidates_internal(params: GatherCandidatesInternalParams) {
|
||||||
|
Self::set_gathering_state(
|
||||||
|
¶ms.chan_candidate_tx,
|
||||||
|
¶ms.gathering_state,
|
||||||
|
GatheringState::Gathering,
|
||||||
|
)
|
||||||
|
.await;
|
||||||
|
|
||||||
|
let wg = WaitGroup::new();
|
||||||
|
|
||||||
|
for t in ¶ms.candidate_types {
|
||||||
|
match t {
|
||||||
|
CandidateType::Host => {
|
||||||
|
let local_params = GatherCandidatesLocalParams {
|
||||||
|
udp_network: params.udp_network.clone(),
|
||||||
|
network_types: params.network_types.clone(),
|
||||||
|
mdns_mode: params.mdns_mode,
|
||||||
|
mdns_name: params.mdns_name.clone(),
|
||||||
|
interface_filter: Arc::clone(¶ms.interface_filter),
|
||||||
|
ip_filter: Arc::clone(¶ms.ip_filter),
|
||||||
|
ext_ip_mapper: Arc::clone(¶ms.ext_ip_mapper),
|
||||||
|
net: Arc::clone(¶ms.net),
|
||||||
|
agent_internal: Arc::clone(¶ms.agent_internal),
|
||||||
|
};
|
||||||
|
|
||||||
|
let w = wg.worker();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let _d = w;
|
||||||
|
|
||||||
|
Self::gather_candidates_local(local_params).await;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
CandidateType::ServerReflexive => {
|
||||||
|
let ephemeral_config = match ¶ms.udp_network {
|
||||||
|
UDPNetwork::Ephemeral(e) => e,
|
||||||
|
// No server reflexive for muxxed connections
|
||||||
|
UDPNetwork::Muxed(_) => continue,
|
||||||
|
};
|
||||||
|
|
||||||
|
let srflx_params = GatherCandidatesSrflxParams {
|
||||||
|
urls: params.urls.clone(),
|
||||||
|
network_types: params.network_types.clone(),
|
||||||
|
port_max: ephemeral_config.port_max(),
|
||||||
|
port_min: ephemeral_config.port_min(),
|
||||||
|
net: Arc::clone(¶ms.net),
|
||||||
|
agent_internal: Arc::clone(¶ms.agent_internal),
|
||||||
|
};
|
||||||
|
let w1 = wg.worker();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let _d = w1;
|
||||||
|
|
||||||
|
Self::gather_candidates_srflx(srflx_params).await;
|
||||||
|
});
|
||||||
|
if let Some(ext_ip_mapper) = &*params.ext_ip_mapper {
|
||||||
|
if ext_ip_mapper.candidate_type == CandidateType::ServerReflexive {
|
||||||
|
let srflx_mapped_params = GatherCandidatesSrflxMappedParasm {
|
||||||
|
network_types: params.network_types.clone(),
|
||||||
|
port_max: ephemeral_config.port_max(),
|
||||||
|
port_min: ephemeral_config.port_min(),
|
||||||
|
ext_ip_mapper: Arc::clone(¶ms.ext_ip_mapper),
|
||||||
|
net: Arc::clone(¶ms.net),
|
||||||
|
agent_internal: Arc::clone(¶ms.agent_internal),
|
||||||
|
};
|
||||||
|
let w2 = wg.worker();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let _d = w2;
|
||||||
|
|
||||||
|
Self::gather_candidates_srflx_mapped(srflx_mapped_params).await;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
CandidateType::Relay => {
|
||||||
|
let urls = params.urls.clone();
|
||||||
|
let net = Arc::clone(¶ms.net);
|
||||||
|
let agent_internal = Arc::clone(¶ms.agent_internal);
|
||||||
|
let w = wg.worker();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let _d = w;
|
||||||
|
|
||||||
|
Self::gather_candidates_relay(urls, net, agent_internal).await;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
_ => {}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Block until all STUN and TURN URLs have been gathered (or timed out)
|
||||||
|
wg.wait().await;
|
||||||
|
|
||||||
|
Self::set_gathering_state(
|
||||||
|
¶ms.chan_candidate_tx,
|
||||||
|
¶ms.gathering_state,
|
||||||
|
GatheringState::Complete,
|
||||||
|
)
|
||||||
|
.await;
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn set_gathering_state(
|
||||||
|
chan_candidate_tx: &ChanCandidateTx,
|
||||||
|
gathering_state: &Arc<AtomicU8>,
|
||||||
|
new_state: GatheringState,
|
||||||
|
) {
|
||||||
|
if GatheringState::from(gathering_state.load(Ordering::SeqCst)) != new_state
|
||||||
|
&& new_state == GatheringState::Complete
|
||||||
|
{
|
||||||
|
let cand_tx = chan_candidate_tx.lock().await;
|
||||||
|
if let Some(tx) = &*cand_tx {
|
||||||
|
let _ = tx.send(None).await;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
gathering_state.store(new_state as u8, Ordering::SeqCst);
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn gather_candidates_local(params: GatherCandidatesLocalParams) {
|
||||||
|
let GatherCandidatesLocalParams {
|
||||||
|
udp_network,
|
||||||
|
network_types,
|
||||||
|
mdns_mode,
|
||||||
|
mdns_name,
|
||||||
|
interface_filter,
|
||||||
|
ip_filter,
|
||||||
|
ext_ip_mapper,
|
||||||
|
net,
|
||||||
|
agent_internal,
|
||||||
|
} = params;
|
||||||
|
|
||||||
|
// If we wanna use UDP mux, do so
|
||||||
|
// FIXME: We still need to support TCP in combination with this option
|
||||||
|
if let UDPNetwork::Muxed(udp_mux) = udp_network {
|
||||||
|
let result = Self::gather_candidates_local_udp_mux(GatherCandidatesLocalUDPMuxParams {
|
||||||
|
network_types,
|
||||||
|
interface_filter,
|
||||||
|
ip_filter,
|
||||||
|
ext_ip_mapper,
|
||||||
|
net,
|
||||||
|
agent_internal,
|
||||||
|
udp_mux,
|
||||||
|
})
|
||||||
|
.await;
|
||||||
|
|
||||||
|
if let Err(err) = result {
|
||||||
|
log::error!("Failed to gather local candidates using UDP mux: {}", err);
|
||||||
|
}
|
||||||
|
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
let ips = local_interfaces(&net, &interface_filter, &ip_filter, &network_types).await;
|
||||||
|
for ip in ips {
|
||||||
|
let mut mapped_ip = ip;
|
||||||
|
|
||||||
|
if mdns_mode != MulticastDnsMode::QueryAndGather && ext_ip_mapper.is_some() {
|
||||||
|
if let Some(ext_ip_mapper2) = ext_ip_mapper.as_ref() {
|
||||||
|
if ext_ip_mapper2.candidate_type == CandidateType::Host {
|
||||||
|
if let Ok(mi) = ext_ip_mapper2.find_external_ip(&ip.to_string()) {
|
||||||
|
mapped_ip = mi;
|
||||||
|
} else {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: 1:1 NAT mapping is enabled but no external IP is found for {}",
|
||||||
|
agent_internal.get_name(),
|
||||||
|
ip
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
let address = if mdns_mode == MulticastDnsMode::QueryAndGather {
|
||||||
|
mdns_name.clone()
|
||||||
|
} else {
|
||||||
|
mapped_ip.to_string()
|
||||||
|
};
|
||||||
|
|
||||||
|
//TODO: for network in networks
|
||||||
|
let network = UDP.to_owned();
|
||||||
|
if let UDPNetwork::Ephemeral(ephemeral_config) = &udp_network {
|
||||||
|
/*TODO:switch network {
|
||||||
|
case tcp:
|
||||||
|
// Handle ICE TCP passive mode
|
||||||
|
|
||||||
|
a.log.Debugf("GetConn by ufrag: %s\n", a.localUfrag)
|
||||||
|
conn, err = a.tcpMux.GetConnByUfrag(a.localUfrag)
|
||||||
|
if err != nil {
|
||||||
|
if !errors.Is(err, ErrTCPMuxNotInitialized) {
|
||||||
|
a.log.Warnf("error getting tcp conn by ufrag: %s %s %s\n", network, ip, a.localUfrag)
|
||||||
|
}
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
port = conn.LocalAddr().(*net.TCPAddr).Port
|
||||||
|
tcpType = TCPTypePassive
|
||||||
|
// is there a way to verify that the listen address is even
|
||||||
|
// accessible from the current interface.
|
||||||
|
case udp:*/
|
||||||
|
|
||||||
|
let conn: Arc<dyn Conn + Send + Sync> = match listen_udp_in_port_range(
|
||||||
|
&net,
|
||||||
|
ephemeral_config.port_max(),
|
||||||
|
ephemeral_config.port_min(),
|
||||||
|
SocketAddr::new(ip, 0),
|
||||||
|
)
|
||||||
|
.await
|
||||||
|
{
|
||||||
|
Ok(conn) => conn,
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: could not listen {} {}: {}",
|
||||||
|
agent_internal.get_name(),
|
||||||
|
network,
|
||||||
|
ip,
|
||||||
|
err
|
||||||
|
);
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
let port = match conn.local_addr() {
|
||||||
|
Ok(addr) => addr.port(),
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: could not get local addr: {}",
|
||||||
|
agent_internal.get_name(),
|
||||||
|
err
|
||||||
|
);
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
let host_config = CandidateHostConfig {
|
||||||
|
base_config: CandidateBaseConfig {
|
||||||
|
network: network.clone(),
|
||||||
|
address,
|
||||||
|
port,
|
||||||
|
component: COMPONENT_RTP,
|
||||||
|
conn: Some(conn),
|
||||||
|
..CandidateBaseConfig::default()
|
||||||
|
},
|
||||||
|
..CandidateHostConfig::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
let candidate: Arc<dyn Candidate + Send + Sync> =
|
||||||
|
match host_config.new_candidate_host() {
|
||||||
|
Ok(candidate) => {
|
||||||
|
if mdns_mode == MulticastDnsMode::QueryAndGather {
|
||||||
|
if let Err(err) = candidate.set_ip(&ip) {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to create host candidate: {} {} {}: {:?}",
|
||||||
|
agent_internal.get_name(),
|
||||||
|
network,
|
||||||
|
mapped_ip,
|
||||||
|
port,
|
||||||
|
err
|
||||||
|
);
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Arc::new(candidate)
|
||||||
|
}
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to create host candidate: {} {} {}: {}",
|
||||||
|
agent_internal.get_name(),
|
||||||
|
network,
|
||||||
|
mapped_ip,
|
||||||
|
port,
|
||||||
|
err
|
||||||
|
);
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
{
|
||||||
|
if let Err(err) = agent_internal.add_candidate(&candidate).await {
|
||||||
|
if let Err(close_err) = candidate.close().await {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to close candidate: {}",
|
||||||
|
agent_internal.get_name(),
|
||||||
|
close_err
|
||||||
|
);
|
||||||
|
}
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to append to localCandidates and run onCandidateHdlr: {}",
|
||||||
|
agent_internal.get_name(),
|
||||||
|
err
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn gather_candidates_local_udp_mux(
|
||||||
|
params: GatherCandidatesLocalUDPMuxParams,
|
||||||
|
) -> Result<()> {
|
||||||
|
let GatherCandidatesLocalUDPMuxParams {
|
||||||
|
network_types,
|
||||||
|
interface_filter,
|
||||||
|
ip_filter,
|
||||||
|
ext_ip_mapper,
|
||||||
|
net,
|
||||||
|
agent_internal,
|
||||||
|
udp_mux,
|
||||||
|
} = params;
|
||||||
|
|
||||||
|
// Filter out non UDP network types
|
||||||
|
let relevant_network_types: Vec<_> =
|
||||||
|
network_types.into_iter().filter(|n| n.is_udp()).collect();
|
||||||
|
|
||||||
|
let udp_mux = Arc::clone(&udp_mux);
|
||||||
|
|
||||||
|
let local_ips =
|
||||||
|
local_interfaces(&net, &interface_filter, &ip_filter, &relevant_network_types).await;
|
||||||
|
|
||||||
|
let candidate_ips: Vec<std::net::IpAddr> = ext_ip_mapper
|
||||||
|
.as_ref() // Arc
|
||||||
|
.as_ref() // Option
|
||||||
|
.and_then(|mapper| {
|
||||||
|
if mapper.candidate_type != CandidateType::Host {
|
||||||
|
return None;
|
||||||
|
}
|
||||||
|
|
||||||
|
Some(
|
||||||
|
local_ips
|
||||||
|
.iter()
|
||||||
|
.filter_map(|ip| match mapper.find_external_ip(&ip.to_string()) {
|
||||||
|
Ok(ip) => Some(ip),
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!(
|
||||||
|
"1:1 NAT mapping is enabled but not external IP is found for {}: {}",
|
||||||
|
ip,
|
||||||
|
err
|
||||||
|
);
|
||||||
|
None
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.collect(),
|
||||||
|
)
|
||||||
|
})
|
||||||
|
.unwrap_or_else(|| local_ips.iter().copied().collect());
|
||||||
|
|
||||||
|
if candidate_ips.is_empty() {
|
||||||
|
return Err(Error::ErrCandidateIpNotFound);
|
||||||
|
}
|
||||||
|
|
||||||
|
let ufrag = {
|
||||||
|
let ufrag_pwd = agent_internal.ufrag_pwd.lock().await;
|
||||||
|
|
||||||
|
ufrag_pwd.local_ufrag.clone()
|
||||||
|
};
|
||||||
|
|
||||||
|
let conn = udp_mux.get_conn(&ufrag).await?;
|
||||||
|
let port = conn.local_addr()?.port();
|
||||||
|
|
||||||
|
for candidate_ip in candidate_ips {
|
||||||
|
let host_config = CandidateHostConfig {
|
||||||
|
base_config: CandidateBaseConfig {
|
||||||
|
network: UDP.to_owned(),
|
||||||
|
address: candidate_ip.to_string(),
|
||||||
|
port,
|
||||||
|
conn: Some(conn.clone()),
|
||||||
|
component: COMPONENT_RTP,
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
tcp_type: TcpType::Unspecified,
|
||||||
|
};
|
||||||
|
|
||||||
|
let candidate: Arc<dyn Candidate + Send + Sync> =
|
||||||
|
Arc::new(host_config.new_candidate_host()?);
|
||||||
|
|
||||||
|
agent_internal.add_candidate(&candidate).await?;
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn gather_candidates_srflx_mapped(params: GatherCandidatesSrflxMappedParasm) {
|
||||||
|
let GatherCandidatesSrflxMappedParasm {
|
||||||
|
network_types,
|
||||||
|
port_max,
|
||||||
|
port_min,
|
||||||
|
ext_ip_mapper,
|
||||||
|
net,
|
||||||
|
agent_internal,
|
||||||
|
} = params;
|
||||||
|
|
||||||
|
let wg = WaitGroup::new();
|
||||||
|
|
||||||
|
for network_type in network_types {
|
||||||
|
if network_type.is_tcp() {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
let network = network_type.to_string();
|
||||||
|
let net2 = Arc::clone(&net);
|
||||||
|
let agent_internal2 = Arc::clone(&agent_internal);
|
||||||
|
let ext_ip_mapper2 = Arc::clone(&ext_ip_mapper);
|
||||||
|
|
||||||
|
let w = wg.worker();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let _d = w;
|
||||||
|
|
||||||
|
let conn: Arc<dyn Conn + Send + Sync> = match listen_udp_in_port_range(
|
||||||
|
&net2,
|
||||||
|
port_max,
|
||||||
|
port_min,
|
||||||
|
if network_type.is_ipv4() {
|
||||||
|
SocketAddr::new(Ipv4Addr::new(0, 0, 0, 0).into(), 0)
|
||||||
|
} else {
|
||||||
|
SocketAddr::new(Ipv6Addr::new(0, 0, 0, 0, 0, 0, 0, 0).into(), 0)
|
||||||
|
},
|
||||||
|
)
|
||||||
|
.await
|
||||||
|
{
|
||||||
|
Ok(conn) => conn,
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to listen {}: {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
network,
|
||||||
|
err
|
||||||
|
);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
let laddr = conn.local_addr()?;
|
||||||
|
let mapped_ip = {
|
||||||
|
if let Some(ext_ip_mapper3) = &*ext_ip_mapper2 {
|
||||||
|
match ext_ip_mapper3.find_external_ip(&laddr.ip().to_string()) {
|
||||||
|
Ok(ip) => ip,
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: 1:1 NAT mapping is enabled but no external IP is found for {}: {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
laddr,
|
||||||
|
err
|
||||||
|
);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
log::error!(
|
||||||
|
"[{}]: ext_ip_mapper is None in gather_candidates_srflx_mapped",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
let srflx_config = CandidateServerReflexiveConfig {
|
||||||
|
base_config: CandidateBaseConfig {
|
||||||
|
network: network.clone(),
|
||||||
|
address: mapped_ip.to_string(),
|
||||||
|
port: laddr.port(),
|
||||||
|
component: COMPONENT_RTP,
|
||||||
|
conn: Some(conn),
|
||||||
|
..CandidateBaseConfig::default()
|
||||||
|
},
|
||||||
|
rel_addr: laddr.ip().to_string(),
|
||||||
|
rel_port: laddr.port(),
|
||||||
|
};
|
||||||
|
|
||||||
|
let candidate: Arc<dyn Candidate + Send + Sync> =
|
||||||
|
match srflx_config.new_candidate_server_reflexive() {
|
||||||
|
Ok(candidate) => Arc::new(candidate),
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to create server reflexive candidate: {} {} {}: {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
network,
|
||||||
|
mapped_ip,
|
||||||
|
laddr.port(),
|
||||||
|
err
|
||||||
|
);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
{
|
||||||
|
if let Err(err) = agent_internal2.add_candidate(&candidate).await {
|
||||||
|
if let Err(close_err) = candidate.close().await {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to close candidate: {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
close_err
|
||||||
|
);
|
||||||
|
}
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to append to localCandidates and run onCandidateHdlr: {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
err
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Result::<()>::Ok(())
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
wg.wait().await;
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn gather_candidates_srflx(params: GatherCandidatesSrflxParams) {
|
||||||
|
let GatherCandidatesSrflxParams {
|
||||||
|
urls,
|
||||||
|
network_types,
|
||||||
|
port_max,
|
||||||
|
port_min,
|
||||||
|
net,
|
||||||
|
agent_internal,
|
||||||
|
} = params;
|
||||||
|
|
||||||
|
let wg = WaitGroup::new();
|
||||||
|
for network_type in network_types {
|
||||||
|
if network_type.is_tcp() {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
for url in &urls {
|
||||||
|
let network = network_type.to_string();
|
||||||
|
let is_ipv4 = network_type.is_ipv4();
|
||||||
|
let url = url.clone();
|
||||||
|
let net2 = Arc::clone(&net);
|
||||||
|
let agent_internal2 = Arc::clone(&agent_internal);
|
||||||
|
|
||||||
|
let w = wg.worker();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let _d = w;
|
||||||
|
|
||||||
|
let host_port = format!("{}:{}", url.host, url.port);
|
||||||
|
let server_addr = match net2.resolve_addr(is_ipv4, &host_port).await {
|
||||||
|
Ok(addr) => addr,
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: failed to resolve stun host: {}: {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
host_port,
|
||||||
|
err
|
||||||
|
);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
let conn: Arc<dyn Conn + Send + Sync> = match listen_udp_in_port_range(
|
||||||
|
&net2,
|
||||||
|
port_max,
|
||||||
|
port_min,
|
||||||
|
if is_ipv4 {
|
||||||
|
SocketAddr::new(Ipv4Addr::new(0, 0, 0, 0).into(), 0)
|
||||||
|
} else {
|
||||||
|
SocketAddr::new(Ipv6Addr::new(0, 0, 0, 0, 0, 0, 0, 0).into(), 0)
|
||||||
|
},
|
||||||
|
)
|
||||||
|
.await
|
||||||
|
{
|
||||||
|
Ok(conn) => conn,
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to listen for {}: {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
server_addr,
|
||||||
|
err
|
||||||
|
);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
let xoraddr =
|
||||||
|
match get_xormapped_addr(&conn, server_addr, STUN_GATHER_TIMEOUT).await {
|
||||||
|
Ok(xoraddr) => xoraddr,
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: could not get server reflexive address {} {}: {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
network,
|
||||||
|
url,
|
||||||
|
err
|
||||||
|
);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
let (ip, port) = (xoraddr.ip, xoraddr.port);
|
||||||
|
|
||||||
|
let laddr = conn.local_addr()?;
|
||||||
|
let srflx_config = CandidateServerReflexiveConfig {
|
||||||
|
base_config: CandidateBaseConfig {
|
||||||
|
network: network.clone(),
|
||||||
|
address: ip.to_string(),
|
||||||
|
port,
|
||||||
|
component: COMPONENT_RTP,
|
||||||
|
conn: Some(conn),
|
||||||
|
..CandidateBaseConfig::default()
|
||||||
|
},
|
||||||
|
rel_addr: laddr.ip().to_string(),
|
||||||
|
rel_port: laddr.port(),
|
||||||
|
};
|
||||||
|
|
||||||
|
let candidate: Arc<dyn Candidate + Send + Sync> =
|
||||||
|
match srflx_config.new_candidate_server_reflexive() {
|
||||||
|
Ok(candidate) => Arc::new(candidate),
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to create server reflexive candidate: {} {} {}: {:?}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
network,
|
||||||
|
ip,
|
||||||
|
port,
|
||||||
|
err
|
||||||
|
);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
{
|
||||||
|
if let Err(err) = agent_internal2.add_candidate(&candidate).await {
|
||||||
|
if let Err(close_err) = candidate.close().await {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to close candidate: {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
close_err
|
||||||
|
);
|
||||||
|
}
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to append to localCandidates and run onCandidateHdlr: {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
err
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Result::<()>::Ok(())
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
wg.wait().await;
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) async fn gather_candidates_relay(
|
||||||
|
urls: Vec<Url>,
|
||||||
|
net: Arc<Net>,
|
||||||
|
agent_internal: Arc<AgentInternal>,
|
||||||
|
) {
|
||||||
|
let wg = WaitGroup::new();
|
||||||
|
|
||||||
|
for url in urls {
|
||||||
|
if url.scheme != SchemeType::Turn && url.scheme != SchemeType::Turns {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
if url.username.is_empty() {
|
||||||
|
log::error!(
|
||||||
|
"[{}]:Failed to gather relay candidates: {:?}",
|
||||||
|
agent_internal.get_name(),
|
||||||
|
Error::ErrUsernameEmpty
|
||||||
|
);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
if url.password.is_empty() {
|
||||||
|
log::error!(
|
||||||
|
"[{}]: Failed to gather relay candidates: {:?}",
|
||||||
|
agent_internal.get_name(),
|
||||||
|
Error::ErrPasswordEmpty
|
||||||
|
);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
let network = NetworkType::Udp4.to_string();
|
||||||
|
let net2 = Arc::clone(&net);
|
||||||
|
let agent_internal2 = Arc::clone(&agent_internal);
|
||||||
|
|
||||||
|
let w = wg.worker();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let _d = w;
|
||||||
|
|
||||||
|
let turn_server_addr = format!("{}:{}", url.host, url.port);
|
||||||
|
|
||||||
|
let (loc_conn, rel_addr, rel_port) =
|
||||||
|
if url.proto == ProtoType::Udp && url.scheme == SchemeType::Turn {
|
||||||
|
let loc_conn = match net2.bind(SocketAddr::from_str("0.0.0.0:0")?).await {
|
||||||
|
Ok(c) => c,
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to listen due to error: {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
err
|
||||||
|
);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
let local_addr = loc_conn.local_addr()?;
|
||||||
|
let rel_addr = local_addr.ip().to_string();
|
||||||
|
let rel_port = local_addr.port();
|
||||||
|
(loc_conn, rel_addr, rel_port)
|
||||||
|
/*TODO: case url.proto == ProtoType::UDP && url.scheme == SchemeType::TURNS{*/
|
||||||
|
} else if url.proto == ProtoType::Tcp && super::turn_tcp::enabled() {
|
||||||
|
// uu-remote-linux patch: TURN over TCP/TLS, optionally via an HTTP proxy.
|
||||||
|
let server = tokio::net::lookup_host(turn_server_addr.as_str()).await.ok()
|
||||||
|
.and_then(|mut addrs| addrs.next())
|
||||||
|
.unwrap_or_else(|| SocketAddr::from(([0, 0, 0, 0], url.port)));
|
||||||
|
let tls = url.scheme == SchemeType::Turns;
|
||||||
|
match super::turn_tcp::dial(&url.host, url.port, server, tls).await {
|
||||||
|
Ok(conn) => {
|
||||||
|
let local_addr = conn.local_addr()?;
|
||||||
|
let loc_conn: Arc<dyn Conn + Send + Sync> = Arc::new(conn);
|
||||||
|
(loc_conn, local_addr.ip().to_string(), local_addr.port())
|
||||||
|
}
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to open TURN {} connection: {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
if tls { "TLS" } else { "TCP" },
|
||||||
|
err
|
||||||
|
);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Unable to handle URL in gather_candidates_relay {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
url
|
||||||
|
);
|
||||||
|
return Ok(());
|
||||||
|
};
|
||||||
|
|
||||||
|
let cfg = turn::client::ClientConfig {
|
||||||
|
stun_serv_addr: String::new(),
|
||||||
|
turn_serv_addr: turn_server_addr.clone(),
|
||||||
|
username: url.username,
|
||||||
|
password: url.password,
|
||||||
|
realm: String::new(),
|
||||||
|
software: String::new(),
|
||||||
|
rto_in_ms: 0,
|
||||||
|
conn: loc_conn,
|
||||||
|
vnet: Some(Arc::clone(&net2)),
|
||||||
|
};
|
||||||
|
let client = match turn::client::Client::new(cfg).await {
|
||||||
|
Ok(client) => Arc::new(client),
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to build new turn.Client {} {}\n",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
turn_server_addr,
|
||||||
|
err
|
||||||
|
);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
};
|
||||||
|
if let Err(err) = client.listen().await {
|
||||||
|
let _ = client.close().await;
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to listen on turn.Client {} {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
turn_server_addr,
|
||||||
|
err
|
||||||
|
);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
|
||||||
|
let relay_conn: Arc<dyn Conn + Send + Sync> = match client.allocate().await {
|
||||||
|
Ok(conn) => Arc::new(conn),
|
||||||
|
Err(err) => {
|
||||||
|
let _ = client.close().await;
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to allocate on turn.Client {} {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
turn_server_addr,
|
||||||
|
err
|
||||||
|
);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
let raddr = relay_conn.local_addr()?;
|
||||||
|
let relay_config = CandidateRelayConfig {
|
||||||
|
base_config: CandidateBaseConfig {
|
||||||
|
network: network.clone(),
|
||||||
|
address: raddr.ip().to_string(),
|
||||||
|
port: raddr.port(),
|
||||||
|
component: COMPONENT_RTP,
|
||||||
|
conn: Some(Arc::clone(&relay_conn)),
|
||||||
|
..CandidateBaseConfig::default()
|
||||||
|
},
|
||||||
|
rel_addr,
|
||||||
|
rel_port,
|
||||||
|
relay_client: Some(Arc::clone(&client)),
|
||||||
|
};
|
||||||
|
|
||||||
|
let candidate: Arc<dyn Candidate + Send + Sync> =
|
||||||
|
match relay_config.new_candidate_relay() {
|
||||||
|
Ok(candidate) => Arc::new(candidate),
|
||||||
|
Err(err) => {
|
||||||
|
let _ = relay_conn.close().await;
|
||||||
|
let _ = client.close().await;
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to create relay candidate: {} {}: {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
network,
|
||||||
|
raddr,
|
||||||
|
err
|
||||||
|
);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
{
|
||||||
|
if let Err(err) = agent_internal2.add_candidate(&candidate).await {
|
||||||
|
if let Err(close_err) = candidate.close().await {
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to close candidate: {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
close_err
|
||||||
|
);
|
||||||
|
}
|
||||||
|
log::warn!(
|
||||||
|
"[{}]: Failed to append to localCandidates and run onCandidateHdlr: {}",
|
||||||
|
agent_internal2.get_name(),
|
||||||
|
err
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Result::<()>::Ok(())
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
wg.wait().await;
|
||||||
|
}
|
||||||
|
}
|
||||||
+490
@@ -0,0 +1,490 @@
|
|||||||
|
use std::str::FromStr;
|
||||||
|
|
||||||
|
use ipnet::IpNet;
|
||||||
|
use tokio::net::UdpSocket;
|
||||||
|
use util::vnet::*;
|
||||||
|
|
||||||
|
use super::agent_vnet_test::*;
|
||||||
|
use super::*;
|
||||||
|
use crate::udp_mux::{UDPMuxDefault, UDPMuxParams};
|
||||||
|
use crate::util::*;
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn test_vnet_gather_no_local_ip_address() -> Result<()> {
|
||||||
|
let vnet = Arc::new(net::Net::new(Some(net::NetConfig::default())));
|
||||||
|
|
||||||
|
let a = Agent::new(AgentConfig {
|
||||||
|
net: Some(Arc::clone(&vnet)),
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.await?;
|
||||||
|
|
||||||
|
let local_ips = local_interfaces(
|
||||||
|
&vnet,
|
||||||
|
&a.interface_filter,
|
||||||
|
&a.ip_filter,
|
||||||
|
&[NetworkType::Udp4],
|
||||||
|
)
|
||||||
|
.await;
|
||||||
|
assert!(local_ips.is_empty(), "should return no local IP");
|
||||||
|
|
||||||
|
a.close().await?;
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn test_vnet_gather_dynamic_ip_address() -> Result<()> {
|
||||||
|
let cider = "1.2.3.0/24";
|
||||||
|
let ipnet = IpNet::from_str(cider).map_err(|e| Error::Other(e.to_string()))?;
|
||||||
|
|
||||||
|
let r = Arc::new(Mutex::new(router::Router::new(router::RouterConfig {
|
||||||
|
cidr: cider.to_owned(),
|
||||||
|
..Default::default()
|
||||||
|
})?));
|
||||||
|
let nw = Arc::new(net::Net::new(Some(net::NetConfig::default())));
|
||||||
|
connect_net2router(&nw, &r).await?;
|
||||||
|
|
||||||
|
let a = Agent::new(AgentConfig {
|
||||||
|
net: Some(Arc::clone(&nw)),
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.await?;
|
||||||
|
|
||||||
|
let local_ips =
|
||||||
|
local_interfaces(&nw, &a.interface_filter, &a.ip_filter, &[NetworkType::Udp4]).await;
|
||||||
|
assert!(!local_ips.is_empty(), "should have one local IP");
|
||||||
|
|
||||||
|
for ip in &local_ips {
|
||||||
|
if ip.is_loopback() {
|
||||||
|
panic!("should not return loopback IP");
|
||||||
|
}
|
||||||
|
if !ipnet.contains(ip) {
|
||||||
|
panic!("{ip} should be contained in the CIDR {ipnet}");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
a.close().await?;
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn test_vnet_gather_listen_udp() -> Result<()> {
|
||||||
|
let cider = "1.2.3.0/24";
|
||||||
|
let r = Arc::new(Mutex::new(router::Router::new(router::RouterConfig {
|
||||||
|
cidr: cider.to_owned(),
|
||||||
|
..Default::default()
|
||||||
|
})?));
|
||||||
|
let nw = Arc::new(net::Net::new(Some(net::NetConfig::default())));
|
||||||
|
connect_net2router(&nw, &r).await?;
|
||||||
|
|
||||||
|
let a = Agent::new(AgentConfig {
|
||||||
|
net: Some(Arc::clone(&nw)),
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.await?;
|
||||||
|
|
||||||
|
let local_ips =
|
||||||
|
local_interfaces(&nw, &a.interface_filter, &a.ip_filter, &[NetworkType::Udp4]).await;
|
||||||
|
assert!(!local_ips.is_empty(), "should have one local IP");
|
||||||
|
|
||||||
|
for ip in local_ips {
|
||||||
|
let _ = listen_udp_in_port_range(&nw, 0, 0, SocketAddr::new(ip, 0)).await?;
|
||||||
|
|
||||||
|
let result = listen_udp_in_port_range(&nw, 4999, 5000, SocketAddr::new(ip, 0)).await;
|
||||||
|
assert!(
|
||||||
|
result.is_err(),
|
||||||
|
"listenUDP with invalid port range did not return ErrPort"
|
||||||
|
);
|
||||||
|
|
||||||
|
let conn = listen_udp_in_port_range(&nw, 5000, 5000, SocketAddr::new(ip, 0)).await?;
|
||||||
|
let port = conn.local_addr()?.port();
|
||||||
|
assert_eq!(
|
||||||
|
port, 5000,
|
||||||
|
"listenUDP with port restriction of 5000 listened on incorrect port ({port})"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
a.close().await?;
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn test_vnet_gather_with_nat_1to1_as_host_candidates() -> Result<()> {
|
||||||
|
let external_ip0 = "1.2.3.4";
|
||||||
|
let external_ip1 = "1.2.3.5";
|
||||||
|
let local_ip0 = "10.0.0.1";
|
||||||
|
let local_ip1 = "10.0.0.2";
|
||||||
|
let map0 = format!("{external_ip0}/{local_ip0}");
|
||||||
|
let map1 = format!("{external_ip1}/{local_ip1}");
|
||||||
|
|
||||||
|
let wan = Arc::new(Mutex::new(router::Router::new(router::RouterConfig {
|
||||||
|
cidr: "1.2.3.0/24".to_owned(),
|
||||||
|
..Default::default()
|
||||||
|
})?));
|
||||||
|
|
||||||
|
let lan = Arc::new(Mutex::new(router::Router::new(router::RouterConfig {
|
||||||
|
cidr: "10.0.0.0/24".to_owned(),
|
||||||
|
static_ips: vec![map0.clone(), map1.clone()],
|
||||||
|
nat_type: Some(nat::NatType {
|
||||||
|
mode: nat::NatMode::Nat1To1,
|
||||||
|
..Default::default()
|
||||||
|
}),
|
||||||
|
..Default::default()
|
||||||
|
})?));
|
||||||
|
|
||||||
|
connect_router2router(&lan, &wan).await?;
|
||||||
|
|
||||||
|
let nw = Arc::new(net::Net::new(Some(net::NetConfig {
|
||||||
|
static_ips: vec![local_ip0.to_owned(), local_ip1.to_owned()],
|
||||||
|
..Default::default()
|
||||||
|
})));
|
||||||
|
|
||||||
|
connect_net2router(&nw, &lan).await?;
|
||||||
|
|
||||||
|
let a = Agent::new(AgentConfig {
|
||||||
|
network_types: vec![NetworkType::Udp4],
|
||||||
|
nat_1to1_ips: vec![map0.clone(), map1.clone()],
|
||||||
|
net: Some(Arc::clone(&nw)),
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.await?;
|
||||||
|
|
||||||
|
let (done_tx, mut done_rx) = mpsc::channel::<()>(1);
|
||||||
|
let done_tx = Arc::new(Mutex::new(Some(done_tx)));
|
||||||
|
a.on_candidate(Box::new(
|
||||||
|
move |c: Option<Arc<dyn Candidate + Send + Sync>>| {
|
||||||
|
let done_tx_clone = Arc::clone(&done_tx);
|
||||||
|
Box::pin(async move {
|
||||||
|
if c.is_none() {
|
||||||
|
let mut tx = done_tx_clone.lock().await;
|
||||||
|
tx.take();
|
||||||
|
}
|
||||||
|
})
|
||||||
|
},
|
||||||
|
));
|
||||||
|
|
||||||
|
a.gather_candidates()?;
|
||||||
|
|
||||||
|
log::debug!("wait for gathering is done...");
|
||||||
|
let _ = done_rx.recv().await;
|
||||||
|
log::debug!("gathering is done");
|
||||||
|
|
||||||
|
let candidates = a.get_local_candidates().await?;
|
||||||
|
assert_eq!(candidates.len(), 2, "There must be two candidates");
|
||||||
|
|
||||||
|
let mut laddrs = vec![];
|
||||||
|
for candi in &candidates {
|
||||||
|
if let Some(conn) = candi.get_conn() {
|
||||||
|
let laddr = conn.local_addr()?;
|
||||||
|
assert_eq!(
|
||||||
|
candi.port(),
|
||||||
|
laddr.port(),
|
||||||
|
"Unexpected candidate port: {}",
|
||||||
|
candi.port()
|
||||||
|
);
|
||||||
|
laddrs.push(laddr);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if candidates[0].address() == external_ip0 {
|
||||||
|
assert_eq!(
|
||||||
|
candidates[1].address(),
|
||||||
|
external_ip1,
|
||||||
|
"Unexpected candidate IP: {}",
|
||||||
|
candidates[1].address()
|
||||||
|
);
|
||||||
|
assert_eq!(
|
||||||
|
laddrs[0].ip().to_string(),
|
||||||
|
local_ip0,
|
||||||
|
"Unexpected listen IP: {}",
|
||||||
|
laddrs[0].ip()
|
||||||
|
);
|
||||||
|
assert_eq!(
|
||||||
|
laddrs[1].ip().to_string(),
|
||||||
|
local_ip1,
|
||||||
|
"Unexpected listen IP: {}",
|
||||||
|
laddrs[1].ip()
|
||||||
|
);
|
||||||
|
} else if candidates[0].address() == external_ip1 {
|
||||||
|
assert_eq!(
|
||||||
|
candidates[1].address(),
|
||||||
|
external_ip0,
|
||||||
|
"Unexpected candidate IP: {}",
|
||||||
|
candidates[1].address()
|
||||||
|
);
|
||||||
|
assert_eq!(
|
||||||
|
laddrs[0].ip().to_string(),
|
||||||
|
local_ip1,
|
||||||
|
"Unexpected listen IP: {}",
|
||||||
|
laddrs[0].ip(),
|
||||||
|
);
|
||||||
|
assert_eq!(
|
||||||
|
laddrs[1].ip().to_string(),
|
||||||
|
local_ip0,
|
||||||
|
"Unexpected listen IP: {}",
|
||||||
|
laddrs[1].ip(),
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
a.close().await?;
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn test_vnet_gather_with_nat_1to1_as_srflx_candidates() -> Result<()> {
|
||||||
|
let wan = Arc::new(Mutex::new(router::Router::new(router::RouterConfig {
|
||||||
|
cidr: "1.2.3.0/24".to_owned(),
|
||||||
|
..Default::default()
|
||||||
|
})?));
|
||||||
|
|
||||||
|
let lan = Arc::new(Mutex::new(router::Router::new(router::RouterConfig {
|
||||||
|
cidr: "10.0.0.0/24".to_owned(),
|
||||||
|
static_ips: vec!["1.2.3.4/10.0.0.1".to_owned()],
|
||||||
|
nat_type: Some(nat::NatType {
|
||||||
|
mode: nat::NatMode::Nat1To1,
|
||||||
|
..Default::default()
|
||||||
|
}),
|
||||||
|
..Default::default()
|
||||||
|
})?));
|
||||||
|
|
||||||
|
connect_router2router(&lan, &wan).await?;
|
||||||
|
|
||||||
|
let nw = Arc::new(net::Net::new(Some(net::NetConfig {
|
||||||
|
static_ips: vec!["10.0.0.1".to_owned()],
|
||||||
|
..Default::default()
|
||||||
|
})));
|
||||||
|
|
||||||
|
connect_net2router(&nw, &lan).await?;
|
||||||
|
|
||||||
|
let a = Agent::new(AgentConfig {
|
||||||
|
network_types: vec![NetworkType::Udp4],
|
||||||
|
nat_1to1_ips: vec!["1.2.3.4".to_owned()],
|
||||||
|
nat_1to1_ip_candidate_type: CandidateType::ServerReflexive,
|
||||||
|
net: Some(nw),
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.await?;
|
||||||
|
|
||||||
|
let (done_tx, mut done_rx) = mpsc::channel::<()>(1);
|
||||||
|
let done_tx = Arc::new(Mutex::new(Some(done_tx)));
|
||||||
|
a.on_candidate(Box::new(
|
||||||
|
move |c: Option<Arc<dyn Candidate + Send + Sync>>| {
|
||||||
|
let done_tx_clone = Arc::clone(&done_tx);
|
||||||
|
Box::pin(async move {
|
||||||
|
if c.is_none() {
|
||||||
|
let mut tx = done_tx_clone.lock().await;
|
||||||
|
tx.take();
|
||||||
|
}
|
||||||
|
})
|
||||||
|
},
|
||||||
|
));
|
||||||
|
|
||||||
|
a.gather_candidates()?;
|
||||||
|
|
||||||
|
log::debug!("wait for gathering is done...");
|
||||||
|
let _ = done_rx.recv().await;
|
||||||
|
log::debug!("gathering is done");
|
||||||
|
|
||||||
|
let candidates = a.get_local_candidates().await?;
|
||||||
|
assert_eq!(candidates.len(), 2, "There must be two candidates");
|
||||||
|
|
||||||
|
let mut candi_host = None;
|
||||||
|
let mut candi_srflx = None;
|
||||||
|
|
||||||
|
for candidate in candidates {
|
||||||
|
match candidate.candidate_type() {
|
||||||
|
CandidateType::Host => {
|
||||||
|
candi_host = Some(candidate);
|
||||||
|
}
|
||||||
|
CandidateType::ServerReflexive => {
|
||||||
|
candi_srflx = Some(candidate);
|
||||||
|
}
|
||||||
|
_ => {
|
||||||
|
panic!("Unexpected candidate type");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
assert!(candi_host.is_some(), "should not be nil");
|
||||||
|
assert_eq!("10.0.0.1", candi_host.unwrap().address(), "should match");
|
||||||
|
assert!(candi_srflx.is_some(), "should not be nil");
|
||||||
|
assert_eq!("1.2.3.4", candi_srflx.unwrap().address(), "should match");
|
||||||
|
|
||||||
|
a.close().await?;
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn test_vnet_gather_with_interface_filter() -> Result<()> {
|
||||||
|
let r = Arc::new(Mutex::new(router::Router::new(router::RouterConfig {
|
||||||
|
cidr: "1.2.3.0/24".to_owned(),
|
||||||
|
..Default::default()
|
||||||
|
})?));
|
||||||
|
let nw = Arc::new(net::Net::new(Some(net::NetConfig::default())));
|
||||||
|
connect_net2router(&nw, &r).await?;
|
||||||
|
|
||||||
|
//"InterfaceFilter should exclude the interface"
|
||||||
|
{
|
||||||
|
let a = Agent::new(AgentConfig {
|
||||||
|
net: Some(Arc::clone(&nw)),
|
||||||
|
interface_filter: Arc::new(Some(Box::new(|_: &str| -> bool {
|
||||||
|
//assert_eq!("eth0", interface_name);
|
||||||
|
false
|
||||||
|
}))),
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.await?;
|
||||||
|
|
||||||
|
let local_ips =
|
||||||
|
local_interfaces(&nw, &a.interface_filter, &a.ip_filter, &[NetworkType::Udp4]).await;
|
||||||
|
assert!(
|
||||||
|
local_ips.is_empty(),
|
||||||
|
"InterfaceFilter should have excluded everything"
|
||||||
|
);
|
||||||
|
|
||||||
|
a.close().await?;
|
||||||
|
}
|
||||||
|
|
||||||
|
//"InterfaceFilter should not exclude the interface"
|
||||||
|
{
|
||||||
|
let a = Agent::new(AgentConfig {
|
||||||
|
net: Some(Arc::clone(&nw)),
|
||||||
|
interface_filter: Arc::new(Some(Box::new(|interface_name: &str| -> bool {
|
||||||
|
"eth0" == interface_name
|
||||||
|
}))),
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.await?;
|
||||||
|
|
||||||
|
let local_ips =
|
||||||
|
local_interfaces(&nw, &a.interface_filter, &a.ip_filter, &[NetworkType::Udp4]).await;
|
||||||
|
assert_eq!(
|
||||||
|
local_ips.len(),
|
||||||
|
1,
|
||||||
|
"InterfaceFilter should not have excluded everything"
|
||||||
|
);
|
||||||
|
|
||||||
|
a.close().await?;
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn test_vnet_gather_turn_connection_leak() -> Result<()> {
|
||||||
|
let turn_server_url = Url {
|
||||||
|
scheme: SchemeType::Turn,
|
||||||
|
host: VNET_STUN_SERVER_IP.to_owned(),
|
||||||
|
port: VNET_STUN_SERVER_PORT,
|
||||||
|
username: "user".to_owned(),
|
||||||
|
password: "pass".to_owned(),
|
||||||
|
proto: ProtoType::Udp,
|
||||||
|
};
|
||||||
|
|
||||||
|
// buildVNet with a Symmetric NATs for both LANs
|
||||||
|
let nat_type = nat::NatType {
|
||||||
|
mapping_behavior: nat::EndpointDependencyType::EndpointAddrPortDependent,
|
||||||
|
filtering_behavior: nat::EndpointDependencyType::EndpointAddrPortDependent,
|
||||||
|
..Default::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
let v = build_vnet(nat_type, nat_type).await?;
|
||||||
|
|
||||||
|
let cfg0 = AgentConfig {
|
||||||
|
urls: vec![turn_server_url.clone()],
|
||||||
|
network_types: supported_network_types(),
|
||||||
|
multicast_dns_mode: MulticastDnsMode::Disabled,
|
||||||
|
nat_1to1_ips: vec![VNET_GLOBAL_IPA.to_owned()],
|
||||||
|
net: Some(Arc::clone(&v.net0)),
|
||||||
|
..Default::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
let a_agent = Agent::new(cfg0).await?;
|
||||||
|
|
||||||
|
{
|
||||||
|
let agent_internal = Arc::clone(&a_agent.internal);
|
||||||
|
Agent::gather_candidates_relay(
|
||||||
|
vec![turn_server_url.clone()],
|
||||||
|
Arc::clone(&v.net0),
|
||||||
|
agent_internal,
|
||||||
|
)
|
||||||
|
.await;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Assert relay conn leak on close.
|
||||||
|
a_agent.close().await?;
|
||||||
|
v.close().await?;
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn test_vnet_gather_muxed_udp() -> Result<()> {
|
||||||
|
let udp_socket = UdpSocket::bind("0.0.0.0:0").await?;
|
||||||
|
let udp_mux = UDPMuxDefault::new(UDPMuxParams::new(udp_socket));
|
||||||
|
|
||||||
|
let lan = Arc::new(Mutex::new(router::Router::new(router::RouterConfig {
|
||||||
|
cidr: "10.0.0.0/24".to_owned(),
|
||||||
|
nat_type: Some(nat::NatType {
|
||||||
|
mode: nat::NatMode::Nat1To1,
|
||||||
|
..Default::default()
|
||||||
|
}),
|
||||||
|
..Default::default()
|
||||||
|
})?));
|
||||||
|
|
||||||
|
let nw = Arc::new(net::Net::new(Some(net::NetConfig {
|
||||||
|
static_ips: vec!["10.0.0.1".to_owned()],
|
||||||
|
..Default::default()
|
||||||
|
})));
|
||||||
|
|
||||||
|
connect_net2router(&nw, &lan).await?;
|
||||||
|
|
||||||
|
let a = Agent::new(AgentConfig {
|
||||||
|
network_types: vec![NetworkType::Udp4],
|
||||||
|
nat_1to1_ips: vec!["1.2.3.4".to_owned()],
|
||||||
|
net: Some(nw),
|
||||||
|
udp_network: UDPNetwork::Muxed(udp_mux),
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.await?;
|
||||||
|
|
||||||
|
let (done_tx, mut done_rx) = mpsc::channel::<()>(1);
|
||||||
|
let done_tx = Arc::new(Mutex::new(Some(done_tx)));
|
||||||
|
a.on_candidate(Box::new(
|
||||||
|
move |c: Option<Arc<dyn Candidate + Send + Sync>>| {
|
||||||
|
let done_tx_clone = Arc::clone(&done_tx);
|
||||||
|
Box::pin(async move {
|
||||||
|
if c.is_none() {
|
||||||
|
let mut tx = done_tx_clone.lock().await;
|
||||||
|
tx.take();
|
||||||
|
}
|
||||||
|
})
|
||||||
|
},
|
||||||
|
));
|
||||||
|
|
||||||
|
a.gather_candidates()?;
|
||||||
|
|
||||||
|
log::debug!("wait for gathering is done...");
|
||||||
|
let _ = done_rx.recv().await;
|
||||||
|
log::debug!("gathering is done");
|
||||||
|
|
||||||
|
let candidates = a.get_local_candidates().await?;
|
||||||
|
assert_eq!(candidates.len(), 1, "There must be a single candidate");
|
||||||
|
|
||||||
|
let candi = &candidates[0];
|
||||||
|
let laddr = candi.get_conn().unwrap().local_addr()?;
|
||||||
|
assert_eq!(candi.address(), "1.2.3.4");
|
||||||
|
assert_eq!(
|
||||||
|
candi.port(),
|
||||||
|
laddr.port(),
|
||||||
|
"Unexpected candidate port: {}",
|
||||||
|
candi.port()
|
||||||
|
);
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
+1198
File diff suppressed because it is too large.
Load diff
+545
@@ -0,0 +1,545 @@
|
|||||||
|
use std::net::SocketAddr;
|
||||||
|
use std::sync::atomic::Ordering;
|
||||||
|
use std::sync::Arc;
|
||||||
|
|
||||||
|
use async_trait::async_trait;
|
||||||
|
use stun::agent::*;
|
||||||
|
use stun::attributes::*;
|
||||||
|
use stun::fingerprint::*;
|
||||||
|
use stun::integrity::*;
|
||||||
|
use stun::message::*;
|
||||||
|
use stun::textattrs::*;
|
||||||
|
use tokio::time::{Duration, Instant};
|
||||||
|
|
||||||
|
use crate::agent::agent_internal::*;
|
||||||
|
use crate::candidate::*;
|
||||||
|
use crate::control::*;
|
||||||
|
use crate::priority::*;
|
||||||
|
use crate::use_candidate::*;
|
||||||
|
|
||||||
|
#[async_trait]
|
||||||
|
trait ControllingSelector {
|
||||||
|
async fn start(&self);
|
||||||
|
async fn contact_candidates(&self);
|
||||||
|
async fn ping_candidate(
|
||||||
|
&self,
|
||||||
|
local: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
);
|
||||||
|
async fn handle_success_response(
|
||||||
|
&self,
|
||||||
|
m: &Message,
|
||||||
|
local: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote_addr: SocketAddr,
|
||||||
|
);
|
||||||
|
async fn handle_binding_request(
|
||||||
|
&self,
|
||||||
|
m: &Message,
|
||||||
|
local: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
#[async_trait]
|
||||||
|
trait ControlledSelector {
|
||||||
|
async fn start(&self);
|
||||||
|
async fn contact_candidates(&self);
|
||||||
|
async fn ping_candidate(
|
||||||
|
&self,
|
||||||
|
local: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
);
|
||||||
|
async fn handle_success_response(
|
||||||
|
&self,
|
||||||
|
m: &Message,
|
||||||
|
local: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote_addr: SocketAddr,
|
||||||
|
);
|
||||||
|
async fn handle_binding_request(
|
||||||
|
&self,
|
||||||
|
m: &Message,
|
||||||
|
local: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
impl AgentInternal {
|
||||||
|
fn is_nominatable(&self, c: &Arc<dyn Candidate + Send + Sync>) -> bool {
|
||||||
|
let start_time = *self.start_time.lock();
|
||||||
|
match c.candidate_type() {
|
||||||
|
CandidateType::Host => {
|
||||||
|
Instant::now()
|
||||||
|
.checked_duration_since(start_time)
|
||||||
|
.unwrap_or_else(|| Duration::from_secs(0))
|
||||||
|
.as_nanos()
|
||||||
|
> self.host_acceptance_min_wait.as_nanos()
|
||||||
|
}
|
||||||
|
CandidateType::ServerReflexive => {
|
||||||
|
Instant::now()
|
||||||
|
.checked_duration_since(start_time)
|
||||||
|
.unwrap_or_else(|| Duration::from_secs(0))
|
||||||
|
.as_nanos()
|
||||||
|
> self.srflx_acceptance_min_wait.as_nanos()
|
||||||
|
}
|
||||||
|
CandidateType::PeerReflexive => {
|
||||||
|
Instant::now()
|
||||||
|
.checked_duration_since(start_time)
|
||||||
|
.unwrap_or_else(|| Duration::from_secs(0))
|
||||||
|
.as_nanos()
|
||||||
|
> self.prflx_acceptance_min_wait.as_nanos()
|
||||||
|
}
|
||||||
|
CandidateType::Relay => {
|
||||||
|
Instant::now()
|
||||||
|
.checked_duration_since(start_time)
|
||||||
|
.unwrap_or_else(|| Duration::from_secs(0))
|
||||||
|
.as_nanos()
|
||||||
|
> self.relay_acceptance_min_wait.as_nanos()
|
||||||
|
}
|
||||||
|
CandidateType::Unspecified => {
|
||||||
|
log::error!(
|
||||||
|
"is_nominatable invalid candidate type {}",
|
||||||
|
c.candidate_type()
|
||||||
|
);
|
||||||
|
false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn nominate_pair(&self) {
|
||||||
|
let result = {
|
||||||
|
let nominated_pair = self.nominated_pair.lock().await;
|
||||||
|
if let Some(pair) = &*nominated_pair {
|
||||||
|
// The controlling agent MUST include the USE-CANDIDATE attribute in
|
||||||
|
// order to nominate a candidate pair (Section 8.1.1). The controlled
|
||||||
|
// agent MUST NOT include the USE-CANDIDATE attribute in a Binding
|
||||||
|
// request.
|
||||||
|
|
||||||
|
let (msg, result) = {
|
||||||
|
let ufrag_pwd = self.ufrag_pwd.lock().await;
|
||||||
|
let username =
|
||||||
|
ufrag_pwd.remote_ufrag.clone() + ":" + ufrag_pwd.local_ufrag.as_str();
|
||||||
|
let mut msg = Message::new();
|
||||||
|
let result = msg.build(&[
|
||||||
|
Box::new(BINDING_REQUEST),
|
||||||
|
Box::new(TransactionId::new()),
|
||||||
|
Box::new(Username::new(ATTR_USERNAME, username)),
|
||||||
|
Box::<UseCandidateAttr>::default(),
|
||||||
|
Box::new(AttrControlling(self.tie_breaker.load(Ordering::SeqCst))),
|
||||||
|
Box::new(PriorityAttr(pair.local.priority())),
|
||||||
|
Box::new(MessageIntegrity::new_short_term_integrity(
|
||||||
|
ufrag_pwd.remote_pwd.clone(),
|
||||||
|
)),
|
||||||
|
Box::new(FINGERPRINT),
|
||||||
|
]);
|
||||||
|
(msg, result)
|
||||||
|
};
|
||||||
|
|
||||||
|
if let Err(err) = result {
|
||||||
|
log::error!("{}", err);
|
||||||
|
None
|
||||||
|
} else {
|
||||||
|
log::trace!(
|
||||||
|
"ping STUN (nominate candidate pair from {} to {}",
|
||||||
|
pair.local,
|
||||||
|
pair.remote
|
||||||
|
);
|
||||||
|
let local = pair.local.clone();
|
||||||
|
let remote = pair.remote.clone();
|
||||||
|
Some((msg, local, remote))
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
None
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
if let Some((msg, local, remote)) = result {
|
||||||
|
self.send_binding_request(&msg, &local, &remote).await;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) async fn start(&self) {
|
||||||
|
if self.is_controlling.load(Ordering::SeqCst) {
|
||||||
|
ControllingSelector::start(self).await;
|
||||||
|
} else {
|
||||||
|
ControlledSelector::start(self).await;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) async fn contact_candidates(&self) {
|
||||||
|
if self.is_controlling.load(Ordering::SeqCst) {
|
||||||
|
ControllingSelector::contact_candidates(self).await;
|
||||||
|
} else {
|
||||||
|
ControlledSelector::contact_candidates(self).await;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) async fn ping_candidate(
|
||||||
|
&self,
|
||||||
|
local: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
) {
|
||||||
|
if self.is_controlling.load(Ordering::SeqCst) {
|
||||||
|
ControllingSelector::ping_candidate(self, local, remote).await;
|
||||||
|
} else {
|
||||||
|
ControlledSelector::ping_candidate(self, local, remote).await;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) async fn handle_success_response(
|
||||||
|
&self,
|
||||||
|
m: &Message,
|
||||||
|
local: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote_addr: SocketAddr,
|
||||||
|
) {
|
||||||
|
if self.is_controlling.load(Ordering::SeqCst) {
|
||||||
|
ControllingSelector::handle_success_response(self, m, local, remote, remote_addr).await;
|
||||||
|
} else {
|
||||||
|
ControlledSelector::handle_success_response(self, m, local, remote, remote_addr).await;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) async fn handle_binding_request(
|
||||||
|
&self,
|
||||||
|
m: &Message,
|
||||||
|
local: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
) {
|
||||||
|
if self.is_controlling.load(Ordering::SeqCst) {
|
||||||
|
ControllingSelector::handle_binding_request(self, m, local, remote).await;
|
||||||
|
} else {
|
||||||
|
ControlledSelector::handle_binding_request(self, m, local, remote).await;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[async_trait]
|
||||||
|
impl ControllingSelector for AgentInternal {
|
||||||
|
async fn start(&self) {
|
||||||
|
{
|
||||||
|
let mut nominated_pair = self.nominated_pair.lock().await;
|
||||||
|
*nominated_pair = None;
|
||||||
|
}
|
||||||
|
*self.start_time.lock() = Instant::now();
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn contact_candidates(&self) {
|
||||||
|
// A lite selector should not contact candidates
|
||||||
|
if self.lite.load(Ordering::SeqCst) {
|
||||||
|
// This only happens if both peers are lite. See RFC 8445 S6.1.1 and S6.2
|
||||||
|
log::trace!("now falling back to full agent");
|
||||||
|
}
|
||||||
|
|
||||||
|
let nominated_pair_is_some = {
|
||||||
|
let nominated_pair = self.nominated_pair.lock().await;
|
||||||
|
nominated_pair.is_some()
|
||||||
|
};
|
||||||
|
|
||||||
|
if self.agent_conn.get_selected_pair().is_some() {
|
||||||
|
if self.validate_selected_pair().await {
|
||||||
|
log::trace!("[{}]: checking keepalive", self.get_name());
|
||||||
|
self.check_keepalive().await;
|
||||||
|
}
|
||||||
|
} else if nominated_pair_is_some {
|
||||||
|
self.nominate_pair().await;
|
||||||
|
} else {
|
||||||
|
let has_nominated_pair =
|
||||||
|
if let Some(p) = self.agent_conn.get_best_valid_candidate_pair().await {
|
||||||
|
self.is_nominatable(&p.local) && self.is_nominatable(&p.remote)
|
||||||
|
} else {
|
||||||
|
false
|
||||||
|
};
|
||||||
|
|
||||||
|
if has_nominated_pair {
|
||||||
|
if let Some(p) = self.agent_conn.get_best_valid_candidate_pair().await {
|
||||||
|
log::trace!(
|
||||||
|
"Nominatable pair found, nominating ({}, {})",
|
||||||
|
p.local.to_string(),
|
||||||
|
p.remote.to_string()
|
||||||
|
);
|
||||||
|
p.nominated.store(true, Ordering::SeqCst);
|
||||||
|
{
|
||||||
|
let mut nominated_pair = self.nominated_pair.lock().await;
|
||||||
|
*nominated_pair = Some(p);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
self.nominate_pair().await;
|
||||||
|
} else {
|
||||||
|
self.ping_all_candidates().await;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn ping_candidate(
|
||||||
|
&self,
|
||||||
|
local: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
) {
|
||||||
|
let (msg, result) = {
|
||||||
|
let ufrag_pwd = self.ufrag_pwd.lock().await;
|
||||||
|
let username = ufrag_pwd.remote_ufrag.clone() + ":" + ufrag_pwd.local_ufrag.as_str();
|
||||||
|
let mut msg = Message::new();
|
||||||
|
let result = msg.build(&[
|
||||||
|
Box::new(BINDING_REQUEST),
|
||||||
|
Box::new(TransactionId::new()),
|
||||||
|
Box::new(Username::new(ATTR_USERNAME, username)),
|
||||||
|
Box::new(AttrControlling(self.tie_breaker.load(Ordering::SeqCst))),
|
||||||
|
Box::new(PriorityAttr(local.priority())),
|
||||||
|
Box::new(MessageIntegrity::new_short_term_integrity(
|
||||||
|
ufrag_pwd.remote_pwd.clone(),
|
||||||
|
)),
|
||||||
|
Box::new(FINGERPRINT),
|
||||||
|
]);
|
||||||
|
(msg, result)
|
||||||
|
};
|
||||||
|
|
||||||
|
if let Err(err) = result {
|
||||||
|
log::error!("{}", err);
|
||||||
|
} else {
|
||||||
|
self.send_binding_request(&msg, local, remote).await;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn handle_success_response(
|
||||||
|
&self,
|
||||||
|
m: &Message,
|
||||||
|
local: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote_addr: SocketAddr,
|
||||||
|
) {
|
||||||
|
if let Some(pending_request) = self.handle_inbound_binding_success(m.transaction_id).await {
|
||||||
|
let transaction_addr = pending_request.destination;
|
||||||
|
|
||||||
|
// Assert that NAT is not symmetric
|
||||||
|
// https://tools.ietf.org/html/rfc8445#section-7.2.5.2.1
|
||||||
|
if transaction_addr != remote_addr {
|
||||||
|
log::debug!("discard message: transaction source and destination does not match expected({}), actual({})", transaction_addr, remote);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
log::trace!(
|
||||||
|
"inbound STUN (SuccessResponse) from {} to {}",
|
||||||
|
remote,
|
||||||
|
local
|
||||||
|
);
|
||||||
|
let selected_pair_is_none = self.agent_conn.get_selected_pair().is_none();
|
||||||
|
|
||||||
|
if let Some(p) = self.find_pair(local, remote).await {
|
||||||
|
p.state
|
||||||
|
.store(CandidatePairState::Succeeded as u8, Ordering::SeqCst);
|
||||||
|
log::trace!(
|
||||||
|
"Found valid candidate pair: {}, p.state: {}, isUseCandidate: {}, {}",
|
||||||
|
p,
|
||||||
|
p.state.load(Ordering::SeqCst),
|
||||||
|
pending_request.is_use_candidate,
|
||||||
|
selected_pair_is_none
|
||||||
|
);
|
||||||
|
if pending_request.is_use_candidate && selected_pair_is_none {
|
||||||
|
self.set_selected_pair(Some(Arc::clone(&p))).await;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// This shouldn't happen
|
||||||
|
log::error!("Success response from invalid candidate pair");
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
log::warn!(
|
||||||
|
"discard message from ({}), unknown TransactionID 0x{:?}",
|
||||||
|
remote,
|
||||||
|
m.transaction_id
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn handle_binding_request(
|
||||||
|
&self,
|
||||||
|
m: &Message,
|
||||||
|
local: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
) {
|
||||||
|
self.send_binding_success(m, local, remote).await;
|
||||||
|
log::trace!("controllingSelector: sendBindingSuccess");
|
||||||
|
|
||||||
|
if let Some(p) = self.find_pair(local, remote).await {
|
||||||
|
let nominated_pair_is_none = {
|
||||||
|
let nominated_pair = self.nominated_pair.lock().await;
|
||||||
|
nominated_pair.is_none()
|
||||||
|
};
|
||||||
|
|
||||||
|
log::trace!(
|
||||||
|
"controllingSelector: after findPair {}, p.state: {}, {}",
|
||||||
|
p,
|
||||||
|
p.state.load(Ordering::SeqCst),
|
||||||
|
nominated_pair_is_none,
|
||||||
|
//self.agent_conn.get_selected_pair().await.is_none() //, {}
|
||||||
|
);
|
||||||
|
if p.state.load(Ordering::SeqCst) == CandidatePairState::Succeeded as u8
|
||||||
|
&& nominated_pair_is_none
|
||||||
|
&& self.agent_conn.get_selected_pair().is_none()
|
||||||
|
{
|
||||||
|
if let Some(best_pair) = self.agent_conn.get_best_available_candidate_pair().await {
|
||||||
|
log::trace!(
|
||||||
|
"controllingSelector: getBestAvailableCandidatePair {}",
|
||||||
|
best_pair
|
||||||
|
);
|
||||||
|
if best_pair == p
|
||||||
|
&& self.is_nominatable(&p.local)
|
||||||
|
&& self.is_nominatable(&p.remote)
|
||||||
|
{
|
||||||
|
log::trace!("The candidate ({}, {}) is the best candidate available, marking it as nominated",
|
||||||
|
p.local, p.remote);
|
||||||
|
{
|
||||||
|
let mut nominated_pair = self.nominated_pair.lock().await;
|
||||||
|
*nominated_pair = Some(p);
|
||||||
|
}
|
||||||
|
self.nominate_pair().await;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
log::trace!("No best pair available");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
log::trace!("controllingSelector: addPair");
|
||||||
|
self.add_pair(local.clone(), remote.clone()).await;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[async_trait]
|
||||||
|
impl ControlledSelector for AgentInternal {
|
||||||
|
async fn start(&self) {}
|
||||||
|
|
||||||
|
async fn contact_candidates(&self) {
|
||||||
|
// A lite selector should not contact candidates
|
||||||
|
if self.lite.load(Ordering::SeqCst) {
|
||||||
|
self.validate_selected_pair().await;
|
||||||
|
} else if self.agent_conn.get_selected_pair().is_some() {
|
||||||
|
if self.validate_selected_pair().await {
|
||||||
|
log::trace!("[{}]: checking keepalive", self.get_name());
|
||||||
|
self.check_keepalive().await;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
self.ping_all_candidates().await;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn ping_candidate(
|
||||||
|
&self,
|
||||||
|
local: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
) {
|
||||||
|
let (msg, result) = {
|
||||||
|
let ufrag_pwd = self.ufrag_pwd.lock().await;
|
||||||
|
let username = ufrag_pwd.remote_ufrag.clone() + ":" + ufrag_pwd.local_ufrag.as_str();
|
||||||
|
let mut msg = Message::new();
|
||||||
|
let result = msg.build(&[
|
||||||
|
Box::new(BINDING_REQUEST),
|
||||||
|
Box::new(TransactionId::new()),
|
||||||
|
Box::new(Username::new(ATTR_USERNAME, username)),
|
||||||
|
Box::new(AttrControlled(self.tie_breaker.load(Ordering::SeqCst))),
|
||||||
|
Box::new(PriorityAttr(local.priority())),
|
||||||
|
Box::new(MessageIntegrity::new_short_term_integrity(
|
||||||
|
ufrag_pwd.remote_pwd.clone(),
|
||||||
|
)),
|
||||||
|
Box::new(FINGERPRINT),
|
||||||
|
]);
|
||||||
|
(msg, result)
|
||||||
|
};
|
||||||
|
|
||||||
|
if let Err(err) = result {
|
||||||
|
log::error!("{}", err);
|
||||||
|
} else {
|
||||||
|
self.send_binding_request(&msg, local, remote).await;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn handle_success_response(
|
||||||
|
&self,
|
||||||
|
m: &Message,
|
||||||
|
local: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote_addr: SocketAddr,
|
||||||
|
) {
|
||||||
|
// https://tools.ietf.org/html/rfc8445#section-7.3.1.5
|
||||||
|
// If the controlled agent does not accept the request from the
|
||||||
|
// controlling agent, the controlled agent MUST reject the nomination
|
||||||
|
// request with an appropriate error code response (e.g., 400)
|
||||||
|
// [RFC5389].
|
||||||
|
|
||||||
|
if let Some(pending_request) = self.handle_inbound_binding_success(m.transaction_id).await {
|
||||||
|
let transaction_addr = pending_request.destination;
|
||||||
|
|
||||||
|
// Assert that NAT is not symmetric
|
||||||
|
// https://tools.ietf.org/html/rfc8445#section-7.2.5.2.1
|
||||||
|
if transaction_addr != remote_addr {
|
||||||
|
log::debug!("discard message: transaction source and destination does not match expected({}), actual({})", transaction_addr, remote);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
log::trace!(
|
||||||
|
"inbound STUN (SuccessResponse) from {} to {}",
|
||||||
|
remote,
|
||||||
|
local
|
||||||
|
);
|
||||||
|
|
||||||
|
if let Some(p) = self.find_pair(local, remote).await {
|
||||||
|
p.state
|
||||||
|
.store(CandidatePairState::Succeeded as u8, Ordering::SeqCst);
|
||||||
|
log::trace!("Found valid candidate pair: {}", p);
|
||||||
|
} else {
|
||||||
|
// This shouldn't happen
|
||||||
|
log::error!("Success response from invalid candidate pair");
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
log::warn!(
|
||||||
|
"discard message from ({}), unknown TransactionID 0x{:?}",
|
||||||
|
remote,
|
||||||
|
m.transaction_id
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn handle_binding_request(
|
||||||
|
&self,
|
||||||
|
m: &Message,
|
||||||
|
local: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote: &Arc<dyn Candidate + Send + Sync>,
|
||||||
|
) {
|
||||||
|
if self.find_pair(local, remote).await.is_none() {
|
||||||
|
self.add_pair(local.clone(), remote.clone()).await;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(p) = self.find_pair(local, remote).await {
|
||||||
|
let use_candidate = m.contains(ATTR_USE_CANDIDATE);
|
||||||
|
if use_candidate {
|
||||||
|
// https://tools.ietf.org/html/rfc8445#section-7.3.1.5
|
||||||
|
|
||||||
|
if p.state.load(Ordering::SeqCst) == CandidatePairState::Succeeded as u8 {
|
||||||
|
// If the state of this pair is Succeeded, it means that the check
|
||||||
|
// previously sent by this pair produced a successful response and
|
||||||
|
// generated a valid pair (Section 7.2.5.3.2). The agent sets the
|
||||||
|
// nominated flag value of the valid pair to true.
|
||||||
|
if self.agent_conn.get_selected_pair().is_none() {
|
||||||
|
self.set_selected_pair(Some(Arc::clone(&p))).await;
|
||||||
|
}
|
||||||
|
self.send_binding_success(m, local, remote).await;
|
||||||
|
} else {
|
||||||
|
// If the received Binding request triggered a new check to be
|
||||||
|
// enqueued in the triggered-check queue (Section 7.3.1.4), once the
|
||||||
|
// check is sent and if it generates a successful response, and
|
||||||
|
// generates a valid pair, the agent sets the nominated flag of the
|
||||||
|
// pair to true. If the request fails (Section 7.2.5.2), the agent
|
||||||
|
// MUST remove the candidate pair from the valid list, set the
|
||||||
|
// candidate pair state to Failed, and set the checklist state to
|
||||||
|
// Failed.
|
||||||
|
self.ping_candidate(local, remote).await;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
self.send_binding_success(m, local, remote).await;
|
||||||
|
self.ping_candidate(local, remote).await;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
+283
@@ -0,0 +1,283 @@
|
|||||||
|
use std::sync::atomic::Ordering;
|
||||||
|
|
||||||
|
use tokio::time::Instant;
|
||||||
|
|
||||||
|
use crate::agent::agent_internal::AgentInternal;
|
||||||
|
use crate::candidate::{CandidatePairState, CandidateType};
|
||||||
|
use crate::network_type::NetworkType;
|
||||||
|
|
||||||
|
/// Contains ICE candidate pair statistics.
|
||||||
|
pub struct CandidatePairStats {
|
||||||
|
/// The timestamp associated with this struct.
|
||||||
|
pub timestamp: Instant,
|
||||||
|
|
||||||
|
/// The id of the local candidate.
|
||||||
|
pub local_candidate_id: String,
|
||||||
|
|
||||||
|
/// The id of the remote candidate.
|
||||||
|
pub remote_candidate_id: String,
|
||||||
|
|
||||||
|
/// The state of the checklist for the local and remote candidates in a pair.
|
||||||
|
pub state: CandidatePairState,
|
||||||
|
|
||||||
|
/// It is true when this valid pair that should be used for media,
|
||||||
|
/// if it is the highest-priority one amongst those whose nominated flag is set.
|
||||||
|
pub nominated: bool,
|
||||||
|
|
||||||
|
/// The total number of packets sent on this candidate pair.
|
||||||
|
pub packets_sent: u32,
|
||||||
|
|
||||||
|
/// The total number of packets received on this candidate pair.
|
||||||
|
pub packets_received: u32,
|
||||||
|
|
||||||
|
/// The total number of payload bytes sent on this candidate pair not including headers or
|
||||||
|
/// padding.
|
||||||
|
pub bytes_sent: u64,
|
||||||
|
|
||||||
|
/// The total number of payload bytes received on this candidate pair not including headers or
|
||||||
|
/// padding.
|
||||||
|
pub bytes_received: u64,
|
||||||
|
|
||||||
|
/// The timestamp at which the last packet was sent on this particular candidate pair, excluding
|
||||||
|
/// STUN packets.
|
||||||
|
pub last_packet_sent_timestamp: Instant,
|
||||||
|
|
||||||
|
/// The timestamp at which the last packet was received on this particular candidate pair,
|
||||||
|
/// excluding STUN packets.
|
||||||
|
pub last_packet_received_timestamp: Instant,
|
||||||
|
|
||||||
|
/// The timestamp at which the first STUN request was sent on this particular candidate pair.
|
||||||
|
pub first_request_timestamp: Instant,
|
||||||
|
|
||||||
|
/// The timestamp at which the last STUN request was sent on this particular candidate pair.
|
||||||
|
/// The average interval between two consecutive connectivity checks sent can be calculated with
|
||||||
|
/// (last_request_timestamp - first_request_timestamp) / requests_sent.
|
||||||
|
pub last_request_timestamp: Instant,
|
||||||
|
|
||||||
|
/// Timestamp at which the last STUN response was received on this particular candidate pair.
|
||||||
|
pub last_response_timestamp: Instant,
|
||||||
|
|
||||||
|
/// The sum of all round trip time measurements in seconds since the beginning of the session,
|
||||||
|
/// based on STUN connectivity check responses (responses_received), including those that reply
|
||||||
|
/// to requests that are sent in order to verify consent. The average round trip time can be
|
||||||
|
/// computed from total_round_trip_time by dividing it by responses_received.
|
||||||
|
pub total_round_trip_time: f64,
|
||||||
|
|
||||||
|
/// The latest round trip time measured in seconds, computed from both STUN connectivity checks,
|
||||||
|
/// including those that are sent for consent verification.
|
||||||
|
pub current_round_trip_time: f64,
|
||||||
|
|
||||||
|
/// It is calculated by the underlying congestion control by combining the available bitrate for
|
||||||
|
/// all the outgoing RTP streams using this candidate pair. The bitrate measurement does not
|
||||||
|
/// count the size of the IP or other transport layers like TCP or UDP. It is similar to the
|
||||||
|
/// TIAS defined in RFC 3890, i.e., it is measured in bits per second and the bitrate is
|
||||||
|
/// calculated over a 1 second window.
|
||||||
|
pub available_outgoing_bitrate: f64,
|
||||||
|
|
||||||
|
/// It is calculated by the underlying congestion control by combining the available bitrate for
|
||||||
|
/// all the incoming RTP streams using this candidate pair. The bitrate measurement does not
|
||||||
|
/// count the size of the IP or other transport layers like TCP or UDP. It is similar to the
|
||||||
|
/// TIAS defined in RFC 3890, i.e., it is measured in bits per second and the bitrate is
|
||||||
|
/// calculated over a 1 second window.
|
||||||
|
pub available_incoming_bitrate: f64,
|
||||||
|
|
||||||
|
/// The number of times the circuit breaker is triggered for this particular 5-tuple,
|
||||||
|
/// ceasing transmission.
|
||||||
|
pub circuit_breaker_trigger_count: u32,
|
||||||
|
|
||||||
|
/// The total number of connectivity check requests received (including retransmissions).
|
||||||
|
/// It is impossible for the receiver to tell whether the request was sent in order to check
|
||||||
|
/// connectivity or check consent, so all connectivity checks requests are counted here.
|
||||||
|
pub requests_received: u64,
|
||||||
|
|
||||||
|
/// The total number of connectivity check requests sent (not including retransmissions).
|
||||||
|
pub requests_sent: u64,
|
||||||
|
|
||||||
|
/// The total number of connectivity check responses received.
|
||||||
|
pub responses_received: u64,
|
||||||
|
|
||||||
|
/// The total number of connectivity check responses sent. Since we cannot distinguish
|
||||||
|
/// connectivity check requests and consent requests, all responses are counted.
|
||||||
|
pub responses_sent: u64,
|
||||||
|
|
||||||
|
/// The total number of connectivity check request retransmissions received.
|
||||||
|
pub retransmissions_received: u64,
|
||||||
|
|
||||||
|
/// The total number of connectivity check request retransmissions sent.
|
||||||
|
pub retransmissions_sent: u64,
|
||||||
|
|
||||||
|
/// The total number of consent requests sent.
|
||||||
|
pub consent_requests_sent: u64,
|
||||||
|
|
||||||
|
/// The timestamp at which the latest valid STUN binding response expired.
|
||||||
|
pub consent_expired_timestamp: Instant,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for CandidatePairStats {
|
||||||
|
fn default() -> Self {
|
||||||
|
Self {
|
||||||
|
timestamp: Instant::now(),
|
||||||
|
local_candidate_id: String::new(),
|
||||||
|
remote_candidate_id: String::new(),
|
||||||
|
state: CandidatePairState::default(),
|
||||||
|
nominated: false,
|
||||||
|
packets_sent: 0,
|
||||||
|
packets_received: 0,
|
||||||
|
bytes_sent: 0,
|
||||||
|
bytes_received: 0,
|
||||||
|
last_packet_sent_timestamp: Instant::now(),
|
||||||
|
last_packet_received_timestamp: Instant::now(),
|
||||||
|
first_request_timestamp: Instant::now(),
|
||||||
|
last_request_timestamp: Instant::now(),
|
||||||
|
last_response_timestamp: Instant::now(),
|
||||||
|
total_round_trip_time: 0.0,
|
||||||
|
current_round_trip_time: 0.0,
|
||||||
|
available_outgoing_bitrate: 0.0,
|
||||||
|
available_incoming_bitrate: 0.0,
|
||||||
|
circuit_breaker_trigger_count: 0,
|
||||||
|
requests_received: 0,
|
||||||
|
requests_sent: 0,
|
||||||
|
responses_received: 0,
|
||||||
|
responses_sent: 0,
|
||||||
|
retransmissions_received: 0,
|
||||||
|
retransmissions_sent: 0,
|
||||||
|
consent_requests_sent: 0,
|
||||||
|
consent_expired_timestamp: Instant::now(),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Contains ICE candidate statistics related to the `ICETransport` objects.
|
||||||
|
#[derive(Debug, Clone)]
|
||||||
|
pub struct CandidateStats {
|
||||||
|
// The timestamp associated with this struct.
|
||||||
|
pub timestamp: Instant,
|
||||||
|
|
||||||
|
/// The candidate id.
|
||||||
|
pub id: String,
|
||||||
|
|
||||||
|
/// The type of network interface used by the base of a local candidate (the address the ICE
|
||||||
|
/// agent sends from). Only present for local candidates; it's not possible to know what type of
|
||||||
|
/// network interface a remote candidate is using.
|
||||||
|
///
|
||||||
|
/// Note: This stat only tells you about the network interface used by the first "hop"; it's
|
||||||
|
/// possible that a connection will be bottlenecked by another type of network. For example,
|
||||||
|
/// when using Wi-Fi tethering, the networkType of the relevant candidate would be "wifi", even
|
||||||
|
/// when the next hop is over a cellular connection.
|
||||||
|
pub network_type: NetworkType,
|
||||||
|
|
||||||
|
/// The IP address of the candidate, allowing for IPv4 addresses and IPv6 addresses, but fully
|
||||||
|
/// qualified domain names (FQDNs) are not allowed.
|
||||||
|
pub ip: String,
|
||||||
|
|
||||||
|
/// The port number of the candidate.
|
||||||
|
pub port: u16,
|
||||||
|
|
||||||
|
/// The `Type` field of the ICECandidate.
|
||||||
|
pub candidate_type: CandidateType,
|
||||||
|
|
||||||
|
/// The `priority` field of the ICECandidate.
|
||||||
|
pub priority: u32,
|
||||||
|
|
||||||
|
/// The url of the TURN or STUN server indicated in the that translated this IP address.
|
||||||
|
/// It is the url address surfaced in an PeerConnectionICEEvent.
|
||||||
|
pub url: String,
|
||||||
|
|
||||||
|
/// The protocol used by the endpoint to communicate with the TURN server. This is only present
|
||||||
|
/// for local candidates. Valid values for the TURN url protocol is one of udp, tcp, or tls.
|
||||||
|
pub relay_protocol: String,
|
||||||
|
|
||||||
|
/// It is true if the candidate has been deleted/freed. For host candidates, this means that any
|
||||||
|
/// network resources (typically a socket) associated with the candidate have been released. For
|
||||||
|
/// TURN candidates, this means the TURN allocation is no longer active.
|
||||||
|
///
|
||||||
|
/// Only defined for local candidates. For remote candidates, this property is not applicable.
|
||||||
|
pub deleted: bool,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for CandidateStats {
|
||||||
|
fn default() -> Self {
|
||||||
|
Self {
|
||||||
|
timestamp: Instant::now(),
|
||||||
|
id: String::new(),
|
||||||
|
network_type: NetworkType::default(),
|
||||||
|
ip: String::new(),
|
||||||
|
port: 0,
|
||||||
|
candidate_type: CandidateType::default(),
|
||||||
|
priority: 0,
|
||||||
|
url: String::new(),
|
||||||
|
relay_protocol: String::new(),
|
||||||
|
deleted: false,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl AgentInternal {
|
||||||
|
/// Returns a list of candidate pair stats.
|
||||||
|
pub(crate) async fn get_candidate_pairs_stats(&self) -> Vec<CandidatePairStats> {
|
||||||
|
let checklist = self.agent_conn.checklist.lock().await;
|
||||||
|
let mut res = Vec::with_capacity(checklist.len());
|
||||||
|
for cp in &*checklist {
|
||||||
|
let stat = CandidatePairStats {
|
||||||
|
timestamp: Instant::now(),
|
||||||
|
local_candidate_id: cp.local.id(),
|
||||||
|
remote_candidate_id: cp.remote.id(),
|
||||||
|
state: cp.state.load(Ordering::SeqCst).into(),
|
||||||
|
nominated: cp.nominated.load(Ordering::SeqCst),
|
||||||
|
..CandidatePairStats::default()
|
||||||
|
};
|
||||||
|
res.push(stat);
|
||||||
|
}
|
||||||
|
res
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a list of local candidates stats.
|
||||||
|
pub(crate) async fn get_local_candidates_stats(&self) -> Vec<CandidateStats> {
|
||||||
|
let local_candidates = self.local_candidates.lock().await;
|
||||||
|
let mut res = Vec::with_capacity(local_candidates.len());
|
||||||
|
for (network_type, local_candidates) in &*local_candidates {
|
||||||
|
for c in local_candidates {
|
||||||
|
let stat = CandidateStats {
|
||||||
|
timestamp: Instant::now(),
|
||||||
|
id: c.id(),
|
||||||
|
network_type: *network_type,
|
||||||
|
ip: c.address(),
|
||||||
|
port: c.port(),
|
||||||
|
candidate_type: c.candidate_type(),
|
||||||
|
priority: c.priority(),
|
||||||
|
// URL string
|
||||||
|
relay_protocol: "udp".to_owned(),
|
||||||
|
// Deleted bool
|
||||||
|
..CandidateStats::default()
|
||||||
|
};
|
||||||
|
res.push(stat);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
res
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a list of remote candidates stats.
|
||||||
|
pub(crate) async fn get_remote_candidates_stats(&self) -> Vec<CandidateStats> {
|
||||||
|
let remote_candidates = self.remote_candidates.lock().await;
|
||||||
|
let mut res = Vec::with_capacity(remote_candidates.len());
|
||||||
|
for (network_type, remote_candidates) in &*remote_candidates {
|
||||||
|
for c in remote_candidates {
|
||||||
|
let stat = CandidateStats {
|
||||||
|
timestamp: Instant::now(),
|
||||||
|
id: c.id(),
|
||||||
|
network_type: *network_type,
|
||||||
|
ip: c.address(),
|
||||||
|
port: c.port(),
|
||||||
|
candidate_type: c.candidate_type(),
|
||||||
|
priority: c.priority(),
|
||||||
|
// URL string
|
||||||
|
relay_protocol: "udp".to_owned(),
|
||||||
|
// Deleted bool
|
||||||
|
..CandidateStats::default()
|
||||||
|
};
|
||||||
|
res.push(stat);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
res
|
||||||
|
}
|
||||||
|
}
|
||||||
+2199
File diff suppressed because it is too large.
Load diff
+246
@@ -0,0 +1,246 @@
|
|||||||
|
use std::io;
|
||||||
|
use std::sync::atomic::{AtomicBool, Ordering};
|
||||||
|
|
||||||
|
use arc_swap::ArcSwapOption;
|
||||||
|
use async_trait::async_trait;
|
||||||
|
use util::Conn;
|
||||||
|
|
||||||
|
use super::*;
|
||||||
|
use crate::error::*;
|
||||||
|
|
||||||
|
impl Agent {
|
||||||
|
/// Connects to the remote agent, acting as the controlling ice agent.
|
||||||
|
/// The method blocks until at least one ice candidate pair has successfully connected.
|
||||||
|
///
|
||||||
|
/// The operation will be cancelled if `cancel_rx` either receives a message or its channel
|
||||||
|
/// closes.
|
||||||
|
pub async fn dial(
|
||||||
|
&self,
|
||||||
|
mut cancel_rx: mpsc::Receiver<()>,
|
||||||
|
remote_ufrag: String,
|
||||||
|
remote_pwd: String,
|
||||||
|
) -> Result<Arc<impl Conn>> {
|
||||||
|
let (on_connected_rx, agent_conn) = {
|
||||||
|
self.internal
|
||||||
|
.start_connectivity_checks(true, remote_ufrag, remote_pwd)
|
||||||
|
.await?;
|
||||||
|
|
||||||
|
let mut on_connected_rx = self.internal.on_connected_rx.lock().await;
|
||||||
|
(
|
||||||
|
on_connected_rx.take(),
|
||||||
|
Arc::clone(&self.internal.agent_conn),
|
||||||
|
)
|
||||||
|
};
|
||||||
|
|
||||||
|
if let Some(mut on_connected_rx) = on_connected_rx {
|
||||||
|
// block until pair selected
|
||||||
|
tokio::select! {
|
||||||
|
_ = on_connected_rx.recv() => {},
|
||||||
|
_ = cancel_rx.recv() => {
|
||||||
|
return Err(Error::ErrCanceledByCaller);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Ok(agent_conn)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Connects to the remote agent, acting as the controlled ice agent.
|
||||||
|
/// The method blocks until at least one ice candidate pair has successfully connected.
|
||||||
|
///
|
||||||
|
/// The operation will be cancelled if `cancel_rx` either receives a message or its channel
|
||||||
|
/// closes.
|
||||||
|
pub async fn accept(
|
||||||
|
&self,
|
||||||
|
mut cancel_rx: mpsc::Receiver<()>,
|
||||||
|
remote_ufrag: String,
|
||||||
|
remote_pwd: String,
|
||||||
|
) -> Result<Arc<impl Conn>> {
|
||||||
|
let (on_connected_rx, agent_conn) = {
|
||||||
|
self.internal
|
||||||
|
.start_connectivity_checks(false, remote_ufrag, remote_pwd)
|
||||||
|
.await?;
|
||||||
|
|
||||||
|
let mut on_connected_rx = self.internal.on_connected_rx.lock().await;
|
||||||
|
(
|
||||||
|
on_connected_rx.take(),
|
||||||
|
Arc::clone(&self.internal.agent_conn),
|
||||||
|
)
|
||||||
|
};
|
||||||
|
|
||||||
|
if let Some(mut on_connected_rx) = on_connected_rx {
|
||||||
|
// block until pair selected
|
||||||
|
tokio::select! {
|
||||||
|
_ = on_connected_rx.recv() => {},
|
||||||
|
_ = cancel_rx.recv() => {
|
||||||
|
return Err(Error::ErrCanceledByCaller);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(agent_conn)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) struct AgentConn {
|
||||||
|
pub(crate) selected_pair: ArcSwapOption<CandidatePair>,
|
||||||
|
pub(crate) checklist: Mutex<Vec<Arc<CandidatePair>>>,
|
||||||
|
|
||||||
|
pub(crate) buffer: Buffer,
|
||||||
|
pub(crate) bytes_received: AtomicUsize,
|
||||||
|
pub(crate) bytes_sent: AtomicUsize,
|
||||||
|
pub(crate) done: AtomicBool,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl AgentConn {
|
||||||
|
pub(crate) fn new() -> Self {
|
||||||
|
Self {
|
||||||
|
selected_pair: ArcSwapOption::empty(),
|
||||||
|
checklist: Mutex::new(vec![]),
|
||||||
|
// Make sure the buffer doesn't grow indefinitely.
|
||||||
|
// NOTE: We actually won't get anywhere close to this limit.
|
||||||
|
// SRTP will constantly read from the endpoint and drop packets if it's full.
|
||||||
|
buffer: Buffer::new(0, MAX_BUFFER_SIZE),
|
||||||
|
bytes_received: AtomicUsize::new(0),
|
||||||
|
bytes_sent: AtomicUsize::new(0),
|
||||||
|
done: AtomicBool::new(false),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
pub(crate) fn get_selected_pair(&self) -> Option<Arc<CandidatePair>> {
|
||||||
|
self.selected_pair.load().clone()
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) async fn get_best_available_candidate_pair(&self) -> Option<Arc<CandidatePair>> {
|
||||||
|
let mut best: Option<&Arc<CandidatePair>> = None;
|
||||||
|
|
||||||
|
let checklist = self.checklist.lock().await;
|
||||||
|
for p in &*checklist {
|
||||||
|
if p.state.load(Ordering::SeqCst) == CandidatePairState::Failed as u8 {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(b) = &mut best {
|
||||||
|
if b.priority() < p.priority() {
|
||||||
|
*b = p;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
best = Some(p);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
best.cloned()
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) async fn get_best_valid_candidate_pair(&self) -> Option<Arc<CandidatePair>> {
|
||||||
|
let mut best: Option<&Arc<CandidatePair>> = None;
|
||||||
|
|
||||||
|
let checklist = self.checklist.lock().await;
|
||||||
|
for p in &*checklist {
|
||||||
|
if p.state.load(Ordering::SeqCst) != CandidatePairState::Succeeded as u8 {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(b) = &mut best {
|
||||||
|
if b.priority() < p.priority() {
|
||||||
|
*b = p;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
best = Some(p);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
best.cloned()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the number of bytes sent.
|
||||||
|
pub fn bytes_sent(&self) -> usize {
|
||||||
|
self.bytes_sent.load(Ordering::SeqCst)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the number of bytes received.
|
||||||
|
pub fn bytes_received(&self) -> usize {
|
||||||
|
self.bytes_received.load(Ordering::SeqCst)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[async_trait]
|
||||||
|
impl Conn for AgentConn {
|
||||||
|
async fn connect(&self, _addr: SocketAddr) -> std::result::Result<(), util::Error> {
|
||||||
|
Err(io::Error::new(io::ErrorKind::Other, "Not applicable").into())
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn recv(&self, buf: &mut [u8]) -> std::result::Result<usize, util::Error> {
|
||||||
|
if self.done.load(Ordering::SeqCst) {
|
||||||
|
return Err(io::Error::new(io::ErrorKind::Other, "Conn is closed").into());
|
||||||
|
}
|
||||||
|
|
||||||
|
let n = match self.buffer.read(buf, None).await {
|
||||||
|
Ok(n) => n,
|
||||||
|
Err(err) => return Err(io::Error::new(io::ErrorKind::Other, err.to_string()).into()),
|
||||||
|
};
|
||||||
|
self.bytes_received.fetch_add(n, Ordering::SeqCst);
|
||||||
|
|
||||||
|
Ok(n)
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn recv_from(
|
||||||
|
&self,
|
||||||
|
buf: &mut [u8],
|
||||||
|
) -> std::result::Result<(usize, SocketAddr), util::Error> {
|
||||||
|
if let Some(raddr) = self.remote_addr() {
|
||||||
|
let n = self.recv(buf).await?;
|
||||||
|
Ok((n, raddr))
|
||||||
|
} else {
|
||||||
|
Err(io::Error::new(io::ErrorKind::Other, "Not applicable").into())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn send(&self, buf: &[u8]) -> std::result::Result<usize, util::Error> {
|
||||||
|
if self.done.load(Ordering::SeqCst) {
|
||||||
|
return Err(io::Error::new(io::ErrorKind::Other, "Conn is closed").into());
|
||||||
|
}
|
||||||
|
|
||||||
|
if is_message(buf) {
|
||||||
|
return Err(util::Error::Other("ErrIceWriteStunMessage".into()));
|
||||||
|
}
|
||||||
|
|
||||||
|
let result = if let Some(pair) = self.get_selected_pair() {
|
||||||
|
pair.write(buf).await
|
||||||
|
} else if let Some(pair) = self.get_best_available_candidate_pair().await {
|
||||||
|
pair.write(buf).await
|
||||||
|
} else {
|
||||||
|
Ok(0)
|
||||||
|
};
|
||||||
|
|
||||||
|
match result {
|
||||||
|
Ok(n) => {
|
||||||
|
self.bytes_sent.fetch_add(buf.len(), Ordering::SeqCst);
|
||||||
|
Ok(n)
|
||||||
|
}
|
||||||
|
Err(err) => Err(io::Error::new(io::ErrorKind::Other, err.to_string()).into()),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn send_to(
|
||||||
|
&self,
|
||||||
|
_buf: &[u8],
|
||||||
|
_target: SocketAddr,
|
||||||
|
) -> std::result::Result<usize, util::Error> {
|
||||||
|
Err(io::Error::new(io::ErrorKind::Other, "Not applicable").into())
|
||||||
|
}
|
||||||
|
|
||||||
|
fn local_addr(&self) -> std::result::Result<SocketAddr, util::Error> {
|
||||||
|
if let Some(pair) = self.get_selected_pair() {
|
||||||
|
Ok(pair.local.addr())
|
||||||
|
} else {
|
||||||
|
Err(io::Error::new(io::ErrorKind::AddrNotAvailable, "Addr Not Available").into())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fn remote_addr(&self) -> Option<SocketAddr> {
|
||||||
|
self.get_selected_pair().map(|pair| pair.remote.addr())
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn close(&self) -> std::result::Result<(), util::Error> {
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
+133
@@ -0,0 +1,133 @@
|
|||||||
|
use util::vnet::*;
|
||||||
|
use util::Conn;
|
||||||
|
use waitgroup::WaitGroup;
|
||||||
|
|
||||||
|
use super::agent_vnet_test::*;
|
||||||
|
use super::*;
|
||||||
|
use crate::agent::agent_transport::AgentConn;
|
||||||
|
|
||||||
|
pub(crate) async fn pipe(
|
||||||
|
default_config0: Option<AgentConfig>,
|
||||||
|
default_config1: Option<AgentConfig>,
|
||||||
|
) -> Result<(Arc<impl Conn>, Arc<impl Conn>, Arc<Agent>, Arc<Agent>)> {
|
||||||
|
let (a_notifier, mut a_connected) = on_connected();
|
||||||
|
let (b_notifier, mut b_connected) = on_connected();
|
||||||
|
|
||||||
|
let mut cfg0 = if let Some(cfg) = default_config0 {
|
||||||
|
cfg
|
||||||
|
} else {
|
||||||
|
AgentConfig::default()
|
||||||
|
};
|
||||||
|
cfg0.urls = vec![];
|
||||||
|
cfg0.network_types = supported_network_types();
|
||||||
|
|
||||||
|
let a_agent = Arc::new(Agent::new(cfg0).await?);
|
||||||
|
a_agent.on_connection_state_change(a_notifier);
|
||||||
|
|
||||||
|
let mut cfg1 = if let Some(cfg) = default_config1 {
|
||||||
|
cfg
|
||||||
|
} else {
|
||||||
|
AgentConfig::default()
|
||||||
|
};
|
||||||
|
cfg1.urls = vec![];
|
||||||
|
cfg1.network_types = supported_network_types();
|
||||||
|
|
||||||
|
let b_agent = Arc::new(Agent::new(cfg1).await?);
|
||||||
|
b_agent.on_connection_state_change(b_notifier);
|
||||||
|
|
||||||
|
let (a_conn, b_conn) = connect_with_vnet(&a_agent, &b_agent).await?;
|
||||||
|
|
||||||
|
// Ensure pair selected
|
||||||
|
// Note: this assumes ConnectionStateConnected is thrown after selecting the final pair
|
||||||
|
let _ = a_connected.recv().await;
|
||||||
|
let _ = b_connected.recv().await;
|
||||||
|
|
||||||
|
Ok((a_conn, b_conn, a_agent, b_agent))
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn test_remote_local_addr() -> Result<()> {
|
||||||
|
// Agent0 is behind 1:1 NAT
|
||||||
|
let nat_type0 = nat::NatType {
|
||||||
|
mode: nat::NatMode::Nat1To1,
|
||||||
|
..Default::default()
|
||||||
|
};
|
||||||
|
// Agent1 is behind 1:1 NAT
|
||||||
|
let nat_type1 = nat::NatType {
|
||||||
|
mode: nat::NatMode::Nat1To1,
|
||||||
|
..Default::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
let v = build_vnet(nat_type0, nat_type1).await?;
|
||||||
|
|
||||||
|
let stun_server_url = Url {
|
||||||
|
scheme: SchemeType::Stun,
|
||||||
|
host: VNET_STUN_SERVER_IP.to_owned(),
|
||||||
|
port: VNET_STUN_SERVER_PORT,
|
||||||
|
proto: ProtoType::Udp,
|
||||||
|
..Default::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
//"Disconnected Returns nil"
|
||||||
|
{
|
||||||
|
let disconnected_conn = AgentConn::new();
|
||||||
|
let result = disconnected_conn.local_addr();
|
||||||
|
assert!(result.is_err(), "Disconnected Returns nil");
|
||||||
|
}
|
||||||
|
|
||||||
|
//"Remote/Local Pair Match between Agents"
|
||||||
|
{
|
||||||
|
let (ca, cb) = pipe_with_vnet(
|
||||||
|
&v,
|
||||||
|
AgentTestConfig {
|
||||||
|
urls: vec![stun_server_url.clone()],
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
AgentTestConfig {
|
||||||
|
urls: vec![stun_server_url],
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
)
|
||||||
|
.await?;
|
||||||
|
|
||||||
|
let a_laddr = ca.local_addr()?;
|
||||||
|
let b_laddr = cb.local_addr()?;
|
||||||
|
|
||||||
|
// Assert addresses
|
||||||
|
assert_eq!(a_laddr.ip().to_string(), VNET_LOCAL_IPA.to_string());
|
||||||
|
assert_eq!(b_laddr.ip().to_string(), VNET_LOCAL_IPB.to_string());
|
||||||
|
|
||||||
|
// Close
|
||||||
|
//ca.close().await?;
|
||||||
|
//cb.close().await?;
|
||||||
|
}
|
||||||
|
|
||||||
|
v.close().await?;
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn test_conn_stats() -> Result<()> {
|
||||||
|
let (ca, cb, _, _) = pipe(None, None).await?;
|
||||||
|
let na = ca.send(&[0u8; 10]).await?;
|
||||||
|
|
||||||
|
let wg = WaitGroup::new();
|
||||||
|
|
||||||
|
let w = wg.worker();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let _d = w;
|
||||||
|
|
||||||
|
let mut buf = vec![0u8; 10];
|
||||||
|
let nb = cb.recv(&mut buf).await?;
|
||||||
|
assert_eq!(nb, 10, "bytes received don't match");
|
||||||
|
|
||||||
|
Result::<()>::Ok(())
|
||||||
|
});
|
||||||
|
|
||||||
|
wg.wait().await;
|
||||||
|
|
||||||
|
assert_eq!(na, 10, "bytes sent don't match");
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
+1016
File diff suppressed because it is too large.
Load diff
Vendored
+517
@@ -0,0 +1,517 @@
|
|||||||
|
#[cfg(test)]
|
||||||
|
mod agent_gather_test;
|
||||||
|
#[cfg(test)]
|
||||||
|
mod agent_test;
|
||||||
|
#[cfg(test)]
|
||||||
|
mod agent_transport_test;
|
||||||
|
#[cfg(test)]
|
||||||
|
pub(crate) mod agent_vnet_test;
|
||||||
|
|
||||||
|
pub mod agent_config;
|
||||||
|
pub mod agent_gather;
|
||||||
|
pub(crate) mod agent_internal;
|
||||||
|
pub mod agent_selector;
|
||||||
|
pub mod agent_stats;
|
||||||
|
pub mod agent_transport;
|
||||||
|
pub mod turn_tcp;
|
||||||
|
|
||||||
|
use std::collections::HashMap;
|
||||||
|
use std::future::Future;
|
||||||
|
use std::net::{Ipv4Addr, SocketAddr};
|
||||||
|
use std::pin::Pin;
|
||||||
|
use std::sync::atomic::{AtomicU8, AtomicUsize, Ordering};
|
||||||
|
use std::sync::Arc;
|
||||||
|
use std::time::SystemTime;
|
||||||
|
|
||||||
|
use agent_config::*;
|
||||||
|
use agent_internal::*;
|
||||||
|
use agent_stats::*;
|
||||||
|
use mdns::conn::*;
|
||||||
|
use stun::agent::*;
|
||||||
|
use stun::attributes::*;
|
||||||
|
use stun::fingerprint::*;
|
||||||
|
use stun::integrity::*;
|
||||||
|
use stun::message::*;
|
||||||
|
use stun::xoraddr::*;
|
||||||
|
use tokio::sync::{broadcast, mpsc, Mutex};
|
||||||
|
use tokio::time::{Duration, Instant};
|
||||||
|
use util::vnet::net::*;
|
||||||
|
use util::Buffer;
|
||||||
|
|
||||||
|
use crate::agent::agent_gather::GatherCandidatesInternalParams;
|
||||||
|
use crate::candidate::*;
|
||||||
|
use crate::error::*;
|
||||||
|
use crate::external_ip_mapper::*;
|
||||||
|
use crate::mdns::*;
|
||||||
|
use crate::network_type::*;
|
||||||
|
use crate::rand::*;
|
||||||
|
use crate::state::*;
|
||||||
|
use crate::tcp_type::TcpType;
|
||||||
|
use crate::udp_mux::UDPMux;
|
||||||
|
use crate::udp_network::UDPNetwork;
|
||||||
|
use crate::url::*;
|
||||||
|
|
||||||
|
#[derive(Debug, Clone)]
|
||||||
|
pub(crate) struct BindingRequest {
|
||||||
|
pub(crate) timestamp: Instant,
|
||||||
|
pub(crate) transaction_id: TransactionId,
|
||||||
|
pub(crate) destination: SocketAddr,
|
||||||
|
pub(crate) is_use_candidate: bool,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for BindingRequest {
|
||||||
|
fn default() -> Self {
|
||||||
|
Self {
|
||||||
|
timestamp: Instant::now(),
|
||||||
|
transaction_id: TransactionId::default(),
|
||||||
|
destination: SocketAddr::new(Ipv4Addr::new(0, 0, 0, 0).into(), 0),
|
||||||
|
is_use_candidate: false,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
pub type OnConnectionStateChangeHdlrFn = Box<
|
||||||
|
dyn (FnMut(ConnectionState) -> Pin<Box<dyn Future<Output = ()> + Send + 'static>>)
|
||||||
|
+ Send
|
||||||
|
+ Sync,
|
||||||
|
>;
|
||||||
|
pub type OnSelectedCandidatePairChangeHdlrFn = Box<
|
||||||
|
dyn (FnMut(
|
||||||
|
&Arc<dyn Candidate + Send + Sync>,
|
||||||
|
&Arc<dyn Candidate + Send + Sync>,
|
||||||
|
) -> Pin<Box<dyn Future<Output = ()> + Send + 'static>>)
|
||||||
|
+ Send
|
||||||
|
+ Sync,
|
||||||
|
>;
|
||||||
|
pub type OnCandidateHdlrFn = Box<
|
||||||
|
dyn (FnMut(
|
||||||
|
Option<Arc<dyn Candidate + Send + Sync>>,
|
||||||
|
) -> Pin<Box<dyn Future<Output = ()> + Send + 'static>>)
|
||||||
|
+ Send
|
||||||
|
+ Sync,
|
||||||
|
>;
|
||||||
|
pub type GatherCandidateCancelFn = Box<dyn Fn() + Send + Sync>;
|
||||||
|
|
||||||
|
struct ChanReceivers {
|
||||||
|
chan_state_rx: mpsc::Receiver<ConnectionState>,
|
||||||
|
chan_candidate_rx: mpsc::Receiver<Option<Arc<dyn Candidate + Send + Sync>>>,
|
||||||
|
chan_candidate_pair_rx: mpsc::Receiver<()>,
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Represents the ICE agent.
|
||||||
|
pub struct Agent {
|
||||||
|
pub(crate) internal: Arc<AgentInternal>,
|
||||||
|
|
||||||
|
pub(crate) udp_network: UDPNetwork,
|
||||||
|
pub(crate) interface_filter: Arc<Option<InterfaceFilterFn>>,
|
||||||
|
pub(crate) ip_filter: Arc<Option<IpFilterFn>>,
|
||||||
|
pub(crate) mdns_mode: MulticastDnsMode,
|
||||||
|
pub(crate) mdns_name: String,
|
||||||
|
pub(crate) mdns_conn: Option<Arc<DnsConn>>,
|
||||||
|
pub(crate) net: Arc<Net>,
|
||||||
|
|
||||||
|
// 1:1 D-NAT IP address mapping
|
||||||
|
pub(crate) ext_ip_mapper: Arc<Option<ExternalIpMapper>>,
|
||||||
|
pub(crate) gathering_state: Arc<AtomicU8>, //GatheringState,
|
||||||
|
pub(crate) candidate_types: Vec<CandidateType>,
|
||||||
|
pub(crate) urls: Vec<Url>,
|
||||||
|
pub(crate) network_types: Vec<NetworkType>,
|
||||||
|
|
||||||
|
pub(crate) gather_candidate_cancel: Option<GatherCandidateCancelFn>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Agent {
|
||||||
|
/// Creates a new Agent.
|
||||||
|
pub async fn new(config: AgentConfig) -> Result<Self> {
|
||||||
|
let mut mdns_name = config.multicast_dns_host_name.clone();
|
||||||
|
if mdns_name.is_empty() {
|
||||||
|
mdns_name = generate_multicast_dns_name();
|
||||||
|
}
|
||||||
|
|
||||||
|
if !mdns_name.ends_with(".local") || mdns_name.split('.').count() != 2 {
|
||||||
|
return Err(Error::ErrInvalidMulticastDnshostName);
|
||||||
|
}
|
||||||
|
|
||||||
|
let mdns_mode = config.multicast_dns_mode;
|
||||||
|
|
||||||
|
let mdns_conn =
|
||||||
|
match create_multicast_dns(mdns_mode, &mdns_name, &config.multicast_dns_dest_addr) {
|
||||||
|
Ok(c) => c,
|
||||||
|
Err(err) => {
|
||||||
|
// Opportunistic mDNS: If we can't open the connection, that's ok: we
|
||||||
|
// can continue without it.
|
||||||
|
log::warn!("Failed to initialize mDNS {}: {}", mdns_name, err);
|
||||||
|
None
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
let (mut ai, chan_receivers) = AgentInternal::new(&config);
|
||||||
|
let (chan_state_rx, chan_candidate_rx, chan_candidate_pair_rx) = (
|
||||||
|
chan_receivers.chan_state_rx,
|
||||||
|
chan_receivers.chan_candidate_rx,
|
||||||
|
chan_receivers.chan_candidate_pair_rx,
|
||||||
|
);
|
||||||
|
|
||||||
|
config.init_with_defaults(&mut ai);
|
||||||
|
|
||||||
|
let candidate_types = if config.candidate_types.is_empty() {
|
||||||
|
default_candidate_types()
|
||||||
|
} else {
|
||||||
|
config.candidate_types.clone()
|
||||||
|
};
|
||||||
|
|
||||||
|
if ai.lite.load(Ordering::SeqCst)
|
||||||
|
&& (candidate_types.len() != 1 || candidate_types[0] != CandidateType::Host)
|
||||||
|
{
|
||||||
|
Self::close_multicast_conn(&mdns_conn).await;
|
||||||
|
return Err(Error::ErrLiteUsingNonHostCandidates);
|
||||||
|
}
|
||||||
|
|
||||||
|
if !config.urls.is_empty()
|
||||||
|
&& !contains_candidate_type(CandidateType::ServerReflexive, &candidate_types)
|
||||||
|
&& !contains_candidate_type(CandidateType::Relay, &candidate_types)
|
||||||
|
{
|
||||||
|
Self::close_multicast_conn(&mdns_conn).await;
|
||||||
|
return Err(Error::ErrUselessUrlsProvided);
|
||||||
|
}
|
||||||
|
|
||||||
|
let ext_ip_mapper = match config.init_ext_ip_mapping(mdns_mode, &candidate_types) {
|
||||||
|
Ok(ext_ip_mapper) => ext_ip_mapper,
|
||||||
|
Err(err) => {
|
||||||
|
Self::close_multicast_conn(&mdns_conn).await;
|
||||||
|
return Err(err);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
let net = if let Some(net) = config.net {
|
||||||
|
if net.is_virtual() {
|
||||||
|
log::warn!("vnet is enabled");
|
||||||
|
if mdns_mode != MulticastDnsMode::Disabled {
|
||||||
|
log::warn!("vnet does not support mDNS yet");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
net
|
||||||
|
} else {
|
||||||
|
Arc::new(Net::new(None))
|
||||||
|
};
|
||||||
|
|
||||||
|
let agent = Self {
|
||||||
|
udp_network: config.udp_network,
|
||||||
|
internal: Arc::new(ai),
|
||||||
|
interface_filter: Arc::clone(&config.interface_filter),
|
||||||
|
ip_filter: Arc::clone(&config.ip_filter),
|
||||||
|
mdns_mode,
|
||||||
|
mdns_name,
|
||||||
|
mdns_conn,
|
||||||
|
net,
|
||||||
|
ext_ip_mapper: Arc::new(ext_ip_mapper),
|
||||||
|
gathering_state: Arc::new(AtomicU8::new(0)), //GatheringState::New,
|
||||||
|
candidate_types,
|
||||||
|
urls: config.urls.clone(),
|
||||||
|
network_types: config.network_types.clone(),
|
||||||
|
|
||||||
|
gather_candidate_cancel: None, //TODO: add cancel
|
||||||
|
};
|
||||||
|
|
||||||
|
agent.internal.start_on_connection_state_change_routine(
|
||||||
|
chan_state_rx,
|
||||||
|
chan_candidate_rx,
|
||||||
|
chan_candidate_pair_rx,
|
||||||
|
);
|
||||||
|
|
||||||
|
// Restart is also used to initialize the agent for the first time
|
||||||
|
if let Err(err) = agent.restart(config.local_ufrag, config.local_pwd).await {
|
||||||
|
Self::close_multicast_conn(&agent.mdns_conn).await;
|
||||||
|
let _ = agent.close().await;
|
||||||
|
return Err(err);
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(agent)
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn get_bytes_received(&self) -> usize {
|
||||||
|
self.internal.agent_conn.bytes_received()
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn get_bytes_sent(&self) -> usize {
|
||||||
|
self.internal.agent_conn.bytes_sent()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Sets a handler that is fired when the connection state changes.
|
||||||
|
pub fn on_connection_state_change(&self, f: OnConnectionStateChangeHdlrFn) {
|
||||||
|
self.internal
|
||||||
|
.on_connection_state_change_hdlr
|
||||||
|
.store(Some(Arc::new(Mutex::new(f))))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Sets a handler that is fired when the final candidate pair is selected.
|
||||||
|
pub fn on_selected_candidate_pair_change(&self, f: OnSelectedCandidatePairChangeHdlrFn) {
|
||||||
|
self.internal
|
||||||
|
.on_selected_candidate_pair_change_hdlr
|
||||||
|
.store(Some(Arc::new(Mutex::new(f))))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Sets a handler that is fired when new candidates gathered. When the gathering process
|
||||||
|
/// complete the last candidate is nil.
|
||||||
|
pub fn on_candidate(&self, f: OnCandidateHdlrFn) {
|
||||||
|
self.internal
|
||||||
|
.on_candidate_hdlr
|
||||||
|
.store(Some(Arc::new(Mutex::new(f))));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Adds a new remote candidate.
|
||||||
|
pub fn add_remote_candidate(&self, c: &Arc<dyn Candidate + Send + Sync>) -> Result<()> {
|
||||||
|
// cannot check for network yet because it might not be applied
|
||||||
|
// when mDNS hostame is used.
|
||||||
|
if c.tcp_type() == TcpType::Active {
|
||||||
|
// TCP Candidates with tcptype active will probe server passive ones, so
|
||||||
|
// no need to do anything with them.
|
||||||
|
log::info!("Ignoring remote candidate with tcpType active: {}", c);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
|
||||||
|
// If we have a mDNS Candidate lets fully resolve it before adding it locally
|
||||||
|
if c.candidate_type() == CandidateType::Host && c.address().ends_with(".local") {
|
||||||
|
if self.mdns_mode == MulticastDnsMode::Disabled {
|
||||||
|
log::warn!(
|
||||||
|
"remote mDNS candidate added, but mDNS is disabled: ({})",
|
||||||
|
c.address()
|
||||||
|
);
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
|
||||||
|
if c.candidate_type() != CandidateType::Host {
|
||||||
|
return Err(Error::ErrAddressParseFailed);
|
||||||
|
}
|
||||||
|
|
||||||
|
let ai = Arc::clone(&self.internal);
|
||||||
|
let host_candidate = Arc::clone(c);
|
||||||
|
let mdns_conn = self.mdns_conn.clone();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
if let Some(mdns_conn) = mdns_conn {
|
||||||
|
if let Ok(candidate) =
|
||||||
|
Self::resolve_and_add_multicast_candidate(mdns_conn, host_candidate).await
|
||||||
|
{
|
||||||
|
ai.add_remote_candidate(&candidate).await;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
} else {
|
||||||
|
let ai = Arc::clone(&self.internal);
|
||||||
|
let candidate = Arc::clone(c);
|
||||||
|
tokio::spawn(async move {
|
||||||
|
ai.add_remote_candidate(&candidate).await;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the local candidates.
|
||||||
|
pub async fn get_local_candidates(&self) -> Result<Vec<Arc<dyn Candidate + Send + Sync>>> {
|
||||||
|
let mut res = vec![];
|
||||||
|
|
||||||
|
{
|
||||||
|
let local_candidates = self.internal.local_candidates.lock().await;
|
||||||
|
for candidates in local_candidates.values() {
|
||||||
|
for candidate in candidates {
|
||||||
|
res.push(Arc::clone(candidate));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(res)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the local user credentials.
|
||||||
|
pub async fn get_local_user_credentials(&self) -> (String, String) {
|
||||||
|
let ufrag_pwd = self.internal.ufrag_pwd.lock().await;
|
||||||
|
(ufrag_pwd.local_ufrag.clone(), ufrag_pwd.local_pwd.clone())
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the remote user credentials.
|
||||||
|
pub async fn get_remote_user_credentials(&self) -> (String, String) {
|
||||||
|
let ufrag_pwd = self.internal.ufrag_pwd.lock().await;
|
||||||
|
(ufrag_pwd.remote_ufrag.clone(), ufrag_pwd.remote_pwd.clone())
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Cleans up the Agent.
|
||||||
|
pub async fn close(&self) -> Result<()> {
|
||||||
|
if let Some(gather_candidate_cancel) = &self.gather_candidate_cancel {
|
||||||
|
gather_candidate_cancel();
|
||||||
|
}
|
||||||
|
|
||||||
|
if let UDPNetwork::Muxed(ref udp_mux) = self.udp_network {
|
||||||
|
let (ufrag, _) = self.get_local_user_credentials().await;
|
||||||
|
udp_mux.remove_conn_by_ufrag(&ufrag).await;
|
||||||
|
}
|
||||||
|
|
||||||
|
//FIXME: deadlock here
|
||||||
|
self.internal.close().await
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the selected pair or nil if there is none
|
||||||
|
pub fn get_selected_candidate_pair(&self) -> Option<Arc<CandidatePair>> {
|
||||||
|
self.internal.agent_conn.get_selected_pair()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Sets the credentials of the remote agent.
|
||||||
|
pub async fn set_remote_credentials(
|
||||||
|
&self,
|
||||||
|
remote_ufrag: String,
|
||||||
|
remote_pwd: String,
|
||||||
|
) -> Result<()> {
|
||||||
|
self.internal
|
||||||
|
.set_remote_credentials(remote_ufrag, remote_pwd)
|
||||||
|
.await
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Restarts the ICE Agent with the provided ufrag/pwd
|
||||||
|
/// If no ufrag/pwd is provided the Agent will generate one itself.
|
||||||
|
///
|
||||||
|
/// Restart must only be called when `GatheringState` is `GatheringStateComplete`
|
||||||
|
/// a user must then call `GatherCandidates` explicitly to start generating new ones.
|
||||||
|
pub async fn restart(&self, mut ufrag: String, mut pwd: String) -> Result<()> {
|
||||||
|
if ufrag.is_empty() {
|
||||||
|
ufrag = generate_ufrag();
|
||||||
|
}
|
||||||
|
if pwd.is_empty() {
|
||||||
|
pwd = generate_pwd();
|
||||||
|
}
|
||||||
|
|
||||||
|
if ufrag.len() * 8 < 24 {
|
||||||
|
return Err(Error::ErrLocalUfragInsufficientBits);
|
||||||
|
}
|
||||||
|
if pwd.len() * 8 < 128 {
|
||||||
|
return Err(Error::ErrLocalPwdInsufficientBits);
|
||||||
|
}
|
||||||
|
|
||||||
|
if GatheringState::from(self.gathering_state.load(Ordering::SeqCst))
|
||||||
|
== GatheringState::Gathering
|
||||||
|
{
|
||||||
|
return Err(Error::ErrRestartWhenGathering);
|
||||||
|
}
|
||||||
|
self.gathering_state
|
||||||
|
.store(GatheringState::New as u8, Ordering::SeqCst);
|
||||||
|
|
||||||
|
{
|
||||||
|
let done_tx = self.internal.done_tx.lock().await;
|
||||||
|
if done_tx.is_none() {
|
||||||
|
return Err(Error::ErrClosed);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Clear all agent needed to take back to fresh state
|
||||||
|
{
|
||||||
|
let mut ufrag_pwd = self.internal.ufrag_pwd.lock().await;
|
||||||
|
ufrag_pwd.local_ufrag = ufrag;
|
||||||
|
ufrag_pwd.local_pwd = pwd;
|
||||||
|
ufrag_pwd.remote_ufrag = String::new();
|
||||||
|
ufrag_pwd.remote_pwd = String::new();
|
||||||
|
}
|
||||||
|
{
|
||||||
|
let mut pending_binding_requests = self.internal.pending_binding_requests.lock().await;
|
||||||
|
*pending_binding_requests = vec![];
|
||||||
|
}
|
||||||
|
|
||||||
|
{
|
||||||
|
let mut checklist = self.internal.agent_conn.checklist.lock().await;
|
||||||
|
*checklist = vec![];
|
||||||
|
}
|
||||||
|
|
||||||
|
self.internal.set_selected_pair(None).await;
|
||||||
|
self.internal.delete_all_candidates().await;
|
||||||
|
self.internal.start().await;
|
||||||
|
|
||||||
|
// Restart is used by NewAgent. Accept/Connect should be used to move to checking
|
||||||
|
// for new Agents
|
||||||
|
if self.internal.connection_state.load(Ordering::SeqCst) != ConnectionState::New as u8 {
|
||||||
|
self.internal
|
||||||
|
.update_connection_state(ConnectionState::Checking)
|
||||||
|
.await;
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Initiates the trickle based gathering process.
|
||||||
|
pub fn gather_candidates(&self) -> Result<()> {
|
||||||
|
if self.gathering_state.load(Ordering::SeqCst) != GatheringState::New as u8 {
|
||||||
|
return Err(Error::ErrMultipleGatherAttempted);
|
||||||
|
}
|
||||||
|
|
||||||
|
if self.internal.on_candidate_hdlr.load().is_none() {
|
||||||
|
return Err(Error::ErrNoOnCandidateHandler);
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(gather_candidate_cancel) = &self.gather_candidate_cancel {
|
||||||
|
gather_candidate_cancel(); // Cancel previous gathering routine
|
||||||
|
}
|
||||||
|
|
||||||
|
//TODO: a.gatherCandidateCancel = cancel
|
||||||
|
|
||||||
|
let params = GatherCandidatesInternalParams {
|
||||||
|
udp_network: self.udp_network.clone(),
|
||||||
|
candidate_types: self.candidate_types.clone(),
|
||||||
|
urls: self.urls.clone(),
|
||||||
|
network_types: self.network_types.clone(),
|
||||||
|
mdns_mode: self.mdns_mode,
|
||||||
|
mdns_name: self.mdns_name.clone(),
|
||||||
|
net: Arc::clone(&self.net),
|
||||||
|
interface_filter: self.interface_filter.clone(),
|
||||||
|
ip_filter: self.ip_filter.clone(),
|
||||||
|
ext_ip_mapper: Arc::clone(&self.ext_ip_mapper),
|
||||||
|
agent_internal: Arc::clone(&self.internal),
|
||||||
|
gathering_state: Arc::clone(&self.gathering_state),
|
||||||
|
chan_candidate_tx: Arc::clone(&self.internal.chan_candidate_tx),
|
||||||
|
};
|
||||||
|
tokio::spawn(async move {
|
||||||
|
Self::gather_candidates_internal(params).await;
|
||||||
|
});
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a list of candidate pair stats.
|
||||||
|
pub async fn get_candidate_pairs_stats(&self) -> Vec<CandidatePairStats> {
|
||||||
|
self.internal.get_candidate_pairs_stats().await
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a list of local candidates stats.
|
||||||
|
pub async fn get_local_candidates_stats(&self) -> Vec<CandidateStats> {
|
||||||
|
self.internal.get_local_candidates_stats().await
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a list of remote candidates stats.
|
||||||
|
pub async fn get_remote_candidates_stats(&self) -> Vec<CandidateStats> {
|
||||||
|
self.internal.get_remote_candidates_stats().await
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn resolve_and_add_multicast_candidate(
|
||||||
|
mdns_conn: Arc<DnsConn>,
|
||||||
|
c: Arc<dyn Candidate + Send + Sync>,
|
||||||
|
) -> Result<Arc<dyn Candidate + Send + Sync>> {
|
||||||
|
//TODO: hook up _close_query_signal_tx to Agent or Candidate's Close signal?
|
||||||
|
let (_close_query_signal_tx, close_query_signal_rx) = mpsc::channel(1);
|
||||||
|
let src = match mdns_conn.query(&c.address(), close_query_signal_rx).await {
|
||||||
|
Ok((_, src)) => src,
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!("Failed to discover mDNS candidate {}: {}", c.address(), err);
|
||||||
|
return Err(err.into());
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
c.set_ip(&src.ip())?;
|
||||||
|
|
||||||
|
Ok(c)
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn close_multicast_conn(mdns_conn: &Option<Arc<DnsConn>>) {
|
||||||
|
if let Some(conn) = mdns_conn {
|
||||||
|
if let Err(err) = conn.close().await {
|
||||||
|
log::warn!("failed to close mDNS Conn: {}", err);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
+191
@@ -0,0 +1,191 @@
|
|||||||
|
//! TURN over TCP/TLS (RFC 6062 framing as used by RFC 5766 §2.1), optionally through an HTTP
|
||||||
|
//! CONNECT proxy. Local patch for uu-remote-linux: upstream only gathers relays over UDP.
|
||||||
|
|
||||||
|
use std::net::{IpAddr, SocketAddr};
|
||||||
|
use std::sync::{Arc, RwLock};
|
||||||
|
|
||||||
|
use async_trait::async_trait;
|
||||||
|
use tokio::io::{AsyncRead, AsyncReadExt, AsyncWrite, AsyncWriteExt, ReadHalf, WriteHalf};
|
||||||
|
use tokio::net::TcpStream;
|
||||||
|
use tokio::sync::Mutex;
|
||||||
|
use util::Conn;
|
||||||
|
|
||||||
|
/// How relay connections over TCP reach the TURN server. Set once by the application.
|
||||||
|
#[derive(Clone, Debug, Default)]
|
||||||
|
pub struct RelayTransport {
|
||||||
|
/// HTTP proxy `host:port` for CONNECT; None dials the TURN server directly.
|
||||||
|
pub http_proxy: Option<String>,
|
||||||
|
}
|
||||||
|
|
||||||
|
static TRANSPORT: RwLock<Option<RelayTransport>> = RwLock::new(None);
|
||||||
|
|
||||||
|
pub fn set_relay_transport(transport: RelayTransport) {
|
||||||
|
*TRANSPORT.write().unwrap() = Some(transport);
|
||||||
|
}
|
||||||
|
|
||||||
|
fn transport() -> RelayTransport {
|
||||||
|
TRANSPORT.read().unwrap().clone().unwrap_or_default()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// TCP/TLS relays are gathered only after the application opts in; UDP-only by default.
|
||||||
|
pub fn enabled() -> bool {
|
||||||
|
TRANSPORT.read().unwrap().is_some()
|
||||||
|
}
|
||||||
|
|
||||||
|
trait Stream: AsyncRead + AsyncWrite + Send + Unpin {}
|
||||||
|
impl<T: AsyncRead + AsyncWrite + Send + Unpin> Stream for T {}
|
||||||
|
|
||||||
|
/// Datagram view of a framed TURN stream: one STUN message or ChannelData per read.
|
||||||
|
pub struct FramedConn {
|
||||||
|
reader: Mutex<ReadHalf<Box<dyn Stream>>>,
|
||||||
|
writer: Mutex<WriteHalf<Box<dyn Stream>>>,
|
||||||
|
local: SocketAddr,
|
||||||
|
server: SocketAddr,
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Opens TCP (optionally through the proxy) and TLS when `tls`, then frames it.
|
||||||
|
pub async fn dial(host: &str, port: u16, server: SocketAddr, tls: bool) -> Result<FramedConn, String> {
|
||||||
|
let settings = transport();
|
||||||
|
let target = format!("{host}:{port}");
|
||||||
|
let tcp = match &settings.http_proxy {
|
||||||
|
Some(proxy) => connect_via_proxy(proxy, &target).await?,
|
||||||
|
None => TcpStream::connect(server).await.map_err(|e| format!("TURN TCP connect: {e}"))?,
|
||||||
|
};
|
||||||
|
let local = tcp.local_addr().map_err(|e| format!("TURN TCP local address: {e}"))?;
|
||||||
|
let stream: Box<dyn Stream> = if tls {
|
||||||
|
Box::new(tls_connect(tcp, host).await?)
|
||||||
|
} else {
|
||||||
|
Box::new(tcp)
|
||||||
|
};
|
||||||
|
let (reader, writer) = tokio::io::split(stream);
|
||||||
|
Ok(FramedConn { reader: Mutex::new(reader), writer: Mutex::new(writer), local, server })
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn connect_via_proxy(proxy: &str, target: &str) -> Result<TcpStream, String> {
|
||||||
|
let mut tcp = TcpStream::connect(proxy).await.map_err(|e| format!("TURN proxy connect: {e}"))?;
|
||||||
|
let request = format!("CONNECT {target} HTTP/1.1\r\nHost: {target}\r\n\r\n");
|
||||||
|
tcp.write_all(request.as_bytes()).await.map_err(|e| format!("TURN proxy write: {e}"))?;
|
||||||
|
// Read byte by byte up to the blank line so no tunnelled bytes are consumed.
|
||||||
|
let mut head = Vec::new();
|
||||||
|
while !head.ends_with(b"\r\n\r\n") {
|
||||||
|
if head.len() > 8192 { return Err("TURN proxy response too large".into()); }
|
||||||
|
let mut byte = [0u8; 1];
|
||||||
|
if tcp.read(&mut byte).await.map_err(|e| format!("TURN proxy read: {e}"))? == 0 {
|
||||||
|
return Err("TURN proxy closed the connection".into());
|
||||||
|
}
|
||||||
|
head.push(byte[0]);
|
||||||
|
}
|
||||||
|
let status = String::from_utf8_lossy(&head).lines().next().unwrap_or("").to_owned();
|
||||||
|
match status.split_whitespace().nth(1) {
|
||||||
|
Some("200") => Ok(tcp),
|
||||||
|
code => Err(format!("TURN proxy CONNECT refused: status={}", code.unwrap_or("none"))),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn tls_connect(tcp: TcpStream, host: &str)
|
||||||
|
-> Result<tokio_rustls::client::TlsStream<TcpStream>, String> {
|
||||||
|
use tokio_rustls::rustls::{self, client::WebPkiServerVerifier, pki_types::ServerName};
|
||||||
|
let provider = Arc::new(rustls::crypto::ring::default_provider());
|
||||||
|
let mut roots = rustls::RootCertStore::empty();
|
||||||
|
roots.extend(webpki_roots::TLS_SERVER_ROOTS.iter().cloned());
|
||||||
|
let inner = WebPkiServerVerifier::builder_with_provider(Arc::new(roots), provider.clone()).build()
|
||||||
|
.map_err(|e| format!("TURN TLS setup: {e}"))?;
|
||||||
|
let config = rustls::ClientConfig::builder_with_provider(provider)
|
||||||
|
.with_safe_default_protocol_versions().map_err(|e| format!("TURN TLS setup: {e}"))?
|
||||||
|
.dangerous().with_custom_certificate_verifier(Arc::new(IpTolerant(inner))).with_no_client_auth();
|
||||||
|
let name = match host.parse::<IpAddr>() {
|
||||||
|
Ok(ip) => ServerName::IpAddress(ip.into()),
|
||||||
|
Err(_) => ServerName::try_from(host.to_owned()).map_err(|_| "TURN TLS: invalid server name".to_owned())?,
|
||||||
|
};
|
||||||
|
tokio_rustls::TlsConnector::from(Arc::new(config)).connect(name, tcp).await
|
||||||
|
.map_err(|e| format!("TURN TLS handshake: {e}"))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Full chain verification; only a name mismatch is accepted, and only when the TURN URL is an
|
||||||
|
/// IP literal (cloud TURN URLs are IPs while certificates name the service). Media is protected
|
||||||
|
/// end to end by DTLS-SRTP with signalled fingerprints, not by this hop.
|
||||||
|
#[derive(Debug)]
|
||||||
|
struct IpTolerant(Arc<tokio_rustls::rustls::client::WebPkiServerVerifier>);
|
||||||
|
|
||||||
|
impl tokio_rustls::rustls::client::danger::ServerCertVerifier for IpTolerant {
|
||||||
|
fn verify_server_cert(&self, end_entity: &tokio_rustls::rustls::pki_types::CertificateDer<'_>,
|
||||||
|
intermediates: &[tokio_rustls::rustls::pki_types::CertificateDer<'_>],
|
||||||
|
server_name: &tokio_rustls::rustls::pki_types::ServerName<'_>, ocsp: &[u8],
|
||||||
|
now: tokio_rustls::rustls::pki_types::UnixTime)
|
||||||
|
-> Result<tokio_rustls::rustls::client::danger::ServerCertVerified, tokio_rustls::rustls::Error> {
|
||||||
|
use tokio_rustls::rustls::{CertificateError, Error, pki_types::ServerName};
|
||||||
|
match self.0.verify_server_cert(end_entity, intermediates, server_name, ocsp, now) {
|
||||||
|
Err(Error::InvalidCertificate(CertificateError::NotValidForName | CertificateError::NotValidForNameContext { .. }))
|
||||||
|
if matches!(server_name, ServerName::IpAddress(_)) =>
|
||||||
|
Ok(tokio_rustls::rustls::client::danger::ServerCertVerified::assertion()),
|
||||||
|
other => other,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
fn verify_tls12_signature(&self, message: &[u8], cert: &tokio_rustls::rustls::pki_types::CertificateDer<'_>,
|
||||||
|
dss: &tokio_rustls::rustls::DigitallySignedStruct)
|
||||||
|
-> Result<tokio_rustls::rustls::client::danger::HandshakeSignatureValid, tokio_rustls::rustls::Error> {
|
||||||
|
self.0.verify_tls12_signature(message, cert, dss)
|
||||||
|
}
|
||||||
|
fn verify_tls13_signature(&self, message: &[u8], cert: &tokio_rustls::rustls::pki_types::CertificateDer<'_>,
|
||||||
|
dss: &tokio_rustls::rustls::DigitallySignedStruct)
|
||||||
|
-> Result<tokio_rustls::rustls::client::danger::HandshakeSignatureValid, tokio_rustls::rustls::Error> {
|
||||||
|
self.0.verify_tls13_signature(message, cert, dss)
|
||||||
|
}
|
||||||
|
fn supported_verify_schemes(&self) -> Vec<tokio_rustls::rustls::SignatureScheme> {
|
||||||
|
self.0.supported_verify_schemes()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Total on-the-wire length of the frame starting with `header` (4 bytes), including
|
||||||
|
/// ChannelData padding to 4 bytes, which TCP carries (RFC 5766 §11.5).
|
||||||
|
pub fn frame_len(header: [u8; 4]) -> Option<usize> {
|
||||||
|
let length = u16::from_be_bytes([header[2], header[3]]) as usize;
|
||||||
|
match header[0] >> 6 {
|
||||||
|
0 => Some(20 + length), // STUN: 20-byte header + attributes
|
||||||
|
1 => Some(4 + (length + 3) / 4 * 4), // ChannelData 0x4000..0x7FFF
|
||||||
|
_ => None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[async_trait]
|
||||||
|
impl Conn for FramedConn {
|
||||||
|
async fn connect(&self, _: SocketAddr) -> util::Result<()> {
|
||||||
|
Err(util::Error::Other("TURN TCP connection is already connected".into()))
|
||||||
|
}
|
||||||
|
async fn recv(&self, buf: &mut [u8]) -> util::Result<usize> {
|
||||||
|
self.recv_from(buf).await.map(|(n, _)| n)
|
||||||
|
}
|
||||||
|
async fn recv_from(&self, buf: &mut [u8]) -> util::Result<(usize, SocketAddr)> {
|
||||||
|
let mut reader = self.reader.lock().await;
|
||||||
|
let mut header = [0u8; 4];
|
||||||
|
reader.read_exact(&mut header).await?;
|
||||||
|
let total = frame_len(header).ok_or_else(|| util::Error::Other("TURN TCP: unknown frame type".into()))?;
|
||||||
|
let mut frame = vec![0u8; total];
|
||||||
|
frame[..4].copy_from_slice(&header);
|
||||||
|
reader.read_exact(&mut frame[4..]).await?;
|
||||||
|
if frame.len() > buf.len() {
|
||||||
|
return Err(util::Error::Other("TURN TCP: frame larger than the read buffer".into()));
|
||||||
|
}
|
||||||
|
buf[..frame.len()].copy_from_slice(&frame);
|
||||||
|
Ok((frame.len(), self.server))
|
||||||
|
}
|
||||||
|
async fn send(&self, buf: &[u8]) -> util::Result<usize> {
|
||||||
|
let mut writer = self.writer.lock().await;
|
||||||
|
writer.write_all(buf).await?;
|
||||||
|
writer.flush().await?;
|
||||||
|
Ok(buf.len())
|
||||||
|
}
|
||||||
|
async fn send_to(&self, buf: &[u8], _: SocketAddr) -> util::Result<usize> {
|
||||||
|
self.send(buf).await
|
||||||
|
}
|
||||||
|
fn local_addr(&self) -> util::Result<SocketAddr> {
|
||||||
|
Ok(self.local)
|
||||||
|
}
|
||||||
|
fn remote_addr(&self) -> Option<SocketAddr> {
|
||||||
|
Some(self.server)
|
||||||
|
}
|
||||||
|
async fn close(&self) -> util::Result<()> {
|
||||||
|
let _ = self.writer.lock().await.shutdown().await;
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
+524
@@ -0,0 +1,524 @@
|
|||||||
|
use std::fmt;
|
||||||
|
use std::ops::Add;
|
||||||
|
use std::sync::atomic::{AtomicU16, AtomicU64, AtomicU8, Ordering};
|
||||||
|
use std::sync::Arc;
|
||||||
|
use std::time::{Duration, SystemTime, UNIX_EPOCH};
|
||||||
|
|
||||||
|
use async_trait::async_trait;
|
||||||
|
use crc::{Crc, CRC_32_ISCSI};
|
||||||
|
use tokio::sync::{broadcast, Mutex};
|
||||||
|
use util::sync::Mutex as SyncMutex;
|
||||||
|
|
||||||
|
use super::*;
|
||||||
|
use crate::candidate::candidate_host::CandidateHostConfig;
|
||||||
|
use crate::candidate::candidate_peer_reflexive::CandidatePeerReflexiveConfig;
|
||||||
|
use crate::candidate::candidate_relay::CandidateRelayConfig;
|
||||||
|
use crate::candidate::candidate_server_reflexive::CandidateServerReflexiveConfig;
|
||||||
|
use crate::error::*;
|
||||||
|
use crate::util::*;
|
||||||
|
|
||||||
|
#[derive(Default)]
|
||||||
|
pub struct CandidateBaseConfig {
|
||||||
|
pub candidate_id: String,
|
||||||
|
pub network: String,
|
||||||
|
pub address: String,
|
||||||
|
pub port: u16,
|
||||||
|
pub component: u16,
|
||||||
|
pub priority: u32,
|
||||||
|
pub foundation: String,
|
||||||
|
pub conn: Option<Arc<dyn util::Conn + Send + Sync>>,
|
||||||
|
pub initialized_ch: Option<broadcast::Receiver<()>>,
|
||||||
|
}
|
||||||
|
|
||||||
|
pub struct CandidateBase {
|
||||||
|
pub(crate) id: String,
|
||||||
|
pub(crate) network_type: AtomicU8,
|
||||||
|
pub(crate) candidate_type: CandidateType,
|
||||||
|
|
||||||
|
pub(crate) component: AtomicU16,
|
||||||
|
pub(crate) address: String,
|
||||||
|
pub(crate) port: u16,
|
||||||
|
pub(crate) related_address: Option<CandidateRelatedAddress>,
|
||||||
|
pub(crate) tcp_type: TcpType,
|
||||||
|
|
||||||
|
pub(crate) resolved_addr: SyncMutex<SocketAddr>,
|
||||||
|
|
||||||
|
pub(crate) last_sent: AtomicU64,
|
||||||
|
pub(crate) last_received: AtomicU64,
|
||||||
|
|
||||||
|
pub(crate) conn: Option<Arc<dyn util::Conn + Send + Sync>>,
|
||||||
|
pub(crate) closed_ch: Arc<Mutex<Option<broadcast::Sender<()>>>>,
|
||||||
|
|
||||||
|
pub(crate) foundation_override: String,
|
||||||
|
pub(crate) priority_override: u32,
|
||||||
|
|
||||||
|
//CandidateHost
|
||||||
|
pub(crate) network: String,
|
||||||
|
//CandidateRelay
|
||||||
|
pub(crate) relay_client: Option<Arc<turn::client::Client>>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for CandidateBase {
|
||||||
|
fn default() -> Self {
|
||||||
|
Self {
|
||||||
|
id: String::new(),
|
||||||
|
network_type: AtomicU8::new(0),
|
||||||
|
candidate_type: CandidateType::default(),
|
||||||
|
|
||||||
|
component: AtomicU16::new(0),
|
||||||
|
address: String::new(),
|
||||||
|
port: 0,
|
||||||
|
related_address: None,
|
||||||
|
tcp_type: TcpType::default(),
|
||||||
|
|
||||||
|
resolved_addr: SyncMutex::new(SocketAddr::new(IpAddr::from([0, 0, 0, 0]), 0)),
|
||||||
|
|
||||||
|
last_sent: AtomicU64::new(0),
|
||||||
|
last_received: AtomicU64::new(0),
|
||||||
|
|
||||||
|
conn: None,
|
||||||
|
closed_ch: Arc::new(Mutex::new(None)),
|
||||||
|
|
||||||
|
foundation_override: String::new(),
|
||||||
|
priority_override: 0,
|
||||||
|
network: String::new(),
|
||||||
|
relay_client: None,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// String makes the candidateBase printable
|
||||||
|
impl fmt::Display for CandidateBase {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||||
|
if let Some(related_address) = self.related_address() {
|
||||||
|
write!(
|
||||||
|
f,
|
||||||
|
"{} {} {}:{}{}",
|
||||||
|
self.network_type(),
|
||||||
|
self.candidate_type(),
|
||||||
|
self.address(),
|
||||||
|
self.port(),
|
||||||
|
related_address,
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
write!(
|
||||||
|
f,
|
||||||
|
"{} {} {}:{}",
|
||||||
|
self.network_type(),
|
||||||
|
self.candidate_type(),
|
||||||
|
self.address(),
|
||||||
|
self.port(),
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[async_trait]
|
||||||
|
impl Candidate for CandidateBase {
|
||||||
|
fn foundation(&self) -> String {
|
||||||
|
if !self.foundation_override.is_empty() {
|
||||||
|
return self.foundation_override.clone();
|
||||||
|
}
|
||||||
|
|
||||||
|
let mut buf = vec![];
|
||||||
|
buf.extend_from_slice(self.candidate_type().to_string().as_bytes());
|
||||||
|
buf.extend_from_slice(self.address.as_bytes());
|
||||||
|
buf.extend_from_slice(self.network_type().to_string().as_bytes());
|
||||||
|
|
||||||
|
let checksum = Crc::<u32>::new(&CRC_32_ISCSI).checksum(&buf);
|
||||||
|
|
||||||
|
format!("{checksum}")
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns Candidate ID.
|
||||||
|
fn id(&self) -> String {
|
||||||
|
self.id.clone()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns candidate component.
|
||||||
|
fn component(&self) -> u16 {
|
||||||
|
self.component.load(Ordering::SeqCst)
|
||||||
|
}
|
||||||
|
|
||||||
|
fn set_component(&self, component: u16) {
|
||||||
|
self.component.store(component, Ordering::SeqCst);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a time indicating the last time this candidate was received.
|
||||||
|
fn last_received(&self) -> SystemTime {
|
||||||
|
UNIX_EPOCH.add(Duration::from_nanos(
|
||||||
|
self.last_received.load(Ordering::SeqCst),
|
||||||
|
))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a time indicating the last time this candidate was sent.
|
||||||
|
fn last_sent(&self) -> SystemTime {
|
||||||
|
UNIX_EPOCH.add(Duration::from_nanos(self.last_sent.load(Ordering::SeqCst)))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns candidate NetworkType.
|
||||||
|
fn network_type(&self) -> NetworkType {
|
||||||
|
NetworkType::from(self.network_type.load(Ordering::SeqCst))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns Candidate Address.
|
||||||
|
fn address(&self) -> String {
|
||||||
|
self.address.clone()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns Candidate Port.
|
||||||
|
fn port(&self) -> u16 {
|
||||||
|
self.port
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Computes the priority for this ICE Candidate.
|
||||||
|
fn priority(&self) -> u32 {
|
||||||
|
if self.priority_override != 0 {
|
||||||
|
return self.priority_override;
|
||||||
|
}
|
||||||
|
|
||||||
|
// The local preference MUST be an integer from 0 (lowest preference) to
|
||||||
|
// 65535 (highest preference) inclusive. When there is only a single IP
|
||||||
|
// address, this value SHOULD be set to 65535. If there are multiple
|
||||||
|
// candidates for a particular component for a particular data stream
|
||||||
|
// that have the same type, the local preference MUST be unique for each
|
||||||
|
// one.
|
||||||
|
(1 << 24) * u32::from(self.candidate_type().preference())
|
||||||
|
+ (1 << 8) * u32::from(self.local_preference())
|
||||||
|
+ (256 - u32::from(self.component()))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns `Option<CandidateRelatedAddress>`.
|
||||||
|
fn related_address(&self) -> Option<CandidateRelatedAddress> {
|
||||||
|
self.related_address.as_ref().cloned()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns candidate type.
|
||||||
|
fn candidate_type(&self) -> CandidateType {
|
||||||
|
self.candidate_type
|
||||||
|
}
|
||||||
|
|
||||||
|
fn tcp_type(&self) -> TcpType {
|
||||||
|
self.tcp_type
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the string representation of the ICECandidate.
|
||||||
|
fn marshal(&self) -> String {
|
||||||
|
let mut val = format!(
|
||||||
|
"{} {} {} {} {} {} typ {}",
|
||||||
|
self.foundation(),
|
||||||
|
self.component(),
|
||||||
|
self.network_type().network_short(),
|
||||||
|
self.priority(),
|
||||||
|
self.address(),
|
||||||
|
self.port(),
|
||||||
|
self.candidate_type()
|
||||||
|
);
|
||||||
|
|
||||||
|
if self.tcp_type != TcpType::Unspecified {
|
||||||
|
val += format!(" tcptype {}", self.tcp_type()).as_str();
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(related_address) = self.related_address() {
|
||||||
|
val += format!(
|
||||||
|
" raddr {} rport {}",
|
||||||
|
related_address.address, related_address.port,
|
||||||
|
)
|
||||||
|
.as_str();
|
||||||
|
}
|
||||||
|
|
||||||
|
val
|
||||||
|
}
|
||||||
|
|
||||||
|
fn addr(&self) -> SocketAddr {
|
||||||
|
*self.resolved_addr.lock()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Stops the recvLoop.
|
||||||
|
async fn close(&self) -> Result<()> {
|
||||||
|
{
|
||||||
|
let mut closed_ch = self.closed_ch.lock().await;
|
||||||
|
if closed_ch.is_none() {
|
||||||
|
return Err(Error::ErrClosed);
|
||||||
|
}
|
||||||
|
closed_ch.take();
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(relay_client) = &self.relay_client {
|
||||||
|
let _ = relay_client.close().await;
|
||||||
|
}
|
||||||
|
|
||||||
|
if let Some(conn) = &self.conn {
|
||||||
|
let _ = conn.close().await;
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
fn seen(&self, outbound: bool) {
|
||||||
|
let d = SystemTime::now()
|
||||||
|
.duration_since(UNIX_EPOCH)
|
||||||
|
.unwrap_or_else(|_| Duration::from_secs(0));
|
||||||
|
|
||||||
|
if outbound {
|
||||||
|
self.set_last_sent(d);
|
||||||
|
} else {
|
||||||
|
self.set_last_received(d);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn write_to(&self, raw: &[u8], dst: &(dyn Candidate + Send + Sync)) -> Result<usize> {
|
||||||
|
let n = if let Some(conn) = &self.conn {
|
||||||
|
let addr = dst.addr();
|
||||||
|
conn.send_to(raw, addr).await?
|
||||||
|
} else {
|
||||||
|
0
|
||||||
|
};
|
||||||
|
self.seen(true);
|
||||||
|
Ok(n)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Used to compare two candidateBases.
|
||||||
|
fn equal(&self, other: &dyn Candidate) -> bool {
|
||||||
|
self.network_type() == other.network_type()
|
||||||
|
&& self.candidate_type() == other.candidate_type()
|
||||||
|
&& self.address() == other.address()
|
||||||
|
&& self.port() == other.port()
|
||||||
|
&& self.tcp_type() == other.tcp_type()
|
||||||
|
&& self.related_address() == other.related_address()
|
||||||
|
}
|
||||||
|
|
||||||
|
fn set_ip(&self, ip: &IpAddr) -> Result<()> {
|
||||||
|
let network_type = determine_network_type(&self.network, ip)?;
|
||||||
|
|
||||||
|
self.network_type
|
||||||
|
.store(network_type as u8, Ordering::SeqCst);
|
||||||
|
|
||||||
|
let addr = create_addr(network_type, *ip, self.port);
|
||||||
|
*self.resolved_addr.lock() = addr;
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
fn get_conn(&self) -> Option<&Arc<dyn util::Conn + Send + Sync>> {
|
||||||
|
self.conn.as_ref()
|
||||||
|
}
|
||||||
|
|
||||||
|
fn get_closed_ch(&self) -> Arc<Mutex<Option<broadcast::Sender<()>>>> {
|
||||||
|
self.closed_ch.clone()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl CandidateBase {
|
||||||
|
pub fn set_last_received(&self, d: Duration) {
|
||||||
|
#[allow(clippy::cast_possible_truncation)]
|
||||||
|
self.last_received
|
||||||
|
.store(d.as_nanos() as u64, Ordering::SeqCst);
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn set_last_sent(&self, d: Duration) {
|
||||||
|
#[allow(clippy::cast_possible_truncation)]
|
||||||
|
self.last_sent.store(d.as_nanos() as u64, Ordering::SeqCst);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the local preference for this candidate.
|
||||||
|
pub fn local_preference(&self) -> u16 {
|
||||||
|
if self.network_type().is_tcp() {
|
||||||
|
// RFC 6544, section 4.2
|
||||||
|
//
|
||||||
|
// In Section 4.1.2.1 of [RFC5245], a recommended formula for UDP ICE
|
||||||
|
// candidate prioritization is defined. For TCP candidates, the same
|
||||||
|
// formula and candidate type preferences SHOULD be used, and the
|
||||||
|
// RECOMMENDED type preferences for the new candidate types defined in
|
||||||
|
// this document (see Section 5) are 105 for NAT-assisted candidates and
|
||||||
|
// 75 for UDP-tunneled candidates.
|
||||||
|
//
|
||||||
|
// (...)
|
||||||
|
//
|
||||||
|
// With TCP candidates, the local preference part of the recommended
|
||||||
|
// priority formula is updated to also include the directionality
|
||||||
|
// (active, passive, or simultaneous-open) of the TCP connection. The
|
||||||
|
// RECOMMENDED local preference is then defined as:
|
||||||
|
//
|
||||||
|
// local preference = (2^13) * direction-pref + other-pref
|
||||||
|
//
|
||||||
|
// The direction-pref MUST be between 0 and 7 (both inclusive), with 7
|
||||||
|
// being the most preferred. The other-pref MUST be between 0 and 8191
|
||||||
|
// (both inclusive), with 8191 being the most preferred. It is
|
||||||
|
// RECOMMENDED that the host, UDP-tunneled, and relayed TCP candidates
|
||||||
|
// have the direction-pref assigned as follows: 6 for active, 4 for
|
||||||
|
// passive, and 2 for S-O. For the NAT-assisted and server reflexive
|
||||||
|
// candidates, the RECOMMENDED values are: 6 for S-O, 4 for active, and
|
||||||
|
// 2 for passive.
|
||||||
|
//
|
||||||
|
// (...)
|
||||||
|
//
|
||||||
|
// If any two candidates have the same type-preference and direction-
|
||||||
|
// pref, they MUST have a unique other-pref. With this specification,
|
||||||
|
// this usually only happens with multi-homed hosts, in which case
|
||||||
|
// other-pref is the preference for the particular IP address from which
|
||||||
|
// the candidate was obtained. When there is only a single IP address,
|
||||||
|
// this value SHOULD be set to the maximum allowed value (8191).
|
||||||
|
let other_pref: u16 = 8191;
|
||||||
|
|
||||||
|
let direction_pref: u16 = match self.candidate_type() {
|
||||||
|
CandidateType::Host | CandidateType::Relay => match self.tcp_type() {
|
||||||
|
TcpType::Active => 6,
|
||||||
|
TcpType::Passive => 4,
|
||||||
|
TcpType::SimultaneousOpen => 2,
|
||||||
|
TcpType::Unspecified => 0,
|
||||||
|
},
|
||||||
|
CandidateType::PeerReflexive | CandidateType::ServerReflexive => {
|
||||||
|
match self.tcp_type() {
|
||||||
|
TcpType::SimultaneousOpen => 6,
|
||||||
|
TcpType::Active => 4,
|
||||||
|
TcpType::Passive => 2,
|
||||||
|
TcpType::Unspecified => 0,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
CandidateType::Unspecified => 0,
|
||||||
|
};
|
||||||
|
|
||||||
|
(1 << 13) * direction_pref + other_pref
|
||||||
|
} else {
|
||||||
|
DEFAULT_LOCAL_PREFERENCE
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Creates a Candidate from its string representation.
|
||||||
|
pub fn unmarshal_candidate(raw: &str) -> Result<impl Candidate> {
|
||||||
|
let split: Vec<&str> = raw.split_whitespace().collect();
|
||||||
|
if split.len() < 8 {
|
||||||
|
return Err(Error::Other(format!(
|
||||||
|
"{:?} ({})",
|
||||||
|
Error::ErrAttributeTooShortIceCandidate,
|
||||||
|
split.len()
|
||||||
|
)));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Foundation
|
||||||
|
let foundation = split[0].to_owned();
|
||||||
|
|
||||||
|
// Component
|
||||||
|
let component: u16 = split[1].parse()?;
|
||||||
|
|
||||||
|
// Network
|
||||||
|
let network = split[2].to_owned();
|
||||||
|
|
||||||
|
// Priority
|
||||||
|
let priority: u32 = split[3].parse()?;
|
||||||
|
|
||||||
|
// Address
|
||||||
|
let address = split[4].to_owned();
|
||||||
|
|
||||||
|
// Port
|
||||||
|
let port: u16 = split[5].parse()?;
|
||||||
|
|
||||||
|
let typ = split[7];
|
||||||
|
|
||||||
|
let mut rel_addr = String::new();
|
||||||
|
let mut rel_port = 0;
|
||||||
|
let mut tcp_type = TcpType::Unspecified;
|
||||||
|
|
||||||
|
if split.len() > 8 {
|
||||||
|
let split2 = &split[8..];
|
||||||
|
|
||||||
|
if split2[0] == "raddr" {
|
||||||
|
if split2.len() < 4 {
|
||||||
|
return Err(Error::Other(format!(
|
||||||
|
"{:?}: incorrect length",
|
||||||
|
Error::ErrParseRelatedAddr
|
||||||
|
)));
|
||||||
|
}
|
||||||
|
|
||||||
|
// RelatedAddress
|
||||||
|
rel_addr = split2[1].to_owned();
|
||||||
|
|
||||||
|
// RelatedPort
|
||||||
|
rel_port = split2[3].parse()?;
|
||||||
|
} else if split2[0] == "tcptype" {
|
||||||
|
if split2.len() < 2 {
|
||||||
|
return Err(Error::Other(format!(
|
||||||
|
"{:?}: incorrect length",
|
||||||
|
Error::ErrParseType
|
||||||
|
)));
|
||||||
|
}
|
||||||
|
|
||||||
|
tcp_type = TcpType::from(split2[1]);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
match typ {
|
||||||
|
"host" => {
|
||||||
|
let config = CandidateHostConfig {
|
||||||
|
base_config: CandidateBaseConfig {
|
||||||
|
network,
|
||||||
|
address,
|
||||||
|
port,
|
||||||
|
component,
|
||||||
|
priority,
|
||||||
|
foundation,
|
||||||
|
..CandidateBaseConfig::default()
|
||||||
|
},
|
||||||
|
tcp_type,
|
||||||
|
};
|
||||||
|
config.new_candidate_host()
|
||||||
|
}
|
||||||
|
"srflx" => {
|
||||||
|
let config = CandidateServerReflexiveConfig {
|
||||||
|
base_config: CandidateBaseConfig {
|
||||||
|
network,
|
||||||
|
address,
|
||||||
|
port,
|
||||||
|
component,
|
||||||
|
priority,
|
||||||
|
foundation,
|
||||||
|
..CandidateBaseConfig::default()
|
||||||
|
},
|
||||||
|
rel_addr,
|
||||||
|
rel_port,
|
||||||
|
};
|
||||||
|
config.new_candidate_server_reflexive()
|
||||||
|
}
|
||||||
|
"prflx" => {
|
||||||
|
let config = CandidatePeerReflexiveConfig {
|
||||||
|
base_config: CandidateBaseConfig {
|
||||||
|
network,
|
||||||
|
address,
|
||||||
|
port,
|
||||||
|
component,
|
||||||
|
priority,
|
||||||
|
foundation,
|
||||||
|
..CandidateBaseConfig::default()
|
||||||
|
},
|
||||||
|
rel_addr,
|
||||||
|
rel_port,
|
||||||
|
};
|
||||||
|
|
||||||
|
config.new_candidate_peer_reflexive()
|
||||||
|
}
|
||||||
|
"relay" => {
|
||||||
|
let config = CandidateRelayConfig {
|
||||||
|
base_config: CandidateBaseConfig {
|
||||||
|
network,
|
||||||
|
address,
|
||||||
|
port,
|
||||||
|
component,
|
||||||
|
priority,
|
||||||
|
foundation,
|
||||||
|
..CandidateBaseConfig::default()
|
||||||
|
},
|
||||||
|
rel_addr,
|
||||||
|
rel_port,
|
||||||
|
..CandidateRelayConfig::default()
|
||||||
|
};
|
||||||
|
config.new_candidate_relay()
|
||||||
|
}
|
||||||
|
_ => Err(Error::Other(format!(
|
||||||
|
"{:?} ({})",
|
||||||
|
Error::ErrUnknownCandidateType,
|
||||||
|
typ
|
||||||
|
))),
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,45 @@
|
|||||||
|
use std::sync::atomic::{AtomicU16, AtomicU8};
|
||||||
|
|
||||||
|
use super::candidate_base::*;
|
||||||
|
use super::*;
|
||||||
|
use crate::rand::generate_cand_id;
|
||||||
|
|
||||||
|
/// The config required to create a new `CandidateHost`.
|
||||||
|
#[derive(Default)]
|
||||||
|
pub struct CandidateHostConfig {
|
||||||
|
pub base_config: CandidateBaseConfig,
|
||||||
|
|
||||||
|
pub tcp_type: TcpType,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl CandidateHostConfig {
|
||||||
|
/// Creates a new host candidate.
|
||||||
|
pub fn new_candidate_host(self) -> Result<CandidateBase> {
|
||||||
|
let mut candidate_id = self.base_config.candidate_id;
|
||||||
|
if candidate_id.is_empty() {
|
||||||
|
candidate_id = generate_cand_id();
|
||||||
|
}
|
||||||
|
|
||||||
|
let c = CandidateBase {
|
||||||
|
id: candidate_id,
|
||||||
|
address: self.base_config.address.clone(),
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
component: AtomicU16::new(self.base_config.component),
|
||||||
|
port: self.base_config.port,
|
||||||
|
tcp_type: self.tcp_type,
|
||||||
|
foundation_override: self.base_config.foundation,
|
||||||
|
priority_override: self.base_config.priority,
|
||||||
|
network: self.base_config.network,
|
||||||
|
network_type: AtomicU8::new(NetworkType::Udp4 as u8),
|
||||||
|
conn: self.base_config.conn,
|
||||||
|
..CandidateBase::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
if !self.base_config.address.ends_with(".local") {
|
||||||
|
let ip = self.base_config.address.parse()?;
|
||||||
|
c.set_ip(&ip)?;
|
||||||
|
};
|
||||||
|
|
||||||
|
Ok(c)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,155 @@
|
|||||||
|
use super::*;
|
||||||
|
use crate::candidate::candidate_host::CandidateHostConfig;
|
||||||
|
use crate::candidate::candidate_peer_reflexive::CandidatePeerReflexiveConfig;
|
||||||
|
use crate::candidate::candidate_relay::CandidateRelayConfig;
|
||||||
|
use crate::candidate::candidate_server_reflexive::CandidateServerReflexiveConfig;
|
||||||
|
|
||||||
|
pub(crate) fn host_candidate() -> Result<CandidateBase> {
|
||||||
|
CandidateHostConfig {
|
||||||
|
base_config: CandidateBaseConfig {
|
||||||
|
network: "udp".to_owned(),
|
||||||
|
address: "0.0.0.0".to_owned(),
|
||||||
|
component: COMPONENT_RTP,
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
..Default::default()
|
||||||
|
}
|
||||||
|
.new_candidate_host()
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) fn prflx_candidate() -> Result<CandidateBase> {
|
||||||
|
CandidatePeerReflexiveConfig {
|
||||||
|
base_config: CandidateBaseConfig {
|
||||||
|
network: "udp".to_owned(),
|
||||||
|
address: "0.0.0.0".to_owned(),
|
||||||
|
component: COMPONENT_RTP,
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
..Default::default()
|
||||||
|
}
|
||||||
|
.new_candidate_peer_reflexive()
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) fn srflx_candidate() -> Result<CandidateBase> {
|
||||||
|
CandidateServerReflexiveConfig {
|
||||||
|
base_config: CandidateBaseConfig {
|
||||||
|
network: "udp".to_owned(),
|
||||||
|
address: "0.0.0.0".to_owned(),
|
||||||
|
component: COMPONENT_RTP,
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
..Default::default()
|
||||||
|
}
|
||||||
|
.new_candidate_server_reflexive()
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) fn relay_candidate() -> Result<CandidateBase> {
|
||||||
|
CandidateRelayConfig {
|
||||||
|
base_config: CandidateBaseConfig {
|
||||||
|
network: "udp".to_owned(),
|
||||||
|
address: "0.0.0.0".to_owned(),
|
||||||
|
component: COMPONENT_RTP,
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
..Default::default()
|
||||||
|
}
|
||||||
|
.new_candidate_relay()
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_candidate_pair_priority() -> Result<()> {
|
||||||
|
let tests = vec![
|
||||||
|
(
|
||||||
|
CandidatePair::new(
|
||||||
|
Arc::new(host_candidate()?),
|
||||||
|
Arc::new(host_candidate()?),
|
||||||
|
false,
|
||||||
|
),
|
||||||
|
9151314440652587007,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
CandidatePair::new(
|
||||||
|
Arc::new(host_candidate()?),
|
||||||
|
Arc::new(host_candidate()?),
|
||||||
|
true,
|
||||||
|
),
|
||||||
|
9151314440652587007,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
CandidatePair::new(
|
||||||
|
Arc::new(host_candidate()?),
|
||||||
|
Arc::new(prflx_candidate()?),
|
||||||
|
true,
|
||||||
|
),
|
||||||
|
7998392936314175488,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
CandidatePair::new(
|
||||||
|
Arc::new(host_candidate()?),
|
||||||
|
Arc::new(prflx_candidate()?),
|
||||||
|
false,
|
||||||
|
),
|
||||||
|
7998392936314175487,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
CandidatePair::new(
|
||||||
|
Arc::new(host_candidate()?),
|
||||||
|
Arc::new(srflx_candidate()?),
|
||||||
|
true,
|
||||||
|
),
|
||||||
|
7277816996102668288,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
CandidatePair::new(
|
||||||
|
Arc::new(host_candidate()?),
|
||||||
|
Arc::new(srflx_candidate()?),
|
||||||
|
false,
|
||||||
|
),
|
||||||
|
7277816996102668287,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
CandidatePair::new(
|
||||||
|
Arc::new(host_candidate()?),
|
||||||
|
Arc::new(relay_candidate()?),
|
||||||
|
true,
|
||||||
|
),
|
||||||
|
72057593987596288,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
CandidatePair::new(
|
||||||
|
Arc::new(host_candidate()?),
|
||||||
|
Arc::new(relay_candidate()?),
|
||||||
|
false,
|
||||||
|
),
|
||||||
|
72057593987596287,
|
||||||
|
),
|
||||||
|
];
|
||||||
|
|
||||||
|
for (pair, want) in tests {
|
||||||
|
let got = pair.priority();
|
||||||
|
assert_eq!(
|
||||||
|
got, want,
|
||||||
|
"CandidatePair({pair}).Priority() = {got}, want {want}"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_candidate_pair_equality() -> Result<()> {
|
||||||
|
let pair_a = CandidatePair::new(
|
||||||
|
Arc::new(host_candidate()?),
|
||||||
|
Arc::new(srflx_candidate()?),
|
||||||
|
true,
|
||||||
|
);
|
||||||
|
let pair_b = CandidatePair::new(
|
||||||
|
Arc::new(host_candidate()?),
|
||||||
|
Arc::new(srflx_candidate()?),
|
||||||
|
false,
|
||||||
|
);
|
||||||
|
|
||||||
|
assert_eq!(pair_a, pair_b, "Expected {pair_a} to equal {pair_b}");
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
@@ -0,0 +1,54 @@
|
|||||||
|
use std::sync::atomic::{AtomicU16, AtomicU8};
|
||||||
|
|
||||||
|
use util::sync::Mutex as SyncMutex;
|
||||||
|
|
||||||
|
use super::candidate_base::*;
|
||||||
|
use super::*;
|
||||||
|
use crate::error::*;
|
||||||
|
use crate::rand::generate_cand_id;
|
||||||
|
use crate::util::*;
|
||||||
|
|
||||||
|
/// The config required to create a new `CandidatePeerReflexive`.
|
||||||
|
#[derive(Default)]
|
||||||
|
pub struct CandidatePeerReflexiveConfig {
|
||||||
|
pub base_config: CandidateBaseConfig,
|
||||||
|
|
||||||
|
pub rel_addr: String,
|
||||||
|
pub rel_port: u16,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl CandidatePeerReflexiveConfig {
|
||||||
|
/// Creates a new peer reflective candidate.
|
||||||
|
pub fn new_candidate_peer_reflexive(self) -> Result<CandidateBase> {
|
||||||
|
let ip: IpAddr = match self.base_config.address.parse() {
|
||||||
|
Ok(ip) => ip,
|
||||||
|
Err(_) => return Err(Error::ErrAddressParseFailed),
|
||||||
|
};
|
||||||
|
let network_type = determine_network_type(&self.base_config.network, &ip)?;
|
||||||
|
|
||||||
|
let mut candidate_id = self.base_config.candidate_id;
|
||||||
|
if candidate_id.is_empty() {
|
||||||
|
candidate_id = generate_cand_id();
|
||||||
|
}
|
||||||
|
|
||||||
|
let c = CandidateBase {
|
||||||
|
id: candidate_id,
|
||||||
|
network_type: AtomicU8::new(network_type as u8),
|
||||||
|
candidate_type: CandidateType::PeerReflexive,
|
||||||
|
address: self.base_config.address,
|
||||||
|
port: self.base_config.port,
|
||||||
|
resolved_addr: SyncMutex::new(create_addr(network_type, ip, self.base_config.port)),
|
||||||
|
component: AtomicU16::new(self.base_config.component),
|
||||||
|
foundation_override: self.base_config.foundation,
|
||||||
|
priority_override: self.base_config.priority,
|
||||||
|
related_address: Some(CandidateRelatedAddress {
|
||||||
|
address: self.rel_addr,
|
||||||
|
port: self.rel_port,
|
||||||
|
}),
|
||||||
|
conn: self.base_config.conn,
|
||||||
|
..CandidateBase::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
Ok(c)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,57 @@
|
|||||||
|
use std::sync::atomic::{AtomicU16, AtomicU8};
|
||||||
|
use std::sync::Arc;
|
||||||
|
|
||||||
|
use util::sync::Mutex as SyncMutex;
|
||||||
|
|
||||||
|
use super::candidate_base::*;
|
||||||
|
use super::*;
|
||||||
|
use crate::error::*;
|
||||||
|
use crate::rand::generate_cand_id;
|
||||||
|
use crate::util::*;
|
||||||
|
|
||||||
|
/// The config required to create a new `CandidateRelay`.
|
||||||
|
#[derive(Default)]
|
||||||
|
pub struct CandidateRelayConfig {
|
||||||
|
pub base_config: CandidateBaseConfig,
|
||||||
|
|
||||||
|
pub rel_addr: String,
|
||||||
|
pub rel_port: u16,
|
||||||
|
pub relay_client: Option<Arc<turn::client::Client>>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl CandidateRelayConfig {
|
||||||
|
/// Creates a new relay candidate.
|
||||||
|
pub fn new_candidate_relay(self) -> Result<CandidateBase> {
|
||||||
|
let mut candidate_id = self.base_config.candidate_id;
|
||||||
|
if candidate_id.is_empty() {
|
||||||
|
candidate_id = generate_cand_id();
|
||||||
|
}
|
||||||
|
|
||||||
|
let ip: IpAddr = match self.base_config.address.parse() {
|
||||||
|
Ok(ip) => ip,
|
||||||
|
Err(_) => return Err(Error::ErrAddressParseFailed),
|
||||||
|
};
|
||||||
|
let network_type = determine_network_type(&self.base_config.network, &ip)?;
|
||||||
|
|
||||||
|
let c = CandidateBase {
|
||||||
|
id: candidate_id,
|
||||||
|
network_type: AtomicU8::new(network_type as u8),
|
||||||
|
candidate_type: CandidateType::Relay,
|
||||||
|
address: self.base_config.address,
|
||||||
|
port: self.base_config.port,
|
||||||
|
resolved_addr: SyncMutex::new(create_addr(network_type, ip, self.base_config.port)),
|
||||||
|
component: AtomicU16::new(self.base_config.component),
|
||||||
|
foundation_override: self.base_config.foundation,
|
||||||
|
priority_override: self.base_config.priority,
|
||||||
|
related_address: Some(CandidateRelatedAddress {
|
||||||
|
address: self.rel_addr,
|
||||||
|
port: self.rel_port,
|
||||||
|
}),
|
||||||
|
conn: self.base_config.conn,
|
||||||
|
relay_client: self.relay_client.clone(),
|
||||||
|
..CandidateBase::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
Ok(c)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,114 @@
|
|||||||
|
use std::result::Result;
|
||||||
|
use std::time::Duration;
|
||||||
|
|
||||||
|
use tokio::net::UdpSocket;
|
||||||
|
use turn::auth::AuthHandler;
|
||||||
|
|
||||||
|
use super::*;
|
||||||
|
use crate::agent::agent_config::AgentConfig;
|
||||||
|
use crate::agent::agent_vnet_test::{connect_with_vnet, on_connected};
|
||||||
|
use crate::agent::Agent;
|
||||||
|
use crate::error::Error;
|
||||||
|
use crate::url::{ProtoType, SchemeType, Url};
|
||||||
|
|
||||||
|
pub(crate) struct OptimisticAuthHandler;
|
||||||
|
|
||||||
|
impl AuthHandler for OptimisticAuthHandler {
|
||||||
|
fn auth_handle(
|
||||||
|
&self,
|
||||||
|
_username: &str,
|
||||||
|
_realm: &str,
|
||||||
|
_src_addr: SocketAddr,
|
||||||
|
) -> Result<Vec<u8>, turn::Error> {
|
||||||
|
Ok(turn::auth::generate_auth_key(
|
||||||
|
"username",
|
||||||
|
"webrtc.rs",
|
||||||
|
"password",
|
||||||
|
))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
//use std::io::Write;
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn test_relay_only_connection() -> Result<(), Error> {
|
||||||
|
/*env_logger::Builder::new()
|
||||||
|
.format(|buf, record| {
|
||||||
|
writeln!(
|
||||||
|
buf,
|
||||||
|
"{}:{} [{}] {} - {}",
|
||||||
|
record.file().unwrap_or("unknown"),
|
||||||
|
record.line().unwrap_or(0),
|
||||||
|
record.level(),
|
||||||
|
chrono::Local::now().format("%H:%M:%S.%6f"),
|
||||||
|
record.args()
|
||||||
|
)
|
||||||
|
})
|
||||||
|
.filter(None, log::LevelFilter::Trace)
|
||||||
|
.init();*/
|
||||||
|
|
||||||
|
let server_listener = Arc::new(UdpSocket::bind("127.0.0.1:0").await?);
|
||||||
|
let server_port = server_listener.local_addr()?.port();
|
||||||
|
|
||||||
|
let server = turn::server::Server::new(turn::server::config::ServerConfig {
|
||||||
|
realm: "webrtc.rs".to_owned(),
|
||||||
|
auth_handler: Arc::new(OptimisticAuthHandler {}),
|
||||||
|
conn_configs: vec![turn::server::config::ConnConfig {
|
||||||
|
conn: server_listener,
|
||||||
|
relay_addr_generator: Box::new(turn::relay::relay_none::RelayAddressGeneratorNone {
|
||||||
|
address: "127.0.0.1".to_owned(),
|
||||||
|
net: Arc::new(util::vnet::net::Net::new(None)),
|
||||||
|
}),
|
||||||
|
}],
|
||||||
|
channel_bind_timeout: Duration::from_secs(0),
|
||||||
|
alloc_close_notify: None,
|
||||||
|
})
|
||||||
|
.await?;
|
||||||
|
|
||||||
|
let cfg0 = AgentConfig {
|
||||||
|
network_types: supported_network_types(),
|
||||||
|
urls: vec![Url {
|
||||||
|
scheme: SchemeType::Turn,
|
||||||
|
host: "127.0.0.1".to_owned(),
|
||||||
|
username: "username".to_owned(),
|
||||||
|
password: "password".to_owned(),
|
||||||
|
port: server_port,
|
||||||
|
proto: ProtoType::Udp,
|
||||||
|
}],
|
||||||
|
candidate_types: vec![CandidateType::Relay],
|
||||||
|
..Default::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
let a_agent = Arc::new(Agent::new(cfg0).await?);
|
||||||
|
let (a_notifier, mut a_connected) = on_connected();
|
||||||
|
a_agent.on_connection_state_change(a_notifier);
|
||||||
|
|
||||||
|
let cfg1 = AgentConfig {
|
||||||
|
network_types: supported_network_types(),
|
||||||
|
urls: vec![Url {
|
||||||
|
scheme: SchemeType::Turn,
|
||||||
|
host: "127.0.0.1".to_owned(),
|
||||||
|
username: "username".to_owned(),
|
||||||
|
password: "password".to_owned(),
|
||||||
|
port: server_port,
|
||||||
|
proto: ProtoType::Udp,
|
||||||
|
}],
|
||||||
|
candidate_types: vec![CandidateType::Relay],
|
||||||
|
..Default::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
let b_agent = Arc::new(Agent::new(cfg1).await?);
|
||||||
|
let (b_notifier, mut b_connected) = on_connected();
|
||||||
|
b_agent.on_connection_state_change(b_notifier);
|
||||||
|
|
||||||
|
connect_with_vnet(&a_agent, &b_agent).await?;
|
||||||
|
|
||||||
|
let _ = a_connected.recv().await;
|
||||||
|
let _ = b_connected.recv().await;
|
||||||
|
|
||||||
|
a_agent.close().await?;
|
||||||
|
b_agent.close().await?;
|
||||||
|
server.close().await?;
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
@@ -0,0 +1,54 @@
|
|||||||
|
use std::sync::atomic::{AtomicU16, AtomicU8};
|
||||||
|
|
||||||
|
use util::sync::Mutex as SyncMutex;
|
||||||
|
|
||||||
|
use super::candidate_base::*;
|
||||||
|
use super::*;
|
||||||
|
use crate::error::*;
|
||||||
|
use crate::rand::generate_cand_id;
|
||||||
|
use crate::util::*;
|
||||||
|
|
||||||
|
/// The config required to create a new `CandidateServerReflexive`.
|
||||||
|
#[derive(Default)]
|
||||||
|
pub struct CandidateServerReflexiveConfig {
|
||||||
|
pub base_config: CandidateBaseConfig,
|
||||||
|
|
||||||
|
pub rel_addr: String,
|
||||||
|
pub rel_port: u16,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl CandidateServerReflexiveConfig {
|
||||||
|
/// Creates a new server reflective candidate.
|
||||||
|
pub fn new_candidate_server_reflexive(self) -> Result<CandidateBase> {
|
||||||
|
let ip: IpAddr = match self.base_config.address.parse() {
|
||||||
|
Ok(ip) => ip,
|
||||||
|
Err(_) => return Err(Error::ErrAddressParseFailed),
|
||||||
|
};
|
||||||
|
let network_type = determine_network_type(&self.base_config.network, &ip)?;
|
||||||
|
|
||||||
|
let mut candidate_id = self.base_config.candidate_id;
|
||||||
|
if candidate_id.is_empty() {
|
||||||
|
candidate_id = generate_cand_id();
|
||||||
|
}
|
||||||
|
|
||||||
|
let c = CandidateBase {
|
||||||
|
id: candidate_id,
|
||||||
|
network_type: AtomicU8::new(network_type as u8),
|
||||||
|
candidate_type: CandidateType::ServerReflexive,
|
||||||
|
address: self.base_config.address,
|
||||||
|
port: self.base_config.port,
|
||||||
|
resolved_addr: SyncMutex::new(create_addr(network_type, ip, self.base_config.port)),
|
||||||
|
component: AtomicU16::new(self.base_config.component),
|
||||||
|
foundation_override: self.base_config.foundation,
|
||||||
|
priority_override: self.base_config.priority,
|
||||||
|
related_address: Some(CandidateRelatedAddress {
|
||||||
|
address: self.rel_addr,
|
||||||
|
port: self.rel_port,
|
||||||
|
}),
|
||||||
|
conn: self.base_config.conn,
|
||||||
|
..CandidateBase::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
Ok(c)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,91 @@
|
|||||||
|
use std::time::Duration;
|
||||||
|
|
||||||
|
use tokio::net::UdpSocket;
|
||||||
|
|
||||||
|
use super::candidate_relay_test::OptimisticAuthHandler;
|
||||||
|
use super::*;
|
||||||
|
use crate::agent::agent_config::AgentConfig;
|
||||||
|
use crate::agent::agent_vnet_test::{connect_with_vnet, on_connected};
|
||||||
|
use crate::agent::Agent;
|
||||||
|
use crate::url::{SchemeType, Url};
|
||||||
|
|
||||||
|
//use std::io::Write;
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn test_server_reflexive_only_connection() -> Result<()> {
|
||||||
|
/*env_logger::Builder::new()
|
||||||
|
.format(|buf, record| {
|
||||||
|
writeln!(
|
||||||
|
buf,
|
||||||
|
"{}:{} [{}] {} - {}",
|
||||||
|
record.file().unwrap_or("unknown"),
|
||||||
|
record.line().unwrap_or(0),
|
||||||
|
record.level(),
|
||||||
|
chrono::Local::now().format("%H:%M:%S.%6f"),
|
||||||
|
record.args()
|
||||||
|
)
|
||||||
|
})
|
||||||
|
.filter(None, log::LevelFilter::Trace)
|
||||||
|
.init();*/
|
||||||
|
|
||||||
|
let server_listener = Arc::new(UdpSocket::bind("127.0.0.1:0").await?);
|
||||||
|
let server_port = server_listener.local_addr()?.port();
|
||||||
|
|
||||||
|
let server = turn::server::Server::new(turn::server::config::ServerConfig {
|
||||||
|
realm: "webrtc.rs".to_owned(),
|
||||||
|
auth_handler: Arc::new(OptimisticAuthHandler {}),
|
||||||
|
conn_configs: vec![turn::server::config::ConnConfig {
|
||||||
|
conn: server_listener,
|
||||||
|
relay_addr_generator: Box::new(turn::relay::relay_none::RelayAddressGeneratorNone {
|
||||||
|
address: "127.0.0.1".to_owned(),
|
||||||
|
net: Arc::new(util::vnet::net::Net::new(None)),
|
||||||
|
}),
|
||||||
|
}],
|
||||||
|
channel_bind_timeout: Duration::from_secs(0),
|
||||||
|
alloc_close_notify: None,
|
||||||
|
})
|
||||||
|
.await?;
|
||||||
|
|
||||||
|
let cfg0 = AgentConfig {
|
||||||
|
network_types: vec![NetworkType::Udp4],
|
||||||
|
urls: vec![Url {
|
||||||
|
scheme: SchemeType::Stun,
|
||||||
|
host: "127.0.0.1".to_owned(),
|
||||||
|
port: server_port,
|
||||||
|
..Default::default()
|
||||||
|
}],
|
||||||
|
candidate_types: vec![CandidateType::ServerReflexive],
|
||||||
|
..Default::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
let a_agent = Arc::new(Agent::new(cfg0).await?);
|
||||||
|
let (a_notifier, mut a_connected) = on_connected();
|
||||||
|
a_agent.on_connection_state_change(a_notifier);
|
||||||
|
|
||||||
|
let cfg1 = AgentConfig {
|
||||||
|
network_types: vec![NetworkType::Udp4],
|
||||||
|
urls: vec![Url {
|
||||||
|
scheme: SchemeType::Stun,
|
||||||
|
host: "127.0.0.1".to_owned(),
|
||||||
|
port: server_port,
|
||||||
|
..Default::default()
|
||||||
|
}],
|
||||||
|
candidate_types: vec![CandidateType::ServerReflexive],
|
||||||
|
..Default::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
let b_agent = Arc::new(Agent::new(cfg1).await?);
|
||||||
|
let (b_notifier, mut b_connected) = on_connected();
|
||||||
|
b_agent.on_connection_state_change(b_notifier);
|
||||||
|
|
||||||
|
connect_with_vnet(&a_agent, &b_agent).await?;
|
||||||
|
|
||||||
|
let _ = a_connected.recv().await;
|
||||||
|
let _ = b_connected.recv().await;
|
||||||
|
|
||||||
|
a_agent.close().await?;
|
||||||
|
b_agent.close().await?;
|
||||||
|
server.close().await?;
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
+411
@@ -0,0 +1,411 @@
|
|||||||
|
use std::time::UNIX_EPOCH;
|
||||||
|
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_candidate_priority() -> Result<()> {
|
||||||
|
let tests = vec![
|
||||||
|
(
|
||||||
|
CandidateBase {
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
component: AtomicU16::new(COMPONENT_RTP),
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
2130706431,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
CandidateBase {
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
component: AtomicU16::new(COMPONENT_RTP),
|
||||||
|
network_type: AtomicU8::new(NetworkType::Tcp4 as u8),
|
||||||
|
tcp_type: TcpType::Active,
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
2128609279,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
CandidateBase {
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
component: AtomicU16::new(COMPONENT_RTP),
|
||||||
|
network_type: AtomicU8::new(NetworkType::Tcp4 as u8),
|
||||||
|
tcp_type: TcpType::Passive,
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
2124414975,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
CandidateBase {
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
component: AtomicU16::new(COMPONENT_RTP),
|
||||||
|
network_type: AtomicU8::new(NetworkType::Tcp4 as u8),
|
||||||
|
tcp_type: TcpType::SimultaneousOpen,
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
2120220671,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
CandidateBase {
|
||||||
|
candidate_type: CandidateType::PeerReflexive,
|
||||||
|
component: AtomicU16::new(COMPONENT_RTP),
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
1862270975,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
CandidateBase {
|
||||||
|
candidate_type: CandidateType::PeerReflexive,
|
||||||
|
component: AtomicU16::new(COMPONENT_RTP),
|
||||||
|
network_type: AtomicU8::new(NetworkType::Tcp6 as u8),
|
||||||
|
tcp_type: TcpType::SimultaneousOpen,
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
1860173823,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
CandidateBase {
|
||||||
|
candidate_type: CandidateType::PeerReflexive,
|
||||||
|
component: AtomicU16::new(COMPONENT_RTP),
|
||||||
|
network_type: AtomicU8::new(NetworkType::Tcp6 as u8),
|
||||||
|
tcp_type: TcpType::Active,
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
1855979519,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
CandidateBase {
|
||||||
|
candidate_type: CandidateType::PeerReflexive,
|
||||||
|
component: AtomicU16::new(COMPONENT_RTP),
|
||||||
|
network_type: AtomicU8::new(NetworkType::Tcp6 as u8),
|
||||||
|
tcp_type: TcpType::Passive,
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
1851785215,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
CandidateBase {
|
||||||
|
candidate_type: CandidateType::ServerReflexive,
|
||||||
|
component: AtomicU16::new(COMPONENT_RTP),
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
1694498815,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
CandidateBase {
|
||||||
|
candidate_type: CandidateType::Relay,
|
||||||
|
component: AtomicU16::new(COMPONENT_RTP),
|
||||||
|
..Default::default()
|
||||||
|
},
|
||||||
|
16777215,
|
||||||
|
),
|
||||||
|
];
|
||||||
|
|
||||||
|
for (candidate, want) in tests {
|
||||||
|
let got = candidate.priority();
|
||||||
|
assert_eq!(
|
||||||
|
got, want,
|
||||||
|
"Candidate({candidate}).Priority() = {got}, want {want}"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_candidate_last_sent() -> Result<()> {
|
||||||
|
let candidate = CandidateBase::default();
|
||||||
|
assert_eq!(candidate.last_sent(), UNIX_EPOCH);
|
||||||
|
|
||||||
|
let now = SystemTime::now();
|
||||||
|
let d = now.duration_since(UNIX_EPOCH)?;
|
||||||
|
candidate.set_last_sent(d);
|
||||||
|
assert_eq!(candidate.last_sent(), now);
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_candidate_last_received() -> Result<()> {
|
||||||
|
let candidate = CandidateBase::default();
|
||||||
|
assert_eq!(candidate.last_received(), UNIX_EPOCH);
|
||||||
|
|
||||||
|
let now = SystemTime::now();
|
||||||
|
let d = now.duration_since(UNIX_EPOCH)?;
|
||||||
|
candidate.set_last_received(d);
|
||||||
|
assert_eq!(candidate.last_received(), now);
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_candidate_foundation() -> Result<()> {
|
||||||
|
// All fields are the same
|
||||||
|
assert_eq!(
|
||||||
|
(CandidateBase {
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
network_type: AtomicU8::new(NetworkType::Udp4 as u8),
|
||||||
|
address: "A".to_owned(),
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.foundation(),
|
||||||
|
(CandidateBase {
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
network_type: AtomicU8::new(NetworkType::Udp4 as u8),
|
||||||
|
address: "A".to_owned(),
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.foundation()
|
||||||
|
);
|
||||||
|
|
||||||
|
// Different Address
|
||||||
|
assert_ne!(
|
||||||
|
(CandidateBase {
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
network_type: AtomicU8::new(NetworkType::Udp4 as u8),
|
||||||
|
address: "A".to_owned(),
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.foundation(),
|
||||||
|
(CandidateBase {
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
network_type: AtomicU8::new(NetworkType::Udp4 as u8),
|
||||||
|
address: "B".to_owned(),
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.foundation(),
|
||||||
|
);
|
||||||
|
|
||||||
|
// Different networkType
|
||||||
|
assert_ne!(
|
||||||
|
(CandidateBase {
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
network_type: AtomicU8::new(NetworkType::Udp4 as u8),
|
||||||
|
address: "A".to_owned(),
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.foundation(),
|
||||||
|
(CandidateBase {
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
network_type: AtomicU8::new(NetworkType::Udp6 as u8),
|
||||||
|
address: "A".to_owned(),
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.foundation(),
|
||||||
|
);
|
||||||
|
|
||||||
|
// Different candidateType
|
||||||
|
assert_ne!(
|
||||||
|
(CandidateBase {
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
network_type: AtomicU8::new(NetworkType::Udp4 as u8),
|
||||||
|
address: "A".to_owned(),
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.foundation(),
|
||||||
|
(CandidateBase {
|
||||||
|
candidate_type: CandidateType::PeerReflexive,
|
||||||
|
network_type: AtomicU8::new(NetworkType::Udp4 as u8),
|
||||||
|
address: "A".to_owned(),
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.foundation(),
|
||||||
|
);
|
||||||
|
|
||||||
|
// Port has no effect
|
||||||
|
assert_eq!(
|
||||||
|
(CandidateBase {
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
network_type: AtomicU8::new(NetworkType::Udp4 as u8),
|
||||||
|
address: "A".to_owned(),
|
||||||
|
port: 8080,
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.foundation(),
|
||||||
|
(CandidateBase {
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
network_type: AtomicU8::new(NetworkType::Udp4 as u8),
|
||||||
|
address: "A".to_owned(),
|
||||||
|
port: 80,
|
||||||
|
..Default::default()
|
||||||
|
})
|
||||||
|
.foundation()
|
||||||
|
);
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_candidate_pair_state_serialization() {
|
||||||
|
let tests = vec![
|
||||||
|
(CandidatePairState::Unspecified, "\"unspecified\""),
|
||||||
|
(CandidatePairState::Waiting, "\"waiting\""),
|
||||||
|
(CandidatePairState::InProgress, "\"in-progress\""),
|
||||||
|
(CandidatePairState::Failed, "\"failed\""),
|
||||||
|
(CandidatePairState::Succeeded, "\"succeeded\""),
|
||||||
|
];
|
||||||
|
|
||||||
|
for (candidate_pair_state, expected_string) in tests {
|
||||||
|
assert_eq!(
|
||||||
|
expected_string.to_string(),
|
||||||
|
serde_json::to_string(&candidate_pair_state).unwrap()
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_candidate_pair_state_to_string() {
|
||||||
|
let tests = vec![
|
||||||
|
(CandidatePairState::Unspecified, "unspecified"),
|
||||||
|
(CandidatePairState::Waiting, "waiting"),
|
||||||
|
(CandidatePairState::InProgress, "in-progress"),
|
||||||
|
(CandidatePairState::Failed, "failed"),
|
||||||
|
(CandidatePairState::Succeeded, "succeeded"),
|
||||||
|
];
|
||||||
|
|
||||||
|
for (candidate_pair_state, expected_string) in tests {
|
||||||
|
assert_eq!(candidate_pair_state.to_string(), expected_string);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_candidate_type_serialization() {
|
||||||
|
let tests = vec![
|
||||||
|
(CandidateType::Unspecified, "\"unspecified\""),
|
||||||
|
(CandidateType::Host, "\"host\""),
|
||||||
|
(CandidateType::ServerReflexive, "\"srflx\""),
|
||||||
|
(CandidateType::PeerReflexive, "\"prflx\""),
|
||||||
|
(CandidateType::Relay, "\"relay\""),
|
||||||
|
];
|
||||||
|
|
||||||
|
for (candidate_type, expected_string) in tests {
|
||||||
|
assert_eq!(
|
||||||
|
serde_json::to_string(&candidate_type).unwrap(),
|
||||||
|
expected_string.to_string()
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_candidate_type_to_string() {
|
||||||
|
let tests = vec![
|
||||||
|
(CandidateType::Unspecified, "Unknown candidate type"),
|
||||||
|
(CandidateType::Host, "host"),
|
||||||
|
(CandidateType::ServerReflexive, "srflx"),
|
||||||
|
(CandidateType::PeerReflexive, "prflx"),
|
||||||
|
(CandidateType::Relay, "relay"),
|
||||||
|
];
|
||||||
|
|
||||||
|
for (candidate_type, expected_string) in tests {
|
||||||
|
assert_eq!(candidate_type.to_string(), expected_string);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_candidate_marshal() -> Result<()> {
|
||||||
|
let tests = vec![
|
||||||
|
(
|
||||||
|
Some(CandidateBase{
|
||||||
|
network_type: AtomicU8::new(NetworkType::Udp6 as u8),
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
address: "fcd9:e3b8:12ce:9fc5:74a5:c6bb:d8b:e08a".to_owned(),
|
||||||
|
port: 53987,
|
||||||
|
priority_override: 500,
|
||||||
|
foundation_override: "750".to_owned(),
|
||||||
|
..Default::default()
|
||||||
|
}),
|
||||||
|
"750 1 udp 500 fcd9:e3b8:12ce:9fc5:74a5:c6bb:d8b:e08a 53987 typ host",
|
||||||
|
),
|
||||||
|
(
|
||||||
|
Some(CandidateBase{
|
||||||
|
network_type: AtomicU8::new(NetworkType::Udp4 as u8),
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
address: "10.0.75.1".to_owned(),
|
||||||
|
port: 53634,
|
||||||
|
..Default::default()
|
||||||
|
}),
|
||||||
|
"4273957277 1 udp 2130706431 10.0.75.1 53634 typ host",
|
||||||
|
),
|
||||||
|
(
|
||||||
|
Some(CandidateBase{
|
||||||
|
network_type: AtomicU8::new(NetworkType::Udp4 as u8),
|
||||||
|
candidate_type: CandidateType::ServerReflexive,
|
||||||
|
address: "191.228.238.68".to_owned(),
|
||||||
|
port: 53991,
|
||||||
|
related_address: Some(CandidateRelatedAddress{
|
||||||
|
address: "192.168.0.274".to_owned(),
|
||||||
|
port:53991
|
||||||
|
}),
|
||||||
|
..Default::default()
|
||||||
|
}),
|
||||||
|
"647372371 1 udp 1694498815 191.228.238.68 53991 typ srflx raddr 192.168.0.274 rport 53991",
|
||||||
|
),
|
||||||
|
(
|
||||||
|
Some(CandidateBase{
|
||||||
|
network_type: AtomicU8::new(NetworkType::Udp4 as u8),
|
||||||
|
candidate_type: CandidateType::Relay,
|
||||||
|
address: "50.0.0.1".to_owned(),
|
||||||
|
port: 5000,
|
||||||
|
related_address: Some(
|
||||||
|
CandidateRelatedAddress{
|
||||||
|
address: "192.168.0.1".to_owned(),
|
||||||
|
port:5001}
|
||||||
|
),
|
||||||
|
..Default::default()
|
||||||
|
}),
|
||||||
|
"848194626 1 udp 16777215 50.0.0.1 5000 typ relay raddr 192.168.0.1 rport 5001",
|
||||||
|
),
|
||||||
|
(
|
||||||
|
Some(CandidateBase{
|
||||||
|
network_type: AtomicU8::new(NetworkType::Tcp4 as u8),
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
address: "192.168.0.196".to_owned(),
|
||||||
|
port: 0,
|
||||||
|
tcp_type: TcpType::Active,
|
||||||
|
..Default::default()
|
||||||
|
}),
|
||||||
|
"1052353102 1 tcp 2128609279 192.168.0.196 0 typ host tcptype active",
|
||||||
|
),
|
||||||
|
(
|
||||||
|
Some(CandidateBase{
|
||||||
|
network_type: AtomicU8::new(NetworkType::Udp4 as u8),
|
||||||
|
candidate_type: CandidateType::Host,
|
||||||
|
address: "e2494022-4d9a-4c1e-a750-cc48d4f8d6ee.local".to_owned(),
|
||||||
|
port: 60542,
|
||||||
|
..Default::default()
|
||||||
|
}),
|
||||||
|
"1380287402 1 udp 2130706431 e2494022-4d9a-4c1e-a750-cc48d4f8d6ee.local 60542 typ host",
|
||||||
|
),
|
||||||
|
// Invalid candidates
|
||||||
|
(None, ""),
|
||||||
|
(None, "1938809241"),
|
||||||
|
(None, "1986380506 99999999 udp 2122063615 10.0.75.1 53634 typ host generation 0 network-id 2"),
|
||||||
|
(None, "1986380506 1 udp 99999999999 10.0.75.1 53634 typ host"),
|
||||||
|
(None, "4207374051 1 udp 1685790463 191.228.238.68 99999999 typ srflx raddr 192.168.0.278 rport 53991 generation 0 network-id 3"),
|
||||||
|
(None, "4207374051 1 udp 1685790463 191.228.238.68 53991 typ srflx raddr"),
|
||||||
|
(None, "4207374051 1 udp 1685790463 191.228.238.68 53991 typ srflx raddr 192.168.0.278 rport 99999999 generation 0 network-id 3"),
|
||||||
|
(None, "4207374051 INVALID udp 2130706431 10.0.75.1 53634 typ host"),
|
||||||
|
(None, "4207374051 1 udp INVALID 10.0.75.1 53634 typ host"),
|
||||||
|
(None, "4207374051 INVALID udp 2130706431 10.0.75.1 INVALID typ host"),
|
||||||
|
(None, "4207374051 1 udp 2130706431 10.0.75.1 53634 typ INVALID"),
|
||||||
|
];
|
||||||
|
|
||||||
|
for (candidate, marshaled) in tests {
|
||||||
|
let actual_candidate = unmarshal_candidate(marshaled);
|
||||||
|
if let Some(candidate) = candidate {
|
||||||
|
if let Ok(actual_candidate) = actual_candidate {
|
||||||
|
assert!(
|
||||||
|
candidate.equal(&actual_candidate),
|
||||||
|
"{} vs {}",
|
||||||
|
candidate.marshal(),
|
||||||
|
marshaled
|
||||||
|
);
|
||||||
|
assert_eq!(marshaled, actual_candidate.marshal());
|
||||||
|
} else {
|
||||||
|
panic!("expected ok");
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
assert!(actual_candidate.is_err(), "expected error");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
+324
@@ -0,0 +1,324 @@
|
|||||||
|
#[cfg(test)]
|
||||||
|
mod candidate_pair_test;
|
||||||
|
#[cfg(test)]
|
||||||
|
mod candidate_relay_test;
|
||||||
|
#[cfg(test)]
|
||||||
|
mod candidate_server_reflexive_test;
|
||||||
|
#[cfg(test)]
|
||||||
|
mod candidate_test;
|
||||||
|
|
||||||
|
pub mod candidate_base;
|
||||||
|
pub mod candidate_host;
|
||||||
|
pub mod candidate_peer_reflexive;
|
||||||
|
pub mod candidate_relay;
|
||||||
|
pub mod candidate_server_reflexive;
|
||||||
|
|
||||||
|
use std::fmt;
|
||||||
|
use std::net::{IpAddr, SocketAddr};
|
||||||
|
use std::sync::atomic::{AtomicBool, AtomicU16, AtomicU8, Ordering};
|
||||||
|
use std::sync::Arc;
|
||||||
|
use std::time::SystemTime;
|
||||||
|
|
||||||
|
use async_trait::async_trait;
|
||||||
|
use candidate_base::*;
|
||||||
|
use serde::Serialize;
|
||||||
|
use tokio::sync::{broadcast, Mutex};
|
||||||
|
|
||||||
|
use crate::error::Result;
|
||||||
|
use crate::network_type::*;
|
||||||
|
use crate::tcp_type::*;
|
||||||
|
|
||||||
|
pub(crate) const RECEIVE_MTU: usize = 8192;
|
||||||
|
pub(crate) const DEFAULT_LOCAL_PREFERENCE: u16 = 65535;
|
||||||
|
|
||||||
|
/// Indicates that the candidate is used for RTP.
|
||||||
|
pub(crate) const COMPONENT_RTP: u16 = 1;
|
||||||
|
/// Indicates that the candidate is used for RTCP.
|
||||||
|
pub(crate) const COMPONENT_RTCP: u16 = 0;
|
||||||
|
|
||||||
|
/// Candidate represents an ICE candidate
|
||||||
|
#[async_trait]
|
||||||
|
pub trait Candidate: fmt::Display {
|
||||||
|
/// An arbitrary string used in the freezing algorithm to
|
||||||
|
/// group similar candidates. It is the same for two candidates that
|
||||||
|
/// have the same type, base IP address, protocol (UDP, TCP, etc.),
|
||||||
|
/// and STUN or TURN server.
|
||||||
|
fn foundation(&self) -> String;
|
||||||
|
|
||||||
|
/// A unique identifier for just this candidate
|
||||||
|
/// Unlike the foundation this is different for each candidate.
|
||||||
|
fn id(&self) -> String;
|
||||||
|
|
||||||
|
/// A component is a piece of a data stream.
|
||||||
|
/// An example is one for RTP, and one for RTCP
|
||||||
|
fn component(&self) -> u16;
|
||||||
|
fn set_component(&self, c: u16);
|
||||||
|
|
||||||
|
/// The last time this candidate received traffic
|
||||||
|
fn last_received(&self) -> SystemTime;
|
||||||
|
|
||||||
|
/// The last time this candidate sent traffic
|
||||||
|
fn last_sent(&self) -> SystemTime;
|
||||||
|
|
||||||
|
fn network_type(&self) -> NetworkType;
|
||||||
|
fn address(&self) -> String;
|
||||||
|
fn port(&self) -> u16;
|
||||||
|
|
||||||
|
fn priority(&self) -> u32;
|
||||||
|
|
||||||
|
/// A transport address related to candidate,
|
||||||
|
/// which is useful for diagnostics and other purposes.
|
||||||
|
fn related_address(&self) -> Option<CandidateRelatedAddress>;
|
||||||
|
|
||||||
|
fn candidate_type(&self) -> CandidateType;
|
||||||
|
fn tcp_type(&self) -> TcpType;
|
||||||
|
|
||||||
|
fn marshal(&self) -> String;
|
||||||
|
|
||||||
|
fn addr(&self) -> SocketAddr;
|
||||||
|
|
||||||
|
async fn close(&self) -> Result<()>;
|
||||||
|
fn seen(&self, outbound: bool);
|
||||||
|
|
||||||
|
async fn write_to(&self, raw: &[u8], dst: &(dyn Candidate + Send + Sync)) -> Result<usize>;
|
||||||
|
fn equal(&self, other: &dyn Candidate) -> bool;
|
||||||
|
fn set_ip(&self, ip: &IpAddr) -> Result<()>;
|
||||||
|
fn get_conn(&self) -> Option<&Arc<dyn util::Conn + Send + Sync>>;
|
||||||
|
fn get_closed_ch(&self) -> Arc<Mutex<Option<broadcast::Sender<()>>>>;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Represents the type of candidate `CandidateType` enum.
|
||||||
|
#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize)]
|
||||||
|
pub enum CandidateType {
|
||||||
|
#[serde(rename = "unspecified")]
|
||||||
|
Unspecified,
|
||||||
|
#[serde(rename = "host")]
|
||||||
|
Host,
|
||||||
|
#[serde(rename = "srflx")]
|
||||||
|
ServerReflexive,
|
||||||
|
#[serde(rename = "prflx")]
|
||||||
|
PeerReflexive,
|
||||||
|
#[serde(rename = "relay")]
|
||||||
|
Relay,
|
||||||
|
}
|
||||||
|
|
||||||
|
// String makes CandidateType printable
|
||||||
|
impl fmt::Display for CandidateType {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||||
|
let s = match *self {
|
||||||
|
CandidateType::Host => "host",
|
||||||
|
CandidateType::ServerReflexive => "srflx",
|
||||||
|
CandidateType::PeerReflexive => "prflx",
|
||||||
|
CandidateType::Relay => "relay",
|
||||||
|
CandidateType::Unspecified => "Unknown candidate type",
|
||||||
|
};
|
||||||
|
write!(f, "{s}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for CandidateType {
|
||||||
|
fn default() -> Self {
|
||||||
|
Self::Unspecified
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl CandidateType {
|
||||||
|
/// Returns the preference weight of a `CandidateType`.
|
||||||
|
///
|
||||||
|
/// 4.1.2.2. Guidelines for Choosing Type and Local Preferences
|
||||||
|
/// The RECOMMENDED values are 126 for host candidates, 100
|
||||||
|
/// for server reflexive candidates, 110 for peer reflexive candidates,
|
||||||
|
/// and 0 for relayed candidates.
|
||||||
|
#[must_use]
|
||||||
|
pub const fn preference(self) -> u16 {
|
||||||
|
match self {
|
||||||
|
Self::Host => 126,
|
||||||
|
Self::PeerReflexive => 110,
|
||||||
|
Self::ServerReflexive => 100,
|
||||||
|
Self::Relay | CandidateType::Unspecified => 0,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) fn contains_candidate_type(
|
||||||
|
candidate_type: CandidateType,
|
||||||
|
candidate_type_list: &[CandidateType],
|
||||||
|
) -> bool {
|
||||||
|
if candidate_type_list.is_empty() {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
for ct in candidate_type_list {
|
||||||
|
if *ct == candidate_type {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
false
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Convey transport addresses related to the candidate, useful for diagnostics and other purposes.
|
||||||
|
#[derive(PartialEq, Eq, Debug, Clone)]
|
||||||
|
pub struct CandidateRelatedAddress {
|
||||||
|
pub address: String,
|
||||||
|
pub port: u16,
|
||||||
|
}
|
||||||
|
|
||||||
|
// String makes CandidateRelatedAddress printable
|
||||||
|
impl fmt::Display for CandidateRelatedAddress {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||||
|
write!(f, " related {}:{}", self.address, self.port)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Represent the ICE candidate pair state.
|
||||||
|
#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize)]
|
||||||
|
pub enum CandidatePairState {
|
||||||
|
#[serde(rename = "unspecified")]
|
||||||
|
Unspecified = 0,
|
||||||
|
|
||||||
|
/// Means a check has not been performed for this pair.
|
||||||
|
#[serde(rename = "waiting")]
|
||||||
|
Waiting = 1,
|
||||||
|
|
||||||
|
/// Means a check has been sent for this pair, but the transaction is in progress.
|
||||||
|
#[serde(rename = "in-progress")]
|
||||||
|
InProgress = 2,
|
||||||
|
|
||||||
|
/// Means a check for this pair was already done and failed, either never producing any response
|
||||||
|
/// or producing an unrecoverable failure response.
|
||||||
|
#[serde(rename = "failed")]
|
||||||
|
Failed = 3,
|
||||||
|
|
||||||
|
/// Means a check for this pair was already done and produced a successful result.
|
||||||
|
#[serde(rename = "succeeded")]
|
||||||
|
Succeeded = 4,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl From<u8> for CandidatePairState {
|
||||||
|
fn from(v: u8) -> Self {
|
||||||
|
match v {
|
||||||
|
1 => Self::Waiting,
|
||||||
|
2 => Self::InProgress,
|
||||||
|
3 => Self::Failed,
|
||||||
|
4 => Self::Succeeded,
|
||||||
|
_ => Self::Unspecified,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for CandidatePairState {
|
||||||
|
fn default() -> Self {
|
||||||
|
Self::Unspecified
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for CandidatePairState {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||||
|
let s = match *self {
|
||||||
|
Self::Waiting => "waiting",
|
||||||
|
Self::InProgress => "in-progress",
|
||||||
|
Self::Failed => "failed",
|
||||||
|
Self::Succeeded => "succeeded",
|
||||||
|
Self::Unspecified => "unspecified",
|
||||||
|
};
|
||||||
|
|
||||||
|
write!(f, "{s}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Represents a combination of a local and remote candidate.
|
||||||
|
pub struct CandidatePair {
|
||||||
|
pub(crate) ice_role_controlling: AtomicBool,
|
||||||
|
pub remote: Arc<dyn Candidate + Send + Sync>,
|
||||||
|
pub local: Arc<dyn Candidate + Send + Sync>,
|
||||||
|
pub(crate) binding_request_count: AtomicU16,
|
||||||
|
pub(crate) state: AtomicU8, // convert it to CandidatePairState,
|
||||||
|
pub(crate) nominated: AtomicBool,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for CandidatePair {
|
||||||
|
fn default() -> Self {
|
||||||
|
Self {
|
||||||
|
ice_role_controlling: AtomicBool::new(false),
|
||||||
|
remote: Arc::new(CandidateBase::default()),
|
||||||
|
local: Arc::new(CandidateBase::default()),
|
||||||
|
state: AtomicU8::new(CandidatePairState::Waiting as u8),
|
||||||
|
binding_request_count: AtomicU16::new(0),
|
||||||
|
nominated: AtomicBool::new(false),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Debug for CandidatePair {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||||
|
write!(
|
||||||
|
f,
|
||||||
|
"prio {} (local, prio {}) {} <-> {} (remote, prio {})",
|
||||||
|
self.priority(),
|
||||||
|
self.local.priority(),
|
||||||
|
self.local,
|
||||||
|
self.remote,
|
||||||
|
self.remote.priority()
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for CandidatePair {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||||
|
write!(
|
||||||
|
f,
|
||||||
|
"prio {} (local, prio {}) {} <-> {} (remote, prio {})",
|
||||||
|
self.priority(),
|
||||||
|
self.local.priority(),
|
||||||
|
self.local,
|
||||||
|
self.remote,
|
||||||
|
self.remote.priority()
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl PartialEq for CandidatePair {
|
||||||
|
fn eq(&self, other: &Self) -> bool {
|
||||||
|
self.local.equal(&*other.local) && self.remote.equal(&*other.remote)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl CandidatePair {
|
||||||
|
#[must_use]
|
||||||
|
pub fn new(
|
||||||
|
local: Arc<dyn Candidate + Send + Sync>,
|
||||||
|
remote: Arc<dyn Candidate + Send + Sync>,
|
||||||
|
controlling: bool,
|
||||||
|
) -> Self {
|
||||||
|
Self {
|
||||||
|
ice_role_controlling: AtomicBool::new(controlling),
|
||||||
|
remote,
|
||||||
|
local,
|
||||||
|
state: AtomicU8::new(CandidatePairState::Waiting as u8),
|
||||||
|
binding_request_count: AtomicU16::new(0),
|
||||||
|
nominated: AtomicBool::new(false),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// RFC 5245 - 5.7.2. Computing Pair Priority and Ordering Pairs
|
||||||
|
/// Let G be the priority for the candidate provided by the controlling
|
||||||
|
/// agent. Let D be the priority for the candidate provided by the
|
||||||
|
/// controlled agent.
|
||||||
|
/// pair priority = 2^32*MIN(G,D) + 2*MAX(G,D) + (G>D?1:0)
|
||||||
|
pub fn priority(&self) -> u64 {
|
||||||
|
let (g, d) = if self.ice_role_controlling.load(Ordering::SeqCst) {
|
||||||
|
(self.local.priority(), self.remote.priority())
|
||||||
|
} else {
|
||||||
|
(self.remote.priority(), self.local.priority())
|
||||||
|
};
|
||||||
|
|
||||||
|
// 1<<32 overflows uint32; and if both g && d are
|
||||||
|
// maxUint32, this result would overflow uint64
|
||||||
|
((1 << 32_u64) - 1) * u64::from(std::cmp::min(g, d))
|
||||||
|
+ 2 * u64::from(std::cmp::max(g, d))
|
||||||
|
+ u64::from(g > d)
|
||||||
|
}
|
||||||
|
|
||||||
|
pub async fn write(&self, b: &[u8]) -> Result<usize> {
|
||||||
|
self.local.write_to(b, &*self.remote).await
|
||||||
|
}
|
||||||
|
}
|
||||||
+168
@@ -0,0 +1,168 @@
|
|||||||
|
use super::*;
|
||||||
|
use crate::error::Result;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_controlled_get_from() -> Result<()> {
|
||||||
|
let mut m = Message::new();
|
||||||
|
let mut c = AttrControlled(4321);
|
||||||
|
let result = c.get_from(&m);
|
||||||
|
if let Err(err) = result {
|
||||||
|
assert_eq!(stun::Error::ErrAttributeNotFound, err, "unexpected error");
|
||||||
|
} else {
|
||||||
|
panic!("expected error, but got ok");
|
||||||
|
}
|
||||||
|
|
||||||
|
m.build(&[Box::new(BINDING_REQUEST), Box::new(c)])?;
|
||||||
|
|
||||||
|
let mut m1 = Message::new();
|
||||||
|
m1.write(&m.raw)?;
|
||||||
|
|
||||||
|
let mut c1 = AttrControlled::default();
|
||||||
|
c1.get_from(&m1)?;
|
||||||
|
|
||||||
|
assert_eq!(c1, c, "not equal");
|
||||||
|
|
||||||
|
//"IncorrectSize"
|
||||||
|
{
|
||||||
|
let mut m3 = Message::new();
|
||||||
|
m3.add(ATTR_ICE_CONTROLLED, &[0; 100]);
|
||||||
|
let mut c2 = AttrControlled::default();
|
||||||
|
let result = c2.get_from(&m3);
|
||||||
|
if let Err(err) = result {
|
||||||
|
assert!(is_attr_size_invalid(&err), "should error");
|
||||||
|
} else {
|
||||||
|
panic!("expected error, but got ok");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_controlling_get_from() -> Result<()> {
|
||||||
|
let mut m = Message::new();
|
||||||
|
let mut c = AttrControlling(4321);
|
||||||
|
let result = c.get_from(&m);
|
||||||
|
if let Err(err) = result {
|
||||||
|
assert_eq!(stun::Error::ErrAttributeNotFound, err, "unexpected error");
|
||||||
|
} else {
|
||||||
|
panic!("expected error, but got ok");
|
||||||
|
}
|
||||||
|
|
||||||
|
m.build(&[Box::new(BINDING_REQUEST), Box::new(c)])?;
|
||||||
|
|
||||||
|
let mut m1 = Message::new();
|
||||||
|
m1.write(&m.raw)?;
|
||||||
|
|
||||||
|
let mut c1 = AttrControlling::default();
|
||||||
|
c1.get_from(&m1)?;
|
||||||
|
|
||||||
|
assert_eq!(c1, c, "not equal");
|
||||||
|
|
||||||
|
//"IncorrectSize"
|
||||||
|
{
|
||||||
|
let mut m3 = Message::new();
|
||||||
|
m3.add(ATTR_ICE_CONTROLLING, &[0; 100]);
|
||||||
|
let mut c2 = AttrControlling::default();
|
||||||
|
let result = c2.get_from(&m3);
|
||||||
|
if let Err(err) = result {
|
||||||
|
assert!(is_attr_size_invalid(&err), "should error");
|
||||||
|
} else {
|
||||||
|
panic!("expected error, but got ok");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_control_get_from() -> Result<()> {
|
||||||
|
//"Blank"
|
||||||
|
{
|
||||||
|
let m = Message::new();
|
||||||
|
let mut c = AttrControl::default();
|
||||||
|
let result = c.get_from(&m);
|
||||||
|
if let Err(err) = result {
|
||||||
|
assert_eq!(stun::Error::ErrAttributeNotFound, err, "unexpected error");
|
||||||
|
} else {
|
||||||
|
panic!("expected error, but got ok");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
//"Controlling"
|
||||||
|
{
|
||||||
|
let mut m = Message::new();
|
||||||
|
let mut c = AttrControl::default();
|
||||||
|
let result = c.get_from(&m);
|
||||||
|
if let Err(err) = result {
|
||||||
|
assert_eq!(stun::Error::ErrAttributeNotFound, err, "unexpected error");
|
||||||
|
} else {
|
||||||
|
panic!("expected error, but got ok");
|
||||||
|
}
|
||||||
|
|
||||||
|
c.role = Role::Controlling;
|
||||||
|
c.tie_breaker = TieBreaker(4321);
|
||||||
|
|
||||||
|
m.build(&[Box::new(BINDING_REQUEST), Box::new(c)])?;
|
||||||
|
|
||||||
|
let mut m1 = Message::new();
|
||||||
|
m1.write(&m.raw)?;
|
||||||
|
|
||||||
|
let mut c1 = AttrControl::default();
|
||||||
|
c1.get_from(&m1)?;
|
||||||
|
|
||||||
|
assert_eq!(c1, c, "not equal");
|
||||||
|
|
||||||
|
//"IncorrectSize"
|
||||||
|
{
|
||||||
|
let mut m3 = Message::new();
|
||||||
|
m3.add(ATTR_ICE_CONTROLLING, &[0; 100]);
|
||||||
|
let mut c2 = AttrControl::default();
|
||||||
|
let result = c2.get_from(&m3);
|
||||||
|
if let Err(err) = result {
|
||||||
|
assert!(is_attr_size_invalid(&err), "should error");
|
||||||
|
} else {
|
||||||
|
panic!("expected error, but got ok");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
//"Controlled"
|
||||||
|
{
|
||||||
|
let mut m = Message::new();
|
||||||
|
let mut c = AttrControl::default();
|
||||||
|
let result = c.get_from(&m);
|
||||||
|
if let Err(err) = result {
|
||||||
|
assert_eq!(stun::Error::ErrAttributeNotFound, err, "unexpected error");
|
||||||
|
} else {
|
||||||
|
panic!("expected error, but got ok");
|
||||||
|
}
|
||||||
|
|
||||||
|
c.role = Role::Controlled;
|
||||||
|
c.tie_breaker = TieBreaker(1234);
|
||||||
|
|
||||||
|
m.build(&[Box::new(BINDING_REQUEST), Box::new(c)])?;
|
||||||
|
|
||||||
|
let mut m1 = Message::new();
|
||||||
|
m1.write(&m.raw)?;
|
||||||
|
|
||||||
|
let mut c1 = AttrControl::default();
|
||||||
|
c1.get_from(&m1)?;
|
||||||
|
|
||||||
|
assert_eq!(c1, c, "not equal");
|
||||||
|
|
||||||
|
//"IncorrectSize"
|
||||||
|
{
|
||||||
|
let mut m3 = Message::new();
|
||||||
|
m3.add(ATTR_ICE_CONTROLLING, &[0; 100]);
|
||||||
|
let mut c2 = AttrControl::default();
|
||||||
|
let result = c2.get_from(&m3);
|
||||||
|
if let Err(err) = result {
|
||||||
|
assert!(is_attr_size_invalid(&err), "should error");
|
||||||
|
} else {
|
||||||
|
panic!("expected error, but got ok");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
Vendored
+143
@@ -0,0 +1,143 @@
|
|||||||
|
#[cfg(test)]
|
||||||
|
mod control_test;
|
||||||
|
|
||||||
|
use std::fmt;
|
||||||
|
|
||||||
|
use stun::attributes::*;
|
||||||
|
use stun::checks::*;
|
||||||
|
use stun::message::*;
|
||||||
|
|
||||||
|
/// Common helper for ICE-{CONTROLLED,CONTROLLING} and represents the so-called Tiebreaker number.
|
||||||
|
#[derive(Default, PartialEq, Eq, Debug, Copy, Clone)]
|
||||||
|
pub struct TieBreaker(pub u64);
|
||||||
|
|
||||||
|
pub(crate) const TIE_BREAKER_SIZE: usize = 8; // 64 bit
|
||||||
|
|
||||||
|
impl TieBreaker {
|
||||||
|
/// Adds Tiebreaker value to m as t attribute.
|
||||||
|
pub fn add_to_as(self, m: &mut Message, t: AttrType) -> Result<(), stun::Error> {
|
||||||
|
let mut v = vec![0; TIE_BREAKER_SIZE];
|
||||||
|
v.copy_from_slice(&self.0.to_be_bytes());
|
||||||
|
m.add(t, &v);
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Decodes Tiebreaker value in message getting it as for t type.
|
||||||
|
pub fn get_from_as(&mut self, m: &Message, t: AttrType) -> Result<(), stun::Error> {
|
||||||
|
let v = m.get(t)?;
|
||||||
|
check_size(t, v.len(), TIE_BREAKER_SIZE)?;
|
||||||
|
self.0 = u64::from_be_bytes([v[0], v[1], v[2], v[3], v[4], v[5], v[6], v[7]]);
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/// Represents ICE-CONTROLLED attribute.
|
||||||
|
#[derive(Default, PartialEq, Eq, Debug, Copy, Clone)]
|
||||||
|
pub struct AttrControlled(pub u64);
|
||||||
|
|
||||||
|
impl Setter for AttrControlled {
|
||||||
|
/// Adds ICE-CONTROLLED to message.
|
||||||
|
fn add_to(&self, m: &mut Message) -> Result<(), stun::Error> {
|
||||||
|
TieBreaker(self.0).add_to_as(m, ATTR_ICE_CONTROLLED)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Getter for AttrControlled {
|
||||||
|
/// Decodes ICE-CONTROLLED from message.
|
||||||
|
fn get_from(&mut self, m: &Message) -> Result<(), stun::Error> {
|
||||||
|
let mut t = TieBreaker::default();
|
||||||
|
t.get_from_as(m, ATTR_ICE_CONTROLLED)?;
|
||||||
|
self.0 = t.0;
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Represents ICE-CONTROLLING attribute.
|
||||||
|
#[derive(Default, PartialEq, Eq, Debug, Copy, Clone)]
|
||||||
|
pub struct AttrControlling(pub u64);
|
||||||
|
|
||||||
|
impl Setter for AttrControlling {
|
||||||
|
// add_to adds ICE-CONTROLLING to message.
|
||||||
|
fn add_to(&self, m: &mut Message) -> Result<(), stun::Error> {
|
||||||
|
TieBreaker(self.0).add_to_as(m, ATTR_ICE_CONTROLLING)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Getter for AttrControlling {
|
||||||
|
// get_from decodes ICE-CONTROLLING from message.
|
||||||
|
fn get_from(&mut self, m: &Message) -> Result<(), stun::Error> {
|
||||||
|
let mut t = TieBreaker::default();
|
||||||
|
t.get_from_as(m, ATTR_ICE_CONTROLLING)?;
|
||||||
|
self.0 = t.0;
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Helper that wraps ICE-{CONTROLLED,CONTROLLING}.
|
||||||
|
#[derive(Default, PartialEq, Eq, Debug, Copy, Clone)]
|
||||||
|
pub struct AttrControl {
|
||||||
|
role: Role,
|
||||||
|
tie_breaker: TieBreaker,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Setter for AttrControl {
|
||||||
|
// add_to adds ICE-CONTROLLED or ICE-CONTROLLING attribute depending on Role.
|
||||||
|
fn add_to(&self, m: &mut Message) -> Result<(), stun::Error> {
|
||||||
|
if self.role == Role::Controlling {
|
||||||
|
self.tie_breaker.add_to_as(m, ATTR_ICE_CONTROLLING)
|
||||||
|
} else {
|
||||||
|
self.tie_breaker.add_to_as(m, ATTR_ICE_CONTROLLED)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Getter for AttrControl {
|
||||||
|
// get_from decodes Role and Tiebreaker value from message.
|
||||||
|
fn get_from(&mut self, m: &Message) -> Result<(), stun::Error> {
|
||||||
|
if m.contains(ATTR_ICE_CONTROLLING) {
|
||||||
|
self.role = Role::Controlling;
|
||||||
|
return self.tie_breaker.get_from_as(m, ATTR_ICE_CONTROLLING);
|
||||||
|
}
|
||||||
|
if m.contains(ATTR_ICE_CONTROLLED) {
|
||||||
|
self.role = Role::Controlled;
|
||||||
|
return self.tie_breaker.get_from_as(m, ATTR_ICE_CONTROLLED);
|
||||||
|
}
|
||||||
|
|
||||||
|
Err(stun::Error::ErrAttributeNotFound)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Represents ICE agent role, which can be controlling or controlled.
|
||||||
|
/// Possible ICE agent roles.
|
||||||
|
#[derive(PartialEq, Eq, Copy, Clone, Debug)]
|
||||||
|
pub enum Role {
|
||||||
|
Controlling,
|
||||||
|
Controlled,
|
||||||
|
Unspecified,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for Role {
|
||||||
|
fn default() -> Self {
|
||||||
|
Self::Controlling
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl From<&str> for Role {
|
||||||
|
fn from(raw: &str) -> Self {
|
||||||
|
match raw {
|
||||||
|
"controlling" => Self::Controlling,
|
||||||
|
"controlled" => Self::Controlled,
|
||||||
|
_ => Self::Unspecified,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for Role {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||||
|
let s = match *self {
|
||||||
|
Self::Controlling => "controlling",
|
||||||
|
Self::Controlled => "controlled",
|
||||||
|
Self::Unspecified => "unspecified",
|
||||||
|
};
|
||||||
|
write!(f, "{s}")
|
||||||
|
}
|
||||||
|
}
|
||||||
Vendored
+238
@@ -0,0 +1,238 @@
|
|||||||
|
use std::num::ParseIntError;
|
||||||
|
use std::time::SystemTimeError;
|
||||||
|
use std::{io, net};
|
||||||
|
|
||||||
|
use thiserror::Error;
|
||||||
|
|
||||||
|
pub type Result<T> = std::result::Result<T, Error>;
|
||||||
|
|
||||||
|
#[derive(Debug, Error, PartialEq)]
|
||||||
|
#[non_exhaustive]
|
||||||
|
pub enum Error {
|
||||||
|
/// Indicates an error with Unknown info.
|
||||||
|
#[error("Unknown type")]
|
||||||
|
ErrUnknownType,
|
||||||
|
|
||||||
|
/// Indicates the scheme type could not be parsed.
|
||||||
|
#[error("unknown scheme type")]
|
||||||
|
ErrSchemeType,
|
||||||
|
|
||||||
|
/// Indicates query arguments are provided in a STUN URL.
|
||||||
|
#[error("queries not supported in stun address")]
|
||||||
|
ErrStunQuery,
|
||||||
|
|
||||||
|
/// Indicates an malformed query is provided.
|
||||||
|
#[error("invalid query")]
|
||||||
|
ErrInvalidQuery,
|
||||||
|
|
||||||
|
/// Indicates malformed hostname is provided.
|
||||||
|
#[error("invalid hostname")]
|
||||||
|
ErrHost,
|
||||||
|
|
||||||
|
/// Indicates malformed port is provided.
|
||||||
|
#[error("invalid port number")]
|
||||||
|
ErrPort,
|
||||||
|
|
||||||
|
/// Indicates local username fragment insufficient bits are provided.
|
||||||
|
/// Have to be at least 24 bits long.
|
||||||
|
#[error("local username fragment is less than 24 bits long")]
|
||||||
|
ErrLocalUfragInsufficientBits,
|
||||||
|
|
||||||
|
/// Indicates local passoword insufficient bits are provided.
|
||||||
|
/// Have to be at least 128 bits long.
|
||||||
|
#[error("local password is less than 128 bits long")]
|
||||||
|
ErrLocalPwdInsufficientBits,
|
||||||
|
|
||||||
|
/// Indicates an unsupported transport type was provided.
|
||||||
|
#[error("invalid transport protocol type")]
|
||||||
|
ErrProtoType,
|
||||||
|
|
||||||
|
/// Indicates the agent is closed.
|
||||||
|
#[error("the agent is closed")]
|
||||||
|
ErrClosed,
|
||||||
|
|
||||||
|
/// Indicates agent does not have a valid candidate pair.
|
||||||
|
#[error("no candidate pairs available")]
|
||||||
|
ErrNoCandidatePairs,
|
||||||
|
|
||||||
|
/// Indicates agent connection was canceled by the caller.
|
||||||
|
#[error("connecting canceled by caller")]
|
||||||
|
ErrCanceledByCaller,
|
||||||
|
|
||||||
|
/// Indicates agent was started twice.
|
||||||
|
#[error("attempted to start agent twice")]
|
||||||
|
ErrMultipleStart,
|
||||||
|
|
||||||
|
/// Indicates agent was started with an empty remote ufrag.
|
||||||
|
#[error("remote ufrag is empty")]
|
||||||
|
ErrRemoteUfragEmpty,
|
||||||
|
|
||||||
|
/// Indicates agent was started with an empty remote pwd.
|
||||||
|
#[error("remote pwd is empty")]
|
||||||
|
ErrRemotePwdEmpty,
|
||||||
|
|
||||||
|
/// Indicates agent was started without on_candidate.
|
||||||
|
#[error("no on_candidate provided")]
|
||||||
|
ErrNoOnCandidateHandler,
|
||||||
|
|
||||||
|
/// Indicates GatherCandidates has been called multiple times.
|
||||||
|
#[error("attempting to gather candidates during gathering state")]
|
||||||
|
ErrMultipleGatherAttempted,
|
||||||
|
|
||||||
|
/// Indicates agent was give TURN URL with an empty Username.
|
||||||
|
#[error("username is empty")]
|
||||||
|
ErrUsernameEmpty,
|
||||||
|
|
||||||
|
/// Indicates agent was give TURN URL with an empty Password.
|
||||||
|
#[error("password is empty")]
|
||||||
|
ErrPasswordEmpty,
|
||||||
|
|
||||||
|
/// Indicates we were unable to parse a candidate address.
|
||||||
|
#[error("failed to parse address")]
|
||||||
|
ErrAddressParseFailed,
|
||||||
|
|
||||||
|
/// Indicates that non host candidates were selected for a lite agent.
|
||||||
|
#[error("lite agents must only use host candidates")]
|
||||||
|
ErrLiteUsingNonHostCandidates,
|
||||||
|
|
||||||
|
/// Indicates that one or more URL was provided to the agent but no host candidate required them.
|
||||||
|
#[error("agent does not need URL with selected candidate types")]
|
||||||
|
ErrUselessUrlsProvided,
|
||||||
|
|
||||||
|
/// Indicates that the specified NAT1To1IPCandidateType is unsupported.
|
||||||
|
#[error("unsupported 1:1 NAT IP candidate type")]
|
||||||
|
ErrUnsupportedNat1to1IpCandidateType,
|
||||||
|
|
||||||
|
/// Indicates that the given 1:1 NAT IP mapping is invalid.
|
||||||
|
#[error("invalid 1:1 NAT IP mapping")]
|
||||||
|
ErrInvalidNat1to1IpMapping,
|
||||||
|
|
||||||
|
/// IPNotFound in NAT1To1IPMapping.
|
||||||
|
#[error("external mapped IP not found")]
|
||||||
|
ErrExternalMappedIpNotFound,
|
||||||
|
|
||||||
|
/// Indicates that the mDNS gathering cannot be used along with 1:1 NAT IP mapping for host
|
||||||
|
/// candidate.
|
||||||
|
#[error("mDNS gathering cannot be used with 1:1 NAT IP mapping for host candidate")]
|
||||||
|
ErrMulticastDnsWithNat1to1IpMapping,
|
||||||
|
|
||||||
|
/// Indicates that 1:1 NAT IP mapping for host candidate is requested, but the host candidate
|
||||||
|
/// type is disabled.
|
||||||
|
#[error("1:1 NAT IP mapping for host candidate ineffective")]
|
||||||
|
ErrIneffectiveNat1to1IpMappingHost,
|
||||||
|
|
||||||
|
/// Indicates that 1:1 NAT IP mapping for srflx candidate is requested, but the srflx candidate
|
||||||
|
/// type is disabled.
|
||||||
|
#[error("1:1 NAT IP mapping for srflx candidate ineffective")]
|
||||||
|
ErrIneffectiveNat1to1IpMappingSrflx,
|
||||||
|
|
||||||
|
/// Indicates an invalid MulticastDNSHostName.
|
||||||
|
#[error("invalid mDNS HostName, must end with .local and can only contain a single '.'")]
|
||||||
|
ErrInvalidMulticastDnshostName,
|
||||||
|
|
||||||
|
/// Indicates Restart was called when Agent is in GatheringStateGathering.
|
||||||
|
#[error("ICE Agent can not be restarted when gathering")]
|
||||||
|
ErrRestartWhenGathering,
|
||||||
|
|
||||||
|
/// Indicates a run operation was canceled by its individual done.
|
||||||
|
#[error("run was canceled by done")]
|
||||||
|
ErrRunCanceled,
|
||||||
|
|
||||||
|
/// Initialized Indicates TCPMux is not initialized and that invalidTCPMux is used.
|
||||||
|
#[error("TCPMux is not initialized")]
|
||||||
|
ErrTcpMuxNotInitialized,
|
||||||
|
|
||||||
|
/// Indicates we already have the connection with same remote addr.
|
||||||
|
#[error("conn with same remote addr already exists")]
|
||||||
|
ErrTcpRemoteAddrAlreadyExists,
|
||||||
|
|
||||||
|
#[error("failed to send packet")]
|
||||||
|
ErrSendPacket,
|
||||||
|
#[error("attribute not long enough to be ICE candidate")]
|
||||||
|
ErrAttributeTooShortIceCandidate,
|
||||||
|
#[error("could not parse component")]
|
||||||
|
ErrParseComponent,
|
||||||
|
#[error("could not parse priority")]
|
||||||
|
ErrParsePriority,
|
||||||
|
#[error("could not parse port")]
|
||||||
|
ErrParsePort,
|
||||||
|
#[error("could not parse related addresses")]
|
||||||
|
ErrParseRelatedAddr,
|
||||||
|
#[error("could not parse type")]
|
||||||
|
ErrParseType,
|
||||||
|
#[error("unknown candidate type")]
|
||||||
|
ErrUnknownCandidateType,
|
||||||
|
#[error("failed to get XOR-MAPPED-ADDRESS response")]
|
||||||
|
ErrGetXorMappedAddrResponse,
|
||||||
|
#[error("connection with same remote address already exists")]
|
||||||
|
ErrConnectionAddrAlreadyExist,
|
||||||
|
#[error("error reading streaming packet")]
|
||||||
|
ErrReadingStreamingPacket,
|
||||||
|
#[error("error writing to")]
|
||||||
|
ErrWriting,
|
||||||
|
#[error("error closing connection")]
|
||||||
|
ErrClosingConnection,
|
||||||
|
#[error("unable to determine networkType")]
|
||||||
|
ErrDetermineNetworkType,
|
||||||
|
#[error("missing protocol scheme")]
|
||||||
|
ErrMissingProtocolScheme,
|
||||||
|
#[error("too many colons in address")]
|
||||||
|
ErrTooManyColonsAddr,
|
||||||
|
#[error("unexpected error trying to read")]
|
||||||
|
ErrRead,
|
||||||
|
#[error("unknown role")]
|
||||||
|
ErrUnknownRole,
|
||||||
|
#[error("username mismatch")]
|
||||||
|
ErrMismatchUsername,
|
||||||
|
#[error("the ICE conn can't write STUN messages")]
|
||||||
|
ErrIceWriteStunMessage,
|
||||||
|
#[error("invalid url")]
|
||||||
|
ErrInvalidUrl,
|
||||||
|
#[error("relative URL without a base")]
|
||||||
|
ErrUrlParse,
|
||||||
|
#[error("Candidate IP could not be found")]
|
||||||
|
ErrCandidateIpNotFound,
|
||||||
|
|
||||||
|
#[error("parse int: {0}")]
|
||||||
|
ParseInt(#[from] ParseIntError),
|
||||||
|
#[error("parse addr: {0}")]
|
||||||
|
ParseIp(#[from] net::AddrParseError),
|
||||||
|
#[error("{0}")]
|
||||||
|
Io(#[source] IoError),
|
||||||
|
#[error("{0}")]
|
||||||
|
Util(#[from] util::Error),
|
||||||
|
#[error("{0}")]
|
||||||
|
Stun(#[from] stun::Error),
|
||||||
|
#[error("{0}")]
|
||||||
|
ParseUrl(#[from] url::ParseError),
|
||||||
|
#[error("{0}")]
|
||||||
|
Mdns(#[from] mdns::Error),
|
||||||
|
#[error("{0}")]
|
||||||
|
Turn(#[from] turn::Error),
|
||||||
|
|
||||||
|
#[error("{0}")]
|
||||||
|
Other(String),
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Debug, Error)]
|
||||||
|
#[error("io error: {0}")]
|
||||||
|
pub struct IoError(#[from] pub io::Error);
|
||||||
|
|
||||||
|
// Workaround for wanting PartialEq for io::Error.
|
||||||
|
impl PartialEq for IoError {
|
||||||
|
fn eq(&self, other: &Self) -> bool {
|
||||||
|
self.0.kind() == other.0.kind()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl From<io::Error> for Error {
|
||||||
|
fn from(e: io::Error) -> Self {
|
||||||
|
Error::Io(IoError(e))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl From<SystemTimeError> for Error {
|
||||||
|
fn from(e: SystemTimeError) -> Self {
|
||||||
|
Error::Other(e.to_string())
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,251 @@
|
|||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_external_ip_mapper_validate_ip_string() -> Result<()> {
|
||||||
|
let ip = validate_ip_string("1.2.3.4")?;
|
||||||
|
assert!(ip.is_ipv4(), "should be true");
|
||||||
|
assert_eq!("1.2.3.4", ip.to_string(), "should be true");
|
||||||
|
|
||||||
|
let ip = validate_ip_string("2601:4567::5678")?;
|
||||||
|
assert!(!ip.is_ipv4(), "should be false");
|
||||||
|
assert_eq!("2601:4567::5678", ip.to_string(), "should be true");
|
||||||
|
|
||||||
|
let result = validate_ip_string("bad.6.6.6");
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_external_ip_mapper_new_external_ip_mapper() -> Result<()> {
|
||||||
|
// ips being empty should succeed but mapper will still be nil
|
||||||
|
let m = ExternalIpMapper::new(CandidateType::Unspecified, &[])?;
|
||||||
|
assert!(m.is_none(), "should be none");
|
||||||
|
|
||||||
|
// IPv4 with no explicit local IP, defaults to CandidateTypeHost
|
||||||
|
let m = ExternalIpMapper::new(CandidateType::Unspecified, &["1.2.3.4".to_owned()])?.unwrap();
|
||||||
|
assert_eq!(m.candidate_type, CandidateType::Host, "should match");
|
||||||
|
assert!(m.ipv4_mapping.ip_sole.is_some());
|
||||||
|
assert!(m.ipv6_mapping.ip_sole.is_none());
|
||||||
|
assert_eq!(m.ipv4_mapping.ip_map.len(), 0, "should match");
|
||||||
|
assert_eq!(m.ipv6_mapping.ip_map.len(), 0, "should match");
|
||||||
|
|
||||||
|
// IPv4 with no explicit local IP, using CandidateTypeServerReflexive
|
||||||
|
let m =
|
||||||
|
ExternalIpMapper::new(CandidateType::ServerReflexive, &["1.2.3.4".to_owned()])?.unwrap();
|
||||||
|
assert_eq!(
|
||||||
|
CandidateType::ServerReflexive,
|
||||||
|
m.candidate_type,
|
||||||
|
"should match"
|
||||||
|
);
|
||||||
|
assert!(m.ipv4_mapping.ip_sole.is_some());
|
||||||
|
assert!(m.ipv6_mapping.ip_sole.is_none());
|
||||||
|
assert_eq!(m.ipv4_mapping.ip_map.len(), 0, "should match");
|
||||||
|
assert_eq!(m.ipv6_mapping.ip_map.len(), 0, "should match");
|
||||||
|
|
||||||
|
// IPv4 with no explicit local IP, defaults to CandidateTypeHost
|
||||||
|
let m = ExternalIpMapper::new(CandidateType::Unspecified, &["2601:4567::5678".to_owned()])?
|
||||||
|
.unwrap();
|
||||||
|
assert_eq!(m.candidate_type, CandidateType::Host, "should match");
|
||||||
|
assert!(m.ipv4_mapping.ip_sole.is_none());
|
||||||
|
assert!(m.ipv6_mapping.ip_sole.is_some());
|
||||||
|
assert_eq!(m.ipv4_mapping.ip_map.len(), 0, "should match");
|
||||||
|
assert_eq!(m.ipv6_mapping.ip_map.len(), 0, "should match");
|
||||||
|
|
||||||
|
// IPv4 and IPv6 in the mix
|
||||||
|
let m = ExternalIpMapper::new(
|
||||||
|
CandidateType::Unspecified,
|
||||||
|
&["1.2.3.4".to_owned(), "2601:4567::5678".to_owned()],
|
||||||
|
)?
|
||||||
|
.unwrap();
|
||||||
|
assert_eq!(m.candidate_type, CandidateType::Host, "should match");
|
||||||
|
assert!(m.ipv4_mapping.ip_sole.is_some());
|
||||||
|
assert!(m.ipv6_mapping.ip_sole.is_some());
|
||||||
|
assert_eq!(m.ipv4_mapping.ip_map.len(), 0, "should match");
|
||||||
|
assert_eq!(m.ipv6_mapping.ip_map.len(), 0, "should match");
|
||||||
|
|
||||||
|
// Unsupported candidate type - CandidateTypePeerReflexive
|
||||||
|
let result = ExternalIpMapper::new(CandidateType::PeerReflexive, &["1.2.3.4".to_owned()]);
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
// Unsupported candidate type - CandidateTypeRelay
|
||||||
|
let result = ExternalIpMapper::new(CandidateType::PeerReflexive, &["1.2.3.4".to_owned()]);
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
// Cannot duplicate mapping IPv4 family
|
||||||
|
let result = ExternalIpMapper::new(
|
||||||
|
CandidateType::ServerReflexive,
|
||||||
|
&["1.2.3.4".to_owned(), "5.6.7.8".to_owned()],
|
||||||
|
);
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
// Cannot duplicate mapping IPv6 family
|
||||||
|
let result = ExternalIpMapper::new(
|
||||||
|
CandidateType::ServerReflexive,
|
||||||
|
&["2201::1".to_owned(), "2201::0002".to_owned()],
|
||||||
|
);
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
// Invalid external IP string
|
||||||
|
let result = ExternalIpMapper::new(CandidateType::ServerReflexive, &["bad.2.3.4".to_owned()]);
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
// Invalid local IP string
|
||||||
|
let result = ExternalIpMapper::new(
|
||||||
|
CandidateType::ServerReflexive,
|
||||||
|
&["1.2.3.4/10.0.0.bad".to_owned()],
|
||||||
|
);
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_external_ip_mapper_new_external_ip_mapper_with_explicit_local_ip() -> Result<()> {
|
||||||
|
// IPv4 with explicit local IP, defaults to CandidateTypeHost
|
||||||
|
let m = ExternalIpMapper::new(CandidateType::Unspecified, &["1.2.3.4/10.0.0.1".to_owned()])?
|
||||||
|
.unwrap();
|
||||||
|
assert_eq!(m.candidate_type, CandidateType::Host, "should match");
|
||||||
|
assert!(m.ipv4_mapping.ip_sole.is_none());
|
||||||
|
assert!(m.ipv6_mapping.ip_sole.is_none());
|
||||||
|
assert_eq!(m.ipv4_mapping.ip_map.len(), 1, "should match");
|
||||||
|
assert_eq!(m.ipv6_mapping.ip_map.len(), 0, "should match");
|
||||||
|
|
||||||
|
// Cannot assign two ext IPs for one local IPv4
|
||||||
|
let result = ExternalIpMapper::new(
|
||||||
|
CandidateType::Unspecified,
|
||||||
|
&["1.2.3.4/10.0.0.1".to_owned(), "1.2.3.5/10.0.0.1".to_owned()],
|
||||||
|
);
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
// Cannot assign two ext IPs for one local IPv6
|
||||||
|
let result = ExternalIpMapper::new(
|
||||||
|
CandidateType::Unspecified,
|
||||||
|
&[
|
||||||
|
"2200::1/fe80::1".to_owned(),
|
||||||
|
"2200::0002/fe80::1".to_owned(),
|
||||||
|
],
|
||||||
|
);
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
// Cannot mix different IP family in a pair (1)
|
||||||
|
let result =
|
||||||
|
ExternalIpMapper::new(CandidateType::Unspecified, &["2200::1/10.0.0.1".to_owned()]);
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
// Cannot mix different IP family in a pair (2)
|
||||||
|
let result = ExternalIpMapper::new(CandidateType::Unspecified, &["1.2.3.4/fe80::1".to_owned()]);
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
// Invalid pair
|
||||||
|
let result = ExternalIpMapper::new(
|
||||||
|
CandidateType::Unspecified,
|
||||||
|
&["1.2.3.4/192.168.0.2/10.0.0.1".to_owned()],
|
||||||
|
);
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_external_ip_mapper_new_external_ip_mapper_with_implicit_local_ip() -> Result<()> {
|
||||||
|
// Mixing inpicit and explicit local IPs not allowed
|
||||||
|
let result = ExternalIpMapper::new(
|
||||||
|
CandidateType::Unspecified,
|
||||||
|
&["1.2.3.4".to_owned(), "1.2.3.5/10.0.0.1".to_owned()],
|
||||||
|
);
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
// Mixing inpicit and explicit local IPs not allowed
|
||||||
|
let result = ExternalIpMapper::new(
|
||||||
|
CandidateType::Unspecified,
|
||||||
|
&["1.2.3.5/10.0.0.1".to_owned(), "1.2.3.4".to_owned()],
|
||||||
|
);
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_external_ip_mapper_find_external_ip_without_explicit_local_ip() -> Result<()> {
|
||||||
|
// IPv4 with explicit local IP, defaults to CandidateTypeHost
|
||||||
|
let m = ExternalIpMapper::new(
|
||||||
|
CandidateType::Unspecified,
|
||||||
|
&["1.2.3.4".to_owned(), "2200::1".to_owned()],
|
||||||
|
)?
|
||||||
|
.unwrap();
|
||||||
|
assert!(m.ipv4_mapping.ip_sole.is_some());
|
||||||
|
assert!(m.ipv6_mapping.ip_sole.is_some());
|
||||||
|
|
||||||
|
// find external IPv4
|
||||||
|
let ext_ip = m.find_external_ip("10.0.0.1")?;
|
||||||
|
assert_eq!(ext_ip.to_string(), "1.2.3.4", "should match");
|
||||||
|
|
||||||
|
// find external IPv6
|
||||||
|
let ext_ip = m.find_external_ip("fe80::0001")?; // use '0001' instead of '1' on purpose
|
||||||
|
assert_eq!(ext_ip.to_string(), "2200::1", "should match");
|
||||||
|
|
||||||
|
// Bad local IP string
|
||||||
|
let result = m.find_external_ip("really.bad");
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_external_ip_mapper_find_external_ip_with_explicit_local_ip() -> Result<()> {
|
||||||
|
// IPv4 with explicit local IP, defaults to CandidateTypeHost
|
||||||
|
let m = ExternalIpMapper::new(
|
||||||
|
CandidateType::Unspecified,
|
||||||
|
&[
|
||||||
|
"1.2.3.4/10.0.0.1".to_owned(),
|
||||||
|
"1.2.3.5/10.0.0.2".to_owned(),
|
||||||
|
"2200::1/fe80::1".to_owned(),
|
||||||
|
"2200::2/fe80::2".to_owned(),
|
||||||
|
],
|
||||||
|
)?
|
||||||
|
.unwrap();
|
||||||
|
|
||||||
|
// find external IPv4
|
||||||
|
let ext_ip = m.find_external_ip("10.0.0.1")?;
|
||||||
|
assert_eq!(ext_ip.to_string(), "1.2.3.4", "should match");
|
||||||
|
|
||||||
|
let ext_ip = m.find_external_ip("10.0.0.2")?;
|
||||||
|
assert_eq!(ext_ip.to_string(), "1.2.3.5", "should match");
|
||||||
|
|
||||||
|
let result = m.find_external_ip("10.0.0.3");
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
// find external IPv6
|
||||||
|
let ext_ip = m.find_external_ip("fe80::0001")?; // use '0001' instead of '1' on purpose
|
||||||
|
assert_eq!(ext_ip.to_string(), "2200::1", "should match");
|
||||||
|
|
||||||
|
let ext_ip = m.find_external_ip("fe80::0002")?; // use '0002' instead of '2' on purpose
|
||||||
|
assert_eq!(ext_ip.to_string(), "2200::2", "should match");
|
||||||
|
|
||||||
|
let result = m.find_external_ip("fe80::3");
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
// Bad local IP string
|
||||||
|
let result = m.find_external_ip("really.bad");
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_external_ip_mapper_find_external_ip_with_empty_map() -> Result<()> {
|
||||||
|
let m = ExternalIpMapper::new(CandidateType::Unspecified, &["1.2.3.4".to_owned()])?.unwrap();
|
||||||
|
|
||||||
|
// attempt to find IPv6 that does not exist in the map
|
||||||
|
let result = m.find_external_ip("fe80::1");
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
let m = ExternalIpMapper::new(CandidateType::Unspecified, &["2200::1".to_owned()])?.unwrap();
|
||||||
|
|
||||||
|
// attempt to find IPv4 that does not exist in the map
|
||||||
|
let result = m.find_external_ip("10.0.0.1");
|
||||||
|
assert!(result.is_err(), "should fail");
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
+133
@@ -0,0 +1,133 @@
|
|||||||
|
#[cfg(test)]
|
||||||
|
mod external_ip_mapper_test;
|
||||||
|
|
||||||
|
use std::collections::HashMap;
|
||||||
|
use std::net::IpAddr;
|
||||||
|
|
||||||
|
use crate::candidate::*;
|
||||||
|
use crate::error::*;
|
||||||
|
|
||||||
|
pub(crate) fn validate_ip_string(ip_str: &str) -> Result<IpAddr> {
|
||||||
|
match ip_str.parse() {
|
||||||
|
Ok(ip) => Ok(ip),
|
||||||
|
Err(_) => Err(Error::ErrInvalidNat1to1IpMapping),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Holds the mapping of local and external IP address for a particular IP family.
|
||||||
|
#[derive(Default, PartialEq, Debug)]
|
||||||
|
pub(crate) struct IpMapping {
|
||||||
|
ip_sole: Option<IpAddr>, // when non-nil, this is the sole external IP for one local IP assumed
|
||||||
|
ip_map: HashMap<String, IpAddr>, // local-to-external IP mapping (k: local, v: external)
|
||||||
|
}
|
||||||
|
|
||||||
|
impl IpMapping {
|
||||||
|
pub(crate) fn set_sole_ip(&mut self, ip: IpAddr) -> Result<()> {
|
||||||
|
if self.ip_sole.is_some() || !self.ip_map.is_empty() {
|
||||||
|
return Err(Error::ErrInvalidNat1to1IpMapping);
|
||||||
|
}
|
||||||
|
|
||||||
|
self.ip_sole = Some(ip);
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) fn add_ip_mapping(&mut self, loc_ip: IpAddr, ext_ip: IpAddr) -> Result<()> {
|
||||||
|
if self.ip_sole.is_some() {
|
||||||
|
return Err(Error::ErrInvalidNat1to1IpMapping);
|
||||||
|
}
|
||||||
|
|
||||||
|
let loc_ip_str = loc_ip.to_string();
|
||||||
|
|
||||||
|
// check if dup of local IP
|
||||||
|
if self.ip_map.contains_key(&loc_ip_str) {
|
||||||
|
return Err(Error::ErrInvalidNat1to1IpMapping);
|
||||||
|
}
|
||||||
|
|
||||||
|
self.ip_map.insert(loc_ip_str, ext_ip);
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) fn find_external_ip(&self, loc_ip: IpAddr) -> Result<IpAddr> {
|
||||||
|
if let Some(ip_sole) = &self.ip_sole {
|
||||||
|
return Ok(*ip_sole);
|
||||||
|
}
|
||||||
|
|
||||||
|
self.ip_map.get(&loc_ip.to_string()).map_or_else(
|
||||||
|
|| Err(Error::ErrExternalMappedIpNotFound),
|
||||||
|
|ext_ip| Ok(*ext_ip),
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Default)]
|
||||||
|
pub(crate) struct ExternalIpMapper {
|
||||||
|
pub(crate) ipv4_mapping: IpMapping,
|
||||||
|
pub(crate) ipv6_mapping: IpMapping,
|
||||||
|
pub(crate) candidate_type: CandidateType,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl ExternalIpMapper {
|
||||||
|
pub(crate) fn new(mut candidate_type: CandidateType, ips: &[String]) -> Result<Option<Self>> {
|
||||||
|
if ips.is_empty() {
|
||||||
|
return Ok(None);
|
||||||
|
}
|
||||||
|
if candidate_type == CandidateType::Unspecified {
|
||||||
|
candidate_type = CandidateType::Host; // defaults to host
|
||||||
|
} else if candidate_type != CandidateType::Host
|
||||||
|
&& candidate_type != CandidateType::ServerReflexive
|
||||||
|
{
|
||||||
|
return Err(Error::ErrUnsupportedNat1to1IpCandidateType);
|
||||||
|
}
|
||||||
|
|
||||||
|
let mut m = Self {
|
||||||
|
ipv4_mapping: IpMapping::default(),
|
||||||
|
ipv6_mapping: IpMapping::default(),
|
||||||
|
candidate_type,
|
||||||
|
};
|
||||||
|
|
||||||
|
for ext_ip_str in ips {
|
||||||
|
let ip_pair: Vec<&str> = ext_ip_str.split('/').collect();
|
||||||
|
if ip_pair.is_empty() || ip_pair.len() > 2 {
|
||||||
|
return Err(Error::ErrInvalidNat1to1IpMapping);
|
||||||
|
}
|
||||||
|
|
||||||
|
let ext_ip = validate_ip_string(ip_pair[0])?;
|
||||||
|
if ip_pair.len() == 1 {
|
||||||
|
if ext_ip.is_ipv4() {
|
||||||
|
m.ipv4_mapping.set_sole_ip(ext_ip)?;
|
||||||
|
} else {
|
||||||
|
m.ipv6_mapping.set_sole_ip(ext_ip)?;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
let loc_ip = validate_ip_string(ip_pair[1])?;
|
||||||
|
if ext_ip.is_ipv4() {
|
||||||
|
if !loc_ip.is_ipv4() {
|
||||||
|
return Err(Error::ErrInvalidNat1to1IpMapping);
|
||||||
|
}
|
||||||
|
|
||||||
|
m.ipv4_mapping.add_ip_mapping(loc_ip, ext_ip)?;
|
||||||
|
} else {
|
||||||
|
if loc_ip.is_ipv4() {
|
||||||
|
return Err(Error::ErrInvalidNat1to1IpMapping);
|
||||||
|
}
|
||||||
|
|
||||||
|
m.ipv6_mapping.add_ip_mapping(loc_ip, ext_ip)?;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(Some(m))
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) fn find_external_ip(&self, local_ip_str: &str) -> Result<IpAddr> {
|
||||||
|
let loc_ip = validate_ip_string(local_ip_str)?;
|
||||||
|
|
||||||
|
if loc_ip.is_ipv4() {
|
||||||
|
self.ipv4_mapping.find_external_ip(loc_ip)
|
||||||
|
} else {
|
||||||
|
self.ipv6_mapping.find_external_ip(loc_ip)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
Vendored
+22
@@ -0,0 +1,22 @@
|
|||||||
|
#![warn(rust_2018_idioms)]
|
||||||
|
#![allow(dead_code)]
|
||||||
|
|
||||||
|
pub mod agent;
|
||||||
|
pub mod candidate;
|
||||||
|
pub mod control;
|
||||||
|
mod error;
|
||||||
|
pub mod external_ip_mapper;
|
||||||
|
pub mod mdns;
|
||||||
|
pub mod network_type;
|
||||||
|
pub mod priority;
|
||||||
|
pub mod rand;
|
||||||
|
pub mod state;
|
||||||
|
pub mod stats;
|
||||||
|
pub mod tcp_type;
|
||||||
|
pub mod udp_mux;
|
||||||
|
pub mod udp_network;
|
||||||
|
pub mod url;
|
||||||
|
pub mod use_candidate;
|
||||||
|
pub mod util;
|
||||||
|
|
||||||
|
pub use error::Error;
|
||||||
+151
@@ -0,0 +1,151 @@
|
|||||||
|
use regex::Regex;
|
||||||
|
use tokio::sync::{mpsc, Mutex};
|
||||||
|
|
||||||
|
use super::*;
|
||||||
|
use crate::agent::agent_config::*;
|
||||||
|
use crate::agent::agent_vnet_test::*;
|
||||||
|
use crate::agent::*;
|
||||||
|
use crate::candidate::*;
|
||||||
|
use crate::error::Error;
|
||||||
|
use crate::network_type::*;
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
// This test is disabled on Windows for now because it gets stuck and never finishes.
|
||||||
|
// This does not seem to have happened due to a code change. It started happening with
|
||||||
|
// `ce55c3a066ab461c3e74f0d5ac6f1209205e79bc` but was verified as happening on
|
||||||
|
// `92cc698a3dc6da459f3bf3789fd046c2dffdf107` too.
|
||||||
|
#[cfg(not(windows))]
|
||||||
|
async fn test_multicast_dns_only_connection() -> Result<()> {
|
||||||
|
let cfg0 = AgentConfig {
|
||||||
|
network_types: vec![NetworkType::Udp4],
|
||||||
|
candidate_types: vec![CandidateType::Host],
|
||||||
|
multicast_dns_mode: MulticastDnsMode::QueryAndGather,
|
||||||
|
..Default::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
let a_agent = Arc::new(Agent::new(cfg0).await?);
|
||||||
|
let (a_notifier, mut a_connected) = on_connected();
|
||||||
|
a_agent.on_connection_state_change(a_notifier);
|
||||||
|
|
||||||
|
let cfg1 = AgentConfig {
|
||||||
|
network_types: vec![NetworkType::Udp4],
|
||||||
|
candidate_types: vec![CandidateType::Host],
|
||||||
|
multicast_dns_mode: MulticastDnsMode::QueryAndGather,
|
||||||
|
..Default::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
let b_agent = Arc::new(Agent::new(cfg1).await?);
|
||||||
|
let (b_notifier, mut b_connected) = on_connected();
|
||||||
|
b_agent.on_connection_state_change(b_notifier);
|
||||||
|
|
||||||
|
connect_with_vnet(&a_agent, &b_agent).await?;
|
||||||
|
let _ = a_connected.recv().await;
|
||||||
|
let _ = b_connected.recv().await;
|
||||||
|
|
||||||
|
a_agent.close().await?;
|
||||||
|
b_agent.close().await?;
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn test_multicast_dns_mixed_connection() -> Result<()> {
|
||||||
|
let cfg0 = AgentConfig {
|
||||||
|
network_types: vec![NetworkType::Udp4],
|
||||||
|
candidate_types: vec![CandidateType::Host],
|
||||||
|
multicast_dns_mode: MulticastDnsMode::QueryAndGather,
|
||||||
|
..Default::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
let a_agent = Arc::new(Agent::new(cfg0).await?);
|
||||||
|
let (a_notifier, mut a_connected) = on_connected();
|
||||||
|
a_agent.on_connection_state_change(a_notifier);
|
||||||
|
|
||||||
|
let cfg1 = AgentConfig {
|
||||||
|
network_types: vec![NetworkType::Udp4],
|
||||||
|
candidate_types: vec![CandidateType::Host],
|
||||||
|
multicast_dns_mode: MulticastDnsMode::QueryOnly,
|
||||||
|
..Default::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
let b_agent = Arc::new(Agent::new(cfg1).await?);
|
||||||
|
let (b_notifier, mut b_connected) = on_connected();
|
||||||
|
b_agent.on_connection_state_change(b_notifier);
|
||||||
|
|
||||||
|
connect_with_vnet(&a_agent, &b_agent).await?;
|
||||||
|
let _ = a_connected.recv().await;
|
||||||
|
let _ = b_connected.recv().await;
|
||||||
|
|
||||||
|
a_agent.close().await?;
|
||||||
|
b_agent.close().await?;
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn test_multicast_dns_static_host_name() -> Result<()> {
|
||||||
|
let cfg0 = AgentConfig {
|
||||||
|
network_types: vec![NetworkType::Udp4],
|
||||||
|
candidate_types: vec![CandidateType::Host],
|
||||||
|
multicast_dns_mode: MulticastDnsMode::QueryAndGather,
|
||||||
|
multicast_dns_host_name: "invalidHostName".to_owned(),
|
||||||
|
..Default::default()
|
||||||
|
};
|
||||||
|
if let Err(err) = Agent::new(cfg0).await {
|
||||||
|
assert_eq!(err, Error::ErrInvalidMulticastDnshostName);
|
||||||
|
} else {
|
||||||
|
panic!("expected error, but got ok");
|
||||||
|
}
|
||||||
|
|
||||||
|
let cfg1 = AgentConfig {
|
||||||
|
network_types: vec![NetworkType::Udp4],
|
||||||
|
candidate_types: vec![CandidateType::Host],
|
||||||
|
multicast_dns_mode: MulticastDnsMode::QueryAndGather,
|
||||||
|
multicast_dns_host_name: "validName.local".to_owned(),
|
||||||
|
..Default::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
let a = Agent::new(cfg1).await?;
|
||||||
|
|
||||||
|
let (done_tx, mut done_rx) = mpsc::channel::<()>(1);
|
||||||
|
let done_tx = Arc::new(Mutex::new(Some(done_tx)));
|
||||||
|
a.on_candidate(Box::new(
|
||||||
|
move |c: Option<Arc<dyn Candidate + Send + Sync>>| {
|
||||||
|
let done_tx_clone = Arc::clone(&done_tx);
|
||||||
|
Box::pin(async move {
|
||||||
|
if c.is_none() {
|
||||||
|
let mut tx = done_tx_clone.lock().await;
|
||||||
|
tx.take();
|
||||||
|
}
|
||||||
|
})
|
||||||
|
},
|
||||||
|
));
|
||||||
|
|
||||||
|
a.gather_candidates()?;
|
||||||
|
|
||||||
|
log::debug!("wait for gathering is done...");
|
||||||
|
let _ = done_rx.recv().await;
|
||||||
|
log::debug!("gathering is done");
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_generate_multicast_dnsname() -> Result<()> {
|
||||||
|
let name = generate_multicast_dns_name();
|
||||||
|
|
||||||
|
let re = Regex::new(
|
||||||
|
r"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}.local+$",
|
||||||
|
);
|
||||||
|
|
||||||
|
if let Ok(re) = re {
|
||||||
|
assert!(
|
||||||
|
re.is_match(&name),
|
||||||
|
"mDNS name must be UUID v4 + \".local\" suffix, got {name}"
|
||||||
|
);
|
||||||
|
} else {
|
||||||
|
panic!("expected ok, but got err");
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
Vendored
+71
@@ -0,0 +1,71 @@
|
|||||||
|
#[cfg(test)]
|
||||||
|
mod mdns_test;
|
||||||
|
|
||||||
|
use std::net::SocketAddr;
|
||||||
|
use std::str::FromStr;
|
||||||
|
use std::sync::Arc;
|
||||||
|
|
||||||
|
use mdns::config::*;
|
||||||
|
use mdns::conn::*;
|
||||||
|
use uuid::Uuid;
|
||||||
|
|
||||||
|
use crate::error::Result;
|
||||||
|
|
||||||
|
/// Represents the different Multicast modes that ICE can run.
|
||||||
|
#[derive(PartialEq, Eq, Debug, Copy, Clone)]
|
||||||
|
pub enum MulticastDnsMode {
|
||||||
|
/// Means remote mDNS candidates will be discarded, and local host candidates will use IPs.
|
||||||
|
Disabled,
|
||||||
|
|
||||||
|
/// Means remote mDNS candidates will be accepted, and local host candidates will use IPs.
|
||||||
|
QueryOnly,
|
||||||
|
|
||||||
|
/// Means remote mDNS candidates will be accepted, and local host candidates will use mDNS.
|
||||||
|
QueryAndGather,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for MulticastDnsMode {
|
||||||
|
fn default() -> Self {
|
||||||
|
Self::QueryOnly
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) fn generate_multicast_dns_name() -> String {
|
||||||
|
// https://tools.ietf.org/id/draft-ietf-rtcweb-mdns-ice-candidates-02.html#gathering
|
||||||
|
// The unique name MUST consist of a version 4 UUID as defined in [RFC4122], followed by “.local”.
|
||||||
|
let u = Uuid::new_v4();
|
||||||
|
format!("{u}.local")
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) fn create_multicast_dns(
|
||||||
|
mdns_mode: MulticastDnsMode,
|
||||||
|
mdns_name: &str,
|
||||||
|
dest_addr: &str,
|
||||||
|
) -> Result<Option<Arc<DnsConn>>> {
|
||||||
|
let local_names = match mdns_mode {
|
||||||
|
MulticastDnsMode::QueryOnly => vec![],
|
||||||
|
MulticastDnsMode::QueryAndGather => vec![mdns_name.to_owned()],
|
||||||
|
MulticastDnsMode::Disabled => return Ok(None),
|
||||||
|
};
|
||||||
|
|
||||||
|
let addr = if dest_addr.is_empty() {
|
||||||
|
//TODO: why DEFAULT_DEST_ADDR doesn't work on Mac/Win?
|
||||||
|
if cfg!(target_os = "linux") {
|
||||||
|
SocketAddr::from_str(DEFAULT_DEST_ADDR)?
|
||||||
|
} else {
|
||||||
|
SocketAddr::from_str("0.0.0.0:5353")?
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
SocketAddr::from_str(dest_addr)?
|
||||||
|
};
|
||||||
|
log::info!("mDNS is using {} as dest_addr", addr);
|
||||||
|
|
||||||
|
let conn = DnsConn::server(
|
||||||
|
addr,
|
||||||
|
Config {
|
||||||
|
local_names,
|
||||||
|
..Config::default()
|
||||||
|
},
|
||||||
|
)?;
|
||||||
|
Ok(Some(Arc::new(conn)))
|
||||||
|
}
|
||||||
+148
@@ -0,0 +1,148 @@
|
|||||||
|
#[cfg(test)]
|
||||||
|
mod network_type_test;
|
||||||
|
|
||||||
|
use std::fmt;
|
||||||
|
use std::net::IpAddr;
|
||||||
|
|
||||||
|
use serde::{Deserialize, Serialize};
|
||||||
|
|
||||||
|
use crate::error::*;
|
||||||
|
|
||||||
|
pub(crate) const UDP: &str = "udp";
|
||||||
|
pub(crate) const TCP: &str = "tcp";
|
||||||
|
|
||||||
|
#[must_use]
|
||||||
|
pub fn supported_network_types() -> Vec<NetworkType> {
|
||||||
|
vec![
|
||||||
|
NetworkType::Udp4,
|
||||||
|
NetworkType::Udp6,
|
||||||
|
//NetworkType::TCP4,
|
||||||
|
//NetworkType::TCP6,
|
||||||
|
]
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Represents the type of network.
|
||||||
|
#[derive(PartialEq, Debug, Copy, Clone, Eq, Hash, Serialize, Deserialize)]
|
||||||
|
pub enum NetworkType {
|
||||||
|
#[serde(rename = "unspecified")]
|
||||||
|
Unspecified,
|
||||||
|
|
||||||
|
/// Indicates UDP over IPv4.
|
||||||
|
#[serde(rename = "udp4")]
|
||||||
|
Udp4,
|
||||||
|
|
||||||
|
/// Indicates UDP over IPv6.
|
||||||
|
#[serde(rename = "udp6")]
|
||||||
|
Udp6,
|
||||||
|
|
||||||
|
/// Indicates TCP over IPv4.
|
||||||
|
#[serde(rename = "tcp4")]
|
||||||
|
Tcp4,
|
||||||
|
|
||||||
|
/// Indicates TCP over IPv6.
|
||||||
|
#[serde(rename = "tcp6")]
|
||||||
|
Tcp6,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl From<u8> for NetworkType {
|
||||||
|
fn from(v: u8) -> Self {
|
||||||
|
match v {
|
||||||
|
1 => Self::Udp4,
|
||||||
|
2 => Self::Udp6,
|
||||||
|
3 => Self::Tcp4,
|
||||||
|
4 => Self::Tcp6,
|
||||||
|
_ => Self::Unspecified,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for NetworkType {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||||
|
let s = match *self {
|
||||||
|
Self::Udp4 => "udp4",
|
||||||
|
Self::Udp6 => "udp6",
|
||||||
|
Self::Tcp4 => "tcp4",
|
||||||
|
Self::Tcp6 => "tcp6",
|
||||||
|
Self::Unspecified => "unspecified",
|
||||||
|
};
|
||||||
|
write!(f, "{s}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for NetworkType {
|
||||||
|
fn default() -> Self {
|
||||||
|
Self::Unspecified
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl NetworkType {
|
||||||
|
/// Returns true when network is UDP4 or UDP6.
|
||||||
|
#[must_use]
|
||||||
|
pub fn is_udp(self) -> bool {
|
||||||
|
self == Self::Udp4 || self == Self::Udp6
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns true when network is TCP4 or TCP6.
|
||||||
|
#[must_use]
|
||||||
|
pub fn is_tcp(self) -> bool {
|
||||||
|
self == Self::Tcp4 || self == Self::Tcp6
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the short network description.
|
||||||
|
#[must_use]
|
||||||
|
pub fn network_short(self) -> String {
|
||||||
|
match self {
|
||||||
|
Self::Udp4 | Self::Udp6 => UDP.to_owned(),
|
||||||
|
Self::Tcp4 | Self::Tcp6 => TCP.to_owned(),
|
||||||
|
Self::Unspecified => "Unspecified".to_owned(),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns true if the network is reliable.
|
||||||
|
#[must_use]
|
||||||
|
pub const fn is_reliable(self) -> bool {
|
||||||
|
match self {
|
||||||
|
Self::Tcp4 | Self::Tcp6 => true,
|
||||||
|
Self::Udp4 | Self::Udp6 | Self::Unspecified => false,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns whether the network type is IPv4 or not.
|
||||||
|
#[must_use]
|
||||||
|
pub const fn is_ipv4(self) -> bool {
|
||||||
|
match self {
|
||||||
|
Self::Udp4 | Self::Tcp4 => true,
|
||||||
|
Self::Udp6 | Self::Tcp6 | Self::Unspecified => false,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns whether the network type is IPv6 or not.
|
||||||
|
#[must_use]
|
||||||
|
pub const fn is_ipv6(self) -> bool {
|
||||||
|
match self {
|
||||||
|
Self::Udp6 | Self::Tcp6 => true,
|
||||||
|
Self::Udp4 | Self::Tcp4 | Self::Unspecified => false,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Determines the type of network based on the short network string and an IP address.
|
||||||
|
pub(crate) fn determine_network_type(network: &str, ip: &IpAddr) -> Result<NetworkType> {
|
||||||
|
let ipv4 = ip.is_ipv4();
|
||||||
|
let net = network.to_lowercase();
|
||||||
|
if net.starts_with(UDP) {
|
||||||
|
if ipv4 {
|
||||||
|
Ok(NetworkType::Udp4)
|
||||||
|
} else {
|
||||||
|
Ok(NetworkType::Udp6)
|
||||||
|
}
|
||||||
|
} else if net.starts_with(TCP) {
|
||||||
|
if ipv4 {
|
||||||
|
Ok(NetworkType::Tcp4)
|
||||||
|
} else {
|
||||||
|
Ok(NetworkType::Tcp6)
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
Err(Error::ErrDetermineNetworkType)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,95 @@
|
|||||||
|
use super::*;
|
||||||
|
use crate::error::Result;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_network_type_parsing_success() -> Result<()> {
|
||||||
|
let ipv4: IpAddr = "192.168.0.1".parse().unwrap();
|
||||||
|
let ipv6: IpAddr = "fe80::a3:6ff:fec4:5454".parse().unwrap();
|
||||||
|
|
||||||
|
let tests = vec![
|
||||||
|
("lowercase UDP4", "udp", ipv4, NetworkType::Udp4),
|
||||||
|
("uppercase UDP4", "UDP", ipv4, NetworkType::Udp4),
|
||||||
|
("lowercase UDP6", "udp", ipv6, NetworkType::Udp6),
|
||||||
|
("uppercase UDP6", "UDP", ipv6, NetworkType::Udp6),
|
||||||
|
];
|
||||||
|
|
||||||
|
for (name, in_network, in_ip, expected) in tests {
|
||||||
|
let actual = determine_network_type(in_network, &in_ip)?;
|
||||||
|
|
||||||
|
assert_eq!(
|
||||||
|
actual, expected,
|
||||||
|
"NetworkTypeParsing: '{name}' -- input:{in_network} expected:{expected} actual:{actual}"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_network_type_parsing_failure() -> Result<()> {
|
||||||
|
let ipv6: IpAddr = "fe80::a3:6ff:fec4:5454".parse().unwrap();
|
||||||
|
|
||||||
|
let tests = vec![("invalid network", "junkNetwork", ipv6)];
|
||||||
|
for (name, in_network, in_ip) in tests {
|
||||||
|
let result = determine_network_type(in_network, &in_ip);
|
||||||
|
assert!(
|
||||||
|
result.is_err(),
|
||||||
|
"NetworkTypeParsing should fail: '{name}' -- input:{in_network}",
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_network_type_is_udp() -> Result<()> {
|
||||||
|
assert!(NetworkType::Udp4.is_udp());
|
||||||
|
assert!(NetworkType::Udp6.is_udp());
|
||||||
|
assert!(!NetworkType::Udp4.is_tcp());
|
||||||
|
assert!(!NetworkType::Udp6.is_tcp());
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_network_type_is_tcp() -> Result<()> {
|
||||||
|
assert!(NetworkType::Tcp4.is_tcp());
|
||||||
|
assert!(NetworkType::Tcp6.is_tcp());
|
||||||
|
assert!(!NetworkType::Tcp4.is_udp());
|
||||||
|
assert!(!NetworkType::Tcp6.is_udp());
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_network_type_serialization() {
|
||||||
|
let tests = vec![
|
||||||
|
(NetworkType::Tcp4, "\"tcp4\""),
|
||||||
|
(NetworkType::Tcp6, "\"tcp6\""),
|
||||||
|
(NetworkType::Udp4, "\"udp4\""),
|
||||||
|
(NetworkType::Udp6, "\"udp6\""),
|
||||||
|
(NetworkType::Unspecified, "\"unspecified\""),
|
||||||
|
];
|
||||||
|
|
||||||
|
for (network_type, expected_string) in tests {
|
||||||
|
assert_eq!(
|
||||||
|
expected_string.to_string(),
|
||||||
|
serde_json::to_string(&network_type).unwrap()
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_network_type_to_string() {
|
||||||
|
let tests = vec![
|
||||||
|
(NetworkType::Tcp4, "tcp4"),
|
||||||
|
(NetworkType::Tcp6, "tcp6"),
|
||||||
|
(NetworkType::Udp4, "udp4"),
|
||||||
|
(NetworkType::Udp6, "udp6"),
|
||||||
|
(NetworkType::Unspecified, "unspecified"),
|
||||||
|
];
|
||||||
|
|
||||||
|
for (network_type, expected_string) in tests {
|
||||||
|
assert_eq!(network_type.to_string(), expected_string);
|
||||||
|
}
|
||||||
|
}
|
||||||
+36
@@ -0,0 +1,36 @@
|
|||||||
|
#[cfg(test)]
|
||||||
|
mod priority_test;
|
||||||
|
|
||||||
|
use stun::attributes::ATTR_PRIORITY;
|
||||||
|
use stun::checks::*;
|
||||||
|
use stun::message::*;
|
||||||
|
|
||||||
|
/// Represents PRIORITY attribute.
|
||||||
|
#[derive(Default, PartialEq, Eq, Debug, Copy, Clone)]
|
||||||
|
pub struct PriorityAttr(pub u32);
|
||||||
|
|
||||||
|
const PRIORITY_SIZE: usize = 4; // 32 bit
|
||||||
|
|
||||||
|
impl Setter for PriorityAttr {
|
||||||
|
// add_to adds PRIORITY attribute to message.
|
||||||
|
fn add_to(&self, m: &mut Message) -> Result<(), stun::Error> {
|
||||||
|
let mut v = vec![0_u8; PRIORITY_SIZE];
|
||||||
|
v.copy_from_slice(&self.0.to_be_bytes());
|
||||||
|
m.add(ATTR_PRIORITY, &v);
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl PriorityAttr {
|
||||||
|
/// Decodes PRIORITY attribute from message.
|
||||||
|
pub fn get_from(&mut self, m: &Message) -> Result<(), stun::Error> {
|
||||||
|
let v = m.get(ATTR_PRIORITY)?;
|
||||||
|
|
||||||
|
check_size(ATTR_PRIORITY, v.len(), PRIORITY_SIZE)?;
|
||||||
|
|
||||||
|
let p = u32::from_be_bytes([v[0], v[1], v[2], v[3]]);
|
||||||
|
self.0 = p;
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
+39
@@ -0,0 +1,39 @@
|
|||||||
|
use super::*;
|
||||||
|
use crate::error::Result;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_priority_get_from() -> Result<()> {
|
||||||
|
let mut m = Message::new();
|
||||||
|
let mut p = PriorityAttr::default();
|
||||||
|
let result = p.get_from(&m);
|
||||||
|
if let Err(err) = result {
|
||||||
|
assert_eq!(err, stun::Error::ErrAttributeNotFound, "unexpected error");
|
||||||
|
} else {
|
||||||
|
panic!("expected error, but got ok");
|
||||||
|
}
|
||||||
|
|
||||||
|
m.build(&[Box::new(BINDING_REQUEST), Box::new(p)])?;
|
||||||
|
|
||||||
|
let mut m1 = Message::new();
|
||||||
|
m1.write(&m.raw)?;
|
||||||
|
|
||||||
|
let mut p1 = PriorityAttr::default();
|
||||||
|
p1.get_from(&m1)?;
|
||||||
|
|
||||||
|
assert_eq!(p1, p, "not equal");
|
||||||
|
|
||||||
|
//"IncorrectSize"
|
||||||
|
{
|
||||||
|
let mut m3 = Message::new();
|
||||||
|
m3.add(ATTR_PRIORITY, &[0; 100]);
|
||||||
|
let mut p2 = PriorityAttr::default();
|
||||||
|
let result = p2.get_from(&m3);
|
||||||
|
if let Err(err) = result {
|
||||||
|
assert!(is_attr_size_invalid(&err), "should error");
|
||||||
|
} else {
|
||||||
|
panic!("expected error, but got ok");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
Vendored
+48
@@ -0,0 +1,48 @@
|
|||||||
|
#[cfg(test)]
|
||||||
|
mod rand_test;
|
||||||
|
|
||||||
|
use rand::{thread_rng, Rng};
|
||||||
|
|
||||||
|
const RUNES_ALPHA: &[u8] = b"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
|
||||||
|
const RUNES_CANDIDATE_ID_FOUNDATION: &[u8] =
|
||||||
|
b"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/+";
|
||||||
|
|
||||||
|
const LEN_UFRAG: usize = 16;
|
||||||
|
const LEN_PWD: usize = 32;
|
||||||
|
|
||||||
|
//TODO: generates a random string for cryptographic usage.
|
||||||
|
pub fn generate_crypto_random_string(n: usize, runes: &[u8]) -> String {
|
||||||
|
let mut rng = thread_rng();
|
||||||
|
|
||||||
|
let rand_string: String = (0..n)
|
||||||
|
.map(|_| {
|
||||||
|
let idx = rng.gen_range(0..runes.len());
|
||||||
|
runes[idx] as char
|
||||||
|
})
|
||||||
|
.collect();
|
||||||
|
|
||||||
|
rand_string
|
||||||
|
}
|
||||||
|
|
||||||
|
/// https://tools.ietf.org/html/rfc5245#section-15.1
|
||||||
|
/// candidate-id = "candidate" ":" foundation
|
||||||
|
/// foundation = 1*32ice-char
|
||||||
|
/// ice-char = ALPHA / DIGIT / "+" / "/"
|
||||||
|
pub fn generate_cand_id() -> String {
|
||||||
|
format!(
|
||||||
|
"candidate:{}",
|
||||||
|
generate_crypto_random_string(32, RUNES_CANDIDATE_ID_FOUNDATION)
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Generates ICE pwd.
|
||||||
|
/// This internally uses `generate_crypto_random_string`.
|
||||||
|
pub fn generate_pwd() -> String {
|
||||||
|
generate_crypto_random_string(LEN_PWD, RUNES_ALPHA)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// ICE user fragment.
|
||||||
|
/// This internally uses `generate_crypto_random_string`.
|
||||||
|
pub fn generate_ufrag() -> String {
|
||||||
|
generate_crypto_random_string(LEN_UFRAG, RUNES_ALPHA)
|
||||||
|
}
|
||||||
+77
@@ -0,0 +1,77 @@
|
|||||||
|
use std::sync::Arc;
|
||||||
|
|
||||||
|
use tokio::sync::Mutex;
|
||||||
|
use waitgroup::WaitGroup;
|
||||||
|
|
||||||
|
use super::*;
|
||||||
|
use crate::error::Result;
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn test_random_generator_collision() -> Result<()> {
|
||||||
|
let test_cases = vec![
|
||||||
|
(
|
||||||
|
"CandidateID",
|
||||||
|
0, /*||-> String {
|
||||||
|
generate_cand_id()
|
||||||
|
},*/
|
||||||
|
),
|
||||||
|
(
|
||||||
|
"PWD", 1, /*||-> String {
|
||||||
|
generate_pwd()
|
||||||
|
},*/
|
||||||
|
),
|
||||||
|
(
|
||||||
|
"Ufrag", 2, /*|| ->String {
|
||||||
|
generate_ufrag()
|
||||||
|
},*/
|
||||||
|
),
|
||||||
|
];
|
||||||
|
|
||||||
|
const N: usize = 10;
|
||||||
|
const ITERATION: usize = 10;
|
||||||
|
|
||||||
|
for (name, test_case) in test_cases {
|
||||||
|
for _ in 0..ITERATION {
|
||||||
|
let rands = Arc::new(Mutex::new(vec![]));
|
||||||
|
|
||||||
|
// Create a new wait group.
|
||||||
|
let wg = WaitGroup::new();
|
||||||
|
|
||||||
|
for _ in 0..N {
|
||||||
|
let w = wg.worker();
|
||||||
|
let rs = Arc::clone(&rands);
|
||||||
|
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let _d = w;
|
||||||
|
|
||||||
|
let s = if test_case == 0 {
|
||||||
|
generate_cand_id()
|
||||||
|
} else if test_case == 1 {
|
||||||
|
generate_pwd()
|
||||||
|
} else {
|
||||||
|
generate_ufrag()
|
||||||
|
};
|
||||||
|
|
||||||
|
let mut r = rs.lock().await;
|
||||||
|
r.push(s);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
wg.wait().await;
|
||||||
|
|
||||||
|
let rs = rands.lock().await;
|
||||||
|
assert_eq!(rs.len(), N, "{name} Failed to generate randoms");
|
||||||
|
|
||||||
|
for i in 0..N {
|
||||||
|
for j in i + 1..N {
|
||||||
|
assert_ne!(
|
||||||
|
rs[i], rs[j],
|
||||||
|
"{}: generateRandString caused collision: {} == {}",
|
||||||
|
name, rs[i], rs[j],
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
Vendored
+112
@@ -0,0 +1,112 @@
|
|||||||
|
#[cfg(test)]
|
||||||
|
mod state_test;
|
||||||
|
|
||||||
|
use std::fmt;
|
||||||
|
|
||||||
|
/// An enum showing the state of a ICE Connection List of supported States.
|
||||||
|
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
|
||||||
|
pub enum ConnectionState {
|
||||||
|
Unspecified,
|
||||||
|
|
||||||
|
/// ICE agent is gathering addresses.
|
||||||
|
New,
|
||||||
|
|
||||||
|
/// ICE agent has been given local and remote candidates, and is attempting to find a match.
|
||||||
|
Checking,
|
||||||
|
|
||||||
|
/// ICE agent has a pairing, but is still checking other pairs.
|
||||||
|
Connected,
|
||||||
|
|
||||||
|
/// ICE agent has finished.
|
||||||
|
Completed,
|
||||||
|
|
||||||
|
/// ICE agent never could successfully connect.
|
||||||
|
Failed,
|
||||||
|
|
||||||
|
/// ICE agent connected successfully, but has entered a failed state.
|
||||||
|
Disconnected,
|
||||||
|
|
||||||
|
/// ICE agent has finished and is no longer handling requests.
|
||||||
|
Closed,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for ConnectionState {
|
||||||
|
fn default() -> Self {
|
||||||
|
Self::Unspecified
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ConnectionState {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||||
|
let s = match *self {
|
||||||
|
Self::Unspecified => "Unspecified",
|
||||||
|
Self::New => "New",
|
||||||
|
Self::Checking => "Checking",
|
||||||
|
Self::Connected => "Connected",
|
||||||
|
Self::Completed => "Completed",
|
||||||
|
Self::Failed => "Failed",
|
||||||
|
Self::Disconnected => "Disconnected",
|
||||||
|
Self::Closed => "Closed",
|
||||||
|
};
|
||||||
|
write!(f, "{s}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl From<u8> for ConnectionState {
|
||||||
|
fn from(v: u8) -> Self {
|
||||||
|
match v {
|
||||||
|
1 => Self::New,
|
||||||
|
2 => Self::Checking,
|
||||||
|
3 => Self::Connected,
|
||||||
|
4 => Self::Completed,
|
||||||
|
5 => Self::Failed,
|
||||||
|
6 => Self::Disconnected,
|
||||||
|
7 => Self::Closed,
|
||||||
|
_ => Self::Unspecified,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Describes the state of the candidate gathering process.
|
||||||
|
#[derive(PartialEq, Eq, Copy, Clone)]
|
||||||
|
pub enum GatheringState {
|
||||||
|
Unspecified,
|
||||||
|
|
||||||
|
/// Indicates candidate gathering is not yet started.
|
||||||
|
New,
|
||||||
|
|
||||||
|
/// Indicates candidate gathering is ongoing.
|
||||||
|
Gathering,
|
||||||
|
|
||||||
|
/// Indicates candidate gathering has been completed.
|
||||||
|
Complete,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl From<u8> for GatheringState {
|
||||||
|
fn from(v: u8) -> Self {
|
||||||
|
match v {
|
||||||
|
1 => Self::New,
|
||||||
|
2 => Self::Gathering,
|
||||||
|
3 => Self::Complete,
|
||||||
|
_ => Self::Unspecified,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for GatheringState {
|
||||||
|
fn default() -> Self {
|
||||||
|
Self::Unspecified
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for GatheringState {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||||
|
let s = match *self {
|
||||||
|
Self::New => "new",
|
||||||
|
Self::Gathering => "gathering",
|
||||||
|
Self::Complete => "complete",
|
||||||
|
Self::Unspecified => "unspecified",
|
||||||
|
};
|
||||||
|
write!(f, "{s}")
|
||||||
|
}
|
||||||
|
}
|
||||||
+46
@@ -0,0 +1,46 @@
|
|||||||
|
use super::*;
|
||||||
|
use crate::error::Result;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_connected_state_string() -> Result<()> {
|
||||||
|
let tests = vec![
|
||||||
|
(ConnectionState::Unspecified, "Unspecified"),
|
||||||
|
(ConnectionState::New, "New"),
|
||||||
|
(ConnectionState::Checking, "Checking"),
|
||||||
|
(ConnectionState::Connected, "Connected"),
|
||||||
|
(ConnectionState::Completed, "Completed"),
|
||||||
|
(ConnectionState::Failed, "Failed"),
|
||||||
|
(ConnectionState::Disconnected, "Disconnected"),
|
||||||
|
(ConnectionState::Closed, "Closed"),
|
||||||
|
];
|
||||||
|
|
||||||
|
for (connection_state, expected_string) in tests {
|
||||||
|
assert_eq!(
|
||||||
|
connection_state.to_string(),
|
||||||
|
expected_string,
|
||||||
|
"testCase: {expected_string} vs {connection_state}",
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_gathering_state_string() -> Result<()> {
|
||||||
|
let tests = vec![
|
||||||
|
(GatheringState::Unspecified, "unspecified"),
|
||||||
|
(GatheringState::New, "new"),
|
||||||
|
(GatheringState::Gathering, "gathering"),
|
||||||
|
(GatheringState::Complete, "complete"),
|
||||||
|
];
|
||||||
|
|
||||||
|
for (gathering_state, expected_string) in tests {
|
||||||
|
assert_eq!(
|
||||||
|
gathering_state.to_string(),
|
||||||
|
expected_string,
|
||||||
|
"testCase: {expected_string} vs {gathering_state}",
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
Vendored
+178
@@ -0,0 +1,178 @@
|
|||||||
|
use tokio::time::Instant;
|
||||||
|
|
||||||
|
use crate::candidate::*;
|
||||||
|
use crate::network_type::*;
|
||||||
|
|
||||||
|
// CandidatePairStats contains ICE candidate pair statistics
|
||||||
|
#[derive(Debug, Clone)]
|
||||||
|
pub struct CandidatePairStats {
|
||||||
|
// timestamp is the timestamp associated with this object.
|
||||||
|
pub timestamp: Instant,
|
||||||
|
|
||||||
|
// local_candidate_id is the id of the local candidate
|
||||||
|
pub local_candidate_id: String,
|
||||||
|
|
||||||
|
// remote_candidate_id is the id of the remote candidate
|
||||||
|
pub remote_candidate_id: String,
|
||||||
|
|
||||||
|
// state represents the state of the checklist for the local and remote
|
||||||
|
// candidates in a pair.
|
||||||
|
pub state: CandidatePairState,
|
||||||
|
|
||||||
|
// nominated is true when this valid pair that should be used for media
|
||||||
|
// if it is the highest-priority one amongst those whose nominated flag is set
|
||||||
|
pub nominated: bool,
|
||||||
|
|
||||||
|
// packets_sent represents the total number of packets sent on this candidate pair.
|
||||||
|
pub packets_sent: u32,
|
||||||
|
|
||||||
|
// packets_received represents the total number of packets received on this candidate pair.
|
||||||
|
pub packets_received: u32,
|
||||||
|
|
||||||
|
// bytes_sent represents the total number of payload bytes sent on this candidate pair
|
||||||
|
// not including headers or padding.
|
||||||
|
pub bytes_sent: u64,
|
||||||
|
|
||||||
|
// bytes_received represents the total number of payload bytes received on this candidate pair
|
||||||
|
// not including headers or padding.
|
||||||
|
pub bytes_received: u64,
|
||||||
|
|
||||||
|
// last_packet_sent_timestamp represents the timestamp at which the last packet was
|
||||||
|
// sent on this particular candidate pair, excluding STUN packets.
|
||||||
|
pub last_packet_sent_timestamp: Instant,
|
||||||
|
|
||||||
|
// last_packet_received_timestamp represents the timestamp at which the last packet
|
||||||
|
// was received on this particular candidate pair, excluding STUN packets.
|
||||||
|
pub last_packet_received_timestamp: Instant,
|
||||||
|
|
||||||
|
// first_request_timestamp represents the timestamp at which the first STUN request
|
||||||
|
// was sent on this particular candidate pair.
|
||||||
|
pub first_request_timestamp: Instant,
|
||||||
|
|
||||||
|
// last_request_timestamp represents the timestamp at which the last STUN request
|
||||||
|
// was sent on this particular candidate pair. The average interval between two
|
||||||
|
// consecutive connectivity checks sent can be calculated with
|
||||||
|
// (last_request_timestamp - first_request_timestamp) / requests_sent.
|
||||||
|
pub last_request_timestamp: Instant,
|
||||||
|
|
||||||
|
// last_response_timestamp represents the timestamp at which the last STUN response
|
||||||
|
// was received on this particular candidate pair.
|
||||||
|
pub last_response_timestamp: Instant,
|
||||||
|
|
||||||
|
// total_round_trip_time represents the sum of all round trip time measurements
|
||||||
|
// in seconds since the beginning of the session, based on STUN connectivity
|
||||||
|
// check responses (responses_received), including those that reply to requests
|
||||||
|
// that are sent in order to verify consent. The average round trip time can
|
||||||
|
// be computed from total_round_trip_time by dividing it by responses_received.
|
||||||
|
pub total_round_trip_time: f64,
|
||||||
|
|
||||||
|
// current_round_trip_time represents the latest round trip time measured in seconds,
|
||||||
|
// computed from both STUN connectivity checks, including those that are sent
|
||||||
|
// for consent verification.
|
||||||
|
pub current_round_trip_time: f64,
|
||||||
|
|
||||||
|
// available_outgoing_bitrate is calculated by the underlying congestion control
|
||||||
|
// by combining the available bitrate for all the outgoing RTP streams using
|
||||||
|
// this candidate pair. The bitrate measurement does not count the size of the
|
||||||
|
// ip or other transport layers like TCP or UDP. It is similar to the TIAS defined
|
||||||
|
// in RFC 3890, i.e., it is measured in bits per second and the bitrate is calculated
|
||||||
|
// over a 1 second window.
|
||||||
|
pub available_outgoing_bitrate: f64,
|
||||||
|
|
||||||
|
// available_incoming_bitrate is calculated by the underlying congestion control
|
||||||
|
// by combining the available bitrate for all the incoming RTP streams using
|
||||||
|
// this candidate pair. The bitrate measurement does not count the size of the
|
||||||
|
// ip or other transport layers like TCP or UDP. It is similar to the TIAS defined
|
||||||
|
// in RFC 3890, i.e., it is measured in bits per second and the bitrate is
|
||||||
|
// calculated over a 1 second window.
|
||||||
|
pub available_incoming_bitrate: f64,
|
||||||
|
|
||||||
|
// circuit_breaker_trigger_count represents the number of times the circuit breaker
|
||||||
|
// is triggered for this particular 5-tuple, ceasing transmission.
|
||||||
|
pub circuit_breaker_trigger_count: u32,
|
||||||
|
|
||||||
|
// requests_received represents the total number of connectivity check requests
|
||||||
|
// received (including retransmissions). It is impossible for the receiver to
|
||||||
|
// tell whether the request was sent in order to check connectivity or check
|
||||||
|
// consent, so all connectivity checks requests are counted here.
|
||||||
|
pub requests_received: u64,
|
||||||
|
|
||||||
|
// requests_sent represents the total number of connectivity check requests
|
||||||
|
// sent (not including retransmissions).
|
||||||
|
pub requests_sent: u64,
|
||||||
|
|
||||||
|
// responses_received represents the total number of connectivity check responses received.
|
||||||
|
pub responses_received: u64,
|
||||||
|
|
||||||
|
// responses_sent epresents the total number of connectivity check responses sent.
|
||||||
|
// Since we cannot distinguish connectivity check requests and consent requests,
|
||||||
|
// all responses are counted.
|
||||||
|
pub responses_sent: u64,
|
||||||
|
|
||||||
|
// retransmissions_received represents the total number of connectivity check
|
||||||
|
// request retransmissions received.
|
||||||
|
pub retransmissions_received: u64,
|
||||||
|
|
||||||
|
// retransmissions_sent represents the total number of connectivity check
|
||||||
|
// request retransmissions sent.
|
||||||
|
pub retransmissions_sent: u64,
|
||||||
|
|
||||||
|
// consent_requests_sent represents the total number of consent requests sent.
|
||||||
|
pub consent_requests_sent: u64,
|
||||||
|
|
||||||
|
// consent_expired_timestamp represents the timestamp at which the latest valid
|
||||||
|
// STUN binding response expired.
|
||||||
|
pub consent_expired_timestamp: Instant,
|
||||||
|
}
|
||||||
|
|
||||||
|
// CandidateStats contains ICE candidate statistics related to the ICETransport objects.
|
||||||
|
#[derive(Debug, Clone)]
|
||||||
|
pub struct CandidateStats {
|
||||||
|
// timestamp is the timestamp associated with this object.
|
||||||
|
pub timestamp: Instant,
|
||||||
|
|
||||||
|
// id is the candidate id
|
||||||
|
pub id: String,
|
||||||
|
|
||||||
|
// network_type represents the type of network interface used by the base of a
|
||||||
|
// local candidate (the address the ICE agent sends from). Only present for
|
||||||
|
// local candidates; it's not possible to know what type of network interface
|
||||||
|
// a remote candidate is using.
|
||||||
|
//
|
||||||
|
// Note:
|
||||||
|
// This stat only tells you about the network interface used by the first "hop";
|
||||||
|
// it's possible that a connection will be bottlenecked by another type of network.
|
||||||
|
// For example, when using Wi-Fi tethering, the networkType of the relevant candidate
|
||||||
|
// would be "wifi", even when the next hop is over a cellular connection.
|
||||||
|
pub network_type: NetworkType,
|
||||||
|
|
||||||
|
// ip is the ip address of the candidate, allowing for IPv4 addresses and
|
||||||
|
// IPv6 addresses, but fully qualified domain names (FQDNs) are not allowed.
|
||||||
|
pub ip: String,
|
||||||
|
|
||||||
|
// port is the port number of the candidate.
|
||||||
|
pub port: u16,
|
||||||
|
|
||||||
|
// candidate_type is the "Type" field of the ICECandidate.
|
||||||
|
pub candidate_type: CandidateType,
|
||||||
|
|
||||||
|
// priority is the "priority" field of the ICECandidate.
|
||||||
|
pub priority: u32,
|
||||||
|
|
||||||
|
// url is the url of the TURN or STUN server indicated in the that translated
|
||||||
|
// this ip address. It is the url address surfaced in an PeerConnectionICEEvent.
|
||||||
|
pub url: String,
|
||||||
|
|
||||||
|
// relay_protocol is the protocol used by the endpoint to communicate with the
|
||||||
|
// TURN server. This is only present for local candidates. Valid values for
|
||||||
|
// the TURN url protocol is one of udp, tcp, or tls.
|
||||||
|
pub relay_protocol: String,
|
||||||
|
|
||||||
|
// deleted is true if the candidate has been deleted/freed. For host candidates,
|
||||||
|
// this means that any network resources (typically a socket) associated with the
|
||||||
|
// candidate have been released. For TURN candidates, this means the TURN allocation
|
||||||
|
// is no longer active.
|
||||||
|
//
|
||||||
|
// Only defined for local candidates. For remote candidates, this property is not applicable.
|
||||||
|
pub deleted: bool,
|
||||||
|
}
|
||||||
+48
@@ -0,0 +1,48 @@
|
|||||||
|
#[cfg(test)]
|
||||||
|
mod tcp_type_test;
|
||||||
|
|
||||||
|
use std::fmt;
|
||||||
|
|
||||||
|
// TCPType is the type of ICE TCP candidate as described in
|
||||||
|
// ttps://tools.ietf.org/html/rfc6544#section-4.5
|
||||||
|
#[derive(PartialEq, Eq, Debug, Copy, Clone)]
|
||||||
|
pub enum TcpType {
|
||||||
|
/// The default value. For example UDP candidates do not need this field.
|
||||||
|
Unspecified,
|
||||||
|
/// Active TCP candidate, which initiates TCP connections.
|
||||||
|
Active,
|
||||||
|
/// Passive TCP candidate, only accepts TCP connections.
|
||||||
|
Passive,
|
||||||
|
/// Like `Active` and `Passive` at the same time.
|
||||||
|
SimultaneousOpen,
|
||||||
|
}
|
||||||
|
|
||||||
|
// from creates a new TCPType from string.
|
||||||
|
impl From<&str> for TcpType {
|
||||||
|
fn from(raw: &str) -> Self {
|
||||||
|
match raw {
|
||||||
|
"active" => Self::Active,
|
||||||
|
"passive" => Self::Passive,
|
||||||
|
"so" => Self::SimultaneousOpen,
|
||||||
|
_ => Self::Unspecified,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for TcpType {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||||
|
let s = match *self {
|
||||||
|
Self::Active => "active",
|
||||||
|
Self::Passive => "passive",
|
||||||
|
Self::SimultaneousOpen => "so",
|
||||||
|
Self::Unspecified => "unspecified",
|
||||||
|
};
|
||||||
|
write!(f, "{s}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for TcpType {
|
||||||
|
fn default() -> Self {
|
||||||
|
Self::Unspecified
|
||||||
|
}
|
||||||
|
}
|
||||||
+18
@@ -0,0 +1,18 @@
|
|||||||
|
use super::*;
|
||||||
|
use crate::error::Result;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_tcp_type() -> Result<()> {
|
||||||
|
//assert_eq!(tcpType, TCPType::Unspecified)
|
||||||
|
assert_eq!(TcpType::from("active"), TcpType::Active);
|
||||||
|
assert_eq!(TcpType::from("passive"), TcpType::Passive);
|
||||||
|
assert_eq!(TcpType::from("so"), TcpType::SimultaneousOpen);
|
||||||
|
assert_eq!(TcpType::from("something else"), TcpType::Unspecified);
|
||||||
|
|
||||||
|
assert_eq!(TcpType::Unspecified.to_string(), "unspecified");
|
||||||
|
assert_eq!(TcpType::Active.to_string(), "active");
|
||||||
|
assert_eq!(TcpType::Passive.to_string(), "passive");
|
||||||
|
assert_eq!(TcpType::SimultaneousOpen.to_string(), "so");
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
Vendored
+338
@@ -0,0 +1,338 @@
|
|||||||
|
use std::collections::HashMap;
|
||||||
|
use std::io::ErrorKind;
|
||||||
|
use std::net::SocketAddr;
|
||||||
|
use std::sync::{Arc, Weak};
|
||||||
|
|
||||||
|
use async_trait::async_trait;
|
||||||
|
use tokio::sync::{watch, Mutex};
|
||||||
|
use util::sync::RwLock;
|
||||||
|
use util::{Conn, Error};
|
||||||
|
|
||||||
|
mod udp_mux_conn;
|
||||||
|
pub use udp_mux_conn::{UDPMuxConn, UDPMuxConnParams, UDPMuxWriter};
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod udp_mux_test;
|
||||||
|
|
||||||
|
mod socket_addr_ext;
|
||||||
|
|
||||||
|
use stun::attributes::ATTR_USERNAME;
|
||||||
|
use stun::message::{is_message as is_stun_message, Message as STUNMessage};
|
||||||
|
|
||||||
|
use crate::candidate::RECEIVE_MTU;
|
||||||
|
|
||||||
|
/// Normalize a target socket addr for sending over a given local socket addr. This is useful when
|
||||||
|
/// a dual stack socket is used, in which case an IPv4 target needs to be mapped to an IPv6
|
||||||
|
/// address.
|
||||||
|
fn normalize_socket_addr(target: &SocketAddr, socket_addr: &SocketAddr) -> SocketAddr {
|
||||||
|
match (target, socket_addr) {
|
||||||
|
(SocketAddr::V4(target_ipv4), SocketAddr::V6(_)) => {
|
||||||
|
let ipv6_mapped = target_ipv4.ip().to_ipv6_mapped();
|
||||||
|
|
||||||
|
SocketAddr::new(std::net::IpAddr::V6(ipv6_mapped), target_ipv4.port())
|
||||||
|
}
|
||||||
|
// This will fail later if target is IPv6 and socket is IPv4, we ignore it here
|
||||||
|
(_, _) => *target,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[async_trait]
|
||||||
|
pub trait UDPMux {
|
||||||
|
/// Close the muxing.
|
||||||
|
async fn close(&self) -> Result<(), Error>;
|
||||||
|
|
||||||
|
/// Get the underlying connection for a given ufrag.
|
||||||
|
async fn get_conn(self: Arc<Self>, ufrag: &str) -> Result<Arc<dyn Conn + Send + Sync>, Error>;
|
||||||
|
|
||||||
|
/// Remove the underlying connection for a given ufrag.
|
||||||
|
async fn remove_conn_by_ufrag(&self, ufrag: &str);
|
||||||
|
}
|
||||||
|
|
||||||
|
pub struct UDPMuxParams {
|
||||||
|
conn: Box<dyn Conn + Send + Sync>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl UDPMuxParams {
|
||||||
|
pub fn new<C>(conn: C) -> Self
|
||||||
|
where
|
||||||
|
C: Conn + Send + Sync + 'static,
|
||||||
|
{
|
||||||
|
Self {
|
||||||
|
conn: Box::new(conn),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
pub struct UDPMuxDefault {
|
||||||
|
/// The params this instance is configured with.
|
||||||
|
/// Contains the underlying UDP socket in use
|
||||||
|
params: UDPMuxParams,
|
||||||
|
|
||||||
|
/// Maps from ufrag to the underlying connection.
|
||||||
|
conns: Mutex<HashMap<String, UDPMuxConn>>,
|
||||||
|
|
||||||
|
/// Maps from ip address to the underlying connection.
|
||||||
|
address_map: RwLock<HashMap<SocketAddr, UDPMuxConn>>,
|
||||||
|
|
||||||
|
// Close sender
|
||||||
|
closed_watch_tx: Mutex<Option<watch::Sender<()>>>,
|
||||||
|
|
||||||
|
/// Close receiver
|
||||||
|
closed_watch_rx: watch::Receiver<()>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl UDPMuxDefault {
|
||||||
|
pub fn new(params: UDPMuxParams) -> Arc<Self> {
|
||||||
|
let (closed_watch_tx, closed_watch_rx) = watch::channel(());
|
||||||
|
|
||||||
|
let mux = Arc::new(Self {
|
||||||
|
params,
|
||||||
|
conns: Mutex::default(),
|
||||||
|
address_map: RwLock::default(),
|
||||||
|
closed_watch_tx: Mutex::new(Some(closed_watch_tx)),
|
||||||
|
closed_watch_rx: closed_watch_rx.clone(),
|
||||||
|
});
|
||||||
|
|
||||||
|
let cloned_mux = Arc::clone(&mux);
|
||||||
|
cloned_mux.start_conn_worker(closed_watch_rx);
|
||||||
|
|
||||||
|
mux
|
||||||
|
}
|
||||||
|
|
||||||
|
pub async fn is_closed(&self) -> bool {
|
||||||
|
self.closed_watch_tx.lock().await.is_none()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Create a muxed connection for a given ufrag.
|
||||||
|
fn create_muxed_conn(self: &Arc<Self>, ufrag: &str) -> Result<UDPMuxConn, Error> {
|
||||||
|
let local_addr = self.params.conn.local_addr()?;
|
||||||
|
|
||||||
|
let params = UDPMuxConnParams {
|
||||||
|
local_addr,
|
||||||
|
key: ufrag.into(),
|
||||||
|
udp_mux: Arc::downgrade(self) as Weak<dyn UDPMuxWriter + Send + Sync>,
|
||||||
|
};
|
||||||
|
|
||||||
|
Ok(UDPMuxConn::new(params))
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn conn_from_stun_message(&self, buffer: &[u8], addr: &SocketAddr) -> Option<UDPMuxConn> {
|
||||||
|
let (result, message) = {
|
||||||
|
let mut m = STUNMessage::new();
|
||||||
|
|
||||||
|
(m.unmarshal_binary(buffer), m)
|
||||||
|
};
|
||||||
|
|
||||||
|
match result {
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!("Failed to handle decode ICE from {}: {}", addr, err);
|
||||||
|
None
|
||||||
|
}
|
||||||
|
Ok(_) => {
|
||||||
|
let (attr, found) = message.attributes.get(ATTR_USERNAME);
|
||||||
|
if !found {
|
||||||
|
log::warn!("No username attribute in STUN message from {}", &addr);
|
||||||
|
return None;
|
||||||
|
}
|
||||||
|
|
||||||
|
let s = match String::from_utf8(attr.value) {
|
||||||
|
// Per the RFC this shouldn't happen
|
||||||
|
// https://datatracker.ietf.org/doc/html/rfc5389#section-15.3
|
||||||
|
Err(err) => {
|
||||||
|
log::warn!(
|
||||||
|
"Failed to decode USERNAME from STUN message as UTF-8: {}",
|
||||||
|
err
|
||||||
|
);
|
||||||
|
return None;
|
||||||
|
}
|
||||||
|
Ok(s) => s,
|
||||||
|
};
|
||||||
|
|
||||||
|
let conns = self.conns.lock().await;
|
||||||
|
let conn = s
|
||||||
|
.split(':')
|
||||||
|
.next()
|
||||||
|
.and_then(|ufrag| conns.get(ufrag))
|
||||||
|
.map(Clone::clone);
|
||||||
|
|
||||||
|
conn
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fn start_conn_worker(self: Arc<Self>, mut closed_watch_rx: watch::Receiver<()>) {
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let mut buffer = [0u8; RECEIVE_MTU];
|
||||||
|
|
||||||
|
loop {
|
||||||
|
let loop_self = Arc::clone(&self);
|
||||||
|
let conn = &loop_self.params.conn;
|
||||||
|
|
||||||
|
tokio::select! {
|
||||||
|
res = conn.recv_from(&mut buffer) => {
|
||||||
|
match res {
|
||||||
|
Ok((len, addr)) => {
|
||||||
|
// Find connection based on previously having seen this source address
|
||||||
|
let conn = {
|
||||||
|
let address_map = loop_self
|
||||||
|
.address_map
|
||||||
|
.read();
|
||||||
|
|
||||||
|
address_map.get(&addr).map(Clone::clone)
|
||||||
|
};
|
||||||
|
|
||||||
|
let conn = match conn {
|
||||||
|
// If we couldn't find the connection based on source address, see if
|
||||||
|
// this is a STUN message and if so if we can find the connection based on ufrag.
|
||||||
|
None if is_stun_message(&buffer) => {
|
||||||
|
loop_self.conn_from_stun_message(&buffer, &addr).await
|
||||||
|
}
|
||||||
|
s @ Some(_) => s,
|
||||||
|
_ => None,
|
||||||
|
};
|
||||||
|
|
||||||
|
match conn {
|
||||||
|
None => {
|
||||||
|
log::trace!("Dropping packet from {}", &addr);
|
||||||
|
}
|
||||||
|
Some(conn) => {
|
||||||
|
if let Err(err) = conn.write_packet(&buffer[..len], addr).await {
|
||||||
|
log::error!("Failed to write packet: {}", err);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Err(Error::Io(err)) if err.0.kind() == ErrorKind::TimedOut => continue,
|
||||||
|
Err(err) => {
|
||||||
|
log::error!("Could not read udp packet: {}", err);
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
_ = closed_watch_rx.changed() => {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[async_trait]
|
||||||
|
impl UDPMux for UDPMuxDefault {
|
||||||
|
async fn close(&self) -> Result<(), Error> {
|
||||||
|
if self.is_closed().await {
|
||||||
|
return Err(Error::ErrAlreadyClosed);
|
||||||
|
}
|
||||||
|
|
||||||
|
let mut closed_tx = self.closed_watch_tx.lock().await;
|
||||||
|
|
||||||
|
if let Some(tx) = closed_tx.take() {
|
||||||
|
let _ = tx.send(());
|
||||||
|
drop(closed_tx);
|
||||||
|
|
||||||
|
let old_conns = {
|
||||||
|
let mut conns = self.conns.lock().await;
|
||||||
|
|
||||||
|
std::mem::take(&mut (*conns))
|
||||||
|
};
|
||||||
|
|
||||||
|
// NOTE: We don't wait for these closure to complete
|
||||||
|
for (_, conn) in old_conns {
|
||||||
|
conn.close();
|
||||||
|
}
|
||||||
|
|
||||||
|
{
|
||||||
|
let mut address_map = self.address_map.write();
|
||||||
|
|
||||||
|
// NOTE: This is important, we need to drop all instances of `UDPMuxConn` to
|
||||||
|
// avoid a retain cycle due to the use of [`std::sync::Arc`] on both sides.
|
||||||
|
let _ = std::mem::take(&mut (*address_map));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn get_conn(self: Arc<Self>, ufrag: &str) -> Result<Arc<dyn Conn + Send + Sync>, Error> {
|
||||||
|
if self.is_closed().await {
|
||||||
|
return Err(Error::ErrUseClosedNetworkConn);
|
||||||
|
}
|
||||||
|
|
||||||
|
{
|
||||||
|
let mut conns = self.conns.lock().await;
|
||||||
|
if let Some(conn) = conns.get(ufrag) {
|
||||||
|
// UDPMuxConn uses `Arc` internally so it's cheap to clone, but because
|
||||||
|
// we implement `Conn` we need to further wrap it in an `Arc` here.
|
||||||
|
return Ok(Arc::new(conn.clone()) as Arc<dyn Conn + Send + Sync>);
|
||||||
|
}
|
||||||
|
|
||||||
|
let muxed_conn = self.create_muxed_conn(ufrag)?;
|
||||||
|
let mut close_rx = muxed_conn.close_rx();
|
||||||
|
let cloned_self = Arc::clone(&self);
|
||||||
|
let cloned_ufrag = ufrag.to_string();
|
||||||
|
tokio::spawn(async move {
|
||||||
|
let _ = close_rx.changed().await;
|
||||||
|
|
||||||
|
// Arc needed
|
||||||
|
cloned_self.remove_conn_by_ufrag(&cloned_ufrag).await;
|
||||||
|
});
|
||||||
|
|
||||||
|
conns.insert(ufrag.into(), muxed_conn.clone());
|
||||||
|
|
||||||
|
Ok(Arc::new(muxed_conn) as Arc<dyn Conn + Send + Sync>)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn remove_conn_by_ufrag(&self, ufrag: &str) {
|
||||||
|
// Pion's ice implementation has both `RemoveConnByFrag` and `RemoveConn`, but since `conns`
|
||||||
|
// is keyed on `ufrag` their implementation is equivalent.
|
||||||
|
|
||||||
|
let removed_conn = {
|
||||||
|
let mut conns = self.conns.lock().await;
|
||||||
|
conns.remove(ufrag)
|
||||||
|
};
|
||||||
|
|
||||||
|
if let Some(conn) = removed_conn {
|
||||||
|
let mut address_map = self.address_map.write();
|
||||||
|
|
||||||
|
for address in conn.get_addresses() {
|
||||||
|
address_map.remove(&address);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[async_trait]
|
||||||
|
impl UDPMuxWriter for UDPMuxDefault {
|
||||||
|
async fn register_conn_for_address(&self, conn: &UDPMuxConn, addr: SocketAddr) {
|
||||||
|
if self.is_closed().await {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
let key = conn.key();
|
||||||
|
{
|
||||||
|
let mut addresses = self.address_map.write();
|
||||||
|
|
||||||
|
addresses
|
||||||
|
.entry(addr)
|
||||||
|
.and_modify(|e| {
|
||||||
|
if e.key() != key {
|
||||||
|
e.remove_address(&addr);
|
||||||
|
*e = conn.clone();
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.or_insert_with(|| conn.clone());
|
||||||
|
}
|
||||||
|
|
||||||
|
log::debug!("Registered {} for {}", addr, key);
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn send_to(&self, buf: &[u8], target: &SocketAddr) -> Result<usize, Error> {
|
||||||
|
self.params
|
||||||
|
.conn
|
||||||
|
.send_to(buf, *target)
|
||||||
|
.await
|
||||||
|
.map_err(Into::into)
|
||||||
|
}
|
||||||
|
}
|
||||||
+246
@@ -0,0 +1,246 @@
|
|||||||
|
use std::array::TryFromSliceError;
|
||||||
|
use std::convert::TryInto;
|
||||||
|
use std::net::SocketAddr;
|
||||||
|
|
||||||
|
use util::Error;
|
||||||
|
|
||||||
|
pub(super) trait SocketAddrExt {
|
||||||
|
///Encode a representation of `self` into the buffer and return the length of this encoded
|
||||||
|
///version.
|
||||||
|
///
|
||||||
|
/// The buffer needs to be at least 27 bytes in length.
|
||||||
|
fn encode(&self, buffer: &mut [u8]) -> Result<usize, Error>;
|
||||||
|
|
||||||
|
/// Decode a `SocketAddr` from a buffer. The encoding should have previously been done with
|
||||||
|
/// [`SocketAddrExt::encode`].
|
||||||
|
fn decode(buffer: &[u8]) -> Result<SocketAddr, Error>;
|
||||||
|
}
|
||||||
|
|
||||||
|
const IPV4_MARKER: u8 = 4;
|
||||||
|
const IPV4_ADDRESS_SIZE: usize = 7;
|
||||||
|
const IPV6_MARKER: u8 = 6;
|
||||||
|
const IPV6_ADDRESS_SIZE: usize = 27;
|
||||||
|
|
||||||
|
pub(super) const MAX_ADDR_SIZE: usize = IPV6_ADDRESS_SIZE;
|
||||||
|
|
||||||
|
impl SocketAddrExt for SocketAddr {
|
||||||
|
fn encode(&self, buffer: &mut [u8]) -> Result<usize, Error> {
|
||||||
|
use std::net::SocketAddr::{V4, V6};
|
||||||
|
|
||||||
|
if buffer.len() < MAX_ADDR_SIZE {
|
||||||
|
return Err(Error::ErrBufferShort);
|
||||||
|
}
|
||||||
|
|
||||||
|
match self {
|
||||||
|
V4(addr) => {
|
||||||
|
let marker = IPV4_MARKER;
|
||||||
|
let ip: [u8; 4] = addr.ip().octets();
|
||||||
|
let port: u16 = addr.port();
|
||||||
|
|
||||||
|
buffer[0] = marker;
|
||||||
|
buffer[1..5].copy_from_slice(&ip);
|
||||||
|
buffer[5..7].copy_from_slice(&port.to_le_bytes());
|
||||||
|
|
||||||
|
Ok(7)
|
||||||
|
}
|
||||||
|
V6(addr) => {
|
||||||
|
let marker = IPV6_MARKER;
|
||||||
|
let ip: [u8; 16] = addr.ip().octets();
|
||||||
|
let port: u16 = addr.port();
|
||||||
|
let flowinfo = addr.flowinfo();
|
||||||
|
let scope_id = addr.scope_id();
|
||||||
|
|
||||||
|
buffer[0] = marker;
|
||||||
|
buffer[1..17].copy_from_slice(&ip);
|
||||||
|
buffer[17..19].copy_from_slice(&port.to_le_bytes());
|
||||||
|
buffer[19..23].copy_from_slice(&flowinfo.to_le_bytes());
|
||||||
|
buffer[23..27].copy_from_slice(&scope_id.to_le_bytes());
|
||||||
|
|
||||||
|
Ok(MAX_ADDR_SIZE)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fn decode(buffer: &[u8]) -> Result<SocketAddr, Error> {
|
||||||
|
use std::net::{Ipv4Addr, Ipv6Addr, SocketAddrV4, SocketAddrV6};
|
||||||
|
|
||||||
|
match buffer[0] {
|
||||||
|
IPV4_MARKER => {
|
||||||
|
if buffer.len() < IPV4_ADDRESS_SIZE {
|
||||||
|
return Err(Error::ErrBufferShort);
|
||||||
|
}
|
||||||
|
|
||||||
|
let ip_parts = &buffer[1..5];
|
||||||
|
let port = match &buffer[5..7].try_into() {
|
||||||
|
Err(_) => return Err(Error::ErrFailedToParseIpaddr),
|
||||||
|
Ok(input) => u16::from_le_bytes(*input),
|
||||||
|
};
|
||||||
|
|
||||||
|
let ip = Ipv4Addr::new(ip_parts[0], ip_parts[1], ip_parts[2], ip_parts[3]);
|
||||||
|
|
||||||
|
Ok(SocketAddr::V4(SocketAddrV4::new(ip, port)))
|
||||||
|
}
|
||||||
|
IPV6_MARKER => {
|
||||||
|
if buffer.len() < IPV6_ADDRESS_SIZE {
|
||||||
|
return Err(Error::ErrBufferShort);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Just to help the type system infer correctly
|
||||||
|
fn helper(b: &[u8]) -> Result<&[u8; 16], TryFromSliceError> {
|
||||||
|
b.try_into()
|
||||||
|
}
|
||||||
|
|
||||||
|
let ip = match helper(&buffer[1..17]) {
|
||||||
|
Err(_) => return Err(Error::ErrFailedToParseIpaddr),
|
||||||
|
Ok(input) => Ipv6Addr::from(*input),
|
||||||
|
};
|
||||||
|
let port = match &buffer[17..19].try_into() {
|
||||||
|
Err(_) => return Err(Error::ErrFailedToParseIpaddr),
|
||||||
|
Ok(input) => u16::from_le_bytes(*input),
|
||||||
|
};
|
||||||
|
|
||||||
|
let flowinfo = match &buffer[19..23].try_into() {
|
||||||
|
Err(_) => return Err(Error::ErrFailedToParseIpaddr),
|
||||||
|
Ok(input) => u32::from_le_bytes(*input),
|
||||||
|
};
|
||||||
|
|
||||||
|
let scope_id = match &buffer[23..27].try_into() {
|
||||||
|
Err(_) => return Err(Error::ErrFailedToParseIpaddr),
|
||||||
|
Ok(input) => u32::from_le_bytes(*input),
|
||||||
|
};
|
||||||
|
|
||||||
|
Ok(SocketAddr::V6(SocketAddrV6::new(
|
||||||
|
ip, port, flowinfo, scope_id,
|
||||||
|
)))
|
||||||
|
}
|
||||||
|
_ => Err(Error::ErrFailedToParseIpaddr),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use std::net::{Ipv4Addr, Ipv6Addr, SocketAddrV4, SocketAddrV6};
|
||||||
|
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_ipv4() {
|
||||||
|
let ip = SocketAddr::V4(SocketAddrV4::new(Ipv4Addr::from([56, 128, 35, 5]), 0x1234));
|
||||||
|
|
||||||
|
let mut buffer = [0_u8; MAX_ADDR_SIZE];
|
||||||
|
let encoded_len = ip.encode(&mut buffer);
|
||||||
|
|
||||||
|
assert_eq!(encoded_len, Ok(7));
|
||||||
|
assert_eq!(
|
||||||
|
&buffer[0..7],
|
||||||
|
&[IPV4_MARKER, 56, 128, 35, 5, 0x34, 0x12][..]
|
||||||
|
);
|
||||||
|
|
||||||
|
let decoded = SocketAddr::decode(&buffer);
|
||||||
|
|
||||||
|
assert_eq!(decoded, Ok(ip));
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_ipv6() {
|
||||||
|
let ip = SocketAddr::V6(SocketAddrV6::new(
|
||||||
|
Ipv6Addr::from([
|
||||||
|
92, 114, 235, 3, 244, 64, 38, 111, 20, 100, 199, 241, 19, 174, 220, 123,
|
||||||
|
]),
|
||||||
|
0x1234,
|
||||||
|
0x12345678,
|
||||||
|
0x87654321,
|
||||||
|
));
|
||||||
|
|
||||||
|
let mut buffer = [0_u8; MAX_ADDR_SIZE];
|
||||||
|
let encoded_len = ip.encode(&mut buffer);
|
||||||
|
|
||||||
|
assert_eq!(encoded_len, Ok(27));
|
||||||
|
assert_eq!(
|
||||||
|
&buffer[0..27],
|
||||||
|
&[
|
||||||
|
IPV6_MARKER, // marker
|
||||||
|
// Start of ipv6 address
|
||||||
|
92,
|
||||||
|
114,
|
||||||
|
235,
|
||||||
|
3,
|
||||||
|
244,
|
||||||
|
64,
|
||||||
|
38,
|
||||||
|
111,
|
||||||
|
20,
|
||||||
|
100,
|
||||||
|
199,
|
||||||
|
241,
|
||||||
|
19,
|
||||||
|
174,
|
||||||
|
220,
|
||||||
|
123,
|
||||||
|
// LE port
|
||||||
|
0x34,
|
||||||
|
0x12,
|
||||||
|
// LE flowinfo
|
||||||
|
0x78,
|
||||||
|
0x56,
|
||||||
|
0x34,
|
||||||
|
0x12,
|
||||||
|
// LE scope_id
|
||||||
|
0x21,
|
||||||
|
0x43,
|
||||||
|
0x65,
|
||||||
|
0x87,
|
||||||
|
][..]
|
||||||
|
);
|
||||||
|
|
||||||
|
let decoded = SocketAddr::decode(&buffer);
|
||||||
|
|
||||||
|
assert_eq!(decoded, Ok(ip));
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_encode_ipv4_with_short_buffer() {
|
||||||
|
let mut buffer = vec![0u8; IPV4_ADDRESS_SIZE - 1];
|
||||||
|
let ip = SocketAddr::V4(SocketAddrV4::new(Ipv4Addr::from([56, 128, 35, 5]), 0x1234));
|
||||||
|
|
||||||
|
let result = ip.encode(&mut buffer);
|
||||||
|
|
||||||
|
assert_eq!(result, Err(Error::ErrBufferShort));
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_encode_ipv6_with_short_buffer() {
|
||||||
|
let mut buffer = vec![0u8; MAX_ADDR_SIZE - 1];
|
||||||
|
let ip = SocketAddr::V6(SocketAddrV6::new(
|
||||||
|
Ipv6Addr::from([
|
||||||
|
92, 114, 235, 3, 244, 64, 38, 111, 20, 100, 199, 241, 19, 174, 220, 123,
|
||||||
|
]),
|
||||||
|
0x1234,
|
||||||
|
0x12345678,
|
||||||
|
0x87654321,
|
||||||
|
));
|
||||||
|
|
||||||
|
let result = ip.encode(&mut buffer);
|
||||||
|
|
||||||
|
assert_eq!(result, Err(Error::ErrBufferShort));
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_decode_ipv4_with_short_buffer() {
|
||||||
|
let buffer = vec![IPV4_MARKER, 0];
|
||||||
|
|
||||||
|
let result = SocketAddr::decode(&buffer);
|
||||||
|
|
||||||
|
assert_eq!(result, Err(Error::ErrBufferShort));
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_decode_ipv6_with_short_buffer() {
|
||||||
|
let buffer = vec![IPV6_MARKER, 0];
|
||||||
|
|
||||||
|
let result = SocketAddr::decode(&buffer);
|
||||||
|
|
||||||
|
assert_eq!(result, Err(Error::ErrBufferShort));
|
||||||
|
}
|
||||||
|
}
|
||||||
+316
@@ -0,0 +1,316 @@
|
|||||||
|
use std::collections::HashSet;
|
||||||
|
use std::convert::TryInto;
|
||||||
|
use std::io;
|
||||||
|
use std::net::SocketAddr;
|
||||||
|
use std::sync::{Arc, Weak};
|
||||||
|
|
||||||
|
use async_trait::async_trait;
|
||||||
|
use tokio::sync::watch;
|
||||||
|
use util::sync::Mutex;
|
||||||
|
use util::{Buffer, Conn, Error};
|
||||||
|
|
||||||
|
use super::socket_addr_ext::{SocketAddrExt, MAX_ADDR_SIZE};
|
||||||
|
use super::{normalize_socket_addr, RECEIVE_MTU};
|
||||||
|
|
||||||
|
/// A trait for a [`UDPMuxConn`] to communicate with an UDP mux.
|
||||||
|
#[async_trait]
|
||||||
|
pub trait UDPMuxWriter {
|
||||||
|
/// Registers an address for the given connection.
|
||||||
|
async fn register_conn_for_address(&self, conn: &UDPMuxConn, addr: SocketAddr);
|
||||||
|
/// Sends the content of the buffer to the given target.
|
||||||
|
///
|
||||||
|
/// Returns the number of bytes sent or an error, if any.
|
||||||
|
async fn send_to(&self, buf: &[u8], target: &SocketAddr) -> Result<usize, Error>;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Parameters for a [`UDPMuxConn`].
|
||||||
|
pub struct UDPMuxConnParams {
|
||||||
|
/// Local socket address.
|
||||||
|
pub local_addr: SocketAddr,
|
||||||
|
/// Static key identifying the connection.
|
||||||
|
pub key: String,
|
||||||
|
/// A `std::sync::Weak` reference to the UDP mux.
|
||||||
|
///
|
||||||
|
/// NOTE: a non-owning reference should be used to prevent possible cycles.
|
||||||
|
pub udp_mux: Weak<dyn UDPMuxWriter + Send + Sync>,
|
||||||
|
}
|
||||||
|
|
||||||
|
type ConnResult<T> = Result<T, util::Error>;
|
||||||
|
|
||||||
|
/// A UDP mux connection.
|
||||||
|
#[derive(Clone)]
|
||||||
|
pub struct UDPMuxConn {
|
||||||
|
/// Close Receiver. A copy of this can be obtained via [`close_tx`].
|
||||||
|
closed_watch_rx: watch::Receiver<bool>,
|
||||||
|
|
||||||
|
inner: Arc<UDPMuxConnInner>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl UDPMuxConn {
|
||||||
|
/// Creates a new [`UDPMuxConn`].
|
||||||
|
pub fn new(params: UDPMuxConnParams) -> Self {
|
||||||
|
let (closed_watch_tx, closed_watch_rx) = watch::channel(false);
|
||||||
|
|
||||||
|
Self {
|
||||||
|
closed_watch_rx,
|
||||||
|
inner: Arc::new(UDPMuxConnInner {
|
||||||
|
params,
|
||||||
|
closed_watch_tx: Mutex::new(Some(closed_watch_tx)),
|
||||||
|
addresses: Default::default(),
|
||||||
|
buffer: Buffer::new(0, 0),
|
||||||
|
}),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a key identifying this connection.
|
||||||
|
pub fn key(&self) -> &str {
|
||||||
|
&self.inner.params.key
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Writes data to the given address. Returns an error if the buffer is too short or there's an
|
||||||
|
/// encoding error.
|
||||||
|
pub async fn write_packet(&self, data: &[u8], addr: SocketAddr) -> ConnResult<()> {
|
||||||
|
// NOTE: Pion/ice uses Sync.Pool to optimise this.
|
||||||
|
let mut buffer = make_buffer();
|
||||||
|
let mut offset = 0;
|
||||||
|
|
||||||
|
if (data.len() + MAX_ADDR_SIZE) > (RECEIVE_MTU + MAX_ADDR_SIZE) {
|
||||||
|
return Err(Error::ErrBufferShort);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Format of buffer: | data len(2) | data bytes(dn) | addr len(2) | addr bytes(an) |
|
||||||
|
// Where the number in parenthesis indicate the number of bytes used
|
||||||
|
// `dn` and `an` are the length in bytes of data and addr respectively.
|
||||||
|
|
||||||
|
// SAFETY: `data.len()` is at most RECEIVE_MTU(8192) - MAX_ADDR_SIZE(27)
|
||||||
|
buffer[0..2].copy_from_slice(&(data.len() as u16).to_le_bytes()[..]);
|
||||||
|
offset += 2;
|
||||||
|
|
||||||
|
buffer[offset..offset + data.len()].copy_from_slice(data);
|
||||||
|
offset += data.len();
|
||||||
|
|
||||||
|
let len = addr.encode(&mut buffer[offset + 2..])?;
|
||||||
|
buffer[offset..offset + 2].copy_from_slice(&(len as u16).to_le_bytes()[..]);
|
||||||
|
offset += 2 + len;
|
||||||
|
|
||||||
|
self.inner.buffer.write(&buffer[..offset]).await?;
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns true if this connection is closed.
|
||||||
|
pub fn is_closed(&self) -> bool {
|
||||||
|
self.inner.is_closed()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Gets a copy of the close [`tokio::sync::watch::Receiver`] that fires when this
|
||||||
|
/// connection is closed.
|
||||||
|
pub fn close_rx(&self) -> watch::Receiver<bool> {
|
||||||
|
self.closed_watch_rx.clone()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Closes this connection.
|
||||||
|
pub fn close(&self) {
|
||||||
|
self.inner.close();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Gets the list of the addresses associated with this connection.
|
||||||
|
pub fn get_addresses(&self) -> Vec<SocketAddr> {
|
||||||
|
self.inner.get_addresses()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Registers a new address for this connection.
|
||||||
|
pub async fn add_address(&self, addr: SocketAddr) {
|
||||||
|
self.inner.add_address(addr);
|
||||||
|
if let Some(mux) = self.inner.params.udp_mux.upgrade() {
|
||||||
|
mux.register_conn_for_address(self, addr).await;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Deregisters an address.
|
||||||
|
pub fn remove_address(&self, addr: &SocketAddr) {
|
||||||
|
self.inner.remove_address(addr)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns true if the given address is associated with this connection.
|
||||||
|
pub fn contains_address(&self, addr: &SocketAddr) -> bool {
|
||||||
|
self.inner.contains_address(addr)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
struct UDPMuxConnInner {
|
||||||
|
params: UDPMuxConnParams,
|
||||||
|
|
||||||
|
/// Close Sender. We'll send a value on this channel when we close
|
||||||
|
closed_watch_tx: Mutex<Option<watch::Sender<bool>>>,
|
||||||
|
|
||||||
|
/// Remote addresses we've seen on this connection.
|
||||||
|
addresses: Mutex<HashSet<SocketAddr>>,
|
||||||
|
|
||||||
|
buffer: Buffer,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl UDPMuxConnInner {
|
||||||
|
// Sending/Recieving
|
||||||
|
async fn recv_from(&self, buf: &mut [u8]) -> ConnResult<(usize, SocketAddr)> {
|
||||||
|
// NOTE: Pion/ice uses Sync.Pool to optimise this.
|
||||||
|
let mut buffer = make_buffer();
|
||||||
|
let mut offset = 0;
|
||||||
|
|
||||||
|
let len = self.buffer.read(&mut buffer, None).await?;
|
||||||
|
// We always have at least.
|
||||||
|
//
|
||||||
|
// * 2 bytes for data len
|
||||||
|
// * 2 bytes for addr len
|
||||||
|
// * 7 bytes for an Ipv4 addr
|
||||||
|
if len < 11 {
|
||||||
|
return Err(Error::ErrBufferShort);
|
||||||
|
}
|
||||||
|
|
||||||
|
let data_len: usize = buffer[..2]
|
||||||
|
.try_into()
|
||||||
|
.map(u16::from_le_bytes)
|
||||||
|
.map(From::from)
|
||||||
|
.unwrap();
|
||||||
|
offset += 2;
|
||||||
|
|
||||||
|
let total = 2 + data_len + 2 + 7;
|
||||||
|
if data_len > buf.len() || total > len {
|
||||||
|
return Err(Error::ErrBufferShort);
|
||||||
|
}
|
||||||
|
|
||||||
|
buf[..data_len].copy_from_slice(&buffer[offset..offset + data_len]);
|
||||||
|
offset += data_len;
|
||||||
|
|
||||||
|
let address_len: usize = buffer[offset..offset + 2]
|
||||||
|
.try_into()
|
||||||
|
.map(u16::from_le_bytes)
|
||||||
|
.map(From::from)
|
||||||
|
.unwrap();
|
||||||
|
offset += 2;
|
||||||
|
|
||||||
|
let addr = SocketAddr::decode(&buffer[offset..offset + address_len])?;
|
||||||
|
|
||||||
|
Ok((data_len, addr))
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn send_to(&self, buf: &[u8], target: &SocketAddr) -> ConnResult<usize> {
|
||||||
|
if let Some(mux) = self.params.udp_mux.upgrade() {
|
||||||
|
mux.send_to(buf, target).await
|
||||||
|
} else {
|
||||||
|
Err(Error::Other(format!(
|
||||||
|
"wanted to send {} bytes to {}, but UDP mux is gone",
|
||||||
|
buf.len(),
|
||||||
|
target
|
||||||
|
)))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fn is_closed(&self) -> bool {
|
||||||
|
self.closed_watch_tx.lock().is_none()
|
||||||
|
}
|
||||||
|
|
||||||
|
fn close(self: &Arc<Self>) {
|
||||||
|
let mut closed_tx = self.closed_watch_tx.lock();
|
||||||
|
|
||||||
|
if let Some(tx) = closed_tx.take() {
|
||||||
|
let _ = tx.send(true);
|
||||||
|
drop(closed_tx);
|
||||||
|
|
||||||
|
let cloned_self = Arc::clone(self);
|
||||||
|
|
||||||
|
{
|
||||||
|
let mut addresses = self.addresses.lock();
|
||||||
|
*addresses = Default::default();
|
||||||
|
}
|
||||||
|
|
||||||
|
// NOTE: Alternatively we could wait on the buffer closing here so that
|
||||||
|
// our caller can wait for things to fully settle down
|
||||||
|
tokio::spawn(async move {
|
||||||
|
cloned_self.buffer.close().await;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fn local_addr(&self) -> SocketAddr {
|
||||||
|
self.params.local_addr
|
||||||
|
}
|
||||||
|
|
||||||
|
// Address related methods
|
||||||
|
pub(super) fn get_addresses(&self) -> Vec<SocketAddr> {
|
||||||
|
let addresses = self.addresses.lock();
|
||||||
|
|
||||||
|
addresses.iter().copied().collect()
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(super) fn add_address(self: &Arc<Self>, addr: SocketAddr) {
|
||||||
|
{
|
||||||
|
let mut addresses = self.addresses.lock();
|
||||||
|
addresses.insert(addr);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(super) fn remove_address(&self, addr: &SocketAddr) {
|
||||||
|
{
|
||||||
|
let mut addresses = self.addresses.lock();
|
||||||
|
addresses.remove(addr);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(super) fn contains_address(&self, addr: &SocketAddr) -> bool {
|
||||||
|
let addresses = self.addresses.lock();
|
||||||
|
|
||||||
|
addresses.contains(addr)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[async_trait]
|
||||||
|
impl Conn for UDPMuxConn {
|
||||||
|
async fn connect(&self, _addr: SocketAddr) -> ConnResult<()> {
|
||||||
|
Err(io::Error::new(io::ErrorKind::Other, "Not applicable").into())
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn recv(&self, _buf: &mut [u8]) -> ConnResult<usize> {
|
||||||
|
Err(io::Error::new(io::ErrorKind::Other, "Not applicable").into())
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn recv_from(&self, buf: &mut [u8]) -> ConnResult<(usize, SocketAddr)> {
|
||||||
|
self.inner.recv_from(buf).await
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn send(&self, _buf: &[u8]) -> ConnResult<usize> {
|
||||||
|
Err(io::Error::new(io::ErrorKind::Other, "Not applicable").into())
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn send_to(&self, buf: &[u8], target: SocketAddr) -> ConnResult<usize> {
|
||||||
|
let normalized_target = normalize_socket_addr(&target, &self.inner.params.local_addr);
|
||||||
|
|
||||||
|
if !self.contains_address(&normalized_target) {
|
||||||
|
self.add_address(normalized_target).await;
|
||||||
|
}
|
||||||
|
|
||||||
|
self.inner.send_to(buf, &normalized_target).await
|
||||||
|
}
|
||||||
|
|
||||||
|
fn local_addr(&self) -> ConnResult<SocketAddr> {
|
||||||
|
Ok(self.inner.local_addr())
|
||||||
|
}
|
||||||
|
|
||||||
|
fn remote_addr(&self) -> Option<SocketAddr> {
|
||||||
|
None
|
||||||
|
}
|
||||||
|
async fn close(&self) -> ConnResult<()> {
|
||||||
|
self.inner.close();
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[inline(always)]
|
||||||
|
/// Create a buffer of appropriate size to fit both a packet with max RECEIVE_MTU and the
|
||||||
|
/// additional metadata used for muxing.
|
||||||
|
fn make_buffer() -> Vec<u8> {
|
||||||
|
// The 4 extra bytes are used to encode the length of the data and address respectively.
|
||||||
|
// See [`write_packet`] for details.
|
||||||
|
vec![0u8; RECEIVE_MTU + MAX_ADDR_SIZE + 2 + 2]
|
||||||
|
}
|
||||||
+292
@@ -0,0 +1,292 @@
|
|||||||
|
use std::convert::TryInto;
|
||||||
|
use std::io;
|
||||||
|
use std::time::Duration;
|
||||||
|
|
||||||
|
use rand::{thread_rng, Rng};
|
||||||
|
use sha1::{Digest, Sha1};
|
||||||
|
use stun::message::{Message, BINDING_REQUEST};
|
||||||
|
use tokio::net::UdpSocket;
|
||||||
|
use tokio::time::{sleep, timeout};
|
||||||
|
|
||||||
|
use super::*;
|
||||||
|
use crate::error::Result;
|
||||||
|
|
||||||
|
#[derive(Debug, Copy, Clone)]
|
||||||
|
enum Network {
|
||||||
|
Ipv4,
|
||||||
|
Ipv6,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Network {
|
||||||
|
/// Bind the UDP socket for the "remote".
|
||||||
|
async fn bind(self) -> io::Result<UdpSocket> {
|
||||||
|
match self {
|
||||||
|
Network::Ipv4 => UdpSocket::bind("0.0.0.0:0").await,
|
||||||
|
Network::Ipv6 => UdpSocket::bind("[::]:0").await,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Connect ip from the "remote".
|
||||||
|
fn connect_ip(self, port: u16) -> String {
|
||||||
|
match self {
|
||||||
|
Network::Ipv4 => format!("127.0.0.1:{port}"),
|
||||||
|
Network::Ipv6 => format!("[::1]:{port}"),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const TIMEOUT: Duration = Duration::from_secs(60);
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
async fn test_udp_mux() -> Result<()> {
|
||||||
|
use std::io::Write;
|
||||||
|
env_logger::Builder::from_default_env()
|
||||||
|
.format(|buf, record| {
|
||||||
|
writeln!(
|
||||||
|
buf,
|
||||||
|
"{}:{} [{}] {} - {}",
|
||||||
|
record.file().unwrap_or("unknown"),
|
||||||
|
record.line().unwrap_or(0),
|
||||||
|
record.level(),
|
||||||
|
chrono::Local::now().format("%H:%M:%S.%6f"),
|
||||||
|
record.args()
|
||||||
|
)
|
||||||
|
})
|
||||||
|
.init();
|
||||||
|
|
||||||
|
// TODO: Support IPv6 dual stack. This works Linux and macOS, but not Windows.
|
||||||
|
#[cfg(all(unix, target_pointer_width = "64"))]
|
||||||
|
let udp_socket = UdpSocket::bind((std::net::Ipv6Addr::UNSPECIFIED, 0)).await?;
|
||||||
|
|
||||||
|
#[cfg(any(not(unix), not(target_pointer_width = "64")))]
|
||||||
|
let udp_socket = UdpSocket::bind((std::net::Ipv4Addr::UNSPECIFIED, 0)).await?;
|
||||||
|
|
||||||
|
let addr = udp_socket.local_addr()?;
|
||||||
|
log::info!("Listening on {}", addr);
|
||||||
|
|
||||||
|
let udp_mux = UDPMuxDefault::new(UDPMuxParams::new(udp_socket));
|
||||||
|
let udp_mux_dyn = Arc::clone(&udp_mux) as Arc<dyn UDPMux + Send + Sync>;
|
||||||
|
|
||||||
|
let udp_mux_dyn_1 = Arc::clone(&udp_mux_dyn);
|
||||||
|
let h1 = tokio::spawn(async move {
|
||||||
|
timeout(
|
||||||
|
TIMEOUT,
|
||||||
|
test_mux_connection(Arc::clone(&udp_mux_dyn_1), "ufrag1", addr, Network::Ipv4),
|
||||||
|
)
|
||||||
|
.await
|
||||||
|
});
|
||||||
|
|
||||||
|
let udp_mux_dyn_2 = Arc::clone(&udp_mux_dyn);
|
||||||
|
let h2 = tokio::spawn(async move {
|
||||||
|
timeout(
|
||||||
|
TIMEOUT,
|
||||||
|
test_mux_connection(Arc::clone(&udp_mux_dyn_2), "ufrag2", addr, Network::Ipv4),
|
||||||
|
)
|
||||||
|
.await
|
||||||
|
});
|
||||||
|
|
||||||
|
let all_results;
|
||||||
|
|
||||||
|
#[cfg(all(unix, target_pointer_width = "64"))]
|
||||||
|
{
|
||||||
|
// TODO: Support IPv6 dual stack. This works Linux and macOS, but not Windows.
|
||||||
|
let udp_mux_dyn_3 = Arc::clone(&udp_mux_dyn);
|
||||||
|
let h3 = tokio::spawn(async move {
|
||||||
|
timeout(
|
||||||
|
TIMEOUT,
|
||||||
|
test_mux_connection(Arc::clone(&udp_mux_dyn_3), "ufrag3", addr, Network::Ipv6),
|
||||||
|
)
|
||||||
|
.await
|
||||||
|
});
|
||||||
|
|
||||||
|
let (r1, r2, r3) = tokio::join!(h1, h2, h3);
|
||||||
|
all_results = [r1, r2, r3];
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(any(not(unix), not(target_pointer_width = "64")))]
|
||||||
|
{
|
||||||
|
let (r1, r2) = tokio::join!(h1, h2);
|
||||||
|
all_results = [r1, r2];
|
||||||
|
}
|
||||||
|
|
||||||
|
for timeout_result in &all_results {
|
||||||
|
// Timeout error
|
||||||
|
match timeout_result {
|
||||||
|
Err(timeout_err) => {
|
||||||
|
panic!("Mux test timedout: {timeout_err:?}");
|
||||||
|
}
|
||||||
|
|
||||||
|
// Join error
|
||||||
|
Ok(join_result) => match join_result {
|
||||||
|
Err(err) => {
|
||||||
|
panic!("Mux test failed with join error: {err:?}");
|
||||||
|
}
|
||||||
|
// Actual error
|
||||||
|
Ok(mux_result) => {
|
||||||
|
if let Err(err) = mux_result {
|
||||||
|
panic!("Mux test failed with error: {err:?}");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
let timeout = all_results.iter().find_map(|r| r.as_ref().err());
|
||||||
|
assert!(
|
||||||
|
timeout.is_none(),
|
||||||
|
"At least one of the muxed tasks timedout {all_results:?}"
|
||||||
|
);
|
||||||
|
|
||||||
|
let res = udp_mux.close().await;
|
||||||
|
assert!(res.is_ok());
|
||||||
|
let res = udp_mux.get_conn("failurefrag").await;
|
||||||
|
|
||||||
|
assert!(
|
||||||
|
res.is_err(),
|
||||||
|
"Getting connections after UDPMuxDefault is closed should fail"
|
||||||
|
);
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
async fn test_mux_connection(
|
||||||
|
mux: Arc<dyn UDPMux + Send + Sync>,
|
||||||
|
ufrag: &str,
|
||||||
|
listener_addr: SocketAddr,
|
||||||
|
network: Network,
|
||||||
|
) -> Result<()> {
|
||||||
|
let conn = mux.get_conn(ufrag).await?;
|
||||||
|
// FIXME: Cleanup
|
||||||
|
|
||||||
|
let connect_addr = network
|
||||||
|
.connect_ip(listener_addr.port())
|
||||||
|
.parse::<SocketAddr>()
|
||||||
|
.unwrap();
|
||||||
|
|
||||||
|
let remote_connection = Arc::new(network.bind().await?);
|
||||||
|
log::info!("Bound for ufrag: {}", ufrag);
|
||||||
|
remote_connection.connect(connect_addr).await?;
|
||||||
|
log::info!("Connected to {} for ufrag: {}", connect_addr, ufrag);
|
||||||
|
log::info!(
|
||||||
|
"Testing muxing from {} over {}",
|
||||||
|
remote_connection.local_addr().unwrap(),
|
||||||
|
listener_addr
|
||||||
|
);
|
||||||
|
|
||||||
|
// These bytes should be dropped
|
||||||
|
remote_connection.send("Dropped bytes".as_bytes()).await?;
|
||||||
|
|
||||||
|
sleep(Duration::from_millis(1)).await;
|
||||||
|
|
||||||
|
let stun_msg = {
|
||||||
|
let mut m = Message {
|
||||||
|
typ: BINDING_REQUEST,
|
||||||
|
..Message::default()
|
||||||
|
};
|
||||||
|
|
||||||
|
m.add(ATTR_USERNAME, format!("{ufrag}:otherufrag").as_bytes());
|
||||||
|
|
||||||
|
m.marshal_binary().unwrap()
|
||||||
|
};
|
||||||
|
|
||||||
|
let remote_connection_addr = remote_connection.local_addr()?;
|
||||||
|
|
||||||
|
conn.send_to(&stun_msg, remote_connection_addr).await?;
|
||||||
|
|
||||||
|
let mut buffer = vec![0u8; RECEIVE_MTU];
|
||||||
|
let len = remote_connection.recv(&mut buffer).await?;
|
||||||
|
assert_eq!(buffer[..len], stun_msg);
|
||||||
|
|
||||||
|
const TARGET_SIZE: usize = 1024 * 1024;
|
||||||
|
|
||||||
|
// Read on the muxed side
|
||||||
|
let conn_2 = Arc::clone(&conn);
|
||||||
|
let mux_handle = tokio::spawn(async move {
|
||||||
|
let conn = conn_2;
|
||||||
|
|
||||||
|
let mut buffer = vec![0u8; RECEIVE_MTU];
|
||||||
|
let mut next_sequence = 0;
|
||||||
|
let mut read = 0;
|
||||||
|
|
||||||
|
while read < TARGET_SIZE {
|
||||||
|
let (n, _) = conn
|
||||||
|
.recv_from(&mut buffer)
|
||||||
|
.await
|
||||||
|
.expect("recv_from should not error");
|
||||||
|
assert_eq!(n, RECEIVE_MTU);
|
||||||
|
|
||||||
|
verify_packet(&buffer[..n], next_sequence);
|
||||||
|
|
||||||
|
conn.send_to(&buffer[..n], remote_connection_addr)
|
||||||
|
.await
|
||||||
|
.expect("Failed to write to muxxed connection");
|
||||||
|
|
||||||
|
read += n;
|
||||||
|
log::debug!("Muxxed read {}, sequence: {}", read, next_sequence);
|
||||||
|
next_sequence += 1;
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
let remote_connection_2 = Arc::clone(&remote_connection);
|
||||||
|
let remote_handle = tokio::spawn(async move {
|
||||||
|
let remote_connection = remote_connection_2;
|
||||||
|
let mut buffer = vec![0u8; RECEIVE_MTU];
|
||||||
|
let mut next_sequence = 0;
|
||||||
|
let mut read = 0;
|
||||||
|
|
||||||
|
while read < TARGET_SIZE {
|
||||||
|
let n = remote_connection
|
||||||
|
.recv(&mut buffer)
|
||||||
|
.await
|
||||||
|
.expect("recv_from should not error");
|
||||||
|
assert_eq!(n, RECEIVE_MTU);
|
||||||
|
|
||||||
|
verify_packet(&buffer[..n], next_sequence);
|
||||||
|
read += n;
|
||||||
|
log::debug!("Remote read {}, sequence: {}", read, next_sequence);
|
||||||
|
next_sequence += 1;
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
let mut sequence: u32 = 0;
|
||||||
|
let mut written = 0;
|
||||||
|
let mut buffer = vec![0u8; RECEIVE_MTU];
|
||||||
|
while written < TARGET_SIZE {
|
||||||
|
thread_rng().fill(&mut buffer[24..]);
|
||||||
|
|
||||||
|
let hash = sha1_hash(&buffer[24..]);
|
||||||
|
buffer[4..24].copy_from_slice(&hash);
|
||||||
|
buffer[0..4].copy_from_slice(&sequence.to_le_bytes());
|
||||||
|
|
||||||
|
let len = remote_connection.send(&buffer).await?;
|
||||||
|
|
||||||
|
written += len;
|
||||||
|
log::debug!("Data written {}, sequence: {}", written, sequence);
|
||||||
|
sequence += 1;
|
||||||
|
|
||||||
|
sleep(Duration::from_millis(1)).await;
|
||||||
|
}
|
||||||
|
|
||||||
|
let (r1, r2) = tokio::join!(mux_handle, remote_handle);
|
||||||
|
assert!(r1.is_ok() && r2.is_ok());
|
||||||
|
|
||||||
|
let res = conn.close().await;
|
||||||
|
assert!(res.is_ok(), "Failed to close Conn: {res:?}");
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
fn verify_packet(buffer: &[u8], next_sequence: u32) {
|
||||||
|
let read_sequence = u32::from_le_bytes(buffer[0..4].try_into().unwrap());
|
||||||
|
assert_eq!(read_sequence, next_sequence);
|
||||||
|
|
||||||
|
let hash = sha1_hash(&buffer[24..]);
|
||||||
|
assert_eq!(hash, buffer[4..24]);
|
||||||
|
}
|
||||||
|
|
||||||
|
fn sha1_hash(buffer: &[u8]) -> Vec<u8> {
|
||||||
|
let mut hasher = Sha1::new();
|
||||||
|
hasher.update(&buffer[24..]);
|
||||||
|
|
||||||
|
hasher.finalize().to_vec()
|
||||||
|
}
|
||||||
Vendored
+116
@@ -0,0 +1,116 @@
|
|||||||
|
use std::sync::Arc;
|
||||||
|
|
||||||
|
use super::udp_mux::UDPMux;
|
||||||
|
use super::Error;
|
||||||
|
|
||||||
|
#[derive(Default, Clone)]
|
||||||
|
pub struct EphemeralUDP {
|
||||||
|
port_min: u16,
|
||||||
|
port_max: u16,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl EphemeralUDP {
|
||||||
|
pub fn new(port_min: u16, port_max: u16) -> Result<Self, Error> {
|
||||||
|
let mut s = Self::default();
|
||||||
|
s.set_ports(port_min, port_max)?;
|
||||||
|
|
||||||
|
Ok(s)
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn port_min(&self) -> u16 {
|
||||||
|
self.port_min
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn port_max(&self) -> u16 {
|
||||||
|
self.port_max
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn set_ports(&mut self, port_min: u16, port_max: u16) -> Result<(), Error> {
|
||||||
|
if port_max < port_min {
|
||||||
|
return Err(Error::ErrPort);
|
||||||
|
}
|
||||||
|
|
||||||
|
self.port_min = port_min;
|
||||||
|
self.port_max = port_max;
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Configuration for the underlying UDP network stack.
|
||||||
|
/// There are two ways to configure this Ephemeral and Muxed.
|
||||||
|
///
|
||||||
|
/// **Ephemeral mode**
|
||||||
|
///
|
||||||
|
/// In Ephemeral mode sockets are created and bound to random ports during ICE
|
||||||
|
/// gathering. The ports to use can be restricted by setting [`EphemeralUDP::port_min`] and
|
||||||
|
/// [`EphemeralEphemeralUDP::port_max`] in which case only ports in this range will be used.
|
||||||
|
///
|
||||||
|
/// **Muxed**
|
||||||
|
///
|
||||||
|
/// In muxed mode a single UDP socket is used and all connections are muxed over this single socket.
|
||||||
|
///
|
||||||
|
#[derive(Clone)]
|
||||||
|
pub enum UDPNetwork {
|
||||||
|
Ephemeral(EphemeralUDP),
|
||||||
|
Muxed(Arc<dyn UDPMux + Send + Sync>),
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for UDPNetwork {
|
||||||
|
fn default() -> Self {
|
||||||
|
Self::Ephemeral(Default::default())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl UDPNetwork {
|
||||||
|
fn is_ephemeral(&self) -> bool {
|
||||||
|
matches!(self, Self::Ephemeral(_))
|
||||||
|
}
|
||||||
|
|
||||||
|
fn is_muxed(&self) -> bool {
|
||||||
|
matches!(self, Self::Muxed(_))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod test {
|
||||||
|
use super::EphemeralUDP;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_ephemeral_udp_constructor() {
|
||||||
|
assert!(
|
||||||
|
EphemeralUDP::new(3000, 2999).is_err(),
|
||||||
|
"EphemeralUDP should not allow invalid port range"
|
||||||
|
);
|
||||||
|
|
||||||
|
let e = EphemeralUDP::default();
|
||||||
|
assert_eq!(e.port_min(), 0, "EphemeralUDP should default port_min to 0");
|
||||||
|
assert_eq!(e.port_max(), 0, "EphemeralUDP should default port_max to 0");
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_ephemeral_udp_set_ports() {
|
||||||
|
let mut e = EphemeralUDP::default();
|
||||||
|
|
||||||
|
assert!(
|
||||||
|
e.set_ports(3000, 2999).is_err(),
|
||||||
|
"EphemeralUDP should not allow invalid port range"
|
||||||
|
);
|
||||||
|
|
||||||
|
assert!(
|
||||||
|
e.set_ports(6000, 6001).is_ok(),
|
||||||
|
"EphemeralUDP::set_ports should allow valid port range"
|
||||||
|
);
|
||||||
|
|
||||||
|
assert_eq!(
|
||||||
|
e.port_min(),
|
||||||
|
6000,
|
||||||
|
"Ports set with `EphemeralUDP::set_ports` should be reflected"
|
||||||
|
);
|
||||||
|
assert_eq!(
|
||||||
|
e.port_max(),
|
||||||
|
6001,
|
||||||
|
"Ports set with `EphemeralUDP::set_ports` should be reflected"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
Vendored
+266
@@ -0,0 +1,266 @@
|
|||||||
|
#[cfg(test)]
|
||||||
|
mod url_test;
|
||||||
|
|
||||||
|
use std::borrow::Cow;
|
||||||
|
use std::convert::From;
|
||||||
|
use std::fmt;
|
||||||
|
|
||||||
|
use crate::error::*;
|
||||||
|
|
||||||
|
/// The type of server used in the ice.URL structure.
|
||||||
|
#[derive(PartialEq, Eq, Debug, Copy, Clone)]
|
||||||
|
pub enum SchemeType {
|
||||||
|
/// The URL represents a STUN server.
|
||||||
|
Stun,
|
||||||
|
|
||||||
|
/// The URL represents a STUNS (secure) server.
|
||||||
|
Stuns,
|
||||||
|
|
||||||
|
/// The URL represents a TURN server.
|
||||||
|
Turn,
|
||||||
|
|
||||||
|
/// The URL represents a TURNS (secure) server.
|
||||||
|
Turns,
|
||||||
|
|
||||||
|
/// Default public constant to use for "enum" like struct comparisons when no value was defined.
|
||||||
|
Unknown,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for SchemeType {
|
||||||
|
fn default() -> Self {
|
||||||
|
Self::Unknown
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl From<&str> for SchemeType {
|
||||||
|
/// Defines a procedure for creating a new `SchemeType` from a raw
|
||||||
|
/// string naming the scheme type.
|
||||||
|
fn from(raw: &str) -> Self {
|
||||||
|
match raw {
|
||||||
|
"stun" => Self::Stun,
|
||||||
|
"stuns" => Self::Stuns,
|
||||||
|
"turn" => Self::Turn,
|
||||||
|
"turns" => Self::Turns,
|
||||||
|
_ => Self::Unknown,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for SchemeType {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||||
|
let s = match *self {
|
||||||
|
SchemeType::Stun => "stun",
|
||||||
|
SchemeType::Stuns => "stuns",
|
||||||
|
SchemeType::Turn => "turn",
|
||||||
|
SchemeType::Turns => "turns",
|
||||||
|
SchemeType::Unknown => "unknown",
|
||||||
|
};
|
||||||
|
write!(f, "{s}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// The transport protocol type that is used in the `ice::url::Url` structure.
|
||||||
|
#[derive(PartialEq, Eq, Debug, Copy, Clone)]
|
||||||
|
pub enum ProtoType {
|
||||||
|
/// The URL uses a UDP transport.
|
||||||
|
Udp,
|
||||||
|
|
||||||
|
/// The URL uses a TCP transport.
|
||||||
|
Tcp,
|
||||||
|
|
||||||
|
Unknown,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for ProtoType {
|
||||||
|
fn default() -> Self {
|
||||||
|
Self::Udp
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// defines a procedure for creating a new ProtoType from a raw
|
||||||
|
// string naming the transport protocol type.
|
||||||
|
impl From<&str> for ProtoType {
|
||||||
|
// NewSchemeType defines a procedure for creating a new SchemeType from a raw
|
||||||
|
// string naming the scheme type.
|
||||||
|
fn from(raw: &str) -> Self {
|
||||||
|
match raw {
|
||||||
|
"udp" => Self::Udp,
|
||||||
|
"tcp" => Self::Tcp,
|
||||||
|
_ => Self::Unknown,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for ProtoType {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||||
|
let s = match *self {
|
||||||
|
Self::Udp => "udp",
|
||||||
|
Self::Tcp => "tcp",
|
||||||
|
Self::Unknown => "unknown",
|
||||||
|
};
|
||||||
|
write!(f, "{s}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Represents a STUN (rfc7064) or TURN (rfc7065) URL.
|
||||||
|
#[derive(Debug, Clone, Default)]
|
||||||
|
pub struct Url {
|
||||||
|
pub scheme: SchemeType,
|
||||||
|
pub host: String,
|
||||||
|
pub port: u16,
|
||||||
|
pub username: String,
|
||||||
|
pub password: String,
|
||||||
|
pub proto: ProtoType,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl fmt::Display for Url {
|
||||||
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||||
|
let host = if self.host.contains("::") {
|
||||||
|
"[".to_owned() + self.host.as_str() + "]"
|
||||||
|
} else {
|
||||||
|
self.host.clone()
|
||||||
|
};
|
||||||
|
if self.scheme == SchemeType::Turn || self.scheme == SchemeType::Turns {
|
||||||
|
write!(
|
||||||
|
f,
|
||||||
|
"{}:{}:{}?transport={}",
|
||||||
|
self.scheme, host, self.port, self.proto
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
write!(f, "{}:{}:{}", self.scheme, host, self.port)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Url {
|
||||||
|
/// Parses a STUN or TURN urls following the ABNF syntax described in
|
||||||
|
/// [IETF rfc-7064](https://tools.ietf.org/html/rfc7064) and
|
||||||
|
/// [IETF rfc-7065](https://tools.ietf.org/html/rfc7065) respectively.
|
||||||
|
pub fn parse_url(raw: &str) -> Result<Self> {
|
||||||
|
// work around for url crate
|
||||||
|
if raw.contains("//") {
|
||||||
|
return Err(Error::ErrInvalidUrl);
|
||||||
|
}
|
||||||
|
|
||||||
|
let mut s = raw.to_string();
|
||||||
|
let pos = raw.find(':');
|
||||||
|
if let Some(p) = pos {
|
||||||
|
s.replace_range(p..=p, "://");
|
||||||
|
} else {
|
||||||
|
return Err(Error::ErrSchemeType);
|
||||||
|
}
|
||||||
|
|
||||||
|
let raw_parts = url::Url::parse(&s)?;
|
||||||
|
|
||||||
|
let scheme = raw_parts.scheme().into();
|
||||||
|
|
||||||
|
let host = if let Some(host) = raw_parts.host_str() {
|
||||||
|
host.trim()
|
||||||
|
.trim_start_matches('[')
|
||||||
|
.trim_end_matches(']')
|
||||||
|
.to_owned()
|
||||||
|
} else {
|
||||||
|
return Err(Error::ErrHost);
|
||||||
|
};
|
||||||
|
|
||||||
|
let port = if let Some(port) = raw_parts.port() {
|
||||||
|
port
|
||||||
|
} else if scheme == SchemeType::Stun || scheme == SchemeType::Turn {
|
||||||
|
3478
|
||||||
|
} else {
|
||||||
|
5349
|
||||||
|
};
|
||||||
|
|
||||||
|
let mut q_args = raw_parts.query_pairs();
|
||||||
|
let proto = match scheme {
|
||||||
|
SchemeType::Stun => {
|
||||||
|
if q_args.count() > 0 {
|
||||||
|
return Err(Error::ErrStunQuery);
|
||||||
|
}
|
||||||
|
ProtoType::Udp
|
||||||
|
}
|
||||||
|
SchemeType::Stuns => {
|
||||||
|
if q_args.count() > 0 {
|
||||||
|
return Err(Error::ErrStunQuery);
|
||||||
|
}
|
||||||
|
ProtoType::Tcp
|
||||||
|
}
|
||||||
|
SchemeType::Turn => {
|
||||||
|
if q_args.count() > 1 {
|
||||||
|
return Err(Error::ErrInvalidQuery);
|
||||||
|
}
|
||||||
|
if let Some((key, value)) = q_args.next() {
|
||||||
|
if key == Cow::Borrowed("transport") {
|
||||||
|
let proto: ProtoType = value.as_ref().into();
|
||||||
|
if proto == ProtoType::Unknown {
|
||||||
|
return Err(Error::ErrProtoType);
|
||||||
|
}
|
||||||
|
proto
|
||||||
|
} else {
|
||||||
|
return Err(Error::ErrInvalidQuery);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
ProtoType::Udp
|
||||||
|
}
|
||||||
|
}
|
||||||
|
SchemeType::Turns => {
|
||||||
|
if q_args.count() > 1 {
|
||||||
|
return Err(Error::ErrInvalidQuery);
|
||||||
|
}
|
||||||
|
if let Some((key, value)) = q_args.next() {
|
||||||
|
if key == Cow::Borrowed("transport") {
|
||||||
|
let proto: ProtoType = value.as_ref().into();
|
||||||
|
if proto == ProtoType::Unknown {
|
||||||
|
return Err(Error::ErrProtoType);
|
||||||
|
}
|
||||||
|
proto
|
||||||
|
} else {
|
||||||
|
return Err(Error::ErrInvalidQuery);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
ProtoType::Tcp
|
||||||
|
}
|
||||||
|
}
|
||||||
|
SchemeType::Unknown => {
|
||||||
|
return Err(Error::ErrSchemeType);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
Ok(Self {
|
||||||
|
scheme,
|
||||||
|
host,
|
||||||
|
port,
|
||||||
|
username: "".to_owned(),
|
||||||
|
password: "".to_owned(),
|
||||||
|
proto,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
/*
|
||||||
|
fn parse_proto(raw:&str) ->Result<ProtoType> {
|
||||||
|
let qArgs= raw.split('=');
|
||||||
|
if qArgs.len() != 2 {
|
||||||
|
return Err(Error::ErrInvalidQuery.into());
|
||||||
|
}
|
||||||
|
|
||||||
|
var proto ProtoType
|
||||||
|
if rawProto := qArgs.Get("transport"); rawProto != "" {
|
||||||
|
if proto = NewProtoType(rawProto); proto == ProtoType(0) {
|
||||||
|
return ProtoType(Unknown), ErrProtoType
|
||||||
|
}
|
||||||
|
return proto, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
if len(qArgs) > 0 {
|
||||||
|
return ProtoType(Unknown), ErrInvalidQuery
|
||||||
|
}
|
||||||
|
|
||||||
|
return proto, nil
|
||||||
|
}*/
|
||||||
|
|
||||||
|
/// Returns whether the this URL's scheme describes secure scheme or not.
|
||||||
|
#[must_use]
|
||||||
|
pub fn is_secure(&self) -> bool {
|
||||||
|
self.scheme == SchemeType::Stuns || self.scheme == SchemeType::Turns
|
||||||
|
}
|
||||||
|
}
|
||||||
+142
@@ -0,0 +1,142 @@
|
|||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_parse_url_success() -> Result<()> {
|
||||||
|
let tests = vec![
|
||||||
|
(
|
||||||
|
"stun:google.de",
|
||||||
|
"stun:google.de:3478",
|
||||||
|
SchemeType::Stun,
|
||||||
|
false,
|
||||||
|
"google.de",
|
||||||
|
3478,
|
||||||
|
ProtoType::Udp,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
"stun:google.de:1234",
|
||||||
|
"stun:google.de:1234",
|
||||||
|
SchemeType::Stun,
|
||||||
|
false,
|
||||||
|
"google.de",
|
||||||
|
1234,
|
||||||
|
ProtoType::Udp,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
"stuns:google.de",
|
||||||
|
"stuns:google.de:5349",
|
||||||
|
SchemeType::Stuns,
|
||||||
|
true,
|
||||||
|
"google.de",
|
||||||
|
5349,
|
||||||
|
ProtoType::Tcp,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
"stun:[::1]:123",
|
||||||
|
"stun:[::1]:123",
|
||||||
|
SchemeType::Stun,
|
||||||
|
false,
|
||||||
|
"::1",
|
||||||
|
123,
|
||||||
|
ProtoType::Udp,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
"turn:google.de",
|
||||||
|
"turn:google.de:3478?transport=udp",
|
||||||
|
SchemeType::Turn,
|
||||||
|
false,
|
||||||
|
"google.de",
|
||||||
|
3478,
|
||||||
|
ProtoType::Udp,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
"turns:google.de",
|
||||||
|
"turns:google.de:5349?transport=tcp",
|
||||||
|
SchemeType::Turns,
|
||||||
|
true,
|
||||||
|
"google.de",
|
||||||
|
5349,
|
||||||
|
ProtoType::Tcp,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
"turn:google.de?transport=udp",
|
||||||
|
"turn:google.de:3478?transport=udp",
|
||||||
|
SchemeType::Turn,
|
||||||
|
false,
|
||||||
|
"google.de",
|
||||||
|
3478,
|
||||||
|
ProtoType::Udp,
|
||||||
|
),
|
||||||
|
(
|
||||||
|
"turns:google.de?transport=tcp",
|
||||||
|
"turns:google.de:5349?transport=tcp",
|
||||||
|
SchemeType::Turns,
|
||||||
|
true,
|
||||||
|
"google.de",
|
||||||
|
5349,
|
||||||
|
ProtoType::Tcp,
|
||||||
|
),
|
||||||
|
];
|
||||||
|
|
||||||
|
for (
|
||||||
|
raw_url,
|
||||||
|
expected_url_string,
|
||||||
|
expected_scheme,
|
||||||
|
expected_secure,
|
||||||
|
expected_host,
|
||||||
|
expected_port,
|
||||||
|
expected_proto,
|
||||||
|
) in tests
|
||||||
|
{
|
||||||
|
let url = Url::parse_url(raw_url)?;
|
||||||
|
|
||||||
|
assert_eq!(url.scheme, expected_scheme, "testCase: {raw_url:?}");
|
||||||
|
assert_eq!(
|
||||||
|
expected_url_string,
|
||||||
|
url.to_string(),
|
||||||
|
"testCase: {raw_url:?}"
|
||||||
|
);
|
||||||
|
assert_eq!(url.is_secure(), expected_secure, "testCase: {raw_url:?}");
|
||||||
|
assert_eq!(url.host, expected_host, "testCase: {raw_url:?}");
|
||||||
|
assert_eq!(url.port, expected_port, "testCase: {raw_url:?}");
|
||||||
|
assert_eq!(url.proto, expected_proto, "testCase: {raw_url:?}");
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn test_parse_url_failure() -> Result<()> {
|
||||||
|
let tests = vec![
|
||||||
|
("", Error::ErrSchemeType),
|
||||||
|
(":::", Error::ErrUrlParse),
|
||||||
|
("stun:[::1]:123:", Error::ErrPort),
|
||||||
|
("stun:[::1]:123a", Error::ErrPort),
|
||||||
|
("google.de", Error::ErrSchemeType),
|
||||||
|
("stun:", Error::ErrHost),
|
||||||
|
("stun:google.de:abc", Error::ErrPort),
|
||||||
|
("stun:google.de?transport=udp", Error::ErrStunQuery),
|
||||||
|
("stuns:google.de?transport=udp", Error::ErrStunQuery),
|
||||||
|
("turn:google.de?trans=udp", Error::ErrInvalidQuery),
|
||||||
|
("turns:google.de?trans=udp", Error::ErrInvalidQuery),
|
||||||
|
(
|
||||||
|
"turns:google.de?transport=udp&another=1",
|
||||||
|
Error::ErrInvalidQuery,
|
||||||
|
),
|
||||||
|
("turn:google.de?transport=ip", Error::ErrProtoType),
|
||||||
|
];
|
||||||
|
|
||||||
|
for (raw_url, expected_err) in tests {
|
||||||
|
let result = Url::parse_url(raw_url);
|
||||||
|
if let Err(err) = result {
|
||||||
|
assert_eq!(
|
||||||
|
err.to_string(),
|
||||||
|
expected_err.to_string(),
|
||||||
|
"testCase: '{raw_url}', expected err '{expected_err}', but got err '{err}'"
|
||||||
|
);
|
||||||
|
} else {
|
||||||
|
panic!("expected error, but got ok");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
Loaded 100 of 105 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user