source: xtideuniversalbios/trunk/Assembly_Library/Src/File/FileIO.asm @ 526

Last change on this file since 526 was 526, checked in by krille_n_@…, 11 years ago

Changes:

  • Update of the copyright notices to include the year 2013.
File size: 8.5 KB
Line 
1; Project name  :   Assembly Library
2; Description   :   Functions for file access.
3
4;
5; XTIDE Universal BIOS and Associated Tools
6; Copyright (C) 2009-2010 by Tomi Tilli, 2011-2013 by XTIDE Universal BIOS Team.
7;
8; This program is free software; you can redistribute it and/or modify
9; it under the terms of the GNU General Public License as published by
10; the Free Software Foundation; either version 2 of the License, or
11; (at your option) any later version.
12;
13; This program is distributed in the hope that it will be useful,
14; but WITHOUT ANY WARRANTY; without even the implied warranty of
15; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16; GNU General Public License for more details.
17; Visit http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
18;
19
20
21; Section containing code
22SECTION .text
23
24;--------------------------------------------------------------------
25; FileIO_CreateWithPathInDSSIandAttributesInCX
26;   Parameters:
27;       CX:     File attribute flags
28;       DS:SI:  Ptr to NULL terminated path or file name
29;   Returns:
30;       AX:     DOS error code if CF set
31;       BX:     File handle if CF cleared
32;       CF:     Clear if file opened successfully
33;               Set if error
34;   Corrupts registers:
35;       AX, BX
36;--------------------------------------------------------------------
37ALIGN JUMP_ALIGN
38FileIO_CreateWithPathInDSSIandAttributesInCX:
39    mov     ah, CREATE_OR_TRUNCATE_FILE
40    SKIP2B  bx
41    ; Fall to FileIO_OpenWithPathInDSSIandFileAccessInAL
42
43;--------------------------------------------------------------------
44; FileIO_OpenWithPathInDSSIandFileAccessInAL
45;   Parameters:
46;       AL:     FILE_ACCESS.(mode)
47;       DS:SI:  Ptr to NULL terminated path or file name
48;   Returns:
49;       AX:     DOS error code if CF set
50;       BX:     File handle if CF cleared
51;       CF:     Clear if file opened successfully
52;               Set if error
53;   Corrupts registers:
54;       AX, BX
55;--------------------------------------------------------------------
56FileIO_OpenWithPathInDSSIandFileAccessInAL:
57    mov     ah, OPEN_EXISTING_FILE
58    xchg    dx, si      ; Path now in DS:DX
59    int     DOS_INTERRUPT_21h
60    xchg    si, dx
61    mov     bx, ax      ; Copy file handle to BX
62    ret
63
64
65;--------------------------------------------------------------------
66; FileIO_ReadDXCXbytesToDSSIusingHandleFromBX
67;   Parameters:
68;       BX:     File handle
69;       DX:CX:  Number of bytes to read
70;       DS:SI:  Ptr to destination buffer
71;   Returns:
72;       AX:     DOS error code if CF set
73;       CF:     Clear if successful
74;               Set if error
75;   Corrupts registers:
76;       AX
77;--------------------------------------------------------------------
78ALIGN JUMP_ALIGN
79FileIO_ReadDXCXbytesToDSSIusingHandleFromBX:
80    push    bp
81    mov     bp, FileIO_ReadCXbytesToDSSIusingHandleFromBX
82    call    SplitLargeReadOrWritesToSmallerBlocks
83    pop     bp
84    ret
85
86
87;--------------------------------------------------------------------
88; FileIO_WriteDXCXbytesFromDSSIusingHandleFromBX
89;   Parameters:
90;       BX:     File handle
91;       DX:CX:  Number of bytes to write
92;       DS:SI:  Ptr to source buffer
93;   Returns:
94;       AX:     DOS error code if CF set
95;       CF:     Clear if successful
96;               Set if error
97;   Corrupts registers:
98;       AX
99;--------------------------------------------------------------------
100ALIGN JUMP_ALIGN
101FileIO_WriteDXCXbytesFromDSSIusingHandleFromBX:
102    push    bp
103    mov     bp, FileIO_WriteCXbytesFromDSSIusingHandleFromBX
104    call    SplitLargeReadOrWritesToSmallerBlocks
105    pop     bp
106    ret
107
108
109;--------------------------------------------------------------------
110; File position is updated so next read will start where
111; previous read stopped.
112;
113; FileIO_ReadCXbytesToDSSIusingHandleFromBX
114;   Parameters:
115;       BX:     File handle
116;       CX:     Number of bytes to read
117;       DS:SI:  Ptr to destination buffer
118;   Returns:
119;       AX:     Number of bytes actually read if successful (0 if at EOF before call)
120;               DOS error code if CF set
121;       CF:     Clear if successful
122;               Set if error
123;   Corrupts registers:
124;       Nothing
125;--------------------------------------------------------------------
126ALIGN JUMP_ALIGN
127FileIO_ReadCXbytesToDSSIusingHandleFromBX:
128    mov     ah, READ_FROM_FILE_OR_DEVICE
129    SKIP2B  f
130    ; Fall to FileIO_WriteCXbytesFromDSSIusingHandleFromBX
131
132;--------------------------------------------------------------------
133; File position is updated so next write will start where
134; previous write stopped.
135;
136; FileIO_WriteCXbytesFromDSSIusingHandleFromBX
137;   Parameters:
138;       BX:     File handle
139;       CX:     Number of bytes to write
140;       DS:SI:  Ptr to source buffer
141;   Returns:
142;       AX:     Number of bytes actually written if successful (EOF check)
143;               DOS error code if CF set
144;       CF:     Clear if successful
145;               Set if error
146;   Corrupts registers:
147;       Nothing
148;--------------------------------------------------------------------
149FileIO_WriteCXbytesFromDSSIusingHandleFromBX:
150    mov     ah, WRITE_TO_FILE_OR_DEVICE
151    xchg    dx, si              ; DS:DX now points to buffer
152    int     DOS_INTERRUPT_21h
153    xchg    si, dx
154    ret
155
156
157;--------------------------------------------------------------------
158; SplitLargeReadOrWritesToSmallerBlocks
159;   Parameters:
160;       BX:     File handle
161;       BP:     Ptr to transfer function
162;       DX:CX:  Number of bytes to transfer
163;       DS:SI:  Ptr to transfer buffer
164;   Returns:
165;       AX:     DOS error code if CF set
166;       CF:     Clear if successful
167;               Set if error
168;   Corrupts registers:
169;       AX
170;--------------------------------------------------------------------
171ALIGN JUMP_ALIGN
172SplitLargeReadOrWritesToSmallerBlocks:
173    push    ds
174    push    si
175    push    dx
176    push    cx
177
178    xchg    ax, cx                  ; DX:AX now holds bytes to transfer
179    mov     cx, SPLIT_SIZE_FOR_LARGE_TRANSFERS
180    div     cx                      ; AX = Number of full transfers
181    push    dx                      ; Bytes for last transfer
182    test    ax, ax
183    jz      SHORT .TransferRemainingBytes
184    xchg    dx, ax                  ; DX = Number of full transfers
185
186ALIGN JUMP_ALIGN
187.TransferNextBytes:
188    call    NormalizeDSSI
189    call    bp                      ; Transfer function
190    jc      SHORT .ErrorOccurredDuringTransfer
191    add     si, SPLIT_SIZE_FOR_LARGE_TRANSFERS
192    dec     dx
193    jnz     SHORT .TransferNextBytes
194.TransferRemainingBytes:
195    pop     cx                      ; CX = Bytes for last transfer
196    jcxz    .ReturnErrorCodeInAX    ; No remaining bytes
197    call    NormalizeDSSI
198    call    bp
199.ReturnErrorCodeInAX:
200    pop     cx
201    pop     dx
202    pop     si
203    pop     ds
204    ret
205.ErrorOccurredDuringTransfer:
206    pop     cx                      ; Remove bytes for last transfer
207    jmp     SHORT .ReturnErrorCodeInAX
208
209;--------------------------------------------------------------------
210; NormalizeDSSI
211;   Parameters
212;       DS:SI:  Ptr to normalize
213;   Returns:
214;       DS:SI:  Normalized pointer
215;   Corrupts registers:
216;       Nothing
217;--------------------------------------------------------------------
218ALIGN JUMP_ALIGN
219NormalizeDSSI:
220    push    dx
221    push    ax
222    NORMALIZE_FAR_POINTER ds, si, ax, dx
223    pop     ax
224    pop     dx
225    ret
226
227
228;--------------------------------------------------------------------
229; FileIO_GetFileSizeToDXAXusingHandleFromBXandResetFilePosition
230;   Parameters:
231;       BX:     File handle
232;   Returns:
233;       DX:AX:  Signed file size (if CF cleared)
234;       AX:     DOS error code (if CF set)
235;       CF:     Clear if successful
236;               Set if error
237;   Corrupts registers:
238;       Nothing
239;--------------------------------------------------------------------
240ALIGN JUMP_ALIGN
241FileIO_GetFileSizeToDXAXusingHandleFromBXandResetFilePosition:
242    push    cx
243
244    ; Get file size to DX:AX
245    xor     cx, cx
246    xor     dx, dx
247    mov     al, SEEK_FROM.endOfFile
248    call    FileIO_SeekFromOriginInALtoOffsetInDXAXusingHandleFromBX
249    jc      SHORT .ReturnFileError
250    push    dx
251    push    ax
252
253    ; Reset file position
254    xor     dx, dx
255    mov     al, SEEK_FROM.startOfFile
256    call    FileIO_SeekFromOriginInALtoOffsetInDXAXusingHandleFromBX
257    pop     ax
258    pop     dx
259
260.ReturnFileError:
261    pop     cx
262    ret
263
264
265;--------------------------------------------------------------------
266; FileIO_CloseUsingHandleFromBX
267;   Parameters:
268;       BX:     File handle
269;   Returns:
270;       AX:     DOS error code if CF set
271;       CF:     Clear if file closed successfully
272;               Set if error
273;   Corrupts registers:
274;       AX
275;--------------------------------------------------------------------
276ALIGN JUMP_ALIGN
277FileIO_CloseUsingHandleFromBX:
278    mov     ah, CLOSE_FILE
279    SKIP2B  f   ; cmp ax, <next instruction>
280    ; Fall to FileIO_SeekFromOriginInALtoOffsetInDXAXusingHandleFromBX
281
282
283;--------------------------------------------------------------------
284; FileIO_SeekFromOriginInALtoOffsetInDXAXusingHandleFromBX
285;   Parameters:
286;       AL:     SEEK_FROM.(origin)
287;       BX:     File handle
288;       CX:DX:  Signed offset to seek starting from AL
289;   Returns:
290;       DX:AX:  New file position in bytes from start of file (if CF cleared)
291;       AX:     DOS error code (if CF set)
292;       CF:     Clear if successful
293;               Set if error
294;   Corrupts registers:
295;       Nothing
296;--------------------------------------------------------------------
297FileIO_SeekFromOriginInALtoOffsetInDXAXusingHandleFromBX:
298    mov     ah, SET_CURRENT_FILE_POSITION
299    int     DOS_INTERRUPT_21h
300    ret
Note: See TracBrowser for help on using the repository browser.