WebSVN – Kolibri OS – Diff – /kernel/trunk/docs/sysfuncr.txt

 ---------------------- Константы для регистров: ----------------------
   eax - SF_GET_SYS_DATE (29)
 ======================================================================
 ================ Функция 30 - работа с текущей папкой. ===============
 ======================================================================
 -------- Подфункция 1 - установить текущую папку для потока. ---------
 Параметры:
   * eax = 30 - номер функции
   * ebx = 1 - номер подфункции
   * ecx = указатель на строку с путём к новой текущей папке,
     правила формирования строки указаны в описании функции 70.
 Возвращаемое значение:
   * функция не возвращает значения
+----------------------------------------------------------------------
 --------- Подфункция 2 - получить текущую папку для потока. ----------
 Параметры:
   * eax = 30 - номер функции
   * ebx = 2 - номер подфункции
   * ecx = указатель на буфер
   * edx = размер буфера
 Возвращаемое значение:
-  * eax = длина имени текущей папки (включая завершающий 0)
+  * eax = длина строки (включая завершающий 0)
 Замечания:
-  * Если размера буфера недостаточно для копирования всего имени,
+  * Если размера буфера недостаточно для копирования всего пути,
-    копируются только первые (edx-1) байт и в конце ставится
+    копируются только часть строки и в конце ставится завершающий 0.
-    завершающий 0.
   * По умолчанию, текущая папка для потока - "/rd/1".
   * При создании процесса/потока текущая папка наследуется от
     родителя.
+----------------------------------------------------------------------
 ---- Подфункция 3 - установить доп. системную директорию для ядра ----
 Параметры:
   * eax = 30 - номер функции
   * ebx = 3 - номер подфункции
   * ecx = указатель на блок данных:
-    для кодировки cp866:
 key     rb  64
 path    rb  64
-    для кодировки UTF-16LE:
-key     rb  64
-        dw  2
-path    rw  31
     Пример:
 align 64
 key     db  'kolibrios',0   ; ключ должен быть в нижнем регистре
 align 64
 path    db  'HD0/1',0
 Возвращаемое значение:
   * функция не возвращает значения
 Замечания:
   * Функция может быть вызвана только 1 раз за 1 сессию работы ОС.
-  * Кодировка не влияет на символьный ключ.
+  * При вводе пути символьный ключ не зависит от кодировки.
+----------------------------------------------------------------------
------ Подфункция 4 - получить текущую папку в кодировке UTF-16LE -----
+--- Подфункция 4 - установить текущую папку с указанием кодировки. ---
 Параметры:
   * eax = 30 - номер функции
+  * ebx = 4 - номер подфункции
+  * ecx = указатель на строку с путём к новой текущей папке
+  * edx = кодировка строки, подробности указаны в описании функции 80.
+Возвращаемое значение:
+  * функция не возвращает значения
+----------------------------------------------------------------------
+---- Подфункция 5 - получить текущую папку с указанием кодировки. ----
+Параметры:
+  * eax = 30 - номер функции
-  * ebx = 4 - номер подфункции
+  * ebx = 5 - номер подфункции
   * ecx = указатель на буфер
+  * edx = размер буфера
-  * edx = размер буфера
+  * esi = кодировка строки
 Возвращаемое значение:
-  * eax = количество символов в строке (включая завершающий 0)
+  * eax = длина строки в байтах (включая завершающий 0)
 Замечания:
-  * Если размера буфера недостаточно для копирования всего имени,
+  * Если размера буфера недостаточно для копирования всего пути,
-    копируются только первые (edx-2) байт и в конце ставится
-    завершающий 0.
+    копируются только часть строки и в конце ставится завершающий 0.
   * По умолчанию, текущая папка для потока - "/rd/1".
   * При создании процесса/потока текущая папка наследуется от
     родителя.
 ---------------------- Константы для регистров: ----------------------
   eax - SF_SYS_MISC (68)
   ebx - SSF_CONTROL_DRIVER (17)
 ======================================================================
-============= Функция 68, подфункция 19 - загрузить DLL. =============
+== Функция 68, подфункция 18 - загрузить DLL с указанием кодировки. ==
 ======================================================================
 Параметры:
   * eax = 68 - номер функции
-  * ebx = 19 - номер подфункции
+  * ebx = 18 - номер подфункции
-  * ecx = указатель на строку с путём к DLL,
+  * ecx = указатель на строку с путём к DLL
-    правила формирования строки указаны в описании функции 70.
+  * edx = кодировка строки, подробности указаны в описании функции 80.
 Возвращаемое значение:
   * eax = 0 - неудача
   * иначе eax = указатель на таблицу экспорта DLL
 Замечания:
   * Таблица экспорта представляет собой массив структур по 2 dword'а,
     заканчивающийся нулём. Первый dword в структуре является
