Skip to content

Commit e63b8af

Browse files
committed
rfc26: add dependency event semantics sub-section
1 parent 039a5b8 commit e63b8af

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

spec_26.rst

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,27 @@ Plugins may be self contained, or may outsource dependency processing to a
6464
service outside of the job manager; for example, a separate broker module
6565
or an entity that is not part of Flux.
6666

67+
Dependency Event Semantics
68+
~~~~~~~~~~~~~~~~~~~~~~~~~~
69+
70+
Dependency events SHALL only be posted to the job eventlog by job manager
71+
plugins.
72+
73+
Dependency events SHALL be treated as matching when their ``description``
74+
fields have the same value.
75+
76+
A dependency SHALL be considered satisfied when matching ``dependency-add``
77+
and ``dependency-remove`` events have been posted.
78+
79+
Some special semantics for these events are needed to allow plugins
80+
to reacquire their internal state when the job manager is restarted:
81+
82+
Attempts to post duplicate ``dependency-add`` events for unsatisfied
83+
dependencies SHALL NOT raise a plugin error and SHALL NOT be posted.
84+
85+
Attempts to post duplicate ``dependency-add`` events for satisfied
86+
dependencies SHALL raise a plugin error.
87+
6788

6889
Representation
6990
--------------

0 commit comments

Comments
 (0)