Changes between Version 18 and Version 19 of Debugging


Ignore:
Timestamp:
Sep 24, 2016, 1:04:43 PM (13 months ago)
Author:
elexis
Comment:

Replaced rejointest link with #4242

Legend:

Unmodified
Added
Removed
Modified
  • Debugging

    v18 v19  
    132132
    133133=== Serialization test mode ===
    134 The engine has a very useful test mode for debugging serialization errors. Using the `-serializationtest` command line option tells the simulation to do a full test of the simulation state ''every turn''. This will be extremely slow compared to a normal run of the game, but can reveal problems the moment they occur. '''Note:''' it will currently always fail with AI players, since they don't serialize properly.[[BR]]Note: sometimes, OOS only happen over several turns. This makes them unreproducible with the basic serializationtest. In this situation, use [attachment:serializationChange_v2.patch:ticket:3292 this patch]. It will start the second simulation at a given turn, and form then on will update it as if it were a second player.
     134The engine has a very useful test mode for debugging serialization errors. Using the `-serializationtest` command line option tells the simulation to do a full test of the simulation state ''every turn''. This will be extremely slow compared to a normal run of the game, but can reveal problems the moment they occur. '''Note:''' it will currently always fail with AI players, since they don't serialize properly.[[BR]]Note: sometimes, OOS only happen over several turns. This makes them unreproducible with the basic serializationtest. In this situation, use the patch in #4242. It will start the second simulation at a given turn, and form then on will update it as if it were a second player.
    135135
    136136When the serialization test fails, an error window will be shown, but the more useful data is created in the game's log folder (see GameDataPaths) inside `oos_log`. In the following filenames, '''.a''' means data from the primary simulation state (e.g. the one used in a typical game), while '''.b''' is data from the secondary simulation state (e.g. the one being reconstructed every turn to compare with the primary state). When they differ, it's a serialization test failure.