Modify various POSIX platform files so you can build on top of glibc for testing

[pdclib.old] / internals / _PDCLIB_glue.h

diff --git a/internals/_PDCLIB_glue.h b/internals/_PDCLIB_glue.h
index f946cf5effe5c6099b5849dc63baf2228aca51aa..1d978638f8f46cce35c4c188864166b876f61b4f 100644 (file)
--- a/internals/_PDCLIB_glue.h
+++ b/internals/_PDCLIB_glue.h
@@ -1,7 +1,5 @@
-#ifndef _PDCLIB_GLUE_H
-#define _PDCLIB_GLUE_H
-/* $Id$ */
-
+#ifndef __PDCLIB_GLUE_H
+#define __PDCLIB_GLUE_H __PDCLIB_GLUE_H
 /* OS glue functions declaration <_PDCLIB_glue.h>
 
    This file is part of the Public Domain C Library (PDCLib).
@@ -9,6 +7,9 @@
 */
 
 #include <_PDCLIB_int.h>
+#include <_PDCLIB_io.h>
+#include <stdbool.h>
+#include <stddef.h>
 _PDCLIB_BEGIN_EXTERN_C
 
 /* -------------------------------------------------------------------------- */
@@ -23,45 +24,38 @@ _PDCLIB_BEGIN_EXTERN_C
 /* A system call that terminates the calling process, returning a given status
    to the environment.
 */
-void _PDCLIB_Exit( int status ) _PDCLIB_NORETURN;
+_PDCLIB_noreturn void _PDCLIB_Exit( int status );
 
-/* A system call that adds n pages of memory to the process heap (if n is
-   positive), or releases n pages from the process heap (if n is negative).
-   Return a (void *) pointing to the *former* end-of-heap if successful, NULL
-   otherwise.
+/* A system call which allocates n pages of memory and returns a pointer to 
+   them. On failure, returns NULL
 */
-void * _PDCLIB_allocpages( int n );
-
+void * _PDCLIB_allocpages( size_t n );
 
-/* stdio.h */
-
-/* A system call that opens a file identified by name in a given mode. Return 
-   a file descriptor uniquely identifying that file.
-   (The mode is the return value of the _PDCLIB_filemode() function.)
-*/
-_PDCLIB_fd_t _PDCLIB_open( char const * const filename, unsigned int mode );
+/* A system call which frees the n pages of memory pointed to by p */
+void _PDCLIB_freepages( void * p, size_t n );
 
-/* A system call that writes a stream's buffer.
-   Returns 0 on success, EOF on write error.
-   Sets stream error flags and errno appropriately on error.
-*/
-int _PDCLIB_flushbuffer( struct _PDCLIB_file_t * stream );
+#ifdef _PDCLIB_HAVE_REALLOCPAGES
+/* A system call which attempts to reallocate the group of \p on pages starting
+   at \p p, resizing the chunk to be \p nn pages long. If \p mayMove is true, 
+   then then the group of pages may move; otherwise, if the group cannot be 
+   resized in its current position, failure must be reported.
 
-/* A system call that fills a stream's buffer.
-   Returns 0 on success, EOF on read error / EOF.
-   Sets stream EOF / error flags and errno appropriately on error.
+   On failure, returns NULL; on success, returns the address of the group of 
+   pages (if mayMove == false, then this must be equal to \p p)
 */
-int _PDCLIB_fillbuffer( struct _PDCLIB_file_t * stream );
+void * _PDCLIB_reallocpages( void* p, size_t on, size_t nn, bool mayMove);
+#endif
 
-/* A system call that repositions within a file. Returns new offset on success,
-   -1 / errno on error.
-*/
-_PDCLIB_int64_t _PDCLIB_seek( struct _PDCLIB_file_t * stream, _PDCLIB_int64_t offset, int whence );
+/* stdio.h */
 
-/* A system call that closes a file identified by given file descriptor. Return
-   zero on success, non-zero otherwise.
-*/
-int _PDCLIB_close( _PDCLIB_fd_t fd );
+/* Open the file with the given name and mode. Return the file descriptor in 
+ * *fd and a pointer to the operations structure in **ops on success.
+ *
+ * Return true on success and false on failure.
+ */
+bool _PDCLIB_open( 
+   _PDCLIB_fd_t* fd, const _PDCLIB_fileops_t** ops,
+   char const * filename, unsigned int mode );
 
 /* A system call that removes a file identified by name. Return zero on success,
    non-zero otherwise.