Add "Since: 2.26" to all new GDBus API
[platform/upstream/glib.git] / gio / gcredentials.h
1 /* GDBus - GLib D-Bus Library
2  *
3  * Copyright (C) 2008-2009 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, write to the
17  * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
18  * Boston, MA 02111-1307, USA.
19  *
20  * Author: David Zeuthen <davidz@redhat.com>
21  */
22
23 #ifndef __G_CREDENTIALS_H__
24 #define __G_CREDENTIALS_H__
25
26 #include <gio/giotypes.h>
27
28 G_BEGIN_DECLS
29
30 #define G_TYPE_CREDENTIALS         (g_credentials_get_type ())
31 #define G_CREDENTIALS(o)           (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_CREDENTIALS, GCredentials))
32 #define G_CREDENTIALS_CLASS(k)     (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_CREDENTIALS, GCredentialsClass))
33 #define G_CREDENTIALS_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_CREDENTIALS, GCredentialsClass))
34 #define G_IS_CREDENTIALS(o)        (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_CREDENTIALS))
35 #define G_IS_CREDENTIALS_CLASS(k)  (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_CREDENTIALS))
36
37 typedef struct _GCredentialsClass   GCredentialsClass;
38 typedef struct _GCredentialsPrivate GCredentialsPrivate;
39
40 /**
41  * GCredentials:
42  *
43  * The #GCredentials structure contains only private data and
44  * should only be accessed using the provided API.
45  *
46  * Since: 2.26
47  */
48 struct _GCredentials
49 {
50   /*< private >*/
51   GObject parent_instance;
52   GCredentialsPrivate *priv;
53 };
54
55 /**
56  * GCredentialsClass:
57  *
58  * Class structure for #GCredentials.
59  *
60  * Since: 2.26
61  */
62 struct _GCredentialsClass
63 {
64   /*< private >*/
65   GObjectClass parent_class;
66
67   /* Padding for future expansion */
68   void (*_g_reserved1) (void);
69   void (*_g_reserved2) (void);
70   void (*_g_reserved3) (void);
71   void (*_g_reserved4) (void);
72   void (*_g_reserved5) (void);
73   void (*_g_reserved6) (void);
74   void (*_g_reserved7) (void);
75   void (*_g_reserved8) (void);
76 };
77
78 GType            g_credentials_get_type           (void) G_GNUC_CONST;
79
80 GCredentials    *g_credentials_new                (void);
81 GCredentials    *g_credentials_new_for_process    (void);
82 GCredentials    *g_credentials_new_for_string     (const gchar  *str,
83                                                    GError      **error);
84 gchar           *g_credentials_to_string          (GCredentials    *credentials);
85
86 gboolean         g_credentials_has_unix_user      (GCredentials    *credentials);
87 gint64           g_credentials_get_unix_user      (GCredentials    *credentials);
88 void             g_credentials_set_unix_user      (GCredentials    *credentials,
89                                                    gint64           user_id);
90
91 gboolean         g_credentials_has_unix_group     (GCredentials    *credentials);
92 gint64           g_credentials_get_unix_group     (GCredentials    *credentials);
93 void             g_credentials_set_unix_group     (GCredentials    *credentials,
94                                                    gint64           group_id);
95
96 gboolean         g_credentials_has_unix_process   (GCredentials    *credentials);
97 gint64           g_credentials_get_unix_process   (GCredentials    *credentials);
98 void             g_credentials_set_unix_process   (GCredentials    *credentials,
99                                                    gint64           process_id);
100
101 gboolean         g_credentials_has_windows_user   (GCredentials    *credentials);
102 const gchar     *g_credentials_get_windows_user   (GCredentials    *credentials);
103 void             g_credentials_set_windows_user   (GCredentials    *credentials,
104                                                    const gchar     *user_sid);
105
106 G_END_DECLS
107
108 #endif /* __G_DBUS_PROXY_H__ */