Changes between Version 144 and Version 145 of library_stdio

Timestamp:

Jan 1, 2016, 2:48:33 PM (8 years ago)

Author:

alain

Comment:

--

library_stdio

@@ -364 +364 @@
 Returns a negative value if error.
 
+=== 15) '''void* giet_fat_mmap'''( void* vaddr , unsigned int  length , unsigned int  prot , unsigned int  flags , unsigned int  fd_id , unsigned int  offset ) ===
+This function has the same semantic as the UNIX <mmap()> function.
+It allocates as many small pages (4 Kbytes) as defined by the <length> argument, from the MMAP vseg of the calling vspace.
+It maps all these pages directly to the file_cache as defined by the  <fd_id> and offset arguments.
+Both <length> and <offset> are bytes numbers.
+The supported values for the <prot> argument are : MAP_PROT_READ / MAP_PROT_WRITE / MAP_PROT_EXEC (can be ored).
+It has the following limitations:
+ * it does not support the MAP_PRIVATE flag : all write are seen by all threads.
+ * it does not support the MAP_FIXED flag : the <vaddr> argument is not used.
+ * it does not support the MAP_ANONYMOUS flog : only file mapping.
+ * The only supported value for the <flags> argument is MAP_SHARED.
+ * The <length> and <offset> arguments must be multiple of 4 Kbytes.
+
+Returns a pointer on the allocated buffer in user space (from the MMAP space).
+Returns NULL in case of error (illegal arguments).
+
+=== 16) '''int giet_fat_munmap'''( void* vaddr , unsigned int  length ) ===
+This function has the same semantic as the UNIX <munmap()> function.
+It desallocates as many small pages (4 Kbytes) as defined by the <vaddr> and <length> arguments from the MMAP vseg of the calling space.
+The dirty pages will be written on disk when the mapped file is closed.
+It has the following limitations: 
+ * The <vaddr> argument must be in the MMAP vseg.
+ * The <length> argument must be multiple of 4 Kbytes.
+
+Returns 0 in case of success.
+Returns -1 in case of error (illegal arguments).
+ 
  == __Network related system call__ ==