Class

GioTlsDatabase

Description [src]

abstract class Gio.TlsDatabase : GObject.Object {
  parent_instance: GObject,
  priv: GTlsDatabasePrivate*
}

GTlsDatabase is used to look up certificates and other information from a certificate or key store. It is an abstract base class which TLS library specific subtypes override.

A GTlsDatabase may be accessed from multiple threads by the TLS backend. All implementations are required to be fully thread-safe.

Most common client applications will not directly interact with GTlsDatabase. It is used internally by GTlsConnection.

Available since:2.30

Hierarchy

hierarchy this GTlsDatabase ancestor_0 GObject ancestor_0--this

Ancestors

Instance methods

g_tls_database_create_certificate_handle

Create a handle string for the certificate. The database will only be able to create a handle for certificates that originate from the database. In cases where the database cannot create a handle for a certificate, NULL will be returned.

Available since: 2.30

g_tls_database_lookup_certificate_for_handle

Look up a certificate by its handle.

Available since: 2.30

g_tls_database_lookup_certificate_for_handle_async

Asynchronously look up a certificate by its handle in the database. See g_tls_database_lookup_certificate_for_handle() for more information.

Available since: 2.30

g_tls_database_lookup_certificate_for_handle_finish

Finish an asynchronous lookup of a certificate by its handle. See g_tls_database_lookup_certificate_for_handle() for more information.

Available since: 2.30

g_tls_database_lookup_certificate_issuer

Look up the issuer of certificate in the database. The GTlsCertificate:issuer property of certificate is not modified, and the two certificates are not hooked into a chain.

Available since: 2.30

g_tls_database_lookup_certificate_issuer_async

Asynchronously look up the issuer of certificate in the database. See g_tls_database_lookup_certificate_issuer() for more information.

Available since: 2.30

g_tls_database_lookup_certificate_issuer_finish

Finish an asynchronous lookup issuer operation. See g_tls_database_lookup_certificate_issuer() for more information.

Available since: 2.30

g_tls_database_lookup_certificates_issued_by

Look up certificates issued by this issuer in the database.

Available since: 2.30

g_tls_database_lookup_certificates_issued_by_async

Asynchronously look up certificates issued by this issuer in the database. See g_tls_database_lookup_certificates_issued_by() for more information.

Available since: 2.30

g_tls_database_lookup_certificates_issued_by_finish

Finish an asynchronous lookup of certificates. See g_tls_database_lookup_certificates_issued_by() for more information.

Available since: 2.30

g_tls_database_verify_chain

Determines the validity of a certificate chain, outside the context of a TLS session.

Available since: 2.30

g_tls_database_verify_chain_async

Asynchronously determines the validity of a certificate chain after looking up and adding any missing certificates to the chain. See g_tls_database_verify_chain() for more information.

Available since: 2.30

g_tls_database_verify_chain_finish

Finish an asynchronous verify chain operation. See g_tls_database_verify_chain() for more information.

Available since: 2.30

Methods inherited from GObject (43)

Signals

Signals inherited from GObject (1)

Class structure

