пространство имён ara::per

Руководство пользователяСОЗДАНО ИИ

Обеспечивает персистентное хранение и управление данными приложений через хранилища «ключ-значение» и файловые хранилища.

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 9cb072b2740a Происхождение Открытые вопросы (1)

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Пространство имен ara::per предоставляет интерфейсы для персистентного хранения данных, предоставляя адаптивным приложениям доступ к файловым областям хранения и хранилищам типа «ключ-значение» через идентификаторы экземпляров ([SWS_PER_00052], [SWS_PER_00116]). Приложения управляют открытыми хранилищами через разделяемые дескрипторы, выполняют скоординированные обновления при изменениях манифеста и могут восстанавливать несогласованные данные с помощью механизмов восстановления ([SWS_PER_00333], [SWS_PER_00357]). В то время как доступ к хранилищу осуществляется параллельно через дескрипторы, административные операции, такие как обновления или сбросы хранилища, требуют отсутствия конкурирующих обращений ([SWS_PER_00311]).

Контекст

Пространство имен ara::per предоставляет интерфейсы функционального кластера персистентности для AUTOSAR Adaptive Platform. Его основная ответственность заключается в долговременном хранении данных приложений, сохраняющемся между перезапусками системы и жизненными циклами процессов. Модуль различает две базовые парадигмы хранения: KeyValueStorage для структурированных пар «ключ-значение» и FileStorage для файлового доступа к хранилищу. Адаптивные приложения обращаются к этим ресурсам через сконфигурированные прототипы портов с помощью ara::core::InstanceSpecifier ([SWS_PER_00052], [SWS_PER_00116]).

Важными партнерами пространства имен по взаимодействию являются Update and Configuration Management (UCM), способный предоставлять обновленные целевые конфигурации (Target Configuration) во время выполнения ([SWS_PER_00576], [SWS_PER_00577]), а также физический носитель данных, на котором ara::per гарантирует целостность, избыточность и безопасность данных ([SWS_PER_00311]).

Контекстная диаграмма: взаимодействие между приложением, ara::per, Update Management и физическим накопителем. Источники: [SWS_PER_00052], [SWS_PER_00116], [SWS_PER_00576]

Жизненный цикл

Доступ к объектам хранилища регулируется через абстракции дескрипторов. Открытие хранилища через OpenKeyValueStorage или OpenFileStorage создает SharedHandle ([SWS_PER_00052], [SWS_PER_00116]). Поскольку несколько потоков могут одновременно обращаться к одному и тому же хранилищу, физический ресурс не обязательно закрывается при выходе отдельного SharedHandle из области видимости; закрытие происходит только тогда, когда удалены все ссылающиеся экземпляры SharedHandle ([SWS_PER_00052], [SWS_PER_00116]).

Для файлов внутри FileStorage детально отслеживаются состояния создания и модификации. Перечисление FileCreationState отображает, был ли файл создан при установке (kCreatedDuringInstallation), во время обновления (kCreatedDuringUpdate), в результате сброса (kCreatedDuringReset), вследствие восстановления (kCreatedDuringRecovery) или самим приложением (kCreatedByApplication) ([SWS_PER_00435]). Аналогично FileModificationState отражает, когда и в результате какой операции файл был изменен в последний раз ([SWS_PER_00436]).

Для управления исходными состояниями пространство имен предоставляет функции сброса: ResetKeyValueStorage ([SWS_PER_00334]) и ResetAllFiles ([SWS_PER_00336]) возвращают отдельные хранилища к значениям, изначально определенным в манифесте. В отличие от этого глобальная операция ResetPersistency ([SWS_PER_00358]) полностью очищает все хранилища «ключ-значение» и файловые хранилища; их повторное создание происходит при следующем вызове OpenFileStorage или OpenKeyValueStorage.

С точки зрения параллелизма функции открытия (OpenFileStorage, OpenKeyValueStorage), запросы размера хранилища (GetCurrentFileStorageSize, GetCurrentKeyValueStorageSize), а также связанные с хранилищем функции восстановления и сброса являются потокобезопасными ([SWS_PER_00052], [SWS_PER_00116], [SWS_PER_00405], [SWS_PER_00406], [SWS_PER_00333], [SWS_PER_00334], [SWS_PER_00335], [SWS_PER_00336]). Глобальные операции обновления и очистки, такие как UpdatePersistency ([SWS_PER_00357]), CleanUpPersistency ([SWS_PER_00567]), ResetPersistency ([SWS_PER_00358]), CheckForManifestUpdate ([SWS_PER_00576]) и ReloadPersistencyManifest ([SWS_PER_00577]), напротив, объявлены как непотокобезопасные.

Путь использования

Типичный процесс работы приложения включает проверку наличия обновлений конфигурации, применение миграций данных и последующий доступ к хранилищу:

До или во время штатного режима работы приложение проверяет с помощью CheckForManifestUpdate, установил ли UCM новую целевую конфигурацию ([SWS_PER_00576]). Если это так, новый манифест считывается через ReloadPersistencyManifest ([SWS_PER_00577]). Во время последующей фазы верификации приложение инициирует UpdatePersistency ([SWS_PER_00357]). Для управления версионными миграциями данных приложение предварительно регистрирует функцию обратного вызова через RegisterApplicationDataUpdateCallback, которая получает уведомления об устаревших версиях контракта и выполняет собственные шаги миграции приложения ([SWS_PER_00356]). Дополнительно изменения элементов могут отслеживаться с помощью RegisterDataUpdateIndication ([SWS_PER_00578]). После завершения обновления CleanUpPersistency удаляет устаревшие резервные копии и избыточные старые данные ([SWS_PER_00567]).

Для штатного доступа приложение открывает целевой ресурс через OpenKeyValueStorage ([SWS_PER_00052]) или OpenFileStorage ([SWS_PER_00116]). Обращения к файлам в FileStorage управляются битовыми масками перечисления OpenMode (например, kAtTheBeginning, kAtTheEnd, kTruncate, kAppend), комбинируемыми через операторы operator| ([SWS_PER_00144]) и operator|= ([SWS_PER_00434]) ([SWS_PER_00147]). Позиционирование выполняется относительно Origin (kBeginning, kCurrent, kEnd) ([SWS_PER_00146]). Текущий занятый размер хранилища может быть определен во время выполнения через GetCurrentKeyValueStorageSize ([SWS_PER_00405]) и GetCurrentFileStorageSize ([SWS_PER_00406]).

Диаграмма последовательности: процесс проверки обновлений манифеста, выполнения обновления и последующего доступа к хранилищу «ключ-значение». Источники: [SWS_PER_00052], [SWS_PER_00356], [SWS_PER_00357], [SWS_PER_00567], [SWS_PER_00576], [SWS_PER_00577]

Сценарии ошибок

Ошибки в пространстве имен стандартизированно сигнализируются через перечисление PerErrc ([SWS_PER_00311]) в сочетании с PerErrorDomain ([SWS_PER_00352]) и MakeErrorCode ([SWS_PER_00351]). Объявленный класс PerException, вероятно, служит типом C++-исключений для окружений, в которых ошибки обрабатываются не через ara::core::Result, а с помощью исключений (интерпретация). Вопрос Q-263982a4a4dae284 (открытый)

Ключевые сценарии ошибок включают:

Ошибки конфигурации и адресации: если переданный InstanceSpecifier не соответствует ни одному сконфигурированному в модели интерфейсу порта, открытие завершается сбоем с PerErrc::kStorageNotFound ([SWS_PER_00052], [SWS_PER_00116], [SWS_PER_00311]). Обращения к несуществующим файлам порождают PerErrc::kFileNotFound ([SWS_PER_00311]).
Конфликты ресурсов: если хранилища открыты или одновременно выполняются административные команды, такие операции, как OpenKeyValueStorage, OpenFileStorage, RecoverKeyValueStorage, RecoverAllFiles, ResetKeyValueStorage, ResetAllFiles, UpdatePersistency, CleanUpPersistency или ResetPersistency, завершаются сбоем с PerErrc::kResourceBusy ([SWS_PER_00052], [SWS_PER_00116], [SWS_PER_00333], [SWS_PER_00334], [SWS_PER_00335], [SWS_PER_00336], [SWS_PER_00357], [SWS_PER_00358], [SWS_PER_00567]).
Потеря целостности и восстановление: при структурных повреждениях (PerErrc::kIntegrityCorrupted) или неудавшихся проверках избыточности (PerErrc::kValidationFailed) ara::per обеспечивает восстановление по мере возможностей (best-effort) через RecoverKeyValueStorage ([SWS_PER_00333]) или RecoverAllFiles ([SWS_PER_00335]). Через RegisterRecoveryReportCallback ([SWS_PER_00433]) приложения, критичные к безопасности, могут автоматически протоколировать корректирующие меры на основе RecoveryReportKind (например, kKeyValueStorageRecovered, kFileRecovered) ([SWS_PER_00432]).
Пределы памяти и физические ошибки: при превышении квот или физической емкости сообщается о PerErrc::kOutOfStorageSpace, PerErrc::kQuotaExceeded или PerErrc::kTooManyFiles ([SWS_PER_00311]). Аппаратные сбои или ошибки файловой системы приводят к PerErrc::kPhysicalStorageFailure ([SWS_PER_00311]).
Безопасность и режимы доступа: в случае сбоя криптографических проверок или вычислений модуль возвращает PerErrc::kEncryptionFailed или PerErrc::kAuthenticationFailed ([SWS_PER_00311]). Попытки записи в защищенные от записи области хранилища отклоняются с PerErrc::kIllegalWriteAccess ([SWS_PER_00311]).

Настоящее руководство основано исключительно на спецификации AUTOSAR Adaptive R25-11.

Карта тем

KI-gestützte Gruppierung auf Basis der Records und Spezifikationsauszüge; keine Gliederung aus der AUTOSAR-Spezifikation.

Диаграмма классов

Abgerundete Rahmen = Namespace- bzw. Klassen-Scopes; hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); graue Boxen = namespace-fremde bzw. externe Basisklassen. Klicken öffnet die jeweilige Klassen- bzw. cppreference-Seite.

Подробный вид

Выберите элемент в оглавлении.

Для этого релиза нет данных об элементах

Dateizugriff

FileAccessor класс

FileAccessor contains a common basis for ReadAccessor and WriteAccessor

база для ReadAccessor, WriteAccessor

FileInfo класс

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

ReadAccessor класс

ReadAccessor is used to read file data

наследует от FileAccessor

база для ReadWriteAccessor

ReadWriteAccessor класс

ReadWriteAccessor is used to read and write file data

наследует от ReadAccessor, WriteAccessor

UniqueHandle класс

Handle to a ReadAccessor or ReadWriteAccessor

WriteAccessor класс

WriteAccessor is used to write file data

наследует от FileAccessor

база для ReadWriteAccessor

operator| функция

Merges two OpenMode modifiers into one.

constexpr OpenMode operator| (OpenMode left, OpenMode right);

operator|= функция

Merges an OpenMode modifier into this OpenMode.

OpenMode & operator|= (OpenMode &left, const OpenMode &right);

FileCreationState перечисление

This enumeration describes how and when a file was created.

enum class FileCreationState : std::uint32_t {...};

FileModificationState перечисление

This enumeration describes how and when a file was last modified.

enum class FileModificationState : std::uint32_t {...};

OpenMode перечисление

This enumeration defines how a file shall be opened. The values can be combined (using | and |=) as long as they do not contradict each other.

enum class OpenMode : std::uint32_t {...};

Origin перечисление

Specification of origin used in MovePosition.

enum class Origin : std::uint32_t {...};

Speicheröffnung

FileStorage класс

The File Storage contains a set of files identified by their file names.

KeyValueStorage класс

The Key-Value Storage contains a set of keys with associated values.

SharedHandle класс

Handle to a File Storage or Key-Value Storage

GetCurrentFileStorageSize функция

Returns the space in bytes currently occupied by a File Storage. The returned size includes all metadata and the space used for redundancy and backups. The returned size is only guaranteed to be accurate if the File Storage is not opened and no other operation on the File Storage takes place at the same time.

