1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
/* SPDX-License-Identifier: GPL-2.0-or-later */
/*
* Copyright (C) 2013 Red Hat, Inc.
*/
/**
* SECTION:nmt-utils
* @short_description: Miscellaneous nmtui-specific utilities
*/
#include "libnm-client-aux-extern/nm-default-client.h"
#include "nmt-utils.h"
/**
* NmtSyncOp:
*
* A helper object used when synchronously waiting for an asynchronous
* operation to complete.
*
* The caller first does:
*
* |[
* NmtSyncOp op;
*
* nmt_sync_op_init (&op);
* ]|
*
* It then passes the op as the user_data to the async operation's
* callback function, and then calls nmt_sync_op_wait_boolean() or
* nmt_sync_op_wait_pointer() to wait for the result.
*
* When the async callback is invoked, it should call
* nmt_sync_op_complete_boolean() or nmt_sync_op_complete_pointer() to
* return a result or an error to the caller.
*
* There is no free/clear function; any memory that needs to be freed
* will have been returned to the caller from
* nmt_sync_op_wait_boolean() or nmt_sync_op_wait_pointer(), so there
* is nothing left that needs to be freed.
*/
typedef struct {
gpointer result;
GError * error;
gpointer complete;
} NmtSyncOpReal;
/**
* nmt_sync_op_init:
* @op: pointer to a stack-allocated #NmtSyncOp
*
* Initializes @op before use.
*/
void
nmt_sync_op_init(NmtSyncOp *op)
{
memset(op, 0, sizeof(*op));
}
/**
* nmt_sync_op_wait_boolean:
* @op: the #NmtSyncOp
* @error: return location for a #GError
*
* This runs the main loop until @op's operation returns, and then
* returns the result or error.
*
* Returns: the result of the operation.
*/
gboolean
nmt_sync_op_wait_boolean(NmtSyncOp *op, GError **error)
{
return GPOINTER_TO_UINT(nmt_sync_op_wait_pointer(op, error));
}
/**
* nmt_sync_op_complete_boolean:
* @op: the #NmtSyncOp
* @result: the result of the operation
* @error: (allow-none): the error, or %NULL
*
* Completes @op and returns @result and/or @error to the caller.
*/
void
nmt_sync_op_complete_boolean(NmtSyncOp *op, gboolean result, GError *error)
{
nmt_sync_op_complete_pointer(op, GUINT_TO_POINTER(result), error);
}
/**
* nmt_sync_op_wait_pointer:
* @op: the #NmtSyncOp
* @error: return location for a #GError
*
* This runs the main loop until @op's operation returns, and then
* returns the result or error.
*
* Returns: the result of the operation.
*/
gpointer
nmt_sync_op_wait_pointer(NmtSyncOp *op, GError **error)
{
NmtSyncOpReal *real = (NmtSyncOpReal *) op;
while (!real->complete)
g_main_context_iteration(NULL, TRUE);
if (real->error)
g_propagate_error(error, real->error);
return real->result;
}
/**
* nmt_sync_op_complete_pointer:
* @op: the #NmtSyncOp
* @result: the result of the operation
* @error: (allow-none): the error, or %NULL
*
* Completes @op and returns @result and/or @error to the caller.
*/
void
nmt_sync_op_complete_pointer(NmtSyncOp *op, gpointer result, GError *error)
{
NmtSyncOpReal *real = (NmtSyncOpReal *) op;
real->result = result;
real->error = error ? g_error_copy(error) : NULL;
real->complete = GUINT_TO_POINTER(TRUE);
}
|
