X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/81cc1b311676270b4c3d8c49ad0c1bbf13486482..5241914dc00a0deafcecb82a2ed70e34fae1aada:/doc/doxygen/platform.doc diff --git a/doc/doxygen/platform.doc b/doc/doxygen/platform.doc index 0085a2d8ac..1101198e49 100644 --- a/doc/doxygen/platform.doc +++ b/doc/doxygen/platform.doc @@ -126,7 +126,7 @@ attributes. That also have a big impact on how many information you'll have to provide to help the simulator to route between the AS elements. routing possible values are Full, Floyd, Dijkstra, - DijkstraCache, none, RuleBased, Vivaldi, Cluster. For more + DijkstraCache, none, Vivaldi, Cluster. For more explanation about what to choose, take a look at the section devoted to it below. @@ -162,15 +162,16 @@ contain more than 1 core. Here are the attributes of a host : referring to it. \li power (mandatory):the peak number FLOPS the CPU can manage. Expressed in flop/s. -\li core: The number of core of this host. If set, the power - gives the power of one core. The specified computing power will be +\li core: The number of core of this host (by default, 1). If + you specify the amount of cores, the 'power' parameter is the power + of each core. + For example, if you specify that your host has 6 cores, it will be available to up to 6 sequential tasks without sharing. If more tasks are placed on this host, the resource will be shared - accordingly. For example, if you schedule 12 tasks on the host, - each will get half of the computing power. Please note that - although sound, this model were never scientifically assessed. + accordingly. For example, if you schedule 12 tasks on that host, + each will get half of the specified computing power. Please note + that although sound, this model were never scientifically assessed. Please keep this fact in mind when using it. - \li availability: specify if the percentage of power available. \li availability_file: Allow you to use a file as input. This file will contain availability traces for this computer. The @@ -770,12 +771,6 @@ DijsktraCache example : \subsubsection pf_rm_me Manually-entered route models \li Full: You have to enter all necessary routes manually -\li RuleBased: Rule-Based routing data; same as Full except you - can use regexp to express route. As SimGrid has to evaluate the - regexp, it's slower than Full, but requires less memory. Regexp - syntax is similar as pcre ones, - as this is the lib SimGrid use to do so. - Full example : \verbatim @@ -787,54 +782,6 @@ Full example : \endverbatim -RuleBased example : -\verbatim - - - - - - - - - - - - - - - - - - - - - - - - - - -\endverbatim - -The example upper contains $1src and $1dst. It's simply a reference to -string matching regexp enclosed by "()" within respectively src -and dst attributes. If they were more than 1 "()", then you -could refer to it as $2src, $3src and so on. - \subsubsection pf_rm_sf Simple/fast models \li none: No routing (Unless you know what you are doing, avoid @@ -914,7 +861,7 @@ a link_ctn is the tag that is used in order to reference a \subsubsection pf_asro ASroute ASroute tag purpose is to let people write manually their routes -between AS. It's usefull when you're in Full or Rule-based model. +between AS. It's useful when you're in Full model. ASroute attributes : \li src (mandatory): the source AS id. @@ -929,15 +876,6 @@ between AS. It's usefull when you're in Full or Rule-based model. will be the opposite of the one defined. Can be either YES or NO, default is YES. -Example of ASroute with RuleBased -\verbatim - - - -\endverbatim Example of ASroute with Full \verbatim @@ -968,8 +906,8 @@ between AS. It's usefull when you're in Full or Rule-based model. The principle is the same as ASroute : route contains list of links that are in the path between src and dst, except that it is for routes between a src that can be either host or \b router and a -dst that can be either host or \b router. Useful for Full and -RuleBased, as well as for the shortest-paths based models, where you +dst that can be either host or \b router. Useful for Full +as well as for the shortest-paths based models, where you have to give topological information. @@ -1398,9 +1336,6 @@ characteristics (lookup : time to resolve a route): Defines that there is no routes, so if you try to determine a route without constant network within this AS, SimGrid will raise an exception. -\li RuleBased: Rule-Based routing data (fast initialisation, - relatively slow lookup, moderate memory requirements, fully - expressive): uses regexp to define routes; \li Vivaldi: Vivaldi routing, so when you want to use coordinates \li Cluster: Cluster routing, specific to cluster tag, should not be used.