Gio.TlsDatabase (original) (raw)

Class

GioTlsDatabase

since: 2.30

Description [src]

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

GTlsDatabase is used to look up certificates and other information from a certificate or key store. It is an abstract base class whichTLS 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 withGTlsDatabase. It is used internally by GTlsConnection.

Available since: 2.30

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, NULLwill be returned.

since: 2.30

g_tls_database_lookup_certificate_issuer

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

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. Seeg_tls_database_verify_chain() for more information.

since: 2.30

Methods inherited from GObject (43)

Please see GObject for a full list of methods.

Signals

Signals inherited from GObject (1)

GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

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
  );
  
}

The class for GTlsDatabase. Derived classes should implement the various virtual methods. _async and _finish methods have a default implementation that runs the corresponding sync method in a thread.

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 )

Virtual method implementing g_tls_database_verify_chain().

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 )

Virtual method implementing g_tls_database_verify_chain_async().

verify_chain_finish: GTlsCertificateFlags (* verify_chain_finish) ( GTlsDatabase* self, GAsyncResult* result, GError** error )

Virtual method implementing g_tls_database_verify_chain_finish().

create_certificate_handle: gchar* (* create_certificate_handle) ( GTlsDatabase* self, GTlsCertificate* certificate )

Virtual method implementing g_tls_database_create_certificate_handle().

lookup_certificate_for_handle: GTlsCertificate* (* lookup_certificate_for_handle) ( GTlsDatabase* self, const gchar* handle, GTlsInteraction* interaction, GTlsDatabaseLookupFlags flags, GCancellable* cancellable, GError** error )

Virtual method implementing g_tls_database_lookup_certificate_for_handle().

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 )

Virtual method implementing g_tls_database_lookup_certificate_for_handle_async().

lookup_certificate_for_handle_finish: GTlsCertificate* (* lookup_certificate_for_handle_finish) ( GTlsDatabase* self, GAsyncResult* result, GError** error )

Virtual method implementing g_tls_database_lookup_certificate_for_handle_finish().

lookup_certificate_issuer: GTlsCertificate* (* lookup_certificate_issuer) ( GTlsDatabase* self, GTlsCertificate* certificate, GTlsInteraction* interaction, GTlsDatabaseLookupFlags flags, GCancellable* cancellable, GError** error )

Virtual method implementing g_tls_database_lookup_certificate_issuer().

lookup_certificate_issuer_async: void (* lookup_certificate_issuer_async) ( GTlsDatabase* self, GTlsCertificate* certificate, GTlsInteraction* interaction, GTlsDatabaseLookupFlags flags, GCancellable* cancellable, GAsyncReadyCallback callback, gpointer user_data )

Virtual method implementing g_tls_database_lookup_certificate_issuer_async().

lookup_certificate_issuer_finish: GTlsCertificate* (* lookup_certificate_issuer_finish) ( GTlsDatabase* self, GAsyncResult* result, GError** error )

Virtual method implementing g_tls_database_lookup_certificate_issuer_finish().

lookup_certificates_issued_by: GList* (* lookup_certificates_issued_by) ( GTlsDatabase* self, GByteArray* issuer_raw_dn, GTlsInteraction* interaction, GTlsDatabaseLookupFlags flags, GCancellable* cancellable, GError** error )

Virtual method implementing g_tls_database_lookup_certificates_issued_by().

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 )

Virtual method implementing g_tls_database_lookup_certificates_issued_by_async().

lookup_certificates_issued_by_finish: GList* (* lookup_certificates_issued_by_finish) ( GTlsDatabase* self, GAsyncResult* result, GError** error )

Virtual method implementing g_tls_database_lookup_certificates_issued_by_finish().

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, NULLwill be returned.

since: 2.30

Gio.TlsDatabaseClass.lookup_certificate_issuer

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

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. Seeg_tls_database_verify_chain() for more information.

since: 2.30