TrustedUser, Bureaucrats, Administrators
442
edits
Difference between revisions of "Reporting unknown MD5 checksums"
Jump to navigation
Jump to search
Reporting unknown MD5 checksums (view source)
Revision as of 00:25, 6 October 2023
, 00:25, 6 October 2023Updates MacOS manual MD5 instructions
Thunderforge (talk | contribs) (Adding more macOS info) |
(Updates MacOS manual MD5 instructions) |
||
| (5 intermediate revisions by 3 users not shown) | |||
| Line 3: | Line 3: | ||
==From ScummVM== | ==From ScummVM== | ||
The | {{ManualScreenshot|name=Unknown game dialog.png|desc=Unknown game dialog}} | ||
{{ManualScreenshot|name=Unknown game ticket.png|desc=Unknown game ticket}} | |||
Recent versions of ScummVM will display a dialog when detecting unknown game variants when you try to add a game to ScummVM. From this dialog you may have the option to report the game directly to [https://bugs.scummvm.org our bug tracker]. This will generate automatically the new ticket, but please add the game name, version, and language to the description before submitting the ticket. | |||
The option to report the game is not available on all platforms, and in that case you may want to use the option to copy the detection information to the clipboard instead, and then paste it manually to your report. | |||
As a last resort, if neither the '''Report game''' nor the '''Copy to clipboard''' options are available on your platform, or if you are using an older version of ScummVM, the detection information will also be available in the ScummVM console window and in the ScummVM log file, and you can copy it from there. Check the README on how you can access the console or the log file for your platform. You can also redirect ScummVM's output to a text file, by running ScummVM as follows: | |||
scummvm > file.txt | scummvm > file.txt | ||
If for some reason | If for some reason none of the options above are working, you need to follow an a bit harder process. | ||
==Manually== | ==Manually== | ||
| Line 14: | Line 21: | ||
Number of bytes in each engine, to compute an MD5 hash:<br> | Number of bytes in each engine, to compute an MD5 hash:<br> | ||
''[[AGI]], [[AGOS]], [[Blade Runner]], [[Cine]], [[Composer]], [[CruisE]], [[Draci]], [[Drascula]], [[Dreamweb]], [[Gob]], [[M4]], [[MADE]], [[Mohawk]], [[Parallaction]], [[SAGA]], [[SCI]], [[TeenAgent]], [[Tinsel]]'' - '''5000''' bytes (default)<br> | ''[[AGI]], [[AGOS]], [[Blade Runner]], [[Cine]], [[Composer]], [[CruisE]], [[Director]], [[Draci]], [[Drascula]], [[Dreamweb]], [[Gob]], [[Groovie]], [[M4]], [[MADE]], [[Mohawk]], [[Parallaction]], [[SAGA]], [[SCI]], [[TeenAgent]], [[Tinsel]]'' - '''5000''' bytes (default)<br> | ||
''[[Lure]]'' - '''1024''' bytes<br> | ''[[Lure]]'' - '''1024''' bytes<br> | ||
''[[Kyra]], [[SCUMM]]'' - '''1024 * 1024''' bytes<br> | ''[[Kyra]], [[SCUMM]]'' - '''1024 * 1024''' bytes<br> | ||
| Line 23: | Line 30: | ||
To get the correct MD5 checksum, run the following | To get the correct MD5 checksum, run the following | ||
=== Using ScummVM === | |||
Since version 2.6.0, ScummVM can compute and report the md5 of files on the command line. | |||
scummvm --md5 --md5-path=file --md5-engine=engine | |||
Where <code>file</code> is the file to be examined and <code>engine</code> is the engine that would use this file. This will automatically use the size used for detection by the specified engine. The size can also be provided manually using <code>--md5-length=size</code> instead of <code>--md5-engine=engine</code> | |||
For old Mac files with a resource fork, us <code>--md5mac</code> instead of <code>--md5</code>. | |||
===Under *nix=== | ===Under *nix=== | ||
| Line 31: | Line 46: | ||
===Under macOS=== | ===Under macOS=== | ||
head -c size file | md5 -r | |||
Where <code>file</code> is the file to be examined. | Where <code>file</code> is the file to be examined and <code>size</code> depends on the engine, as described above. | ||
Alternatively, you can install [https://raamdev.com/2008/howto-install-md5sum-sha1sum-on-mac-os-x/ md5sum] and run the *nix command above. | Alternatively, you can install [https://raamdev.com/2008/howto-install-md5sum-sha1sum-on-mac-os-x/ md5sum] and run the *nix command above. | ||
| Line 50: | Line 65: | ||
After you get the MD5 sums of the game files, you can report them by using our [https://bugs.scummvm.org bug tracker]. It is much preferred over a post in the forums. | After you get the MD5 sums of the game files, you can report them by using our [https://bugs.scummvm.org bug tracker]. It is much preferred over a post in the forums. | ||
Also to speedup things, please consider providing directory layout of your game. | Please indicate the game name, version, and language in the report. Also to speedup things, please consider providing directory layout of your game. | ||