Skip to content

Commit 4f6ce2e

Browse files
joshuagllukpueh
authored andcommitted
Ensure steps in the detailed workflow are consistent in use of variables
Update the modified step 3 to use a named variable for the application author defined number of bytes to download a snapshot metadata file. Re-name prior variables, starting at W, to ensure an alphabetically consistent list of variables used in each step. Signed-off-by: Joshua Lock <[email protected]>
1 parent e360733 commit 4f6ce2e

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

tuf-spec.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1076,8 +1076,8 @@ repo](https://github.com/theupdateframework/specification/issues).
10761076
* **1.1**. Let N denote the version number of the trusted root metadata file.
10771077

10781078
* **1.2**. **Try downloading version N+1 of the root metadata file**, up to
1079-
some X number of bytes (because the size is unknown). The value for X is set
1080-
by the authors of the application using TUF. For example, X may be tens of
1079+
some W number of bytes (because the size is unknown). The value for W is set
1080+
by the authors of the application using TUF. For example, W may be tens of
10811081
kilobytes. The filename used to download the root metadata file is of the
10821082
fixed form VERSION_NUMBER.FILENAME.EXT (e.g., 42.root.json). If this file is
10831083
not available, or we have downloaded more than Y number of root metadata files
@@ -1129,9 +1129,9 @@ repo](https://github.com/theupdateframework/specification/issues).
11291129
* **1.10**. **Set whether consistent snapshots are used as per the trusted
11301130
root metadata file** (see Section 4.3).
11311131

1132-
**2**. **Download the timestamp metadata file**, up to Y number of bytes
1133-
(because the size is unknown.) The value for Y is set by the authors of the
1134-
application using TUF. For example, Y may be tens of kilobytes. The filename
1132+
**2**. **Download the timestamp metadata file**, up to X number of bytes
1133+
(because the size is unknown). The value for X is set by the authors of the
1134+
application using TUF. For example, X may be tens of kilobytes. The filename
11351135
used to download the timestamp metadata file is of the fixed form FILENAME.EXT
11361136
(e.g., timestamp.json). The client MUST write the file to non-volatile storage
11371137
as FILENAME.EXT.
@@ -1153,9 +1153,9 @@ as FILENAME.EXT.
11531153
file. If the new timestamp metadata file has expired, discard it, abort the
11541154
update cycle, and report the potential freeze attack.
11551155

1156-
**3**. **Download snapshot metadata file**, up to the number of bytes
1157-
specified in the timestamp metadata file. If not specified, download up to a
1158-
number of bytes set by the authors of the application using TUF. This may be
1156+
**3**. **Download snapshot metadata file**, up to either the number of bytes
1157+
specified in the timestamp metadata file, or some Y number of bytes. The value
1158+
for Y is set by the authors of the application using TUF. For example, Y may be
11591159
tens of kilobytes. If consistent snapshots are not used (see
11601160
Section 7), then the filename used to download the snapshot metadata file is of
11611161
the fixed form FILENAME.EXT (e.g., snapshot.json). Otherwise, the filename is

0 commit comments

Comments
 (0)