Skip to content

Commit 9a3bd6d

Browse files
committed
rfc14: update definition of duration=0
Problem: RFC 14 defines a jobspec duration of 0 as being unset or unlimited, but does not specify further what that means. This could allow different scheduler implementations to drift in how they apply time limits when no duration is specified. Add wording that explicitly indicates how a scheduler should treat an unset duration.
1 parent c12339c commit 9a3bd6d

File tree

1 file changed

+10
-5
lines changed

1 file changed

+10
-5
lines changed

spec_14.rst

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -316,11 +316,16 @@ which, if present, must have values. Values MAY have any valid YAML type.
316316
Some common system attributes are:
317317

318318
**duration**
319-
The value of the ``duration`` attribute is a floating-point number greater than
320-
or equal to zero representing time span in seconds. A ``duration`` of 0 SHALL be
321-
interpreted as "unlimited" or "not set" by the system. The scheduler will make
322-
an effort to allocate the requested resources for the number of seconds
323-
specified in ``duration``.
319+
The value of the ``duration`` attribute is a floating-point number
320+
greater than or equal to zero representing time span in seconds.
321+
If ``duration`` is greater than zero, then the scheduler SHALL
322+
allocate the requested resources for the number of seconds specified
323+
in ``duration``. A ``duration`` value of ``0.`` SHALL be interpreted
324+
as unlimited or unset, and the scheduler SHALL use a ``duration``
325+
that is the minimum of any configured ``duration`` default and the
326+
time span to the currently defined instance expiration. If no default
327+
``duration`` is configured, and the current instance has no expiration,
328+
then resources shall be allocated without expiration.
324329

325330
**environment**
326331
The value of the ``environment`` attribute is a dictionary containing the names

0 commit comments

Comments
 (0)