Starting March 27, 2025, we recommend using android-latest-release instead of aosp-main to build and contribute to AOSP. For more information, see Changes to AOSP.
Stay organized with collections
Save and categorize content based on your preferences.
SuplCertificateInterface Struct Reference
#include <
gps.h
>
AGPS Interface to handle SUPL certificate operations
Definition at line
978
of file
gps.h
.
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
.
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
.
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
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2019-10-02 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2019-10-02 UTC."],[],[],null,["# Android Hardware Abstraction Layer: SuplCertificateInterface Struct Reference\n\nSuplCertificateInterface Struct Reference\n=========================================\n\n[Data Fields](#pub-attribs) \nSuplCertificateInterface Struct Reference \n\n`\n#include \u003c\n`[gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)`\n\u003e\n`\n\n|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Data Fields ----------- ||\n| size_t | [size](/reference/hal/struct_supl_certificate_interface#a854352f53b148adc24983a58a1866d66) |\n| ||\n| int(\\* | [install_certificates](/reference/hal/struct_supl_certificate_interface#a9208ffa455b013091db3afa2abc2a1a3) )(const [DerEncodedCertificate](/reference/hal/struct_der_encoded_certificate) \\*certificates, size_t length) |\n| ||\n| int(\\* | [revoke_certificates](/reference/hal/struct_supl_certificate_interface#a6c541c29aa9f7a5fb5f44ce4283e98e3) )(const [Sha1CertificateFingerprint](/reference/hal/struct_sha1_certificate_fingerprint) \\*fingerprints, size_t length) |\n| ||\n\n\nDetailed Description\n--------------------\n\n\nAGPS Interface to handle SUPL certificate operations\n\n\nDefinition at line\n[978](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\nof file\n[gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\n.\n\nField Documentation\n-------------------\n\n\n|------------------------------------------------------------------------------------------------------------------------------------------|\n| int(\\* install_certificates)(const [DerEncodedCertificate](/reference/hal/struct_der_encoded_certificate) \\*certificates, size_t length) |\n\n\nInstalls 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.\n\n\nParameters: 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.\n\n\nIMPORTANT: If needed the HAL should find out internally the set of certificates that need to be removed to accommodate the certificates to install.\n\n\nDefinition at line\n[1005](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\nof file\n[gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\n.\n\n|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| int(\\* revoke_certificates)(const [Sha1CertificateFingerprint](/reference/hal/struct_sha1_certificate_fingerprint) \\*fingerprints, size_t length) |\n\n\nNotifies 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.\n\n\nParameters: 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.\n\n\nIMPORTANT: 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.\n\n\nDefinition at line\n[1022](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\nof file\n[gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\n.\n\n|-------------|\n| size_t size |\n\n\nset to sizeof(SuplCertificateInterface)\n\n\nDefinition at line\n[980](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\nof file\n[gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)\n.\n\n*** ** * ** ***\n\nThe documentation for this struct was generated from the following file:\n\n- hardware/libhardware/include/hardware/ [gps.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/gps.h)"]]
