@@ -411,34 +411,36 @@ repo](https://github.com/theupdateframework/specification/issues).
411
411
+ ** 3.1.2 Metadata files**
412
412
413
413
The filenames and directory structure of repository metadata are strictly
414
- defined. The following are the metadata files of top-level roles relative
414
+ defined. All metadata filenames will have an extension based on the
415
+ metaformat, for example json metadata files would have an EXT of json.
416
+ The following are the metadata files of top-level roles relative
415
417
to the base URL of metadata available from a given repository mirror.
416
418
417
- /root.json
419
+ /root.EXT
418
420
419
421
Signed by the root keys; specifies trusted keys for the other
420
422
top-level roles.
421
423
422
- /snapshot.json
424
+ /snapshot.EXT
423
425
424
426
Signed by the snapshot role's keys. Lists the version numbers of all
425
- target metadata files: the top-level targets.json and all delegated
427
+ target metadata files: the top-level targets.EXT and all delegated
426
428
roles.
427
429
428
- /targets.json
430
+ /targets.EXT
429
431
430
432
Signed by the target role's keys. Lists hashes and sizes of target
431
433
files. Specifies delegation information and trusted keys for delegated
432
434
target roles.
433
435
434
- /timestamp.json
436
+ /timestamp.EXT
435
437
436
438
Signed by the timestamp role's keys. Lists hash(es), size, and version
437
439
number of the snapshot file. This is the first and potentially only
438
440
file that needs to be downloaded when clients poll for the existence
439
441
of updates.
440
442
441
- /mirrors.json (optional)
443
+ /mirrors.EXT (optional)
442
444
443
445
Signed by the mirrors role's keys. Lists information about available
444
446
mirrors and the content available from each mirror.
@@ -452,13 +454,13 @@ repo](https://github.com/theupdateframework/specification/issues).
452
454
453
455
A delegated role file is located at:
454
456
455
- /DELEGATED_ROLE.json
457
+ /DELEGATED_ROLE.EXT
456
458
457
459
where DELEGATED_ROLE is the name of the delegated role that has been
458
- specified in targets.json . If this role further delegates trust to a role
460
+ specified in targets.EXT . If this role further delegates trust to a role
459
461
named ANOTHER_ROLE, that role's signed metadata file is made available at:
460
462
461
- /ANOTHER_ROLE.json
463
+ /ANOTHER_ROLE.EXT
462
464
463
465
Delegated target roles are authorized by the keys listed in the directly
464
466
delegating target role.
@@ -472,7 +474,9 @@ repo](https://github.com/theupdateframework/specification/issues).
472
474
473
475
* ** 4.1. Metaformat**
474
476
475
- All documents use a subset of the JSON object format, with
477
+ Implementers of TUF may use any data format for metadata files as long as
478
+ all fields in this specification are included. The examples in this document
479
+ use a subset of the JSON object format, with
476
480
floating-point numbers omitted. When calculating the digest of an
477
481
object, we use the "canonical JSON" subdialect as described at
478
482
http://wiki.laptop.org/go/Canonical_JSON
0 commit comments