DEENESPTFRRUARHIKOZHNL

क्लास ara::crypto::cryp::SymmetricCipherCtx

[SWS_CRYPT_50136] Upstream: RS_CRYPTO_02201

class SymmetricCipherCtx :           public CryptoContext {...};

Interface for Symmetric Cipher Operations.

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Forwarding-Header#include "ara/crypto/crypto_fwd.h"
Scopenamespace ara::crypto::cryp
Basisklasse(n)CryptoContext

उपयोगकर्ता गाइडएआई जनित

डेटा स्ट्रीम या एकल कॉल में सममित एन्क्रिप्शन और डिक्रिप्शन संचालन के लिए एक इंटरफ़ेस के रूप में कार्य करता है।
एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 0261b663ca0d उद्गम खुले प्रश्न (1)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

डेटा स्ट्रीम या एकल कॉल में सममित एन्क्रिप्शन और डिक्रिप्शन संचालन के लिए एक इंटरफ़ेस के रूप में कार्य करता है।

वर्ग ara::crypto::cryp::SymmetricCipherCtx AUTOSAR Adaptive [SWS_CRYPT_50044] में सममित एन्क्रिप्शन और डिक्रिप्शन संचालन के लिए एक थ्रेड-सुरक्षित इंटरफ़ेस के रूप में कार्य करता है। SetKey() के माध्यम से एक कुंजी को कॉन्फ़िगर करने के बाद, डेटा को या तो एकल कॉल में या Start(), Update() और Finish() के स्ट्रीमिंग चक्र में क्रमिक रूप से संसाधित किया जा सकता है [SWS_CRYPT_50138], [SWS_CRYPT_50139]। सभी विधियों को noexcept के रूप में निर्दिष्ट किया गया है और ara::core::Result [SWS_CRYPT_50140] के माध्यम से लापता आरंभीकरण या बहुत छोटे बफ़र्स जैसी त्रुटियों का संकेत देते हैं।

संदर्भ

इंटरफ़ेस ara::crypto::cryp::SymmetricCipherCtx सममित क्रिप्टोग्राफ़िक परिवर्तनों को समाहित करता है, जिसमें एन्क्रिप्शन और डिक्रिप्शन दोनों ऑपरेशन शामिल हैं। क्रिप्टो आर्किटेक्चर के भीतर, वर्ग सममित एल्गोरिदम के लिए एक निष्पादन संदर्भ के रूप में कार्य करता है और कुंजी वस्तुओं के साथ-साथ मेमोरी बफ़र्स के साथ सहयोग करता है। क्रिप्टोग्राफ़िक कुंजी को कॉन्फ़िगर करने के लिए, वर्ग या तो सीधे SymmetricKey [SWS_CRYPT_50138] के माध्यम से क्षणिक कुंजियों के साथ या लगातार या अलग-थलग प्रबंधित कुंजियों के साथ KeySlot [SWS_CRYPT_50043] के माध्यम से बातचीत करता है। संसाधित किए जाने वाले प्लेनटेक्स्ट और सिफरटेक्स्ट और साथ ही इनिशियलाइज़ेशन वैक्टर (IV) प्रकार ReadOnlyMemRegion और ReadWriteMemRegion के मेमोरी क्षेत्रों के माध्यम से पास और प्राप्त किए जाते हैं [SWS_CRYPT_50048], [SWS_CRYPT_50049]।

जीवनचक्र

इंटरफ़ेस के जीवन चक्र और स्वामित्व को मुख्य रूप से टाइप किए गए स्मार्ट पॉइंटर उपनाम Sptr (std::shared_ptr<SymmetricCipherCtx>) [SWS_CRYPT_50137] के माध्यम से नियंत्रित किया जाता है। व्यवहार में एक ठोस उदाहरण का प्रावधान एक उच्च-स्तरीय क्रिप्टो फ़ैक्टरी विधि (व्याख्या) के माध्यम से होने की संभावना है, क्योंकि इंटरफ़ेस परिभाषा स्वयं निर्माण कार्यों को नहीं दिखाती है। प्रश्न Q-5b5f5ffdf964c91f (खुला)

इंस्टेंसिएशन के बाद, संदर्भ कई परिचालन चरणों से गुजरता है:

  • आरंभीकृत नहीं: इंस्टेंसिएशन के तुरंत बाद, संदर्भ के लिए कोई कुंजी असाइन नहीं की जाती है। इस चरण में प्रत्येक प्रसंस्करण कॉल त्रुटि CryptoErrc::kUninitializedContext [SWS_CRYPT_50044], [SWS_CRYPT_50047] की ओर जाता है।
  • आरंभीकृत / कुंजी बंधी हुई: SymmetricKey [SWS_CRYPT_50138] या KeySlot [SWS_CRYPT_50043] के साथ SetKey() को कॉल करके संदर्भ उपयोग के लिए तैयार हो जाता है। इस स्थिति से, या तो स्टेटलेस सिंगल-कॉल ऑपरेशन निष्पादित किए जा सकते हैं या स्टेटफुल स्ट्रीमिंग प्रक्रिया शुरू की जा सकती है।
  • स्ट्रीमिंग प्रसंस्करण: Start() का एक कॉल क्रमिक परिवर्तन शुरू करता है [SWS_CRYPT_50044], [SWS_CRYPT_23625]। इस चरण में, डेटा को Update() के माध्यम से रूपांतरित किया जा सकता है [SWS_CRYPT_50139] और स्थिति को Seek() [SWS_CRYPT_23613] के माध्यम से संशोधित किया जा सकता है। स्ट्रीमिंग स्थिति नियमित रूप से Finish() [SWS_CRYPT_50045] या FinishEncrypt() [SWS_CRYPT_23618] द्वारा समाप्त हो जाती है या Cancel() [SWS_CRYPT_50046] के माध्यम से समय से पहले खारिज कर दी जाती है। उसके बाद, संदर्भ आरंभीकृत मूल स्थिति में वापस आ जाता है।

SymmetricCipherCtx की सभी विधियों को noexcept के रूप में घोषित किया गया है, अपवाद सुरक्षा ("exception safe") सुनिश्चित करती हैं और समवर्ती पहुंच के लिए थ्रेड-सुरक्षित ("thread-safe") के रूप में निर्दिष्ट हैं [SWS_CRYPT_50044], [SWS_CRYPT_50139]।

SymmetricCipherCtxState Uninitialized Uninitialized Initialized Initialized Uninitialized->Initialized SetKey() Initialized->Initialized ProcessSingleCall...() Streaming Streaming Initialized->Streaming Start() Streaming->Initialized Finish() / FinishEncrypt() / Cancel() Streaming->Streaming Update() / Seek()

स्थिति आरेख: सममित सिफर संदर्भ का जीवन चक्र और स्थिति संक्रमण। स्रोत: [SWS_CRYPT_50138], [SWS_CRYPT_50044], [SWS_CRYPT_50139], [SWS_CRYPT_50045], [SWS_CRYPT_50046]

उपयोग पथ

वास्तविक डेटा परिवर्तन से पहले, आवश्यक बफ़र और विखंडन (chunk) आकारों को निर्धारित करने की अनुशंसा की जाती है। GetMinimumChunkSize() [SWS_CRYPT_50144] और GetMaximumChunkSize() [SWS_CRYPT_50050] के माध्यम से इनपुट ब्लॉक्स के लिए अनुमेय सीमाओं का निर्धारण किया जा सकता है। यदि इनिशियलाइज़ेशन वैक्टर की आवश्यकता है, तो उनकी लंबाई सीमा को GetMinimumInputIvSize() [SWS_CRYPT_50141], GetMaximumInputIvSize() [SWS_CRYPT_50142] या GetOutputIvSize() [SWS_CRYPT_50143] का उपयोग करके क्वेरी किया जा सकता है। किसी ऑपरेशन के लिए अधिकतम आवश्यक लक्ष्य बफ़र आकार की गणना GetRequiredOutputBufferSize() [SWS_CRYPT_50140] का उपयोग करके की जाती है।

क्रमिक स्ट्रीम एन्क्रिप्शन या डिक्रिप्शन के लिए निम्नलिखित मानक प्रक्रिया लागू होती है:

  1. कुंजी कॉन्फ़िगर करना: SetKey() [SWS_CRYPT_50138] के माध्यम से संदर्भ के लिए क्रिप्टोग्राफ़िक कुंजी को बांधना।
  2. रूपांतरण शुरू करना: परिवर्तन दिशा (एन्क्रिप्शन या डिक्रिप्शन) और वैकल्पिक IV [SWS_CRYPT_23625] या बिना IV [SWS_CRYPT_50044] निर्दिष्ट करते हुए Start() को कॉल करना।
  3. डेटा ब्लॉक रूपांतरित करना: इनपुट डेटा के क्रमिक हस्तांतरण और आउटपुट डेटा [SWS_CRYPT_50139] को हटाने के लिए Update() की बार-बार कॉल। यदि आवश्यक हो, तो डेटा स्ट्रीम के भीतर Seek() [SWS_CRYPT_23613] के माध्यम से नेविगेट किया जा सकता है।
  4. समापन: Finish() [SWS_CRYPT_50045] के माध्यम से या FinishEncrypt() के माध्यम से अंतिम रूप देना, बशर्ते कि संदर्भ द्वारा जनरेट किए गए IV को लौटाया जाना चाहिए [SWS_CRYPT_23618]।

इस स्ट्रीमिंग पैटर्न के विकल्प के रूप में, इंटरफ़ेस समकालिक एकल कॉलों का समर्थन करता है। यदि पूरा पेलोड मौजूद है, तो ऑपरेशन सीधे ProcessSingleCall() [SWS_CRYPT_50047], ProcessSingleCallWithInputIv() [SWS_CRYPT_50048] के माध्यम से या संदर्भ-विशिष्ट IV पीढ़ी के लिए EncryptSingleCallWithOutputIv() [SWS_CRYPT_50049] के माध्यम से निष्पादित किया जा सकता है।

