DEENESPTFRRUARHIKOZHNL

estructura 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

Guía del usuarioGENERADO POR IA

Agrupa marcas de tiempo e información de estado sobre el origen y las modificaciones de un archivo en el módulo adaptativo de persistencia.
GENERADO POR IA no revisado Modelo: gemini-3.8-flash-medium · Esfuerzo: medium · Temperatura: no controlable · Prompt: c3acbafda95f Procedencia Preguntas abiertas (3)
traducido de la guía alemanagemini-3.8-flash-low · 2026-10-13 · Original en alemán

Agrupa marcas de tiempo e información de estado sobre el origen y las modificaciones de un archivo en el módulo adaptativo de persistencia.

La estructura ara::per::FileInfo sirve como contenedor de metadatos para archivos persistentes y es devuelta por GetFileInfo. Proporciona marcas de tiempo basadas en UTC en nanosegundos para la creación [SWS_PER_00441], modificación [SWS_PER_00442] y acceso [SWS_PER_00443], así como indicaciones de estado relativas al origen [SWS_PER_00444] y a la última edición [SWS_PER_00445]. Como tipo de datos pasivo, está sujeta a la semántica de valor de la aplicación y no ofrece sincronización de subprocesos propia.

Contexto

La estructura ara::per::FileInfo sirve en el módulo per (Persistency) de AUTOSAR Adaptive Platform como portador de datos estructurado para metadatos administrativos de archivo. En operaciones sobre archivos procesadas a través de las interfaces del archivo de cabecera ara/per/file_storage.h, el módulo de persistencia separa la información de gestión del contenido real del archivo. La estructura se proporciona como resultado de la operación GetFileInfo y asume la función de un objeto de transferencia de datos (Data Transfer Object) entre la capa de persistencia y la aplicación invocadora.

En cuanto a su contenido, FileInfo resume dos categorías de atributos: datos de registro cronológicos precisos e información cualitativa de estado sobre el origen y mantenimiento de un archivo. Entre las indicaciones de tiempo se incluyen la hora de creación [SWS_PER_00441], la hora de modificación [SWS_PER_00442] y la hora del último acceso [SWS_PER_00443]. Estos metadatos se complementan con características descriptivas de estado que detallan cómo y por quién fue creado el archivo [SWS_PER_00444], así como cuándo fue modificado por última vez [SWS_PER_00445].

Ciclo de vida

Como estructura pasiva de C++ (struct), FileInfo no posee lógica de estado independiente ni un ciclo de vida de tiempo de ejecución activo. La instanciación tiene lugar típicamente dentro de la implementación de persistencia durante la ejecución de GetFileInfo. En este proceso, los metadatos se leen del sistema de archivos subyacente y se transfieren a los campos de datos de la estructura. La entrega a la aplicación se efectúa probablemente como copia de valor o encapsulada en un tipo de resultado, con lo que la propiedad y la responsabilidad del ciclo de vida se transfieren por completo al componente invocador. Pregunta Q-f5a9cf72c47f805e (abierta)

La vida útil de una instancia de FileInfo está ligada al ámbito en el que la aplicación declara la variable; al salir del ámbito, la estructura se libera automáticamente. Dado que FileInfo encapsula campos de datos puros y no proporciona mecanismos de sincronización internos, la estructura no es segura para subprocesos: en caso de acceso concurrente de varios subprocesos a la misma instancia, es probable que se requiera una sincronización explícita del lado de la aplicación, siempre que al menos un acceso sea de escritura. Pregunta Q-139f5e8f58d3fe07 (abierta)

Ruta de uso

El flujo típico para el uso de FileInfo comprende la consulta de la información del archivo a través de la interfaz de almacenamiento de archivos y la posterior evaluación de los atributos por parte de la aplicación. La aplicación inicia la consulta invocando GetFileInfo e indicando el archivo de destino. Tras una devolución correcta, todos los metadatos están disponibles directamente a través de las variables miembro públicas.

Obtención y evaluación de metadatos de archivoAplicaciónFileStorageFileInfoGetFileInfo(fileName)Crear instancia y rellenar camposDevolución de FileInfoComprobar marcas de tiempo y campos de estado

Diagrama de secuencia: Flujo típico para la obtención y evaluación de metadatos de archivo a través de GetFileInfo. Fuentes: [SWS_PER_00441], [SWS_PER_00442], [SWS_PER_00443], [SWS_PER_00444], [SWS_PER_00445].

Durante la evaluación, la aplicación lee las marcas de tiempo:

  • creationTime representa el momento de creación del archivo en nanosegundos desde el 01/01/1970 UTC (época Unix) [SWS_PER_00441].
  • modificationTime indica el momento de la última modificación de contenido en el mismo formato de nanosegundos [SWS_PER_00442].
  • accessTime documenta el momento del último acceso de lectura o escritura en nanosegundos desde 1970-01-01 UTC [SWS_PER_00443].

Además de la clasificación temporal, la aplicación comprueba los atributos fileCreationState [SWS_PER_00444] y fileModificationState [SWS_PER_00445]. Estos valores de enumeración indican bajo qué condiciones y por quién se creó o modificó el archivo. Esto permite a la aplicación verificar si un archivo se generó de manera regular en funcionamiento productivo, durante un proceso de recuperación o mediante un procedimiento de actualización, antes de realizar más operaciones de lectura o escritura sobre el contenido del archivo.

Esta guía de clase fue generada por un asistente de IA a partir de la especificación de AUTOSAR para el Release R25-11.

Mapa de miembros

Diagrama de clases

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

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

Vista de detalle

Selecciona una entrada en el índice.

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;

Documentación de las 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