Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Merge branch 'master' of scm.gforge.inria.fr:/gitroot/simgrid/simgrid
authorMartin Quinson <martin.quinson@loria.fr>
Thu, 7 Dec 2017 14:09:43 +0000 (15:09 +0100)
committerMartin Quinson <martin.quinson@loria.fr>
Thu, 7 Dec 2017 14:09:43 +0000 (15:09 +0100)
examples/s4u/README.doc

index efcefaa..6ab9071 100644 (file)
@@ -167,17 +167,25 @@ also the tesh files in the example directories for details.
 @section s4u_ex_io Simulating disks and files
 
 The examples of this section demonstrate how to interact with the
-simulated storages.
+simulated storages. 
 
-  - <b>File Management</b>. @ref examples/s4u/io-file-system/s4u-io-file-system.cpp \n
-    This example illustrates the use of operations on files
-    (read, write, seek, tell, unlink, ...).
+SimGrid provides two levels of abstraction. You can either use the 
+FileSystem plugin, or interact directly with the disks. At the file
+system level, you can open files and interact with them. A write
+operation may fail if the disk is already full. Using the direct (low
+level) interface, you just specify the amount of data that is written
+or read, and this is done unconditionnally. Both levels have
+respective advantages, depending on what you want to model.
 
-  - <b>Access to raw storage devices </b>.
+  - <b>Access to raw storage devices</b>.
     @ref examples/s4u/io-storage-raw/s4u-io-storage-raw.cpp \n
     This example illustrates how to simply read and write data on a
     simulated storage resource.
 
+  - <b>File Management</b>. @ref examples/s4u/io-file-system/s4u-io-file-system.cpp \n
+    This example illustrates the use of operations on files
+    (read, write, seek, tell, unlink, ...).
+
   - <b>Remote I/O</b>. 
     @ref examples/s4u/io-file-remote/s4u-io-file-remote.cpp \n
     I/O operations on files can also be done in a remote fashion,