Intermediate work, checked in for safekeeping as I pick up working on this again.

[pdclib] / platform / example / internals / _PDCLIB_config.h

diff --git a/platform/example/internals/_PDCLIB_config.h b/platform/example/internals/_PDCLIB_config.h
index ef8dea4355d793f183ab4cf1b829a0bbc324f49d..0df16791cd26f98afbd8f5c53343585d73a2295a 100644 (file)
--- a/platform/example/internals/_PDCLIB_config.h
+++ b/platform/example/internals/_PDCLIB_config.h
@@ -11,6 +11,14 @@
 /* Misc                                                                       */
 /* -------------------------------------------------------------------------- */
 
+/* By default, PDCLib does some rather strict checking of function usage,     */
+/* especially in <stdio.h>. Things that are undefined by the standard - for   */
+/* example, mixing byte / wide operations or read / write operations without  */
+/* resetting the stream beforehand - are caught and handled graciously. This  */
+/* adds some complexity, and eats a couple of clock cycles. If you want to    */
+/* disable these checks, define _PDCLIB_STRICT to zero.                       */
+#define _PDCLIB_STRICT 1
+
 /* The character (sequence) your platform uses as newline.                    */
 #define _PDCLIB_endl "\n"
 
@@ -123,6 +131,7 @@ struct _PDCLIB_lldiv_t
    interrupts). The type itself is not defined in a freestanding environment,
    but its limits are. (Don't ask.)
 */
+#define _PDCLIB_sig_atomic int
 #define _PDCLIB_SIG_ATOMIC INT
 
 /* Result type of the 'sizeof' operator (must be unsigned) */
@@ -211,37 +220,64 @@ typedef char * _PDCLIB_va_list;
 /* The actual *functions* of the OS interface are declared in _PDCLIB_glue.h. */
 /* -------------------------------------------------------------------------- */
 
-/* Memory management */
+/* Memory management -------------------------------------------------------- */
 
 /* Set this to the page size of your OS. If your OS does not support paging, set
    to an appropriate value. (Too small, and malloc() will call the kernel too
-   often. Too large, and you will waste memory.
+   often. Too large, and you will waste memory.)
 */
 #define _PDCLIB_PAGESIZE 4096
 
-/* Set this to the minimum memory node size. Any malloc() for a smaller siz
-   will be satisfied by a malloc() of this size instead.
+/* Set this to the minimum memory node size. Any malloc() for a smaller size
+   will be satisfied by a malloc() of this size instead (to avoid excessive
+   fragmentation).
 */
 #define _PDCLIB_MINALLOC 8
 
-/* I/O */
+/* I/O ---------------------------------------------------------------------- */
 
-/* The unique file descriptor returned by _PDCLIB_open(). */
+/* The type of the file descriptor returned by _PDCLIB_open(). */
 typedef int _PDCLIB_fd_t;
 
+/* The value (of type _PDCLIB_fd_t) returned by _PDCLIB_open() if the operation
+   failed.
+*/
+#define _PDCLIB_NOHANDLE ( (_PDCLIB_fd_t) -1 )
+
 /* A type in which to store file offsets. See fgetpos() / fsetpos(). */
+/* FIXME: The 'int' types here are placeholders. When changed, check out
+   stdinit.c, too. */
 typedef struct
 {
     int position;
-    int parse_state;
+    int mbstate;
 } _PDCLIB_fpos_t;
 
-/* The mode flags used in calls to _PDCLIB_open(). */
-enum _PDCLIB_iomode_e
-{
-    _PDCLIB_io_read     = 1,
-    _PDCLIB_io_write    = 2,
-    _PDCLIB_io_append   = 4,
-    _PDCLIB_io_create   = 8,
-    _PDCLIB_io_truncate = 16,
-};
+/* The default size for file buffers. Must be at least 256. */
+#define _PDCLIB_BUFSIZ 1024
+
+/* The minimum number of files the implementation can open simultaneously. Must
+   be at least 8. Depends largely on how the bookkeeping is done by fopen() /
+   freopen() / fclose().
+*/
+#define _PDCLIB_FOPEN_MAX 8
+
+/* Length of the longest filename the implementation guarantees to support. */
+#define _PDCLIB_FILENAME_MAX 128
+
+/* Buffer size for tmpnam(). */
+#define _PDCLIB_L_tmpnam 100
+
+/* Number of distinct file names that can be generated by tmpnam(). */
+#define _PDCLIB_TMP_MAX 50
+
+/* The number of times fflush() tries to write a file buffer before giving up
+   if no characters can be written.
+*/
+#define _PDCLIB_FLUSH_RETRIES 3
+/* This macro is executed after each try to write characters that results in
+   no characters being written. You can define this to be empty, wait a short
+   period of time, or whatever suits your environment.
+*/
+#define _PDCLIB_FLUSH_RETRY_PREP
+