X-Git-Url: https://pd.if.org/git/?a=blobdiff_plain;f=internals%2F_PDCLIB_glue.h;h=96cedca1e66f0d4d6404eb20be7f61d506cc4011;hb=38c392a0b8812ee3d1a60b7bda4540a306484e7c;hp=f19e25071a7f8cb495bb88278b1559f8de692ade;hpb=d02f38605b53cdff5460cc6b9e1b2a80c3a2ba4c;p=pdclib

diff --git a/internals/_PDCLIB_glue.h b/internals/_PDCLIB_glue.h
index f19e250..96cedca 100644
--- a/internals/_PDCLIB_glue.h
+++ b/internals/_PDCLIB_glue.h
@@ -1,7 +1,5 @@
 /* $Id$ */
 
-/* Release $Name$ */
-
 /* OS glue functions declaration <_PDCLIB_glue.h>
 
    This file is part of the Public Domain C Library (PDCLib).
@@ -17,7 +15,7 @@
 /* OS "glue", part 2                                                          */
 /* These are the functions you will have to touch, as they are where PDCLib   */
 /* interfaces with the operating system.                                      */
-/* They operate on data types partially defined by _PDCLIB_config.h.          */
+/* Some operate on data types defined by _PDCLIB_config.h.                    */
 /* -------------------------------------------------------------------------- */
 
 /* A system call that terminates the calling process, returning a given status
@@ -32,23 +30,28 @@ void _PDCLIB_Exit( int status ) _PDCLIB_NORETURN;
 */
 void * _PDCLIB_allocpages( int n );
 
-/* A system call that opens a file identified by name in a given mode, and
-   returns a file descriptor uniquely identifying that file.
+/* 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, int mode );
+_PDCLIB_fd_t _PDCLIB_open( char const * const filename, unsigned int mode );
 
-/* A system call that writes n characters to a file identified by given file
-   descriptor. Return the number of characters written.
+/* A system call that writes up to n characters to a file identified by given
+   file descriptor. Return the number of characters actually written, or -1
+   if an error occured. Note that the number of characters may well be lower
+   than n without an error having occured.
 */
-_PDCLIB_size_t _PDCLIB_write( _PDCLIB_fd_t fd, char const * buffer, _PDCLIB_size_t n );
+int _PDCLIB_write( struct _PDCLIB_file_t * stream, char const * buffer, int n );
 
 /* A system call that reads n characters into a buffer, from a file identified
    by given file descriptor. Return the number of characters read.
 */
 _PDCLIB_size_t _PDCLIB_read( _PDCLIB_fd_t fd, char * buffer, _PDCLIB_size_t n );
 
-/* A system call that closes a file identified by given file descriptor. */
-void _PDCLIB_close( _PDCLIB_fd_t fd );
+/* 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 );
 
 /* A system call that removes a file identified by name. Return zero on success,
    non-zero otherwise.
@@ -60,3 +63,9 @@ int _PDCLIB_remove( const char * filename );
    must still be accessible by old name.
 */
 int _PDCLIB_rename( const char * old, const char * new );
+
+/* A system call that returns one if the given file descriptor refers to an
+   interactive device, and zero otherwise.
+ */
+int _PDCLIB_isinteractive( _PDCLIB_fd_t fd );
+