doc/doxygen/deployment.doc

   1 /*! \page deployment Step 3: Deploy the simulation
   2
   3 \section dep_over Overview
   4
   5 When you want to simulate the behavior of your code with SimGrid, you need
   6 to tell SimGrid exactly what code (that you wrote) is supposed to be run by which host - so you need to assign
   7 processes/functions to hosts. The hosts in question here are the hosts of your platform model; see Section \ref platform for details on how to set one up.
   8
   9 This assignment of the form \c code -> \c host is what the deployment file is all about, which will
  10 be discussed briefly here.
  11
  12 \note
  13     You can bypass the deployment file by hardcoding it in your user code, at least when you're using
  14     MSG.
  15
  16 The deployment file looks just like a \ref platform "platform" file, except that in
  17 this case, only two different tags are used: \c process and \c argument, whereas
  18 the latter is just used to supply additional configuration options to the process; the
  19 order in which the \c argument tags are given is important and depends on the application.
  20
  21 ### The process tag ###
  22
  23 #### Attribute list ####
  24
  25
  26 \section process_tag Process
  27 There are optional attributes to the process tag, here is a list of all attributes of process:
  28
  29 | Attribute name  | Mandatory | Values                 | Description                                                                                                               |
  30 | --------------- | --------- | ---------------------- | -----------                                                                                                               |
  31 | host            | yes       | String                 | Describes which host will be used to run this process. The host must be defined in the platform file!                     |
  32 | process         | yes       | String                 | Name of a function that will be executed on this host. This is any function that was registered by #MSG_register_function |
  33 | start_time      | no        | int (Default: 0)       | The simulated time when this function will start to be computed.                                                          |
  34 | kill_time       | no        | int                    | The simulated time when this function will end to be computed. By default, it stops only when it's done.                  |
  35
  36 ### An example ###
  37
  38 A complete example including a \ref MSG_ext_ms_application "deployment file" can be found
  39 in the Section \ref MSG_ex_basics "MSG basics".
  40
  41
  42 */