struct GioTlsDatabaseClass {
  GObjectClass parent_class;
  GTlsCertificateFlags (* verify_chain) (
    GTlsDatabase* self,
    GTlsCertificate* chain,
    const gchar* purpose,
    GSocketConnectable* identity,
    GTlsInteraction* interaction,
    GTlsDatabaseVerifyFlags flags,
    GCancellable* cancellable,
    GError** error
  );
  void (* verify_chain_async) (
    GTlsDatabase* self,
    GTlsCertificate* chain,
    const gchar* purpose,
    GSocketConnectable* identity,
    GTlsInteraction* interaction,
    GTlsDatabaseVerifyFlags flags,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  );
  GTlsCertificateFlags (* verify_chain_finish) (
    GTlsDatabase* self,
    GAsyncResult* result,
    GError** error
  );
  gchar* (* create_certificate_handle) (
    GTlsDatabase* self,
    GTlsCertificate* certificate
  );
  GTlsCertificate* (* lookup_certificate_for_handle) (
    GTlsDatabase* self,
    const gchar* handle,
    GTlsInteraction* interaction,
    GTlsDatabaseLookupFlags flags,
    GCancellable* cancellable,
    GError** error
  );
  void (* lookup_certificate_for_handle_async) (
    GTlsDatabase* self,
    const gchar* handle,
    GTlsInteraction* interaction,
    GTlsDatabaseLookupFlags flags,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  );
  GTlsCertificate* (* lookup_certificate_for_handle_finish) (
    GTlsDatabase* self,
    GAsyncResult* result,
    GError** error
  );
  GTlsCertificate* (* lookup_certificate_issuer) (
    GTlsDatabase* self,
    GTlsCertificate* certificate,
    GTlsInteraction* interaction,
    GTlsDatabaseLookupFlags flags,
    GCancellable* cancellable,
    GError** error
  );
  void (* lookup_certificate_issuer_async) (
    GTlsDatabase* self,
    GTlsCertificate* certificate,
    GTlsInteraction* interaction,
    GTlsDatabaseLookupFlags flags,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  );
  GTlsCertificate* (* lookup_certificate_issuer_finish) (
    GTlsDatabase* self,
    GAsyncResult* result,
    GError** error
  );
  GList* (* lookup_certificates_issued_by) (
    GTlsDatabase* self,
    GByteArray* issuer_raw_dn,
    GTlsInteraction* interaction,
    GTlsDatabaseLookupFlags flags,
    GCancellable* cancellable,
    GError** error
  );
  void (* lookup_certificates_issued_by_async) (
    GTlsDatabase* self,
    GByteArray* issuer_raw_dn,
    GTlsInteraction* interaction,
    GTlsDatabaseLookupFlags flags,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  );
  GList* (* lookup_certificates_issued_by_finish) (
    GTlsDatabase* self,
    GAsyncResult* result,
    GError** error
  );
  
}
Class members
parent_class
GObjectClass
  No description available.
verify_chain
GTlsCertificateFlags (* verify_chain) (
    GTlsDatabase* self,
    GTlsCertificate* chain,
    const gchar* purpose,
    GSocketConnectable* identity,
    GTlsInteraction* interaction,
    GTlsDatabaseVerifyFlags flags,
    GCancellable* cancellable,
    GError** error
  )
  No description available.
verify_chain_async
void (* verify_chain_async) (
    GTlsDatabase* self,
    GTlsCertificate* chain,
    const gchar* purpose,
    GSocketConnectable* identity,
    GTlsInteraction* interaction,
    GTlsDatabaseVerifyFlags flags,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  )
  No description available.
verify_chain_finish
GTlsCertificateFlags (* verify_chain_finish) (
    GTlsDatabase* self,
    GAsyncResult* result,
    GError** error
  )
  No description available.
create_certificate_handle
gchar* (* create_certificate_handle) (
    GTlsDatabase* self,
    GTlsCertificate* certificate
  )
  No description available.
lookup_certificate_for_handle
GTlsCertificate* (* lookup_certificate_for_handle) (
    GTlsDatabase* self,
    const gchar* handle,
    GTlsInteraction* interaction,
    GTlsDatabaseLookupFlags flags,
    GCancellable* cancellable,
    GError** error
  )
  No description available.
lookup_certificate_for_handle_async
void (* lookup_certificate_for_handle_async) (
    GTlsDatabase* self,
    const gchar* handle,
    GTlsInteraction* interaction,
    GTlsDatabaseLookupFlags flags,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  )
  No description available.
lookup_certificate_for_handle_finish
GTlsCertificate* (* lookup_certificate_for_handle_finish) (
    GTlsDatabase* self,
    GAsyncResult* result,
    GError** error
  )
  No description available.
lookup_certificate_issuer
GTlsCertificate* (* lookup_certificate_issuer) (
    GTlsDatabase* self,
    GTlsCertificate* certificate,
    GTlsInteraction* interaction,
    GTlsDatabaseLookupFlags flags,
    GCancellable* cancellable,
    GError** error
  )
  No description available.