सममित डेटा स्ट्रीम एन्क्रिप्शनएप्लिकेशनSymmetricCipherCtxSetKey(key)Result<void>Start(kEncrypt, iv)Result<void>loopजब तक ब्लॉक उपलब्ध हैंUpdate(in, out)Result<size_t>FinishEncrypt(in, out, ivOut)Result<size_t>

अनुक्रम आरेख: स्ट्रीमिंग एन्क्रिप्शन का विशिष्ट कॉल क्रम। स्रोत: [SWS_CRYPT_50138], [SWS_CRYPT_23625], [SWS_CRYPT_50139], [SWS_CRYPT_23618]

त्रुटि परिदृश्य

वर्ग की विधियां त्रुटि डोमेन ara::crypto::CryptoErrc के कोड के साथ ara::core::Result के माध्यम से त्रुटियों का संकेत देती हैं। आवश्यक त्रुटि स्थितियों में शामिल हैं:

  • CryptoErrc::kUninitializedContext: तब होता है जब SetKey() के माध्यम से कुंजी संग्रहीत होने से पहले प्रसंस्करण कॉल जैसे Start() [SWS_CRYPT_50044], सिंगल-कॉल रूटीन [SWS_CRYPT_50047] या GetRequiredOutputBufferSize() [SWS_CRYPT_50140] को कॉल किया जाता है।
  • CryptoErrc::kProcessingNotStarted: तब ट्रिगर होता है जब स्ट्रीमिंग फ़ंक्शन जैसे Update() [SWS_CRYPT_50139], Finish() [SWS_CRYPT_50045], FinishEncrypt() [SWS_CRYPT_23618], Seek() [SWS_CRYPT_23613] या Cancel() [SWS_CRYPT_50046] पूर्व सफल Start() कॉल के बिना निष्पादित किए जाते हैं।
  • CryptoErrc::kInsufficientCapacity: डेटा या IV के लिए प्रदान किया गया लक्ष्य बफ़र न्यूनतम आवश्यक क्षमता [SWS_CRYPT_50139], [SWS_CRYPT_50049] से छोटा है।
  • CryptoErrc::kUsageViolation और CryptoErrc::kIncompatibleObject: पास किया गया कुंजी प्रकार परिवर्तन के लिए अनुपयुक्त है या कुंजी में संग्रहीत उपयोग नियम ऑपरेशन को प्रतिबंधित करते हैं (उदा. kAllowDataEncryption या kAllowDataDecryption का अभाव) [SWS_CRYPT_50044], [SWS_CRYPT_50047]।
  • CryptoErrc::kEmptyKeySlot और CryptoErrc::kBusyResource: इंगित करता है कि एक कॉन्फ़िगर किए गए KeySlot में रनटाइम पर कोई कुंजी नहीं है या क्रिप्टो ऑपरेशन के लिए आवश्यक संसाधन अवरुद्ध है [SWS_CRYPT_50048], [SWS_CRYPT_50049]।
  • CryptoErrc::kUnsupported: तब लौटाया जाता है जब कोई ऑपरेटिंग मोड (जैसे स्ट्रीम प्रोसेसिंग, सिंगल-कॉल या Seek()) चयनित संदर्भ या एल्गोरिदम द्वारा समर्थित नहीं होता है [SWS_CRYPT_23613], [SWS_CRYPT_50047]।

यह गाइड विनिर्देश आवश्यकताओं के आधार पर एक AI सहायक द्वारा तैयार किया गया था।

सदस्य मानचित्र

क्लास आरेख

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

G nara__crypto__cryp__SymmetricCipherCtx167 SymmetricCipherCtx + Cancel() + EncryptSingleCallWithOutputIv() + Finish() + FinishEncrypt() + GetMaximumChunkSize() + GetMaximumInputIvSize() + GetMinimumChunkSize() + GetMinimumInputIvSize() + GetOutputIvSize() + GetRequiredOutputBufferSize() + ProcessSingleCall() + ProcessSingleCallWithInputIv() + Seek() + SetKey() + Start() + Update() nara__crypto__cryp__CryptoContext85 CryptoContext nara__crypto__cryp__SymmetricCipherCtx167->nara__crypto__cryp__CryptoContext85

विवरण दृश्य

रूपरेखा में कोई प्रविष्टि चुनें।

मेथड

Cancel फ़ंक्शन

Cancel the ongoing streaming operation that has been initiated by Start() and has not yet been finished.

virtual ara::core::Result< void > Cancel () noexcept=0;
EncryptSingleCallWithOutputIv फ़ंक्शन

Perform encryption in a single-call and return an IV generated by the context.

virtual ara::core::Result< std::size_t > EncryptSingleCallWithOutputIv (ReadOnlyMemRegion in, ReadWriteMemRegion out, ReadWriteMemRegion iv Out) noexcept=0;
Finish फ़ंक्शन

Finalize the encryption/decryption without returning an IV.

virtual ara::core::Result< std::size_t > Finish (ReadOnlyMemRegion in, ReadWriteMemRegion out) noexcept=0;
FinishEncrypt फ़ंक्शन

Finalize the encryption and return the IV generated by the context.

virtual ara::core::Result< std::size_t > FinishEncrypt (ReadOnlyMem Region in, ReadWriteMemRegion out, ReadWriteMemRegion ivOut) noexcept=0;
GetMaximumChunkSize फ़ंक्शन

Get the maximum input buffer size supported for processing in single calls to Update(), Finish(), FinishEncrypt(), or ProcessSingleCall() by this context.

virtual ara::core::Result< std::size_t > GetMaximumChunkSize () const noexcept=0;
GetMaximumInputIvSize फ़ंक्शन

Get the maximum IV size required to be passed to the context in the functions Start() and ProcessSingleCallWithInputIv() for the given transformDirection.

virtual ara::core::Result< std::size_t > GetMaximumInputIvSize (Crypto Transform transformDirection) const noexcept=0;
GetMinimumChunkSize फ़ंक्शन

Get the minimum input buffer size supported for processing in single calls to Update(), Finish(), FinishEncrypt(), or ProcessSingleCall() by this context.

virtual ara::core::Result< std::size_t > GetMinimumChunkSize () const noexcept=0;
GetMinimumInputIvSize फ़ंक्शन

Get the minimum IV size required to be passed to the context in the functions Start() and ProcessSingleCallWithInputIv() for the given transformDirection.

virtual ara::core::Result< std::size_t > GetMinimumInputIvSize (Crypto Transform transformDirection) const noexcept=0;
GetOutputIvSize फ़ंक्शन

Get the output IV size that will be returned by the functions FinishEncrypt() (in case no IV has been provided by the application during the call to Start()), and EncryptSingleCallWithOutputIv().

virtual ara::core::Result< std::size_t > GetOutputIvSize () const noexcept=0;
GetRequiredOutputBufferSize फ़ंक्शन

Calculate the maximum required size of the output buffer depending on the input size in the current state of the context.

virtual ara::core::Result< std::size_t > GetRequiredOutputBufferSize (std::size_t inputSize, bool isFinal) const noexcept;
ProcessSingleCall फ़ंक्शन

Perform en-/decryption in a single-call without setting or returning an IV.

virtual ara::core::Result< std::size_t > ProcessSingleCall (ReadOnly MemRegion in, ReadWriteMemRegion out, CryptoTransform transform Direction) noexcept=0;
ProcessSingleCallWithInputIv फ़ंक्शन

Perform en-/decryption in a single-call, providing an IV to be used during en-/decryption.

virtual ara::core::Result< std::size_t > ProcessSingleCallWithInputIv (ReadOnlyMemRegion in, ReadWriteMemRegion out, CryptoTransform transformDirection, ReadOnlyMemRegion iv) noexcept=0;
Seek फ़ंक्शन

Set the position of the next byte within the data stream.

virtual ara::core::Result< void > Seek (std::int64_t offset, bool from Begin) noexcept=0;
SetKey फ़ंक्शन 2

Configure the context to use the key stored in the provided KeySlot at the time the en-/decryption is started.

ओवरलोड SetKey 2
virtual ara::core::Result< void > SetKey (KeySlot::Sptr keySlot) noexcept=0; SWS_CRYPT_50043
virtual ara::core::Result< void > SetKey (SymmetricKey::Sptr key) noexcept=0; SWS_CRYPT_50138
Start फ़ंक्शन 2

Initialize the context for a new encryption or decryption and set the IV used by the context.

ओवरलोड Start 2
virtual ara::core::Result< void > Start (CryptoTransform transform Direction, ReadOnlyMemRegion iv) noexcept=0; SWS_CRYPT_23625
virtual ara::core::Result< void > Start (CryptoTransform transform Direction) noexcept=0; SWS_CRYPT_50044
Update फ़ंक्शन

Encrypt or decrypt a data buffer.

virtual ara::core::Result< std::size_t > Update (ReadOnlyMemRegion in, ReadWriteMemRegion out) noexcept=0;

टाइप उपनाम

Sptr टाइप उपनाम

Smart pointer of the interface.

मेथड का प्रलेखन

फ़ंक्शन Cancel [SWS_CRYPT_50046] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< void > Cancel () noexcept=0;

Cancel the ongoing streaming operation that has been initiated by Start() and has not yet been finished.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 0bea3f0e1d0d उद्गम खुले प्रश्न (1)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

क्लास ara::crypto::cryp::SymmetricCipherCtx का सिंक्रोनस मेथड Cancel() किसी चालू स्ट्रीमिंग ऑपरेशन को समय से पहले निरस्त करने के लिए उपयोग किया जाता है, जिसे पहले Start() के साथ शुरू किया गया था और जो अभी तक समाप्त नहीं हुआ है [SWS_CRYPT_50046]। इंटरफ़ेस ara/crypto/cryp/symmetric_cipher_ctx.h में पैरामीटर-रहित घोषित है और सफल निष्पादन पर एक रिक्त ara::core::Result<void> लौटाता है [SWS_CRYPT_50046]।

