1 /* SimGrid Lua bindings */
3 /* Copyright (c) 2010. The SimGrid Team.
4 * All rights reserved. */
6 /* This program is free software; you can redistribute it and/or modify it
7 * under the terms of the license (GNU LGPL) which comes with this package. */
15 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(lua,bindings,"Lua Bindings");
17 #define TASK_MODULE_NAME "simgrid.Task"
18 #define HOST_MODULE_NAME "simgrid.Host"
19 // Surf ( bypass XML )
20 #define LINK_MODULE_NAME "simgrid.Link"
21 #define ROUTE_MODULE_NAME "simgrid.Route"
24 /* ********************************************************************************* */
25 /* helper functions */
26 /* ********************************************************************************* */
28 static void stackDump (const char *msg, lua_State *L) {
32 int top = lua_gettop(L);
35 p+=sprintf(p,"STACK(top=%d): ",top);
37 for (i = 1; i <= top; i++) { /* repeat for each level */
38 int t = lua_type(L, i);
41 case LUA_TSTRING: /* strings */
42 p+=sprintf(p,"`%s'", lua_tostring(L, i));
45 case LUA_TBOOLEAN: /* booleans */
46 p+=sprintf(p,lua_toboolean(L, i) ? "true" : "false");
49 case LUA_TNUMBER: /* numbers */
50 p+=sprintf(p,"%g", lua_tonumber(L, i));
54 p+=sprintf(p, "Table");
57 default: /* other values */
59 /* if ((ptr = luaL_checkudata(L,i,TASK_MODULE_NAME))) {
62 p+=printf(p,"%s", lua_typename(L, t));
67 p+=sprintf(p," "); /* put a separator */
69 INFO2("%s%s",msg,buff);
72 /** @brief ensures that a userdata on the stack is a task and returns the pointer inside the userdata */
73 static m_task_t checkTask (lua_State *L,int index) {
75 luaL_checktype(L,index,LUA_TTABLE);
76 lua_getfield(L,index,"__simgrid_task");
77 pi = (m_task_t*)luaL_checkudata(L,-1,TASK_MODULE_NAME);
79 luaL_typerror(L,index,TASK_MODULE_NAME);
82 luaL_error(L,"null Task");
86 /* ********************************************************************************* */
87 /* wrapper functions */
88 /* ********************************************************************************* */
91 * A task is either something to compute somewhere, or something to exchange between two hosts (or both).
92 * It is defined by a computing amount and a message size.
100 * Construct an new task with the specified processing amount and amount
103 * @param name Task's name
105 * @param computeDuration A value of the processing amount (in flop) needed to process the task.
106 * If 0, then it cannot be executed with the execute() method.
107 * This value has to be >= 0.
109 * @param messageSize A value of amount of data (in bytes) needed to transfert this task.
110 * If 0, then it cannot be transfered with the get() and put() methods.
111 * This value has to be >= 0.
113 static int Task_new(lua_State* L) {
114 const char *name=luaL_checkstring(L,1);
115 int comp_size = luaL_checkint(L,2);
116 int msg_size = luaL_checkint(L,3);
117 INFO0("Creating task");
118 m_task_t msg_task = MSG_task_create(name,comp_size,msg_size,NULL);
119 lua_newtable (L); /* create a table, put the userdata on top of it */
120 m_task_t *lua_task = (m_task_t*)lua_newuserdata(L,sizeof(m_task_t));
121 *lua_task = msg_task;
122 luaL_getmetatable(L,TASK_MODULE_NAME);
123 lua_setmetatable(L,-2);
124 lua_setfield (L, -2, "__simgrid_task"); /* put the userdata as field of the table */
125 /* remove the args from the stack */
132 static int Task_get_name(lua_State *L) {
133 m_task_t tk = checkTask(L,-1);
134 lua_pushstring(L,MSG_task_get_name(tk));
138 static int Task_computation_duration(lua_State *L){
139 m_task_t tk = checkTask(L,-1);
140 lua_pushnumber(L,MSG_task_get_compute_duration (tk));
144 static int Task_execute(lua_State *L){
145 m_task_t tk = checkTask(L,-1);
146 int res = MSG_task_execute(tk);
147 lua_pushnumber(L,res);
151 static int Task_destroy(lua_State *L) {
152 m_task_t tk = checkTask(L,-1);
153 int res = MSG_task_destroy(tk);
154 lua_pushnumber(L,res);
158 static int Task_send(lua_State *L) {
159 //stackDump("send ",L);
160 m_task_t tk = checkTask(L,-2);
161 const char *mailbox = luaL_checkstring(L,-1);
162 lua_pop(L,1); // remove the string so that the task is on top of it
163 MSG_task_set_data(tk,L); // Copy my stack into the task, so that the receiver can copy the lua task directly
164 MSG_error_t res = MSG_task_send(tk,mailbox);
165 while (MSG_task_get_data(tk)!=NULL) // Don't mess up with my stack: the receiver didn't copy the data yet
166 MSG_process_sleep(0); // yield
168 if (res != MSG_OK) switch(res) {
170 ERROR0("MSG_task_send failed : Timeout");
172 case MSG_TRANSFER_FAILURE :
173 ERROR0("MSG_task_send failed : Transfer Failure");
175 case MSG_HOST_FAILURE :
176 ERROR0("MSG_task_send failed : Host Failure ");
179 ERROR0("MSG_task_send failed : Unexpected error , please report this bug");
185 static int Task_recv(lua_State *L) {
187 const char *mailbox = luaL_checkstring(L,-1);
188 MSG_error_t res = MSG_task_receive(&tk,mailbox);
190 lua_State *sender_stack = MSG_task_get_data(tk);
191 lua_xmove(sender_stack,L,1); // copy the data directly from sender's stack
192 MSG_task_set_data(tk,NULL);
194 if(res != MSG_OK) switch(res){
196 ERROR0("MSG_task_receive failed : Timeout");
198 case MSG_TRANSFER_FAILURE :
199 ERROR0("MSG_task_receive failed : Transfer Failure");
201 case MSG_HOST_FAILURE :
202 ERROR0("MSG_task_receive failed : Host Failure ");
205 ERROR0("MSG_task_receive failed : Unexpected error , please report this bug");
212 static const luaL_reg Task_methods[] = {
214 {"name", Task_get_name},
215 {"computation_duration", Task_computation_duration},
216 {"execute", Task_execute},
217 {"destroy", Task_destroy},
222 static int Task_gc(lua_State *L) {
223 m_task_t tk=checkTask(L,-1);
224 if (tk) MSG_task_destroy(tk);
228 static int Task_tostring(lua_State *L) {
229 lua_pushfstring(L, "Task :%p",lua_touserdata(L,1));
233 static const luaL_reg Task_meta[] = {
235 {"__tostring", Task_tostring},
242 static m_host_t checkHost (lua_State *L,int index) {
244 luaL_checktype(L,index,LUA_TTABLE);
245 lua_getfield(L,index,"__simgrid_host");
246 pi = (m_host_t*)luaL_checkudata(L,-1,HOST_MODULE_NAME);
248 luaL_typerror(L,index,HOST_MODULE_NAME);
251 luaL_error(L,"null Host");
256 static int Host_get_by_name(lua_State *L)
258 const char *name=luaL_checkstring(L,1);
259 DEBUG0("Getting Host from name...");
260 m_host_t msg_host = MSG_get_host_by_name(name);
263 luaL_error(L,"null Host : MSG_get_host_by_name failled");
265 lua_newtable (L); /* create a table, put the userdata on top of it */
266 m_host_t *lua_host = (m_host_t*)lua_newuserdata(L,sizeof(m_host_t));
267 *lua_host = msg_host;
268 luaL_getmetatable(L,HOST_MODULE_NAME);
269 lua_setmetatable(L,-2);
270 lua_setfield (L, -2, "__simgrid_host"); /* put the userdata as field of the table */
271 /* remove the args from the stack */
277 static int Host_get_name(lua_State *L) {
278 m_host_t ht = checkHost(L,-1);
279 lua_pushstring(L,MSG_host_get_name(ht));
283 static int Host_number(lua_State *L) {
284 lua_pushnumber(L,MSG_get_host_number());
288 static int Host_at(lua_State *L)
290 int index = luaL_checkinteger(L,1);
291 m_host_t host = MSG_get_host_table()[index-1]; // lua indexing start by 1 (lua[1] <=> C[0])
292 lua_newtable (L); /* create a table, put the userdata on top of it */
293 m_host_t *lua_host = (m_host_t*)lua_newuserdata(L,sizeof(m_host_t));
295 luaL_getmetatable(L,HOST_MODULE_NAME);
296 lua_setmetatable(L,-2);
297 lua_setfield (L, -2, "__simgrid_host"); /* put the userdata as field of the table */
302 /*****************************************************************************************
303 * BYPASS XML SURF Methods *
304 ***************************
305 ***************************
306 ******************************************************************************************/
307 #include "surf/surfxml_parse.h" /* to override surf_parse and bypass the parser */
308 #include "surf/surf_private.h"
309 typedef struct t_host_attr
314 //deployment attribute
315 const char* function;
317 //const char ** args_list;
318 xbt_dynar_t args_list;
319 }host_attr,*p_host_attr;
321 typedef struct t_link_attr
326 }link_attr,*p_link_attr;
328 typedef struct t_route_attr
333 const char **links_id;
335 }route_attr,*p_route_attr;
338 static int host_index = 0;
339 static int link_index = 0;
340 static int route_index = 0;
342 //using xbt_dynar_t :
343 static xbt_dynar_t host_list_d ;
344 static xbt_dynar_t link_list_d ;
345 static xbt_dynar_t route_list_d ;
348 static int Host_new(lua_State *L) //(id,power)
350 // if it's the first time ,instanciate the dynar
351 if(xbt_dynar_is_empty(host_list_d))
352 host_list_d = xbt_dynar_new(sizeof(p_host_attr), &xbt_free_ref);
355 p_host_attr host = malloc(sizeof(host_attr));
356 host->id = luaL_checkstring(L,1);
357 host->power = luaL_checknumber(L,2);
358 host->function = NULL;
359 xbt_dynar_push(host_list_d, &host);
364 static int Link_new(lua_State *L) // (id,bandwidth,latency)
366 if(xbt_dynar_is_empty(link_list_d))
367 link_list_d = xbt_dynar_new(sizeof(p_link_attr), &xbt_free_ref);
369 p_link_attr link = malloc(sizeof(link_attr));
370 link->id = luaL_checkstring(L,1);
371 link->bandwidth = luaL_checknumber(L,2);
372 link->latency = luaL_checknumber(L,3);
373 xbt_dynar_push(link_list_d,&link);
378 static int Route_new(lua_State *L) // (src_id,dest_id,links_number,link_table)
380 if(xbt_dynar_is_empty(route_list_d))
381 route_list_d = xbt_dynar_new(sizeof(p_route_attr), &xbt_free_ref);
384 p_route_attr route = malloc(sizeof(route_attr));
385 route->src_id = luaL_checkstring(L,1);
386 route->dest_id = luaL_checkstring(L,2);
387 route->links_nb = luaL_checkint(L,3);
388 route->links_id = malloc(sizeof(char*)*route->links_nb);
390 while (lua_next(L,4) != 0) {
391 if(i >= route->links_nb)
392 ERROR1("Number of links should be less than %d",route->links_nb+1);
393 route->links_id[i] = lua_tostring(L, -1);
394 DEBUG2("index = %f , Link_id = %s \n",lua_tonumber(L, -2),lua_tostring(L, -1));
400 //add route to platform's route list
401 xbt_dynar_push(route_list_d,&route);
406 static int Host_set_function(lua_State *L) //(host,function,nb_args,list_args)
408 // look for the index of host in host_list
409 const char *host_id = luaL_checkstring(L,1);
410 const char* argument;
414 xbt_dynar_foreach(host_list_d,i,p_host)
416 if(p_host->id == host_id)
418 p_host->function = luaL_checkstring(L,2);
419 p_host->args_nb = luaL_checkint(L,3);
420 //p_host->args_list = malloc(sizeof(char*)*p_host->args_nb);
421 p_host->args_list = xbt_dynar_new(sizeof(char *), &xbt_free_ref);
422 // fill the args list
425 while (lua_next(L,4) != 0) {
426 if(j >= p_host->args_nb)
427 ERROR1("Number of args should be less than %d",p_host->args_nb+1);
428 //p_host->args_list[j] = lua_tostring(L, -1);
429 argument = lua_tostring(L, -1);
430 xbt_dynar_push(p_host->args_list, &argument);
431 DEBUG2("index = %f , Arg_id = %s \n",lua_tonumber(L, -2),lua_tostring(L, -1));
439 ERROR1("Host : %s Not Fount !!",host_id);
444 * surf parse bypass platform
446 static int surf_parse_bypass_platform()
453 p_route_attr p_route;
455 static int AX_ptr = 0;
456 static int surfxml_bufferstack_size = 2048;
458 /* FIXME allocating memory for the buffer, I think 2kB should be enough */
459 surfxml_bufferstack = xbt_new0(char, surfxml_bufferstack_size);
461 SURFXML_BUFFER_SET(platform_version, "2");
463 SURFXML_START_TAG(platform);
467 xbt_dynar_foreach(host_list_d,i,p_host)
472 init_host_bypass(p_host->id,p_host->power);
475 //SURFXML_BUFFER_SET(host_id,host_list[i]->id);
476 SURFXML_BUFFER_SET(host_id,p_host->id);
477 //sprintf(buffer, "%f", host_list[i]->power);
478 sprintf(buffer,"%f",p_host->power);
479 SURFXML_BUFFER_SET(host_power,buffer);
480 SURFXML_BUFFER_SET(host_availability, "1.0");
481 SURFXML_BUFFER_SET(host_availability_file, "");
482 A_surfxml_host_state = A_surfxml_host_state_ON;
483 SURFXML_BUFFER_SET(host_state_file, "");
484 SURFXML_BUFFER_SET(host_interference_send, "1.0");
485 SURFXML_BUFFER_SET(host_interference_recv, "1.0");
486 SURFXML_BUFFER_SET(host_interference_send_recv, "1.0");
487 SURFXML_BUFFER_SET(host_max_outgoing_rate, "-1.0");
488 SURFXML_START_TAG(host);
489 SURFXML_END_TAG(host);
494 xbt_dynar_foreach(link_list_d,i,p_link)
497 //SURFXML_BUFFER_SET(link_id,link_list[i]->id);
498 SURFXML_BUFFER_SET(link_id,p_link->id);
499 //sprintf(buffer,"%f",link_list[i]->bandwidth);
500 sprintf(buffer,"%f",p_link->bandwidth);
501 SURFXML_BUFFER_SET(link_bandwidth,buffer);
502 SURFXML_BUFFER_SET(link_bandwidth_file, "");
503 //sprintf(buffer,"%f",link_list[i]->latency);
504 sprintf(buffer,"%f",p_link->latency);
505 SURFXML_BUFFER_SET(link_latency,buffer);
506 SURFXML_BUFFER_SET(link_latency_file, "");
507 A_surfxml_link_state = A_surfxml_link_state_ON;
508 SURFXML_BUFFER_SET(link_state_file, "");
509 A_surfxml_link_sharing_policy = A_surfxml_link_sharing_policy_SHARED;
510 SURFXML_START_TAG(link);
511 SURFXML_END_TAG(link);
517 for (i = 0;i<route_index;i++)
518 xbt_dynar_foreach(route_list_d,i,p_route)
521 //SURFXML_BUFFER_SET(route_src,route_list[i]->src_id);
522 SURFXML_BUFFER_SET(route_src,p_route->src_id);
523 //SURFXML_BUFFER_SET(route_dst,route_list[i]->dest_id);
524 SURFXML_BUFFER_SET(route_dst,p_route->dest_id);
525 SURFXML_BUFFER_SET(route_impact_on_src, "0.0");
526 SURFXML_BUFFER_SET(route_impact_on_dst, "0.0");
527 SURFXML_BUFFER_SET(route_impact_on_src_with_other_recv, "0.0");
528 SURFXML_BUFFER_SET(route_impact_on_dst_with_other_send, "0.0");
529 SURFXML_START_TAG(route);
532 for(j=0;j< p_route->links_nb;j++)
534 //SURFXML_BUFFER_SET(link_c_ctn_id,route_list[i]->links_id[j]);
535 SURFXML_BUFFER_SET(link_c_ctn_id,p_route->links_id[j]);
536 SURFXML_START_TAG(link_c_ctn);
537 SURFXML_END_TAG(link_c_ctn);
540 SURFXML_END_TAG(route);
545 SURFXML_END_TAG(platform);
548 free(surfxml_bufferstack);
549 return 0; // must return 0 ?!!
554 * surf parse bypass application
556 static int surf_parse_bypass_application()
565 static int surfxml_bufferstack_size = 2048;
566 /* FIXME ( should be manual )allocating memory to the buffer, I think 2MB should be enough */
567 surfxml_bufferstack = xbt_new0(char, surfxml_bufferstack_size);
570 SURFXML_BUFFER_SET(platform_version, "2");
572 SURFXML_START_TAG(platform);
574 //for(i=0 ; i< host_index ;i++)
575 xbt_dynar_foreach(host_list_d,i,p_host)
579 SURFXML_BUFFER_SET(process_host, p_host->id);
580 SURFXML_BUFFER_SET(process_function, p_host->function);
581 SURFXML_BUFFER_SET(process_start_time, "-1.0");
582 SURFXML_BUFFER_SET(process_kill_time, "-1.0");
583 SURFXML_START_TAG(process);
587 // for(j=0 ;j<p_host->args_nb;j++)
588 xbt_dynar_foreach(p_host->args_list,j,arg)
590 //SURFXML_BUFFER_SET(argument_value,p_host->args_list[j]);
591 SURFXML_BUFFER_SET(argument_value,arg);
592 SURFXML_START_TAG(argument);
593 SURFXML_END_TAG(argument);
595 SURFXML_END_TAG(process);
600 SURFXML_END_TAG(platform);
601 free(surfxml_bufferstack);
605 //***********Register Methods *******************************************//
609 static const luaL_reg Host_methods[] = {
610 {"getByName", Host_get_by_name},
611 {"name", Host_get_name},
612 {"number", Host_number},
614 // Bypass XML Methods
616 {"setFunction", Host_set_function},
620 static int Host_gc(lua_State *L)
622 m_host_t ht = checkHost(L,-1);
627 static int Host_tostring(lua_State *L)
629 lua_pushfstring(L,"Host :%p",lua_touserdata(L,1));
633 static const luaL_reg Host_meta[] = {
635 {"__tostring", Host_tostring},
642 static const luaL_reg Link_methods[] = {
649 static const luaL_reg Route_methods[] ={
654 * Environment related
657 extern lua_State *simgrid_lua_state;
659 static int run_lua_code(int argc,char **argv) {
660 DEBUG1("Run lua code %s",argv[0]);
661 lua_State *L = lua_newthread(simgrid_lua_state);
662 int ref = luaL_ref(simgrid_lua_state, LUA_REGISTRYINDEX); // protect the thread from being garbage collected
665 /* Start the co-routine */
666 lua_getglobal(L,argv[0]);
667 xbt_assert1(lua_isfunction(L,-1),
668 "The lua function %s does not seem to exist",argv[0]);
670 // push arguments onto the stack
673 lua_pushstring(L,argv[i]);
675 // Call the function (in resume)
676 xbt_assert2(lua_pcall(L, argc-1, 1, 0) == 0,
677 "error running function `%s': %s",argv[0], lua_tostring(L, -1));
679 /* retrieve result */
680 if (lua_isnumber(L, -1)) {
681 res = lua_tonumber(L, -1);
682 lua_pop(L, 1); /* pop returned value */
686 luaL_unref(simgrid_lua_state,LUA_REGISTRYINDEX,ref );
687 DEBUG1("Execution of lua code %s is over", (argv ? argv[0] : "(null)"));
690 static int launch_application(lua_State *L) {
691 const char * file = luaL_checkstring(L,1);
692 MSG_function_register_default(run_lua_code);
693 MSG_launch_application(file);
696 #include "simix/simix.h" //FIXME: KILLME when debugging on simix internals become useless
697 static int create_environment(lua_State *L) {
698 const char *file = luaL_checkstring(L,1);
699 DEBUG1("Loading environment file %s",file);
700 MSG_create_environment(file);
701 smx_host_t *hosts = SIMIX_host_get_table();
703 for (i=0;i<SIMIX_host_get_number();i++) {
704 DEBUG1("We have an host %s", SIMIX_host_get_name(hosts[i]));
710 static int debug(lua_State *L) {
711 const char *str = luaL_checkstring(L,1);
715 static int info(lua_State *L) {
716 const char *str = luaL_checkstring(L,1);
720 static int run(lua_State *L) {
724 static int clean(lua_State *L) {
732 static int register_platform(lua_State *L)
734 /* Tell Simgrid we dont wanna use its parser*/
735 surf_parse = surf_parse_bypass_platform;
736 MSG_create_environment(NULL);
740 static int register_application(lua_State *L)
742 MSG_function_register_default(run_lua_code);
743 surf_parse = surf_parse_bypass_application;
744 MSG_launch_application(NULL);
748 static const luaL_Reg simgrid_funcs[] = {
749 { "create_environment", create_environment},
750 { "launch_application", launch_application},
756 { "platform", create_environment},
757 { "application", launch_application},
758 /* methods to bypass XML parser*/
759 { "register_platform",register_platform},
760 { "register_application",register_application},
764 /* ********************************************************************************* */
765 /* module management functions */
766 /* ********************************************************************************* */
768 extern const char*xbt_ctx_factory_to_use; /*Hack: let msg load directly the right factory */
770 #define LUA_MAX_ARGS_COUNT 10 /* maximum amount of arguments we can get from lua on command line */
772 int luaopen_simgrid(lua_State* L); // Fuck gcc: we don't need that prototype
773 int luaopen_simgrid(lua_State* L) {
774 //xbt_ctx_factory_to_use = "lua";
776 char **argv=malloc(sizeof(char*)*LUA_MAX_ARGS_COUNT);
778 argv[0] = (char*)"/usr/bin/lua"; /* Lie on the argv[0] so that the stack dumping facilities find the right binary. FIXME: what if lua is not in that location? */
779 /* Get the command line arguments from the lua interpreter */
780 lua_getglobal(L,"arg");
781 xbt_assert1(lua_istable(L,-1),"arg parameter is not a table but a %s",lua_typename(L,-1));
785 lua_pushinteger(L,argc-2);
787 if (lua_isnil(L,-1)) {
790 xbt_assert1(lua_isstring(L,-1),"argv[%d] got from lua is no string",argc-1);
791 xbt_assert2(argc<LUA_MAX_ARGS_COUNT,
792 "Too many arguments, please increase LUA_MAX_ARGS_COUNT in %s before recompiling SimGrid if you insist on having more than %d args on command line",
793 __FILE__,LUA_MAX_ARGS_COUNT-1);
794 argv[argc-1] = (char*)luaL_checkstring(L,-1);
796 DEBUG1("Got command line argument %s from lua",argv[argc-1]);
801 /* Initialize the MSG core */
802 MSG_global_init(&argc,argv);
803 DEBUG1("Still %d arguments on command line",argc); // FIXME: update the lua's arg table to reflect the changes from SimGrid
805 /* register the core C functions to lua */
806 luaL_register(L, "simgrid", simgrid_funcs);
807 /* register the task methods to lua */
808 luaL_openlib(L,TASK_MODULE_NAME,Task_methods,0); //create methods table,add it to the globals
809 luaL_newmetatable(L,TASK_MODULE_NAME); //create metatable for Task,add it to the Lua registry
810 luaL_openlib(L,0,Task_meta,0);// fill metatable
811 lua_pushliteral(L,"__index");
812 lua_pushvalue(L,-3); //dup methods table
813 lua_rawset(L,-3); //matatable.__index = methods
814 lua_pushliteral(L,"__metatable");
815 lua_pushvalue(L,-3); //dup methods table
816 lua_rawset(L,-3); //hide metatable:metatable.__metatable = methods
817 lua_pop(L,1); //drop metatable
819 /* register the hosts methods to lua*/
820 luaL_openlib(L,HOST_MODULE_NAME,Host_methods,0);
821 luaL_newmetatable(L,HOST_MODULE_NAME);
822 luaL_openlib(L,0,Host_meta,0);
823 lua_pushliteral(L,"__index");
826 lua_pushliteral(L,"__metatable");
831 /* register the links methods to lua*/
832 luaL_openlib(L,LINK_MODULE_NAME,Link_methods,0);
833 luaL_newmetatable(L,LINK_MODULE_NAME);
836 /*register the routes methods to lua*/
837 luaL_openlib(L,ROUTE_MODULE_NAME,Route_methods,0);
838 luaL_newmetatable(L,LINK_MODULE_NAME);
841 /* Keep the context mechanism informed of our lua world today */
842 simgrid_lua_state = L;