Functions

Management functions of Hosts
[MSG native]

This section describes the host structure of MSG. More...

Functions

MSG_error_t MSG_host_set_data (m_host_t host, void *data)
 Set the user data of a m_host_t.
void * MSG_host_get_data (m_host_t host)
 Return the user data of a m_host_t.
const char * MSG_host_get_name (m_host_t host)
 Return the name of the m_host_t.
m_host_t MSG_host_self (void)
 Return the location on which the current process is executed.
int MSG_get_host_number (void)
 Return the current number of m_host_t.
m_host_tMSG_get_host_table (void)
 Return a array of all the m_host_t.
int MSG_get_host_msgload (m_host_t h)
 Return the number of MSG tasks currently running on a m_host_t. The external load is not taken in account.
double MSG_get_host_speed (m_host_t h)
 Return the speed of the processor (in flop/s), regardless of the current load on the machine.
const char * MSG_host_get_property_value (m_host_t host, const char *name)
 Returns the value of a given host property.
xbt_dict_t MSG_host_get_properties (m_host_t host)
 Returns a xbt_dynar_t consisting of the list of properties assigned to this host.

Detailed Description

This section describes the host structure of MSG.

(m_host_t) and the functions for managing it.

A location (or host) is any possible place where a process may run. Thus it may be represented as a physical resource with computing capabilities, some mailboxes to enable running process to communicate with remote ones, and some private data that can be only accessed by local process.

See also:
m_host_t

Function Documentation

MSG_error_t MSG_host_set_data ( m_host_t  host,
void *  data 
)

Set the user data of a m_host_t.

This functions checks whether some data has already been associated to host or not and attach data to host if it is possible.

void* MSG_host_get_data ( m_host_t  host  ) 

Return the user data of a m_host_t.

This functions checks whether host is a valid pointer or not and return the user data associated to host if it is possible.

const char* MSG_host_get_name ( m_host_t  host  ) 

Return the name of the m_host_t.

This functions checks whether host is a valid pointer or not and return its name.

const char* MSG_host_get_property_value ( m_host_t  host,
const char *  name 
)

Returns the value of a given host property.

Parameters:
host a host
name a property name
Returns:
value of a property (or NULL if property not set)
xbt_dict_t MSG_host_get_properties ( m_host_t  host  ) 

Returns a xbt_dynar_t consisting of the list of properties assigned to this host.

Parameters:
host a host
Returns:
a dict containing the properties


Back to the main Simgrid Documentation page Generated for SimGridAPI by doxygen