diff options
Diffstat (limited to 'gir/gio-2.0.c')
| -rw-r--r-- | gir/gio-2.0.c | 34 |
1 files changed, 28 insertions, 6 deletions
diff --git a/gir/gio-2.0.c b/gir/gio-2.0.c index 105a47c1..78528551 100644 --- a/gir/gio-2.0.c +++ b/gir/gio-2.0.c @@ -12380,6 +12380,10 @@ * * Checks if two #GAppInfos are equal. * + * Note that the check <em>may not</em> compare each individual field, and + * only does an identity check. In case detecting changes in the contents + * is needed, program code must additionally compare relevant fields. + * * Returns: %TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise. */ @@ -40012,8 +40016,8 @@ * @cancellable: (nullable): a #GCancellable, or %NULL * @error: (nullable): a #GError, or %NULL * - * Verify's a certificate chain after looking up and adding any missing - * certificates to the chain. + * Determines the validity of a certificate chain after looking up and + * adding any missing certificates to the chain. * * @chain is a chain of #GTlsCertificate objects each pointing to the next * certificate in the chain by its %issuer property. The chain may initially @@ -40034,6 +40038,15 @@ * Currently there are no @flags, and %G_TLS_DATABASE_VERIFY_NONE should be * used. * + * If @chain is found to be valid, then the return value will be 0. If + * @chain is found to be invalid, then the return value will indicate + * the problems found. If the function is unable to determine whether + * @chain is valid or not (eg, because @cancellable is triggered + * before it completes) then the return value will be + * %G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set + * accordingly. @error is not set when @chain is successfully analyzed + * but found to be invalid. + * * This function can block, use g_tls_database_verify_chain_async() to perform * the verification operation asynchronously. * @@ -40055,9 +40068,9 @@ * @callback: callback to call when the operation completes * @user_data: the data to pass to the callback function * - * Asynchronously verify's a certificate chain after looking up and adding - * any missing certificates to the chain. See g_tls_database_verify_chain() - * for more information. + * 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. * * Since: 2.30 */ @@ -40070,7 +40083,16 @@ * @error: a #GError pointer, or %NULL * * Finish an asynchronous verify chain operation. See - * g_tls_database_verify_chain() for more information. * + * g_tls_database_verify_chain() for more information. + * + * If @chain is found to be valid, then the return value will be 0. If + * @chain is found to be invalid, then the return value will indicate + * the problems found. If the function is unable to determine whether + * @chain is valid or not (eg, because @cancellable is triggered + * before it completes) then the return value will be + * %G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set + * accordingly. @error is not set when @chain is successfully analyzed + * but found to be invalid. * * Returns: the appropriate #GTlsCertificateFlags which represents the * result of verification. |