nl::Weave::Profiles::SoftwareUpdate

इस नेमस्पेस में Weave Software Update प्रोफ़ाइल के लिए Weave के सभी इंटरफ़ेस शामिल हैं, जिनमें संबंधित नाम का प्रोटोकॉल शामिल है.

खास जानकारी

गिनती
@309{
  kMsgType_ImageAnnounce = 0,
  kMsgType_ImageQuery = 1,
  kMsgType_ImageQueryResponse = 2,
  kMsgType_DownloadNotify = 3,
  kMsgType_NotifyResponse = 4,
  kMsgType_UpdateNotify = 5,
  kMsgType_ImageQueryStatus = 6
} 		enum
SoftwareUpdate मैसेज के टाइप.
@310{
  kStatus_NoUpdateAvailable = 0x0001,
  kStatus_UpdateFailed = 0x0010,
  kStatus_InvalidInstructions = 0x0050,
  kStatus_DownloadFailed = 0x0051,
  kStatus_IntegrityCheckFailed = 0x0052,
  kStatus_Abort = 0x0053,
  kStatus_Retry = 0x0091
} 		enum
@311{
  kFlag_PackageSpecPresent = 1,
  kFlag_LocaleSpecPresent = 2,
  kFlag_TargetNodeIdPresent = 4
} 		enum
ImageQuery फ़्रेम के कंट्रोल फ़ील्ड के लिए फ़्लैग को कंट्रोल करें.
@312 enum
ImageQueryResponse के अपडेट के विकल्प वाले फ़ील्ड के लिए बिटमास्क.
@313 enum
ImageQueryResponse के अपडेट के विकल्प वाले फ़ील्ड के लिए Shift ऑफ़सेट.
@314{
  kIntegrityType_SHA160 = 0,
  kIntegrityType_SHA256 = 1,
  kIntegrityType_SHA512 = 2,
  kIntegrityType_Last = 3
} 		enum
@315 enum
इंटिग्रिटी स्पेसिफ़िकेशन बाइट-स्ट्रिंग के लिए, लंबाई बाइट में.
@316{
  kUpdateScheme_HTTP = 0,
  kUpdateScheme_HTTPS = 1,
  kUpdateScheme_SFTP = 2,
  kUpdateScheme_BDX = 3,
  kUpdateScheme_Last = 4
} 		enum
@317 enum
SoftwareUpdate प्रोफ़ाइल के लिए डेटा एलिमेंट टैग.
UpdateCondition{
  IfUnmatched,
  IfLater,
  Unconditionally,
  OnOptIn
} 		enum
अपडेट की नीति को कंट्रोल करने वाली शर्तें.
UpdatePriority{
  Normal,
  Critical
} 		enum
प्राथमिकताएं अपडेट करें.

फ़ंक्शन
integrityLength(uint8_t aType)
int
IntegrityTypes की वैल्यू को उस टाइप के हैश की लंबाई पर मैप करने के लिए, सहायता का तरीका.

क्लास
nl::Weave::Profiles::SoftwareUpdate::IWeaveImageAnnounceServerDelegate

WeaveImageAnnounceServer डेलिगेट के लिए इंटरफ़ेस.

nl::Weave::Profiles::SoftwareUpdate::ImageAnnounce

ImageAnnounce मैसेज की जानकारी देने वाली क्लास.

nl::Weave::Profiles::SoftwareUpdate::ImageQuery

इमेज क्वेरी के मैसेज बनाने और उन्हें डिकोड करने में मदद करने वाला क्लास.

nl::Weave::Profiles::SoftwareUpdate::ImageQueryResponse

इमेज क्वेरी के जवाब वाले मैसेज बनाने और डिकोड करने में मदद करने वाली क्लास.

nl::Weave::Profiles::SoftwareUpdate::IntegritySpec

एक सहायक क्लास, जिसके पास इंटिग्रिटी टाइप और सॉफ़्टवेयर अपडेट इमेज का असली हैश है.

nl::Weave::Profiles::SoftwareUpdate::IntegrityTypeList

इमेज क्वेरी के हिस्से के तौर पर इंटिग्रिटी टाइप की सूची रखने के लिए, सहायक क्लास.

nl::Weave::Profiles::SoftwareUpdate::ProductSpec

एक सहायक क्लास जो किसी प्रॉडक्ट की खास बातों को दिखाती है.

nl::Weave::Profiles::SoftwareUpdate::UpdateSchemeList

इमेज क्वेरी के हिस्से के रूप में अपडेट स्कीम की सूची होल्ड करने के लिए सहायक क्लास.

nl::Weave::Profiles::SoftwareUpdate::WeaveImageAnnounceServer

सर्वर जो Weave इमेज की घोषणाएं सुनता है.

गिनती

@309

 @309

SoftwareUpdate मैसेज के टाइप.

प्रॉपर्टी
kMsgType_DownloadNotify

