SuplCertificateInterface Struct Reference

SuplCertificateInterface Struct Reference

#include < gps.h >

Data Fields

size_t  size
 
int(*  install_certificates )(const DerEncodedCertificate *certificates, size_t length)
 
int(*  revoke_certificates )(const Sha1CertificateFingerprint *fingerprints, size_t length)
 

Detailed Description

AGPS Interface to handle SUPL certificate operations

Definition at line 978 of file gps.h .

Field Documentation

int(* install_certificates)(const DerEncodedCertificate *certificates, size_t length)

Installs a set of Certificates used for SUPL connections to the AGPS server. If needed the HAL should find out internally any certificates that need to be removed to accommodate the certificates to install. The certificates installed represent a full set of valid certificates needed to connect to AGPS SUPL servers. The list of certificates is required, and all must be available at the same time, when trying to establish a connection with the AGPS Server.

Parameters: certificates - A pointer to an array of DER encoded certificates that are need to be installed in the HAL. length - The number of certificates to install. Returns: AGPS_CERTIFICATE_OPERATION_SUCCESS if the operation is completed successfully AGPS_CERTIFICATE_ERROR_TOO_MANY_CERTIFICATES if the HAL cannot store the number of certificates attempted to be installed, the state of the certificates stored should remain the same as before on this error case.

IMPORTANT: If needed the HAL should find out internally the set of certificates that need to be removed to accommodate the certificates to install.

Definition at line 1005 of file gps.h .

int(* revoke_certificates)(const Sha1CertificateFingerprint *fingerprints, size_t length)

Notifies the HAL that a list of certificates used for SUPL connections are revoked. It is expected that the given set of certificates is removed from the internal store of the HAL.

Parameters: fingerprints - A pointer to an array of SHA1 Fingerprints to identify the set of certificates to revoke. length - The number of fingerprints provided. Returns: AGPS_CERTIFICATE_OPERATION_SUCCESS if the operation is completed successfully.

IMPORTANT: If any of the certificates provided (through its fingerprint) is not known by the HAL, it should be ignored and continue revoking/deleting the rest of them.

Definition at line 1022 of file gps.h .

size_t size

set to sizeof(SuplCertificateInterface)

Definition at line 980 of file gps.h .


The documentation for this struct was generated from the following file:
  • hardware/libhardware/include/hardware/ gps.h