X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/891335d86e914cdc1ab32aff45c3930c3f6a3a03..0d2cd6f4e4e5c8b75159c79b7ae7d716cef99086:/src/msg/msg_host.c

diff --git a/src/msg/msg_host.c b/src/msg/msg_host.c
index 76df2333d5..6e1e568159 100644
--- a/src/msg/msg_host.c
+++ b/src/msg/msg_host.c
@@ -264,27 +264,33 @@ int MSG_host_is_avail(msg_host_t host)
   return (simcall_host_get_state(host));
 }
 
-/**
- * \ingroup msg_gos_functions
+/** \ingroup m_host_management
+ * \brief Return the speed of the processor (in flop/s) at a given pstate
  *
+ * \param  host host to test
+ * \param pstate_index pstate to test
+ * \return Returns the processor speed associated with pstate_index
  */
 double MSG_get_host_power_peak_at(msg_host_t host, int pstate_index) {
 	  xbt_assert((host != NULL), "Invalid parameters (host is NULL)");
 	  return (simcall_host_get_power_peak_at(host, pstate_index));
 }
 
-/**
- * \ingroup msg_gos_functions
+/** \ingroup m_host_management
+ * \brief Return the current speed of the processor (in flop/s)
  *
+ * \param  host host to test
+ * \return Returns the current processor speed
  */
 double MSG_get_host_current_power_peak(msg_host_t host) {
 	  xbt_assert((host != NULL), "Invalid parameters (host is NULL)");
 	  return simcall_host_get_current_power_peak(host);
 }
 
-/**
- * \ingroup msg_gos_functions
+/** \ingroup m_host_management
+ * \brief Return the number of pstates defined for a host
  *
+ * \param  host host to test
  */
 int MSG_get_host_nb_pstates(msg_host_t host) {
 
@@ -292,9 +298,11 @@ int MSG_get_host_nb_pstates(msg_host_t host) {
 	  return (simcall_host_get_nb_pstates(host));
 }
 
-/**
- * \ingroup msg_gos_functions
+/** \ingroup m_host_management
+ * \brief Sets the speed of the processor (in flop/s) at a given pstate
  *
+ * \param  host host to test
+ * \param pstate_index pstate to switch to
  */
 void MSG_set_host_power_peak_at(msg_host_t host, int pstate_index) {
 	  xbt_assert((host != NULL), "Invalid parameters (host is NULL)");
@@ -302,9 +310,11 @@ void MSG_set_host_power_peak_at(msg_host_t host, int pstate_index) {
 	  simcall_host_set_power_peak_at(host, pstate_index);
 }
 
-/**
- * \ingroup msg_gos_functions
+/** \ingroup m_host_management
+ * \brief Return the total energy consumed by a host (in Joules)
  *
+ * \param  host host to test
+ * \return Returns the consumed energy
  */
 double MSG_get_host_consumed_energy(msg_host_t host) {
 	  xbt_assert((host != NULL), "Invalid parameters (host is NULL)");