यदि डेटा प्रोसेसिंग पहले Start() को कॉल करके शुरू नहीं की गई थी, तो ऑपरेशन विशिष्ट त्रुटि कोड ara::crypto::CryptoErrc::kProcessingNotStarted और रोलबैक सिमेंटिक्स के साथ विफल हो जाता है [SWS_CRYPT_50046]। कॉल संदर्भ के लिए, विनिर्देश थ्रेड-सुरक्षा (thread-safe) के साथ-साथ noexcept-घोषणा के साथ अपवाद-सुरक्षा (exception safe) की गारंटी देता है [SWS_CRYPT_50046]। Interpretation: रोलबैक सिमेंटिक्स के कारण, ऑब्जेक्ट निरस्त होने के बाद संभवतः पुनः तैयार प्रारंभिक स्थिति में वापस आ जाता है। प्रश्न Q-b6deb8db5367acc5 (खुला)

यह कार्यात्मक पैटर्न AUTOSAR Adaptive में सभी क्रिप्टोग्राफ़िक स्ट्रीमिंग संदर्भों में सुसंगत रूप से परिभाषित है। समान सिग्नेचर और त्रुटि सिमेंटिक्स संदर्भ वर्गों VerifierPublicCtx ([SWS_CRYPT_50023]), MessageAuthnCodeCtx ([SWS_CRYPT_50027]), SignerPrivateCtx ([SWS_CRYPT_50041]), HashFunctionCtx ([SWS_CRYPT_50058]), DecryptorPrivateCtx ([SWS_CRYPT_50069]), AuthCipherCtx ([SWS_CRYPT_50077]) और EncryptorPublicCtx ([SWS_CRYPT_50089]) के लिए लागू होते हैं।

यह पाठ एक AI द्वारा क्यूरेट किया गया था और AUTOSAR Adaptive R25-11 विनिर्देश पर आधारित है।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::core::Result< void >an empty result if the ongoing streaming operation was cancelled successfully, or a result containing an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kProcessingNotStartedrollback_semantics if data processing was not started by a call of the Start() method

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50046
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50046@rel:R25-11#7875e290
Content hash
7875e290
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50046
Status: valid/unmigrated Version: rel:R25-11#f0ef0c54 Versionshistorie & Revisions (1 transition)
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_CRYPT_50046@rel:R25-11#f0ef0c54
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन EncryptSingleCallWithOutputIv [SWS_CRYPT_50049] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< std::size_t > EncryptSingleCallWithOutputIv (ReadOnlyMemRegion in, ReadWriteMemRegion out, ReadWriteMemRegion iv Out) noexcept=0;

Perform encryption in a single-call and return an IV generated by the context.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 9c4059afbb11 उद्गम खुले प्रश्न (1)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग और बफ़र हैंडलिंग

सिंक्रोनस मेथड EncryptSingleCallWithOutputIv एकल कॉल में सममित एन्क्रिप्शन निष्पादित करती है और संदर्भ द्वारा जनरेट किए गए इनिशियलाइज़ेशन वेक्टर को बफ़र ivOut के माध्यम से लौटाती है [SWS_CRYPT_50049]। इनपुट डेटा in के माध्यम से पास किया जाता है, जबकि out एन्क्रिप्ट किए गए डेटा को प्राप्त करता है [SWS_CRYPT_50049]। सफल निष्पादन पर, परिणाम ara::core::Result<std::size_t> जनरेट किए गए आउटपुट डेटा का वास्तविक आकार प्रदान करता है, जो out की कुल क्षमता से कम हो सकता है [SWS_CRYPT_50049]। यदि चुने गए एल्गोरिदम को इनिशियलाइज़ेशन वेक्टर की आवश्यकता नहीं होती है, तो ivOut में कोई डेटा नहीं लिखा जाता है [SWS_CRYPT_50049]।

इंटरैक्शन और पूर्वापेक्षाएँ

कॉल करने से पहले संदर्भ को एक उपयुक्त कुंजी के माध्यम से इनिशियलाइज़ किया जाना चाहिए [SWS_CRYPT_50049]। बफ़र ivOut की पर्याप्त क्षमता सुनिश्चित करने के लिए, आवश्यक IV लंबाई पहले से GetOutputIvSize() के माध्यम से निर्धारित की जा सकती है [SWS_CRYPT_50143]। यदि अतिरिक्त रूप से टैग गणना के साथ प्रमाणीकरण की आवश्यकता होती है, तो ara::crypto::cryp::AuthCipherCtx संबंधित समकक्ष प्रदान करता है [SWS_CRYPT_50080]।

त्रुटि हैंडलिंग और समवर्तीता

इंटरफ़ेस थ्रेड-सुरक्षित और अपवाद-सुरक्षित ("exception safe") निर्दिष्ट है और त्रुटियों पर रोलबैक सेमेंटिक्स लागू करता है [SWS_CRYPT_50049]। Interpretation: इस रोलबैक सेमेंटिक्स द्वारा यह सुनिश्चित किए जाने की संभावना है कि त्रुटियाँ होने पर संदर्भ की स्थिति बरकरार रहे और बफ़र में कोई अधूरा डेटा मान्य रूप में न रहे। प्रश्न Q-841087731518d866 (खुला) प्रासंगिक त्रुटियों में शामिल हैं:

  • UninitializedContext: संदर्भ को अभी तक कोई कुंजी असाइन नहीं की गई है [SWS_CRYPT_50049]।
  • ara::crypto::CryptoErrc::kInsufficientCapacity: out या ivOut की क्षमता अपर्याप्त है [SWS_CRYPT_50049]।
  • ara::crypto::CryptoErrc::kUnsupported: सिंगल-कॉल एन्क्रिप्शन समर्थित नहीं है या एल्गोरिदम एक इनपुट IV को निर्दिष्ट करने के लिए बाध्य करता है [SWS_CRYPT_50049]।
  • ara::crypto::CryptoErrc::kUsageViolation या ara::crypto::CryptoErrc::kIncompatibleObject: कुंजी का प्रकार ट्रांसफ़ॉर्मेशन से मेल नहीं खाता है या कुंजी का उपयोग डेटा एन्क्रिप्शन की अनुमति नहीं देता है [SWS_CRYPT_50049]।

यह उपयोग नोट AUTOSAR Adaptive के विनिर्देशों के आधार पर AI द्वारा जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe ara::crypto::CryptoErrc::k rollback_semantics

Parameter (in)

ParameterBeschreibung
inan input data buffer containing the ciphertext or plaintext

Parameter (out)

ParameterBeschreibung
outan output data buffer that the encrypted or decrypted data is written to
ivOutan output data buffer that the initialization vector (IV) generated by the context will be written to. If the algorithm does not use an IV, no data will be written into the buffer.

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >a result containing the size of the output data or an error. The output data may be smaller than the size of the output buffer out.

Fehler

FehlercodeBeschreibung
UninitializedContextif the context was not initialized by deploying a key
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if single-call encryption is not supported, or if the algorithm requires providing an input IV
ara::crypto::CryptoErrc::kInsufficientCapacityrollback_semantics if the data or IV output buffer is too small
ara::crypto::CryptoErrc::kInvalidInputSizerollback_semantics if the size of the input buffer cannot be processed
ara::crypto::CryptoErrc::kInvalidArgumentrollback_semantics if the provided input data contains invalid data
ara::crypto::CryptoErrc::kBusyResourcerollback_semantics a required resource is busy
ara::crypto::CryptoErrc::kEmptyKeySlotrollback_semantics if a KeySlot was configured that is currently is empty
ara::crypto::CryptoErrc::kUsageViolationrollback_semantics if the allowed usage of the key does not include kAllowData Encryption for encryption
ara::crypto::CryptoErrc::kIncompatibleObjectrollback_semantics if type of the key is incompatible to the transformation or the transformation direction (encrypt)

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50049
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50049@rel:R25-11#f965e70c
Content hash
f965e70c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50049
Status: valid/unmigrated Version: rel:R25-11#f2ba22b4 Versionshistorie & Revisions (1 transition)
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_CRYPT_50049@rel:R25-11#f2ba22b4
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन Finish [SWS_CRYPT_50045] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< std::size_t > Finish (ReadOnlyMemRegion in, ReadWriteMemRegion out) noexcept=0;

Finalize the encryption/decryption without returning an IV.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 041cbaba2731 उद्गम खुले प्रश्न (1)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग

सिंक्रोनस मेथड Finish ara::crypto::cryp::SymmetricCipherCtx के भीतर एक इनिशियलाइज़ेशन वेक्टर लौटाए बिना सममित एन्क्रिप्शन या डिक्रिप्शन को फ़ाइनलाइज़ करती है ([SWS_CRYPT_50045])। यह इनपुट बफ़र in (ReadOnlyMemRegion) से अंतिम डेटा खंड को प्रोसेस करती है और परिणामी डेटा को आउटपुट बफ़र out (ReadWriteMemRegion) ([SWS_CRYPT_50045]) में लिखती है। इसके लिए आवश्यक बफ़र आकार को पहले से GetRequiredOutputBufferSize() के माध्यम से पूछा जा सकता है ([SWS_CRYPT_50045])। प्रकार ara::core::Result<std::size_t> का रिटर्न मान सफलता पर लिखे गए बाइट्स की सटीक संख्या देता है, जो out की कुल क्षमता से कम हो सकती है ([SWS_CRYPT_50045])।

त्रुटि प्रबंधन

त्रुटि की स्थिति में, मेथड विशिष्ट एरर कोड के साथ एक ara::core::Result लौटाती है ([SWS_CRYPT_50045]):

  • ProcessingNotStarted: डेटा प्रोसेसिंग पहले Start() द्वारा शुरू नहीं की गई थी ([SWS_CRYPT_50045])।
  • ara::crypto::CryptoErrc::kInsufficientCapacity: आउटपुट बफ़र out बहुत छोटा है ([SWS_CRYPT_50045])।
  • ara::crypto::CryptoErrc::kInvalidInputSize: इनपुट डेटा का आकार प्रोसेस नहीं किया जा सकता है ([SWS_CRYPT_50045])।
  • ara::crypto::CryptoErrc::kInvalidArgument: पास किया गया इनपुट डेटा अमान्य है ([SWS_CRYPT_50045])।
  • ara::crypto::CryptoErrc::kUnsupported: वर्तमान संदर्भ द्वारा स्ट्रीम प्रोसेसिंग समर्थित नहीं है ([SWS_CRYPT_50045])।

