6502/cc65
1
0
Fork 0
mirror of https://github.com/cc65/cc65.git synced 2025-01-25 11:30:06 +00:00
Code Issues Projects Releases Wiki Activity

Added a note about errors in disk drives on some platforms that lead to

Browse Source 
failures if files are opened/closed while reading the directory.


git-svn-id: svn://svn.cc65.org/cc65/trunk@5828 b7a2c559-68d2-44c3-8de9-860c34a00d81
This commit is contained in:
uz 2012-09-20 20:25:22 +00:00
parent e6b52ee8d0
commit 60a47704d4
1 changed files with 14 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
doc/funcref.sgml
View File

@ -1,4 +1,4 @@
<!doctype linuxdoc system> <!doctype linuxdoc system> <!-- -*- text-mode -*- -->
<article> <article>
<title>cc65 function reference <title>cc65 function reference
@ -1598,7 +1598,7 @@ Exception is the routine for the keyboard device (which is the default input dev
<ref id="cbm_k_open" name="cbm_k_open">, <ref id="cbm_k_open" name="cbm_k_open">,
<ref id="cbm_k_chkin" name="cbm_k_chkin"> <ref id="cbm_k_chkin" name="cbm_k_chkin">
<tag/Example/None. <tag/Example/None.
</descrip> </descrip>
</quote> </quote>
@ -1880,7 +1880,7 @@ routines must be called.
only be used in presence of a prototype. only be used in presence of a prototype.
</itemize> </itemize>
<tag/Availability/cc65 <tag/Availability/cc65
<tag/See also/ <tag/See also/
<ref id="cbm_k_save" name="cbm_k_save">, <ref id="cbm_k_save" name="cbm_k_save">,
<ref id="cbm_k_setlfs" name="cbm_k_setlfs">, <ref id="cbm_k_setlfs" name="cbm_k_setlfs">,
<ref id="cbm_k_setnam" name="cbm_k_setnam"> <ref id="cbm_k_setnam" name="cbm_k_setnam">
@ -4824,6 +4824,17 @@ be used in presence of a prototype.
<item>The returned pointer may point to a statically allocated instance of <item>The returned pointer may point to a statically allocated instance of
<tt/struct dirent/, so it may get overwritten by subsequent calls to <tt/struct dirent/, so it may get overwritten by subsequent calls to
<tt/readdir/. <tt/readdir/.
<item>On several platforms, namely the CBMs and the Atari, the disk drives get
confused when opening/closing files between directory reads. So for example a
program that reads the list of files on a disk, and after each call to
<tt/readdir/, opens the file to process it, will fail.<newline>
Possible solutions are reading the directory into memory before processing the
file list, or to reset the directory by seeking to the correct position after
opening/closing a file:
<verb>
seekdir (DIR, telldir (DIR));
</verb>
Platforms known to work without problems are: Apple.
</itemize> </itemize>
<tag/Availability/POSIX 1003.1 <tag/Availability/POSIX 1003.1
<tag/See also/ <tag/See also/