lookup_certificate_issuer_async
void (* lookup_certificate_issuer_async) (
    GTlsDatabase* self,
    GTlsCertificate* certificate,
    GTlsInteraction* interaction,
    GTlsDatabaseLookupFlags flags,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  )
  No description available.
lookup_certificate_issuer_finish
GTlsCertificate* (* lookup_certificate_issuer_finish) (
    GTlsDatabase* self,
    GAsyncResult* result,
    GError** error
  )
  No description available.
lookup_certificates_issued_by
GList* (* lookup_certificates_issued_by) (
    GTlsDatabase* self,
    GByteArray* issuer_raw_dn,
    GTlsInteraction* interaction,
    GTlsDatabaseLookupFlags flags,
    GCancellable* cancellable,
    GError** error
  )
  No description available.
lookup_certificates_issued_by_async
void (* lookup_certificates_issued_by_async) (
    GTlsDatabase* self,
    GByteArray* issuer_raw_dn,
    GTlsInteraction* interaction,
    GTlsDatabaseLookupFlags flags,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  )
  No description available.
lookup_certificates_issued_by_finish
GList* (* lookup_certificates_issued_by_finish) (
    GTlsDatabase* self,
    GAsyncResult* result,
    GError** error
  )
  No description available.

Virtual methods

Gio.TlsDatabaseClass.create_certificate_handle

Create a handle string for the certificate. The database will only be able to create a handle for certificates that originate from the database. In cases where the database cannot create a handle for a certificate, NULL will be returned.

Available since: 2.30

Gio.TlsDatabaseClass.lookup_certificate_for_handle

Look up a certificate by its handle.

Available since: 2.30

Gio.TlsDatabaseClass.lookup_certificate_for_handle_async

Asynchronously look up a certificate by its handle in the database. See g_tls_database_lookup_certificate_for_handle() for more information.

Available since: 2.30

Gio.TlsDatabaseClass.lookup_certificate_for_handle_finish

Finish an asynchronous lookup of a certificate by its handle. See g_tls_database_lookup_certificate_for_handle() for more information.

Available since: 2.30

Gio.TlsDatabaseClass.lookup_certificate_issuer

Look up the issuer of certificate in the database. The GTlsCertificate:issuer property of certificate is not modified, and the two certificates are not hooked into a chain.

Available since: 2.30

Gio.TlsDatabaseClass.lookup_certificate_issuer_async

Asynchronously look up the issuer of certificate in the database. See g_tls_database_lookup_certificate_issuer() for more information.

Available since: 2.30

Gio.TlsDatabaseClass.lookup_certificate_issuer_finish

Finish an asynchronous lookup issuer operation. See g_tls_database_lookup_certificate_issuer() for more information.

Available since: 2.30

Gio.TlsDatabaseClass.lookup_certificates_issued_by

Look up certificates issued by this issuer in the database.

Available since: 2.30

Gio.TlsDatabaseClass.lookup_certificates_issued_by_async

Asynchronously look up certificates issued by this issuer in the database. See g_tls_database_lookup_certificates_issued_by() for more information.

Available since: 2.30

Gio.TlsDatabaseClass.lookup_certificates_issued_by_finish

Finish an asynchronous lookup of certificates. See g_tls_database_lookup_certificates_issued_by() for more information.

Available since: 2.30

Gio.TlsDatabaseClass.verify_chain

Determines the validity of a certificate chain, outside the context of a TLS session.

Available since: 2.30

Gio.TlsDatabaseClass.verify_chain_async

Asynchronously determines the validity of a certificate chain after looking up and adding any missing certificates to the chain. See g_tls_database_verify_chain() for more information.

Available since: 2.30

Gio.TlsDatabaseClass.verify_chain_finish

Finish an asynchronous verify chain operation. See g_tls_database_verify_chain() for more information.

Available since: 2.30