En Google, luchamos por la equidad racial de la comunidad negra. Más información

nl :: Tejido:: Perfiles: Actualización de software

Este espacio de nombres incluye todas las interfaces dentro de Weave para el perfil de actualización de software de Weave, que incluye el protocolo correspondiente del mismo nombre.

Resumen

Enumeraciones

@309 {
kMsgType_ImageAnnounce = 0,
kMsgType_ImageQuery = 1,
kMsgType_ImageQueryResponse = 2,
kMsgType_DownloadNotify = 3,
kMsgType_NotifyResponse = 4,
kMsgType_UpdateNotify = 5,
kMsgType_ImageQueryStatus = 6
}
enumeración
Softwareupdate tipos de mensaje.
@310 {
kStatus_NoUpdateAvailable = 0x0001,
kStatus_UpdateFailed = 0x0010,
kStatus_InvalidInstructions = 0x0050,
kStatus_DownloadFailed = 0x0051,
kStatus_IntegrityCheckFailed = 0x0052,
kStatus_Abort = 0x0053,
kStatus_Retry = 0x0091
}
enumeración
@311 {
kFlag_PackageSpecPresent = 1,
kFlag_LocaleSpecPresent = 2,
kFlag_TargetNodeIdPresent = 4
}
enumeración
Los indicadores de control para el campo de control de la ImageQuery marco.
@312 enumeración
Máscaras de bits para el campo de opciones de actualización opcional de la ImageQueryResponse .
@313 enumeración
Cambiar las compensaciones para el campo de opciones de actualización opcional de la ImageQueryResponse .
@314 {
kIntegrityType_SHA160 = 0,
kIntegrityType_SHA256 = 1,
kIntegrityType_SHA512 = 2,
kIntegrityType_Last = 3
}
enumeración
@315 enumeración
Longitudes, en bytes, para las cadenas de bytes de especificación de integridad.
@316 {
kUpdateScheme_HTTP = 0,
kUpdateScheme_HTTPS = 1,
kUpdateScheme_SFTP = 2,
kUpdateScheme_BDX = 3,
kUpdateScheme_Last = 4
}
enumeración
@317 enumeración
Elemento de datos Etiquetas para la softwareupdate perfil.
UpdateCondition {
IfUnmatched ,
IfLater ,
Unconditionally ,
OnOptIn
}
enumeración
Condiciones que rigen la política de actualización.
UpdatePriority {
Normal ,
Critical
}
enumeración
Actualice las prioridades.

Funciones

integrityLength (uint8_t aType)
int
Un método admite la asignación de los IntegrityTypes valores en las longitudes de los hashes de ese tipo.

Clases

nl :: Armadura :: Perfiles :: :: softwareupdate IWeaveImageAnnounceServerDelegate

Interfaz para WeaveImageAnnounceServer delegado.

nl :: Armadura :: Perfiles :: :: softwareupdate ImageAnnounce

Clase que describe el ImageAnnounce mensaje.

nl :: Armadura :: Perfiles :: :: softwareupdate ImageQuery

Una clase para apoyar la creación y decodificación de mensajes de consulta de imágenes.

nl :: Armadura :: Perfiles :: :: softwareupdate ImageQueryResponse

Una clase para apoyar la creación y decodificación de los mensajes de respuesta a la consulta de imágenes.

nl :: Armadura :: Perfiles :: :: softwareupdate IntegritySpec

Una clase auxiliar que contiene el tipo de integridad y el hash real de la imagen de actualización de software.

nl :: Armadura :: Perfiles :: :: softwareupdate IntegrityTypeList

Una clase auxiliar para contener una lista de tipos de integridad como parte de la consulta de imágenes.

nl :: Armadura :: Perfiles :: :: softwareupdate ProductSpec

Una clase auxiliar que representa una especificación de producto.

nl :: Armadura :: Perfiles :: :: softwareupdate UpdateSchemeList

Una clase auxiliar para contener una lista de esquemas de actualización como parte de la consulta de imágenes.

nl :: Armadura :: Perfiles :: :: softwareupdate WeaveImageAnnounceServer

Servidor que escucha anuncios de imágenes de Weave.

Enumeraciones

@ 309

 @309

Softwareupdate tipos de mensaje.

Propiedades
kMsgType_DownloadNotify

Un mensaje opcional del cliente al servidor que se utiliza para notificar al servidor sobre el estado de la descarga.

Su carga útil es un nl :: Armadura :: Perfiles :: :: StatusReporting StatusReport con la información de estado adicional extraída de SoftwareUpdateStatusCodes .

kMsgType_ImageAnnounce

Un mensaje opcional no solicitado, utilizado por el servidor para anunciar la disponibilidad de una actualización de software.

El mensaje no tiene carga útil.

kMsgType_ImageQuery

Un mensaje de consulta enviado por el cliente al servidor.

Su formato se define con la ImageQuery clase.

kMsgType_ImageQueryResponse

Un mensaje generado en respuesta a un mensaje de consulta de imagen exitoso.

Su formato es definido por el ImageQueryResponse clase.

kMsgType_ImageQueryStatus

Un mensaje generado en respuesta a un mensaje de consulta de imagen fallido.

Su carga útil es un nl :: Armadura :: Perfiles :: :: StatusReporting StatusReport con la información de estado adicional extraída de SoftwareUpdateStatusCodes .

