nl::Weave::Profiles::SoftwareUpdate

Bu ad alanı, Weave Software Update profili için Weave içindeki tüm arayüzleri ve aynı ada sahip ilgili protokolü içerir.

Özet

Sıralamalar
@309{
  kMsgType_ImageAnnounce = 0,
  kMsgType_ImageQuery = 1,
  kMsgType_ImageQueryResponse = 2,
  kMsgType_DownloadNotify = 3,
  kMsgType_NotifyResponse = 4,
  kMsgType_UpdateNotify = 5,
  kMsgType_ImageQueryStatus = 6
} 		enum
SoftwareUpdate Mesaj türleri.
@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 çerçevesinin kontrol alanı için kontrol işaretleri.
@312 enum
ImageQueryResponse'un isteğe bağlı güncelleme seçenekleri alanı için bit maskeleri.
@313 enum
ImageQueryResponse'un isteğe bağlı güncelleme seçenekleri alanı için kaydırma ofsetleri.
@314{
  kIntegrityType_SHA160 = 0,
  kIntegrityType_SHA256 = 1,
  kIntegrityType_SHA512 = 2,
  kIntegrityType_Last = 3
} 		enum
@315 enum
Bütünlük spesifikasyonu bayt dizeleri için bayt cinsinden uzunluklar.
@316{
  kUpdateScheme_HTTP = 0,
  kUpdateScheme_HTTPS = 1,
  kUpdateScheme_SFTP = 2,
  kUpdateScheme_BDX = 3,
  kUpdateScheme_Last = 4
} 		enum
@317 enum
SoftwareUpdate Profili için Veri Öğesi Etiketleri.
UpdateCondition{
  IfUnmatched,
  IfLater,
  Unconditionally,
  OnOptIn
} 		enum
Güncelleme politikasını düzenleyen koşullar.
UpdatePriority{
  Normal,
  Critical
} 		enum
Öncelikleri güncelleyin.

İşlevler
integrityLength(uint8_t aType)
int
IntegrityTypes değerlerini, bu türdeki karmaların uzunluklarına eşleyen bir destek yöntemi.

Sınıflar
nl::Weave::Profiles::SoftwareUpdate::IWeaveImageAnnounceServerDelegate

WeaveImageAnnounceServer yetki verilmiş kullanıcı arayüzü.

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

ImageAnnounce mesajını açıklayan sınıf.

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

Resim sorgu mesajlarının oluşturulmasını ve kodunu çözmeyi destekleyen bir sınıf.

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

Resim sorgusu yanıt mesajlarının oluşturulmasını ve kodunun çözülmesini destekleyen bir sınıf.

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

Bütünlük türünü ve yazılım güncelleme görüntüsünün gerçek karmasını içeren bir yardımcı sınıf.

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

Resim sorgusunun parçası olarak bütünlük türlerinin listesini tutan yardımcı bir sınıf.

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

Ürün spesifikasyonunu temsil eden yardımcı sınıf.

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

Resim sorgusunun bir parçası olarak güncelleme şemalarının listesini barındıran yardımcı bir sınıf.

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

Weave resim duyurularını dinleyen sunucu.

Sıralamalar

@309

 @309

SoftwareUpdate Mesaj türleri.

Özellikler
kMsgType_DownloadNotify

İstemciden sunucuya gönderilen ve sunucuyu indirme durumu hakkında bilgilendirmek için kullanılan isteğe bağlı bir ileti.

Yükü nl::Weave::Profiles::StatusReporting::StatusReport ve ek durum bilgileri SoftwareUpdateStatusCodes şeklindedir.

kMsgType_ImageAnnounce

Bir yazılım güncellemesinin kullanıma sunulduğunu duyurmak için sunucu tarafından kullanılan isteğe bağlı istenmeyen mesaj.

İletide yük taşımaz.

kMsgType_ImageQuery

İstemci tarafından sunucuya gönderilen sorgu mesajı.

Biçimi, ImageQuery sınıfıyla tanımlanır.

kMsgType_ImageQueryResponse

Başarılı bir resim sorgusu mesajına yanıt olarak oluşturulan bir mesaj.

Biçimi, ImageQueryResponse sınıfı tarafından tanımlanır.

kMsgType_ImageQueryStatus

Başarısız bir görsel sorgu mesajına yanıt olarak oluşturulan mesaj.

Yükü nl::Weave::Profiles::StatusReporting::StatusReport ve ek durum bilgileri SoftwareUpdateStatusCodes şeklindedir.

kMsgType_NotifyResponse

İndirme bildirimi iletisine yanıt olarak bir ileti oluşturuldu.

Yükü nl::Weave::Profiles::StatusReporting::StatusReport ve ek durum bilgileri SoftwareUpdateStatusCodes şeklindedir.

kMsgType_UpdateNotify

Güncellemenin nihai durumunu bildirmek için istemciden sunucuya gönderilen isteğe bağlı bir mesajdır.

Yükü nl::Weave::Profiles::StatusReporting::StatusReport ve ek durum bilgileri SoftwareUpdateStatusCodes şeklindedir. İleti, gerçek güncelleme sonrasında oluşturulması beklendiğinden, yeni bir ExchangeContext üzerinde gönderilir ve sunucuda istenmeyen bir ileti olarak ele alınır.

@310

 @310

