Diff: rfc9770v4.txt - rfc9770.txt

	rfc9770v4.txt	rfc9770.txt

	skipping to change at line 1153 ¶	skipping to change at line 1153 ¶
	update collection in question. If supporting the "Cursor" extension,	update collection in question. If supporting the "Cursor" extension,
	the AS MUST provide registered devices and administrators with the	the AS MUST provide registered devices and administrators with the
	corresponding value of MAX_DIFF_BATCH upon their registration (see	corresponding value of MAX_DIFF_BATCH upon their registration (see
	Section 10).	Section 10).

	6.3. Query Parameters	6.3. Query Parameters

	A GET request to the TRL endpoint can include the following query	A GET request to the TRL endpoint can include the following query
	parameters. The AS MUST silently ignore unknown query parameters.	parameters. The AS MUST silently ignore unknown query parameters.


	* 'diff': if included, it indicates that the AS should perform a	* 'diff': if included, it asks the AS to perform a diff query of the
	diff query of the TRL (see Section 8). Its value MUST be either:	TRL (see Section 8). Its value MUST be either:

	- the integer 0, indicating that a (notification) response should	- the integer 0, indicating that a (notification) response should
	include as many diff entries as the AS can provide in the	include as many diff entries as the AS can provide in the
	response; or	response; or

	- a positive integer strictly greater than 0, indicating the	- a positive integer strictly greater than 0, indicating the
	maximum number of diff entries that a (notification) response	maximum number of diff entries that a (notification) response
	should include.	should include.

	If the AS does not support diff queries, it ignores the 'diff'	If the AS does not support diff queries, it ignores the 'diff'

	skipping to change at line 1179 ¶	skipping to change at line 1179 ¶
	case the 'diff' query parameter of the GET request has a value	case the 'diff' query parameter of the GET request has a value
	that is neither 0 nor a positive integer, irrespective of the	that is neither 0 nor a positive integer, irrespective of the
	presence of the 'cursor' query parameter and its value (see	presence of the 'cursor' query parameter and its value (see
	below). The response MUST have Content-Format set to	below). The response MUST have Content-Format set to
	"application/concise-problem-details+cbor", and its payload is	"application/concise-problem-details+cbor", and its payload is
	formatted as defined in Section 6.1. Within the Custom Problem	formatted as defined in Section 6.1. Within the Custom Problem
	Detail entry 'ace-trl-error', the value of the 'error-id' field	Detail entry 'ace-trl-error', the value of the 'error-id' field
	MUST be set to 0 ("Invalid parameter value"), and the 'cursor'	MUST be set to 0 ("Invalid parameter value"), and the 'cursor'
	field MUST NOT be present.	field MUST NOT be present.


	* 'cursor': if included, it indicates the should perform a diff	* 'cursor': if included, it asks the AS to perform a diff query of
	query of the TRL together with the "Cursor" extension, as defined	the TRL together with the "Cursor" extension, as defined in
	in Section 9.2. Its value MUST be either 0 or a positive integer.	Section 9.2. Its value MUST be either 0 or a positive integer.
	If the 'cursor' query parameter is included, then the 'diff' query	If the 'cursor' query parameter is included, then the 'diff' query
	parameter MUST also be included.	parameter MUST also be included.

	If included, the 'cursor' query parameter has an unsigned integer	If included, the 'cursor' query parameter has an unsigned integer
	value that was provided by the AS in a previous response from the	value that was provided by the AS in a previous response from the
	TRL endpoint (see Sections 9.1, 9.2.2, and 9.2.3).	TRL endpoint (see Sections 9.1, 9.2.2, and 9.2.3).

	If the AS does not support the "Cursor" extension, it ignores the	If the AS does not support the "Cursor" extension, it ignores the
	'cursor' query parameter when present in the GET request. In such	'cursor' query parameter when present in the GET request. In such
	a case, the AS proceeds as specified elsewhere in this document,	a case, the AS proceeds as specified elsewhere in this document,

	skipping to change at line 1384 ¶	skipping to change at line 1384 ¶
	element of 'diff_set_value' relates to the most recent TRL	element of 'diff_set_value' relates to the most recent TRL
	update pertaining to the requester. The second 'diff_entry'	update pertaining to the requester. The second 'diff_entry'
	element relates to the second-to-last most recent TRL update	element relates to the second-to-last most recent TRL update
	pertaining to the requester, and so on.	pertaining to the requester, and so on.

	* The 'cursor' parameter and the 'more' parameter MUST be	* The 'cursor' parameter and the 'more' parameter MUST be
	included if the AS supports both diff queries and the related	included if the AS supports both diff queries and the related
	"Cursor" extension (see Section 6.2.1). Their values are set	"Cursor" extension (see Section 6.2.1). Their values are set
	as specified in Section 9.2 and provide the requester with	as specified in Section 9.2 and provide the requester with
	information for sending a new request that asks the AS to	information for sending a new request that asks the AS to

	perfrom a follow-up query of the TRL (see Section 9.2).	perform a follow-up query of the TRL (see Section 9.2).

	In case the AS supports diff queries but not the "Cursor"	In case the AS supports diff queries but not the "Cursor"
	extension, these parameters MUST NOT be included. In case the	extension, these parameters MUST NOT be included. In case the
	requester supports diff queries but not the "Cursor"	requester supports diff queries but not the "Cursor"
	extension, the requester MUST silently ignore the 'cursor'	extension, the requester MUST silently ignore the 'cursor'
	parameter and the 'more' parameter, if present.	parameter and the 'more' parameter, if present.

	Figure 8 provides the CDDL definition [RFC8610] of the CBOR array	Figure 8 provides the CDDL definition [RFC8610] of the CBOR array
	'diff_set_value' specified in the response from the AS, as the value	'diff_set_value' specified in the response from the AS, as the value
	of the 'diff_set' parameter.	of the 'diff_set' parameter.

	skipping to change at line 3269 ¶	skipping to change at line 3269 ¶
	RS.	RS.

	Figure 14 shows an interaction example of a CoAP observation and a	Figure 14 shows an interaction example of a CoAP observation and a
	full query of the TRL.	full query of the TRL.

	The example also shows some of the notifications from the AS getting	The example also shows some of the notifications from the AS getting
	lost in transmission; thus, those notifications do not reach the RS.	lost in transmission; thus, those notifications do not reach the RS.

	When this happens, and after a waiting time defined by the	When this happens, and after a waiting time defined by the
	application has elapsed, the RS sends a GET request with no Observe	application has elapsed, the RS sends a GET request with no Observe

	Option to the AS, to perform a diff query of the TRL. In particular,	Option to the AS, asking the AS to perform a diff query of the TRL.
	the RS specifies:	In particular, the RS specifies:

	* The 'diff' query parameter with a value of 8, i.e., the maximum	* The 'diff' query parameter with a value of 8, i.e., the maximum
	number of diff entries to be included in a response from the AS.	number of diff entries to be included in a response from the AS.

	* The 'cursor' query parameter with a value of 2, thus requesting	* The 'cursor' query parameter with a value of 2, thus requesting
	from the update collection the series items following the one with	from the update collection the series items following the one with
	the 'index' value equal to 2 (i.e., following the last series item	the 'index' value equal to 2 (i.e., following the last series item
	that the RS successfully received in an earlier notification	that the RS successfully received in an earlier notification
	response).	response).


	skipping to change at line 3541 ¶	skipping to change at line 3541 ¶
	The work on this document has been partly supported by the Sweden's	The work on this document has been partly supported by the Sweden's
	Innovation Agency VINNOVA and the Celtic-Next projects CRITISEC and	Innovation Agency VINNOVA and the Celtic-Next projects CRITISEC and
	CYPRESS; and by the H2020 project SIFIS-Home (Grant agreement	CYPRESS; and by the H2020 project SIFIS-Home (Grant agreement
	952652).	952652).

	Authors' Addresses	Authors' Addresses

	Marco Tiloca	Marco Tiloca
	RISE AB	RISE AB
	Isafjordsgatan 22	Isafjordsgatan 22

	SE-SE-164 40 Kista	SE-164 40 Kista
	Sweden	Sweden
	Email: marco.tiloca@ri.se	Email: marco.tiloca@ri.se

	Francesca Palombini	Francesca Palombini
	Ericsson AB	Ericsson AB
	Torshamnsgatan 23	Torshamnsgatan 23

	SE-16440 Kista	SE-164 40 Kista
	Sweden	Sweden
	Email: francesca.palombini@ericsson.com	Email: francesca.palombini@ericsson.com

	Sebastian Echeverria	Sebastian Echeverria
	CMU SEI	CMU SEI
	4500 Fifth Avenue	4500 Fifth Avenue
	Pittsburgh, PA 15213-2612	Pittsburgh, PA 15213-2612
	United States of America	United States of America
	Email: secheverria@sei.cmu.edu	Email: secheverria@sei.cmu.edu


End of changes. 6 change blocks.
	10 lines changed or deleted	10 lines changed or added
This html diff was produced by rfcdiff 1.48.