GFileMonitor* g_file_monitor_file ( GFile* file, GFileMonitorFlags flags, GCancellable* cancellable, GError** error )
Obtains a file monitor for the given file. If no file notification mechanism exists, then regular polling of the file is used.
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.
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
backend and/or filesystem type.
|The caller of the method takes ownership of the data, and is responsible for freeing it.|