Subrotina LAPI_Xfer

Propósito

Serve como uma função de wrapper para funções de transferência de dados LAPI.

Biblioteca

Biblioteca de Disponibilidade (liblapi_r.a)

Sintaxe C

#include <lapi.h>
 
int LAPI_Xfer(hndl, xfer_cmd)
lapi_handle_t hndl;
lapi_xfer_t *xfer_cmd;
 

typedef struct {
    uint            src;          /* Target task ID    */
    uint            reason;       /* LAPI return codes */
    ulong           reserve[6];   /* Reserved          */
} lapi_sh_info_t;


typedef void (scompl_hndlr_t)(lapi_handle_t *hndl, void *completion_param,
                              lapi_sh_info_t *info);
 

Sintaxe FORTRAN

include 'lapif.h'
 
LAPI_XFER(hndl, xfer_cmd, ierror)
INTEGER hndl
TYPE (fortran_xfer_type) :: xfer_cmd
INTEGER ierror

Descrição

Type of call: comunicação ponto-a-ponto (sem bloqueio)

O subroutine LAPI_Xfer fornece um superconjunto da funcionalidade dessas subroutines: LAPI_Amsend, LAPI_Amsendv, LAPI_Put, LAPI_Putv, LAPI_Get, LAPI_Getve LAPI_Rmw. Além disso, LAPI_Xfer fornece transferência de mensagens de coleta de dados / programa de dispersão de dados (DGSP).

Em C, o comando LAPI_Xfer é passado um ponteiro para um sindicato. Ele examina o primeiro membro do sindicato, Xfer_type, para determinar o tipo de transferência, e para determinar qual membro do sindicato foi passado. LAPI_Xfer espera que cada campo do membro do sindicato identificado seja configurado. Ele não examia ou modifica qualquer memória fora do membro do sindicato identificado. LAPI_Xfer trata todos os membros do sindicato (exceto status) como dados de leitura.

typedef union {
        lapi_xfer_type_t   Xfer_type;
        lapi_get_t         Get;
        lapi_am_t          Am;
        lapi_rmw_t         Rmw;
        lapi_put_t         Put;
        lapi_getv_t        Getv;
        lapi_putv_t        Putv; 
        lapi_amv_t         Amv;
        lapi_amdgsp_t      Dgsp;
} lapi_xfer_t;

detalhes lapi_am_t

detalhes lapi_amv_t

detalhes lapi_amdgsp_t

Quando o buffer de dados de origem é livre para ser modificado, o manipulador de conclusão de envio (shdlr) é chamado com os dados de conclusão de envio (sinfo), se shdlr não for um ponteiro NULL (em C) ou LAPI_ADDR_NULL (em FORTRAN).

Veja Usando lapi_am_dgsp_t para processamento de DGSP de lado de dispersão para obter mais informações.

O campo de bandeiras lapi_amdgsp_t

Uma ou mais bandeiras podem ser definidas usando o operador | (bitwise ou). As diretivas do usuário são sempre seguidas e poderiam resultar em resultados incorretos se usados impropriamente. As sugestões apropriadas podem melhorar o desempenho, mas podem ser ignoradas pelo LAPI. As sugestões inadequadas podem degradar o desempenho, mas não causarão resultados incorretos.

Essas dicas podem ou não ser honradas pela biblioteca de comunicação.

Usando lapi_am_dgsp_t para processamento de DGSP de lado de dispersão

O LAPI permite que informações adicionais sejam retornadas do manipulador de cabeçalho através do uso do datatype lapi_return_info_t . Veja RSCT para AIX 5L: Guia de Programação LAPI para obter mais informações sobre lapi_return_info_t. No caso do tipo de transferência lapi_am_dgsp_t, este mecanismo pode ser usado para instruir LAPI a executar um DGSP de usuário para espalhar dados no lado de recebimento.

