XBT:
* Logs:
- Add new runtime parameters --help-logs and --help-log-categories
- to display informations about supported logging parameters and
+ to display information about supported logging parameters and
categories.
- Old deprecated parameters --{gras,surf,msg,simix,xbt}-log=...
don't exists anymore.
SIMIX:
* New SIMIX network module. Provides:
- - Mailbox: rendez-vous mecanism to find with who you want to speak
+ - Mailbox: rendez-vous mechanism to find with who you want to speak
- Synchronous send/recv: easier and hopefully faster since the
logic is handled in the maestro process directly now
- Asynchronous send/recv: you dreamt of it? It's here now
(just like the main() function)
GRAS new features and improvements:
- * New module mecanism where user code can use per process globals [Mt]
+ * New module mechanism where user code can use per process globals [Mt]
This is similar to gras_userdata_*() functions, but for libraries. It
factorize some code developped over and over in the examples and AMOK.
It has still to be documented and used (only amok/peermanagement is
converted for now).
- * Fix a vicious bug in the TCP buffering mecanism which leaded to message
+ * Fix a vicious bug in the TCP buffering mechanism which leaded to message
loss when they were small enough to fit into the buffer and sent quickly
enough so that they can all get received in one shoot.
* gras_datadesc_by_name and gras_msgtype_by_name: now raise an exception
XBT:
* When running manually src/testall, you select specific units [Mt]
- testall is the result of our cunit mecanism, and should replace all
+ testall is the result of our cunit mechanism, and should replace all
the scripty thingy around since bash don't run easily on billware.
* A mallocator system has been added. [Christophe Thiery]
. Lesson 3: Passing arguments to the processes (in SG)
. Lesson 4: Attaching callbacks to messages
. Lesson 5: Using globals in processes
- . Lesson 6: Logging informations properly
+ . Lesson 6: Logging information properly
. Lesson 7: Using internal timers
. Lesson 8: Handling errors through exceptions
. Lesson 9: Exchanging simple data
is up or down. [AL]
GRAS:
- * New! a real RPC mecanism, as it ought to be since too long. [MQ]
+ * New! a real RPC mechanism, as it ought to be since too long. [MQ]
Exception occurring on server-side are propagated back to client (!).
API CHANGE: the callback changed their prototype. Change:
- Don't use it for receive since we send data sizes and data on the
same stream, so we wouldn't be able to chain large amount of chunks
before having to flush the stuff to read the size.
- * Rework the transport plugin mecanism to simplify it and reduce the
+ * Rework the transport plugin mechanism to simplify it and reduce the
amount of pointer dereferencement when searching for the right function
to use.
XBT:
* New! Exception handling with setjmp or such (code from OSSP ex) [MQ]
- This deprecates the xbt_error_t mecanisms.
+ This deprecates the xbt_error_t mechanisms.
It modifies (simplifies) all XBT and GRAS API.
MSG API keeps unchanged (exceptions raised by XBT are catched from
within MSG and masked with existing error handling facilities)
* Add xbt_os_time(). As the rest of xbt/portability, this is not public
for users. Instead, each programming environment (GRAS, MSG,...) use it
when needed to provide such a feature to users.
- Don't shortcut the mecanism or you will also shortcut the virtualization
+ Don't shortcut the mechanism or you will also shortcut the virtualization
you need on the simulator.
>>>Martin<<<
* Rename gras_get_my_fqdn to gras_os_myname and implement it in the simulator
RL would imply a DNS resolver, which is *hard* to do in a portable way
(and therefore delayed).
- * Implement a real timer mecanism and use it in timing macros. This allows
+ * Implement a real timer mechanism and use it in timing macros. This allows
to avoid rounding errors and get a 0.000005 sec precision in timing
macros. While I was at it, various cleanups:
- allow to declare more than one timed section per file (fix a stupid bug)
2004-07-13 Martin Quinson
version 0.1
- - No major issue in previous version => change versionning schema
+ - No major issue in previous version => change versioning schema
- Re-enable little64 convertion test now that Abdou kindly regenerated the
corresponding dataset.
\subsubsection faq_trouble_err_logcat "gcc: _simgrid_this_log_category_does_not_exist__??? undeclared (first use in this function)"
-This is because you are using the log mecanism, but you didn't created
+This is because you are using the log mechanism, but you didn't created
any default category in this file. You should refer to \ref XBT_log
for all the details, but you simply forgot to call one of
XBT_LOG_NEW_DEFAULT_CATEGORY() or XBT_LOG_NEW_DEFAULT_SUBCATEGORY().
==21434== at 0x420DC3A: __longjmp (__longjmp.S:48)
\endverbatim
-This is the sign that you didn't used the exception mecanism well. Most
+This is the sign that you didn't used the exception mechanism well. Most
probably, you have a <tt>return;</tt> somewhere within a <tt>TRY{}</tt>
block. This is <b>evil</b>, and you must not do this. Did you read the section
about \ref XBT_ex??
Unfortunately, we cannot debug every code written in SimGrid. We
furthermore believe that the framework provides ways enough
-information to debug such informations yourself. If the textual output
+information to debug such information yourself. If the textual output
is not enough, Make sure to check the \ref faq_visualization FAQ entry to see
how to get a graphical one.
considered as an informative documentation and can be omitted), and
give any information you feel useful to the user. In particular, add
links to any other location of the documentation that could provide
-interesting additional informations.
+interesting additional information.
\section inside_doxygen_page Adding a new page to the user guide
pthreads or windows native threads)
- \b ucontext: fast factory using System V contexts (or a portability
layer of our own on top of Windows fibers)
- - \b raw: amazingly fast factory using a context switching mecanism
+ - \b raw: amazingly fast factory using a context switching mechanism
of our own, directly implemented in assembly (only available for x86
and amd64 platforms for now)
- \b boost: This uses the [context implementation](http://www.boost.org/doc/libs/1_59_0/libs/context/doc/html/index.html)
Use that amount of processes. By default, there is the same number of processes as there are of hosts in the hostfile.
.TP
\fB\-trace\fR
-Equivalent to \fB–cfg\fR=\fItracing\fR:\fIyes\fR \fB–cfg\fR=\fItracing/smpi\fR:\fIyes\fR, activate the trace mecanism if available.
+Equivalent to \fB–cfg\fR=\fItracing\fR:\fIyes\fR \fB–cfg\fR=\fItracing/smpi\fR:\fIyes\fR, activate the trace mechanism if available.
.TP
\fB\-trace-ti\fR
Activate time independant tracing.
* suspend/suspend.c: Demonstrates how to suspend and resume processes
using MSG_process_suspend() and MSG_process_resume().
- * properties/msg_prop.c Attaching arbitrary informations to host,
+ * properties/msg_prop.c Attaching arbitrary information to host,
processes and such, and retrieving them with
MSG_host_get_properties(), MSG_host_get_property_value(),
MSG_process_get_properties() and MSG_process_get_property_value().
// Once upon a time, our code assumed that here, task_received != task_sent all the time
//
// This assumption is wrong (as messages from differing round can interleave), leading to a bug in our code.
- // We failed to find this bug directly, as it only occured on large platforms, leading to hardly usable traces.
+ // We failed to find this bug directly, as it only occurred on large platforms, leading to hardly usable traces.
// Instead, we used the model-checker to track down the issue by adding the following test here in the code:
// if (MC_is_active()) {
// MC_assert(task_received == task_sent);
/** @addtogroup MSG_examples
*
- * - <b>User-defined properties: properties/properties.c</b> Attaching arbitrary informations to host, processes and
+ * - <b>User-defined properties: properties/properties.c</b> Attaching arbitrary information to host, processes and
* such, and retrieving them with @ref MSG_host_get_properties, @ref MSG_host_get_property_value,
* @ref MSG_process_get_properties, and @ref MSG_process_get_property_value. Also make sure to read the platform and
* deployment XML files to see how to declare these data.
-/* xbt/asserts.h -- assertion mecanism */
+/* xbt/asserts.h -- assertion mechanism */
/* Copyright (c) 2005-2007, 2009-2014. The SimGrid Team.
* All rights reserved. */
*
* @{
*/
-/** @brief Provide informations about the suite declared in this file
+/** @brief Provide information about the suite declared in this file
* @hideinitializer
*
* Actually, this macro is only used by the script extracting the test units, but that should be transparent for you.
/** @brief Declare that the lastly started test was expected to fail (and actually failed) */
XBT_PUBLIC(void) xbt_test_expect_failure(void);
-/** @brief Declare that the lastly started test should be skiped today */
+/** @brief Declare that the lastly started test should be skipped today */
XBT_PUBLIC(void) xbt_test_skip(void);
/** @} */
*
* The simulation is not cleaned afterward (see
* {@link #clean()} if you really insist on cleaning the C side), so you can freely
- * retrieve the informations that you want from the simulation. In particular, retrieving the status
+ * retrieve the information that you want from the simulation. In particular, retrieving the status
* of a process or the current date is perfectly ok.
*/
public final static native void run() ;
XBT_PUBLIC(surf_action_t) surf_host_write(sg_host_t host, surf_file_t fd, sg_size_t size);
/**
- * @brief Get the informations of a file descriptor
+ * @brief Get the information of a file descriptor
* @details The returned xbt_dynar_t contains:
* - the size of the file,
* - the mount point,
*
* @param host The surf host
* @param fd The file descriptor
- * @return An xbt_dynar_t with the file informations
+ * @return An xbt_dynar_t with the file information
*/
XBT_PUBLIC(xbt_dynar_t) surf_host_get_info(sg_host_t host, surf_file_t fd);
/**
* \ingroup msg_task_usage
- * \brief Returns the error (if any) that occured during a finished communication.
+ * \brief Returns the error (if any) that occurred during a finished communication.
* \param comm a finished communication
- * \return the status of the communication, or #MSG_OK if no error occured
+ * \return the status of the communication, or #MSG_OK if no error occurred
* during the communication
*/
msg_error_t MSG_comm_get_status(msg_comm_t comm) {
ret = MSG_task_recv(&task, ms->mbox);
{
if (ret != MSG_OK) {
- // An error occured, clean the code and return
+ // An error occurred, clean the code and return
// The owner did not change, hence the task should be only destroyed on the other side
xbt_free(finalize_task_name);
return 0;
}
#endif
- /* wait until the migration have finished or on error has occured */
+ /* wait until the migration have finished or on error has occurred */
{
XBT_DEBUG("wait for reception of the final ACK (i.e. migration has been correctly performed");
msg_task_t task = NULL;
return task->kind;
}
-/** @brief Displays debugging informations about a task */
+/** @brief Displays debugging information about a task */
void SD_task_dump(SD_task_t task)
{
unsigned int counter;
return (const char*) xbt_dict_get_or_null(sg_host_get_properties(host), name);
}
-/** @brief Displays debugging informations about a host */
+/** @brief Displays debugging information about a host */
void sg_host_dump(sg_host_t host)
{
xbt_dict_t props;
# CallType must be one of the three:
#
# - Func: returning a value immediately (within the same scheduling round)
-# examples: all getters that only retrieve informations with no side effect
+# examples: all getters that only retrieve information with no side effect
#
# - Proc: not returning any value (but doing so immediately)
# examples: all setters, *_cancel
#ifdef TIME_BENCH_AMDAHL
xbt_os_cputimer_stop(simix_global->timer_seq);
- XBT_INFO("Amdahl timing informations. Sequential time: %f; Parallel time: %f",
+ XBT_INFO("Amdahl timings. Sequential time: %f; Parallel time: %f",
xbt_os_timer_elapsed(simix_global->timer_seq),
xbt_os_timer_elapsed(simix_global->timer_par));
xbt_os_timer_free(simix_global->timer_seq);
case EEXIST:
xbt_die("Please cleanup /dev/shm/%s", shmname);
default:
- xbt_die("An unhandled error occured while opening %s. shm_open: %s", shmname, strerror(errno));
+ xbt_die("An unhandled error occurred while opening %s. shm_open: %s", shmname, strerror(errno));
}
}
data->second.fd = fd;
// TODO : we have to check for zeros and negative numbers, or it might crash
if (parameters.size() != 4){
- surf_parse_error("Fat trees are defined by the levels number and 3 vectors, see the documentation for more informations");
+ surf_parse_error("Fat trees are defined by the levels number and 3 vectors, see the documentation for more information");
}
// The first parts of topo_parameters should be the levels number
boost::split(tmp, parameters[1], boost::is_any_of(","));
if(tmp.size() != this->levels_) {
surf_parse_error("Fat trees are defined by the levels number and 3 vectors"
- ", see the documentation for more informations");
+ ", see the documentation for more information");
}
for(size_t i = 0 ; i < tmp.size() ; i++){
this->lowerLevelNodesNumber_.push_back(xbt_str_parse_int(tmp[i].c_str(), "Invalid lower level node number: %s"));
boost::split(tmp, parameters[2], boost::is_any_of(","));
if(tmp.size() != this->levels_) {
surf_parse_error("Fat trees are defined by the levels number and 3 vectors"
- ", see the documentation for more informations");
+ ", see the documentation for more information");
}
for(size_t i = 0 ; i < tmp.size() ; i++){
this->upperLevelNodesNumber_.push_back(xbt_str_parse_int(tmp[i].c_str(), "Invalid upper level node number: %s"));
boost::split(tmp, parameters[3], boost::is_any_of(","));
if(tmp.size() != this->levels_) {
surf_parse_error("Fat trees are defined by the levels number and 3 vectors"
- ", see the documentation for more informations");
+ ", see the documentation for more information");
}
for(size_t i = 0 ; i < tmp.size() ; i++){
* Things are rather complex here because we have to find the path from ASes to ASes, and within each.
* In addition, the different ASes may use differing routing models.
* Some ASes may be routed in full, others may have only some connection information and use a shortest path on top of that, and so on.
- * Some ASes may even not have any predefined links and use only coordinate informations to compute the latency.
+ * Some ASes may even not have any predefined links and use only coordinate information to compute the latency.
*
* So, the path is constructed recursively, with each traversed AS adding its information to the set.
* The algorithm for that is explained in http://hal.inria.fr/hal-00650233/
enum class RoutingMode {
unset = 0, /**< Undefined type */
base, /**< Base case: use simple link lists for routing */
- recursive /**< Recursive case: also return gateway informations */
+ recursive /**< Recursive case: also return gateway information */
};
/* FIXME: protect the following fields once the construction madness is sorted out */
RoutingMode hierarchy_ = RoutingMode::unset;
virtual Action *write(surf_file_t fd, sg_size_t size);
/**
- * @brief Get the informations of a file descriptor
+ * @brief Get the information of a file descriptor
* @details The returned xbt_dynar_t contains:
* - the size of the file,
* - the mount point,
* - the storage content type
*
* @param fd The file descriptor
- * @return An xbt_dynar_t with the file informations
+ * @return An xbt_dynar_t with the file information
*/
virtual xbt_dynar_t getInfo(surf_file_t fd);
xbt_swag_remove(cnst, &sys->modified_constraint_set); } while (0)
/** @ingroup SURF_lmm
- * @brief Print informations about a lmm system
+ * @brief Print information about a lmm system
*
* @param sys A lmm system
*/
void xbt_test_skip(void)
{
xbt_assert(xbt_dynar_length(_xbt_test_current_unit->tests),
- "Test skiped even before being declared (broken unit: %s)", _xbt_test_current_unit->title);
+ "Test skipped even before being declared (broken unit: %s)", _xbt_test_current_unit->title);
xbt_test_test_t test = xbt_dynar_getlast_as(_xbt_test_current_unit->tests, xbt_test_test_t);
test->ignored = 1;
}
#include "simgrid/simix.h" /* SIMIX_process_self_get_name() */
-XBT_LOG_NEW_DEFAULT_SUBCATEGORY(xbt_ex, xbt, "Exception mecanism");
+XBT_LOG_NEW_DEFAULT_SUBCATEGORY(xbt_ex, xbt, "Exception mechanism");
XBT_EXPORT_NO_IMPORT(const xbt_running_ctx_t) __xbt_ex_ctx_initializer = XBT_RUNNING_CTX_INITIALIZER;
-/* synchro_crashtest -- tries to crash the logging mecanism by doing // logs*/
+/* synchro_crashtest -- tries to crash the logging mechanism by doing // logs*/
/* Copyright (c) 2007-2014. The SimGrid Team.
* All rights reserved. */
XBT_LOG_NEW_DEFAULT_CATEGORY(synchro_crashtest, "Logs of this example");
-int test_amount = 99; /* Up to 999 to not break the logs (and thus the testing mecanism) */
-int crasher_amount = 99; /* Up to 99 to not break the logs (and thus the testing mecanism) */
+int test_amount = 99; /* Up to 999 to not break the logs (and thus the testing mechanism) */
+int crasher_amount = 99; /* Up to 99 to not break the logs (and thus the testing mechanism) */
int *id; /* to pass a pointer to the threads without race condition */
int more_info = 0; /* SET IT TO TRUE TO GET MORE INFO */
xbt_init(&argc, argv);
- /* initializations of the philosopher mecanisms */
+ /* initializations of the philosopher mechanisms */
id = xbt_new0(int, crasher_amount);
crashers = xbt_new(xbt_os_thread_t, crasher_amount);
! timeout 20
-p Try to crash the log mecanism by using it in parallel with a lot of threads
+p Try to crash the log mechanism by using it in parallel with a lot of threads
$ ${bindir:=.}/parallel_log_crashtest "--log=root.fmt:%m%n"
> XXX (XX|XX|XX|XX|XX|XX|XX|XX|XX)
> XXX (XX|XX|XX|XX|XX|XX|XX|XX|XX)
SELECT:
while ( $self->pumpable ) {
if ( $io_occurred && $self->{break_on_io} ) {
- _debug "exiting _select(): io occured and break_on_io set"
+ _debug "exiting _select(): io occurred and break_on_io set"
if _debugging_details;
last;
}
=item
-The version attribute of platform were added to allow file versionning.
+The version attribute of platform were added to allow file versioning.
=item
The solution is to prefix each line of your output with temporal
information so that lines can be grouped by timestamps. The
-lexicographical sort then only applies to lines that occured at the
+lexicographical sort then only applies to lines that occurred at the
same timestamp. Here is a SimGrid example:
# Sort only lines depending on the first 19 chars
eval {
finish( $cmd{'job'} );
};
- if ($@) { # deal with the errors that occured in the child process
+ if ($@) { # deal with the errors that occurred in the child process
if ($@ =~ /timeout/) {
$cmd{'job'}->kill_kill;
$cmd{'timeouted'} = 1;
