classe ara::per::FileStorage

O método síncrono DeleteFile da classe ara::per::FileStorage remove um ficheiro a partir do seu nome (fileName) do armazenamento de ficheiros [SWS_PER_00111]. O identificador pode corresponder ao PersistencyFile.fileName configurado [SWS_PER_00111]. A chamada está especificada como noexcept, é considerada segura contra exceções e segura para threads, e reporta o resultado através de ara::core::Result<void> [SWS_PER_00111].

Antes da chamada, todos os acessos ativos ao ficheiro de destino têm de estar terminados. Se o ficheiro estiver atualmente aberto, a operação de eliminação falha com o erro PerErrc::kResourceBusy [SWS_PER_00111]. Por conseguinte, as aplicações têm de garantir que instâncias de UniqueHandle anteriormente criadas através de OpenFileReadWrite [SWS_PER_00113], OpenFileReadOnly [SWS_PER_00114] ou OpenFileWriteOnly [SWS_PER_00115] tenham saído do seu âmbito, fechando assim o ficheiro. Da mesma forma, uma execução paralela de RecoverFile [SWS_PER_00337] ou ResetFile [SWS_PER_00338] para o mesmo nome de ficheiro resulta em PerErrc::kResourceBusy [SWS_PER_00111].

Em caso de erro, o tipo Result retornado disponibiliza causas de erro específicas [SWS_PER_00111]:

• PerErrc::kFileNotFound: o arquivo especificado não existe no armazenamento de arquivos [SWS_PER_00111].
• PerErrc::kIllegalWriteAccess: O File Storage está configurado como protegido contra escrita [SWS_PER_00111].
• PerErrc::kPhysicalStorageFailure: O acesso ao suporte de armazenamento físico falha (sem semântica de rollback) [SWS_PER_00111].
• PerErrc::kIntegrityCorrupted, PerErrc::kEncryptionFailed ou PerErrc::kAuthenticationFailed: Falha na integridade estrutural, na encriptação/desencriptação ou na verificação de MAC (cada uma com semântica de rollback), bem como erros específicos do fabricante [SWS_PER_00111].

O método síncrono FileExists da classe ara::per::FileStorage verifica se um ficheiro existe no respetivo armazenamento de ficheiros [SWS_PER_00112]. A função está declarada como noexcept e não lança exceções C++ [SWS_PER_00112].

usar

Como parâmetro é transmitido fileName como ara::core::StringView, o que pode corresponder ao identificador PersistencyFile.fileName de um ficheiro configurado [SWS_PER_00112]. O valor de retorno ara::core::Result<bool> devolve true se o ficheiro tiver sido localizado e, caso contrário, false [SWS_PER_00112].

Tratamento de erros

Se a verificação falhar, o Result devolvido não contém um valor booleano, mas sim um código de erro [SWS_PER_00112]. As causas de erro especificadas são:

• PerErrc::kPhysicalStorageFailure em caso de falha no acesso ao armazenamento físico [SWS_PER_00112],
• PerErrc::kIntegrityCorrupted em caso de integridade estrutural danificada dos dados [SWS_PER_00112],
• PerErrc::kValidationFailed se a validade dos dados armazenados não puder ser garantida [SWS_PER_00112],
• PerErrc::kEncryptionFailed em caso de falha na desencriptação [SWS_PER_00112],
• PerErrc::kAuthenticationFailed em caso de falha na verificação do MAC [SWS_PER_00112], bem como possíveis erros específicos do fabricante [SWS_PER_00112].

Simultaneidade e restrições

O método está declarado como seguro para threads [SWS_PER_00112]. No entanto, o resultado de verificação fornecido só é exato enquanto não forem adicionados ou eliminados ficheiros no armazenamento em simultâneo; se, por exemplo, outra thread remover um ficheiro diretamente após o retorno de true, o resultado já não é válido [SWS_PER_00112].

