-
Type: Spec Change
-
Resolution: Unresolved
-
Priority: Minor - P4
-
None
-
Component/s: Multiple
-
Needed
Different driver specs use slightly inconsistent terminology for network errors, timeouts, exceptions, etc. leading to subtle differences between specs. We should standardize on unambiguous terminology and update all specs to match.
Proposal: Use the prefix "socket" for errors and timeout; use the term "network exception" to mean any sort of socket problem. Having different prefixes for the different scopes makes it harder to accidentally mix up the cases.
Specific examples:
- Socket Timeout: the condition where a networking socket operation is halted before the sucess or failure of the operation is determined. Examples include (but are not limited to) socket system calls with -1 return value and errno equal to ETIMEDOUT and a zero return value from select().
- Socket Error: the condition where a networking socket operation is known to have failed or been interrupted.
- Network Exception: the condition where either a Socket Timeout or Socket Error has occurred.