Skip to content

Commit a30af20

Browse files
hacdiaslidel
authored andcommitted
path-gateway: clarify Range should support single range
1 parent 7545f1e commit a30af20

File tree

1 file changed

+13
-4
lines changed

1 file changed

+13
-4
lines changed

src/http-gateways/path-gateway.md

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ editors:
2222
xref:
2323
- url
2424
- trustless-gateway
25+
- ipip-0402
26+
- ipip-0412
2527
tags: ['httpGateways', 'lowLevelHttpGateways']
2628
order: 0
2729
---
@@ -143,15 +145,22 @@ For example:
143145

144146
### `Range` (request header)
145147

146-
`Range` can be used for requesting specific byte ranges of UnixFS files and raw
148+
`Range` can be used for requesting specific byte range of UnixFS files and raw
147149
blocks.
148150

149151
Gateway implementations SHOULD be smart enough to require only the minimal DAG subset
150152
necessary for handling the range request.
151153

152-
NOTE: for more advanced use cases such as partial DAG/CAR streaming, or
153-
non-UnixFS data structures, see the `selector` query parameter
154-
[proposal](https://github.com/ipfs/go-ipfs/issues/8769).
154+
Gateways SHOULD support single range requests. The support of more than one
155+
range is optional: implementation MAY decide to not support more than one range.
156+
157+
:::note
158+
159+
For more advanced use cases such as partial DAG/CAR streaming, or non-UnixFS
160+
data structures, see `dag-scope` and `entity-bytes` from :cite[ipip-0402] and
161+
ordered CARs from :cite[ipip-0412].
162+
163+
:::
155164

156165
### `Service-Worker` (request header)
157166

0 commit comments

Comments
 (0)