ara::core::Result< std::uint64_t > GetCurrentFileStorageSize (const ara::core::InstanceSpecifier &fs) noexcept;

GetCurrentKeyValueStorageSize функция

Returns the space in bytes currently occupied by a Key-Value Storage. The returned size includes all metadata and the space used for redundancy and backups. The returned size is only guaranteed to be accurate if the Key-Value Storage is not opened and no other operation on the Key-Value Storage takes place at the same time.

ara::core::Result< std::uint64_t > GetCurrentKeyValueStorageSize (const ara::core::InstanceSpecifier &kvs) noexcept;

OpenFileStorage функция

Opens a File Storage. OpenFileStorage will fail with kResourceBusy when the File Storage is currently being modified by a call from another thread to UpdatePersistency, CleanUpPersistency, ResetPersistency, RecoverAllFiles, or ResetAllFiles. Because multiple threads can access the same File Storage concurrently, the File Storage might not be closed when the SharedHandle returned by this function goes out of scope. It will only be closed when all SharedHandles that refer to the same File Storage went out of scope.

ara::core::Result< SharedHandle< FileStorage > > OpenFileStorage (const ara::core::InstanceSpecifier &fs) noexcept;

OpenKeyValueStorage функция

Opens a Key-Value Storage. OpenKeyValueStorage will fail with kResourceBusy when the Key-Value Storage is currently being modified by a call from another thread to UpdatePersistency, CleanUpPersistency, Reset Persistency, RecoverKeyValueStorage, or ResetKeyValueStorage. Because multiple threads can access the same Key-Value Storage concurrently, the Key-Value Storage might not be closed when the SharedHandle returned by this function goes out of scope. It will only be closed when all SharedHandles that refer to the same Key-Value Storage went out of scope.

ara::core::Result< SharedHandle< KeyValueStorage > > OpenKeyValue Storage (const ara::core::InstanceSpecifier &kvs) noexcept;

Fehlerbehandlung

PerErrorDomain класс

Defines the error domain for Persistency.

наследует от ara::core::ErrorDomain

PerException класс

Exception type thrown by Persistency.

наследует от ara::core::Exception

GetPerDomain функция

Returns the global PerErrorDomain object.

constexpr const ara::core::ErrorDomain & GetPerDomain () noexcept;

MakeErrorCode функция

Creates an error code.

constexpr ara::core::ErrorCode MakeErrorCode (PerErrc code, ara::core::ErrorDomain::SupportDataType data) noexcept;

PerErrc перечисление

Defines the errors for Persistency. The enumeration values 0 - 255 are reserved for AUTOSAR assigned errors, the stack provider is free to define additional errors starting from 256.

enum class PerErrc : ara::core::ErrorDomain::CodeType {...};

Wiederherstellung

RecoverAllFiles функция

Recovers a File Storage, including all files. RecoverAllFiles recovers a File Storage when the redundancy checks fail. It will fail with kResourceBusy when the File Storage is currently open, or when it is modified by a call from another thread to UpdatePersistency, CleanUpPersistency, ResetPersistency, RecoverAllFiles, or ResetAllFiles. This method does a best-effort recovery of all files. After recovery, files might show outdated or initial content, or might be lost.

ara::core::Result< void > RecoverAllFiles (const ara::core::Instance Specifier &fs) noexcept;

RecoverKeyValueStorage функция

Recovers a Key-ValueStorage. RecoverKeyValueStorage allows to recover a Key-Value Storage when the redundancy checks fail. It will fail with kResourceBusy when the Key-Value Storage is currently open, or when it is modified by a call from another thread to UpdatePersistency, CleanUpPersistency, Reset Persistency, RecoverKeyValueStorage, or ResetKeyValueStorage. This method does a best-effort recovery of all key-value pairs. After recovery, keys might show outdated or initial value, or might be lost.

ara::core::Result< void > RecoverKeyValueStorage (const ara::core::InstanceSpecifier &kvs) noexcept;

RegisterRecoveryReportCallback функция

Register a recovery reporting callback with Persistency. This callback can be used in safety-aware Adaptive Applications to detect actions of the Persistency that are related to the correctness of the persisted data and the reliability of the storage.

void RegisterRecoveryReportCallback (std::function< void(const ara::core::InstanceSpecifier &storage, ara::per::RecoveryReportKind recoveryReportKind, ara::core::Vector< ara::core::String > reported Elements, ara::core::Vector< std::uint8_t > reportedInstances)> recoveryReportCallback) noexcept;

RecoveryReportKind перечисление

Defines the reported recovery actions.

enum class RecoveryReportKind : std::uint32_t {...};

Datenpflege

CheckForManifestUpdate функция

Checks for updates of the Persistency Target Configuration. This method can be used to detect configuration updates that are installed by UCM while the Adaptive Application that uses Persistency is running. To re-read the updated Target Configuration, the Adaptive Application needs to call ara::per:: ReloadPersistencyManifest.

ara::core::Result< bool > CheckForManifestUpdate () noexcept;

CleanUpPersistency функция

Removes backup data and other unused data of all Persistency Key-Value Storages and File Storages.

ara::core::Result< void > CleanUpPersistency () noexcept;

RegisterApplicationDataUpdateCallback функция

Registers an application data update callback with Persistency. The provided callback function will be called by Persistency if an update of stored application data might be necessary. This decision is based on the contract versions. The contract version that last accessed Persistency is provided as an argument to the callback, as well as the ara::core::InstanceSpecifier referring to the updated Key- Value Storage or File Storage. Based on this information, the Adaptive Application can decide which updates are actually necessary, e.g. a migration from any older contract version could be supported, with different steps required for each of these. The provided function will be called from the context of ara::per::UpdatePersistency, ara::per::OpenKeyValueStorage, or ara::per::OpenFileStorage.

void RegisterApplicationDataUpdateCallback (std::function< void(const ara::core::InstanceSpecifier &storage, ara::core::String contract Version)> appDataUpdateCallback) noexcept;

RegisterDataUpdateIndication функция

Registers a data update indication callback with Persistency. The provided callback function will be called by Persistency when an update of stored data happened. It will be called from the context of ara::per::UpdatePersistency, ara:: per::OpenKeyValueStorage, or ara::per::OpenFileStorage.

void RegisterDataUpdateIndication (std::function< void(const ara::core::InstanceSpecifier &updatedStorage, ara::core::StringView updatedElement)> dataUpdateIndication, ara::core::InstanceSpecifier monitoredStorage, ara::core::Vector< ara::core::String > monitored Elements) noexcept;

ReloadPersistencyManifest функция

Re-reads the Target Configuration. This method can be used to prepare for updates of the Key-Value Storages and File Storages of Persistency after a new Target Configuration was installed by UCM while the Adaptive Application that uses Persistency is running. Storages are only updated after closing them, either when they are opened again or by an explicit call to ara:: per::UpdatePersistency.

ara::core::Result< void > ReloadPersistencyManifest () noexcept;

ResetAllFiles функция

Resets a File Storage, including all files. ResetAllFiles resets a File Storage to the initial state, containing only the files which were deployed from the Target Configuration, with their initial content. Afterwards, the File Storage will appear as if it was newly installed from the current Target Configuration. It will fail with kResourceBusy when the File Storage is currently open, or when it is modified by a call from another thread to UpdatePersistency, CleanUpPersistency, ResetPersistency, RecoverAllFiles, or ResetAllFiles.

ara::core::Result< void > ResetAllFiles (const ara::core::Instance Specifier &fs) noexcept;

ResetKeyValueStorage функция

Resets a Key-Value Storage to the initial state. ResetKeyValueStorage allows to reset a Key-Value Storage to the initial state, containing only key-value pairs which were deployed from the Target Configuration, with their initial values. Afterwards, the Key-Value Storage will appear as if it was newly installed from the current Target Configuration. It will fail with kResourceBusy when the Key-Value Storage is currently open, or when it is modified by a call from another thread to UpdatePersistency, CleanUpPersistency, Reset Persistency, RecoverKeyValueStorage, or ResetKeyValueStorage.

ara::core::Result< void > ResetKeyValueStorage (const ara::core::InstanceSpecifier &kvs) noexcept;

ResetPersistency функция

Resets all Key-Value Storages and File Storages by entirely removing their content. The Key-Value Storages and File Storages will be re-created when ara::per:: OpenFileStorage or ara::per::OpenKeyValueStorage is called next time.

ara::core::Result< void > ResetPersistency () noexcept;

UpdatePersistency функция

Updates all Persistency Key-Value Storages and File Storages after a new Target Configuration was installed. This method can be used to update the persistent data of the Adaptive Application during verification phase.

ara::core::Result< void > UpdatePersistency () noexcept;

Нажмите на элемент, чтобы увидеть его связи.

Базовый классПроизводныеИспользуетИспользуется вНаследованиеудалено начиная сВстречается вНет связей в этом пространстве имёнФункцииКомментарий ИИОткрыть страницу классаНе удалось загрузить страницу класса.Изменить порядокИзменить ширинуИзменить ширину структурыРазделыВремя чтенияСсылки SWSДиаграммыВернуть в серединуИзменить порядок или перетащить на строку заголовкаОткрепить – показать в содержимомПереместить в среднюю колонкуЗакрепить вкладкой в строке заголовкаЭлементыМодель ИИОткрыть аудиторское досьеДосьеОткрыть краткую версиюОткрыть среднюю версиюОткрыть полную версиюВосстановить вид по умолчаниюВид по умолчанию восстановленОтменитьЗакрыть подробный видСигнатураОбщие сведенияЗначенияПоследнее изменение до выбранного релизаСледующее изменение после негоЩелчок: выбрать релизЗдесь нельзя отпустить: перетащите на строку заголовка, чтобы закрепить, или в среднюю колонку, чтобы открепить.новыйизменёнбез измененийудалённе включёнИзмененияСодержание не изменилосьВпервые вУдалён вДанные о версиях недоступны.Загрузка данных о версиях …ТекстФормулировка в этом релизе не зафиксированаНаведите или щёлкните ячейку: сравнить с выбранным релизом · Щелчок по заголовку релиза: выбрать релизВыбрать релизСведенияРелизЭлементТолько один релиз с формулировкойесть в PDF, текст ещё не импортированТекст сохранён впервыебез изменений с {rel}Цвета выпусковсамый ранний выпусксамый новый выпуск

Перечисления

перечисление FileCreationState [SWS_PER_00435] Upstream: RS_PER_00004, RS_AP_00122, RS_AP_00125, RS_AP_00143

enum class FileCreationState :                std::uint32_t {...};

This enumeration describes how and when a file was created.

Header-Datei	#include "ara/per/file_storage.h"
Forwarding-Header	#include "ara/per/per_fwd.h"
Scope	namespace ara::per
Symbol	FileCreationState
Basistyp	std::uint32_t

Werte

Enumerator	Beschreibung
kCreatedDuringInstallation	=1 The file was created by Persistency after installation of the Adaptive Application or after ResetPersistency.
kCreatedDuringUpdate	=2 The file was created by Persistency during an update.
kCreatedDuringReset	=3 The file was re-created due to a call to ResetFile or ResetAllFiles.
kCreatedDuringRecovery	=4 The file was re-created by Persistency after a corruption was detected.
kCreatedByApplication	=5 The file was created by the Persistency user.

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

Record: AUTOSAR/AP/record/SWS_PER_00435
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00435@rel:R25-11#1be0583f
Content hash: 1be0583f
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00435

Status: valid/unmigrated Version: rel:R25-11#5c76ed9c 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_00435@rel:R25-11#5c76ed9c

Recorded Revisions (7):

R25-11rel:R25-11#91c90ae12026-09-30
R20-11rel:R20-11#fc72e8cf2026-10-14
R21-11rel:R21-11#fade16892026-10-14
R22-11rel:R22-11#76ad97da2026-10-14
R23-11rel:R23-11#096eb2152026-10-14
R24-11rel:R24-11#67a514e92026-10-14
R25-11rel:R25-11#5c76ed9c2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

перечисление FileModificationState [SWS_PER_00436] Upstream: RS_PER_00004, RS_AP_00122, RS_AP_00125, RS_AP_00143

enum class FileModificationState :                 std::uint32_t {...};

