src/msg/msg_io.c

   1 /* Copyright (c) 2004-2013. The SimGrid Team.
   2  * All rights reserved.                                                       */
   3
   4 /* This program is free software; you can redistribute it and/or modify it
   5  * under the terms of the license (GNU LGPL) which comes with this package.   */
   6
   7 #include "msg_private.h"
   8 #include "xbt/log.h"
   9
  10 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(msg_io, msg,
  11                                 "Logging specific to MSG (io)");
  12
  13 /** @addtogroup msg_file_management
  14  * \htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Files" --> \endhtmlonly
  15  * (#msg_file_t) and the functions for managing it.
  16  *
  17  *  \see #msg_file_t
  18  */
  19
  20 /********************************* File **************************************/
  21 void __MSG_file_get_info(msg_file_t fd){
  22   xbt_dynar_t info = simcall_file_get_info(fd->simdata->smx_file);
  23   fd->info->content_type = xbt_dynar_pop_as(info, char *);
  24   fd->info->storage_type = xbt_dynar_pop_as(info, char *);
  25   fd->info->storageId = xbt_dynar_pop_as(info, char *);
  26   fd->info->mount_point = xbt_dynar_pop_as(info, char *);
  27   fd->info->size = xbt_dynar_pop_as(info, size_t);
  28
  29   xbt_dynar_free_container(&info);
  30 }
  31
  32 /** \ingroup msg_file_management
  33  *
  34  * \brief Set the user data of a #msg_file_t.
  35  *
  36  * This functions checks whether some data has already been associated to \a file
  37    or not and attach \a data to \a file if it is possible.
  38  */
  39 msg_error_t MSG_file_set_data(msg_file_t fd, void *data)
  40 {
  41   SIMIX_file_set_data(fd->simdata->smx_file,data);
  42
  43   return MSG_OK;
  44 }
  45
  46 /** \ingroup msg_file_management
  47  *
  48  * \brief Return the user data of a #msg_file_t.
  49  *
  50  * This functions checks whether \a file is a valid pointer or not and return
  51    the user data associated to \a file if it is possible.
  52  */
  53 void *MSG_file_get_data(msg_file_t fd)
  54 {
  55   return SIMIX_file_get_data(fd->simdata->smx_file);
  56 }
  57
  58 /** \ingroup msg_file_management
  59  * \brief Display information related to a file descriptor
  60  *
  61  * \param fd is a the file descriptor
  62  */
  63
  64 void MSG_file_dump (msg_file_t fd){
  65 //   THROW_UNIMPLEMENTED;
  66   /* Update the cached information first */
  67   __MSG_file_get_info(fd);
  68   XBT_INFO("File Descriptor information:\n\t\tFull name: '%s'"
  69       "\n\t\tSize: %zu\n\t\tMount point: '%s'\n\t\tStorage Id: '%s'"
  70       "\n\t\tStorage Type: '%s'\n\t\tContent Type: '%s'",
  71       fd->fullname, fd->info->size, fd->info->mount_point, fd->info->storageId,
  72       fd->info->storage_type, fd->info->content_type);
  73 }
  74
  75 /** \ingroup msg_file_management
  76  * \brief Read a file
  77  *
  78  * \param size of the file to read
  79  * \param fd is a the file descriptor
  80  * \return the number of bytes successfully read
  81  */
  82 size_t MSG_file_read(size_t size, msg_file_t fd)
  83 {
  84   return simcall_file_read(size, fd->simdata->smx_file);
  85 }
  86
  87 /** \ingroup msg_file_management
  88  * \brief Write into a file
  89  *
  90  * \param size of the file to write
  91  * \param fd is a the file descriptor
  92  * \return the number of bytes successfully write
  93  */
  94 size_t MSG_file_write(size_t size, msg_file_t fd)
  95 {
  96   return simcall_file_write(size, fd->simdata->smx_file);
  97 }
  98
  99 /** \ingroup msg_file_management
 100  * \brief Opens the file whose name is the string pointed to by path
 101  *
 102  * \param mount is the mount point where find the file is located
 103  * \param fullname is the file location on the storage
 104  * \param data user data to attach to the file
 105  *
 106  * \return An #msg_file_t associated to the file
 107  */
 108 msg_file_t MSG_file_open(const char* mount, const char* fullname, void* data)
 109 {
 110   msg_file_t file = xbt_new(s_msg_file_t,1);
 111   file->fullname = xbt_strdup(fullname);
 112   file->simdata = xbt_new0(s_simdata_file_t,1);
 113   file->info = xbt_new0(s_file_info_t,1);
 114   file->simdata->smx_file = simcall_file_open(mount, fullname);
 115   SIMIX_file_set_data(file->simdata->smx_file, data);
 116   return file;
 117 }
 118
 119 /** \ingroup msg_file_management
 120  * \brief Close the file
 121  *
 122  * \param fd is the file to close
 123  * \return 0 on success or 1 on error
 124  */
 125 int MSG_file_close(msg_file_t fd)
 126 {
 127   int res = simcall_file_close(fd->simdata->smx_file);
 128   free(fd->fullname);
 129   xbt_free(fd->simdata);
 130   xbt_free(fd->info);
 131   xbt_free(fd);
 132   return res;
 133 }
 134
 135 /** \ingroup msg_file_management
 136  * \brief Unlink the file pointed by fd
 137  *
 138  * \param fd is the file descriptor (#msg_file_t)
 139  * \return 0 on success or 1 on error
 140  */
 141 int MSG_file_unlink(msg_file_t fd)
 142 {
 143   return simcall_file_unlink(fd->simdata->smx_file);
 144 }
 145
 146 /** \ingroup msg_file_management
 147  * \brief Return the size of a file
 148  *
 149  * \param fd is the file descriptor (#msg_file_t)
 150  * \return the size of the file (as a size_t)
 151  */
 152
 153 size_t MSG_file_get_size(msg_file_t fd){
 154   return simcall_file_get_size(fd->simdata->smx_file);
 155 }
 156
 157 /** \ingroup msg_file_management
 158  * \brief Search for file
 159  *
 160  * \param mount is the mount point where find the file is located
 161  * \param path the file regex to find
 162  * \return a xbt_dict_t of file where key is the name of file and the
 163  * value the msg_stat_t corresponding to the key
 164  */
 165 xbt_dict_t MSG_file_ls(const char *mount, const char *path)
 166 {
 167   xbt_assert(path,"You must set path");
 168   int size = strlen(path);
 169   if(size && path[size-1] != '/')
 170   {
 171     char *new_path = bprintf("%s/",path);
 172     XBT_DEBUG("Change '%s' for '%s'",path,new_path);
 173     xbt_dict_t dict = simcall_file_ls(mount, new_path);
 174     xbt_free(new_path);
 175     return dict;
 176   }
 177
 178   return simcall_file_ls(mount, path);
 179 }
 180
 181 /********************************* Storage **************************************/
 182
 183 /** @addtogroup msg_storage_management
 184  * \htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Storages" --> \endhtmlonly
 185  * (#msg_storage_t) and the functions for managing it.
 186  *
 187  */
 188
 189
 190 /* TODO: PV: to comment */
 191 msg_storage_t __MSG_storage_create(smx_storage_t storage)
 192 {
 193   const char *name = SIMIX_storage_get_name(storage);
 194   msg_storage_priv_t storage_private = xbt_new0(s_msg_storage_priv_t, 1);
 195   xbt_lib_set(storage_lib,name,MSG_STORAGE_LEVEL,storage_private);
 196   return xbt_lib_get_elm_or_null(storage_lib, name);
 197 }
 198
 199 /*
 200  * \brief Destroys a storage (internal call only)
 201  */
 202 void __MSG_storage_destroy(msg_storage_priv_t storage) {
 203
 204   free(storage);
 205 }
 206
 207 /** \ingroup msg_storage_management
 208  *
 209  * \brief Returns the name of the #msg_storage_t.
 210  *
 211  * This functions checks whether a storage is a valid pointer or not and return its name.
 212  */
 213 const char *MSG_storage_get_name(msg_storage_t storage) {
 214   xbt_assert((storage != NULL), "Invalid parameters");
 215   return SIMIX_storage_get_name(storage);
 216 }
 217
 218 /** \ingroup msg_storage_management
 219  * \brief Returns the free space size of a storage element
 220  * \param name the name of a storage
 221  * \return the free space size of the storage element (as a size_t)
 222  */
 223 size_t MSG_storage_get_free_size(const char* name){
 224   return simcall_storage_get_free_size(name);
 225 }
 226
 227 /** \ingroup msg_storage_management
 228  * \brief Returns the used space size of a storage element
 229  * \param name the name of a storage
 230  * \return the used space size of the storage element (as a size_t)
 231  */
 232 size_t MSG_storage_get_used_size(const char* name){
 233   return simcall_storage_get_used_size(name);
 234 }
 235
 236 /** \ingroup msg_storage_management
 237  * \brief Returns a xbt_dict_t consisting of the list of properties assigned to this storage
 238  * \param storage a storage
 239  * \return a dict containing the properties
 240  */
 241 xbt_dict_t MSG_storage_get_properties(msg_storage_t storage)
 242 {
 243   xbt_assert((storage != NULL), "Invalid parameters (storage is NULL)");
 244   return (simcall_storage_get_properties(storage));
 245 }
 246
 247 /** \ingroup msg_storage_management
 248  * \brief Change the value of a given storage property
 249  *
 250  * \param storage a storage
 251  * \param name a property name
 252  * \param value what to change the property to
 253  * \param free_ctn the freeing function to use to kill the value on need
 254  */
 255 void MSG_storage_set_property_value(msg_storage_t storage, const char *name, char *value,void_f_pvoid_t free_ctn) {
 256   xbt_dict_set(MSG_storage_get_properties(storage), name, value,free_ctn);
 257 }
 258
 259 /** \ingroup msg_storage_management
 260  * \brief Finds a msg_storage_t using its name.
 261  * \param name the name of a storage
 262  * \return the corresponding storage
 263  */
 264 msg_storage_t MSG_storage_get_by_name(const char *name)
 265 {
 266   return (msg_storage_t) xbt_lib_get_elm_or_null(storage_lib,name);
 267 }
 268
 269 /** \ingroup msg_storage_management
 270  * \brief Returns a dynar containing all the storage elements declared at a given point of time
 271  *
 272  */
 273 xbt_dynar_t MSG_storages_as_dynar(void) {
 274
 275   xbt_lib_cursor_t cursor;
 276   char *key;
 277   void **data;
 278   xbt_dynar_t res = xbt_dynar_new(sizeof(msg_storage_t),NULL);
 279
 280   xbt_lib_foreach(storage_lib, cursor, key, data) {
 281     if(routing_get_network_element_type(key) == MSG_STORAGE_LEVEL) {
 282       xbt_dictelm_t elm = xbt_dict_cursor_get_elm(cursor);
 283       xbt_dynar_push(res, &elm);
 284     }
 285   }
 286
 287   return res;
 288 }
 289
 290 /** \ingroup msg_storage_management
 291  *
 292  * \brief Set the user data of a #msg_storage_t.
 293  * This functions checks whether some data has already been associated to \a storage
 294    or not and attach \a data to \a storage if it is possible.
 295  */
 296 msg_error_t MSG_storage_set_data(msg_storage_t storage, void *data)
 297 {
 298   SIMIX_storage_set_data(storage,data);
 299
 300   return MSG_OK;
 301 }
 302
 303 /** \ingroup msg_host_management
 304  *
 305  * \brief Returns the user data of a #msg_storage_t.
 306  *
 307  * This functions checks whether \a storage is a valid pointer or not and returns
 308    the user data associated to \a storage if it is possible.
 309  */
 310 void *MSG_storage_get_data(msg_storage_t storage)
 311 {
 312   return SIMIX_storage_get_data(storage);
 313 }
 314
 315 /** \ingroup msg_storage_management
 316  *
 317  * \brief Returns the content (file list) of a #msg_storage_t.
 318  * \param storage a storage
 319  * \return The content of this storage element as a dict (full path file => size)
 320  */
 321 xbt_dict_t MSG_storage_get_content(msg_storage_t storage)
 322 {
 323   return SIMIX_storage_get_content(storage);
 324   //return (simcall_storage_get_properties(storage));
 325 }