mirror of
https://github.com/KolibriOS/kolibrios.git
synced 2024-12-19 13:23:27 +03:00
92 lines
6.1 KiB
Plaintext
92 lines
6.1 KiB
Plaintext
; Copyright (c) 2008-2009, diamond
|
||
; All rights reserved.
|
||
;
|
||
; Redistribution and use in source and binary forms, with or without
|
||
; modification, are permitted provided that the following conditions are met:
|
||
; * Redistributions of source code must retain the above copyright
|
||
; notice, this list of conditions and the following disclaimer.
|
||
; * Redistributions in binary form must reproduce the above copyright
|
||
; notice, this list of conditions and the following disclaimer in the
|
||
; documentation and/or other materials provided with the distribution.
|
||
; * Neither the name of the <organization> nor the
|
||
; names of its contributors may be used to endorse or promote products
|
||
; derived from this software without specific prior written permission.
|
||
;
|
||
; THIS SOFTWARE IS PROVIDED BY Alexey Teplov aka <Lrz> ''AS IS'' AND ANY
|
||
; EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
||
; WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||
; DISCLAIMED. IN NO EVENT SHALL <copyright holder> BE LIABLE FOR ANY
|
||
; DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||
; (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
||
; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
||
; ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
||
; (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
||
; SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||
;*****************************************************************************
|
||
|
||
Спецификация на первичный загрузчик KordOS.
|
||
Загрузчик должен предоставлять следующие сервисы:
|
||
1. При загрузке компьютера, получив управление от BIOS'а, загружать
|
||
файл loader из папки kord по адресу 1000:0000.
|
||
Размер файла loader не превосходит 30000h = 192 Kb.
|
||
2. При этом устанавливать следующие регистры:
|
||
ax идентифицирует устройство:
|
||
al = тип:
|
||
'f' - флопик
|
||
'h' - HDD
|
||
'c' - CD/DVD
|
||
'u' - USB флешка
|
||
'?' - неизвестное устройство
|
||
ah = номер устройства (среди всех устройств фиксированного типа)
|
||
bx = тип файловой системы:
|
||
'12' = FAT12
|
||
'16' = FAT16
|
||
'32' = FAT32
|
||
'nt' = NTFS
|
||
'is' = ISO-9660
|
||
ds:si = far-указатель на callback-сервис
|
||
3. Предоставлять callback-сервис для вторичного загрузчика - far-процедуру:
|
||
на входе: ax = запрашиваемая функция
|
||
на выходе: CF=1, если функция не поддерживается; CF=0 иначе
|
||
Загрузчик может разрушать все регистры, включая сегментные,
|
||
за исключением ss и sp.
|
||
4. Всегда должна поддерживаться callback-функция 1:
|
||
назначение: прочитать файл, расположенный на загрузочном устройстве
|
||
на входе: ax = 1, ds:di = указатель на информационную структуру:
|
||
dw:dw far-указатель на буфер,
|
||
первое слово - смещение, второе - сегмент
|
||
dw максимальное число 4Kb-блоков для чтения (0x1000 байт)
|
||
должно быть ненулевым и строго меньше 0x100
|
||
ASCIIZ имя файла в формате "<папка1>/<папка2>/<файл>"
|
||
Если имя файла содержит символы из старшей половины
|
||
ASCIIZ-таблицы или не является 8.3-именем (в смысле, одна из компонент
|
||
имени файла имеет имя длиннее 8 символов или расширение длиннее 3),
|
||
загрузчик может не найти такой файл, даже если он есть
|
||
(а может и найти).
|
||
на выходе: bx = статус:
|
||
0 = успешно
|
||
1 = файл оказался слишком большим, буфер заполнен целиком
|
||
и есть ещё данные файла
|
||
2 = файл не найден
|
||
3 = произошла ошибка чтения
|
||
dx:ax = размер файла или FFFF:FFFF, если файл не найден
|
||
5. Всегда должна поддерживаться callback-функция 2:
|
||
назначение: продолжить чтение файла, частично загруженного функцией 1
|
||
на входе: ax = 2, ds:di = указатель на информационную структуру:
|
||
dw:dw far-указатель на буфер,
|
||
первое слово - смещение, второе - сегмент
|
||
dw максимальное число 4Kb-блоков для чтения (0x1000 байт)
|
||
должно быть ненулевым и строго меньше 0x100
|
||
на выходе: bx = статус:
|
||
0 = успешно
|
||
1 = файл оказался слишком большим, буфер заполнен целиком
|
||
и есть ещё данные файла
|
||
3 = произошла ошибка чтения
|
||
dx:ax = размер файла
|
||
Функцию можно вызывать только в случае, когда последний вызов функции
|
||
1 и все последующие вызовы функции 2 вернули bx=1 (иными словами,
|
||
только для продолжения загрузки файла, который уже был частично
|
||
загружен, но ещё не загружен полностью).
|
||
Загрузчик может быть уверен, что данные в областях памяти 0-9000 и
|
||
60000-A0000 не будут модифицированы ядром.
|