s/RST_STREAM/TERMINATE_STREAM (editorial) was: Naming Consistency (editorial)

On Sunday,13 July 2014 22:28, martin.thomson@gmail.com<mailto:martin.thomson@gmail.com> wrote:

> On 12 July 2014 14:07,  <K.Morgan@iaea.org<mailto:K.Morgan@iaea.org>> wrote:

>> The GOAWAY frame name has no separator. To keep consistency in the

>> naming scheme, I suggest changing to GO_AWAY.

>

> And you aren't bothered by the lack of vowels in RST_STREAM?

>



(Not really.  The abbreviation 'RST' is a "generally accepted" abbreviation in computing to mean reset.)



What bothers me more about the name 'RST_STREAM' is that it's usage in http/2 doesn't match the meaning of the word reset.  For example, here are some of the definitions of 'reset' that a quick search found:



= "cause (a binary device) to enter the state representing the numeral 0." [http://www.oxforddictionaries.com/definition/english/reset]

="to move (something) back to an original place or position" [http://www.merriam-webster.com/dictionary/reset]

="to set again or anew" [http://www.merriam-webster.com/dictionary/reset]

= "to restore (the contents of a register or similar device) in a computer system to zero" [http://dictionary.reference.com/browse/reset]

In other words, the word reset implies that the stream should be reset back to its *original* state (i.e. IDLE), but RST_STREAM immediately takes a stream to its *terminal* state (i.e. CLOSED).

A more appropriate name would be TERMINATE_STREAM (or perhaps close).

Even the definition in Section Received on Friday,  1 August 2014 10:09:11 UTC

Follow Lee on X/Twitter - Father, Husband, Serial builder creating AI, crypto, games & web tools. We are friends :) AI Will Come To Life!

Check out: eBank.nz (Art Generator) | Netwrck.com (AI Tools) | Text-Generator.io (AI API) | BitBank.nz (Crypto AI) | ReadingTime (Kids Reading) | RewordGame | BigMultiplayerChess | WebFiddle | How.nz | Helix AI Assistant