libpurple/tls-certificate.h

branch
purple-ssl-to-gio
changeset 37622
14d1273cae74
parent 37621
2a2f1068e0f0
child 37632
4879ef4db7cf
--- a/libpurple/tls-certificate.h	Tue Feb 16 17:48:03 2016 -0600
+++ b/libpurple/tls-certificate.h	Tue Mar 29 22:51:43 2016 -0500
@@ -118,6 +118,70 @@
 gpointer
 purple_tls_certificate_attach_to_socket_client(GSocketClient *client);
 
+
+/**
+ * PurpleTlsCertificateInfo
+ *
+ * An opaque structure to contain parsed certificate info, which
+ * can subsequently be accessed by purple_tls_certificate_info_*
+ * functions.
+ */
+typedef struct _PurpleTlsCertificateInfo PurpleTlsCertificateInfo;
+
+/**
+ * purple_tls_certificate_get_info:
+ * @certificate: Certificate from which to parse the info
+ *
+ * Returns a #PurpleTlsCertificateInfo containing parsed information
+ * of the certificate.
+ *
+ * Returns: #PurpleTlsCertificateInfo parsed from the certificate
+ */
+PurpleTlsCertificateInfo *
+purple_tls_certificate_get_info(GTlsCertificate *certificate);
+
+/**
+ * purple_tls_certificate_info_free:
+ * @info: #PurpleTlsCertificateInfo object to free
+ *
+ * Frees @info.
+ */
+void
+purple_tls_certificate_info_free(PurpleTlsCertificateInfo *info);
+
+/**
+ * purple_tls_certificate_info_get_display_string:
+ * @info: #PurpleTlsCertificateInfo from which to generate a display string
+ *
+ * Generates a user readable string to display information from @info
+ *
+ * Returns: A user readable string suitable to display to the user
+ */
+gchar *
+purple_tls_certificate_info_get_display_string(PurpleTlsCertificateInfo *info);
+
+/**
+ * purple_tls_certificate_get_subject_name:
+ * @certificate: Certificate from which to get the subject name
+ *
+ * Returns the common subject name of the cert
+ *
+ * Returns: The subject name of the cert
+ */
+gchar *
+purple_tls_certificate_info_get_subject_name(PurpleTlsCertificateInfo *info);
+
+/**
+ * purple_tls_certificate_get_fingerprint_sha1:
+ * @certificate: Certificate from which to get the SHA1 fingerprint
+ *
+ * Returns the SHA1 fingerprint of the cert
+ *
+ * Returns: The SHA1 fingerprint of the cert
+ */
+GByteArray *
+purple_tls_certificate_get_fingerprint_sha1(GTlsCertificate *certificate);
+
 G_END_DECLS
 
 #endif /* _PURPLE_TLS_CERTIFICATE_H */

mercurial