Para usar este mecanismo, passe um ponteiro lapi_return_info_t * de volta para LAPI por meio do membro msg_len do manipulador de cabeçalho do usuário. O membro dgsp_handle da estrutura passada deve apontar para uma descrição do DGSP que foi registrada no lado do recebimento. Veja LAPI_Util e RSCT para AIX 5L: Guia de Programação LAPI para obter detalhes sobre construção e registro de DGSPs.

detalhes lapi_get_t

detalhes lapi_getv_t

Quando o buffer de dados de origem tiver chegado completamente, o ponteiro para o manipulador de conclusão (chndlr) é chamado com os dados de conclusão (cinfo) se chndlr não for um ponteiro NULL (em C) ou LAPI_ADDR_NULL (em FORTRAN). Caso contrário, o comportamento é idêntico ao de LAPI_Getv.

detalhes lapi_put_t

detalhes lapi_putv_t

Quando o buffer de dados de origem estiver livre para ser modificado, o ponteiro para o manipulador de conclusão de envio (shdlr) é chamado com os dados de conclusão de envio (sinfo), se shdlr não for um ponteiro NULL (em C) ou LAPI_ADDR_NULL (em FORTRAN). Caso contrário, o comportamento é idêntico ao de LAPI_Putv.

detalhes lapi_rmw_t

Parâmetros

INPUT

hndl

Especifica a alça LAPI.

xfer_cmd

Especifica o nome e os parâmetros da função de transferência de dados.

SAÍDA

ierro

Especifica um código de retorno FORTRAN. Este é sempre o último parâmetro.

Valores De Retorno

LAPI_SUCESSO

Indica que a chamada de função foi concluída com sucesso.

LAPI_ERR_DATA_LEN

Indica que o valor de udata_len ou len é maior do que o valor da constante LAPI LAPI_MAX_MSG_SZ.

LAPI_ERR_DGSP

Indica que o DGSP que foi passado em é NULL (em C) ou LAPI_ADDR_NULL (no FORTRAN) ou não é um DGSP registrado.

LAPI_ERR_DGSP_ATOM

Indica que o DGSP tem um atom_size que é menor que 0 ou maior do que MAX_ATOM_SIZE.

LAPI_ERR_DGSP_BRANCH

Indica que a DGSP tentou um ramo que caiu fora da matriz de código.

LAPI_ERR_ERR_DGSP_CTL

Indica que uma instrução de controle do DGSP foi encontrada em um contexto não válido (como um controle de lado de reúna ou controle de lado de dispersão com um tamanho de átomo de 0 em reunir, por exemplo).

LAPI_ERR_DGSP_OPC

Indica que o código DGSP op-code não é válido.

LAPI_ERR_DGSP_STACK

Indica que o DGSP possui maior profundidade GOSUB do que os suportes de pilha alocados. Alocação de pilha é especificada pelo membro dgsp->profundidade.

LAPI_ERR_HDR_HNDLR_NULL

Indica que o hdr_hdl passado em é NULL (em C) ou LAPI_ADDR_NULL (em FORTRAN).

LAPI_ERR_HNDL_INVÁLIDA

Indica que o hndl passado em não é válido (não inicializado ou em estado finalizado).

LAPI_ERR_IN_VAL_NULL

Indica que o ponteiro in_val é NULL (em C) ou LAPI_ADDR_NULL (em FORTRAN).

LAPI_ERR_MEMORY_ESGOTADO

LAPI é incapaz de obter memória do sistema.

LAPI_ERR_OP_SZ

Indica que o campo lapi_rmw_t size não está configurado como 32 ou 64.

LAPI_ERR_ORG_ADDR_NULL

Indica ou que o parâmetro udata passado em é NULL (em C) ou LAPI_ADDR_NULL (em FORTRAN) e udata_len é maior que 0, ou que o org_addr passado em é NULL (em C) ou LAPI_ADDR_NULL (em FORTRAN) e len é maior que 0.

Note: se Xfer_type = LAPI_DGSP_XFER, o caso em que udata é NULL (em C) ou LAPI_ADDR_NULL (em FORTRAN) e udata_len é maior que 0 é válido, portanto, um erro não é retornado.

LAPI_ERR_ORG_EXTENSÃO

