1 /* GIO - GLib Input, Output and Streaming Library
3 * Copyright (C) 2006-2007 Red Hat, Inc.
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General
16 * Public License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
18 * Boston, MA 02111-1307, USA.
20 * Author: Alexander Larsson <alexl@redhat.com>
25 #include "gioscheduler.h"
26 #include "gcancellable.h"
30 * SECTION:gioscheduler
31 * @short_description: I/O Scheduler
35 * As of GLib 2.36, the <literal>g_io_scheduler</literal> methods
36 * are deprecated in favor of #GThreadPool and #GTask.
39 * Schedules asynchronous I/O operations. #GIOScheduler integrates
40 * into the main event loop (#GMainLoop) and uses threads.
43 struct _GIOSchedulerJob
{
47 GIOSchedulerJobFunc job_func
;
49 GDestroyNotify destroy_notify
;
51 GCancellable
*cancellable
;
52 gulong cancellable_id
;
53 GMainContext
*context
;
56 G_LOCK_DEFINE_STATIC(active_jobs
);
57 static GList
*active_jobs
= NULL
;
60 g_io_job_free (GIOSchedulerJob
*job
)
62 if (job
->destroy_notify
)
63 job
->destroy_notify (job
->data
);
66 active_jobs
= g_list_delete_link (active_jobs
, job
->active_link
);
67 G_UNLOCK (active_jobs
);
70 g_object_unref (job
->cancellable
);
71 g_main_context_unref (job
->context
);
72 g_slice_free (GIOSchedulerJob
, job
);
76 io_job_thread (GTask
*task
,
77 gpointer source_object
,
79 GCancellable
*cancellable
)
81 GIOSchedulerJob
*job
= task_data
;
85 g_cancellable_push_current (job
->cancellable
);
89 result
= job
->job_func (job
, job
->cancellable
, job
->data
);
94 g_cancellable_pop_current (job
->cancellable
);
98 * g_io_scheduler_push_job:
99 * @job_func: a #GIOSchedulerJobFunc.
100 * @user_data: data to pass to @job_func
101 * @notify: (allow-none): a #GDestroyNotify for @user_data, or %NULL
102 * @io_priority: the <link linkend="io-priority">I/O priority</link>
104 * @cancellable: optional #GCancellable object, %NULL to ignore.
106 * Schedules the I/O job to run in another thread.
108 * @notify will be called on @user_data after @job_func has returned,
109 * regardless whether the job was cancelled or has run to completion.
111 * If @cancellable is not %NULL, it can be used to cancel the I/O job
112 * by calling g_cancellable_cancel() or by calling
113 * g_io_scheduler_cancel_all_jobs().
115 * Deprecated: use #GThreadPool or g_task_run_in_thread()
118 g_io_scheduler_push_job (GIOSchedulerJobFunc job_func
,
120 GDestroyNotify notify
,
122 GCancellable
*cancellable
)
124 GIOSchedulerJob
*job
;
127 g_return_if_fail (job_func
!= NULL
);
129 job
= g_slice_new0 (GIOSchedulerJob
);
130 job
->job_func
= job_func
;
131 job
->data
= user_data
;
132 job
->destroy_notify
= notify
;
135 job
->cancellable
= g_object_ref (cancellable
);
137 job
->context
= g_main_context_ref_thread_default ();
139 G_LOCK (active_jobs
);
140 active_jobs
= g_list_prepend (active_jobs
, job
);
141 job
->active_link
= active_jobs
;
142 G_UNLOCK (active_jobs
);
144 task
= g_task_new (NULL
, cancellable
, NULL
, NULL
);
145 g_task_set_task_data (task
, job
, (GDestroyNotify
)g_io_job_free
);
146 g_task_set_priority (task
, io_priority
);
147 g_task_run_in_thread (task
, io_job_thread
);
148 g_object_unref (task
);
152 * g_io_scheduler_cancel_all_jobs:
154 * Cancels all cancellable I/O jobs.
156 * A job is cancellable if a #GCancellable was passed into
157 * g_io_scheduler_push_job().
159 * Deprecated: You should never call this function, since you don't
160 * know how other libraries in your program might be making use of
164 g_io_scheduler_cancel_all_jobs (void)
166 GList
*cancellable_list
, *l
;
168 G_LOCK (active_jobs
);
169 cancellable_list
= NULL
;
170 for (l
= active_jobs
; l
!= NULL
; l
= l
->next
)
172 GIOSchedulerJob
*job
= l
->data
;
173 if (job
->cancellable
)
174 cancellable_list
= g_list_prepend (cancellable_list
,
175 g_object_ref (job
->cancellable
));
177 G_UNLOCK (active_jobs
);
179 for (l
= cancellable_list
; l
!= NULL
; l
= l
->next
)
181 GCancellable
*c
= l
->data
;
182 g_cancellable_cancel (c
);
185 g_list_free (cancellable_list
);
192 GDestroyNotify notify
;
200 mainloop_proxy_func (gpointer data
)
202 MainLoopProxy
*proxy
= data
;
204 proxy
->ret_val
= proxy
->func (proxy
->data
);
207 proxy
->notify (proxy
->data
);
209 g_mutex_lock (&proxy
->ack_lock
);
211 g_cond_signal (&proxy
->ack_condition
);
212 g_mutex_unlock (&proxy
->ack_lock
);
218 mainloop_proxy_free (MainLoopProxy
*proxy
)
220 g_mutex_clear (&proxy
->ack_lock
);
221 g_cond_clear (&proxy
->ack_condition
);
226 * g_io_scheduler_job_send_to_mainloop:
227 * @job: a #GIOSchedulerJob
228 * @func: a #GSourceFunc callback that will be called in the original thread
229 * @user_data: data to pass to @func
230 * @notify: (allow-none): a #GDestroyNotify for @user_data, or %NULL
232 * Used from an I/O job to send a callback to be run in the thread
233 * that the job was started from, waiting for the result (and thus
234 * blocking the I/O job).
236 * Returns: The return value of @func
238 * Deprecated: Use g_main_context_invoke().
241 g_io_scheduler_job_send_to_mainloop (GIOSchedulerJob
*job
,
244 GDestroyNotify notify
)
247 MainLoopProxy
*proxy
;
250 g_return_val_if_fail (job
!= NULL
, FALSE
);
251 g_return_val_if_fail (func
!= NULL
, FALSE
);
253 proxy
= g_new0 (MainLoopProxy
, 1);
255 proxy
->data
= user_data
;
256 proxy
->notify
= notify
;
257 g_mutex_init (&proxy
->ack_lock
);
258 g_cond_init (&proxy
->ack_condition
);
259 g_mutex_lock (&proxy
->ack_lock
);
261 source
= g_idle_source_new ();
262 g_source_set_priority (source
, G_PRIORITY_DEFAULT
);
263 g_source_set_callback (source
, mainloop_proxy_func
, proxy
,
266 g_source_attach (source
, job
->context
);
267 g_source_unref (source
);
270 g_cond_wait (&proxy
->ack_condition
, &proxy
->ack_lock
);
271 g_mutex_unlock (&proxy
->ack_lock
);
273 ret_val
= proxy
->ret_val
;
274 mainloop_proxy_free (proxy
);
280 * g_io_scheduler_job_send_to_mainloop_async:
281 * @job: a #GIOSchedulerJob
282 * @func: a #GSourceFunc callback that will be called in the original thread
283 * @user_data: data to pass to @func
284 * @notify: (allow-none): a #GDestroyNotify for @user_data, or %NULL
286 * Used from an I/O job to send a callback to be run asynchronously in
287 * the thread that the job was started from. The callback will be run
288 * when the main loop is available, but at that time the I/O job might
289 * have finished. The return value from the callback is ignored.
291 * Note that if you are passing the @user_data from g_io_scheduler_push_job()
292 * on to this function you have to ensure that it is not freed before
293 * @func is called, either by passing %NULL as @notify to
294 * g_io_scheduler_push_job() or by using refcounting for @user_data.
296 * Deprecated: Use g_main_context_invoke().
299 g_io_scheduler_job_send_to_mainloop_async (GIOSchedulerJob
*job
,
302 GDestroyNotify notify
)
305 MainLoopProxy
*proxy
;
307 g_return_if_fail (job
!= NULL
);
308 g_return_if_fail (func
!= NULL
);
310 proxy
= g_new0 (MainLoopProxy
, 1);
312 proxy
->data
= user_data
;
313 proxy
->notify
= notify
;
314 g_mutex_init (&proxy
->ack_lock
);
315 g_cond_init (&proxy
->ack_condition
);
317 source
= g_idle_source_new ();
318 g_source_set_priority (source
, G_PRIORITY_DEFAULT
);
319 g_source_set_callback (source
, mainloop_proxy_func
, proxy
,
320 (GDestroyNotify
)mainloop_proxy_free
);
322 g_source_attach (source
, job
->context
);
323 g_source_unref (source
);