}
case 'p':
status->base = 16;
- status->flags |= E_unsigned;
+ /* TODO: Assuming 'long' for pointers, this should be handled differently. */
+ status->flags |= E_unsigned | E_long;
break;
case 'n':
{
+++ /dev/null
-# This is where you chose which platform to compile for (see 'make links' / './platform')
-PLATFORM := example_cygwin
-
-# This is a list of all non-source files that are part of the distribution.
-AUXFILES := Makefile Readme.txt
-
-# Directories belonging to the project
-PROJDIRS := functions includes internals
-# All source files of the project
-SRCFILES := $(shell find $(PROJDIRS) -mindepth 1 -maxdepth 3 -name "*.c")
-# All header files of the project
-HDRFILES := $(shell find $(PROJDIRS) -mindepth 1 -maxdepth 3 -name "*.h")
-# All .c files in functions/_PDCLIB that do not have a regression test driver
-INTFILES := _Exit atomax digits open print scan remove rename seed stdinit strtox_main strtox_prelim cleanstream fflush filemode eol errno seek prepread prepwrite allocpages
-# All object files in the library
-OBJFILES := $(patsubst %.c,%.o,$(SRCFILES))
-# All test drivers (.t)
-TSTFILES := $(patsubst %.c,%.t,$(SRCFILES))
-# All regression test drivers (.r)
-REGFILES := $(filter-out $(patsubst %,functions/_PDCLIB/%.r,$(INTFILES)),$(patsubst %.c,%.r,$(SRCFILES)))
-# All dependency files (.d)
-DEPFILES := $(patsubst %.c,%.d,$(SRCFILES))
-# All files belonging to the source distribution
-ALLFILES := $(SRCFILES) $(HDRFILES) $(AUXFILES)
-
-# All files in platform/$(PLATFORM)/functions/_PDCLIB (for development only)
-PATCHFILES1 := $(shell ls platform/$(PLATFORM)/functions/_PDCLIB/*.c)
-# All files in platform/$(PLATFORM)/functions/stdlib (for development only)
-PATCHFILES2 := $(shell ls platform/$(PLATFORM)/functions/stdlib/*.c)
-# All files in platform/$(PLATFORM)/functions/stdio (for development only)
-PATCHFILES3 := $(shell ls platform/$(PLATFORM)/functions/stdio/*.c)
-
-WARNINGS := -Wall -Wextra -pedantic -Wno-unused-parameter -Wshadow -Wpointer-arith -Wcast-align -Wwrite-strings -Wmissing-prototypes -Wmissing-declarations -Wredundant-decls -Wnested-externs -Winline -Wno-long-long -fno-builtin
-CFLAGS := -g -std=gnu99 -I./internals $(WARNINGS) $(USERFLAGS)
-
-.PHONY: all clean srcdist bindist test tests testdrivers regtests regtestdrivers todos fixmes find links unlink help
-
-all: pdclib.a testdrivers regtestdrivers
- @echo
- @echo "========================"
- @echo "Executing library tests:"
- @echo "========================"
- @echo
- @$(MAKE) tests | grep -v "^ TST" | grep -v "^Failed"
- @echo
- @echo "==========================="
- @echo "Executing regression tests:"
- @echo "==========================="
- @echo
- @$(MAKE) regtests | grep -v "^ RTST" | grep -v "^Failed"
-
-pdclib.a: $(OBJFILES)
- @echo " AR $@"
- @ar rc pdclib.a $?
- @echo
-
-test: functions/$(FILE)
- functions/$(FILE)
-
-tests: testdrivers
- -@rc=0; count=0; failed=""; for file in $(TSTFILES); do echo " TST $$file"; ./$$file; test=$$?; if [ $$test != 0 ]; then rc=`expr $$rc + $$test`; failed="$$failed $$file"; fi; count=`expr $$count + 1`; done; echo; echo "Tests executed (linking PDCLib): $$count Tests failed: $$rc"; echo; for file in $$failed; do echo "Failed: $$file"; done; echo
-
-testdrivers: $(TSTFILES)
- @echo
-
-regtests: regtestdrivers
- -@rc=0; count=0; failed=""; for file in $(REGFILES); do echo " RTST $$file"; ./$$file; test=$$?; if [ $$test != 0 ]; then rc=`expr $$rc + $$test`; failed="$$failed $$file"; fi; count=`expr $$count + 1`; done; echo; echo "Tests executed (linking system libc): $$count Tests failed: $$rc"; echo; for file in $$failed; do echo "Failed: $$file"; done; echo
-
-regtestdrivers: $(REGFILES)
- @echo
-
--include $(DEPFILES)
-
-clean:
- @for file in $(OBJFILES) $(DEPFILES) $(TSTFILES) $(REGFILES) pdclib.a pdclib.tgz; do if [ -f $$file ]; then rm $$file; fi; done
-
-srcdist:
- @tar czf pdclib.tgz $(ALLFILES)
-
-todos:
- -@for file in $(ALLFILES); do grep -H TODO $$file; done; true
-
-fixmes:
- -@for file in $(ALLFILES); do grep -H FIXME $$file; done; true
-
-find:
- @find functions/ includes/ internals/ platform/ -name "*\.[ch]" -type f | xargs grep $$FIND
-
-links:
- @echo "Linking platform/$(PLATFORM)..."
- @cd internals && ln -s ../platform/$(PLATFORM)/internals/_PDCLIB_config.h
- @cd includes && ln -s ../platform/$(PLATFORM)/includes/float.h
- @cd functions/_PDCLIB && for file in $(PATCHFILES1); do basfile=`basename $$file`; if [ ! -f $$basfile ]; then ln -s `ls ../../$$file` .; fi; done
- @cd functions/stdlib && for file in $(PATCHFILES2); do basfile=`basename $$file`; if [ ! -f $$basfile ]; then ln -s `ls ../../$$file` .; fi; done
- @cd functions/stdio && for file in $(PATCHFILES3); do basfile=`basename $$file`; if [ ! -f $$basfile ]; then ln -s `ls ../../$$file` .; fi; done
-
-unlink:
- @echo "Unlinking platform files..."
- @if [ -f internals/_PDCLIB_config.h ]; then rm internals/_PDCLIB_config.h; fi
- @if [ -f includes/float.h ]; then rm includes/float.h; fi
- @cd functions/_PDCLIB && for file in $(PATCHFILES1); do basfile=`basename $$file`; if [ -f $$basfile ]; then rm $$basfile; fi; done
- @cd functions/stdlib && for file in $(PATCHFILES2); do basfile=`basename $$file`; if [ -f $$basfile ]; then rm $$basfile; fi; done
- @cd functions/stdio && for file in $(PATCHFILES3); do basfile=`basename $$file`; if [ -f $$basfile ]; then rm $$basfile; fi; done
-
-help:
- @echo "Available make targets:"
- @echo
- @echo "all - build pdclib.a"
- @echo "clean - remove all object files, dependency files and test drivers"
- @echo "srcdist - build pdclib.tgz (source tarball)"
- @echo "test - test a single testdriver (Usage: FILE=\"test.[rt]\" make test)"
- @echo "tests - build and run test drivers (link pdclib.a)"
- @echo " testdrivers - build but do not run test drivers"
- @echo "regtests - build and run regression test drivers (link system clib)"
- @echo " regtestdrivers - build but do not run regression test drivers"
- @echo "todos - list all TODO comments in the sources"
- @echo "fixmes - list all FIXME comments in the sources"
- @echo "find - find a phrase in the sources (Usage: FIND=\"phrase\" make find)"
- @echo "links - link platform files (development only)"
- @echo "unlink - remove links to platform files (development only)"
- @echo "%.o - build an individual object file"
- @echo "%.t - build an individual test driver"
- @echo "%.r - build an individual regression test driver"
- @echo "help - print this list"
- @echo
- @echo "Any additional compiler flags you want to use can be passed as USERFLAGS"
- @echo "(Usage: USERFLAGS=\"flags\" make [...])."
-
-%.o: %.c Makefile
- @echo " CC $(patsubst functions/%,%,$@)"
- @$(CC) $(CFLAGS) -MMD -MP -MT "$*.d $*.t" -I./includes -c $< -o $@
-
-%.t: %.c Makefile pdclib.a
- @echo " CC $(patsubst functions/%,%,$@)"
- @$(CC) $(CFLAGS) -DTEST -I./includes $< pdclib.a -o $@
-
-%.r: %.c Makefile
- @echo " CC $(patsubst functions/%,%,$@)"
- @$(CC) $(CFLAGS) -Wno-format -DTEST -DREGTEST $< -o $@
-
+++ /dev/null
-"Example" Platform Overlay
-==========================
-
-This is an example platform overlay, as described in the main Readme.txt of
-this archive. For ease of development, it applies (and tests) correctly on the
-machine of the author; no other guarantees can be given.
-It should give you a good idea of what is REQUIRED to make a copy of PDCLib
-work. There is a lot more you could do, and even some things you SHOULD do, in
-order to experience anything but abysmal performance:
-
-- Read / write operations on binary streams, and even on text streams for
- machines that do not do any text conversion, can be made much more efficient
- by using some sort of page buffer instead of the linear buffer implemented
- here. It requires some special and platform-dependent manipulations, though,
- which is why it is not done by default.
-
-- Anything relating to floating point logic is written in generic C. While
- this is (hopefully) highly portable and should get you started on your
- platform of choice, it is also highly inefficient and should be replaced by
- inline assembly. Just make sure that your assembly keeps all the promises
- the C library makes.
-
+++ /dev/null
-/* _PDCLIB_exit( int )
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-/* This is an example implementation of _PDCLIB_exit() fit for use with POSIX
- kernels.
-*/
-
-#include <stdlib.h>
-
-#ifndef REGTEST
-#include <_PDCLIB_glue.h>
-
-extern void _exit( int status ) _PDCLIB_NORETURN;
-
-void _PDCLIB_Exit( int status )
-{
- _exit( status );
-}
-
-#endif
-
-#ifdef TEST
-#include <_PDCLIB_test.h>
-
-int main( void )
-{
- int UNEXPECTED_RETURN = 0;
- _PDCLIB_Exit( 0 );
- TESTCASE( UNEXPECTED_RETURN );
- return TEST_RESULTS;
-}
-
-#endif
+++ /dev/null
-/* _PDCLIB_allocpages( int const )
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-/* This is an example implementation of _PDCLIB_allocpages() (declared in
- _PDCLIB_config.h), fit for use with POSIX kernels.
-*/
-
-#include <stdint.h>
-#include <stddef.h>
-
-void * sbrk( intptr_t );
-
-#include <_PDCLIB_glue.h>
-
-static void * membreak = NULL;
-
-void * _PDCLIB_allocpages( int const n )
-{
- if ( membreak == NULL )
- {
- /* first call, make sure end-of-heap is page-aligned */
- intptr_t unaligned = 0;
- membreak = sbrk( 0 );
- unaligned = _PDCLIB_PAGESIZE - (intptr_t)membreak % _PDCLIB_PAGESIZE;
- if ( unaligned < _PDCLIB_PAGESIZE )
- {
- /* end-of-heap not page-aligned - adjust */
- if ( sbrk( unaligned ) != membreak )
- {
- /* error */
- return NULL;
- }
- membreak = (char *)membreak + unaligned;
- }
- }
- /* increasing or decreasing heap - standard operation */
- void * oldbreak = membreak;
- membreak = (void *)( (char *)membreak + ( n * _PDCLIB_PAGESIZE ) );
- if ( sbrk( (char*)membreak - (char*)oldbreak ) == membreak )
- {
- /* successful */
- return oldbreak;
- }
- else
- {
- /* out of memory */
- membreak = oldbreak;
- return NULL;
- }
-}
-
-#ifdef TEST
-#include <_PDCLIB_test.h>
-
-int main( void )
-{
- char * startbreak = sbrk( 0 );
- TESTCASE( _PDCLIB_allocpages( 0 ) );
- TESTCASE( ( (char *)sbrk( 0 ) - startbreak ) <= _PDCLIB_PAGESIZE );
- startbreak = sbrk( 0 );
- TESTCASE( _PDCLIB_allocpages( 1 ) );
- TESTCASE( sbrk( 0 ) == startbreak + ( 1 * _PDCLIB_PAGESIZE ) );
- TESTCASE( _PDCLIB_allocpages( 5 ) );
- TESTCASE( sbrk( 0 ) == startbreak + ( 6 * _PDCLIB_PAGESIZE ) );
- TESTCASE( _PDCLIB_allocpages( -3 ) );
- TESTCASE( sbrk( 0 ) == startbreak + ( 3 * _PDCLIB_PAGESIZE ) );
-}
-
-#endif
+++ /dev/null
-/* _PDCLIB_close( _PDCLIB_fd_t )
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-/* This is an example implementation of _PDCLIB_close() fit for use with POSIX
- kernels.
-*/
-
-#include <stdio.h>
-
-#ifndef REGTEST
-#include <_PDCLIB_glue.h>
-
-extern int close( int fd );
-
-int _PDCLIB_close( int fd )
-{
- return close( fd );
-}
-
-#endif
-
-#ifdef TEST
-#include <_PDCLIB_test.h>
-
-int main( void )
-{
- /* No testdriver; tested in driver for _PDCLIB_open(). */
- return TEST_RESULTS;
-}
-
-#endif
+++ /dev/null
-/* _PDCLIB_fillbuffer( struct _PDCLIB_file_t * )
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-/* This is an example implementation of _PDCLIB_fillbuffer() fit for
- use with POSIX kernels.
-*/
-
-#include <stdio.h>
-
-#ifndef REGTEST
-#include <_PDCLIB_glue.h>
-
-#include </usr/include/errno.h>
-
-typedef long ssize_t;
-extern ssize_t read( int fd, void * buf, size_t count );
-
-int _PDCLIB_fillbuffer( struct _PDCLIB_file_t * stream )
-{
- /* No need to handle buffers > INT_MAX, as PDCLib doesn't allow them */
- ssize_t rc = read( stream->handle, stream->buffer, stream->bufsize );
- if ( rc > 0 )
- {
- /* Reading successful. */
- if ( ! ( stream->status & _PDCLIB_FBIN ) )
- {
- /* TODO: Text stream conversion here */
- }
- stream->bufend = rc;
- stream->bufidx = 0;
- return 0;
- }
- if ( rc < 0 )
- {
- /* Reading error */
- switch ( errno )
- {
- /* See comments on implementation-defined errno values in
- <_PDCLIB_config.h>.
- */
- case EBADF:
- case EFAULT:
- case EINTR:
- case EINVAL:
- case EIO:
- _PDCLIB_errno = _PDCLIB_ERROR;
- break;
- default:
- /* This should be something like EUNKNOWN. */
- _PDCLIB_errno = _PDCLIB_ERROR;
- break;
- }
- stream->status |= _PDCLIB_ERRORFLAG;
- return EOF;
- }
- /* End-of-File */
- stream->status |= _PDCLIB_EOFFLAG;
- return EOF;
-}
-
-#endif
-
-#ifdef TEST
-#include <_PDCLIB_test.h>
-
-int main( void )
-{
- /* Testing covered by ftell.c */
- return TEST_RESULTS;
-}
-
-#endif
-
+++ /dev/null
-/* _PDCLIB_flushbuffer( struct _PDCLIB_file_t * )
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-/* This is an example implementation of _PDCLIB_flushbuffer() fit for
- use with POSIX kernels.
-*/
-
-#include <stdio.h>
-#include <string.h>
-
-#ifndef REGTEST
-#include <_PDCLIB_glue.h>
-
-#include </usr/include/errno.h>
-
-typedef long ssize_t;
-extern ssize_t write( int fd, const void * buf, size_t count );
-
-/* The number of attempts to complete an output buffer flushing before giving
- * up.
- * */
-#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 )
-
-int _PDCLIB_flushbuffer( struct _PDCLIB_file_t * stream )
-{
- if ( ! ( stream->status & _PDCLIB_FBIN ) )
- {
- /* TODO: Text stream conversion here */
- }
- /* No need to handle buffers > INT_MAX, as PDCLib doesn't allow them */
- _PDCLIB_size_t written = 0;
- int rc;
- /* Keep trying to write data until everything is written, an error
- occurs, or the configured number of retries is exceeded.
- */
- for ( unsigned int retries = _PDCLIB_IO_RETRIES; retries > 0; --retries )
- {
- rc = (int)write( stream->handle, stream->buffer + written, stream->bufidx - written );
- if ( rc < 0 )
- {
- /* Write error */
- switch ( errno )
- {
- /* See <_PDCLIB_config.h>. There should be differenciated errno
- handling here, possibly even a 1:1 mapping; but that is up
- to the individual platform.
- */
- case EBADF:
- case EFAULT:
- case EFBIG:
- case EINTR:
- case EINVAL:
- case EIO:
- case ENOSPC:
- case EPIPE:
- _PDCLIB_errno = _PDCLIB_ERROR;
- break;
- default:
- /* This should be something like EUNKNOWN. */
- _PDCLIB_errno = _PDCLIB_ERROR;
- break;
- }
- stream->status |= _PDCLIB_ERRORFLAG;
- /* Move unwritten remains to begin of buffer. */
- stream->bufidx -= written;
- memmove( stream->buffer, stream->buffer + written, stream->bufidx );
- return EOF;
- }
- written += (_PDCLIB_size_t)rc;
- stream->pos.offset += rc;
- if ( written == stream->bufidx )
- {
- /* Buffer written completely. */
- stream->bufidx = 0;
- return 0;
- }
- }
- /* Number of retries exceeded. You probably want a different errno value
- here.
- */
- _PDCLIB_errno = _PDCLIB_ERROR;
- stream->status |= _PDCLIB_ERRORFLAG;
- /* Move unwritten remains to begin of buffer. */
- stream->bufidx -= written;
- memmove( stream->buffer, stream->buffer + written, stream->bufidx );
- return EOF;
-}
-
-#endif
-
-
-#ifdef TEST
-#include <_PDCLIB_test.h>
-
-int main( void )
-{
- /* Testing covered by ftell.c */
- return TEST_RESULTS;
-}
-
-#endif
-
+++ /dev/null
-/* _PDCLIB_open( char const * const, int )
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-/* This is an example implementation of _PDCLIB_open() fit for use with POSIX
- kernels.
-*/
-
-#include <stdio.h>
-
-#ifndef REGTEST
-#include <_PDCLIB_glue.h>
-
-#include <sys/types.h>
-#include <sys/stat.h>
-#include <fcntl.h>
-#include <unistd.h>
-
-#include "/usr/include/errno.h"
-
-int _PDCLIB_open( char const * const filename, unsigned int mode )
-{
- /* This is an example implementation of _PDCLIB_open() fit for use with
- POSIX kernels.
- FIXME: The permissions of newly created files should not be hardcoded
- here.
- */
- int osmode;
- switch ( mode & ( _PDCLIB_FREAD | _PDCLIB_FWRITE | _PDCLIB_FAPPEND | _PDCLIB_FRW ) )
- {
- case _PDCLIB_FREAD: /* "r" */
- osmode = O_RDONLY;
- break;
- case _PDCLIB_FWRITE: /* "w" */
- osmode = O_WRONLY | O_CREAT | O_TRUNC;
- break;
- case _PDCLIB_FAPPEND: /* "a" */
- osmode = O_WRONLY | O_APPEND | O_CREAT;
- break;
- case _PDCLIB_FREAD | _PDCLIB_FRW: /* "r+" */
- osmode = O_RDWR;
- break;
- case _PDCLIB_FWRITE | _PDCLIB_FRW: /* "w+" */
- osmode = O_RDWR | O_CREAT | O_TRUNC;
- break;
- case _PDCLIB_FAPPEND | _PDCLIB_FRW: /* "a+" */
- osmode = O_RDWR | O_APPEND | O_CREAT;
- break;
- default: /* Invalid mode */
- return -1;
- }
- int rc;
- if ( osmode & O_CREAT )
- {
- rc = open( filename, osmode, S_IRUSR | S_IWUSR );
- }
- else
- {
- rc = open( filename, osmode );
- }
- if ( rc == -1 )
- {
- switch ( errno )
- {
- /* See the comments on implementation-defined errno values in
- <_PDCLIB_config.h>.
- */
- case EACCES:
- case EFAULT:
- case EINTR:
- case EISDIR:
- case ELOOP:
- case EMFILE:
- case ENAMETOOLONG:
- case ENFILE:
- case ENODEV:
- case ENOENT:
- case ENOMEM:
- case ENOSPC:
- case ENOTDIR:
- case EOVERFLOW:
- case EROFS:
- case ETXTBSY:
- _PDCLIB_errno = _PDCLIB_ERROR;
- break;
- default:
- /* This should be something like EUNKNOWN. */
- _PDCLIB_errno = _PDCLIB_ERROR;
- break;
- }
- }
- return rc;
-}
-
-#endif
-
-#ifdef TEST
-#include <_PDCLIB_test.h>
-
-#include <stdlib.h>
-#include <string.h>
-
-int main( void )
-{
- /* This testdriver assumes POSIX, i.e. _PDCLIB_fd_t being int and being
- incremented by one on each successful open.
- */
- int fh;
- char buffer[ 10 ];
- remove( testfile );
- /* Trying to read non-existent file. */
- TESTCASE( _PDCLIB_open( testfile, _PDCLIB_FREAD ) == _PDCLIB_NOHANDLE );
- /* Writing to file, trying to read from it. */
- TESTCASE( ( fh = _PDCLIB_open( testfile, _PDCLIB_FWRITE ) ) != _PDCLIB_NOHANDLE );
- TESTCASE( write( fh, "test", 4 ) == 4 );
- TESTCASE( lseek( fh, 0, SEEK_SET ) == 0 );
- TESTCASE( read( fh, buffer, 4 ) == -1 );
- TESTCASE( _PDCLIB_close( fh ) == 0 );
- /* Reading from file, trying to write to it. */
- TESTCASE( ( fh = _PDCLIB_open( testfile, _PDCLIB_FREAD ) ) != _PDCLIB_NOHANDLE );
- TESTCASE( write( fh, "test", 4 ) == -1 );
- TESTCASE( _PDCLIB_close( fh ) == 0 );
- /* Appending to file, trying to read from it. */
- TESTCASE( ( fh = _PDCLIB_open( testfile, _PDCLIB_FAPPEND ) ) != _PDCLIB_NOHANDLE );
- TESTCASE( write( fh, "app", 3 ) == 3 );
- TESTCASE( lseek( fh, 0, SEEK_SET ) == 0 );
- TESTCASE( read( fh, buffer, 10 ) == -1 );
- TESTCASE( write( fh, "end", 3 ) == 3 );
- TESTCASE( _PDCLIB_close( fh ) == 0 );
- /* Reading and writing from file ("r+"). */
- TESTCASE( ( fh = _PDCLIB_open( testfile, _PDCLIB_FREAD | _PDCLIB_FRW ) ) != _PDCLIB_NOHANDLE );
- TESTCASE( read( fh, buffer, 10 ) == 10 );
- TESTCASE( memcmp( buffer, "testappend", 10 ) == 0 );
- TESTCASE( lseek( fh, 0, SEEK_SET ) == 0 );
- TESTCASE( write( fh, "wedo", 4 ) == 4 );
- TESTCASE( lseek( fh, 0, SEEK_SET ) == 0 );
- TESTCASE( read( fh, buffer, 10 ) == 10 );
- TESTCASE( memcmp( buffer, "wedoappend", 10 ) == 0 );
- TESTCASE( _PDCLIB_close( fh ) == 0 );
- /* Writing and reading from file ("w+"). */
- TESTCASE( ( fh = _PDCLIB_open( testfile, _PDCLIB_FWRITE | _PDCLIB_FRW ) ) != _PDCLIB_NOHANDLE );
- TESTCASE( write( fh, "test", 4 ) == 4 );
- TESTCASE( lseek( fh, 1, SEEK_SET ) == 1 );
- TESTCASE( read( fh, buffer, 2 ) == 2 );
- TESTCASE( memcmp( buffer, "es", 2 ) == 0 );
- TESTCASE( write( fh, "sie", 3 ) == 3 );
- TESTCASE( lseek( fh, 0, SEEK_SET ) == 0 );
- TESTCASE( read( fh, buffer, 6 ) == 6 );
- TESTCASE( memcmp( buffer, "tessie", 6 ) == 0 );
- TESTCASE( _PDCLIB_close( fh ) == 0 );
- /* Appending and reading from file ("a+"). */
- TESTCASE( ( fh = _PDCLIB_open( testfile, _PDCLIB_FAPPEND | _PDCLIB_FRW ) ) != _PDCLIB_NOHANDLE );
- TESTCASE( write( fh, "baby", 4 ) == 4 );
- TESTCASE( lseek( fh, 0, SEEK_SET ) == 0 );
- TESTCASE( read( fh, buffer, 10 ) == 10 );
- TESTCASE( memcmp( buffer, "tessiebaby", 10 ) == 0 );
- TESTCASE( _PDCLIB_close( fh ) == 0 );
- /* Cleaning up. */
- TESTCASE( remove( testfile ) == 0 );
- return TEST_RESULTS;
-}
-
-#endif
-
+++ /dev/null
-/* _PDCLIB_rename( const char *, const char * )
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-#include <stdio.h>
-
-#ifndef REGTEST
-#include <_PDCLIB_glue.h>
-
-#include </usr/include/errno.h>
-
-extern int unlink( const char * pathname );
-extern int link( const char * old, const char * new );
-
-int _PDCLIB_rename( const char * old, const char * new )
-{
- /* Note that the behaviour if new file exists is implementation-defined.
- There is nothing wrong with either overwriting it or failing the
- operation, but you might want to document whichever you chose.
- This example fails if new file exists.
- */
- if ( link( old, new ) == 0 )
- {
- if ( unlink( old ) == EOF )
- {
- switch ( errno )
- {
- /* See the comments on implementation-defined errno values in
- <_PDCLIB_config.h>.
- */
- case EACCES:
- case EFAULT:
- case EIO:
- case EISDIR:
- case ELOOP:
- case ENAMETOOLONG:
- case ENOENT:
- case ENOMEM:
- case ENOTDIR:
- case EPERM:
- case EROFS:
- _PDCLIB_errno = _PDCLIB_ERROR;
- break;
- default:
- /* This should be something like EUNKNOWN. */
- _PDCLIB_errno = _PDCLIB_ERROR;
- break;
- }
- return -1;
- }
- else
- {
- return 0;
- }
- }
- else
- {
- switch ( errno )
- {
- /* See the comments on implementation-defined errno values in
- <_PDCLIB_config.h>.
- */
- case EACCES:
- case EEXIST:
- case EFAULT:
- case EIO:
- case ELOOP:
- case EMLINK:
- case ENAMETOOLONG:
- case ENOENT:
- case ENOMEM:
- case ENOSPC:
- case ENOTDIR:
- case EPERM:
- case EROFS:
- case EXDEV:
- _PDCLIB_errno = _PDCLIB_ERROR;
- break;
- default:
- /* This should be something like EUNKNOWN. */
- _PDCLIB_errno = _PDCLIB_ERROR;
- break;
- }
- return EOF;
- }
-}
-
-#endif
-
-#ifdef TEST
-#include <_PDCLIB_test.h>
-
-#include <stdlib.h>
-
-int main( void )
-{
- FILE * file;
- remove( testfile1 );
- remove( testfile2 );
- /* check that neither file exists */
- TESTCASE( fopen( testfile1, "r" ) == NULL );
- TESTCASE( fopen( testfile2, "r" ) == NULL );
- /* rename file 1 to file 2 - expected to fail */
- TESTCASE( _PDCLIB_rename( testfile1, testfile2 ) == -1 );
- /* create file 1 */
- TESTCASE( ( file = fopen( testfile1, "w" ) ) != NULL );
- TESTCASE( fputc( 'x', file ) == 'x' );
- TESTCASE( fclose( file ) == 0 );
- /* check that file 1 exists */
- TESTCASE( fopen( testfile1, "r" ) != NULL );
- /* rename file 1 to file 2 */
- TESTCASE( _PDCLIB_rename( testfile1, testfile2 ) == 0 );
- /* check that file 2 exists, file 1 does not */
- TESTCASE( fopen( testfile1, "r" ) == NULL );
- TESTCASE( fopen( testfile2, "r" ) != NULL );
- /* create another file 1 */
- TESTCASE( ( file = fopen( testfile1, "w" ) ) != NULL );
- TESTCASE( fputc( 'x', file ) == 'x' );
- TESTCASE( fclose( file ) == 0 );
- /* check that file 1 exists */
- TESTCASE( ( file = fopen( testfile1, "r" ) ) != NULL );
- TESTCASE( fclose( file ) == 0 );
- /* rename file 1 to file 2 - expected to fail, see comment in
- _PDCLIB_rename() itself.
- */
- TESTCASE( _PDCLIB_rename( testfile1, testfile2 ) == -1 );
- /* remove both files */
- remove( testfile1 );
- remove( testfile2 );
- return TEST_RESULTS;
-}
-
-#endif
+++ /dev/null
-/* int64_t _PDCLIB_seek( FILE *, int64_t, int )
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-#include <stdio.h>
-
-#include <_PDCLIB_glue.h>
-
-#include "/usr/include/errno.h"
-
-extern int lseek( int fd, int offset, int whence );
-
-_PDCLIB_int64_t _PDCLIB_seek( struct _PDCLIB_file_t * stream, _PDCLIB_int64_t offset, int whence )
-{
- switch ( whence )
- {
- case SEEK_SET:
- case SEEK_CUR:
- case SEEK_END:
- /* EMPTY - OK */
- break;
- default:
- _PDCLIB_errno = _PDCLIB_ERROR;
- return EOF;
- break;
- }
- _PDCLIB_int64_t rc = lseek( stream->handle, offset, whence );
- if ( rc != EOF )
- {
- stream->ungetidx = 0;
- stream->bufidx = 0;
- stream->bufend = 0;
- stream->pos.offset = rc;
- return rc;
- }
- switch ( errno )
- {
- /* See comments on implementation-defined errno values in
- <_PDCLIB_config.h>.
- */
- case EBADF:
- case EFAULT:
- _PDCLIB_errno = _PDCLIB_ERROR;
- break;
- default:
- /* This should be something like EUNKNOWN. */
- _PDCLIB_errno = _PDCLIB_ERROR;
- break;
- }
- return EOF;
-}
-
-#ifdef TEST
-#include <_PDCLIB_test.h>
-
-int main( void )
-{
- /* Testing covered by ftell.c */
- return TEST_RESULTS;
-}
-
-#endif
-
+++ /dev/null
-/* _PDCLIB_stdinit
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-/* This is an example initialization of stdin, stdout and stderr to the integer
- file descriptors 0, 1, and 2, respectively. This applies for a great variety
- of operating systems, including POSIX compliant ones.
-*/
-
-#include <stdio.h>
-
-#ifndef REGTEST
-
-/* In a POSIX system, stdin / stdout / stderr are equivalent to the (int) file
- descriptors 0, 1, and 2 respectively.
-*/
-/* TODO: This is proof-of-concept, requires finetuning. */
-static char _PDCLIB_sin_buffer[BUFSIZ];
-static char _PDCLIB_sout_buffer[BUFSIZ];
-static char _PDCLIB_serr_buffer[BUFSIZ];
-
-static unsigned char _PDCLIB_sin_ungetbuf[_PDCLIB_UNGETCBUFSIZE];
-static unsigned char _PDCLIB_sout_ungetbuf[_PDCLIB_UNGETCBUFSIZE];
-static unsigned char _PDCLIB_serr_ungetbuf[_PDCLIB_UNGETCBUFSIZE];
-
-/* FIXME: serr should handle one character. Buffering on out / in? */
-static struct _PDCLIB_file_t _PDCLIB_serr = { 2, _PDCLIB_serr_buffer, BUFSIZ, 0, 0, { 0, 0 }, 0, _PDCLIB_serr_ungetbuf, _IONBF | _PDCLIB_FWRITE, NULL, NULL };
-static struct _PDCLIB_file_t _PDCLIB_sout = { 1, _PDCLIB_sout_buffer, BUFSIZ, 0, 0, { 0, 0 }, 0, _PDCLIB_sout_ungetbuf, _IOLBF | _PDCLIB_FWRITE, NULL, &_PDCLIB_serr };
-static struct _PDCLIB_file_t _PDCLIB_sin = { 0, _PDCLIB_sin_buffer, BUFSIZ, 0, 0, { 0, 0 }, 0, _PDCLIB_sin_ungetbuf, _IOLBF | _PDCLIB_FREAD, NULL, &_PDCLIB_sout };
-
-struct _PDCLIB_file_t * stdin = &_PDCLIB_sin;
-struct _PDCLIB_file_t * stdout = &_PDCLIB_sout;
-struct _PDCLIB_file_t * stderr = &_PDCLIB_serr;
-
-/* FIXME: This approach is a possible attack vector. */
-struct _PDCLIB_file_t * _PDCLIB_filelist = &_PDCLIB_sin;
-
-#endif
-
-#ifdef TEST
-#include <_PDCLIB_test.h>
-
-int main( void )
-{
- /* Testing covered by several other testdrivers using stdin / stdout /
- stderr.
- */
- return TEST_RESULTS;
-}
-
-#endif
+++ /dev/null
-/* raise( int )
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-#include <signal.h>
-
-#ifndef REGTEST
-
-#include <stdio.h>
-#include <stdlib.h>
-
-extern void (*_PDCLIB_sigabrt)( int );
-extern void (*_PDCLIB_sigfpe)( int );
-extern void (*_PDCLIB_sigill)( int );
-extern void (*_PDCLIB_sigint)( int );
-extern void (*_PDCLIB_sigsegv)( int );
-extern void (*_PDCLIB_sigterm)( int );
-
-int raise( int sig )
-{
- void (*sighandler)( int );
- char const * message;
- switch ( sig )
- {
- case SIGABRT:
- sighandler = _PDCLIB_sigabrt;
- message = "Abnormal termination (SIGABRT)";
- break;
- case SIGFPE:
- sighandler = _PDCLIB_sigfpe;
- message = "Arithmetic exception (SIGFPE)";
- break;
- case SIGILL:
- sighandler = _PDCLIB_sigill;
- message = "Illegal instruction (SIGILL)";
- break;
- case SIGINT:
- sighandler = _PDCLIB_sigint;
- message = "Interactive attention signal (SIGINT)";
- break;
- case SIGSEGV:
- sighandler = _PDCLIB_sigsegv;
- message = "Invalid memory access (SIGSEGV)";
- break;
- case SIGTERM:
- sighandler = _PDCLIB_sigterm;
- message = "Termination request (SIGTERM)";
- break;
- default:
- fprintf( stderr, "Unknown signal #%d\n", sig );
- _Exit( EXIT_FAILURE );
- }
- if ( sighandler == SIG_DFL )
- {
- fputs( message, stderr );
- _Exit( EXIT_FAILURE );
- }
- else if ( sighandler != SIG_IGN )
- {
- sighandler = signal( sig, SIG_DFL );
- sighandler( sig );
- }
- return 0;
-}
-
-#endif
-
-#ifdef TEST
-#include <_PDCLIB_test.h>
-
-#include <stdlib.h>
-
-static volatile sig_atomic_t flag = 0;
-
-static int expected_signal = 0;
-
-static void test_handler( int sig )
-{
- TESTCASE( sig == expected_signal );
- flag = 1;
-}
-
-int main( void )
-{
- /* Could be other than SIG_DFL if you changed the implementation. */
- TESTCASE( signal( SIGABRT, SIG_IGN ) == SIG_DFL );
- /* Should be ignored. */
- TESTCASE( raise( SIGABRT ) == 0 );
- /* Installing test handler, old handler should be returned */
- TESTCASE( signal( SIGABRT, test_handler ) == SIG_IGN );
- /* Raising and checking SIGABRT */
- expected_signal = SIGABRT;
- TESTCASE( raise( SIGABRT ) == 0 );
- TESTCASE( flag == 1 );
- /* Re-installing test handler, should have been reset to default */
- /* Could be other than SIG_DFL if you changed the implementation. */
- TESTCASE( signal( SIGABRT, test_handler ) == SIG_DFL );
- /* Raising and checking SIGABRT */
- flag = 0;
- TESTCASE( raise( SIGABRT ) == 0 );
- TESTCASE( flag == 1 );
- /* Installing test handler for different signal... */
- TESTCASE( signal( SIGTERM, test_handler ) == SIG_DFL );
- /* Raising and checking SIGTERM */
- expected_signal = SIGTERM;
- TESTCASE( raise( SIGTERM ) == 0 );
- TESTCASE( flag == 1 );
- return TEST_RESULTS;
-}
-#endif
+++ /dev/null
-/* signal( int, void (*)( int ) )
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-#include <signal.h>
-
-#ifndef REGTEST
-
-#include <stdlib.h>
-
-void (*_PDCLIB_sigabrt)( int ) = SIG_DFL;
-void (*_PDCLIB_sigfpe)( int ) = SIG_DFL;
-void (*_PDCLIB_sigill)( int ) = SIG_DFL;
-void (*_PDCLIB_sigint)( int ) = SIG_DFL;
-void (*_PDCLIB_sigsegv)( int ) = SIG_DFL;
-void (*_PDCLIB_sigterm)( int ) = SIG_DFL;
-
-void (*signal( int sig, void (*func)( int ) ) )( int )
-{
- void (*oldhandler)( int );
- switch ( sig )
- {
- case SIGABRT:
- oldhandler = _PDCLIB_sigabrt;
- _PDCLIB_sigabrt = func;
- break;
- case SIGFPE:
- oldhandler = _PDCLIB_sigfpe;
- _PDCLIB_sigfpe = func;
- break;
- case SIGILL:
- oldhandler = _PDCLIB_sigill;
- _PDCLIB_sigill = func;
- break;
- case SIGINT:
- oldhandler = _PDCLIB_sigint;
- _PDCLIB_sigint = func;
- break;
- case SIGSEGV:
- oldhandler = _PDCLIB_sigsegv;
- _PDCLIB_sigsegv = func;
- break;
- case SIGTERM:
- oldhandler = _PDCLIB_sigterm;
- _PDCLIB_sigterm = func;
- break;
- default:
- /* The standard calls for an unspecified "positive value". You
- will probably want to define a specific value for this.
- */
- _PDCLIB_errno = 1;
- return SIG_ERR;
- }
- return oldhandler;
-}
-
-#endif
-
-#ifdef TEST
-#include <_PDCLIB_test.h>
-
-int main( void )
-{
- TESTCASE( NO_TESTDRIVER );
- return TEST_RESULTS;
-}
-#endif
+++ /dev/null
-/* remove( const char * )
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-/* This is an example implementation of remove() fit for use with POSIX kernels.
-*/
-
-#include <stdio.h>
-
-#ifndef REGTEST
-
-#include "/usr/include/errno.h"
-
-extern int unlink( const char * pathname );
-
-int remove( const char * pathname )
-{
- int rc;
- if ( ( rc = unlink( pathname ) ) == -1 )
- {
- switch ( errno )
- {
- /* See the comments on implementation-defined errno values in
- <_PDCLIB_config.h>.
- */
- case EACCES:
- case EFAULT:
- case EIO:
- case EISDIR:
- case ELOOP:
- case ENAMETOOLONG:
- case ENOENT:
- case ENOMEM:
- case ENOTDIR:
- case EPERM:
- case EROFS:
- _PDCLIB_errno = _PDCLIB_ERROR;
- break;
- default:
- /* This should be something like EUNKNOWN. */
- _PDCLIB_errno = _PDCLIB_ERROR;
- break;
- }
- }
- return rc;
-}
-
-#endif
-
-#ifdef TEST
-#include <_PDCLIB_test.h>
-
-int main( void )
-{
- /* Testing covered by ftell.c (and several others) */
- return TEST_RESULTS;
-}
-
-#endif
-
+++ /dev/null
-/* tmpfile( void )
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-#include <stdio.h>
-
-#ifndef REGTEST
-
-struct _PDCLIB_file_t * tmpfile( void )
-{
- /* TODO: Implement */
- return NULL;
-}
-
-#endif
-
-#ifdef TEST
-#include <_PDCLIB_test.h>
-
-int main( void )
-{
- FILE * fh;
- char filename[ L_tmpnam ];
- FILE * fhtest;
- TESTCASE( ( fh = tmpfile() ) != NULL );
- TESTCASE( fputc( 'x', fh ) == 'x' );
- /* Checking that file is actually there */
- TESTCASE_NOREG( strcpy( filename, fh->filename ) == filename );
- TESTCASE_NOREG( ( fhtest = fopen( filename, "r" ) ) != NULL );
- TESTCASE_NOREG( fclose( fhtest ) == 0 );
- /* Closing tmpfile */
- TESTCASE( fclose( fh ) == 0 );
- /* Checking that file was deleted */
- TESTCASE_NOREG( fopen( filename, "r" ) == NULL );
- return TEST_RESULTS;
-}
-
-#endif
+++ /dev/null
-/* getenv( const char * )
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-/* This is an example implementation of getenv() fit for use with POSIX kernels.
-*/
-
-#include <string.h>
-#include <stdlib.h>
-
-#ifndef REGTEST
-
-extern char * * environ;
-
-char * getenv( const char * name )
-{
- size_t len = strlen( name );
- size_t index = 0;
- while ( environ[ index ] != NULL )
- {
- if ( strncmp( environ[ index ], name, len ) == 0 )
- {
- return environ[ index ] + len + 1;
- }
- index++;
- }
- return NULL;
-}
-
-#endif
-
-#ifdef TEST
-#include <_PDCLIB_test.h>
-
-int main( void )
-{
- TESTCASE( strcmp( getenv( "SHELL" ), "/bin/bash" ) == 0 );
- /* TESTCASE( strcmp( getenv( "SHELL" ), "/bin/sh" ) == 0 ); */
- return TEST_RESULTS;
-}
-
-#endif
+++ /dev/null
-/* system( const char * )
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-#include <stdlib.h>
-
-/* This is an example implementation of system() fit for use with POSIX kernels.
-*/
-
-extern int fork( void );
-extern int execve( const char * filename, char * const argv[], char * const envp[] );
-extern int wait( int * status );
-
-int system( const char * string )
-{
- char const * const argv[] = { "sh", "-c", (char const * const)string, NULL };
- if ( string != NULL )
- {
- int pid = fork();
- if ( pid == 0 )
- {
- execve( "/bin/sh", (char * * const)argv, NULL );
- }
- else if ( pid > 0 )
- {
- while( wait( NULL ) != pid );
- }
- }
- return -1;
-}
-
-#ifdef TEST
-#include <_PDCLIB_test.h>
-
-#define SHELLCOMMAND "echo 'SUCCESS testing system()'"
-
-int main( void )
-{
- TESTCASE( system( SHELLCOMMAND ) );
- return TEST_RESULTS;
-}
-
-#endif
+++ /dev/null
-/* Characteristics of floating types <float.h>
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-#ifndef _PDCLIB_FLOAT_H
-#define _PDCLIB_FLOAT_H _PDCLIB_FLOAT_H
-
-#include <_PDCLIB_config.h>
-
-#define FLT_ROUNDS _PDCLIB_FLT_ROUNDS
-#define FLT_EVAL_METHOD _PDCLIB_FLT_EVAL_METHOD
-#define DECIMAL_DIG _PDCLIB_DECIMAL_DIG
-
- /* Radix of exponent representation */
-#define FLT_RADIX __FLT_RADIX__
- /* Number of base-FLT_RADIX digits in the significand of a float */
-#define FLT_MANT_DIG __FLT_MANT_DIG__
- /* Number of decimal digits of precision in a float */
-#define FLT_DIG __FLT_DIG__
- /* Difference between 1.0 and the minimum float greater than 1.0 */
-#define FLT_EPSILON __FLT_EPSILON__
- /* Minimum int x such that FLT_RADIX**(x-1) is a normalised float */
-#define FLT_MIN_EXP __FLT_MIN_EXP__
- /* Minimum normalised float */
-#define FLT_MIN __FLT_MIN__
- /* Minimum int x such that 10**x is a normalised float */
-#define FLT_MIN_10_EXP __FLT_MIN_10_EXP__
- /* Maximum int x such that FLT_RADIX**(x-1) is a representable float */
-#define FLT_MAX_EXP __FLT_MAX_EXP__
- /* Maximum float */
-#define FLT_MAX __FLT_MAX__
- /* Maximum int x such that 10**x is a representable float */
-#define FLT_MAX_10_EXP __FLT_MAX_10_EXP__
-
- /* Number of base-FLT_RADIX digits in the significand of a double */
-#define DBL_MANT_DIG __DBL_MANT_DIG__
- /* Number of decimal digits of precision in a double */
-#define DBL_DIG __DBL_DIG__
- /* Difference between 1.0 and the minimum double greater than 1.0 */
-#define DBL_EPSILON __DBL_EPSILON__
- /* Minimum int x such that FLT_RADIX**(x-1) is a normalised double */
-#define DBL_MIN_EXP __DBL_MIN_EXP__
- /* Minimum normalised double */
-#define DBL_MIN __DBL_MIN__
- /* Minimum int x such that 10**x is a normalised double */
-#define DBL_MIN_10_EXP __DBL_MIN_10_EXP__
- /* Maximum int x such that FLT_RADIX**(x-1) is a representable double */
-#define DBL_MAX_EXP __DBL_MAX_EXP__
- /* Maximum double */
-#define DBL_MAX __DBL_MAX__
- /* Maximum int x such that 10**x is a representable double */
-#define DBL_MAX_10_EXP __DBL_MAX_10_EXP__
-
- /* Number of base-FLT_RADIX digits in the significand of a long double */
-#define LDBL_MANT_DIG __LDBL_MANT_DIG__
- /* Number of decimal digits of precision in a long double */
-#define LDBL_DIG __LDBL_DIG__
- /* Difference between 1.0 and the minimum long double greater than 1.0 */
-#define LDBL_EPSILON __LDBL_EPSILON__
- /* Minimum int x such that FLT_RADIX**(x-1) is a normalised long double */
-#define LDBL_MIN_EXP __LDBL_MIN_EXP__
- /* Minimum normalised long double */
-#define LDBL_MIN __LDBL_MIN__
- /* Minimum int x such that 10**x is a normalised long double */
-#define LDBL_MIN_10_EXP __LDBL_MIN_10_EXP__
- /* Maximum int x such that FLT_RADIX**(x-1) is a representable long double */
-#define LDBL_MAX_EXP __LDBL_MAX_EXP__
- /* Maximum long double */
-#define LDBL_MAX __LDBL_MAX__
- /* Maximum int x such that 10**x is a representable long double */
-#define LDBL_MAX_10_EXP __LDBL_MAX_10_EXP__
-
-#endif
+++ /dev/null
-/* Signal handling <string.h>
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-#ifndef _PDCLIB_SIGNAL_H
-#define _PDCLIB_SIGNAL_H _PDCLIB_SIGNAL_H
-
-#include <_PDCLIB_config.h>
-
-/* Signals ------------------------------------------------------------------ */
-
-/* A word on signals, to the people using PDCLib in their OS projects.
-
- The definitions of the C standard leave about everything that *could* be
- useful to be "implementation defined". Without additional, non-standard
- arrangements, it is not possible to turn them into a useful tool.
-
- This example implementation chose to "not generate any of these signals,
- except as a result of explicit calls to the raise function", which is
- allowed by the standard but of course does nothing for the usefulness of
- <signal.h>.
-
- A useful signal handling would:
- 1) make signal() a system call that registers the signal handler with the OS
- 2) make raise() a system call triggering an OS signal to the running process
- 3) make provisions that further signals of the same type are blocked until
- the signal handler returns (optional for SIGILL)
-*/
-
-/* These are the values used by Linux. */
-
-/* Abnormal termination / abort() */
-#define SIGABRT 6
-/* Arithmetic exception / division by zero / overflow */
-#define SIGFPE 8
-/* Illegal instruction */
-#define SIGILL 4
-/* Interactive attention signal */
-#define SIGINT 2
-/* Invalid memory access */
-#define SIGSEGV 11
-/* Termination request */
-#define SIGTERM 15
-
-/* The following should be defined to pointer values that could NEVER point to
- a valid signal handler function. (They are used as special arguments to
- signal().) Again, these are the values used by Linux.
-*/
-#define SIG_DFL (void (*)( int ))0
-#define SIG_ERR (void (*)( int ))-1
-#define SIG_IGN (void (*)( int ))1
-
-typedef _PDCLIB_sig_atomic sig_atomic_t;
-
-/* Installs a signal handler "func" for the given signal.
- A signal handler is a function that takes an integer as argument (the signal
- number) and returns void.
-
- Note that a signal handler can do very little else than:
- 1) assign a value to a static object of type "volatile sig_atomic_t",
- 2) call signal() with the value of sig equal to the signal received,
- 3) call _Exit(),
- 4) call abort().
- Virtually everything else is undefind.
-
- The signal() function returns the previous installed signal handler, which
- at program start may be SIG_DFL or SIG_ILL. (This implementation uses
- SIG_DFL for all handlers.) If the request cannot be honored, SIG_ERR is
- returned and errno is set to an unspecified positive value.
-*/
-void (*signal( int sig, void (*func)( int ) ) )( int );
-
-/* Raises the given signal (executing the registered signal handler with the
- given signal number as parameter).
- This implementation does not prevent further signals of the same time from
- occuring, but executes signal( sig, SIG_DFL ) before entering the signal
- handler (i.e., a second signal before the signal handler re-registers itself
- or SIG_IGN will end the program).
- Returns zero if successful, nonzero otherwise. */
-int raise( int sig );
-
-#endif
-
+++ /dev/null
-/* Internal PDCLib configuration <_PDCLIB_config.h>
- (Generic Template)
-
- This file is part of the Public Domain C Library (PDCLib).
- Permission is granted to use, modify, and / or redistribute at will.
-*/
-
-#ifndef _PDCLIB_CONFIG_H
-#define _PDCLIB_CONFIG_H _PDCLIB_CONFIG_H
-
-/* -------------------------------------------------------------------------- */
-/* Misc */
-/* -------------------------------------------------------------------------- */
-
-/* The character (sequence) your platform uses as newline. */
-#define _PDCLIB_endl "\n"
-
-/* 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 */
-/* is not required to handle it gracefully. Set your definitions here. */
-#define _PDCLIB_SUCCESS 0
-#define _PDCLIB_FAILURE -1
-
-/* qsort() in <stdlib.h> requires a function that swaps two memory areas. */
-/* Below is a naive implementation that can be improved significantly for */
-/* 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 */
-/* -------------------------------------------------------------------------- */
-/* Assuming 8-bit char, two's-complement architecture here. 'short' being */
-/* 16 bit, 'int' being either 16, 32 or 64 bit, 'long' being either 32 or 64 */
-/* bit (but 64 bit only if 'int' is 32 bit), and 'long long' being 64 bit if */
-/* 'long' is not, 64 or 128 bit otherwise. */
-/* Author is quite willing to support other systems but would like to hear of */
-/* interest in such support and details on the to-be-supported architecture */
-/* first, before going to lengths about it. */
-/* -------------------------------------------------------------------------- */
-
-/* Comment out (or delete) the line below if your 'char' type is unsigned. */
-#define _PDCLIB_CHAR_SIGNED 1
-
-/* Width of the integer types short, int, long, and long long, in bytes. */
-/* SHRT == 2, INT >= SHRT, LONG >= INT >= 4, LLONG >= LONG - check your */
-/* compiler manuals. */
-#define _PDCLIB_SHRT_BYTES 2
-#define _PDCLIB_INT_BYTES 4
-#define _PDCLIB_LONG_BYTES 4
-#define _PDCLIB_LLONG_BYTES 8
-
-/* <stdlib.h> defines the div() function family that allows taking quotient */
-/* and remainder of an integer division in one operation. Many platforms */
-/* support this in hardware / opcode, and the standard permits ordering of */
-/* the return structure in any way to fit the hardware. That is why those */
-/* structs can be configured here. */
-
-struct _PDCLIB_div_t
-{
- int quot;
- int rem;
-};
-
-struct _PDCLIB_ldiv_t
-{
- long int quot;
- long int rem;
-};
-
-struct _PDCLIB_lldiv_t
-{
- long long int quot;
- long long int rem;
-};
-
-/* -------------------------------------------------------------------------- */
-/* <stdint.h> defines a set of integer types that are of a minimum width, and */
-/* "usually fastest" on the system. (If, for example, accessing a single char */
-/* requires the CPU to access a complete int and then mask out the char, the */
-/* "usually fastest" type of at least 8 bits would be int, not char.) */
-/* If you do not have information on the relative performance of the types, */
-/* the standard allows you to define any type that meets minimum width and */
-/* signedness requirements. */
-/* The defines below are just configuration for the real typedefs and limit */
-/* definitions done in <_PDCLIB_int.h>. The uppercase define shall be either */
-/* 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 <inttypes.h>). */
-/* 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. */
-/* -------------------------------------------------------------------------- */
-
-#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 LLONG
-#define _PDCLIB_fast64 long long
-#define _PDCLIB_FAST64_CONV ll
-
-/* -------------------------------------------------------------------------- */
-/* What follows are a couple of "special" typedefs and their limits. Again, */
-/* the actual definition of the limits is done in <_PDCLIB_int.h>, and the */
-/* defines here are merely "configuration". See above for details. */
-/* -------------------------------------------------------------------------- */
-
-/* The result type of substracting two pointers */
-#define _PDCLIB_ptrdiff int
-#define _PDCLIB_PTRDIFF INT
-#define _PDCLIB_PTR_CONV
-
-/* An integer type that can be accessed as atomic entity (think asynchronous
- 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) */
-#define _PDCLIB_size unsigned int
-#define _PDCLIB_SIZE UINT
-
-/* 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_intptr int
-#define _PDCLIB_INTPTR INT
-
-/* Largest supported integer type. Implementation note: see _PDCLIB_atomax(). */
-#define _PDCLIB_intmax long long int
-#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
-
-/* <inttypes.h> 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 */
-/* -------------------------------------------------------------------------- */
-
-/* Whether the implementation rounds toward zero (0), to nearest (1), toward
- positive infinity (2), or toward negative infinity (3). (-1) signifies
- indeterminable rounding, any other value implementation-specific rounding.
-*/
-#define _PDCLIB_FLT_ROUNDS -1
-
-/* Whether the implementation uses exact-width precision (0), promotes float
- to double (1), or promotes float and double to long double (2). (-1)
- signifies indeterminable behaviour, any other value implementation-specific
- behaviour.
-*/
-#define _PDCLIB_FLT_EVAL_METHOD -1
-
-/* "Number of the decimal digits (n), such that any floating-point number in the
- widest supported floating type with p(max) radix (b) digits can be rounded to
- a floating-point number with (n) decimal digits and back again without change
- to the value p(max) log(10)b if (b) is a power of 10, [1 + p(max) log(10)b]
- otherwise."
- 64bit IEC 60559 double format (53bit mantissa) is DECIMAL_DIG 17.
- 80bit IEC 60559 double-extended format (64bit mantissa) is DECIMAL_DIG 21.
-*/
-#define _PDCLIB_DECIMAL_DIG 17
-
-/* -------------------------------------------------------------------------- */
-/* Platform-dependent macros defined by the standard headers. */
-/* -------------------------------------------------------------------------- */
-
-/* The offsetof macro
- Contract: Expand to an integer constant expression of type size_t, which
- represents the offset in bytes to the structure member from the beginning
- of the structure. If the specified member is a bitfield, behaviour is
- undefined.
- There is no standard-compliant way to do this.
- This implementation casts an integer zero to 'pointer to type', and then
- takes the address of member. This is undefined behaviour but should work on
- most compilers.
-*/
-#define _PDCLIB_offsetof( type, member ) ( (size_t) &( ( (type *) 0 )->member ) )
-
-/* Variable Length Parameter List Handling (<stdarg.h>)
- The macros defined by <stdarg.h> are highly dependent on the calling
- conventions used, and you probably have to replace them with builtins of
- your compiler. The following generic implementation works only for pure
- stack-based architectures, and only if arguments are aligned to pointer
- type. Credits to Michael Moody, who contributed this to the Public Domain.
-*/
-
-/* Internal helper macro. va_round is not part of <stdarg.h>. */
-#define _PDCLIB_va_round( type ) ( (sizeof(type) + sizeof(void *) - 1) & ~(sizeof(void *) - 1) )
-
-typedef char * _PDCLIB_va_list;
-#define _PDCLIB_va_arg( ap, type ) ( (ap) += (_PDCLIB_va_round(type)), ( *(type*) ( (ap) - (_PDCLIB_va_round(type)) ) ) )
-#define _PDCLIB_va_copy( dest, src ) ( (dest) = (src), (void)0 )
-#define _PDCLIB_va_end( ap ) ( (ap) = (void *)0, (void)0 )
-#define _PDCLIB_va_start( ap, parmN ) ( (ap) = (char *) &parmN + ( _PDCLIB_va_round(parmN) ), (void)0 )
-
-/* -------------------------------------------------------------------------- */
-/* OS "glue", part 1 */
-/* These are values and data type definitions that you would have to adapt to */
-/* the capabilities and requirements of your OS. */
-/* The actual *functions* of the OS interface are declared in _PDCLIB_glue.h. */
-/* -------------------------------------------------------------------------- */
-
-/* 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.)
-*/
-#define _PDCLIB_PAGESIZE 4096
-
-/* 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 ---------------------------------------------------------------------- */
-
-/* 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 )
-
-/* 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).
-*/
-#define _PDCLIB_SEEK_SET 0
-#define _PDCLIB_SEEK_CUR 1
-#define _PDCLIB_SEEK_END 2
-
-/* The number of characters that can be buffered with ungetc(). The standard
- guarantees only one (1); anything larger would make applications relying on
- this capability dependent on implementation-defined behaviour (not good).
-*/
-#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 <errno.h> will "see" EPERM instead of EISDIR (the _PDCLIB_*
- prefix removed by <errno.h> 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, as to avoid confusion.
-
- The 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. There is some controversy as to whether errno is
- such a good idea at all, so you might want to come up with a different error
- reporting facility for your platform. Since errno values beyond the three
- defined by the standard are not portable anyway (unless you look at POSIX),
- having your own error reporting facility would not hurt anybody either.
-*/
-#define _PDCLIB_ERANGE 1
-#define _PDCLIB_EDOM 2
-#define _PDCLIB_EILSEQ 3
-
-/* The following is not strictly "configuration", but there is no better place
- to explain it than here.
-
- PDCLib strives to be as generic as possible, so by default it does NOT define
- any values beyond the three standard ones above, even where it would have
- been prudent and convenient to do so. Any errno "caught" from the host OS,
- and some internal error conditions as well, are all lumped together into the
- value of '_PDCLIB_ERROR'.
-
- '_PDCLIB_ERROR' is STRICLY meant as a PLACEHOLDER only.
-
- You should NEVER ship an adaption of PDCLib still using that particular
- value. You should NEVER write code that *tests* for that value. Indeed it is
- not even conforming, since errno values should be defined as beginning with
- an uppercase 'E', and there is no mechanics in <errno.h> to unmask that
- particular value (for exactly that reason).
-
- There also is no error message available for this value through either the
- strerror() or perror() functions. It is being reported as "unknown" error.
-
- The idea is that you scan the source of PDCLib for occurrences of this macro
- and replace _PDCLIB_ERROR with whatever additional errno value you came up
- with for your platform.
-
- If you cannot find it within you to do that, tell your clients to check for
- an errno value larger than zero. That, at least, would be standard compliant
- (and fully portable).
-*/
-#define _PDCLIB_ERROR 4
-
-/* The maximum value that errno can be set to. This is used to set the size */
-/* of the array in struct lconv (<locale.h>) holding error messages for the */
-/* strerror() and perror() functions. (If you change this value because you */
-/* are using additional errno values, you *HAVE* to provide appropriate error */
-/* messages for *ALL* locales.) */
-/* Default is 4 (0, ERANGE, EDOM, EILSEQ). */
-#define _PDCLIB_ERRNO_MAX 4
-
-#endif
projects / pdclib / commitdiff