directory_dir2dat_guide [dumping.guide]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Directory Dir2Dat Guide ======

If the "ROM" consists of of multiple directories, you will want to use the "dir2dat" function of [[https://mamedev.emulab.it/clrmamepro/|clrmamepro]] with the following settings in the "Options" section.

{{:submission:clrmamepro_dir2dat_directory_hashing.png?400}}

In other words, make sure only the following boxes are checked in that section:
  * Scan Subfolders
  * Add MD5
  * Add SHA1
  * Add 0-File For Empty Folder
  * Set-Subfolder Mode
  * Keep Archives As Files
  * Keep CHDs As ROMs

You can also press the Load button and load {{ :general:dir2dat-directory.d2d.zip |this}} dir2dat config file to achieve the same thing. 

Make sure to lay out the data as with the following example.

{{:general:directory_dir2_dat_folder_structure.png?400|}}

You can test this setup is working correctly by hashing the contents of {{ :test_dir_structure.zip |this zip}} and comparing the datfile that clrmamepro creates with {{ :test_dir_structure.dat.zip |this pre-made datfile}} . Currently there is no solid solution for "directory hashing" that supports SHA256, so you can leave that hash type out.

In the created datfile, directories, including empty ones, are represented as files with a size of "0" and a CRC32 of "-", and no other attributes. The filename is set as you would expect (e.g. "dirwithemptydir\emptydir2" for one of the directories in the example, except it will have "_" appended to it when clrmamepro is used on Windows, and "\_" when clrmamepro is used on Linux with Wine. There will also be an archive called "Default" with a single empty folder, which should be ignored/deleted.