Skip to content

Commit 00f924c

Browse files
authored
Define SUBSCRIBE_ERROR error codes (#341)
Fixes existing TODOs and TBDs
2 parents e44aa48 + ed1be1e commit 00f924c

File tree

1 file changed

+16
-5
lines changed

1 file changed

+16
-5
lines changed

draft-ietf-moq-transport.md

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -598,6 +598,19 @@ allows relays to make only a single forward subscription for the
598598
track. The published content received from the forward subscription
599599
request is cached and shared among the pending subscribers.
600600

601+
The application SHOULD use a relevant error code in SUBSCRIBE_ERROR,
602+
as defined below:
603+
604+
|------|---------------------------|
605+
| Code | Reason |
606+
|-----:|:--------------------------|
607+
| 0x0 | Generic Error |
608+
|------|---------------------------|
609+
| 0x1 | Invalid Range |
610+
|------|---------------------------|
611+
| 0x2 | Retry Track Alias |
612+
|------|---------------------------|
613+
601614

602615
## Publisher Interactions
603616

@@ -988,8 +1001,8 @@ On successful subscription, the publisher SHOULD start delivering
9881001
objects from the group ID and object ID described above.
9891002

9901003
If a publisher cannot satisfy the requested start or end for the subscription it
991-
MAY send a SUBSCRIBE_ERROR with code TBD. A publisher MUST NOT send objects
992-
from outside the requested start and end.
1004+
MAY send a SUBSCRIBE_ERROR with code 'Invalid Range'. A publisher MUST NOT send
1005+
objects from outside the requested start and end.
9931006

9941007
TODO: Define the flow where subscribe request matches an existing subscribe id
9951008
(subscription updates.)
@@ -1095,12 +1108,10 @@ SUBSCRIBE_ERROR
10951108

10961109
* Reason Phrase: Provides the reason for subscription error.
10971110

1098-
* Track Alias: When Error Code is TBD, the subscriber SHOULD re-issue the
1111+
* Track Alias: When Error Code is 'Retry Track Alias', the subscriber SHOULD re-issue the
10991112
SUBSCRIBE with this Track Alias instead. If this Track Alias is already in use,
11001113
the receiver MUST close the connection with a Duplicate Track Alias error
11011114
({{session-termination}}).
1102-
TODO: Add a registry for subscribe error codes and make this field conditional.
1103-
11041115

11051116
## UNSUBSCRIBE {#message-unsubscribe}
11061117

0 commit comments

Comments
 (0)