This page contains some information on how you can better debug FS-UAE problems. In general, checking the contents of FS-UAE.log is a good source of information, as is checking messages printed to stdout.
Some environment variables can be set to aid with debugging problems:
This will cause FS-UAE to log more information about input events to the log file.
This will cause FS-UAE to log all file system operations (for mounted directories) to the log file.
Compile a Debug Version
If you experience a crash, it is helpful to have a stack trace for when the crash occurs. To compile a version suitable for debugging crashes, you should use the optimize=0 option when running make (also for libfsemu):
cd fs-uae-(version) make clean make optimize=0
You can run FS-UAE from the source directory without installing it, just stay in the top of the project directory and run (using Linux as an example):
./fs-uae <optional args>
You can run FS-UAE through gdb like this:
gdb --args ./fs-uae <other args>
If the program crashes through gdb when input is grabbed, it can be a bit awkward (you may need to switch to a virtual console and kill fs-uae/gdb), so the following is highly recommended:
gdb --args ./fs-uae --no-initial-input-grab <other args>
or, to make FS-UAE never grab input automatically (either on startup or when clicking in the FS-UAE window):
gdb --args ./fs-uae --no-automatic-input-grab <other args>