451ab91e |
1 | ============================================================================== |
2 | savestate_convert.txt - Mupen64Plus - July 12th, 2008 |
3 | |
4 | This conversion tool was written to help users migrate their savestate files |
5 | when there are changes to the savestate file format which break backward |
6 | compatibility. |
7 | |
8 | To compile the conversion tool, open a console window, go to the root of your |
9 | Mupen64Plus source code, and type: |
10 | |
11 | gcc -o savestate_convert -lz tools/savestate_convert.c |
12 | |
13 | This will create a small command-line application called 'savestate_convert'. |
14 | This program takes only one command-line parameter, which is a path to the |
15 | savestate file that you want to update. The old savestate file will be |
16 | overwritten with the new one, so you may wish to first make a backup copy |
17 | of the savestate file. If you update a savestate file to a newer version, |
18 | older versions of Mupen64Plus will not be able to load it. |
19 | |
20 | If you wish to update all of the savestate files in your home directory, you |
21 | may do so with the following bash command: |
22 | |
23 | for file in ~/.mupen64plus/save/*.st*; do ./savestate_convert "${file}"; done |
24 | |
25 | ============================================================================== |
26 | Savestate File Format History: |
27 | |
28 | version 0: |
29 | - Original (Unversioned) file format |
30 | - used by Mupen64 v0.5 and Mupen64Plus up to v1.4 |
31 | |
32 | version 1.0: |
33 | - bugfix: TLB was not being entirely saved and restored |
34 | - added small header with magic number and version number |
35 | - introduced in rev 758 of Mupen64Plus SVN repository (trunk) |
36 | |