O método OpenFileReadOnly da classe ara::per::FileStorage (declarado em #include "ara/per/file_storage.h") abre um arquivo persistido somente para leitura com um modo de acesso especificado [SWS_PER_00114]. A menos que especificado de outra forma por meio do parâmetro mode, a posição do ponteiro de leitura é definida por padrão para o início do arquivo (kAtTheBeginning) [SWS_PER_00114]. A execução ocorre de forma síncrona e retorna um ara::core::Result<UniqueHandle<ReadAccessor>>. O handle utiliza semântica RAII: assim que a instância de UniqueHandle sai de seu escopo, o arquivo é automaticamente fechado [SWS_PER_00114].

Em relação à concorrência, o método é especificado como thread-safe e exception safe (com noexcept) [SWS_PER_00114]. Contudo, existem restrições funcionais de chamada: se o arquivo de destino já estiver aberto ou se operações como DeleteFile, RecoverFile ou ResetFile estiverem sendo executadas concorrentemente com o mesmo nome de arquivo, a chamada falhará com PerErrc::kResourceBusy [SWS_PER_00114].

Em caso de erro, o ara::core::Result retorna erros específicos do fabricante ou códigos de erro padronizados de PerErrc ou StorageFailure [SWS_PER_00114]:

• PerErrc::kFileNotFound: o arquivo especificado não existe no armazenamento de arquivos [SWS_PER_00114].
• PerErrc::kInvalidOpenMode: o modo fornecido contém uma combinação inválida de flags [SWS_PER_00114].
• StorageFailure: o acesso ao armazenamento físico falhou [SWS_PER_00114].
• PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kAuthenticationFailed ou PerErrc::kEncryptionFailed: integridade estrutural corrompida, validação insuficiente, falha na verificação de MAC ou falha na descriptografia [SWS_PER_00114].

Em conjunto com outras interfaces, FileStorage oferece duas sobrecargas relacionadas: uma variante sem parâmetro de modo, que sempre abre no início do arquivo [SWS_PER_00376], e uma sobrecarga com buffer (ara::core::Span<ara::core::Byte> buffer), por meio da qual o ReadAccessor implementa leitura em blocos para acelerar muitos acessos pequenos [SWS_PER_00430].

usar

O método OpenFileReadOnly da classe ara::per::FileStorage abre um ficheiro persistido em modo de apenas leitura [SWS_PER_00376]. A chamada é realizada através do ficheiro de cabeçalho ara/per/file_storage.h passando o nome do ficheiro fileName. A posição de leitura é inicialmente colocada no início do ficheiro. Como valor de retorno serve um ara::core::Result, que disponibiliza um UniqueHandle<ReadAccessor> em caso de sucesso. O ficheiro aberto é fechado automaticamente assim que este identificador sai do seu âmbito.

Tratamento de erros

Se a execução falhar, o resultado contém um código de erro ou um erro específico do fabricante [SWS_PER_00376]:

• PerErrc::kFileNotFound: O ficheiro especificado não existe no armazenamento.
• PerErrc::kResourceBusy: O ficheiro já está aberto ou está a ser processado simultaneamente por DeleteFile, RecoverFile ou ResetFile.
• PerErrc::kPhysicalStorageFailure: O acesso ao suporte de armazenamento físico falhou.
• PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed, PerErrc::kAuthenticationFailed: Erro na integridade estrutural, validação de dados, desencriptação ou verificação de MAC.

Concorrência e interação

O método está especificado como thread-safe, exception safe e noexcept [SWS_PER_00376]. Para requisitos avançados estão disponíveis sobrecargas: uma variante para indicação explícita de um OpenMode [SWS_PER_00114], bem como uma assinatura com buffer de utilizador adicional para aceleração por blocos de pequenos acessos de leitura [SWS_PER_00430].

O método síncrono OpenFileReadOnly da classe ara::per::FileStorage abre um ficheiro persistido para acesso de leitura utilizando um buffer disponibilizado pelo chamador [SWS_PER_00430]. Com base nos parâmetros fileName, mode bem como buffer (como ara::core::Span<ara::core::Byte>), o acesso ao ficheiro é inicializado [SWS_PER_00430]. Salvo indicação em contrário através de mode, a posição de leitura situa-se por padrão no início do ficheiro (kAtTheBeginning) [SWS_PER_00430]. O espaço de memória transmitido é utilizado pelo ReadAccessor resultante para acelerar pequenos acessos de leitura repetidos através de leitura por blocos [SWS_PER_00430]. O recurso está protegido via RAII: assim que o UniqueHandle devolvido sai do âmbito, o ficheiro é automaticamente fechado [SWS_PER_00430].

No que diz respeito à simultaneidade, a função está especificada como segura para threads (thread-safe), segura contra exceções (exception safe) e noexcept [SWS_PER_00430]. Se ocorrer um erro, o ara::core::Result fornece erros específicos do fabricante ou códigos de erro normalizados de PerErrc [SWS_PER_00430]:

• PerErrc::kResourceBusy: O ficheiro já está aberto ou está a ser processado simultaneamente por DeleteFile, RecoverFile ou ResetFile [SWS_PER_00430].
• PerErrc::kFileNotFound: o arquivo especificado não existe no armazenamento de arquivos [SWS_PER_00430].
• PerErrc::kInvalidOpenMode: O modo transmitido contém uma combinação inválida de opções [SWS_PER_00430].
• Erros de integridade e segurança: PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed ou PerErrc::kAuthenticationFailed (falha na verificação de MAC), bem como StorageFailure em caso de erros de acesso ao armazenamento físico [SWS_PER_00430].

Além desta variante com buffer, estão disponíveis para casos de utilização sem buffer definido pelo utilizador as sobrecargas [SWS_PER_00114] (com mode) e [SWS_PER_00376] (apenas com fileName).

usar

O método síncrono OpenFileReadWrite da classe ara::per::FileStorage abre um ficheiro para acessos de leitura e escrita no modo indicado mode [SWS_PER_00113]. Se não for especificado de outro modo no modo, o ponteiro do ficheiro é colocado por predefinição no início (kAtTheBeginning). Se o ficheiro ainda não existir, é criado automaticamente [SWS_PER_00113]. A função retorna um ara::core::Result com um UniqueHandle<ReadWriteAccessor>, o qual fecha o ficheiro automaticamente assim que o handle sair do seu âmbito de validade [SWS_PER_00113].

Simultaneidade e restrições

A chamada é segura para threads (thread-safe) e não lança exceções (noexcept) [SWS_PER_00113]. O ficheiro não pode estar já aberto no momento da chamada. Além disso, não pode ocorrer uma execução simultânea de DeleteFile, RecoverFile ou ResetFile com o mesmo nome de ficheiro, caso contrário a chamada falhará com PerErrc::kResourceBusy [SWS_PER_00113].

Tratamento de erros

Em caso de erro, o ara::core::Result contém códigos de erro específicos [SWS_PER_00113]:

• PerErrc::kInvalidOpenMode: combinação inválida de flags no mode passado.
• PerErrc::kResourceBusy: o ficheiro de destino já está aberto ou está ocupado por operações administrativas de ficheiros.
• Access: o armazenamento está configurado como read-only ou como write-only-once com uma chave já existente.
• PerErrc::kOutOfStorageSpace ou PerErrc::kTooManyFiles: espaço de armazenamento físico insuficiente ou ultrapassagem de maxNumberOfFiles na nova criação.
• PerErrc::kPhysicalStorageFailure, PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed, PerErrc::kAuthenticationFailed: erros de acesso ao hardware, estruturas de dados corrompidas ou validações criptográficas com falha.

Interação

Como variante simplificada, está disponível uma sobrecarga sem parâmetro de modo, que abre ficheiros por predefinição no início [SWS_PER_00375]. Para otimização de desempenho no caso de numerosos acessos pequenos, existe ainda uma sobrecarga com buffer definido pelo utilizador (buffer) para leitura e escrita por blocos [SWS_PER_00429].

A função-membro síncrona OpenFileReadWrite da classe ara::per::FileStorage serve para abrir um ficheiro para acessos combinados de leitura e escrita [SWS_PER_00375]. É transmitido como parâmetro o nome do ficheiro fileName como ara::core::StringView, o qual pode corresponder à modelagem PersistencyFile.fileName de um ficheiro configurado [SWS_PER_00375]. Se o ficheiro especificado ainda não existir, é criado automaticamente de raiz [SWS_PER_00375]. Ao abrir, a posição do ficheiro é colocada imediatamente no início (em conformidade com kAtTheBeginning) [SWS_PER_00375]. O chamador recebe um ara::core::Result<UniqueHandle<ReadWriteAccessor>>; o ficheiro é fechado automaticamente assim que o UniqueHandle devolvido sai do seu âmbito de validade [SWS_PER_00375].

No que diz respeito à concorrência e ao contexto de execução, a função está especificada como thread-safe e exception safe [SWS_PER_00375]. Deve-se notar, contudo, que os acessos simultâneos são regulamentados: se o ficheiro já estiver aberto ou se for executada simultaneamente uma operação como DeleteFile, RecoverFile ou ResetFile com o mesmo nome de ficheiro, a chamada falha e devolve o código de erro PerErrc::kResourceBusy [SWS_PER_00375].

Em caso de erro, o objeto Result devolvido encapsula erros específicos de persistência ou erros específicos do fabricante [SWS_PER_00375]:

• Erros de configuração e de acesso como Access no caso de armazenamento protegido contra escrita ou dados já existentes com configuração Write-Once [SWS_PER_00375].
• Limites de espaço de armazenamento através de PerErrc::kOutOfStorageSpace ou PerErrc::kTooManyFiles em caso de excesso do limite máximo configurado para o ficheiro [SWS_PER_00375].
• Erros de integridade e segurança como PerErrc::kPhysicalStorageFailure, PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed ou PerErrc::kAuthenticationFailed [SWS_PER_00375].

Na interação com outras interfaces de FileStorage, o AUTOSAR disponibiliza sobrecargas alternativas: OpenFileReadWrite pode ser chamada com OpenMode explícito [SWS_PER_00113] ou com uma área de memória adicional do lado do utilizador buffer (ara::core::Span<ara::core::Byte>), que possibilita um buffering por blocos para acelerar pequenos acessos repetidos [SWS_PER_00429].

usar

O método OpenFileReadWrite da classe ara::per::FileStorage abre um ficheiro de forma síncrona para leitura e escrita combinadas, disponibilizando um buffer definido pelo utilizador [SWS_PER_00429]. O intervalo de memória transmitido buffer (como ara::core::Span<ara::core::Byte>) é utilizado internamente pelo ReadWriteAccessor para operações de leitura e escrita por blocos, a fim de processar de forma eficiente séries de pequenos acessos. Se o ficheiro indicado ainda não existir, é criado de novo automaticamente; a posição do ficheiro situa-se, por padrão, no início (kAtTheBeginning), exceto se especificado de outra forma no mode transmitido [SWS_PER_00429]. O ficheiro é fechado assim que o UniqueHandle retornado em ara::core::Result sai do seu âmbito. Interpretação: A memória subjacente do buffer span transmitido deve provavelmente permanecer válida durante todo o tempo de vida do UniqueHandle, uma vez que o acessor a referencia para acessos por blocos. Pergunta Q-e0009b7de17e3597 (aberta)

Tratamento de erros e simultaneidade

A função está especificada como noexcept, segura contra exceções (exception safe) e segura para threads [SWS_PER_00429]. Em caso de falha, o Result fornece erros específicos do fabricante ou códigos de erro definidos:

• PerErrc::kResourceBusy: O ficheiro já está aberto ou está a ser processado simultaneamente com o mesmo nome por DeleteFile, RecoverFile ou ResetFile [SWS_PER_00429].
• Access: A área de armazenamento está configurada como read-only ou definida como write-only-once e já ocupada [SWS_PER_00429].
• PerErrc::kInvalidOpenMode: O mode transmitido contém uma combinação inválida de características [SWS_PER_00429].
• PerErrc::kOutOfStorageSpace ou PerErrc::kTooManyFiles: O armazenamento físico não é suficiente para uma nova criação ou o limite configurado maxNumberOfFiles seria excedido [SWS_PER_00429].
• PerErrc::kPhysicalStorageFailure, PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed e PerErrc::kAuthenticationFailed: Erros no acesso, na verificação de integridade, MAC ou validação, bem como na desencriptação [SWS_PER_00429].

Interação

O método representa uma variante com desempenho otimizado da abertura para leitura/escrita: enquanto [SWS_PER_00113] processa apenas o nome do ficheiro e o modo, e [SWS_PER_00375] processa exclusivamente o nome do ficheiro, [SWS_PER_00429] permite a aceleração orientada de pequenos acessos de E/S através de um buffer de memória explícito.

usar

O método OpenFileWriteOnly da classe ara::per::FileStorage abre um ficheiro de forma síncrona para escrita exclusiva com um modo de acesso definido [SWS_PER_00115]. A menos que seja indicado em contrário através do parâmetro mode, o ficheiro é truncado (de acordo com kTruncate). Se o ficheiro ainda não existir, ele é criado. O valor de retorno é um ara::core::Result<UniqueHandle<WriteAccessor>>; ao sair do âmbito de validade do UniqueHandle, o ficheiro é automaticamente fechado de novo [SWS_PER_00115].

Tratamento de erros

Em caso de erro, o Result devolvido contém códigos de erro específicos [SWS_PER_00115]: Access indica que o armazenamento é protegido contra escrita ou foi configurado como Write-Once e a chave já existe. PerErrc::kInvalidOpenMode assinala combinações inválidas de modos e PerErrc::kOutOfStorageSpace espaço de armazenamento físico insuficiente. Além disso, podem ocorrer PerErrc::kTooManyFiles, PerErrc::kPhysicalStorageFailure, bem como erros de integridade e segurança como PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed ou PerErrc::kAuthenticationFailed [SWS_PER_00115].

Simultaneidade e restrições

A função foi concebida para ser segura para threads (thread-safe), bem como segura em termos de exceções (noexcept) [SWS_PER_00115]. Os acessos simultâneos ao mesmo ficheiro falham com o código de erro PerErrc::kResourceBusy se o ficheiro já estiver aberto ou se operações como DeleteFile, RecoverFile ou ResetFile forem executadas em paralelo com o mesmo nome de ficheiro [SWS_PER_00115].

Interação

Além desta função, a interface disponibiliza uma sobrecarga simplificada sem parâmetro de modo, que funciona por predefinição com kTruncate [SWS_PER_00377], bem como uma sobrecarga com um buffer personalizado para permitir a escrita por blocos para acelerar muitos acessos pequenos [SWS_PER_00431].

usar

O método síncrono OpenFileWriteOnly da classe ara::per::FileStorage abre um ficheiro exclusivamente para escrita de acordo com [SWS_PER_00377]. Recebe o nome do ficheiro de destino através do parâmetro fileName. Se o ficheiro não existir, é criado de novo; um ficheiro já existente é truncado (de acordo com kTruncate) [SWS_PER_00377]. Como valor de retorno serve um ara::core::Result, que encapsula um ara::per::UniqueHandle<WriteAccessor> em caso de sucesso. Este identificador fecha o ficheiro automaticamente segundo o padrão RAII assim que sai do âmbito [SWS_PER_00377].

Tratamento de erros e simultaneidade

A operação é declarada como noexcept, segura contra exceções e segura para threads [SWS_PER_00377]. Em caso de erro, o Result contém um código de erro específico de PerErrc ou um erro específico do fabricante [SWS_PER_00377]:

• PerErrc::kResourceBusy: O ficheiro já está aberto ou está a ser trabalhado em simultâneo por DeleteFile, RecoverFile ou ResetFile.
• PerErrc::kOutOfStorageSpace e PerErrc::kTooManyFiles: A memória física não é suficiente ou o número máximo de ficheiros configurados (maxNumberOfFiles) é excedido.
• PerErrc::kPhysicalStorageFailure, PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed ou PerErrc::kAuthenticationFailed: Erro no acesso ao hardware, bem como em verificações de integridade, validação ou desencriptação.

Interação

Enquanto esta variante define o truncamento de forma fixa, a sobrecarga com o parâmetro OpenMode permite um modo de abertura diferente [SWS_PER_00115]. Para operações de escrita otimizadas por blocos com vários acessos pequenos, está disponível outra sobrecarga com buffer definido pelo utilizador (ara::core::Span<ara::core::Byte>) [SWS_PER_00431].

O método síncrono OpenFileWriteOnly da classe ara::per::FileStorage abre um ficheiro exclusivamente para escrita e devolve um ara::core::Result<UniqueHandle<WriteAccessor>> em caso de sucesso [SWS_PER_00431]. Ao sair do âmbito do UniqueHandle devolvido, o ficheiro aberto é automaticamente fechado [SWS_PER_00431]. Além do nome do ficheiro fileName e do modo de acesso mode, a chamada recebe um buffer do lado do utilizador buffer (como ara::core::Span<ara::core::Byte>), que é utilizado para escrita por blocos a fim de acelerar pequenos acessos de escrita repetidos [SWS_PER_00431]. Salvo configuração diferente no modo, o ficheiro é truncado aquando da abertura (de acordo com kTruncate); se ainda não existir, é criado de novo [SWS_PER_00431].

No que diz respeito à simultaneidade e à segurança, o método está especificado como thread-safe e exception safe, bem como declarado como noexcept [SWS_PER_00431]. Contudo, o acesso falha se o ficheiro já estiver aberto ou se operações de gestão como DeleteFile, RecoverFile ou ResetFile estiverem a ser executadas simultaneamente sobre o mesmo nome de ficheiro [SWS_PER_00431].

Em caso de erro, é devolvido no resultado um código de erro correspondente de PerErrc ou um erro específico do fabricante [SWS_PER_00431]:

• PerErrc::kResourceBusy: O ficheiro já está aberto ou está ocupado por outra operação de ficheiro [SWS_PER_00431].
• PerErrc::kIllegalWriteAccess: O File Storage está protegido contra escrita ou configurado como write-only-once e o ficheiro já existe [SWS_PER_00431].
• PerErrc::kInvalidOpenMode: A combinação de modos transmitida é inválida [SWS_PER_00431].
• PerErrc::kOutOfStorageSpace ou PerErrc::kTooManyFiles: O espaço de armazenamento não é suficiente ou o número máximo de ficheiros configurados é excedido [SWS_PER_00431].
• PerErrc::kPhysicalStorageFailure, PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed ou PerErrc::kAuthenticationFailed: Falha no acesso físico, na integridade, na validação, na desencriptação ou na autenticação [SWS_PER_00431].

Na interação com outras interfaces, a função expande os métodos base [SWS_PER_00377] (apenas fileName) e [SWS_PER_00115] (com mode) especificamente com suporte a buffer para operações de escrita otimizadas [SWS_PER_00431].

usar

O método síncrono RecoverFile da classe ara::per::FileStorage executa uma restauração de melhor esforço de um único ficheiro se as verificações de redundância falharem [SWS_PER_00337]. O identificador do ficheiro afetado é transmitido através do parâmetro fileName como ara::core::StringView. Após a restauração, o ficheiro pode apresentar estados desatualizados ou o conteúdo inicial, ou, no pior dos casos, ser perdido [SWS_PER_00337].

Concorrência e interação

A operação está especificada como segura para threads e segura contra exceções [SWS_PER_00337]. No entanto, não pode ser executada em ficheiros abertos: antes da chamada, todas as instâncias de UniqueHandle obtidas anteriormente através de métodos de abertura de ficheiros como [SWS_PER_00113], [SWS_PER_00114] ou [SWS_PER_00375] têm de estar fechadas [SWS_PER_00337]. Caso contrário, a chamada falha com PerErrc::kResourceBusy. O mesmo erro é reportado se [SWS_PER_00111] (DeleteFile) ou [SWS_PER_00338] (ResetFile) estiver a ser executado simultaneamente para o mesmo nome de ficheiro [SWS_PER_00337].

Tratamento de erros

A função retorna um ara::core::Result<void> [SWS_PER_00337]. Além de PerErrc::kResourceBusy, podem ocorrer os seguintes erros normalizados:

• PerErrc::kFileNotFound: o arquivo especificado não existe no armazenamento de arquivos [SWS_PER_00337].
• PerErrc::kPhysicalStorageFailure: O acesso ao suporte de armazenamento físico falha [SWS_PER_00337].
• PerErrc::kOutOfStorageSpace: O espaço de armazenamento físico disponível não é suficiente para o ficheiro restaurado [SWS_PER_00337].
• PerErrc::kQuotaExceeded: O ficheiro restaurado excederia o limite configurado maximumAllowedSize [SWS_PER_00337].
• PerErrc::kEncryptionFailed e PerErrc::kAuthenticationFailed: A desencriptação criptográfica ou a validação de MAC dos dados armazenados falhou [SWS_PER_00337].

O método síncrono ResetFile da classe ara::per::FileStorage repõe um único ficheiro no seu estado inicial pré-configurado [SWS_PER_00338]. Se o ficheiro especificado através de fileName ainda não existir no armazenamento, é criado de novo [SWS_PER_00338]. Em ambos os casos, o ficheiro passa a ter o mesmo conteúdo que após uma nova instalação a partir da Target Configuration atual [SWS_PER_00338]; o seu estado de modificação é mantido em FileModificationState como kModifiedDuringReset [SWS_PER_00436].

A operação é segura para threads bem como segura contra exceções e devolve sincronamente um ara::core::Result<void> [SWS_PER_00338]. Falha com PerErrc::kResourceBusy se o ficheiro estiver atualmente aberto – por exemplo, através de [SWS_PER_00113] – ou se ocorrer em simultâneo uma execução de [SWS_PER_00111] ou [SWS_PER_00337] com o mesmo nome de ficheiro [SWS_PER_00338].

Adicionalmente, a interface define casos de erro específicos [SWS_PER_00338]:

• PerErrc::kInitValueNotAvailable: Não está configurado nenhum valor inicial nem no Application Design nem na Target Configuration [SWS_PER_00338].
• PerErrc::kQuotaExceeded ou PerErrc::kTooManyFiles: O ficheiro restaurado excederia o limite AllowedSize ou maxNumberOfFiles [SWS_PER_00338].
• PerErrc::kOutOfStorageSpace ou StorageFailure: O espaço de armazenamento físico não é suficiente ou o acesso físico falha [SWS_PER_00338].
• PerErrc::kEncryptionFailed ou PerErrc::kAuthenticationFailed: A encriptação/desencriptação ou a verificação de MAC dos dados armazenados falha [SWS_PER_00338].