This enumeration describes how and when a file was last modified.

Header-Datei	#include "ara/per/file_storage.h"
Forwarding-Header	#include "ara/per/per_fwd.h"
Scope	namespace ara::per
Symbol	FileModificationState
Basistyp	std::uint32_t

Werte

Enumerator	Beschreibung
kModifiedDuringUpdate	=2 The file was last modified by Persistency during an update.
kModifiedDuringReset	=3 The file was last modified by Persistency due to a call to ResetFile or ResetAllFiles.
kModifiedDuringRecovery	=4 The file was last modified by Persistency after a corruption was detected.
kModifiedByApplication	=5 The file was last modified by the Persistency user.

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

Record: AUTOSAR/AP/record/SWS_PER_00436
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00436@rel:R25-11#7b6c5b3f
Content hash: 7b6c5b3f
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00436

Status: valid/unmigrated Version: rel:R25-11#13cb5d42 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_00436@rel:R25-11#13cb5d42

Recorded Revisions (7):

R25-11rel:R25-11#399a20322026-09-30
R20-11rel:R20-11#83ce45b72026-10-14
R21-11rel:R21-11#98b8ab052026-10-14
R22-11rel:R22-11#2ce2c3962026-10-14
R23-11rel:R23-11#d9854b632026-10-14
R24-11rel:R24-11#93230b352026-10-14
R25-11rel:R25-11#13cb5d422026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

перечисление OpenMode [SWS_PER_00147] Upstream: RS_PER_00003, RS_AP_00122, RS_AP_00125, RS_AP_00143

enum class OpenMode :            std::uint32_t {...};

This enumeration defines how a file shall be opened. The values can be combined (using | and |=) as long as they do not contradict each other.

Header-Datei	#include "ara/per/file_storage.h"
Forwarding-Header	#include "ara/per/per_fwd.h"
Scope	namespace ara::per
Symbol	OpenMode
Basistyp	std::uint32_t

Werte

Enumerator	Beschreibung
kAtTheBeginning	= 1 << 0 Sets the seek position to the beginning of the file when the file is opened. This mode cannot be combined with kAtTheEnd.
kAtTheEnd	= 1 << 1 Sets the seek position to the end of the file when the file is opened. This mode cannot be combined with kAtTheBeginning or kTruncate.
kTruncate	= 1 << 2 Removes existing content when the file is opened. This mode cannot be combined with kAtTheEnd.
kAppend	= 1 << 3 Append to the end. Always seeks to the end of the file before writing.

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

Record: AUTOSAR/AP/record/SWS_PER_00147
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00147@rel:R25-11#f8aedc3e
Content hash: f8aedc3e
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00147

Status: valid/unmigrated Version: rel:R25-11#76cbd793 Versionshistorie & Revisions (1 transition, 8 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_00147@rel:R25-11#76cbd793

Recorded Revisions (8):

R25-11rel:R25-11#1232fbf52026-09-30
R19-11rel:R19-11#850afae02026-10-14
R20-11rel:R20-11#1262e3062026-10-14
R21-11rel:R21-11#6e04c4702026-10-14
R22-11rel:R22-11#53c040ad2026-10-14
R23-11rel:R23-11#48e6b88e2026-10-14
R24-11rel:R24-11#678f13022026-10-14
R25-11rel:R25-11#76cbd7932026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

перечисление Origin [SWS_PER_00146] Upstream: RS_PER_00003, RS_AP_00122, RS_AP_00125, RS_AP_00143

enum class Origin :            std::uint32_t {...};

Specification of origin used in MovePosition.

Header-Datei	#include "ara/per/file_accessor.h"
Forwarding-Header	#include "ara/per/per_fwd.h"
Scope	namespace ara::per
Symbol	Origin
Basistyp	std::uint32_t

Werte

Enumerator	Beschreibung
kBeginning	=0 Seek from the beginning of the file.
kCurrent	=1 Seek from the current position.
kEnd	=2 Seek from the end of the file.

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

Record: AUTOSAR/AP/record/SWS_PER_00146
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00146@rel:R25-11#472e8696
Content hash: 472e8696
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00146

Status: valid/unmigrated Version: rel:R25-11#d2fd11c4 Versionshistorie & Revisions (1 transition, 8 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_00146@rel:R25-11#d2fd11c4

Recorded Revisions (8):

R25-11rel:R25-11#3a8c900d2026-09-30
R19-11rel:R19-11#852935312026-10-14
R20-11rel:R20-11#25a49a522026-10-14
R21-11rel:R21-11#118ba30a2026-10-14
R22-11rel:R22-11#118ba30a2026-10-14
R23-11rel:R23-11#f995dce12026-10-14
R24-11rel:R24-11#f995dce12026-10-14
R25-11rel:R25-11#d2fd11c42026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

перечисление PerErrc [SWS_PER_00311] Upstream: RS_AP_00122, RS_AP_00125, RS_AP_00127, RS_AP_00149

enum class PerErrc :            ara::core::ErrorDomain::CodeType {...};

Defines the errors for Persistency. The enumeration values 0 - 255 are reserved for AUTOSAR assigned errors, the stack provider is free to define additional errors starting from 256.

Header-Datei	#include "ara/per/per_error_domain.h"
Forwarding-Header	#include "ara/per/per_fwd.h"
Scope	namespace ara::per
Symbol	PerErrc
Basistyp	ara::core::ErrorDomain::CodeType

Werte

Enumerator	Beschreibung
kStorageNotFound	=1 The requested Key-Value Storage or File Storage is not configured in the AUTOSAR model.
kKeyNotFound	=2 The provided key cannot be not found in the Key-Value Storage.
kIllegalWriteAccess	=3 The operation could not be performed because the accessed Key-Value Storage or File Storage is configured as read-only or write-only-once.
kPhysicalStorageFailure	=4 An error occurred when accessing the physical storage, e.g. because of a corrupted file system or corrupted hardware, or because of insufficient access rights.
kIntegrityCorrupted	=5 The structural integrity of the Key-Value Storage or File Storage could not be established. This can happen when the internal structure of a Key-Value Storage or the metadata of a File Storage is corrupted.
kValidationFailed	=6 The validation of redundancy measures failed for a single key-value pair, for the whole Key-Value Storage, for a single file, or for the whole File Storage.
kEncryptionFailed	=7 The encryption or decryption failed for a single key-value pair, for the whole Key-Value Storage, for a single file, or for the whole File Storage.
kDataTypeMismatch	=8 The provided data type does not match the stored data type.
kInitValueNotAvailable	=9 The operation could not be performed because no initial value is available.
kResourceBusy	= 10 The operation could not be performed because the resource is currently busy.
kOutOfStorageSpace	= 12 The physical storage space was exceeded.
kFileNotFound	= 13 The requested file name cannot be not found in the File Storage.
kInvalidPosition	= 15 SetPosition tried to move to a position that is not reachable (i.e. which is smaller than zero or greater than the current size of the file).
kEof	= 16 The Persistency user tried to read from the end of the file or from an empty file.
kInvalidOpenMode	= 17 Opening a file failed because the requested combination of Open Modes is invalid.
kInvalidSize	= 18 SetFileSize tried to set a new size that is bigger than the current file size.
kTooManyFiles	= 19 The maximum number of files was exceeded.
kQuotaExceeded	= 20 The allocated storage quota was exceeded.
kAuthenticationFailed	= 21 Calculating or checking of the MAC failed for a single key-value pair, for the whole Key-Value Storage, for a single file, or for the whole File Storage.

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

Record: AUTOSAR/AP/record/SWS_PER_00311
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00311@rel:R25-11#8e4ef3b6
Content hash: 8e4ef3b6
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00311

Status: valid/unmigrated Version: rel:R25-11#bb710d42 Versionshistorie & Revisions (1 transition, 8 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_00311@rel:R25-11#bb710d42

Recorded Revisions (8):

R25-11rel:R25-11#74bafb1d2026-09-30
R19-11rel:R19-11#52a505112026-10-14
R20-11rel:R20-11#31f87d482026-10-14
R21-11rel:R21-11#9bbbacde2026-10-14
R22-11rel:R22-11#4c6de6f22026-10-14
R23-11rel:R23-11#3774a98c2026-10-14
R24-11rel:R24-11#7af9c3ee2026-10-14
R25-11rel:R25-11#bb710d422026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

перечисление RecoveryReportKind [SWS_PER_00432] Upstream: RS_PER_00008, RS_AP_00122, RS_AP_00125, RS_AP_00143

enum class RecoveryReportKind :            std::uint32_t {...};

Defines the reported recovery actions.

Header-Datei	#include "ara/per/recovery.h"
Forwarding-Header	#include "ara/per/per_fwd.h"
Scope	namespace ara::per
Symbol	RecoveryReportKind
Basistyp	std::uint32_t

Werte

Enumerator	Beschreibung
kKeyValueStorageRecoveryFailed	=1 A Key-Value Storage was corrupted, an insufficient number of valid copies existed. storage contains the short-name path of the Key-Value Storage, reportedElements is empty, reportedInstances contains the indices of the affected Key-Value Storage copies.
kKeyValueStorageRecovered	=2 A Key-Value Storage was corrupted, but a sufficient number of valid copies existed. storage contains the short-name path of the Key-Value Storage, reportedElements is empty, reportedInstances contains the indices of the affected Key-Value Storage copies.
kKeyRecoveryFailed	=3 A set of key-value pairs was corrupted, an insufficient number of valid copies existed. storage contains the short-name path of the Key-Value Storage, reportedElements contains the list of affected keys, reportedInstances contains the indices of the affected Key-Value Storage or key-value pair copies. In general, the nth key in reportedElements corresponds to the nth index in reported Instances, i.e. a key may be reported several times if several copies are broken. In case only one key-value pair is affected, reported Elements may be provided containing just this key.
kKeyRecovered	=4 A set of key-value pairs was corrupted, but a sufficient number of valid copies existed. storage contains the short-name path of the Key-Value Storage, reportedElements contains the list of affected keys, reportedInstances contains the indices of the affected Key-Value Storage or key-value pair copies. In general, the nth key in reportedElements corresponds to the nth index in reported Instances, i.e. a key may be reported several times if several copies are broken. In case only one key-value pair is affected, reported Elements may be provided containing just this key.
kFileStorageRecoveryFailed	=5 A File Storage was corrupted, an insufficient number of valid copies existed. storage contains the short-name path of the File Storage, reportedElements is empty, reportedInstances contains the indices of the affected File Storage copies.
kFileStorageRecovered	=6 A File Storage was corrupted, but a sufficient number of valid copies existed. storage contains the short-name path of the File Storage, reportedElements is empty, reportedInstances contains the indices of the affected File Storage copies.
kFileRecoveryFailed	=7 A set of files was corrupted, an insufficient number of valid copies existed. storage contains the short-name path of the File Storage, reportedElements contains the list of affected file names, reported Instances contains the indices of the affected File Storage or file copies. In general, the nth file name in reportedElements corresponds to the nth index in reportedInstances, i.e. a file name may be reported several times if several copies are broken. In case only one file is affected, reportedElements may be provided containing just this file name.
kFileRecovered	=8 A set of files was corrupted, but a sufficient number of valid copies existed. storage contains the short-name path of the File Storage, reportedElements contains the list of affected file names, reported Instances contains the indices of the affected File Storage or file copies. In general, the nth file name in reportedElements corresponds to the nth index in reportedInstances, i.e. a file name may be reported several times if several copies are broken. In case only one file is affected, reportedElements may be provided containing just this file name.

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

Record: AUTOSAR/AP/record/SWS_PER_00432
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00432@rel:R25-11#6d21e58f
Content hash: 6d21e58f
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00432

Status: valid/unmigrated Version: rel:R25-11#dd38feda 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_00432@rel:R25-11#dd38feda

Recorded Revisions (7):

R25-11rel:R25-11#3adbe73c2026-09-30
R20-11rel:R20-11#6815294e2026-10-14
R21-11rel:R21-11#8fb22ccf2026-10-14
R22-11rel:R22-11#92f94a6b2026-10-14
R23-11rel:R23-11#4cff42322026-10-14
R24-11rel:R24-11#2ec0a9942026-10-14
R25-11rel:R25-11#dd38feda2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