क्लाइंट की ओर से सर्वर को भेजा जाने वाला एक वैकल्पिक मैसेज, जिसका इस्तेमाल सर्वर को डाउनलोड स्थिति के बारे में बताने के लिए किया जाता है.

इसका पेलोड एक nl::Weave::Profiles::StatusReporting::StatusReport है. इस जानकारी के साथ, SoftwareUpdateStatusCodes से मिली स्थिति की जानकारी मिलती है.

kMsgType_ImageAnnounce

एक वैकल्पिक अनचाहे मैसेज, जिसका इस्तेमाल सर्वर सॉफ़्टवेयर अपडेट की उपलब्धता के बारे में बताने के लिए करता है.

इस मैसेज में कोई पेलोड नहीं है.

kMsgType_ImageQuery

क्लाइंट से सर्वर को भेजा गया क्वेरी मैसेज.

इसका फ़ॉर्मैट ImageQuery क्लास से तय किया जाता है.

kMsgType_ImageQueryResponse

इमेज के लिए की गई क्वेरी के मैसेज के जवाब में जनरेट किया गया मैसेज.

इसका फ़ॉर्मैट ImageQueryResponse क्लास से तय होता है.

kMsgType_ImageQueryStatus

ऐसी इमेज क्वेरी के मैसेज के जवाब में जनरेट किया गया मैसेज जो इमेज लोड नहीं हो सकी.

इसका पेलोड एक nl::Weave::Profiles::StatusReporting::StatusReport है. इस जानकारी के साथ, SoftwareUpdateStatusCodes से मिली स्थिति की जानकारी मिलती है.

kMsgType_NotifyResponse

डाउनलोड की सूचना वाले मैसेज के जवाब में जनरेट हुआ एक मैसेज.

इसका पेलोड एक nl::Weave::Profiles::StatusReporting::StatusReport है. इस जानकारी के साथ, SoftwareUpdateStatusCodes से मिली स्थिति की जानकारी मिलती है.

kMsgType_UpdateNotify

क्लाइंट की तरफ़ से सर्वर को भेजा जाने वाला एक वैकल्पिक मैसेज, जिसका इस्तेमाल अपडेट की आखिरी स्थिति बताने के लिए किया जाता है.

इसका पेलोड एक nl::Weave::Profiles::StatusReporting::StatusReport है. इस जानकारी के साथ, SoftwareUpdateStatusCodes से मिली स्थिति की जानकारी मिलती है. इस मैसेज को असल अपडेट के बाद जनरेट किया जाना चाहिए. इसलिए, इसे नए ExchangeContext पर भेजा जाता है और इसे सर्वर पर, अनचाहे मैसेज के तौर पर माना जाता है.

@310

 @310

SoftwareUpdate प्रोफ़ाइल के लिए खास स्टेटस कोड.

प्रॉपर्टी
kStatus_Abort

सर्वर => क्लाइंट है, यह बताता है कि क्लाइंट को छोड़ देना चाहिए, क्योंकि सर्वर में विकल्प नहीं हैं.

kStatus_DownloadFailed

Client => सर्वर से पता चलता है कि कोई डाउनलोड नहीं किया जा सका.

kStatus_IntegrityCheckFailed

client => सर्वर से पता चलता है कि एक इमेज डाउनलोड की गई थी, लेकिन यह बाद में पूरी सुरक्षा की जांच में असफल हो गई.

kStatus_InvalidInstructions

Client => सर्वर से पता चलता है कि क्लाइंट किसी इमेज को डाउनलोड नहीं कर सका, क्योंकि ImageQueryResponse में डाउनलोड निर्देश, यानी कि

यूआरआई, अपडेट स्कीम, अपडेट की स्थिति, खराब तरीके से बनाई गई थी या अलग-अलग थी.

kStatus_NoUpdateAvailable

सर्वर => क्लाइंट से पता चलता है कि एक इमेज क्वेरी मिल गई है और उसे समझ लिया गया है और फ़िलहाल सर्वर के पास क्लाइंट के लिए कोई अपडेट नहीं है.

kStatus_Retry

सर्वर => क्लाइंट है, यह बताता है कि क्लाइंट को कोई दूसरी इमेज क्वेरी सबमिट करनी चाहिए और अपडेट को रीस्टार्ट करना/जारी रखना चाहिए

kStatus_UpdateFailed

Client => सर्वर, दिखाता है कि सर्वर से तय की गई इमेज को इंस्टॉल करने की कोशिश नाकाम हो गई है.

@311

 @311

ImageQuery फ़्रेम के कंट्रोल फ़ील्ड के लिए फ़्लैग को कंट्रोल करें.

प्रॉपर्टी
kFlag_LocaleSpecPresent

ImageQuery में Locale के बारे में खास जानकारी मौजूद है.

kFlag_PackageSpecPresent

ImageQuery में पैकेज की खास जानकारी मौजूद है.