SoftwareUpdate profiline özgü durum kodları.

Özellikler
kStatus_Abort

server => client, sunucu seçeneklerde kalmadığı için istemcinin vazgeçmesi gerektiğini belirtir.

kStatus_DownloadFailed

client => server (sunucu), indirme girişiminin başarısız olduğunu belirtir.

kStatus_IntegrityCheckFailed

client => sunucu, bir görüntünün indirildiğini ancak sonraki bütünlük denetiminde başarısız olduğunu belirtir.

kStatus_InvalidInstructions

client => sunucu, ImageQueryResponse içinde yer alan indirme talimatları nedeniyle (yani

URI, güncelleme şeması, güncelleme koşulu, kötü biçime sahip veya tutarsız.

kStatus_NoUpdateAvailable

sunucu => istemcisi, bir resim sorgusunun alındığını, anlaşıldığını ve sunucunun şu anda istemci için herhangi bir güncellemesi olmadığını belirtir.

kStatus_Retry

server => client, istemcinin başka bir resim sorgusu göndermesi ve güncellemeyi yeniden başlatması/devam etmesi gerektiğini belirtir

kStatus_UpdateFailed

client => sunucu, sunucu tarafından belirtilen bir görüntüyü yükleme girişiminin başarısız olduğunu belirtir.

@311

 @311

ImageQuery çerçevesinin kontrol alanı için kontrol işaretleri.

Özellikler
kFlag_LocaleSpecPresent

Locale (Yerel Ayar) spesifikasyonu ImageQuery'de mevcuttur.

kFlag_PackageSpecPresent

Paket spesifikasyonu ImageQuery'de mevcut.

kFlag_TargetNodeIdPresent

ImageQuery içinde hedef düğüm kimliği mevcut.

@312

 @312

ImageQueryResponse'un isteğe bağlı güncelleme seçenekleri alanı için bit maskeleri.

@313

 @313

ImageQueryResponse'un isteğe bağlı güncelleme seçenekleri alanı için kaydırma ofsetleri.

@314

 @314

SoftwareUpdate profili tarafından desteklenen bütünlük türleri.

Resim sorgu çerçevesi, istemcinin hangi bütünlük denetimini desteklediğine dair bilgiler içerir. Resim sorgusu yanıtı ise istemciden indirmesi ve yüklemesi için talimat verilen görüntü için bir bütünlük türü ve değeri içerir. Desteklenen türler şunlardır:

Özellikler
kIntegrityType_Last

Sıralamadaki geçerli öğe sayısı.

kIntegrityType_SHA160

160 bit Güvenli Karma (SHA-1), gerekli.

kIntegrityType_SHA256

256 bit Güvenli Karma (SHA-2).

kIntegrityType_SHA512

512 bit, Güvenli Karma (SHA-2).

@315

 @315

Bütünlük spesifikasyonu bayt dizeleri için bayt cinsinden uzunluklar.

@316

 @316

SofwareUpdate profili tarafından desteklenen şemaları güncelleyin.

Desteklenen bütünlük türlerine benzer şekilde, resim sorgusu hangi güncelleme şemaları (yani indirme protokolleri) ile ilgili bilgi içerir (ör. indirme protokolleri), istemcinin desteklediği bilgiler ve yanıt, görüntülerin indirilmesinde kullanılacak güncelleme şemasını belirten bir değer içerir. Desteklenen şemalar şunlardır:

Özellikler
kUpdateScheme_BDX

Weave Toplu veri aktarımı, indirme protokolü olarak kullanılacaktır.

kUpdateScheme_HTTP

İndirme protokolü olarak HTTP kullanılmalıdır.

kUpdateScheme_HTTPS

İndirme protokolü olarak HTTPS kullanılmalıdır.

kUpdateScheme_Last

Sıralamadaki geçerli öğe sayısı.

kUpdateScheme_SFTP

İndirme protokolü olarak SFTP kullanılmalıdır.

@317

 @317

SoftwareUpdate Profili için Veri Öğesi Etiketleri.

UpdateCondition

 UpdateCondition

Güncelleme politikasını düzenleyen koşullar.

Özellikler
IfLater

Yanıt çerçevesindeki sürüm spesifikasyonu, yüklü olan yazılım sürümünden sonraysa görüntüyü indirip yükleyin.

IfUnmatched

Yanıt çerçevesindeki sürüm spesifikasyonu şu anda yüklü olan yazılım sürümüyle eşleşmiyorsa görüntüyü indirip yükleyin.

OnOptIn

resmi, sitedeki bir kullanıcı tarafından sağlanan bazı tetikleyicilere indirip yükleyin.

Unconditionally

Görüntüyü, o anda çalışan yazılım sürümünden bağımsız olarak indirip yükleyin.

UpdatePriority

 UpdatePriority

Öncelikleri güncelleyin.

Özellikler
Critical

Güncelleme hemen yürütülmelidir.

Normal

Güncelleme müşterinin takdirine bağlı olarak uygulanabilir.

İşlevler

integrityLength

int integrityLength(
  uint8_t aType
)

IntegrityTypes değerlerini, bu türdeki karmaların uzunluklarına eşleyen bir destek yöntemi.

Ayrıntılar
Parametreler
[in] aType
İadeler
Sağlanan karma türünün karma uzunluğu.