Skip to content

Commit 74dc56f

Browse files
committed
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 steps. Signed-off-by: Joshua Lock <[email protected]>
1 parent 27f2652 commit 74dc56f

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
@@ -1080,8 +1080,8 @@ repo](https://github.com/theupdateframework/specification/issues).
10801080
* **1.1**. Let N denote the version number of the trusted root metadata file.
10811081

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

1136-
**2**. **Download the timestamp metadata file**, up to Y number of bytes
1137-
(because the size is unknown.) The value for Y is set by the authors of the
1138-
application using TUF. For example, Y may be tens of kilobytes. The filename
1136+
**2**. **Download the timestamp metadata file**, up to X number of bytes
1137+
(because the size is unknown). The value for X is set by the authors of the
1138+
application using TUF. For example, X may be tens of kilobytes. The filename
11391139
used to download the timestamp metadata file is of the fixed form FILENAME.EXT
11401140
(e.g., timestamp.json). The client MUST write the file to non-volatile storage
11411141
as FILENAME.EXT.
@@ -1157,9 +1157,9 @@ as FILENAME.EXT.
11571157
file. If the new timestamp metadata file has expired, discard it, abort the
11581158
update cycle, and report the potential freeze attack.
11591159

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

0 commit comments

Comments
 (0)