Документация свободных функций

функция CheckForManifestUpdate [SWS_PER_00576] Upstream: RS_PER_00013, RS_AP_00119, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< bool > CheckForManifestUpdate () noexcept;

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: b1f49db8b33d Происхождение

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Использование

Синхронная функция CheckForManifestUpdate из заголовочного файла ara/per/update.h проверяет в пространстве имен ara::per наличие обновлений Persistency Target Configuration [SWS_PER_00576]. Она служит для обнаружения изменений конфигурации, примененных Update and Configuration Management (UCM) во время работы адаптивного приложения, использующего Persistency [SWS_PER_00576]. Функция не принимает параметров и возвращает ara::core::Result<bool>: true, если конфигурация была обновлена с момента последнего считывания, или false, если она осталась без изменений [SWS_PER_00576].

Обработка ошибок и параллелизм

Функция объявлена как noexcept и является безопасной по отношению к исключениям (exception safe), но не является потокобезопасной (not thread-safe) [SWS_PER_00576]. В случае ошибки результат содержит либо ошибки поставщика, либо один из следующих кодов ошибок [SWS_PER_00576]:

kPhysicalStorageFailure: возникает, если во время проверки происходит сбой доступа к физической памяти [SWS_PER_00576].
kIntegrityCorrupted: возникает, если сохраненные данные не могут быть прочитаны из-за нарушения структурной целостности [SWS_PER_00576].

Взаимодействие

Если обнаружено обновление (возвращаемое значение true), приложение должно затем вызвать ara::per::ReloadPersistencyManifest, чтобы фактически заново считать измененную Target Configuration [SWS_PER_00576].

Этот текст сгенерирован ИИ и служит ориентиром на основе спецификации.

Header-Datei	#include "ara/per/update.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Result< bool >	A Result containing true if the Target Configuration was updated or false if it is unchanged since the last time the Target Configuration was read. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
kPhysicalStorage-Failure	rollback_semantics Returned if access to the physical storage fails during the checking operation.
kIntegrityCor-rupted	rollback_semantics Returned if stored data cannot be read because the structural integrity is corrupted.

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

Record: AUTOSAR/AP/record/SWS_PER_00576
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00576@rel:R25-11#7d9f5131
Content hash: 7d9f5131
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00576

Status: valid/unmigrated Version: rel:R25-11#f5cc3f5c Versionshistorie & Revisions (1 transition, 3 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_00576@rel:R25-11#f5cc3f5c

Recorded Revisions (3):

R25-11rel:R25-11#b26d10d92026-09-30
R24-11rel:R24-11#478f6c8c2026-10-14
R25-11rel:R25-11#f5cc3f5c2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция CleanUpPersistency [SWS_PER_00567] Upstream: RS_PER_00016, RS_AP_00119, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< void > CleanUpPersistency () noexcept;

Removes backup data and other unused data of all Persistency Key-Value Storages and File Storages.

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: ce1bea3039de Происхождение

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Использование

Синхронная функция CleanUpPersistency из ara/per/update.h служит для удаления резервных данных (Backup Data) и других неиспользуемых данных во всех Key-Value- и File-Storage экземпляра [SWS_PER_00567]. Она не принимает параметров и возвращает результат через тип возвращаемого значения ara::core::Result<void> [SWS_PER_00567].

Параллелизм и ограничения

Функция не является потокобезопасной (not thread-safe) и требует монопольного доступа ко всем ресурсам хранилища [SWS_PER_00567]. Если ещё открыт ara::per::SharedHandle какого-либо Key-Value- или File-Storage, вызов завершается ошибкой с kResourceBusy [SWS_PER_00567]. Аналогично, параллельно выполняемые операции, такие как UpdatePersistency, ResetPersistency, RecoverKeyValueStorage, ResetKeyValueStorage, RecoverAllFiles или ResetAllFiles, приводят к коду ошибки kResourceBusy [SWS_PER_00567].

Пока выполняется CleanUpPersistency, конкурирующие вызовы для открытия хранилищ через OpenKeyValueStorage [SWS_PER_00052] или OpenFileStorage [SWS_PER_00116], а также функции восстановления и сброса [SWS_PER_00333], [SWS_PER_00334], [SWS_PER_00335], [SWS_PER_00336] также завершаются ошибкой с kResourceBusy.

Обработка ошибок

Для возникших ошибок действует семантика отката на уровне хранилища [SWS_PER_00567]. К возможным ошибкам, помимо kResourceBusy, относятся:

kPhysicalStorageFailure при ошибках доступа к физическому носителю данных [SWS_PER_00567],
kIntegrityCorrupted при структурном повреждении сохранённых данных [SWS_PER_00567],
kValidationFailed при неудачной проверке валидности данных [SWS_PER_00567],
kEncryptionFailed при ошибках во время шифрования или расшифрования [SWS_PER_00567],
kAuthenticationFailed при неудачном вычислении или проверке MAC [SWS_PER_00567],
а также специфические для производителя коды ошибок [SWS_PER_00567].

Этот текст сгенерирован ИИ на основе спецификации.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei	#include "ara/per/update.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe kPhysicalStorage- rollback_semantics

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
Failure	Returned if access to the physical storage fails during the update operation.
kIntegrityCor-rupted	rollback_semantics Returned if stored data cannot be read because the structural integrity is corrupted.
kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
kEncryptionFailed	rollback_semantics Returned if the encryption or decryption of stored data fails during the update operation.
kResourceBusy	rollback_semantics Returned if ara::per::UpdatePersistency or ara::per:: ResetPersistency is currently being executed, or if ara:: per::RecoverKeyValueStorage or ara::per:: ResetKeyValueStorage is currently being executed for any Key-Value Storage, or if ara::per::RecoverAllFiles or ara::per::ResetAllFiles is currently being executed for any File Storage, or a ara::per::SharedHandle of a Key- Value Storage or a File Storage is currently in use.
kAuthentication-Failed	rollback_semantics Returned if calculating or checking the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00567
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00567@rel:R25-11#ba9549f6
Content hash: ba9549f6
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00567

Status: valid/unmigrated Version: rel:R25-11#f9cdaf08 Versionshistorie & Revisions (1 transition, 4 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_00567@rel:R25-11#f9cdaf08

Recorded Revisions (4):

R25-11rel:R25-11#7398665b2026-09-30
R23-11rel:R23-11#e1f7fda32026-10-14
R24-11rel:R24-11#0bfb7d2d2026-10-14
R25-11rel:R25-11#f9cdaf082026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция GetCurrentFileStorageSize [SWS_PER_00406] Upstream: RS_PER_00017, RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00137, RS_AP_00139, RS_AP_00159

ara::core::Result< std::uint64_t > GetCurrentFileStorageSize (const ara::core::InstanceSpecifier &fs) noexcept;

Header-Datei	#include "ara/per/file_storage.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
fs	The shortName path of a PortPrototype typed by a PersistencyFile StorageInterface.

Rückgabewert

Typ	Beschreibung
ara::core::Result<std::uint64_t >	A Result containing the occupied space in bytes. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
PerErrc::kStorageNotFound	rollback_semantics Returned if the passed InstanceSpecifier does not match any PersistencyFileStorageInterface configured for this Executable.
PerErrc::kPhysicalStorageFailure	rollback_semantics Returned if access to the physical storage fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00406
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00406@rel:R25-11#35df1316
Content hash: 35df1316
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00406

Status: valid/unmigrated Version: rel:R25-11#05c094c0 Versionshistorie & Revisions (1 transition, 8 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_00406@rel:R25-11#05c094c0

Recorded Revisions (8):

R25-11rel:R25-11#602f8c772026-09-30
R19-11rel:R19-11#67f89fa62026-10-14
R20-11rel:R20-11#87f0114c2026-10-14
R21-11rel:R21-11#ee9e70cd2026-10-14
R22-11rel:R22-11#def327602026-10-14
R23-11rel:R23-11#06e0e64e2026-10-14
R24-11rel:R24-11#78d010822026-10-14
R25-11rel:R25-11#05c094c02026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция GetCurrentKeyValueStorageSize [SWS_PER_00405] Upstream: RS_PER_00017, RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00137, RS_AP_00139, RS_AP_00159

ara::core::Result< std::uint64_t > GetCurrentKeyValueStorageSize (const ara::core::InstanceSpecifier &kvs) noexcept;

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
kvs	The shortName path of a PortPrototype typed by a PersistencyKey ValueStorageInterface.

Rückgabewert

Typ	Beschreibung
ara::core::Result<std::uint64_t >	A Result containing the occupied space in bytes. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
PerErrc::kStorageNotFound	rollback_semantics Returned if the passed InstanceSpecifier does not match any PersistencyKeyValueStorageInterface configured for this Executable.
PerErrc::kPhysicalStorageFailure	rollback_semantics Returned if access to the physical storage fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00405
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00405@rel:R25-11#7daf084c
Content hash: 7daf084c
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00405

Status: valid/unmigrated Version: rel:R25-11#542916fb Versionshistorie & Revisions (1 transition, 8 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_00405@rel:R25-11#542916fb

Recorded Revisions (8):

R25-11rel:R25-11#c4ec6e962026-09-30
R19-11rel:R19-11#3f8d2ee72026-10-14
R20-11rel:R20-11#f394ab092026-10-14
R21-11rel:R21-11#e1cb35cd2026-10-14
R22-11rel:R22-11#39a308942026-10-14
R23-11rel:R23-11#5c939f722026-10-14
R24-11rel:R24-11#542916fb2026-10-14
R25-11rel:R25-11#542916fb2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция GetPerDomain [SWS_PER_00352] Upstream: RS_AP_00119, RS_AP_00120, RS_AP_00159

constexpr const ara::core::ErrorDomain & GetPerDomain () noexcept;

Returns the global PerErrorDomain object.

Header-Datei	#include "ara/per/per_error_domain.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Rückgabewert

Typ	Beschreibung
const ara::core::ErrorDomain &	The global PerErrorDomain object.

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

Record: AUTOSAR/AP/record/SWS_PER_00352
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00352@rel:R25-11#96bbe742
Content hash: 96bbe742
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00352

Status: valid/unmigrated Version: rel:R25-11#0f9be8a3 Versionshistorie & Revisions (1 transition, 8 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_00352@rel:R25-11#0f9be8a3

Recorded Revisions (8):

R25-11rel:R25-11#404a17482026-09-30
R19-11rel:R19-11#9cb2d1f82026-10-14
R20-11rel:R20-11#ba7c6ddb2026-10-14
R21-11rel:R21-11#ba7c6ddb2026-10-14
R22-11rel:R22-11#a22a71a82026-10-14
R23-11rel:R23-11#e20d90152026-10-14
R24-11rel:R24-11#0f9be8a32026-10-14
R25-11rel:R25-11#0f9be8a32026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция MakeErrorCode [SWS_PER_00351] Upstream: RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00135, RS_AP_00159

constexpr ara::core::ErrorCode MakeErrorCode (PerErrc code, ara::core::ErrorDomain::SupportDataType data) noexcept;

Creates an error code.

Header-Datei	#include "ara/per/per_error_domain.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
code	Error code number.
data	Vendor defined data associated with the error.

Rückgabewert

Typ	Beschreibung
ara::core::ErrorCode	An ErrorCode object.

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

Record: AUTOSAR/AP/record/SWS_PER_00351
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00351@rel:R25-11#c2580c81
Content hash: c2580c81
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00351

Status: valid/unmigrated Version: rel:R25-11#6bc3a705 Versionshistorie & Revisions (1 transition, 8 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_00351@rel:R25-11#6bc3a705

Recorded Revisions (8):

R25-11rel:R25-11#d180b00f2026-09-30
R19-11rel:R19-11#4a2f0cae2026-10-14
R20-11rel:R20-11#0405c8a02026-10-14
R21-11rel:R21-11#df6b498d2026-10-14
R22-11rel:R22-11#cc3dc3172026-10-14
R23-11rel:R23-11#caf22e062026-10-14
R24-11rel:R24-11#6bc3a7052026-10-14
R25-11rel:R25-11#6bc3a7052026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция OpenFileStorage [SWS_PER_00116] Upstream: RS_PER_00001, RS_PER_00004, RS_PER_00010, RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00137, RS_AP_00139, RS_AP_00144, RS_AP_00147, RS_AP_00159

