17.2.159. MPI_Finalize

MPI_Finalize — 终止MPI执行环境。

17.2.159.1. 语法

17.2.159.1.1. C语法

#include <mpi.h>

int MPI_Finalize()

17.2.159.1.2. Fortran语法

USE MPI
! or the older form: INCLUDE 'mpif.h'

MPI_FINALIZE(IERROR)
    INTEGER IERROR

17.2.159.1.3. Fortran 2008 语法

USE mpi_f08

MPI_Finalize(ierror)
    INTEGER, OPTIONAL, INTENT(OUT) :: ierror

17.2.159.2. 输出参数

ierror : 仅限Fortran：错误状态（整数）。

17.2.159.3. 描述

该例程用于清理所有MPI状态。一旦调用此例程，除MPI_Get_version、MPI_Initialized和MPI_Finalized外，不得再调用任何MPI例程（甚至包括MPI_Init）。除非已调用MPI_Abort，否则必须确保进程在调用MPI_Finalize前完成所有待处理的通信。若调用返回，每个进程可继续本地计算或直接退出，而无需与其他进程进行进一步通信。当最后一个进程调用MPI_Finalize时，所有待发送消息必须被接收操作匹配，所有待接收消息必须被发送操作匹配。

MPI_Finalize 在所有已连接的进程间具有集体性。如果没有任何进程被派生、接受或连接，则意味着它在 MPI_COMM_WORLD 范围内具有集体性。否则，它将在所有曾经连接且保持连接的进程集合上具有集体性。

17.2.159.4. 注意事项

所有进程在退出前都必须调用此例程。所有进程仍将存在，但不得再进行任何MPI调用。MPI_Finalize确保用户已完成的通信所需的所有本地操作都会在其返回前实际发生。然而，MPI_Finalize不保证未完成的待处理通信；只有通过MPI_Wait、MPI_Test或MPI_Request_free结合其他完成验证才能确保完成。

例如，阻塞通信操作或MPI_Wait、MPI_Test的成功返回意味着通信已由用户完成且缓冲区可被重用，但并不保证本地进程没有其他工作需要处理。同样，对于由MPI_Isend生成的请求句柄，MPI_Request_free的成功返回会使该句柄失效，但并不保证操作已完成。只有当匹配的接收操作完成时，MPI_Isend才算真正完成。

如果您希望在进程结束时触发某些操作，可以通过向MPI_COMM_SELF附加带有回调函数的属性来实现。当调用MPI_Finalize时，系统会首先执行相当于对MPI_COMM_SELF进行MPI_Comm_free的操作。这将导致与MPI_COMM_SELF关联的所有键上注册的删除回调函数以任意顺序执行。如果MPI_COMM_SELF上未附加任何键，则不会触发任何回调。MPI_COMM_SELF的释放操作发生在MPI其他部分受影响之前。因此在任何回调函数中调用MPI_Finalized都将返回"false"。完成对MPI_COMM_SELF的这些操作后，MPI_Finalize的执行结果将不再确定。

17.2.159.5. 错误

几乎所有MPI例程都会返回一个错误值；C语言例程通过函数返回值返回，Fortran例程则通过最后一个参数返回。

在返回错误值之前，会调用与通信对象（如通信器、窗口、文件）关联的当前MPI错误处理程序。如果MPI调用未关联任何通信对象，则该调用被视为附加到MPI_COMM_SELF，并将调用关联的MPI错误处理程序。当MPI_COMM_SELF未初始化时（即在MPI_Init/MPI_Init_thread之前、MPI_Finalize之后，或仅使用会话模型时），错误会触发初始错误处理程序。初始错误处理程序可通过在使用世界模型时调用MPI_Comm_set_errhandler来修改MPI_COMM_SELF，或通过mpiexec的mpi_initial_errhandler命令行参数，或MPI_Comm_spawn/MPI_Comm_spawn_multiple的info键来设置。如果未设置其他适当的错误处理程序，则MPI I/O函数将调用MPI_ERRORS_RETURN错误处理程序，而其他所有MPI函数将调用MPI_ERRORS_ABORT错误处理程序。

Open MPI 包含三个可使用的预定义错误处理器：

MPI_ERRORS_ARE_FATAL 导致程序中止所有连接的MPI进程。
MPI_ERRORS_ABORT 一个可在通信器、窗口、文件或会话上调用的错误处理程序。当在通信器上调用时，其行为类似于在该通信器上调用MPI_Abort。如果在窗口或文件上调用，则行为类似于在包含对应窗口或文件中进程组的通信器上调用MPI_Abort。如果在会话上调用，则仅中止本地进程。
MPI_ERRORS_RETURN 向应用程序返回一个错误代码。

MPI应用程序也可以通过调用以下方式实现自己的错误处理程序：

MPI_Comm_create_errhandler 然后 MPI_Comm_set_errhandler
MPI_File_create_errhandler 然后 MPI_File_set_errhandler
MPI_Session_create_errhandler 然后 MPI_Session_set_errhandler 或在 MPI_Session_init
MPI_Win_create_errhandler 然后 MPI_Win_set_errhandler

请注意，MPI不保证MPI程序在出现错误后能够继续运行。

查看MPI手册页获取完整的MPI错误代码列表。

有关更多信息，请参阅MPI-3.1标准中的错误处理部分。

另请参阅

MPI_Init