Define duplicate registration behavior for portable event_add

未关闭
#1,011 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
30/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
linux, rust

调研方向

Start by reading std/sys/macos/event.wave:66 and comparing it with the Linux, Windows, and kqueue event-provider sources plus the documented kqueue semantics. Before implementation, discuss the add-versus-modify and token-ownership contract with @LunaStev, as the issue explicitly leaves the design unresolved. Done means each backend has documented same-token and different-token duplicate-add behavior, consistent modify/remove interactions, and native or backend-boundary fixtures covering the complete sequence.

由索引模型根据 Issue 内容生成。

描述

discussion enhancement help wanted

Motivation

Linux epoll ADD and the Windows set reject an already registered descriptor, while kqueue EV_ADD updates an existing ident/filter registration. The portable facade exposes these as the same add operation without defining the duplicate/token replacement contract.

Starting point: std/sys/macos/event.wave:66.

Validation

Audited canonical Wave 540728c2eb6cc12f5c69c3fb3fdb96e07ba059a4 (0.0.1-alpha-dev), whose tree matches the local checkout. Validation: Compared Linux/Windows/kqueue provider source and official kqueue semantics. 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.

FreeBSD kqueue(2) specifies that re-adding modifies an existing event.

Scope

Choose consistent add-versus-modify and token ownership semantics, or make the capability difference explicit. Do not silently rely on one backend's behavior.

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

  • Duplicate add with the same and different tokens has a documented result on each backend.
  • Modify/remove interactions follow the same ownership contract.
  • Native/backend-boundary fixtures check the complete sequence.
主要语言
Rust
星标
56
派生
21
平均合并
23 小时 20 分钟
30 天内合并 PR
45

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

wavefnd/Wave 的其他 Issue

查看 wavefnd/Wave 的全部 Issue

相似的 Issue

更多 Rust Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。