यदि CryptoErrc त्रुटियों में से कोई एक होती है, तो रोलबैक सेमेंटिक्स प्रभावी होता है ([SWS_CRYPT_50045])।

समवर्तीता और परस्पर क्रिया

ऑपरेशन को thread-safe और exception safe के रूप में परिभाषित किया गया है ([SWS_CRYPT_50045])। कॉल करने से पहले, ट्रांसफ़ॉर्मेशन अनिवार्य रूप से Start() द्वारा शुरू किया गया होना चाहिए ([SWS_CRYPT_50045])। Finish() के व्यक्तिगत कॉल्स के लिए अधिकतम स्वीकार्य इनपुट आकार GetMaximumChunkSize() के माध्यम से निर्धारित किया जा सकता है ([SWS_CRYPT_50050])। पूर्ण होने के बाद ट्रांसफ़ॉर्मेशन रन समाप्त होने की संभावना है और आगे के ऑपरेशनों के लिए संभवतः Start() के एक नए कॉल की आवश्यकता होगी। प्रश्न Q-c4ffc8028e8f522b (खुला)

यह पाठ AUTOSAR विनिर्देश R25-11 के आधार पर एक AI द्वारा जनरेट किया गया था।

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe ara::crypto::CryptoErrc::k rollback_semantics

Parameter (in)

ParameterBeschreibung
inan input data buffer containing a part of the ciphertext or plaintext

Parameter (out)

ParameterBeschreibung
outan output data buffer that contains encrypted or decrypted data. The required size of this buffer can be queried using GetRequired OutputBufferSize()

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >a result containing the size of the output data or an error. The output data may be smaller than the size of the output buffer out.

Fehler

FehlercodeBeschreibung
ProcessingNotStartedif data processing was not started by a call of the Start() method
ara::crypto::CryptoErrc::kInsufficientCapacityrollback_semantics if the output buffer is too small
ara::crypto::CryptoErrc::kInvalidInputSizerollback_semantics if the size of the input buffer cannot be processed
ara::crypto::CryptoErrc::kInvalidArgumentrollback_semantics if the provided input data contains invalid data
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if stream processing is not supported by the context or

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50045
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50045@rel:R25-11#3656eb8c
Content hash
3656eb8c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50045
Status: valid/unmigrated Version: rel:R25-11#b9951f15 Versionshistorie & Revisions (1 transition)
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_CRYPT_50045@rel:R25-11#b9951f15
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन FinishEncrypt [SWS_CRYPT_23618] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< std::size_t > FinishEncrypt (ReadOnlyMem Region in, ReadWriteMemRegion out, ReadWriteMemRegion ivOut) noexcept=0;

Finalize the encryption and return the IV generated by the context.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: c0e4f2ad1bdc उद्गम
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

विधि FinishEncrypt एक एन्क्रिप्शन ऑपरेशन को समाप्त करती है और संदर्भ द्वारा उत्पन्न आरंभीकरण वेक्टर (IV) लौटाती है [SWS_CRYPT_23618]। यह अंतिम इनपुट डेटा बफ़र in को संसाधित करती है और परिणामी डेटा को आउटपुट बफ़र out में तथा IV को ivOut में लिखती है। वापसी मान के रूप में, यह लिखे गए आउटपुट डेटा के वास्तविक आकार के साथ एक ara::core::Result<std::size_t> प्रदान करती है, जो out की क्षमता से छोटा हो सकता है [SWS_CRYPT_23618]।

त्रुटि-रहित निष्पादन के लिए, बफ़र आयामों और संदर्भ स्थिति को पहले से समन्वित किया जाना चाहिए:

  • out के लिए आवश्यक बफ़र आकार को पैरामीटर isFinal = true सेट करके [SWS_CRYPT_50140] के माध्यम से निर्धारित किया जा सकता है। यदि out बहुत छोटा है, तो कॉल CryptoErrc::kInsufficientCapacity के साथ विफल हो जाती है [SWS_CRYPT_23618]।
  • ivOut के लिए अपेक्षित आकार [SWS_CRYPT_50143] के माध्यम से पूछा जा सकता है।
  • in का इनपुट आकार [SWS_CRYPT_50144] और [SWS_CRYPT_50050] द्वारा परिभाषित न्यूनतम और अधिकतम सीमाओं के बीच होना चाहिए, अन्यथा CryptoErrc::kInvalidInputSize लौटाया जाता है [SWS_CRYPT_23618]।

यदि डेटा प्रोसेसिंग पहले Start() द्वारा शुरू नहीं की गई थी, तो विधि CryptoErrc::kProcessingNotStarted की रिपोर्ट करती है [SWS_CRYPT_23618]। यदि इनपुट बफ़र में अमान्य डेटा है, तो CryptoErrc::kInvalidArgument का अनुसरण होता है [SWS_CRYPT_23618]। त्रुटि CryptoErrc::kUnsupported तब होती है जब स्ट्रीम प्रोसेसिंग समर्थित नहीं होती है, संदर्भ किसी IV का उपयोग नहीं करता है या पहले ही Start() में एक IV पास किया जा चुका है [SWS_CRYPT_23618]। सभी त्रुटियों में रोलबैक शब्दार्थ होता है [SWS_CRYPT_23618]। विनिर्देश के अनुसार कॉल थ्रेड-सुरक्षित और अपवाद-सुरक्षित (noexcept) है [SWS_CRYPT_23618]।

यह उपयोग नोट AUTOSAR पेलोड के आधार पर स्वचालित रूप से उत्पन्न किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
inan input data buffer containing a part of the ciphertext or plaintext

Parameter (out)

ParameterBeschreibung
outan output data buffer that contains encrypted or decrypted data
ivOutan output data buffer that contains the IV

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >a result containing the size of the output data or an error. The output data may be smaller than the size of the output buffer out.

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kProcessingNotStartedrollback_semantics if data processing was not started by a call of the Start() method
ara::crypto::CryptoErrc::kInsufficientCapacityrollback_semantics if the output buffer is too small
ara::crypto::CryptoErrc::kInvalidInputSizerollback_semantics if the size of the input buffer cannot be processed
ara::crypto::CryptoErrc::kInvalidArgumentrollback_semantics if the provided input data contains invalid data
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if stream processing is not supported by the context or if this context does not use an IV or if the IV has been provided by the application in the Start() function

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

Record
AUTOSAR/AP/record/SWS_CRYPT_23618
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_23618@rel:R25-11#0ab1e2d1
Content hash
0ab1e2d1
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_23618
Status: valid/unmigrated Version: rel:R25-11#dcc35b13 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_CRYPT_23618@rel:R25-11#dcc35b13
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#c50d30f82026-09-30
  • R19-11rel:R19-11#c41ea37b2026-10-14
  • R20-11rel:R20-11#06f18fb12026-10-14
  • R21-11rel:R21-11#3725bc5a2026-10-14
  • R22-11rel:R22-11#724878ec2026-10-14
  • R23-11rel:R23-11#8e98bdf02026-10-14
  • R24-11rel:R24-11#1d9181d92026-10-14
  • R25-11rel:R25-11#dcc35b132026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन GetMaximumChunkSize [SWS_CRYPT_50050] Upstream: RS_CRYPTO_02309

virtual ara::core::Result< std::size_t > GetMaximumChunkSize () const noexcept=0;

Get the maximum input buffer size supported for processing in single calls to Update(), Finish(), FinishEncrypt(), or ProcessSingleCall() by this context.

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >the maximum buffer size in bytes

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50050
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50050@rel:R25-11#675d2d31
Content hash
675d2d31
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50050
Status: valid/unmigrated Version: rel:R25-11#439b3c69 Versionshistorie & Revisions (1 transition)
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_CRYPT_50050@rel:R25-11#439b3c69
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन GetMaximumInputIvSize [SWS_CRYPT_50142] Upstream: RS_CRYPTO_02309

virtual ara::core::Result< std::size_t > GetMaximumInputIvSize (Crypto Transform transformDirection) const noexcept=0;

Get the maximum IV size required to be passed to the context in the functions Start() and ProcessSingleCallWithInputIv() for the given transformDirection.

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
transformDirectionthe transformation direction, i.e., encryption or decryption

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >size of IV in bytes

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50142
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50142@rel:R25-11#b1e8d79f
Content hash
b1e8d79f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50142
Status: valid/unmigrated Version: rel:R25-11#2fd32b15 Versionshistorie & Revisions (1 transition)
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_CRYPT_50142@rel:R25-11#2fd32b15
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन GetMinimumChunkSize [SWS_CRYPT_50144] Upstream: RS_CRYPTO_02309

virtual ara::core::Result< std::size_t > GetMinimumChunkSize () const noexcept=0;

Get the minimum input buffer size supported for processing in single calls to Update(), Finish(), FinishEncrypt(), or ProcessSingleCall() by this context.

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >the minimum buffer size in bytes

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50144
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50144@rel:R25-11#adb28ffa
Content hash
adb28ffa
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50144
Status: valid/unmigrated Version: rel:R25-11#8dfc91ab Versionshistorie & Revisions (1 transition)
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_CRYPT_50144@rel:R25-11#8dfc91ab
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन GetMinimumInputIvSize [SWS_CRYPT_50141] Upstream: RS_CRYPTO_02309

virtual ara::core::Result< std::size_t > GetMinimumInputIvSize (Crypto Transform transformDirection) const noexcept=0;

Get the minimum IV size required to be passed to the context in the functions Start() and ProcessSingleCallWithInputIv() for the given transformDirection.

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
transformDirectionthe transformation direction, i.e., encryption or decryption

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >size of IV in bytes

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50141
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50141@rel:R25-11#ad7b556d
Content hash
ad7b556d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50141
Status: valid/unmigrated Version: rel:R25-11#a69e1387 Versionshistorie & Revisions (1 transition)
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_CRYPT_50141@rel:R25-11#a69e1387
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन GetOutputIvSize [SWS_CRYPT_50143] Upstream: RS_CRYPTO_02309

