This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

MPI_Status_f2c(3OpenMPI)                                                            MPI_Status_f2c(3OpenMPI)



NAME
       Status conversion routines  - Translates a C status into a Fortran status, or vice versa.


SYNTAX
C Syntax
       #include <mpi.h>
       int MPI_Status_f2c(MPI_Fint *f_status, MPI_Status *c_status)
       int MPI_Status_c2f(MPI_Status *c_status, MPI_Fint *f_status)


DESCRIPTION
       These  two  procedures are provided in C to convert from a Fortran status (which is an array of inte-gers) integers)
       gers) to a C status (which is a structure), and vice versa. The conversion occurs on all the informa-tion information
       tion in status, including that which is hidden. That is, no status information is lost in the conver-sion. conversion.
       sion.

       When using MPI_Status_f2c, if f_status is a valid Fortran  status,  but  not  the  Fortran  value  of
       MPI_STATUS_IGNORE  or  MPI_STATUSES_IGNORE,  then MPI_Status_f2c returns in c_status a valid C status
       with the same content. If f_status is the Fortran value of MPI_STATUS_IGNORE or  MPI_STATUSES_IGNORE,
       or if f_status is not a valid Fortran status, then the call is erroneous.

       When  using  MPI_Status_c2f,  the opposite conversion is applied. If c_status is MPI_STATUS_IGNORE or
       MPI_STATUSES_IGNORE, or if c_status is not a valid C status, then the call is erroneous.

       The C status has the same source, tag and error code values as the Fortran status,  and  returns  the
       same  answers  when  queried  for  count,  elements, and cancellation. The conversion function may be
       called with a Fortran status argument that has an undefined error field, in which case the  value  of
       the error field in the C status argument is undefined.






Open MPI 1.2                                   September 2006                       MPI_Status_f2c(3OpenMPI)