+    указателем на имя функции, второй содержит адрес функции.
+======================================================================
+============= Функция 68, подфункция 19 - загрузить DLL. =============
+======================================================================
+Параметры:
+  * eax = 68 - номер функции
+  * ebx = 19 - номер подфункции
+  * ecx = указатель на строку с путём к DLL,
+    правила формирования строки указаны в описании функции 70.
+Возвращаемое значение:
+  * eax = 0 - неудача
-    указателем на имя функции, второй содержит адрес функции.
+  * иначе eax = указатель на таблицу экспорта DLL
 ---------------------- Константы для регистров: ----------------------
   eax - SF_SYS_MISC (68)
   ebx - SSF_LOAD_DLL (19)
 ---------------------- Константы для регистров: ----------------------
   eax - SF_SYS_MISC (68)
   ebx - SSF_SET_EXCEPTION_STATE (25)
 ======================================================================
-= Функция 68, подфункция 26 - освободить страницы памяти ============
+======= Функция 68, подфункция 26 - освободить страницы памяти =======
 ======================================================================
 Параметры:
   * eax = 68 - номер функции
   * ebx = 26 - номер подфункции
 ---------------------- Константы для регистров: ----------------------
   eax - SF_SYS_MISC (68)
   ebx - SSF_MEM_FREE_EXT (26)
 ======================================================================
-= Функция 68, подфункция 27 - загрузить файл ===================
+============= Функция 68, подфункция 27 - загрузить файл =============
 ======================================================================
 Параметры:
   * eax = 68 - номер функции
   * ebx = 27 - номер подфункции
 ---------------------- Константы для регистров: ----------------------
   eax - SF_SYS_MISC (68)
   ebx - SSF_LOAD_FILE (27)
+======================================================================
+== Функция 68, подфункция 28 - загрузить файл с указанием кодировки ==
+======================================================================
+Параметры:
+  * eax = 68 - номер функции
+  * ebx = 28 - номер подфункции
+  * ecx = указатель на строку с путём к файлу
+  * edx = кодировка строки, подробности указаны в описании функции 80.
+Возвращаемое значение:
+  * eax = указатель на загруженный файл или 0
+  * edx = размер загруженного файла или 0
+Примечания:
+  * функция загружает и, при необходимости, распаковывает файл (kunpack)
 ======================================================================
 ======================== Функция 69 - отладка. =======================
 ======================================================================
 Процесс может загрузить другой процесс как отлаживаемый установкой
 соответствующего бита при вызове подфункции 7 функции 70.
   * eax = 0 - успешно; иначе код ошибки файловой системы
   * в зависимости от подфункции может возвращаться значение и
     в других регистрах
 Общий формат информационной структуры:
   * +0: dword: номер подфункции
-  * +4: dword: смещение в файле
+  * +4: dword: смещение в файле или папке
-  * +8: dword: старший dword смещения (должен быть 0) или поле флагов
+  * +8: dword: старшая часть смещения или поле флагов
-  * +12 = +0xC: dword: размер
+  * +12 = +0xC: dword: размер данных
   * +16 = +0x10: dword: указатель на данные
   * +20 = +0x14: ?: текстовая строка - путь к файлу, заканчивается нулём
   или
   * +20 = +0x14: byte: 0
   * +21 = +0x15: dword: указатель на строку
 Чувствительность к регистру букв зависит от файловой системы.
 Если путь начинается не с '/', то он считается относительным.
 Получить или установить текущую папку можно с помощью сисфункции 30.
-'../' в начале пути означает подъём на одну папку относительно текущей.
+'../' в пути означает подъём на одну папку относительно текущей.
 Можно указать кодировку строки, поместив в её начале байт со значениями:
   * 1 = cp866
   * 2 = UTF-16LE
   * 3 = UTF-8
 иначе будет использоваться кодировка cp866. В абсолютном пути можно
 поместить этот байт после '/' или добавить дополнительный '/' перед ним.
+Также, можно использовать сисфункцию 80.
 Формат абсолютного пути:
   /base/number/dir1/dir2/.../dirn/file,
 где base/number идентифицирует устройство, на котором ищется файл:
   * RD/1 = рамдиск
   * FD/1 = первый флоппи-дисковод,
   * ebx = указатель на информационную структуру
 Формат информационной структуры:
   * +0: dword: 1 = номер подфункции
   * +4: dword: индекс начального блока (считая с 0)
   * +8: dword: в какой кодировке возвращать имена:
-= cp866 -> байт на символ
+= по умолчанию
+= cp866
-= UTF-16LE -> 2 байта на символ
+= UTF-16LE
+= UTF-8
   * +12 = +0xC: dword: сколько блоков читать
-  * +16 = +0x10: dword: указатель на буфер, куда будут записаны
+  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные.
-    данные, размер буфера должен быть не меньше 32+n(40+256*enc+8) байт
   * +20 = +0x14: путь, правила формирования имён указаны в общем описании
 Возвращаемое значение:
   * eax = 0 - успешно, иначе код ошибки файловой системы
   * ebx = число файлов, информация о которых была записана в буфер,
     или -1=0xffffffff, если папка не найдена
       архивации имеют опцию, по которой архивируются только файлы
       с установленным этим битом, после чего этот бит сбрасывается -
       это может быть полезно для автоматического создания
       backup-архивов, ибо при записи бит обычно устанавливается
       (не в Kolibri, правда)
-  * +4: dword: кодировка имени:
+  * +4: dword: кодировка имени, соответствует полю +8 информационной структуры
-    * 0 = cp866 -> байт на символ
-    * 1 = UTF-16LE -> 2 байта на символ
   * +8: 4*byte: время создания файла
   * +12 = +0xC: 4*byte: дата создания файла
   * +16 = +0x10: 4*byte: время последнего доступа (чтение или запись)
   * +20 = +0x14: 4*byte: дата последнего доступа
   * +24 = +0x18: 4*byte: время последней модификации
   * +28 = +0x1C: 4*byte: дата последней модификации
   * +32 = +0x20: qword: размер файла в байтах (до 16777216 Тб)
-  * +40 = +0x28: (256*enc+8)*byte: имя
+  * +40 = +0x28: имя, размер в cp866 составляет 264 байта, иначе - 520 байт.
 Формат времени:
   * +0: byte: секунды
   * +1: byte: минуты
   * +2: byte: часы
   * +3: byte: зарезервировано (0)
   * +0: byte: день
   * +1: byte: месяц
   * +2: word: год
   * например, 25.11.1979 записывается как (в hex) 19 0B BB 07
 Замечания:
-  * Если в БДВК присутствует имя в cp866, то длина БДВК составляет
+  * Если БДВК содержит имя в cp866, то длина БДВК составляет
-байта, если в UTF-16LE - 560 байт. Значение длины выравнено
+байта, иначе - 560 байт.
-    на целое кратное 16 байт для ускорения обработки в кэш-памяти CPU.
   * Строка имени заканчивается нулём, дальнейшие данные содержат мусор.
   * Если файлы в папке кончились раньше, чем было прочитано
     запрошенное количество, то функция прочитает, сколько сможет,
     после чего вернёт eax=6 (EOF).
   * Любая папка на диске, кроме корневой, содержит два специальных
     вызовом подфункции 2 функции 18.
 ---------------------- Константы для регистров: ----------------------
   eax - SF_TERMINATE_PROCESS (-1)
+======================================================================
+=== Функция 80 - работа с файловой системой с указанием кодировки. ===
+======================================================================
+Параметры:
+  * eax = 80
+  * ebx = указатель на информационную структуру
+Возвращаемое значение:
+  * eax = 0 - успешно; иначе код ошибки файловой системы
+  * в зависимости от подфункции может возвращаться значение и
+    в других регистрах
+Общий формат информационной структуры:
+  * +0: dword: номер подфункции
+  * +4: dword: смещение в файле или папке
+  * +8: dword: старшая часть смещения или поле флагов
+  * +12 = +0xC: dword: размер данных
+  * +16 = +0x10: dword: указатель на данные
+  * +20 = +0x14: dword: кодировка строки:
+= cp866
+= UTF-16LE
+= UTF-8
+= по умолчанию (поддерживает байт кодировки в начале строки)
+  * +24 = +0x18: dword: указатель на строку пути (заканчивается нулём)
+В остальном полностью соответствует функции 70.
 ======================================================================
 =========================== Список событий ===========================
 ======================================================================
 Очередное событие можно получить вызовом одной из функций 10
 (ожидать события), 11 (проверить без ожидания), 23

Subversion Repositories Kolibri OS

(root)/kernel/trunk/docs/sysfuncr.txt – Rev 6790 → 6798