virtual ara::core::Result< std::size_t > GetOutputIvSize () const noexcept=0;

Get the output IV size that will be returned by the functions FinishEncrypt() (in case no IV has been provided by the application during the call to Start()), and EncryptSingleCallWithOutputIv().

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >size of IV in bytes

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50143
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50143@rel:R25-11#5f9c8ae4
Content hash
5f9c8ae4
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50143
Status: valid/unmigrated Version: rel:R25-11#11f7dfe6 Versionshistorie & Revisions (1 transition)
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_CRYPT_50143@rel:R25-11#11f7dfe6
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन GetRequiredOutputBufferSize [SWS_CRYPT_50140] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< std::size_t > GetRequiredOutputBufferSize (std::size_t inputSize, bool isFinal) const noexcept;

Calculate the maximum required size of the output buffer depending on the input size in the current state of the context.

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
inputSizesize of input data
isFinalif true, calculate maximum required output buffer size for Finish(), FinishEncrypt(), ProcessSingleCallWithInputIv(), and Encrypt SingleCallWithOutputIv(), otherwise for Update()

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >a result containing the required capacity of the output buffer (in bytes) or an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kUninitializedContextrollback_semantics if the context was not initialized by deploying a key and setting the transformation direction

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50140
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50140@rel:R25-11#8ed78505
Content hash
8ed78505
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50140
Status: valid/unmigrated Version: rel:R25-11#3cd4a32f Versionshistorie & Revisions (1 transition)
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_CRYPT_50140@rel:R25-11#3cd4a32f
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन ProcessSingleCall [SWS_CRYPT_50047] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< std::size_t > ProcessSingleCall (ReadOnly MemRegion in, ReadWriteMemRegion out, CryptoTransform transform Direction) noexcept=0;

Perform en-/decryption in a single-call without setting or returning an IV.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 4a1fdc95f521 उद्गम
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

मेथड ProcessSingleCall इनिशियलाइज़ेशन वेक्टर (IV) के बिना एकल सिंक्रोनस कॉल में एन्क्रिप्शन या डिक्रिप्शन निष्पादित करती है ([SWS_CRYPT_50047])। डेटा बफ़र in (ReadOnlyMemRegion) और ट्रांसफ़ॉर्मेशन दिशा transformDirection (CryptoTransform) इनपुट पैरामीटर के रूप में काम करते हैं, जबकि परिणाम बफ़र out (ReadWriteMemRegion) में लिखा जाता है। सफल निष्पादन पर, फ़ंक्शन एक ara::core::Result<std::size_t> लौटाता है, जिसमें लिखे गए बाइट्स की संख्या होती है; यह मान आउटपुट बफ़र की कुल क्षमता से कम हो सकता है।

समवर्तीता और सुरक्षा के संबंध में, मेथड को thread-safe और exception safe के रूप में निर्दिष्ट किया गया है ([SWS_CRYPT_50047])। in का प्रोसेस करने योग्य इनपुट आकार संदर्भ द्वारा परिभाषित सीमाओं के अधीन है, जिन्हें [SWS_CRYPT_50144] (GetMinimumChunkSize) और [SWS_CRYPT_50050] (GetMaximumChunkSize) के माध्यम से पूछा जा सकता है।

सभी त्रुटि मामले रोलबैक सेमेंटिक्स का पालन करते हैं ([SWS_CRYPT_50047]):

  • ara::crypto::CryptoErrc::kUninitializedContext: संदर्भ को पहले कोई कुंजी असाइन करके इनिशियलाइज़ नहीं किया गया था।
  • ara::crypto::CryptoErrc::kUnsupported: सिंगल-कॉल प्रोसेसिंग समर्थित नहीं है या ट्रांसफ़ॉर्मेशन के लिए IV सेट करने अथवा पढ़ने की आवश्यकता है।
  • ara::crypto::CryptoErrc::kInsufficientCapacity: आउटपुट बफ़र out पर्याप्त क्षमता प्रदान नहीं करता है।
  • ara::crypto::CryptoErrc::kInvalidInputSize: इनपुट आकार संदर्भ द्वारा प्रोसेस नहीं किया जा सकता है।
  • ara::crypto::CryptoErrc::kUsageViolation: कुंजी का उपयोग अनुरोधित ऑपरेशन को कवर नहीं करता है (क्रमशः kAllowDataEncryption या kAllowDataDecryption)।
  • ara::crypto::CryptoErrc::kIncompatibleObject, kEmptyKeySlot, kInvalidArgument या kBusyResource: कुंजी असंगत है, कुंजी-स्लॉट रिक्त है, इनपुट डेटा अमान्य है या आवश्यक संसाधन व्यस्त हैं।

अन्य इंटरफ़ेस के साथ इंटरैक्शन में, कॉल के लिए पूरी तरह से कॉन्फ़िगर किए गए संदर्भ की आवश्यकता होती है; अतिरिक्त टैग प्रोसेसिंग वाले ऑथेंटिकेटिंग सिफ़र के लिए AuthCipherCtx में वैकल्पिक इंटरफ़ेस [SWS_CRYPT_50078] उपलब्ध है।

यह उपयोग नोट AUTOSAR विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
inan input data buffer containing the ciphertext or plaintext
transformDirectionthe transformation direction, i.e., encryption or decryption

Parameter (out)

ParameterBeschreibung
outan output data buffer that the encrypted or decrypted data is written to

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >a result containing the size of the output data or an error. The output data may be smaller than the size of the output buffer out.

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kUninitializedContextrollback_semantics if the context was not initialized by deploying a key
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if single-call en-/decryption is not supported, or if the context requires setting or returning an IV in the passed transformDirection
ara::crypto::CryptoErrc::kInsufficientCapacityrollback_semantics if the output buffer is too small
ara::crypto::CryptoErrc::kInvalidInputSizerollback_semantics if the size of the input buffer cannot be processed
ara::crypto::CryptoErrc::kInvalidArgumentrollback_semantics if the provided input data contains invalid data
ara::crypto::CryptoErrc::kBusyResourcerollback_semantics a required resource is busy
ara::crypto::CryptoErrc::kEmptyKeySlotrollback_semantics if a KeySlot was configured that is currently is empty
ara::crypto::CryptoErrc::kUsageViolationrollback_semantics if the allowed usage of the key does not include kAllowData Encryption for encryption, or kAllowDataDecryption for decryption, respectively
ara::crypto::CryptoErrc::kIncompatibleObjectrollback_semantics if type of the key is incompatible to the transformation or the transformation direction

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50047
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50047@rel:R25-11#5d241ea8
Content hash
5d241ea8
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50047
Status: valid/unmigrated Version: rel:R25-11#c5198454 Versionshistorie & Revisions (1 transition)
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_CRYPT_50047@rel:R25-11#c5198454
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन ProcessSingleCallWithInputIv [SWS_CRYPT_50048] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< std::size_t > ProcessSingleCallWithInputIv (ReadOnlyMemRegion in, ReadWriteMemRegion out, CryptoTransform transformDirection, ReadOnlyMemRegion iv) noexcept=0;

Perform en-/decryption in a single-call, providing an IV to be used during en-/decryption.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: f491c775eb62 उद्गम
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

ara::crypto::cryp::SymmetricCipherCtx पर मेथड ProcessSingleCallWithInputIv एकल सिंक्रोनस कॉल (सिंगल-कॉल) में डेटा का सममित एन्क्रिप्शन या डिक्रिप्शन निष्पादित करती है [SWS_CRYPT_50048]। इस प्रक्रिया में ट्रांसफ़ॉर्मेशन के लिए प्रयुक्त इनिशियलाइज़ेशन वेक्टर स्पष्ट रूप से इनपुट बफ़र iv के माध्यम से पास किया जाता है।

उपयोग और अंतःक्रिया

transformDirection के माध्यम से नियंत्रित किया जाता है कि in के डेटा को एन्क्रिप्ट किया जाए या डिक्रिप्ट। परिणाम बफ़र out में लिखा जाता है। लौटाया गया ara::core::Result<std::size_t> लिखे गए बाइट्स की वास्तविक संख्या रखता है, जो out की कुल क्षमता से कम हो सकती है [SWS_CRYPT_50048]।

बफ़र्स के आकार निर्धारण के लिए सहायक फ़ंक्शन उपलब्ध हैं:

  • out के लिए आवश्यक बफ़र आकार की गणना पहले से पैरामीटर isFinal = true के साथ GetRequiredOutputBufferSize के माध्यम से की जा सकती है [SWS_CRYPT_50140]।
  • iv के लिए अनुमत लंबाई चुनी गई ट्रांसफ़ॉर्मेशन दिशा के लिए GetMinimumInputIvSize [SWS_CRYPT_50141] और GetMaximumInputIvSize [SWS_CRYPT_50142] के माध्यम से निर्धारित की जा सकती है।
  • यदि प्रमाणीकरण टैग के निर्माण या सत्यापन की भी आवश्यकता होती है, तो इसके बजाय ara::crypto::cryp::AuthCipherCtx::ProcessSingleCallWithInputIv का उपयोग किया जाना चाहिए [SWS_CRYPT_50079]।

त्रुटि हैंडलिंग और समवर्तीता

ऑपरेशन को thread-safe और exception safe के रूप में परिभाषित किया गया है [SWS_CRYPT_50048]। सभी त्रुटियों में रोलबैक सेमेंटिक्स होता है:

  • CryptoErrc::kUninitializedContext या CryptoErrc::kEmptyKeySlot: संदर्भ को कोई कुंजी असाइन नहीं की गई थी या KeySlot रिक्त है [SWS_CRYPT_50048]।
  • CryptoErrc::kUsageViolation: कुंजी चुनी गई दिशा की अनुमति नहीं देती है (kAllowDataEncryption या kAllowDataDecryption अनुपलब्ध है) [SWS_CRYPT_50048]।
  • CryptoErrc::kIncompatibleObject: कुंजी का प्रकार ट्रांसफ़ॉर्मेशन के साथ असंगत है [SWS_CRYPT_50048]।
  • CryptoErrc::kInsufficientCapacity: आउटपुट बफ़र out बहुत छोटा है [SWS_CRYPT_50048]।
  • CryptoErrc::kInvalidInputSize या CryptoErrc::kInvalidArgument: in का बफ़र आकार या सामग्री अमान्य है [SWS_CRYPT_50048]।
  • CryptoErrc::kUnsupported: सिंगल-कॉल प्रोसेसिंग या इनपुट IVs समर्थित नहीं हैं [SWS_CRYPT_50048]।
  • CryptoErrc::kBusyResource: एक आवश्यक संसाधन व्यस्त है [SWS_CRYPT_50048]।