kMsgType_NotifyResponse

Un mensaje generado en respuesta al mensaje de notificación de descarga.

Su carga útil es un nl :: Armadura :: Perfiles :: :: StatusReporting StatusReport con la información de estado adicional extraída de SoftwareUpdateStatusCodes .

kMsgType_UpdateNotify

Un mensaje opcional del cliente al servidor que se utiliza para comunicar el estado final de la actualización.

Su carga útil es un nl :: Armadura :: Perfiles :: :: StatusReporting StatusReport con la información de estado adicional extraída de SoftwareUpdateStatusCodes . Como se espera que el mensaje que se genere actualización real posterior, se envía en un nuevo ExchangeContext y es tratado como un mensaje no solicitado en el servidor.

@ 310

 @310

Softwareupdate códigos de estado específica del perfil.

Propiedades
kStatus_Abort

servidor => cliente, indica que el cliente debe darse por vencido ya que el servidor no tiene opciones.

kStatus_DownloadFailed

cliente => servidor, indica que un intento de descarga falló.

kStatus_IntegrityCheckFailed

cliente => servidor, indica que se descargó una imagen pero no pasó la verificación de integridad posterior.

kStatus_InvalidInstructions

cliente => servidor, indica que el cliente no ha podido descargar una imagen, porque las instrucciones de descarga contenidas en el ImageQueryResponse , es decir,

URI, esquema de actualización, condición de actualización, estaban mal formados o eran inconsistentes.

kStatus_NoUpdateAvailable

servidor => cliente, indica que se ha recibido y comprendido una consulta de imagen y que el servidor no tiene ninguna actualización para el cliente en este momento.

kStatus_Retry

servidor => cliente, indica que el cliente debe enviar otra consulta de imagen y reiniciar / continuar la actualización

kStatus_UpdateFailed

cliente => servidor, indica que ha fallado un intento de instalar una imagen especificada por el servidor.

@ 311

 @311

Los indicadores de control para el campo de control de la ImageQuery marco.

Propiedades
kFlag_LocaleSpecPresent

Locale especificación está presente en la ImageQuery .

kFlag_PackageSpecPresent

Especificación del paquete está presente en la ImageQuery .

kFlag_TargetNodeIdPresent

Target ID de nodo está presente en la ImageQuery .

@ 312

 @312

Máscaras de bits para el campo de opciones de actualización opcional de la ImageQueryResponse .

@ 313

 @313

Cambiar las compensaciones para el campo de opciones de actualización opcional de la ImageQueryResponse .

@ 314

 @314

Tipos de integridad apoyados por el softwareupdate perfil.

El marco de consulta de imagen contiene información sobre qué comprobación de integridad admite el cliente y la respuesta de consulta de imagen contiene un tipo y valor de integridad para la imagen que se le indica al cliente que descargue e instale. Los tipos admitidos son:

Propiedades
kIntegrityType_Last

Número de elementos válidos en la enumeración.

kIntegrityType_SHA160

Se requiere Hash seguro de 160 bits (SHA-1).

kIntegrityType_SHA256

Hash seguro de 256 bits (SHA-2).

kIntegrityType_SHA512

Hash seguro de 512 bits (SHA-2).

@ 315

 @315

Longitudes, en bytes, para las cadenas de bytes de especificación de integridad.

@ 316

 @316

Actualice los esquemas admitidos por el perfil SofwareUpdate.

De manera similar a los tipos de integridad admitidos, la consulta de imágenes contiene información sobre qué esquemas de actualización, es decir, protocolos de descarga, admite el cliente, y la respuesta contiene un valor para indicar el esquema de actualización que se utilizará para descargar las imágenes. Los esquemas admitidos son:

Propiedades
kUpdateScheme_BDX

La transferencia de datos de Weave Bulk se utilizará como protocolo de descarga.

kUpdateScheme_HTTP

HTTP se utilizará como protocolo de descarga.

kUpdateScheme_HTTPS

Se utilizará HTTPS como protocolo de descarga.

kUpdateScheme_Last

Número de elementos válidos en la enumeración.

kUpdateScheme_SFTP

SFTP se utilizará como protocolo de descarga.

@ 317

 @317

Elemento de datos Etiquetas para la softwareupdate perfil.

UpdateCondition

 UpdateCondition

Condiciones que rigen la política de actualización.

Propiedades
IfLater

Descargue e instale la imagen si la especificación de la versión en el marco de respuesta es posterior a la versión de software instalada actualmente.

IfUnmatched

Descargue e instale la imagen si la especificación de la versión en el marco de respuesta no coincide con la versión de software instalada actualmente.

OnOptIn

descargue e instale la imagen en algún activador proporcionado por un usuario en el sitio.

Unconditionally

Descargue e instale la imagen independientemente de la versión de software que se esté ejecutando actualmente.

UpdatePriority

 UpdatePriority

Actualice las prioridades.

Propiedades
Critical

La actualización debe ejecutarse de inmediato.

Normal

La actualización se puede ejecutar a discreción del cliente.

Funciones

integridad Longitud

int integrityLength(
  uint8_t aType
)

Un método admite la asignación de los IntegrityTypes valores en las longitudes de los hashes de ese tipo.

Detalles
Parámetros
[in] aType
Un IntegrityTypes valor
Devoluciones
Longitud del hash del tipo de hash proporcionado.