summary refs log tree commit diff
path: root/libnm/nm-secret-agent-old.h
diff options
context:
space:
mode:
authorMichael Biebl <biebl@debian.org>2021-10-01 23:05:04 +0200
committerMichael Biebl <biebl@debian.org>2021-10-01 23:05:04 +0200
commite74c568b07b50b97873fb4ee1d776dedefbd54d6 (patch)
tree3469f17ea9af91f7ff169b890633bda68b0cf76e /libnm/nm-secret-agent-old.h
parentbfe522304da217296e2a61040f58e35ec5d6f3f2 (diff)
New upstream version 1.32.12 upstream/1.32.12
Diffstat (limited to 'libnm/nm-secret-agent-old.h')
-rw-r--r--libnm/nm-secret-agent-old.h263
1 files changed, 0 insertions, 263 deletions
diff --git a/libnm/nm-secret-agent-old.h b/libnm/nm-secret-agent-old.h
deleted file mode 100644
index cc33c14a..00000000
--- a/libnm/nm-secret-agent-old.h
+++ /dev/null
@@ -1,263 +0,0 @@
-/* SPDX-License-Identifier: LGPL-2.1-or-later */
-/*
- * Copyright (C) 2010 - 2011 Red Hat, Inc.
- */
-
-#ifndef __NM_SECRET_AGENT_OLD_H__
-#define __NM_SECRET_AGENT_OLD_H__
-
-#include "nm-types.h"
-
-G_BEGIN_DECLS
-
-#define NM_TYPE_SECRET_AGENT_OLD (nm_secret_agent_old_get_type())
-#define NM_SECRET_AGENT_OLD(obj) \
-    (G_TYPE_CHECK_INSTANCE_CAST((obj), NM_TYPE_SECRET_AGENT_OLD, NMSecretAgentOld))
-#define NM_SECRET_AGENT_OLD_CLASS(klass) \
-    (G_TYPE_CHECK_CLASS_CAST((klass), NM_TYPE_SECRET_AGENT_OLD, NMSecretAgentOldClass))
-#define NM_IS_SECRET_AGENT_OLD(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), NM_TYPE_SECRET_AGENT_OLD))
-#define NM_IS_SECRET_AGENT_OLD_CLASS(klass) \
-    (G_TYPE_CHECK_CLASS_TYPE((klass), NM_TYPE_SECRET_AGENT_OLD))
-#define NM_SECRET_AGENT_OLD_GET_CLASS(obj) \
-    (G_TYPE_INSTANCE_GET_CLASS((obj), NM_TYPE_SECRET_AGENT_OLD, NMSecretAgentOldClass))
-
-#define NM_SECRET_AGENT_OLD_IDENTIFIER      "identifier"
-#define NM_SECRET_AGENT_OLD_AUTO_REGISTER   "auto-register"
-#define NM_SECRET_AGENT_OLD_REGISTERED      "registered"
-#define NM_SECRET_AGENT_OLD_CAPABILITIES    "capabilities"
-#define NM_SECRET_AGENT_OLD_DBUS_CONNECTION "dbus-connection"
-
-/**
- * NMSecretAgentOld:
- */
-typedef struct {
-    GObject parent;
-} NMSecretAgentOld;
-
-/**
- * NMSecretAgentOldGetSecretsFunc:
- * @agent: the secret agent object
- * @connection: (transfer none): the connection for which secrets were requested,
- * note that this object will be unrefed after the callback has returned, use
- * g_object_ref()/g_object_unref() if you want to use this object after the callback
- * has returned
- * @secrets: the #GVariant of type %NM_VARIANT_TYPE_CONNECTION containing the requested
- * secrets (as created by nm_connection_to_dbus() for example).  Each key in @secrets
- * should be the name of a #NMSetting object (like "802-11-wireless-security")
- * and each value should be an %NM_VARIANT_TYPE_SETTING variant.  The sub-dicts
- * map string:value, where the string is the setting property name (like "psk")
- * and the value is the secret
- * @error: if the secrets request failed, give a descriptive error here
- * @user_data: caller-specific data to be passed to the function
- *
- * Called as a result of a request by NM to retrieve secrets.  When the
- * #NMSecretAgentOld subclass has finished retrieving secrets and is ready to
- * return them, or to return an error, this function should be called with
- * those secrets or the error.
- *
- * To easily create the dictionary to return the Wi-Fi PSK, you could do
- * something like this:
- * <example>
- *  <title>Creating a secrets dictionary</title>
- *  <programlisting>
- *   NMConnection *secrets;
- *   NMSettingWirelessSecurity *s_wsec;
- *   GVariant *secrets_dict;
- *
- *   secrets = nm_simple_connection_new ();
- *   s_wsec = (NMSettingWirelessSecurity *) nm_setting_wireless_security_new ();
- *   g_object_set (G_OBJECT (s_wsec),
- *                 NM_SETTING_WIRELESS_SECURITY_PSK, "my really cool PSK",
- *                 NULL);
- *   nm_connection_add_setting (secrets, NM_SETTING (s_wsec));
- *   secrets_dict = nm_connection_to_dbus (secrets, NM_CONNECTION_SERIALIZE_ALL);
- *
- *   (call the NMSecretAgentOldGetSecretsFunc with secrets_dict)
- *
- *   g_object_unref (secrets);
- *   g_variant_unref (secrets_dict);
- *  </programlisting>
- * </example>
- */
-typedef void (*NMSecretAgentOldGetSecretsFunc)(NMSecretAgentOld *agent,
-                                               NMConnection *    connection,
-                                               GVariant *        secrets,
-                                               GError *          error,
-                                               gpointer          user_data);
-
-/**
- * NMSecretAgentOldSaveSecretsFunc:
- * @agent: the secret agent object
- * @connection: (transfer none): the connection for which secrets were to be saved,
- * note that this object will be unrefed after the callback has returned, use
- * g_object_ref()/g_object_unref() if you want to use this object after the callback
- * has returned
- * @error: if the saving secrets failed, give a descriptive error here
- * @user_data: caller-specific data to be passed to the function
- *
- * Called as a result of a request by NM to save secrets.  When the
- * #NMSecretAgentOld subclass has finished saving the secrets, this function
- * should be called.
- */
-typedef void (*NMSecretAgentOldSaveSecretsFunc)(NMSecretAgentOld *agent,
-                                                NMConnection *    connection,
-                                                GError *          error,
-                                                gpointer          user_data);
-
-/**
- * NMSecretAgentOldDeleteSecretsFunc:
- * @agent: the secret agent object
- * @connection: (transfer none): the connection for which secrets were to be deleted,
- * note that this object will be unrefed after the callback has returned, use
- * g_object_ref()/g_object_unref() if you want to use this object after the callback
- * has returned
- * @error: if the deleting secrets failed, give a descriptive error here
- * @user_data: caller-specific data to be passed to the function
- *
- * Called as a result of a request by NM to delete secrets.  When the
- * #NMSecretAgentOld subclass has finished deleting the secrets, this function
- * should be called.
- */
-typedef void (*NMSecretAgentOldDeleteSecretsFunc)(NMSecretAgentOld *agent,
-                                                  NMConnection *    connection,
-                                                  GError *          error,
-                                                  gpointer          user_data);
-
-typedef struct {
-    GObjectClass parent;
-
-    /* Virtual methods for subclasses */
-
-    /* Called when the subclass should retrieve and return secrets.  Subclass
-     * must copy or reference any arguments it may require after returning from
-     * this method, as the arguments will freed (except for 'self', 'callback',
-     * and 'user_data' of course).
-     *
-     * Before version 1.24, if the request is canceled, the callback
-     * should still be called, but with the NM_SECRET_AGENT_ERROR_AGENT_CANCELED
-     * error. Since 1.24, invoking the callback has no effect during cancellation
-     * and may be omitted.
-     */
-    void (*get_secrets)(NMSecretAgentOld *             self,
-                        NMConnection *                 connection,
-                        const char *                   connection_path,
-                        const char *                   setting_name,
-                        const char **                  hints,
-                        NMSecretAgentGetSecretsFlags   flags,
-                        NMSecretAgentOldGetSecretsFunc callback,
-                        gpointer                       user_data);
-
-    /* Called when the subclass should cancel an outstanding request to
-     * get secrets for a given connection.
-     *
-     * Before version 1.24, canceling the request MUST call the callback that was
-     * passed along with the initial get_secrets call, sending the NM_SECRET_AGENT_ERROR/
-     * NM_SECRET_AGENT_ERROR_AGENT_CANCELED error to that callback. Since 1.24,
-     * the get_secrets callback will be ignored during cancellation and may be omitted.
-     */
-    void (*cancel_get_secrets)(NMSecretAgentOld *self,
-                               const char *      connection_path,
-                               const char *      setting_name);
-
-    /* Called when the subclass should save the secrets contained in the
-     * connection to backing storage.  Subclass must copy or reference any
-     * arguments it may require after returning from this method, as the
-     * arguments will freed (except for 'self', 'callback', and 'user_data'
-     * of course).
-     */
-    void (*save_secrets)(NMSecretAgentOld *              self,
-                         NMConnection *                  connection,
-                         const char *                    connection_path,
-                         NMSecretAgentOldSaveSecretsFunc callback,
-                         gpointer                        user_data);
-
-    /* Called when the subclass should delete the secrets contained in the
-     * connection from backing storage.  Subclass must copy or reference any
-     * arguments it may require after returning from this method, as the
-     * arguments will freed (except for 'self', 'callback', and 'user_data'
-     * of course).
-     */
-    void (*delete_secrets)(NMSecretAgentOld *                self,
-                           NMConnection *                    connection,
-                           const char *                      connection_path,
-                           NMSecretAgentOldDeleteSecretsFunc callback,
-                           gpointer                          user_data);
-
-    /*< private >*/
-    gpointer padding[8];
-} NMSecretAgentOldClass;
-
-GType nm_secret_agent_old_get_type(void);
-
-NM_AVAILABLE_IN_1_24
-GDBusConnection *nm_secret_agent_old_get_dbus_connection(NMSecretAgentOld *self);
-
-NM_AVAILABLE_IN_1_24
-GMainContext *nm_secret_agent_old_get_main_context(NMSecretAgentOld *self);
-
-NM_AVAILABLE_IN_1_24
-GObject *nm_secret_agent_old_get_context_busy_watcher(NMSecretAgentOld *self);
-
-NM_AVAILABLE_IN_1_24
-const char *nm_secret_agent_old_get_dbus_name_owner(NMSecretAgentOld *self);
-
-gboolean nm_secret_agent_old_get_registered(NMSecretAgentOld *self);
-
-/*****************************************************************************/
-
-NM_AVAILABLE_IN_1_24
-void nm_secret_agent_old_enable(NMSecretAgentOld *self, gboolean enable);
-
-void nm_secret_agent_old_register_async(NMSecretAgentOld *  self,
-                                        GCancellable *      cancellable,
-                                        GAsyncReadyCallback callback,
-                                        gpointer            user_data);
-gboolean
-nm_secret_agent_old_register_finish(NMSecretAgentOld *self, GAsyncResult *result, GError **error);
-
-NM_AVAILABLE_IN_1_24
-void nm_secret_agent_old_destroy(NMSecretAgentOld *self);
-
-/*****************************************************************************/
-
-NM_DEPRECATED_IN_1_24_FOR(nm_secret_agent_old_enable)
-gboolean
-nm_secret_agent_old_register(NMSecretAgentOld *self, GCancellable *cancellable, GError **error);
-
-NM_DEPRECATED_IN_1_24_FOR(nm_secret_agent_old_enable)
-gboolean
-nm_secret_agent_old_unregister(NMSecretAgentOld *self, GCancellable *cancellable, GError **error);
-
-NM_DEPRECATED_IN_1_24_FOR(nm_secret_agent_old_enable)
-void nm_secret_agent_old_unregister_async(NMSecretAgentOld *  self,
-                                          GCancellable *      cancellable,
-                                          GAsyncReadyCallback callback,
-                                          gpointer            user_data);
-
-NM_DEPRECATED_IN_1_24_FOR(nm_secret_agent_old_enable)
-gboolean
-nm_secret_agent_old_unregister_finish(NMSecretAgentOld *self, GAsyncResult *result, GError **error);
-
-/*****************************************************************************/
-
-void nm_secret_agent_old_get_secrets(NMSecretAgentOld *             self,
-                                     NMConnection *                 connection,
-                                     const char *                   setting_name,
-                                     const char **                  hints,
-                                     NMSecretAgentGetSecretsFlags   flags,
-                                     NMSecretAgentOldGetSecretsFunc callback,
-                                     gpointer                       user_data);
-
-void nm_secret_agent_old_save_secrets(NMSecretAgentOld *              self,
-                                      NMConnection *                  connection,
-                                      NMSecretAgentOldSaveSecretsFunc callback,
-                                      gpointer                        user_data);
-
-void nm_secret_agent_old_delete_secrets(NMSecretAgentOld *                self,
-                                        NMConnection *                    connection,
-                                        NMSecretAgentOldDeleteSecretsFunc callback,
-                                        gpointer                          user_data);
-
-G_END_DECLS
-
-#endif /* __NM_SECRET_AGENT_OLD_H__ */