![]() |
![]() |
![]() |
Thunar-VFS Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#include <thunar-vfs/thunar-vfs.h> ThunarVfsJob * thunar_vfs_listdir (ThunarVfsPath *path, GError **error); ThunarVfsJob * thunar_vfs_create_file (ThunarVfsPath *path, GError **error); ThunarVfsJob * thunar_vfs_create_files (GList *path_list, GError **error); ThunarVfsJob * thunar_vfs_copy_file (ThunarVfsPath *source_path, ThunarVfsPath *target_path, GError **error); ThunarVfsJob * thunar_vfs_copy_files (GList *source_path_list, GList *target_path_list, GError **error); ThunarVfsJob * thunar_vfs_link_file (ThunarVfsPath *source_path, ThunarVfsPath *target_path, GError **error); ThunarVfsJob * thunar_vfs_link_files (GList *source_path_list, GList *target_path_list, GError **error); ThunarVfsJob * thunar_vfs_move_file (ThunarVfsPath *source_path, ThunarVfsPath *target_path, GError **error); ThunarVfsJob * thunar_vfs_move_files (GList *source_path_list, GList *target_path_list, GError **error); ThunarVfsJob * thunar_vfs_unlink_file (ThunarVfsPath *path, GError **error); ThunarVfsJob * thunar_vfs_unlink_files (GList *path_list, GError **error); ThunarVfsJob * thunar_vfs_make_directory (ThunarVfsPath *path, GError **error); ThunarVfsJob * thunar_vfs_make_directories (GList *path_list, GError **error); ThunarVfsJob * thunar_vfs_change_mode (ThunarVfsPath *path, ThunarVfsFileMode dir_mask, ThunarVfsFileMode dir_mode, ThunarVfsFileMode file_mask, ThunarVfsFileMode file_mode, gboolean recursive, GError **error); ThunarVfsJob * thunar_vfs_change_group (ThunarVfsPath *path, ThunarVfsGroupId gid, gboolean recursive, GError **error); ThunarVfsJob * thunar_vfs_change_owner (ThunarVfsPath *path, ThunarVfsUserId uid, gboolean recursive, GError **error); ThunarVfsJob * thunar_vfs_deep_count (ThunarVfsPath *path, ThunarVfsDeepCountFlags flags, GError **error);
ThunarVfsJob * thunar_vfs_listdir (ThunarVfsPath *path, GError **error);
Generates a ThunarVfsJob, which lists the contents of the folder
at the specified path
. If the job could not be launched for
some reason, NULL
will be returned and error
will be set to
point to a GError describing the cause. Otherwise the newly
allocated ThunarVfsJob will be returned and the caller is
responsible to call g_object_unref()
.
Note, that the returned job is launched right away, so you
don't need to call thunar_vfs_job_launch()
on it.
|
the ThunarVfsPath for the folder that should be listed. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsJob or NULL
if an error occurs while creating the job.
|
ThunarVfsJob * thunar_vfs_create_file (ThunarVfsPath *path, GError **error);
Allocates a new ThunarVfsJob, which creates a new empty
file at path
.
The caller is responsible to free the returned job using
g_object_unref()
when no longer needed.
Note that the returned job is launched right away, so you
don't need to call thunar_vfs_job_launch()
on it.
|
the ThunarVfsPath of the file to create. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsJob or NULL
if an error occurs while creating the job.
|
ThunarVfsJob * thunar_vfs_create_files (GList *path_list, GError **error);
Allocates a new ThunarVfsJob which creates new empty files for all
ThunarVfsPaths in path_list
.
The caller is responsible to free the returned job using
g_object_unref()
when no longer needed.
Note that the returned job is launched right away, so you
don't need to call thunar_vfs_job_launch()
on it.
|
a list of ThunarVfsPaths for files to create. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsJob or NULL
if an error occurs while creating the job.
|
ThunarVfsJob * thunar_vfs_copy_file (ThunarVfsPath *source_path, ThunarVfsPath *target_path, GError **error);
Allocates a new ThunarVfsTransferJob, which copies the file
from source_path
to target_path
. That said, the file or directory
located at source_path
will be placed at target_path
, NOT INTO
target_path
.
The caller is responsible to free the returned job using
g_object_unref()
when no longer needed.
Note, that the returned job is launched right away, so you don't
need to call thunar_vfs_job_launch()
on it.
|
the source ThunarVfsPath. |
|
the target ThunarVfsPath. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsTransferJob or NULL
if an error occurs while creating the job.
|
ThunarVfsJob * thunar_vfs_copy_files (GList *source_path_list, GList *target_path_list, GError **error);
Similar to thunar_vfs_copy_file()
, but takes a bunch of files. The
source_path_list
and target_path_list
must be of the same size.
Note, that the returned job is launched right away, so you don't
need to call thunar_vfs_job_launch()
on it. The caller is responsible
to free the returned object using g_object_unref()
when no longer
needed.
|
the list of ThunarVfsPaths that should be copied. |
|
the list of ThunarVfsPaths for the targets. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsTransferJob or NULL
if an error occurs while creating the job.
|
ThunarVfsJob * thunar_vfs_link_file (ThunarVfsPath *source_path, ThunarVfsPath *target_path, GError **error);
Allocates a new ThunarVfsJob, which creates a symbolic
link from source_path
to target_path
.
If source_path
and target_path
refer to the same file,
a new unique target filename will be choosen automatically.
The caller is responsible to free the returned job using
g_object_unref()
when no longer needed.
Note, that the returned job is launched right away, so you don't
need to call thunar_vfs_job_launch()
on it.
|
the source ThunarVfsPath. |
|
the target ThunarVfsPath. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsJob or NULL
if an error occurs while creating the job.
|
ThunarVfsJob * thunar_vfs_link_files (GList *source_path_list, GList *target_path_list, GError **error);
Like thunar_vfs_link_file()
, but works on path lists, rather than a single
path. The length of the source_path_list
and target_path_list
must match,
otherwise the behaviour is undefined, but its likely to crash the application.
Right now links can only be created from local files to local files (with
path scheme THUNAR_VFS_PATH_SCHEME_FILE
).
The caller is responsible to free the returned job using
g_object_unref()
when no longer needed.
Note, that the returned job is launched right away, so you don't
need to call thunar_vfs_job_launch()
on it.
|
list of ThunarVfsPaths to the source files. |
|
list of ThunarVfsPaths to the target files. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsJob or NULL
if an error occurs while creating the job.
|
ThunarVfsJob * thunar_vfs_move_file (ThunarVfsPath *source_path, ThunarVfsPath *target_path, GError **error);
Allocates a new ThunarVfsTransferJob, which moves the file
from source_path
to target_path
. That said, the file or directory
located at source_path
will be placed at target_path
, NOT INTO
target_path
.
The caller is responsible to free the returned job using
g_object_unref()
when no longer needed.
Note, that the returned job is launched right away, so you don't
need to call thunar_vfs_job_launch()
on it.
|
the source ThunarVfsPath. |
|
the target ThunarVfsPath. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsTransferJob or NULL
if an error occurs while creating the job.
|
ThunarVfsJob * thunar_vfs_move_files (GList *source_path_list, GList *target_path_list, GError **error);
Similar to thunar_vfs_move_file()
, but takes a bunch of files. The
source_path_list
and target_path_list
must be of the same size.
Note, that the returned job is launched right away, so you don't
need to call thunar_vfs_job_launch()
on it. The caller is responsible
to free the returned object using g_object_unref()
when no longer
needed.
|
the list of ThunarVfsPaths that should be moved. |
|
the list of ThunarVfsPaths to the targets. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsTransferJob or NULL
if an error occurs while creating the job.
|
ThunarVfsJob * thunar_vfs_unlink_file (ThunarVfsPath *path, GError **error);
Simple wrapper to thunar_vfs_unlink_files()
, which takes
only a single path.
Note, that the returned job is launched right away, so you
don't need to call thunar_vfs_job_launch()
on it. The caller
is responsible to free the returned object using g_object_unref()
when no longer needed.
|
a ThunarVfsPath, that should be unlinked. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsJob or NULL
if an error occurs while creating the job.
|
ThunarVfsJob * thunar_vfs_unlink_files (GList *path_list, GError **error);
Allocates a new ThunarVfsJob which recursively unlinks all files
referenced by the path_list
. If the job cannot be launched for
some reason, NULL
will be returned and error
will be set to point to
a GError describing the cause. Else, the newly allocated ThunarVfsJob
will be returned, and the caller is responsible to free it using
g_object_unref()
when no longer needed.
Note, that the returned job is launched right away, so you
don't need to call thunar_vfs_job_launch()
on it.
|
a list of ThunarVfsPaths, that should be unlinked. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsJob or NULL
if an error occurs while creating the job.
|
ThunarVfsJob * thunar_vfs_make_directory (ThunarVfsPath *path, GError **error);
Simple wrapper for thunar_vfs_make_directories()
.
|
the ThunarVfsPath to the directory to create. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsJob or NULL
if an error occurs while creating the job.
|
ThunarVfsJob * thunar_vfs_make_directories (GList *path_list, GError **error);
Allocates a new ThunarVfsJob to create new directories at all
ThunarVfsPaths specified in path_list
. Returns NULL
if
the job could not be launched for some reason, and error
will be
set to point to a GError describing the cause. Otherwise the
job will be returned and the caller is responsible to free the
returned object using g_object_unref()
when no longer needed.
Note, that the returned job is launched right away, so you don't
need to call thunar_vfs_job_launch()
on it.
|
a list of ThunarVfsPaths that contain the paths to the directories which should be created. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsJob or NULL
if an error occurs while creating the job.
|
ThunarVfsJob * thunar_vfs_change_mode (ThunarVfsPath *path, ThunarVfsFileMode dir_mask, ThunarVfsFileMode dir_mode, ThunarVfsFileMode file_mask, ThunarVfsFileMode file_mode, gboolean recursive, GError **error);
The caller is responsible to free the returned job using
g_object_unref()
when no longer needed.
Note, that the returned job is launched right away, so you don't
need to call thunar_vfs_job_launch()
on it.
|
the base ThunarVfsPath. |
|
the mask for the dir_mode .
|
|
the new mode for directories. |
|
the mask for the file_mode .
|
|
the new mode for files. |
|
whether to change permissions recursively. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsJob or NULL
if an error occurs while creating the job.
|
ThunarVfsJob * thunar_vfs_change_group (ThunarVfsPath *path, ThunarVfsGroupId gid, gboolean recursive, GError **error);
The caller is responsible to free the returned job using
g_object_unref()
when no longer needed.
Note, that the returned job is launched right away, so you don't
need to call thunar_vfs_job_launch()
on it.
|
the base ThunarVfsPath. |
|
the new group id. |
|
whether to change groups recursively. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsJob or NULL
if an error occurs while creating the job.
|
ThunarVfsJob * thunar_vfs_change_owner (ThunarVfsPath *path, ThunarVfsUserId uid, gboolean recursive, GError **error);
The caller is responsible to free the returned job using
g_object_unref()
when no longer needed.
Note, that the returned job is launched right away, so you don't
need to call thunar_vfs_job_launch()
on it.
|
the base ThunarVfsPath. |
|
the new user id. |
|
whether to change groups recursively. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsChownJob or NULL
if an error occurs while creating the job.
|
ThunarVfsJob * thunar_vfs_deep_count (ThunarVfsPath *path, ThunarVfsDeepCountFlags flags, GError **error);
Starts a ThunarVfsJob, which will count the number of items
in the directory specified by path
and also determine the
total size. If path
is not a directory, then the size of the
item at path
will be determined.
The caller is responsible to free the returned job using
g_object_unref()
when no longer needed.
Note, that the returned job is launched right away, so you don't
need to call thunar_vfs_job_launch()
on it.
|
the base ThunarVfsPath. |
|
the ThunarVfsDeepCountFlags which control the behaviour of the returned job. |
|
return location for errors or NULL .
|
Returns : |
the newly allocated ThunarVfsDeepCountJob or NULL
if an error occurs while creating the job.
|