X-Git-Url: https://pd.if.org/git/?p=pdclib;a=blobdiff_plain;f=platform%2Fexample%2Finternals%2F_PDCLIB_config.h;h=c717286a97f714137d171eb952c38766fedbc55d;hp=92d5662b541cc4ab1e986107a8fae6d041366fab;hb=ea66319bf240c51e4f33caf868e1774e32ef19d6;hpb=327639a3101db8d83fa81338b5f1455a07f15a60 diff --git a/platform/example/internals/_PDCLIB_config.h b/platform/example/internals/_PDCLIB_config.h index 92d5662..c717286 100644 --- a/platform/example/internals/_PDCLIB_config.h +++ b/platform/example/internals/_PDCLIB_config.h @@ -1,4 +1,5 @@ -/* $Id$ */ +#ifndef _PDCLIB_CONFIG_H +#define _PDCLIB_CONFIG_H /* Internal PDCLib configuration <_PDCLIB_config.h> (Generic Template) @@ -26,12 +27,6 @@ /* specific platforms, e.g. by swapping int instead of char. */ #define _PDCLIB_memswp( i, j, size ) char tmp; do { tmp = *i; *i++ = *j; *j++ = tmp; } while ( --size ); -/* Define this to some compiler directive that can be written after the */ -/* parameter list of a function declaration to indicate the function does */ -/* never return. If your compiler does not support such a directive, define */ -/* to nothing. (This is to avoid warnings with the exit functions under GCC.) */ -#define _PDCLIB_NORETURN __attribute__(( noreturn )) - /* -------------------------------------------------------------------------- */ /* Integers */ /* -------------------------------------------------------------------------- */ @@ -44,7 +39,7 @@ /* first, before going to lengths about it. */ /* -------------------------------------------------------------------------- */ -/* Comment out (or delete) the line below if your 'char' type is unsigned. */ +/* Set to 0 if your 'char' type is unsigned. */ #define _PDCLIB_CHAR_SIGNED 1 /* Width of the integer types short, int, long, and long long, in bytes. */ @@ -52,7 +47,11 @@ /* compiler manuals. */ #define _PDCLIB_SHRT_BYTES 2 #define _PDCLIB_INT_BYTES 4 -#define _PDCLIB_LONG_BYTES 4 +#if defined(__LP64__) || defined(_LP64) +# define _PDCLIB_LONG_BYTES 8 +#else +# define _PDCLIB_LONG_BYTES 4 +#endif #define _PDCLIB_LLONG_BYTES 8 /* defines the div() function family that allows taking quotient */ @@ -122,8 +121,8 @@ struct _PDCLIB_lldiv_t /* -------------------------------------------------------------------------- */ /* The result type of substracting two pointers */ -#define _PDCLIB_ptrdiff int -#define _PDCLIB_PTRDIFF INT +#define _PDCLIB_ptrdiff long +#define _PDCLIB_PTRDIFF LONG #define _PDCLIB_PTR_CONV /* An integer type that can be accessed as atomic entity (think asynchronous @@ -134,17 +133,18 @@ struct _PDCLIB_lldiv_t #define _PDCLIB_SIG_ATOMIC INT /* Result type of the 'sizeof' operator (must be unsigned) */ -#define _PDCLIB_size unsigned int -#define _PDCLIB_SIZE UINT +#define _PDCLIB_size unsigned long +#define _PDCLIB_SIZE ULONG /* Large enough an integer to hold all character codes of the largest supported locale. */ -#define _PDCLIB_wchar unsigned short -#define _PDCLIB_WCHAR USHRT +#define _PDCLIB_wint signed int +#define _PDCLIB_wchar unsigned int +#define _PDCLIB_WCHAR UINT -#define _PDCLIB_intptr int -#define _PDCLIB_INTPTR INT +#define _PDCLIB_intptr long +#define _PDCLIB_INTPTR LONG /* Largest supported integer type. Implementation note: see _PDCLIB_atomax(). */ #define _PDCLIB_intmax long long int @@ -162,6 +162,49 @@ struct _PDCLIB_imaxdiv_t _PDCLIB_intmax rem; }; +/* : time_t + * The C standard doesn't define what representation of time is stored in + * time_t when returned by time() , but POSIX defines it to be seconds since the + * UNIX epoch and most appplications expect that. + * + * time_t is also used as the tv_sec member of struct timespec, which *is* + * defined as a linear count of seconds. + * + * time_t is defined as a "real type", so may be a floating point type, but with + * the presence of the nanosecond accurate struct timespec, and with the lack of + * any functions for manipulating more accurate values of time_t, this is + * probably not useful. + */ +#define _PDCLIB_time unsigned long long + +/* : clock_t + * + * A count of "clock ticks", where the length of a clock tick is unspecified by + * the standard. The implementation is required to provide a macro, + * CLOCKS_PER_SEC, which is the number of "clock ticks" which corresponds to one + * second. + * + * clock_t may be any real type (i.e. integral or floating), and its type on + * various systems differs. + * + * On XSI systems, CLOCKS_PER_SEC must be defined to 1000000 + */ +#define _PDCLIB_clock double +#define _PDCLIB_CLOCKS_PER_SEC 1000000 + +/* : TIME_UTC + * + * The TIME_UTC parameter is passed to the timespec_get function in order to get + * the system time in UTC since an implementation defined epoch (not necessarily + * the same as that used for time_t). That said, on POSIX the obvious + * implementation of timespec_get for TIME_UTC is to wrap + * clock_gettime(CLOCK_REALTIME, ...), which is defined as time in UTC since the + * same epoch. + * + * This may be any non-zero integer value. + */ +#define _PDCLIB_TIME_UTC 1 + /* -------------------------------------------------------------------------- */ /* Floating Point */ /* -------------------------------------------------------------------------- */ @@ -189,6 +232,22 @@ struct _PDCLIB_imaxdiv_t */ #define _PDCLIB_DECIMAL_DIG 17 +/* Floating point types + * + * PDCLib (at present) assumes IEEE 754 floating point formats + * The following names are used: + * SINGLE: IEEE 754 single precision (32-bit) + * DOUBLE: IEEE 754 double precision (64-bit) + * EXTENDED: IEEE 754 extended precision (80-bit, as x87) + */ +#define _PDCLIB_FLOAT_TYPE SINGLE +#define _PDCLIB_DOUBLE_TYPE DOUBLE +#if defined(__i386__) || defined(__amd64__) + #define _PDCLIB_LDOUBLE_TYPE EXTENDED +#else + #define _PDCLIB_LDOUBLE_TYPE DOUBLE +#endif + /* -------------------------------------------------------------------------- */ /* Platform-dependent macros defined by the standard headers. */ /* -------------------------------------------------------------------------- */ @@ -235,23 +294,24 @@ typedef char * _PDCLIB_va_list; to an appropriate value. (Too small, and malloc() will call the kernel too often. Too large, and you will waste memory.) */ -#define _PDCLIB_PAGESIZE 4096 +#define _PDCLIB_MALLOC_PAGESIZE 4096 +#define _PDCLIB_MALLOC_ALIGN 16 +#define _PDCLIB_MALLOC_GRANULARITY 64*1024 +#define _PDCLIB_MALLOC_TRIM_THRESHOLD 2*1024*1024 +#define _PDCLIB_MALLOC_MMAP_THRESHOLD 256*1024 +#define _PDCLIB_MALLOC_RELEASE_CHECK_RATE 4095 -/* 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 +/* TODO: Better document these */ -/* I/O ---------------------------------------------------------------------- */ +/* Locale --------------------------------------------------------------------*/ -/* The type of the file descriptor returned by _PDCLIB_open(). */ -typedef int _PDCLIB_fd_t; +/* Locale method. See _PDCLIB_locale.h */ +/* #define _PDCLIB_LOCALE_METHOD _PDCLIB_LOCALE_METHOD_TSS */ -/* The value (of type _PDCLIB_fd_t) returned by _PDCLIB_open() if the operation - failed. -*/ -#define _PDCLIB_NOHANDLE ( (_PDCLIB_fd_t) -1 ) +/* wchar_t encoding */ +#define _PDCLIB_WCHAR_ENCODING _PDCLIB_WCHAR_ENCODING_UCS4 + +/* I/O ---------------------------------------------------------------------- */ /* The default size for file buffers. Must be at least 256. */ #define _PDCLIB_BUFSIZ 1024 @@ -286,3 +346,121 @@ typedef int _PDCLIB_fd_t; */ #define _PDCLIB_UNGETCBUFSIZE 1 +/* errno -------------------------------------------------------------------- */ + +/* These are the values that _PDCLIB_errno can be set to by the library. + + By keeping PDCLib's errno in the _PDCLIB_* namespace, the library is capable + to "translate" between errno values used by the hosting operating system and + those used and passed out by the library. + + Example: In the example platform, the remove() function uses the unlink() + system call as backend. Linux sets its errno to EISDIR if you try to unlink() + a directory, but POSIX demands EPERM. Within the remove() function, you can + catch the 'errno == EISDIR', and set '_PDCLIB_errno = _PDCLIB_EPERM'. Anyone + using PDCLib's will "see" EPERM instead of EISDIR (the _PDCLIB_* + prefix removed by mechanics). + + If you do not want that kind of translation, you might want to "match" the + values used by PDCLib with those used by the host OS, to avoid confusion. + + The C standard only defines three distinct errno values: ERANGE, EDOM, and + EILSEQ. The standard leaves it up to "the implementation" whether there are + any more beyond those three. + + However, C++11 introduced the whole list of POSIX errno values into the + standard, so PDCLib might as well define those as well. + + Sometimes the standard says to set errno to indicate an error, but does not + prescribe a value. We will use a value from the following list. If POSIX + defines a value, we use that; otherwise, we use as seems suitable. +*/ + +/* These values were taken from Linux, gcc 4.8. */ +#define _PDCLIB_E2BIG 7 +#define _PDCLIB_EACCES 13 +#define _PDCLIB_EADDRINUSE 98 +#define _PDCLIB_EADDRNOTAVAIL 99 +#define _PDCLIB_EAFNOSUPPORT 97 +#define _PDCLIB_EAGAIN 11 +#define _PDCLIB_EALREADY 114 +#define _PDCLIB_EBADF 9 +#define _PDCLIB_EBADMSG 74 +#define _PDCLIB_EBUSY 16 +#define _PDCLIB_ECANCELED 125 +#define _PDCLIB_ECHILD 10 +#define _PDCLIB_ECONNABORTED 103 +#define _PDCLIB_ECONNREFUSED 111 +#define _PDCLIB_ECONNRESET 104 +#define _PDCLIB_EDEADLK 35 +#define _PDCLIB_EDESTADDRREQ 89 +#define _PDCLIB_EDOM 33 +#define _PDCLIB_EEXIST 17 +#define _PDCLIB_EFAULT 14 +#define _PDCLIB_EFBIG 27 +#define _PDCLIB_EHOSTUNREACH 113 +#define _PDCLIB_EIDRM 43 +#define _PDCLIB_EILSEQ 84 +#define _PDCLIB_EINPROGRESS 115 +#define _PDCLIB_EINTR 4 +#define _PDCLIB_EINVAL 22 +#define _PDCLIB_EIO 5 +#define _PDCLIB_EISCONN 106 +#define _PDCLIB_EISDIR 21 +#define _PDCLIB_ELOOP 40 +#define _PDCLIB_EMFILE 24 +#define _PDCLIB_EMLINK 31 +#define _PDCLIB_EMSGSIZE 90 +#define _PDCLIB_ENAMETOOLONG 36 +#define _PDCLIB_ENETDOWN 100 +#define _PDCLIB_ENETRESET 102 +#define _PDCLIB_ENETUNREACH 101 +#define _PDCLIB_ENFILE 23 +#define _PDCLIB_ENOBUFS 105 +#define _PDCLIB_ENODATA 61 +#define _PDCLIB_ENODEV 19 +#define _PDCLIB_ENOENT 2 +#define _PDCLIB_ENOEXEC 8 +#define _PDCLIB_ENOLCK 37 +#define _PDCLIB_ENOLINK 67 +#define _PDCLIB_ENOMEM 12 +#define _PDCLIB_ENOMSG 42 +#define _PDCLIB_ENOPROTOOPT 92 +#define _PDCLIB_ENOSPC 28 +#define _PDCLIB_ENOSR 63 +#define _PDCLIB_ENOSTR 60 +#define _PDCLIB_ENOSYS 38 +#define _PDCLIB_ENOTCONN 107 +#define _PDCLIB_ENOTDIR 20 +#define _PDCLIB_ENOTEMPTY 39 +#define _PDCLIB_ENOTRECOVERABLE 131 +#define _PDCLIB_ENOTSOCK 88 +#define _PDCLIB_ENOTSUP 95 +#define _PDCLIB_ENOTTY 25 +#define _PDCLIB_ENXIO 6 +#define _PDCLIB_EOPNOTSUPP 95 +#define _PDCLIB_EOVERFLOW 75 +#define _PDCLIB_EOWNERDEAD 130 +#define _PDCLIB_EPERM 1 +#define _PDCLIB_EPIPE 32 +#define _PDCLIB_EPROTO 71 +#define _PDCLIB_EPROTONOSUPPORT 93 +#define _PDCLIB_EPROTOTYPE 91 +#define _PDCLIB_ERANGE 34 +#define _PDCLIB_EROFS 30 +#define _PDCLIB_ESPIPE 29 +#define _PDCLIB_ESRCH 3 +#define _PDCLIB_ETIME 62 +#define _PDCLIB_ETIMEDOUT 110 +#define _PDCLIB_ETXTBSY 26 +#define _PDCLIB_EWOULDBLOCK 11 +#define _PDCLIB_EXDEV 18 + +/* This is used to set the size of the array in struct lconv () */ +/* holding the error messages for the strerror() and perror() fuctions. If */ +/* you change this value because you are using additional errno values, you */ +/* *HAVE* to provide appropriate error messages for *ALL* locales. */ +/* Needs to be one higher than the highest errno value above. */ +#define _PDCLIB_ERRNO_MAX 132 + +#endif