यह टेक्स्ट AI द्वारा तैयार किया गया था और विनिर्देश तत्व के उपयोग में सहायता प्रदान करने के लिए कार्य करता है।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
inan input data buffer containing the ciphertext or plaintext
transformDirectionthe transformation direction, i.e., encryption or decryption
ivan input data buffer containing the initialization vector (IV) to be used by the context

Parameter (out)

ParameterBeschreibung
outan output data buffer that the encrypted or decrypted data is written to

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >a result containing the size of the output data or an error. The output data may be smaller than the size of the output buffer out.

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kUninitializedContextrollback_semantics if the context was not initialized by deploying a key
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if single-call en-/decryption is not supported, or if single-call processing with an input IV is not supported
ara::crypto::CryptoErrc::kInsufficientCapacityrollback_semantics if the data output buffer is too small
ara::crypto::CryptoErrc::kInvalidInputSizerollback_semantics if the size of the input buffer cannot be processed
ara::crypto::CryptoErrc::kInvalidArgumentrollback_semantics if the provided input data contains invalid data
ara::crypto::CryptoErrc::kBusyResourcerollback_semantics a required resource is busy
ara::crypto::CryptoErrc::kEmptyKeySlotrollback_semantics if a KeySlot was configured that is currently is empty
ara::crypto::CryptoErrc::kUsageViolationrollback_semantics if the allowed usage of the key does not include kAllowData Encryption for encryption, or kAllowDataDecryption for decryption, respectively
ara::crypto::CryptoErrc::kIncompatibleObjectrollback_semantics if type of the key is incompatible to the transformation or the transformation direction

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50048
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50048@rel:R25-11#54b4102a
Content hash
54b4102a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50048
Status: valid/unmigrated Version: rel:R25-11#06bfc8c8 Versionshistorie & Revisions (1 transition)
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_CRYPT_50048@rel:R25-11#06bfc8c8
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन Seek [SWS_CRYPT_23613] Upstream: RS_CRYPTO_02304

virtual ara::core::Result< void > Seek (std::int64_t offset, bool from Begin) noexcept=0;

Set the position of the next byte within the data stream.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 2287fbd40f75 उद्गम खुले प्रश्न (1)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

इंटरफ़ेस ara::crypto::cryp::SymmetricCipherCtx की मेथड Seek डेटा स्ट्रीम [SWS_CRYPT_23613] के भीतर संसाधित किए जाने वाले अगले बाइट की स्थिति सेट करती है। फ़्यूचर्स जैसे एसिंक्रोनस रिटर्न प्रकारों के अभाव में कॉल संभवतः सिंक्रोनस रूप से होता है। प्रश्न Q-fccf732722263f60 (खुला)

उपयोग

पोजिशनिंग को दो पैरामीटर्स [SWS_CRYPT_23613] के माध्यम से नियंत्रित किया जाता है:

  • offset: डेटा स्ट्रीम में बाइट ऑफ़सेट, जो या तो स्ट्रीम की शुरुआत या वर्तमान स्थिति से संबंधित है [SWS_CRYPT_23613]।
  • fromBegin: पोज़िशनिंग का संदर्भ बिंदु; true स्ट्रीम की शुरुआत से ऑफ़सेट को संबोधित करता है, false वर्तमान स्थिति के सापेक्ष [SWS_CRYPT_23613]।

फंक्शन को noexcept के रूप में घोषित किया गया है और यह एक ara::core::Result<void> लौटाता है, जो सफल निष्पादन का संकेत देता है या उत्पन्न एरर ऑब्जेक्ट रखता है [SWS_CRYPT_23613]।

समवर्तीता और प्रतिबंध

स्पेसिफिकेशन के अनुसार Seek को एक्सेप्शन-सुरक्षित (exception safe) और थ्रेड-सुरक्षित (thread-safe) के रूप में वर्गीकृत किया गया है [SWS_CRYPT_23613]। निष्पादन के लिए पूर्वशर्त यह है कि डेटा प्रोसेसिंग पहले Start() को कॉल करके शुरू की गई हो [SWS_CRYPT_23613]।

त्रुटि प्रबंधन

सभी एरर स्थितियाँ एक परिभाषित रोलबैक सिमेंटिक्स (rollback_semantics) के अधीन हैं, ताकि एरर आने पर आंतरिक स्थिति सुसंगत बनी रहे [SWS_CRYPT_23613]:

  • ara::crypto::CryptoErrc::kUnsupported: सीक ऑपरेशन वर्तमान क्रिप्टोग्राफ़िक संदर्भ द्वारा समर्थित नहीं है [SWS_CRYPT_23613]।
  • ara::crypto::CryptoErrc::kProcessingNotStarted: डेटा प्रोसेसिंग पहले Start() के माध्यम से शुरू नहीं की गई थी [SWS_CRYPT_23613]।
  • ara::crypto::CryptoErrc::kOutOfBounds: परिणामी ऑफ़सेट डेटा स्ट्रीम के लिए बहुत छोटा या बहुत बड़ा है [SWS_CRYPT_23613]।
  • ara::crypto::CryptoErrc::kInvalidArgument: परिणामी ऑफ़सेट ब्लॉक सीमा पर संरेखित नहीं है, भले ही संदर्भ ब्लॉक संरेखण की मांग करता हो [SWS_CRYPT_23613]।

यह पाठ AI द्वारा तैयार किया गया था।

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
offsetthe offset value in bytes, relative to begin or current position in the data stream
fromBeginthe starting point for positioning within the stream: from begin (if true) or from current position (if false)

Rückgabewert

TypBeschreibung
ara::core::Result< void >An empty result or an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if the seek operation is not supported by this context
ara::crypto::CryptoErrc::kProcessingNotStartedrollback_semantics if the data processing was not started by a call of the Start() method
ara::crypto::CryptoErrc::kOutOfBoundsrollback_semantics if the resulting offset value is too large or too small
ara::crypto::CryptoErrc::kInvalidArgumentrollback_semantics if the resulting offset is not block aligned but the context requires block alignment

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

Record
AUTOSAR/AP/record/SWS_CRYPT_23613
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_23613@rel:R25-11#8ed2ffcb
Content hash
8ed2ffcb
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_23613
Status: valid/unmigrated Version: rel:R25-11#383a800f 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_CRYPT_23613@rel:R25-11#383a800f
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#6a4153822026-09-30
  • R19-11rel:R19-11#9c63158a2026-10-14
  • R20-11rel:R20-11#36a48d2b2026-10-14
  • R21-11rel:R21-11#f3b5692c2026-10-14
  • R22-11rel:R22-11#a11f983a2026-10-14
  • R23-11rel:R23-11#10ff1b922026-10-14
  • R24-11rel:R24-11#23dbf8e42026-10-14
  • R25-11rel:R25-11#383a800f2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन SetKey [SWS_CRYPT_50043] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02003

virtual ara::core::Result< void > SetKey (KeySlot::Sptr keySlot) noexcept=0;

Configure the context to use the key stored in the provided KeySlot at the time the en-/decryption is started.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 72406ca015ea उद्गम खुले प्रश्न (1)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

प्योर वर्चुअल मेथड SetKey ara::crypto::cryp::SymmetricCipherCtx के इंस्टेंस को इस तरह कॉन्फ़िगर करती है कि वह भविष्य के क्रिप्टोग्राफ़िक ऑपरेशनों के लिए पास किए गए KeySlot से कुंजी का उपयोग करे [SWS_CRYPT_50043]।

उपयोग और कॉल संदर्भ

कॉल सिंक्रोनस रूप से होता है और पैरामीटर keySlot के रूप में एक KeySlot::Sptr स्वीकार करता है, जिसमें एक SymmetricKey होता है [SWS_CRYPT_50043]। रिटर्न मान एक ara::core::Result<void> होता है, जो सफलता का संकेत देता है या त्रुटि के मामले में एक एरर कोड भेजता है [SWS_CRYPT_50043]। कॉन्फ़िगरेशन का प्रभाव यह होता है कि स्लॉट में संग्रहीत कुंजी का उपयोग केवल उस समय किया जाता है जब वास्तविक एन्क्रिप्शन या डिक्रिप्शन प्रारंभ होता है [SWS_CRYPT_50043]।

त्रुटि प्रबंधन

त्रुटि की स्थिति में कोई अपवाद नहीं फेंका जाता है (मेथड noexcept और exception safe के रूप में निर्दिष्ट है), बल्कि रोलबैक सेमेंटिक्स के साथ एक एरर कोड लौटाया जाता है [SWS_CRYPT_50043]:

  • ara::crypto::CryptoErrc::kIncompatibleObject: पास किया गया KeySlot सिफ़र संदर्भ के साथ असंगत है [SWS_CRYPT_50043]।
  • ara::crypto::CryptoErrc::kUnsupported: संदर्भ कार्यान्वयन केवल एक प्रत्यक्ष कुंजी (जैसे SymmetricKey) सेट करने का समर्थन करता है और KeySlot के माध्यम से कोई असाइनमेंट नहीं करता है [SWS_CRYPT_50043]।

समवर्तीता और परस्पर क्रिया

