src/include/surf/surf.h

   1 /* Copyright (c) 2004-2017. The SimGrid Team. All rights reserved.          */
   2
   3 /* This program is free software; you can redistribute it and/or modify it
   4  * under the terms of the license (GNU LGPL) which comes with this package. */
   5
   6 #ifndef SURF_SURF_H
   7 #define SURF_SURF_H
   8
   9 #include "xbt/swag.h"
  10 #include "xbt/dynar.h"
  11 #include "xbt/dict.h"
  12 #include "xbt/graph.h"
  13 #include "xbt/misc.h"
  14 #include "xbt/config.h"
  15 #include "src/internal_config.h"
  16 #include "surf/surf_routing.h"
  17 #include "surf/datatypes.h"
  18 #include "xbt/lib.h"
  19 #include "surf/surf_routing.h"
  20 #include "simgrid/datatypes.h"
  21 #include "simgrid/forward.h"
  22
  23 SG_BEGIN_DECL()
  24 /* Actions and models are highly connected structures... */
  25
  26 /* user-visible parameters */
  27 extern XBT_PRIVATE double sg_tcp_gamma;
  28 extern XBT_PRIVATE double sg_sender_gap;
  29 extern XBT_PRIVATE double sg_latency_factor;
  30 extern XBT_PRIVATE double sg_bandwidth_factor;
  31 extern XBT_PRIVATE double sg_weight_S_parameter;
  32 extern XBT_PRIVATE int sg_network_crosstraffic;
  33 extern XBT_PRIVATE xbt_dynar_t surf_path;
  34
  35 #ifdef __cplusplus
  36
  37 namespace simgrid {
  38 namespace surf {
  39
  40 class Model;
  41 class CpuModel;
  42 class HostModel;
  43 class NetworkModel;
  44 class StorageModel;
  45 class Resource;
  46 class ResourceLmm;
  47 class HostCLM03;
  48 class NetworkCm02Link;
  49 class Action;
  50 class ActionLmm;
  51 class StorageActionLmm;
  52 }
  53 }
  54
  55 typedef simgrid::surf::Model surf_Model;
  56 typedef simgrid::surf::CpuModel surf_CpuModel;
  57 typedef simgrid::surf::Cpu surf_Cpu;
  58 typedef simgrid::surf::HostModel surf_HostModel;
  59 typedef simgrid::surf::NetworkModel surf_NetworkModel;
  60 typedef simgrid::surf::StorageModel surf_StorageModel;
  61 typedef simgrid::surf::Resource surf_Resource;
  62 typedef simgrid::surf::ResourceLmm surf_ResourceLmm;
  63 typedef simgrid::surf::HostImpl surf_Host;
  64 typedef simgrid::surf::HostCLM03 surf_HostCLM03;
  65 typedef simgrid::surf::NetworkCm02Link surf_NetworkCm02Link;
  66 typedef simgrid::surf::Action surf_Action;
  67 typedef simgrid::surf::ActionLmm surf_ActionLmm;
  68 typedef simgrid::surf::StorageActionLmm surf_StorageActionLmm;
  69
  70 #else
  71
  72 typedef struct surf_Model surf_Model;
  73 typedef struct surf_CpuModel surf_CpuModel;
  74 typedef struct surf_Cpu surf_Cpu;
  75 typedef struct surf_HostModel surf_HostModel;
  76 typedef struct surf_NetworkModel surf_NetworkModel;
  77 typedef struct surf_StorageModel surf_StorageModel;
  78 typedef struct surf_Resource surf_Resource;
  79 typedef struct surf_ResourceLmm surf_ResourceLmm;
  80 typedef struct surf_HostCLM03 surf_HostCLM03;
  81 typedef struct surf_Host surf_Host;
  82 typedef struct surf_NetworkCm02Link surf_NetworkCm02Link;
  83 typedef struct surf_Action surf_Action;
  84 typedef struct surf_ActionLmm surf_ActionLmm;
  85 typedef struct surf_StorageActionLmm surf_StorageActionLmm;
  86
  87 #endif
  88
  89 /** @ingroup SURF_c_bindings
  90  *  \brief Model datatype
  91  *
  92  *  Generic data structure for a model. The hosts,
  93  *  the CPUs and the network links are examples of models.
  94  */
  95 typedef surf_Model *surf_model_t;
  96 typedef surf_CpuModel *surf_cpu_model_t;
  97 typedef surf_Cpu* surf_cpu_t;
  98 typedef surf_HostModel *surf_host_model_t;
  99 typedef surf_NetworkModel *surf_network_model_t;
 100 typedef surf_StorageModel *surf_storage_model_t;
 101
 102 typedef xbt_dictelm_t surf_resource_t;
 103 typedef surf_Resource *surf_cpp_resource_t;
 104 typedef surf_Host *surf_host_t;
 105 typedef surf_Cpu *surf_cpu_t;
 106
 107 /** @ingroup SURF_c_bindings
 108  *  \brief Action structure
 109  *
 110  *  Never create s_surf_action_t by yourself ! The actions are created
 111  *  on the fly when you call execute or communicate on a model.
 112  *
 113  *  \see e_surf_action_state_t
 114  */
 115 typedef surf_Action *surf_action_t;
 116
 117 typedef struct surf_file *surf_file_t;
 118
 119 /** \brief Resource model description
 120  */
 121 struct surf_model_description {
 122   const char *name;
 123   const char *description;
 124   void_f_void_t model_init_preparse;
 125 };
 126 typedef struct surf_model_description  s_surf_model_description_t;
 127 typedef struct surf_model_description* surf_model_description_t;
 128
 129 XBT_PUBLIC(int) find_model_description(s_surf_model_description_t * table, const char *name);
 130 XBT_PUBLIC(void) model_help(const char *category, s_surf_model_description_t * table);
 131
 132 /***************************/
 133 /* Generic model object */
 134 /***************************/
 135
 136 static inline void *surf_storage_resource_priv(const void *storage){
 137   return (void*)xbt_lib_get_level((xbt_dictelm_t)storage, SURF_STORAGE_LEVEL);
 138 }
 139
 140 static inline void *surf_storage_resource_by_name(const char *name){
 141   return xbt_lib_get_elm_or_null(storage_lib, name);
 142 }
 143
 144 /** @{ @ingroup SURF_c_bindings */
 145
 146 /**
 147  * @brief Pop an action from the done actions set
 148  *
 149  * @param model The model from which the action is extracted
 150  * @return An action in done state
 151  */
 152 XBT_PUBLIC(surf_action_t) surf_model_extract_done_action_set(surf_model_t model);
 153
 154 /**
 155  * @brief Pop an action from the failed actions set
 156  *
 157  * @param model The model from which the action is extracted
 158  * @return An action in failed state
 159  */
 160 XBT_PUBLIC(surf_action_t) surf_model_extract_failed_action_set(surf_model_t model);
 161
 162 /**
 163  * @brief Get the size of the running action set of a model
 164  *
 165  * @param model The model
 166  * @return The size of the running action set
 167  */
 168 XBT_PUBLIC(int) surf_model_running_action_set_size(surf_model_t model);
 169
 170 /** @brief Create a file opening action on the given host */
 171 XBT_PUBLIC(surf_action_t) surf_host_open(sg_host_t host, const char* fullpath);
 172
 173 /** @brief Create a file closing action on the given host */
 174 XBT_PUBLIC(surf_action_t) surf_host_close(sg_host_t host, surf_file_t fd);
 175
 176 /** @brief Create a file reading action on the given host */
 177 XBT_PUBLIC(surf_action_t) surf_host_read(sg_host_t host, surf_file_t fd, sg_size_t size);
 178
 179 /** @brief Create a file writing action on the given host  */
 180 XBT_PUBLIC(surf_action_t) surf_host_write(sg_host_t host, surf_file_t fd, sg_size_t size);
 181
 182 /**
 183  * @brief Get the information of a file descriptor
 184  * @details The returned xbt_dynar_t contains:
 185  *  - the size of the file,
 186  *  - the mount point,
 187  *  - the storage name,
 188  *  - the storage typeId,
 189  *  - the storage content type
 190  *
 191  * @param host The surf host
 192  * @param fd The file descriptor
 193  * @return An xbt_dynar_t with the file information
 194  */
 195 XBT_PUBLIC(xbt_dynar_t) surf_host_get_info(sg_host_t host, surf_file_t fd);
 196
 197 /**
 198  * @brief Get the available space of the storage at the mount point
 199  *
 200  * @param resource The surf host
 201  * @param name The mount point
 202  * @return The amount of available space in bytes
 203  */
 204 XBT_PUBLIC(sg_size_t) surf_host_get_free_size(sg_host_t resource, const char* name);
 205
 206 /**
 207  * @brief Get the used space of the storage at the mount point
 208  *
 209  * @param resource The surf host
 210  * @param name The mount point
 211  * @return The amount of used space in bytes
 212  */
 213 XBT_PUBLIC(sg_size_t) surf_host_get_used_size(sg_host_t resource, const char* name);
 214
 215 /**
 216  * @brief Unlink a file descriptor
 217  *
 218  * @param host The surf host
 219  * @param fd The file descriptor
 220  *
 221  * @return 0 if failed to unlink, 1 otherwise
 222  */
 223 XBT_PUBLIC(int) surf_host_unlink(sg_host_t host, surf_file_t fd);
 224
 225 /**
 226  * @brief Get the size of a file on a host
 227  *
 228  * @param host The surf host
 229  * @param fd The file descriptor
 230  *
 231  * @return The size in bytes of the file
 232  */
 233 XBT_PUBLIC(size_t) surf_host_get_size(sg_host_t host, surf_file_t fd);
 234
 235 /**
 236  * @brief Get the current position of the file descriptor
 237  *
 238  * @param host The surf host
 239  * @param fd The file descriptor
 240  * @return The current position of the file descriptor
 241  */
 242 XBT_PUBLIC(size_t) surf_host_file_tell(sg_host_t host, surf_file_t fd);
 243
 244 /**
 245  * @brief Move a file to another location on the *same mount point*.
 246  * @details [long description]
 247  *
 248  * @param host The surf host
 249  * @param fd The file descriptor
 250  * @param fullpath The new full path
 251  *
 252  * @return MSG_OK if successful, otherwise MSG_TASK_CANCELED
 253  */
 254 XBT_PUBLIC(int) surf_host_file_move(sg_host_t host, surf_file_t fd, const char* fullpath);
 255
 256 /**
 257  * @brief Set the position indictator assiociated with the file descriptor to a new position
 258  * @details [long description]
 259  *
 260  * @param host The surf host
 261  * @param fd The file descriptor
 262  * @param offset The offset from the origin
 263  * @param origin Position used as a reference for the offset
 264  *  - SEEK_SET: beginning of the file
 265  *  - SEEK_CUR: current position indicator
 266  *  - SEEK_END: end of the file
 267  * @return MSG_OK if successful, otherwise MSG_TASK_CANCELED
 268  */
 269 XBT_PUBLIC(int) surf_host_file_seek(sg_host_t host, surf_file_t fd, sg_offset_t offset, int origin);
 270
 271 /**
 272  * @brief Get the content of a storage
 273  *
 274  * @param resource The surf storage
 275  * @return A xbt_dict_t with path as keys and size in bytes as values
 276  */
 277 XBT_PUBLIC(xbt_dict_t) surf_storage_get_content(surf_resource_t resource);
 278
 279 /**
 280  * @brief Get the size in bytes of a storage
 281  *
 282  * @param resource The surf storage
 283  * @return The size in bytes of the storage
 284  */
 285 XBT_PUBLIC(sg_size_t) surf_storage_get_size(surf_resource_t resource);
 286
 287 /**
 288  * @brief Get the available size in bytes of a storage
 289  *
 290  * @param resource The surf storage
 291  * @return The available size in bytes of the storage
 292  */
 293 XBT_PUBLIC(sg_size_t) surf_storage_get_free_size(surf_resource_t resource);
 294
 295 /**
 296  * @brief Get the size in bytes of a storage
 297  *
 298  * @param resource The surf storage
 299  * @return The used size in bytes of the storage
 300  */
 301 XBT_PUBLIC(sg_size_t) surf_storage_get_used_size(surf_resource_t resource);
 302
 303 /** @brief return the properties set associated to that storage */
 304 XBT_PUBLIC(xbt_dict_t) surf_storage_get_properties(surf_resource_t resource);
 305
 306 /**
 307  * @brief [brief description]
 308  * @details [long description]
 309  *
 310  * @param action The surf cpu action
 311  * @param bound [description]
 312  */
 313 XBT_PUBLIC(void) surf_cpu_action_set_bound(surf_action_t action, double bound);
 314
 315 /**
 316  * @brief [brief description]
 317  * @details [long description]
 318  *
 319  * @param action The surf network action
 320  */
 321 XBT_PUBLIC(double) surf_network_action_get_latency_limited(surf_action_t action);
 322
 323 /**
 324  * @brief Get the file associated to a storage action
 325  *
 326  * @param action The surf storage action
 327  * @return The file associated to a storage action
 328  */
 329 XBT_PUBLIC(surf_file_t) surf_storage_action_get_file(surf_action_t action);
 330
 331 /**
 332  * @brief Get the result dictionary of an ls action
 333  *
 334  * @param action The surf storage action
 335  * @return The dictionry listing a path
 336  */
 337 XBT_PUBLIC(xbt_dict_t) surf_storage_action_get_ls_dict(surf_action_t action);
 338
 339
 340 /**
 341  * @brief Get the host the storage is attached to
 342  *
 343  * @param resource The surf storage
 344  * @return The host name
 345  * may not exist.
 346  */
 347 XBT_PUBLIC(const char * ) surf_storage_get_host(surf_resource_t resource);
 348
 349 /** @} */
 350
 351 /**************************************/
 352 /* Implementations of model object */
 353 /**************************************/
 354
 355 /** \ingroup SURF_models
 356  *  \brief The CPU model object for the physical machine layer
 357  */
 358 XBT_PUBLIC_DATA(surf_cpu_model_t) surf_cpu_model_pm;
 359
 360 /** \ingroup SURF_models
 361  *  \brief The CPU model object for the virtual machine layer
 362  */
 363 XBT_PUBLIC_DATA(surf_cpu_model_t) surf_cpu_model_vm;
 364
 365
 366 /** \ingroup SURF_models
 367  *  \brief Initializes the CPU model with the model Cas01
 368  *
 369  *  By default, this model uses the lazy optimization mechanism that relies on partial invalidation in LMM and a heap
 370  *  for lazy action update.
 371  *  You can change this behavior by setting the cpu/optim configuration variable to a different value.
 372  *
 373  *  You shouldn't have to call it by yourself.
 374  */
 375 XBT_PUBLIC(void) surf_cpu_model_init_Cas01();
 376
 377 /** \ingroup SURF_models
 378  *  \brief Initializes the CPU model with trace integration [Deprecated]
 379  *
 380  *  You shouldn't have to call it by yourself.
 381  */
 382 XBT_PUBLIC(void) surf_cpu_model_init_ti();
 383
 384 /** \ingroup SURF_models
 385  *  \brief The list of all available optimization modes (both for cpu and networks).
 386  *  These optimization modes can be set using --cfg=cpu/optim:... and --cfg=network/optim:...
 387  */
 388 XBT_PUBLIC_DATA(s_surf_model_description_t) surf_optimization_mode_description[];
 389
 390 /** \ingroup SURF_plugins
 391  *  \brief The list of all available surf plugins
 392  */
 393 XBT_PUBLIC_DATA(s_surf_model_description_t) surf_plugin_description[];
 394
 395 /** \ingroup SURF_models
 396  *  \brief The list of all available cpu model models
 397  */
 398 XBT_PUBLIC_DATA(s_surf_model_description_t) surf_cpu_model_description[];
 399
 400 /** \ingroup SURF_models
 401  *  \brief The network model
 402  *
 403  *  When creating a new API on top on SURF, you shouldn't use the network model unless you know what you are doing.
 404  *  Only the host model should be accessed because depending on the platform model, the network model can be NULL.
 405  */
 406 XBT_PUBLIC_DATA(surf_network_model_t) surf_network_model;
 407
 408 /** \ingroup SURF_models
 409  *  \brief Same as network model 'LagrangeVelho', only with different correction factors.
 410  *
 411  * This model is proposed by Pierre-Nicolas Clauss and Martin Quinson and Stéphane Génaud based on the model 'LV08' and
 412  * different correction factors depending on the communication size (< 1KiB, < 64KiB, >= 64KiB).
 413  * See comments in the code for more information.
 414  *
 415  *  \see surf_host_model_init_SMPI()
 416  */
 417 XBT_PUBLIC(void) surf_network_model_init_SMPI();
 418
 419 /** \ingroup SURF_models
 420  *  \brief Same as network model 'LagrangeVelho', only with different correction factors.
 421  *
 422  * This model impelments a variant of the contention model on Infinband networks based on
 423  * the works of Jérôme Vienne : http://mescal.imag.fr/membres/jean-marc.vincent/index.html/PhD/Vienne.pdf
 424  *
 425  *  \see surf_host_model_init_IB()
 426  */
 427 XBT_PUBLIC(void) surf_network_model_init_IB();
 428
 429 /** \ingroup SURF_models
 430  *  \brief Initializes the platform with the network model 'LegrandVelho'
 431  *
 432  * This model is proposed by Arnaud Legrand and Pedro Velho based on the results obtained with the GTNets simulator for
 433  * onelink and dogbone sharing scenarios. See comments in the code for more information.
 434  *
 435  *  \see surf_host_model_init_LegrandVelho()
 436  */
 437 XBT_PUBLIC(void) surf_network_model_init_LegrandVelho();
 438
 439 /** \ingroup SURF_models
 440  *  \brief Initializes the platform with the network model 'Constant'
 441  *
 442  *  In this model, the communication time between two network cards is constant, hence no need for a routing table.
 443  *  This is particularly useful when simulating huge distributed algorithms where scalability is really an issue. This
 444  *  function is called in conjunction with surf_host_model_init_compound.
 445  *
 446  *  \see surf_host_model_init_compound()
 447  */
 448 XBT_PUBLIC(void) surf_network_model_init_Constant();
 449
 450 /** \ingroup SURF_models
 451  *  \brief Initializes the platform with the network model CM02
 452  *
 453  *  You sould call this function by yourself only if you plan using surf_host_model_init_compound.
 454  *  See comments in the code for more information.
 455  */
 456 XBT_PUBLIC(void) surf_network_model_init_CM02();
 457
 458 /** \ingroup SURF_models
 459  *  \brief Initializes the platform with the network model NS3
 460  *
 461  *  This function is called by surf_host_model_init_NS3 or by yourself only if you plan using
 462  *  surf_host_model_init_compound
 463  *
 464  *  \see surf_host_model_init_NS3()
 465  */
 466 XBT_PUBLIC(void) surf_network_model_init_NS3();
 467
 468 /** \ingroup SURF_models
 469  *  \brief Initializes the platform with the network model Reno
 470  *
 471  *  The problem is related to max( sum( arctan(C * Df * xi) ) ).
 472  *
 473  *  Reference:
 474  *  [LOW03] S. H. Low. A duality model of TCP and queue management algorithms.
 475  *  IEEE/ACM Transaction on Networking, 11(4):525-536, 2003.
 476  *
 477  *  Call this function only if you plan using surf_host_model_init_compound.
 478  */
 479 XBT_PUBLIC(void) surf_network_model_init_Reno();
 480
 481 /** \ingroup SURF_models
 482  *  \brief Initializes the platform with the network model Reno2
 483  *
 484  *  The problem is related to max( sum( arctan(C * Df * xi) ) ).
 485  *
 486  *  Reference:
 487  *  [LOW01] S. H. Low. A duality model of TCP and queue management algorithms.
 488  *  IEEE/ACM Transaction on Networking, 11(4):525-536, 2003.
 489  *
 490  *  Call this function only if you plan using surf_host_model_init_compound.
 491  */
 492 XBT_PUBLIC(void) surf_network_model_init_Reno2();
 493
 494 /** \ingroup SURF_models
 495  *  \brief Initializes the platform with the network model Vegas
 496  *
 497  *  This problem is related to max( sum( a * Df * ln(xi) ) ) which is equivalent  to the proportional fairness.
 498  *
 499  *  Reference:
 500  *  [LOW03] S. H. Low. A duality model of TCP and queue management algorithms.
 501  *  IEEE/ACM Transaction on Networking, 11(4):525-536, 2003.
 502  *
 503  *  Call this function only if you plan using surf_host_model_init_compound.
 504  */
 505 XBT_PUBLIC(void) surf_network_model_init_Vegas();
 506
 507 /** \ingroup SURF_models
 508  *  \brief The list of all available network model models
 509  */
 510 XBT_PUBLIC_DATA(s_surf_model_description_t) surf_network_model_description[];
 511
 512 /** \ingroup SURF_models
 513  *  \brief The storage model
 514  */
 515 XBT_PUBLIC(void) surf_storage_model_init_default();
 516
 517 /** \ingroup SURF_models
 518  *  \brief The list of all available storage modes.
 519  *  This storage mode can be set using --cfg=storage/model:...
 520  */
 521 XBT_PUBLIC_DATA(s_surf_model_description_t) surf_storage_model_description[];
 522
 523 XBT_PUBLIC_DATA(surf_storage_model_t) surf_storage_model;
 524
 525 /** \ingroup SURF_models
 526  *  \brief The host model
 527  *
 528  *  Note that when you create an API on top of SURF, the host model should be the only one you use
 529  *  because depending on the platform model, the network model and the CPU model may not exist.
 530  */
 531 XBT_PUBLIC_DATA(surf_host_model_t) surf_host_model;
 532
 533 /** \ingroup SURF_models
 534  *  \brief Initializes the platform with a compound host model
 535  *
 536  *  This function should be called after a cpu_model and a network_model have been set up.
 537  */
 538 XBT_PUBLIC(void) surf_host_model_init_compound();
 539
 540 /** \ingroup SURF_models
 541  *  \brief Initializes the platform with the current best network and cpu models at hand
 542  *
 543  *  This platform model separates the host model and the network model.
 544  *  The host model will be initialized with the model compound, the network model with the model LV08 (with cross
 545  *  traffic support) and the CPU model with the model Cas01.
 546  *  Such model is subject to modification with warning in the ChangeLog so monitor it!
 547  */
 548 XBT_PUBLIC(void) surf_host_model_init_current_default();
 549
 550 /** \ingroup SURF_models
 551  *  \brief Initializes the platform with the model L07
 552  *
 553  *  With this model, only parallel tasks can be used. Resource sharing is done by identifying bottlenecks and giving an
 554  *  equal share of the model to each action.
 555  */
 556 XBT_PUBLIC(void) surf_host_model_init_ptask_L07();
 557
 558 /** \ingroup SURF_models
 559  *  \brief The list of all available host model models
 560  */
 561 XBT_PUBLIC_DATA(s_surf_model_description_t) surf_host_model_description[];
 562
 563 /** \ingroup SURF_models
 564  *  \brief Initializes the platform with the current best network and cpu models at hand
 565  *
 566  *  This platform model seperates the host model and the network model.
 567  *  The host model will be initialized with the model compound, the network model with the model LV08 (with cross
 568  *  traffic support) and the CPU model with the model Cas01.
 569  *  Such model is subject to modification with warning in the ChangeLog so monitor it!
 570  */
 571 XBT_PUBLIC(void) surf_vm_model_init_HL13();
 572
 573 /** \ingroup SURF_simulation
 574  *  \brief List of hosts for which one want to be notified if they ever restart.
 575  */
 576 XBT_PUBLIC_DATA(xbt_dict_t) watched_hosts_lib;
 577
 578 /*** SURF Globals **************************/
 579
 580 /** \ingroup SURF_simulation
 581  *  \brief Initialize SURF
 582  *  \param argc argument number
 583  *  \param argv arguments
 584  *
 585  *  This function has to be called to initialize the common structures. Then you will have to create the environment by
 586  *  calling  e.g. surf_host_model_init_CM02()
 587  *
 588  *  \see surf_host_model_init_CM02(), surf_host_model_init_compound(), surf_exit()
 589  */
 590 XBT_PUBLIC(void) surf_init(int *argc, char **argv);     /* initialize common structures */
 591
 592 /** \ingroup SURF_simulation
 593  *  \brief Finish simulation initialization
 594  *
 595  *  This function must be called before the first call to surf_solve()
 596  */
 597 XBT_PUBLIC(void) surf_presolve();
 598
 599 /** \ingroup SURF_simulation
 600  *  \brief Performs a part of the simulation
 601  *  \param max_date Maximum date to update the simulation to, or -1
 602  *  \return the elapsed time, or -1.0 if no event could be executed
 603  *
 604  *  This function execute all possible events, update the action states  and returns the time elapsed.
 605  *  When you call execute or communicate on a model, the corresponding actions are not executed immediately but only
 606  *  when you call surf_solve.
 607  *  Note that the returned elapsed time can be zero.
 608  */
 609 XBT_PUBLIC(double) surf_solve(double max_date);
 610
 611 /** \ingroup SURF_simulation
 612  *  \brief Return the current time
 613  *
 614  *  Return the current time in millisecond.
 615  */
 616 XBT_PUBLIC(double) surf_get_clock();
 617
 618 /** \ingroup SURF_simulation
 619  *  \brief Exit SURF
 620  *
 621  *  Clean everything.
 622  *
 623  *  \see surf_init()
 624  */
 625 XBT_PUBLIC(void) surf_exit();
 626
 627 /* Prototypes of the functions that handle the properties */
 628 XBT_PUBLIC_DATA(xbt_dict_t) current_property_set;// the prop set for the currently parsed element (also used in SIMIX)
 629 /* The same for model_prop set*/
 630 XBT_PUBLIC_DATA(xbt_dict_t) current_model_property_set;
 631
 632 /* surf parse file related (public because called from a test suite) */
 633 XBT_PUBLIC(void) parse_platform_file(const char *file);
 634
 635 /* For the trace and trace:connect tag (store their content till the end of the parsing) */
 636 XBT_PUBLIC_DATA(xbt_dict_t) traces_set_list;
 637
 638 /*
 639  * Returns the initial path. On Windows the initial path is the current directory for the current process in the other
 640  * case the function returns "./" that represents the current directory on Unix/Linux platforms.
 641  */
 642 const char *__surf_get_initial_path();
 643
 644 /********** Tracing **********/
 645 /* from surf_instr.c */
 646 void TRACE_surf_action(surf_action_t surf_action, const char *category);
 647 void TRACE_surf_alloc();
 648 void TRACE_surf_release();
 649
 650 /* instr_routing.c */
 651 void instr_routing_define_callbacks ();
 652 void instr_new_variable_type (const char *new_typename, const char *color);
 653 void instr_new_user_variable_type  (const char *father_type, const char *new_typename, const char *color);
 654 void instr_new_user_state_type (const char *father_type, const char *new_typename);
 655 void instr_new_value_for_user_state_type (const char *_typename, const char *value, const char *color);
 656 int instr_platform_traced ();
 657 xbt_graph_t instr_routing_platform_graph ();
 658 void instr_routing_platform_graph_export_graphviz (xbt_graph_t g, const char *filename);
 659
 660 SG_END_DECL()
 661 #endif /* SURF_SURF_H */