iOS Simulator screen stream: ROCKit invalid-connection fault storm and multi-second stalls
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 4/5
- Thời gian dự kiến
- 3-5 ngày
- Mức phù hợp với người mới
- 37/100
- Loại issue
- Lỗi
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- ios, typescript
Hướng nghiên cứu
Start with dist/drivers/ios/screen-capture.js, dist/stream/worker-link.js, dist/stream/captures.js, and dist/stream/feed.js; trace the gateway stream route and correlate each request with helper PID and exit reason. Reproduce by opening the lease stream for about six seconds, closing it, then reopening and watching SimRenderServer logs for invalid connection UUID faults. Done means the helper and native connection lifecycle is understood and a fix is verified to stop sustained faults and stalls across reconnects.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Environment
- Measured: Simlock 0.7.0, packaged iOS screen-capture driver and helper; iOS Simulator runtime 26.5, running in a macOS VM. Measurements on 2026-11-15. macOS and Xcode versions and host hardware are not established here.
- Measured: The fault storm was seen on every streamed simulator examined, including simulators held by other leases, between 19:56 and 20:16 local time. This does not establish behavior on every installation.
Symptoms and evidence
Measured: Opening a stream was followed by two simlock-screen-capture process starts, PID 4985 at 20:24:43 and PID 5151 at 20:24:52 local time. This establishes two starts, not that their lifetimes overlapped or why the second was started. From about 20:24:49, the streamed device's SimRenderServer (PID 3502) emitted approximately 120–270 faults per second. Each was followed by an Activity for state dumps entry (subsystem ROCKit, category RuntimeIssues, sender ROCKit.framework). The fault text included:
ROCKit Soft Assertion Failure ... Failed Condition: errorPropagated -- Runtime error encountered without error propagation channel, aborting. Error: NSPOSIXErrorDomain Code=22 (Invalid connection UUID specified.) connectionUUID=...
Measured: One connection UUID accounted for about 17,600 faults in three minutes; 15 others accounted for 605 each. The message's word “aborting” does not by itself establish that the server process exited.
Measured: Over a 180-second run, the app reported 7,441 unique and 3,232 lost frames, about 59.3 frames/s combined. The received stream nonetheless had gaps of roughly 2–9 seconds. After gaps, chunks resumed at about 16 ms spacing, beginning with a large delta frame and no backlog burst. Per-second guest logs show SimRenderServer and the device's processes silent during each observed stall, followed by a catch-up burst of 500–1,300 lines; ControlCenter and airportd continued logging.
Hypothesis: The gap pattern points toward interruption before or during guest-side capture/delivery rather than ordinary transport buffering. Log silence is consistent with a blocked SimRenderServer, but does not by itself prove where it blocked or exclude every downstream cause. The app's aggregate frame count does not establish uninterrupted frame production at every instant.
Reproduction to try
-
On a Mac with Simlock 0.7.0 and an iOS 26.5 simulator, start the worker and lease a simulator using the documented workflow, for example
simlock lease --platform ios --device "iPhone 16". Launch an app with continuous visible animation or a frame counter. -
Open one Simlock screen stream using the usual viewer. Keep it open for at least three minutes. Record received frame or chunk timestamps and sizes, and the app's frame count. Observe helper starts and exits, for example with
pssampling, including command arguments and parent PIDs. -
In another terminal, capture the relevant unified logs while the stream is open, for example:
log stream --style compact --info --debug --predicate 'process == "SimRenderServer" OR process == "simlock-screen-capture"'Count
Invalid connection UUID specifiedfaults by second and UUID, and correlate stream gaps with SimRenderServer and other process logs. Compare an equivalent interval without a stream, then close and reopen the viewer and check whether the faults persist. Redact identifiers before sharing logs.
Expected: A continuous stream, clean helper lifecycle, and no sustained invalid-connection fault storm. Observed: The rates and stalls above. Unverified: This exact procedure has not been rerun as a minimal independent reproduction; the trigger for the second helper and whether a single open suffices are unknown.
Mechanism to investigate
- Code-backed:
<simlock>/dist/drivers/ios/screen-capture.js:37–48, 53–79starts a helper for each successful capture open. The driver checks the abort signal before starting, but does not subscribe to it after starting. The returned close operation is idempotent. - Code-backed:
<simlock>/dist/stream/worker-link.js:11–22, 32–40registers a slot and starts a feed for each serve call, and releases on abort or close.<simlock>/dist/stream/captures.js:23–36, 50–66keeps a set of slots per device; it does not enforce one capture per device. Multiple opens can therefore spawn multiple helpers, and a new open need not wait for another slot's close. These files alone do not show an automatic restart or prove concurrent helpers in this incident. - Code-backed:
<simlock>/dist/drivers/ios/screen-capture.js:90–109, 123–128closes on stream cancellation, read error, or completion; stopping closes stdin, waits up to two seconds, then sendsSIGKILLand waits up to two more seconds. This JavaScript does not call a display detach API. Whether the native helper detaches on stdin EOF or before a forced kill is not established by the JS.<simlock>/dist/stream/feed.js:4–8, 35–38, 80–87has a 30-second default silence bound and closes on read failure; the reported 2–9-second gaps alone do not reach that default. - Binary inspection: Strings in the packaged helper reference
SimulatorKit.frameworkand framebuffer/display descriptors. Strings do not establish the connection lifecycle, an actual ROCKit API call, or a detach implementation. - Hypothesis: A capture client exits or is replaced without fully tearing down a display/ROCKit connection. SimRenderServer may then repeatedly service a stale connection UUID and fault, possibly on frame-related work, with periodic blocking and stream stalls. The fault storm starts before the second observed helper start, so that second start cannot explain the onset in this timeline. A pre-existing stale connection, an earlier lifecycle event, or a different Apple/runtime defect could also explain it.
Suggested investigation and fixes
- Trace each stream request, helper PID, exit reason, native connection UUID and detach completion; correlate those with fault onset and stalls. Determine whether starts are retries, separate viewers or another path.
- Consider a single shared capture per device/stream with reference-counted viewers, or serialize replacement so the previous helper has exited and detached before the next attaches. Preserve intended multi-viewer behavior.
- In the native helper, explicitly unregister and detach the display/framebuffer connection on normal EOF, cancellation and handled errors before exiting. Ensure close waits for teardown; investigate how to recover when forced termination prevents cleanup.
- Investigate whether the relevant SimulatorKit/ROCKit interface supports an error-propagation handler, and install and handle one where supported. Avoid assuming the assertion can be fixed solely in Simlock.
- Add lifecycle coverage for rapid open/close, overlapping requests, failed startup and forced termination, plus an integration check that faults cease and frames continue after reconnect. Compare the same scenario without Simlock to isolate a Simulator defect.
Explicitly unverified
- The exact macOS, Xcode and hardware versions; whether physical Macs or other simulator runtimes reproduce this.
- Whether the two helpers overlapped, which requests caused them, whether either was killed, or whether a restart happened.
- Which client owns any faulting UUID, whether it is stale, and whether native teardown or an error handler is absent.
- Whether the fault storm causes the stalls, the precise blocking location, or whether a transport or encoder issue contributes.
- Whether the storm occurs without a Simlock stream, persists after closing it, or is specific to Simlock rather than an Apple framework issue.
- Whether the proposed changes eliminate faults or stalls; none has been tested.
Addendum (same day): trigger and a logging A/B
- Measured: Our test harness opens a short probe stream through the gateway (about 6 s, ~7 MB) and closes it immediately before the real stream. That fits the two helper starts per run. A viewer that opens and closes a stream quickly (a reconnect, a preview) may leave the same state; the storm was also present on simulators our harness never touched.
- Measured (A/B, 4 x 300 s, ABBA): turning ROCKit logging off in the guest (
log config --subsystem ROCKit --mode level:off) did not consistently reduce stalls (pairs: 23 -> 7 and 7 -> 8 stalls >= 0.3 s). So the cost is not the logging itself. Across arms, stalls were higher when the storm ran for the whole arm (326 s of SimRenderServer log activity: 12 unexplained stalls) than when it was intermittent (110 s: 2). This is a correlation only. - Likely quickest trigger (from our runs, not yet reduced further): open the gateway's stream for a lease (
GET /v1/leases/<lease>/stream), read for about 6 s, close it, then open it again and keep it open. Then watch SimRenderServer's log forInvalid connection UUID specified.
- Ngôn ngữ chính
- TypeScript
- Star
- 705
- Fork
- 40
- Merge trung bình
- 12 giờ 9 phút
- Pull request đã merge (30 ngày)
- 376
Chuẩn bị môi trường
Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của callstackincubator/simlock
-
request:new
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
callstackincubator/simlock#1806 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug:new
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
callstackincubator/simlock#1780 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
task:draft
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
callstackincubator/simlock#1441 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug:new
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 45/100
callstackincubator/simlock#1805 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug:new
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 45/100
callstackincubator/simlock#1804 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của callstackincubator/simlock
Issue tương tự
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 82/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Update project links after the repository renamesCó thể đã có người làm @JonathanTSilva đã nhận hôm nay. Đang mởai-generated priority: p2 size: xs type: bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 85/100
JonathanTSilva/jts-website#119 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 74/100
promplate/code-review#158 · 1 bình luận · 1 reaction ·
Maintainer thường phản hồi trong vòng 1 ngày
-
[Docs] CONTRIBUTING points the Backend Remake milestone at a branch that does not existCó thể đã có người làm @franpts2 đã nhận hôm nay. Đang mởdocs
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 90/100
Maintainer thường phản hồi trong vòng 3 ngày