View Issue Details

Jump to NotesJump to History
IDProjectCategoryView StatusDate SubmittedLast Update
000834110000-014: PubSubSpecpublic2022-09-21 13:012022-09-23 14:54
ReporterMatthias Damm Assigned ToMatthias Damm  
PrioritynormalSeverityminorReproducibilityhave not tried
Status closedResolutionfixed 
Product Version1.05.01 
Target Version1.05.02Fixed in Version1.05.02 
Summary0008341: Allowed open modes for PubSubConfigurationType
Description

Current definition for PubSubConfigurationType:
The Open Method shall not support modes other than Read (0x01) and the Write + EraseExisting (0x06).

Requirement from FX WG:
Provide a way to read the current configuration and to write changes back without allowing another application to make changes in between.
If the file is open for Read AND Write, no other client is able to access the object during this time.

Problem:
With these modes (copied from TrustListType), we can only Read OR Write.

Solution:
Offer third mode Read + Write (0x03)

The third mode needs some special handling if you read and write. E.g. open for Read + Write, Read the old configuration, SetPosition to beginning, write new configuration, call CloseAndUpdate. If the new configuration is smaller than the old configuration, the buffer would theoretically contain parts of the old configuration but the way of handing CloseAndUpdate would not have a problem since the content of the buffer would be read by the decoder only until the valid new part.

Additional Information

An additional point,
we should add to the list: On any creation or modification of a push target using CloseAndUpdate, the SKS shall push keys (similar statement as in ConnectSecurityGroups).

TagsNo tags attached.
Commit Version
Fix Due Date

Activities

Jim Luth

2022-09-21 14:41

administrator   ~0017751

agreed to add this to the 1.05.02 release (post RC edits).

Matthias Damm

2022-09-22 15:50

developer   ~0017804

In 9.1.3.7.1 PubSubConfigurationType

Replaced
The Open Method shall not support modes other than Read (0x01) and the Write + EraseExisting (0x06).

When a Client opens the file for writing the Server will not actually update the PubSub configuration until the CloseAndUpdate Method is called. Simply calling Close will discard the updates.

With
The Open Method shall not support modes other than Read (0x01), Write + EraseExisting (0x06) and Read + Write (0x03).

When a Client opens the file for writing the Server will not actually update the PubSub configuration until the CloseAndUpdate Method is called. Simply calling Close will discard the updates. Open for writing is an exclusive access. Clients shall open with Write flag set only for the execution of the sequence of Method calls necessary for a configuration update.

When a Client opens the file for reading and writing, the Client shall follow the following steps.

  • Read the existing configuration with the FileType Read Method.
  • Set the position to the beginning of the file with the FileType SetPosition Method.
  • Write the changes with the FileType Write Method.
  • Apply the changes with the CloseAndUpdate Method.

The Read + Write (0x03) option allows a Client to ensure that the changes are consistent with the current configuration and to avoid that another Client made changes between read and write.

Jim Luth

2022-09-23 14:54

administrator   ~0017839

Agreed to changes edited in F2F meeting.

Issue History

Date Modified Username Field Change
2022-09-21 13:01 Matthias Damm New Issue
2022-09-21 13:01 Matthias Damm Status new => assigned
2022-09-21 13:01 Matthias Damm Assigned To => Matthias Damm
2022-09-21 14:41 Jim Luth Note Added: 0017751
2022-09-22 15:50 Matthias Damm Status assigned => resolved
2022-09-22 15:50 Matthias Damm Resolution open => fixed
2022-09-22 15:50 Matthias Damm Fixed in Version => 1.05.02
2022-09-22 15:50 Matthias Damm Note Added: 0017804
2022-09-23 14:54 Jim Luth Status resolved => closed
2022-09-23 14:54 Jim Luth Note Added: 0017839