DEENESPTFRRUARHIKOZHNL

structure ara::per::FileInfo

[SWS_PER_00437] Upstream: RS_PER_00004, RS_AP_00122

struct FileInfo {...};

This structure contains additional information on a file returned by GetFileInfo.

Header-Datei#include "ara/per/file_storage.h"
Forwarding-Header#include "ara/per/per_fwd.h"
Scopenamespace ara::per

Guide utilisateurGÉNÉRÉ PAR IA

Regroupe les horodatages et les informations d'état relatifs à l'origine et aux modifications d'un fichier dans le module de persistance adaptatif.
GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : c3acbafda95f Provenance Questions ouvertes (3)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

Regroupe les horodatages et les informations d'état relatifs à l'origine et aux modifications d'un fichier dans le module de persistance adaptatif.

La structure ara::per::FileInfo sert de conteneur de métadonnées pour les fichiers persistants et est retournée par GetFileInfo. Elle fournit des horodatages basés sur UTC en nanosecondes pour la création [SWS_PER_00441], la modification [SWS_PER_00442] et l'accès [SWS_PER_00443], ainsi que des indications d'état relatives à la création [SWS_PER_00444] et à la dernière modification [SWS_PER_00445]. En tant que type de données passif, elle est soumise à la sémantique de valeur de l'application et n'offre aucune synchronisation de threads propre.

Contexte

La structure ara::per::FileInfo sert, dans le module per (Persistency) de l'AUTOSAR Adaptive Platform, de support de données structuré pour les métadonnées administratives de fichier. Lors des opérations sur fichiers traitées via les interfaces du fichier d'en-tête ara/per/file_storage.h, le module de persistance sépare les informations de gestion des contenus de fichier proprement dits. La structure est fournie comme résultat de l'opération GetFileInfo et assume la fonction d'objet de transfert de données (Data Transfer Object) entre la couche de persistance et l'application appelante.

Sur le plan du contenu, FileInfo regroupe deux catégories d'attributs : des données de journalisation temporelle précises et des informations d'état qualitatives sur la création et la maintenance d'un fichier. Les indications temporelles comprennent l'horodatage de création [SWS_PER_00441], l'horodatage de modification [SWS_PER_00442] ainsi que l'horodatage du dernier accès [SWS_PER_00443]. Ces métadonnées sont complétées par des caractéristiques d'état descriptives qui détaillent comment et par qui le fichier a été créé [SWS_PER_00444] ainsi que modifié pour la dernière fois [SWS_PER_00445].

Cycle de vie

En tant que structure C++ passive (struct), FileInfo ne possède pas de logique d'état autonome ni de cycle de vie actif à l'exécution. L'instanciation s'effectue typiquement au sein de l'implémentation de la persistance pendant l'exécution de GetFileInfo. À cette occasion, les métadonnées sont lues depuis le système de fichiers sous-jacent et transférées dans les champs de données de la structure. La transmission à l'application s'effectue vraisemblablement sous forme de copie par valeur ou encapsulée dans un type de résultat, transférant ainsi intégralement la propriété et la responsabilité du cycle de vie au composant appelant. Question Q-f5a9cf72c47f805e (ouverte)

La durée de vie d'une instance FileInfo est liée à la portée dans laquelle l'application déclare la variable ; à la sortie de la portée, la structure est automatiquement libérée. Comme FileInfo encapsule de simples champs de données et ne fournit aucun mécanisme interne de synchronisation, la structure n'est pas thread-safe : en cas d'accès concurrent de plusieurs threads à la même instance, une synchronisation explicite devrait être requise côté application dès lors qu'au moins un accès s'effectue en écriture. Question Q-139f5e8f58d3fe07 (ouverte)

Parcours d'utilisation

Le déroulement typique de l'utilisation de FileInfo comprend l'interrogation des informations de fichier via l'interface de stockage de fichiers, puis l'évaluation des attributs par l'application. L'application initie l'interrogation par l'appel de GetFileInfo en spécifiant le fichier cible. Après un retour réussi, l'ensemble des métadonnées est directement accessible via les variables membres publiques.

Récupération et évaluation des métadonnées de fichierApplicationFileStorageFileInfoGetFileInfo(fileName)Créer l'instance et remplir les champsRetour FileInfoVérifier l'horodatage et les champs d'état

Diagramme de séquence : déroulement typique de la récupération et de l'évaluation des métadonnées de fichier via GetFileInfo. Sources : [SWS_PER_00441], [SWS_PER_00442], [SWS_PER_00443], [SWS_PER_00444], [SWS_PER_00445].

Lors de l'évaluation, l'application lit les horodatages :

  • creationTime représente l'horodatage de la création du fichier en nanosecondes depuis le 01/01/1970 UTC (époque Unix) [SWS_PER_00441].
  • modificationTime indique l'horodatage de la dernière modification de contenu dans le même format en nanosecondes [SWS_PER_00442].
  • accessTime documente l'horodatage du dernier accès en lecture ou en écriture en nanosecondes depuis le 1970-01-01 UTC [SWS_PER_00443].

En plus du positionnement temporel, l'application vérifie les attributs fileCreationState [SWS_PER_00444] et fileModificationState [SWS_PER_00445]. Ces valeurs d'énumération indiquent dans quelles conditions et par qui le fichier a été créé ou modifié. Cela permet à l'application de vérifier si un fichier a été créé régulièrement en exploitation normale, pendant un processus de reprise ou par une procédure de mise à jour, avant que d'autres opérations de lecture ou d'écriture ne soient exécutées sur le contenu du fichier.

Ce guide de classe a été généré par un assistant IA à partir de la spécification AUTOSAR pour la release R25-11.

Carte des membres

