1 /* Copyright (c) 2006, 2007, 2008, 2009, 2010. 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. */
8 #include "simdag/simdag.h"
10 #include "xbt/sysdep.h"
11 #include "surf/surf.h"
13 /* Creates a link and registers it in SD.
15 SD_link_t __SD_link_create(void *surf_link, void *data)
21 link = xbt_new(s_SD_link_t, 1);
22 link->surf_link = surf_link;
23 link->data = data; /* user data */
24 if (surf_workstation_model->extension.workstation.link_shared(surf_link))
25 link->sharing_policy = SD_LINK_SHARED;
27 link->sharing_policy = SD_LINK_FATPIPE;
29 name = SD_link_get_name(link);
30 xbt_lib_set(link_lib,name,SD_LINK_LEVEL,link);
36 * \brief Returns the link list
38 * Use SD_link_get_number() to know the array size.
40 * \return an array of \ref SD_link_t containing all links
41 * \see SD_link_get_number()
43 const SD_link_t *SD_link_get_list(void)
46 xbt_lib_cursor_t cursor;
51 if (sd_global->link_list == NULL) { /* this is the first time the function is called */
52 sd_global->link_list = xbt_new(SD_link_t, link_lib->count);
55 xbt_lib_foreach(link_lib, cursor, key, data) {
56 sd_global->link_list[i++] = (SD_link_t) data[SD_LINK_LEVEL];
59 return sd_global->link_list;
63 * \brief Returns the number of links
65 * \return the number of existing links
66 * \see SD_link_get_list()
68 int SD_link_get_number(void)
70 return link_lib->count;
74 * \brief Returns the user data of a link
77 * \return the user data associated with this link (can be \c NULL)
78 * \see SD_link_set_data()
80 void *SD_link_get_data(SD_link_t link)
86 * \brief Sets the user data of a link
88 * The new data can be \c NULL. The old data should have been freed first
89 * if it was not \c NULL.
92 * \param data the new data you want to associate with this link
93 * \see SD_link_get_data()
95 void SD_link_set_data(SD_link_t link, void *data)
101 * \brief Returns the name of a link
104 * \return the name of this link (cannot be \c NULL)
106 const char *SD_link_get_name(SD_link_t link)
108 return surf_resource_name(link->surf_link);
112 * \brief Returns the current bandwidth of a link
115 * \return the current bandwidth of this link, in bytes per second
117 double SD_link_get_current_bandwidth(SD_link_t link)
119 return surf_workstation_model->extension.workstation.
120 get_link_bandwidth(link->surf_link);
124 * \brief Returns the current latency of a link
127 * \return the current latency of this link, in seconds
129 double SD_link_get_current_latency(SD_link_t link)
131 return surf_workstation_model->extension.workstation.
132 get_link_latency(link->surf_link);
136 * \brief Returns the sharing policy of this workstation.
139 * \return the sharing policyfor the flows going through this link:
140 * SD_LINK_SHARED or SD_LINK_FATPIPE
143 e_SD_link_sharing_policy_t SD_link_get_sharing_policy(SD_link_t link)
145 return link->sharing_policy;
151 void __SD_link_destroy(void *link)
153 /* link->surf_link is freed by surf_exit and link->data is freed by the user */