<!-- ##### SECTION Title ##### -->
File Transfers

<!-- ##### SECTION Short_Description ##### -->
Conveniently copy/move/delete files en masse

<!-- ##### SECTION Long_Description ##### -->
<para>

</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### SECTION Stability_Level ##### -->


<!-- ##### ENUM GnomeVFSXferOptions ##### -->
<para>

</para>

@GNOME_VFS_XFER_DEFAULT: 
@GNOME_VFS_XFER_UNUSED_1: 
@GNOME_VFS_XFER_FOLLOW_LINKS: 
@GNOME_VFS_XFER_UNUSED_2: 
@GNOME_VFS_XFER_RECURSIVE: 
@GNOME_VFS_XFER_SAMEFS: 
@GNOME_VFS_XFER_DELETE_ITEMS: 
@GNOME_VFS_XFER_EMPTY_DIRECTORIES: 
@GNOME_VFS_XFER_NEW_UNIQUE_DIRECTORY: 
@GNOME_VFS_XFER_REMOVESOURCE: 
@GNOME_VFS_XFER_USE_UNIQUE_NAMES: 
@GNOME_VFS_XFER_LINK_ITEMS: 
@GNOME_VFS_XFER_FOLLOW_LINKS_RECURSIVE: 
@GNOME_VFS_XFER_TARGET_DEFAULT_PERMS: 

<!-- ##### ENUM GnomeVFSXferProgressStatus ##### -->
<para>

</para>

@GNOME_VFS_XFER_PROGRESS_STATUS_OK: 
@GNOME_VFS_XFER_PROGRESS_STATUS_VFSERROR: 
@GNOME_VFS_XFER_PROGRESS_STATUS_OVERWRITE: 
@GNOME_VFS_XFER_PROGRESS_STATUS_DUPLICATE: 

<!-- ##### ENUM GnomeVFSXferOverwriteMode ##### -->
<para>

</para>

@GNOME_VFS_XFER_OVERWRITE_MODE_ABORT: 
@GNOME_VFS_XFER_OVERWRITE_MODE_QUERY: 
@GNOME_VFS_XFER_OVERWRITE_MODE_REPLACE: 
@GNOME_VFS_XFER_OVERWRITE_MODE_SKIP: 

<!-- ##### ENUM GnomeVFSXferOverwriteAction ##### -->
<para>

</para>

@GNOME_VFS_XFER_OVERWRITE_ACTION_ABORT: 
@GNOME_VFS_XFER_OVERWRITE_ACTION_REPLACE: 
@GNOME_VFS_XFER_OVERWRITE_ACTION_REPLACE_ALL: 
@GNOME_VFS_XFER_OVERWRITE_ACTION_SKIP: 
@GNOME_VFS_XFER_OVERWRITE_ACTION_SKIP_ALL: 

<!-- ##### ENUM GnomeVFSXferErrorMode ##### -->
<para>

</para>

@GNOME_VFS_XFER_ERROR_MODE_ABORT: 
@GNOME_VFS_XFER_ERROR_MODE_QUERY: 

<!-- ##### ENUM GnomeVFSXferErrorAction ##### -->
<para>

</para>

@GNOME_VFS_XFER_ERROR_ACTION_ABORT: 
@GNOME_VFS_XFER_ERROR_ACTION_RETRY: 
@GNOME_VFS_XFER_ERROR_ACTION_SKIP: 

<!-- ##### ENUM GnomeVFSXferPhase ##### -->
<para>

</para>

@GNOME_VFS_XFER_PHASE_INITIAL: 
@GNOME_VFS_XFER_CHECKING_DESTINATION: 
@GNOME_VFS_XFER_PHASE_COLLECTING: 
@GNOME_VFS_XFER_PHASE_READYTOGO: 
@GNOME_VFS_XFER_PHASE_OPENSOURCE: 
@GNOME_VFS_XFER_PHASE_OPENTARGET: 
@GNOME_VFS_XFER_PHASE_COPYING: 
@GNOME_VFS_XFER_PHASE_MOVING: 
@GNOME_VFS_XFER_PHASE_READSOURCE: 
@GNOME_VFS_XFER_PHASE_WRITETARGET: 
@GNOME_VFS_XFER_PHASE_CLOSESOURCE: 
@GNOME_VFS_XFER_PHASE_CLOSETARGET: 
@GNOME_VFS_XFER_PHASE_DELETESOURCE: 
@GNOME_VFS_XFER_PHASE_SETATTRIBUTES: 
@GNOME_VFS_XFER_PHASE_FILECOMPLETED: 
@GNOME_VFS_XFER_PHASE_CLEANUP: 
@GNOME_VFS_XFER_PHASE_COMPLETED: 
@GNOME_VFS_XFER_NUM_PHASES: 

<!-- ##### STRUCT GnomeVFSXferProgressInfo ##### -->
<para>

</para>

@status: 
@vfs_status: 
@phase: 
@source_name: 
@target_name: 
@file_index: 
@files_total: 
@bytes_total: 
@file_size: 
@bytes_copied: 
@total_bytes_copied: 
@duplicate_name: 
@duplicate_count: 
@top_level_item: 
@reserved1: 
@reserved2: 

<!-- ##### USER_FUNCTION GnomeVFSXferProgressCallback ##### -->
<para>
This is the prototype for functions called during a transfer operation to
report progress.  If the return value is `FALSE' (0), the operation is
interrupted immediately: the transfer function returns with the value of
`vfs_status' if it is different from `GNOME_VFS_OK', or with
`GNOME_VFS_ERROR_INTERRUPTED' otherwise.  The effect of other values depend
on the value of `info->status':

 - If the status is `GNOME_VFS_XFER_PROGRESS_STATUS_OK', the transfer
   operation is resumed normally.

 - If the status is `GNOME_VFS_XFER_PROGRESS_STATUS_VFSERROR', the return
   value is interpreted as a `GnomeVFSXferErrorAction' and operation is
   interrupted, continued or retried accordingly.

 - If the status is `GNOME_VFS_XFER_PROGRESS_STATUS_OVERWRITE', the return
   value is interpreted as a `GnomeVFSXferOverwriteAction'. 
</para>

@info: 
@data: 
@Returns: 


<!-- ##### FUNCTION gnome_vfs_xfer_uri_list ##### -->
<para>

</para>

@source_uri_list: 
@target_uri_list: 
@xfer_options: 
@error_mode: 
@overwrite_mode: 
@progress_callback: 
@data: 
@Returns: 


<!-- ##### FUNCTION gnome_vfs_xfer_uri ##### -->
<para>

</para>

@source_uri: 
@target_uri: 
@xfer_options: 
@error_mode: 
@overwrite_mode: 
@progress_callback: 
@data: 
@Returns: 


<!-- ##### FUNCTION gnome_vfs_xfer_delete_list ##### -->
<para>

</para>

@source_uri_list: 
@error_mode: 
@xfer_options: 
@progress_callback: 
@data: 
@Returns: 