kFlag_TargetNodeIdPresent

ImageQuery में टारगेट नोड आईडी मौजूद है.

@312

 @312

ImageQueryResponse के अपडेट के विकल्प वाले फ़ील्ड के लिए बिटमास्क.

@313

 @313

ImageQueryResponse के अपडेट के विकल्प वाले फ़ील्ड के लिए Shift ऑफ़सेट.

@314

 @314

SoftwareUpdate प्रोफ़ाइल के साथ काम करने वाले इंटिग्रिटी टाइप.

इमेज क्वेरी फ़्रेम में वह जानकारी होती है जिसकी जानकारी क्लाइंट से मिलती है. साथ ही, इमेज क्वेरी के जवाब में उस इमेज का इंटिग्रिटी टाइप और वैल्यू शामिल होती है जिसे क्लाइंट को डाउनलोड और इंस्टॉल करने का निर्देश दिया जा रहा है. काम करने वाले इस तरह के टाइप हैं:

प्रॉपर्टी
kIntegrityType_Last

गिनती में मान्य एलिमेंट की संख्या.

kIntegrityType_SHA160

160-बिट सुरक्षित हैश, (SHA-1), ज़रूरी है.

kIntegrityType_SHA256

256-बिट सुरक्षित हैश (SHA-2).

kIntegrityType_SHA512

512-बिट, सुरक्षित हैश (SHA-2).

@315

 @315

इंटिग्रिटी स्पेसिफ़िकेशन बाइट-स्ट्रिंग के लिए, लंबाई बाइट में.

@316

 @316

SofwareUpdate प्रोफ़ाइल के साथ काम करने वाली स्कीम अपडेट करें.

साथ काम करने वाले इंटिग्रिटी टाइप की ही तरह, इमेज क्वेरी में यह जानकारी होती है कि कौनसी अपडेट स्कीम हैं.जैसे, डाउनलोड प्रोटोकॉल, क्लाइंट जो सपोर्ट करता है. साथ ही, रिस्पॉन्स में एक वैल्यू शामिल होती है, जिसमें इमेज डाउनलोड करने के लिए अपडेट स्कीम के बारे में बताया जाता है. काम करने वाली स्कीम, ये हैं:

प्रॉपर्टी
kUpdateScheme_BDX

Weave बल्क डेटा ट्रांसफ़र का इस्तेमाल, डाउनलोड प्रोटोकॉल के तौर पर किया जाएगा.

kUpdateScheme_HTTP

एचटीटीपी का इस्तेमाल डाउनलोड प्रोटोकॉल के तौर पर किया जाएगा.

kUpdateScheme_HTTPS

एचटीटीपीएस का इस्तेमाल डाउनलोड प्रोटोकॉल के तौर पर किया जाएगा.

kUpdateScheme_Last

गिनती में मान्य एलिमेंट की संख्या.

kUpdateScheme_SFTP

एसएफ़टीपी का इस्तेमाल डाउनलोड प्रोटोकॉल के तौर पर किया जाएगा.

@317

 @317

SoftwareUpdate प्रोफ़ाइल के लिए डेटा एलिमेंट टैग.

UpdateCondition

 UpdateCondition

अपडेट की नीति को कंट्रोल करने वाली शर्तें.

प्रॉपर्टी
IfLater

अगर रिस्पॉन्स फ़्रेम में दिया गया वर्शन स्पेसिफ़िकेशन, इंस्टॉल किए गए सॉफ़्टवेयर वर्शन के बाद का है, तो इमेज को डाउनलोड और इंस्टॉल करें.

IfUnmatched

अगर रिस्पॉन्स फ़्रेम में मौजूद वर्शन की जानकारी, मौजूदा समय में इंस्टॉल किए गए सॉफ़्टवेयर के वर्शन से मेल नहीं खाती है, तो इमेज को डाउनलोड और इंस्टॉल करें.

OnOptIn

ऑन-साइट उपयोगकर्ता से मिले कुछ ट्रिगर पर इमेज को डाउनलोड और इंस्टॉल करें.

Unconditionally

इमेज को डाउनलोड और इंस्टॉल करें, भले ही अभी चल रहे सॉफ़्टवेयर का कोई भी वर्शन हो.

UpdatePriority

 UpdatePriority

प्राथमिकताएं अपडेट करें.

प्रॉपर्टी
Critical

अपडेट तुरंत लागू किया जाना चाहिए.

Normal

अपडेट, क्लाइंट के विवेक पर लागू किए जा सकते हैं.

फ़ंक्शन

integrityLength

int integrityLength(
  uint8_t aType
)

IntegrityTypes की वैल्यू को उस टाइप के हैश की लंबाई पर मैप करने के लिए, सहायता का तरीका.

जानकारी
पैरामीटर
[in] aType
IntegrityTypes वैल्यू
लौटाए गए सामान
दिए गए हैश टाइप के हैश की लंबाई.