home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / MPI_Init.z / MPI_Init
Encoding:
Text File  |  2002-10-03  |  4.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. MMMMPPPPIIII____IIIINNNNIIIITTTT((((3333))))                                                        MMMMPPPPIIII____IIIINNNNIIIITTTT((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      MMMMPPPPIIII____IIIInnnniiiitttt - Initializes the MPI execution environment
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      C:
  13.  
  14.           #include <mpi.h>
  15.  
  16.           int MPI_Init(_a_r_g_c,_a_r_g_v)
  17.           int  *_a_r_g_c;
  18.           char ***_a_r_g_v;
  19.  
  20.  
  21.      C++:
  22.  
  23.           #include <mpi.h>
  24.  
  25.           void Init()
  26.  
  27.  
  28.      Fortran:
  29.  
  30.           INCLUDE "mpif.h" (or USE MPI)
  31.  
  32.           INTEGER error
  33.  
  34.           CALL MPI_INIT(error)
  35.  
  36.  
  37. SSSSTTTTAAAANNNNDDDDAAAARRRRDDDDSSSS
  38.      This release implements the MPI 1.2 standard, as documented by the MPI
  39.      Forum in the spring 1997 release of _M_P_I:  _A _M_e_s_s_a_g_e _P_a_s_s_i_n_g _I_n_t_e_r_f_a_c_e
  40.      _S_t_a_n_d_a_r_d.
  41.  
  42. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  43.      The MMMMPPPPIIII____IIIInnnniiiitttt routine initializes the MPI execution environment.  This
  44.      routine accepts the following parameters:
  45.  
  46.      _a_r_g_c      Specifies a pointer to the number of arguments
  47.  
  48.      _a_r_g_v      Specifies a pointer to the argument vector
  49.  
  50.      _i_e_r_r_o_r    Specifies the return code value for successful completion,
  51.                which is in MPI_SUCCESS.  MPI_SUCCESS is defined in the mmmmppppiiiiffff....hhhh
  52.                file.
  53.  
  54.      MPI specifies no command-line arguments, but does allow an MPI
  55.      implementation to make use of them.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MMMMPPPPIIII____IIIINNNNIIIITTTT((((3333))))                                                        MMMMPPPPIIII____IIIINNNNIIIITTTT((((3333))))
  71.  
  72.  
  73.  
  74. NOTES
  75.      The Fortran binding for this routine has only the error return argument
  76.      (MMMMPPPPIIII____IIIINNNNIIIITTTT(_i_e_r_r_o_r)).
  77.  
  78.      Because the Fortran and C versions of MMMMPPPPIIII____IIIInnnniiiitttt are different, there is a
  79.      restriction on who can call MMMMPPPPIIII____IIIInnnniiiitttt.  The version (Fortran or C) must
  80.      match the main program.  That is, if the main program is in C, the C
  81.      version of MMMMPPPPIIII____IIIInnnniiiitttt must be called.  If the main program is in Fortran,
  82.      the Fortran version must be called.
  83.  
  84.      On exit from this routine, all processes will have a copy of the argument
  85.      list.  This is .ft3 not required by the MPI standard, and truly portable
  86.      codes should not rely on it.  This is provided as a service by this
  87.      implementation (an MPI implementation is allowed to distribute the
  88.      command line arguments but is not required to).
  89.  
  90.      Command line arguments are not provided to Fortran programs.  More
  91.      precisely, nonstandard Fortran routines such as GGGGEEEETTTTAAAARRRRGGGG(3F) and IIIIAAAARRRRGGGGCCCC(3F)
  92.      have undefined behavior in MPI and in this implementation.
  93.  
  94.      The MPI standard does not say what a program can do before an MMMMPPPPIIII____IIIInnnniiiitttt
  95.      operation or after an MMMMPPPPIIII____FFFFiiiinnnnaaaalllliiiizzzzeeee(3) operation.
  96.  
  97.      Shared-memory mode uses no signals.  TCP mode uses SSSSIIIIGGGGUUUUSSSSRRRR1111.
  98.  
  99. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  100.      GGGGEEEETTTTAAAARRRRGGGG(3F), IIIIAAAARRRRGGGGCCCC(3F), MMMMPPPPIIII____FFFFiiiinnnnaaaalllliiiizzzzeeee(3)
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.