4 >Asynchronous File I/O</TITLE
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.64
10 TITLE="GnomeVFS - Filesystem Abstraction library"
11 HREF="index.html"><LINK
13 TITLE="Basic File Operations"
14 HREF="file-operations.html"><LINK
16 TITLE="Finding Special Directories"
17 HREF="gnome-vfs-finding-special-directories.html"><LINK
20 HREF="gnome-vfs-xfer.html"></HEAD
43 >GnomeVFS - Filesystem Abstraction library</FONT
52 HREF="gnome-vfs-finding-special-directories.html"
57 ><<< Previous Page</B
90 HREF="file-operations.html"
106 HREF="gnome-vfs-xfer.html"
111 >Next Page >>></B
120 NAME="GNOME-VFS-ASYNCHRONOUS-OPERATIONS"
121 >Asynchronous File I/O</A
130 >Asynchronous File I/O -- allows for non-blocking file operations</DIV
132 CLASS="REFSYNOPSISDIV"
150 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-CANCEL"
151 >gnome_vfs_async_cancel</A
152 > (GnomeVFSAsyncHandle *handle);
154 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-OPEN"
155 >gnome_vfs_async_open</A
156 > (GnomeVFSAsyncHandle **handle_return,
158 HREF=../glib/glib-basic-types.html#GCHAR
159 >gchar</A> *text_uri,
161 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
166 HREF="gnome-vfs-types.html#GNOMEVFSASYNCOPENCALLBACK"
167 >GnomeVFSAsyncOpenCallback</A
170 HREF=../glib/glib-basic-types.html#GPOINTER
171 >gpointer</A> callback_data);
173 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-OPEN-URI"
174 >gnome_vfs_async_open_uri</A
175 > (GnomeVFSAsyncHandle **handle_return,
178 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
183 HREF="gnome-vfs-types.html#GNOMEVFSASYNCOPENCALLBACK"
184 >GnomeVFSAsyncOpenCallback</A
187 HREF=../glib/glib-basic-types.html#GPOINTER
188 >gpointer</A> callback_data);
190 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-OPEN-AS-CHANNEL"
191 >gnome_vfs_async_open_as_channel</A
192 > (GnomeVFSAsyncHandle **handle_return,
194 HREF=../glib/glib-basic-types.html#GCHAR
195 >gchar</A> *text_uri,
197 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
201 HREF=../glib/glib-basic-types.html#GUINT
202 >guint</A> advised_block_size,
204 GnomeVFSAsyncOpenAsChannelCallback callback,
206 HREF=../glib/glib-basic-types.html#GPOINTER
207 >gpointer</A> callback_data);
209 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-OPEN-URI-AS-CHANNEL"
210 >gnome_vfs_async_open_uri_as_channel</A
212 (GnomeVFSAsyncHandle **handle_return,
215 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
219 HREF=../glib/glib-basic-types.html#GUINT
220 >guint</A> advised_block_size,
222 GnomeVFSAsyncOpenAsChannelCallback callback,
224 HREF=../glib/glib-basic-types.html#GPOINTER
225 >gpointer</A> callback_data);
227 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-CREATE"
228 >gnome_vfs_async_create</A
229 > (GnomeVFSAsyncHandle **handle_return,
231 HREF=../glib/glib-basic-types.html#GCHAR
232 >gchar</A> *text_uri,
234 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
238 HREF=../glib/glib-basic-types.html#GBOOLEAN
239 >gboolean</A> exclusive,
241 HREF=../glib/glib-basic-types.html#GUINT
245 HREF="gnome-vfs-types.html#GNOMEVFSASYNCOPENCALLBACK"
246 >GnomeVFSAsyncOpenCallback</A
249 HREF=../glib/glib-basic-types.html#GPOINTER
250 >gpointer</A> callback_data);
252 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-CREATE-URI"
253 >gnome_vfs_async_create_uri</A
254 > (GnomeVFSAsyncHandle **handle_return,
257 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
261 HREF=../glib/glib-basic-types.html#GBOOLEAN
262 >gboolean</A> exclusive,
264 HREF=../glib/glib-basic-types.html#GUINT
268 HREF="gnome-vfs-types.html#GNOMEVFSASYNCOPENCALLBACK"
269 >GnomeVFSAsyncOpenCallback</A
272 HREF=../glib/glib-basic-types.html#GPOINTER
273 >gpointer</A> callback_data);
275 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-CREATE-SYMBOLIC-LINK"
276 >gnome_vfs_async_create_symbolic_link</A
278 (GnomeVFSAsyncHandle **handle_return,
281 HREF=../glib/glib-basic-types.html#GCHAR
282 >gchar</A> *uri_reference,
285 HREF="gnome-vfs-types.html#GNOMEVFSASYNCOPENCALLBACK"
286 >GnomeVFSAsyncOpenCallback</A
289 HREF=../glib/glib-basic-types.html#GPOINTER
290 >gpointer</A> callback_data);
292 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-CREATE-AS-CHANNEL"
293 >gnome_vfs_async_create_as_channel</A
295 (GnomeVFSAsyncHandle **handle_return,
297 HREF=../glib/glib-basic-types.html#GCHAR
298 >gchar</A> *text_uri,
300 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
304 HREF=../glib/glib-basic-types.html#GBOOLEAN
305 >gboolean</A> exclusive,
307 HREF=../glib/glib-basic-types.html#GUINT
311 HREF="gnome-vfs-types.html#GNOMEVFSASYNCCREATEASCHANNELCALLBACK"
312 >GnomeVFSAsyncCreateAsChannelCallback</A
315 HREF=../glib/glib-basic-types.html#GPOINTER
316 >gpointer</A> callback_data);
318 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-CREATE-URI-AS-CHANNEL"
319 >gnome_vfs_async_create_uri_as_channel</A
321 (GnomeVFSAsyncHandle **handle_return,
324 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
328 HREF=../glib/glib-basic-types.html#GBOOLEAN
329 >gboolean</A> exclusive,
331 HREF=../glib/glib-basic-types.html#GUINT
335 HREF="gnome-vfs-types.html#GNOMEVFSASYNCCREATEASCHANNELCALLBACK"
336 >GnomeVFSAsyncCreateAsChannelCallback</A
339 HREF=../glib/glib-basic-types.html#GPOINTER
340 >gpointer</A> callback_data);
342 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-CLOSE"
343 >gnome_vfs_async_close</A
344 > (GnomeVFSAsyncHandle *handle,
346 HREF="gnome-vfs-types.html#GNOMEVFSASYNCCLOSECALLBACK"
347 >GnomeVFSAsyncCloseCallback</A
350 HREF=../glib/glib-basic-types.html#GPOINTER
351 >gpointer</A> callback_data);
353 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-READ"
354 >gnome_vfs_async_read</A
355 > (GnomeVFSAsyncHandle *handle,
357 HREF=../glib/glib-basic-types.html#GPOINTER
358 >gpointer</A> buffer,
360 HREF=../glib/glib-basic-types.html#GUINT
363 HREF="gnome-vfs-types.html#GNOMEVFSASYNCREADCALLBACK"
364 >GnomeVFSAsyncReadCallback</A
367 HREF=../glib/glib-basic-types.html#GPOINTER
368 >gpointer</A> callback_data);
370 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-WRITE"
371 >gnome_vfs_async_write</A
372 > (GnomeVFSAsyncHandle *handle,
374 HREF=../glib/glib-basic-types.html#GCONSTPOINTER
375 >gconstpointer</A> buffer,
377 HREF=../glib/glib-basic-types.html#GUINT
380 HREF="gnome-vfs-types.html#GNOMEVFSASYNCWRITECALLBACK"
381 >GnomeVFSAsyncWriteCallback</A
384 HREF=../glib/glib-basic-types.html#GPOINTER
385 >gpointer</A> callback_data);
387 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-GET-FILE-INFO"
388 >gnome_vfs_async_get_file_info</A
389 > (GnomeVFSAsyncHandle **handle_return,
391 HREF=../glib/glib-doubly-linked-lists.html#GLIST
392 >GList</A> *uri_list,
394 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFOOPTIONS"
395 >GnomeVFSFileInfoOptions</A
398 GnomeVFSAsyncGetFileInfoCallback callback,
400 HREF=../glib/glib-basic-types.html#GPOINTER
401 >gpointer</A> callback_data);
403 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-SET-FILE-INFO"
404 >gnome_vfs_async_set_file_info</A
405 > (GnomeVFSAsyncHandle **handle_return,
408 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFO"
412 HREF="gnome-vfs-types.html#GNOMEVFSSETFILEINFOMASK"
413 >GnomeVFSSetFileInfoMask</A
416 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFOOPTIONS"
417 >GnomeVFSFileInfoOptions</A
420 GnomeVFSAsyncSetFileInfoCallback callback,
422 HREF=../glib/glib-basic-types.html#GPOINTER
423 >gpointer</A> callback_data);
425 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-LOAD-DIRECTORY"
426 >gnome_vfs_async_load_directory</A
427 > (GnomeVFSAsyncHandle **handle_return,
429 HREF=../glib/glib-basic-types.html#GCHAR
430 >gchar</A> *text_uri,
432 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFOOPTIONS"
433 >GnomeVFSFileInfoOptions</A
436 HREF=../glib/glib-basic-types.html#GUINT
437 >guint</A> items_per_notification,
439 GnomeVFSAsyncDirectoryLoadCallback callback,
441 HREF=../glib/glib-basic-types.html#GPOINTER
442 >gpointer</A> callback_data);
444 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-LOAD-DIRECTORY-URI"
445 >gnome_vfs_async_load_directory_uri</A
447 (GnomeVFSAsyncHandle **handle_return,
450 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFOOPTIONS"
451 >GnomeVFSFileInfoOptions</A
454 HREF=../glib/glib-basic-types.html#GUINT
455 >guint</A> items_per_notification,
457 GnomeVFSAsyncDirectoryLoadCallback callback,
459 HREF=../glib/glib-basic-types.html#GPOINTER
460 >gpointer</A> callback_data);
462 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
465 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-XFER"
466 >gnome_vfs_async_xfer</A
467 > (GnomeVFSAsyncHandle **handle_return,
469 HREF=../glib/glib-doubly-linked-lists.html#GLIST
470 >GList</A> *source_uri_list,
472 HREF=../glib/glib-doubly-linked-lists.html#GLIST
473 >GList</A> *target_uri_list,
475 HREF="gnome-vfs-types.html#GNOMEVFSXFEROPTIONS"
476 >GnomeVFSXferOptions</A
479 HREF="gnome-vfs-types.html#GNOMEVFSXFERERRORMODE"
480 >GnomeVFSXferErrorMode</A
483 HREF="gnome-vfs-types.html#GNOMEVFSXFEROVERWRITEMODE"
484 >GnomeVFSXferOverwriteMode</A
487 GnomeVFSAsyncXferProgressCallback progress_update_callback,
489 HREF=../glib/glib-basic-types.html#GPOINTER
490 >gpointer</A> update_callback_data,
492 HREF="gnome-vfs-types.html#GNOMEVFSXFERPROGRESSCALLBACK"
493 >GnomeVFSXferProgressCallback</A
494 > progress_sync_callback,
496 HREF=../glib/glib-basic-types.html#GPOINTER
497 >gpointer</A> sync_callback_data);
499 HREF="gnome-vfs-asynchronous-operations.html#GNOME-VFS-ASYNC-FIND-DIRECTORY"
500 >gnome_vfs_async_find_directory</A
501 > (GnomeVFSAsyncHandle **handle_return,
503 HREF=../glib/glib-doubly-linked-lists.html#GLIST
504 >GList</A> *near_uri_list,
506 HREF="gnome-vfs-types.html#GNOMEVFSFINDDIRECTORYKIND"
507 >GnomeVFSFindDirectoryKind</A
510 HREF=../glib/glib-basic-types.html#GBOOLEAN
511 >gboolean</A> create_if_needed,
513 HREF=../glib/glib-basic-types.html#GBOOLEAN
514 >gboolean</A> find_if_needed,
516 HREF=../glib/glib-basic-types.html#GUINT
517 >guint</A> permissions,
519 GnomeVFSAsyncFindDirectoryCallback callback,
521 HREF=../glib/glib-basic-types.html#GPOINTER
522 >gpointer</A> user_data);</PRE
535 >The number of concurrent asynchronous jobs is limited.
536 When the limit is reached jobs are put into a queue.
537 The priority parameter determines which job is taken
538 from the queue first and when.</P
540 >Priority values range from -10 to 10, lower priority values
541 mean higher priority.</P
543 >How to decide the priority of a job?</P
545 >Generally speaking jobs that can wait should be low priority,
546 jobs that are urgent should be high priority.</P
548 >Another possible approach is that jobs that potentially
549 take long to finish should be low priority, jobs that finish
550 quickly should be high priority. </P
552 >For example, if your application is doing something in the
553 background (e.g. looking for a directory) it can wait: choose
554 low priority like 10.
555 If you need update the user interface with the contents of
556 a directory it should happen quickly: use a -10 priority job.</P
558 >How to choose the priority value?</P
560 >The scheduling algorithm reserves threads for high priority
561 jobs so that running low priority jobs can't block high
563 The priority value of a job determines the maximum number of
564 running jobs so that the job can start. E.g. if a job has
565 a priority of -7 then it can start if there are less then
566 8 jobs running (using the default thread limit of 10).</P
582 NAME="GNOME-VFS-ASYNC-CANCEL"
584 >gnome_vfs_async_cancel ()</H3
593 CLASS="PROGRAMLISTING"
594 >void gnome_vfs_async_cancel (GnomeVFSAsyncHandle *handle);</PRE
599 >Cancels an operation</P
601 CLASS="INFORMALTABLE"
630 >the handle to cancel
646 NAME="GNOME-VFS-ASYNC-OPEN"
648 >gnome_vfs_async_open ()</H3
657 CLASS="PROGRAMLISTING"
658 >void gnome_vfs_async_open (GnomeVFSAsyncHandle **handle_return,
660 HREF=../glib/glib-basic-types.html#GCHAR
661 >gchar</A> *text_uri,
663 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
668 HREF="gnome-vfs-types.html#GNOMEVFSASYNCOPENCALLBACK"
669 >GnomeVFSAsyncOpenCallback</A
672 HREF=../glib/glib-basic-types.html#GPOINTER
673 >gpointer</A> callback_data);</PRE
678 >Opens a text-based URI according to <TT
685 CLASS="INFORMALTABLE"
714 >a reference to where the newly created handle pointer should be stored</TD
731 >string representation of the URI</TD
782 >a callback for when the URI is opened or an error occured</TD
799 >data to be passed to the callback function
815 NAME="GNOME-VFS-ASYNC-OPEN-URI"
817 >gnome_vfs_async_open_uri ()</H3
826 CLASS="PROGRAMLISTING"
827 >void gnome_vfs_async_open_uri (GnomeVFSAsyncHandle **handle_return,
830 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
835 HREF="gnome-vfs-types.html#GNOMEVFSASYNCOPENCALLBACK"
836 >GnomeVFSAsyncOpenCallback</A
839 HREF=../glib/glib-basic-types.html#GPOINTER
840 >gpointer</A> callback_data);</PRE
845 >Opens a GnomeVFSURI according to <TT
850 >. This function exposes a public <TT
855 > object, which may be deprecated eventually. Therefore, use of <TT
858 >gnome_vfs_async_open</I
860 > is encouraged instead of this function to minimize breakage.</P
862 CLASS="INFORMALTABLE"
891 >a reference to where the newly created handle pointer should be stored</TD
964 >a callback for when the URI is opened or an error occured</TD
981 >data to be passed to the callback function
997 NAME="GNOME-VFS-ASYNC-OPEN-AS-CHANNEL"
999 >gnome_vfs_async_open_as_channel ()</H3
1008 CLASS="PROGRAMLISTING"
1009 >void gnome_vfs_async_open_as_channel (GnomeVFSAsyncHandle **handle_return,
1011 HREF=../glib/glib-basic-types.html#GCHAR
1012 >gchar</A> *text_uri,
1014 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
1015 >GnomeVFSOpenMode</A
1018 HREF=../glib/glib-basic-types.html#GUINT
1019 >guint</A> advised_block_size,
1021 GnomeVFSAsyncOpenAsChannelCallback callback,
1023 HREF=../glib/glib-basic-types.html#GPOINTER
1024 >gpointer</A> callback_data);</PRE
1031 CLASS="INFORMALTABLE"
1060 >a reference to where the newly created handle pointer should be stored</TD
1104 >advised_block_size</I
1162 >data to be passed to the callback function
1178 NAME="GNOME-VFS-ASYNC-OPEN-URI-AS-CHANNEL"
1180 >gnome_vfs_async_open_uri_as_channel ()</H3
1189 CLASS="PROGRAMLISTING"
1190 >void gnome_vfs_async_open_uri_as_channel
1191 (GnomeVFSAsyncHandle **handle_return,
1194 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
1195 >GnomeVFSOpenMode</A
1198 HREF=../glib/glib-basic-types.html#GUINT
1199 >guint</A> advised_block_size,
1201 GnomeVFSAsyncOpenAsChannelCallback callback,
1203 HREF=../glib/glib-basic-types.html#GPOINTER
1204 >gpointer</A> callback_data);</PRE
1211 CLASS="INFORMALTABLE"
1240 >a reference to where the newly created handle pointer should be stored</TD
1284 >advised_block_size</I
1342 >data to be passed to the callback function
1358 NAME="GNOME-VFS-ASYNC-CREATE"
1360 >gnome_vfs_async_create ()</H3
1369 CLASS="PROGRAMLISTING"
1370 >void gnome_vfs_async_create (GnomeVFSAsyncHandle **handle_return,
1372 HREF=../glib/glib-basic-types.html#GCHAR
1373 >gchar</A> *text_uri,
1375 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
1376 >GnomeVFSOpenMode</A
1379 HREF=../glib/glib-basic-types.html#GBOOLEAN
1380 >gboolean</A> exclusive,
1382 HREF=../glib/glib-basic-types.html#GUINT
1386 HREF="gnome-vfs-types.html#GNOMEVFSASYNCOPENCALLBACK"
1387 >GnomeVFSAsyncOpenCallback</A
1390 HREF=../glib/glib-basic-types.html#GPOINTER
1391 >gpointer</A> callback_data);</PRE
1398 CLASS="INFORMALTABLE"
1427 >a reference to where the newly created handle pointer should be stored</TD
1546 >data to be passed to the callback function
1562 NAME="GNOME-VFS-ASYNC-CREATE-URI"
1564 >gnome_vfs_async_create_uri ()</H3
1573 CLASS="PROGRAMLISTING"
1574 >void gnome_vfs_async_create_uri (GnomeVFSAsyncHandle **handle_return,
1577 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
1578 >GnomeVFSOpenMode</A
1581 HREF=../glib/glib-basic-types.html#GBOOLEAN
1582 >gboolean</A> exclusive,
1584 HREF=../glib/glib-basic-types.html#GUINT
1588 HREF="gnome-vfs-types.html#GNOMEVFSASYNCOPENCALLBACK"
1589 >GnomeVFSAsyncOpenCallback</A
1592 HREF=../glib/glib-basic-types.html#GPOINTER
1593 >gpointer</A> callback_data);</PRE
1600 CLASS="INFORMALTABLE"
1629 >a reference to where the newly created handle pointer should be stored</TD
1748 >data to be passed to the callback function
1764 NAME="GNOME-VFS-ASYNC-CREATE-SYMBOLIC-LINK"
1766 >gnome_vfs_async_create_symbolic_link ()</H3
1775 CLASS="PROGRAMLISTING"
1776 >void gnome_vfs_async_create_symbolic_link
1777 (GnomeVFSAsyncHandle **handle_return,
1780 HREF=../glib/glib-basic-types.html#GCHAR
1781 >gchar</A> *uri_reference,
1784 HREF="gnome-vfs-types.html#GNOMEVFSASYNCOPENCALLBACK"
1785 >GnomeVFSAsyncOpenCallback</A
1788 HREF=../glib/glib-basic-types.html#GPOINTER
1789 >gpointer</A> callback_data);</PRE
1796 CLASS="INFORMALTABLE"
1825 >a reference to where the newly created handle pointer should be stored</TD
1910 >data to be passed to the callback function
1926 NAME="GNOME-VFS-ASYNC-CREATE-AS-CHANNEL"
1928 >gnome_vfs_async_create_as_channel ()</H3
1937 CLASS="PROGRAMLISTING"
1938 >void gnome_vfs_async_create_as_channel
1939 (GnomeVFSAsyncHandle **handle_return,
1941 HREF=../glib/glib-basic-types.html#GCHAR
1942 >gchar</A> *text_uri,
1944 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
1945 >GnomeVFSOpenMode</A
1948 HREF=../glib/glib-basic-types.html#GBOOLEAN
1949 >gboolean</A> exclusive,
1951 HREF=../glib/glib-basic-types.html#GUINT
1955 HREF="gnome-vfs-types.html#GNOMEVFSASYNCCREATEASCHANNELCALLBACK"
1956 >GnomeVFSAsyncCreateAsChannelCallback</A
1959 HREF=../glib/glib-basic-types.html#GPOINTER
1960 >gpointer</A> callback_data);</PRE
1967 CLASS="INFORMALTABLE"
1996 >a reference to where the newly created handle pointer should be stored</TD
2115 >data to be passed to the callback function
2131 NAME="GNOME-VFS-ASYNC-CREATE-URI-AS-CHANNEL"
2133 >gnome_vfs_async_create_uri_as_channel ()</H3
2142 CLASS="PROGRAMLISTING"
2143 >void gnome_vfs_async_create_uri_as_channel
2144 (GnomeVFSAsyncHandle **handle_return,
2147 HREF="gnome-vfs-types.html#GNOMEVFSOPENMODE"
2148 >GnomeVFSOpenMode</A
2151 HREF=../glib/glib-basic-types.html#GBOOLEAN
2152 >gboolean</A> exclusive,
2154 HREF=../glib/glib-basic-types.html#GUINT
2158 HREF="gnome-vfs-types.html#GNOMEVFSASYNCCREATEASCHANNELCALLBACK"
2159 >GnomeVFSAsyncCreateAsChannelCallback</A
2162 HREF=../glib/glib-basic-types.html#GPOINTER
2163 >gpointer</A> callback_data);</PRE
2170 CLASS="INFORMALTABLE"
2199 >a reference to where the newly created handle pointer should be stored</TD
2318 >data to be passed to the callback function
2334 NAME="GNOME-VFS-ASYNC-CLOSE"
2336 >gnome_vfs_async_close ()</H3
2345 CLASS="PROGRAMLISTING"
2346 >void gnome_vfs_async_close (GnomeVFSAsyncHandle *handle,
2348 HREF="gnome-vfs-types.html#GNOMEVFSASYNCCLOSECALLBACK"
2349 >GnomeVFSAsyncCloseCallback</A
2352 HREF=../glib/glib-basic-types.html#GPOINTER
2353 >gpointer</A> callback_data);</PRE
2360 CLASS="INFORMALTABLE"
2389 >GnomeVFSHandle to close</TD
2406 >a callback for when the <TT
2411 > is closed or an error has occured</TD
2428 >data to be passed to the callback function
2444 NAME="GNOME-VFS-ASYNC-READ"
2446 >gnome_vfs_async_read ()</H3
2455 CLASS="PROGRAMLISTING"
2456 >void gnome_vfs_async_read (GnomeVFSAsyncHandle *handle,
2458 HREF=../glib/glib-basic-types.html#GPOINTER
2459 >gpointer</A> buffer,
2461 HREF=../glib/glib-basic-types.html#GUINT
2464 HREF="gnome-vfs-types.html#GNOMEVFSASYNCREADCALLBACK"
2465 >GnomeVFSAsyncReadCallback</A
2468 HREF=../glib/glib-basic-types.html#GPOINTER
2469 >gpointer</A> callback_data);</PRE
2476 CLASS="INFORMALTABLE"
2573 >data to be passed to the callback function
2589 NAME="GNOME-VFS-ASYNC-WRITE"
2591 >gnome_vfs_async_write ()</H3
2600 CLASS="PROGRAMLISTING"
2601 >void gnome_vfs_async_write (GnomeVFSAsyncHandle *handle,
2603 HREF=../glib/glib-basic-types.html#GCONSTPOINTER
2604 >gconstpointer</A> buffer,
2606 HREF=../glib/glib-basic-types.html#GUINT
2609 HREF="gnome-vfs-types.html#GNOMEVFSASYNCWRITECALLBACK"
2610 >GnomeVFSAsyncWriteCallback</A
2613 HREF=../glib/glib-basic-types.html#GPOINTER
2614 >gpointer</A> callback_data);</PRE
2621 CLASS="INFORMALTABLE"
2718 >data to be passed to the callback function
2734 NAME="GNOME-VFS-ASYNC-GET-FILE-INFO"
2736 >gnome_vfs_async_get_file_info ()</H3
2745 CLASS="PROGRAMLISTING"
2746 >void gnome_vfs_async_get_file_info (GnomeVFSAsyncHandle **handle_return,
2748 HREF=../glib/glib-doubly-linked-lists.html#GLIST
2749 >GList</A> *uri_list,
2751 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFOOPTIONS"
2752 >GnomeVFSFileInfoOptions</A
2755 GnomeVFSAsyncGetFileInfoCallback callback,
2757 HREF=../glib/glib-basic-types.html#GPOINTER
2758 >gpointer</A> callback_data);</PRE
2765 CLASS="INFORMALTABLE"
2794 >a reference to where the newly created handle pointer should be stored</TD
2879 >data to be passed to the callback function
2895 NAME="GNOME-VFS-ASYNC-SET-FILE-INFO"
2897 >gnome_vfs_async_set_file_info ()</H3
2906 CLASS="PROGRAMLISTING"
2907 >void gnome_vfs_async_set_file_info (GnomeVFSAsyncHandle **handle_return,
2910 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFO"
2911 >GnomeVFSFileInfo</A
2914 HREF="gnome-vfs-types.html#GNOMEVFSSETFILEINFOMASK"
2915 >GnomeVFSSetFileInfoMask</A
2918 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFOOPTIONS"
2919 >GnomeVFSFileInfoOptions</A
2922 GnomeVFSAsyncSetFileInfoCallback callback,
2924 HREF=../glib/glib-basic-types.html#GPOINTER
2925 >gpointer</A> callback_data);</PRE
2932 CLASS="INFORMALTABLE"
2961 >a reference to where the newly created handle pointer should be stored</TD
3080 >data to be passed to the callback function
3096 NAME="GNOME-VFS-ASYNC-LOAD-DIRECTORY"
3098 >gnome_vfs_async_load_directory ()</H3
3107 CLASS="PROGRAMLISTING"
3108 >void gnome_vfs_async_load_directory (GnomeVFSAsyncHandle **handle_return,
3110 HREF=../glib/glib-basic-types.html#GCHAR
3111 >gchar</A> *text_uri,
3113 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFOOPTIONS"
3114 >GnomeVFSFileInfoOptions</A
3117 HREF=../glib/glib-basic-types.html#GUINT
3118 >guint</A> items_per_notification,
3120 GnomeVFSAsyncDirectoryLoadCallback callback,
3122 HREF=../glib/glib-basic-types.html#GPOINTER
3123 >gpointer</A> callback_data);</PRE
3130 CLASS="INFORMALTABLE"
3159 >a reference to where the newly created handle pointer should be stored</TD
3203 >items_per_notification</I
3261 >data to be passed to the callback function</TD
3276 NAME="GNOME-VFS-ASYNC-LOAD-DIRECTORY-URI"
3278 >gnome_vfs_async_load_directory_uri ()</H3
3287 CLASS="PROGRAMLISTING"
3288 >void gnome_vfs_async_load_directory_uri
3289 (GnomeVFSAsyncHandle **handle_return,
3292 HREF="gnome-vfs-types.html#GNOMEVFSFILEINFOOPTIONS"
3293 >GnomeVFSFileInfoOptions</A
3296 HREF=../glib/glib-basic-types.html#GUINT
3297 >guint</A> items_per_notification,
3299 GnomeVFSAsyncDirectoryLoadCallback callback,
3301 HREF=../glib/glib-basic-types.html#GPOINTER
3302 >gpointer</A> callback_data);</PRE
3309 CLASS="INFORMALTABLE"
3338 >a reference to where the newly created handle pointer should be stored</TD
3382 >items_per_notification</I
3440 >data to be passed to the callback function</TD
3455 NAME="GNOME-VFS-ASYNC-XFER"
3457 >gnome_vfs_async_xfer ()</H3
3466 CLASS="PROGRAMLISTING"
3468 HREF="gnome-vfs-types.html#GNOMEVFSRESULT"
3470 > gnome_vfs_async_xfer (GnomeVFSAsyncHandle **handle_return,
3472 HREF=../glib/glib-doubly-linked-lists.html#GLIST
3473 >GList</A> *source_uri_list,
3475 HREF=../glib/glib-doubly-linked-lists.html#GLIST
3476 >GList</A> *target_uri_list,
3478 HREF="gnome-vfs-types.html#GNOMEVFSXFEROPTIONS"
3479 >GnomeVFSXferOptions</A
3482 HREF="gnome-vfs-types.html#GNOMEVFSXFERERRORMODE"
3483 >GnomeVFSXferErrorMode</A
3486 HREF="gnome-vfs-types.html#GNOMEVFSXFEROVERWRITEMODE"
3487 >GnomeVFSXferOverwriteMode</A
3490 GnomeVFSAsyncXferProgressCallback progress_update_callback,
3492 HREF=../glib/glib-basic-types.html#GPOINTER
3493 >gpointer</A> update_callback_data,
3495 HREF="gnome-vfs-types.html#GNOMEVFSXFERPROGRESSCALLBACK"
3496 >GnomeVFSXferProgressCallback</A
3497 > progress_sync_callback,
3499 HREF=../glib/glib-basic-types.html#GPOINTER
3500 >gpointer</A> sync_callback_data);</PRE
3505 >Transfers file(s) from one location to another</P
3507 CLASS="INFORMALTABLE"
3536 >a reference to where the newly created handle pointer should be stored</TD
3558 >. Each element should be a pointer to a GnomeVFSURI object</TD
3580 >. Each element should be a pointer to a GnomeVFSURI object</TD
3658 >progress_update_callback</I
3675 >update_callback_data</I
3682 >data to be passed to the progress update callback function</TD
3692 >progress_sync_callback</I
3709 >sync_callback_data</I
3716 >data to be passed to the progress sync callback function</TD
3746 NAME="GNOME-VFS-ASYNC-FIND-DIRECTORY"
3748 >gnome_vfs_async_find_directory ()</H3
3757 CLASS="PROGRAMLISTING"
3758 >void gnome_vfs_async_find_directory (GnomeVFSAsyncHandle **handle_return,
3760 HREF=../glib/glib-doubly-linked-lists.html#GLIST
3761 >GList</A> *near_uri_list,
3763 HREF="gnome-vfs-types.html#GNOMEVFSFINDDIRECTORYKIND"
3764 >GnomeVFSFindDirectoryKind</A
3767 HREF=../glib/glib-basic-types.html#GBOOLEAN
3768 >gboolean</A> create_if_needed,
3770 HREF=../glib/glib-basic-types.html#GBOOLEAN
3771 >gboolean</A> find_if_needed,
3773 HREF=../glib/glib-basic-types.html#GUINT
3774 >guint</A> permissions,
3776 GnomeVFSAsyncFindDirectoryCallback callback,
3778 HREF=../glib/glib-basic-types.html#GPOINTER
3779 >gpointer</A> user_data);</PRE
3786 CLASS="INFORMALTABLE"
3815 >a reference to where the newly created handle pointer should be stored</TD
3859 >create_if_needed</I
3951 >data to be passed to the callback function
3964 CLEAR="all"><BR><TABLE
3976 HREF="gnome-vfs-finding-special-directories.html"
3981 ><<< Previous Page</B
4014 HREF="file-operations.html"
4030 HREF="gnome-vfs-xfer.html"
4035 >Next Page >>></B
4048 >Finding Special Directories</B