From 953d47e06c6735ec8c069353688be4ddad21df5e Mon Sep 17 00:00:00 2001
From: Doczom <Doczom@kolibrios.org>
Date: Sat, 23 Apr 2022 21:32:11 +0000
Subject: [PATCH] Add documentation on 68.31 sysfn

git-svn-id: svn://kolibrios.org@9779 a494cfbc-eb01-0410-851d-a64ba20cac60
---
 kernel/trunk/docs/sysfuncr.txt | 42 ++++++++++++++++++++++++++++++++++
 kernel/trunk/docs/sysfuncs.txt | 26 +++++++++++++++++++++
 2 files changed, 68 insertions(+)

diff --git a/kernel/trunk/docs/sysfuncr.txt b/kernel/trunk/docs/sysfuncr.txt
index c686797981..b7225881ed 100644
--- a/kernel/trunk/docs/sysfuncr.txt
+++ b/kernel/trunk/docs/sysfuncr.txt
@@ -3680,6 +3680,48 @@ Architecture Software Developer's Manual, Volume 3, Appendix B);
 Примечания:
   * функция загружает и, при необходимости, распаковывает файл (kunpack)
 
+======================================================================
+======== Функция 68, подфункция 29 - allocate ring memory. =========
+======================================================================
+Parameters:
+  * eax = 68 - function number
+  * ebx = 29 - subfunction number
+  * ecx = required size in bytes
+Returned value:
+  * eax = 0 - failed
+  * eax = pointer to the allocated ring
+Remarks:
+  * The requested size must be an exact multiple of pagesize (4 Kb)
+  * The function allocates memory in such a way that you can read and
+    write beyond the size of the allocated memory and will reach the 
+    beginning of the buffer again.
+
+
+======================================================================
+======== Функция 68, подфункция 31 - получить данные драйвера. =======
+======================================================================
+Параметры:
+  * eax = 68 - номер функции
+  * ebx = 31 - номер подфункции
+  * ecx = функция (1 - получить начальные значения списка,
+                   2 - получить элемент списка)
+  * edx = Если ecx=2 указатель на структуру.
+  * edi = Если ecx=2 указатель на память под структуру
+Возвращаемое значение:
+  * Если ecx = 1, то ebx = fd 
+                     ecx = bk
+  * Если ecx = 2, то eax = 0  операция прошла успешно
+                     eax = -1 ошибка
+Примечания:
+  * возвращаемая структура
+   data_service:
+     .name:         rb 16
+     .fd:           rd 1
+     .bk:           rd 1
+     .base:         rd 1
+     .entry:        rd 1
+     .srv_proc:     rd 1
+
 ======================================================================
 ======================== Функция 69 - отладка. =======================
 ======================================================================
diff --git a/kernel/trunk/docs/sysfuncs.txt b/kernel/trunk/docs/sysfuncs.txt
index 254df7ec6d..bb4dccba14 100644
--- a/kernel/trunk/docs/sysfuncs.txt
+++ b/kernel/trunk/docs/sysfuncs.txt
@@ -3665,6 +3665,32 @@ Remarks:
   eax - SF_SYS_MISC (68)
   ebx - SSF_MEM_ALLOC_RING (29)  
 
+======================================================================
+============ Function 68, subfunction 31 - get data driver. ==========
+======================================================================
+Параметры:
+  * eax = 68 - function number
+  * ebx = 31 - subfunction number
+  * ecx = function (1 - get first pointers on list,
+                    2 - get item list)
+  * edx = if ecx=2 pointer on structure.
+  * edi = if ecx=2 pointer on memory for structure.
+Возвращаемое значение:
+  * If ecx = 1, then ebx = fd 
+                     ecx = bk
+  * If ecx = 2, then eax = 0  ok
+                     eax = -1 error
+Примечания:
+  *  Returned structure
+   data_service:
+     .name:         rb 16
+     .fd:           rd 1
+     .bk:           rd 1
+     .base:         rd 1
+     .entry:        rd 1
+     .srv_proc:     rd 1
+
+
 ======================================================================
 ====================== Function 69 - debugging. ======================
 ======================================================================