X-Git-Url: https://pd.if.org/git/?a=blobdiff_plain;f=platform%2Fexample%2Finternals%2F_PDCLIB_config.h;h=0df16791cd26f98afbd8f5c53343585d73a2295a;hb=f93d55176e4db9edfb1840054169003bcca4d1fb;hp=ef8dea4355d793f183ab4cf1b829a0bbc324f49d;hpb=b08f4b52b1cd1f7a9553c0f357a7c90859fa3e73;p=pdclib diff --git a/platform/example/internals/_PDCLIB_config.h b/platform/example/internals/_PDCLIB_config.h index ef8dea4..0df1679 100644 --- 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 . 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 +