estrutura apext::tsync::FVContainer

A estrutura apext::tsync::FVContainer serve no módulo tsync como contêiner de dados para a passagem e o retorno de valores de frescor entre aplicações e o Freshness Value Management. Ela encapsula o próprio valor de frescor como vetor de bytes em value, que contém valores completos ou truncados dependendo da direção [SWS_TS_14196], bem como seu comprimento exato em bits no atributo length [SWS_TS_14195]. O acesso concorrente requer coordenação externa por parte do chamador.

mais ›

Contexto

A estrutura apext::tsync::FVContainer atua no cluster funcional tsync da AUTOSAR Adaptive Platform como contêiner de dados dedicado para valores de frescor (Freshness Values). Incluída por meio do arquivo de cabeçalho apext/tsync/fvm.h, ela serve como interface padronizada na interação com o Freshness Value Management (FVM). Sua responsabilidade primária consiste em disponibilizar o próprio valor criptográfico de frescor juntamente com seu comprimento exato. Para isso, o contêiner encapsula o comprimento em bits no elemento de dados length [SWS_TS_14195] e os dados úteis reais no vetor de bytes value [SWS_TS_14196]. A estrutura atua, assim, como uma ponte entre aplicações chamadoras ou camadas de protocolo e as rotinas de cálculo do FVM.

Ciclo de vida

Como estrutura de dados leve (struct), apext::tsync::FVContainer obedece à semântica de valor regular do C++. A criação ocorre tipicamente de forma local na pilha (stack) do chamador ou dinamicamente no âmbito da criação de uma mensagem de nível superior. Com a instanciação, a estrutura assume a responsabilidade pelo ciclo de vida do vetor contido value do tipo ara::core::Vector<std::uint8_t> [SWS_TS_14196]. Caso a estrutura seja repassada por valor ou por referência ao ser transmitida a interfaces, o princípio de RAII do vetor assegura uma liberação determinística da memória alocada na destruição do contêiner. Pergunta Q-416ceca84f9cfdaf (aberta) Como apext::tsync::FVContainer não disponibiliza mecanismos internos de sincronização, a coordenação thread-safe em acessos concorrentes de leitura e escrita cabe integralmente ao componente de software chamador.

Caminho de utilização

Em uso prático, apext::tsync::FVContainer passa por duas direções centrais na comunicação da interface:

• Parâmetro de entrada: na verificação ou no processamento de mensagens recebidas, o contêiner é preenchido pela aplicação e passado para métodos do FVM. Dependendo do contexto, o campo value recebe valores de frescor completos ou valores truncados (Truncated Values) [SWS_TS_14196]. Paralelamente, o campo length especifica a quantidade exata de bits do valor contido [SWS_TS_14195]. Isso é de particular importância quando a validade do valor de frescor não termina em um limite exato de byte.
• Valor de retorno: na geração de valores frescos pelo FVM, o respectivo método retorna uma instância de apext::tsync::FVContainer. O contexto chamador lê em seguida, via length [SWS_TS_14195], o comprimento efetivo em bits determinado pelo FVM e extrai os bytes correspondentes de value [SWS_TS_14196] para incorporá-los em protocolos de segurança subsequentes.

Interpretação: presumivelmente, a contagem de bits registrada em length corresponde sempre ao tamanho em bytes arredondado para cima do vetor value, de modo que bits residuais utilizados de forma incompleta no último byte do vetor possam ser delimitados com precisão pela especificação de comprimento. Pergunta Q-e8feae8a93c14191 (aberta)