glib/gio/gtlspassword.h
Stef Walter 0f99cfa882 GTlsDatabase and related objects
The database is an abstract object implemented by the various TLS
backends, which is used by GTlsConnection to lookup certificates
and keys, as well as verify certificate chains.

Also add GTlsInteraction, which can be used to prompt the user
for a password or PIN (used with the database).

https://bugzilla.gnome.org/show_bug.cgi?id=636572
2011-08-04 08:54:55 +02:00

102 lines
4.2 KiB
C

/* GIO - GLib Input, Output and Streaming Library
*
* Copyright (C) 2011 Collabora, Ltd.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General
* Public License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place, Suite 330,
* Boston, MA 02111-1307, USA.
*
* Author: Stef Walter <stefw@collabora.co.uk>
*/
#if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
#error "Only <gio/gio.h> can be included directly."
#endif
#ifndef __G_TLS_PASSWORD_H__
#define __G_TLS_PASSWORD_H__
#include <gio/giotypes.h>
G_BEGIN_DECLS
#define G_TYPE_TLS_PASSWORD (g_tls_password_get_type ())
#define G_TLS_PASSWORD(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_TLS_PASSWORD, GTlsPassword))
#define G_TLS_PASSWORD_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_TLS_PASSWORD, GTlsPasswordClass))
#define G_IS_TLS_PASSWORD(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_TLS_PASSWORD))
#define G_IS_TLS_PASSWORD_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_TLS_PASSWORD))
#define G_TLS_PASSWORD_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_TLS_PASSWORD, GTlsPasswordClass))
typedef struct _GTlsPasswordClass GTlsPasswordClass;
typedef struct _GTlsPasswordPrivate GTlsPasswordPrivate;
struct _GTlsPassword
{
GObject parent_instance;
GTlsPasswordPrivate *priv;
};
struct _GTlsPasswordClass
{
GObjectClass parent_class;
/* methods */
const guchar * ( *get_value) (GTlsPassword *password,
gsize *length);
void ( *set_value) (GTlsPassword *password,
guchar *value,
gssize length,
GDestroyNotify destroy);
const gchar* ( *get_default_warning) (GTlsPassword *password);
/*< private >*/
/* Padding for future expansion */
gpointer padding[4];
};
GType g_tls_password_get_type (void) G_GNUC_CONST;
GTlsPassword * g_tls_password_new (GTlsPasswordFlags flags,
const gchar *description);
const guchar * g_tls_password_get_value (GTlsPassword *password,
gsize *length);
void g_tls_password_set_value (GTlsPassword *password,
const guchar *value,
gssize length);
void g_tls_password_set_value_full (GTlsPassword *password,
guchar *value,
gssize length,
GDestroyNotify destroy);
GTlsPasswordFlags g_tls_password_get_flags (GTlsPassword *password);
void g_tls_password_set_flags (GTlsPassword *password,
GTlsPasswordFlags flags);
const gchar* g_tls_password_get_description (GTlsPassword *password);
void g_tls_password_set_description (GTlsPassword *password,
const gchar *description);
const gchar * g_tls_password_get_warning (GTlsPassword *password);
void g_tls_password_set_warning (GTlsPassword *password,
const gchar *warning);
G_END_DECLS
#endif /* __G_TLS_PASSWORD_H__ */