updated loader_doc.txt

git-svn-id: svn://kolibrios.org@657 a494cfbc-eb01-0410-851d-a64ba20cac60

kernel/trunk/docs/loader_doc.txt

@@ -1,7 +1,23 @@
+; (english text below)
+
+;------------------------------------------
+; Èíòåðôåéñ ñîõðàíåíèÿ ïàðàìåòðîâ
+;------------------------------------------
+Åñëè ïðè ïåðåäà÷å óïðàâëåíèÿ ÿäðó çàãðóç÷èê óñòàíàâëèâàåò AX='KL',
+òî â DS:SI ÿäðî îæèäàåò äàëüíåãî óêàçàòåëÿ íà ñëåäóþùóþ ñòðóêòóðó:
+        db      âåðñèÿ ñòðóêòóðû, äîëæíà áûòü 1
+        dw      ôëàãè:
+                áèò 0 óñòàíîâëåí = ïðèñóòñòâóåò îáðàç ðàìäèñêà â ïàìÿòè
+        dd      äàëüíèé óêàçàòåëü íà ïðîöåäóðó ñîõðàíåíèÿ ïàðàìåòðîâ
+                ìîæåò áûòü 0, åñëè çàãðóç÷èê íå ïîääåðæèâàåò
+Ïðîöåäóðà ñîõðàíåíèÿ ïàðàìåòðîâ äîëæíà çàïèñàòü ïåðâûé ñåêòîð ÿäðà
+kernel.mnt íàçàä íà òî ìåñòî, îòêóäà îíà åãî ñ÷èòàëà; âîçâðàò èç
+ïðîöåäóðû îñóùåñòâëÿåòñÿ ïî retf.
+
 ;------------------------------------------
 ; Указание загрузчиком системного каталога
 ;------------------------------------------
-Ïåðåä ïåðåäà÷åé óïðàâëåíèÿ ÿäðó ìîãóò áûòü óñòàíîâëåííû ñëåäóþùèå ðåãèñòðû:
+Ïåðåä ïåðåäà÷åé óïðàâëåíèÿ ÿäðó ìîãóò áûòü óñòàíîâëåíû ñëåäóþùèå ðåãèñòðû:
 CX='HA'
 DX='RD'
 Это указывает на то, что регистр BX указывает на системный раздел. Каталог /kolibri/ на
@@ -16,7 +32,7 @@ DX='RD'
 'm' - Приводы CD-ROM
 
 Возможные значения регистра BH (указывает на раздел):
-äëÿ BL='a','b','c','d','r' - óêàçûâàåò íà íàçäåë, ãäå ðàñïîëîæåí ñèñòåìíûé êàòàëîã
+äëÿ BL='a','b','c','d','r' - óêàçûâàåò íà ðàçäåë, ãäå ðàñïîëîæåí ñèñòåìíûé êàòàëîã
 для BL='m',указывает на номер физического устройства, с которого надо начинать поиск системного каталога.
 
 примеры значений регистра BX:
@@ -28,18 +44,30 @@ DX='RD'
 'r1' - /rd/1/
 
 
-
+;------------------------------------------
+; Interface for saving boot-screen settings
+;------------------------------------------
+If a loader sets AX='KL' when transferring control to the kernel,
+the kernel expects in DS:SI far pointer to the following structure:
+        db      structure version, must be 1
+        dw      flags
+                bit 0 set = ramdisk image in memory is present
+        dd      far pointer to save settings procedure
+                may be 0 if such procedure is not supported by loader
+Procedure for saving settings must write the first sector of the kernel
+kernel.mnt back to the place, from where it has been read; return from
+this procedure must be with retf.
 
 ;------------------------------------------ 
-; Note boot system directory
+; System directory information from loader
 ;------------------------------------------ 
-The transfer of the kernel can be installed following registers:
+Before transfer of control to the kernel following registers can be set:
 CX = 'HA'
 DX = 'RD'
-This indicates that the register BX points to a system partition. Catalog /kolibri/ in
+This indicates that the register BX identifies system partition. The folder /kolibri/ in
-this section is system, it is treated as a /sys/
+this partition is system folder, it can be referenced as /sys/
 
-Possible values register BL (indicates the device):
+Possible values for register BL (indicates the device):
 'a' - Primary Master
 'b' - Primary Slave
 'c' - Secondary Master
@@ -47,8 +75,8 @@ Possible values register BL (indicates the device):
 'r' - RAM disc
 'm' - ROM drives
 
-Possible values register BH (indicating section):
+Possible values for register BH (indicates section):
-for BL = 'a', 'b', 'c', 'd', 'r' to denote nazdel where the system folder
+for BL = 'a', 'b', 'c', 'd', 'r' to denote partition where the system folder
 for BL = 'm', indicates the number of physical devices, which must begin a systematic search directory.
 
 Examples of register BX:
@@ -56,7 +84,5 @@ Examples of register BX:
 'a2' - /hd0/2/
 'b1' - /hd1/1/
 'd4' - /hd3/4/
-'m0' - search directory sidyukam kolibri
+'m0' - search directory 'kolibri' by all CD-ROMs
 'r1' - /rd/1/
-
-Ïåðåâåäåíî Google