| 1 | /* GIO - GLib Input, Output and Streaming Library | 
| 2 |  * | 
| 3 |  * Copyright (C) 2011 Collabora, Ltd. | 
| 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.1 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 |  * Author: Stef Walter <stefw@collabora.co.uk> | 
| 19 |  */ | 
| 20 |  | 
| 21 | #ifndef __G_TLS_PASSWORD_H__ | 
| 22 | #define __G_TLS_PASSWORD_H__ | 
| 23 |  | 
| 24 | #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) | 
| 25 | #error "Only <gio/gio.h> can be included directly." | 
| 26 | #endif | 
| 27 |  | 
| 28 | #include <gio/giotypes.h> | 
| 29 |  | 
| 30 | G_BEGIN_DECLS | 
| 31 |  | 
| 32 | #define G_TYPE_TLS_PASSWORD         (g_tls_password_get_type ()) | 
| 33 | #define G_TLS_PASSWORD(o)           (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_TLS_PASSWORD, GTlsPassword)) | 
| 34 | #define G_TLS_PASSWORD_CLASS(k)     (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_TLS_PASSWORD, GTlsPasswordClass)) | 
| 35 | #define G_IS_TLS_PASSWORD(o)        (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_TLS_PASSWORD)) | 
| 36 | #define G_IS_TLS_PASSWORD_CLASS(k)  (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_TLS_PASSWORD)) | 
| 37 | #define G_TLS_PASSWORD_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_TLS_PASSWORD, GTlsPasswordClass)) | 
| 38 |  | 
| 39 | typedef struct _GTlsPasswordClass   GTlsPasswordClass; | 
| 40 | typedef struct _GTlsPasswordPrivate GTlsPasswordPrivate; | 
| 41 |  | 
| 42 | struct _GTlsPassword | 
| 43 | { | 
| 44 |   GObject parent_instance; | 
| 45 |  | 
| 46 |   GTlsPasswordPrivate *priv; | 
| 47 | }; | 
| 48 |  | 
| 49 | /** | 
| 50 |  * GTlsPasswordClass: | 
| 51 |  * @get_value: virtual method for g_tls_password_get_value() | 
| 52 |  * @set_value: virtual method for g_tls_password_set_value() | 
| 53 |  * @get_default_warning: virtual method for g_tls_password_get_warning() if no | 
| 54 |  *  value has been set using g_tls_password_set_warning() | 
| 55 |  * | 
| 56 |  * Class structure for #GTlsPassword. | 
| 57 |  */ | 
| 58 | struct _GTlsPasswordClass | 
| 59 | { | 
| 60 |   GObjectClass parent_class; | 
| 61 |  | 
| 62 |   /* methods */ | 
| 63 |  | 
| 64 |   const guchar *    ( *get_value)            (GTlsPassword  *password, | 
| 65 |                                               gsize         *length); | 
| 66 |  | 
| 67 |   void              ( *set_value)            (GTlsPassword  *password, | 
| 68 |                                               guchar        *value, | 
| 69 |                                               gssize         length, | 
| 70 |                                               GDestroyNotify destroy); | 
| 71 |  | 
| 72 |   const gchar*      ( *get_default_warning)  (GTlsPassword  *password); | 
| 73 |  | 
| 74 |   /*< private >*/ | 
| 75 |   /* Padding for future expansion */ | 
| 76 |   gpointer padding[4]; | 
| 77 | }; | 
| 78 |  | 
| 79 | GLIB_AVAILABLE_IN_ALL | 
| 80 | GType             g_tls_password_get_type            (void) G_GNUC_CONST; | 
| 81 |  | 
| 82 | GLIB_AVAILABLE_IN_ALL | 
| 83 | GTlsPassword *    g_tls_password_new                 (GTlsPasswordFlags  flags, | 
| 84 |                                                       const gchar       *description); | 
| 85 |  | 
| 86 | GLIB_AVAILABLE_IN_ALL | 
| 87 | const guchar *    g_tls_password_get_value           (GTlsPassword      *password, | 
| 88 |                                                       gsize             *length); | 
| 89 | GLIB_AVAILABLE_IN_ALL | 
| 90 | void              g_tls_password_set_value           (GTlsPassword      *password, | 
| 91 |                                                       const guchar      *value, | 
| 92 |                                                       gssize             length); | 
| 93 | GLIB_AVAILABLE_IN_ALL | 
| 94 | void              g_tls_password_set_value_full      (GTlsPassword      *password, | 
| 95 |                                                       guchar            *value, | 
| 96 |                                                       gssize             length, | 
| 97 |                                                       GDestroyNotify     destroy); | 
| 98 |  | 
| 99 | GLIB_AVAILABLE_IN_ALL | 
| 100 | GTlsPasswordFlags g_tls_password_get_flags           (GTlsPassword      *password); | 
| 101 | GLIB_AVAILABLE_IN_ALL | 
| 102 | void              g_tls_password_set_flags           (GTlsPassword      *password, | 
| 103 |                                                       GTlsPasswordFlags  flags); | 
| 104 |  | 
| 105 | GLIB_AVAILABLE_IN_ALL | 
| 106 | const gchar*      g_tls_password_get_description     (GTlsPassword      *password); | 
| 107 | GLIB_AVAILABLE_IN_ALL | 
| 108 | void              g_tls_password_set_description     (GTlsPassword      *password, | 
| 109 |                                                       const gchar       *description); | 
| 110 |  | 
| 111 | GLIB_AVAILABLE_IN_ALL | 
| 112 | const gchar *     g_tls_password_get_warning         (GTlsPassword      *password); | 
| 113 | GLIB_AVAILABLE_IN_ALL | 
| 114 | void              g_tls_password_set_warning         (GTlsPassword      *password, | 
| 115 |                                                       const gchar       *warning); | 
| 116 |  | 
| 117 | G_END_DECLS | 
| 118 |  | 
| 119 | #endif /* __G_TLS_PASSWORD_H__ */ | 
| 120 |  |