मेथड को thread-safe निर्दिष्ट किया गया है [SWS_CRYPT_50043]। Interpretation: कुंजी सामग्री का वास्तविक पठन केवल एन्क्रिप्शन या डिक्रिप्शन शुरू होने पर ही होने की संभावना है, ताकि ट्रांसफ़ॉर्मेशन प्रारंभ होने तक स्लॉट सुसंगत बना रहे। प्रश्न Q-799125800ab0f93c (खुला) प्रत्यक्ष कुंजी ऑब्जेक्ट्स के बजाय KeySlot::Sptr के माध्यम से संदर्भों को कॉन्फ़िगर करने की अवधारणा संबंधित क्रिप्टो संदर्भों के एकीकृत पैटर्न से मेल खाती है, जिनमें KeyDerivationFunctionCtx [SWS_CRYPT_50010], MessageAuthnCodeCtx [SWS_CRYPT_50026], SymmetricKeyWrapperCtx [SWS_CRYPT_50034] और VerifierPublicCtx [SWS_CRYPT_50018] शामिल हैं।

यह पाठ AUTOSAR Adaptive R25-11 विनिर्देश के आधार पर एक AI द्वारा तैयार किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
keySlota keyslot containing a SymmetricKey.

Rückgabewert

TypBeschreibung
ara::core::Result< void >An empty result or an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kIncompatibleObjectrollback_semantics if the provided keyslot is incompatible with this context
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if the context only supports setting a SymmetricKey

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50043
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50043@rel:R25-11#59708871
Content hash
59708871
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50043
Status: valid/unmigrated Version: rel:R25-11#e7e7c9ab Versionshistorie & Revisions (1 transition)
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_CRYPT_50043@rel:R25-11#e7e7c9ab
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन SetKey [SWS_CRYPT_50138] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02003

virtual ara::core::Result< void > SetKey (SymmetricKey::Sptr key) noexcept=0;

Configure the context to use the provided symmetric key.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 7e5086bb8751 उद्गम
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग

विधि SetKey पास की गई सममित कुंजी के उपयोग के लिए ara::crypto::cryp::SymmetricCipherCtx के एक इंस्टेंस को कॉन्फ़िगर करने का कार्य करती है [SWS_CRYPT_50138]। इनपुट पैरामीटर के रूप में, फ़ंक्शन SymmetricKey::Sptr प्रकार के स्मार्ट पॉइंटर key के रूप में उपयोग की जाने वाली कुंजी को स्वीकार करता है। कॉल सिंक्रोनस रूप से होती है और एक ara::core::Result<void> लौटाती है, जो सफल असाइनमेंट पर खाली होती है या त्रुटि के मामले में एक त्रुटि कोड प्रदान करती है [SWS_CRYPT_50138]। घोषणा हेडर ara/crypto/cryp/symmetric_cipher_ctx.h के माध्यम से शामिल है।

त्रुटि प्रबंधन

त्रुटि प्रबंधन रोलबैक सिमेंटिक्स की गारंटी देता है, ताकि असाइनमेंट विफल होने की स्थिति में संदर्भ अपनी पिछली स्थिति में बना रहे [SWS_CRYPT_50138]। दो विशिष्ट त्रुटियां परिभाषित हैं:

  • ara::crypto::CryptoErrc::kUnsupported: तब होता है जब संदर्भ विशेष रूप से एक KeySlot के माध्यम से एक कुंजी के असाइनमेंट का समर्थन करता है [SWS_CRYPT_50138]।
  • ara::crypto::CryptoErrc::kIncompatibleObject: तब लौटाया जाता है जब पास किया गया कुंजी ऑब्जेक्ट संदर्भ के साथ संगत नहीं होता है [SWS_CRYPT_50138]।

समवर्तीता और परस्पर क्रिया

आभासी फ़ंक्शन को noexcept के रूप में परिभाषित किया गया है, इसे Exception-safe माना जाता है और विनिर्देश के अनुसार thread-safe निष्पादित किया गया है [SWS_CRYPT_50138]। SymmetricKey::Sptr के असाइनमेंट के लिए समान इंटरफ़ेस संबंधित क्रिप्टो संदर्भों जैसे AuthCipherCtx [SWS_CRYPT_23911] और साथ ही SymmetricKeyWrapperCtx [SWS_CRYPT_24018] में पाए जाते हैं। कुंजी कंटेनरों के साथ इंटरेक्शन को उन संदर्भ वर्गों द्वारा भी स्पष्ट किया जाता है जो वैकल्पिक रूप से KeySlot::Sptr स्वीकार करते हैं [SWS_CRYPT_50034]।

यह उपयोग निर्देश AUTOSAR विनिर्देश R25-11 के आधार पर स्वचालित रूप से जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
keythe SymmetricKey to be used.

Rückgabewert

TypBeschreibung
ara::core::Result< void >An empty result or an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if the context only supports setting a KeySlot
ara::crypto::CryptoErrc::kIncompatibleObjectrollback_semantics if the provided key object is incompatible with this context

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50138
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50138@rel:R25-11#a44ff261
Content hash
a44ff261
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50138
Status: valid/unmigrated Version: rel:R25-11#aa2f4130 Versionshistorie & Revisions (1 transition)
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_CRYPT_50138@rel:R25-11#aa2f4130
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन Start [SWS_CRYPT_23625] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< void > Start (CryptoTransform transform Direction, ReadOnlyMemRegion iv) noexcept=0;

Initialize the context for a new encryption or decryption and set the IV used by the context.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 33beff56357b उद्गम
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग

मेथड Start एक नए सिंक्रोनस एन्क्रिप्शन या डिक्रिप्शन ऑपरेशन के लिए संदर्भ ara::crypto::cryp::SymmetricCipherCtx को इनिशियलाइज़ करती है और संबंधित इनिशियलाइज़ेशन वेक्टर (IV) या नॉनस मान [SWS_CRYPT_23625] सेट करती है। पैरामीटर transformDirection के माध्यम से रूपांतरण दिशा निर्धारित की जाती है, जबकि iv इनिशियलाइज़ेशन वेक्टर को ReadOnlyMemRegion [SWS_CRYPT_23625] के रूप में प्रदान करता है। बफ़र का अनुमेय आकार पहले से ही मेथड्स GetMinimumInputIvSize() और GetMaximumInputIvSize() [SWS_CRYPT_23625] के माध्यम से प्राप्त किया जा सकता है। कॉल एक ara::core::Result<void> लौटाता है, इसे noexcept के रूप में घोषित किया गया है और यह एक्सेप्शन-सुरक्षित (exception safe) माना जाता है [SWS_CRYPT_23625]।

त्रुटि प्रबंधन

त्रुटि की स्थिति में, रोलबैक सिमेंटिक्स के साथ एक त्रुटि कोड लौटाया जाता है [SWS_CRYPT_23625]:

  • ara::crypto::CryptoErrc::kUninitializedContext: संदर्भ को पहले किसी की के असाइनमेंट द्वारा इनिशियलाइज़ नहीं किया गया था [SWS_CRYPT_23625]।
  • ara::crypto::CryptoErrc::kInvalidInputSize: पास किया गया IV आकार समर्थित नहीं है [SWS_CRYPT_23625]।
  • ara::crypto::CryptoErrc::kUnsupported: निर्दिष्ट रूपांतरण दिशा में IV सेट करना या स्ट्रीम प्रोसेसिंग संदर्भ द्वारा समर्थित नहीं है [SWS_CRYPT_23625]।
  • ara::crypto::CryptoErrc::kEmptyKeySlot: एक कॉन्फ़िगर किया गया KeySlot वर्तमान में खाली है [SWS_CRYPT_23625]।
  • ara::crypto::CryptoErrc::kUsageViolation: अनुमेय की उपयोग में एन्क्रिप्शन के लिए kAllowDataEncryption या डिक्रिप्शन के लिए kAllowDataDecryption शामिल नहीं है [SWS_CRYPT_23625]।
  • ara::crypto::CryptoErrc::kIncompatibleObject: की प्रकार रूपांतरण या रूपांतरण दिशा के साथ असंगत है [SWS_CRYPT_23625]।
  • ara::crypto::CryptoErrc::kBusyResource: एक आवश्यक संसाधन व्यस्त है [SWS_CRYPT_23625]।

समवर्तीता और परस्पर क्रिया

फंक्शन को थ्रेड-सुरक्षित (thread-safe) के रूप में निर्दिष्ट किया गया है [SWS_CRYPT_23625]। स्ट्रीम प्रोसेसिंग के प्रवाह में, Start एक आरंभिक चरण के रूप में कार्य करता है, जिसके बाद उदाहरण के लिए Seek [SWS_CRYPT_23613] के माध्यम से पोज़िशनिंग ऑपरेशन्स या FinishEncrypt [SWS_CRYPT_23618] के माध्यम से अंतिम रूप देना शामिल है।

यह पाठ AUTOSAR विनिर्देश R25-11 के आधार पर एक AI प्रणाली द्वारा तैयार किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
transformDirectionthe transformation direction, i.e., encryption or decryption
ivan Initialization Vector (IV) or "nonce" value. The allowed size of the IV can be queried using the functions GetMinimumInputIvSize() and GetMaximumInputIvSize().

Rückgabewert

TypBeschreibung
ara::core::Result< void >An empty result or an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kUninitializedContextrollback_semantics if the context was not initialized by deploying a key
ara::crypto::CryptoErrc::kInvalidInputSizerollback_semantics if the size of provided IV is not supported
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if the context does not support setting an IV in the given transform Direction or if stream processing is not supported by the context
ara::crypto::CryptoErrc::kBusyResourcerollback_semantics a required resource is busy
ara::crypto::CryptoErrc::kEmptyKeySlotrollback_semantics if a KeySlot was configured that is currently is empty
ara::crypto::CryptoErrc::kUsageViolationrollback_semantics if the allowed usage of the key does not include kAllowData Encryption for encryption, or kAllowDataDecryption for decryption, respectively
ara::crypto::CryptoErrc::kIncompatibleObjectrollback_semantics if type of the key is incompatible to the transformation or the transformation direction

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

