main.c File Reference

Ядро эмулятора архитектуры PDP-11. More...

#include "pdp_11/pdp_11.h"
#include "pdp_11/run.h"
#include "tests/test_pdp/test_pdp.h"
#include "utils/logger/logger.h"
#include <assert.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

Include dependency graph for main.c:

Functions
int	start_test_if_mode_debug (int argc, char **argv)
	Селектор режима отладки.
int	main (int argc, char **argv)
	Главная точка входа в приложение (Main Entry Point).

Detailed Description

Ядро эмулятора архитектуры PDP-11.

Данный файл является "точкой сборки" всей системы. Он управляет жизненным циклом эмулятора: от парсинга аргументов командной строки до корректного освобождения ресурсов после завершения работы.

Author

<koles.nosp@m.niko.nosp@m.vvita.nosp@m.liy@.nosp@m.mail..nosp@m.ru Vitaliy Kolesnikov>

Date

2026

Function Documentation

main()

int main	(	int	argc,
		char **	argv
	)

Главная точка входа в приложение (Main Entry Point).

Алгоритм работы:

1. Проверка необходимости запуска тестов.
2. Аллокация и "чистая" инициализация контекста PDP-11.
3. Передача управления диспетчеру выполнения (функция run).
4. Деаллокация памяти.

Parameters

[in]	argc	Количество аргументов командной строки.
[in]	argv	Массив строк аргументов.

Returns

Статус завершения процесса.

Return values

0	Успешное завершение.
!=0	Критическая ошибка при работе эмулятора.

Note

Инициализация через pdp_new гарантирует нулевое состояние регистров и памяти, что предотвращает "undefined behavior" и ошибки Valgrind.

{
    // Проверка режима отладки перед стартом основной логики
    start_test_if_mode_debug(argc, argv);
 
    struct pdp_11_t *pdp = pdp_new();
    assert(pdp != NULL);
 
    DEBUG("PDP_11 ИНИЦИАЛИЗИРОВАНА", "");
 
    /* Запуск исполнительного цикла */
    run(pdp, argc, argv);
 
    /* Очистка контекста перед выходом */
    free(pdp);
 
    return 0;
}

Here is the call graph for this function:

start_test_if_mode_debug()

int start_test_if_mode_debug	(	int	argc,
		char **	argv
	)

Селектор режима отладки.

Переключатель режимов: Тестирование vs Эмуляция.

Анализирует массив аргументов командной строки на наличие флага -d. При обнаружении флага прерывает стандартный поток выполнения и запускает модуль модульного тестирования.

Parameters

[in]	argc	Количество аргументов (передается из main).
[in]	argv	Вектор строк аргументов.

Return values

1	Обнаружен флаг отладки, тесты выполнены.
0	Флаг отсутствует, требуется обычный запуск.

Note

Вызов этой функции должен происходить до инициализации основных структур данных.

Проходит по массиву аргументов командной строки в поиске управляющего флага -d. Если флаг обнаружен, функция немедленно инициирует выполнение набора тестов через вызов test_pdp.

Parameters

[in]	argc	Количество аргументов, переданных программе.
[in]	argv	Массив строк (аргументов), где выполняется поиск флага.

Return values

1	Обнаружен режим отладки, тесты запущены.
0	Режим отладки не активен, работа продолжается в штатном режиме.

Note

Поиск чувствителен к регистру; флаг должен быть в нижнем регистре ("-d").

Attention

Функция не проверяет остальные аргументы после нахождения первого вхождения "-d".

Todo:

Добавить поддержку расширенных флагов отладки (например, "-d:verbose") для выбора конкретных групп тестов.

{
    if (argv == NULL || argc < 1) {
        return 0;
    }
 
    for (int i = 0; i < argc; i++) {
        if (strcmp("-d", argv[i]) == 0) {
            DEBUG("ЗАПУСК ТЕСТОВ", "");
            test_pdp(argc, argv);
            return 1;
        }
    }
 
    return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function: