/* Chrysalide - Outil d'analyse de fichiers binaires
 * workqueue.h - prototypes pour la gestion des travaux différés
 *
 * Copyright (C) 2009-2024 Cyrille Bagard
 *
 *  This file is part of Chrysalide.
 *
 *  Chrysalide is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  Chrysalide is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with Chrysalide.  If not, see <http://www.gnu.org/licenses/>.
 */


#ifndef _GLIBEXT_WORKQUEUE_H
#define _GLIBEXT_WORKQUEUE_H


#include <stdbool.h>


#include "helpers.h"
#include "workgroup.h"



#define G_TYPE_WORK_QUEUE (g_work_queue_get_type())

DECLARE_GTYPE(GWorkQueue, g_work_queue, G, WORK_QUEUE);


/* Créé un nouveau gestionnaire de tâches parallèles. */
GWorkQueue *g_work_queue_new(void);

/* Constitue un nouveau groupe de travail. */
wgroup_id_t g_work_queue_define_group(GWorkQueue *, guint);

/* Dissout un groupe de travail existant. */
void g_work_queue_delete_group(GWorkQueue *, wgroup_id_t);

/* Place une nouvelle tâche en attente. */
bool g_work_queue_schedule(GWorkQueue *, GGenericWork *, wgroup_id_t);

/* Détermine si un groupe est vide de toute programmation. */
bool g_work_queue_is_empty(GWorkQueue *, wgroup_id_t);

/* Attend que toutes les tâches d'un groupe soient traitées. */
void g_work_queue_wait_for_completion(GWorkQueue *, wgroup_id_t);

/* Attend que toutes les tâches d'un groupe soient traitées. */
bool g_work_queue_wait_timed_for_completion(GWorkQueue *, wgroup_id_t, gint64);

/* Attend que toutes les tâches de tout groupe soient traitées. */
void g_work_queue_wait_for_all_completions(GWorkQueue *, const wgroup_id_t *, size_t);

/* Force un réveil d'une attente en cours pour la confirmer. */
void g_work_queue_wake_up_waiters(GWorkQueue *, wgroup_id_t);



#endif  /* _GLIBEXT_WORKQUEUE_H */