X-Git-Url: https://pd.if.org/git/?a=blobdiff_plain;f=platform%2Fexample%2Finternals%2F_PDCLIB_config.h;h=0df16791cd26f98afbd8f5c53343585d73a2295a;hb=9507e63e4b8558c8a3337521853f80f72f83a689;hp=150161f18373a92e262765a1774bd8d68c1aa96e;hpb=12e17136786afb1775c9dc946cbe41f5e230c24a;p=pdclib.old diff --git a/platform/example/internals/_PDCLIB_config.h b/platform/example/internals/_PDCLIB_config.h index 150161f..0df1679 100644 --- a/platform/example/internals/_PDCLIB_config.h +++ b/platform/example/internals/_PDCLIB_config.h @@ -1,7 +1,5 @@ /* $Id$ */ -/* Release $Name$ */ - /* Internal PDCLib configuration <_PDCLIB_config.h> (Generic Template) @@ -13,6 +11,14 @@ /* Misc */ /* -------------------------------------------------------------------------- */ +/* By default, PDCLib does some rather strict checking of function usage, */ +/* especially in . 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" @@ -125,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) */ @@ -213,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 +