KolibriOS/kolibrios
15
21
Fork 36
Code Issues 129 Pull Requests 31 Actions 1 Projects 1 Releases Wiki Activity

Updated documentation

Browse Source 
git-svn-id: svn://kolibrios.org@499 a494cfbc-eb01-0410-851d-a64ba20cac60
This commit is contained in:
Evgeny Grechnikov (Diamond)
2007-05-16 13:59:46 +00:00
parent 8390a01a58
commit 69160c350e
2 changed files with 28 additions and 78 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
kernel/trunk/docs/sysfuncr.txt
View File

@@ -502,7 +502,7 @@
‚®§¢à é ¥¬®¥ §­ ç¥­¨¥:
* äã­ªæ¨ï ­¥ ¢®§¢à é ¥â §­ ç¥­¨ï
‡ ¬¥ç ­¨ï:
* ‚맮¢ ä㭪樨 ®¡ï§ â¥«¥­ ¯¥à¥¤ ¢ë§®¢®¬ ä㭪権 15.2 ¨ 15.5
* ‚맮¢ ä㭪樨 ®¡ï§ â¥«¥­ ¯¥à¥¤ ¢ë§®¢®¬ ¯®¤ä㭪権 2 ¨ 5.
* „«ï ®¡­®¢«¥­¨ï íªà ­  (¯®á«¥ § ¢¥à襭¨ï á¥à¨¨ ª®¬ ­¤, à ¡®â îé¨å á
ä®­®¬) ¢ë§ë¢ ©â¥ ¯®¤äã­ªæ¨î 3 ¯¥à¥à¨á®¢ª¨ ä®­ .
* …áâì ¯ à­ ï äã­ªæ¨ï ¯®«ã祭¨ï à §¬¥à®¢ ä®­®¢®£® ¨§®¡à ¦¥­¨ï -
@@ -521,8 +521,8 @@
‡ ¬¥ç ­¨ï:
* ‘¬¥é¥­¨¥ ¤«ï â®çª¨ á ª®®à¤¨­ â ¬¨ (x,y) ¢ëç¨á«ï¥âáï ª ª
(x+y*xsize)*3.
* …᫨ 㪠§ ­­®¥ ᬥ饭¨¥ ¯à¥¢ëè ¥â ãáâ ­®¢«¥­­ë© ä㭪樥© 15.1 à §¬¥à,
¢ë§®¢ ¨£­®à¨àã¥âáï.
* …᫨ 㪠§ ­­®¥ ᬥ饭¨¥ ¯à¥¢ëè ¥â ãáâ ­®¢«¥­­ë© ¯®¤ä㭪樥© 1
à §¬¥à, ¢ë§®¢ ¨£­®à¨àã¥âáï.
* „«ï ®¡­®¢«¥­¨ï íªà ­  (¯®á«¥ § ¢¥à襭¨ï á¥à¨¨ ª®¬ ­¤, à ¡®â îé¨å á
ä®­®¬) ¢ë§ë¢ ©â¥ ¯®¤äã­ªæ¨î 3 ¯¥à¥à¨á®¢ª¨ ä®­ .
* …áâì ¯ à­ ï äã­ªæ¨ï ¯®«ã祭¨ï â®çª¨ á ä®­®¢®£® ¨§®¡à ¦¥­¨ï -
@@ -566,8 +566,7 @@
‚®§¢à é ¥¬®¥ §­ ç¥­¨¥:
* äã­ªæ¨ï ­¥ ¢®§¢à é ¥â §­ ç¥­¨ï
‡ ¬¥ç ­¨ï:
* …᫨ 㪠§ ­­®¥ ᬥ饭¨¥ ¯à¥¢ëè ¥â ãáâ ­®¢«¥­­ë© ä㭪樥© 15.1 à §¬¥à,
¢ë§®¢ ¨£­®à¨àã¥âáï.
* <EFBFBD>஢¥àª¨ ª®à४⭮á⨠ᬥ饭¨ï ¨ à §¬¥à  ­¥ ¯à®¨§¢®¤¨âáï.
* –¢¥â ª ¦¤®£® ¯¨ªá¥«ï åà ­¨âáï ª ª 3-¡ ©â­ ï ¢¥«¨ç¨­  BBGGRR.
* <20>¨ªá¥«¨ ä®­®¢®£® ¨§®¡à ¦¥­¨ï § ¯¨á뢠îâáï ¯®á«¥¤®¢ â¥«ì­®
á«¥¢  ­ ¯à ¢®, ᢥàåã ¢­¨§.
@@ -1822,16 +1821,16 @@ db 'Kolibri',0
* …᫨ 㤠«ï¥âáï  ªâ¨¢­ë© (ãáâ ­®¢«¥­­ë© ¯®¤ä㭪樥© 5) ªãàá®à, â®
¢®ááâ ­ ¢«¨¢ ¥âáï ªãàá®à ¯® 㬮«ç ­¨î (áâ ­¤ àâ­ ï áâ५ª ).
------------------- <20>®¤äã­ªæ¨ï 7 - ¤ ­­ë¥ ¯à®ªàã⪨ --------------------
------------------ <20>®¤äã­ªæ¨ï 7 - ¤ ­­ë¥ ¯à®ªàã⪨ -------------------
<EFBFBD> à ¬¥âàë:
* eax = 37 - ­®¬¥à ä㭪樨
* ebx = 7 - ­®¬¥à ¯®¤ä㭪樨
* ebx = 6 - ­®¬¥à ¯®¤ä㭪樨
‚®§¢à é ¥¬®¥ §­ ç¥­¨¥:
* eax = horizontal_offset*65536 + vertical_offset
* eax = [horizontal offset]*65536 + [vertical offset]
‡ ¬¥ç ­¨ï:
* „ ­­ë¥ ¤®áâ㯭ë ⮫쪮  ªâ¨¢­®¬ã ®ª­ã
* <20>®á«¥ ¯à®ç⥭¨ï §­ ç¥­¨ï ®¡­ã«ïîâáï
* „ ­­ë¥ ᮤ¥à¦ â §­ ª®¢ë¥ §­ ç¥­¨ï
* „ ­­ë¥ ¤®áâ㯭ë ⮫쪮  ªâ¨¢­®¬ã ®ª­ã.
* <20>®á«¥ ¯à®ç⥭¨ï §­ ç¥­¨ï ®¡­ã«ïîâáï.
* „ ­­ë¥ ¨¬¥îâ §­ ª®¢ë¥ §­ ç¥­¨ï.
======================================================================
================== ”ã­ªæ¨ï 38 - ­ à¨á®¢ âì ®â१®ª. ==================
@@ -2919,7 +2918,6 @@ dword-
* '/hd0/1/menuet/pics/tanzania.bmp',0
„®áâã¯­ë¥ ¯®¤ä㭪樨:
* ¯®¤äã­ªæ¨ï 0 - ç⥭¨¥ ä ©« /¯ ¯ª¨
* ¯®¤äã­ªæ¨ï 1 - ¯¥à¥§ ¯¨áì ä ©« 
* ¯®¤äã­ªæ¨ï 8 - LBA-ç⥭¨¥ á ãáâனá⢠
* ¯®¤äã­ªæ¨ï 15 - ¯®«ã祭¨¥ ¨­ä®à¬ æ¨¨ ® ä ©«®¢®© á¨á⥬¥
@@ -2984,29 +2982,6 @@ dword-
¨á¯®«ì§ã©â¥ ¯®¤äã­ªæ¨î 11 ä㭪樨 18 ¨«¨
ç¨â ©â¥ ᮮ⢥âáâ¢ãî騥 ¯ ¯ª¨ ¯®¤ä㭪樥© 1 ä㭪樨 70.
======================================================================
============ ”ã­ªæ¨ï 58, ¯®¤äã­ªæ¨ï 1 - ¯¥à¥§ ¯¨á âì ä ©«. ===========
======================================================================
…᫨ ä ©« ­¥ áãé¥áâ¢ã¥â, ®­ ᮧ¤ ñâáï.
…᫨ ä ©« áãé¥áâ¢ã¥â, ®­ ¯¥à¥§ ¯¨á뢠¥âáï.
<EFBFBD> à ¬¥âàë:
* eax = 58 - ­®¬¥à ä㭪樨
* ebx = 㪠§ â¥«ì ­  ¨­ä®à¬ æ¨®­­ãî áâàãªâãàã
”®à¬ â ¨­ä®à¬ æ¨®­­®© áâàãªâãàë:
* +0: dword: 1 = ­®¬¥à ¯®¤ä㭪樨
* +4: dword: ¨£­®à¨àã¥âáï (ãáâ ­ ¢«¨¢ ©â¥ ¢ 0)
* +8: dword: ç¨á«® ¡ ©â ¤«ï § ¯¨á¨
* +12 = +0xC: dword: 㪠§ â¥«ì ­  ¤ ­­ë¥ ¤«ï § ¯¨á¨
* +16 = +0x10: dword: 㪠§ â¥«ì ­  ¡ãä¥à ¤«ï à ¡®âë á¨á⥬ë
(4096 ¡ ©â)
* +20 = +0x14: ASCIIZ-¨¬ï ä ©« , ¯à ¢¨«  ä®à¬¨à®¢ ­¨ï ¨¬ñ­ 㪠§ ­ë ¢
®¡é¥¬ ®¯¨á ­¨¨
‚®§¢à é ¥¬®¥ §­ ç¥­¨¥:
* eax = 0 - ãᯥ譮, ¨­ ç¥ ª®¤ ®è¨¡ª¨ ä ©«®¢®© á¨á⥬ë
* ebx à §àãè ¥âáï
‡ ¬¥ç ­¨ï:
* <20>â  äã­ªæ¨ï ãáâ à¥« , ¨á¯®«ì§ã©â¥ ¯®¤äã­ªæ¨î 2 ä㭪樨 70.
======================================================================
========= ”ã­ªæ¨ï 58, ¯®¤äã­ªæ¨ï 8 - LBA-ç⥭¨¥ á ãáâனá⢠. ========
======================================================================
@@ -3604,7 +3579,7 @@ Architecture Software Developer's Manual, Volume 3, Appendix B);
* edx =  ¤à¥á MSR
* esi:edi = áâ à訩:¬« ¤è¨© dword
‚®§¢à é ¥¬®¥ §­ ç¥­¨¥:
* ebx:eax = ª®¯¨ï esi:edi
* äã­ªæ¨ï ­¥ ¢®§¢à é ¥â §­ ç¥­¨ï
‡ ¬¥ç ­¨ï:
* “ª § ­¨¥ ¢ ecx ­¥áãé¥áâ¢ãî饣® ¨«¨ ­¥à¥ «¨§®¢ ­­®£® ¤«ï ¤ ­­®£®
¯à®æ¥áá®à  MSR ¯®¢«¥çñ⠨᪫î祭¨¥ ¢ ï¤à¥, ª®â®à®¥ ¯à¨¡ìñâ ¯®â®ª.
@@ -3806,7 +3781,7 @@ Architecture Software Developer's Manual, Volume 3, Appendix B);
¯®¤ä㭪樥© 3.
‚ᥠ¯®¤ä㭪樨 ¯à¨¬¥­¨¬ë ⮫쪮 ª ¯à®æ¥áá ¬/¯®â®ª ¬, § ¯ã饭­ë¬
¨§ ⥪ã饣® ä㭪樥© 58 ¨«¨ 70 á ãáâ ­®¢«¥­­ë¬ ä« £®¬ ®â« ¤ª¨.
¨§ ⥪ã饣® ä㭪樥© 70 á ãáâ ­®¢«¥­­ë¬ ä« £®¬ ®â« ¤ª¨.
Žâ« ¤ª  ¬­®£®¯®â®ç­ëå ¯à®£à ¬¬ ¯®ª  ­¥ ¯®¤¤¥à¦¨¢ ¥âáï.
<EFBFBD>®«­ë© ᯨ᮪ ¯®¤ä㭪権:
* ¯®¤äã­ªæ¨ï 0 - ®¯à¥¤¥«¨âì ®¡« áâì ¤ ­­ëå ¤«ï ®â« ¤®ç­ëå á®®¡é¥­¨©

