Function

Gcrtrust_is_certificate_pinned

Declaration [src]

gboolean
gcr_trust_is_certificate_pinned (
  GcrCertificate* certificate,
  const gchar* purpose,
  const gchar* peer,
  GCancellable* cancellable,
  GError** error
)

Description [src]

Check if certificate is pinned for purpose to communicate with peer. A pinned certificate overrides all other certificate verification.

This call may block, see gcr_trust_is_certificate_pinned_async() for the non-blocking version.

In the case of an error, FALSE is also returned. Check error to detect if an error occurred.

Parameters

certificate

Type: GcrCertificate

A GcrCertificate to check.

The data is owned by the caller of the function.
purpose

Type: const gchar*

The purpose string.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
peer

Type: const gchar*

The peer for this pinned.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
cancellable

Type: GCancellable

A GCancellable.

The argument can be NULL.
The data is owned by the caller of the function.
error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.
If the return location is not NULL, then you must initialize it to a NULL GError*.
The argument will be left initialized to NULL by the function if there are no errors.
In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.

Return value

Type: gboolean

TRUE if the certificate is pinned for the host and purpose.