Параллельное программирование: Учебное пособие, страница 126

В MPI реализованы несколько локальных операций с атрибутами. Для создания нового значения keyval (ключа атрибута) предназначена подпрограмма MPI_Keyval_create:

int MPI_Keyval_create(MPI_Copy_function *copy_fn,

MPI_Delete_function *delete_fn, int *keyval,

void *extra_state)

Ключи уникальны для каждого процесса и не видны пользователю, хотя явным образом хранятся в виде целых значений. Будучи однажды задан, ключ может быть использован для задания атрибутов и доступа к ним в любом коммуникаторе. Функция copy_fn вызывается, когда коммуникатор дублируется подпрограммой MPI_Comm_dup, а функция delete_fn используется для удаления. Параметр extra_state задает дополнительную информацию (состояние) для функций копирования и удаления.

Тип функции MPI_Copy_function определяется следующим образом:

typedef int MPI_Copy_function(MPI_Comm oldcomm,

int keyval, void *extra_state, void *attribute_val_in,

void *attribute_val_out, int *flag)

Функция копирования вызывается для каждого значения ключа в исходном коммуникаторе в произвольном порядке. Каждое обращение к функции копирования выполняется со значением ключа и соответствующим ему атрибутом. Если она возвращает значение флага flag=0, атрибут удаляется из продублированного коммуникатора. В противном случае (flag=1) устанавливается новое значение атрибута, равное значению, возвращенному в параметре attribute_val_out.

Функцию Copy_fn в языке С можно определить значениями MPI_NULL_COPY_FN или MPI_DUP_FN. ЗначениеMPI_NULL_COPY_FN является функцией, которая не выполняет никаких действий, только возвращает значение флага flag = 0 и MPI_SUCCESS. Значение MPI_DUP_FN представляет собой простейшую функцию дублирования. Она возвращает значение флага flag = 1, значение атрибута в переменной attribute_val_out и код завершения MPI_SUCCESS.

Аналогичной copy_fn является функция удаления delete_fn. Она вызывается, когда коммуникатор удаляется вызовом MPI_Comm_free или при вызове MPI_Attr_delete. Эта функция должна иметь типMPI_Delete_function, который определяется следующим образом:

typedef int MPI_Delete_function(MPI_Comm comm,

int keyval, void *attribute_val,

void *extra_state);

Эта функция вызывается подпрограммами MPI_Comm_free, MPI_Attr_delete и MPI_Attr_put. Функция удаления может иметь значение  MPI_NULL_DELETE_FN (пусто) и, не выполняя никаких действий, возвращает значение MPI_SUCCESS.

Специальное значение ключа MPI_KEYVAL_INVALID никогда не возвращается подпрограммой MPI_Keyval_create. Его можно использовать для инициализации ключей.

Удалить ключ keyval атрибута можно с помощью вызова подпрограммы MPI_Keyval_free:

int MPI_Keyval_free(int *keyval)

Эта функция присваивает параметру keyval значение MPI_KEYVAL_INVALID. Используемый атрибут можно удалить, поскольку фактическое удаление происходит только после того, как будут удалены все ссылки на атрибут. Эти ссылки должны быть явным образом удалены программой, например, посредством вызова MPI_Attr_delete — каждый такой вызов удаляет один экземпляр атрибута, либо вызовом MPI_Comm_free, который удаляет все экземпляры атрибута, связанные с удаляемым коммуникатором.

Подпрограмма  MPI_ATTR_PUT:

int MPI_Attr_put(MPI_Comm comm,

intkeyval, void* attribute)

используется для задания атрибута attribute, который в дальнейшем может применяться подпрограммой MPI_Attr_get. С атрибутом ассоциируется значение ключа keyval. Если значение атрибута уже задано, результат будет аналогичен ситуации, когда сначала для удаления предыдущего значения вызывается MPI_Attr_delete (и выполняется функция обратного вызова delete_fn), а затем сохраняется новое значение. Вызов завершится с ошибкой, если нет ключа со значением keyval. В частности, MPI_KEYVAL_INVALID — ошибочное значение ключа. Не допускается изменение системных атрибутов MPI_TAG_UB, MPI_HOST, MPI_IO и MPI_WTIME_IS_GLOBAL. Если атрибут уже назначен, вызывается функция удаления, заданная при создании соответствующего ключа.

Подпрограмма MPI_Attr_get:

int MPI_Attr_get(MPI_Comm comm, int keyval,