Jump to content

The Principia Machina/TPS/5.7 The lock: Difference between revisions

From The Invariance Itself
m BFP Rauch moved page The Principia Machina/TPS 0.1.0/5.7 The lock to The Principia Machina/TPS/5.7 The lock: TPS tree migration to version-free titles (record D34.1, D55, D87.1)
TPS 0.1.0 revision 4: D48-D57, D83.1, D84.1, D85.2 (v12)
Line 1: Line 1:
{{DISPLAYTITLE:5.7 The lock (TPS 0.1.0)}}
{{DISPLAYTITLE:5.7 The lock (TPS 0.1.0)}}
''Instruction artifact, machine-optimized text: TPS 0.1.0, section 5.7 The lock. Part of [[The Principia Machina/TPS 0.1.0|TPS 0.1.0]] and [[The Principia Machina/Hub|the TPM hub]]. Human-only edit (TPS 5.13). Version 0.1.0, proposed, revision 3; declaration pending.'' The text below is this section of the TPS 0.1.0 artifact, verbatim; the whole artifact and its file digest are on [[The Principia Machina/TPS 0.1.0]]. Human readers: [[The Principia Machina/TPS 0.1.0/Contents|the contents page]] is the map.
''Instruction artifact, machine-optimized text: TPS 0.1.0, section 5.7 The lock. Part of [[The Principia Machina/TPS|TPS 0.1.0]] and [[The Principia Machina/Hub|the TPM hub]]. Human-only edit (TPS 5.13). Version 0.1.0, proposed, revision 4; declaration pending.'' The text below is this section of the TPS 0.1.0 artifact, verbatim; the whole artifact and its file digest are on [[The Principia Machina/TPS]]. Human readers: [[The Principia Machina/TPS/Contents|the contents page]] is the map.


<pre>
<pre>
Line 10: Line 10:
audience: operator, agent
audience: operator, agent


5.7.1  One lock page per container, on the wiki; acquired by
5.7.1  TPX owns the mutex. One lock page per container, on the wiki,
      base-revision edit; a TPX save hook refuses an acquisition out of
      acquired by base-revision edit, so acquisition and its history
      queue order or before expiry; the grant number is a fencing token
      rest on the platform's own conflict detection and page history;
       checked by TPX's landing API; heartbeat extends a lock to at most
      a TPX save hook refuses an acquisition out of queue order or
      24 h; petitions queue in revision order; identifier ranges are
      before expiry; the grant number is a fencing token checked by
       leased; one lock at a time, never nested (D14, D32). The mutex
       TPX's landing API; heartbeat extends a lock to at most 24 h;
       holder is the sole allocation authority for the container's
      petitions queue in revision order; identifier ranges are leased;
       identifier mark. [I-081]
       one lock at a time, never nested (D14, D32). The mutex holder is
       the sole allocation authority for the container's identifier
       mark; holding the grant authorizes a CA-GTP to request register
      writes of TPX, not to make them (see 5.4, 6.4). [I-081] [I-137]
      [D48]
5.7.2  Acquire by an edit carrying the base revision ID that writes
5.7.2  Acquire by an edit carrying the base revision ID that writes
       holder account, grant number (previous plus one), grant time, and
       holder account, grant number (previous plus one), grant time, and
Line 34: Line 38:
5.7.6  The lock page is written by AI-LEAD, by AI-CO when head and in the
5.7.6  The lock page is written by AI-LEAD, by AI-CO when head and in the
       window, and cleared by H-OP with an audit line (see 5.13). [I-102]
       window, and cleared by H-OP with an audit line (see 5.13). [I-102]
5.7.7  Under a CLOSED access policy TPX refuses a queue-head acquisition
      from an account not on the UWC's access list (see 5.16). [I-153]
      [D52]
</pre>
</pre>


[[Category:The Principia Machina]]
[[Category:The Principia Machina]]



Revision as of 05:25, 22 September 2026

Instruction artifact, machine-optimized text: TPS 0.1.0, section 5.7 The lock. Part of TPS 0.1.0 and the TPM hub. Human-only edit (TPS 5.13). Version 0.1.0, proposed, revision 4; declaration pending. The text below is this section of the TPS 0.1.0 artifact, verbatim; the whole artifact and its file digest are on The Principia Machina/TPS. Human readers: the contents page is the map.

TPS 5.7  THE LOCK
purpose: the lock page; acquisition by base-revision edit and its
         written fields; the save hook; the grant number as fencing
         token; heartbeat; one lock, never nested
governs: 5.7 | version: 0.1.0 (proposed) | class: instruction artifact
audience: operator, agent

5.7.1  TPX owns the mutex. One lock page per container, on the wiki,
       acquired by base-revision edit, so acquisition and its history
       rest on the platform's own conflict detection and page history;
       a TPX save hook refuses an acquisition out of queue order or
       before expiry; the grant number is a fencing token checked by
       TPX's landing API; heartbeat extends a lock to at most 24 h;
       petitions queue in revision order; identifier ranges are leased;
       one lock at a time, never nested (D14, D32). The mutex holder is
       the sole allocation authority for the container's identifier
       mark; holding the grant authorizes a CA-GTP to request register
       writes of TPX, not to make them (see 5.4, 6.4). [I-081] [I-137]
       [D48]
5.7.2  Acquire by an edit carrying the base revision ID that writes
       holder account, grant number (previous plus one), grant time, and
       expiry, all in server time; a failed edit means another holder.
       [B-12]
5.7.3  Heartbeat edit every few hours extends expiry, never past 24
       hours from grant. [B-12]
5.7.4  Handover: an ordered petition queue on the collaboration page,
       ordered by the wiki's revision order of the petition edits; on
       release the head of the queue acquires; the others wait on the one
       ahead; if the head has not acquired within the ACQUISITION WINDOW,
       the next waiter may (see 5.8, 7.2). [B-12] [I-132]
5.7.5  Coworkers receive a leased identifier range per assignment. A
       release is valid only after a final push, in that order (see
       5.10). [B-12] [I-084]
5.7.6  The lock page is written by AI-LEAD, by AI-CO when head and in the
       window, and cleared by H-OP with an audit line (see 5.13). [I-102]
5.7.7  Under a CLOSED access policy TPX refuses a queue-head acquisition
       from an account not on the UWC's access list (see 5.16). [I-153]
       [D52]