MPCXX_INITIALIZE(3)
MTTL-ULT LIBRARY (C)
MPCXX_INITIALIZE(3)
NAME
mpcxx_initialize - initialize MTTL-ULT thread library

SYNOPSIS
#include <mpcxx.h>

void mpcxx_initialize(int argc, char **argv);

DESCRIPTION
The mpcxx_initialize() function initializes the MTTL-ULT thread library. All MTTL-related functions must be called after calling mpcxx_initialize(). The arguments argc and argv must be the same as those passed to the main() function.

Only the thread on node 0 will return from the call to mpcxx_initialize(). The other threads will just wait for messages from node 0.

When a thread calls the exit() function, the entire parallel process will be terminated. This is not the case for an MPC++ program initialized using mpcxx_spmd_initialize().

NOTES
Do not print out messages to standard output before calling mpcxx_initialize().

BUGS
All Sync and GlobalPtr objects are NOT initialized until after mpcxx_initialize() is called. Those objects in a file scope are also NOT initialized. Further, automatic objects in the main() function are NOT initialized.

SEE ALSO
MPC++ Getting Started, MPC++ Multi-Threaded Template Library, mpcxx_spmd_initialize(3)

CREDIT
This document is a part of the SCore cluster system software developed at PC Cluster Consortium, Japan. Copyright (C) 2003 PC Cluster Consortium.