X-Git-Url: https://pd.if.org/git/?a=blobdiff_plain;f=platform%2Fexample_64%2Finternals%2F_PDCLIB_config.h;h=ba3de27e9483dbfe8eb5e7f4e71323f8d703b453;hb=01c88bc38e78e9b2c47917b85b9b497187946e3c;hp=c8aa535e59e8640b396c625839b5ce722c60688a;hpb=393020b6e48719d27699dea6b29e53025bbd5123;p=pdclib diff --git a/platform/example_64/internals/_PDCLIB_config.h b/platform/example_64/internals/_PDCLIB_config.h index c8aa535..ba3de27 100644 --- a/platform/example_64/internals/_PDCLIB_config.h +++ b/platform/example_64/internals/_PDCLIB_config.h @@ -14,14 +14,6 @@ /* The character (sequence) your platform uses as newline. */ #define _PDCLIB_endl "\n" -/* The number of attempts to complete an I/O operation before giving up. */ -/* (Example: How often a buffer flushing is attempted before reporting fail.) */ -#define _PDCLIB_IO_RETRIES 1 - -/* What the system should do after an I/O operation did not succeed, before */ -/* trying again. (Empty by default.) */ -#define _PDCLIB_IO_RETRY_OP( stream ) - /* exit() can signal success to the host environment by the value of zero or */ /* the constant EXIT_SUCCESS. Failure is signaled by EXIT_FAILURE. Note that */ /* any other return value is "implementation-defined", i.e. your environment */ @@ -100,6 +92,8 @@ struct _PDCLIB_lldiv_t /* SHRT, INT, LONG, or LLONG (telling which values to use for the *_MIN and */ /* *_MAX limits); the lowercase define either short, int, long, or long long */ /* (telling the actual type to use). */ +/* The third define is the length modifier used for the type in printf() and */ +/* scanf() functions (used in ). */ /* If you require a non-standard datatype to define the "usually fastest" */ /* types, PDCLib as-is doesn't support that. Please contact the author with */ /* details on your platform in that case, so support can be added. */ @@ -107,15 +101,19 @@ struct _PDCLIB_lldiv_t #define _PDCLIB_FAST8 INT #define _PDCLIB_fast8 int +#define _PDCLIB_FAST8_CONV #define _PDCLIB_FAST16 INT #define _PDCLIB_fast16 int +#define _PDCLIB_FAST16_CONV #define _PDCLIB_FAST32 INT #define _PDCLIB_fast32 int +#define _PDCLIB_FAST32_CONV #define _PDCLIB_FAST64 LONG #define _PDCLIB_fast64 long +#define _PDCLIB_FAST64_CONV l /* -------------------------------------------------------------------------- */ /* What follows are a couple of "special" typedefs and their limits. Again, */ @@ -126,6 +124,7 @@ struct _PDCLIB_lldiv_t /* The result type of substracting two pointers */ #define _PDCLIB_ptrdiff long #define _PDCLIB_PTRDIFF LONG +#define _PDCLIB_PTR_CONV l /* An integer type that can be accessed as atomic entity (think asynchronous interrupts). The type itself is not defined in a freestanding environment, @@ -149,10 +148,20 @@ struct _PDCLIB_lldiv_t /* Largest supported integer type. Implementation note: see _PDCLIB_atomax(). */ #define _PDCLIB_intmax long long int -#define _PDCLIB_INTMAX LLINT +#define _PDCLIB_INTMAX LLONG +#define _PDCLIB_MAX_CONV ll /* You are also required to state the literal suffix for the intmax type */ #define _PDCLIB_INTMAX_LITERAL ll +/* defines imaxdiv(), which is equivalent to the div() function */ +/* family (see further above) with intmax_t as basis. */ + +struct _PDCLIB_imaxdiv_t +{ + _PDCLIB_intmax quot; + _PDCLIB_intmax rem; +}; + /* -------------------------------------------------------------------------- */ /* Floating Point */ /* -------------------------------------------------------------------------- */ @@ -237,6 +246,25 @@ typedef int _PDCLIB_fd_t; */ #define _PDCLIB_NOHANDLE ( (_PDCLIB_fd_t) -1 ) +/* 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(). The example implementation limits the number of open + files only by available memory. +*/ +#define _PDCLIB_FOPEN_MAX 8 + +/* Length of the longest filename the implementation guarantees to support. */ +#define _PDCLIB_FILENAME_MAX 128 + +/* Maximum length of filenames generated by tmpnam(). (See tmpfile.c.) */ +#define _PDCLIB_L_tmpnam 46 + +/* Number of distinct file names that can be generated by tmpnam(). */ +#define _PDCLIB_TMP_MAX 50 + /* The values of SEEK_SET, SEEK_CUR and SEEK_END, used by fseek(). Since at least one platform (POSIX) uses the same symbols for its own "seek" function, we use whatever the host defines (if it does define them). @@ -251,3 +279,38 @@ typedef int _PDCLIB_fd_t; */ #define _PDCLIB_UNGETCBUFSIZE 1 +/* Signals ------------------------------------------------------------------ */ + +/* A word on signals, to the people using PDCLib in their OS projects. + + The way they are defined by the C standard severely limits their usefulness, + to the point where a library implementation need not interface with the OS' + signals at all (which is what the PDCLib example implementation does). + (Other issues include, for example, that signal handlers are not re-entrant.) + + Thus, it is strongly discouraged to try bolting on a signal handling infra- + structure onto . Since C's signal handling is so limited to begin + with, and code using it is pretty much non-portable anyway, it would be + smarter to keep in the barely functional state it is in, and + instead create a better, OS-specific API. + + That being said, the below signals require to be defined to a positive int + value. I took what my Linux box defined them to; if you have to change them, + and what value to change them *to*, depends heavily on your environment and + what you are expecting to accomplish (see above). +*/ +#define _PDCLIB_SIGABRT 6 +#define _PDCLIB_SIGFPE 8 +#define _PDCLIB_SIGILL 4 +#define _PDCLIB_SIGINT 2 +#define _PDCLIB_SIGSEGV 11 +#define _PDCLIB_SIGTERM 15 + +/* The following should be defined to pointer values that could NEVER point to + a valid function. (They are used as special arguments to signal().) Again, I + took the values of my Linux box, which should be as good as any other value. +*/ +#define _PDCLIB_SIG_DFL (void (*)( int ))0 +#define _PDCLIB_SIG_ERR (void (*)( int ))-1 +#define _PDCLIB_SIG_IGN (void (*)( int ))1 +