← Back to branch summary

~ubuntu-branches/debian/sid/thunar/sid

« back to all changes in this revision

Viewing changes to docs/reference/thunar-vfs/xml/thunar-vfs-operations.xml

  • Committer: Bazaar Package Importer
  • Author(s): Lionel Le Folgoc
  • Date: 2010-05-23 14:12:33 UTC
  • mfrom: (1.1.24 upstream)
  • Revision ID: james.westby@ubuntu.com-20100523141233-ntplken25atdr214
Tags: 1.0.2-1
* New upstream release.
* debian/patches/04_fix-umask-handling.patch: dropped, included upstream.
* debian/control: build-dep on libstartup-notification0-dev (>= 0.4) as
  startup notification support is enabled in debian/rules.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/thunar-vfs/xml/thunar-vfs-operations.xml
1
 
<refentry id="thunar-vfs-Operations">
2
 
<refmeta>
3
 
<refentrytitle role="top_of_page" id="thunar-vfs-Operations.top_of_page">Operations</refentrytitle>
4
 
<manvolnum>3</manvolnum>
5
 
<refmiscinfo>THUNAR-VFS Library</refmiscinfo>
6
 
</refmeta>
7
 
 
8
 
<refnamediv>
9
 
<refname>Operations</refname>
10
 
<refpurpose></refpurpose>
11
 
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
12
 
</refnamediv>
13
 
 
14
 
<refsynopsisdiv id="thunar-vfs-Operations.synopsis" role="synopsis">
15
 
<title role="synopsis.title">Synopsis</title>
16
 
 
17
 
<synopsis>
18
 
 
19
 
#include &lt;thunar-vfs/thunar-vfs.h&gt;
20
 
 
21
 
<link linkend="ThunarVfsJob">ThunarVfsJob</link>*       <link linkend="thunar-vfs-listdir">thunar_vfs_listdir</link>                  (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *path,
22
 
                                                         <link linkend="GError">GError</link> **error);
23
 
<link linkend="ThunarVfsJob">ThunarVfsJob</link>*       <link linkend="thunar-vfs-create-file">thunar_vfs_create_file</link>              (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *path,
24
 
                                                         <link linkend="GError">GError</link> **error);
25
 
<link linkend="ThunarVfsJob">ThunarVfsJob</link>*       <link linkend="thunar-vfs-create-files">thunar_vfs_create_files</link>             (<link linkend="GList">GList</link> *path_list,
26
 
                                                         <link linkend="GError">GError</link> **error);
27
 
<link linkend="ThunarVfsJob">ThunarVfsJob</link>*       <link linkend="thunar-vfs-copy-file">thunar_vfs_copy_file</link>                (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *source_path,
28
 
                                                         <link linkend="ThunarVfsPath">ThunarVfsPath</link> *target_path,
29
 
                                                         <link linkend="GError">GError</link> **error);
30
 
<link linkend="ThunarVfsJob">ThunarVfsJob</link>*       <link linkend="thunar-vfs-copy-files">thunar_vfs_copy_files</link>               (<link linkend="GList">GList</link> *source_path_list,
31
 
                                                         <link linkend="GList">GList</link> *target_path_list,
32
 
                                                         <link linkend="GError">GError</link> **error);
33
 
<link linkend="ThunarVfsJob">ThunarVfsJob</link>*       <link linkend="thunar-vfs-link-file">thunar_vfs_link_file</link>                (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *source_path,
34
 
                                                         <link linkend="ThunarVfsPath">ThunarVfsPath</link> *target_path,
35
 
                                                         <link linkend="GError">GError</link> **error);
36
 
<link linkend="ThunarVfsJob">ThunarVfsJob</link>*       <link linkend="thunar-vfs-link-files">thunar_vfs_link_files</link>               (<link linkend="GList">GList</link> *source_path_list,
37
 
                                                         <link linkend="GList">GList</link> *target_path_list,
38
 
                                                         <link linkend="GError">GError</link> **error);
39
 
<link linkend="ThunarVfsJob">ThunarVfsJob</link>*       <link linkend="thunar-vfs-move-file">thunar_vfs_move_file</link>                (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *source_path,
40
 
                                                         <link linkend="ThunarVfsPath">ThunarVfsPath</link> *target_path,
41
 
                                                         <link linkend="GError">GError</link> **error);
42
 