ara::core::Result< SharedHandle< FileStorage > > OpenFileStorage (const ara::core::InstanceSpecifier &fs) noexcept;

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 14078ca86bfb Происхождение

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Синхронная функция ara::per::OpenFileStorage открывает файловое хранилище для персистентных данных и предоставляет его через разделяемый дескриптор доступа [SWS_PER_00116]. В качестве параметра она ожидает ссылку на ara::core::InstanceSpecifier, указывающий путь shortName прототипа порта (PortPrototype), типизированного с помощью PersistencyFileStorageInterface. Возвращаемое значение представляет собой ara::core::Result<ara::core::SharedHandle<FileStorage>> [SWS_PER_00116].

В отношении параллелизма функция специфицирована как thread-safe и exception-safe [SWS_PER_00116]. Поскольку несколько потоков могут параллельно обращаться к одному и тому же экземпляру файлового хранилища, физическое хранилище не обязательно закрывается, когда отдельный SharedHandle выходит из области видимости. Закрытие происходит только тогда, когда все ссылающиеся дескрипторы вышли из области видимости (out-of-scope) [SWS_PER_00116].

В случае ошибки Result содержит коды ошибок перечисления PerErrc или ошибки, специфичные для производителя [SWS_PER_00116]:

PerErrc::kResourceBusy: возвращается, если одновременно выполняются такие административные операции, как CleanUpPersistency, ResetPersistency, RecoverAllFiles или ResetAllFiles. Пока активна UpdatePersistency, эта ошибка возникает, если вызов происходит вне зарегистрированного через RegisterApplicationDataUpdateCallback обратного вызова или с другим идентификатором [SWS_PER_00116], [SWS_PER_00356].
Ошибки конфигурации и доступа: kStorageNotFound при нескомплектованном (несконфигурированном) экземпляре, kPhysicalStorageFailure при ошибках физического хранилища, а также kIntegrityCorrupted, kValidationFailed, kEncryptionFailed и kAuthenticationFailed при проблемах целостности, проверки или расшифрования [SWS_PER_00116].
Ограничения ёмкости при неявных обновлениях: kOutOfStorageSpace, kTooManyFiles или kQuotaExceeded [SWS_PER_00116].

Во взаимодействии с модулем предварительный сброс с помощью ResetPersistency приводит к тому, что удалённые файловые хранилища создаются заново при следующем вызове OpenFileStorage [SWS_PER_00358]. Если во время открытия данные обновляются, обратный вызов индикации (indication callback), зарегистрированный через RegisterDataUpdateIndication, вызывается непосредственно в контексте OpenFileStorage [SWS_PER_00578].

Этот текст был сгенерирован ИИ на основе спецификации AUTOSAR Adaptive R25-11.

Руководство разработчика реализации в подготовке (сложность I1)

Header-Datei	#include "ara/per/file_storage.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
fs	The shortName path of a PortPrototype typed by a PersistencyFile StorageInterface.

Rückgabewert

Typ	Beschreibung
ara::core::Result<SharedHandle< FileStorage > >	A Result containing a SharedHandle for the File Storage. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
PerErrc::kStorageNotFound	rollback_semantics Returned if the passed InstanceSpecifier does not match any PersistencyFileStorageInterface configured for this Executable.
PerErrc::kPhysicalStorageFailure	no_rollback_semantics Returned if access to the physical storage fails.
PerErrc::kIntegrityCorrupted	rollback_semantics Returned if stored data cannot be read because the structural integrity is corrupted.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kResourceBusy	rollback_semantics Returned if CleanUpPersistency, or ResetPersistency is currently being executed, or if RecoverAllFiles or ResetAllFiles is currently being executed for the same File Storage. Also, while Update Persistency is currently being executed, this error is returned when OpenFileStorage is called outside of the callback registered via RegisterApplicationDataUpdateCallback, or if the used Instance Specifier differs from the one provided by the callback.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for the files that are added/updated during an implicit update of the File Storage.
PerErrc::kTooManyFiles	rollback_semantics Returned if the files that are added during an implicit update of the File Storage would exceed the configured maxNumberOfFiles.
PerErrc::kQuotaExceeded	rollback_semantics Returned if the files that are added/updated during an implicit update of the File Storage would exceed the configured maximum AllowedSize.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00116
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00116@rel:R25-11#62392612
Content hash: 62392612
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00116

Status: valid/unmigrated Version: rel:R25-11#045a694e Versionshistorie & Revisions (1 transition, 8 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_00116@rel:R25-11#045a694e

Recorded Revisions (8):

R25-11rel:R25-11#3d9a9e5b2026-09-30
R19-11rel:R19-11#bf01f2fc2026-10-14
R20-11rel:R20-11#f59e7f982026-10-14
R21-11rel:R21-11#8ea5df192026-10-14
R22-11rel:R22-11#4ac6fa6a2026-10-14
R23-11rel:R23-11#21db3eff2026-10-14
R24-11rel:R24-11#a4ff2c552026-10-14
R25-11rel:R25-11#045a694e2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция OpenKeyValueStorage [SWS_PER_00052] Upstream: RS_PER_00003, RS_PER_00010, RS_AP_00119, RS_AP_00120, RS_ AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00137, RS_AP_00139, RS_AP_00144, RS_AP_00147, RS_AP_00159

ara::core::Result< SharedHandle< KeyValueStorage > > OpenKeyValue Storage (const ara::core::InstanceSpecifier &kvs) noexcept;

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: d24427922381 Происхождение

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Использование и жизненный цикл

Синхронная функция OpenKeyValueStorage открывает хранилище «ключ — значение» и специфицирована как thread-safe, а также noexcept [SWS_PER_00052]. В качестве параметра kvs передаётся ara::core::InstanceSpecifier, ссылающийся на путь PortPrototype, типизированного с помощью PersistencyKeyValueStorageInterface. Возврат осуществляется в виде ara::core::Result<SharedHandle<KeyValueStorage>>. Поскольку несколько потоков могут конкурентно открывать одно и то же хранилище, Persistency закрывает физическое хранилище только тогда, когда все ссылающиеся экземпляры SharedHandle вышли из своей области видимости [SWS_PER_00052].

Обработка ошибок и параллелизм

В случае ошибки Result возвращает специфические коды ошибок домена ошибок Persistency [SWS_PER_00052]:

PerErrc::kStorageNotFound: идентификатор не соответствует ни одному сконфигурированному интерфейсу Executable.
PerErrc::kResourceBusy: возникает, если для этого хранилища конкурентно выполняются CleanUpPersistency, ResetPersistency [SWS_PER_00358], RecoverKeyValueStorage или ResetKeyValueStorage. Во время UpdatePersistency вызов допустим только внутри обратного вызова, зарегистрированного через RegisterApplicationDataUpdateCallback, с переданным там идентификатором экземпляра [SWS_PER_00356].
PerErrc::kPhysicalStorageFailure, PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed и PerErrc::kAuthenticationFailed при дефектах, ошибках валидации или криптографических ошибках.
PerErrc::kOutOfStorageSpace и PerErrc::kQuotaExceeded при недостатке места в хранилище или превышении квоты во время неявного обновления.

Взаимодействие

Если все данные ранее были удалены с помощью ResetPersistency, хранилище автоматически создаётся заново при следующем вызове OpenKeyValueStorage [SWS_PER_00358]. После открытия несохранённые модификации могут быть сброшены на состояние на момент открытия с помощью DiscardPendingChanges [SWS_PER_00365]. Кроме того, открытие может инициировать выполнение обратных вызовов, зарегистрированных через RegisterDataUpdateIndication [SWS_PER_00578].

Это указание по использованию было сгенерировано автоматически на основе требований спецификации.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe PerErrc::kStorageNot rollback_semantics

Parameter (in)

Parameter	Beschreibung
kvs	The shortName path of a PortPrototype typed by a PersistencyKey ValueStorageInterface.

Rückgabewert

Typ	Beschreibung
ara::core::Result<SharedHandle< KeyValueStorage > >	A Result containing a SharedHandle for the KeyValueStorage. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
Found	Returned if the passed InstanceSpecifier does not match any PersistencyKeyValueStorageInterface configured for this Executable.
PerErrc::kPhysicalStorageFailure	no_rollback_semantics Returned if access to the physical storage fails.
PerErrc::kIntegrityCorrupted	rollback_semantics Returned if stored data cannot be read because the structural integrity is corrupted.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kResourceBusy	rollback_semantics Returned if CleanUpPersistency, or ResetPersistency is currently being executed, or if RecoverKeyValueStorage or ResetKeyValue Storage is currently being executed for the same Key-Value Storage. Also, while UpdatePersistency is currently being executed, this error is returned when OpenKeyValueStorage is called outside of the callback registered via RegisterApplicationDataUpdate Callback, or if the used InstanceSpecifier differs from the one provided by the callback.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for the values that are added/updated during an implicit update of the Key-Value Storage.
PerErrc::kQuotaExceeded	rollback_semantics Returned if the values that are added/updated during an implicit update of the Key-Value Storage would exceed the configured maximumAllowedSize.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00052
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00052@rel:R25-11#3ed289b1
Content hash: 3ed289b1
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00052

Status: valid/unmigrated Version: rel:R25-11#d4b1e761 Versionshistorie & Revisions (1 transition, 8 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_00052@rel:R25-11#d4b1e761

Recorded Revisions (8):

R25-11rel:R25-11#caeeeace2026-09-30
R19-11rel:R19-11#34496dec2026-10-14
R20-11rel:R20-11#f68c65ef2026-10-14
R21-11rel:R21-11#b958923e2026-10-14
R22-11rel:R22-11#e940c9852026-10-14
R23-11rel:R23-11#704678462026-10-14
R24-11rel:R24-11#124418c72026-10-14
R25-11rel:R25-11#d4b1e7612026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция RecoverAllFiles [SWS_PER_00335] Upstream: RS_PER_00001, RS_PER_00004, RS_PER_00009, RS_PER_00010, RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00137, RS_AP_00139, RS_AP_00159

ara::core::Result< void > RecoverAllFiles (const ara::core::Instance Specifier &fs) noexcept;

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: ca84cc440ba3 Происхождение

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Функция RecoverAllFiles выполняет восстановление файлового хранилища (File Storage), включая все хранящиеся в нём файлы, в случае сбоя проверок избыточности [SWS_PER_00335]. Вызов происходит синхронно с указанием InstanceSpecifier для сконфигурированного прототипа порта и возвращает ara::core::Result<void> [SWS_PER_00335].

Восстановление работает по принципу наилучших усилий: после завершения файлы могут содержать устаревшее содержимое, быть сброшены в исходное состояние или полностью утеряны [SWS_PER_00335]. В случае сбоя доступа к носителю данных (PerErrc::kPhysicalStorageFailure) или нехватки дискового пространства (PerErrc::kOutOfStorageSpace) гарантия отката отсутствует [SWS_PER_00335]. При возникновении ошибки во время шифрования (PerErrc::kEncryptionFailed), проверки целостности (PerErrc::kAuthenticationFailed) или ограничения размера хранилища (PerErrc::kQuotaExceeded) применяется семантика отката [SWS_PER_00335]. Если идентификатор не соответствует ни одному сконфигурированному интерфейсу, это приводит к PerErrc::kStorageNotFound [SWS_PER_00335].

Хотя функция является потокобезопасной, выполнение завершается сбоем с PerErrc::kResourceBusy, пока хранилище открыто или существует активный разделяемый дескриптор [SWS_PER_00335], [SWS_PER_00116]. Также параллельные выполнения ResetAllFiles [SWS_PER_00336] для того же хранилища, а также глобальные операции обновления UpdatePersistency [SWS_PER_00357], ResetPersistency [SWS_PER_00358] и CleanUpPersistency [SWS_PER_00567] блокируют вызов [SWS_PER_00335].

