3 When the engine crashes or is closed, it returns an exit code (or error code) which can be used to further analyze the problem. |
3 When the engine crashes or is closed, it returns an exit code (or error code) which can be used to further analyze the problem. |
4 |
4 |
5 = List of engine error codes = |
5 = List of engine error codes = |
6 This is the list of all possible error codes: |
6 This is the list of all possible error codes: |
7 |
7 |
8 || Exit code || Meaning || Description || Solution || |
8 || *Exit code* || *Meaning* || *Description* || *Solution* || |
9 || 0 || No error || Engine exited normally || N/A || |
9 || 0 || No error || Engine exited normally || N/A || |
10 || 51 || Usage error || The engine was launched with invalid command line arguments || Check your command-line arguments. Use `hwengine --help` for a list || |
10 || 51 || Usage error || The engine was launched with invalid command line arguments || Check your command-line arguments. Use `hwengine --help` for a list || |
11 || 52 || Fatal error || Generic error for critical errors. Commonly happens when a critical file like an image was not found || Check the error message or the end of `Logs/game0.log` in your [http://hedgewars.org/wiki/User_directory user directory] for clues || |
11 || 52 || Fatal error || Generic error for critical errors. Commonly happens when a critical file like an image was not found || Check the error message or the end of `Logs/game0.log` in your [http://hedgewars.org/wiki/User_directory user directory] for clues || |
12 || 53 || Startup error || Failure while initializing stuff on startup, like graphics, shader, OpenGL stuff, etc. || Check your [Dependencies] and if you have the latest drivers installed and update them as needed || |
12 || 53 || Startup error || Failure while initializing stuff on startup, like graphics, shader, OpenGL stuff, etc. || Check your [Dependencies] and if you have the latest drivers installed and update them as needed || |
13 || 54 || Fatal error, no IPC socket || Similar to error 52, but the IPC socket is not working for some reason || Check the end of `Logs/game0.log` in your [http://hedgewars.org/wiki/User_directory user directory] for clues || |
13 || 54 || Fatal error, no IPC socket || Similar to error 52, but the IPC socket is not working for some reason || Check the end of `Logs/game0.log` in your [http://hedgewars.org/wiki/User_directory user directory] for clues || |
14 || Other || Free Pascal run-time error. This is probably a bug || See [https://www.freepascal.org/docs-html/user/userap4.html Free Pascal run-time errors] || [http://www.hedgewars.org/bugs Report a bug], then someone should fix it || |
14 || Other || Free Pascal run-time error. This is probably a bug || See [https://www.freepascal.org/docs-html/user/userap4.html Free Pascal run-time errors] || [http://www.hedgewars.org/bugs Report a bug], then someone should fix it || |
15 |
15 |
16 = Error codes when performing engine test cases = |
16 = Error codes when performing engine test cases = |
17 When the engine is used to perform [EngineTestCases test cases], the follwing additional codes are used: |
17 When the engine is used to perform [EngineTestCases test cases], the follwing additional codes are used: |
18 |
18 |
19 || Exit code || Meaning || Solution || |
19 || *Exit code* || *Meaning* || *Solution* || |
20 || 0 || Test succeeded || N/A || |
20 || 0 || Test succeeded || N/A || |
21 || 60 || Test failed || Fix the engine || |
21 || 60 || Test failed || Fix the engine || |
22 || 61 || Lua error in test case || Fix the Lua code of the test case || |
22 || 61 || Lua error in test case || Fix the Lua code of the test case || |
23 || 62 || Unexpected error while testing || Debug || |
23 || 62 || Unexpected error while testing || Debug || |
24 |
24 |