<link linkend="ThunarVfsJob">ThunarVfsJob</link>*       <link linkend="thunar-vfs-move-files">thunar_vfs_move_files</link>               (<link linkend="GList">GList</link> *source_path_list,
43
 
                                                         <link linkend="GList">GList</link> *target_path_list,
44
 
                                                         <link linkend="GError">GError</link> **error);
45
 
<link linkend="ThunarVfsJob">ThunarVfsJob</link>*       <link linkend="thunar-vfs-unlink-file">thunar_vfs_unlink_file</link>              (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *path,
46
 
                                                         <link linkend="GError">GError</link> **error);
47
 
<link linkend="ThunarVfsJob">ThunarVfsJob</link>*       <link linkend="thunar-vfs-unlink-files">thunar_vfs_unlink_files</link>             (<link linkend="GList">GList</link> *path_list,
48
 
                                                         <link linkend="GError">GError</link> **error);
49
 
<link linkend="ThunarVfsJob">ThunarVfsJob</link>*       <link linkend="thunar-vfs-make-directory">thunar_vfs_make_directory</link>           (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *path,
50
 
                                                         <link linkend="GError">GError</link> **error);
51
 
<link linkend="ThunarVfsJob">ThunarVfsJob</link>*       <link linkend="thunar-vfs-make-directories">thunar_vfs_make_directories</link>         (<link linkend="GList">GList</link> *path_list,
52
 
                                                         <link linkend="GError">GError</link> **error);
53
 
<link linkend="ThunarVfsJob">ThunarVfsJob</link>*       <link linkend="thunar-vfs-change-mode">thunar_vfs_change_mode</link>              (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *path,
54
 
                                                         <link linkend="ThunarVfsFileMode">ThunarVfsFileMode</link> dir_mask,
55
 
                                                         <link linkend="ThunarVfsFileMode">ThunarVfsFileMode</link> dir_mode,
56
 
                                                         <link linkend="ThunarVfsFileMode">ThunarVfsFileMode</link> file_mask,
57
 
                                                         <link linkend="ThunarVfsFileMode">ThunarVfsFileMode</link> file_mode,
58
 
                                                         <link linkend="gboolean">gboolean</link> recursive,
59
 
                                                         <link linkend="GError">GError</link> **error);
60
 
<link linkend="ThunarVfsJob">ThunarVfsJob</link>*       <link linkend="thunar-vfs-change-group">thunar_vfs_change_group</link>             (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *path,
61
 
                                                         <link linkend="ThunarVfsGroupId">ThunarVfsGroupId</link> gid,
62
 
                                                         <link linkend="gboolean">gboolean</link> recursive,
63
 
                                                         <link linkend="GError">GError</link> **error);
64
 
</synopsis>
65
 
</refsynopsisdiv>
66
 
 
67
 
 
68
 
 
69
 
 
70
 
 
71
 
 
72
 
 
73
 
 
74
 
 
75
 
<refsect1 id="thunar-vfs-Operations.description" role="desc">
76
 
<title role="desc.title">Description</title>
77
 
<para>
78
 
 
79
 
</para>
80
 
</refsect1>
81
 
 
82
 
<refsect1 id="thunar-vfs-Operations.details" role="details">
83
 
<title role="details.title">Details</title>
84
 
<refsect2 id="thunar-vfs-listdir" role="function">
85
 
<title>thunar_vfs_listdir ()</title>
86
 
