mirror of
https://gitlab.freedesktop.org/NetworkManager/NetworkManager.git
synced 2025-12-25 16:30:07 +01:00
ef7fd9e4e3
We want that our asynchronous operations are cancellable. In fact, NMAuthChain is already (manually) cancellable by the user calling nm_auth_chain_destroy(). However, sometimes we have a GCancellable at hand, so the callers would have to register to the cancellable themselves. Instead, support setting a cancellable to the NMAuthChain, that aborts the request and invokes the callback. It does so always on an idle handler. Also, the user may only set the cancellable once, and only before starting the first call.
93 lines
3.3 KiB
C
93 lines
3.3 KiB
C
// SPDX-License-Identifier: GPL-2.0+
|
|
/*
|
|
* Copyright (C) 2010 Red Hat, Inc.
|
|
*/
|
|
|
|
#ifndef __NETWORKMANAGER_MANAGER_AUTH_H__
|
|
#define __NETWORKMANAGER_MANAGER_AUTH_H__
|
|
|
|
#include "nm-connection.h"
|
|
|
|
#include "nm-auth-manager.h"
|
|
|
|
/*****************************************************************************/
|
|
|
|
typedef struct _NMAuthChain NMAuthChain;
|
|
|
|
typedef void (*NMAuthChainResultFunc) (NMAuthChain *chain,
|
|
GDBusMethodInvocation *context,
|
|
gpointer user_data);
|
|
|
|
NMAuthChain *nm_auth_chain_new_context (GDBusMethodInvocation *context,
|
|
NMAuthChainResultFunc done_func,
|
|
gpointer user_data);
|
|
|
|
NMAuthChain *nm_auth_chain_new_subject (NMAuthSubject *subject,
|
|
GDBusMethodInvocation *context,
|
|
NMAuthChainResultFunc done_func,
|
|
gpointer user_data);
|
|
|
|
GCancellable *nm_auth_chain_get_cancellable (NMAuthChain *self);
|
|
void nm_auth_chain_set_cancellable (NMAuthChain *self,
|
|
GCancellable *cancellable);
|
|
|
|
gpointer nm_auth_chain_get_data (NMAuthChain *chain, const char *tag);
|
|
|
|
gpointer nm_auth_chain_steal_data (NMAuthChain *chain, const char *tag);
|
|
|
|
void nm_auth_chain_set_data_unsafe (NMAuthChain *chain,
|
|
const char *tag,
|
|
gpointer data,
|
|
GDestroyNotify data_destroy);
|
|
|
|
#define nm_auth_chain_set_data(chain, tag, data, data_destroy) \
|
|
nm_auth_chain_set_data_unsafe ((chain), ""tag"", (data), (data_destroy))
|
|
|
|
NMAuthCallResult nm_auth_chain_get_result (NMAuthChain *chain,
|
|
const char *permission);
|
|
|
|
void nm_auth_chain_add_call_unsafe (NMAuthChain *chain,
|
|
const char *permission,
|
|
gboolean allow_interaction);
|
|
|
|
#define nm_auth_chain_add_call(chain, permission, allow_interaction) \
|
|
nm_auth_chain_add_call_unsafe ((chain), ""permission"", (allow_interaction))
|
|
|
|
void nm_auth_chain_destroy (NMAuthChain *chain);
|
|
|
|
NMAuthSubject *nm_auth_chain_get_subject (NMAuthChain *self);
|
|
|
|
GDBusMethodInvocation *nm_auth_chain_get_context (NMAuthChain *self);
|
|
|
|
/*****************************************************************************/
|
|
|
|
struct CList;
|
|
|
|
static inline NMAuthChain *
|
|
nm_auth_chain_parent_lst_entry (struct CList *parent_lst_self)
|
|
{
|
|
return (NMAuthChain *) ((void *) parent_lst_self);
|
|
}
|
|
|
|
static inline struct CList *
|
|
nm_auth_chain_parent_lst_list (NMAuthChain *self)
|
|
{
|
|
return (struct CList *) ((void *) self);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
/* Caller must free returned error description */
|
|
gboolean nm_auth_is_subject_in_acl (NMConnection *connection,
|
|
NMAuthSubject *subect,
|
|
char **out_error_desc);
|
|
|
|
gboolean nm_auth_is_subject_in_acl_set_error (NMConnection *connection,
|
|
NMAuthSubject *subject,
|
|
GQuark err_domain,
|
|
int err_code,
|
|
GError **error);
|
|
|
|
#endif /* __NETWORKMANAGER_MANAGER_AUTH_H__ */
|
|
|