1 | /* GDBus - GLib D-Bus Library |
2 | * |
3 | * Copyright (C) 2008-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.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: David Zeuthen <davidz@redhat.com> |
19 | */ |
20 | |
21 | #ifndef __G_DBUS_AUTH_H__ |
22 | #define __G_DBUS_AUTH_H__ |
23 | |
24 | #if !defined (GIO_COMPILATION) |
25 | #error "gdbusauth.h is a private header file." |
26 | #endif |
27 | |
28 | #include <gio/giotypes.h> |
29 | |
30 | G_BEGIN_DECLS |
31 | |
32 | #define G_TYPE_DBUS_AUTH (_g_dbus_auth_get_type ()) |
33 | #define G_DBUS_AUTH(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_DBUS_AUTH, GDBusAuth)) |
34 | #define G_DBUS_AUTH_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_DBUS_AUTH, GDBusAuthClass)) |
35 | #define G_DBUS_AUTH_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_DBUS_AUTH, GDBusAuthClass)) |
36 | #define G_IS_DBUS_AUTH(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_DBUS_AUTH)) |
37 | #define G_IS_DBUS_AUTH_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_DBUS_AUTH)) |
38 | |
39 | typedef struct _GDBusAuth GDBusAuth; |
40 | typedef struct _GDBusAuthClass GDBusAuthClass; |
41 | typedef struct _GDBusAuthPrivate GDBusAuthPrivate; |
42 | |
43 | struct _GDBusAuthClass |
44 | { |
45 | /*< private >*/ |
46 | GObjectClass parent_class; |
47 | }; |
48 | |
49 | struct _GDBusAuth |
50 | { |
51 | GObject parent_instance; |
52 | GDBusAuthPrivate *priv; |
53 | }; |
54 | |
55 | GType _g_dbus_auth_get_type (void) G_GNUC_CONST; |
56 | GDBusAuth *_g_dbus_auth_new (GIOStream *stream); |
57 | |
58 | /* TODO: need a way to set allowed authentication mechanisms */ |
59 | |
60 | /* TODO: need a way to convey credentials etc. */ |
61 | |
62 | /* TODO: need a way to convey negotiated features (e.g. returning flags from e.g. GDBusConnectionFeatures) */ |
63 | |
64 | /* TODO: need to expose encode()/decode() from the AuthMechanism (and whether it is needed at all) */ |
65 | |
66 | gboolean _g_dbus_auth_run_server (GDBusAuth *auth, |
67 | GDBusAuthObserver *observer, |
68 | const gchar *guid, |
69 | gboolean allow_anonymous, |
70 | gboolean require_same_user, |
71 | GDBusCapabilityFlags offered_capabilities, |
72 | GDBusCapabilityFlags *out_negotiated_capabilities, |
73 | GCredentials **out_received_credentials, |
74 | GCancellable *cancellable, |
75 | GError **error); |
76 | |
77 | gchar *_g_dbus_auth_run_client (GDBusAuth *auth, |
78 | GDBusAuthObserver *observer, |
79 | GDBusCapabilityFlags offered_capabilities, |
80 | GDBusCapabilityFlags *out_negotiated_capabilities, |
81 | GCancellable *cancellable, |
82 | GError **error); |
83 | |
84 | G_END_DECLS |
85 | |
86 | #endif /* __G_DBUS_AUTH_H__ */ |
87 | |