nl::Weave::Profiles::SoftwareUpdate

Ta przestrzeń nazw obejmuje wszystkie interfejsy Weave dla profilu aktualizacji oprogramowania Weave, w tym odpowiedni protokół o tej samej nazwie.

Podsumowanie

Wyliczenia

@309{
  kMsgType_ImageAnnounce = 0,
  kMsgType_ImageQuery = 1,
  kMsgType_ImageQueryResponse = 2,
  kMsgType_DownloadNotify = 3,
  kMsgType_NotifyResponse = 4,
  kMsgType_UpdateNotify = 5,
  kMsgType_ImageQueryStatus = 6
}
enum | typ wyliczeniowy
Typy wiadomości SoftwareUpdate.
@310{
  kStatus_NoUpdateAvailable = 0x0001,
  kStatus_UpdateFailed = 0x0010,
  kStatus_InvalidInstructions = 0x0050,
  kStatus_DownloadFailed = 0x0051,
  kStatus_IntegrityCheckFailed = 0x0052,
  kStatus_Abort = 0x0053,
  kStatus_Retry = 0x0091
}
enum | typ wyliczeniowy
@311{
  kFlag_PackageSpecPresent = 1,
  kFlag_LocaleSpecPresent = 2,
  kFlag_TargetNodeIdPresent = 4
}
enum | typ wyliczeniowy
Flagi sterujące pola sterującego ramki ImageQuery.
@312 enum | typ wyliczeniowy
Maski bitowe dla opcjonalnego pola opcji aktualizacji w ImageQueryResponse.
@313 enum | typ wyliczeniowy
Przesuń przesunięcia w opcjonalnym polu opcji aktualizacji w obiekcie ImageQueryResponse.
@314{
  kIntegrityType_SHA160 = 0,
  kIntegrityType_SHA256 = 1,
  kIntegrityType_SHA512 = 2,
  kIntegrityType_Last = 3
}
enum | typ wyliczeniowy
@315 enum | typ wyliczeniowy
Długość ciągu bajtów w specyfikacji integralności (w bajtach).
@316{
  kUpdateScheme_HTTP = 0,
  kUpdateScheme_HTTPS = 1,
  kUpdateScheme_SFTP = 2,
  kUpdateScheme_BDX = 3,
  kUpdateScheme_Last = 4
}
enum | typ wyliczeniowy
@317 enum | typ wyliczeniowy
Tagi elementu danych dla profilu SoftwareUpdate.
UpdateCondition{
  IfUnmatched,
  IfLater,
  Unconditionally,
  OnOptIn
}
enum | typ wyliczeniowy
Warunki regulujące zasady aktualizacji.
UpdatePriority{
  Normal,
  Critical
}
enum | typ wyliczeniowy
Zaktualizuj priorytety.

Funkcje

integrityLength(uint8_t aType)
int
Metoda wsparcia mapująca wartości IntegrityTypes na długości skrótów tego typu.

Zajęcia

nl::Weave::Profiles::SoftwareUpdate::IWeaveImageAnnounceServerDelegate

Interfejs delegata WeaveImageAnnounceServer.

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

Klasa opisująca komunikat ImageAnnounce.

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

Klasa do tworzenia i dekodowania wiadomości zapytań dotyczących obrazów.

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

Klasa do tworzenia i dekodowania odpowiedzi na zapytania dotyczące obrazów.

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

Klasa pomocnicza zawierająca typ integralności i rzeczywisty hasz obrazu aktualizacji oprogramowania.

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

Klasa pomocnicza do przechowywania listy typów integralności w ramach zapytania dotyczącego obrazu.

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

Klasa pomocnicza reprezentująca specyfikację produktu.

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

Klasa pomocnicza do przechowywania listy schematów aktualizacji w ramach zapytania dotyczącego obrazu.

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

Serwer nasłuchujący ogłoszenia dotyczące obrazów Weave.

Wyliczenia

@309

 @309

Typy wiadomości SoftwareUpdate.

Właściwości
kMsgType_DownloadNotify

Opcjonalna wiadomość wysłana przez klienta do serwera, która służy do powiadamiania serwera o stanie pobierania.

Jej ładunek ma postać nl::Weave::Profiles::StatusReporting::StatusReport z dodatkowymi informacjami o stanie pobranymi z elementu SoftwareUpdateStatusCodes.

kMsgType_ImageAnnounce

Opcjonalny niezamawiany komunikat używany przez serwer do informowania o dostępności aktualizacji oprogramowania.

Wiadomość nie zawiera ładunku.

kMsgType_ImageQuery

Zapytanie wysłane przez klienta do serwera.

Jej format jest określany za pomocą klasy ImageQuery.

kMsgType_ImageQueryResponse

Komunikat wygenerowany w odpowiedzi na udane zapytanie o grafikę.

Jej format jest definiowany przez klasę ImageQueryResponse.

kMsgType_ImageQueryStatus

Komunikat wygenerowany w odpowiedzi na nieudane zapytanie o obraz.

Jej ładunek ma postać nl::Weave::Profiles::StatusReporting::StatusReport z dodatkowymi informacjami o stanie pobranymi z elementu SoftwareUpdateStatusCodes.

kMsgType_NotifyResponse

Komunikat wygenerowany w odpowiedzi na powiadomienie o pobieraniu.

Jej ładunek ma postać nl::Weave::Profiles::StatusReporting::StatusReport z dodatkowymi informacjami o stanie pobranymi z elementu SoftwareUpdateStatusCodes.

kMsgType_UpdateNotify

Opcjonalna wiadomość od klienta do serwera używana do przekazywania ostatecznego stanu aktualizacji.

Jej ładunek ma postać nl::Weave::Profiles::StatusReporting::StatusReport z dodatkowymi informacjami o stanie pobranymi z elementu SoftwareUpdateStatusCodes. Wiadomość ma zostać wygenerowana po rzeczywistej aktualizacji, więc jest wysyłana w nowym kontekście ExchangeContext i traktowana na serwerze jako niepożądana wiadomość.

@310

 @310

Kody stanu właściwe dla profilu SoftwareUpdate.

Właściwości
kStatus_Abort

serwer => klient, wskazuje, że klient powinien się poddać, ponieważ na serwerze nie ma dostępnych opcji.

kStatus_DownloadFailed

client => Server, wskazuje, że próba pobrania się nie powiodła.

kStatus_IntegrityCheckFailed

client => serwer, wskazuje, że obraz został pobrany, ale nie przeszedł on kolejnej kontroli integralności.

kStatus_InvalidInstructions

client => serwer, wskazuje, że klient nie mógł pobrać obrazu, ponieważ instrukcje pobierania zawarte w obiekcie ImageQueryResponse, tj.

Identyfikator URI, schemat aktualizacji, warunek aktualizacji, były źle sformułowane lub niespójne.

kStatus_NoUpdateAvailable

serwer => oznacza, że zapytanie dotyczące obrazu zostało odebrane i zrozumiane oraz że w chwili obecnej serwer nie zawiera aktualizacji dla klienta.

kStatus_Retry

serwer => klient, wskazuje, że klient powinien przesłać kolejne zapytanie dotyczące obrazu, a następnie ponownie uruchomić aktualizację/kontynuować aktualizację;

kStatus_UpdateFailed

client => serwer, wskazuje, że próba zainstalowania obrazu wskazanego przez serwer nie powiodła się.

@311

 @311

Flagi sterujące pola sterującego ramki ImageQuery.

Właściwości
kFlag_LocaleSpecPresent

Specyfikacja Locale znajduje się w obiekcie ImageQuery.

kFlag_PackageSpecPresent

Specyfikacja pakietu znajduje się w obiekcie ImageQuery.

kFlag_TargetNodeIdPresent

Identyfikator węzła docelowego znajduje się w elemencie ImageQuery.

@312

 @312

Maski bitowe dla opcjonalnego pola opcji aktualizacji w ImageQueryResponse.

@313

 @313

Przesuń przesunięcia w opcjonalnym polu opcji aktualizacji w obiekcie ImageQueryResponse.

@314

 @314

Typy integralności obsługiwane przez profil SoftwareUpdate.

Ramka zapytania o obraz zawiera informacje o tym, jaką kontrolę integralności obsługuje klient, a odpowiedź na zapytanie o obraz zawiera typ integralności i wartość obrazu, który ma pobrać i zainstalować. Obsługiwane typy to:

Właściwości
kIntegrityType_Last

Liczba prawidłowych elementów w wyliczeniu.

kIntegrityType_SHA160

Wymagany jest 160-bitowy klucz bezpieczny (SHA-1).

kIntegrityType_SHA256

256-bitowy bezpieczny hasz (SHA-2).

kIntegrityType_SHA512

512-bitowy, bezpieczny hasz (SHA-2).

@315

 @315

Długość ciągu bajtów w specyfikacji integralności (w bajtach).

@316

 @316

Aktualizowanie schematów obsługiwanych przez profil SofwareUpdate.

Podobnie jak w przypadku obsługiwanych typów integralności, zapytanie dotyczące obrazu zawiera informacje o schematach aktualizacji, czyli protokoły pobierania, które obsługuje klient. Odpowiedź zawiera wartość wskazującą schemat aktualizacji, który ma zostać użyty przy pobieraniu obrazów. Obsługiwane schematy to:

Właściwości
kUpdateScheme_BDX

Za protokół pobierania służy zbiorcze przesyłanie danych Weave.

kUpdateScheme_HTTP

Jako protokół pobierania powinien być używany protokół HTTP.

kUpdateScheme_HTTPS

Jako protokół pobierania należy używać protokołu HTTPS.

kUpdateScheme_Last

Liczba prawidłowych elementów w wyliczeniu.

kUpdateScheme_SFTP

Używany jest protokół SFTP.

@317

 @317

Tagi elementu danych dla profilu SoftwareUpdate.

UpdateCondition

 UpdateCondition

Warunki regulujące zasady aktualizacji.

Właściwości
IfLater

Pobierz i zainstaluj obraz, jeśli specyfikacja wersji w ramce odpowiedzi jest późniejsza niż aktualnie zainstalowana wersja oprogramowania.

IfUnmatched

Jeśli specyfikacja wersji w ramce odpowiedzi nie jest zgodna z wersją obecnie zainstalowaną, pobierz i zainstaluj obraz.

OnOptIn

pobrać i zainstalować obraz za pomocą czynnika uruchamiającego, który został udostępniony przez użytkownika witryny.

Unconditionally

Pobrać i zainstalować obraz niezależnie od używanej wersji oprogramowania.

UpdatePriority

 UpdatePriority

Zaktualizuj priorytety.

Właściwości
Critical

Aktualizacja musi zostać przeprowadzona natychmiast.

Normal

Klient może przeprowadzić aktualizację według uznania.

Funkcje

integrityLength

int integrityLength(
  uint8_t aType
)

Metoda wsparcia mapująca wartości IntegrityTypes na długości skrótów tego typu.

Szczegóły
Parametry
[in] aType
Wartość IntegrityTypes.
Zwroty
Długość skrótu podanego typu skrótu.