FileIF.monitorFile

Obtains a file monitor for the given file. If no file notification mechanism exists, then regular polling of the file is used.

If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.

If @flags contains %G_FILE_MONITOR_WATCH_HARD_LINKS then the monitor will also attempt to report changes made to the file via another filename (ie, a hard link). Without this flag, you can only rely on changes made through the filename contained in @file to be reported. Using this flag may result in an increase in resource usage, and may not have any effect depending on the #GFileMonitor backend and/or filesystem type.

Parameters

flags GFileMonitorFlags

a set of #GFileMonitorFlags

cancellable Cancellable

optional #GCancellable object, %NULL to ignore

Return Value

a #GFileMonitor for the given @file, or %NULL on error. Free the returned object with g_object_unref().

Throws

GException on failure.

Meta