Реализация MPI может обрабатывать или не обрабатывать некоторые ошибки, которые возникают при выполнении вызовов MPI. Это могут быть ошибки, которые генерируют исключения или прерывания, например, ошибки для операций с плавающей точкой или при нарушении доступа. Набор ошибок, которые корректно обрабатываются MPI, зависит от реализации. Каждая такая ошибка генерирует исключение MPI.
Вышеупомянутый текст имеет приоритет над любым текстом по обработке ошибок внутри этого документа. Текст, в котором говорится, что ошибки будут обработаны, должен содержать информацию о том, как они могут быть обработаны.
Пользователь может связывать обработчик ошибок с коммуникатором. Эта процедура будет использоваться для любого исключения MPI, которое имеет место в течение вызова MPI для обмена с использованием этого коммуникатора. Вызовы MPI, которые не связаны ни с одним коммуникатором, рассматриваются, как относящиеся к коммуникатору MPI_COMM_WORLD.
Привязка обработчиков ошибок к коммуникатору исключительно локальная: различные процессы могут присоединить различные обработчики ошибок к тому же самому коммуникатору.
Вновь созданный коммуникатор наследует обработчик ошибок, который связан с ``родительским'' коммуникатором. В частности, пользователь может определить ``глобальный'' обработчик ошибок для всех коммуникаторов, связывая этот обработчик с коммуникатором MPI_COMM_WORLD сразу после инициализации.
В MPI доступны несколько предопределенных обработчиков ошибок :
Реализации могут обеспечивать дополнительные обработчики ошибок, программисты также могут написать свои собственные обработчики ошибок.
Обработчик ошибок MPI_ERRORS_ARE_FATAL связан по умолчанию с MPI_COMM_WORLD после его инициализации. Таким образом, если пользователь не желает управлять обработкой ошибок самостоятельно, то каждая ошибка в MPI обрабатывается как фатальная. Так как все вызовы MPI возвращают код ошибки, пользователь может работать с ошибками в головной программе, используя возвращенные вызовами MPI коды и выполняя подходящую программу восстановления в том случае, когда вызов не был успешным. В этом случае будет использоваться обработчик ошибок MPI_ERRORS_RETURN. Обычно более удобно и более эффективно не проверять ошибки после каждого вызова, а иметь специализированный обработчик ошибок.
После того, как ошибка обнаружена, состояние MPI является
неопределенным. Это означает, что даже если используется определенный
пользователем обработчик ошибок или
MPI_ERRORS_RETURN,
не обязательно, что пользователю будет разрешено продолжить использовать
MPI после того, как ошибка определена. Цель таких обработчиков состоит в
том, чтобы пользователь получил определенное им сообщение об ошибке и предпринял
действия, не относящиеся к MPI (такие, как очистки буферов
ввода/вывода) перед выходом из программы. Реализация MPI допускает
продолжение работы приложения после возникновения ошибки, но не требует,
чтобы так было всегда.
Совет разработчикам: Хорошие реализации MPI должны максимально ограничивать воздействие ошибки, чтобы нормальное функционирование могло продолжаться после того, как обработчик ошибок был запущен. В документации должна содержаться информация относительно возможного эффекта по каждому классу ошибок.[]
Обработчик ошибок MPI является скрытым объектом, связанным с дескриптором. Процедуры MPI обеспечивают создание новых обработчиков ошибок, связывают обработчики ошибок с коммуникаторами и проверяют, какой обработчик ошибок связан с коммуникатором.
Синтаксис функции MPI_ERRHANDLER_CREATE представлен ниже.
MPI_ERRHANDLER_CREATE(function, errhandler)
| IN | function | установленная пользователем процедура обработки ошибок | |
| OUT | errhandler | MPI обработчик ошибок (дескриптор) |
int MPI_Errhandler_create(MPI_Handler_function *function,
MPI_Errhandler *errhandler)
MPI_ERRHANDLER_CREATE(FUNCTION, ERRHANDLER, IERROR)
EXTERNAL FUNCTION
INTEGER ERRHANDLER, IERROR
Функция MPI_ERRHANDLER_CREATE регистрирует процедуру пользователя в качестве обработчика MPI исключений. Возвращает в errhandler дескриптор зарегистрированного обработчика исключений.
В языке Си процедура пользователя должна быть функцией типа MPI_Handler_function, которая определяется как:
typedef void (MPI_Handler_function)(MPI_Comm *, int *, ...);
Первый аргумент является идентификатором используемого коммуникатора, второй является кодом ошибки, который будет возвращен процедурой MPI, которая выявила ошибку. Если процедура возвратила MPI_ERR_IN_STATUS, то это значит, что код ошибки возвращен в статусный объект обращения, которое запустило обработчик ошибок. Остающиеся аргументы есть аргументы ``stdargs'', номер и значение которых являются зависимыми от реализации. В реализации должны быть ясно документированы эти аргументы. Адреса используются так, чтобы обработчик мог быть написан на языке ФОРТРАН.
Синтаксис функции MPI_ERRHANDLER_SET представлен ниже.
MPI_ERRHANDLER_SET(comm, errhandler)
| IN | comm | коммуникатор , на котором устанавливается обработчик ошибок (дескриптор) | |
| IN | errhandler | новый обработчик ошибок для коммуникатора (дескриптор) |
int MPI_Errhandler_set(MPI_Comm comm, MPI_Errhandler errhandler)
MPI_ERRHANDLER_SET(COMM, ERRHANDLER, IERROR)
INTEGER COMM, ERRHANDLER, IERROR
Функция MPI_ERRHANDLER_SET связывает новый обработчик ошибок errorhandler с коммуникатором comm на вызывающем процессе. Заметим, что обработчик ошибок всегда связан с коммуникатором.
Синтаксис функции MPI_ERRHANDLER_GET представлен ниже.
MPI_ERRHANDLER_GET(comm, errhandler)
| IN | comm | коммуникатор, из которого получен обработчик ошибок (дескриптор) | |
| OUT | errhandler | MPI обработчик ошибок, связанный с коммуникатором (дескриптор) |
int MPI_Errhandler_get(MPI_Comm comm, MPI_Errhandler *errhandler)
MPI_ERRHANDLER_GET(COMM, ERRHANDLER, IERROR)
INTEGER COMM, ERRHANDLER, IERROR
Функция MPI_ERRHANDLER_GET возвращает в errhandler дескриптор обработчика ошибок, связанного с коммуникатором comm. Пример: библиотечная функция может записать на входной точке текущий обработчик ошибок для коммуникатора, затем установить собственный частный обработчик ошибок для этого коммуникатора и восстановить перед выходом предыдущий обработчик ошибок.
Синтаксис функции MPI_ERRHANDLER_FREE представлен ниже.
MPI_ERRHANDLER_FREE(errhandler)
| INOUT | errhandler | MPI обработчик ошибок (дескриптор) |
int MPI_Errhandler_free(MPI_Errhandler *errhandler)
MPI_ERRHANDLER_FREE(ERRHANDLER, IERROR)
INTEGER ERRHANDLER, IERROR
void MPI::Errhandler::Free()
Эта функция маркирует обработчик ошибок, связанный с errhandler для удаления и устанавливает для errhandler значение MPI_ERRHANDLER_NULL. Обработчик ошибок будет удален после того, как все коммуникаторы, связанные с ним, будут удалены.
Синтаксис функции MPI_ERROR_STRING представлен ниже.
MPI_ERROR_STRING(errorcode, string, resultlen)
| IN | errorcodeк | код ошибки, возвращаемый процедурой MPI | |
| OUT | string | текст, соответствующий errorcode | |
| OUT | resultlen | длина (в печатных знаках) результата, возвращаемого в string |
int MPI_Error_string(int errorcode, char *string, int *resultlen)
MPI_ERROR_STRING(ERRORCODE, STRING, RESULTLEN, IERROR)
INTEGER ERRORCODE, RESULTLEN, IERROR
CHARACTER*(*) STRING
void MPI::Get_error_string(int errorcode, char* name, int& resulten)
Функция MPI_ERROR_STRING возвращает текст ошибки, связанный с кодом или классом ошибки. Аргумент string обязан иметь длину не менее _MAX_ERROR_STRING знаков. Число фактически записанных символов возвращается в выходном аргументе resultlen.
Объяснение: Форма этой функции была выбрана такой для того, чтобы сделать привязки в языке ФОРТРАН и Си похожими. Версия, которая возвращает указатель на строку, создает две проблемы. Во первых, возвращенная строка должна быть статически распределена и различаться для каждого сообщения об ошибке (позволяя указателям, возвращенным успешными обращениями к MPI_ERROR_STRING, указать правильное сообщение). Во вторых, в языке ФОРТРАН функция, объявленная, как возвращающая CHARACTER*(*), может не ссылаться, например, на оператор PRINT.[]