• Allison Karlitskaya's avatar
    glocalfile: add private worker monitor APIs · 33762a41
    Allison Karlitskaya authored
    Add a convenient and race-free method of watching local files from the
    GLib worker thread.
    
    Without this, the race-free way to create a monitor that dispatches
    events to the worker thread looked something like this:
    
     - dispatch an idle to the worker thread
     - from the idle, create the monitor and connect signals
     - from the original thread, wait (on a cond?) until the worker thread
       has finished setting up the monitor
     - read the file that you were monitoring
    
    which is just ridiculously complicated...
    
    To use the new API:
    
      monitor = g_local_file_monitor_new_in_worker ("/path/to/some/file",
                                                    G_FILE_MONITOR_NONE,
                                                    &error);
      g_assert_no_error (error);
    
      g_signal_connect (monitor, "changed", G_CALLBACK (callback), NULL);
    
      g_local_file_monitor_start (monitor);
    
    'callback' will run from the GLib worker thread.
    
    This is the reason that the start() call was introduced in the previous
    commit.  The backends that don't use the start() call will have a very
    thin race between creating the monitor and connecting the signal, but
    hopefully they will be fixed soon.
    
    These new APIs will be used (at least) from gdesktopappinfo to watch for
    changes in the desktop file directories.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=704887
    33762a41
Name
Last commit
Last update
build Loading commit data...
docs Loading commit data...
gio Loading commit data...
glib Loading commit data...
gmodule Loading commit data...
gobject Loading commit data...
gthread Loading commit data...
m4macros Loading commit data...
po Loading commit data...
tests Loading commit data...
.dir-locals.el Loading commit data...
.gitignore Loading commit data...
AUTHORS Loading commit data...
COPYING Loading commit data...
ChangeLog.pre-1-2 Loading commit data...
ChangeLog.pre-2-0 Loading commit data...
ChangeLog.pre-2-10 Loading commit data...
ChangeLog.pre-2-12 Loading commit data...
ChangeLog.pre-2-14 Loading commit data...
ChangeLog.pre-2-16 Loading commit data...
ChangeLog.pre-2-18 Loading commit data...
ChangeLog.pre-2-2 Loading commit data...
ChangeLog.pre-2-20 Loading commit data...
ChangeLog.pre-2-4 Loading commit data...
ChangeLog.pre-2-6 Loading commit data...
ChangeLog.pre-2-8 Loading commit data...
HACKING Loading commit data...
INSTALL.in Loading commit data...
Makefile.am Loading commit data...
NEWS Loading commit data...
NEWS.pre-1-3 Loading commit data...
README.commits Loading commit data...
README.in Loading commit data...
README.win32 Loading commit data...
acglib.m4 Loading commit data...
acinclude.m4 Loading commit data...
autogen.sh Loading commit data...
check-abis.sh Loading commit data...
config.h.win32.in Loading commit data...
configure.ac Loading commit data...
gio-2.0.pc.in Loading commit data...
gio-unix-2.0.pc.in Loading commit data...
gio-windows-2.0.pc.in Loading commit data...
glib-2.0.pc.in Loading commit data...
glib-gettextize.in Loading commit data...
glib-tap.mk Loading commit data...
glib-zip.in Loading commit data...
glib.doap Loading commit data...
glib.mk Loading commit data...
gmodule-2.0.pc.in Loading commit data...
gmodule-export-2.0.pc.in Loading commit data...
gmodule-no-export-2.0.pc.in Loading commit data...
gobject-2.0.pc.in Loading commit data...
gthread-2.0.pc.in Loading commit data...
makefile.msc Loading commit data...
msvc_recommended_pragmas.h Loading commit data...
sanity_check Loading commit data...
tap-test Loading commit data...
win32-fixup.pl Loading commit data...