Skip to content

Commit 039a5b8

Browse files
committed
rfc26: add simple dependencies section
Add a new section for simple dependencies, as proposed in flux-framework/flux-core#3696. Teach the dictionary some new words.
1 parent c32481c commit 039a5b8

File tree

2 files changed

+50
-1
lines changed

2 files changed

+50
-1
lines changed

spec_26.rst

Lines changed: 47 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@ scheme
7777
value
7878
(string) semantics determined by the scheme.
7979

80-
A dependency object MAY contain additional OPTIONAL keys-value pairs,
80+
A dependency object MAY contain additional OPTIONAL key-value pairs,
8181
whose semantics are determined by the scheme.
8282

8383
in jobspec
@@ -112,6 +112,52 @@ This form SHOULD be translated by the command line tool to the object
112112
form above before being shared with other parts of the system.
113113

114114

115+
Simple Dependencies
116+
-------------------
117+
118+
The following dependency schemes are built-in.
119+
120+
after
121+
~~~~~
122+
123+
``value`` SHALL be interpreted as the antecedent jobid, in any valid
124+
FLUID encoding from RFC 19.
125+
126+
The dependency SHALL be satisfied once the antecedent job enters RUN state.
127+
If the antecedent job reaches INACTIVE state without entering RUN state,
128+
a fatal exception SHOULD be raised on the dependent job.
129+
130+
131+
afterany
132+
~~~~~~~~
133+
134+
``value`` SHALL be interpreted as the antecedent jobid, in any valid
135+
FLUID encoding from RFC 19.
136+
137+
The dependency SHALL be satisfied once the antecedent job enters INACTIVE
138+
state, regardless of result.
139+
140+
afterok
141+
~~~~~~~
142+
143+
``value`` SHALL be interpreted as the antecedent jobid, in any valid
144+
FLUID encoding from RFC 19.
145+
146+
The dependency SHALL be satisfied once the antecedent job enters INACTIVE
147+
state, with a successful result. If the antecedent job does not conclude
148+
successfully, a fatal exception SHOULD be raised on the dependent job.
149+
150+
afternotok
151+
~~~~~~~~~~
152+
153+
``value`` SHALL be interpreted as the antecedent jobid, in any valid
154+
FLUID encoding from RFC 19.
155+
156+
The dependency SHALL be satisfied once the antecedent job enters INACTIVE
157+
state, with an unsuccessful result. If the antecedent job concludes
158+
successfully, a fatal exception SHOULD be raised on the dependent job.
159+
160+
115161
OpenMP-style Dependencies
116162
-------------------------
117163

spell.en.pws

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -447,3 +447,6 @@ RTT
447447
dothex
448448
dec
449449
Hostlists
450+
afterany
451+
afterok
452+
afternotok

0 commit comments

Comments
 (0)