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 mensajes.
@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
Indicadores de control para el campo de control del marco ImageQuery .
@312 enumeración
Máscaras de bits para el campo de opciones de actualización opcional de ImageQueryResponse .
@313 enumeración
Desplazamientos de desplazamiento para el campo de opciones de actualización opcional de 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
Etiquetas de elementos de datos para el perfil de actualización de software .
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 de soporte que asigna los valores de IntegrityTypes a las longitudes de los hash de ese tipo.

Clases

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

Interfaz para el delegado de WeaveImageAnnounceServer .

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

Clase que describe el mensaje ImageAnnounce .

nl :: Weave :: Perfiles :: SoftwareUpdate :: ImageQuery

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

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

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

nl :: Weave :: 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 :: Weave :: Perfiles :: SoftwareUpdate :: IntegrityTypeList

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

nl :: Weave :: Perfiles :: SoftwareUpdate :: ProductSpec

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

nl :: Weave :: Perfiles :: SoftwareUpdate :: UpdateSchemeList

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

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

Servidor que escucha anuncios de imágenes de Weave.

Enumeraciones

@ 309

 @309

SoftwareUpdate Tipos de mensajes.

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 :: Weave :: Profiles :: 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 clase ImageQuery .

kMsgType_ImageQueryResponse

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

Su formato está definido por la clase ImageQueryResponse .

kMsgType_ImageQueryStatus

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

Su carga útil es un nl :: Weave :: Profiles :: 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 :: Weave :: Profiles :: 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 :: Weave :: Profiles :: StatusReporting :: StatusReport con la información de estado adicional extraída de SoftwareUpdateStatusCodes . Como se espera que el mensaje se genere después de la actualización real, se envía en un nuevo ExchangeContext y se trata como un mensaje no solicitado en el servidor.

@ 310

 @310

SoftwareUpdate códigos de estado específicos 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

client => server, indica que el cliente no pudo descargar una imagen porque las instrucciones de descarga contenidas en 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

Indicadores de control para el campo de control del marco ImageQuery .

Propiedades
kFlag_LocaleSpecPresent

La especificación de configuración regional está presente en ImageQuery .

kFlag_PackageSpecPresent

La especificación del paquete está presente en ImageQuery .

kFlag_TargetNodeIdPresent

El ID del nodo de destino está presente en ImageQuery .

@ 312

 @312

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

@ 313

 @313

Desplazamientos de desplazamiento para el campo de opciones de actualización opcional de ImageQueryResponse .

@ 314

 @314

Tipos de integridad admitidos por el perfil SoftwareUpdate .

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

Etiquetas de elementos de datos para el perfil de actualización de software .

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 disparador 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 de soporte que asigna los valores de IntegrityTypes a las longitudes de los hash de ese tipo.

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