Skip to content

Commit 773a241

Browse files
ianswettianswett
authored
Move error codes to message descriptions, include newer error messages (#656)
The error codes are currently in the "Relays" section, which doesn't make any sense. It's also missing codes for SUBSCRIBE_ANNOUNCES_ERROR, ANNOUNCE_ERROR, and FETCH_ERROR. Also fixes #577.
2 parents 66a6f1a + f6aa0fb commit 773a241

File tree

1 file changed

+95
-42
lines changed

1 file changed

+95
-42
lines changed

‎draft-ietf-moq-transport.md‎

Lines changed: 95 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -881,48 +881,6 @@ allows relays to make only a single upstream subscription for the
881881
track. The published content received from the upstream subscription
882882
request is cached and shared among the pending subscribers.
883883

884-
The application SHOULD use a relevant error code in SUBSCRIBE_ERROR,
885-
as defined below:
886-
887-
|------|---------------------------|
888-
| Code | Reason |
889-
|-----:|:--------------------------|
890-
| 0x0 | Internal Error |
891-
|------|---------------------------|
892-
| 0x1 | Invalid Range |
893-
|------|---------------------------|
894-
| 0x2 | Retry Track Alias |
895-
|------|---------------------------|
896-
| 0x3 | Track Does Not Exist |
897-
|------|---------------------------|
898-
| 0x4 | Unauthorized |
899-
|------|---------------------------|
900-
| 0x5 | Timeout |
901-
|------|---------------------------|
902-
903-
The application SHOULD use a relevant status code in
904-
SUBSCRIBE_DONE, as defined below:
905-
906-
|------|---------------------------|
907-
| Code | Reason |
908-
|-----:|:--------------------------|
909-
| 0x0 | Unsubscribed |
910-
|------|---------------------------|
911-
| 0x1 | Internal Error |
912-
|------|---------------------------|
913-
| 0x2 | Unauthorized |
914-
|------|---------------------------|
915-
| 0x3 | Track Ended |
916-
|------|---------------------------|
917-
| 0x4 | Subscription Ended |
918-
|------|---------------------------|
919-
| 0x5 | Going Away |
920-
|------|---------------------------|
921-
| 0x6 | Expired |
922-
|------|---------------------------|
923-
| 0x7 | Too Far Behind |
924-
|------|---------------------------|
925-
926884
### Graceful Publisher Relay Switchover
927885

928886
This section describes behavior a subscriber MAY implement
@@ -1657,6 +1615,23 @@ message for which this response is provided.
16571615

16581616
* Reason Phrase: Provides the reason for announcement error.
16591617

1618+
The application SHOULD use a relevant error code in ANNOUNCE_ERROR, as defined
1619+
below:
1620+
1621+
|------|---------------------------|
1622+
| Code | Reason |
1623+
|-----:|:--------------------------|
1624+
| 0x0 | Internal Error |
1625+
|------|---------------------------|
1626+
| 0x1 | Unauthorized |
1627+
|------|---------------------------|
1628+
| 0x2 | Timeout |
1629+
|------|---------------------------|
1630+
| 0x3 | Not Supported |
1631+
|------|---------------------------|
1632+
| 0x4 | Uninterested |
1633+
|------|---------------------------|
1634+
16601635
## ANNOUNCE_CANCEL {#message-announce-cancel}
16611636

16621637
The subscriber sends an `ANNOUNCE_CANCEL` control message to
@@ -1844,6 +1819,27 @@ SUBSCRIBE_ERROR
18441819
the subscriber MUST close the connection with a Duplicate Track Alias error
18451820
({{session-termination}}).
18461821

1822+
The application SHOULD use a relevant error code in SUBSCRIBE_ERROR,
1823+
as defined below:
1824+
1825+
|------|---------------------------|
1826+
| Code | Reason |
1827+
|-----:|:--------------------------|
1828+
| 0x0 | Internal Error |
1829+
|------|---------------------------|
1830+
| 0x1 | Unauthorized |
1831+
|------|---------------------------|
1832+
| 0x2 | Timeout |
1833+
|------|---------------------------|
1834+
| 0x3 | Not Supported |
1835+
|------|---------------------------|
1836+
| 0x4 | Track Does Not Exist |
1837+
|------|---------------------------|
1838+
| 0x5 | Invalid Range |
1839+
|------|---------------------------|
1840+
| 0x6 | Retry Track Alias |
1841+
|------|---------------------------|
1842+
18471843
## FETCH_OK {#message-fetch-ok}
18481844

18491845
A publisher sends a FETCH_OK control message in response to successful fetches.
@@ -1907,6 +1903,25 @@ FETCH_ERROR
19071903

19081904
* Reason Phrase: Provides the reason for fetch error.
19091905

1906+
The application SHOULD use a relevant error code in FETCH_ERROR,
1907+
as defined below:
1908+
1909+
|------|---------------------------|
1910+
| Code | Reason |
1911+
|-----:|:--------------------------|
1912+
| 0x0 | Internal Error |
1913+
|------|---------------------------|
1914+
| 0x1 | Unauthorized |
1915+
|------|---------------------------|
1916+
| 0x2 | Timeout |
1917+
|------|---------------------------|
1918+
| 0x3 | Not Supported |
1919+
|------|---------------------------|
1920+
| 0x4 | Track Does Not Exist |
1921+
|------|---------------------------|
1922+
| 0x5 | Invalid Range |
1923+
|------|---------------------------|
1924+
19101925
## SUBSCRIBE_DONE {#message-subscribe-done}
19111926

19121927
A publisher sends a `SUBSCRIBE_DONE` message to indicate it is done publishing
@@ -1968,6 +1983,27 @@ once the same number of streams have been processed.
19681983

19691984
* Reason Phrase: Provides the reason for subscription error.
19701985

1986+
The application SHOULD use a relevant status code in
1987+
SUBSCRIBE_DONE, as defined below:
1988+
1989+
|------|---------------------------|
1990+
| Code | Reason |
1991+
|-----:|:--------------------------|
1992+
| 0x0 | Internal Error |
1993+
|------|---------------------------|
1994+
| 0x1 | Unauthorized |
1995+
|------|---------------------------|
1996+
| 0x2 | Track Ended |
1997+
|------|---------------------------|
1998+
| 0x3 | Subscription Ended |
1999+
|------|---------------------------|
2000+
| 0x4 | Going Away |
2001+
|------|---------------------------|
2002+
| 0x5 | Expired |
2003+
|------|---------------------------|
2004+
| 0x6 | Too Far Behind |
2005+
|------|---------------------------|
2006+
19712007
## MAX_SUBSCRIBE_ID {#message-max-subscribe-id}
19722008

19732009
A publisher sends a MAX_SUBSCRIBE_ID message to increase the number of
@@ -2165,6 +2201,23 @@ failure.
21652201

21662202
* Reason Phrase: Provides the reason for the namespace subscription error.
21672203

2204+
The application SHOULD use a relevant error code in SUBSCRIBE_ANNOUNCES_ERROR,
2205+
as defined below:
2206+
2207+
|------|---------------------------|
2208+
| Code | Reason |
2209+
|-----:|:--------------------------|
2210+
| 0x0 | Internal Error |
2211+
|------|---------------------------|
2212+
| 0x1 | Unauthorized |
2213+
|------|---------------------------|
2214+
| 0x2 | Timeout |
2215+
|------|---------------------------|
2216+
| 0x3 | Not Supported |
2217+
|------|---------------------------|
2218+
| 0x4 | Namespace Prefix Unknown |
2219+
|------|---------------------------|
2220+
21682221
# Data Streams {#data-streams}
21692222

21702223
A publisher sends Objects matching a subscription on Data Streams.

0 commit comments

Comments
 (0)