glib: Improve documentation for g_strfreev()
[platform/upstream/glib.git] / gio / gtlscertificate.h
1 /* GIO - GLib Input, Output and Streaming Library
2  *
3  * Copyright (C) 2010 Red Hat, Inc.
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General
16  * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
17  */
18
19 #ifndef __G_TLS_CERTIFICATE_H__
20 #define __G_TLS_CERTIFICATE_H__
21
22 #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
23 #error "Only <gio/gio.h> can be included directly."
24 #endif
25
26 #include <gio/giotypes.h>
27
28 G_BEGIN_DECLS
29
30 #define G_TYPE_TLS_CERTIFICATE            (g_tls_certificate_get_type ())
31 #define G_TLS_CERTIFICATE(inst)           (G_TYPE_CHECK_INSTANCE_CAST ((inst), G_TYPE_TLS_CERTIFICATE, GTlsCertificate))
32 #define G_TLS_CERTIFICATE_CLASS(class)    (G_TYPE_CHECK_CLASS_CAST ((class), G_TYPE_TLS_CERTIFICATE, GTlsCertificateClass))
33 #define G_IS_TLS_CERTIFICATE(inst)        (G_TYPE_CHECK_INSTANCE_TYPE ((inst), G_TYPE_TLS_CERTIFICATE))
34 #define G_IS_TLS_CERTIFICATE_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_TLS_CERTIFICATE))
35 #define G_TLS_CERTIFICATE_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), G_TYPE_TLS_CERTIFICATE, GTlsCertificateClass))
36
37 typedef struct _GTlsCertificateClass   GTlsCertificateClass;
38 typedef struct _GTlsCertificatePrivate GTlsCertificatePrivate;
39
40 struct _GTlsCertificate {
41   GObject parent_instance;
42
43   GTlsCertificatePrivate *priv;
44 };
45
46 struct _GTlsCertificateClass
47 {
48   GObjectClass parent_class;
49
50   GTlsCertificateFlags  (* verify) (GTlsCertificate     *cert,
51                                     GSocketConnectable  *identity,
52                                     GTlsCertificate     *trusted_ca);
53
54   /*< private >*/
55   /* Padding for future expansion */
56   gpointer padding[8];
57 };
58
59 GLIB_AVAILABLE_IN_ALL
60 GType                 g_tls_certificate_get_type           (void) G_GNUC_CONST;
61
62 GLIB_AVAILABLE_IN_ALL
63 GTlsCertificate      *g_tls_certificate_new_from_pem       (const gchar         *data,
64                                                             gssize               length,
65                                                             GError             **error);
66
67 GLIB_AVAILABLE_IN_ALL
68 GTlsCertificate      *g_tls_certificate_new_from_file      (const gchar         *file,
69                                                             GError             **error);
70 GLIB_AVAILABLE_IN_ALL
71 GTlsCertificate      *g_tls_certificate_new_from_files     (const gchar         *cert_file,
72                                                             const gchar         *key_file,
73                                                             GError             **error);
74 GLIB_AVAILABLE_IN_ALL
75 GList                *g_tls_certificate_list_new_from_file (const gchar         *file,
76                                                             GError             **error);
77
78 GLIB_AVAILABLE_IN_ALL
79 GTlsCertificate      *g_tls_certificate_get_issuer         (GTlsCertificate     *cert);
80
81 GLIB_AVAILABLE_IN_ALL
82 GTlsCertificateFlags  g_tls_certificate_verify             (GTlsCertificate     *cert,
83                                                             GSocketConnectable  *identity,
84                                                             GTlsCertificate     *trusted_ca);
85
86 GLIB_AVAILABLE_IN_2_34
87 gboolean              g_tls_certificate_is_same            (GTlsCertificate     *cert_one,
88                                                             GTlsCertificate     *cert_two);
89
90 G_END_DECLS
91
92 #endif /* __G_TLS_CERTIFICATE_H__ */