1 /* Copyright (c) 2007-2014. The SimGrid Team.
2 * All rights reserved. */
4 /* This program is free software; you can redistribute it and/or modify it
5 * under the terms of the license (GNU LGPL) which comes with this package. */
7 #include "smx_private.h"
8 #include "xbt/sysdep.h"
13 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(simix_host, simix,
14 "Logging specific to SIMIX (hosts)");
16 static void SIMIX_execution_finish(smx_action_t action);
19 * \brief Internal function to create a SIMIX host.
20 * \param name name of the host to create
21 * \param workstation the SURF workstation to encapsulate
22 * \param data some user data (may be NULL)
24 smx_host_t SIMIX_host_create(const char *name,
25 void *workstation, void *data)
27 smx_host_priv_t smx_host = xbt_new0(s_smx_host_priv_t, 1);
31 smx_host->process_list =
32 xbt_swag_new(xbt_swag_offset(proc, host_proc_hookup));
34 /* Update global variables */
35 xbt_lib_set(host_lib,name,SIMIX_HOST_LEVEL,smx_host);
37 return xbt_lib_get_elm_or_null(host_lib, name);
40 void simcall_HANDLER_host_on(smx_simcall_t simcall, smx_host_t h)
46 * \brief Start the host if it is off
49 void SIMIX_host_on(smx_host_t h)
51 smx_host_priv_t host = SIMIX_host_priv(h);
53 xbt_assert((host != NULL), "Invalid parameters");
55 if (surf_resource_get_state(surf_workstation_resource_priv(h))==SURF_RESOURCE_OFF) {
56 surf_resource_set_state(surf_workstation_resource_priv(h), SURF_RESOURCE_ON);
59 smx_process_arg_t arg;
60 xbt_dynar_foreach(host->boot_processes,cpt,arg) {
61 smx_process_t process;
63 char** argv = xbt_new(char*, arg->argc);
64 for (int i=0; i<arg->argc; i++)
65 argv[i] = xbt_strdup(arg->argv[i]);
67 XBT_DEBUG("Booting Process %s(%s) right now", arg->argv[0], arg->hostname);
68 if (simix_global->create_process_function) {
69 simix_global->create_process_function(&process,
81 simcall_process_create(&process,
96 void simcall_HANDLER_host_off(smx_simcall_t simcall, smx_host_t h)
98 SIMIX_host_off(h, simcall->issuer);
102 * \brief Stop the host if it is on
105 void SIMIX_host_off(smx_host_t h, smx_process_t issuer)
107 smx_host_priv_t host = SIMIX_host_priv(h);
109 xbt_assert((host != NULL), "Invalid parameters");
111 if (surf_resource_get_state(surf_workstation_resource_priv(h))==SURF_RESOURCE_ON) {
112 surf_resource_set_state(surf_workstation_resource_priv(h), SURF_RESOURCE_OFF);
114 /* Clean Simulator data */
115 if (xbt_swag_size(host->process_list) != 0) {
116 smx_process_t process = NULL;
117 xbt_swag_foreach(process, host->process_list) {
118 SIMIX_process_kill(process, issuer);
119 XBT_DEBUG("Killing %s on %s by %s", process->name, sg_host_name(process->smx_host), issuer->name);
123 /*xbt_dynar_t vms = surf_workstation_get_vms(h);
126 xbt_dynar_foreach(vms, cpt, vm) {
127 SIMIX_vm_shutdown(vm, issuer);
128 SIMIX_vm_destroy(vm);
130 xbt_dynar_free(&vms);*/
134 * \brief Internal function to destroy a SIMIX host.
136 * \param h the host to destroy (a smx_host_t)
138 void SIMIX_host_destroy(void *h)
140 smx_host_priv_t host = (smx_host_priv_t) h;
142 xbt_assert((host != NULL), "Invalid parameters");
144 /* Clean Simulator data */
145 if (xbt_swag_size(host->process_list) != 0) {
146 char *msg = xbt_strdup("Shutting down host, but it's not empty:");
148 smx_process_t process = NULL;
150 xbt_swag_foreach(process, host->process_list) {
151 tmp = bprintf("%s\n\t%s", msg, process->name);
155 SIMIX_display_process_status();
156 THROWF(arg_error, 0, "%s", msg);
158 xbt_dynar_free(&host->auto_restart_processes);
159 xbt_dynar_free(&host->boot_processes);
160 xbt_swag_free(host->process_list);
162 /* Clean host structure */
167 smx_host_t simcall_HANDLER_host_get_by_name(smx_simcall_t simcall, const char *name){
168 return SIMIX_host_get_by_name(name);
170 smx_host_t SIMIX_host_get_by_name(const char *name){
171 xbt_assert(((simix_global != NULL)
172 && (host_lib != NULL)),
173 "Environment not set yet");
175 return xbt_lib_get_elm_or_null(host_lib, name);
178 smx_host_t SIMIX_host_self(void)
180 smx_process_t process = SIMIX_process_self();
181 return (process == NULL) ? NULL : SIMIX_process_get_host(process);
184 const char* simcall_HANDLER_host_self_get_name(smx_simcall_t simcall){
185 return SIMIX_host_self_get_name();
187 /* needs to be public and without simcall because it is called
188 by exceptions and logging events */
189 const char* SIMIX_host_self_get_name(void)
191 smx_host_t host = SIMIX_host_self();
192 if (host == NULL || SIMIX_process_self() == simix_global->maestro_process)
195 return SIMIX_host_get_name(host);
198 const char* simcall_HANDLER_host_get_name(smx_simcall_t simcall, smx_host_t host){
199 return SIMIX_host_get_name(host);
201 const char* SIMIX_host_get_name(smx_host_t host){
202 xbt_assert((host != NULL), "Invalid parameters");
204 return sg_host_name(host);
207 xbt_dict_t simcall_HANDLER_host_get_properties(smx_simcall_t simcall, smx_host_t host){
208 return SIMIX_host_get_properties(host);
210 xbt_dict_t SIMIX_host_get_properties(smx_host_t host){
211 xbt_assert((host != NULL), "Invalid parameters (simix host is NULL)");
213 return surf_resource_get_properties(surf_workstation_resource_priv(host));
216 double simcall_HANDLER_host_get_speed(smx_simcall_t simcall, smx_host_t host){
217 return SIMIX_host_get_speed(host);
219 double SIMIX_host_get_speed(smx_host_t host){
220 xbt_assert((host != NULL), "Invalid parameters (simix host is NULL)");
221 return surf_workstation_get_speed(host, 1.0);
224 int simcall_HANDLER_host_get_core(smx_simcall_t simcall, smx_host_t host){
225 return SIMIX_host_get_core(host);
227 int SIMIX_host_get_core(smx_host_t host){
228 xbt_assert((host != NULL), "Invalid parameters (simix host is NULL)");
230 return surf_workstation_get_core(host);
233 xbt_swag_t simcall_HANDLER_host_get_process_list(smx_simcall_t simcall, smx_host_t host){
234 return SIMIX_host_get_process_list(host);
237 xbt_swag_t SIMIX_host_get_process_list(smx_host_t host){
238 xbt_assert((host != NULL), "Invalid parameters (simix host is NULL)");
239 smx_host_priv_t host_priv = SIMIX_host_priv(host);
241 return host_priv->process_list;
245 double simcall_HANDLER_host_get_available_speed(smx_simcall_t simcall, smx_host_t host){
246 return SIMIX_host_get_available_speed(host);
248 double SIMIX_host_get_available_speed(smx_host_t host){
249 xbt_assert((host != NULL), "Invalid parameters (simix host is NULL)");
251 return surf_workstation_get_available_speed(host);
254 double simcall_HANDLER_host_get_current_power_peak(smx_simcall_t simcall, smx_host_t host){
255 return SIMIX_host_get_current_power_peak(host);
257 double SIMIX_host_get_current_power_peak(smx_host_t host) {
258 xbt_assert((host != NULL), "Invalid parameters (simix host is NULL)");
259 return surf_workstation_get_current_power_peak(host);
262 double simcall_HANDLER_host_get_power_peak_at(smx_simcall_t simcall, smx_host_t host, int pstate_index){
263 return SIMIX_host_get_power_peak_at(host, pstate_index);
265 double SIMIX_host_get_power_peak_at(smx_host_t host, int pstate_index) {
266 xbt_assert((host != NULL), "Invalid parameters (simix host is NULL)");
268 return surf_workstation_get_power_peak_at(host, pstate_index);
271 int simcall_HANDLER_host_get_nb_pstates(smx_simcall_t simcall, smx_host_t host){
272 return SIMIX_host_get_nb_pstates(host);
274 int SIMIX_host_get_nb_pstates(smx_host_t host) {
275 xbt_assert((host != NULL), "Invalid parameters (simix host is NULL)");
277 return surf_workstation_get_nb_pstates(host);
281 void simcall_HANDLER_host_set_power_peak_at(smx_simcall_t simcall, smx_host_t host, int pstate_index){
282 SIMIX_host_set_power_peak_at(host, pstate_index);
284 void SIMIX_host_set_power_peak_at(smx_host_t host, int pstate_index) {
285 xbt_assert((host != NULL), "Invalid parameters (simix host is NULL)");
287 surf_workstation_set_power_peak_at(host, pstate_index);
290 double simcall_HANDLER_host_get_consumed_energy(smx_simcall_t simcall, smx_host_t host){
291 return SIMIX_host_get_consumed_energy(host);
293 double SIMIX_host_get_consumed_energy(smx_host_t host) {
294 xbt_assert((host != NULL), "Invalid parameters (simix host is NULL)");
295 return surf_workstation_get_consumed_energy(host);
298 int simcall_HANDLER_host_get_state(smx_simcall_t simcall, smx_host_t host){
299 return SIMIX_host_get_state(host);
301 int SIMIX_host_get_state(smx_host_t host){
302 xbt_assert((host != NULL), "Invalid parameters (simix host is NULL)");
304 return surf_resource_get_state(surf_workstation_resource_priv(host));
307 void _SIMIX_host_free_process_arg(void *data)
309 smx_process_arg_t arg = *(void**)data;
311 for (i = 0; i < arg->argc; i++)
312 xbt_free(arg->argv[i]);
318 * \brief Add a process to the list of the processes that the host will restart when it comes back
319 * This function add a process to the list of the processes that will be restarted when the host comes
320 * back. It is expected that this function is called when the host is down.
321 * The processes will only be restarted once, meaning that you will have to register the process
322 * again to restart the process again.
324 void SIMIX_host_add_auto_restart_process(smx_host_t host,
326 xbt_main_func_t code,
328 const char *hostname,
330 int argc, char **argv,
331 xbt_dict_t properties,
334 if (!SIMIX_host_priv(host)->auto_restart_processes) {
335 SIMIX_host_priv(host)->auto_restart_processes = xbt_dynar_new(sizeof(smx_process_arg_t),_SIMIX_host_free_process_arg);
337 smx_process_arg_t arg = xbt_new(s_smx_process_arg_t,1);
338 arg->name = xbt_strdup(name);
341 arg->hostname = hostname;
342 arg->kill_time = kill_time;
345 arg->argv = xbt_new(char*,argc + 1);
348 for (i = 0; i < argc; i++) {
349 arg->argv[i] = xbt_strdup(argv[i]);
351 arg->argv[argc] = NULL;
353 arg->properties = properties;
354 arg->auto_restart = auto_restart;
356 if( SIMIX_host_get_state(host) == SURF_RESOURCE_OFF
357 && !xbt_dict_get_or_null(watched_hosts_lib,sg_host_name(host))){
358 xbt_dict_set(watched_hosts_lib,sg_host_name(host),host,NULL);
359 XBT_DEBUG("Have pushed host %s to watched_hosts_lib because state == SURF_RESOURCE_OFF",sg_host_name(host));
361 xbt_dynar_push_as(SIMIX_host_priv(host)->auto_restart_processes,smx_process_arg_t,arg);
364 * \brief Restart the list of processes that have been registered to the host
366 void SIMIX_host_restart_processes(smx_host_t host)
369 smx_process_arg_t arg;
370 xbt_dynar_t process_list = SIMIX_host_priv(host)->auto_restart_processes;
374 xbt_dynar_foreach (process_list, cpt, arg) {
376 smx_process_t process;
378 XBT_DEBUG("Restarting Process %s(%s) right now", arg->argv[0], arg->hostname);
379 if (simix_global->create_process_function) {
380 simix_global->create_process_function(&process,
392 simcall_process_create(&process,
404 /* arg->argv is used by the process created above. Hide it to
405 * _SIMIX_host_free_process_arg() which is called by xbt_dynar_reset()
410 xbt_dynar_reset(process_list);
413 void SIMIX_host_autorestart(smx_host_t host)
415 if(simix_global->autorestart)
416 simix_global->autorestart(host);
418 xbt_die("No function for simix_global->autorestart");
421 smx_action_t simcall_HANDLER_host_execute(smx_simcall_t simcall,const char *name,
422 smx_host_t host, double computation_amount, double priority, double bound, unsigned long affinity_mask){
423 return SIMIX_host_execute(name, host, computation_amount, priority, bound, affinity_mask);
425 smx_action_t SIMIX_host_execute(const char *name,
426 smx_host_t host, double computation_amount, double priority, double bound, unsigned long affinity_mask){
428 /* alloc structures and initialize */
429 smx_action_t action = xbt_mallocator_get(simix_global->action_mallocator);
430 action->type = SIMIX_ACTION_EXECUTE;
431 action->name = xbt_strdup(name);
432 action->state = SIMIX_RUNNING;
433 action->execution.host = host;
436 action->category = NULL;
439 /* set surf's action */
440 if (!MC_is_active()) {
442 action->execution.surf_exec = surf_workstation_execute(host, computation_amount);
443 surf_action_set_data(action->execution.surf_exec, action);
444 surf_action_set_priority(action->execution.surf_exec, priority);
446 /* Note (hypervisor): for multicore, the bound value being passed to the
447 * surf layer should not be zero (i.e., unlimited). It should be the
448 * capacity of a CPU core. */
450 surf_cpu_action_set_bound(action->execution.surf_exec, SIMIX_host_get_speed(host));
452 surf_cpu_action_set_bound(action->execution.surf_exec, bound);
454 if (affinity_mask != 0) {
455 /* just a double check to confirm that this host is the host where this task is running. */
456 xbt_assert(action->execution.host == host);
457 surf_cpu_action_set_affinity(action->execution.surf_exec, host, affinity_mask);
461 XBT_DEBUG("Create execute action %p: %s", action, action->name);
466 smx_action_t simcall_HANDLER_host_parallel_execute(smx_simcall_t simcall, const char *name,
467 int host_nb, smx_host_t *host_list,
468 double *computation_amount, double *communication_amount,
469 double amount, double rate){
470 return SIMIX_host_parallel_execute(name, host_nb, host_list, computation_amount,
471 communication_amount, amount, rate);
473 smx_action_t SIMIX_host_parallel_execute(const char *name,
474 int host_nb, smx_host_t *host_list,
475 double *computation_amount, double *communication_amount,
476 double amount, double rate){
478 void **workstation_list = NULL;
481 /* alloc structures and initialize */
482 smx_action_t action = xbt_mallocator_get(simix_global->action_mallocator);
483 action->type = SIMIX_ACTION_PARALLEL_EXECUTE;
484 action->name = xbt_strdup(name);
485 action->state = SIMIX_RUNNING;
486 action->execution.host = NULL; /* FIXME: do we need the list of hosts? */
489 action->category = NULL;
492 /* set surf's action */
493 workstation_list = xbt_new0(void *, host_nb);
494 for (i = 0; i < host_nb; i++)
495 workstation_list[i] = surf_workstation_resource_priv(host_list[i]);
498 /* FIXME: what happens if host_list contains VMs and PMs. If
499 * execute_parallel_task() does not change the state of the model, we can mix
501 surf_model_t ws_model = surf_resource_model(host_list[0], SURF_WKS_LEVEL);
502 for (i = 1; i < host_nb; i++) {
503 surf_model_t ws_model_tmp = surf_resource_model(host_list[i], SURF_WKS_LEVEL);
504 if (ws_model_tmp != ws_model) {
505 XBT_CRITICAL("mixing VMs and PMs is not supported");
510 /* set surf's action */
511 if (!MC_is_active()) {
512 action->execution.surf_exec =
513 surf_workstation_model_execute_parallel_task((surf_workstation_model_t)surf_workstation_model,
514 host_nb, workstation_list, computation_amount, communication_amount, rate);
516 surf_action_set_data(action->execution.surf_exec, action);
518 XBT_DEBUG("Create parallel execute action %p", action);
523 void simcall_HANDLER_host_execution_destroy(smx_simcall_t simcall, smx_action_t action){
524 SIMIX_host_execution_destroy(action);
526 void SIMIX_host_execution_destroy(smx_action_t action){
527 XBT_DEBUG("Destroy action %p", action);
529 if (action->execution.surf_exec) {
530 surf_action_unref(action->execution.surf_exec);
531 action->execution.surf_exec = NULL;
533 xbt_free(action->name);
534 xbt_mallocator_release(simix_global->action_mallocator, action);
537 void simcall_HANDLER_host_execution_cancel(smx_simcall_t simcall, smx_action_t action){
538 SIMIX_host_execution_cancel(action);
540 void SIMIX_host_execution_cancel(smx_action_t action){
541 XBT_DEBUG("Cancel action %p", action);
543 if (action->execution.surf_exec)
544 surf_action_cancel(action->execution.surf_exec);
547 double simcall_HANDLER_host_execution_get_remains(smx_simcall_t simcall, smx_action_t action){
548 return SIMIX_host_execution_get_remains(action);
550 double SIMIX_host_execution_get_remains(smx_action_t action){
553 if (action->state == SIMIX_RUNNING)
554 result = surf_action_get_remains(action->execution.surf_exec);
559 e_smx_state_t simcall_HANDLER_host_execution_get_state(smx_simcall_t simcall, smx_action_t action){
560 return SIMIX_host_execution_get_state(action);
562 e_smx_state_t SIMIX_host_execution_get_state(smx_action_t action){
563 return action->state;
566 void simcall_HANDLER_host_execution_set_priority(smx_simcall_t simcall, smx_action_t action,
568 SIMIX_host_execution_set_priority(action, priority);
570 void SIMIX_host_execution_set_priority(smx_action_t action, double priority){
572 if(action->execution.surf_exec)
573 surf_action_set_priority(action->execution.surf_exec, priority);
576 void simcall_HANDLER_host_execution_set_bound(smx_simcall_t simcall, smx_action_t action,
578 SIMIX_host_execution_set_bound(action, bound);
580 void SIMIX_host_execution_set_bound(smx_action_t action, double bound){
582 if(action->execution.surf_exec)
583 surf_cpu_action_set_bound(action->execution.surf_exec, bound);
586 void simcall_HANDLER_host_execution_set_affinity(smx_simcall_t simcall,
587 smx_action_t action, smx_host_t host, unsigned long mask){
588 SIMIX_host_execution_set_affinity(action, host, mask);
590 void SIMIX_host_execution_set_affinity(smx_action_t action, smx_host_t host, unsigned long mask){
591 xbt_assert(action->type == SIMIX_ACTION_EXECUTE);
593 if (action->execution.surf_exec) {
594 /* just a double check to confirm that this host is the host where this task is running. */
595 xbt_assert(action->execution.host == host);
596 surf_cpu_action_set_affinity(action->execution.surf_exec, host, mask);
600 void simcall_HANDLER_host_execution_wait(smx_simcall_t simcall, smx_action_t action){
602 XBT_DEBUG("Wait for execution of action %p, state %d", action, (int)action->state);
604 /* Associate this simcall to the action */
605 xbt_fifo_push(action->simcalls, simcall);
606 simcall->issuer->waiting_action = action;
608 /* set surf's action */
609 if (MC_is_active()) {
610 action->state = SIMIX_DONE;
611 SIMIX_execution_finish(action);
615 /* If the action is already finished then perform the error handling */
616 if (action->state != SIMIX_RUNNING)
617 SIMIX_execution_finish(action);
620 void SIMIX_host_execution_suspend(smx_action_t action)
622 if(action->execution.surf_exec)
623 surf_action_suspend(action->execution.surf_exec);
626 void SIMIX_host_execution_resume(smx_action_t action)
628 if(action->execution.surf_exec)
629 surf_action_resume(action->execution.surf_exec);
632 void SIMIX_execution_finish(smx_action_t action)
634 xbt_fifo_item_t item;
635 smx_simcall_t simcall;
637 xbt_fifo_foreach(action->simcalls, item, simcall, smx_simcall_t) {
639 switch (action->state) {
642 /* do nothing, action done */
643 XBT_DEBUG("SIMIX_execution_finished: execution successful");
647 XBT_DEBUG("SIMIX_execution_finished: host '%s' failed", sg_host_name(simcall->issuer->smx_host));
648 simcall->issuer->context->iwannadie = 1;
649 SMX_EXCEPTION(simcall->issuer, host_error, 0, "Host failed");
653 XBT_DEBUG("SIMIX_execution_finished: execution canceled");
654 SMX_EXCEPTION(simcall->issuer, cancel_error, 0, "Canceled");
658 xbt_die("Internal error in SIMIX_execution_finish: unexpected action state %d",
661 /* check if the host is down */
662 if (surf_resource_get_state(surf_workstation_resource_priv(simcall->issuer->smx_host)) != SURF_RESOURCE_ON) {
663 simcall->issuer->context->iwannadie = 1;
666 simcall->issuer->waiting_action = NULL;
667 simcall_host_execution_wait__set__result(simcall, action->state);
668 SIMIX_simcall_answer(simcall);
671 /* We no longer need it */
672 SIMIX_host_execution_destroy(action);
676 void SIMIX_post_host_execute(smx_action_t action)
678 if (action->type == SIMIX_ACTION_EXECUTE && /* FIMXE: handle resource failure
679 * for parallel tasks too */
680 surf_resource_get_state(surf_workstation_resource_priv(action->execution.host)) == SURF_RESOURCE_OFF) {
681 /* If the host running the action failed, notice it so that the asking
682 * process can be killed if it runs on that host itself */
683 action->state = SIMIX_FAILED;
684 } else if (surf_action_get_state(action->execution.surf_exec) == SURF_ACTION_FAILED) {
685 /* If the host running the action didn't fail, then the action was
687 action->state = SIMIX_CANCELED;
689 action->state = SIMIX_DONE;
692 if (action->execution.surf_exec) {
693 surf_action_unref(action->execution.surf_exec);
694 action->execution.surf_exec = NULL;
697 /* If there are simcalls associated with the action, then answer them */
698 if (xbt_fifo_size(action->simcalls)) {
699 SIMIX_execution_finish(action);
705 void simcall_HANDLER_set_category(smx_simcall_t simcall, smx_action_t action,
706 const char *category){
707 SIMIX_set_category(action, category);
709 void SIMIX_set_category(smx_action_t action, const char *category)
711 if (action->state != SIMIX_RUNNING) return;
712 if (action->type == SIMIX_ACTION_EXECUTE){
713 surf_action_set_category(action->execution.surf_exec, category);
714 }else if (action->type == SIMIX_ACTION_COMMUNICATE){
715 surf_action_set_category(action->comm.surf_comm, category);
721 * \brief Function to get the parameters of the given the SIMIX host.
723 * \param host the host to get_phys_host (a smx_host_t)
724 * \param param the parameter object space to be overwritten (a ws_params_t)
726 void SIMIX_host_get_params(smx_host_t ind_vm, ws_params_t params)
728 /* jump to ws_get_params(). */
729 surf_workstation_get_params(ind_vm, params);
732 void simcall_HANDLER_host_get_params(smx_simcall_t simcall, smx_host_t ind_vm, ws_params_t params)
734 SIMIX_host_get_params(ind_vm, params);
737 void SIMIX_host_set_params(smx_host_t ind_vm, ws_params_t params)
739 /* jump to ws_set_params(). */
740 surf_workstation_set_params(ind_vm, params);
743 void simcall_HANDLER_host_set_params(smx_simcall_t simcall, smx_host_t ind_vm, ws_params_t params)
745 SIMIX_host_set_params(ind_vm, params);
748 xbt_dict_t simcall_HANDLER_host_get_mounted_storage_list(smx_simcall_t simcall, smx_host_t host){
749 return SIMIX_host_get_mounted_storage_list(host);
752 xbt_dict_t SIMIX_host_get_mounted_storage_list(smx_host_t host){
753 xbt_assert((host != NULL), "Invalid parameters (simix host is NULL)");
755 return surf_workstation_get_mounted_storage_list(host);
758 xbt_dynar_t simcall_HANDLER_host_get_attached_storage_list(smx_simcall_t simcall, smx_host_t host){
759 return SIMIX_host_get_attached_storage_list(host);
762 xbt_dynar_t SIMIX_host_get_attached_storage_list(smx_host_t host){
763 xbt_assert((host != NULL), "Invalid parameters (simix host is NULL)");
765 return surf_workstation_get_attached_storage_list(host);