X-Git-Url: https://pd.if.org/git/?p=pdclib;a=blobdiff_plain;f=internals%2F_PDCLIB_glue.h;h=68f37e7827ee5f7f6684afcd213a778a3cb85e38;hp=f946cf5effe5c6099b5849dc63baf2228aca51aa;hb=be738e08ec9ba2498d81153bee1de9b8af7e764c;hpb=b41576197133c1211d6ec353faf93f505f573b8a diff --git a/internals/_PDCLIB_glue.h b/internals/_PDCLIB_glue.h index f946cf5..68f37e7 100644 --- a/internals/_PDCLIB_glue.h +++ b/internals/_PDCLIB_glue.h @@ -1,15 +1,21 @@ -#ifndef _PDCLIB_GLUE_H -#define _PDCLIB_GLUE_H -/* $Id$ */ - /* OS glue functions declaration <_PDCLIB_glue.h> This file is part of the Public Domain C Library (PDCLib). Permission is granted to use, modify, and / or redistribute at will. */ -#include <_PDCLIB_int.h> -_PDCLIB_BEGIN_EXTERN_C +#ifndef __PDCLIB_GLUE_H +#define __PDCLIB_GLUE_H __PDCLIB_GLUE_H + +#include "_PDCLIB_int.h" +#include "_PDCLIB_io.h" + +#include +#include + +#ifdef __cplusplus +extern "C" { +#endif /* -------------------------------------------------------------------------- */ /* OS "glue", part 2 */ @@ -23,50 +29,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; - -/* 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. -*/ -void * _PDCLIB_allocpages( int n ); - - -/* stdio.h */ +_PDCLIB_noreturn void _PDCLIB_Exit( int status ); -/* 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.) +/* A system call which allocates n pages of memory and returns a pointer to + them. On failure, returns NULL */ -_PDCLIB_fd_t _PDCLIB_open( char const * const filename, unsigned int mode ); +void * _PDCLIB_allocpages( 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 ); +/* 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 fills a stream's buffer. - Returns 0 on success, EOF on read error / EOF. - Sets stream EOF / error flags and errno appropriately on error. -*/ -int _PDCLIB_fillbuffer( 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 repositions within a file. Returns new offset on success, - -1 / errno 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) */ -_PDCLIB_int64_t _PDCLIB_seek( struct _PDCLIB_file_t * stream, _PDCLIB_int64_t offset, int whence ); +void * _PDCLIB_reallocpages( void* p, size_t on, size_t nn, bool mayMove); +#endif -/* 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 ); +/* stdio.h */ -/* A system call that removes a file identified by name. Return zero on success, - non-zero otherwise. -*/ -int _PDCLIB_remove( const char * filename ); +/* 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 renames a file from given old name to given new name. Return zero on success, non-zero otherwise. In case of failure, the file @@ -75,5 +69,8 @@ int _PDCLIB_remove( const char * filename ); */ int _PDCLIB_rename( const char * old, const char * newn); -_PDCLIB_END_EXTERN_C +#ifdef __cplusplus +} +#endif + #endif