Это указание по использованию было создано ИИ на основе спецификаций.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei	#include "ara/per/file_storage.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe PerErrc::kStorageNot rollback_semantics

Parameter (in)

Parameter	Beschreibung
fs	The shortName path of a PortPrototype typed by a PersistencyFile StorageInterface.

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
Found	Returned if the passed InstanceSpecifier does not match any PersistencyFileStorageInterface configured for this Executable.
PerErrc::kPhysicalStorageFailure	no_rollback_semantics Returned if access to the physical storage fails.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the encryption of stored data fails.
PerErrc::kResourceBusy	rollback_semantics Returned if UpdatePersistency, CleanUpPersistency, or Reset Persistency is currently being executed, or if ResetAllFiles is currently being executed for the same File Storage, or a Shared Handle of the same File Storage is currently in use.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for the recovered files.
PerErrc::kQuotaExceeded	rollback_semantics Returned if the recovered files would exceed the configured maximumAllowedSize of the File Storage.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if calculating the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00335
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00335@rel:R25-11#110bdfb5
Content hash: 110bdfb5
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00335

Status: valid/unmigrated Version: rel:R25-11#2f7dfc4c Versionshistorie & Revisions (1 transition, 8 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_00335@rel:R25-11#2f7dfc4c

Recorded Revisions (8):

R25-11rel:R25-11#73a082452026-09-30
R19-11rel:R19-11#3ad2a41d2026-10-14
R20-11rel:R20-11#313148252026-10-14
R21-11rel:R21-11#524080052026-10-14
R22-11rel:R22-11#ec0502c32026-10-14
R23-11rel:R23-11#c58779272026-10-14
R24-11rel:R24-11#bd0fcca72026-10-14
R25-11rel:R25-11#2f7dfc4c2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция RecoverKeyValueStorage [SWS_PER_00333] Upstream: RS_PER_00003, RS_PER_00009, RS_PER_00010, RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00137, RS_AP_00139, RS_AP_00159

ara::core::Result< void > RecoverKeyValueStorage (const ara::core::InstanceSpecifier &kvs) noexcept;

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: ba269bfce693 Происхождение

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Синхронная функция RecoverKeyValueStorage в пространстве имён ara::per служит для восстановления хранилища пар «ключ-значение» после сбоя проверок избыточности ([SWS_PER_00333]). В качестве параметра kvs передаётся ara::core::InstanceSpecifier, который ссылается на путь ShortName соответствующего PortPrototype ([SWS_PER_00333]). Восстановление выполняется по принципу «best effort» (максимальных усилий); после завершения процесса ключи могут содержать устаревшие или начальные значения либо быть полностью утрачены ([SWS_PER_00333]).

Хотя функция специфицирована как потокобезопасная, выполнение завершается сбоем с кодом ошибки PerErrc::kResourceBusy, если соответствующее хранилище «ключ — значение» открыто — то есть существует как минимум один активный SharedHandle ([SWS_PER_00052], [SWS_PER_00333]). Та же ошибка возникает, если другие потоки одновременно вызывают модифицирующие функции: UpdatePersistency ([SWS_PER_00357]), CleanUpPersistency ([SWS_PER_00567]), ResetPersistency ([SWS_PER_00358]) или ResetKeyValueStorage ([SWS_PER_00334]). Во время восстановления вызов OpenKeyValueStorage также завершается сбоем с kResourceBusy ([SWS_PER_00052]).

Результат возвращается синхронно как ara::core::Result<void>. Помимо PerErrc::kResourceBusy определены следующие специфические ошибки ([SWS_PER_00333]):

PerErrc::kStorageNotFound: переданный идентификатор не соответствует ни одному сконфигурированному интерфейсу.
PerErrc::kPhysicalStorageFailure: сбой доступа к физической памяти (без семантики отката).
PerErrc::kOutOfStorageSpace: недостаточно физического пространства в памяти для восстановленных данных (без семантики отката).
PerErrc::kQuotaExceeded: превышение сконфигурированной максимальной длины (maximumAllowedSize).
PerErrc::kEncryptionFailed и PerErrc::kAuthenticationFailed: ошибка шифрования или вычисления MAC.

Этот текст был создан ИИ на основе спецификации AUTOSAR.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
kvs	The shortName path of a PortPrototype typed by a PersistencyKey ValueStorageInterface.

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
PerErrc::kStorageNotFound	rollback_semantics Returned if the passed InstanceSpecifier does not match any PersistencyKeyValueStorageInterface configured for this Executable.
PerErrc::kPhysicalStorageFailure	no_rollback_semantics Returned if access to the physical storage fails.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the encryption of stored data fails.
PerErrc::kResourceBusy	rollback_semantics Returned if UpdatePersistency, CleanUpPersistency, or Reset Persistency is currently being executed, or if ResetKeyValue Storage is currently being executed for the same Key-Value Storage, or a SharedHandle of the same Key-Value Storage is currently in use.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for the recovered values.
PerErrc::kQuotaExceeded	rollback_semantics Returned if the recovered values would exceed the configured maximumAllowedSize of the Key-Value Storage.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if calculating the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00333
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00333@rel:R25-11#4fd7b5db
Content hash: 4fd7b5db
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00333

Status: valid/unmigrated Version: rel:R25-11#6863ad8c Versionshistorie & Revisions (1 transition, 8 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_00333@rel:R25-11#6863ad8c

Recorded Revisions (8):

R25-11rel:R25-11#ea3338422026-09-30
R19-11rel:R19-11#3c9d0f722026-10-14
R20-11rel:R20-11#8230292c2026-10-14
R21-11rel:R21-11#dff1a22a2026-10-14
R22-11rel:R22-11#e3e6a2c42026-10-14
R23-11rel:R23-11#d7c298b92026-10-14
R24-11rel:R24-11#093db65f2026-10-14
R25-11rel:R25-11#6863ad8c2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция RegisterApplicationDataUpdateCallback [SWS_PER_00356] Upstream: RS_PER_00013, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00135, RS_AP_00137, RS_AP_00159

void RegisterApplicationDataUpdateCallback (std::function< void(const ara::core::InstanceSpecifier &storage, ara::core::String contract Version)> appDataUpdateCallback) noexcept;

Header-Datei	#include "ara/per/update.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Parameter (in)

Parameter	Beschreibung
appDataUpdateCallback	The callback function to be called by Persistency after an update of persistent data took place. The function will be called with the shortName path of an updated Key-Value Storage or File Storage, and with the contract version with which the Persistency was last accessed.

Rückgabewert

Typ	Beschreibung
None

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

Record: AUTOSAR/AP/record/SWS_PER_00356
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00356@rel:R25-11#fc47c152
Content hash: fc47c152
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00356

Status: valid/unmigrated Version: rel:R25-11#b578b750 Versionshistorie & Revisions (1 transition, 8 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_00356@rel:R25-11#b578b750

Recorded Revisions (8):

R25-11rel:R25-11#ddfa8c352026-09-30
R19-11rel:R19-11#34e96d122026-10-14
R20-11rel:R20-11#86e5368a2026-10-14
R21-11rel:R21-11#86e5368a2026-10-14
R22-11rel:R22-11#abcf8b8d2026-10-14
R23-11rel:R23-11#691305fc2026-10-14
R24-11rel:R24-11#60beb5142026-10-14
R25-11rel:R25-11#b578b7502026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция RegisterDataUpdateIndication [SWS_PER_00578] Upstream: RS_PER_00013, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00135, RS_AP_00137, RS_AP_00159

void RegisterDataUpdateIndication (std::function< void(const ara::core::InstanceSpecifier &updatedStorage, ara::core::StringView updatedElement)> dataUpdateIndication, ara::core::InstanceSpecifier monitoredStorage, ara::core::Vector< ara::core::String > monitored Elements) noexcept;

Header-Datei	#include "ara/per/update.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Parameter (in)

Parameter	Beschreibung
dataUpdateIndication	The callback function to be called by Persistency after an update of persistent data took place. The function will be called with the shortName path of an updated Key-Value Storage or File Storage, and with the the updated elements of the storage.
monitoredStorage	A Key-Value Storage or File Storage for which updates shall be reported.
monitoredElements	A set of elements for which updates shall be reported.

Rückgabewert

Typ	Beschreibung
None

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

Record: AUTOSAR/AP/record/SWS_PER_00578
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00578@rel:R25-11#eee5b07f
Content hash: eee5b07f
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00578

Status: valid/unmigrated Version: rel:R25-11#59c9fead Versionshistorie & Revisions (1 transition, 3 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_00578@rel:R25-11#59c9fead

Recorded Revisions (3):

R25-11rel:R25-11#685948a72026-09-30
R24-11rel:R24-11#9946b5902026-10-14
R25-11rel:R25-11#59c9fead2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция RegisterRecoveryReportCallback [SWS_PER_00433] Upstream: RS_PER_00008, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00135, RS_AP_00137, RS_AP_00159

void RegisterRecoveryReportCallback (std::function< void(const ara::core::InstanceSpecifier &storage, ara::per::RecoveryReportKind recoveryReportKind, ara::core::Vector< ara::core::String > reported Elements, ara::core::Vector< std::uint8_t > reportedInstances)> recoveryReportCallback) noexcept;

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 5828fc3d3f00 Происхождение Открытые вопросы (1)

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Функция RegisterRecoveryReportCallback в пространстве имен ara::per ([SWS_PER_00433]) служит для регистрации процедуры обратного вызова в компоненте Persistency. Она используется в ориентированных на безопасность Adaptive Applications для обнаружения корректирующих мер Persistency относительно корректности сохраненных данных и надежности памяти [SWS_PER_00433].

Параметры и семантика вызова

В качестве параметра передается recoveryReportCallback, std::function, вызываемый Persistency при успешном исправлении ошибок в сохраненных данных с использованием доступной избыточности [SWS_PER_00433]. При этом обратному вызову передается следующая контекстная информация [SWS_PER_00433]:

storage: путь (shortName) затронутого Key-Value Storage или File Storage в виде ara::core::InstanceSpecifier.
recoveryReportKind: тип отчета о восстановлении (ara::per::RecoveryReportKind).
reportedElements: вектор идентификаторов затронутых элементов (ara::core::Vector<ara::core::String>).
reportedInstances: вектор затронутых экземпляров (ara::core::Vector<std::uint8_t>).

Обработка ошибок и параллелизм

Функция не возвращает значения и объявлена как noexcept; она считается безопасной относительно исключений (exception safe) [SWS_PER_00433]. Собственные коды ошибок отсутствуют [SWS_PER_00433]. Что касается потокобезопасности, интерфейс классифицирован как not thread-safe [SWS_PER_00433]. Поэтому вызов, как правило, должен выполняться на этапе инициализации приложения до запуска параллельных обращений к памяти. Вопрос Q-e5b93ea58fb56a1c (открытый)

Данное указание по использованию создано ИИ и основано на спецификациях платформы AUTOSAR.

Header-Datei	#include "ara/per/recovery.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Parameter (in)

Parameter	Beschreibung
recoveryReportCallback	The callback function to be called by Persistency to report errors in the stored data that were corrected using the available redundancy. The function will be called with the shortName path of the affected Key-Value Storage or File Storage in storage and information on what has been corrected, placed in the parameters recoveryReport Kind, reportedElements, and reportedInstances.

Rückgabewert

Typ	Beschreibung
None

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

Record: AUTOSAR/AP/record/SWS_PER_00433
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00433@rel:R25-11#06cacd16
Content hash: 06cacd16
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00433

Status: valid/unmigrated Version: rel:R25-11#69cc138a 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_00433@rel:R25-11#69cc138a

Recorded Revisions (7):

