1469
|
1 |
#summary Description and list of engine error codes
|
1467
|
2 |
|
1469
|
3 |
= Engine error codes =
|
|
4 |
When the Hedgewars engine (`hwengine`) crashes or is closed, it returns an exit code (or error code) which can be used to further analyze the problem.
|
1465
|
5 |
|
1469
|
6 |
== List of engine error codes ==
|
1465
|
7 |
This is the list of all possible error codes:
|
|
8 |
|
1468
|
9 |
|| *Exit code* || *Meaning* || *Description* || *Solution* ||
|
1465
|
10 |
|| 0 || No error || Engine exited normally || N/A ||
|
1471
|
11 |
|| 51 || Usage error || The engine was launched with invalid command line arguments || Check your command-line arguments. Type `hwengine --help` in a command line for help ||
|
1482
|
12 |
|| 52 || Fatal error || Generic error for critical errors at runtime || Check the error message or the end of `Logs/game0.log` in your [http://hedgewars.org/wiki/User_directory user directory] for clues ||
|
1472
|
13 |
|| 53 || Startup error || Failure while initializing stuff on startup, like graphics, shader, OpenGL stuff, etc. || Check your [Dependencies dependencies] and if you have the latest video drivers installed and update them as needed ||
|
1465
|
14 |
|| 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 ||
|
1483
|
15 |
|| 55 || Video encoding error || Error while a video recording is being encoded, might be an initialization or file access error || Check the end of `Logs/rec0.log` in your [http://hedgewars.org/wiki/User_directory user directory] for more information ||
|
1473
|
16 |
|| Other || Free Pascal run-time error, see [https://www.freepascal.org/docs-html/user/userap4.html here] || This is probably a bug. Or it might be a problem in your system. || If you believe this is a bug, [http://www.hedgewars.org/bugs report a bug], then someone should fix it ||
|
1465
|
17 |
|
1469
|
18 |
== Error codes when performing engine test cases ==
|
1465
|
19 |
When the engine is used to perform [EngineTestCases test cases], the follwing additional codes are used:
|
|
20 |
|
1468
|
21 |
|| *Exit code* || *Meaning* || *Solution* ||
|
1465
|
22 |
|| 0 || Test succeeded || N/A ||
|
|
23 |
|| 60 || Test failed || Fix the engine ||
|
|
24 |
|| 61 || Lua error in test case || Fix the Lua code of the test case ||
|
|
25 |
|| 62 || Unexpected error while testing || Debug ||
|
|
26 |
|
|
27 |
= Source code =
|
1474
|
28 |
The exit codes are defined in the source code file [https://hg.hedgewars.org/hedgewars/file/tip/hedgewars/uConsts.pas hedgewars/uConsts.pas].
|