New upstream version 1.32.12 upstream/1.32.12

1 files changed, 130 insertions, 0 deletions

diff --git a/src/nmtui/nmt-utils.c b/src/nmtui/nmt-utils.c
new file mode 100644
index 00000000..bac763f6
--- /dev/null
+++ b/src/nmtui/nmt-utils.c
@@ -0,0 +1,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);
+}