Indica que a extensão org_vec(stride * num_vecs) é maior do que o valor da constante LAPI LAPI_MAX_MSG_SZ.

LAPI_ERR_ORG_STRIDE

Indica que o stride org_vec é menor do que bloco.

LAPI_ERR_ORG_VEC_ADDR

Indica que o org_vec->info [i] é NULL (em C) ou LAPI_ADDR_NULL (em FORTRAN), mas o seu comprimento (org_vec->len [i]) não é 0.

LAPI_ERR_ORG_VEC_LEN

Indica que a soma de org_vec-> len é maior do que o valor da constante LAPI LAPI_MAX_MSG_SZ.

LAPI_ERR_ORG_VEC_NULL

Indica que o valor org_vec é NULL (em C) ou LAPI_ADDR_NULL (em FORTRAN).

LAPI_ERR_ORG_VEC_TYPE

Indica que o org_vec->vec_type não é válido.

LAPI_ERR_RMW_OP

Indica que a op não é válida.

LAPI_ERR_STRIDE_ORG_VEC_ADDR_NULL

Indica que o vetor de vetor de stridado org_vec->info[0] é NULL (em C) ou LAPI_ADDR_NULL (em FORTRAN).

LAPI_ERR_STRIDE_TGT_VEC_ADDR_NULL

Indica que o endereço vetorial stridado tgt_vec->info[0] é NULL (em C) ou LAPI_ADDR_NULL (em FORTRAN).

LAPI_ERR_TGT

Indica que o tgt passado em está fora do intervalo de tarefas definidas no job.

LAPI_ERR_TGT_ADDR_NULL

Indica que ret_addr é NULL (em C) ou LAPI_ADDR_NULL (em FORTRAN).

LAPI_ERR_TGT_EXTENSÃO

Indica que a extensão tgt_vec(stride * num_vecs) é maior do que o valor da constante LAPI LAPI_MAX_MSG_SZ.

LAPI_ERR_TGT_PURGED

Indica que a subroutine retornou mais cedo porque LAPI_Purge_totask() foi chamada.

LAPI_ERR_TGT_STRIDE

Indica que o stride tgt_vec é menor do que bloco.

LAPI_ERR_TGT_VAR_NULL

Indica que o endereço tgt_var é NULL (em C) ou que o valor de tgt_var é LAPI_ADDR_NULL (em FORTRAN).

LAPI_ERR_TGT_VEC_ADDR

Indica que o tgt_vec->info[i] é NULL (em C) ou LAPI_ADDR_NULL (em FORTRAN), mas o seu comprimento (tgt_vec->len[i]) não é 0.

LAPI_ERR_TGT_VEC_LEN

Indica que a soma de tgt_vec->len é maior do que o valor de constante LAPI LAPI_MAX_MSG_SZ.

LAPI_ERR_TGT_VEC_NULL

Indica que tgt_vec é NULL (em C) ou LAPI_ADDR_NULL (em FORTRAN).

LAPI_ERR_TGT_VEC_TYPE

Indica que o tgt_vec->vec_type não é válido.

LAPI_ERR_UHDR_LEN

Indica que o valor uhdr_len passado em é maior que MAX_UHDR_SZ ou não é um múltiplo do tamanho do doubleword do processador.

LAPI_ERR_UHDR_NULL

Indica que o uhdr passado em é NULL (em C) ou LAPI_ADDR_NULL (em FORTRAN), mas uhdr_len não é 0.

LAPI_ERR_VEC_LEN_DIFF

Indica que org_vec e tgt_vec têm tamanhos diferentes (len []).

LAPI_ERR_VEC_NUM_DIFF

Indica que org_vec e tgt_vec têm diferentes num_vecs.

LAPI_ERR_VEC_TYPE_DIFF

Indica que org_vec e tgt_vec possuem tipos de vetores diferentes (vec_type).

LAPI_ERR_XFER_CMD

Indica que o Xfer_cmd não é válido.

Exemplos de C

Localização

/usr/lib/liblapi_r.a