X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/47ac9cef9d5cf9ccf4739355db1e0bb3d90dda33..599347b970dec2ad471021b8eecca62e8f0854e9:/src/msg/msg_io.c

diff --git a/src/msg/msg_io.c b/src/msg/msg_io.c
index 0ab1ee1cb9..c00fb8560d 100644
--- a/src/msg/msg_io.c
+++ b/src/msg/msg_io.c
@@ -6,29 +6,88 @@
 
 #include "msg_private.h"
 
-// FILE
+/** @addtogroup m_file_management
+ *     \htmlonly <!-- DOXYGEN_NAVBAR_LABEL="File" --> \endhtmlonly
+ * (#m_file_t) and the functions for managing it.
+ *
+ *  \see #m_file_t
+ */
 
-size_t MSG_file_read(void* ptr, size_t size, size_t nmemb,  m_file_t stream)
+/********************************* File **************************************/
+
+/** \ingroup m_file_management
+ * \brief Read elements of a file
+ *
+ * \param storage is the name where find the stream
+ * \param ptr buffer to where the data is copied
+ * \param size of each element
+ * \param nmemb is the number of elements of data to read
+ * \param stream to read
+ * \return the number of items successfully read
+ */
+size_t MSG_file_read(const char* storage, void* ptr, size_t size, size_t nmemb,  m_file_t stream)
 {
-  return simcall_file_read(ptr, size, nmemb, (smx_file_t)stream);
+  return simcall_file_read(storage, ptr, size, nmemb, (m_file_t)stream);
 }
 
-size_t MSG_file_write(const void* ptr, size_t size, size_t nmemb, m_file_t stream)
+/** \ingroup m_file_management
+ * \brief Write elements into a file
+ *
+ * \param storage is the name where find the stream
+ * \param ptr buffer from where the data is copied
+ * \param size of each element
+ * \param nmemb is the number of elements of data to write
+ * \param stream to write
+ * \return the number of items successfully write
+ */
+size_t MSG_file_write(const char* storage, const void* ptr, size_t size, size_t nmemb, m_file_t stream)
 {
-  return simcall_file_write(ptr, size, nmemb, (smx_file_t)stream);
+  return simcall_file_write(storage, ptr, size, nmemb, (m_file_t)stream);
 }
 
-m_file_t MSG_file_open(const char* path, const char* mode)
+/** \ingroup m_file_management
+ * \brief Opens the file whose name is the string pointed to by path
+ *
+ * \param storage is the name where find the file to open
+ * \param path is the file location on the storage
+ * \param mode points to a string beginning with one of the following sequences (Additional characters may follow these sequences.):
+ *      r      Open text file for reading.  The stream is positioned at the beginning of the file.
+ *      r+     Open for reading and writing.  The stream is positioned at the beginning of the file.
+ *      w      Truncate file to zero length or create text file for writing.  The stream is positioned at the beginning of the file.
+ *      w+     Open for reading and writing.  The file is created if it does not exist, otherwise it is truncated.  The stream is positioned at the begin‐
+ *             ning of the file.
+ *      a      Open for appending (writing at end of file).  The file is created if it does not exist.  The stream is positioned at the end of the file.
+ *      a+     Open for reading and appending (writing at end of file).  The file is created if it does not exist.  The initial file position for  reading
+ *             is at the beginning of the file, but output is always appended to the end of the file.
+ *
+ * \return An #m_file_t associated to the file
+ */
+m_file_t MSG_file_open(const char* storage, const char* path, const char* mode)
 {
-  return (m_file_t) simcall_file_open(path, mode);
+  return (m_file_t) simcall_file_open(storage, path, mode);
 }
 
-int MSG_file_close(m_file_t fp)
+/** \ingroup m_file_management
+ * \brief Close the file
+ *
+ * \param storage is the name where find the stream
+ * \param fp is the file to close
+ * \return 0 on success or 1 on error
+ */
+int MSG_file_close(const char* storage, m_file_t fp)
 {
-  return simcall_file_close((smx_file_t)fp);
+  return simcall_file_close(storage, (m_file_t)fp);
 }
 
-int MSG_file_stat(int fd, void* buf)
+/** \ingroup m_file_management
+ * \brief Stats the file pointed by fd
+ *
+ * \param storage is the name where find the stream
+ * \param fd is the file descriptor
+ * \param buf is the return structure with informations
+ * \return 0 on success or 1 on error
+ */
+int MSG_file_stat(const char* storage, int fd, void* buf)
 {
-  return simcall_file_stat(fd, buf);
+  return simcall_file_stat(storage, fd, buf);
 }