Diagramme de classes

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G nara__per__FileInfo503 «struct» FileInfo + accessTime + creationTime + fileCreationState + fileModificationState + modificationTime

Vue détaillée

Sélectionnez une entrée dans le plan.

Constantes

accessTime variable

Time in nanoseconds since midnight 1970-01-01 UTC at which the file was last accessed.

std::uint64_t accessTime;
creationTime variable

Time in nanoseconds since midnight 1970-01-01 UTC at which the file was created.

std::uint64_t creationTime;

Information on how and by whom the file was created.

FileCreationState fileCreationState;

Information on how and by whom the file was last modified.

FileModificationState fileModificationState;

Time in nanoseconds since midnight 1970-01-01 UTC at which the file was last modified.

std::uint64_t modificationTime;

Documentation des constantes / variables

variable accessTime [SWS_PER_00443] Upstream: RS_PER_00004

std::uint64_t accessTime;

Time in nanoseconds since midnight 1970-01-01 UTC at which the file was last accessed.

Header-Datei#include "ara/per/file_storage.h"
Scopestruct ara::per::FileInfo
SymbolaccessTime
Typstd::uint64_t

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_PER_00443
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PER_00443@rel:R25-11#a52f457e
Content hash
a52f457e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00443
Status: valid/unmigrated Version: rel:R25-11#0c3b2ea7 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_PER_00443@rel:R25-11#0c3b2ea7
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#a52f457e2026-09-30
  • R20-11rel:R20-11#c3c78f402026-10-14
  • R21-11rel:R21-11#1fd0675a2026-10-14
  • R22-11rel:R22-11#4d72990b2026-10-14
  • R23-11rel:R23-11#0c3b2ea72026-10-14
  • R24-11rel:R24-11#0c3b2ea72026-10-14
  • R25-11rel:R25-11#0c3b2ea72026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

variable creationTime [SWS_PER_00441] Upstream: RS_PER_00004

std::uint64_t creationTime;

Time in nanoseconds since midnight 1970-01-01 UTC at which the file was created.

Header-Datei#include "ara/per/file_storage.h"
Scopestruct ara::per::FileInfo
SymbolcreationTime
Typstd::uint64_t

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_PER_00441
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PER_00441@rel:R25-11#87034c82
Content hash
87034c82
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00441
Status: valid/unmigrated Version: rel:R25-11#128ec43c Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_PER_00441@rel:R25-11#128ec43c
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#87034c822026-09-30
  • R20-11rel:R20-11#abb3400d2026-10-14
  • R21-11rel:R21-11#406c80992026-10-14
  • R22-11rel:R22-11#9868f2512026-10-14
  • R23-11rel:R23-11#3b4c30052026-10-14
  • R24-11rel:R24-11#3b4c30052026-10-14
  • R25-11rel:R25-11#128ec43c2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

variable fileCreationState [SWS_PER_00444] Upstream: RS_PER_00004

FileCreationState fileCreationState;

Information on how and by whom the file was created.

Header-Datei#include "ara/per/file_storage.h"
Scopestruct ara::per::FileInfo
SymbolfileCreationState
TypFileCreationState

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_PER_00444
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PER_00444@rel:R25-11#24e1cc7d
Content hash
24e1cc7d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00444
Status: valid/unmigrated Version: rel:R25-11#c8568e53 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_PER_00444@rel:R25-11#c8568e53
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#24e1cc7d2026-09-30
  • R20-11rel:R20-11#3a13cd782026-10-14
  • R21-11rel:R21-11#3a13cd782026-10-14
  • R22-11rel:R22-11#cb985c4a2026-10-14
  • R23-11rel:R23-11#c8568e532026-10-14
  • R24-11rel:R24-11#c8568e532026-10-14
  • R25-11rel:R25-11#c8568e532026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

variable fileModificationState [SWS_PER_00445] Upstream: RS_PER_00004

FileModificationState fileModificationState;

Information on how and by whom the file was last modified.

Header-Datei#include "ara/per/file_storage.h"
Scopestruct ara::per::FileInfo
SymbolfileModificationState
TypFileModificationState

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_PER_00445
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PER_00445@rel:R25-11#2450e463
Content hash
2450e463
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00445
Status: valid/unmigrated Version: rel:R25-11#6371f418 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_PER_00445@rel:R25-11#6371f418
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#2450e4632026-09-30
  • R20-11rel:R20-11#c2a6b5522026-10-14
  • R21-11rel:R21-11#c2a6b5522026-10-14
  • R22-11rel:R22-11#5d73b03d2026-10-14
  • R23-11rel:R23-11#6371f4182026-10-14
  • R24-11rel:R24-11#6371f4182026-10-14
  • R25-11rel:R25-11#6371f4182026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

variable modificationTime [SWS_PER_00442] Upstream: RS_PER_00004

std::uint64_t modificationTime;

Time in nanoseconds since midnight 1970-01-01 UTC at which the file was last modified.

Header-Datei#include "ara/per/file_storage.h"
Scopestruct ara::per::FileInfo
SymbolmodificationTime
Typstd::uint64_t

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_PER_00442
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PER_00442@rel:R25-11#0ee0f8de
Content hash
0ee0f8de
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00442
Status: valid/unmigrated Version: rel:R25-11#58665943 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_PER_00442@rel:R25-11#58665943
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#0ee0f8de2026-09-30
  • R20-11rel:R20-11#1094540b2026-10-14
  • R21-11rel:R21-11#2f2714482026-10-14
  • R22-11rel:R22-11#620d66d02026-10-14
  • R23-11rel:R23-11#586659432026-10-14
  • R24-11rel:R24-11#586659432026-10-14
  • R25-11rel:R25-11#586659432026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill