nl:: Weave:: Profiles:: SoftwareUpdate
Dieser Namespace umfasst alle Weave-Schnittstellen für das Weave-Software-Update-Profil, einschließlich des entsprechenden Protokolls desselben Namens.
Zusammenfassung
Funktionen |
|
---|---|
integrityLength(uint8_t aType)
|
int
Eine Supportmethode, die die IntegrityTypes-Werte den Längen der Hashes dieses Typs zuordnet.
|
Kurse |
|
---|---|
nl:: |
Schnittstelle für den WeaveImageAnnounceServer-Delegat. |
nl:: |
Klasse, die die ImageAnnounce-Nachricht beschreibt. |
nl:: |
Eine Klasse, die das Erstellen und Decodieren von Bildanfragenachrichten unterstützt. |
nl:: |
Eine Klasse, die das Erstellen und Decodieren der Antwortnachrichten auf Bildanfragen unterstützt. |
nl:: |
Eine Hilfsklasse, die den Integritätstyp und den tatsächlichen Hash des Software-Update-Images enthält. |
nl:: |
Eine Hilfsklasse, die eine Liste von Integritätstypen als Teil der Bildabfrage enthält. |
nl:: |
Eine Hilfsklasse, die eine Produktspezifikation darstellt. |
nl:: |
Eine Hilfsklasse, die eine Liste von Aktualisierungsschemata als Teil der Bildabfrage enthält. |
nl:: |
Server, der auf Weave-Bildankündigungen wartet. |
Aufzählungen
@309
@309
SoftwareUpdate-Nachrichtentypen
Attribute | |
---|---|
kMsgType_DownloadNotify
|
Eine optionale Nachricht vom Client an den Server, die verwendet wird, um den Server über den Downloadstatus zu informieren. Die Nutzlast ist ein nl::Weave::Profiles::StatusReporting::StatusReport mit zusätzlichen Statusinformationen aus SoftwareUpdateStatusCodes. |
kMsgType_ImageAnnounce
|
Eine optionale, unerwünschte Nachricht, die vom Server verwendet wird, um die Verfügbarkeit eines Softwareupdates anzukündigen. Die Nachricht enthält keine Nutzlast. |
kMsgType_ImageQuery
|
Eine vom Client an den Server gesendete Anfragenachricht. Das Format wird mit der Klasse ImageQuery definiert. |
kMsgType_ImageQueryResponse
|
Eine Nachricht, die als Antwort auf eine erfolgreiche Bildanfrage generiert wird. Das Format wird von der Klasse ImageQueryResponse definiert. |
kMsgType_ImageQueryStatus
|
Eine Nachricht, die als Antwort auf eine fehlgeschlagene Bildanfrage generiert wird. Die Nutzlast ist ein nl::Weave::Profiles::StatusReporting::StatusReport mit zusätzlichen Statusinformationen aus SoftwareUpdateStatusCodes. |
kMsgType_NotifyResponse
|
Eine als Reaktion auf die Downloadbenachrichtigungsnachricht generierte Nachricht. Die Nutzlast ist ein nl::Weave::Profiles::StatusReporting::StatusReport mit zusätzlichen Statusinformationen aus SoftwareUpdateStatusCodes. |
kMsgType_UpdateNotify
|
Eine optionale Nachricht vom Client an den Server, mit der der endgültige Status des Updates kommuniziert wird. Die Nutzlast ist ein nl::Weave::Profiles::StatusReporting::StatusReport mit zusätzlichen Statusinformationen aus SoftwareUpdateStatusCodes. Da die Nachricht voraussichtlich nach einer tatsächlichen Aktualisierung generiert wird, wird sie in einem neuen ExchangeContext gesendet und auf dem Server als unerwünschte Nachricht behandelt. |
@310
@310
SoftwareUpdate-Profilspezifische Statuscodes.
Attribute | |
---|---|
kStatus_Abort
|
server => client: Gibt an, dass der Client aufgeben soll, da der Server keine Optionen hat. |
kStatus_DownloadFailed
|
client => server gibt an, dass ein versuchter Download fehlgeschlagen ist. |
kStatus_IntegrityCheckFailed
|
client => server gibt an, dass ein Image heruntergeladen wurde, aber die nachfolgende Integritätsprüfung nicht bestanden hat. |
kStatus_InvalidInstructions
|
client => server gibt an, dass der Client kein Image herunterladen konnte, da die Downloadanleitung in der ImageQueryResponse enthalten war, d.h. URI, Aktualisierungsschema, Aktualisierungsbedingung, schlecht formatiert oder inkonsistent. |
kStatus_NoUpdateAvailable
|
server => client: Gibt an, dass eine Bildanfrage empfangen und gelesen wurde und dass der Server zu diesem Zeitpunkt kein Update für den Client hat. |
kStatus_Retry
|
server => client, gibt an, dass der Client eine weitere Image-Abfrage senden und das Update neu starten/fortsetzen soll |
kStatus_UpdateFailed
|
client => server gibt an, dass der Versuch, ein vom Server angegebenes Image zu installieren, fehlgeschlagen ist. |
@311
@311
Steuer-Flags für das Steuerfeld des Frames ImageQuery.
Attribute | |
---|---|
kFlag_LocaleSpecPresent
|
Die Locale-Spezifikation ist in der ImageQuery vorhanden. |
kFlag_PackageSpecPresent
|
Paketspezifikation ist in ImageQuery vorhanden. |
kFlag_TargetNodeIdPresent
|
Die Zielknoten-ID ist in der ImageQuery vorhanden. |
@313
@313
Verschiebt Offsets für das optionale Feld für Aktualisierungsoptionen von ImageQueryResponse.
@314
@314
Integritätstypen, die vom SoftwareUpdate-Profil unterstützt werden
Der Frame für die Bildabfrage enthält Informationen darüber, welche Integritätsprüfung der Client unterstützt, und die Bildanfrageantwort enthält einen Integritätstyp und einen Wert für das Bild, das der Client herunterladen und installieren soll. Folgende Typen werden unterstützt:
Attribute | |
---|---|
kIntegrityType_Last
|
Anzahl der gültigen Elemente in der Aufzählung. |
kIntegrityType_SHA160
|
Sicherer 160-Bit-Hash (SHA-1), erforderlich. |
kIntegrityType_SHA256
|
Sicherer 256-Bit-Hash (SHA-2) |
kIntegrityType_SHA512
|
Sicherer 512-Bit-Hash (SHA-2). |
@315
@315
Längen in Byte für die Bytestrings der Integritätsspezifikation.
@316
@316
Vom SofwareUpdate-Profil unterstützte Update-Schemas
Ähnlich wie die unterstützten Integritätstypen enthält die Bildabfrage Informationen darüber, welche Aktualisierungsschemata (d.h. Download-Protokolle) vom Client unterstützt werden, und die Antwort enthält einen Wert zur Angabe des Aktualisierungsschemas, das beim Herunterladen der Bilder verwendet werden soll. Folgende Schemas werden unterstützt:
Attribute | |
---|---|
kUpdateScheme_BDX
|
Als Downloadprotokoll wird die Weave-Bulk-Datenübertragung verwendet. |
kUpdateScheme_HTTP
|
HTTP wird als Download-Protokoll verwendet. |
kUpdateScheme_HTTPS
|
HTTPS wird als Downloadprotokoll verwendet. |
kUpdateScheme_Last
|
Anzahl der gültigen Elemente in der Aufzählung. |
kUpdateScheme_SFTP
|
SFTP wird als Download-Protokoll verwendet. |
UpdateCondition
UpdateCondition
Bedingungen für die Aktualisierungsrichtlinie.
Attribute | |
---|---|
IfLater
|
Laden Sie das Image herunter und installieren Sie es, wenn die Versionsspezifikation im Antwort-Frame höher ist als die aktuell installierte Softwareversion. |
IfUnmatched
|
Laden Sie das Image herunter und installieren Sie es, wenn die Versionsspezifikation im Antwort-Frame nicht mit der aktuell installierten Softwareversion übereinstimmt. |
OnOptIn
|
das Bild über einen Trigger, der von einem Nutzer vor Ort bereitgestellt wird, herunterladen und installieren. |
Unconditionally
|
Laden Sie das Image herunter und installieren Sie es unabhängig von der aktuell ausgeführten Softwareversion. |
UpdatePriority
UpdatePriority
Funktionen
integrityLength
int integrityLength( uint8_t aType )
Eine Supportmethode, die die IntegrityTypes-Werte den Längen der Hashes dieses Typs zuordnet.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
Hash-Länge des angegebenen Hash-Typs.
|