57
kernel/trunk/docs/sysfuncs.txt
View File

@@ -493,7 +493,7 @@ Parameters:
Returned value:
* function does not return value
Remarks:
* Before calling functions 15.2 and 15.5 you should call this function
* Before calling subfunctions 2 and 5 you should call this function
to set image size!
* For update of the screen (after completion of a series of commands
working with a background) call subfunction 3.
@@ -513,7 +513,7 @@ Returned value:
Remarks:
* Offset for a pixel with coordinates (x,y) is calculated as
(x+y*xsize)*3.
* If the given offset exceeds size sets by function 15.1,
* If the given offset exceeds size set by subfunction 1,
the call is ignored.
* For update of the screen (after completion of a series of commands
working with a background) call subfunction 3.
@@ -559,8 +559,7 @@ Parameters:
Returned value:
* function does not return value
Remarks:
* If the block gets out abroad size sets by function 15.1,
the call is ignored.
* Offset and size are not checked for correctness.
* Color of each pixel is stored as 3-bytes value BBGGRR.
* Pixels of the background image are written sequentially
from left to right, from up to down.
@@ -674,7 +673,7 @@ Parameters:
Returned value:
* eax = 0 - success
* else eax = error code of the file system
³àìå÷àíèÿ:
Remarks:
* All folders in the given path must exist, otherwise function
returns value 5, "file not found".
@@ -1414,7 +1413,7 @@ Parameters:
Returned value:
* eax = 0 - success
* eax = 1 - CD base is not defined
³àìå÷àíèÿ:
Remarks:
* Previously CD base port must be defined by call to
subfunction 3 of function 21.
@@ -1797,16 +1796,16 @@ Remarks:
* If the active cursor (set by subfunction 5) is deleted,
the system restores the default cursor (standard arrow).
------------------- Subfunction 7 - get scroll data --------------------
------------------ Subfunction 7 - get scroll data -------------------
Parameters:
* eax = 37 - function number
* ebx = 7 - subfunction number
Returned value:
* eax = horizontal_offset*65536 + vertical_offset
* eax = [horizontal offset]*65536 + [vertical offset]
Remarks:
* Scroll data is available for active window only
* Values are zeroized after reading
* Values ara signed
* Scroll data is available for active window only.
* Values are zeroed after reading.
* Values are signed.
======================================================================
====================== Function 38 - draw line. ======================
@@ -2042,8 +2041,8 @@ Parameters:
* bh = 0 - display in decimal number system
* bh = 1 - display in hexadecimal system
* bh = 2 - display in binary system
* áèòv 16-21 = how many digits to display
* áèòv 22-31 reserved and must be set to 0
* bits 16-21 = how many digits to display
* bits 22-31 reserved and must be set to 0
* ecx = number (if bl=0) or pointer (if bl=1)
* edx = [coordinate on axis x]*65536 + [coordinate on axis y]
* esi = 0xX0RRGGBB:
@@ -2893,7 +2892,6 @@ Examples:
* '/hd0/1/menuet/pics/tanzania.bmp',0
Existing subfunctions:
* subfunction 0 - read file/folder
* subfunction 1 - rewrite file
* subfunction 8 - LBA-read from device
* subfunction 15 - get file system information
@@ -2959,29 +2957,6 @@ Remarks:
use subfunction 11 of function 18 or
read corresponding folder with subfunction 1 of function 70.
======================================================================
============= Function 58, subfunction 1 - rewrite file. =============
======================================================================
If the file does not exist, it is created.
If the file exists, it is rewritten.
Parameters:
* eax = 58 - function number
* ebx = pointer to the information structure
Format of the information structure:
* +0: dword: 1 = subfunction number
* +4: dword: ignored (set to 0)
* +8: dword: number of bytes to write
* +12 = +0xC: dword: pointer to data to write
* +16 = +0x10: dword: pointer to buffer for system operations
(4096 bytes)
* +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
given in the general description
Returned value:
* eax = 0 - success, otherwise file system error code
* ebx destroyed
Remarks:
* This function is obsolete, use subfunction 2 of function 70.
======================================================================
========= Function 58, subfunction 8 - LBA-read from device. =========
======================================================================
@@ -3297,7 +3272,7 @@ Remarks:
============== Function 63 - work with the debug board. ==============
======================================================================
The debug board is the global system buffer (with the size
4096 bytes), to which any program can write (generally speaking,
1024 bytes), to which any program can write (generally speaking,
arbitrary) data and from which other program can read these data.
By the agreement written data are text strings interpreted as
debug messages on a course of program execution. The kernel in
@@ -3573,8 +3548,8 @@ Parameters:
* edx = MSR address
* esi:edi = high:low dword
Returned value:
* ebx:eax = copy of esi:edi
³àìå÷àíèÿ:
* function does not return value
Remarks:
* If ecx contains nonexistent or not implemented for this processor
MSR, processor will generate an exception in the kernel, which
will kill the thread.
@@ -3773,7 +3748,7 @@ If debugger does not want this, it must previously detach by
subfunction 3.
All subfunctions are applicable only to processes/threads started
from the current by function 58 or 70 with set debugging flag.
from the current by function 70 with set debugging flag.
Debugging of multithreaded programs is not supported yet.
The full list of subfunctions:
* subfunction 0 - define data area for debug messages