R25-11rel:R25-11#627aa0e12026-09-30
R20-11rel:R20-11#3a84481e2026-10-14
R21-11rel:R21-11#a74b248f2026-10-14
R22-11rel:R22-11#cb37dbf52026-10-14
R23-11rel:R23-11#6ca484be2026-10-14
R24-11rel:R24-11#71de55b32026-10-14
R25-11rel:R25-11#69cc138a2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция ReloadPersistencyManifest [SWS_PER_00577] Upstream: RS_PER_00013, RS_AP_00119, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< void > ReloadPersistencyManifest () noexcept;

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 19920ccb9cf9 Происхождение Открытые вопросы (1)

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Синхронная функция ReloadPersistencyManifest из пространства имен ara::per (объявленная в #include "ara/per/update.h") повторно считывает целевую конфигурацию (Target Configuration) Persistency [SWS_PER_00577]. Она служит для подготовки обновлений хранилищ ключ-значение (Key-Value Storages) и файловых хранилищ (File Storages) после того, как Update and Config Management (UCM) установил новую целевую конфигурацию во время выполнения Adaptive Application [SWS_PER_00577].

Как правило, приложение предварительно проверяет с помощью CheckForManifestUpdate [SWS_PER_00576] наличие обновления конфигурации и затем вызывает ReloadPersistencyManifest [SWS_PER_00576]. Однако повторное считывание пока не обновляет персистентные хранилища немедленно: хранилища обновляются только после их закрытия — либо при повторном открытии, либо через явный вызов ara::per::UpdatePersistency [SWS_PER_00577]. Интерпретация: уже открытые области хранения, вероятно, не закрываются автоматически при данном вызове, поэтому приложению необходимо закрыть их самостоятельно или обновить явно. Вопрос Q-16f9dae418feb3fa (открытый)

Функция не принимает параметров и возвращает ara::core::Result<void> [SWS_PER_00577]. В случае ошибки результат содержит ошибки поставщика или один из следующих кодов ошибок с семантикой отката [SWS_PER_00577]:

kPhysicalStorageFailure: возникает, если во время операции чтения происходит сбой доступа к физической памяти [SWS_PER_00577].
kIntegrityCorrupted: возникает, если сохраненные данные не могут быть прочитаны из-за нарушения структурной целостности [SWS_PER_00577].

С точки зрения параллелизма функция специфицирована как непотокобезопасная (not thread-safe), однако объявлена как безопасная по отношению к исключениям (exception safe) и noexcept [SWS_PER_00577]. Поэтому параллельные вызовы должны синхронизироваться на стороне приложения.

Данное указание по использованию было создано ИИ на основе спецификации.

Руководство разработчика реализации в подготовке (сложность I1)

Header-Datei	#include "ara/per/update.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
kPhysicalStorage-Failure	rollback_semantics Returned if access to the physical storage fails during the read operation.
kIntegrityCor-rupted	rollback_semantics Returned if stored data cannot be read because the structural integrity is corrupted.

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

Record: AUTOSAR/AP/record/SWS_PER_00577
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00577@rel:R25-11#487caa69
Content hash: 487caa69
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00577

Status: valid/unmigrated Version: rel:R25-11#7f7b5c0c Versionshistorie & Revisions (1 transition, 3 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_00577@rel:R25-11#7f7b5c0c

Recorded Revisions (3):

R25-11rel:R25-11#68a8e5e42026-09-30
R24-11rel:R24-11#685afcab2026-10-14
R25-11rel:R25-11#7f7b5c0c2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция ResetAllFiles [SWS_PER_00336] Upstream: RS_PER_00001, RS_PER_00004, RS_PER_00009, RS_PER_00010, RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00137, RS_AP_00139, RS_AP_00159

ara::core::Result< void > ResetAllFiles (const ara::core::Instance Specifier &fs) noexcept;

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: f645139d391c Происхождение

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Функция ResetAllFiles синхронно возвращает File Storage к его исходному состоянию поставки в соответствии с текущей Target Configuration [SWS_PER_00336]. После успешного выполнения хранилище содержит исключительно определённые там файлы с их первоначальным содержимым, как если бы оно было установлено заново [SWS_PER_00336].

Использование и параллелизм: Через параметр fs передаётся идентификатор экземпляра PortPrototype, типизированного через PersistencyFileStorageInterface [SWS_PER_00336]. Хотя функция специфицирована как thread-safe и exception safe, она требует эксклюзивного доступа к хранилищу: если хранилище в данный момент открыто (например, через активный SharedHandle из OpenFileStorage [SWS_PER_00116]) или параллельно модифицируется посредством UpdatePersistency [SWS_PER_00357], CleanUpPersistency [SWS_PER_00567], ResetPersistency [SWS_PER_00358], RecoverAllFiles [SWS_PER_00335] либо другого вызова ResetAllFiles, выполнение завершается ошибкой [SWS_PER_00336].

Обработка ошибок: Функция возвращает ara::core::Result<void> [SWS_PER_00336]. Возможные коды ошибок из PerErrc:

kResourceBusy: файловое хранилище открыто или модифицируется параллельно (семантика отката) [SWS_PER_00336].
kStorageNotFound: идентификатор не соответствует ни одному интерфейсу, сконфигурированному для Executable [SWS_PER_00336].
kPhysicalStorageFailure или kOutOfStorageSpace: физическая ошибка хранилища или недостаточно места в хранилище (без семантики отката) [SWS_PER_00336].
kEncryptionFailed или kAuthenticationFailed: ошибка при шифровании или вычислении MAC (семантика отката) [SWS_PER_00336].

Взаимодействие: После сброса восстановленные файлы при запросах состояния имеют статус FileCreationState::kCreatedDuringReset [SWS_PER_00435], а также FileModificationState::kModifiedDuringReset [SWS_PER_00436].

Данное указание по использованию было сгенерировано ИИ на основе спецификации AUTOSAR R25-11.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei	#include "ara/per/file_storage.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe PerErrc::kStorageNot rollback_semantics

Parameter (in)

Parameter	Beschreibung
fs	The shortName path of a PortPrototype typed by a PersistencyFile StorageInterface.

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
Found	Returned if the passed InstanceSpecifier does not match any PersistencyFileStorageInterface configured for this Executable.
PerErrc::kPhysicalStorageFailure	no_rollback_semantics Returned if access to the physical storage fails.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the encryption of stored data fails.
PerErrc::kResourceBusy	rollback_semantics Returned if UpdatePersistency, CleanUpPersistency, or Reset Persistency is currently being executed, or if RecoverAllFiles is currently being executed for the same File Storage, or a Shared Handle of the same File Storage is currently in use.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for the initial files.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if calculating the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00336
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00336@rel:R25-11#5757d8ca
Content hash: 5757d8ca
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00336

Status: valid/unmigrated Version: rel:R25-11#e599a530 Versionshistorie & Revisions (1 transition, 8 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_00336@rel:R25-11#e599a530

Recorded Revisions (8):

R25-11rel:R25-11#58b5b3b72026-09-30
R19-11rel:R19-11#6f3f0cf62026-10-14
R20-11rel:R20-11#a8b98a422026-10-14
R21-11rel:R21-11#886423992026-10-14
R22-11rel:R22-11#3a2ec7602026-10-14
R23-11rel:R23-11#6a7428df2026-10-14
R24-11rel:R24-11#b2af05972026-10-14
R25-11rel:R25-11#e599a5302026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция ResetKeyValueStorage [SWS_PER_00334] Upstream: RS_PER_00003, RS_PER_00009, RS_PER_00010, RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00137, RS_AP_00139, RS_AP_00159

ara::core::Result< void > ResetKeyValueStorage (const ara::core::InstanceSpecifier &kvs) noexcept;

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 48697319880f Происхождение

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Синхронная функция ResetKeyValueStorage сбрасывает конкретное хранилище «ключ — значение» в его начальное состояние [SWS_PER_00334]. После успешного выполнения хранилище содержит исключительно те пары «ключ — значение» с их начальными значениями, которые были предоставлены через Target Configuration; после этого хранилище ведет себя так, как будто оно было заново установлено из текущей конфигурации [SWS_PER_00334]. В качестве параметра передается путь kvs как ara::core::InstanceSpecifier, который ссылается на PortPrototype сконфигурированного PersistencyKeyValueStorageInterface [SWS_PER_00334].

Функция специфицирована как thread-safe и exception safe, однако подчиняется строгим условиям параллелизма относительно открытых хранилищ и глобальных операций персистентности [SWS_PER_00334]:

Вызов завершается сбоем с PerErrc::kResourceBusy, если соответствующий Key-Value-Storage в данный момент открыт (то есть еще существует SharedHandle, см. [SWS_PER_00052]) или параллельно выполняется восстановление с помощью RecoverKeyValueStorage [SWS_PER_00333] на том же хранилище [SWS_PER_00334].
К kResourceBusy также приводит параллельное выполнение глобальных операций UpdatePersistency [SWS_PER_00357], CleanUpPersistency [SWS_PER_00567], ResetPersistency [SWS_PER_00358] или параллельный вызов ResetKeyValueStorage в другом потоке [SWS_PER_00334].

В качестве результата функция возвращает ara::core::Result<void> [SWS_PER_00334]. В случае ошибки, помимо kResourceBusy, возникают следующие специфические коды ошибок: PerErrc::kStorageNotFound (недопустимый InstanceSpecifier), PerErrc::kPhysicalStorageFailure (ошибка доступа к носителю данных, без семантики отката), PerErrc::kOutOfStorageSpace (недостаточно места в памяти для начальных значений, без семантики отката), PerErrc::kEncryptionFailed (ошибка шифрования), а также PerErrc::kAuthenticationFailed (ошибка при вычислении MAC) [SWS_PER_00334].

Это указание по использованию было сгенерировано ИИ на основе спецификации AUTOSAR R25-11.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
kvs	The shortName path of a PortPrototype typed by a PersistencyKey ValueStorageInterface.

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
PerErrc::kStorageNotFound	rollback_semantics Returned if the passed InstanceSpecifier does not match any PersistencyKeyValueStorageInterface configured for this Executable.
PerErrc::kPhysicalStorageFailure	no_rollback_semantics Returned if access to the physical storage fails.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the encryption of stored data fails.
PerErrc::kResourceBusy	rollback_semantics Returned if UpdatePersistency, CleanUpPersistency, or Reset Persistency is currently being executed, or if RecoverKeyValue Storage is currently being executed for the same Key-Value Storage, or a SharedHandle of the same Key-Value Storage is currently in use.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for the initial values.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if calculating the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00334
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00334@rel:R25-11#e3d87a97
Content hash: e3d87a97
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00334

Status: valid/unmigrated Version: rel:R25-11#6250b32b Versionshistorie & Revisions (1 transition, 8 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_00334@rel:R25-11#6250b32b

Recorded Revisions (8):

R25-11rel:R25-11#370e52a02026-09-30
R19-11rel:R19-11#cd1560792026-10-14
R20-11rel:R20-11#1ed663b32026-10-14
R21-11rel:R21-11#f31fb8fb2026-10-14
R22-11rel:R22-11#764c93d52026-10-14
R23-11rel:R23-11#f7e8d0052026-10-14
R24-11rel:R24-11#cdcd205a2026-10-14
R25-11rel:R25-11#6250b32b2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция ResetPersistency [SWS_PER_00358] Upstream: RS_PER_00009, RS_AP_00119, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< void > ResetPersistency () noexcept;

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: d1720067a24e Происхождение

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Использование

Синхронная функция ResetPersistency ([SWS_PER_00358]) из заголовочного файла ara/per/update.h служит для полного сброса всех хранилищ «ключ — значение» и файловых хранилищ приложения. При вызове все персистентное содержимое удаляется без остатка. Сами хранилища при этом создаются заново не сразу, а только при следующем вызове ara::per::OpenKeyValueStorage ([SWS_PER_00052]) или ara::per::OpenFileStorage ([SWS_PER_00116]). Файлы, которые повторно предоставляются после сброса, получают при этом статус создания FileCreationState::kCreatedDuringInstallation ([SWS_PER_00435]).

Обработка ошибок

В качестве возвращаемого значения функция возвращает ara::core::Result<void> ([SWS_PER_00358]). Если во время операции происходит сбой доступа к физическому носителю данных, функция возвращает kPhysicalStorageFailure без семантики отката. Если персистентные ресурсы заняты или параллельно модифицируются, вызов прерывается с ошибкой kResourceBusy и активной семантикой отката ([SWS_PER_00358]). Кроме того, могут возникать ошибки, специфичные для поставщика.

Параллелизм и ограничения

Интерфейс объявлен как exception safe, но явно классифицирован как not thread-safe ([SWS_PER_00358]). Он завершается сбоем с kResourceBusy, как только:

уже выполняются глобальные операции, такие как UpdatePersistency ([SWS_PER_00357]) или CleanUpPersistency ([SWS_PER_00567]),
отдельное хранилище параллельно обрабатывается через RecoverKeyValueStorage, ResetKeyValueStorage, RecoverAllFiles ([SWS_PER_00335]) или ResetAllFiles ([SWS_PER_00336]),
или все еще существует как минимум один активный SharedHandle хранилища «ключ — значение» или файлового хранилища ([SWS_PER_00358]).

Пока выполняется ResetPersistency, одновременные попытки открытия через OpenKeyValueStorage ([SWS_PER_00052]) или OpenFileStorage ([SWS_PER_00116]) в других потоках также приводят к kResourceBusy.

Этот текст был создан ИИ. Спецификации AUTOSAR имеют преимущественную силу.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei	#include "ara/per/update.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode

Beschreibung

kPhysicalStorage-Failure

no_rollback_semantics Returned if access to the physical storage fails during the reset operation.

kResourceBusy

rollback_semantics Returned if ara::per::UpdatePersistency or ara::per:: CleanUpPersistency is currently being executed, or if ara:: per::RecoverKeyValueStorage or ara::per:: ResetKeyValueStorage is currently being executed for any Key-Value Storage, or if ara::per::RecoverAllFiles or ara::per::ResetAllFiles is currently being executed for any File Storage, or a ara::per::SharedHandle of a Key- Value Storage or a File Storage is currently in use.

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

Record: AUTOSAR/AP/record/SWS_PER_00358
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00358@rel:R25-11#b7d81f9a
Content hash: b7d81f9a
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00358

Status: valid/unmigrated Version: rel:R25-11#5a943877 Versionshistorie & Revisions (1 transition, 8 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_00358@rel:R25-11#5a943877

Recorded Revisions (8):

R25-11rel:R25-11#c8860b2d2026-09-30
R19-11rel:R19-11#8d6229f02026-10-14
R20-11rel:R20-11#cdbd91872026-10-14
R21-11rel:R21-11#58c165482026-10-14
R22-11rel:R22-11#675e4de82026-10-14
R23-11rel:R23-11#9628a79f2026-10-14
R24-11rel:R24-11#a5d729472026-10-14
R25-11rel:R25-11#5a9438772026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция UpdatePersistency [SWS_PER_00357] Upstream: RS_PER_00013, RS_AP_00119, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< void > UpdatePersistency () noexcept;

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: a05074f12eed Происхождение

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Использование

Синхронная функция ara::per::UpdatePersistency ([SWS_PER_00357], заголовочный файл ara/per/update.h) после установки новой целевой конфигурации обновляет все хранилища Key-Value и File приложения. Она служит для обновления персистентных данных Adaptive Application на этапе верификации [SWS_PER_00357]. Функция не принимает входных параметров и возвращает ara::core::Result<void> [SWS_PER_00357].

Обработка ошибок

В случае ошибки возвращенный Result содержит определенный код ошибки или ошибку, специфичную для производителя [SWS_PER_00357]. При этом различаются операции с семантикой отката и без нее:

Семантика отката: при kIntegrityCorrupted, kValidationFailed, kEncryptionFailed, kAuthenticationFailed, kTooManyFiles (превышение maxNumberOfFiles), kQuotaExceeded (превышение MaximumAllowedSize), а также kResourceBusy внесенные изменения сбрасываются [SWS_PER_00357].
Без семантики отката: при физических ошибках хранилища (kPhysicalStorageFailure), а также при недостатке физического дискового пространства (kOutOfStorageSpace) откат не гарантируется [SWS_PER_00357].

Параллелизм и ограничения

Функция специфицирована как исключениебезопасная (exception safe), но явно как потоконебезопасная (not thread-safe) [SWS_PER_00357]. Вызов завершается ошибкой kResourceBusy, как только SharedHandle хранилища Key-Value или File еще используется или параллельно выполняются функции обслуживания, такие как CleanUpPersistency [SWS_PER_00567], ResetPersistency [SWS_PER_00358], RecoverKeyValueStorage [SWS_PER_00333], ResetKeyValueStorage [SWS_PER_00334], RecoverAllFiles [SWS_PER_00335] или ResetAllFiles [SWS_PER_00336] [SWS_PER_00357]. И наоборот, одновременные вызовы OpenKeyValueStorage [SWS_PER_00052] и OpenFileStorage [SWS_PER_00116] из других потоков во время обновления также завершаются с ошибкой kResourceBusy.

Взаимодействие

Если во время работы с помощью UCM была установлена новая целевая конфигурация и повторно считана через ReloadPersistencyManifest [SWS_PER_00577], закрытые хранилища обновляются через UpdatePersistency. Если ранее через RegisterDataUpdateIndication [SWS_PER_00578] или RegisterApplicationDataUpdateCallback [SWS_PER_00356] были зарегистрированы обратные вызовы, их вызов происходит синхронно в контексте UpdatePersistency [SWS_PER_00578].

Это указание по использованию было сгенерировано автоматически на основе спецификации AUTOSAR R25-11.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei	#include "ara/per/update.h"
Scope	namespace ara::per
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
kPhysicalStorage-Failure	no_rollback_semantics Returned if access to the physical storage fails during the update operation.
kIntegrityCor-rupted	rollback_semantics Returned if stored data cannot be read because the structural integrity is corrupted.
kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
kEncryptionFailed	rollback_semantics Returned if the encryption or decryption of stored data fails during the update operation.
kResourceBusy	rollback_semantics Returned if ara::per::CleanUpPersistency or ara::per:: ResetPersistency is currently being executed, or if ara:: per::RecoverKeyValueStorage or ara::per:: ResetKeyValueStorage is currently being executed for any Key-Value Storage, or if ara::per::RecoverAllFiles or ara::per::ResetAllFiles is currently being executed for any File Storage, or a ara::per::SharedHandle of a Key- Value Storage or a File Storage is currently in use.
kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for the update.
kTooManyFiles	rollback_semantics Returned if the files added during the update of any File Storage would exceed the configured PersistencyFileStorageInterface.maxNumberOfFiles.
kQuotaExceeded	rollback_semantics Returned if the update would exceed the configured PersistencyCommon.MaximumAllowedSize of any Key- Value Storage or File Storage.
kAuthentication-Failed	rollback_semantics Returned if calculating or checking the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00357
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00357@rel:R25-11#357ae02c
Content hash: 357ae02c
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00357

Status: valid/unmigrated Version: rel:R25-11#1d0f3ff3 Versionshistorie & Revisions (1 transition, 8 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_00357@rel:R25-11#1d0f3ff3

Recorded Revisions (8):

R25-11rel:R25-11#77e03de52026-09-30
R19-11rel:R19-11#b69714eb2026-10-14
R20-11rel:R20-11#2ada0bc82026-10-14
R21-11rel:R21-11#fc219af52026-10-14
R22-11rel:R22-11#8c6aea8d2026-10-14
R23-11rel:R23-11#9bb026b22026-10-14
R24-11rel:R24-11#936392f02026-10-14
R25-11rel:R25-11#1d0f3ff32026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция operator| [SWS_PER_00144] Upstream: RS_PER_00001, RS_PER_00004, RS_AP_00119, RS_AP_00120, RS_ AP_00121

constexpr OpenMode operator| (OpenMode left, OpenMode right);

Merges two OpenMode modifiers into one.

Header-Datei	#include "ara/per/file_storage.h"
Scope	namespace ara::per
Exception-Sicherheit	not exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
left	First OpenMode modifiers.
right	Second OpenMode modifiers.

Rückgabewert

Typ	Beschreibung
OpenMode	returns Merged OpenMode modifiers.

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

Record: AUTOSAR/AP/record/SWS_PER_00144
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00144@rel:R25-11#0cc4fe91
Content hash: 0cc4fe91
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00144

Status: valid/unmigrated Version: rel:R25-11#be0c00de Versionshistorie & Revisions (1 transition, 8 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_00144@rel:R25-11#be0c00de

Recorded Revisions (8):

R25-11rel:R25-11#089c02522026-09-30
R19-11rel:R19-11#4ac4ea742026-10-14
R20-11rel:R20-11#d1a0a9db2026-10-14
R21-11rel:R21-11#a74548b62026-10-14
R22-11rel:R22-11#f391a35f2026-10-14
R23-11rel:R23-11#0b63b8d12026-10-14
R24-11rel:R24-11#be0c00de2026-10-14
R25-11rel:R25-11#be0c00de2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

функция operator|= [SWS_PER_00434] Upstream: RS_PER_00001, RS_PER_00004, RS_AP_00119, RS_AP_00120, RS_ AP_00121

OpenMode & operator|= (OpenMode &left, const OpenMode &right);

Merges an OpenMode modifier into this OpenMode.

Header-Datei	#include "ara/per/file_storage.h"
Scope	namespace ara::per
Exception-Sicherheit	not exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
left	Left OpenMode modifiers.
right	Right OpenMode modifiers.

Rückgabewert

Typ	Beschreibung
OpenMode &	returns The modified OpenMode.

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

Record: AUTOSAR/AP/record/SWS_PER_00434
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00434@rel:R25-11#738627f4
Content hash: 738627f4
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00434

Status: valid/unmigrated Version: rel:R25-11#481cc8ef 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_00434@rel:R25-11#481cc8ef

Recorded Revisions (7):

R25-11rel:R25-11#eda27c892026-09-30
R20-11rel:R20-11#7995a25b2026-10-14
R21-11rel:R21-11#7c5577592026-10-14
R22-11rel:R22-11#483368c52026-10-14
R23-11rel:R23-11#951ada062026-10-14
R24-11rel:R24-11#481cc8ef2026-10-14
R25-11rel:R25-11#481cc8ef2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

пространство имён ara::per

Руководство пользователяСОЗДАНО ИИ

Контекст

Жизненный цикл

Путь использования

Сценарии ошибок

Карта тем

Dateizugriff

Speicheröffnung

Fehlerbehandlung

Wiederherstellung

Datenpflege

Диаграмма классов

Подробный вид

Dateizugriff

Speicheröffnung

Fehlerbehandlung

Wiederherstellung

Datenpflege

Перечисления

перечисление FileCreationState [SWS_PER_00435] Upstream: RS_PER_00004, RS_AP_00122, RS_AP_00125, RS_AP_00143

Werte

Recorded Revisions (7):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

перечисление FileModificationState [SWS_PER_00436] Upstream: RS_PER_00004, RS_AP_00122, RS_AP_00125, RS_AP_00143

Werte

Recorded Revisions (7):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

перечисление OpenMode [SWS_PER_00147] Upstream: RS_PER_00003, RS_AP_00122, RS_AP_00125, RS_AP_00143

Werte

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

перечисление Origin [SWS_PER_00146] Upstream: RS_PER_00003, RS_AP_00122, RS_AP_00125, RS_AP_00143

Werte

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

перечисление PerErrc [SWS_PER_00311] Upstream: RS_AP_00122, RS_AP_00125, RS_AP_00127, RS_AP_00149

Werte

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

перечисление RecoveryReportKind [SWS_PER_00432] Upstream: RS_PER_00008, RS_AP_00122, RS_AP_00125, RS_AP_00143

Werte

Recorded Revisions (7):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

Документация свободных функций

функция CheckForManifestUpdate [SWS_PER_00576] Upstream: RS_PER_00013, RS_AP_00119, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00135, RS_AP_00139, RS_AP_00159

Использование

Обработка ошибок и параллелизм

Взаимодействие

Rückgabewert

Fehler

Recorded Revisions (3):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

функция CleanUpPersistency [SWS_PER_00567] Upstream: RS_PER_00016, RS_AP_00119, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00135, RS_AP_00139, RS_AP_00159

Использование

Параллелизм и ограничения

Обработка ошибок

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

функция GetCurrentFileStorageSize [SWS_PER_00406] Upstream: RS_PER_00017, RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00137, RS_AP_00139, RS_AP_00159

Parameter (in)

Rückgabewert