Updated Error Codes (markdown)

Lex Berezhny 2018-07-29 20:48:45 -04:00
parent 4bae3adac4
commit 098799ba99

@ -2,16 +2,28 @@ Proposal for consistent error codes across the entire lbrynet API.
Code | Name Code | Name
---:|--- ---:|---
**1xx** | **Daemon `start` Failures (non-recoverable)** **1xx** | **Daemon `start` other CLI command Failures (non-recoverable)**
100 | Daemon does not start. (A philosophical error code, never actually presented.) **10x** | Meta error codes not presented by `lbrynet` itself but from apps trying to interact with `lbrynet`.
10x | 101-109 TBD; covers various OS / runtime errors that prevent `lbrynet` from bootstrapping itself. 100 | Cannot find the `lbrynet` command.
110 | Cannot write configuration file. (When writing the default config fails on startup, such as due to permission issues.) 101 | Permission denied trying to execute `lbrynet` command.
111 | Cannot find provided configuration file. (Can't open the config file user provided via command line args.) 102 | Executing `lbrynet` command does not produce any result.
112 | Failed to parse the configuration file. (Includes the syntax error / line number to help user fix it.) 103 | Executing `lbrynet` produces a result that is not normal (eg. a segfault).
120 | Out of disk space. **11x** | Enough of `lbrynet` was able to start to determine external factors causing eventual startup failure.
130 | Command does not exist. 110 | Out of disk space.
131 | Command is deprecated. 111 | Out of RAM.
132 | Invalid arguments for command. **12x** | 120-129 Internal factors preventing `lbrynet` from bootstrapping itself.
120 | Incompatible version of Python.
121 | Incompatible version of some library.
**13x** | 130-139 configuration errors
130 | Cannot write configuration file. (When writing the default config fails on startup, such as due to permission issues.)
131 | Cannot find provided configuration file. (Can't open the config file user provided via command line args.)
132 | Failed to parse the configuration file. (Includes the syntax error / line number to help user fix it.)
133 | Configuration file is missing setting that has no default / fallback.
134 | Configuration file has setting set to an invalid value.
**14x** | 140-149 executing commands
140 | Command does not exist.
141 | Command is deprecated.
142 | Invalid arguments for command.
**2xx** | **Networking** **2xx** | **Networking**
201 | Not internet connection. 201 | Not internet connection.
202 | Router does not support UPnP. 202 | Router does not support UPnP.