From 2ab3bb2c87e087851ea590a187de677e6b6922db Mon Sep 17 00:00:00 2001 From: Albert Chu Date: Wed, 20 Dec 2023 13:58:39 -0800 Subject: [PATCH] rfc41: add new lookup flags Problem: The job-info.lookup RPC is missing the new json_decode and current flags. Document the new flags. --- spec_41.rst | 17 +++++++++++++++-- spell.en.pws | 1 + 2 files changed, 16 insertions(+), 2 deletions(-) diff --git a/spec_41.rst b/spec_41.rst index 6098d3e6..4b90926a 100644 --- a/spec_41.rst +++ b/spec_41.rst @@ -127,7 +127,18 @@ The RPC payloads are defined as follows: .. object:: flags - (*integer*, REQUIRED) Flags, reserved for future use. Set to zero. + (*integer*, REQUIRED) A bitfield comprised of zero or more flags: + + json_decode (1) + For lookups of R or jobspec, return the field as a decoded + JSON object instead of a string. This flag has no effect on + other keys. + + current (2) + For lookups of R or jobspec, return the current version. The + current version SHALL be computed by applying any + resource-update or jobspec-update events that have been posted + to the job eventlog, as described in RFC 21. .. object:: job-info.lookup response @@ -141,7 +152,9 @@ The RPC payloads are defined as follows: Additional keys correspond to the keys in the request. - Values are the KVS values associated with the keys, encoded as strings. + Values are the KVS values associated with the keys. Values are + encoded as strings, except in special cases indicated by flags + in the request. Eventlog Watch ============== diff --git a/spell.en.pws b/spell.en.pws index 31edc532..c83c61ea 100644 --- a/spell.en.pws +++ b/spell.en.pws @@ -489,3 +489,4 @@ userids parsable bitmasks DoS +lookups