Specify when NetEvent.fd is valid across readiness backends

Aperta
  • Qualcosa non va?
#1,013 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
38/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
rust
Ambito
backend-api-design, operating-systems

Direzione di ricerca

Start with std/sys/linux/event.wave:18 and trace NativeEvent production through the public NetEvent facade in net_event_wait. Review the Linux, kqueue, and Windows backends to identify their current fd and token behavior. Completion requires an explicitly agreed portable validity contract, tested rules for every backend, and examples using only fields guaranteed by that contract; implementation should wait for design discussion with @LunaStev.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

discussion enhancement help wanted

Motivation

The Linux provider returns fd=-1 while preserving the caller token; kqueue and Windows providers return a descriptor. net_event_wait copies this field into the public NetEvent without a field-validity contract. Portable consumers cannot know whether fd is usable.

Starting point: std/sys/linux/event.wave:18.

Validation

Audited canonical Wave 540728c2eb6cc12f5c69c3fb3fdb96e07ba059a4 (0.0.1-alpha-dev), whose tree matches the local checkout. Validation: Traced NativeEvent production through the public NetEvent facade. 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

Choose a stable token-first/optional-fd or always-valid-fd contract and document the representation without implying native backend parity.

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

  • Every backend has a tested, explicit NetEvent.fd validity rule.
  • Tokens retain full identity and descriptor reuse does not create stale associations.
  • Examples use only fields guaranteed by the portable contract.
Lingua principale
Rust
Stelle
56
Fork
21
Merge medio
23h 20m
PR unite (30g)
45

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di wavefnd/Wave

Tutte le issue di wavefnd/Wave

Issue simili

Altre issue su Rust

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.