Skip to content

Commit ca809b3

Browse files
committed
image-layout.md: clarify ref names are arbitrary
Signed-off-by: Antonio Murdaca <[email protected]>
1 parent 2f24791 commit ca809b3

File tree

1 file changed

+3
-2
lines changed

1 file changed

+3
-2
lines changed

image-layout.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ $ find .
2626
./oci-layout
2727
./refs
2828
./refs/v1.0
29-
./refs/v1.1
29+
./refs/stable-release
3030
```
3131

3232
Blobs are named by their contents:
@@ -36,12 +36,13 @@ $ shasum -a 256 ./blobs/sha256-afff3924849e458c5ef237db5f89539274d5e609db5db935e
3636
afff3924849e458c5ef237db5f89539274d5e609db5db935ed3959c90f1f2d51 ./blobs/sha256-afff3924849e458c5ef237db5f89539274d5e609db5db935ed3959c90f1f2d51
3737
```
3838

39-
Object names in the refs and blobs MUST NOT include characters outside of the set of "A" to "Z", "a" to "z", the hyphen `-`, the dot `.`, and the underscore `_`.
39+
Object names in the `refs` and `blobs` MUST NOT include characters outside of the set of "A" to "Z", "a" to "z", the hyphen `-`, the dot `.`, and the underscore `_`.
4040
Hash algorithm identifiers containing the colon `:` will be converted to the hyphen `-`.
4141
For example `sha256:5b` will map to the layout `blobs/sha256-5b`.
4242
The blobs directory MAY contain blobs which are not referenced by any of the refs.
4343
The blobs directory MAY be missing referenced blobs, in which case the missing blobs SHOULD be fulfilled by an external blob store.
4444

45+
No semantic restriction is given for object names in the `refs` subdirectory.
4546
Each object in the `refs` subdirectory MUST be of type `application/vnd.oci.descriptor.v1+json`.
4647
In general the `mediatype` of this descriptor object will be either `application/vnd.oci.image.manifest.list.v1+json` or `application/vnd.oci.image.manifest.v1+json` although future versions of the spec MAY use a different mediatype.
4748

0 commit comments

Comments
 (0)