<indexterm zone="thunar-vfs-listdir"><primary>thunar_vfs_listdir</primary></indexterm><programlisting><link linkend="ThunarVfsJob">ThunarVfsJob</link>*       thunar_vfs_listdir                  (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *path,
87
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
88
 
<para>
89
 
Generates a <link linkend="ThunarVfsJob"><type>ThunarVfsJob</type></link>, which lists the contents of the folder
90
 
at the specified <parameter>path</parameter>. If the job could not be launched for
91
 
some reason, <link linkend="NULL:CAPS"><literal>NULL</literal></link> will be returned and <parameter>error</parameter> will be set to
92
 
point to a <link linkend="GError"><type>GError</type></link> describing the cause. Otherwise the newly
93
 
allocated <link linkend="ThunarVfsJob"><type>ThunarVfsJob</type></link> will be returned and the caller is
94
 
responsible to call <link linkend="g-object-unref"><function>g_object_unref()</function></link>.
95
 
</para>
96
 
<para>
97
 
Note, that the returned job is launched right away, so you
98
 
don't need to call <link linkend="thunar-vfs-job-launch"><function>thunar_vfs_job_launch()</function></link> on it.</para>
99
 
<para>
100
 
 
101
 
</para><variablelist role="params">
102
 
<varlistentry><term><parameter>path</parameter>&nbsp;:</term>
103
 
<listitem><simpara>
104
 
</simpara></listitem></varlistentry>
105
 
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
106
 
<listitem><simpara>
107
 
</simpara></listitem></varlistentry>
108
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
109
 
 
110
 
 
111
 
</simpara></listitem></varlistentry>
112
 
</variablelist></refsect2>
113
 
<refsect2 id="thunar-vfs-create-file" role="function">
114
 
<title>thunar_vfs_create_file ()</title>
115
 
<indexterm zone="thunar-vfs-create-file"><primary>thunar_vfs_create_file</primary></indexterm><programlisting><link linkend="ThunarVfsJob">ThunarVfsJob</link>*       thunar_vfs_create_file              (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *path,
116
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
117
 
<para>
118
 
Allocates a new <link linkend="ThunarVfsJob"><type>ThunarVfsJob</type></link>, which creates a new empty
119
 
file at <parameter>path</parameter>.
120
 
</para>
121
 
<para>
122
 
The caller is responsible to free the returned job using
123
 
<link linkend="g-object-unref"><function>g_object_unref()</function></link> when no longer needed.
124
 
</para>
125
 
<para>
126
 
Note that the returned job is launched right away, so you
127
 
don't need to call <link linkend="thunar-vfs-job-launch"><function>thunar_vfs_job_launch()</function></link> on it.</para>
128
 
<para>
129
 
 
130
 
</para><variablelist role="params">
131
 
<varlistentry><term><parameter>path</parameter>&nbsp;:</term>
132
 
<listitem><simpara>
133
 
</simpara></listitem></varlistentry>
134
 
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
135
 
<listitem><simpara>
136
 
</simpara></listitem></varlistentry>
137
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
138
 
 
139
 
 
140
 
</simpara></listitem></varlistentry>
141
 
</variablelist></refsect2>
142
 
<refsect2 id="thunar-vfs-create-files" role="function">
143
 
<title>thunar_vfs_create_files ()</title>
144
 
<indexterm zone="thunar-vfs-create-files"><primary>thunar_vfs_create_files</primary></indexterm><programlisting><link linkend="ThunarVfsJob">ThunarVfsJob</link>*       thunar_vfs_create_files             (<link linkend="GList">GList</link> *path_list,
145
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
146
 
<para>
147
 
Allocates a new <link linkend="ThunarVfsJob"><type>ThunarVfsJob</type></link> which creates new empty files for all
148
 
<link linkend="ThunarVfsPath"><type>ThunarVfsPath</type></link><!---->s in <parameter>path_list</parameter>.
149
 
</para>
150
 
<para>
151
 
The caller is responsible to free the returned job using
152
 
<link linkend="g-object-unref"><function>g_object_unref()</function></link> when no longer needed.
153
 
</para>
154
 
<para>
155
 
Note that the returned job is launched right away, so you
156
 
don't need to call <link linkend="thunar-vfs-job-launch"><function>thunar_vfs_job_launch()</function></link> on it.</para>
157
 
<para>
158
 
 
159
 
</para><variablelist role="params">
160
 
<varlistentry><term><parameter>path_list</parameter>&nbsp;:</term>
161
 
<listitem><simpara>
162
 
</simpara></listitem></varlistentry>
163
 
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
164
 
<listitem><simpara>
165
 
</simpara></listitem></varlistentry>
166
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
167
 
 
168
 
 
169
 
</simpara></listitem></varlistentry>
170
 
</variablelist></refsect2>
171
 
<refsect2 id="thunar-vfs-copy-file" role="function">
172
 
<title>thunar_vfs_copy_file ()</title>
173
 
<indexterm zone="thunar-vfs-copy-file"><primary>thunar_vfs_copy_file</primary></indexterm><programlisting><link linkend="ThunarVfsJob">ThunarVfsJob</link>*       thunar_vfs_copy_file                (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *source_path,
174
 
                                                         <link linkend="ThunarVfsPath">ThunarVfsPath</link> *target_path,
175
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
176
 
<para>
177
 
Allocates a new <link linkend="ThunarVfsTransferJob"><type>ThunarVfsTransferJob</type></link>, which copies the file
178
 
from <parameter>source_path</parameter> to <parameter>target_path</parameter>. That said, the file or directory
179
 
located at <parameter>source_path</parameter> will be placed at <parameter>target_path</parameter>, NOT INTO
180
 
<parameter>target_path</parameter>.
181
 
</para>
182
 
<para>
183
 
The caller is responsible to free the returned job using
184
 
<link linkend="g-object-unref"><function>g_object_unref()</function></link> when no longer needed.
185
 
</para>
186
 
<para>
187
 
Note, that the returned job is launched right away, so you don't
188
 
need to call <link linkend="thunar-vfs-job-launch"><function>thunar_vfs_job_launch()</function></link> on it.</para>
189
 
<para>
190
 
 
191
 
</para><variablelist role="params">
192
 
<varlistentry><term><parameter>source_path</parameter>&nbsp;:</term>
193
 
<listitem><simpara>
194
 
</simpara></listitem></varlistentry>
195
 
<varlistentry><term><parameter>target_path</parameter>&nbsp;:</term>
196
 
<listitem><simpara>
197
 
</simpara></listitem></varlistentry>
198
 
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
199
 
<listitem><simpara>
200
 
</simpara></listitem></varlistentry>
201
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
202
 
 
203
 
 
204
 
</simpara></listitem></varlistentry>
205
 
</variablelist></refsect2>
206
 
<refsect2 id="thunar-vfs-copy-files" role="function">
207
 
<title>thunar_vfs_copy_files ()</title>
208
 
<indexterm zone="thunar-vfs-copy-files"><primary>thunar_vfs_copy_files</primary></indexterm><programlisting><link linkend="ThunarVfsJob">ThunarVfsJob</link>*       thunar_vfs_copy_files               (<link linkend="GList">GList</link> *source_path_list,
209
 
                                                         <link linkend="GList">GList</link> *target_path_list,
210
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
211
 
<para>
212
 
Similar to <link linkend="thunar-vfs-copy-file"><function>thunar_vfs_copy_file()</function></link>, but takes a bunch of files. The
213
 
<parameter>source_path_list</parameter> and <parameter>target_path_list</parameter> must be of the same size.
214
 
</para>
215
 
<para>
216
 
Note, that the returned job is launched right away, so you don't
217
 
need to call <link linkend="thunar-vfs-job-launch"><function>thunar_vfs_job_launch()</function></link> on it. The caller is responsible
218
 
to free the returned object using <link linkend="g-object-unref"><function>g_object_unref()</function></link> when no longer
219
 
needed.</para>
220
 
<para>
221
 
 
222
 
</para><variablelist role="params">
223
 
<varlistentry><term><parameter>source_path_list</parameter>&nbsp;:</term>
224
 
<listitem><simpara>
225
 
</simpara></listitem></varlistentry>
226
 
<varlistentry><term><parameter>target_path_list</parameter>&nbsp;:</term>
227
 
<listitem><simpara>
228
 
</simpara></listitem></varlistentry>
229
 
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
230
 
<listitem><simpara>
231
 
</simpara></listitem></varlistentry>
232
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
233
 
 
234
 
 
235
 
</simpara></listitem></varlistentry>
236
 
</variablelist></refsect2>
237
 
<refsect2 id="thunar-vfs-link-file" role="function">
238
 
<title>thunar_vfs_link_file ()</title>
239
 
<indexterm zone="thunar-vfs-link-file"><primary>thunar_vfs_link_file</primary></indexterm><programlisting><link linkend="ThunarVfsJob">ThunarVfsJob</link>*       thunar_vfs_link_file                (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *source_path,
240
 
                                                         <link linkend="ThunarVfsPath">ThunarVfsPath</link> *target_path,
241
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
242
 
<para>
243
 
Allocates a new <link linkend="ThunarVfsJob"><type>ThunarVfsJob</type></link>, which creates a symbolic
244
 
link from <parameter>source_path</parameter> to <parameter>target_path</parameter>.
245
 
</para>
246
 
<para>
247
 
If <parameter>source_path</parameter> and <parameter>target_path</parameter> refer to the same file,
248
 
a new unique target filename will be choosen automatically.
249
 
</para>
250
 
<para>
251
 
The caller is responsible to free the returned job using
252
 
<link linkend="g-object-unref"><function>g_object_unref()</function></link> when no longer needed.
253
 
</para>
254
 
<para>
255
 
Note, that the returned job is launched right away, so you don't
256
 
need to call <link linkend="thunar-vfs-job-launch"><function>thunar_vfs_job_launch()</function></link> on it.</para>
257
 
<para>
258
 
 
259
 
</para><variablelist role="params">
260
 
<varlistentry><term><parameter>source_path</parameter>&nbsp;:</term>
261
 
<listitem><simpara>
262
 
</simpara></listitem></varlistentry>
263
 
<varlistentry><term><parameter>target_path</parameter>&nbsp;:</term>
264
 
<listitem><simpara>
265
 
</simpara></listitem></varlistentry>
266
 
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
267
 
<listitem><simpara>
268
 
</simpara></listitem></varlistentry>
269
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
270
 
 
271
 
 
272
 
</simpara></listitem></varlistentry>
273
 
</variablelist></refsect2>
274
 
<refsect2 id="thunar-vfs-link-files" role="function">
275
 
<title>thunar_vfs_link_files ()</title>
276
 
<indexterm zone="thunar-vfs-link-files"><primary>thunar_vfs_link_files</primary></indexterm><programlisting><link linkend="ThunarVfsJob">ThunarVfsJob</link>*       thunar_vfs_link_files               (<link linkend="GList">GList</link> *source_path_list,
277
 
                                                         <link linkend="GList">GList</link> *target_path_list,
278
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
279
 
<para>
280
 
Like <link linkend="thunar-vfs-link-file"><function>thunar_vfs_link_file()</function></link>, but works on path lists, rather than a single
281
 
path. The length of the <parameter>source_path_list</parameter> and <parameter>target_path_list</parameter> must match,
282
 
otherwise the behaviour is undefined, but its likely to crash the application.
283
 
</para>
284
 
<para>
285
 
Right now links can only be created from local files to local files (with
286
 
path scheme <link linkend="THUNAR-VFS-PATH-SCHEME-FILE:CAPS"><literal>THUNAR_VFS_PATH_SCHEME_FILE</literal></link>).
287
 
</para>
288
 
<para>
289
 
The caller is responsible to free the returned job using
290
 
<link linkend="g-object-unref"><function>g_object_unref()</function></link> when no longer needed.
291
 
</para>
292
 
<para>
293
 
Note, that the returned job is launched right away, so you don't
294
 
need to call <link linkend="thunar-vfs-job-launch"><function>thunar_vfs_job_launch()</function></link> on it.</para>
295
 
<para>
296
 
 
297
 
</para><variablelist role="params">
298
 
<varlistentry><term><parameter>source_path_list</parameter>&nbsp;:</term>
299
 
<listitem><simpara>
300
 
</simpara></listitem></varlistentry>
301
 
<varlistentry><term><parameter>target_path_list</parameter>&nbsp;:</term>
302
 
<listitem><simpara>
303
 
</simpara></listitem></varlistentry>
304
 
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
305
 
<listitem><simpara>
306
 
</simpara></listitem></varlistentry>
307
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
308
 
 
309
 
 
310
 
</simpara></listitem></varlistentry>
311
 
</variablelist></refsect2>
312
 
<refsect2 id="thunar-vfs-move-file" role="function">
313
 
<title>thunar_vfs_move_file ()</title>
314
 
<indexterm zone="thunar-vfs-move-file"><primary>thunar_vfs_move_file</primary></indexterm><programlisting><link linkend="ThunarVfsJob">ThunarVfsJob</link>*       thunar_vfs_move_file                (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *source_path,
315
 
                                                         <link linkend="ThunarVfsPath">ThunarVfsPath</link> *target_path,
316
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
317
 
<para>
318
 
Allocates a new <link linkend="ThunarVfsTransferJob"><type>ThunarVfsTransferJob</type></link>, which moves the file
319
 
from <parameter>source_path</parameter> to <parameter>target_path</parameter>. That said, the file or directory
320
 
located at <parameter>source_path</parameter> will be placed at <parameter>target_path</parameter>, NOT INTO
321
 
<parameter>target_path</parameter>.
322
 
</para>
323
 
<para>
324
 
The caller is responsible to free the returned job using
325
 
<link linkend="g-object-unref"><function>g_object_unref()</function></link> when no longer needed.
326
 
</para>
327
 
<para>
328
 
Note, that the returned job is launched right away, so you don't
329
 
need to call <link linkend="thunar-vfs-job-launch"><function>thunar_vfs_job_launch()</function></link> on it.</para>
330
 
<para>
331
 
 
332
 
</para><variablelist role="params">
333
 
<varlistentry><term><parameter>source_path</parameter>&nbsp;:</term>
334
 
<listitem><simpara>
335
 
</simpara></listitem></varlistentry>
336
 
<varlistentry><term><parameter>target_path</parameter>&nbsp;:</term>
337
 
<listitem><simpara>
338
 
</simpara></listitem></varlistentry>
339
 
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
340
 
<listitem><simpara>
341
 
</simpara></listitem></varlistentry>
342
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
343
 
 
344
 
 
345
 
</simpara></listitem></varlistentry>
346
 
</variablelist></refsect2>
347
 
<refsect2 id="thunar-vfs-move-files" role="function">
348
 
<title>thunar_vfs_move_files ()</title>
349
 
<indexterm zone="thunar-vfs-move-files"><primary>thunar_vfs_move_files</primary></indexterm><programlisting><link linkend="ThunarVfsJob">ThunarVfsJob</link>*       thunar_vfs_move_files               (<link linkend="GList">GList</link> *source_path_list,
350
 
                                                         <link linkend="GList">GList</link> *target_path_list,
351
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
352
 
<para>
353
 
Similar to <link linkend="thunar-vfs-move-file"><function>thunar_vfs_move_file()</function></link>, but takes a bunch of files. The
354
 
<parameter>source_path_list</parameter> and <parameter>target_path_list</parameter> must be of the same size.
355
 
</para>
356
 
<para>
357
 
Note, that the returned job is launched right away, so you don't
358
 
need to call <link linkend="thunar-vfs-job-launch"><function>thunar_vfs_job_launch()</function></link> on it. The caller is responsible
359
 
to free the returned object using <link linkend="g-object-unref"><function>g_object_unref()</function></link> when no longer
360
 
needed.</para>
361
 
<para>
362
 
 
363
 
</para><variablelist role="params">
364
 
<varlistentry><term><parameter>source_path_list</parameter>&nbsp;:</term>
365
 
<listitem><simpara>
366
 
</simpara></listitem></varlistentry>
367
 
<varlistentry><term><parameter>target_path_list</parameter>&nbsp;:</term>
368
 
<listitem><simpara>
369
 
</simpara></listitem></varlistentry>
370
 
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
371
 
<listitem><simpara>
372
 
</simpara></listitem></varlistentry>
373
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
374
 
 
375
 
 
376
 
</simpara></listitem></varlistentry>
377
 
</variablelist></refsect2>
378
 
<refsect2 id="thunar-vfs-unlink-file" role="function">
379
 
<title>thunar_vfs_unlink_file ()</title>
380
 
<indexterm zone="thunar-vfs-unlink-file"><primary>thunar_vfs_unlink_file</primary></indexterm><programlisting><link linkend="ThunarVfsJob">ThunarVfsJob</link>*       thunar_vfs_unlink_file              (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *path,
381
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
382
 
<para>
383
 
Simple wrapper to <link linkend="thunar-vfs-unlink-files"><function>thunar_vfs_unlink_files()</function></link>, which takes
384
 
only a single path.
385
 
</para>
386
 
<para>
387
 
Note, that the returned job is launched right away, so you
388
 
don't need to call <link linkend="thunar-vfs-job-launch"><function>thunar_vfs_job_launch()</function></link> on it. The caller
389
 
is responsible to free the returned object using <link linkend="g-object-unref"><function>g_object_unref()</function></link>
390
 
when no longer needed.</para>
391
 
<para>
392
 
 
393
 
</para><variablelist role="params">
394
 
<varlistentry><term><parameter>path</parameter>&nbsp;:</term>
395
 
<listitem><simpara>
396
 
</simpara></listitem></varlistentry>
397
 
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
398
 
<listitem><simpara>
399
 
</simpara></listitem></varlistentry>
400
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
401
 
 
402
 
 
403
 
</simpara></listitem></varlistentry>
404
 
</variablelist></refsect2>
405
 
<refsect2 id="thunar-vfs-unlink-files" role="function">
406
 
<title>thunar_vfs_unlink_files ()</title>
407
 
<indexterm zone="thunar-vfs-unlink-files"><primary>thunar_vfs_unlink_files</primary></indexterm><programlisting><link linkend="ThunarVfsJob">ThunarVfsJob</link>*       thunar_vfs_unlink_files             (<link linkend="GList">GList</link> *path_list,
408
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
409
 
<para>
410
 
Allocates a new <link linkend="ThunarVfsJob"><type>ThunarVfsJob</type></link> which recursively unlinks all files
411
 
referenced by the <parameter>path_list</parameter>. If the job cannot be launched for
412
 
some reason, <link linkend="NULL:CAPS"><literal>NULL</literal></link> will be returned and <parameter>error</parameter> will be set to point to
413
 
a <link linkend="GError"><type>GError</type></link> describing the cause. Else, the newly allocated <link linkend="ThunarVfsJob"><type>ThunarVfsJob</type></link>
414
 
will be returned, and the caller is responsible to free it using
415
 
<link linkend="g-object-unref"><function>g_object_unref()</function></link> when no longer needed.
416
 
</para>
417
 
<para>
418
 
Note, that the returned job is launched right away, so you
419
 
don't need to call <link linkend="thunar-vfs-job-launch"><function>thunar_vfs_job_launch()</function></link> on it.</para>
420
 
<para>
421
 
 
422
 
</para><variablelist role="params">
423
 
<varlistentry><term><parameter>path_list</parameter>&nbsp;:</term>
424
 
<listitem><simpara>
425
 
</simpara></listitem></varlistentry>
426
 
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
427
 
<listitem><simpara>
428
 
</simpara></listitem></varlistentry>
429
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
430
 
 
431
 
 
432
 
</simpara></listitem></varlistentry>
433
 
</variablelist></refsect2>
434
 
<refsect2 id="thunar-vfs-make-directory" role="function">
435
 
<title>thunar_vfs_make_directory ()</title>
436
 
<indexterm zone="thunar-vfs-make-directory"><primary>thunar_vfs_make_directory</primary></indexterm><programlisting><link linkend="ThunarVfsJob">ThunarVfsJob</link>*       thunar_vfs_make_directory           (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *path,
437
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
438
 
<para>
439
 
Simple wrapper for <link linkend="thunar-vfs-make-directories"><function>thunar_vfs_make_directories()</function></link>.</para>
440
 
<para>
441
 
 
442
 
</para><variablelist role="params">
443
 
<varlistentry><term><parameter>path</parameter>&nbsp;:</term>
444
 
<listitem><simpara>
445
 
</simpara></listitem></varlistentry>
446
 
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
447
 
<listitem><simpara>
448
 
</simpara></listitem></varlistentry>
449
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
450
 
 
451
 
 
452
 
</simpara></listitem></varlistentry>
453
 
</variablelist></refsect2>
454
 
<refsect2 id="thunar-vfs-make-directories" role="function">
455
 
<title>thunar_vfs_make_directories ()</title>
456
 
<indexterm zone="thunar-vfs-make-directories"><primary>thunar_vfs_make_directories</primary></indexterm><programlisting><link linkend="ThunarVfsJob">ThunarVfsJob</link>*       thunar_vfs_make_directories         (<link linkend="GList">GList</link> *path_list,
457
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
458
 
<para>
459
 
Allocates a new <link linkend="ThunarVfsJob"><type>ThunarVfsJob</type></link> to create new directories at all
460
 
<link linkend="ThunarVfsPath"><type>ThunarVfsPath</type></link><!---->s specified in <parameter>path_list</parameter>. Returns <link linkend="NULL:CAPS"><literal>NULL</literal></link> if
461
 
the job could not be launched for some reason, and <parameter>error</parameter> will be
462
 
set to point to a <link linkend="GError"><type>GError</type></link> describing the cause. Otherwise the
463
 
job will be returned and the caller is responsible to free the
464
 
returned object using <link linkend="g-object-unref"><function>g_object_unref()</function></link> when no longer needed.
465
 
</para>
466
 
<para>
467
 
Note, that the returned job is launched right away, so you don't
468
 
need to call <link linkend="thunar-vfs-job-launch"><function>thunar_vfs_job_launch()</function></link> on it.</para>
469
 
<para>
470
 
 
471
 
</para><variablelist role="params">
472
 
<varlistentry><term><parameter>path_list</parameter>&nbsp;:</term>
473
 
<listitem><simpara>
474
 
</simpara></listitem></varlistentry>
475
 
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
476
 
<listitem><simpara>
477
 
</simpara></listitem></varlistentry>
478
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
479
 
 
480
 
 
481
 
</simpara></listitem></varlistentry>
482
 
</variablelist></refsect2>
483
 
<refsect2 id="thunar-vfs-change-mode" role="function">
484
 
<title>thunar_vfs_change_mode ()</title>
485
 
<indexterm zone="thunar-vfs-change-mode"><primary>thunar_vfs_change_mode</primary></indexterm><programlisting><link linkend="ThunarVfsJob">ThunarVfsJob</link>*       thunar_vfs_change_mode              (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *path,
486
 
                                                         <link linkend="ThunarVfsFileMode">ThunarVfsFileMode</link> dir_mask,
487
 
                                                         <link linkend="ThunarVfsFileMode">ThunarVfsFileMode</link> dir_mode,
488
 
                                                         <link linkend="ThunarVfsFileMode">ThunarVfsFileMode</link> file_mask,
489
 
                                                         <link linkend="ThunarVfsFileMode">ThunarVfsFileMode</link> file_mode,
490
 
                                                         <link linkend="gboolean">gboolean</link> recursive,
491
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
492
 
<para>
493
 
The caller is responsible to free the returned job using
494
 
<link linkend="g-object-unref"><function>g_object_unref()</function></link> when no longer needed.
495
 
</para>
496
 
<para>
497
 
Note, that the returned job is launched right away, so you don't
498
 
need to call <link linkend="thunar-vfs-job-launch"><function>thunar_vfs_job_launch()</function></link> on it.</para>
499
 
<para>
500
 
 
501
 
</para><variablelist role="params">
502
 
<varlistentry><term><parameter>path</parameter>&nbsp;:</term>
503
 
<listitem><simpara>
504
 
</simpara></listitem></varlistentry>
505
 
<varlistentry><term><parameter>dir_mask</parameter>&nbsp;:</term>
506
 
<listitem><simpara>
507
 
</simpara></listitem></varlistentry>
508
 
<varlistentry><term><parameter>dir_mode</parameter>&nbsp;:</term>
509
 
<listitem><simpara>
510
 
</simpara></listitem></varlistentry>
511
 
<varlistentry><term><parameter>file_mask</parameter>&nbsp;:</term>
512
 
<listitem><simpara>
513
 
</simpara></listitem></varlistentry>
514
 
<varlistentry><term><parameter>file_mode</parameter>&nbsp;:</term>
515
 
<listitem><simpara>
516
 
</simpara></listitem></varlistentry>
517
 
<varlistentry><term><parameter>recursive</parameter>&nbsp;:</term>
518
 
<listitem><simpara>
519
 
</simpara></listitem></varlistentry>
520
 
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
521
 
<listitem><simpara>
522
 
</simpara></listitem></varlistentry>
523
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
524
 
 
525
 
 
526
 
</simpara></listitem></varlistentry>
527
 
</variablelist></refsect2>
528
 
<refsect2 id="thunar-vfs-change-group" role="function">
529
 
<title>thunar_vfs_change_group ()</title>
530
 
<indexterm zone="thunar-vfs-change-group"><primary>thunar_vfs_change_group</primary></indexterm><programlisting><link linkend="ThunarVfsJob">ThunarVfsJob</link>*       thunar_vfs_change_group             (<link linkend="ThunarVfsPath">ThunarVfsPath</link> *path,
531
 
                                                         <link linkend="ThunarVfsGroupId">ThunarVfsGroupId</link> gid,
532
 
                                                         <link linkend="gboolean">gboolean</link> recursive,
533
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
534
 
<para>
535
 
The caller is responsible to free the returned job using
536
 
<link linkend="g-object-unref"><function>g_object_unref()</function></link> when no longer needed.
537
 
</para>
538
 
<para>
539
 
Note, that the returned job is launched right away, so you don't
540
 
need to call <link linkend="thunar-vfs-job-launch"><function>thunar_vfs_job_launch()</function></link> on it.</para>
541
 
<para>
542
 
 
543
 
</para><variablelist role="params">
544
 
<varlistentry><term><parameter>path</parameter>&nbsp;:</term>
545
 
<listitem><simpara>
546
 
</simpara></listitem></varlistentry>
547
 
<varlistentry><term><parameter>gid</parameter>&nbsp;:</term>
548
 
<listitem><simpara>
549
 
</simpara></listitem></varlistentry>
550
 
<varlistentry><term><parameter>recursive</parameter>&nbsp;:</term>
551
 
<listitem><simpara>
552
 
</simpara></listitem></varlistentry>
553
 
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
554
 
<listitem><simpara>
555
 
</simpara></listitem></varlistentry>
556
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
557
 
 
558
 
 
559
 
</simpara></listitem></varlistentry>
560
 
</variablelist></refsect2>
561
 
 
562
 
</refsect1>
563
 
 
564
 
 
565
 
 
566
 
 
567
 
</refentry>