Kernel code/ru

Ветка trunk ядра KolibriOS. Путеводитель-справочник по исходному коду.

/

Файл init.inc

Содержит функции, необходимые для инициализации системы.

---

mem_test

Проводит тестирование памяти.

Если bios имеет функцию 0xE820, то тестирование не производится и происходит выход из функции.

init_mem

Инициализация системной таблицы страниц

init_page_map

TODO

init_BIOS32

TODO

test_cpu

Получение информации о процессоре.

acpi_locate

Поиск поиск структуры RSDP (Root System Description Pointer) которая используется в ACPI.

Функция возвращает указатель на RSDP в регистре eax.

см. https://wiki.osdev.org/RSDP

rsdt_find

В ecx принимает адрес RSDT, в edx сигнатуру таблицы, которую нужно найти (например ACPI_FADT_SIGN)

В eax возвращает адрес требуемой таблицы

см. https://wiki.osdev.org/RSDT

check_acpi

TODO

init_hpet

Инициализация HPET (High Perfomance Event Timer)

---

Файл kernel32.inc

Этот файл не содержит реализаций и является по сути заголовочным

Здесь содержатся инклуды .inc файлов почти всех подсистем ядра

---

Файл proc32.inc

Содержит макросы для определения и вызова процедур:

---

stdcall proc

Directly call STDCALL procedure

invoke proc

Indirectly call STDCALL procedure

ccall proc

Directly call CDECL procedure

invoke proc

Indirectly call CDECL procedure

proc

...

---

Файл macros.inc

Содержит разные полезные макросы, в том числе для работы со связными списками

---

$Revision

Клиент svn при работе с репозиторием после ключевого слова $Revision: подставляет текущую ревизию файла.

В macros.inc из исходников ядра, подключающемся первым, определён макрос fasm'а $Revision, который вычисляет максимум из всех мест, где он встретился (то есть во всех файлах, прямо или косвенно подключаемым к kernel.asm), каковой максимум и является номером самой свежей ревизии ядра (не драйверов).

В конце kernel.asm он присваивается переменной __REV__, ну а boot/bootstr.inc включает значение __REV__ в начальную выводимую строку.

diff16

Макрос, который вычисляет разность между вторым и первым аргументом и выводит ее на консоль в 16ичной системе счисления во время ассемблирования fasm'ом

Первый аргумент - строка с сообщением

Пример:

diff16 "cur_saved_data (data32.inc) ", 0, $

cur_saved_data rb 4096

Во время ассемблирования данного участка кода, fasm выведет "cur_saved_data (data32.inc) 0xЧИСЛО", где 0xЧИСЛО будет адресом cur_saved_data

diff10

Аналог diff16, только в 10ичной системе.

dbgstr

Вывод строки на доску отладки.

Макросы для работы со связными списками:

list_init_head

Создание списка

__list_add

Добавление в список (внутреннее использование)

list_add

Вставка в начало списка

list_add_tail

Вставка в конец списка

list_del

Удаление из списка

---

Файл struct.inc

Содержит макросы для объявления структур и работы с ними

---

struct

Макрос для объявления структур

---

Файл fdo.inc

Formatted Debug Output (FDO)

Это набор макросов для повышения удобства отладки приложений.

Работает подобно функции printf(), выводя на доску отладки форматированные сообщения.

Доступные спецификаторы формата %s, %d, %u, %x (с частичной поддержкой ширины).

Использовать обычно нужно только DEBUGF, хотя доступны также и DEBUGS, DEBUGD, DEBUGH.

Примеры:

DEBUGF 1, "%s - %d (%x)", eax, 123, ch

DEBUGF 1, "%d.%d.%d.%d", [ip+0]:1, [ip+1]:1, [ip+2]:1, [ip+3]:1

DEBUGF 1, <"function ", __FNAME__, ": %s - %x - %u">, "text here", [var]:5, [esp+16]

DEBUGF 1, "[%d][%d][%d][%d][%d]\n", al, ax, ebx, [eax], [eax]:1

DEBUGF 2, "[%u][%u][%u][%u][%u]\n", al, ax, ebx, [eax], [eax]:1

DEBUGF 3, "[%x][%x][%x][%x][%x]\n", al, ax, ebx, [eax], [eax]:1

DEBUGF 4, "[%s][%s][%s][%s][%s][%s][%s]\n", "string":4, eax, eax:5, [ebx]:5, eax:ecx, eax:[ecx], eax:byte[ecx]

Ширина:

for %s - any number, register, or in-memory variable

for %d - 1, 2, 4 (only for in-memory arguments)

for %u - 1, 2, 4 (only for in-memory arguments)

for %x - 1 .. 8

---

Файл data32.inc

Содержит в основном строковые константы на различных языках (русский, английский и т.д).

Также в здесь объявлены некотрые переменные и настройки ядра

Включает в себя файлы data32sp.inc (испанский) и data32et.inc (эстонский)

keymap

Содежит раскладку клавиатуры (128 байт)

keymap_shift

Раскладка клавиатуры при зажатой Shift

keymap_alt

Раскладка клавиатуры при зажатой Alt

... - далее идут объявления констант с именами boot_*

Это те самые сообщения, которые пишутся белым шрифтом на черном фоне при загрузке KolibriOS

... - далее идут константы, содержащие пути к драйверам, некоторым файлам

shmem_list

TODO

dll_list

TODO

pcidev_list

TODO

...

syslang

Хранит номер языка системы (1 - en, 4 - ru и тд)

gdts

Судя из названия метки: gdts = GDT Start

GDT это Global Descriptor Table, глобальная таблица дескрипторов, в которой описываются сегменты памяти

Далее описаны элементы этой таблицы то есть сегменты:

os_code_l, int_data_l и os_data_l, app_code_l, app_data_l, pci_code_32, pci_data_32, apm_code_32, apm_code_16, apm_data_16, graph_data_l, tss0_1, tls_data_l

gdte

После описания всех сегментов стоит это метка.

Судя из названия: gdte = GDT End

...

pg_data

TODO

...

sys_pgmap

Таблица физических страниц.

Представляет собой массив битов, который для каждой физической страницы описывает, выделена она или свободна.

...

detect/

...