Define capacity semantics and backend limits for portable event loops

Đang mở
  • Có gì không ổn?
#1,014 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

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ó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
32/100
Loại issue
Tái cấu trúc
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
rust
Lĩnh vực
operating-systems

Hướng nghiên cứu

Start with std/sys/windows/event.wave at the readiness capacity handling, then compare creation, registration, and wait boundaries in the epoll, kqueue, Windows readiness, and IOCP providers. Use compiler probes at capacities 0, 1, 64, and 65, plus registrations beyond capacity, to establish current behavior. Done means the contract separates the three capacities, defines target-specific or common outcomes and clear errors, and preserves existing event behavior after the design is agreed with @LunaStev.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

discussion enhancement help wanted

Motivation

The Windows readiness set enforces a fixed maximum and registration capacity, while epoll/kqueue creation uses a positive hint. The public loop capacity argument does not explain whether it is a hint or a portable registration limit.

Starting point: std/sys/windows/event.wave:45.

Validation

Audited canonical Wave 540728c2eb6cc12f5c69c3fb3fdb96e07ba059a4 (0.0.1-alpha-dev), whose tree matches the local checkout. Validation: Compared creation/add/wait boundaries in all readiness providers. Executed compiler probes use the matching checkout-built compiler and std on Linux amd64 (Rust 1.89.0 / LLVM 21.1.8). Source/header or mocked checks are not native execution on another OS.

Scope

Define creation capacity, registration capacity and per-wait output capacity separately. Preserve the bounded Windows readiness fallback and keep IOCP distinct.

Design discussion required

This issue records a proposal or an unresolved contract; it is not approval to choose new semantics. Please mention @LunaStev to discuss the design before starting implementation.

Completion criteria

  • Creation at 0/1/64/65 and registration beyond capacity have documented target-specific or common results.
  • Output capacity does not silently redefine registration capacity.
  • Unsupported limits produce clear errors and existing event behavior remains valid.
Ngôn ngữ chính
Rust
Star
56
Fork
21
Merge trung bình
23 giờ 20 phút
Pull request đã merge (30 ngày)
45

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. 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.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của wavefnd/Wave

Tất cả issue của wavefnd/Wave

Issue tương tự

Thêm issue về Rust

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.