Skip to main content

Module identity

Module identity 

Source
Expand description

Explains the identities used to submit, manage, and coordinate tasks.

ValueMeaning
TaskIdOne submission in the current process
Task nameRegistry uniqueness key and diagnostic label
Controller slotKey that coordinates competing submissions
application submission
     ├── direct add ─────────► TaskId + task name ──► registry
     └── controller submit ──► TaskId + slot ───────► controller ──► registry

Taskvisor allocates the ID before the first admission decision. The same ID follows queued work, every retry, terminal cleanup, and controller rejection. Several task names may use the same controller slot.

A name becomes reusable after registry membership ends and any force-aborted actor with that name exits physically. Reuse allocates a new TaskId. IDs come from a process-local u64 sequence. They are not persisted and cannot be reconstructed through the public API. Returned IDs are never zero and never wrap. The next allocation after exhaustion panics. Store a separate application ID when identity must survive a process restart.

Structs§

TaskId
Opaque identity of one task submission within the current process.