Dumping

### Дампы памяти и файлы журналов регистрации, создаваемые WHDLOAD

Главным образом это нужно для отладочных целей. WHDLoad может создавать различные дампы и файлы журналов регистрации (логи).

#### Дамп памяти

Дамп памяти - снимок всей памяти, которая используется установленной программой. Размер дампа зависит от установленной программы (оно равно значению ws_BaseMemSize в структуре Slave). Дамп памяти будет создан, если была нажата DebugKey или если после ошибки будет нажата кнопка CoreDump. Имя созданного файла дампа памяти - ".whdl_memory". Заданное по умолчанию местоположение - "PROGDIR: ", но оно может быть изменено опцией CoreDumpPath. Существующий файл с тем же самым именем будет всегда перезаписываться. Если установленная программа использует Fast память, дамп сохраняется в файле под именем ".whdl_expmem".

#### Дамп регистров

Дамп регистров содержит последнее состояние центрального процессора (включая MMU), Cia и Custom Chips. Некоторое Cia и Custom регистры не могут быть прочитаны и они включаются в файл дампа только если был активизирован режим Snoop. Информация будет сохранена в файл формата ASCII с подсветкой, используя ESC-последовательности (используется CSI - Последовательность Управляющих Команд, десятичное число 155). Для просмотра такого файла, нужна программа, поддерживающая ESC-последовательности, (например, More, MuchMore, Multiview...). Имя файла дампа регистров - ".whdl_register", заданное по умолчанию местоположение - "PROGDIR: " но оно может быть изменено опцией CoreDumpPath. Если файл с тем же самым названием уже существует, то дамп будет добавлен в конец старого дампа - иначе будет создан новый файл.

#### Complete dump file

Файл дампа сохраняется в формате IFF и содержит информацию обо всех предыдущих дампах. Это необходимо для других приложений. Структура файла описана в файле `whddump.i`. Полученный дамп используется приложением WHDLoadGCI (графический интерфейс) и SP (сохранение экранов) путем его чтения. Имя файла полного дампа - ".whdl_dump". По умолчанию он сохраняется в "PROGDIR:" но можно и изменить путь сохранения с помощью опции CoreDumpPath . Получаемый файл дампа всегда будет перезаписываться.

#### Журнал регистрации доступа к файлам

Все дисковые операции будут записываться в журнал регистрации (лог-файл), если была активизирована опция FileLog. Эта функция будет очень полезна для анализа дисковых операций, производимых установленной программой, в целях отладки и оптимизации. Записи в лог-файл заносят следующие функции:

- resload_DeleteFile
- resload_DiskLoad
- resload_Examine
- resload_ExNext
- resload_GetFileSize
- resload_GetFileSizeDec
- resload_ListFiles
- resload_LoadFile
- resload_LoadFileDecrunch
- resload_LoadFileOffset
- resload_SaveFile
- resload_SaveFileOffset

Вышеупомянутые функции при каждом доступе к файлу, создают одну запись в журнале, в строке записывается имя вызванной функции, контрольная сумма чтения/записи данных, параметры и результат операции. WHDLoad заносит все вхождения в лог во внутренний буфер. Буфер сохраняется при выходе из программы, либо если буфер полон - в момент доступа. Информация будет записана в ASCII файл, имя файла дампа - ".whdl_filelog", заданное по умолчанию местоположение - "PROGDIR: " но оно может быть изменено опцией CoreDumpPath.