src/msg/deployment.c

   1 /*     $Id$      */
   2
   3 /* Copyright (c) 2002-2007 Arnaud Legrand.                                  */
   4 /* Copyright (c) 2007 Bruno Donassolo.                                      */
   5 /* All rights reserved.                                                     */
   6
   7 /* This program is free software; you can redistribute it and/or modify it
   8  * under the terms of the license (GNU LGPL) which comes with this package. */
   9
  10 #include "msg/private.h"
  11 #include "xbt/sysdep.h"
  12 #include "xbt/log.h"
  13
  14
  15 /** \ingroup msg_easier_life
  16  * \brief An application deployer.
  17  *
  18  * Creates the process described in \a file.
  19  * \param file a filename of a xml description of the application. This file
  20  * follows this DTD :
  21  *
  22  *     \include surfxml.dtd
  23  *
  24  * Here is a small example of such a platform
  25  *
  26  *     \include small_deployment.xml
  27  *
  28  * Have a look in the directory examples/msg/ to have a bigger example.
  29  */
  30 void MSG_launch_application(const char *file)
  31 {
  32
  33   xbt_assert0(msg_global,
  34               "MSG_global_init_args has to be called before MSG_launch_application.");
  35   SIMIX_function_register_process_create(_MSG_process_create_from_SIMIX);
  36   SIMIX_function_register_process_cleanup(__MSG_process_cleanup);
  37   SIMIX_function_register_process_kill(_MSG_process_kill_from_SIMIX);
  38
  39   SIMIX_launch_application(file);
  40
  41   return;
  42 }
  43
  44 /** \ingroup msg_easier_life
  45  * \brief Registers the main function of an agent in a global table.
  46  *
  47  * Registers a code function in a global table.
  48  * This table is then used by #MSG_launch_application.
  49  * \param name the reference name of the function.
  50  * \param code the function (must have the same prototype than the main function of any C program: int ..(int argc, char *argv[]))
  51  */
  52 void MSG_function_register(const char *name, xbt_main_func_t code)
  53 {
  54   SIMIX_function_register(name, code);
  55   return;
  56 }
  57
  58 /** \ingroup msg_easier_life
  59  * \brief Retrieves a registered main function
  60  *
  61  * Registers a code function in a global table.
  62  * This table is then used by #MSG_launch_application.
  63  * \param name the reference name of the function.
  64  */
  65 xbt_main_func_t MSG_get_registered_function(const char *name)
  66 {
  67   return SIMIX_get_registered_function(name);
  68 }