Record
AUTOSAR/AP/record/SWS_CRYPT_23625
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_23625@rel:R25-11#c9270ff4
Content hash
c9270ff4
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_23625
Status: valid/unmigrated Version: rel:R25-11#608e87fd 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_CRYPT_23625@rel:R25-11#608e87fd
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#a536a6ca2026-09-30
  • R20-11rel:R20-11#6996665a2026-10-14
  • R21-11rel:R21-11#c2b5cf1e2026-10-14
  • R22-11rel:R22-11#25b4dab42026-10-14
  • R23-11rel:R23-11#e01d837d2026-10-14
  • R24-11rel:R24-11#26e85c6c2026-10-14
  • R25-11rel:R25-11#608e87fd2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन Start [SWS_CRYPT_50044] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< void > Start (CryptoTransform transform Direction) noexcept=0;

Initialize the context for a new encryption or decryption. An IV is either not required for this context in this transformation direction, or set by the context itself.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 09affb4844e4 उद्गम
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग

विधि Start आगामी एन्क्रिप्शन या डिक्रिप्शन ([SWS_CRYPT_50044]) के लिए ara::crypto::cryp::SymmetricCipherCtx के एक इंस्टेंस को समकालिक रूप से इनिशियलाइज़ करती है। इसका उपयोग तब किया जाता है जब पैरामीटर transformDirection के माध्यम से निर्दिष्ट रूपांतरण दिशा के लिए किसी इनिशियलाइज़ेशन वेक्टर (IV) की आवश्यकता नहीं होती है या संदर्भ इसे स्वयं उत्पन्न करता है ([SWS_CRYPT_50044])। इसके विपरीत, यदि संदर्भ को चुनी गई दिशा में एक स्पष्ट IV की आवश्यकता होती है, तो IV पैरामीटर वाले ओवरलोड को कॉल किया जाना चाहिए ([SWS_CRYPT_23625])।

त्रुटि हैंडलिंग और समवर्तीता

ऑपरेशन को थ्रेड-सुरक्षित और अपवाद-सुरक्षित निर्दिष्ट किया गया है ([SWS_CRYPT_50044])। किसी त्रुटि की स्थिति में, फ़ंक्शन रोलबैक सेमांटिक्स के साथ एक ara::core::Result<void> लौटाता है ([SWS_CRYPT_50044])। प्रासंगिक त्रुटि कारण हैं:

  • ara::crypto::CryptoErrc::kUninitializedContext: संदर्भ को पहले से कोई की असाइन नहीं की गई थी ([SWS_CRYPT_50044])।
  • ara::crypto::CryptoErrc::kUnsupported: स्ट्रीम प्रोसेसिंग समर्थित नहीं है या ऑपरेशन के लिए इस दिशा में अनिवार्य रूप से एक IV सेट करने की आवश्यकता है ([SWS_CRYPT_50044])।
  • ara::crypto::CryptoErrc::kUsageViolation: कुंजी के पास आवश्यक अनुमति kAllowDataEncryption या kAllowDataDecryption नहीं है ([SWS_CRYPT_50044])।
  • ara::crypto::CryptoErrc::kIncompatibleObject या ara::crypto::CryptoErrc::kEmptyKeySlot: कुंजी प्रकार रूपांतरण से मेल नहीं खाता है या कॉन्फ़िगर किया गया कुंजी स्थान खाली है ([SWS_CRYPT_50044])।
  • ara::crypto::CryptoErrc::kBusyResource: एक आवश्यक संसाधन वर्तमान में व्यस्त है ([SWS_CRYPT_50044])।

इंटरैक्शन

सफल इनिशियलाइज़ेशन के बाद, यदि आवश्यक हो तो डेटा स्ट्रीम को Seek ([SWS_CRYPT_23613]) के माध्यम से स्थित किया जा सकता है। यदि IV संदर्भ द्वारा ही निर्धारित किया गया था, तो एन्क्रिप्शन के अंत में इसे FinishEncrypt के माध्यम से कॉलर को पास कर दिया जाता है ([SWS_CRYPT_23618])।

यह उपयोग नोट AUTOSAR विनिर्देश R25-11 के आधार पर स्वचालित रूप से तैयार किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
transformDirectionthe transformation direction, i.e., encryption or decryption

Rückgabewert

TypBeschreibung
ara::core::Result< void >An empty result or an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kUninitializedContextrollback_semantics if the context was not initialized by deploying a key
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if the context requires setting an IV in the given transformDirection or if stream processing is not supported by the context
ara::crypto::CryptoErrc::kBusyResourcerollback_semantics a required resource is busy
ara::crypto::CryptoErrc::kEmptyKeySlotrollback_semantics if a KeySlot was configured that is currently is empty
ara::crypto::CryptoErrc::kUsageViolationrollback_semantics if the allowed usage of the key does not include kAllowData Encryption for encryption, or kAllowDataDecryption for decryption, respectively
ara::crypto::CryptoErrc::kIncompatibleObjectrollback_semantics if type of the key is incompatible to the transformation or the transformation direction

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50044
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50044@rel:R25-11#2b15750e
Content hash
2b15750e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50044
Status: valid/unmigrated Version: rel:R25-11#842f896d Versionshistorie & Revisions (1 transition)
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_CRYPT_50044@rel:R25-11#842f896d
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन Update [SWS_CRYPT_50139] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< std::size_t > Update (ReadOnlyMemRegion in, ReadWriteMemRegion out) noexcept=0;

Encrypt or decrypt a data buffer.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 5cb4a9bba31d उद्गम
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

ara::crypto::cryp::SymmetricCipherCtx में समकालिक विधि Update() का उपयोग आंशिक डेटा स्ट्रीम्स को चरणबद्ध तरीके से एन्क्रिप्ट या डिक्रिप्ट करने के लिए किया जाता है [SWS_CRYPT_50139]। यह प्लेनटेक्स्ट या सिफ़रटेक्स्ट वाले एक इनपुट बफ़र in (प्रकार ReadOnlyMemRegion) को संसाधित करती है और रूपांतरित डेटा को आउटपुट बफ़र out (प्रकार ReadWriteMemRegion) में लिखती है [SWS_CRYPT_50139]। सफलता की स्थिति में रिटर्न मान ara::core::Result<std::size_t> वास्तव में out में लिखे गए बाइट्स की सटीक संख्या प्रदान करता है, जो लक्ष्य बफ़र की कुल क्षमता से कम हो सकती है [SWS_CRYPT_50139]।

कॉल के लिए निर्धारित पूर्व-शर्तें और बफ़र नियम लागू होते हैं:

  • निष्पादन क्रम: डेटा प्रोसेसिंग को अनिवार्य रूप से पहले मेथड Start() के साथ शुरू किया गया होना चाहिए; अन्यथा कॉल ara::crypto::CryptoErrc::kProcessingNotStarted के साथ विफल हो जाती है [SWS_CRYPT_50139]।
  • बफ़र आयाम (Buffer dimensioning): प्रति एकल कॉल अनुमत अधिकतम इनपुट आकार GetMaximumChunkSize() के माध्यम से निर्धारित किया जा सकता है [SWS_CRYPT_50050]; अमान्य बफ़र आकारों की स्थिति में मेथड ara::crypto::CryptoErrc::kInvalidInputSize लौटाती है [SWS_CRYPT_50139]। आवश्यक आउटपुट बफ़र को GetRequiredOutputBufferSize() के माध्यम से क्वेरी किया जा सकता है [SWS_CRYPT_50139]; बहुत छोटा बफ़र ara::crypto::CryptoErrc::kInsufficientCapacity की ओर ले जाता है [SWS_CRYPT_50139]।
  • स्ट्रीमिंग समर्थन: यदि विशिष्ट संदर्भ निरंतर स्ट्रीम प्रोसेसिंग का समर्थन नहीं करता है, तो कॉल ara::crypto::CryptoErrc::kUnsupported के साथ विफल हो जाती है [SWS_CRYPT_50139]।

इंटरफ़ेस को thread-safe और exception safe के रूप में निर्दिष्ट किया गया है और यह प्रत्येक त्रुटि पर रोलबैक सिमेंटिक्स की गारंटी देता है [SWS_CRYPT_50139]। प्रोसेसिंग चक्र में, यह GetMaximumChunkSize() के साथ-साथ Finish() या FinishEncrypt() जैसे समापन ऑपरेशनों के साथ इंटरैक्ट करता है [SWS_CRYPT_50050]।

यह उपयोग संबंधी निर्देश AUTOSAR विनिर्देश R25-11 के आधार पर स्वचालित रूप से जनरेट किया गया था।

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
inan input data buffer containing a part of the ciphertext or plaintext

Parameter (out)

ParameterBeschreibung
outan output data buffer that the encrypted or decrypted data will be written into. The required size of this buffer can be queried using GetRequiredOutputBufferSize()

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >a result containing the size of the output data or an error. The output data may be smaller than the size of the output buffer out.

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kProcessingNotStartedrollback_semantics if data processing was not started by a call of the Start() method
ara::crypto::CryptoErrc::kInsufficientCapacityrollback_semantics if the output buffer is too small
ara::crypto::CryptoErrc::kInvalidInputSizerollback_semantics if the size of the input buffer is invalid
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if stream processing is not supported by the context

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50139
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50139@rel:R25-11#222b0b33
Content hash
222b0b33
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50139
Status: valid/unmigrated Version: rel:R25-11#50161066 Versionshistorie & Revisions (1 transition)
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_CRYPT_50139@rel:R25-11#50161066
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

टाइप उपनामों का प्रलेखन

टाइप उपनाम Sptr [SWS_CRYPT_50137] Upstream: RS_CRYPTO_02201

using Sptr = std::shared_ptr<SymmetricCipherCtx>;

Smart pointer of the interface.

Header-Datei#include "ara/crypto/cryp/symmetric_cipher_ctx.h"
Scopeclass ara::crypto::cryp::SymmetricCipherCtx
SymbolSptr

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50137
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50137@rel:R25-11#f0a83622
Content hash
f0a83622
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50137
Status: valid/unmigrated Version: rel:R25-11#61315479 Versionshistorie & Revisions (1 transition)
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_CRYPT_50137@rel:R25-11#61315479
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill