Skip to content

Commit

Permalink
docs: add tar in Etag
Browse files Browse the repository at this point in the history
  • Loading branch information
hacdias committed Jun 30, 2022
1 parent 8023280 commit c18dda7
Showing 1 changed file with 4 additions and 3 deletions.
7 changes: 4 additions & 3 deletions http-gateways/PATH_GATEWAY.md
Original file line number Diff line number Diff line change
Expand Up @@ -350,7 +350,7 @@ and CDNs, implementations should base it on both CID and response type:

- By default, etag should be based on requested CID. Example: `Etag: "bafy…foo"`

- If a custom `format` was requested (such as a raw block or a CAR), the
- If a custom `format` was requested (such as a raw block, CAR or TAR), the
returned etag should be modified to include it. It could be a suffix.
- Example: `Etag: "bafy…foo.raw"`

Expand All @@ -361,8 +361,9 @@ and CDNs, implementations should base it on both CID and response type:
- Example: `Etag: "DirIndex-2B423AF_CID-bafy…foo"`

- When a gateway can’t guarantee byte-for-byte identical responses, a “weak”
etag should be used. For example, if CAR is streamed, and blocks arrive in
non-deterministic order, the response should have `Etag: W/"bafy…foo.car"`
etag should be used. For example, if CAR or TAR is streamed, and blocks arrive in
non-deterministic order, the response should have `Etag: W/"bafy…foo.EXT"`, where `EXT`
is `car` or `tar`, respectively.

- When responding to [`Range`](#range-request-header) request, a strong `Etag`
should be based on requested range in addition to CID and response format:
Expand Down

0 comments on commit c18dda7

Please sign in to comment.