]> gitweb.factorcode.org Git - factor.git/blob - basis/gio/Gio-2.0.gir
Add Wombat theme, put it and Base16 theme in OS X menu
[factor.git] / basis / gio / Gio-2.0.gir
1 <?xml version="1.0"?>
2 <!-- This file was automatically generated from C sources - DO NOT EDIT!
3 To affect the contents of this file, edit the original C definitions,
4 and/or use gtk-doc annotations.  -->
5 <repository version="1.2"
6             xmlns="http://www.gtk.org/introspection/core/1.0"
7             xmlns:c="http://www.gtk.org/introspection/c/1.0"
8             xmlns:glib="http://www.gtk.org/introspection/glib/1.0">
9   <include name="GLib" version="2.0"/>
10   <include name="GObject" version="2.0"/>
11   <package name="gio-2.0"/>
12   <package name="gio-unix-2.0"/>
13   <c:include name="gio/gio.h"/>
14   <namespace name="Gio"
15              version="2.0"
16              shared-library="libgio-2.0.so.0"
17              c:identifier-prefixes="G"
18              c:symbol-prefixes="g">
19     <interface name="Action"
20                c:symbol-prefix="action"
21                c:type="GAction"
22                glib:type-name="GAction"
23                glib:get-type="g_action_get_type"
24                glib:type-struct="ActionInterface">
25       <virtual-method name="activate" invoker="activate" version="2.26">
26         <doc xml:whitespace="preserve">Activates the action.
27 the parameter type given at construction time).  If the parameter
28 type was %NULL then @parameter must also be %NULL.</doc>
29         <return-value transfer-ownership="none">
30           <type name="none" c:type="void"/>
31         </return-value>
32         <parameters>
33           <parameter name="parameter" transfer-ownership="none" allow-none="1">
34             <doc xml:whitespace="preserve">the parameter to the activation</doc>
35             <type name="GLib.Variant" c:type="GVariant*"/>
36           </parameter>
37         </parameters>
38       </virtual-method>
39       <virtual-method name="get_enabled" invoker="get_enabled" version="2.26">
40         <doc xml:whitespace="preserve">Checks if @action is currently enabled.
41 An action must be enabled in order to be activated or in order to
42 have its state changed from outside callers.</doc>
43         <return-value transfer-ownership="none">
44           <doc xml:whitespace="preserve">whether the action is enabled</doc>
45           <type name="gboolean" c:type="gboolean"/>
46         </return-value>
47       </virtual-method>
48       <virtual-method name="get_name" invoker="get_name" version="2.26">
49         <doc xml:whitespace="preserve">Queries the name of @action.</doc>
50         <return-value transfer-ownership="none">
51           <doc xml:whitespace="preserve">the name of the action</doc>
52           <type name="utf8" c:type="gchar*"/>
53         </return-value>
54       </virtual-method>
55       <virtual-method name="get_parameter_type"
56                       invoker="get_parameter_type"
57                       version="2.26">
58         <doc xml:whitespace="preserve">Queries the type of the parameter that must be given when activating
59 When activating the action using g_action_activate(), the #GVariant
60 given to that function must be of the type returned by this function.
61 In the case that this function returns %NULL, you must not give any
62 #GVariant, but %NULL instead.</doc>
63         <return-value transfer-ownership="none">
64           <doc xml:whitespace="preserve">the parameter type</doc>
65           <type name="GLib.VariantType" c:type="GVariantType*"/>
66         </return-value>
67       </virtual-method>
68       <virtual-method name="get_state" invoker="get_state" version="2.26">
69         <doc xml:whitespace="preserve">Queries the current state of @action.
70 If the action is not stateful then %NULL will be returned.  If the
71 action is stateful then the type of the return value is the type
72 given by g_action_get_state_type().
73 The return value (if non-%NULL) should be freed with
74 g_variant_unref() when it is no longer required.</doc>
75         <return-value transfer-ownership="full">
76           <doc xml:whitespace="preserve">the current state of the action</doc>
77           <type name="GLib.Variant" c:type="GVariant*"/>
78         </return-value>
79       </virtual-method>
80       <virtual-method name="get_state_hint"
81                       invoker="get_state_hint"
82                       version="2.26">
83         <doc xml:whitespace="preserve">Requests a hint about the valid range of values for the state of
84 If %NULL is returned it either means that the action is not stateful
85 or that there is no hint about the valid range of values for the
86 state of the action.
87 If a #GVariant array is returned then each item in the array is a
88 returned then the tuple specifies the inclusive lower and upper bound
89 of valid values for the state.
90 In any case, the information is merely a hint.  It may be possible to
91 have a state value outside of the hinted range and setting a value
92 within the range may fail.
93 The return value (if non-%NULL) should be freed with
94 g_variant_unref() when it is no longer required.</doc>
95         <return-value transfer-ownership="full">
96           <doc xml:whitespace="preserve">the state range hint</doc>
97           <type name="GLib.Variant" c:type="GVariant*"/>
98         </return-value>
99       </virtual-method>
100       <virtual-method name="get_state_type"
101                       invoker="get_state_type"
102                       version="2.26">
103         <doc xml:whitespace="preserve">Queries the type of the state of @action.
104 g_action_new_stateful()) then this function returns the #GVariantType
105 of the state.  This is the type of the initial value given as the
106 state.  All calls to g_action_set_state() must give a #GVariant of
107 this type and g_action_get_state() will return a #GVariant of the
108 same type.
109 this function will return %NULL.  In that case, g_action_get_state()
110 will return %NULL and you must not call g_action_set_state().</doc>
111         <return-value transfer-ownership="none">
112           <doc xml:whitespace="preserve">the state type, if the action is stateful</doc>
113           <type name="GLib.VariantType" c:type="GVariantType*"/>
114         </return-value>
115       </virtual-method>
116       <virtual-method name="set_state" invoker="set_state" version="2.26">
117         <doc xml:whitespace="preserve">Request for the state of @action to be changed to @value.
118 The action must be stateful and @value must be of the correct type.
119 See g_action_get_state_type().
120 This call merely requests a change.  The action may refuse to change
121 its state or may change its state to something other than @value.
122 See g_action_get_state_hint().
123 If the @value GVariant is floating, it is consumed.</doc>
124         <return-value transfer-ownership="none">
125           <type name="none" c:type="void"/>
126         </return-value>
127         <parameters>
128           <parameter name="state" transfer-ownership="none">
129             <type name="GLib.Variant" c:type="GVariant*"/>
130           </parameter>
131         </parameters>
132       </virtual-method>
133       <method name="activate" c:identifier="g_action_activate" version="2.26">
134         <doc xml:whitespace="preserve">Activates the action.
135 the parameter type given at construction time).  If the parameter
136 type was %NULL then @parameter must also be %NULL.</doc>
137         <return-value transfer-ownership="none">
138           <type name="none" c:type="void"/>
139         </return-value>
140         <parameters>
141           <parameter name="parameter" transfer-ownership="none" allow-none="1">
142             <doc xml:whitespace="preserve">the parameter to the activation</doc>
143             <type name="GLib.Variant" c:type="GVariant*"/>
144           </parameter>
145         </parameters>
146       </method>
147       <method name="get_enabled"
148               c:identifier="g_action_get_enabled"
149               version="2.26">
150         <doc xml:whitespace="preserve">Checks if @action is currently enabled.
151 An action must be enabled in order to be activated or in order to
152 have its state changed from outside callers.</doc>
153         <return-value transfer-ownership="none">
154           <doc xml:whitespace="preserve">whether the action is enabled</doc>
155           <type name="gboolean" c:type="gboolean"/>
156         </return-value>
157       </method>
158       <method name="get_name" c:identifier="g_action_get_name" version="2.26">
159         <doc xml:whitespace="preserve">Queries the name of @action.</doc>
160         <return-value transfer-ownership="none">
161           <doc xml:whitespace="preserve">the name of the action</doc>
162           <type name="utf8" c:type="gchar*"/>
163         </return-value>
164       </method>
165       <method name="get_parameter_type"
166               c:identifier="g_action_get_parameter_type"
167               version="2.26">
168         <doc xml:whitespace="preserve">Queries the type of the parameter that must be given when activating
169 When activating the action using g_action_activate(), the #GVariant
170 given to that function must be of the type returned by this function.
171 In the case that this function returns %NULL, you must not give any
172 #GVariant, but %NULL instead.</doc>
173         <return-value transfer-ownership="none">
174           <doc xml:whitespace="preserve">the parameter type</doc>
175           <type name="GLib.VariantType" c:type="GVariantType*"/>
176         </return-value>
177       </method>
178       <method name="get_state"
179               c:identifier="g_action_get_state"
180               version="2.26">
181         <doc xml:whitespace="preserve">Queries the current state of @action.
182 If the action is not stateful then %NULL will be returned.  If the
183 action is stateful then the type of the return value is the type
184 given by g_action_get_state_type().
185 The return value (if non-%NULL) should be freed with
186 g_variant_unref() when it is no longer required.</doc>
187         <return-value transfer-ownership="full">
188           <doc xml:whitespace="preserve">the current state of the action</doc>
189           <type name="GLib.Variant" c:type="GVariant*"/>
190         </return-value>
191       </method>
192       <method name="get_state_hint"
193               c:identifier="g_action_get_state_hint"
194               version="2.26">
195         <doc xml:whitespace="preserve">Requests a hint about the valid range of values for the state of
196 If %NULL is returned it either means that the action is not stateful
197 or that there is no hint about the valid range of values for the
198 state of the action.
199 If a #GVariant array is returned then each item in the array is a
200 returned then the tuple specifies the inclusive lower and upper bound
201 of valid values for the state.
202 In any case, the information is merely a hint.  It may be possible to
203 have a state value outside of the hinted range and setting a value
204 within the range may fail.
205 The return value (if non-%NULL) should be freed with
206 g_variant_unref() when it is no longer required.</doc>
207         <return-value transfer-ownership="full">
208           <doc xml:whitespace="preserve">the state range hint</doc>
209           <type name="GLib.Variant" c:type="GVariant*"/>
210         </return-value>
211       </method>
212       <method name="get_state_type"
213               c:identifier="g_action_get_state_type"
214               version="2.26">
215         <doc xml:whitespace="preserve">Queries the type of the state of @action.
216 g_action_new_stateful()) then this function returns the #GVariantType
217 of the state.  This is the type of the initial value given as the
218 state.  All calls to g_action_set_state() must give a #GVariant of
219 this type and g_action_get_state() will return a #GVariant of the
220 same type.
221 this function will return %NULL.  In that case, g_action_get_state()
222 will return %NULL and you must not call g_action_set_state().</doc>
223         <return-value transfer-ownership="none">
224           <doc xml:whitespace="preserve">the state type, if the action is stateful</doc>
225           <type name="GLib.VariantType" c:type="GVariantType*"/>
226         </return-value>
227       </method>
228       <method name="set_state"
229               c:identifier="g_action_set_state"
230               version="2.26">
231         <doc xml:whitespace="preserve">Request for the state of @action to be changed to @value.
232 The action must be stateful and @value must be of the correct type.
233 See g_action_get_state_type().
234 This call merely requests a change.  The action may refuse to change
235 its state or may change its state to something other than @value.
236 See g_action_get_state_hint().
237 If the @value GVariant is floating, it is consumed.</doc>
238         <return-value transfer-ownership="none">
239           <type name="none" c:type="void"/>
240         </return-value>
241         <parameters>
242           <parameter name="value" transfer-ownership="none">
243             <doc xml:whitespace="preserve">the new state</doc>
244             <type name="GLib.Variant" c:type="GVariant*"/>
245           </parameter>
246         </parameters>
247       </method>
248       <property name="enabled" version="2.26" transfer-ownership="none">
249         <doc xml:whitespace="preserve">If @action is currently enabled.
250 If the action is disabled then calls to g_action_activate() and
251 g_action_set_state() have no effect.</doc>
252         <type name="gboolean"/>
253       </property>
254       <property name="name" version="2.26" transfer-ownership="none">
255         <doc xml:whitespace="preserve">The name of the action.  This is mostly meaningful for identifying
256 the action once it has been added to a #GActionGroup.</doc>
257         <type name="utf8"/>
258       </property>
259       <property name="parameter-type"
260                 version="2.26"
261                 introspectable="0"
262                 transfer-ownership="none">
263         <doc xml:whitespace="preserve">The type of the parameter that must be given when activating the
264 action.</doc>
265         <type/>
266       </property>
267       <property name="state"
268                 version="2.26"
269                 writable="1"
270                 construct="1"
271                 transfer-ownership="none">
272         <doc xml:whitespace="preserve">The state of the action, or %NULL if the action is stateless.</doc>
273         <type name="GLib.Variant"/>
274       </property>
275       <property name="state-type"
276                 version="2.26"
277                 introspectable="0"
278                 transfer-ownership="none">
279         <doc xml:whitespace="preserve">The #GVariantType of the state that the action has, or %NULL if the
280 action is stateless.</doc>
281         <type/>
282       </property>
283     </interface>
284     <interface name="ActionGroup"
285                c:symbol-prefix="action_group"
286                c:type="GActionGroup"
287                glib:type-name="GActionGroup"
288                glib:get-type="g_action_group_get_type"
289                glib:type-struct="ActionGroupInterface">
290       <virtual-method name="activate" invoker="activate" version="2.26">
291         <doc xml:whitespace="preserve">Activate the named action within @action_group.
292 If the action is expecting a parameter, then the correct type of
293 parameter must be given as @parameter.  If the action is expecting no
294 parameters then @parameter must be %NULL.  See
295 g_action_group_get_parameter_type().</doc>
296         <return-value transfer-ownership="none">
297           <type name="none" c:type="void"/>
298         </return-value>
299         <parameters>
300           <parameter name="action_name" transfer-ownership="none">
301             <doc xml:whitespace="preserve">the name of the action to activate</doc>
302             <type name="utf8" c:type="gchar*"/>
303           </parameter>
304           <parameter name="parameter" transfer-ownership="none" allow-none="1">
305             <doc xml:whitespace="preserve">parameters to the activation</doc>
306             <type name="GLib.Variant" c:type="GVariant*"/>
307           </parameter>
308         </parameters>
309       </virtual-method>
310       <virtual-method name="get_enabled" invoker="get_enabled" version="2.26">
311         <doc xml:whitespace="preserve">Checks if the named action within @action_group is currently enabled.
312 An action must be enabled in order to be activated or in order to
313 have its state changed from outside callers.</doc>
314         <return-value transfer-ownership="none">
315           <doc xml:whitespace="preserve">whether or not the action is currently enabled</doc>
316           <type name="gboolean" c:type="gboolean"/>
317         </return-value>
318         <parameters>
319           <parameter name="action_name" transfer-ownership="none">
320             <doc xml:whitespace="preserve">the name of the action to query</doc>
321             <type name="utf8" c:type="gchar*"/>
322           </parameter>
323         </parameters>
324       </virtual-method>
325       <virtual-method name="get_parameter_type"
326                       invoker="get_parameter_type"
327                       version="2.26">
328         <doc xml:whitespace="preserve">Queries the type of the parameter that must be given when activating
329 the named action within @action_group.
330 When activating the action using g_action_group_activate(), the
331 #GVariant given to that function must be of the type returned by this
332 function.
333 In the case that this function returns %NULL, you must not give any
334 #GVariant, but %NULL instead.
335 The parameter type of a particular action will never change but it is
336 possible for an action to be removed and for a new action to be added
337 with the same name but a different parameter type.</doc>
338         <return-value transfer-ownership="none">
339           <doc xml:whitespace="preserve">the parameter type</doc>
340           <type name="GLib.VariantType" c:type="GVariantType*"/>
341         </return-value>
342         <parameters>
343           <parameter name="action_name" transfer-ownership="none">
344             <doc xml:whitespace="preserve">the name of the action to query</doc>
345             <type name="utf8" c:type="gchar*"/>
346           </parameter>
347         </parameters>
348       </virtual-method>
349       <virtual-method name="get_state" invoker="get_state" version="2.26">
350         <doc xml:whitespace="preserve">Queries the current state of the named action within @action_group.
351 If the action is not stateful then %NULL will be returned.  If the
352 action is stateful then the type of the return value is the type
353 given by g_action_group_get_state_type().
354 The return value (if non-%NULL) should be freed with
355 g_variant_unref() when it is no longer required.</doc>
356         <return-value transfer-ownership="full">
357           <doc xml:whitespace="preserve">the current state of the action</doc>
358           <type name="GLib.Variant" c:type="GVariant*"/>
359         </return-value>
360         <parameters>
361           <parameter name="action_name" transfer-ownership="none">
362             <doc xml:whitespace="preserve">the name of the action to query</doc>
363             <type name="utf8" c:type="gchar*"/>
364           </parameter>
365         </parameters>
366       </virtual-method>
367       <virtual-method name="get_state_hint"
368                       invoker="get_state_hint"
369                       version="2.26">
370         <doc xml:whitespace="preserve">Requests a hint about the valid range of values for the state of the
371 named action within @action_group.
372 If %NULL is returned it either means that the action is not stateful
373 or that there is no hint about the valid range of values for the
374 state of the action.
375 If a #GVariant array is returned then each item in the array is a
376 returned then the tuple specifies the inclusive lower and upper bound
377 of valid values for the state.
378 In any case, the information is merely a hint.  It may be possible to
379 have a state value outside of the hinted range and setting a value
380 within the range may fail.
381 The return value (if non-%NULL) should be freed with
382 g_variant_unref() when it is no longer required.</doc>
383         <return-value transfer-ownership="full">
384           <doc xml:whitespace="preserve">the state range hint</doc>
385           <type name="GLib.Variant" c:type="GVariant*"/>
386         </return-value>
387         <parameters>
388           <parameter name="action_name" transfer-ownership="none">
389             <doc xml:whitespace="preserve">the name of the action to query</doc>
390             <type name="utf8" c:type="gchar*"/>
391           </parameter>
392         </parameters>
393       </virtual-method>
394       <virtual-method name="get_state_type"
395                       invoker="get_state_type"
396                       version="2.26"
397                       introspectable="0">
398         <doc xml:whitespace="preserve">Queries the type of the state of the named action within
399 If the action is stateful then this function returns the
400 #GVariantType of the state.  All calls to g_action_group_set_state()
401 must give a #GVariant of this type and g_action_group_get_state()
402 will return a #GVariant of the same type.
403 If the action is not stateful then this function will return %NULL.
404 In that case, g_action_group_get_state() will return %NULL and you
405 must not call g_action_group_set_state().
406 The state type of a particular action will never change but it is
407 possible for an action to be removed and for a new action to be added
408 with the same name but a different state type.</doc>
409         <return-value transfer-ownership="full">
410           <doc xml:whitespace="preserve">the state type, if the action is stateful</doc>
411           <type name="GLib.VariantType" c:type="GVariantType*"/>
412         </return-value>
413         <parameters>
414           <parameter name="action_name" transfer-ownership="none">
415             <doc xml:whitespace="preserve">the name of the action to query</doc>
416             <type name="utf8" c:type="gchar*"/>
417           </parameter>
418         </parameters>
419       </virtual-method>
420       <virtual-method name="has_action" invoker="has_action" version="2.26">
421         <doc xml:whitespace="preserve">Checks if the named action exists within @action_group.</doc>
422         <return-value transfer-ownership="none">
423           <doc xml:whitespace="preserve">whether the named action exists</doc>
424           <type name="gboolean" c:type="gboolean"/>
425         </return-value>
426         <parameters>
427           <parameter name="action_name" transfer-ownership="none">
428             <doc xml:whitespace="preserve">the name of the action to check for</doc>
429             <type name="utf8" c:type="gchar*"/>
430           </parameter>
431         </parameters>
432       </virtual-method>
433       <virtual-method name="list_actions"
434                       invoker="list_actions"
435                       version="2.26">
436         <doc xml:whitespace="preserve">Lists the actions contained within @action_group.
437 The caller is responsible for freeing the list with g_strfreev() when
438 it is no longer required.
439 actions in the groupb</doc>
440         <return-value transfer-ownership="full">
441           <doc xml:whitespace="preserve">a %NULL-terminated array of the names of the</doc>
442           <array c:type="gchar**">
443             <type name="utf8"/>
444           </array>
445         </return-value>
446       </virtual-method>
447       <virtual-method name="set_state" invoker="set_state" version="2.26">
448         <doc xml:whitespace="preserve">Request for the state of the named action within @action_group to be
449 changed to @value.
450 The action must be stateful and @value must be of the correct type.
451 See g_action_group_get_state_type().
452 This call merely requests a change.  The action may refuse to change
453 its state or may change its state to something other than @value.
454 See g_action_group_get_state_hint().
455 If the @value GVariant is floating, it is consumed.</doc>
456         <return-value transfer-ownership="none">
457           <type name="none" c:type="void"/>
458         </return-value>
459         <parameters>
460           <parameter name="action_name" transfer-ownership="none">
461             <doc xml:whitespace="preserve">the name of the action to request the change on</doc>
462             <type name="utf8" c:type="gchar*"/>
463           </parameter>
464           <parameter name="value" transfer-ownership="none">
465             <doc xml:whitespace="preserve">the new state</doc>
466             <type name="GLib.Variant" c:type="GVariant*"/>
467           </parameter>
468         </parameters>
469       </virtual-method>
470       <method name="action_added"
471               c:identifier="g_action_group_action_added"
472               version="2.26">
473         <doc xml:whitespace="preserve">Emits the #GActionGroup::action-added signal on @action_group.
474 This function should only be called by #GActionGroup implementations.</doc>
475         <return-value transfer-ownership="none">
476           <type name="none" c:type="void"/>
477         </return-value>
478         <parameters>
479           <parameter name="action_name" transfer-ownership="none">
480             <doc xml:whitespace="preserve">the name of an action in the group</doc>
481             <type name="utf8" c:type="gchar*"/>
482           </parameter>
483         </parameters>
484       </method>
485       <method name="action_enabled_changed"
486               c:identifier="g_action_group_action_enabled_changed"
487               version="2.26">
488         <doc xml:whitespace="preserve">Emits the #GActionGroup::action-enabled-changed signal on @action_group.
489 This function should only be called by #GActionGroup implementations.</doc>
490         <return-value transfer-ownership="none">
491           <type name="none" c:type="void"/>
492         </return-value>
493         <parameters>
494           <parameter name="action_name" transfer-ownership="none">
495             <doc xml:whitespace="preserve">the name of an action in the group</doc>
496             <type name="utf8" c:type="gchar*"/>
497           </parameter>
498           <parameter name="enabled" transfer-ownership="none">
499             <doc xml:whitespace="preserve">whether or not the action is now enabled</doc>
500             <type name="gboolean" c:type="gboolean"/>
501           </parameter>
502         </parameters>
503       </method>
504       <method name="action_removed"
505               c:identifier="g_action_group_action_removed"
506               version="2.26">
507         <doc xml:whitespace="preserve">Emits the #GActionGroup::action-removed signal on @action_group.
508 This function should only be called by #GActionGroup implementations.</doc>
509         <return-value transfer-ownership="none">
510           <type name="none" c:type="void"/>
511         </return-value>
512         <parameters>
513           <parameter name="action_name" transfer-ownership="none">
514             <doc xml:whitespace="preserve">the name of an action in the group</doc>
515             <type name="utf8" c:type="gchar*"/>
516           </parameter>
517         </parameters>
518       </method>
519       <method name="action_state_changed"
520               c:identifier="g_action_group_action_state_changed"
521               version="2.26">
522         <doc xml:whitespace="preserve">Emits the #GActionGroup::action-state-changed signal on @action_group.
523 This function should only be called by #GActionGroup implementations.</doc>
524         <return-value transfer-ownership="none">
525           <type name="none" c:type="void"/>
526         </return-value>
527         <parameters>
528           <parameter name="action_name" transfer-ownership="none">
529             <doc xml:whitespace="preserve">the name of an action in the group</doc>
530             <type name="utf8" c:type="gchar*"/>
531           </parameter>
532           <parameter name="state" transfer-ownership="none">
533             <doc xml:whitespace="preserve">the new state of the named action</doc>
534             <type name="GLib.Variant" c:type="GVariant*"/>
535           </parameter>
536         </parameters>
537       </method>
538       <method name="activate"
539               c:identifier="g_action_group_activate"
540               version="2.26">
541         <doc xml:whitespace="preserve">Activate the named action within @action_group.
542 If the action is expecting a parameter, then the correct type of
543 parameter must be given as @parameter.  If the action is expecting no
544 parameters then @parameter must be %NULL.  See
545 g_action_group_get_parameter_type().</doc>
546         <return-value transfer-ownership="none">
547           <type name="none" c:type="void"/>
548         </return-value>
549         <parameters>
550           <parameter name="action_name" transfer-ownership="none">
551             <doc xml:whitespace="preserve">the name of the action to activate</doc>
552             <type name="utf8" c:type="gchar*"/>
553           </parameter>
554           <parameter name="parameter" transfer-ownership="none" allow-none="1">
555             <doc xml:whitespace="preserve">parameters to the activation</doc>
556             <type name="GLib.Variant" c:type="GVariant*"/>
557           </parameter>
558         </parameters>
559       </method>
560       <method name="get_enabled"
561               c:identifier="g_action_group_get_enabled"
562               version="2.26">
563         <doc xml:whitespace="preserve">Checks if the named action within @action_group is currently enabled.
564 An action must be enabled in order to be activated or in order to
565 have its state changed from outside callers.</doc>
566         <return-value transfer-ownership="none">
567           <doc xml:whitespace="preserve">whether or not the action is currently enabled</doc>
568           <type name="gboolean" c:type="gboolean"/>
569         </return-value>
570         <parameters>
571           <parameter name="action_name" transfer-ownership="none">
572             <doc xml:whitespace="preserve">the name of the action to query</doc>
573             <type name="utf8" c:type="gchar*"/>
574           </parameter>
575         </parameters>
576       </method>
577       <method name="get_parameter_type"
578               c:identifier="g_action_group_get_parameter_type"
579               version="2.26">
580         <doc xml:whitespace="preserve">Queries the type of the parameter that must be given when activating
581 the named action within @action_group.
582 When activating the action using g_action_group_activate(), the
583 #GVariant given to that function must be of the type returned by this
584 function.
585 In the case that this function returns %NULL, you must not give any
586 #GVariant, but %NULL instead.
587 The parameter type of a particular action will never change but it is
588 possible for an action to be removed and for a new action to be added
589 with the same name but a different parameter type.</doc>
590         <return-value transfer-ownership="none">
591           <doc xml:whitespace="preserve">the parameter type</doc>
592           <type name="GLib.VariantType" c:type="GVariantType*"/>
593         </return-value>
594         <parameters>
595           <parameter name="action_name" transfer-ownership="none">
596             <doc xml:whitespace="preserve">the name of the action to query</doc>
597             <type name="utf8" c:type="gchar*"/>
598           </parameter>
599         </parameters>
600       </method>
601       <method name="get_state"
602               c:identifier="g_action_group_get_state"
603               version="2.26">
604         <doc xml:whitespace="preserve">Queries the current state of the named action within @action_group.
605 If the action is not stateful then %NULL will be returned.  If the
606 action is stateful then the type of the return value is the type
607 given by g_action_group_get_state_type().
608 The return value (if non-%NULL) should be freed with
609 g_variant_unref() when it is no longer required.</doc>
610         <return-value transfer-ownership="full">
611           <doc xml:whitespace="preserve">the current state of the action</doc>
612           <type name="GLib.Variant" c:type="GVariant*"/>
613         </return-value>
614         <parameters>
615           <parameter name="action_name" transfer-ownership="none">
616             <doc xml:whitespace="preserve">the name of the action to query</doc>
617             <type name="utf8" c:type="gchar*"/>
618           </parameter>
619         </parameters>
620       </method>
621       <method name="get_state_hint"
622               c:identifier="g_action_group_get_state_hint"
623               version="2.26">
624         <doc xml:whitespace="preserve">Requests a hint about the valid range of values for the state of the
625 named action within @action_group.
626 If %NULL is returned it either means that the action is not stateful
627 or that there is no hint about the valid range of values for the
628 state of the action.
629 If a #GVariant array is returned then each item in the array is a
630 returned then the tuple specifies the inclusive lower and upper bound
631 of valid values for the state.
632 In any case, the information is merely a hint.  It may be possible to
633 have a state value outside of the hinted range and setting a value
634 within the range may fail.
635 The return value (if non-%NULL) should be freed with
636 g_variant_unref() when it is no longer required.</doc>
637         <return-value transfer-ownership="full">
638           <doc xml:whitespace="preserve">the state range hint</doc>
639           <type name="GLib.Variant" c:type="GVariant*"/>
640         </return-value>
641         <parameters>
642           <parameter name="action_name" transfer-ownership="none">
643             <doc xml:whitespace="preserve">the name of the action to query</doc>
644             <type name="utf8" c:type="gchar*"/>
645           </parameter>
646         </parameters>
647       </method>
648       <method name="get_state_type"
649               c:identifier="g_action_group_get_state_type"
650               version="2.26"
651               introspectable="0">
652         <doc xml:whitespace="preserve">Queries the type of the state of the named action within
653 If the action is stateful then this function returns the
654 #GVariantType of the state.  All calls to g_action_group_set_state()
655 must give a #GVariant of this type and g_action_group_get_state()
656 will return a #GVariant of the same type.
657 If the action is not stateful then this function will return %NULL.
658 In that case, g_action_group_get_state() will return %NULL and you
659 must not call g_action_group_set_state().
660 The state type of a particular action will never change but it is
661 possible for an action to be removed and for a new action to be added
662 with the same name but a different state type.</doc>
663         <return-value transfer-ownership="full">
664           <doc xml:whitespace="preserve">the state type, if the action is stateful</doc>
665           <type name="GLib.VariantType" c:type="GVariantType*"/>
666         </return-value>
667         <parameters>
668           <parameter name="action_name" transfer-ownership="none">
669             <doc xml:whitespace="preserve">the name of the action to query</doc>
670             <type name="utf8" c:type="gchar*"/>
671           </parameter>
672         </parameters>
673       </method>
674       <method name="has_action"
675               c:identifier="g_action_group_has_action"
676               version="2.26">
677         <doc xml:whitespace="preserve">Checks if the named action exists within @action_group.</doc>
678         <return-value transfer-ownership="none">
679           <doc xml:whitespace="preserve">whether the named action exists</doc>
680           <type name="gboolean" c:type="gboolean"/>
681         </return-value>
682         <parameters>
683           <parameter name="action_name" transfer-ownership="none">
684             <doc xml:whitespace="preserve">the name of the action to check for</doc>
685             <type name="utf8" c:type="gchar*"/>
686           </parameter>
687         </parameters>
688       </method>
689       <method name="list_actions"
690               c:identifier="g_action_group_list_actions"
691               version="2.26">
692         <doc xml:whitespace="preserve">Lists the actions contained within @action_group.
693 The caller is responsible for freeing the list with g_strfreev() when
694 it is no longer required.
695 actions in the groupb</doc>
696         <return-value transfer-ownership="full">
697           <doc xml:whitespace="preserve">a %NULL-terminated array of the names of the</doc>
698           <array c:type="gchar**">
699             <type name="utf8"/>
700           </array>
701         </return-value>
702       </method>
703       <method name="set_state"
704               c:identifier="g_action_group_set_state"
705               version="2.26">
706         <doc xml:whitespace="preserve">Request for the state of the named action within @action_group to be
707 changed to @value.
708 The action must be stateful and @value must be of the correct type.
709 See g_action_group_get_state_type().
710 This call merely requests a change.  The action may refuse to change
711 its state or may change its state to something other than @value.
712 See g_action_group_get_state_hint().
713 If the @value GVariant is floating, it is consumed.</doc>
714         <return-value transfer-ownership="none">
715           <type name="none" c:type="void"/>
716         </return-value>
717         <parameters>
718           <parameter name="action_name" transfer-ownership="none">
719             <doc xml:whitespace="preserve">the name of the action to request the change on</doc>
720             <type name="utf8" c:type="gchar*"/>
721           </parameter>
722           <parameter name="value" transfer-ownership="none">
723             <doc xml:whitespace="preserve">the new state</doc>
724             <type name="GLib.Variant" c:type="GVariant*"/>
725           </parameter>
726         </parameters>
727       </method>
728       <glib:signal name="action-added" version="2.26">
729         <doc xml:whitespace="preserve">Signals that a new action was just added to the group.  This signal
730 is emitted after the action has been added and is now visible.</doc>
731         <return-value transfer-ownership="none">
732           <type name="none"/>
733         </return-value>
734         <parameters>
735           <parameter name="object" transfer-ownership="none">
736             <doc xml:whitespace="preserve">the name of the action in @action_group</doc>
737             <type name="utf8"/>
738           </parameter>
739         </parameters>
740       </glib:signal>
741       <glib:signal name="action-enabled-changed" version="2.26">
742         <doc xml:whitespace="preserve">Signals that the enabled status of the named action has changed.</doc>
743         <return-value transfer-ownership="none">
744           <type name="none"/>
745         </return-value>
746         <parameters>
747           <parameter name="object" transfer-ownership="none">
748             <doc xml:whitespace="preserve">the name of the action in @action_group</doc>
749             <type name="utf8"/>
750           </parameter>
751           <parameter name="p0" transfer-ownership="none">
752             <doc xml:whitespace="preserve">whether the action is enabled or not</doc>
753             <type name="gboolean"/>
754           </parameter>
755         </parameters>
756       </glib:signal>
757       <glib:signal name="action-removed" version="2.26">
758         <doc xml:whitespace="preserve">Signals that an action is just about to be removed from the group.
759 This signal is emitted before the action is removed, so the action
760 is still visible and can be queried from the signal handler.</doc>
761         <return-value transfer-ownership="none">
762           <type name="none"/>
763         </return-value>
764         <parameters>
765           <parameter name="object" transfer-ownership="none">
766             <doc xml:whitespace="preserve">the name of the action in @action_group</doc>
767             <type name="utf8"/>
768           </parameter>
769         </parameters>
770       </glib:signal>
771       <glib:signal name="action-state-changed" version="2.26">
772         <doc xml:whitespace="preserve">Signals that the state of the named action has changed.</doc>
773         <return-value transfer-ownership="none">
774           <type name="none"/>
775         </return-value>
776         <parameters>
777           <parameter name="object" transfer-ownership="none">
778             <doc xml:whitespace="preserve">the name of the action in @action_group</doc>
779             <type name="utf8"/>
780           </parameter>
781           <parameter name="p0" transfer-ownership="none">
782             <doc xml:whitespace="preserve">the new value of the state</doc>
783             <type name="GLib.Variant"/>
784           </parameter>
785         </parameters>
786       </glib:signal>
787     </interface>
788     <record name="ActionGroupInterface"
789             c:type="GActionGroupInterface"
790             glib:is-gtype-struct-for="ActionGroup"
791             version="2.26">
792       <doc xml:whitespace="preserve">The virtual function table for #GActionGroup.</doc>
793       <field name="g_iface">
794         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
795       </field>
796       <field name="has_action">
797         <callback name="has_action">
798           <return-value transfer-ownership="none">
799             <doc xml:whitespace="preserve">whether the named action exists</doc>
800             <type name="gboolean" c:type="gboolean"/>
801           </return-value>
802           <parameters>
803             <parameter name="action_group" transfer-ownership="none">
804               <type name="ActionGroup" c:type="GActionGroup*"/>
805             </parameter>
806             <parameter name="action_name" transfer-ownership="none">
807               <doc xml:whitespace="preserve">the name of the action to check for</doc>
808               <type name="utf8" c:type="gchar*"/>
809             </parameter>
810           </parameters>
811         </callback>
812       </field>
813       <field name="list_actions">
814         <callback name="list_actions">
815           <return-value transfer-ownership="full">
816             <doc xml:whitespace="preserve">a %NULL-terminated array of the names of the</doc>
817             <array c:type="gchar**">
818               <type name="utf8"/>
819             </array>
820           </return-value>
821           <parameters>
822             <parameter name="action_group" transfer-ownership="none">
823               <type name="ActionGroup" c:type="GActionGroup*"/>
824             </parameter>
825           </parameters>
826         </callback>
827       </field>
828       <field name="get_enabled">
829         <callback name="get_enabled">
830           <return-value transfer-ownership="none">
831             <doc xml:whitespace="preserve">whether or not the action is currently enabled</doc>
832             <type name="gboolean" c:type="gboolean"/>
833           </return-value>
834           <parameters>
835             <parameter name="action_group" transfer-ownership="none">
836               <type name="ActionGroup" c:type="GActionGroup*"/>
837             </parameter>
838             <parameter name="action_name" transfer-ownership="none">
839               <doc xml:whitespace="preserve">the name of the action to query</doc>
840               <type name="utf8" c:type="gchar*"/>
841             </parameter>
842           </parameters>
843         </callback>
844       </field>
845       <field name="get_parameter_type">
846         <callback name="get_parameter_type">
847           <return-value transfer-ownership="none">
848             <doc xml:whitespace="preserve">the parameter type</doc>
849             <type name="GLib.VariantType" c:type="GVariantType*"/>
850           </return-value>
851           <parameters>
852             <parameter name="action_group" transfer-ownership="none">
853               <type name="ActionGroup" c:type="GActionGroup*"/>
854             </parameter>
855             <parameter name="action_name" transfer-ownership="none">
856               <doc xml:whitespace="preserve">the name of the action to query</doc>
857               <type name="utf8" c:type="gchar*"/>
858             </parameter>
859           </parameters>
860         </callback>
861       </field>
862       <field name="get_state_type" introspectable="0">
863         <callback name="get_state_type" introspectable="0">
864           <return-value transfer-ownership="full">
865             <doc xml:whitespace="preserve">the state type, if the action is stateful</doc>
866             <type name="GLib.VariantType" c:type="GVariantType*"/>
867           </return-value>
868           <parameters>
869             <parameter name="action_group" transfer-ownership="none">
870               <type name="ActionGroup" c:type="GActionGroup*"/>
871             </parameter>
872             <parameter name="action_name" transfer-ownership="none">
873               <doc xml:whitespace="preserve">the name of the action to query</doc>
874               <type name="utf8" c:type="gchar*"/>
875             </parameter>
876           </parameters>
877         </callback>
878       </field>
879       <field name="get_state_hint">
880         <callback name="get_state_hint">
881           <return-value transfer-ownership="full">
882             <doc xml:whitespace="preserve">the state range hint</doc>
883             <type name="GLib.Variant" c:type="GVariant*"/>
884           </return-value>
885           <parameters>
886             <parameter name="action_group" transfer-ownership="none">
887               <type name="ActionGroup" c:type="GActionGroup*"/>
888             </parameter>
889             <parameter name="action_name" transfer-ownership="none">
890               <doc xml:whitespace="preserve">the name of the action to query</doc>
891               <type name="utf8" c:type="gchar*"/>
892             </parameter>
893           </parameters>
894         </callback>
895       </field>
896       <field name="get_state">
897         <callback name="get_state">
898           <return-value transfer-ownership="full">
899             <doc xml:whitespace="preserve">the current state of the action</doc>
900             <type name="GLib.Variant" c:type="GVariant*"/>
901           </return-value>
902           <parameters>
903             <parameter name="action_group" transfer-ownership="none">
904               <type name="ActionGroup" c:type="GActionGroup*"/>
905             </parameter>
906             <parameter name="action_name" transfer-ownership="none">
907               <doc xml:whitespace="preserve">the name of the action to query</doc>
908               <type name="utf8" c:type="gchar*"/>
909             </parameter>
910           </parameters>
911         </callback>
912       </field>
913       <field name="set_state">
914         <callback name="set_state">
915           <return-value transfer-ownership="none">
916             <type name="none" c:type="void"/>
917           </return-value>
918           <parameters>
919             <parameter name="action_group" transfer-ownership="none">
920               <type name="ActionGroup" c:type="GActionGroup*"/>
921             </parameter>
922             <parameter name="action_name" transfer-ownership="none">
923               <doc xml:whitespace="preserve">the name of the action to request the change on</doc>
924               <type name="utf8" c:type="gchar*"/>
925             </parameter>
926             <parameter name="value" transfer-ownership="none">
927               <doc xml:whitespace="preserve">the new state</doc>
928               <type name="GLib.Variant" c:type="GVariant*"/>
929             </parameter>
930           </parameters>
931         </callback>
932       </field>
933       <field name="activate">
934         <callback name="activate">
935           <return-value transfer-ownership="none">
936             <type name="none" c:type="void"/>
937           </return-value>
938           <parameters>
939             <parameter name="action_group" transfer-ownership="none">
940               <type name="ActionGroup" c:type="GActionGroup*"/>
941             </parameter>
942             <parameter name="action_name" transfer-ownership="none">
943               <doc xml:whitespace="preserve">the name of the action to activate</doc>
944               <type name="utf8" c:type="gchar*"/>
945             </parameter>
946             <parameter name="parameter"
947                        transfer-ownership="none"
948                        allow-none="1">
949               <doc xml:whitespace="preserve">parameters to the activation</doc>
950               <type name="GLib.Variant" c:type="GVariant*"/>
951             </parameter>
952           </parameters>
953         </callback>
954       </field>
955       <field name="action_added">
956         <callback name="action_added">
957           <return-value transfer-ownership="none">
958             <type name="none" c:type="void"/>
959           </return-value>
960           <parameters>
961             <parameter name="action_group" transfer-ownership="none">
962               <type name="ActionGroup" c:type="GActionGroup*"/>
963             </parameter>
964             <parameter name="action_name" transfer-ownership="none">
965               <type name="utf8" c:type="gchar*"/>
966             </parameter>
967           </parameters>
968         </callback>
969       </field>
970       <field name="action_removed">
971         <callback name="action_removed">
972           <return-value transfer-ownership="none">
973             <type name="none" c:type="void"/>
974           </return-value>
975           <parameters>
976             <parameter name="action_group" transfer-ownership="none">
977               <type name="ActionGroup" c:type="GActionGroup*"/>
978             </parameter>
979             <parameter name="action_name" transfer-ownership="none">
980               <type name="utf8" c:type="gchar*"/>
981             </parameter>
982           </parameters>
983         </callback>
984       </field>
985       <field name="action_enabled_changed">
986         <callback name="action_enabled_changed">
987           <return-value transfer-ownership="none">
988             <type name="none" c:type="void"/>
989           </return-value>
990           <parameters>
991             <parameter name="action_group" transfer-ownership="none">
992               <type name="ActionGroup" c:type="GActionGroup*"/>
993             </parameter>
994             <parameter name="action_name" transfer-ownership="none">
995               <type name="utf8" c:type="gchar*"/>
996             </parameter>
997             <parameter name="enabled" transfer-ownership="none">
998               <type name="gboolean" c:type="gboolean"/>
999             </parameter>
1000           </parameters>
1001         </callback>
1002       </field>
1003       <field name="action_state_changed">
1004         <callback name="action_state_changed">
1005           <return-value transfer-ownership="none">
1006             <type name="none" c:type="void"/>
1007           </return-value>
1008           <parameters>
1009             <parameter name="action_group" transfer-ownership="none">
1010               <type name="ActionGroup" c:type="GActionGroup*"/>
1011             </parameter>
1012             <parameter name="action_name" transfer-ownership="none">
1013               <type name="utf8" c:type="gchar*"/>
1014             </parameter>
1015             <parameter name="value" transfer-ownership="none">
1016               <type name="GLib.Variant" c:type="GVariant*"/>
1017             </parameter>
1018           </parameters>
1019         </callback>
1020       </field>
1021     </record>
1022     <record name="ActionInterface"
1023             c:type="GActionInterface"
1024             glib:is-gtype-struct-for="Action"
1025             version="2.26">
1026       <field name="g_iface">
1027         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
1028       </field>
1029       <field name="get_name">
1030         <callback name="get_name">
1031           <return-value transfer-ownership="none">
1032             <doc xml:whitespace="preserve">the name of the action</doc>
1033             <type name="utf8" c:type="gchar*"/>
1034           </return-value>
1035           <parameters>
1036             <parameter name="action" transfer-ownership="none">
1037               <type name="Action" c:type="GAction*"/>
1038             </parameter>
1039           </parameters>
1040         </callback>
1041       </field>
1042       <field name="get_parameter_type">
1043         <callback name="get_parameter_type">
1044           <return-value transfer-ownership="none">
1045             <doc xml:whitespace="preserve">the parameter type</doc>
1046             <type name="GLib.VariantType" c:type="GVariantType*"/>
1047           </return-value>
1048           <parameters>
1049             <parameter name="action" transfer-ownership="none">
1050               <type name="Action" c:type="GAction*"/>
1051             </parameter>
1052           </parameters>
1053         </callback>
1054       </field>
1055       <field name="get_state_type">
1056         <callback name="get_state_type">
1057           <return-value transfer-ownership="none">
1058             <doc xml:whitespace="preserve">the state type, if the action is stateful</doc>
1059             <type name="GLib.VariantType" c:type="GVariantType*"/>
1060           </return-value>
1061           <parameters>
1062             <parameter name="action" transfer-ownership="none">
1063               <type name="Action" c:type="GAction*"/>
1064             </parameter>
1065           </parameters>
1066         </callback>
1067       </field>
1068       <field name="get_state_hint">
1069         <callback name="get_state_hint">
1070           <return-value transfer-ownership="full">
1071             <doc xml:whitespace="preserve">the state range hint</doc>
1072             <type name="GLib.Variant" c:type="GVariant*"/>
1073           </return-value>
1074           <parameters>
1075             <parameter name="action" transfer-ownership="none">
1076               <type name="Action" c:type="GAction*"/>
1077             </parameter>
1078           </parameters>
1079         </callback>
1080       </field>
1081       <field name="get_enabled">
1082         <callback name="get_enabled">
1083           <return-value transfer-ownership="none">
1084             <doc xml:whitespace="preserve">whether the action is enabled</doc>
1085             <type name="gboolean" c:type="gboolean"/>
1086           </return-value>
1087           <parameters>
1088             <parameter name="action" transfer-ownership="none">
1089               <type name="Action" c:type="GAction*"/>
1090             </parameter>
1091           </parameters>
1092         </callback>
1093       </field>
1094       <field name="get_state">
1095         <callback name="get_state">
1096           <return-value transfer-ownership="full">
1097             <doc xml:whitespace="preserve">the current state of the action</doc>
1098             <type name="GLib.Variant" c:type="GVariant*"/>
1099           </return-value>
1100           <parameters>
1101             <parameter name="action" transfer-ownership="none">
1102               <type name="Action" c:type="GAction*"/>
1103             </parameter>
1104           </parameters>
1105         </callback>
1106       </field>
1107       <field name="set_state">
1108         <callback name="set_state">
1109           <return-value transfer-ownership="none">
1110             <type name="none" c:type="void"/>
1111           </return-value>
1112           <parameters>
1113             <parameter name="action" transfer-ownership="none">
1114               <type name="Action" c:type="GAction*"/>
1115             </parameter>
1116             <parameter name="state" transfer-ownership="none">
1117               <type name="GLib.Variant" c:type="GVariant*"/>
1118             </parameter>
1119           </parameters>
1120         </callback>
1121       </field>
1122       <field name="activate">
1123         <callback name="activate">
1124           <return-value transfer-ownership="none">
1125             <type name="none" c:type="void"/>
1126           </return-value>
1127           <parameters>
1128             <parameter name="action" transfer-ownership="none">
1129               <type name="Action" c:type="GAction*"/>
1130             </parameter>
1131             <parameter name="parameter"
1132                        transfer-ownership="none"
1133                        allow-none="1">
1134               <doc xml:whitespace="preserve">the parameter to the activation</doc>
1135               <type name="GLib.Variant" c:type="GVariant*"/>
1136             </parameter>
1137           </parameters>
1138         </callback>
1139       </field>
1140     </record>
1141     <interface name="AppInfo"
1142                c:symbol-prefix="app_info"
1143                c:type="GAppInfo"
1144                glib:type-name="GAppInfo"
1145                glib:get-type="g_app_info_get_type"
1146                glib:type-struct="AppInfoIface">
1147       <doc xml:whitespace="preserve">Information about an installed application and methods to launch
1148 it (with file arguments).</doc>
1149       <virtual-method name="add_supports_type"
1150                       invoker="add_supports_type"
1151                       throws="1">
1152         <doc xml:whitespace="preserve">Adds a content type to the application information to indicate the
1153 application is capable of opening files with the given content type.</doc>
1154         <return-value transfer-ownership="none">
1155           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
1156           <type name="gboolean" c:type="gboolean"/>
1157         </return-value>
1158         <parameters>
1159           <parameter name="content_type" transfer-ownership="none">
1160             <doc xml:whitespace="preserve">a string.</doc>
1161             <type name="utf8" c:type="char*"/>
1162           </parameter>
1163         </parameters>
1164       </virtual-method>
1165       <virtual-method name="can_delete" invoker="can_delete" version="2.20">
1166         <doc xml:whitespace="preserve">Obtains the information whether the #GAppInfo can be deleted.
1167 See g_app_info_delete().</doc>
1168         <return-value transfer-ownership="none">
1169           <doc xml:whitespace="preserve">%TRUE if @appinfo can be deleted</doc>
1170           <type name="gboolean" c:type="gboolean"/>
1171         </return-value>
1172       </virtual-method>
1173       <virtual-method name="can_remove_supports_type"
1174                       invoker="can_remove_supports_type">
1175         <doc xml:whitespace="preserve">Checks if a supported content type can be removed from an application.
1176 content types from a given @appinfo, %FALSE if not.</doc>
1177         <return-value transfer-ownership="none">
1178           <doc xml:whitespace="preserve">%TRUE if it is possible to remove supported</doc>
1179           <type name="gboolean" c:type="gboolean"/>
1180         </return-value>
1181       </virtual-method>
1182       <virtual-method name="do_delete" invoker="delete" version="2.20">
1183         <doc xml:whitespace="preserve">Tries to delete a #GAppInfo.
1184 On some platforms, there may be a difference between user-defined
1185 #GAppInfo&lt;!-- --&gt;s which can be deleted, and system-wide ones which
1186 cannot. See g_app_info_can_delete().</doc>
1187         <return-value transfer-ownership="none">
1188           <doc xml:whitespace="preserve">%TRUE if @appinfo has been deleted</doc>
1189           <type name="gboolean" c:type="gboolean"/>
1190         </return-value>
1191       </virtual-method>
1192       <virtual-method name="dup" invoker="dup">
1193         <doc xml:whitespace="preserve">Creates a duplicate of a #GAppInfo.</doc>
1194         <return-value transfer-ownership="full">
1195           <doc xml:whitespace="preserve">a duplicate of @appinfo.</doc>
1196           <type name="AppInfo" c:type="GAppInfo*"/>
1197         </return-value>
1198       </virtual-method>
1199       <virtual-method name="equal" invoker="equal">
1200         <doc xml:whitespace="preserve">Checks if two #GAppInfo&lt;!-- --&gt;s are equal.</doc>
1201         <return-value transfer-ownership="none">
1202           <doc xml:whitespace="preserve">%TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise.</doc>
1203           <type name="gboolean" c:type="gboolean"/>
1204         </return-value>
1205         <parameters>
1206           <parameter name="appinfo2" transfer-ownership="none">
1207             <doc xml:whitespace="preserve">the second #GAppInfo.</doc>
1208             <type name="AppInfo" c:type="GAppInfo*"/>
1209           </parameter>
1210         </parameters>
1211       </virtual-method>
1212       <virtual-method name="get_commandline"
1213                       invoker="get_commandline"
1214                       version="2.20">
1215         <doc xml:whitespace="preserve">Gets the commandline with which the application will be
1216 started.
1217 or %NULL if this information is not available</doc>
1218         <return-value transfer-ownership="none">
1219           <doc xml:whitespace="preserve">a string containing the @appinfo's commandline,</doc>
1220           <type name="utf8" c:type="char*"/>
1221         </return-value>
1222       </virtual-method>
1223       <virtual-method name="get_description" invoker="get_description">
1224         <doc xml:whitespace="preserve">Gets a human-readable description of an installed application.
1225 application @appinfo, or %NULL if none.</doc>
1226         <return-value transfer-ownership="none">
1227           <doc xml:whitespace="preserve">a string containing a description of the</doc>
1228           <type name="utf8" c:type="char*"/>
1229         </return-value>
1230       </virtual-method>
1231       <virtual-method name="get_display_name"
1232                       invoker="get_display_name"
1233                       version="2.24">
1234         <doc xml:whitespace="preserve">Gets the display name of the application. The display name is often more
1235 descriptive to the user than the name itself.
1236 no display name is available.</doc>
1237         <return-value transfer-ownership="none">
1238           <doc xml:whitespace="preserve">the display name of the application for @appinfo, or the name if</doc>
1239           <type name="utf8" c:type="char*"/>
1240         </return-value>
1241       </virtual-method>
1242       <virtual-method name="get_executable" invoker="get_executable">
1243         <doc xml:whitespace="preserve">Gets the executable's name for the installed application.
1244 binaries name</doc>
1245         <return-value transfer-ownership="none">
1246           <doc xml:whitespace="preserve">a string containing the @appinfo's application</doc>
1247           <type name="utf8" c:type="char*"/>
1248         </return-value>
1249       </virtual-method>
1250       <virtual-method name="get_icon" invoker="get_icon">
1251         <doc xml:whitespace="preserve">Gets the icon for the application.</doc>
1252         <return-value transfer-ownership="none">
1253           <doc xml:whitespace="preserve">the default #GIcon for @appinfo.</doc>
1254           <type name="Icon" c:type="GIcon*"/>
1255         </return-value>
1256       </virtual-method>
1257       <virtual-method name="get_id" invoker="get_id">
1258         <doc xml:whitespace="preserve">Gets the ID of an application. An id is a string that
1259 identifies the application. The exact format of the id is
1260 platform dependent. For instance, on Unix this is the
1261 desktop file id from the xdg menu specification.
1262 Note that the returned ID may be %NULL, depending on how
1263 the @appinfo has been constructed.</doc>
1264         <return-value transfer-ownership="none">
1265           <doc xml:whitespace="preserve">a string containing the application's ID.</doc>
1266           <type name="utf8" c:type="char*"/>
1267         </return-value>
1268       </virtual-method>
1269       <virtual-method name="get_name" invoker="get_name">
1270         <doc xml:whitespace="preserve">Gets the installed name of the application.</doc>
1271         <return-value transfer-ownership="none">
1272           <doc xml:whitespace="preserve">the name of the application for @appinfo.</doc>
1273           <type name="utf8" c:type="char*"/>
1274         </return-value>
1275       </virtual-method>
1276       <virtual-method name="launch" invoker="launch" throws="1">
1277         <doc xml:whitespace="preserve">Launches the application. Passes @files to the launched application
1278 as arguments, using the optional @launch_context to get information
1279 about the details of the launcher (like what screen it is on).
1280 On error, @error will be set accordingly.
1281 To launch the application without arguments pass a %NULL @files list.
1282 Note that even if the launch is successful the application launched
1283 can fail to start if it runs into problems during startup. There is
1284 no way to detect this.
1285 Some URIs can be changed when passed through a GFile (for instance
1286 unsupported uris with strange formats like mailto:), so if you have
1287 a textual uri you want to pass in as argument, consider using
1288 g_app_info_launch_uris() instead.
1289 On UNIX, this function sets the &lt;envvar&gt;GIO_LAUNCHED_DESKTOP_FILE&lt;/envvar&gt;
1290 environment variable with the path of the launched desktop file and
1291 &lt;envvar&gt;GIO_LAUNCHED_DESKTOP_FILE_PID&lt;/envvar&gt; to the process
1292 id of the launched process. This can be used to ignore
1293 &lt;envvar&gt;GIO_LAUNCHED_DESKTOP_FILE&lt;/envvar&gt;, should it be inherited
1294 by further processes. The &lt;envvar&gt;DISPLAY&lt;/envvar&gt; and
1295 &lt;envvar&gt;DESKTOP_STARTUP_ID&lt;/envvar&gt; environment variables are also
1296 set, based on information provided in @launch_context.</doc>
1297         <return-value transfer-ownership="none">
1298           <doc xml:whitespace="preserve">%TRUE on successful launch, %FALSE otherwise.</doc>
1299           <type name="gboolean" c:type="gboolean"/>
1300         </return-value>
1301         <parameters>
1302           <parameter name="filenames" transfer-ownership="none">
1303             <type name="GLib.List" c:type="GList*">
1304               <type name="gpointer" c:type="gpointer"/>
1305             </type>
1306           </parameter>
1307           <parameter name="launch_context"
1308                      transfer-ownership="none"
1309                      allow-none="1">
1310             <doc xml:whitespace="preserve">a #GAppLaunchContext or %NULL</doc>
1311             <type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
1312           </parameter>
1313         </parameters>
1314       </virtual-method>
1315       <virtual-method name="launch_uris" invoker="launch_uris" throws="1">
1316         <doc xml:whitespace="preserve">Launches the application. Passes @uris to the launched application
1317 as arguments, using the optional @launch_context to get information
1318 about the details of the launcher (like what screen it is on).
1319 On error, @error will be set accordingly.
1320 To lauch the application without arguments pass a %NULL @uris list.
1321 Note that even if the launch is successful the application launched
1322 can fail to start if it runs into problems during startup. There is
1323 no way to detect this.</doc>
1324         <return-value transfer-ownership="none">
1325           <doc xml:whitespace="preserve">%TRUE on successful launch, %FALSE otherwise.</doc>
1326           <type name="gboolean" c:type="gboolean"/>
1327         </return-value>
1328         <parameters>
1329           <parameter name="uris" transfer-ownership="none">
1330             <doc xml:whitespace="preserve">a #GList containing URIs to launch.</doc>
1331             <type name="GLib.List" c:type="GList*">
1332               <type name="utf8"/>
1333             </type>
1334           </parameter>
1335           <parameter name="launch_context"
1336                      transfer-ownership="none"
1337                      allow-none="1">
1338             <doc xml:whitespace="preserve">a #GAppLaunchContext or %NULL</doc>
1339             <type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
1340           </parameter>
1341         </parameters>
1342       </virtual-method>
1343       <virtual-method name="remove_supports_type"
1344                       invoker="remove_supports_type"
1345                       throws="1">
1346         <doc xml:whitespace="preserve">Removes a supported type from an application, if possible.</doc>
1347         <return-value transfer-ownership="none">
1348           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
1349           <type name="gboolean" c:type="gboolean"/>
1350         </return-value>
1351         <parameters>
1352           <parameter name="content_type" transfer-ownership="none">
1353             <doc xml:whitespace="preserve">a string.</doc>
1354             <type name="utf8" c:type="char*"/>
1355           </parameter>
1356         </parameters>
1357       </virtual-method>
1358       <virtual-method name="set_as_default_for_extension"
1359                       invoker="set_as_default_for_extension"
1360                       throws="1">
1361         <doc xml:whitespace="preserve">Sets the application as the default handler for the given file extension.</doc>
1362         <return-value transfer-ownership="none">
1363           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
1364           <type name="gboolean" c:type="gboolean"/>
1365         </return-value>
1366         <parameters>
1367           <parameter name="extension" transfer-ownership="none">
1368             <doc xml:whitespace="preserve">a string containing the file extension (without the dot).</doc>
1369             <type name="utf8" c:type="char*"/>
1370           </parameter>
1371         </parameters>
1372       </virtual-method>
1373       <virtual-method name="set_as_default_for_type"
1374                       invoker="set_as_default_for_type"
1375                       throws="1">
1376         <doc xml:whitespace="preserve">Sets the application as the default handler for a given type.</doc>
1377         <return-value transfer-ownership="none">
1378           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
1379           <type name="gboolean" c:type="gboolean"/>
1380         </return-value>
1381         <parameters>
1382           <parameter name="content_type" transfer-ownership="none">
1383             <doc xml:whitespace="preserve">the content type.</doc>
1384             <type name="utf8" c:type="char*"/>
1385           </parameter>
1386         </parameters>
1387       </virtual-method>
1388       <virtual-method name="should_show" invoker="should_show">
1389         <doc xml:whitespace="preserve">Checks if the application info should be shown in menus that
1390 list available applications.</doc>
1391         <return-value transfer-ownership="none">
1392           <doc xml:whitespace="preserve">%TRUE if the @appinfo should be shown, %FALSE otherwise.</doc>
1393           <type name="gboolean" c:type="gboolean"/>
1394         </return-value>
1395       </virtual-method>
1396       <virtual-method name="supports_files" invoker="supports_files">
1397         <doc xml:whitespace="preserve">Checks if the application accepts files as arguments.</doc>
1398         <return-value transfer-ownership="none">
1399           <doc xml:whitespace="preserve">%TRUE if the @appinfo supports files.</doc>
1400           <type name="gboolean" c:type="gboolean"/>
1401         </return-value>
1402       </virtual-method>
1403       <virtual-method name="supports_uris" invoker="supports_uris">
1404         <doc xml:whitespace="preserve">Checks if the application supports reading files and directories from URIs.</doc>
1405         <return-value transfer-ownership="none">
1406           <doc xml:whitespace="preserve">%TRUE if the @appinfo supports URIs.</doc>
1407           <type name="gboolean" c:type="gboolean"/>
1408         </return-value>
1409       </virtual-method>
1410       <method name="add_supports_type"
1411               c:identifier="g_app_info_add_supports_type"
1412               throws="1">
1413         <doc xml:whitespace="preserve">Adds a content type to the application information to indicate the
1414 application is capable of opening files with the given content type.</doc>
1415         <return-value transfer-ownership="none">
1416           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
1417           <type name="gboolean" c:type="gboolean"/>
1418         </return-value>
1419         <parameters>
1420           <parameter name="content_type" transfer-ownership="none">
1421             <doc xml:whitespace="preserve">a string.</doc>
1422             <type name="utf8" c:type="char*"/>
1423           </parameter>
1424         </parameters>
1425       </method>
1426       <method name="can_delete"
1427               c:identifier="g_app_info_can_delete"
1428               version="2.20">
1429         <doc xml:whitespace="preserve">Obtains the information whether the #GAppInfo can be deleted.
1430 See g_app_info_delete().</doc>
1431         <return-value transfer-ownership="none">
1432           <doc xml:whitespace="preserve">%TRUE if @appinfo can be deleted</doc>
1433           <type name="gboolean" c:type="gboolean"/>
1434         </return-value>
1435       </method>
1436       <method name="can_remove_supports_type"
1437               c:identifier="g_app_info_can_remove_supports_type">
1438         <doc xml:whitespace="preserve">Checks if a supported content type can be removed from an application.
1439 content types from a given @appinfo, %FALSE if not.</doc>
1440         <return-value transfer-ownership="none">
1441           <doc xml:whitespace="preserve">%TRUE if it is possible to remove supported</doc>
1442           <type name="gboolean" c:type="gboolean"/>
1443         </return-value>
1444       </method>
1445       <method name="delete" c:identifier="g_app_info_delete" version="2.20">
1446         <doc xml:whitespace="preserve">Tries to delete a #GAppInfo.
1447 On some platforms, there may be a difference between user-defined
1448 #GAppInfo&lt;!-- --&gt;s which can be deleted, and system-wide ones which
1449 cannot. See g_app_info_can_delete().</doc>
1450         <return-value transfer-ownership="none">
1451           <doc xml:whitespace="preserve">%TRUE if @appinfo has been deleted</doc>
1452           <type name="gboolean" c:type="gboolean"/>
1453         </return-value>
1454       </method>
1455       <method name="dup" c:identifier="g_app_info_dup">
1456         <doc xml:whitespace="preserve">Creates a duplicate of a #GAppInfo.</doc>
1457         <return-value transfer-ownership="full">
1458           <doc xml:whitespace="preserve">a duplicate of @appinfo.</doc>
1459           <type name="AppInfo" c:type="GAppInfo*"/>
1460         </return-value>
1461       </method>
1462       <method name="equal" c:identifier="g_app_info_equal">
1463         <doc xml:whitespace="preserve">Checks if two #GAppInfo&lt;!-- --&gt;s are equal.</doc>
1464         <return-value transfer-ownership="none">
1465           <doc xml:whitespace="preserve">%TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise.</doc>
1466           <type name="gboolean" c:type="gboolean"/>
1467         </return-value>
1468         <parameters>
1469           <parameter name="appinfo2" transfer-ownership="none">
1470             <doc xml:whitespace="preserve">the second #GAppInfo.</doc>
1471             <type name="AppInfo" c:type="GAppInfo*"/>
1472           </parameter>
1473         </parameters>
1474       </method>
1475       <method name="get_commandline"
1476               c:identifier="g_app_info_get_commandline"
1477               version="2.20">
1478         <doc xml:whitespace="preserve">Gets the commandline with which the application will be
1479 started.
1480 or %NULL if this information is not available</doc>
1481         <return-value transfer-ownership="none">
1482           <doc xml:whitespace="preserve">a string containing the @appinfo's commandline,</doc>
1483           <type name="utf8" c:type="char*"/>
1484         </return-value>
1485       </method>
1486       <method name="get_description" c:identifier="g_app_info_get_description">
1487         <doc xml:whitespace="preserve">Gets a human-readable description of an installed application.
1488 application @appinfo, or %NULL if none.</doc>
1489         <return-value transfer-ownership="none">
1490           <doc xml:whitespace="preserve">a string containing a description of the</doc>
1491           <type name="utf8" c:type="char*"/>
1492         </return-value>
1493       </method>
1494       <method name="get_display_name"
1495               c:identifier="g_app_info_get_display_name"
1496               version="2.24">
1497         <doc xml:whitespace="preserve">Gets the display name of the application. The display name is often more
1498 descriptive to the user than the name itself.
1499 no display name is available.</doc>
1500         <return-value transfer-ownership="none">
1501           <doc xml:whitespace="preserve">the display name of the application for @appinfo, or the name if</doc>
1502           <type name="utf8" c:type="char*"/>
1503         </return-value>
1504       </method>
1505       <method name="get_executable" c:identifier="g_app_info_get_executable">
1506         <doc xml:whitespace="preserve">Gets the executable's name for the installed application.
1507 binaries name</doc>
1508         <return-value transfer-ownership="none">
1509           <doc xml:whitespace="preserve">a string containing the @appinfo's application</doc>
1510           <type name="utf8" c:type="char*"/>
1511         </return-value>
1512       </method>
1513       <method name="get_icon" c:identifier="g_app_info_get_icon">
1514         <doc xml:whitespace="preserve">Gets the icon for the application.</doc>
1515         <return-value transfer-ownership="none">
1516           <doc xml:whitespace="preserve">the default #GIcon for @appinfo.</doc>
1517           <type name="Icon" c:type="GIcon*"/>
1518         </return-value>
1519       </method>
1520       <method name="get_id" c:identifier="g_app_info_get_id">
1521         <doc xml:whitespace="preserve">Gets the ID of an application. An id is a string that
1522 identifies the application. The exact format of the id is
1523 platform dependent. For instance, on Unix this is the
1524 desktop file id from the xdg menu specification.
1525 Note that the returned ID may be %NULL, depending on how
1526 the @appinfo has been constructed.</doc>
1527         <return-value transfer-ownership="none">
1528           <doc xml:whitespace="preserve">a string containing the application's ID.</doc>
1529           <type name="utf8" c:type="char*"/>
1530         </return-value>
1531       </method>
1532       <method name="get_name" c:identifier="g_app_info_get_name">
1533         <doc xml:whitespace="preserve">Gets the installed name of the application.</doc>
1534         <return-value transfer-ownership="none">
1535           <doc xml:whitespace="preserve">the name of the application for @appinfo.</doc>
1536           <type name="utf8" c:type="char*"/>
1537         </return-value>
1538       </method>
1539       <method name="launch" c:identifier="g_app_info_launch" throws="1">
1540         <doc xml:whitespace="preserve">Launches the application. Passes @files to the launched application
1541 as arguments, using the optional @launch_context to get information
1542 about the details of the launcher (like what screen it is on).
1543 On error, @error will be set accordingly.
1544 To launch the application without arguments pass a %NULL @files list.
1545 Note that even if the launch is successful the application launched
1546 can fail to start if it runs into problems during startup. There is
1547 no way to detect this.
1548 Some URIs can be changed when passed through a GFile (for instance
1549 unsupported uris with strange formats like mailto:), so if you have
1550 a textual uri you want to pass in as argument, consider using
1551 g_app_info_launch_uris() instead.
1552 On UNIX, this function sets the &lt;envvar&gt;GIO_LAUNCHED_DESKTOP_FILE&lt;/envvar&gt;
1553 environment variable with the path of the launched desktop file and
1554 &lt;envvar&gt;GIO_LAUNCHED_DESKTOP_FILE_PID&lt;/envvar&gt; to the process
1555 id of the launched process. This can be used to ignore
1556 &lt;envvar&gt;GIO_LAUNCHED_DESKTOP_FILE&lt;/envvar&gt;, should it be inherited
1557 by further processes. The &lt;envvar&gt;DISPLAY&lt;/envvar&gt; and
1558 &lt;envvar&gt;DESKTOP_STARTUP_ID&lt;/envvar&gt; environment variables are also
1559 set, based on information provided in @launch_context.</doc>
1560         <return-value transfer-ownership="none">
1561           <doc xml:whitespace="preserve">%TRUE on successful launch, %FALSE otherwise.</doc>
1562           <type name="gboolean" c:type="gboolean"/>
1563         </return-value>
1564         <parameters>
1565           <parameter name="files" transfer-ownership="none">
1566             <doc xml:whitespace="preserve">a #GList of #GFile objects</doc>
1567             <type name="GLib.List" c:type="GList*">
1568               <type name="File"/>
1569             </type>
1570           </parameter>
1571           <parameter name="launch_context"
1572                      transfer-ownership="none"
1573                      allow-none="1">
1574             <doc xml:whitespace="preserve">a #GAppLaunchContext or %NULL</doc>
1575             <type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
1576           </parameter>
1577         </parameters>
1578       </method>
1579       <method name="launch_uris"
1580               c:identifier="g_app_info_launch_uris"
1581               throws="1">
1582         <doc xml:whitespace="preserve">Launches the application. Passes @uris to the launched application
1583 as arguments, using the optional @launch_context to get information
1584 about the details of the launcher (like what screen it is on).
1585 On error, @error will be set accordingly.
1586 To lauch the application without arguments pass a %NULL @uris list.
1587 Note that even if the launch is successful the application launched
1588 can fail to start if it runs into problems during startup. There is
1589 no way to detect this.</doc>
1590         <return-value transfer-ownership="none">
1591           <doc xml:whitespace="preserve">%TRUE on successful launch, %FALSE otherwise.</doc>
1592           <type name="gboolean" c:type="gboolean"/>
1593         </return-value>
1594         <parameters>
1595           <parameter name="uris" transfer-ownership="none">
1596             <doc xml:whitespace="preserve">a #GList containing URIs to launch.</doc>
1597             <type name="GLib.List" c:type="GList*">
1598               <type name="utf8"/>
1599             </type>
1600           </parameter>
1601           <parameter name="launch_context"
1602                      transfer-ownership="none"
1603                      allow-none="1">
1604             <doc xml:whitespace="preserve">a #GAppLaunchContext or %NULL</doc>
1605             <type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
1606           </parameter>
1607         </parameters>
1608       </method>
1609       <method name="remove_supports_type"
1610               c:identifier="g_app_info_remove_supports_type"
1611               throws="1">
1612         <doc xml:whitespace="preserve">Removes a supported type from an application, if possible.</doc>
1613         <return-value transfer-ownership="none">
1614           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
1615           <type name="gboolean" c:type="gboolean"/>
1616         </return-value>
1617         <parameters>
1618           <parameter name="content_type" transfer-ownership="none">
1619             <doc xml:whitespace="preserve">a string.</doc>
1620             <type name="utf8" c:type="char*"/>
1621           </parameter>
1622         </parameters>
1623       </method>
1624       <method name="set_as_default_for_extension"
1625               c:identifier="g_app_info_set_as_default_for_extension"
1626               throws="1">
1627         <doc xml:whitespace="preserve">Sets the application as the default handler for the given file extension.</doc>
1628         <return-value transfer-ownership="none">
1629           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
1630           <type name="gboolean" c:type="gboolean"/>
1631         </return-value>
1632         <parameters>
1633           <parameter name="extension" transfer-ownership="none">
1634             <doc xml:whitespace="preserve">a string containing the file extension (without the dot).</doc>
1635             <type name="utf8" c:type="char*"/>
1636           </parameter>
1637         </parameters>
1638       </method>
1639       <method name="set_as_default_for_type"
1640               c:identifier="g_app_info_set_as_default_for_type"
1641               throws="1">
1642         <doc xml:whitespace="preserve">Sets the application as the default handler for a given type.</doc>
1643         <return-value transfer-ownership="none">
1644           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
1645           <type name="gboolean" c:type="gboolean"/>
1646         </return-value>
1647         <parameters>
1648           <parameter name="content_type" transfer-ownership="none">
1649             <doc xml:whitespace="preserve">the content type.</doc>
1650             <type name="utf8" c:type="char*"/>
1651           </parameter>
1652         </parameters>
1653       </method>
1654       <method name="should_show" c:identifier="g_app_info_should_show">
1655         <doc xml:whitespace="preserve">Checks if the application info should be shown in menus that
1656 list available applications.</doc>
1657         <return-value transfer-ownership="none">
1658           <doc xml:whitespace="preserve">%TRUE if the @appinfo should be shown, %FALSE otherwise.</doc>
1659           <type name="gboolean" c:type="gboolean"/>
1660         </return-value>
1661       </method>
1662       <method name="supports_files" c:identifier="g_app_info_supports_files">
1663         <doc xml:whitespace="preserve">Checks if the application accepts files as arguments.</doc>
1664         <return-value transfer-ownership="none">
1665           <doc xml:whitespace="preserve">%TRUE if the @appinfo supports files.</doc>
1666           <type name="gboolean" c:type="gboolean"/>
1667         </return-value>
1668       </method>
1669       <method name="supports_uris" c:identifier="g_app_info_supports_uris">
1670         <doc xml:whitespace="preserve">Checks if the application supports reading files and directories from URIs.</doc>
1671         <return-value transfer-ownership="none">
1672           <doc xml:whitespace="preserve">%TRUE if the @appinfo supports URIs.</doc>
1673           <type name="gboolean" c:type="gboolean"/>
1674         </return-value>
1675       </method>
1676     </interface>
1677     <bitfield name="AppInfoCreateFlags"
1678               glib:type-name="GAppInfoCreateFlags"
1679               glib:get-type="g_app_info_create_flags_get_type"
1680               c:type="GAppInfoCreateFlags">
1681       <doc xml:whitespace="preserve">Flags used when creating a #GAppInfo.</doc>
1682       <member name="none"
1683               value="0"
1684               c:identifier="G_APP_INFO_CREATE_NONE"
1685               glib:nick="none"/>
1686       <member name="needs_terminal"
1687               value="1"
1688               c:identifier="G_APP_INFO_CREATE_NEEDS_TERMINAL"
1689               glib:nick="needs-terminal"/>
1690       <member name="supports_uris"
1691               value="2"
1692               c:identifier="G_APP_INFO_CREATE_SUPPORTS_URIS"
1693               glib:nick="supports-uris"/>
1694       <member name="supports_startup_notification"
1695               value="4"
1696               c:identifier="G_APP_INFO_CREATE_SUPPORTS_STARTUP_NOTIFICATION"
1697               glib:nick="supports-startup-notification"/>
1698     </bitfield>
1699     <record name="AppInfoIface"
1700             c:type="GAppInfoIface"
1701             glib:is-gtype-struct-for="AppInfo">
1702       <doc xml:whitespace="preserve">Application Information interface, for operating system portability.</doc>
1703       <field name="g_iface">
1704         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
1705       </field>
1706       <field name="dup">
1707         <callback name="dup">
1708           <return-value transfer-ownership="full">
1709             <doc xml:whitespace="preserve">a duplicate of @appinfo.</doc>
1710             <type name="AppInfo" c:type="GAppInfo*"/>
1711           </return-value>
1712           <parameters>
1713             <parameter name="appinfo" transfer-ownership="none">
1714               <type name="AppInfo" c:type="GAppInfo*"/>
1715             </parameter>
1716           </parameters>
1717         </callback>
1718       </field>
1719       <field name="equal">
1720         <callback name="equal">
1721           <return-value transfer-ownership="none">
1722             <doc xml:whitespace="preserve">%TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise.</doc>
1723             <type name="gboolean" c:type="gboolean"/>
1724           </return-value>
1725           <parameters>
1726             <parameter name="appinfo1" transfer-ownership="none">
1727               <type name="AppInfo" c:type="GAppInfo*"/>
1728             </parameter>
1729             <parameter name="appinfo2" transfer-ownership="none">
1730               <doc xml:whitespace="preserve">the second #GAppInfo.</doc>
1731               <type name="AppInfo" c:type="GAppInfo*"/>
1732             </parameter>
1733           </parameters>
1734         </callback>
1735       </field>
1736       <field name="get_id">
1737         <callback name="get_id">
1738           <return-value transfer-ownership="none">
1739             <doc xml:whitespace="preserve">a string containing the application's ID.</doc>
1740             <type name="utf8" c:type="char*"/>
1741           </return-value>
1742           <parameters>
1743             <parameter name="appinfo" transfer-ownership="none">
1744               <type name="AppInfo" c:type="GAppInfo*"/>
1745             </parameter>
1746           </parameters>
1747         </callback>
1748       </field>
1749       <field name="get_name">
1750         <callback name="get_name">
1751           <return-value transfer-ownership="none">
1752             <doc xml:whitespace="preserve">the name of the application for @appinfo.</doc>
1753             <type name="utf8" c:type="char*"/>
1754           </return-value>
1755           <parameters>
1756             <parameter name="appinfo" transfer-ownership="none">
1757               <type name="AppInfo" c:type="GAppInfo*"/>
1758             </parameter>
1759           </parameters>
1760         </callback>
1761       </field>
1762       <field name="get_description">
1763         <callback name="get_description">
1764           <return-value transfer-ownership="none">
1765             <doc xml:whitespace="preserve">a string containing a description of the</doc>
1766             <type name="utf8" c:type="char*"/>
1767           </return-value>
1768           <parameters>
1769             <parameter name="appinfo" transfer-ownership="none">
1770               <type name="AppInfo" c:type="GAppInfo*"/>
1771             </parameter>
1772           </parameters>
1773         </callback>
1774       </field>
1775       <field name="get_executable">
1776         <callback name="get_executable">
1777           <return-value transfer-ownership="none">
1778             <doc xml:whitespace="preserve">a string containing the @appinfo's application</doc>
1779             <type name="utf8" c:type="char*"/>
1780           </return-value>
1781           <parameters>
1782             <parameter name="appinfo" transfer-ownership="none">
1783               <type name="AppInfo" c:type="GAppInfo*"/>
1784             </parameter>
1785           </parameters>
1786         </callback>
1787       </field>
1788       <field name="get_icon">
1789         <callback name="get_icon">
1790           <return-value transfer-ownership="none">
1791             <doc xml:whitespace="preserve">the default #GIcon for @appinfo.</doc>
1792             <type name="Icon" c:type="GIcon*"/>
1793           </return-value>
1794           <parameters>
1795             <parameter name="appinfo" transfer-ownership="none">
1796               <type name="AppInfo" c:type="GAppInfo*"/>
1797             </parameter>
1798           </parameters>
1799         </callback>
1800       </field>
1801       <field name="launch">
1802         <callback name="launch" throws="1">
1803           <return-value transfer-ownership="none">
1804             <doc xml:whitespace="preserve">%TRUE on successful launch, %FALSE otherwise.</doc>
1805             <type name="gboolean" c:type="gboolean"/>
1806           </return-value>
1807           <parameters>
1808             <parameter name="appinfo" transfer-ownership="none">
1809               <type name="AppInfo" c:type="GAppInfo*"/>
1810             </parameter>
1811             <parameter name="filenames" transfer-ownership="none">
1812               <type name="GLib.List" c:type="GList*">
1813                 <type name="gpointer" c:type="gpointer"/>
1814               </type>
1815             </parameter>
1816             <parameter name="launch_context"
1817                        transfer-ownership="none"
1818                        allow-none="1">
1819               <doc xml:whitespace="preserve">a #GAppLaunchContext or %NULL</doc>
1820               <type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
1821             </parameter>
1822           </parameters>
1823         </callback>
1824       </field>
1825       <field name="supports_uris">
1826         <callback name="supports_uris">
1827           <return-value transfer-ownership="none">
1828             <doc xml:whitespace="preserve">%TRUE if the @appinfo supports URIs.</doc>
1829             <type name="gboolean" c:type="gboolean"/>
1830           </return-value>
1831           <parameters>
1832             <parameter name="appinfo" transfer-ownership="none">
1833               <type name="AppInfo" c:type="GAppInfo*"/>
1834             </parameter>
1835           </parameters>
1836         </callback>
1837       </field>
1838       <field name="supports_files">
1839         <callback name="supports_files">
1840           <return-value transfer-ownership="none">
1841             <doc xml:whitespace="preserve">%TRUE if the @appinfo supports files.</doc>
1842             <type name="gboolean" c:type="gboolean"/>
1843           </return-value>
1844           <parameters>
1845             <parameter name="appinfo" transfer-ownership="none">
1846               <type name="AppInfo" c:type="GAppInfo*"/>
1847             </parameter>
1848           </parameters>
1849         </callback>
1850       </field>
1851       <field name="launch_uris">
1852         <callback name="launch_uris" throws="1">
1853           <return-value transfer-ownership="none">
1854             <doc xml:whitespace="preserve">%TRUE on successful launch, %FALSE otherwise.</doc>
1855             <type name="gboolean" c:type="gboolean"/>
1856           </return-value>
1857           <parameters>
1858             <parameter name="appinfo" transfer-ownership="none">
1859               <type name="AppInfo" c:type="GAppInfo*"/>
1860             </parameter>
1861             <parameter name="uris" transfer-ownership="none">
1862               <doc xml:whitespace="preserve">a #GList containing URIs to launch.</doc>
1863               <type name="GLib.List" c:type="GList*">
1864                 <type name="utf8"/>
1865               </type>
1866             </parameter>
1867             <parameter name="launch_context"
1868                        transfer-ownership="none"
1869                        allow-none="1">
1870               <doc xml:whitespace="preserve">a #GAppLaunchContext or %NULL</doc>
1871               <type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
1872             </parameter>
1873           </parameters>
1874         </callback>
1875       </field>
1876       <field name="should_show">
1877         <callback name="should_show">
1878           <return-value transfer-ownership="none">
1879             <doc xml:whitespace="preserve">%TRUE if the @appinfo should be shown, %FALSE otherwise.</doc>
1880             <type name="gboolean" c:type="gboolean"/>
1881           </return-value>
1882           <parameters>
1883             <parameter name="appinfo" transfer-ownership="none">
1884               <type name="AppInfo" c:type="GAppInfo*"/>
1885             </parameter>
1886           </parameters>
1887         </callback>
1888       </field>
1889       <field name="set_as_default_for_type">
1890         <callback name="set_as_default_for_type" throws="1">
1891           <return-value transfer-ownership="none">
1892             <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
1893             <type name="gboolean" c:type="gboolean"/>
1894           </return-value>
1895           <parameters>
1896             <parameter name="appinfo" transfer-ownership="none">
1897               <type name="AppInfo" c:type="GAppInfo*"/>
1898             </parameter>
1899             <parameter name="content_type" transfer-ownership="none">
1900               <doc xml:whitespace="preserve">the content type.</doc>
1901               <type name="utf8" c:type="char*"/>
1902             </parameter>
1903           </parameters>
1904         </callback>
1905       </field>
1906       <field name="set_as_default_for_extension">
1907         <callback name="set_as_default_for_extension" throws="1">
1908           <return-value transfer-ownership="none">
1909             <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
1910             <type name="gboolean" c:type="gboolean"/>
1911           </return-value>
1912           <parameters>
1913             <parameter name="appinfo" transfer-ownership="none">
1914               <type name="AppInfo" c:type="GAppInfo*"/>
1915             </parameter>
1916             <parameter name="extension" transfer-ownership="none">
1917               <doc xml:whitespace="preserve">a string containing the file extension (without the dot).</doc>
1918               <type name="utf8" c:type="char*"/>
1919             </parameter>
1920           </parameters>
1921         </callback>
1922       </field>
1923       <field name="add_supports_type">
1924         <callback name="add_supports_type" throws="1">
1925           <return-value transfer-ownership="none">
1926             <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
1927             <type name="gboolean" c:type="gboolean"/>
1928           </return-value>
1929           <parameters>
1930             <parameter name="appinfo" transfer-ownership="none">
1931               <type name="AppInfo" c:type="GAppInfo*"/>
1932             </parameter>
1933             <parameter name="content_type" transfer-ownership="none">
1934               <doc xml:whitespace="preserve">a string.</doc>
1935               <type name="utf8" c:type="char*"/>
1936             </parameter>
1937           </parameters>
1938         </callback>
1939       </field>
1940       <field name="can_remove_supports_type">
1941         <callback name="can_remove_supports_type">
1942           <return-value transfer-ownership="none">
1943             <doc xml:whitespace="preserve">%TRUE if it is possible to remove supported</doc>
1944             <type name="gboolean" c:type="gboolean"/>
1945           </return-value>
1946           <parameters>
1947             <parameter name="appinfo" transfer-ownership="none">
1948               <type name="AppInfo" c:type="GAppInfo*"/>
1949             </parameter>
1950           </parameters>
1951         </callback>
1952       </field>
1953       <field name="remove_supports_type">
1954         <callback name="remove_supports_type" throws="1">
1955           <return-value transfer-ownership="none">
1956             <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
1957             <type name="gboolean" c:type="gboolean"/>
1958           </return-value>
1959           <parameters>
1960             <parameter name="appinfo" transfer-ownership="none">
1961               <type name="AppInfo" c:type="GAppInfo*"/>
1962             </parameter>
1963             <parameter name="content_type" transfer-ownership="none">
1964               <doc xml:whitespace="preserve">a string.</doc>
1965               <type name="utf8" c:type="char*"/>
1966             </parameter>
1967           </parameters>
1968         </callback>
1969       </field>
1970       <field name="can_delete">
1971         <callback name="can_delete">
1972           <return-value transfer-ownership="none">
1973             <doc xml:whitespace="preserve">%TRUE if @appinfo can be deleted</doc>
1974             <type name="gboolean" c:type="gboolean"/>
1975           </return-value>
1976           <parameters>
1977             <parameter name="appinfo" transfer-ownership="none">
1978               <type name="AppInfo" c:type="GAppInfo*"/>
1979             </parameter>
1980           </parameters>
1981         </callback>
1982       </field>
1983       <field name="do_delete">
1984         <callback name="do_delete">
1985           <return-value transfer-ownership="none">
1986             <doc xml:whitespace="preserve">%TRUE if @appinfo has been deleted</doc>
1987             <type name="gboolean" c:type="gboolean"/>
1988           </return-value>
1989           <parameters>
1990             <parameter name="appinfo" transfer-ownership="none">
1991               <type name="AppInfo" c:type="GAppInfo*"/>
1992             </parameter>
1993           </parameters>
1994         </callback>
1995       </field>
1996       <field name="get_commandline">
1997         <callback name="get_commandline">
1998           <return-value transfer-ownership="none">
1999             <doc xml:whitespace="preserve">a string containing the @appinfo's commandline,</doc>
2000             <type name="utf8" c:type="char*"/>
2001           </return-value>
2002           <parameters>
2003             <parameter name="appinfo" transfer-ownership="none">
2004               <type name="AppInfo" c:type="GAppInfo*"/>
2005             </parameter>
2006           </parameters>
2007         </callback>
2008       </field>
2009       <field name="get_display_name">
2010         <callback name="get_display_name">
2011           <return-value transfer-ownership="none">
2012             <doc xml:whitespace="preserve">the display name of the application for @appinfo, or the name if</doc>
2013             <type name="utf8" c:type="char*"/>
2014           </return-value>
2015           <parameters>
2016             <parameter name="appinfo" transfer-ownership="none">
2017               <type name="AppInfo" c:type="GAppInfo*"/>
2018             </parameter>
2019           </parameters>
2020         </callback>
2021       </field>
2022     </record>
2023     <class name="AppLaunchContext"
2024            c:symbol-prefix="app_launch_context"
2025            c:type="GAppLaunchContext"
2026            parent="GObject.Object"
2027            glib:type-name="GAppLaunchContext"
2028            glib:get-type="g_app_launch_context_get_type"
2029            glib:type-struct="AppLaunchContextClass">
2030       <doc xml:whitespace="preserve">Integrating the launch with the launching application. This is used to
2031 handle for instance startup notification and launching the new application
2032 on the same screen as the launching window.</doc>
2033       <constructor name="new" c:identifier="g_app_launch_context_new">
2034         <doc xml:whitespace="preserve">Creates a new application launch context. This is not normally used,
2035 instead you instantiate a subclass of this, such as #GdkAppLaunchContext.</doc>
2036         <return-value transfer-ownership="full">
2037           <doc xml:whitespace="preserve">a #GAppLaunchContext.</doc>
2038           <type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
2039         </return-value>
2040       </constructor>
2041       <virtual-method name="get_display" invoker="get_display">
2042         <doc xml:whitespace="preserve">Gets the display string for the @context. This is used to ensure new
2043 applications are started on the same display as the launching
2044 application, by setting the &lt;envvar&gt;DISPLAY&lt;/envvar&gt; environment variable.</doc>
2045         <return-value transfer-ownership="full">
2046           <doc xml:whitespace="preserve">a display string for the display.</doc>
2047           <type name="utf8" c:type="char*"/>
2048         </return-value>
2049         <parameters>
2050           <parameter name="info" transfer-ownership="none">
2051             <doc xml:whitespace="preserve">a #GAppInfo</doc>
2052             <type name="AppInfo" c:type="GAppInfo*"/>
2053           </parameter>
2054           <parameter name="files" transfer-ownership="none">
2055             <doc xml:whitespace="preserve">a #GList of #GFile objects</doc>
2056             <type name="GLib.List" c:type="GList*">
2057               <type name="File"/>
2058             </type>
2059           </parameter>
2060         </parameters>
2061       </virtual-method>
2062       <virtual-method name="get_startup_notify_id"
2063                       invoker="get_startup_notify_id">
2064         <doc xml:whitespace="preserve">Initiates startup notification for the application and returns the
2065 &lt;envvar&gt;DESKTOP_STARTUP_ID&lt;/envvar&gt; for the launched operation,
2066 if supported.
2067 Startup notification IDs are defined in the &lt;ulink
2068 url="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt"&gt;
2069 FreeDesktop.Org Startup Notifications standard&lt;/ulink&gt;.
2070 not supported.</doc>
2071         <return-value transfer-ownership="full">
2072           <doc xml:whitespace="preserve">a startup notification ID for the application, or %NULL if</doc>
2073           <type name="utf8" c:type="char*"/>
2074         </return-value>
2075         <parameters>
2076           <parameter name="info" transfer-ownership="none">
2077             <doc xml:whitespace="preserve">a #GAppInfo</doc>
2078             <type name="AppInfo" c:type="GAppInfo*"/>
2079           </parameter>
2080           <parameter name="files" transfer-ownership="none">
2081             <doc xml:whitespace="preserve">a #GList of of #GFile objects</doc>
2082             <type name="GLib.List" c:type="GList*">
2083               <type name="File"/>
2084             </type>
2085           </parameter>
2086         </parameters>
2087       </virtual-method>
2088       <virtual-method name="launch_failed" invoker="launch_failed">
2089         <doc xml:whitespace="preserve">Called when an application has failed to launch, so that it can cancel
2090 the application startup notification started in g_app_launch_context_get_startup_notify_id().</doc>
2091         <return-value transfer-ownership="none">
2092           <type name="none" c:type="void"/>
2093         </return-value>
2094         <parameters>
2095           <parameter name="startup_notify_id" transfer-ownership="none">
2096             <doc xml:whitespace="preserve">the startup notification id that was returned by g_app_launch_context_get_startup_notify_id().</doc>
2097             <type name="utf8" c:type="char*"/>
2098           </parameter>
2099         </parameters>
2100       </virtual-method>
2101       <method name="get_display"
2102               c:identifier="g_app_launch_context_get_display">
2103         <doc xml:whitespace="preserve">Gets the display string for the @context. This is used to ensure new
2104 applications are started on the same display as the launching
2105 application, by setting the &lt;envvar&gt;DISPLAY&lt;/envvar&gt; environment variable.</doc>
2106         <return-value transfer-ownership="full">
2107           <doc xml:whitespace="preserve">a display string for the display.</doc>
2108           <type name="utf8" c:type="char*"/>
2109         </return-value>
2110         <parameters>
2111           <parameter name="info" transfer-ownership="none">
2112             <doc xml:whitespace="preserve">a #GAppInfo</doc>
2113             <type name="AppInfo" c:type="GAppInfo*"/>
2114           </parameter>
2115           <parameter name="files" transfer-ownership="none">
2116             <doc xml:whitespace="preserve">a #GList of #GFile objects</doc>
2117             <type name="GLib.List" c:type="GList*">
2118               <type name="File"/>
2119             </type>
2120           </parameter>
2121         </parameters>
2122       </method>
2123       <method name="get_startup_notify_id"
2124               c:identifier="g_app_launch_context_get_startup_notify_id">
2125         <doc xml:whitespace="preserve">Initiates startup notification for the application and returns the
2126 &lt;envvar&gt;DESKTOP_STARTUP_ID&lt;/envvar&gt; for the launched operation,
2127 if supported.
2128 Startup notification IDs are defined in the &lt;ulink
2129 url="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt"&gt;
2130 FreeDesktop.Org Startup Notifications standard&lt;/ulink&gt;.
2131 not supported.</doc>
2132         <return-value transfer-ownership="full">
2133           <doc xml:whitespace="preserve">a startup notification ID for the application, or %NULL if</doc>
2134           <type name="utf8" c:type="char*"/>
2135         </return-value>
2136         <parameters>
2137           <parameter name="info" transfer-ownership="none">
2138             <doc xml:whitespace="preserve">a #GAppInfo</doc>
2139             <type name="AppInfo" c:type="GAppInfo*"/>
2140           </parameter>
2141           <parameter name="files" transfer-ownership="none">
2142             <doc xml:whitespace="preserve">a #GList of of #GFile objects</doc>
2143             <type name="GLib.List" c:type="GList*">
2144               <type name="File"/>
2145             </type>
2146           </parameter>
2147         </parameters>
2148       </method>
2149       <method name="launch_failed"
2150               c:identifier="g_app_launch_context_launch_failed">
2151         <doc xml:whitespace="preserve">Called when an application has failed to launch, so that it can cancel
2152 the application startup notification started in g_app_launch_context_get_startup_notify_id().</doc>
2153         <return-value transfer-ownership="none">
2154           <type name="none" c:type="void"/>
2155         </return-value>
2156         <parameters>
2157           <parameter name="startup_notify_id" transfer-ownership="none">
2158             <doc xml:whitespace="preserve">the startup notification id that was returned by g_app_launch_context_get_startup_notify_id().</doc>
2159             <type name="utf8" c:type="char*"/>
2160           </parameter>
2161         </parameters>
2162       </method>
2163       <field name="parent_instance">
2164         <type name="GObject.Object" c:type="GObject"/>
2165       </field>
2166       <field name="priv">
2167         <type name="AppLaunchContextPrivate"
2168               c:type="GAppLaunchContextPrivate*"/>
2169       </field>
2170     </class>
2171     <record name="AppLaunchContextClass"
2172             c:type="GAppLaunchContextClass"
2173             glib:is-gtype-struct-for="AppLaunchContext">
2174       <field name="parent_class">
2175         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
2176       </field>
2177       <field name="get_display">
2178         <callback name="get_display">
2179           <return-value transfer-ownership="full">
2180             <doc xml:whitespace="preserve">a display string for the display.</doc>
2181             <type name="utf8" c:type="char*"/>
2182           </return-value>
2183           <parameters>
2184             <parameter name="context" transfer-ownership="none">
2185               <type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
2186             </parameter>
2187             <parameter name="info" transfer-ownership="none">
2188               <doc xml:whitespace="preserve">a #GAppInfo</doc>
2189               <type name="AppInfo" c:type="GAppInfo*"/>
2190             </parameter>
2191             <parameter name="files" transfer-ownership="none">
2192               <doc xml:whitespace="preserve">a #GList of #GFile objects</doc>
2193               <type name="GLib.List" c:type="GList*">
2194                 <type name="File"/>
2195               </type>
2196             </parameter>
2197           </parameters>
2198         </callback>
2199       </field>
2200       <field name="get_startup_notify_id">
2201         <callback name="get_startup_notify_id">
2202           <return-value transfer-ownership="full">
2203             <doc xml:whitespace="preserve">a startup notification ID for the application, or %NULL if</doc>
2204             <type name="utf8" c:type="char*"/>
2205           </return-value>
2206           <parameters>
2207             <parameter name="context" transfer-ownership="none">
2208               <type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
2209             </parameter>
2210             <parameter name="info" transfer-ownership="none">
2211               <doc xml:whitespace="preserve">a #GAppInfo</doc>
2212               <type name="AppInfo" c:type="GAppInfo*"/>
2213             </parameter>
2214             <parameter name="files" transfer-ownership="none">
2215               <doc xml:whitespace="preserve">a #GList of of #GFile objects</doc>
2216               <type name="GLib.List" c:type="GList*">
2217                 <type name="File"/>
2218               </type>
2219             </parameter>
2220           </parameters>
2221         </callback>
2222       </field>
2223       <field name="launch_failed">
2224         <callback name="launch_failed">
2225           <return-value transfer-ownership="none">
2226             <type name="none" c:type="void"/>
2227           </return-value>
2228           <parameters>
2229             <parameter name="context" transfer-ownership="none">
2230               <type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
2231             </parameter>
2232             <parameter name="startup_notify_id" transfer-ownership="none">
2233               <doc xml:whitespace="preserve">the startup notification id that was returned by g_app_launch_context_get_startup_notify_id().</doc>
2234               <type name="utf8" c:type="char*"/>
2235             </parameter>
2236           </parameters>
2237         </callback>
2238       </field>
2239       <field name="_g_reserved1" introspectable="0">
2240         <callback name="_g_reserved1">
2241           <return-value transfer-ownership="none">
2242             <type name="none" c:type="void"/>
2243           </return-value>
2244         </callback>
2245       </field>
2246       <field name="_g_reserved2" introspectable="0">
2247         <callback name="_g_reserved2">
2248           <return-value transfer-ownership="none">
2249             <type name="none" c:type="void"/>
2250           </return-value>
2251         </callback>
2252       </field>
2253       <field name="_g_reserved3" introspectable="0">
2254         <callback name="_g_reserved3">
2255           <return-value transfer-ownership="none">
2256             <type name="none" c:type="void"/>
2257           </return-value>
2258         </callback>
2259       </field>
2260       <field name="_g_reserved4" introspectable="0">
2261         <callback name="_g_reserved4">
2262           <return-value transfer-ownership="none">
2263             <type name="none" c:type="void"/>
2264           </return-value>
2265         </callback>
2266       </field>
2267       <field name="_g_reserved5" introspectable="0">
2268         <callback name="_g_reserved5">
2269           <return-value transfer-ownership="none">
2270             <type name="none" c:type="void"/>
2271           </return-value>
2272         </callback>
2273       </field>
2274     </record>
2275     <record name="AppLaunchContextPrivate"
2276             c:type="GAppLaunchContextPrivate"
2277             disguised="1">
2278     </record>
2279     <class name="Application"
2280            c:symbol-prefix="application"
2281            c:type="GApplication"
2282            version="2.26"
2283            parent="GObject.Object"
2284            glib:type-name="GApplication"
2285            glib:get-type="g_application_get_type"
2286            glib:type-struct="ApplicationClass">
2287       <doc xml:whitespace="preserve">The &lt;structname&gt;GApplication&lt;/structname&gt; structure contains private
2288 data and should only be accessed using the provided API</doc>
2289       <implements name="Initable"/>
2290       <constructor name="new" c:identifier="g_application_new" version="2.26">
2291         <doc xml:whitespace="preserve">Create a new #GApplication.  This uses a platform-specific
2292 mechanism to ensure the current process is the unique owner of the
2293 application (as defined by the @appid). If successful, the
2294 #GApplication:is-remote property will be %FALSE, and it is safe to
2295 continue creating other resources such as graphics windows.
2296 If the given @appid is already running in another process, the the
2297 GApplication::activate_with_data signal will be emitted in the
2298 remote process, with the data from @argv and other
2299 platform-specific data available.  Subsequently the
2300 #GApplication:default-quit property will be evaluated.  If it's
2301 %TRUE, then the current process will terminate.  If %FALSE, then
2302 the application remains in the #GApplication:is-remote state, and
2303 you can e.g. call g_application_invoke_action(). Note that proxy
2304 instances should not call g_application_add_action().
2305 This function may do synchronous I/O to obtain unique ownership
2306 of the application id, and will block the calling thread in this
2307 case.
2308 If the environment does not support the basic functionality of
2309 #GApplication, this function will invoke g_error(), which by
2310 default is a fatal operation.  This may arise for example on
2311 UNIX systems using D-Bus when the session bus is not available.
2312 As a convenience, this function is defined to call g_type_init() as
2313 its very first action.</doc>
2314         <return-value transfer-ownership="full">
2315           <doc xml:whitespace="preserve">An application instance</doc>
2316           <type name="Application" c:type="GApplication*"/>
2317         </return-value>
2318         <parameters>
2319           <parameter name="appid" transfer-ownership="none">
2320             <doc xml:whitespace="preserve">System-dependent application identifier</doc>
2321             <type name="utf8" c:type="gchar*"/>
2322           </parameter>
2323           <parameter name="argc" transfer-ownership="none">
2324             <doc xml:whitespace="preserve">Number of arguments in @argv</doc>
2325             <type name="gint" c:type="int"/>
2326           </parameter>
2327           <parameter name="argv" transfer-ownership="none" allow-none="1">
2328             <doc xml:whitespace="preserve">Argument vector, usually from the &lt;parameter&gt;argv&lt;/parameter&gt; parameter of main()</doc>
2329             <array length="1" c:type="char**">
2330               <type name="utf8"/>
2331             </array>
2332           </parameter>
2333         </parameters>
2334       </constructor>
2335       <constructor name="try_new"
2336                    c:identifier="g_application_try_new"
2337                    version="2.26"
2338                    throws="1">
2339         <doc xml:whitespace="preserve">This function is similar to g_application_new(), but allows for
2340 more graceful fallback if the environment doesn't support the
2341 basic #GApplication functionality.</doc>
2342         <return-value transfer-ownership="full">
2343           <doc xml:whitespace="preserve">An application instance</doc>
2344           <type name="Application" c:type="GApplication*"/>
2345         </return-value>
2346         <parameters>
2347           <parameter name="appid" transfer-ownership="none">
2348             <doc xml:whitespace="preserve">System-dependent application identifier</doc>
2349             <type name="utf8" c:type="gchar*"/>
2350           </parameter>
2351           <parameter name="argc" transfer-ownership="none">
2352             <doc xml:whitespace="preserve">Number of arguments in @argv</doc>
2353             <type name="gint" c:type="int"/>
2354           </parameter>
2355           <parameter name="argv" transfer-ownership="none" allow-none="1">
2356             <doc xml:whitespace="preserve">Argument vector, usually from the &lt;parameter&gt;argv&lt;/parameter&gt; parameter of main()</doc>
2357             <array length="1" c:type="char**">
2358               <type name="utf8"/>
2359             </array>
2360           </parameter>
2361         </parameters>
2362       </constructor>
2363       <constructor name="unregistered_try_new"
2364                    c:identifier="g_application_unregistered_try_new"
2365                    version="2.26"
2366                    throws="1">
2367         <doc xml:whitespace="preserve">This function is similar to g_application_try_new(), but also
2368 sets the GApplication:register property to %FALSE.  You can later
2369 call g_application_register() to complete initialization.</doc>
2370         <return-value transfer-ownership="full">
2371           <doc xml:whitespace="preserve">An application instance</doc>
2372           <type name="Application" c:type="GApplication*"/>
2373         </return-value>
2374         <parameters>
2375           <parameter name="appid" transfer-ownership="none">
2376             <doc xml:whitespace="preserve">System-dependent application identifier</doc>
2377             <type name="utf8" c:type="gchar*"/>
2378           </parameter>
2379           <parameter name="argc" transfer-ownership="none">
2380             <doc xml:whitespace="preserve">Number of arguments in @argv</doc>
2381             <type name="gint" c:type="int"/>
2382           </parameter>
2383           <parameter name="argv" transfer-ownership="none" allow-none="1">
2384             <doc xml:whitespace="preserve">Argument vector, usually from the &lt;parameter&gt;argv&lt;/parameter&gt; parameter of main()</doc>
2385             <array length="1" c:type="char**">
2386               <type name="utf8"/>
2387             </array>
2388           </parameter>
2389         </parameters>
2390       </constructor>
2391       <function name="get_instance"
2392                 c:identifier="g_application_get_instance"
2393                 version="2.26">
2394         <doc xml:whitespace="preserve">In the normal case where there is exactly one #GApplication instance
2395 in this process, return that instance.  If there are multiple, the
2396 first one created will be returned.  Otherwise, return %NULL.
2397 or %NULL if none is set</doc>
2398         <return-value transfer-ownership="none">
2399           <doc xml:whitespace="preserve">The primary instance of #GApplication,</doc>
2400           <type name="Application" c:type="GApplication*"/>
2401         </return-value>
2402       </function>
2403       <virtual-method name="run" invoker="run" version="2.26">
2404         <doc xml:whitespace="preserve">Starts the application.
2405 The default implementation of this virtual function will simply run
2406 a main loop.
2407 It is an error to call this function if @application is a proxy for
2408 a remote application.</doc>
2409         <return-value transfer-ownership="none">
2410           <type name="none" c:type="void"/>
2411         </return-value>
2412       </virtual-method>
2413       <method name="add_action"
2414               c:identifier="g_application_add_action"
2415               version="2.26">
2416         <doc xml:whitespace="preserve">Adds an action @name to the list of exported actions of @application.
2417 It is an error to call this function if @application is a proxy for
2418 a remote application.
2419 You can invoke an action using g_application_invoke_action().
2420 The newly added action is enabled by default; you can call
2421 g_application_set_action_enabled() to disable it.</doc>
2422         <return-value transfer-ownership="none">
2423           <type name="none" c:type="void"/>
2424         </return-value>
2425         <parameters>
2426           <parameter name="name" transfer-ownership="none">
2427             <doc xml:whitespace="preserve">the action name</doc>
2428             <type name="utf8" c:type="gchar*"/>
2429           </parameter>
2430           <parameter name="description" transfer-ownership="none">
2431             <doc xml:whitespace="preserve">the action description; can be a translatable string</doc>
2432             <type name="utf8" c:type="gchar*"/>
2433           </parameter>
2434         </parameters>
2435       </method>
2436       <method name="get_action_description"
2437               c:identifier="g_application_get_action_description"
2438               version="2.26">
2439         <doc xml:whitespace="preserve">Gets the description of the action @name.
2440 It is an error to call this function if @application is a proxy for
2441 a remote application.</doc>
2442         <return-value transfer-ownership="none">
2443           <doc xml:whitespace="preserve">Description for the given action named @name</doc>
2444           <type name="utf8" c:type="gchar*"/>
2445         </return-value>
2446         <parameters>
2447           <parameter name="name" transfer-ownership="none">
2448             <doc xml:whitespace="preserve">Action name</doc>
2449             <type name="utf8" c:type="gchar*"/>
2450           </parameter>
2451         </parameters>
2452       </method>
2453       <method name="get_action_enabled"
2454               c:identifier="g_application_get_action_enabled"
2455               version="2.26">
2456         <doc xml:whitespace="preserve">Retrieves whether the action @name is enabled or not.
2457 See g_application_set_action_enabled().
2458 It is an error to call this function if @application is a proxy for
2459 a remote application.</doc>
2460         <return-value transfer-ownership="none">
2461           <doc xml:whitespace="preserve">%TRUE if the action was enabled, and %FALSE otherwise</doc>
2462           <type name="gboolean" c:type="gboolean"/>
2463         </return-value>
2464         <parameters>
2465           <parameter name="name" transfer-ownership="none">
2466             <doc xml:whitespace="preserve">the name of the action</doc>
2467             <type name="utf8" c:type="gchar*"/>
2468           </parameter>
2469         </parameters>
2470       </method>
2471       <method name="get_id" c:identifier="g_application_get_id" version="2.26">
2472         <doc xml:whitespace="preserve">Retrieves the platform-specific identifier for the #GApplication.
2473 is owned by the #GApplication instance and it should never be
2474 modified or freed</doc>
2475         <return-value transfer-ownership="none">
2476           <doc xml:whitespace="preserve">The platform-specific identifier. The returned string</doc>
2477           <type name="utf8" c:type="gchar*"/>
2478         </return-value>
2479       </method>
2480       <method name="invoke_action"
2481               c:identifier="g_application_invoke_action"
2482               version="2.26">
2483         <doc xml:whitespace="preserve">Invokes the action @name of the passed #GApplication.
2484 This function has different behavior depending on whether @application
2485 is acting as a proxy for another process.  In the normal case where
2486 the current process is hosting the application, and the specified
2487 action exists and is enabled, the #GApplication::action signal will
2488 be emitted.
2489 If @application is a proxy, then the specified action will be invoked
2490 in the remote process. It is not necessary to call
2491 g_application_add_action() in the current process in order to invoke
2492 one remotely.</doc>
2493         <return-value transfer-ownership="none">
2494           <type name="none" c:type="void"/>
2495         </return-value>
2496         <parameters>
2497           <parameter name="name" transfer-ownership="none">
2498             <doc xml:whitespace="preserve">the name of the action to invoke</doc>
2499             <type name="utf8" c:type="gchar*"/>
2500           </parameter>
2501           <parameter name="platform_data"
2502                      transfer-ownership="none"
2503                      allow-none="1">
2504             <doc xml:whitespace="preserve">platform-specific event data</doc>
2505             <type name="GLib.Variant" c:type="GVariant*"/>
2506           </parameter>
2507         </parameters>
2508       </method>
2509       <method name="is_remote" c:identifier="g_application_is_remote">
2510         <doc xml:whitespace="preserve">Returns whether the object represents a proxy for a remote application.</doc>
2511         <return-value transfer-ownership="none">
2512           <doc xml:whitespace="preserve">%TRUE if this object represents a proxy for a remote application.</doc>
2513           <type name="gboolean" c:type="gboolean"/>
2514         </return-value>
2515       </method>
2516       <method name="list_actions"
2517               c:identifier="g_application_list_actions"
2518               version="2.26">
2519         <doc xml:whitespace="preserve">Retrieves the list of action names currently exported by @application.
2520 It is an error to call this function if @application is a proxy for
2521 a remote application.
2522 of strings containing action names; use g_strfreev() to free the
2523 resources used by the returned array</doc>
2524         <return-value transfer-ownership="full">
2525           <doc xml:whitespace="preserve">a newly allocation, %NULL-terminated array</doc>
2526           <array c:type="gchar**">
2527             <type name="utf8"/>
2528           </array>
2529         </return-value>
2530       </method>
2531       <method name="quit_with_data"
2532               c:identifier="g_application_quit_with_data"
2533               version="2.26">
2534         <doc xml:whitespace="preserve">Request that the application quits.
2535 This function has different behavior depending on whether @application
2536 is acting as a proxy for another process.  In the normal case where
2537 the current process is hosting the application, the default
2538 implementation will quit the main loop created by g_application_run().
2539 If @application is a proxy, then the remote process will be asked
2540 to quit.</doc>
2541         <return-value transfer-ownership="none">
2542           <doc xml:whitespace="preserve">%TRUE if the application accepted the request, %FALSE otherwise</doc>
2543           <type name="gboolean" c:type="gboolean"/>
2544         </return-value>
2545         <parameters>
2546           <parameter name="platform_data"
2547                      transfer-ownership="none"
2548                      allow-none="1">
2549             <doc xml:whitespace="preserve">platform-specific data</doc>
2550             <type name="GLib.Variant" c:type="GVariant*"/>
2551           </parameter>
2552         </parameters>
2553       </method>
2554       <method name="register" c:identifier="g_application_register">
2555         <doc xml:whitespace="preserve">By default, #GApplication ensures process uniqueness when
2556 initialized, but this behavior is controlled by the
2557 GApplication:register property.  If it was given as %FALSE at
2558 construction time, this function allows you to later attempt
2559 to ensure uniqueness.  Note that the GApplication:default-quit
2560 property no longer applies at this point; if this function returns
2561 %FALSE, platform activation will occur, but the current process
2562 will not be terminated.
2563 It is an error to call this function more than once.  It is
2564 also an error to call this function if the GApplication:register
2565 property was %TRUE at construction time.</doc>
2566         <return-value transfer-ownership="none">
2567           <doc xml:whitespace="preserve">%TRUE if registration was successful</doc>
2568           <type name="gboolean" c:type="gboolean"/>
2569         </return-value>
2570       </method>
2571       <method name="remove_action"
2572               c:identifier="g_application_remove_action"
2573               version="2.26">
2574         <doc xml:whitespace="preserve">Removes the action @name from the list of exported actions of @application.
2575 It is an error to call this function if @application is a proxy for
2576 a remote application.</doc>
2577         <return-value transfer-ownership="none">
2578           <type name="none" c:type="void"/>
2579         </return-value>
2580         <parameters>
2581           <parameter name="name" transfer-ownership="none">
2582             <doc xml:whitespace="preserve">the name of the action to remove</doc>
2583             <type name="utf8" c:type="gchar*"/>
2584           </parameter>
2585         </parameters>
2586       </method>
2587       <method name="run" c:identifier="g_application_run" version="2.26">
2588         <doc xml:whitespace="preserve">Starts the application.
2589 The default implementation of this virtual function will simply run
2590 a main loop.
2591 It is an error to call this function if @application is a proxy for
2592 a remote application.</doc>
2593         <return-value transfer-ownership="none">
2594           <type name="none" c:type="void"/>
2595         </return-value>
2596       </method>
2597       <method name="set_action_enabled"
2598               c:identifier="g_application_set_action_enabled"
2599               version="2.26">
2600         <doc xml:whitespace="preserve">Sets whether the action @name inside @application should be enabled
2601 or disabled.
2602 It is an error to call this function if @application is a proxy for
2603 a remote application.
2604 Invoking a disabled action will not result in the #GApplication::action
2605 signal being emitted.</doc>
2606         <return-value transfer-ownership="none">
2607           <type name="none" c:type="void"/>
2608         </return-value>
2609         <parameters>
2610           <parameter name="name" transfer-ownership="none">
2611             <doc xml:whitespace="preserve">the name of the application</doc>
2612             <type name="utf8" c:type="gchar*"/>
2613           </parameter>
2614           <parameter name="enabled" transfer-ownership="none">
2615             <doc xml:whitespace="preserve">whether to enable or disable the action @name</doc>
2616             <type name="gboolean" c:type="gboolean"/>
2617           </parameter>
2618         </parameters>
2619       </method>
2620       <property name="application-id"
2621                 writable="1"
2622                 construct-only="1"
2623                 transfer-ownership="none">
2624         <doc xml:whitespace="preserve">The unique identifier for this application.  See the documentation for
2625 #GApplication for more information about this property.</doc>
2626         <type name="utf8"/>
2627       </property>
2628       <property name="argv"
2629                 writable="1"
2630                 construct-only="1"
2631                 transfer-ownership="none">
2632         <doc xml:whitespace="preserve">The argument vector given to this application.  It must be a #GVariant
2633 with a type signature "aay".</doc>
2634         <type name="GLib.Variant"/>
2635       </property>
2636       <property name="default-quit"
2637                 writable="1"
2638                 construct-only="1"
2639                 transfer-ownership="none">
2640         <doc xml:whitespace="preserve">By default, if the GApplication:register property is %TRUE, and a
2641 different process is running this application, the process will
2642 be exited.  Set this property to %FALSE to allow custom
2643 interaction with the remote process.</doc>
2644         <type name="gboolean"/>
2645       </property>
2646       <property name="is-remote" transfer-ownership="none">
2647         <doc xml:whitespace="preserve">This property is %TRUE if this application instance represents a proxy
2648 to the instance of this application in another process.</doc>
2649         <type name="gboolean"/>
2650       </property>
2651       <property name="platform-data"
2652                 writable="1"
2653                 construct-only="1"
2654                 transfer-ownership="none">
2655         <doc xml:whitespace="preserve">Platform-specific data retrieved from the operating system
2656 environment.  It must be a #GVariant with type signature "a{sv}".</doc>
2657         <type name="GLib.Variant"/>
2658       </property>
2659       <property name="register"
2660                 writable="1"
2661                 construct-only="1"
2662                 transfer-ownership="none">
2663         <doc xml:whitespace="preserve">If this property is %FALSE, the application construction will not attempt
2664 to ensure process uniqueness, and the application is guaranteed to be in the
2665 remote state.  See GApplication:is-remote.</doc>
2666         <type name="gboolean"/>
2667       </property>
2668       <field name="parent_instance">
2669         <type name="GObject.Object" c:type="GObject"/>
2670       </field>
2671       <field name="priv">
2672         <type name="ApplicationPrivate" c:type="GApplicationPrivate*"/>
2673       </field>
2674       <glib:signal name="action-with-data">
2675         <doc xml:whitespace="preserve">This signal is emitted when an action is activated. The action name
2676 is passed as the first argument, but also as signal detail, so it
2677 is possible to connect to this signal for individual actions.
2678 The signal is never emitted for disabled actions.</doc>
2679         <return-value transfer-ownership="none">
2680           <type name="none"/>
2681         </return-value>
2682         <parameters>
2683           <parameter name="object" transfer-ownership="none">
2684             <doc xml:whitespace="preserve">The name of the activated action</doc>
2685             <type name="utf8"/>
2686           </parameter>
2687           <parameter name="p0" transfer-ownership="none">
2688             <doc xml:whitespace="preserve">Platform-specific data, or %NULL</doc>
2689             <type name="GLib.Variant"/>
2690           </parameter>
2691         </parameters>
2692       </glib:signal>
2693       <glib:signal name="prepare-activation">
2694         <doc xml:whitespace="preserve">This signal is emitted when a non-primary process for a given
2695 application is invoked while your application is running; for
2696 example, when a file browser launches your program to open a
2697 file.  The raw operating system arguments are passed in the
2698 stored in @platform_data.</doc>
2699         <return-value transfer-ownership="none">
2700           <type name="none"/>
2701         </return-value>
2702         <parameters>
2703           <parameter name="object" transfer-ownership="none">
2704             <doc xml:whitespace="preserve">A #GVariant with the signature "aay"</doc>
2705             <type name="GLib.Variant"/>
2706           </parameter>
2707           <parameter name="p0" transfer-ownership="none">
2708             <doc xml:whitespace="preserve">A #GVariant with the signature "a{sv}", or %NULL</doc>
2709             <type name="GLib.Variant"/>
2710           </parameter>
2711         </parameters>
2712       </glib:signal>
2713       <glib:signal name="quit-with-data">
2714         <doc xml:whitespace="preserve">This signal is emitted when the Quit action is invoked on the
2715 application.
2716 The default handler for this signal exits the mainloop of the
2717 application.
2718 signal emission</doc>
2719         <return-value transfer-ownership="none">
2720           <doc xml:whitespace="preserve">%TRUE if the signal has been handled, %FALSE to continue</doc>
2721           <type name="gboolean"/>
2722         </return-value>
2723         <parameters>
2724           <parameter name="object" transfer-ownership="none">
2725             <doc xml:whitespace="preserve">Platform-specific data, or %NULL</doc>
2726             <type name="GLib.Variant"/>
2727           </parameter>
2728         </parameters>
2729       </glib:signal>
2730     </class>
2731     <record name="ApplicationClass"
2732             c:type="GApplicationClass"
2733             glib:is-gtype-struct-for="Application"
2734             version="2.26">
2735       <doc xml:whitespace="preserve">The &lt;structname&gt;GApplicationClass&lt;/structname&gt; structure contains
2736 private data only</doc>
2737       <field name="parent_class">
2738         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
2739       </field>
2740       <field name="action_with_data">
2741         <callback name="action_with_data">
2742           <return-value transfer-ownership="none">
2743             <type name="none" c:type="void"/>
2744           </return-value>
2745           <parameters>
2746             <parameter name="application" transfer-ownership="none">
2747               <type name="Application" c:type="GApplication*"/>
2748             </parameter>
2749             <parameter name="action_name" transfer-ownership="none">
2750               <type name="utf8" c:type="gchar*"/>
2751             </parameter>
2752             <parameter name="platform_data" transfer-ownership="none">
2753               <type name="GLib.Variant" c:type="GVariant*"/>
2754             </parameter>
2755           </parameters>
2756         </callback>
2757       </field>
2758       <field name="quit_with_data">
2759         <callback name="quit_with_data">
2760           <return-value transfer-ownership="none">
2761             <type name="gboolean" c:type="gboolean"/>
2762           </return-value>
2763           <parameters>
2764             <parameter name="application" transfer-ownership="none">
2765               <type name="Application" c:type="GApplication*"/>
2766             </parameter>
2767             <parameter name="platform_data" transfer-ownership="none">
2768               <type name="GLib.Variant" c:type="GVariant*"/>
2769             </parameter>
2770           </parameters>
2771         </callback>
2772       </field>
2773       <field name="prepare_activation">
2774         <callback name="prepare_activation">
2775           <return-value transfer-ownership="none">
2776             <type name="none" c:type="void"/>
2777           </return-value>
2778           <parameters>
2779             <parameter name="application" transfer-ownership="none">
2780               <type name="Application" c:type="GApplication*"/>
2781             </parameter>
2782             <parameter name="arguments" transfer-ownership="none">
2783               <type name="GLib.Variant" c:type="GVariant*"/>
2784             </parameter>
2785             <parameter name="platform_data" transfer-ownership="none">
2786               <type name="GLib.Variant" c:type="GVariant*"/>
2787             </parameter>
2788           </parameters>
2789         </callback>
2790       </field>
2791       <field name="run">
2792         <callback name="run">
2793           <return-value transfer-ownership="none">
2794             <type name="none" c:type="void"/>
2795           </return-value>
2796           <parameters>
2797             <parameter name="application" transfer-ownership="none">
2798               <type name="Application" c:type="GApplication*"/>
2799             </parameter>
2800           </parameters>
2801         </callback>
2802       </field>
2803       <field name="_g_reserved1" introspectable="0">
2804         <callback name="_g_reserved1">
2805           <return-value transfer-ownership="none">
2806             <type name="none" c:type="void"/>
2807           </return-value>
2808         </callback>
2809       </field>
2810       <field name="_g_reserved2" introspectable="0">
2811         <callback name="_g_reserved2">
2812           <return-value transfer-ownership="none">
2813             <type name="none" c:type="void"/>
2814           </return-value>
2815         </callback>
2816       </field>
2817       <field name="_g_reserved3" introspectable="0">
2818         <callback name="_g_reserved3">
2819           <return-value transfer-ownership="none">
2820             <type name="none" c:type="void"/>
2821           </return-value>
2822         </callback>
2823       </field>
2824       <field name="_g_reserved4" introspectable="0">
2825         <callback name="_g_reserved4">
2826           <return-value transfer-ownership="none">
2827             <type name="none" c:type="void"/>
2828           </return-value>
2829         </callback>
2830       </field>
2831       <field name="_g_reserved5" introspectable="0">
2832         <callback name="_g_reserved5">
2833           <return-value transfer-ownership="none">
2834             <type name="none" c:type="void"/>
2835           </return-value>
2836         </callback>
2837       </field>
2838       <field name="_g_reserved6" introspectable="0">
2839         <callback name="_g_reserved6">
2840           <return-value transfer-ownership="none">
2841             <type name="none" c:type="void"/>
2842           </return-value>
2843         </callback>
2844       </field>
2845     </record>
2846     <record name="ApplicationPrivate"
2847             c:type="GApplicationPrivate"
2848             disguised="1">
2849     </record>
2850     <bitfield name="AskPasswordFlags"
2851               glib:type-name="GAskPasswordFlags"
2852               glib:get-type="g_ask_password_flags_get_type"
2853               c:type="GAskPasswordFlags">
2854       <doc xml:whitespace="preserve">#GAskPasswordFlags are used to request specific information from the
2855 user, or to notify the user of their choices in an authentication
2856 situation.</doc>
2857       <member name="need_password"
2858               value="1"
2859               c:identifier="G_ASK_PASSWORD_NEED_PASSWORD"
2860               glib:nick="need-password"/>
2861       <member name="need_username"
2862               value="2"
2863               c:identifier="G_ASK_PASSWORD_NEED_USERNAME"
2864               glib:nick="need-username"/>
2865       <member name="need_domain"
2866               value="4"
2867               c:identifier="G_ASK_PASSWORD_NEED_DOMAIN"
2868               glib:nick="need-domain"/>
2869       <member name="saving_supported"
2870               value="8"
2871               c:identifier="G_ASK_PASSWORD_SAVING_SUPPORTED"
2872               glib:nick="saving-supported"/>
2873       <member name="anonymous_supported"
2874               value="16"
2875               c:identifier="G_ASK_PASSWORD_ANONYMOUS_SUPPORTED"
2876               glib:nick="anonymous-supported"/>
2877     </bitfield>
2878     <interface name="AsyncInitable"
2879                c:symbol-prefix="async_initable"
2880                c:type="GAsyncInitable"
2881                version="2.22"
2882                glib:type-name="GAsyncInitable"
2883                glib:get-type="g_async_initable_get_type"
2884                glib:type-struct="AsyncInitableIface">
2885       <doc xml:whitespace="preserve">Interface for asynchronously initializable objects.</doc>
2886       <virtual-method name="init_async" invoker="init_async" version="2.22">
2887         <doc xml:whitespace="preserve">Starts asynchronous initialization of the object implementing the
2888 interface. This must be done before any real use of the object after
2889 initial construction. If the object also implements #GInitable you can
2890 optionally call g_initable_init() instead.
2891 When the initialization is finished, @callback will be called. You can
2892 then call g_async_initable_init_finish() to get the result of the
2893 initialization.
2894 Implementations may also support cancellation. If @cancellable is not
2895 %NULL, then initialization can be cancelled by triggering the cancellable
2896 object from another thread. If the operation was cancelled, the error
2897 %G_IO_ERROR_CANCELLED will be returned. If @cancellable is not %NULL, and
2898 the object doesn't support cancellable initialization, the error
2899 %G_IO_ERROR_NOT_SUPPORTED will be returned.
2900 If this function is not called, or returns with an error, then all
2901 operations on the object should fail, generally returning the
2902 error %G_IO_ERROR_NOT_INITIALIZED.
2903 to this function with the same argument should return the same results.
2904 Only the first call initializes the object; further calls return the result
2905 of the first call. This is so that it's safe to implement the singleton
2906 pattern in the GObject constructor function.
2907 For classes that also support the #GInitable interface, the default
2908 implementation of this method will run the g_initable_init() function
2909 in a thread, so if you want to support asynchronous initialization via
2910 threads, just implement the #GAsyncInitable interface without overriding
2911 any interface methods.</doc>
2912         <return-value transfer-ownership="none">
2913           <type name="none" c:type="void"/>
2914         </return-value>
2915         <parameters>
2916           <parameter name="io_priority" transfer-ownership="none">
2917             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the operation.</doc>
2918             <type name="gint" c:type="int"/>
2919           </parameter>
2920           <parameter name="cancellable"
2921                      transfer-ownership="none"
2922                      allow-none="1">
2923             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
2924             <type name="Cancellable" c:type="GCancellable*"/>
2925           </parameter>
2926           <parameter name="callback"
2927                      transfer-ownership="none"
2928                      scope="async"
2929                      closure="3">
2930             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
2931             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
2932           </parameter>
2933           <parameter name="user_data" transfer-ownership="none" closure="3">
2934             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
2935             <type name="gpointer" c:type="gpointer"/>
2936           </parameter>
2937         </parameters>
2938       </virtual-method>
2939       <virtual-method name="init_finish"
2940                       invoker="init_finish"
2941                       version="2.22"
2942                       throws="1">
2943         <doc xml:whitespace="preserve">Finishes asynchronous initialization and returns the result.
2944 See g_async_initable_init_async().
2945 will return %FALSE and set @error appropriately if present.</doc>
2946         <return-value transfer-ownership="none">
2947           <doc xml:whitespace="preserve">%TRUE if successful. If an error has occurred, this function</doc>
2948           <type name="gboolean" c:type="gboolean"/>
2949         </return-value>
2950         <parameters>
2951           <parameter name="res" transfer-ownership="none">
2952             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
2953             <type name="AsyncResult" c:type="GAsyncResult*"/>
2954           </parameter>
2955         </parameters>
2956       </virtual-method>
2957       <method name="init_async"
2958               c:identifier="g_async_initable_init_async"
2959               version="2.22">
2960         <doc xml:whitespace="preserve">Starts asynchronous initialization of the object implementing the
2961 interface. This must be done before any real use of the object after
2962 initial construction. If the object also implements #GInitable you can
2963 optionally call g_initable_init() instead.
2964 When the initialization is finished, @callback will be called. You can
2965 then call g_async_initable_init_finish() to get the result of the
2966 initialization.
2967 Implementations may also support cancellation. If @cancellable is not
2968 %NULL, then initialization can be cancelled by triggering the cancellable
2969 object from another thread. If the operation was cancelled, the error
2970 %G_IO_ERROR_CANCELLED will be returned. If @cancellable is not %NULL, and
2971 the object doesn't support cancellable initialization, the error
2972 %G_IO_ERROR_NOT_SUPPORTED will be returned.
2973 If this function is not called, or returns with an error, then all
2974 operations on the object should fail, generally returning the
2975 error %G_IO_ERROR_NOT_INITIALIZED.
2976 to this function with the same argument should return the same results.
2977 Only the first call initializes the object; further calls return the result
2978 of the first call. This is so that it's safe to implement the singleton
2979 pattern in the GObject constructor function.
2980 For classes that also support the #GInitable interface, the default
2981 implementation of this method will run the g_initable_init() function
2982 in a thread, so if you want to support asynchronous initialization via
2983 threads, just implement the #GAsyncInitable interface without overriding
2984 any interface methods.</doc>
2985         <return-value transfer-ownership="none">
2986           <type name="none" c:type="void"/>
2987         </return-value>
2988         <parameters>
2989           <parameter name="io_priority" transfer-ownership="none">
2990             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the operation.</doc>
2991             <type name="gint" c:type="int"/>
2992           </parameter>
2993           <parameter name="cancellable"
2994                      transfer-ownership="none"
2995                      allow-none="1">
2996             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
2997             <type name="Cancellable" c:type="GCancellable*"/>
2998           </parameter>
2999           <parameter name="callback"
3000                      transfer-ownership="none"
3001                      scope="async"
3002                      closure="3">
3003             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
3004             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
3005           </parameter>
3006           <parameter name="user_data" transfer-ownership="none">
3007             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
3008             <type name="gpointer" c:type="gpointer"/>
3009           </parameter>
3010         </parameters>
3011       </method>
3012       <method name="init_finish"
3013               c:identifier="g_async_initable_init_finish"
3014               version="2.22"
3015               throws="1">
3016         <doc xml:whitespace="preserve">Finishes asynchronous initialization and returns the result.
3017 See g_async_initable_init_async().
3018 will return %FALSE and set @error appropriately if present.</doc>
3019         <return-value transfer-ownership="none">
3020           <doc xml:whitespace="preserve">%TRUE if successful. If an error has occurred, this function</doc>
3021           <type name="gboolean" c:type="gboolean"/>
3022         </return-value>
3023         <parameters>
3024           <parameter name="res" transfer-ownership="none">
3025             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
3026             <type name="AsyncResult" c:type="GAsyncResult*"/>
3027           </parameter>
3028         </parameters>
3029       </method>
3030       <method name="new_finish"
3031               c:identifier="g_async_initable_new_finish"
3032               version="2.22"
3033               throws="1">
3034         <doc xml:whitespace="preserve">Finishes the async construction for the various g_async_initable_new calls,
3035 returning the created object or %NULL on error.
3036 g_object_unref().</doc>
3037         <return-value transfer-ownership="full">
3038           <doc xml:whitespace="preserve">a newly created #GObject, or %NULL on error. Free with</doc>
3039           <type name="GObject.Object" c:type="GObject*"/>
3040         </return-value>
3041         <parameters>
3042           <parameter name="res" transfer-ownership="none">
3043             <doc xml:whitespace="preserve">the #GAsyncResult.from the callback</doc>
3044             <type name="AsyncResult" c:type="GAsyncResult*"/>
3045           </parameter>
3046         </parameters>
3047       </method>
3048     </interface>
3049     <record name="AsyncInitableIface"
3050             c:type="GAsyncInitableIface"
3051             glib:is-gtype-struct-for="AsyncInitable"
3052             version="2.22">
3053       <doc xml:whitespace="preserve">Provides an interface for asynchronous initializing object such that
3054 initialization may fail.</doc>
3055       <field name="g_iface">
3056         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
3057       </field>
3058       <field name="init_async">
3059         <callback name="init_async">
3060           <return-value transfer-ownership="none">
3061             <type name="none" c:type="void"/>
3062           </return-value>
3063           <parameters>
3064             <parameter name="initable" transfer-ownership="none">
3065               <type name="AsyncInitable" c:type="GAsyncInitable*"/>
3066             </parameter>
3067             <parameter name="io_priority" transfer-ownership="none">
3068               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the operation.</doc>
3069               <type name="gint" c:type="int"/>
3070             </parameter>
3071             <parameter name="cancellable"
3072                        transfer-ownership="none"
3073                        allow-none="1">
3074               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
3075               <type name="Cancellable" c:type="GCancellable*"/>
3076             </parameter>
3077             <parameter name="callback"
3078                        transfer-ownership="none"
3079                        scope="async"
3080                        closure="4">
3081               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
3082               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
3083             </parameter>
3084             <parameter name="user_data" transfer-ownership="none" closure="4">
3085               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
3086               <type name="gpointer" c:type="gpointer"/>
3087             </parameter>
3088           </parameters>
3089         </callback>
3090       </field>
3091       <field name="init_finish">
3092         <callback name="init_finish" throws="1">
3093           <return-value transfer-ownership="none">
3094             <doc xml:whitespace="preserve">%TRUE if successful. If an error has occurred, this function</doc>
3095             <type name="gboolean" c:type="gboolean"/>
3096           </return-value>
3097           <parameters>
3098             <parameter name="initable" transfer-ownership="none">
3099               <type name="AsyncInitable" c:type="GAsyncInitable*"/>
3100             </parameter>
3101             <parameter name="res" transfer-ownership="none">
3102               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
3103               <type name="AsyncResult" c:type="GAsyncResult*"/>
3104             </parameter>
3105           </parameters>
3106         </callback>
3107       </field>
3108     </record>
3109     <callback name="AsyncReadyCallback" c:type="GAsyncReadyCallback">
3110       <doc xml:whitespace="preserve">Type definition for a function that will be called back when an asynchronous
3111 operation within GIO has been completed.</doc>
3112       <return-value transfer-ownership="none">
3113         <type name="none" c:type="void"/>
3114       </return-value>
3115       <parameters>
3116         <parameter name="source_object" transfer-ownership="none">
3117           <doc xml:whitespace="preserve">the object the asynchronous operation was started with.</doc>
3118           <type name="GObject.Object" c:type="GObject*"/>
3119         </parameter>
3120         <parameter name="res" transfer-ownership="none">
3121           <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
3122           <type name="AsyncResult" c:type="GAsyncResult*"/>
3123         </parameter>
3124         <parameter name="user_data" transfer-ownership="none" closure="2">
3125           <doc xml:whitespace="preserve">user data passed to the callback.</doc>
3126           <type name="gpointer" c:type="gpointer"/>
3127         </parameter>
3128       </parameters>
3129     </callback>
3130     <interface name="AsyncResult"
3131                c:symbol-prefix="async_result"
3132                c:type="GAsyncResult"
3133                glib:type-name="GAsyncResult"
3134                glib:get-type="g_async_result_get_type"
3135                glib:type-struct="AsyncResultIface">
3136       <doc xml:whitespace="preserve">Holds results information for an asynchronous operation,
3137 usually passed directly to a asynchronous _finish() operation.</doc>
3138       <virtual-method name="get_source_object" invoker="get_source_object">
3139         <doc xml:whitespace="preserve">Gets the source object from a #GAsyncResult.
3140 or %NULL if there is none.</doc>
3141         <return-value transfer-ownership="full">
3142           <doc xml:whitespace="preserve">a new reference to the source object for the @res,</doc>
3143           <type name="GObject.Object" c:type="GObject*"/>
3144         </return-value>
3145       </virtual-method>
3146       <virtual-method name="get_user_data" invoker="get_user_data">
3147         <doc xml:whitespace="preserve">Gets the user data from a #GAsyncResult.</doc>
3148         <return-value transfer-ownership="full">
3149           <doc xml:whitespace="preserve">the user data for @res.</doc>
3150           <type name="gpointer" c:type="gpointer"/>
3151         </return-value>
3152       </virtual-method>
3153       <method name="get_source_object"
3154               c:identifier="g_async_result_get_source_object">
3155         <doc xml:whitespace="preserve">Gets the source object from a #GAsyncResult.
3156 or %NULL if there is none.</doc>
3157         <return-value transfer-ownership="full">
3158           <doc xml:whitespace="preserve">a new reference to the source object for the @res,</doc>
3159           <type name="GObject.Object" c:type="GObject*"/>
3160         </return-value>
3161       </method>
3162       <method name="get_user_data" c:identifier="g_async_result_get_user_data">
3163         <doc xml:whitespace="preserve">Gets the user data from a #GAsyncResult.</doc>
3164         <return-value transfer-ownership="full">
3165           <doc xml:whitespace="preserve">the user data for @res.</doc>
3166           <type name="gpointer" c:type="gpointer"/>
3167         </return-value>
3168       </method>
3169     </interface>
3170     <record name="AsyncResultIface"
3171             c:type="GAsyncResultIface"
3172             glib:is-gtype-struct-for="AsyncResult">
3173       <doc xml:whitespace="preserve">Interface definition for #GAsyncResult.</doc>
3174       <field name="g_iface">
3175         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
3176       </field>
3177       <field name="get_user_data">
3178         <callback name="get_user_data">
3179           <return-value transfer-ownership="full">
3180             <doc xml:whitespace="preserve">the user data for @res.</doc>
3181             <type name="gpointer" c:type="gpointer"/>
3182           </return-value>
3183           <parameters>
3184             <parameter name="async_result" transfer-ownership="none">
3185               <type name="AsyncResult" c:type="GAsyncResult*"/>
3186             </parameter>
3187           </parameters>
3188         </callback>
3189       </field>
3190       <field name="get_source_object">
3191         <callback name="get_source_object">
3192           <return-value transfer-ownership="full">
3193             <doc xml:whitespace="preserve">a new reference to the source object for the @res,</doc>
3194             <type name="GObject.Object" c:type="GObject*"/>
3195           </return-value>
3196           <parameters>
3197             <parameter name="async_result" transfer-ownership="none">
3198               <type name="AsyncResult" c:type="GAsyncResult*"/>
3199             </parameter>
3200           </parameters>
3201         </callback>
3202       </field>
3203     </record>
3204     <class name="BufferedInputStream"
3205            c:symbol-prefix="buffered_input_stream"
3206            c:type="GBufferedInputStream"
3207            parent="FilterInputStream"
3208            glib:type-name="GBufferedInputStream"
3209            glib:get-type="g_buffered_input_stream_get_type"
3210            glib:type-struct="BufferedInputStreamClass">
3211       <doc xml:whitespace="preserve">Implements #GFilterInputStream with a sized input buffer.</doc>
3212       <constructor name="new" c:identifier="g_buffered_input_stream_new">
3213         <doc xml:whitespace="preserve">Creates a new #GInputStream from the given @base_stream, with
3214 a buffer set to the default size (4 kilobytes).</doc>
3215         <return-value transfer-ownership="full">
3216           <doc xml:whitespace="preserve">a #GInputStream for the given @base_stream.</doc>
3217           <type name="InputStream" c:type="GInputStream*"/>
3218         </return-value>
3219         <parameters>
3220           <parameter name="base_stream" transfer-ownership="none">
3221             <doc xml:whitespace="preserve">a #GInputStream</doc>
3222             <type name="InputStream" c:type="GInputStream*"/>
3223           </parameter>
3224         </parameters>
3225       </constructor>
3226       <constructor name="new_sized"
3227                    c:identifier="g_buffered_input_stream_new_sized">
3228         <doc xml:whitespace="preserve">Creates a new #GBufferedInputStream from the given @base_stream,
3229 with a buffer set to @size.</doc>
3230         <return-value transfer-ownership="full">
3231           <doc xml:whitespace="preserve">a #GInputStream.</doc>
3232           <type name="InputStream" c:type="GInputStream*"/>
3233         </return-value>
3234         <parameters>
3235           <parameter name="base_stream" transfer-ownership="none">
3236             <doc xml:whitespace="preserve">a #GInputStream</doc>
3237             <type name="InputStream" c:type="GInputStream*"/>
3238           </parameter>
3239           <parameter name="size" transfer-ownership="none">
3240             <doc xml:whitespace="preserve">a #gsize</doc>
3241             <type name="gulong" c:type="gsize"/>
3242           </parameter>
3243         </parameters>
3244       </constructor>
3245       <virtual-method name="fill" invoker="fill" throws="1">
3246         <doc xml:whitespace="preserve">Tries to read @count bytes from the stream into the buffer.
3247 Will block during this read.
3248 If @count is zero, returns zero and does nothing. A value of @count
3249 larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
3250 On success, the number of bytes read into the buffer is returned.
3251 It is not an error if this is not the same as the requested size, as it
3252 can happen e.g. near the end of a file. Zero is returned on end of file
3253 (or if @count is zero),  but never otherwise.
3254 If @count is -1 then the attempted read size is equal to the number of
3255 bytes that are required to fill the buffer.
3256 If @cancellable is not %NULL, then the operation can be cancelled by
3257 triggering the cancellable object from another thread. If the operation
3258 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
3259 operation was partially finished when the operation was cancelled the
3260 partial result will be returned, without an error.
3261 On error -1 is returned and @error is set accordingly.
3262 For the asynchronous, non-blocking, version of this function, see
3263 g_buffered_input_stream_fill_async().
3264 or -1 on error.</doc>
3265         <return-value transfer-ownership="none">
3266           <doc xml:whitespace="preserve">the number of bytes read into @stream's buffer, up to @count,</doc>
3267           <type name="glong" c:type="gssize"/>
3268         </return-value>
3269         <parameters>
3270           <parameter name="count" transfer-ownership="none">
3271             <doc xml:whitespace="preserve">the number of bytes that will be read from the stream</doc>
3272             <type name="glong" c:type="gssize"/>
3273           </parameter>
3274           <parameter name="cancellable"
3275                      transfer-ownership="none"
3276                      allow-none="1">
3277             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
3278             <type name="Cancellable" c:type="GCancellable*"/>
3279           </parameter>
3280         </parameters>
3281       </virtual-method>
3282       <virtual-method name="fill_async" invoker="fill_async">
3283         <doc xml:whitespace="preserve">Reads data into @stream's buffer asynchronously, up to @count size.
3284 version of this function, see g_buffered_input_stream_fill().
3285 If @count is -1 then the attempted read size is equal to the number
3286 of bytes that are required to fill the buffer.</doc>
3287         <return-value transfer-ownership="none">
3288           <type name="none" c:type="void"/>
3289         </return-value>
3290         <parameters>
3291           <parameter name="count" transfer-ownership="none">
3292             <doc xml:whitespace="preserve">the number of bytes that will be read from the stream</doc>
3293             <type name="glong" c:type="gssize"/>
3294           </parameter>
3295           <parameter name="io_priority" transfer-ownership="none">
3296             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request</doc>
3297             <type name="gint" c:type="int"/>
3298           </parameter>
3299           <parameter name="cancellable"
3300                      transfer-ownership="none"
3301                      allow-none="1">
3302             <doc xml:whitespace="preserve">optional #GCancellable object</doc>
3303             <type name="Cancellable" c:type="GCancellable*"/>
3304           </parameter>
3305           <parameter name="callback"
3306                      transfer-ownership="none"
3307                      scope="async"
3308                      closure="4">
3309             <doc xml:whitespace="preserve">a #GAsyncReadyCallback</doc>
3310             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
3311           </parameter>
3312           <parameter name="user_data" transfer-ownership="none" closure="4">
3313             <doc xml:whitespace="preserve">a #gpointer</doc>
3314             <type name="gpointer" c:type="gpointer"/>
3315           </parameter>
3316         </parameters>
3317       </virtual-method>
3318       <virtual-method name="fill_finish" invoker="fill_finish" throws="1">
3319         <doc xml:whitespace="preserve">Finishes an asynchronous read.</doc>
3320         <return-value transfer-ownership="none">
3321           <doc xml:whitespace="preserve">a #gssize of the read stream, or %-1 on an error.</doc>
3322           <type name="glong" c:type="gssize"/>
3323         </return-value>
3324         <parameters>
3325           <parameter name="result" transfer-ownership="none">
3326             <doc xml:whitespace="preserve">a #GAsyncResult</doc>
3327             <type name="AsyncResult" c:type="GAsyncResult*"/>
3328           </parameter>
3329         </parameters>
3330       </virtual-method>
3331       <method name="fill"
3332               c:identifier="g_buffered_input_stream_fill"
3333               throws="1">
3334         <doc xml:whitespace="preserve">Tries to read @count bytes from the stream into the buffer.
3335 Will block during this read.
3336 If @count is zero, returns zero and does nothing. A value of @count
3337 larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
3338 On success, the number of bytes read into the buffer is returned.
3339 It is not an error if this is not the same as the requested size, as it
3340 can happen e.g. near the end of a file. Zero is returned on end of file
3341 (or if @count is zero),  but never otherwise.
3342 If @count is -1 then the attempted read size is equal to the number of
3343 bytes that are required to fill the buffer.
3344 If @cancellable is not %NULL, then the operation can be cancelled by
3345 triggering the cancellable object from another thread. If the operation
3346 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
3347 operation was partially finished when the operation was cancelled the
3348 partial result will be returned, without an error.
3349 On error -1 is returned and @error is set accordingly.
3350 For the asynchronous, non-blocking, version of this function, see
3351 g_buffered_input_stream_fill_async().
3352 or -1 on error.</doc>
3353         <return-value transfer-ownership="none">
3354           <doc xml:whitespace="preserve">the number of bytes read into @stream's buffer, up to @count,</doc>
3355           <type name="glong" c:type="gssize"/>
3356         </return-value>
3357         <parameters>
3358           <parameter name="count" transfer-ownership="none">
3359             <doc xml:whitespace="preserve">the number of bytes that will be read from the stream</doc>
3360             <type name="glong" c:type="gssize"/>
3361           </parameter>
3362           <parameter name="cancellable"
3363                      transfer-ownership="none"
3364                      allow-none="1">
3365             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
3366             <type name="Cancellable" c:type="GCancellable*"/>
3367           </parameter>
3368         </parameters>
3369       </method>
3370       <method name="fill_async"
3371               c:identifier="g_buffered_input_stream_fill_async">
3372         <doc xml:whitespace="preserve">Reads data into @stream's buffer asynchronously, up to @count size.
3373 version of this function, see g_buffered_input_stream_fill().
3374 If @count is -1 then the attempted read size is equal to the number
3375 of bytes that are required to fill the buffer.</doc>
3376         <return-value transfer-ownership="none">
3377           <type name="none" c:type="void"/>
3378         </return-value>
3379         <parameters>
3380           <parameter name="count" transfer-ownership="none">
3381             <doc xml:whitespace="preserve">the number of bytes that will be read from the stream</doc>
3382             <type name="glong" c:type="gssize"/>
3383           </parameter>
3384           <parameter name="io_priority" transfer-ownership="none">
3385             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request</doc>
3386             <type name="gint" c:type="int"/>
3387           </parameter>
3388           <parameter name="cancellable"
3389                      transfer-ownership="none"
3390                      allow-none="1">
3391             <doc xml:whitespace="preserve">optional #GCancellable object</doc>
3392             <type name="Cancellable" c:type="GCancellable*"/>
3393           </parameter>
3394           <parameter name="callback"
3395                      transfer-ownership="none"
3396                      scope="async"
3397                      closure="4">
3398             <doc xml:whitespace="preserve">a #GAsyncReadyCallback</doc>
3399             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
3400           </parameter>
3401           <parameter name="user_data" transfer-ownership="none">
3402             <doc xml:whitespace="preserve">a #gpointer</doc>
3403             <type name="gpointer" c:type="gpointer"/>
3404           </parameter>
3405         </parameters>
3406       </method>
3407       <method name="fill_finish"
3408               c:identifier="g_buffered_input_stream_fill_finish"
3409               throws="1">
3410         <doc xml:whitespace="preserve">Finishes an asynchronous read.</doc>
3411         <return-value transfer-ownership="none">
3412           <doc xml:whitespace="preserve">a #gssize of the read stream, or %-1 on an error.</doc>
3413           <type name="glong" c:type="gssize"/>
3414         </return-value>
3415         <parameters>
3416           <parameter name="result" transfer-ownership="none">
3417             <doc xml:whitespace="preserve">a #GAsyncResult</doc>
3418             <type name="AsyncResult" c:type="GAsyncResult*"/>
3419           </parameter>
3420         </parameters>
3421       </method>
3422       <method name="get_available"
3423               c:identifier="g_buffered_input_stream_get_available">
3424         <doc xml:whitespace="preserve">Gets the size of the available data within the stream.</doc>
3425         <return-value transfer-ownership="none">
3426           <doc xml:whitespace="preserve">size of the available stream.</doc>
3427           <type name="gulong" c:type="gsize"/>
3428         </return-value>
3429       </method>
3430       <method name="get_buffer_size"
3431               c:identifier="g_buffered_input_stream_get_buffer_size">
3432         <doc xml:whitespace="preserve">Gets the size of the input buffer.</doc>
3433         <return-value transfer-ownership="none">
3434           <doc xml:whitespace="preserve">the current buffer size.</doc>
3435           <type name="gulong" c:type="gsize"/>
3436         </return-value>
3437       </method>
3438       <method name="peek" c:identifier="g_buffered_input_stream_peek">
3439         <doc xml:whitespace="preserve">Peeks in the buffer, copying data of size @count into @buffer,
3440 offset @offset bytes.</doc>
3441         <return-value transfer-ownership="none">
3442           <doc xml:whitespace="preserve">a #gsize of the number of bytes peeked, or -1 on error.</doc>
3443           <type name="gulong" c:type="gsize"/>
3444         </return-value>
3445         <parameters>
3446           <parameter name="buffer" transfer-ownership="none">
3447             <doc xml:whitespace="preserve">a pointer to an allocated chunk of memory</doc>
3448             <type name="gpointer" c:type="void*"/>
3449           </parameter>
3450           <parameter name="offset" transfer-ownership="none">
3451             <doc xml:whitespace="preserve">a #gsize</doc>
3452             <type name="gulong" c:type="gsize"/>
3453           </parameter>
3454           <parameter name="count" transfer-ownership="none">
3455             <doc xml:whitespace="preserve">a #gsize</doc>
3456             <type name="gulong" c:type="gsize"/>
3457           </parameter>
3458         </parameters>
3459       </method>
3460       <method name="peek_buffer"
3461               c:identifier="g_buffered_input_stream_peek_buffer">
3462         <doc xml:whitespace="preserve">Returns the buffer with the currently available bytes. The returned
3463 buffer must not be modified and will become invalid when reading from
3464 the stream or filling the buffer.</doc>
3465         <return-value transfer-ownership="none">
3466           <doc xml:whitespace="preserve">read-only buffer</doc>
3467           <type name="gpointer" c:type="void*"/>
3468         </return-value>
3469         <parameters>
3470           <parameter name="count" transfer-ownership="none">
3471             <doc xml:whitespace="preserve">a #gsize to get the number of bytes available in the buffer</doc>
3472             <type name="gulong" c:type="gsize*"/>
3473           </parameter>
3474         </parameters>
3475       </method>
3476       <method name="read_byte"
3477               c:identifier="g_buffered_input_stream_read_byte"
3478               throws="1">
3479         <doc xml:whitespace="preserve">Tries to read a single byte from the stream or the buffer. Will block
3480 during this read.
3481 On success, the byte read from the stream is returned. On end of stream
3482 -1 is returned but it's not an exceptional error and @error is not set.
3483 If @cancellable is not %NULL, then the operation can be cancelled by
3484 triggering the cancellable object from another thread. If the operation
3485 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
3486 operation was partially finished when the operation was cancelled the
3487 partial result will be returned, without an error.
3488 On error -1 is returned and @error is set accordingly.</doc>
3489         <return-value transfer-ownership="none">
3490           <doc xml:whitespace="preserve">the byte read from the @stream, or -1 on end of stream or error.</doc>
3491           <type name="gint" c:type="int"/>
3492         </return-value>
3493         <parameters>
3494           <parameter name="cancellable"
3495                      transfer-ownership="none"
3496                      allow-none="1">
3497             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
3498             <type name="Cancellable" c:type="GCancellable*"/>
3499           </parameter>
3500         </parameters>
3501       </method>
3502       <method name="set_buffer_size"
3503               c:identifier="g_buffered_input_stream_set_buffer_size">
3504         <doc xml:whitespace="preserve">Sets the size of the internal buffer of @stream to @size, or to the
3505 size of the contents of the buffer. The buffer can never be resized
3506 smaller than its current contents.</doc>
3507         <return-value transfer-ownership="none">
3508           <type name="none" c:type="void"/>
3509         </return-value>
3510         <parameters>
3511           <parameter name="size" transfer-ownership="none">
3512             <doc xml:whitespace="preserve">a #gsize</doc>
3513             <type name="gulong" c:type="gsize"/>
3514           </parameter>
3515         </parameters>
3516       </method>
3517       <property name="buffer-size"
3518                 writable="1"
3519                 construct="1"
3520                 transfer-ownership="none">
3521         <type name="guint"/>
3522       </property>
3523       <field name="parent_instance">
3524         <type name="FilterInputStream" c:type="GFilterInputStream"/>
3525       </field>
3526       <field name="priv">
3527         <type name="BufferedInputStreamPrivate"
3528               c:type="GBufferedInputStreamPrivate*"/>
3529       </field>
3530     </class>
3531     <record name="BufferedInputStreamClass"
3532             c:type="GBufferedInputStreamClass"
3533             glib:is-gtype-struct-for="BufferedInputStream">
3534       <field name="parent_class">
3535         <type name="FilterInputStreamClass" c:type="GFilterInputStreamClass"/>
3536       </field>
3537       <field name="fill">
3538         <callback name="fill" throws="1">
3539           <return-value transfer-ownership="none">
3540             <doc xml:whitespace="preserve">the number of bytes read into @stream's buffer, up to @count,</doc>
3541             <type name="glong" c:type="gssize"/>
3542           </return-value>
3543           <parameters>
3544             <parameter name="stream" transfer-ownership="none">
3545               <type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
3546             </parameter>
3547             <parameter name="count" transfer-ownership="none">
3548               <doc xml:whitespace="preserve">the number of bytes that will be read from the stream</doc>
3549               <type name="glong" c:type="gssize"/>
3550             </parameter>
3551             <parameter name="cancellable"
3552                        transfer-ownership="none"
3553                        allow-none="1">
3554               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
3555               <type name="Cancellable" c:type="GCancellable*"/>
3556             </parameter>
3557           </parameters>
3558         </callback>
3559       </field>
3560       <field name="fill_async">
3561         <callback name="fill_async">
3562           <return-value transfer-ownership="none">
3563             <type name="none" c:type="void"/>
3564           </return-value>
3565           <parameters>
3566             <parameter name="stream" transfer-ownership="none">
3567               <type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
3568             </parameter>
3569             <parameter name="count" transfer-ownership="none">
3570               <doc xml:whitespace="preserve">the number of bytes that will be read from the stream</doc>
3571               <type name="glong" c:type="gssize"/>
3572             </parameter>
3573             <parameter name="io_priority" transfer-ownership="none">
3574               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request</doc>
3575               <type name="gint" c:type="int"/>
3576             </parameter>
3577             <parameter name="cancellable"
3578                        transfer-ownership="none"
3579                        allow-none="1">
3580               <doc xml:whitespace="preserve">optional #GCancellable object</doc>
3581               <type name="Cancellable" c:type="GCancellable*"/>
3582             </parameter>
3583             <parameter name="callback"
3584                        transfer-ownership="none"
3585                        scope="async"
3586                        closure="5">
3587               <doc xml:whitespace="preserve">a #GAsyncReadyCallback</doc>
3588               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
3589             </parameter>
3590             <parameter name="user_data" transfer-ownership="none" closure="5">
3591               <doc xml:whitespace="preserve">a #gpointer</doc>
3592               <type name="gpointer" c:type="gpointer"/>
3593             </parameter>
3594           </parameters>
3595         </callback>
3596       </field>
3597       <field name="fill_finish">
3598         <callback name="fill_finish" throws="1">
3599           <return-value transfer-ownership="none">
3600             <doc xml:whitespace="preserve">a #gssize of the read stream, or %-1 on an error.</doc>
3601             <type name="glong" c:type="gssize"/>
3602           </return-value>
3603           <parameters>
3604             <parameter name="stream" transfer-ownership="none">
3605               <type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
3606             </parameter>
3607             <parameter name="result" transfer-ownership="none">
3608               <doc xml:whitespace="preserve">a #GAsyncResult</doc>
3609               <type name="AsyncResult" c:type="GAsyncResult*"/>
3610             </parameter>
3611           </parameters>
3612         </callback>
3613       </field>
3614       <field name="_g_reserved1" introspectable="0">
3615         <callback name="_g_reserved1">
3616           <return-value transfer-ownership="none">
3617             <type name="none" c:type="void"/>
3618           </return-value>
3619         </callback>
3620       </field>
3621       <field name="_g_reserved2" introspectable="0">
3622         <callback name="_g_reserved2">
3623           <return-value transfer-ownership="none">
3624             <type name="none" c:type="void"/>
3625           </return-value>
3626         </callback>
3627       </field>
3628       <field name="_g_reserved3" introspectable="0">
3629         <callback name="_g_reserved3">
3630           <return-value transfer-ownership="none">
3631             <type name="none" c:type="void"/>
3632           </return-value>
3633         </callback>
3634       </field>
3635       <field name="_g_reserved4" introspectable="0">
3636         <callback name="_g_reserved4">
3637           <return-value transfer-ownership="none">
3638             <type name="none" c:type="void"/>
3639           </return-value>
3640         </callback>
3641       </field>
3642       <field name="_g_reserved5" introspectable="0">
3643         <callback name="_g_reserved5">
3644           <return-value transfer-ownership="none">
3645             <type name="none" c:type="void"/>
3646           </return-value>
3647         </callback>
3648       </field>
3649     </record>
3650     <record name="BufferedInputStreamPrivate"
3651             c:type="GBufferedInputStreamPrivate"
3652             disguised="1">
3653     </record>
3654     <class name="BufferedOutputStream"
3655            c:symbol-prefix="buffered_output_stream"
3656            c:type="GBufferedOutputStream"
3657            parent="FilterOutputStream"
3658            glib:type-name="GBufferedOutputStream"
3659            glib:get-type="g_buffered_output_stream_get_type"
3660            glib:type-struct="BufferedOutputStreamClass">
3661       <doc xml:whitespace="preserve">An implementation of #GFilterOutputStream with a sized buffer.</doc>
3662       <constructor name="new" c:identifier="g_buffered_output_stream_new">
3663         <doc xml:whitespace="preserve">Creates a new buffered output stream for a base stream.</doc>
3664         <return-value transfer-ownership="full">
3665           <doc xml:whitespace="preserve">a #GOutputStream for the given @base_stream.</doc>
3666           <type name="OutputStream" c:type="GOutputStream*"/>
3667         </return-value>
3668         <parameters>
3669           <parameter name="base_stream" transfer-ownership="none">
3670             <doc xml:whitespace="preserve">a #GOutputStream.</doc>
3671             <type name="OutputStream" c:type="GOutputStream*"/>
3672           </parameter>
3673         </parameters>
3674       </constructor>
3675       <constructor name="new_sized"
3676                    c:identifier="g_buffered_output_stream_new_sized">
3677         <doc xml:whitespace="preserve">Creates a new buffered output stream with a given buffer size.</doc>
3678         <return-value transfer-ownership="full">
3679           <doc xml:whitespace="preserve">a #GOutputStream with an internal buffer set to @size.</doc>
3680           <type name="OutputStream" c:type="GOutputStream*"/>
3681         </return-value>
3682         <parameters>
3683           <parameter name="base_stream" transfer-ownership="none">
3684             <doc xml:whitespace="preserve">a #GOutputStream.</doc>
3685             <type name="OutputStream" c:type="GOutputStream*"/>
3686           </parameter>
3687           <parameter name="size" transfer-ownership="none">
3688             <doc xml:whitespace="preserve">a #gsize.</doc>
3689             <type name="gulong" c:type="gsize"/>
3690           </parameter>
3691         </parameters>
3692       </constructor>
3693       <method name="get_auto_grow"
3694               c:identifier="g_buffered_output_stream_get_auto_grow">
3695         <doc xml:whitespace="preserve">Checks if the buffer automatically grows as data is added.
3696 %FALSE otherwise.</doc>
3697         <return-value transfer-ownership="none">
3698           <doc xml:whitespace="preserve">%TRUE if the @stream's buffer automatically grows,</doc>
3699           <type name="gboolean" c:type="gboolean"/>
3700         </return-value>
3701       </method>
3702       <method name="get_buffer_size"
3703               c:identifier="g_buffered_output_stream_get_buffer_size">
3704         <doc xml:whitespace="preserve">Gets the size of the buffer in the @stream.</doc>
3705         <return-value transfer-ownership="none">
3706           <doc xml:whitespace="preserve">the current size of the buffer.</doc>
3707           <type name="gulong" c:type="gsize"/>
3708         </return-value>
3709       </method>
3710       <method name="set_auto_grow"
3711               c:identifier="g_buffered_output_stream_set_auto_grow">
3712         <doc xml:whitespace="preserve">Sets whether or not the @stream's buffer should automatically grow.
3713 If @auto_grow is true, then each write will just make the buffer
3714 larger, and you must manually flush the buffer to actually write out
3715 the data to the underlying stream.</doc>
3716         <return-value transfer-ownership="none">
3717           <type name="none" c:type="void"/>
3718         </return-value>
3719         <parameters>
3720           <parameter name="auto_grow" transfer-ownership="none">
3721             <doc xml:whitespace="preserve">a #gboolean.</doc>
3722             <type name="gboolean" c:type="gboolean"/>
3723           </parameter>
3724         </parameters>
3725       </method>
3726       <method name="set_buffer_size"
3727               c:identifier="g_buffered_output_stream_set_buffer_size">
3728         <doc xml:whitespace="preserve">Sets the size of the internal buffer to @size.</doc>
3729         <return-value transfer-ownership="none">
3730           <type name="none" c:type="void"/>
3731         </return-value>
3732         <parameters>
3733           <parameter name="size" transfer-ownership="none">
3734             <doc xml:whitespace="preserve">a #gsize.</doc>
3735             <type name="gulong" c:type="gsize"/>
3736           </parameter>
3737         </parameters>
3738       </method>
3739       <property name="auto-grow" writable="1" transfer-ownership="none">
3740         <type name="gboolean"/>
3741       </property>
3742       <property name="buffer-size"
3743                 writable="1"
3744                 construct="1"
3745                 transfer-ownership="none">
3746         <type name="guint"/>
3747       </property>
3748       <field name="parent_instance">
3749         <type name="FilterOutputStream" c:type="GFilterOutputStream"/>
3750       </field>
3751       <field name="priv">
3752         <type name="BufferedOutputStreamPrivate"
3753               c:type="GBufferedOutputStreamPrivate*"/>
3754       </field>
3755     </class>
3756     <record name="BufferedOutputStreamClass"
3757             c:type="GBufferedOutputStreamClass"
3758             glib:is-gtype-struct-for="BufferedOutputStream">
3759       <field name="parent_class">
3760         <type name="FilterOutputStreamClass"
3761               c:type="GFilterOutputStreamClass"/>
3762       </field>
3763       <field name="_g_reserved1" introspectable="0">
3764         <callback name="_g_reserved1">
3765           <return-value transfer-ownership="none">
3766             <type name="none" c:type="void"/>
3767           </return-value>
3768         </callback>
3769       </field>
3770       <field name="_g_reserved2" introspectable="0">
3771         <callback name="_g_reserved2">
3772           <return-value transfer-ownership="none">
3773             <type name="none" c:type="void"/>
3774           </return-value>
3775         </callback>
3776       </field>
3777     </record>
3778     <record name="BufferedOutputStreamPrivate"
3779             c:type="GBufferedOutputStreamPrivate"
3780             disguised="1">
3781     </record>
3782     <callback name="BusAcquiredCallback"
3783               c:type="GBusAcquiredCallback"
3784               version="2.26">
3785       <doc xml:whitespace="preserve">Invoked when a connection to a message bus has been obtained.</doc>
3786       <return-value transfer-ownership="none">
3787         <type name="none" c:type="void"/>
3788       </return-value>
3789       <parameters>
3790         <parameter name="connection" transfer-ownership="none">
3791           <doc xml:whitespace="preserve">The #GDBusConnection to a message bus.</doc>
3792           <type name="DBusConnection" c:type="GDBusConnection*"/>
3793         </parameter>
3794         <parameter name="name" transfer-ownership="none">
3795           <doc xml:whitespace="preserve">The name that is requested to be owned.</doc>
3796           <type name="utf8" c:type="gchar*"/>
3797         </parameter>
3798         <parameter name="user_data" transfer-ownership="none" closure="2">
3799           <doc xml:whitespace="preserve">User data passed to g_bus_own_name().</doc>
3800           <type name="gpointer" c:type="gpointer"/>
3801         </parameter>
3802       </parameters>
3803     </callback>
3804     <callback name="BusNameAcquiredCallback"
3805               c:type="GBusNameAcquiredCallback"
3806               version="2.26">
3807       <doc xml:whitespace="preserve">Invoked when the name is acquired.</doc>
3808       <return-value transfer-ownership="none">
3809         <type name="none" c:type="void"/>
3810       </return-value>
3811       <parameters>
3812         <parameter name="connection" transfer-ownership="none">
3813           <doc xml:whitespace="preserve">The #GDBusConnection on which to acquired the name.</doc>
3814           <type name="DBusConnection" c:type="GDBusConnection*"/>
3815         </parameter>
3816         <parameter name="name" transfer-ownership="none">
3817           <doc xml:whitespace="preserve">The name being owned.</doc>
3818           <type name="utf8" c:type="gchar*"/>
3819         </parameter>
3820         <parameter name="user_data" transfer-ownership="none" closure="2">
3821           <doc xml:whitespace="preserve">User data passed to g_bus_own_name() or g_bus_own_name_on_connection().</doc>
3822           <type name="gpointer" c:type="gpointer"/>
3823         </parameter>
3824       </parameters>
3825     </callback>
3826     <callback name="BusNameAppearedCallback"
3827               c:type="GBusNameAppearedCallback"
3828               version="2.26">
3829       <doc xml:whitespace="preserve">Invoked when the name being watched is known to have to have a owner.</doc>
3830       <return-value transfer-ownership="none">
3831         <type name="none" c:type="void"/>
3832       </return-value>
3833       <parameters>
3834         <parameter name="connection" transfer-ownership="none">
3835           <doc xml:whitespace="preserve">The #GDBusConnection the name is being watched on.</doc>
3836           <type name="DBusConnection" c:type="GDBusConnection*"/>
3837         </parameter>
3838         <parameter name="name" transfer-ownership="none">
3839           <doc xml:whitespace="preserve">The name being watched.</doc>
3840           <type name="utf8" c:type="gchar*"/>
3841         </parameter>
3842         <parameter name="name_owner" transfer-ownership="none">
3843           <doc xml:whitespace="preserve">Unique name of the owner of the name being watched.</doc>
3844           <type name="utf8" c:type="gchar*"/>
3845         </parameter>
3846         <parameter name="user_data" transfer-ownership="none" closure="3">
3847           <doc xml:whitespace="preserve">User data passed to g_bus_watch_name().</doc>
3848           <type name="gpointer" c:type="gpointer"/>
3849         </parameter>
3850       </parameters>
3851     </callback>
3852     <callback name="BusNameLostCallback"
3853               c:type="GBusNameLostCallback"
3854               version="2.26">
3855       <doc xml:whitespace="preserve">Invoked when the name is lost or @connection has been closed.</doc>
3856       <return-value transfer-ownership="none">
3857         <type name="none" c:type="void"/>
3858       </return-value>
3859       <parameters>
3860         <parameter name="connection" transfer-ownership="none">
3861           <doc xml:whitespace="preserve">The #GDBusConnection on which to acquire the name or %NULL if the connection was disconnected.</doc>
3862           <type name="DBusConnection" c:type="GDBusConnection*"/>
3863         </parameter>
3864         <parameter name="name" transfer-ownership="none">
3865           <doc xml:whitespace="preserve">The name being owned.</doc>
3866           <type name="utf8" c:type="gchar*"/>
3867         </parameter>
3868         <parameter name="user_data" transfer-ownership="none" closure="2">
3869           <doc xml:whitespace="preserve">User data passed to g_bus_own_name() or g_bus_own_name_on_connection().</doc>
3870           <type name="gpointer" c:type="gpointer"/>
3871         </parameter>
3872       </parameters>
3873     </callback>
3874     <bitfield name="BusNameOwnerFlags"
3875               version="2.26"
3876               glib:type-name="GBusNameOwnerFlags"
3877               glib:get-type="g_bus_name_owner_flags_get_type"
3878               c:type="GBusNameOwnerFlags">
3879       <doc xml:whitespace="preserve">Flags used in g_bus_own_name().</doc>
3880       <member name="none"
3881               value="0"
3882               c:identifier="G_BUS_NAME_OWNER_FLAGS_NONE"
3883               glib:nick="none"/>
3884       <member name="allow_replacement"
3885               value="1"
3886               c:identifier="G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT"
3887               glib:nick="allow-replacement"/>
3888       <member name="replace"
3889               value="2"
3890               c:identifier="G_BUS_NAME_OWNER_FLAGS_REPLACE"
3891               glib:nick="replace"/>
3892     </bitfield>
3893     <callback name="BusNameVanishedCallback"
3894               c:type="GBusNameVanishedCallback"
3895               version="2.26">
3896       <doc xml:whitespace="preserve">Invoked when the name being watched is known not to have to have a owner.</doc>
3897       <return-value transfer-ownership="none">
3898         <type name="none" c:type="void"/>
3899       </return-value>
3900       <parameters>
3901         <parameter name="connection" transfer-ownership="none">
3902           <doc xml:whitespace="preserve">The #GDBusConnection the name is being watched on.</doc>
3903           <type name="DBusConnection" c:type="GDBusConnection*"/>
3904         </parameter>
3905         <parameter name="name" transfer-ownership="none">
3906           <doc xml:whitespace="preserve">The name being watched.</doc>
3907           <type name="utf8" c:type="gchar*"/>
3908         </parameter>
3909         <parameter name="user_data" transfer-ownership="none" closure="2">
3910           <doc xml:whitespace="preserve">User data passed to g_bus_watch_name().</doc>
3911           <type name="gpointer" c:type="gpointer"/>
3912         </parameter>
3913       </parameters>
3914     </callback>
3915     <bitfield name="BusNameWatcherFlags"
3916               version="2.26"
3917               glib:type-name="GBusNameWatcherFlags"
3918               glib:get-type="g_bus_name_watcher_flags_get_type"
3919               c:type="GBusNameWatcherFlags">
3920       <doc xml:whitespace="preserve">Flags used in g_bus_watch_name().</doc>
3921       <member name="none"
3922               value="0"
3923               c:identifier="G_BUS_NAME_WATCHER_FLAGS_NONE"
3924               glib:nick="none"/>
3925       <member name="auto_start"
3926               value="1"
3927               c:identifier="G_BUS_NAME_WATCHER_FLAGS_AUTO_START"
3928               glib:nick="auto-start"/>
3929     </bitfield>
3930     <enumeration name="BusType"
3931                  version="2.26"
3932                  glib:type-name="GBusType"
3933                  glib:get-type="g_bus_type_get_type"
3934                  c:type="GBusType">
3935       <doc xml:whitespace="preserve">An enumeration for well-known message buses.</doc>
3936       <member name="starter"
3937               value="-1"
3938               c:identifier="G_BUS_TYPE_STARTER"
3939               glib:nick="starter"/>
3940       <member name="none"
3941               value="0"
3942               c:identifier="G_BUS_TYPE_NONE"
3943               glib:nick="none"/>
3944       <member name="system"
3945               value="1"
3946               c:identifier="G_BUS_TYPE_SYSTEM"
3947               glib:nick="system"/>
3948       <member name="session"
3949               value="2"
3950               c:identifier="G_BUS_TYPE_SESSION"
3951               glib:nick="session"/>
3952     </enumeration>
3953     <class name="Cancellable"
3954            c:symbol-prefix="cancellable"
3955            c:type="GCancellable"
3956            parent="GObject.Object"
3957            glib:type-name="GCancellable"
3958            glib:get-type="g_cancellable_get_type"
3959            glib:type-struct="CancellableClass">
3960       <doc xml:whitespace="preserve">Allows actions to be cancelled.</doc>
3961       <constructor name="new" c:identifier="g_cancellable_new">
3962         <doc xml:whitespace="preserve">Creates a new #GCancellable object.
3963 Applications that want to start one or more operations
3964 that should be cancellable should create a #GCancellable
3965 and pass it to the operations.
3966 One #GCancellable can be used in multiple consecutive
3967 operations, but not in multiple concurrent operations.</doc>
3968         <return-value transfer-ownership="full">
3969           <doc xml:whitespace="preserve">a #GCancellable.</doc>
3970           <type name="Cancellable" c:type="GCancellable*"/>
3971         </return-value>
3972       </constructor>
3973       <function name="get_current" c:identifier="g_cancellable_get_current">
3974         <doc xml:whitespace="preserve">Gets the top cancellable from the stack.
3975 if the stack is empty.</doc>
3976         <return-value transfer-ownership="none">
3977           <doc xml:whitespace="preserve">a #GCancellable from the top of the stack, or %NULL</doc>
3978           <type name="Cancellable" c:type="GCancellable*"/>
3979         </return-value>
3980       </function>
3981       <method name="cancel" c:identifier="g_cancellable_cancel">
3982         <doc xml:whitespace="preserve">Will set @cancellable to cancelled, and will emit the
3983 #GCancellable::cancelled signal. (However, see the warning about
3984 race conditions in the documentation for that signal if you are
3985 planning to connect to it.)
3986 This function is thread-safe. In other words, you can safely call
3987 it from a thread other than the one running the operation that was
3988 passed the @cancellable.
3989 The convention within gio is that cancelling an asynchronous
3990 operation causes it to complete asynchronously. That is, if you
3991 cancel the operation from the same thread in which it is running,
3992 then the operation's #GAsyncReadyCallback will not be invoked until
3993 the application returns to the main loop.</doc>
3994         <return-value transfer-ownership="none">
3995           <type name="none" c:type="void"/>
3996         </return-value>
3997       </method>
3998       <method name="connect"
3999               c:identifier="g_cancellable_connect"
4000               version="2.22">
4001         <doc xml:whitespace="preserve">Convenience function to connect to the #GCancellable::cancelled
4002 signal. Also handles the race condition that may happen
4003 if the cancellable is cancelled right before connecting.
4004 time of the connect if @cancellable is already cancelled,
4005 or when @cancellable is cancelled in some thread.
4006 disconnected, or immediately if the cancellable is already
4007 cancelled.
4008 See #GCancellable::cancelled for details on how to use this.
4009 been cancelled.</doc>
4010         <return-value transfer-ownership="none">
4011           <doc xml:whitespace="preserve">The id of the signal handler or 0 if @cancellable has already</doc>
4012           <type name="gulong" c:type="gulong"/>
4013         </return-value>
4014         <parameters>
4015           <parameter name="callback"
4016                      transfer-ownership="none"
4017                      scope="notified"
4018                      closure="1"
4019                      destroy="2">
4020             <doc xml:whitespace="preserve">The #GCallback to connect.</doc>
4021             <type name="GObject.Callback" c:type="GCallback"/>
4022           </parameter>
4023           <parameter name="data" transfer-ownership="none">
4024             <doc xml:whitespace="preserve">Data to pass to @callback.</doc>
4025             <type name="gpointer" c:type="gpointer"/>
4026           </parameter>
4027           <parameter name="data_destroy_func"
4028                      transfer-ownership="none"
4029                      scope="async">
4030             <doc xml:whitespace="preserve">Free function for @data or %NULL.</doc>
4031             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
4032           </parameter>
4033         </parameters>
4034       </method>
4035       <method name="disconnect"
4036               c:identifier="g_cancellable_disconnect"
4037               version="2.22">
4038         <doc xml:whitespace="preserve">Disconnects a handler from a cancellable instance similar to
4039 g_signal_handler_disconnect().  Additionally, in the event that a
4040 signal handler is currently running, this call will block until the
4041 handler has finished.  Calling this function from a
4042 #GCancellable::cancelled signal handler will therefore result in a
4043 deadlock.
4044 This avoids a race condition where a thread cancels at the
4045 same time as the cancellable operation is finished and the
4046 signal handler is removed. See #GCancellable::cancelled for
4047 details on how to use this.
4048 If @cancellable is %NULL or @handler_id is %0 this function does
4049 nothing.</doc>
4050         <return-value transfer-ownership="none">
4051           <type name="none" c:type="void"/>
4052         </return-value>
4053         <parameters>
4054           <parameter name="handler_id" transfer-ownership="none">
4055             <doc xml:whitespace="preserve">Handler id of the handler to be disconnected, or %0.</doc>
4056             <type name="gulong" c:type="gulong"/>
4057           </parameter>
4058         </parameters>
4059       </method>
4060       <method name="get_fd" c:identifier="g_cancellable_get_fd">
4061         <doc xml:whitespace="preserve">Gets the file descriptor for a cancellable job. This can be used to
4062 implement cancellable operations on Unix systems. The returned fd will
4063 turn readable when @cancellable is cancelled.
4064 You are not supposed to read from the fd yourself, just check for
4065 readable status. Reading to unset the readable status is done
4066 with g_cancellable_reset().
4067 After a successful return from this function, you should use
4068 g_cancellable_release_fd() to free up resources allocated for
4069 the returned file descriptor.
4070 See also g_cancellable_make_pollfd().
4071 is not supported, or on errors.</doc>
4072         <return-value transfer-ownership="none">
4073           <doc xml:whitespace="preserve">A valid file descriptor. %-1 if the file descriptor</doc>
4074           <type name="gint" c:type="int"/>
4075         </return-value>
4076       </method>
4077       <method name="is_cancelled" c:identifier="g_cancellable_is_cancelled">
4078         <doc xml:whitespace="preserve">Checks if a cancellable job has been cancelled.
4079 FALSE if called with %NULL or if item is not cancelled.</doc>
4080         <return-value transfer-ownership="none">
4081           <doc xml:whitespace="preserve">%TRUE if @cancellable is cancelled,</doc>
4082           <type name="gboolean" c:type="gboolean"/>
4083         </return-value>
4084       </method>
4085       <method name="make_pollfd"
4086               c:identifier="g_cancellable_make_pollfd"
4087               version="2.22">
4088         <doc xml:whitespace="preserve">Creates a #GPollFD corresponding to @cancellable; this can be passed
4089 to g_poll() and used to poll for cancellation. This is useful both
4090 for unix systems without a native poll and for portability to
4091 windows.
4092 When this function returns %TRUE, you should use
4093 g_cancellable_release_fd() to free up resources allocated for the
4094 If this function returns %FALSE, either no @cancellable was given or
4095 resource limits prevent this function from allocating the necessary
4096 structures for polling. (On Linux, you will likely have reached
4097 the maximum number of file descriptors.) The suggested way to handle
4098 these cases is to ignore the @cancellable.
4099 You are not supposed to read from the fd yourself, just check for
4100 readable status. Reading to unset the readable status is done
4101 with g_cancellable_reset().
4102 failure to prepare the cancellable.</doc>
4103         <return-value transfer-ownership="none">
4104           <doc xml:whitespace="preserve">%TRUE if @pollfd was successfully initialized, %FALSE on</doc>
4105           <type name="gboolean" c:type="gboolean"/>
4106         </return-value>
4107         <parameters>
4108           <parameter name="pollfd" transfer-ownership="none">
4109             <doc xml:whitespace="preserve">a pointer to a #GPollFD</doc>
4110             <type name="GLib.PollFD" c:type="GPollFD*"/>
4111           </parameter>
4112         </parameters>
4113       </method>
4114       <method name="pop_current" c:identifier="g_cancellable_pop_current">
4115         <doc xml:whitespace="preserve">Pops @cancellable off the cancellable stack (verifying that @cancellable
4116 is on the top of the stack).</doc>
4117         <return-value transfer-ownership="none">
4118           <type name="none" c:type="void"/>
4119         </return-value>
4120       </method>
4121       <method name="push_current" c:identifier="g_cancellable_push_current">
4122         <doc xml:whitespace="preserve">Pushes @cancellable onto the cancellable stack. The current
4123 cancllable can then be recieved using g_cancellable_get_current().
4124 This is useful when implementing cancellable operations in
4125 code that does not allow you to pass down the cancellable object.
4126 This is typically called automatically by e.g. #GFile operations,
4127 so you rarely have to call this yourself.</doc>
4128         <return-value transfer-ownership="none">
4129           <type name="none" c:type="void"/>
4130         </return-value>
4131       </method>
4132       <method name="release_fd"
4133               c:identifier="g_cancellable_release_fd"
4134               version="2.22">
4135         <doc xml:whitespace="preserve">Releases a resources previously allocated by g_cancellable_get_fd()
4136 or g_cancellable_make_pollfd().
4137 For compatibility reasons with older releases, calling this function
4138 is not strictly required, the resources will be automatically freed
4139 when the @cancellable is finalized. However, the @cancellable will
4140 block scarce file descriptors until it is finalized if this function
4141 is not called. This can cause the application to run out of file
4142 descriptors when many #GCancellables are used at the same time.</doc>
4143         <return-value transfer-ownership="none">
4144           <type name="none" c:type="void"/>
4145         </return-value>
4146       </method>
4147       <method name="reset" c:identifier="g_cancellable_reset">
4148         <doc xml:whitespace="preserve">Resets @cancellable to its uncancelled state.</doc>
4149         <return-value transfer-ownership="none">
4150           <type name="none" c:type="void"/>
4151         </return-value>
4152       </method>
4153       <method name="set_error_if_cancelled"
4154               c:identifier="g_cancellable_set_error_if_cancelled"
4155               throws="1">
4156         <doc xml:whitespace="preserve">If the @cancellable is cancelled, sets the error to notify
4157 that the operation was cancelled.</doc>
4158         <return-value transfer-ownership="none">
4159           <doc xml:whitespace="preserve">%TRUE if @cancellable was cancelled, %FALSE if it was not.</doc>
4160           <type name="gboolean" c:type="gboolean"/>
4161         </return-value>
4162       </method>
4163       <field name="parent_instance">
4164         <type name="GObject.Object" c:type="GObject"/>
4165       </field>
4166       <field name="priv">
4167         <type name="CancellablePrivate" c:type="GCancellablePrivate*"/>
4168       </field>
4169       <glib:signal name="cancelled">
4170         <doc xml:whitespace="preserve">Emitted when the operation has been cancelled.
4171 Can be used by implementations of cancellable operations. If the
4172 operation is cancelled from another thread, the signal will be
4173 emitted in the thread that cancelled the operation, not the
4174 thread that is running the operation.
4175 Note that disconnecting from this signal (or any signal) in a
4176 multi-threaded program is prone to race conditions. For instance
4177 it is possible that a signal handler may be invoked even
4178 &lt;emphasis&gt;after&lt;/emphasis&gt; a call to
4179 g_signal_handler_disconnect() for that handler has already
4180 returned.
4181 There is also a problem when cancellation happen
4182 right before connecting to the signal. If this happens the
4183 signal will unexpectedly not be emitted, and checking before
4184 connecting to the signal leaves a race condition where this is
4185 still happening.
4186 In order to make it safe and easy to connect handlers there
4187 g_cancellable_disconnect() which protect against problems
4188 like this.
4189 An example of how to us this:
4190 |[
4191 /&lt;!-- --&gt;* Make sure we don't do any unnecessary work if already cancelled *&lt;!-- --&gt;/
4192 if (g_cancellable_set_error_if_cancelled (cancellable))
4193 return;
4194 /&lt;!-- --&gt;* Set up all the data needed to be able to
4195 * handle cancellation of the operation *&lt;!-- --&gt;/
4196 my_data = my_data_new (...);
4197 id = 0;
4198 if (cancellable)
4199 id = g_cancellable_connect (cancellable,
4200 G_CALLBACK (cancelled_handler)
4201 data, NULL);
4202 /&lt;!-- --&gt;* cancellable operation here... *&lt;!-- --&gt;/
4203 g_cancellable_disconnect (cancellable, id);
4204 /&lt;!-- --&gt;* cancelled_handler is never called after this, it
4205 * is now safe to free the data *&lt;!-- --&gt;/
4206 my_data_free (my_data);
4207 ]|
4208 Note that the cancelled signal is emitted in the thread that
4209 the user cancelled from, which may be the main thread. So, the
4210 cancellable signal should not do something that can block.</doc>
4211         <return-value transfer-ownership="none">
4212           <type name="none"/>
4213         </return-value>
4214       </glib:signal>
4215     </class>
4216     <record name="CancellableClass"
4217             c:type="GCancellableClass"
4218             glib:is-gtype-struct-for="Cancellable">
4219       <field name="parent_class">
4220         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
4221       </field>
4222       <field name="cancelled">
4223         <callback name="cancelled">
4224           <return-value transfer-ownership="none">
4225             <type name="none" c:type="void"/>
4226           </return-value>
4227           <parameters>
4228             <parameter name="cancellable" transfer-ownership="none">
4229               <type name="Cancellable" c:type="GCancellable*"/>
4230             </parameter>
4231           </parameters>
4232         </callback>
4233       </field>
4234       <field name="_g_reserved1" introspectable="0">
4235         <callback name="_g_reserved1">
4236           <return-value transfer-ownership="none">
4237             <type name="none" c:type="void"/>
4238           </return-value>
4239         </callback>
4240       </field>
4241       <field name="_g_reserved2" introspectable="0">
4242         <callback name="_g_reserved2">
4243           <return-value transfer-ownership="none">
4244             <type name="none" c:type="void"/>
4245           </return-value>
4246         </callback>
4247       </field>
4248       <field name="_g_reserved3" introspectable="0">
4249         <callback name="_g_reserved3">
4250           <return-value transfer-ownership="none">
4251             <type name="none" c:type="void"/>
4252           </return-value>
4253         </callback>
4254       </field>
4255       <field name="_g_reserved4" introspectable="0">
4256         <callback name="_g_reserved4">
4257           <return-value transfer-ownership="none">
4258             <type name="none" c:type="void"/>
4259           </return-value>
4260         </callback>
4261       </field>
4262       <field name="_g_reserved5" introspectable="0">
4263         <callback name="_g_reserved5">
4264           <return-value transfer-ownership="none">
4265             <type name="none" c:type="void"/>
4266           </return-value>
4267         </callback>
4268       </field>
4269     </record>
4270     <record name="CancellablePrivate"
4271             c:type="GCancellablePrivate"
4272             disguised="1">
4273     </record>
4274     <class name="CharsetConverter"
4275            c:symbol-prefix="charset_converter"
4276            c:type="GCharsetConverter"
4277            parent="GObject.Object"
4278            glib:type-name="GCharsetConverter"
4279            glib:get-type="g_charset_converter_get_type"
4280            glib:type-struct="CharsetConverterClass">
4281       <doc xml:whitespace="preserve">Conversions between character sets.</doc>
4282       <implements name="Converter"/>
4283       <implements name="Initable"/>
4284       <constructor name="new"
4285                    c:identifier="g_charset_converter_new"
4286                    version="2.24"
4287                    throws="1">
4288         <doc xml:whitespace="preserve">Creates a new #GCharsetConverter.</doc>
4289         <return-value transfer-ownership="full">
4290           <doc xml:whitespace="preserve">a new #GCharsetConverter or %NULL on error.</doc>
4291           <type name="CharsetConverter" c:type="GCharsetConverter*"/>
4292         </return-value>
4293         <parameters>
4294           <parameter name="to_charset" transfer-ownership="none">
4295             <doc xml:whitespace="preserve">destination charset</doc>
4296             <type name="utf8" c:type="gchar*"/>
4297           </parameter>
4298           <parameter name="from_charset" transfer-ownership="none">
4299             <doc xml:whitespace="preserve">source charset</doc>
4300             <type name="utf8" c:type="gchar*"/>
4301           </parameter>
4302         </parameters>
4303       </constructor>
4304       <method name="get_num_fallbacks"
4305               c:identifier="g_charset_converter_get_num_fallbacks"
4306               version="2.24">
4307         <doc xml:whitespace="preserve">Gets the number of fallbacks that @converter has applied so far.</doc>
4308         <return-value transfer-ownership="none">
4309           <doc xml:whitespace="preserve">the number of fallbacks that @converter has applied</doc>
4310           <type name="guint" c:type="guint"/>
4311         </return-value>
4312       </method>
4313       <method name="get_use_fallback"
4314               c:identifier="g_charset_converter_get_use_fallback"
4315               version="2.24">
4316         <doc xml:whitespace="preserve">Gets the #GCharsetConverter:use-fallback property.</doc>
4317         <return-value transfer-ownership="none">
4318           <doc xml:whitespace="preserve">%TRUE if fallbacks are used by @converter</doc>
4319           <type name="gboolean" c:type="gboolean"/>
4320         </return-value>
4321       </method>
4322       <method name="set_use_fallback"
4323               c:identifier="g_charset_converter_set_use_fallback"
4324               version="2.24">
4325         <doc xml:whitespace="preserve">Sets the #GCharsetConverter:use-fallback property.</doc>
4326         <return-value transfer-ownership="none">
4327           <type name="none" c:type="void"/>
4328         </return-value>
4329         <parameters>
4330           <parameter name="use_fallback" transfer-ownership="none">
4331             <doc xml:whitespace="preserve">%TRUE to use fallbacks</doc>
4332             <type name="gboolean" c:type="gboolean"/>
4333           </parameter>
4334         </parameters>
4335       </method>
4336       <property name="from-charset"
4337                 writable="1"
4338                 construct-only="1"
4339                 transfer-ownership="none">
4340         <type name="utf8"/>
4341       </property>
4342       <property name="to-charset"
4343                 writable="1"
4344                 construct-only="1"
4345                 transfer-ownership="none">
4346         <type name="utf8"/>
4347       </property>
4348       <property name="use-fallback"
4349                 writable="1"
4350                 construct="1"
4351                 transfer-ownership="none">
4352         <type name="gboolean"/>
4353       </property>
4354     </class>
4355     <record name="CharsetConverterClass"
4356             c:type="GCharsetConverterClass"
4357             glib:is-gtype-struct-for="CharsetConverter">
4358       <field name="parent_class">
4359         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
4360       </field>
4361     </record>
4362     <interface name="Converter"
4363                c:symbol-prefix="converter"
4364                c:type="GConverter"
4365                version="2.24"
4366                glib:type-name="GConverter"
4367                glib:get-type="g_converter_get_type"
4368                glib:type-struct="ConverterIface">
4369       <doc xml:whitespace="preserve">Seek object for streaming operations.</doc>
4370       <virtual-method name="convert"
4371                       invoker="convert"
4372                       version="2.24"
4373                       throws="1">
4374         <doc xml:whitespace="preserve">This is the main operation used when converting data. It is to be called
4375 multiple times in a loop, and each time it will do some work, i.e.
4376 producing some output (in @outbuf) or consuming some input (from @inbuf) or
4377 both. If its not possible to do any work an error is returned.
4378 Note that a single call may not consume all input (or any input at all).
4379 Also a call may produce output even if given no input, due to state stored
4380 in the converter producing output.
4381 If any data was either produced or consumed, and then an error happens, then
4382 only the successful conversion is reported and the error is returned on the
4383 next call.
4384 A full conversion loop involves calling this method repeatedly, each time
4385 giving it new input and space output space. When there is no more input
4386 data after the data in @inbuf, the flag %G_CONVERTER_INPUT_AT_END must be set.
4387 The loop will be (unless some error happens) returning %G_CONVERTER_CONVERTED
4388 each time until all data is consumed and all output is produced, then
4389 %G_CONVERTER_FINISHED is returned instead. Note, that %G_CONVERTER_FINISHED
4390 may be returned even if %G_CONVERTER_INPUT_AT_END is not set, for instance
4391 in a decompression converter where the end of data is detectable from the
4392 data (and there might even be other data after the end of the compressed data).
4393 When some data has successfully been converted @bytes_read and is set to
4394 the number of bytes read from @inbuf, and @bytes_written is set to indicate
4395 how many bytes was written to @outbuf. If there are more data to output
4396 or consume (i.e. unless the G_CONVERTER_INPUT_AT_END is specified) then
4397 G_CONVERTER_CONVERTED is returned, and if no more data is to be output
4398 then G_CONVERTER_FINISHED is returned.
4399 On error %G_CONVERTER_ERROR is returned and @error is set accordingly.
4400 Some errors need special handling:
4401 %G_IO_ERROR_NO_SPACE is returned if there is not enough space
4402 to write the resulting converted data, the application should
4403 call the function again with a larger @outbuf to continue.
4404 %G_IO_ERROR_PARTIAL_INPUT is returned if there is not enough
4405 input to fully determine what the conversion should produce,
4406 and the %G_CONVERTER_INPUT_AT_END flag is not set. This happens for
4407 example with an incomplete multibyte sequence when converting text,
4408 or when a regexp matches up to the end of the input (and may match
4409 further input). It may also happen when @inbuf_size is zero and
4410 there is no more data to produce.
4411 When this happens the application should read more input and then
4412 call the function again. If further input shows that there is no
4413 more data call the function again with the same data but with
4414 the %G_CONVERTER_INPUT_AT_END flag set. This may cause the conversion
4415 to finish as e.g. in the regexp match case (or, to fail again with
4416 %G_IO_ERROR_PARTIAL_INPUT in e.g. a charset conversion where the
4417 input is actually partial).
4418 After g_converter_convert() has returned %G_CONVERTER_FINISHED the
4419 converter object is in an invalid state where its not allowed
4420 to call g_converter_convert() anymore. At this time you can only
4421 free the object or call g_converter_reset() to reset it to the
4422 initial state.
4423 If the flag %G_CONVERTER_FLUSH is set then conversion is modified
4424 to try to write out all internal state to the output. The application
4425 has to call the function multiple times with the flag set, and when
4426 the availible input has been consumed and all internal state has
4427 been produced then %G_CONVERTER_FLUSHED (or %G_CONVERTER_FINISHED if
4428 really at the end) is returned instead of %G_CONVERTER_CONVERTED.
4429 This is somewhat similar to what happens at the end of the input stream,
4430 but done in the middle of the data.
4431 This has different meanings for different conversions. For instance
4432 in a compression converter it would mean that we flush all the
4433 compression state into output such that if you uncompress the
4434 compressed data you get back all the input data. Doing this may
4435 make the final file larger due to padding though. Another example
4436 is a regexp conversion, where if you at the end of the flushed data
4437 have a match, but there is also a potential longer match. In the
4438 non-flushed case we would ask for more input, but when flushing we
4439 treat this as the end of input and do the match.
4440 Flushing is not always possible (like if a charset converter flushes
4441 at a partial multibyte sequence). Converters are supposed to try
4442 to produce as much output as possible and then return an error
4443 (typically %G_IO_ERROR_PARTIAL_INPUT).</doc>
4444         <return-value transfer-ownership="none">
4445           <doc xml:whitespace="preserve">a #GConverterResult, %G_CONVERTER_ERROR on error.</doc>
4446           <type name="ConverterResult" c:type="GConverterResult"/>
4447         </return-value>
4448         <parameters>
4449           <parameter name="inbuf" transfer-ownership="none">
4450             <doc xml:whitespace="preserve">the buffer containing the data to convert.</doc>
4451             <type name="gpointer" c:type="void*"/>
4452           </parameter>
4453           <parameter name="inbuf_size" transfer-ownership="none">
4454             <doc xml:whitespace="preserve">the number of bytes in @inbuf</doc>
4455             <type name="gulong" c:type="gsize"/>
4456           </parameter>
4457           <parameter name="outbuf" transfer-ownership="none">
4458             <doc xml:whitespace="preserve">a buffer to write converted data in.</doc>
4459             <type name="gpointer" c:type="void*"/>
4460           </parameter>
4461           <parameter name="outbuf_size" transfer-ownership="none">
4462             <doc xml:whitespace="preserve">the number of bytes in @outbuf, must be at least one</doc>
4463             <type name="gulong" c:type="gsize"/>
4464           </parameter>
4465           <parameter name="flags" transfer-ownership="none">
4466             <doc xml:whitespace="preserve">a #GConvertFlags controlling the conversion details</doc>
4467             <type name="ConverterFlags" c:type="GConverterFlags"/>
4468           </parameter>
4469           <parameter name="bytes_read" transfer-ownership="none">
4470             <doc xml:whitespace="preserve">will be set to the number of bytes read from @inbuf on success</doc>
4471             <type name="gulong" c:type="gsize*"/>
4472           </parameter>
4473           <parameter name="bytes_written" transfer-ownership="none">
4474             <doc xml:whitespace="preserve">will be set to the number of bytes written to @outbuf on success</doc>
4475             <type name="gulong" c:type="gsize*"/>
4476           </parameter>
4477         </parameters>
4478       </virtual-method>
4479       <virtual-method name="reset" invoker="reset" version="2.24">
4480         <doc xml:whitespace="preserve">Resets all internal state in the converter, making it behave
4481 as if it was just created. If the converter has any internal
4482 state that would produce output then that output is lost.</doc>
4483         <return-value transfer-ownership="none">
4484           <type name="none" c:type="void"/>
4485         </return-value>
4486       </virtual-method>
4487       <method name="convert"
4488               c:identifier="g_converter_convert"
4489               version="2.24"
4490               throws="1">
4491         <doc xml:whitespace="preserve">This is the main operation used when converting data. It is to be called
4492 multiple times in a loop, and each time it will do some work, i.e.
4493 producing some output (in @outbuf) or consuming some input (from @inbuf) or
4494 both. If its not possible to do any work an error is returned.
4495 Note that a single call may not consume all input (or any input at all).
4496 Also a call may produce output even if given no input, due to state stored
4497 in the converter producing output.
4498 If any data was either produced or consumed, and then an error happens, then
4499 only the successful conversion is reported and the error is returned on the
4500 next call.
4501 A full conversion loop involves calling this method repeatedly, each time
4502 giving it new input and space output space. When there is no more input
4503 data after the data in @inbuf, the flag %G_CONVERTER_INPUT_AT_END must be set.
4504 The loop will be (unless some error happens) returning %G_CONVERTER_CONVERTED
4505 each time until all data is consumed and all output is produced, then
4506 %G_CONVERTER_FINISHED is returned instead. Note, that %G_CONVERTER_FINISHED
4507 may be returned even if %G_CONVERTER_INPUT_AT_END is not set, for instance
4508 in a decompression converter where the end of data is detectable from the
4509 data (and there might even be other data after the end of the compressed data).
4510 When some data has successfully been converted @bytes_read and is set to
4511 the number of bytes read from @inbuf, and @bytes_written is set to indicate
4512 how many bytes was written to @outbuf. If there are more data to output
4513 or consume (i.e. unless the G_CONVERTER_INPUT_AT_END is specified) then
4514 G_CONVERTER_CONVERTED is returned, and if no more data is to be output
4515 then G_CONVERTER_FINISHED is returned.
4516 On error %G_CONVERTER_ERROR is returned and @error is set accordingly.
4517 Some errors need special handling:
4518 %G_IO_ERROR_NO_SPACE is returned if there is not enough space
4519 to write the resulting converted data, the application should
4520 call the function again with a larger @outbuf to continue.
4521 %G_IO_ERROR_PARTIAL_INPUT is returned if there is not enough
4522 input to fully determine what the conversion should produce,
4523 and the %G_CONVERTER_INPUT_AT_END flag is not set. This happens for
4524 example with an incomplete multibyte sequence when converting text,
4525 or when a regexp matches up to the end of the input (and may match
4526 further input). It may also happen when @inbuf_size is zero and
4527 there is no more data to produce.
4528 When this happens the application should read more input and then
4529 call the function again. If further input shows that there is no
4530 more data call the function again with the same data but with
4531 the %G_CONVERTER_INPUT_AT_END flag set. This may cause the conversion
4532 to finish as e.g. in the regexp match case (or, to fail again with
4533 %G_IO_ERROR_PARTIAL_INPUT in e.g. a charset conversion where the
4534 input is actually partial).
4535 After g_converter_convert() has returned %G_CONVERTER_FINISHED the
4536 converter object is in an invalid state where its not allowed
4537 to call g_converter_convert() anymore. At this time you can only
4538 free the object or call g_converter_reset() to reset it to the
4539 initial state.
4540 If the flag %G_CONVERTER_FLUSH is set then conversion is modified
4541 to try to write out all internal state to the output. The application
4542 has to call the function multiple times with the flag set, and when
4543 the availible input has been consumed and all internal state has
4544 been produced then %G_CONVERTER_FLUSHED (or %G_CONVERTER_FINISHED if
4545 really at the end) is returned instead of %G_CONVERTER_CONVERTED.
4546 This is somewhat similar to what happens at the end of the input stream,
4547 but done in the middle of the data.
4548 This has different meanings for different conversions. For instance
4549 in a compression converter it would mean that we flush all the
4550 compression state into output such that if you uncompress the
4551 compressed data you get back all the input data. Doing this may
4552 make the final file larger due to padding though. Another example
4553 is a regexp conversion, where if you at the end of the flushed data
4554 have a match, but there is also a potential longer match. In the
4555 non-flushed case we would ask for more input, but when flushing we
4556 treat this as the end of input and do the match.
4557 Flushing is not always possible (like if a charset converter flushes
4558 at a partial multibyte sequence). Converters are supposed to try
4559 to produce as much output as possible and then return an error
4560 (typically %G_IO_ERROR_PARTIAL_INPUT).</doc>
4561         <return-value transfer-ownership="none">
4562           <doc xml:whitespace="preserve">a #GConverterResult, %G_CONVERTER_ERROR on error.</doc>
4563           <type name="ConverterResult" c:type="GConverterResult"/>
4564         </return-value>
4565         <parameters>
4566           <parameter name="inbuf" transfer-ownership="none">
4567             <doc xml:whitespace="preserve">the buffer containing the data to convert.</doc>
4568             <type name="gpointer" c:type="void*"/>
4569           </parameter>
4570           <parameter name="inbuf_size" transfer-ownership="none">
4571             <doc xml:whitespace="preserve">the number of bytes in @inbuf</doc>
4572             <type name="gulong" c:type="gsize"/>
4573           </parameter>
4574           <parameter name="outbuf" transfer-ownership="none">
4575             <doc xml:whitespace="preserve">a buffer to write converted data in.</doc>
4576             <type name="gpointer" c:type="void*"/>
4577           </parameter>
4578           <parameter name="outbuf_size" transfer-ownership="none">
4579             <doc xml:whitespace="preserve">the number of bytes in @outbuf, must be at least one</doc>
4580             <type name="gulong" c:type="gsize"/>
4581           </parameter>
4582           <parameter name="flags" transfer-ownership="none">
4583             <doc xml:whitespace="preserve">a #GConvertFlags controlling the conversion details</doc>
4584             <type name="ConverterFlags" c:type="GConverterFlags"/>
4585           </parameter>
4586           <parameter name="bytes_read" transfer-ownership="none">
4587             <doc xml:whitespace="preserve">will be set to the number of bytes read from @inbuf on success</doc>
4588             <type name="gulong" c:type="gsize*"/>
4589           </parameter>
4590           <parameter name="bytes_written" transfer-ownership="none">
4591             <doc xml:whitespace="preserve">will be set to the number of bytes written to @outbuf on success</doc>
4592             <type name="gulong" c:type="gsize*"/>
4593           </parameter>
4594         </parameters>
4595       </method>
4596       <method name="reset" c:identifier="g_converter_reset" version="2.24">
4597         <doc xml:whitespace="preserve">Resets all internal state in the converter, making it behave
4598 as if it was just created. If the converter has any internal
4599 state that would produce output then that output is lost.</doc>
4600         <return-value transfer-ownership="none">
4601           <type name="none" c:type="void"/>
4602         </return-value>
4603       </method>
4604     </interface>
4605     <bitfield name="ConverterFlags"
4606               version="2.24"
4607               glib:type-name="GConverterFlags"
4608               glib:get-type="g_converter_flags_get_type"
4609               c:type="GConverterFlags">
4610       <doc xml:whitespace="preserve">Flags used when calling a g_converter_convert().</doc>
4611       <member name="none"
4612               value="0"
4613               c:identifier="G_CONVERTER_NO_FLAGS"
4614               glib:nick="none"/>
4615       <member name="input_at_end"
4616               value="1"
4617               c:identifier="G_CONVERTER_INPUT_AT_END"
4618               glib:nick="input-at-end"/>
4619       <member name="flush"
4620               value="2"
4621               c:identifier="G_CONVERTER_FLUSH"
4622               glib:nick="flush"/>
4623     </bitfield>
4624     <record name="ConverterIface"
4625             c:type="GConverterIface"
4626             glib:is-gtype-struct-for="Converter"
4627             version="2.24">
4628       <doc xml:whitespace="preserve">Provides an interface for converting data from one type
4629 to another type. The conversion can be stateful
4630 and may fail at any place.</doc>
4631       <field name="g_iface">
4632         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
4633       </field>
4634       <field name="convert">
4635         <callback name="convert" throws="1">
4636           <return-value transfer-ownership="none">
4637             <doc xml:whitespace="preserve">a #GConverterResult, %G_CONVERTER_ERROR on error.</doc>
4638             <type name="ConverterResult" c:type="GConverterResult"/>
4639           </return-value>
4640           <parameters>
4641             <parameter name="converter" transfer-ownership="none">
4642               <type name="Converter" c:type="GConverter*"/>
4643             </parameter>
4644             <parameter name="inbuf" transfer-ownership="none">
4645               <doc xml:whitespace="preserve">the buffer containing the data to convert.</doc>
4646               <type name="gpointer" c:type="void*"/>
4647             </parameter>
4648             <parameter name="inbuf_size" transfer-ownership="none">
4649               <doc xml:whitespace="preserve">the number of bytes in @inbuf</doc>
4650               <type name="gulong" c:type="gsize"/>
4651             </parameter>
4652             <parameter name="outbuf" transfer-ownership="none">
4653               <doc xml:whitespace="preserve">a buffer to write converted data in.</doc>
4654               <type name="gpointer" c:type="void*"/>
4655             </parameter>
4656             <parameter name="outbuf_size" transfer-ownership="none">
4657               <doc xml:whitespace="preserve">the number of bytes in @outbuf, must be at least one</doc>
4658               <type name="gulong" c:type="gsize"/>
4659             </parameter>
4660             <parameter name="flags" transfer-ownership="none">
4661               <doc xml:whitespace="preserve">a #GConvertFlags controlling the conversion details</doc>
4662               <type name="ConverterFlags" c:type="GConverterFlags"/>
4663             </parameter>
4664             <parameter name="bytes_read" transfer-ownership="none">
4665               <doc xml:whitespace="preserve">will be set to the number of bytes read from @inbuf on success</doc>
4666               <type name="gulong" c:type="gsize*"/>
4667             </parameter>
4668             <parameter name="bytes_written" transfer-ownership="none">
4669               <doc xml:whitespace="preserve">will be set to the number of bytes written to @outbuf on success</doc>
4670               <type name="gulong" c:type="gsize*"/>
4671             </parameter>
4672           </parameters>
4673         </callback>
4674       </field>
4675       <field name="reset">
4676         <callback name="reset">
4677           <return-value transfer-ownership="none">
4678             <type name="none" c:type="void"/>
4679           </return-value>
4680           <parameters>
4681             <parameter name="converter" transfer-ownership="none">
4682               <type name="Converter" c:type="GConverter*"/>
4683             </parameter>
4684           </parameters>
4685         </callback>
4686       </field>
4687     </record>
4688     <class name="ConverterInputStream"
4689            c:symbol-prefix="converter_input_stream"
4690            c:type="GConverterInputStream"
4691            parent="FilterInputStream"
4692            glib:type-name="GConverterInputStream"
4693            glib:get-type="g_converter_input_stream_get_type"
4694            glib:type-struct="ConverterInputStreamClass">
4695       <doc xml:whitespace="preserve">An implementation of #GFilterInputStream that allows data
4696 conversion.</doc>
4697       <constructor name="new" c:identifier="g_converter_input_stream_new">
4698         <doc xml:whitespace="preserve">Creates a new converter input stream for the @base_stream.</doc>
4699         <return-value transfer-ownership="full">
4700           <doc xml:whitespace="preserve">a new #GInputStream.</doc>
4701           <type name="InputStream" c:type="GInputStream*"/>
4702         </return-value>
4703         <parameters>
4704           <parameter name="base_stream" transfer-ownership="none">
4705             <doc xml:whitespace="preserve">a #GInputStream</doc>
4706             <type name="InputStream" c:type="GInputStream*"/>
4707           </parameter>
4708           <parameter name="converter" transfer-ownership="none">
4709             <doc xml:whitespace="preserve">a #GConverter</doc>
4710             <type name="Converter" c:type="GConverter*"/>
4711           </parameter>
4712         </parameters>
4713       </constructor>
4714       <method name="get_converter"
4715               c:identifier="g_converter_input_stream_get_converter"
4716               version="2.24">
4717         <doc xml:whitespace="preserve">Gets the #GConverter that is used by @converter_stream.</doc>
4718         <return-value transfer-ownership="none">
4719           <doc xml:whitespace="preserve">the converter of the converter input stream</doc>
4720           <type name="Converter" c:type="GConverter*"/>
4721         </return-value>
4722       </method>
4723       <property name="converter"
4724                 writable="1"
4725                 construct-only="1"
4726                 transfer-ownership="none">
4727         <type name="Converter"/>
4728       </property>
4729       <field name="parent_instance">
4730         <type name="FilterInputStream" c:type="GFilterInputStream"/>
4731       </field>
4732       <field name="priv">
4733         <type name="ConverterInputStreamPrivate"
4734               c:type="GConverterInputStreamPrivate*"/>
4735       </field>
4736     </class>
4737     <record name="ConverterInputStreamClass"
4738             c:type="GConverterInputStreamClass"
4739             glib:is-gtype-struct-for="ConverterInputStream">
4740       <field name="parent_class">
4741         <type name="FilterInputStreamClass" c:type="GFilterInputStreamClass"/>
4742       </field>
4743       <field name="_g_reserved1" introspectable="0">
4744         <callback name="_g_reserved1">
4745           <return-value transfer-ownership="none">
4746             <type name="none" c:type="void"/>
4747           </return-value>
4748         </callback>
4749       </field>
4750       <field name="_g_reserved2" introspectable="0">
4751         <callback name="_g_reserved2">
4752           <return-value transfer-ownership="none">
4753             <type name="none" c:type="void"/>
4754           </return-value>
4755         </callback>
4756       </field>
4757       <field name="_g_reserved3" introspectable="0">
4758         <callback name="_g_reserved3">
4759           <return-value transfer-ownership="none">
4760             <type name="none" c:type="void"/>
4761           </return-value>
4762         </callback>
4763       </field>
4764       <field name="_g_reserved4" introspectable="0">
4765         <callback name="_g_reserved4">
4766           <return-value transfer-ownership="none">
4767             <type name="none" c:type="void"/>
4768           </return-value>
4769         </callback>
4770       </field>
4771       <field name="_g_reserved5" introspectable="0">
4772         <callback name="_g_reserved5">
4773           <return-value transfer-ownership="none">
4774             <type name="none" c:type="void"/>
4775           </return-value>
4776         </callback>
4777       </field>
4778     </record>
4779     <record name="ConverterInputStreamPrivate"
4780             c:type="GConverterInputStreamPrivate"
4781             disguised="1">
4782     </record>
4783     <class name="ConverterOutputStream"
4784            c:symbol-prefix="converter_output_stream"
4785            c:type="GConverterOutputStream"
4786            parent="FilterOutputStream"
4787            glib:type-name="GConverterOutputStream"
4788            glib:get-type="g_converter_output_stream_get_type"
4789            glib:type-struct="ConverterOutputStreamClass">
4790       <doc xml:whitespace="preserve">An implementation of #GFilterOutputStream that allows data
4791 conversion.</doc>
4792       <constructor name="new" c:identifier="g_converter_output_stream_new">
4793         <doc xml:whitespace="preserve">Creates a new converter output stream for the @base_stream.</doc>
4794         <return-value transfer-ownership="full">
4795           <doc xml:whitespace="preserve">a new #GOutputStream.</doc>
4796           <type name="OutputStream" c:type="GOutputStream*"/>
4797         </return-value>
4798         <parameters>
4799           <parameter name="base_stream" transfer-ownership="none">
4800             <doc xml:whitespace="preserve">a #GOutputStream</doc>
4801             <type name="OutputStream" c:type="GOutputStream*"/>
4802           </parameter>
4803           <parameter name="converter" transfer-ownership="none">
4804             <doc xml:whitespace="preserve">a #GConverter</doc>
4805             <type name="Converter" c:type="GConverter*"/>
4806           </parameter>
4807         </parameters>
4808       </constructor>
4809       <method name="get_converter"
4810               c:identifier="g_converter_output_stream_get_converter"
4811               version="2.24">
4812         <doc xml:whitespace="preserve">Gets the #GConverter that is used by @converter_stream.</doc>
4813         <return-value transfer-ownership="none">
4814           <doc xml:whitespace="preserve">the converter of the converter output stream</doc>
4815           <type name="Converter" c:type="GConverter*"/>
4816         </return-value>
4817       </method>
4818       <property name="converter"
4819                 writable="1"
4820                 construct-only="1"
4821                 transfer-ownership="none">
4822         <type name="Converter"/>
4823       </property>
4824       <field name="parent_instance">
4825         <type name="FilterOutputStream" c:type="GFilterOutputStream"/>
4826       </field>
4827       <field name="priv">
4828         <type name="ConverterOutputStreamPrivate"
4829               c:type="GConverterOutputStreamPrivate*"/>
4830       </field>
4831     </class>
4832     <record name="ConverterOutputStreamClass"
4833             c:type="GConverterOutputStreamClass"
4834             glib:is-gtype-struct-for="ConverterOutputStream">
4835       <field name="parent_class">
4836         <type name="FilterOutputStreamClass"
4837               c:type="GFilterOutputStreamClass"/>
4838       </field>
4839       <field name="_g_reserved1" introspectable="0">
4840         <callback name="_g_reserved1">
4841           <return-value transfer-ownership="none">
4842             <type name="none" c:type="void"/>
4843           </return-value>
4844         </callback>
4845       </field>
4846       <field name="_g_reserved2" introspectable="0">
4847         <callback name="_g_reserved2">
4848           <return-value transfer-ownership="none">
4849             <type name="none" c:type="void"/>
4850           </return-value>
4851         </callback>
4852       </field>
4853       <field name="_g_reserved3" introspectable="0">
4854         <callback name="_g_reserved3">
4855           <return-value transfer-ownership="none">
4856             <type name="none" c:type="void"/>
4857           </return-value>
4858         </callback>
4859       </field>
4860       <field name="_g_reserved4" introspectable="0">
4861         <callback name="_g_reserved4">
4862           <return-value transfer-ownership="none">
4863             <type name="none" c:type="void"/>
4864           </return-value>
4865         </callback>
4866       </field>
4867       <field name="_g_reserved5" introspectable="0">
4868         <callback name="_g_reserved5">
4869           <return-value transfer-ownership="none">
4870             <type name="none" c:type="void"/>
4871           </return-value>
4872         </callback>
4873       </field>
4874     </record>
4875     <record name="ConverterOutputStreamPrivate"
4876             c:type="GConverterOutputStreamPrivate"
4877             disguised="1">
4878     </record>
4879     <enumeration name="ConverterResult"
4880                  version="2.24"
4881                  glib:type-name="GConverterResult"
4882                  glib:get-type="g_converter_result_get_type"
4883                  c:type="GConverterResult">
4884       <doc xml:whitespace="preserve">Results returned from g_converter_convert().</doc>
4885       <member name="error"
4886               value="0"
4887               c:identifier="G_CONVERTER_ERROR"
4888               glib:nick="error"/>
4889       <member name="converted"
4890               value="1"
4891               c:identifier="G_CONVERTER_CONVERTED"
4892               glib:nick="converted"/>
4893       <member name="finished"
4894               value="2"
4895               c:identifier="G_CONVERTER_FINISHED"
4896               glib:nick="finished"/>
4897       <member name="flushed"
4898               value="3"
4899               c:identifier="G_CONVERTER_FLUSHED"
4900               glib:nick="flushed"/>
4901     </enumeration>
4902     <class name="Credentials"
4903            c:symbol-prefix="credentials"
4904            c:type="GCredentials"
4905            version="2.26"
4906            parent="GObject.Object"
4907            glib:type-name="GCredentials"
4908            glib:get-type="g_credentials_get_type"
4909            glib:type-struct="CredentialsClass">
4910       <doc xml:whitespace="preserve">The #GCredentials structure contains only private data and
4911 should only be accessed using the provided API.</doc>
4912       <constructor name="new" c:identifier="g_credentials_new" version="2.26">
4913         <doc xml:whitespace="preserve">Creates a new #GCredentials object with credentials matching the
4914 the current process.</doc>
4915         <return-value transfer-ownership="full">
4916           <doc xml:whitespace="preserve">A #GCredentials. Free with g_object_unref().</doc>
4917           <type name="Credentials" c:type="GCredentials*"/>
4918         </return-value>
4919       </constructor>
4920       <method name="get_native"
4921               c:identifier="g_credentials_get_native"
4922               version="2.26"
4923               introspectable="0">
4924         <doc xml:whitespace="preserve">Gets a pointer to native credentials of type @native_type from
4925 It is a programming error (which will cause an warning to be
4926 logged) to use this method if there is no #GCredentials support for
4927 the OS or if @native_type isn't supported by the OS.
4928 operation there is no #GCredentials support for the OS or if
4929 data, it is owned by @credentials.</doc>
4930         <return-value>
4931           <doc xml:whitespace="preserve">The pointer to native credentials or %NULL if the</doc>
4932           <type name="gpointer" c:type="gpointer"/>
4933         </return-value>
4934         <parameters>
4935           <parameter name="native_type" transfer-ownership="none">
4936             <doc xml:whitespace="preserve">The type of native credentials to get.</doc>
4937             <type name="CredentialsType" c:type="GCredentialsType"/>
4938           </parameter>
4939         </parameters>
4940       </method>
4941       <method name="get_unix_user"
4942               c:identifier="g_credentials_get_unix_user"
4943               version="2.26"
4944               throws="1">
4945         <doc xml:whitespace="preserve">Tries to get the UNIX user identifier from @credentials. This
4946 method is only available on UNIX platforms.
4947 This operation can fail if #GCredentials is not supported on the
4948 OS or if the native credentials type does not contain information
4949 about the UNIX user.</doc>
4950         <return-value transfer-ownership="none">
4951           <doc xml:whitespace="preserve">The UNIX user identifier or -1 if @error is set.</doc>
4952           <type name="guint" c:type="uid_t"/>
4953         </return-value>
4954       </method>
4955       <method name="is_same_user"
4956               c:identifier="g_credentials_is_same_user"
4957               version="2.26"
4958               throws="1">
4959         <doc xml:whitespace="preserve">Checks if @credentials and @other_credentials is the same user.
4960 This operation can fail if #GCredentials is not supported on the
4961 the OS.
4962 user, %FALSE otherwise or if @error is set.</doc>
4963         <return-value transfer-ownership="none">
4964           <doc xml:whitespace="preserve">%TRUE if @credentials and @other_credentials has the same</doc>
4965           <type name="gboolean" c:type="gboolean"/>
4966         </return-value>
4967         <parameters>
4968           <parameter name="other_credentials" transfer-ownership="none">
4969             <doc xml:whitespace="preserve">A #GCredentials.</doc>
4970             <type name="Credentials" c:type="GCredentials*"/>
4971           </parameter>
4972         </parameters>
4973       </method>
4974       <method name="set_native"
4975               c:identifier="g_credentials_set_native"
4976               version="2.26">
4977         <doc xml:whitespace="preserve">Copies the native credentials of type @native_type from @native
4978 into @credentials.
4979 It is a programming error (which will cause an warning to be
4980 logged) to use this method if there is no #GCredentials support for
4981 the OS or if @native_type isn't supported by the OS.</doc>
4982         <return-value transfer-ownership="none">
4983           <type name="none" c:type="void"/>
4984         </return-value>
4985         <parameters>
4986           <parameter name="native_type" transfer-ownership="none">
4987             <doc xml:whitespace="preserve">The type of native credentials to set.</doc>
4988             <type name="CredentialsType" c:type="GCredentialsType"/>
4989           </parameter>
4990           <parameter name="native" transfer-ownership="none">
4991             <doc xml:whitespace="preserve">A pointer to native credentials.</doc>
4992             <type name="gpointer" c:type="gpointer"/>
4993           </parameter>
4994         </parameters>
4995       </method>
4996       <method name="set_unix_user"
4997               c:identifier="g_credentials_set_unix_user"
4998               version="2.26"
4999               throws="1">
5000         <doc xml:whitespace="preserve">Tries to set the UNIX user identifier on @credentials. This method
5001 is only available on UNIX platforms.
5002 This operation can fail if #GCredentials is not supported on the
5003 OS or if the native credentials type does not contain information
5004 about the UNIX user.</doc>
5005         <return-value transfer-ownership="none">
5006           <doc xml:whitespace="preserve">%TRUE if @uid was set, %FALSE if error is set.</doc>
5007           <type name="gboolean" c:type="gboolean"/>
5008         </return-value>
5009         <parameters>
5010           <parameter name="uid" transfer-ownership="none">
5011             <doc xml:whitespace="preserve">The UNIX user identifier to set.</doc>
5012             <type name="guint" c:type="uid_t"/>
5013           </parameter>
5014         </parameters>
5015       </method>
5016       <method name="to_string"
5017               c:identifier="g_credentials_to_string"
5018               version="2.26">
5019         <doc xml:whitespace="preserve">Creates a human-readable textual representation of @credentials
5020 that can be used in logging and debug messages. The format of the
5021 returned string may change in future GLib release.</doc>
5022         <return-value transfer-ownership="full">
5023           <doc xml:whitespace="preserve">A string that should be freed with g_free().</doc>
5024           <type name="utf8" c:type="gchar*"/>
5025         </return-value>
5026       </method>
5027     </class>
5028     <record name="CredentialsClass"
5029             c:type="GCredentialsClass"
5030             disguised="1"
5031             glib:is-gtype-struct-for="Credentials"
5032             version="2.26">
5033       <doc xml:whitespace="preserve">Class structure for #GCredentials.</doc>
5034     </record>
5035     <enumeration name="CredentialsType"
5036                  version="2.26"
5037                  glib:type-name="GCredentialsType"
5038                  glib:get-type="g_credentials_type_get_type"
5039                  c:type="GCredentialsType">
5040       <doc xml:whitespace="preserve">Enumeration describing different kinds of native credential types.</doc>
5041       <member name="invalid"
5042               value="0"
5043               c:identifier="G_CREDENTIALS_TYPE_INVALID"
5044               glib:nick="invalid"/>
5045       <member name="linux_ucred"
5046               value="1"
5047               c:identifier="G_CREDENTIALS_TYPE_LINUX_UCRED"
5048               glib:nick="linux-ucred"/>
5049       <member name="freebsd_cmsgcred"
5050               value="2"
5051               c:identifier="G_CREDENTIALS_TYPE_FREEBSD_CMSGCRED"
5052               glib:nick="freebsd-cmsgcred"/>
5053     </enumeration>
5054     <record name="DBusAnnotationInfo"
5055             c:type="GDBusAnnotationInfo"
5056             version="2.26"
5057             glib:type-name="GDBusAnnotationInfo"
5058             glib:get-type="g_dbus_annotation_info_get_type"
5059             c:symbol-prefix="dbus_annotation_info">
5060       <doc xml:whitespace="preserve">Information about an annotation.</doc>
5061       <field name="ref_count" writable="1">
5062         <type name="gint" c:type="gint"/>
5063       </field>
5064       <field name="key" writable="1">
5065         <type name="utf8" c:type="gchar*"/>
5066       </field>
5067       <field name="value" writable="1">
5068         <type name="utf8" c:type="gchar*"/>
5069       </field>
5070       <field name="annotations" writable="1">
5071         <type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo**"/>
5072       </field>
5073       <method name="ref"
5074               c:identifier="g_dbus_annotation_info_ref"
5075               version="2.26">
5076         <doc xml:whitespace="preserve">If @info is statically allocated does nothing. Otherwise increases
5077 the reference count.</doc>
5078         <return-value transfer-ownership="full">
5079           <doc xml:whitespace="preserve">The same @info.</doc>
5080           <type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo*"/>
5081         </return-value>
5082       </method>
5083       <method name="unref"
5084               c:identifier="g_dbus_annotation_info_unref"
5085               version="2.26">
5086         <doc xml:whitespace="preserve">If @info is statically allocated, does nothing. Otherwise decreases
5087 the reference count of @info. When its reference count drops to 0,
5088 the memory used is freed.</doc>
5089         <return-value transfer-ownership="none">
5090           <type name="none" c:type="void"/>
5091         </return-value>
5092       </method>
5093     </record>
5094     <record name="DBusArgInfo"
5095             c:type="GDBusArgInfo"
5096             version="2.26"
5097             glib:type-name="GDBusArgInfo"
5098             glib:get-type="g_dbus_arg_info_get_type"
5099             c:symbol-prefix="dbus_arg_info">
5100       <doc xml:whitespace="preserve">Information about an argument for a method or a signal.</doc>
5101       <field name="ref_count" writable="1">
5102         <type name="gint" c:type="gint"/>
5103       </field>
5104       <field name="name" writable="1">
5105         <type name="utf8" c:type="gchar*"/>
5106       </field>
5107       <field name="signature" writable="1">
5108         <type name="utf8" c:type="gchar*"/>
5109       </field>
5110       <field name="annotations" writable="1">
5111         <type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo**"/>
5112       </field>
5113       <method name="ref" c:identifier="g_dbus_arg_info_ref" version="2.26">
5114         <doc xml:whitespace="preserve">If @info is statically allocated does nothing. Otherwise increases
5115 the reference count.</doc>
5116         <return-value transfer-ownership="full">
5117           <doc xml:whitespace="preserve">The same @info.</doc>
5118           <type name="DBusArgInfo" c:type="GDBusArgInfo*"/>
5119         </return-value>
5120       </method>
5121       <method name="unref" c:identifier="g_dbus_arg_info_unref" version="2.26">
5122         <doc xml:whitespace="preserve">If @info is statically allocated, does nothing. Otherwise decreases
5123 the reference count of @info. When its reference count drops to 0,
5124 the memory used is freed.</doc>
5125         <return-value transfer-ownership="none">
5126           <type name="none" c:type="void"/>
5127         </return-value>
5128       </method>
5129     </record>
5130     <class name="DBusAuthObserver"
5131            c:symbol-prefix="dbus_auth_observer"
5132            c:type="GDBusAuthObserver"
5133            version="2.26"
5134            parent="GObject.Object"
5135            glib:type-name="GDBusAuthObserver"
5136            glib:get-type="g_dbus_auth_observer_get_type">
5137       <doc xml:whitespace="preserve">The #GDBusAuthObserver structure contains only private data and
5138 should only be accessed using the provided API.</doc>
5139       <constructor name="new"
5140                    c:identifier="g_dbus_auth_observer_new"
5141                    version="2.26">
5142         <doc xml:whitespace="preserve">Creates a new #GDBusAuthObserver object.</doc>
5143         <return-value transfer-ownership="full">
5144           <doc xml:whitespace="preserve">A #GDBusAuthObserver. Free with g_object_unref().</doc>
5145           <type name="DBusAuthObserver" c:type="GDBusAuthObserver*"/>
5146         </return-value>
5147       </constructor>
5148       <method name="authorize_authenticated_peer"
5149               c:identifier="g_dbus_auth_observer_authorize_authenticated_peer"
5150               version="2.26">
5151         <doc xml:whitespace="preserve">Emits the #GDBusAuthObserver::authorize-authenticated-peer signal on @observer.</doc>
5152         <return-value transfer-ownership="none">
5153           <doc xml:whitespace="preserve">%TRUE if the peer is authorized, %FALSE if not.</doc>
5154           <type name="gboolean" c:type="gboolean"/>
5155         </return-value>
5156         <parameters>
5157           <parameter name="stream" transfer-ownership="none">
5158             <doc xml:whitespace="preserve">A #GIOStream for the #GDBusConnection.</doc>
5159             <type name="IOStream" c:type="GIOStream*"/>
5160           </parameter>
5161           <parameter name="credentials" transfer-ownership="none">
5162             <doc xml:whitespace="preserve">Credentials received from the peer or %NULL.</doc>
5163             <type name="Credentials" c:type="GCredentials*"/>
5164           </parameter>
5165         </parameters>
5166       </method>
5167       <glib:signal name="authorize-authenticated-peer" version="2.26">
5168         <doc xml:whitespace="preserve">Emitted to check if a peer that is successfully authenticated
5169 is authorized.</doc>
5170         <return-value transfer-ownership="none">
5171           <doc xml:whitespace="preserve">%TRUE if the peer is authorized, %FALSE if not.</doc>
5172           <type name="gboolean"/>
5173         </return-value>
5174         <parameters>
5175           <parameter name="object" transfer-ownership="none">
5176             <doc xml:whitespace="preserve">A #GIOStream for the #GDBusConnection.</doc>
5177             <type name="IOStream"/>
5178           </parameter>
5179           <parameter name="p0" transfer-ownership="none">
5180             <doc xml:whitespace="preserve">Credentials received from the peer or %NULL.</doc>
5181             <type name="Credentials"/>
5182           </parameter>
5183         </parameters>
5184       </glib:signal>
5185     </class>
5186     <bitfield name="DBusCallFlags"
5187               version="2.26"
5188               glib:type-name="GDBusCallFlags"
5189               glib:get-type="g_dbus_call_flags_get_type"
5190               c:type="GDBusCallFlags">
5191       <doc xml:whitespace="preserve">Flags used in g_dbus_connection_call() and similar APIs.</doc>
5192       <member name="none"
5193               value="0"
5194               c:identifier="G_DBUS_CALL_FLAGS_NONE"
5195               glib:nick="none"/>
5196       <member name="no_auto_start"
5197               value="1"
5198               c:identifier="G_DBUS_CALL_FLAGS_NO_AUTO_START"
5199               glib:nick="no-auto-start"/>
5200     </bitfield>
5201     <bitfield name="DBusCapabilityFlags"
5202               version="2.26"
5203               glib:type-name="GDBusCapabilityFlags"
5204               glib:get-type="g_dbus_capability_flags_get_type"
5205               c:type="GDBusCapabilityFlags">
5206       <doc xml:whitespace="preserve">Capabilities negotiated with the remote peer.</doc>
5207       <member name="none"
5208               value="0"
5209               c:identifier="G_DBUS_CAPABILITY_FLAGS_NONE"
5210               glib:nick="none"/>
5211       <member name="unix_fd_passing"
5212               value="1"
5213               c:identifier="G_DBUS_CAPABILITY_FLAGS_UNIX_FD_PASSING"
5214               glib:nick="unix-fd-passing"/>
5215     </bitfield>
5216     <class name="DBusConnection"
5217            c:symbol-prefix="dbus_connection"
5218            c:type="GDBusConnection"
5219            version="2.26"
5220            parent="GObject.Object"
5221            glib:type-name="GDBusConnection"
5222            glib:get-type="g_dbus_connection_get_type">
5223       <doc xml:whitespace="preserve">The #GDBusConnection structure contains only private data and
5224 should only be accessed using the provided API.</doc>
5225       <implements name="AsyncInitable"/>
5226       <implements name="Initable"/>
5227       <constructor name="new_finish"
5228                    c:identifier="g_dbus_connection_new_finish"
5229                    version="2.26"
5230                    throws="1">
5231         <doc xml:whitespace="preserve">Finishes an operation started with g_dbus_connection_new().</doc>
5232         <return-value transfer-ownership="full">
5233           <doc xml:whitespace="preserve">A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().</doc>
5234           <type name="DBusConnection" c:type="GDBusConnection*"/>
5235         </return-value>
5236         <parameters>
5237           <parameter name="res" transfer-ownership="none">
5238             <doc xml:whitespace="preserve">A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_new().</doc>
5239             <type name="AsyncResult" c:type="GAsyncResult*"/>
5240           </parameter>
5241         </parameters>
5242       </constructor>
5243       <constructor name="new_for_address_finish"
5244                    c:identifier="g_dbus_connection_new_for_address_finish"
5245                    version="2.26"
5246                    throws="1">
5247         <doc xml:whitespace="preserve">Finishes an operation started with g_dbus_connection_new_for_address().</doc>
5248         <return-value transfer-ownership="full">
5249           <doc xml:whitespace="preserve">A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().</doc>
5250           <type name="DBusConnection" c:type="GDBusConnection*"/>
5251         </return-value>
5252         <parameters>
5253           <parameter name="res" transfer-ownership="none">
5254             <doc xml:whitespace="preserve">A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_new().</doc>
5255             <type name="AsyncResult" c:type="GAsyncResult*"/>
5256           </parameter>
5257         </parameters>
5258       </constructor>
5259       <constructor name="new_for_address_sync"
5260                    c:identifier="g_dbus_connection_new_for_address_sync"
5261                    version="2.26"
5262                    throws="1">
5263         <doc xml:whitespace="preserve">Synchronously connects and sets up a D-Bus client connection for
5264 exchanging D-Bus messages with an endpoint specified by @address
5265 which must be in the D-Bus address format.
5266 This constructor can only be used to initiate client-side
5267 connections - use g_dbus_connection_new_sync() if you need to act
5268 as the server. In particular, @flags cannot contain the
5269 %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER or
5270 %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS flags.
5271 This is a synchronous failable constructor. See
5272 g_dbus_connection_new_for_address() for the asynchronous version.
5273 If @observer is not %NULL it may be used to control the
5274 authentication process.</doc>
5275         <return-value transfer-ownership="full">
5276           <doc xml:whitespace="preserve">A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().</doc>
5277           <type name="DBusConnection" c:type="GDBusConnection*"/>
5278         </return-value>
5279         <parameters>
5280           <parameter name="address" transfer-ownership="none">
5281             <doc xml:whitespace="preserve">A D-Bus address.</doc>
5282             <type name="utf8" c:type="gchar*"/>
5283           </parameter>
5284           <parameter name="flags" transfer-ownership="none">
5285             <doc xml:whitespace="preserve">Flags describing how to make the connection.</doc>
5286             <type name="DBusConnectionFlags" c:type="GDBusConnectionFlags"/>
5287           </parameter>
5288           <parameter name="observer" transfer-ownership="none">
5289             <doc xml:whitespace="preserve">A #GDBusAuthObserver or %NULL.</doc>
5290             <type name="DBusAuthObserver" c:type="GDBusAuthObserver*"/>
5291           </parameter>
5292           <parameter name="cancellable"
5293                      transfer-ownership="none"
5294                      allow-none="1">
5295             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
5296             <type name="Cancellable" c:type="GCancellable*"/>
5297           </parameter>
5298         </parameters>
5299       </constructor>
5300       <constructor name="new_sync"
5301                    c:identifier="g_dbus_connection_new_sync"
5302                    version="2.26"
5303                    throws="1">
5304         <doc xml:whitespace="preserve">Synchronously sets up a D-Bus connection for exchanging D-Bus messages
5305 with the end represented by @stream.
5306 If @observer is not %NULL it may be used to control the
5307 authentication process.
5308 This is a synchronous failable constructor. See
5309 g_dbus_connection_new() for the asynchronous version.</doc>
5310         <return-value transfer-ownership="full">
5311           <doc xml:whitespace="preserve">A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().</doc>
5312           <type name="DBusConnection" c:type="GDBusConnection*"/>
5313         </return-value>
5314         <parameters>
5315           <parameter name="stream" transfer-ownership="none">
5316             <doc xml:whitespace="preserve">A #GIOStream.</doc>
5317             <type name="IOStream" c:type="GIOStream*"/>
5318           </parameter>
5319           <parameter name="guid" transfer-ownership="none">
5320             <doc xml:whitespace="preserve">The GUID to use if a authenticating as a server or %NULL.</doc>
5321             <type name="utf8" c:type="gchar*"/>
5322           </parameter>
5323           <parameter name="flags" transfer-ownership="none">
5324             <doc xml:whitespace="preserve">Flags describing how to make the connection.</doc>
5325             <type name="DBusConnectionFlags" c:type="GDBusConnectionFlags"/>
5326           </parameter>
5327           <parameter name="observer" transfer-ownership="none">
5328             <doc xml:whitespace="preserve">A #GDBusAuthObserver or %NULL.</doc>
5329             <type name="DBusAuthObserver" c:type="GDBusAuthObserver*"/>
5330           </parameter>
5331           <parameter name="cancellable"
5332                      transfer-ownership="none"
5333                      allow-none="1">
5334             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
5335             <type name="Cancellable" c:type="GCancellable*"/>
5336           </parameter>
5337         </parameters>
5338       </constructor>
5339       <function name="new" c:identifier="g_dbus_connection_new" version="2.26">
5340         <doc xml:whitespace="preserve">Asynchronously sets up a D-Bus connection for exchanging D-Bus messages
5341 with the end represented by @stream.
5342 If @observer is not %NULL it may be used to control the
5343 authentication process.
5344 When the operation is finished, @callback will be invoked. You can
5345 then call g_dbus_connection_new_finish() to get the result of the
5346 operation.
5347 This is a asynchronous failable constructor. See
5348 g_dbus_connection_new_sync() for the synchronous
5349 version.</doc>
5350         <return-value transfer-ownership="none">
5351           <type name="none" c:type="void"/>
5352         </return-value>
5353         <parameters>
5354           <parameter name="stream" transfer-ownership="none">
5355             <doc xml:whitespace="preserve">A #GIOStream.</doc>
5356             <type name="IOStream" c:type="GIOStream*"/>
5357           </parameter>
5358           <parameter name="guid" transfer-ownership="none">
5359             <doc xml:whitespace="preserve">The GUID to use if a authenticating as a server or %NULL.</doc>
5360             <type name="utf8" c:type="gchar*"/>
5361           </parameter>
5362           <parameter name="flags" transfer-ownership="none">
5363             <doc xml:whitespace="preserve">Flags describing how to make the connection.</doc>
5364             <type name="DBusConnectionFlags" c:type="GDBusConnectionFlags"/>
5365           </parameter>
5366           <parameter name="observer" transfer-ownership="none">
5367             <doc xml:whitespace="preserve">A #GDBusAuthObserver or %NULL.</doc>
5368             <type name="DBusAuthObserver" c:type="GDBusAuthObserver*"/>
5369           </parameter>
5370           <parameter name="cancellable"
5371                      transfer-ownership="none"
5372                      allow-none="1">
5373             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
5374             <type name="Cancellable" c:type="GCancellable*"/>
5375           </parameter>
5376           <parameter name="callback"
5377                      transfer-ownership="none"
5378                      scope="async"
5379                      closure="6">
5380             <doc xml:whitespace="preserve">A #GAsyncReadyCallback to call when the request is satisfied.</doc>
5381             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
5382           </parameter>
5383           <parameter name="user_data" transfer-ownership="none">
5384             <doc xml:whitespace="preserve">The data to pass to @callback.</doc>
5385             <type name="gpointer" c:type="gpointer"/>
5386           </parameter>
5387         </parameters>
5388       </function>
5389       <function name="new_for_address"
5390                 c:identifier="g_dbus_connection_new_for_address"
5391                 version="2.26">
5392         <doc xml:whitespace="preserve">Asynchronously connects and sets up a D-Bus client connection for
5393 exchanging D-Bus messages with an endpoint specified by @address
5394 which must be in the D-Bus address format.
5395 This constructor can only be used to initiate client-side
5396 connections - use g_dbus_connection_new() if you need to act as the
5397 server. In particular, @flags cannot contain the
5398 %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER or
5399 %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS flags.
5400 When the operation is finished, @callback will be invoked. You can
5401 then call g_dbus_connection_new_finish() to get the result of the
5402 operation.
5403 If @observer is not %NULL it may be used to control the
5404 authentication process.
5405 This is a asynchronous failable constructor. See
5406 g_dbus_connection_new_for_address_sync() for the synchronous
5407 version.</doc>
5408         <return-value transfer-ownership="none">
5409           <type name="none" c:type="void"/>
5410         </return-value>
5411         <parameters>
5412           <parameter name="address" transfer-ownership="none">
5413             <doc xml:whitespace="preserve">A D-Bus address.</doc>
5414             <type name="utf8" c:type="gchar*"/>
5415           </parameter>
5416           <parameter name="flags" transfer-ownership="none">
5417             <doc xml:whitespace="preserve">Flags describing how to make the connection.</doc>
5418             <type name="DBusConnectionFlags" c:type="GDBusConnectionFlags"/>
5419           </parameter>
5420           <parameter name="observer" transfer-ownership="none">
5421             <doc xml:whitespace="preserve">A #GDBusAuthObserver or %NULL.</doc>
5422             <type name="DBusAuthObserver" c:type="GDBusAuthObserver*"/>
5423           </parameter>
5424           <parameter name="cancellable"
5425                      transfer-ownership="none"
5426                      allow-none="1">
5427             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
5428             <type name="Cancellable" c:type="GCancellable*"/>
5429           </parameter>
5430           <parameter name="callback"
5431                      transfer-ownership="none"
5432                      scope="async"
5433                      closure="5">
5434             <doc xml:whitespace="preserve">A #GAsyncReadyCallback to call when the request is satisfied.</doc>
5435             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
5436           </parameter>
5437           <parameter name="user_data" transfer-ownership="none">
5438             <doc xml:whitespace="preserve">The data to pass to @callback.</doc>
5439             <type name="gpointer" c:type="gpointer"/>
5440           </parameter>
5441         </parameters>
5442       </function>
5443       <method name="add_filter"
5444               c:identifier="g_dbus_connection_add_filter"
5445               version="2.26">
5446         <doc xml:whitespace="preserve">Adds a message filter. Filters are handlers that are run on all
5447 incoming and outgoing messages, prior to standard dispatch. Filters
5448 are run in the order that they were added.  The same handler can be
5449 added as a filter more than once, in which case it will be run more
5450 than once.  Filters added during a filter callback won't be run on
5451 the message being processed. Filter functions are allowed to modify
5452 and even drop messages - see the #GDBusMessageFilterResult
5453 enumeration for details.
5454 Note that filters are run in a dedicated message handling thread so
5455 they can't block and, generally, can't do anything but signal a
5456 worker thread. Also note that filters are rarely needed - use API
5457 such as g_dbus_connection_send_message_with_reply(),
5458 g_dbus_connection_signal_subscribe() or
5459 g_dbus_connection_call() instead.
5460 If a filter consumes an incoming message the message is not
5461 dispatched anywhere else - not even the standard dispatch machinery
5462 (that API such as g_dbus_connection_signal_subscribe() and
5463 g_dbus_connection_send_message_with_reply() relies on) will see the
5464 message. Similary, if a filter consumes an outgoing message, the
5465 message will not be sent to the other peer.
5466 g_dbus_connection_remove_filter().</doc>
5467         <return-value transfer-ownership="none">
5468           <doc xml:whitespace="preserve">A filter identifier that can be used with</doc>
5469           <type name="guint" c:type="guint"/>
5470         </return-value>
5471         <parameters>
5472           <parameter name="filter_function"
5473                      transfer-ownership="none"
5474                      scope="notified"
5475                      closure="1"
5476                      destroy="2">
5477             <doc xml:whitespace="preserve">A filter function.</doc>
5478             <type name="DBusMessageFilterFunction"
5479                   c:type="GDBusMessageFilterFunction"/>
5480           </parameter>
5481           <parameter name="user_data" transfer-ownership="none">
5482             <doc xml:whitespace="preserve">User data to pass to @filter_function.</doc>
5483             <type name="gpointer" c:type="gpointer"/>
5484           </parameter>
5485           <parameter name="user_data_free_func"
5486                      transfer-ownership="none"
5487                      scope="async">
5488             <doc xml:whitespace="preserve">Function to free @user_data with when filter is removed or %NULL.</doc>
5489             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
5490           </parameter>
5491         </parameters>
5492       </method>
5493       <method name="call" c:identifier="g_dbus_connection_call" version="2.26">
5494         <doc xml:whitespace="preserve">Asynchronously invokes the @method_name method on the
5495 If @connection is closed then the operation will fail with
5496 %G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will
5497 fail with %G_IO_ERROR_CANCELLED. If @parameters contains a value
5498 not compatible with the D-Bus protocol, the operation fails with
5499 %G_IO_ERROR_INVALID_ARGUMENT.
5500 If @reply_type is non-%NULL then the reply will be checked for having this type and an
5501 error will be raised if it does not match.  Said another way, if you give a @reply_type
5502 then any non-%NULL return value will be of this type.
5503 If the @parameters #GVariant is floating, it is consumed. This allows
5504 convenient 'inline' use of g_variant_new(), e.g.:
5505 |[
5506 g_dbus_connection_call (connection,
5507 "org.freedesktop.StringThings",
5508 "/org/freedesktop/StringThings",
5509 "org.freedesktop.StringThings",
5510 "TwoStrings",
5511 g_variant_new ("(ss)",
5512 "Thing One",
5513 "Thing Two"),
5514 NULL,
5515 G_DBUS_CALL_FLAGS_NONE,
5516 -1,
5517 NULL,
5518 (GAsyncReadyCallback) two_strings_done,
5519 NULL);
5520 ]|
5521 This is an asynchronous method. When the operation is finished, @callback will be invoked
5522 in the &lt;link linkend="g-main-context-push-thread-default"&gt;thread-default main loop&lt;/link&gt;
5523 of the thread you are calling this method from. You can then call
5524 g_dbus_connection_call_finish() to get the result of the operation.
5525 See g_dbus_connection_call_sync() for the synchronous version of this
5526 function.</doc>
5527         <return-value transfer-ownership="none">
5528           <type name="none" c:type="void"/>
5529         </return-value>
5530         <parameters>
5531           <parameter name="bus_name" transfer-ownership="none">
5532             <doc xml:whitespace="preserve">A unique or well-known bus name or %NULL if @connection is not a message bus connection.</doc>
5533             <type name="utf8" c:type="gchar*"/>
5534           </parameter>
5535           <parameter name="object_path" transfer-ownership="none">
5536             <doc xml:whitespace="preserve">Path of remote object.</doc>
5537             <type name="utf8" c:type="gchar*"/>
5538           </parameter>
5539           <parameter name="interface_name" transfer-ownership="none">
5540             <doc xml:whitespace="preserve">D-Bus interface to invoke method on.</doc>
5541             <type name="utf8" c:type="gchar*"/>
5542           </parameter>
5543           <parameter name="method_name" transfer-ownership="none">
5544             <doc xml:whitespace="preserve">The name of the method to invoke.</doc>
5545             <type name="utf8" c:type="gchar*"/>
5546           </parameter>
5547           <parameter name="parameters" transfer-ownership="none">
5548             <doc xml:whitespace="preserve">A #GVariant tuple with parameters for the method or %NULL if not passing parameters.</doc>
5549             <type name="GLib.Variant" c:type="GVariant*"/>
5550           </parameter>
5551           <parameter name="reply_type" transfer-ownership="none">
5552             <doc xml:whitespace="preserve">The expected type of the reply, or %NULL.</doc>
5553             <type name="GLib.VariantType" c:type="GVariantType*"/>
5554           </parameter>
5555           <parameter name="flags" transfer-ownership="none">
5556             <doc xml:whitespace="preserve">Flags from the #GDBusCallFlags enumeration.</doc>
5557             <type name="DBusCallFlags" c:type="GDBusCallFlags"/>
5558           </parameter>
5559           <parameter name="timeout_msec" transfer-ownership="none">
5560             <doc xml:whitespace="preserve">The timeout in milliseconds or -1 to use the default timeout.</doc>
5561             <type name="gint" c:type="gint"/>
5562           </parameter>
5563           <parameter name="cancellable"
5564                      transfer-ownership="none"
5565                      allow-none="1">
5566             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
5567             <type name="Cancellable" c:type="GCancellable*"/>
5568           </parameter>
5569           <parameter name="callback"
5570                      transfer-ownership="none"
5571                      scope="async"
5572                      closure="10">
5573             <doc xml:whitespace="preserve">A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't care about the result of the method invocation.</doc>
5574             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
5575           </parameter>
5576           <parameter name="user_data" transfer-ownership="none">
5577             <doc xml:whitespace="preserve">The data to pass to @callback.</doc>
5578             <type name="gpointer" c:type="gpointer"/>
5579           </parameter>
5580         </parameters>
5581       </method>
5582       <method name="call_finish"
5583               c:identifier="g_dbus_connection_call_finish"
5584               version="2.26"
5585               throws="1">
5586         <doc xml:whitespace="preserve">Finishes an operation started with g_dbus_connection_call().
5587 return values. Free with g_variant_unref().</doc>
5588         <return-value transfer-ownership="full">
5589           <doc xml:whitespace="preserve">%NULL if @error is set. Otherwise a #GVariant tuple with</doc>
5590           <type name="GLib.Variant" c:type="GVariant*"/>
5591         </return-value>
5592         <parameters>
5593           <parameter name="res" transfer-ownership="none">
5594             <doc xml:whitespace="preserve">A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_call().</doc>
5595             <type name="AsyncResult" c:type="GAsyncResult*"/>
5596           </parameter>
5597         </parameters>
5598       </method>
5599       <method name="call_sync"
5600               c:identifier="g_dbus_connection_call_sync"
5601               version="2.26"
5602               throws="1">
5603         <doc xml:whitespace="preserve">Synchronously invokes the @method_name method on the
5604 If @connection is closed then the operation will fail with
5605 %G_IO_ERROR_CLOSED. If @cancellable is canceled, the
5606 operation will fail with %G_IO_ERROR_CANCELLED. If @parameters
5607 contains a value not compatible with the D-Bus protocol, the operation
5608 fails with %G_IO_ERROR_INVALID_ARGUMENT.
5609 If @reply_type is non-%NULL then the reply will be checked for having
5610 this type and an error will be raised if it does not match.  Said
5611 another way, if you give a @reply_type then any non-%NULL return
5612 value will be of this type.
5613 If the @parameters #GVariant is floating, it is consumed.
5614 This allows convenient 'inline' use of g_variant_new(), e.g.:
5615 |[
5616 g_dbus_connection_call_sync (connection,
5617 "org.freedesktop.StringThings",
5618 "/org/freedesktop/StringThings",
5619 "org.freedesktop.StringThings",
5620 "TwoStrings",
5621 g_variant_new ("(ss)",
5622 "Thing One",
5623 "Thing Two"),
5624 NULL,
5625 G_DBUS_CALL_FLAGS_NONE,
5626 -1,
5627 NULL,
5628 &amp;amp;error);
5629 ]|
5630 The calling thread is blocked until a reply is received. See
5631 g_dbus_connection_call() for the asynchronous version of
5632 this method.
5633 return values. Free with g_variant_unref().</doc>
5634         <return-value transfer-ownership="full">
5635           <doc xml:whitespace="preserve">%NULL if @error is set. Otherwise a #GVariant tuple with</doc>
5636           <type name="GLib.Variant" c:type="GVariant*"/>
5637         </return-value>
5638         <parameters>
5639           <parameter name="bus_name" transfer-ownership="none">
5640             <doc xml:whitespace="preserve">A unique or well-known bus name.</doc>
5641             <type name="utf8" c:type="gchar*"/>
5642           </parameter>
5643           <parameter name="object_path" transfer-ownership="none">
5644             <doc xml:whitespace="preserve">Path of remote object.</doc>
5645             <type name="utf8" c:type="gchar*"/>
5646           </parameter>
5647           <parameter name="interface_name" transfer-ownership="none">
5648             <doc xml:whitespace="preserve">D-Bus interface to invoke method on.</doc>
5649             <type name="utf8" c:type="gchar*"/>
5650           </parameter>
5651           <parameter name="method_name" transfer-ownership="none">
5652             <doc xml:whitespace="preserve">The name of the method to invoke.</doc>
5653             <type name="utf8" c:type="gchar*"/>
5654           </parameter>
5655           <parameter name="parameters" transfer-ownership="none">
5656             <doc xml:whitespace="preserve">A #GVariant tuple with parameters for the method or %NULL if not passing parameters.</doc>
5657             <type name="GLib.Variant" c:type="GVariant*"/>
5658           </parameter>
5659           <parameter name="reply_type" transfer-ownership="none">
5660             <doc xml:whitespace="preserve">The expected type of the reply, or %NULL.</doc>
5661             <type name="GLib.VariantType" c:type="GVariantType*"/>
5662           </parameter>
5663           <parameter name="flags" transfer-ownership="none">
5664             <doc xml:whitespace="preserve">Flags from the #GDBusCallFlags enumeration.</doc>
5665             <type name="DBusCallFlags" c:type="GDBusCallFlags"/>
5666           </parameter>
5667           <parameter name="timeout_msec" transfer-ownership="none">
5668             <doc xml:whitespace="preserve">The timeout in milliseconds or -1 to use the default timeout.</doc>
5669             <type name="gint" c:type="gint"/>
5670           </parameter>
5671           <parameter name="cancellable"
5672                      transfer-ownership="none"
5673                      allow-none="1">
5674             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
5675             <type name="Cancellable" c:type="GCancellable*"/>
5676           </parameter>
5677         </parameters>
5678       </method>
5679       <method name="close"
5680               c:identifier="g_dbus_connection_close"
5681               version="2.26">
5682         <doc xml:whitespace="preserve">Closes @connection. Note that this never causes the process to
5683 exit (this might only happen if the other end of a shared message
5684 bus connection disconnects, see #GDBusConnection:exit-on-close).
5685 Once the connection is closed, operations such as sending a message
5686 will return with the error %G_IO_ERROR_CLOSED. Closing a connection
5687 will not automatically flush the connection so queued messages may
5688 be lost. Use g_dbus_connection_flush() if you need such guarantees.
5689 If @connection is already closed, this method fails with
5690 %G_IO_ERROR_CLOSED.
5691 When @connection has been closed, the #GDBusConnection::closed
5692 signal is emitted in the &lt;link
5693 linkend="g-main-context-push-thread-default"&gt;thread-default main
5694 loop&lt;/link&gt; of the thread that @connection was constructed in.
5695 This is an asynchronous method. When the operation is finished,
5696 linkend="g-main-context-push-thread-default"&gt;thread-default main
5697 loop&lt;/link&gt; of the thread you are calling this method from. You can
5698 then call g_dbus_connection_close_finish() to get the result of the
5699 operation.  See g_dbus_connection_close_sync() for the synchronous
5700 version.</doc>
5701         <return-value transfer-ownership="none">
5702           <type name="none" c:type="void"/>
5703         </return-value>
5704         <parameters>
5705           <parameter name="cancellable"
5706                      transfer-ownership="none"
5707                      allow-none="1">
5708             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
5709             <type name="Cancellable" c:type="GCancellable*"/>
5710           </parameter>
5711           <parameter name="callback"
5712                      transfer-ownership="none"
5713                      scope="async"
5714                      closure="2">
5715             <doc xml:whitespace="preserve">A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't care about the result.</doc>
5716             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
5717           </parameter>
5718           <parameter name="user_data" transfer-ownership="none">
5719             <doc xml:whitespace="preserve">The data to pass to @callback.</doc>
5720             <type name="gpointer" c:type="gpointer"/>
5721           </parameter>
5722         </parameters>
5723       </method>
5724       <method name="close_finish"
5725               c:identifier="g_dbus_connection_close_finish"
5726               version="2.26"
5727               throws="1">
5728         <doc xml:whitespace="preserve">Finishes an operation started with g_dbus_connection_close().</doc>
5729         <return-value transfer-ownership="none">
5730           <doc xml:whitespace="preserve">%TRUE if the operation succeeded, %FALSE if @error is set.</doc>
5731           <type name="gboolean" c:type="gboolean"/>
5732         </return-value>
5733         <parameters>
5734           <parameter name="res" transfer-ownership="none">
5735             <doc xml:whitespace="preserve">A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_close().</doc>
5736             <type name="AsyncResult" c:type="GAsyncResult*"/>
5737           </parameter>
5738         </parameters>
5739       </method>
5740       <method name="close_sync"
5741               c:identifier="g_dbus_connection_close_sync"
5742               version="2.26"
5743               throws="1">
5744         <doc xml:whitespace="preserve">Synchronously closees @connection. The calling thread is blocked
5745 until this is done. See g_dbus_connection_close() for the
5746 asynchronous version of this method and more details about what it
5747 does.</doc>
5748         <return-value transfer-ownership="none">
5749           <doc xml:whitespace="preserve">%TRUE if the operation succeeded, %FALSE if @error is set.</doc>
5750           <type name="gboolean" c:type="gboolean"/>
5751         </return-value>
5752         <parameters>
5753           <parameter name="cancellable"
5754                      transfer-ownership="none"
5755                      allow-none="1">
5756             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
5757             <type name="Cancellable" c:type="GCancellable*"/>
5758           </parameter>
5759         </parameters>
5760       </method>
5761       <method name="emit_signal"
5762               c:identifier="g_dbus_connection_emit_signal"
5763               version="2.26"
5764               throws="1">
5765         <doc xml:whitespace="preserve">Emits a signal.
5766 If the parameters GVariant is floating, it is consumed.
5767 This can only fail if @parameters is not compatible with the D-Bus protocol.</doc>
5768         <return-value transfer-ownership="none">
5769           <doc xml:whitespace="preserve">%TRUE unless @error is set.</doc>
5770           <type name="gboolean" c:type="gboolean"/>
5771         </return-value>
5772         <parameters>
5773           <parameter name="destination_bus_name" transfer-ownership="none">
5774             <doc xml:whitespace="preserve">The unique bus name for the destination for the signal or %NULL to emit to all listeners.</doc>
5775             <type name="utf8" c:type="gchar*"/>
5776           </parameter>
5777           <parameter name="object_path" transfer-ownership="none">
5778             <doc xml:whitespace="preserve">Path of remote object.</doc>
5779             <type name="utf8" c:type="gchar*"/>
5780           </parameter>
5781           <parameter name="interface_name" transfer-ownership="none">
5782             <doc xml:whitespace="preserve">D-Bus interface to emit a signal on.</doc>
5783             <type name="utf8" c:type="gchar*"/>
5784           </parameter>
5785           <parameter name="signal_name" transfer-ownership="none">
5786             <doc xml:whitespace="preserve">The name of the signal to emit.</doc>
5787             <type name="utf8" c:type="gchar*"/>
5788           </parameter>
5789           <parameter name="parameters" transfer-ownership="none">
5790             <doc xml:whitespace="preserve">A #GVariant tuple with parameters for the signal or %NULL if not passing parameters.</doc>
5791             <type name="GLib.Variant" c:type="GVariant*"/>
5792           </parameter>
5793         </parameters>
5794       </method>
5795       <method name="flush"
5796               c:identifier="g_dbus_connection_flush"
5797               version="2.26">
5798         <doc xml:whitespace="preserve">Asynchronously flushes @connection, that is, writes all queued
5799 outgoing message to the transport and then flushes the transport
5800 (using g_output_stream_flush_async()). This is useful in programs
5801 that wants to emit a D-Bus signal and then exit
5802 immediately. Without flushing the connection, there is no guarantee
5803 that the message has been sent to the networking buffers in the OS
5804 kernel.
5805 This is an asynchronous method. When the operation is finished,
5806 linkend="g-main-context-push-thread-default"&gt;thread-default main
5807 loop&lt;/link&gt; of the thread you are calling this method from. You can
5808 then call g_dbus_connection_flush_finish() to get the result of the
5809 operation.  See g_dbus_connection_flush_sync() for the synchronous
5810 version.</doc>
5811         <return-value transfer-ownership="none">
5812           <type name="none" c:type="void"/>
5813         </return-value>
5814         <parameters>
5815           <parameter name="cancellable"
5816                      transfer-ownership="none"
5817                      allow-none="1">
5818             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
5819             <type name="Cancellable" c:type="GCancellable*"/>
5820           </parameter>
5821           <parameter name="callback"
5822                      transfer-ownership="none"
5823                      scope="async"
5824                      closure="2">
5825             <doc xml:whitespace="preserve">A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't care about the result.</doc>
5826             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
5827           </parameter>
5828           <parameter name="user_data" transfer-ownership="none">
5829             <doc xml:whitespace="preserve">The data to pass to @callback.</doc>
5830             <type name="gpointer" c:type="gpointer"/>
5831           </parameter>
5832         </parameters>
5833       </method>
5834       <method name="flush_finish"
5835               c:identifier="g_dbus_connection_flush_finish"
5836               version="2.26"
5837               throws="1">
5838         <doc xml:whitespace="preserve">Finishes an operation started with g_dbus_connection_flush().</doc>
5839         <return-value transfer-ownership="none">
5840           <doc xml:whitespace="preserve">%TRUE if the operation succeeded, %FALSE if @error is set.</doc>
5841           <type name="gboolean" c:type="gboolean"/>
5842         </return-value>
5843         <parameters>
5844           <parameter name="res" transfer-ownership="none">
5845             <doc xml:whitespace="preserve">A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_flush().</doc>
5846             <type name="AsyncResult" c:type="GAsyncResult*"/>
5847           </parameter>
5848         </parameters>
5849       </method>
5850       <method name="flush_sync"
5851               c:identifier="g_dbus_connection_flush_sync"
5852               version="2.26"
5853               throws="1">
5854         <doc xml:whitespace="preserve">Synchronously flushes @connection. The calling thread is blocked
5855 until this is done. See g_dbus_connection_flush() for the
5856 asynchronous version of this method and more details about what it
5857 does.</doc>
5858         <return-value transfer-ownership="none">
5859           <doc xml:whitespace="preserve">%TRUE if the operation succeeded, %FALSE if @error is set.</doc>
5860           <type name="gboolean" c:type="gboolean"/>
5861         </return-value>
5862         <parameters>
5863           <parameter name="cancellable"
5864                      transfer-ownership="none"
5865                      allow-none="1">
5866             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
5867             <type name="Cancellable" c:type="GCancellable*"/>
5868           </parameter>
5869         </parameters>
5870       </method>
5871       <method name="get_capabilities"
5872               c:identifier="g_dbus_connection_get_capabilities"
5873               version="2.26">
5874         <doc xml:whitespace="preserve">Gets the capabilities negotiated with the remote peer</doc>
5875         <return-value transfer-ownership="none">
5876           <doc xml:whitespace="preserve">Zero or more flags from the #GDBusCapabilityFlags enumeration.</doc>
5877           <type name="DBusCapabilityFlags" c:type="GDBusCapabilityFlags"/>
5878         </return-value>
5879       </method>
5880       <method name="get_exit_on_close"
5881               c:identifier="g_dbus_connection_get_exit_on_close"
5882               version="2.26">
5883         <doc xml:whitespace="preserve">Gets whether the process is terminated when @connection is
5884 closed by the remote peer. See
5885 #GDBusConnection:exit-on-close for more details.
5886 closed by the remote peer.</doc>
5887         <return-value transfer-ownership="none">
5888           <doc xml:whitespace="preserve">Whether the process is terminated when @connection is</doc>
5889           <type name="gboolean" c:type="gboolean"/>
5890         </return-value>
5891       </method>
5892       <method name="get_guid"
5893               c:identifier="g_dbus_connection_get_guid"
5894               version="2.26">
5895         <doc xml:whitespace="preserve">The GUID of the peer performing the role of server when
5896 authenticating. See #GDBusConnection:guid for more details.</doc>
5897         <return-value transfer-ownership="none">
5898           <doc xml:whitespace="preserve">The GUID. Do not free this string, it is owned by</doc>
5899           <type name="utf8" c:type="gchar*"/>
5900         </return-value>
5901       </method>
5902       <method name="get_peer_credentials"
5903               c:identifier="g_dbus_connection_get_peer_credentials"
5904               version="2.26">
5905         <doc xml:whitespace="preserve">Gets the credentials of the authenticated peer. This will always
5906 return %NULL unless @connection acted as a server
5907 (e.g. %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER was passed)
5908 when set up and the client passed credentials as part of the
5909 authentication process.
5910 In a message bus setup, the message bus is always the server and
5911 each application is a client. So this method will always return
5912 %NULL for message bus clients.
5913 this object, it is owned by @connection.</doc>
5914         <return-value transfer-ownership="none">
5915           <doc xml:whitespace="preserve">A #GCredentials or %NULL if not available. Do not free</doc>
5916           <type name="Credentials" c:type="GCredentials*"/>
5917         </return-value>
5918       </method>
5919       <method name="get_stream"
5920               c:identifier="g_dbus_connection_get_stream"
5921               version="2.26">
5922         <doc xml:whitespace="preserve">Gets the underlying stream used for IO.</doc>
5923         <return-value transfer-ownership="none">
5924           <doc xml:whitespace="preserve">the stream used for IO</doc>
5925           <type name="IOStream" c:type="GIOStream*"/>
5926         </return-value>
5927       </method>
5928       <method name="get_unique_name"
5929               c:identifier="g_dbus_connection_get_unique_name"
5930               version="2.26">
5931         <doc xml:whitespace="preserve">Gets the unique name of @connection as assigned by the message
5932 bus. This can also be used to figure out if @connection is a
5933 message bus connection.
5934 bus connection. Do not free this string, it is owned by</doc>
5935         <return-value transfer-ownership="none">
5936           <doc xml:whitespace="preserve">The unique name or %NULL if @connection is not a message</doc>
5937           <type name="utf8" c:type="gchar*"/>
5938         </return-value>
5939       </method>
5940       <method name="is_closed"
5941               c:identifier="g_dbus_connection_is_closed"
5942               version="2.26">
5943         <doc xml:whitespace="preserve">Gets whether @connection is closed.</doc>
5944         <return-value transfer-ownership="none">
5945           <doc xml:whitespace="preserve">%TRUE if the connection is closed, %FALSE otherwise.</doc>
5946           <type name="gboolean" c:type="gboolean"/>
5947         </return-value>
5948       </method>
5949       <method name="register_object"
5950               c:identifier="g_dbus_connection_register_object"
5951               version="2.26"
5952               throws="1">
5953         <doc xml:whitespace="preserve">Registers callbacks for exported objects at @object_path with the
5954 D-Bus interface that is described in @interface_info.
5955 Calls to functions in @vtable (and @user_data_free_func) will
5956 happen in the &lt;link linkend="g-main-context-push-thread-default"&gt;thread-default main
5957 loop&lt;/link&gt; of the thread you are calling this method from.
5958 Note that all #GVariant values passed to functions in @vtable will match
5959 the signature given in @interface_info - if a remote caller passes
5960 incorrect values, the &lt;literal&gt;org.freedesktop.DBus.Error.InvalidArgs&lt;/literal&gt;
5961 is returned to the remote caller.
5962 Additionally, if the remote caller attempts to invoke methods or
5963 access properties not mentioned in @interface_info the
5964 &lt;literal&gt;org.freedesktop.DBus.Error.UnknownMethod&lt;/literal&gt; resp.
5965 &lt;literal&gt;org.freedesktop.DBus.Error.InvalidArgs&lt;/literal&gt; errors
5966 are returned to the caller.
5967 It is considered a programming error if the
5968 #GDBusInterfaceGetPropertyFunc function in @vtable returns a
5969 #GVariant of incorrect type.
5970 If an existing callback is already registered at @object_path and
5971 GDBus automatically implements the standard D-Bus interfaces
5972 org.freedesktop.DBus.Properties, org.freedesktop.DBus.Introspectable
5973 and org.freedesktop.Peer, so you don't have to implement those for
5974 the objects you export. You &lt;emphasis&gt;can&lt;/emphasis&gt; implement
5975 org.freedesktop.DBus.Properties yourself, e.g. to handle getting
5976 and setting of properties asynchronously.
5977 Note that the reference count on @interface_info will be
5978 incremented by 1 (unless allocated statically, e.g. if the
5979 reference count is -1, see g_dbus_interface_info_ref()) for as long
5980 as the object is exported. Also note that @vtable will be copied.
5981 See &lt;xref linkend="gdbus-server"/&gt; for an example of how to use this method.
5982 that can be used with g_dbus_connection_unregister_object() .</doc>
5983         <return-value transfer-ownership="none">
5984           <doc xml:whitespace="preserve">0 if @error is set, otherwise a registration id (never 0)</doc>
5985           <type name="guint" c:type="guint"/>
5986         </return-value>
5987         <parameters>
5988           <parameter name="object_path" transfer-ownership="none">
5989             <doc xml:whitespace="preserve">The object path to register at.</doc>
5990             <type name="utf8" c:type="gchar*"/>
5991           </parameter>
5992           <parameter name="interface_info" transfer-ownership="none">
5993             <doc xml:whitespace="preserve">Introspection data for the interface.</doc>
5994             <type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
5995           </parameter>
5996           <parameter name="vtable" transfer-ownership="none">
5997             <doc xml:whitespace="preserve">A #GDBusInterfaceVTable to call into or %NULL.</doc>
5998             <type name="DBusInterfaceVTable" c:type="GDBusInterfaceVTable*"/>
5999           </parameter>
6000           <parameter name="user_data" transfer-ownership="none">
6001             <doc xml:whitespace="preserve">Data to pass to functions in @vtable.</doc>
6002             <type name="gpointer" c:type="gpointer"/>
6003           </parameter>
6004           <parameter name="user_data_free_func"
6005                      transfer-ownership="none"
6006                      scope="async">
6007             <doc xml:whitespace="preserve">Function to call when the object path is unregistered.</doc>
6008             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
6009           </parameter>
6010         </parameters>
6011       </method>
6012       <method name="register_subtree"
6013               c:identifier="g_dbus_connection_register_subtree"
6014               version="2.26"
6015               throws="1">
6016         <doc xml:whitespace="preserve">Registers a whole subtree of &lt;quote&gt;dynamic&lt;/quote&gt; objects.
6017 The @enumerate and @introspection functions in @vtable are used to
6018 convey, to remote callers, what nodes exist in the subtree rooted
6019 by @object_path.
6020 When handling remote calls into any node in the subtree, first the
6021 or the #G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES flag is set
6022 the @introspection function is used to check if the node supports the
6023 requested method. If so, the @dispatch function is used to determine
6024 where to dispatch the call. The collected #GDBusInterfaceVTable and
6025 #gpointer will be used to call into the interface vtable for processing
6026 the request.
6027 All calls into user-provided code will be invoked in the &lt;link
6028 linkend="g-main-context-push-thread-default"&gt;thread-default main
6029 loop&lt;/link&gt; of the thread you are calling this method from.
6030 If an existing subtree is already registered at @object_path or
6031 then @error is set to #G_IO_ERROR_EXISTS.
6032 Note that it is valid to register regular objects (using
6033 g_dbus_connection_register_object()) in a subtree registered with
6034 g_dbus_connection_register_subtree() - if so, the subtree handler
6035 is tried as the last resort. One way to think about a subtree
6036 handler is to consider it a &lt;quote&gt;fallback handler&lt;/quote&gt;
6037 for object paths not registered via g_dbus_connection_register_object()
6038 or other bindings.
6039 Note that @vtable will be copied so you cannot change it after
6040 registration.
6041 See &lt;xref linkend="gdbus-subtree-server"/&gt; for an example of how to use this method.
6042 that can be used with g_dbus_connection_unregister_subtree() .</doc>
6043         <return-value transfer-ownership="none">
6044           <doc xml:whitespace="preserve">0 if @error is set, otherwise a subtree registration id (never 0)</doc>
6045           <type name="guint" c:type="guint"/>
6046         </return-value>
6047         <parameters>
6048           <parameter name="object_path" transfer-ownership="none">
6049             <doc xml:whitespace="preserve">The object path to register the subtree at.</doc>
6050             <type name="utf8" c:type="gchar*"/>
6051           </parameter>
6052           <parameter name="vtable" transfer-ownership="none">
6053             <doc xml:whitespace="preserve">A #GDBusSubtreeVTable to enumerate, introspect and dispatch nodes in the subtree.</doc>
6054             <type name="DBusSubtreeVTable" c:type="GDBusSubtreeVTable*"/>
6055           </parameter>
6056           <parameter name="flags" transfer-ownership="none">
6057             <doc xml:whitespace="preserve">Flags used to fine tune the behavior of the subtree.</doc>
6058             <type name="DBusSubtreeFlags" c:type="GDBusSubtreeFlags"/>
6059           </parameter>
6060           <parameter name="user_data" transfer-ownership="none">
6061             <doc xml:whitespace="preserve">Data to pass to functions in @vtable.</doc>
6062             <type name="gpointer" c:type="gpointer"/>
6063           </parameter>
6064           <parameter name="user_data_free_func"
6065                      transfer-ownership="none"
6066                      scope="async">
6067             <doc xml:whitespace="preserve">Function to call when the subtree is unregistered.</doc>
6068             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
6069           </parameter>
6070         </parameters>
6071       </method>
6072       <method name="remove_filter"
6073               c:identifier="g_dbus_connection_remove_filter"
6074               version="2.26">
6075         <doc xml:whitespace="preserve">Removes a filter.</doc>
6076         <return-value transfer-ownership="none">
6077           <type name="none" c:type="void"/>
6078         </return-value>
6079         <parameters>
6080           <parameter name="filter_id" transfer-ownership="none">
6081             <doc xml:whitespace="preserve">an identifier obtained from g_dbus_connection_add_filter()</doc>
6082             <type name="guint" c:type="guint"/>
6083           </parameter>
6084         </parameters>
6085       </method>
6086       <method name="send_message"
6087               c:identifier="g_dbus_connection_send_message"
6088               version="2.26"
6089               throws="1">
6090         <doc xml:whitespace="preserve">Asynchronously sends @message to the peer represented by @connection.
6091 Unless @flags contain the
6092 %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
6093 will be assigned by @connection and set on @message via
6094 g_dbus_message_set_serial(). If @out_serial is not %NULL, then the
6095 serial number used will be written to this location prior to
6096 submitting the message to the underlying transport.
6097 If @connection is closed then the operation will fail with
6098 %G_IO_ERROR_CLOSED. If @message is not well-formed,
6099 the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
6100 See &lt;xref linkend="gdbus-server"/&gt; and &lt;xref
6101 linkend="gdbus-unix-fd-client"/&gt; for an example of how to use this
6102 low-level API to send and receive UNIX file descriptors.
6103 Note that @message must be unlocked, unless @flags contain the
6104 %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
6105 transmission, %FALSE if @error is set.</doc>
6106         <return-value transfer-ownership="none">
6107           <doc xml:whitespace="preserve">%TRUE if the message was well-formed and queued for</doc>
6108           <type name="gboolean" c:type="gboolean"/>
6109         </return-value>
6110         <parameters>
6111           <parameter name="message" transfer-ownership="none">
6112             <doc xml:whitespace="preserve">A #GDBusMessage</doc>
6113             <type name="DBusMessage" c:type="GDBusMessage*"/>
6114           </parameter>
6115           <parameter name="flags" transfer-ownership="none">
6116             <doc xml:whitespace="preserve">Flags affecting how the message is sent.</doc>
6117             <type name="DBusSendMessageFlags" c:type="GDBusSendMessageFlags"/>
6118           </parameter>
6119           <parameter name="out_serial" transfer-ownership="none">
6120             <doc xml:whitespace="preserve">Return location for serial number assigned to @message when sending it or %NULL.</doc>
6121             <type name="guint32" c:type="guint32*"/>
6122           </parameter>
6123         </parameters>
6124       </method>
6125       <method name="send_message_with_reply"
6126               c:identifier="g_dbus_connection_send_message_with_reply"
6127               version="2.26">
6128         <doc xml:whitespace="preserve">Asynchronously sends @message to the peer represented by @connection.
6129 Unless @flags contain the
6130 %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
6131 will be assigned by @connection and set on @message via
6132 g_dbus_message_set_serial(). If @out_serial is not %NULL, then the
6133 serial number used will be written to this location prior to
6134 submitting the message to the underlying transport.
6135 If @connection is closed then the operation will fail with
6136 %G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will
6137 fail with %G_IO_ERROR_CANCELLED. If @message is not well-formed,
6138 the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
6139 This is an asynchronous method. When the operation is finished, @callback will be invoked
6140 in the &lt;link linkend="g-main-context-push-thread-default"&gt;thread-default main loop&lt;/link&gt;
6141 of the thread you are calling this method from. You can then call
6142 g_dbus_connection_send_message_with_reply_finish() to get the result of the operation.
6143 See g_dbus_connection_send_message_with_reply_sync() for the synchronous version.
6144 Note that @message must be unlocked, unless @flags contain the
6145 %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
6146 See &lt;xref linkend="gdbus-server"/&gt; and &lt;xref
6147 linkend="gdbus-unix-fd-client"/&gt; for an example of how to use this
6148 low-level API to send and receive UNIX file descriptors.</doc>
6149         <return-value transfer-ownership="none">
6150           <type name="none" c:type="void"/>
6151         </return-value>
6152         <parameters>
6153           <parameter name="message" transfer-ownership="none">
6154             <doc xml:whitespace="preserve">A #GDBusMessage.</doc>
6155             <type name="DBusMessage" c:type="GDBusMessage*"/>
6156           </parameter>
6157           <parameter name="flags" transfer-ownership="none">
6158             <doc xml:whitespace="preserve">Flags affecting how the message is sent.</doc>
6159             <type name="DBusSendMessageFlags" c:type="GDBusSendMessageFlags"/>
6160           </parameter>
6161           <parameter name="timeout_msec" transfer-ownership="none">
6162             <doc xml:whitespace="preserve">The timeout in milliseconds or -1 to use the default timeout.</doc>
6163             <type name="gint" c:type="gint"/>
6164           </parameter>
6165           <parameter name="out_serial" transfer-ownership="none">
6166             <doc xml:whitespace="preserve">Return location for serial number assigned to @message when sending it or %NULL.</doc>
6167             <type name="guint32" c:type="guint32*"/>
6168           </parameter>
6169           <parameter name="cancellable"
6170                      transfer-ownership="none"
6171                      allow-none="1">
6172             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
6173             <type name="Cancellable" c:type="GCancellable*"/>
6174           </parameter>
6175           <parameter name="callback"
6176                      transfer-ownership="none"
6177                      scope="async"
6178                      closure="6">
6179             <doc xml:whitespace="preserve">A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't care about the result.</doc>
6180             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
6181           </parameter>
6182           <parameter name="user_data" transfer-ownership="none">
6183             <doc xml:whitespace="preserve">The data to pass to @callback.</doc>
6184             <type name="gpointer" c:type="gpointer"/>
6185           </parameter>
6186         </parameters>
6187       </method>
6188       <method name="send_message_with_reply_finish"
6189               c:identifier="g_dbus_connection_send_message_with_reply_finish"
6190               version="2.26"
6191               throws="1">
6192         <doc xml:whitespace="preserve">Finishes an operation started with g_dbus_connection_send_message_with_reply().
6193 Note that @error is only set if a local in-process error
6194 occured. That is to say that the returned #GDBusMessage object may
6195 be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use
6196 g_dbus_message_to_gerror() to transcode this to a #GError.
6197 See &lt;xref linkend="gdbus-server"/&gt; and &lt;xref
6198 linkend="gdbus-unix-fd-client"/&gt; for an example of how to use this
6199 low-level API to send and receive UNIX file descriptors.</doc>
6200         <return-value transfer-ownership="full">
6201           <doc xml:whitespace="preserve">A locked #GDBusMessage or %NULL if @error is set.</doc>
6202           <type name="DBusMessage" c:type="GDBusMessage*"/>
6203         </return-value>
6204         <parameters>
6205           <parameter name="res" transfer-ownership="none">
6206             <doc xml:whitespace="preserve">A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_send_message_with_reply().</doc>
6207             <type name="AsyncResult" c:type="GAsyncResult*"/>
6208           </parameter>
6209         </parameters>
6210       </method>
6211       <method name="send_message_with_reply_sync"
6212               c:identifier="g_dbus_connection_send_message_with_reply_sync"
6213               version="2.26"
6214               throws="1">
6215         <doc xml:whitespace="preserve">Synchronously sends @message to the peer represented by @connection
6216 and blocks the calling thread until a reply is received or the
6217 timeout is reached. See g_dbus_connection_send_message_with_reply()
6218 for the asynchronous version of this method.
6219 Unless @flags contain the
6220 %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
6221 will be assigned by @connection and set on @message via
6222 g_dbus_message_set_serial(). If @out_serial is not %NULL, then the
6223 serial number used will be written to this location prior to
6224 submitting the message to the underlying transport.
6225 If @connection is closed then the operation will fail with
6226 %G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will
6227 fail with %G_IO_ERROR_CANCELLED. If @message is not well-formed,
6228 the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
6229 Note that @error is only set if a local in-process error
6230 occured. That is to say that the returned #GDBusMessage object may
6231 be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use
6232 g_dbus_message_to_gerror() to transcode this to a #GError.
6233 See &lt;xref linkend="gdbus-server"/&gt; and &lt;xref
6234 linkend="gdbus-unix-fd-client"/&gt; for an example of how to use this
6235 low-level API to send and receive UNIX file descriptors.
6236 Note that @message must be unlocked, unless @flags contain the
6237 %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.</doc>
6238         <return-value transfer-ownership="full">
6239           <doc xml:whitespace="preserve">A locked #GDBusMessage that is the reply to @message or %NULL if @error is set.</doc>
6240           <type name="DBusMessage" c:type="GDBusMessage*"/>
6241         </return-value>
6242         <parameters>
6243           <parameter name="message" transfer-ownership="none">
6244             <doc xml:whitespace="preserve">A #GDBusMessage.</doc>
6245             <type name="DBusMessage" c:type="GDBusMessage*"/>
6246           </parameter>
6247           <parameter name="flags" transfer-ownership="none">
6248             <doc xml:whitespace="preserve">Flags affecting how the message is sent.</doc>
6249             <type name="DBusSendMessageFlags" c:type="GDBusSendMessageFlags"/>
6250           </parameter>
6251           <parameter name="timeout_msec" transfer-ownership="none">
6252             <doc xml:whitespace="preserve">The timeout in milliseconds or -1 to use the default timeout.</doc>
6253             <type name="gint" c:type="gint"/>
6254           </parameter>
6255           <parameter name="out_serial" transfer-ownership="none">
6256             <doc xml:whitespace="preserve">Return location for serial number assigned to @message when sending it or %NULL.</doc>
6257             <type name="guint32" c:type="guint32*"/>
6258           </parameter>
6259           <parameter name="cancellable"
6260                      transfer-ownership="none"
6261                      allow-none="1">
6262             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
6263             <type name="Cancellable" c:type="GCancellable*"/>
6264           </parameter>
6265         </parameters>
6266       </method>
6267       <method name="set_exit_on_close"
6268               c:identifier="g_dbus_connection_set_exit_on_close"
6269               version="2.26">
6270         <doc xml:whitespace="preserve">Sets whether the process should be terminated when @connection is
6271 closed by the remote peer. See #GDBusConnection:exit-on-close for
6272 more details.</doc>
6273         <return-value transfer-ownership="none">
6274           <type name="none" c:type="void"/>
6275         </return-value>
6276         <parameters>
6277           <parameter name="exit_on_close" transfer-ownership="none">
6278             <doc xml:whitespace="preserve">Whether the process should be terminated when @connection is closed by the remote peer.</doc>
6279             <type name="gboolean" c:type="gboolean"/>
6280           </parameter>
6281         </parameters>
6282       </method>
6283       <method name="signal_subscribe"
6284               c:identifier="g_dbus_connection_signal_subscribe"
6285               version="2.26">
6286         <doc xml:whitespace="preserve">Subscribes to signals on @connection and invokes @callback with a
6287 whenever the signal is received. Note that @callback
6288 will be invoked in the &lt;link
6289 linkend="g-main-context-push-thread-default"&gt;thread-default main
6290 loop&lt;/link&gt; of the thread you are calling this method from.
6291 If @connection is not a message bus connection, @sender must be
6292 %NULL.
6293 If @sender is a well-known name note that @callback is invoked with
6294 the unique name for the owner of @sender, not the well-known name
6295 as one would expect. This is because the message bus rewrites the
6296 name. As such, to avoid certain race conditions, users should be
6297 tracking the name owner of the well-known name and use that when
6298 processing the received signal.</doc>
6299         <return-value transfer-ownership="none">
6300           <doc xml:whitespace="preserve">A subscription identifier that can be used with g_dbus_connection_signal_unsubscribe().</doc>
6301           <type name="guint" c:type="guint"/>
6302         </return-value>
6303         <parameters>
6304           <parameter name="sender" transfer-ownership="none">
6305             <doc xml:whitespace="preserve">Sender name to match on (unique or well-known name) or %NULL to listen from all senders.</doc>
6306             <type name="utf8" c:type="gchar*"/>
6307           </parameter>
6308           <parameter name="interface_name" transfer-ownership="none">
6309             <doc xml:whitespace="preserve">D-Bus interface name to match on or %NULL to match on all interfaces.</doc>
6310             <type name="utf8" c:type="gchar*"/>
6311           </parameter>
6312           <parameter name="member" transfer-ownership="none">
6313             <doc xml:whitespace="preserve">D-Bus signal name to match on or %NULL to match on all signals.</doc>
6314             <type name="utf8" c:type="gchar*"/>
6315           </parameter>
6316           <parameter name="object_path" transfer-ownership="none">
6317             <doc xml:whitespace="preserve">Object path to match on or %NULL to match on all object paths.</doc>
6318             <type name="utf8" c:type="gchar*"/>
6319           </parameter>
6320           <parameter name="arg0" transfer-ownership="none">
6321             <doc xml:whitespace="preserve">Contents of first string argument to match on or %NULL to match on all kinds of arguments.</doc>
6322             <type name="utf8" c:type="gchar*"/>
6323           </parameter>
6324           <parameter name="flags" transfer-ownership="none">
6325             <doc xml:whitespace="preserve">Flags describing how to subscribe to the signal (currently unused).</doc>
6326             <type name="DBusSignalFlags" c:type="GDBusSignalFlags"/>
6327           </parameter>
6328           <parameter name="callback"
6329                      transfer-ownership="none"
6330                      scope="notified"
6331                      closure="7"
6332                      destroy="8">
6333             <doc xml:whitespace="preserve">Callback to invoke when there is a signal matching the requested data.</doc>
6334             <type name="DBusSignalCallback" c:type="GDBusSignalCallback"/>
6335           </parameter>
6336           <parameter name="user_data" transfer-ownership="none">
6337             <doc xml:whitespace="preserve">User data to pass to @callback.</doc>
6338             <type name="gpointer" c:type="gpointer"/>
6339           </parameter>
6340           <parameter name="user_data_free_func"
6341                      transfer-ownership="none"
6342                      scope="async">
6343             <doc xml:whitespace="preserve">Function to free @user_data with when subscription is removed or %NULL.</doc>
6344             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
6345           </parameter>
6346         </parameters>
6347       </method>
6348       <method name="signal_unsubscribe"
6349               c:identifier="g_dbus_connection_signal_unsubscribe"
6350               version="2.26">
6351         <doc xml:whitespace="preserve">Unsubscribes from signals.</doc>
6352         <return-value transfer-ownership="none">
6353           <type name="none" c:type="void"/>
6354         </return-value>
6355         <parameters>
6356           <parameter name="subscription_id" transfer-ownership="none">
6357             <doc xml:whitespace="preserve">A subscription id obtained from g_dbus_connection_signal_subscribe().</doc>
6358             <type name="guint" c:type="guint"/>
6359           </parameter>
6360         </parameters>
6361       </method>
6362       <method name="start_message_processing"
6363               c:identifier="g_dbus_connection_start_message_processing"
6364               version="2.26">
6365         <doc xml:whitespace="preserve">If @connection was created with
6366 %G_DBUS_CONNECTION_FLAGS_DELAY_MESSAGE_PROCESSING, this method
6367 starts processing messages. Does nothing on if @connection wasn't
6368 created with this flag or if the method has already been called.</doc>
6369         <return-value transfer-ownership="none">
6370           <type name="none" c:type="void"/>
6371         </return-value>
6372       </method>
6373       <method name="unregister_object"
6374               c:identifier="g_dbus_connection_unregister_object"
6375               version="2.26">
6376         <doc xml:whitespace="preserve">Unregisters an object.</doc>
6377         <return-value transfer-ownership="none">
6378           <doc xml:whitespace="preserve">%TRUE if the object was unregistered, %FALSE otherwise.</doc>
6379           <type name="gboolean" c:type="gboolean"/>
6380         </return-value>
6381         <parameters>
6382           <parameter name="registration_id" transfer-ownership="none">
6383             <doc xml:whitespace="preserve">A registration id obtained from g_dbus_connection_register_object().</doc>
6384             <type name="guint" c:type="guint"/>
6385           </parameter>
6386         </parameters>
6387       </method>
6388       <method name="unregister_subtree"
6389               c:identifier="g_dbus_connection_unregister_subtree"
6390               version="2.26">
6391         <doc xml:whitespace="preserve">Unregisters a subtree.</doc>
6392         <return-value transfer-ownership="none">
6393           <doc xml:whitespace="preserve">%TRUE if the subtree was unregistered, %FALSE otherwise.</doc>
6394           <type name="gboolean" c:type="gboolean"/>
6395         </return-value>
6396         <parameters>
6397           <parameter name="registration_id" transfer-ownership="none">
6398             <doc xml:whitespace="preserve">A subtree registration id obtained from g_dbus_connection_register_subtree().</doc>
6399             <type name="guint" c:type="guint"/>
6400           </parameter>
6401         </parameters>
6402       </method>
6403       <property name="address"
6404                 version="2.26"
6405                 readable="0"
6406                 writable="1"
6407                 construct-only="1"
6408                 transfer-ownership="none">
6409         <doc xml:whitespace="preserve">A D-Bus address specifying potential endpoints that can be used
6410 when establishing the connection.</doc>
6411         <type name="utf8"/>
6412       </property>
6413       <property name="authentication-observer"
6414                 version="2.26"
6415                 readable="0"
6416                 writable="1"
6417                 construct-only="1"
6418                 transfer-ownership="none">
6419         <doc xml:whitespace="preserve">A #GDBusAuthObserver object to assist in the authentication process or %NULL.</doc>
6420         <type name="DBusAuthObserver"/>
6421       </property>
6422       <property name="capabilities" version="2.26" transfer-ownership="none">
6423         <doc xml:whitespace="preserve">Flags from the #GDBusCapabilityFlags enumeration
6424 representing connection features negotiated with the other peer.</doc>
6425         <type name="DBusCapabilityFlags"/>
6426       </property>
6427       <property name="closed" version="2.26" transfer-ownership="none">
6428         <doc xml:whitespace="preserve">A boolean specifying whether the connection has been closed.</doc>
6429         <type name="gboolean"/>
6430       </property>
6431       <property name="exit-on-close"
6432                 version="2.26"
6433                 writable="1"
6434                 transfer-ownership="none">
6435         <doc xml:whitespace="preserve">A boolean specifying whether the process will be terminated (by
6436 calling &lt;literal&gt;raise(SIGTERM)&lt;/literal&gt;) if the connection
6437 is closed by the remote peer.</doc>
6438         <type name="gboolean"/>
6439       </property>
6440       <property name="flags"
6441                 version="2.26"
6442                 readable="0"
6443                 writable="1"
6444                 construct-only="1"
6445                 transfer-ownership="none">
6446         <doc xml:whitespace="preserve">Flags from the #GDBusConnectionFlags enumeration.</doc>
6447         <type name="DBusConnectionFlags"/>
6448       </property>
6449       <property name="guid"
6450                 version="2.26"
6451                 writable="1"
6452                 construct-only="1"
6453                 transfer-ownership="none">
6454         <doc xml:whitespace="preserve">The GUID of the peer performing the role of server when
6455 authenticating.
6456 If you are constructing a #GDBusConnection and pass
6457 %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER in the
6458 #GDBusConnection:flags property then you MUST also set this
6459 property to a valid guid.
6460 If you are constructing a #GDBusConnection and pass
6461 %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_CLIENT in the
6462 #GDBusConnection:flags property you will be able to read the GUID
6463 of the other peer here after the connection has been successfully
6464 initialized.</doc>
6465         <type name="utf8"/>
6466       </property>
6467       <property name="stream"
6468                 version="2.26"
6469                 writable="1"
6470                 construct-only="1"
6471                 transfer-ownership="none">
6472         <doc xml:whitespace="preserve">The underlying #GIOStream used for I/O.</doc>
6473         <type name="IOStream"/>
6474       </property>
6475       <property name="unique-name" version="2.26" transfer-ownership="none">
6476         <doc xml:whitespace="preserve">The unique name as assigned by the message bus or %NULL if the
6477 connection is not open or not a message bus connection.</doc>
6478         <type name="utf8"/>
6479       </property>
6480       <glib:signal name="closed" version="2.26">
6481         <doc xml:whitespace="preserve">Emitted when the connection is closed.
6482 The cause of this event can be
6483 &lt;itemizedlist&gt;
6484 &lt;listitem&gt;&lt;para&gt;
6485 If g_dbus_connection_close() is called. In this case
6486 &lt;/para&gt;&lt;/listitem&gt;
6487 &lt;listitem&gt;&lt;para&gt;
6488 If the remote peer closes the connection. In this case
6489 &lt;/para&gt;&lt;/listitem&gt;
6490 &lt;listitem&gt;&lt;para&gt;
6491 If the remote peer sends invalid or malformed data. In this
6492 case @remote_peer_vanished is set to %FALSE and @error
6493 is set.
6494 &lt;/para&gt;&lt;/listitem&gt;
6495 &lt;/itemizedlist&gt;
6496 Upon receiving this signal, you should give up your reference to
6497 once.</doc>
6498         <return-value transfer-ownership="none">
6499           <type name="none"/>
6500         </return-value>
6501         <parameters>
6502           <parameter name="object" transfer-ownership="none">
6503             <doc xml:whitespace="preserve">%TRUE if @connection is closed because the remote peer closed its end of the connection.</doc>
6504             <type name="gboolean"/>
6505           </parameter>
6506           <parameter name="p0" transfer-ownership="none">
6507             <doc xml:whitespace="preserve">A #GError with more details about the event or %NULL.</doc>
6508             <type name="GObject.Error"/>
6509           </parameter>
6510         </parameters>
6511       </glib:signal>
6512     </class>
6513     <bitfield name="DBusConnectionFlags"
6514               version="2.26"
6515               glib:type-name="GDBusConnectionFlags"
6516               glib:get-type="g_dbus_connection_flags_get_type"
6517               c:type="GDBusConnectionFlags">
6518       <doc xml:whitespace="preserve">Flags used when creating a new #GDBusConnection.</doc>
6519       <member name="none"
6520               value="0"
6521               c:identifier="G_DBUS_CONNECTION_FLAGS_NONE"
6522               glib:nick="none"/>
6523       <member name="authentication_client"
6524               value="1"
6525               c:identifier="G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_CLIENT"
6526               glib:nick="authentication-client"/>
6527       <member name="authentication_server"
6528               value="2"
6529               c:identifier="G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER"
6530               glib:nick="authentication-server"/>
6531       <member name="authentication_allow_anonymous"
6532               value="4"
6533               c:identifier="G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS"
6534               glib:nick="authentication-allow-anonymous"/>
6535       <member name="message_bus_connection"
6536               value="8"
6537               c:identifier="G_DBUS_CONNECTION_FLAGS_MESSAGE_BUS_CONNECTION"
6538               glib:nick="message-bus-connection"/>
6539       <member name="delay_message_processing"
6540               value="16"
6541               c:identifier="G_DBUS_CONNECTION_FLAGS_DELAY_MESSAGE_PROCESSING"
6542               glib:nick="delay-message-processing"/>
6543     </bitfield>
6544     <enumeration name="DBusError"
6545                  version="2.26"
6546                  glib:type-name="GDBusError"
6547                  glib:get-type="g_dbus_error_get_type"
6548                  c:type="GDBusError">
6549       <doc xml:whitespace="preserve">A generic error; "something went wrong" - see the error message for
6550 more.
6551 There was not enough memory to complete an operation.
6552 The bus doesn't know how to launch a service to supply the bus name
6553 you wanted.
6554 The bus name you referenced doesn't exist (i.e. no application owns
6555 it).
6556 No reply to a message expecting one, usually means a timeout occurred.
6557 Something went wrong reading or writing to a socket, for example.
6558 A D-Bus bus address was malformed.
6559 Requested operation isn't supported (like ENOSYS on UNIX).
6560 Some limited resource is exhausted.
6561 Security restrictions don't allow doing what you're trying to do.
6562 Authentication didn't work.
6563 Unable to connect to server (probably caused by ECONNREFUSED on a
6564 socket).
6565 Certain timeout errors, possibly ETIMEDOUT on a socket.  Note that
6566 %G_DBUS_ERROR_NO_REPLY is used for message reply timeouts. Warning:
6567 this is confusingly-named given that %G_DBUS_ERROR_TIMED_OUT also
6568 exists. We can't fix it for compatibility reasons so just be
6569 careful.
6570 No network access (probably ENETUNREACH on a socket).
6571 Can't bind a socket since its address is in use (i.e. EADDRINUSE).
6572 The connection is disconnected and you're trying to use it.
6573 Invalid arguments passed to a method call.
6574 Missing file.
6575 Existing file and the operation you're using does not silently overwrite.
6576 Method name you invoked isn't known by the object you invoked it on.
6577 confusingly-named given that %G_DBUS_ERROR_TIMEOUT also exists. We
6578 can't fix it for compatibility reasons so just be careful.
6579 Tried to remove or modify a match rule that didn't exist.
6580 The match rule isn't syntactically valid.
6581 While starting a new process, the exec() call failed.
6582 While starting a new process, the fork() call failed.
6583 While starting a new process, the child exited with a status code.
6584 While starting a new process, the child exited on a signal.
6585 While starting a new process, something went wrong.
6586 We failed to setup the environment correctly.
6587 We failed to setup the config parser correctly.
6588 Bus name was not valid.
6589 Service file not found in system-services directory.
6590 Permissions are incorrect on the setuid helper.
6591 Service file invalid (Name, User or Exec missing).
6592 Tried to get a UNIX process ID and it wasn't available.
6593 Tried to get a UNIX process ID and it wasn't available.
6594 A type signature is not valid.
6595 A file contains invalid syntax or is otherwise broken.
6596 Asked for SELinux security context and it wasn't available.
6597 Asked for ADT audit data and it wasn't available.
6598 There's already an object with the requested object path.
6599 Error codes for the %G_DBUS_ERROR error domain.</doc>
6600       <member name="failed"
6601               value="0"
6602               c:identifier="G_DBUS_ERROR_FAILED"
6603               glib:nick="failed"/>
6604       <member name="no_memory"
6605               value="1"
6606               c:identifier="G_DBUS_ERROR_NO_MEMORY"
6607               glib:nick="no-memory"/>
6608       <member name="service_unknown"
6609               value="2"
6610               c:identifier="G_DBUS_ERROR_SERVICE_UNKNOWN"
6611               glib:nick="service-unknown"/>
6612       <member name="name_has_no_owner"
6613               value="3"
6614               c:identifier="G_DBUS_ERROR_NAME_HAS_NO_OWNER"
6615               glib:nick="name-has-no-owner"/>
6616       <member name="no_reply"
6617               value="4"
6618               c:identifier="G_DBUS_ERROR_NO_REPLY"
6619               glib:nick="no-reply"/>
6620       <member name="io_error"
6621               value="5"
6622               c:identifier="G_DBUS_ERROR_IO_ERROR"
6623               glib:nick="io-error"/>
6624       <member name="bad_address"
6625               value="6"
6626               c:identifier="G_DBUS_ERROR_BAD_ADDRESS"
6627               glib:nick="bad-address"/>
6628       <member name="not_supported"
6629               value="7"
6630               c:identifier="G_DBUS_ERROR_NOT_SUPPORTED"
6631               glib:nick="not-supported"/>
6632       <member name="limits_exceeded"
6633               value="8"
6634               c:identifier="G_DBUS_ERROR_LIMITS_EXCEEDED"
6635               glib:nick="limits-exceeded"/>
6636       <member name="access_denied"
6637               value="9"
6638               c:identifier="G_DBUS_ERROR_ACCESS_DENIED"
6639               glib:nick="access-denied"/>
6640       <member name="auth_failed"
6641               value="10"
6642               c:identifier="G_DBUS_ERROR_AUTH_FAILED"
6643               glib:nick="auth-failed"/>
6644       <member name="no_server"
6645               value="11"
6646               c:identifier="G_DBUS_ERROR_NO_SERVER"
6647               glib:nick="no-server"/>
6648       <member name="timeout"
6649               value="12"
6650               c:identifier="G_DBUS_ERROR_TIMEOUT"
6651               glib:nick="timeout"/>
6652       <member name="no_network"
6653               value="13"
6654               c:identifier="G_DBUS_ERROR_NO_NETWORK"
6655               glib:nick="no-network"/>
6656       <member name="address_in_use"
6657               value="14"
6658               c:identifier="G_DBUS_ERROR_ADDRESS_IN_USE"
6659               glib:nick="address-in-use"/>
6660       <member name="disconnected"
6661               value="15"
6662               c:identifier="G_DBUS_ERROR_DISCONNECTED"
6663               glib:nick="disconnected"/>
6664       <member name="invalid_args"
6665               value="16"
6666               c:identifier="G_DBUS_ERROR_INVALID_ARGS"
6667               glib:nick="invalid-args"/>
6668       <member name="file_not_found"
6669               value="17"
6670               c:identifier="G_DBUS_ERROR_FILE_NOT_FOUND"
6671               glib:nick="file-not-found"/>
6672       <member name="file_exists"
6673               value="18"
6674               c:identifier="G_DBUS_ERROR_FILE_EXISTS"
6675               glib:nick="file-exists"/>
6676       <member name="unknown_method"
6677               value="19"
6678               c:identifier="G_DBUS_ERROR_UNKNOWN_METHOD"
6679               glib:nick="unknown-method"/>
6680       <member name="timed_out"
6681               value="20"
6682               c:identifier="G_DBUS_ERROR_TIMED_OUT"
6683               glib:nick="timed-out"/>
6684       <member name="match_rule_not_found"
6685               value="21"
6686               c:identifier="G_DBUS_ERROR_MATCH_RULE_NOT_FOUND"
6687               glib:nick="match-rule-not-found"/>
6688       <member name="match_rule_invalid"
6689               value="22"
6690               c:identifier="G_DBUS_ERROR_MATCH_RULE_INVALID"
6691               glib:nick="match-rule-invalid"/>
6692       <member name="spawn_exec_failed"
6693               value="23"
6694               c:identifier="G_DBUS_ERROR_SPAWN_EXEC_FAILED"
6695               glib:nick="spawn-exec-failed"/>
6696       <member name="spawn_fork_failed"
6697               value="24"
6698               c:identifier="G_DBUS_ERROR_SPAWN_FORK_FAILED"
6699               glib:nick="spawn-fork-failed"/>
6700       <member name="spawn_child_exited"
6701               value="25"
6702               c:identifier="G_DBUS_ERROR_SPAWN_CHILD_EXITED"
6703               glib:nick="spawn-child-exited"/>
6704       <member name="spawn_child_signaled"
6705               value="26"
6706               c:identifier="G_DBUS_ERROR_SPAWN_CHILD_SIGNALED"
6707               glib:nick="spawn-child-signaled"/>
6708       <member name="spawn_failed"
6709               value="27"
6710               c:identifier="G_DBUS_ERROR_SPAWN_FAILED"
6711               glib:nick="spawn-failed"/>
6712       <member name="spawn_setup_failed"
6713               value="28"
6714               c:identifier="G_DBUS_ERROR_SPAWN_SETUP_FAILED"
6715               glib:nick="spawn-setup-failed"/>
6716       <member name="spawn_config_invalid"
6717               value="29"
6718               c:identifier="G_DBUS_ERROR_SPAWN_CONFIG_INVALID"
6719               glib:nick="spawn-config-invalid"/>
6720       <member name="spawn_service_invalid"
6721               value="30"
6722               c:identifier="G_DBUS_ERROR_SPAWN_SERVICE_INVALID"
6723               glib:nick="spawn-service-invalid"/>
6724       <member name="spawn_service_not_found"
6725               value="31"
6726               c:identifier="G_DBUS_ERROR_SPAWN_SERVICE_NOT_FOUND"
6727               glib:nick="spawn-service-not-found"/>
6728       <member name="spawn_permissions_invalid"
6729               value="32"
6730               c:identifier="G_DBUS_ERROR_SPAWN_PERMISSIONS_INVALID"
6731               glib:nick="spawn-permissions-invalid"/>
6732       <member name="spawn_file_invalid"
6733               value="33"
6734               c:identifier="G_DBUS_ERROR_SPAWN_FILE_INVALID"
6735               glib:nick="spawn-file-invalid"/>
6736       <member name="spawn_no_memory"
6737               value="34"
6738               c:identifier="G_DBUS_ERROR_SPAWN_NO_MEMORY"
6739               glib:nick="spawn-no-memory"/>
6740       <member name="unix_process_id_unknown"
6741               value="35"
6742               c:identifier="G_DBUS_ERROR_UNIX_PROCESS_ID_UNKNOWN"
6743               glib:nick="unix-process-id-unknown"/>
6744       <member name="invalid_signature"
6745               value="36"
6746               c:identifier="G_DBUS_ERROR_INVALID_SIGNATURE"
6747               glib:nick="invalid-signature"/>
6748       <member name="invalid_file_content"
6749               value="37"
6750               c:identifier="G_DBUS_ERROR_INVALID_FILE_CONTENT"
6751               glib:nick="invalid-file-content"/>
6752       <member name="selinux_security_context_unknown"
6753               value="38"
6754               c:identifier="G_DBUS_ERROR_SELINUX_SECURITY_CONTEXT_UNKNOWN"
6755               glib:nick="selinux-security-context-unknown"/>
6756       <member name="adt_audit_data_unknown"
6757               value="39"
6758               c:identifier="G_DBUS_ERROR_ADT_AUDIT_DATA_UNKNOWN"
6759               glib:nick="adt-audit-data-unknown"/>
6760       <member name="object_path_in_use"
6761               value="40"
6762               c:identifier="G_DBUS_ERROR_OBJECT_PATH_IN_USE"
6763               glib:nick="object-path-in-use"/>
6764     </enumeration>
6765     <record name="DBusErrorEntry" c:type="GDBusErrorEntry" version="2.26">
6766       <doc xml:whitespace="preserve">Struct used in g_dbus_error_register_error_domain().</doc>
6767       <field name="error_code" writable="1">
6768         <type name="gint" c:type="gint"/>
6769       </field>
6770       <field name="dbus_error_name" writable="1">
6771         <type name="utf8" c:type="gchar*"/>
6772       </field>
6773     </record>
6774     <callback name="DBusInterfaceGetPropertyFunc"
6775               c:type="GDBusInterfaceGetPropertyFunc"
6776               version="2.26">
6777       <doc xml:whitespace="preserve">The type of the @get_property function in #GDBusInterfaceVTable.
6778 consumed - otherwise its reference count is decreased by one.</doc>
6779       <return-value transfer-ownership="full">
6780         <doc xml:whitespace="preserve">A #GVariant with the value for @property_name or %NULL if</doc>
6781         <type name="GLib.Variant" c:type="GVariant*"/>
6782       </return-value>
6783       <parameters>
6784         <parameter name="connection" transfer-ownership="none">
6785           <doc xml:whitespace="preserve">A #GDBusConnection.</doc>
6786           <type name="DBusConnection" c:type="GDBusConnection*"/>
6787         </parameter>
6788         <parameter name="sender" transfer-ownership="none">
6789           <doc xml:whitespace="preserve">The unique bus name of the remote caller.</doc>
6790           <type name="utf8" c:type="gchar*"/>
6791         </parameter>
6792         <parameter name="object_path" transfer-ownership="none">
6793           <doc xml:whitespace="preserve">The object path that the method was invoked on.</doc>
6794           <type name="utf8" c:type="gchar*"/>
6795         </parameter>
6796         <parameter name="interface_name" transfer-ownership="none">
6797           <doc xml:whitespace="preserve">The D-Bus interface name for the property.</doc>
6798           <type name="utf8" c:type="gchar*"/>
6799         </parameter>
6800         <parameter name="property_name" transfer-ownership="none">
6801           <doc xml:whitespace="preserve">The name of the property to get the value of.</doc>
6802           <type name="utf8" c:type="gchar*"/>
6803         </parameter>
6804         <parameter name="error" transfer-ownership="none">
6805           <doc xml:whitespace="preserve">Return location for error.</doc>
6806           <type name="GLib.Error" c:type="GError**"/>
6807         </parameter>
6808         <parameter name="user_data" transfer-ownership="none" closure="6">
6809           <doc xml:whitespace="preserve">The @user_data #gpointer passed to g_dbus_connection_register_object().</doc>
6810           <type name="gpointer" c:type="gpointer"/>
6811         </parameter>
6812       </parameters>
6813     </callback>
6814     <record name="DBusInterfaceInfo"
6815             c:type="GDBusInterfaceInfo"
6816             version="2.26"
6817             glib:type-name="GDBusInterfaceInfo"
6818             glib:get-type="g_dbus_interface_info_get_type"
6819             c:symbol-prefix="dbus_interface_info">
6820       <doc xml:whitespace="preserve">Information about a D-Bus interface.</doc>
6821       <field name="ref_count" writable="1">
6822         <type name="gint" c:type="gint"/>
6823       </field>
6824       <field name="name" writable="1">
6825         <type name="utf8" c:type="gchar*"/>
6826       </field>
6827       <field name="methods" writable="1">
6828         <type name="DBusMethodInfo" c:type="GDBusMethodInfo**"/>
6829       </field>
6830       <field name="signals" writable="1">
6831         <type name="DBusSignalInfo" c:type="GDBusSignalInfo**"/>
6832       </field>
6833       <field name="properties" writable="1">
6834         <type name="DBusPropertyInfo" c:type="GDBusPropertyInfo**"/>
6835       </field>
6836       <field name="annotations" writable="1">
6837         <type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo**"/>
6838       </field>
6839       <method name="generate_xml"
6840               c:identifier="g_dbus_interface_info_generate_xml"
6841               version="2.26">
6842         <doc xml:whitespace="preserve">Appends an XML representation of @info (and its children) to @string_builder.
6843 This function is typically used for generating introspection XML
6844 documents at run-time for handling the
6845 &lt;literal&gt;org.freedesktop.DBus.Introspectable.Introspect&lt;/literal&gt;
6846 method.</doc>
6847         <return-value transfer-ownership="none">
6848           <type name="none" c:type="void"/>
6849         </return-value>
6850         <parameters>
6851           <parameter name="indent" transfer-ownership="none">
6852             <doc xml:whitespace="preserve">Indentation level.</doc>
6853             <type name="guint" c:type="guint"/>
6854           </parameter>
6855           <parameter name="string_builder" transfer-ownership="none">
6856             <doc xml:whitespace="preserve">A #GString to to append XML data to.</doc>
6857             <type name="GLib.String" c:type="GString*"/>
6858           </parameter>
6859         </parameters>
6860       </method>
6861       <method name="lookup_method"
6862               c:identifier="g_dbus_interface_info_lookup_method"
6863               version="2.26">
6864         <doc xml:whitespace="preserve">Looks up information about a method.
6865 This cost of this function is O(n) in number of methods.</doc>
6866         <return-value transfer-ownership="full">
6867           <doc xml:whitespace="preserve">A #GDBusMethodInfo or %NULL if not found. Do not free, it is owned by @info.</doc>
6868           <type name="DBusMethodInfo" c:type="GDBusMethodInfo*"/>
6869         </return-value>
6870         <parameters>
6871           <parameter name="name" transfer-ownership="none">
6872             <doc xml:whitespace="preserve">A D-Bus method name (typically in CamelCase)</doc>
6873             <type name="utf8" c:type="gchar*"/>
6874           </parameter>
6875         </parameters>
6876       </method>
6877       <method name="lookup_property"
6878               c:identifier="g_dbus_interface_info_lookup_property"
6879               version="2.26">
6880         <doc xml:whitespace="preserve">Looks up information about a property.
6881 This cost of this function is O(n) in number of properties.</doc>
6882         <return-value transfer-ownership="full">
6883           <doc xml:whitespace="preserve">A #GDBusPropertyInfo or %NULL if not found. Do not free, it is owned by @info.</doc>
6884           <type name="DBusPropertyInfo" c:type="GDBusPropertyInfo*"/>
6885         </return-value>
6886         <parameters>
6887           <parameter name="name" transfer-ownership="none">
6888             <doc xml:whitespace="preserve">A D-Bus property name (typically in CamelCase).</doc>
6889             <type name="utf8" c:type="gchar*"/>
6890           </parameter>
6891         </parameters>
6892       </method>
6893       <method name="lookup_signal"
6894               c:identifier="g_dbus_interface_info_lookup_signal"
6895               version="2.26">
6896         <doc xml:whitespace="preserve">Looks up information about a signal.
6897 This cost of this function is O(n) in number of signals.</doc>
6898         <return-value transfer-ownership="full">
6899           <doc xml:whitespace="preserve">A #GDBusSignalInfo or %NULL if not found. Do not free, it is owned by @info.</doc>
6900           <type name="DBusSignalInfo" c:type="GDBusSignalInfo*"/>
6901         </return-value>
6902         <parameters>
6903           <parameter name="name" transfer-ownership="none">
6904             <doc xml:whitespace="preserve">A D-Bus signal name (typically in CamelCase)</doc>
6905             <type name="utf8" c:type="gchar*"/>
6906           </parameter>
6907         </parameters>
6908       </method>
6909       <method name="ref"
6910               c:identifier="g_dbus_interface_info_ref"
6911               version="2.26">
6912         <doc xml:whitespace="preserve">If @info is statically allocated does nothing. Otherwise increases
6913 the reference count.</doc>
6914         <return-value transfer-ownership="full">
6915           <doc xml:whitespace="preserve">The same @info.</doc>
6916           <type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
6917         </return-value>
6918       </method>
6919       <method name="unref"
6920               c:identifier="g_dbus_interface_info_unref"
6921               version="2.26">
6922         <doc xml:whitespace="preserve">If @info is statically allocated, does nothing. Otherwise decreases
6923 the reference count of @info. When its reference count drops to 0,
6924 the memory used is freed.</doc>
6925         <return-value transfer-ownership="none">
6926           <type name="none" c:type="void"/>
6927         </return-value>
6928       </method>
6929     </record>
6930     <callback name="DBusInterfaceMethodCallFunc"
6931               c:type="GDBusInterfaceMethodCallFunc"
6932               version="2.26">
6933       <doc xml:whitespace="preserve">The type of the @method_call function in #GDBusInterfaceVTable.</doc>
6934       <return-value transfer-ownership="none">
6935         <type name="none" c:type="void"/>
6936       </return-value>
6937       <parameters>
6938         <parameter name="connection" transfer-ownership="none">
6939           <doc xml:whitespace="preserve">A #GDBusConnection.</doc>
6940           <type name="DBusConnection" c:type="GDBusConnection*"/>
6941         </parameter>
6942         <parameter name="sender" transfer-ownership="none">
6943           <doc xml:whitespace="preserve">The unique bus name of the remote caller.</doc>
6944           <type name="utf8" c:type="gchar*"/>
6945         </parameter>
6946         <parameter name="object_path" transfer-ownership="none">
6947           <doc xml:whitespace="preserve">The object path that the method was invoked on.</doc>
6948           <type name="utf8" c:type="gchar*"/>
6949         </parameter>
6950         <parameter name="interface_name" transfer-ownership="none">
6951           <doc xml:whitespace="preserve">The D-Bus interface name the method was invoked on.</doc>
6952           <type name="utf8" c:type="gchar*"/>
6953         </parameter>
6954         <parameter name="method_name" transfer-ownership="none">
6955           <doc xml:whitespace="preserve">The name of the method that was invoked.</doc>
6956           <type name="utf8" c:type="gchar*"/>
6957         </parameter>
6958         <parameter name="parameters" transfer-ownership="none">
6959           <doc xml:whitespace="preserve">A #GVariant tuple with parameters.</doc>
6960           <type name="GLib.Variant" c:type="GVariant*"/>
6961         </parameter>
6962         <parameter name="invocation" transfer-ownership="none">
6963           <doc xml:whitespace="preserve">A #GDBusMethodInvocation object that can be used to return a value or error.</doc>
6964           <type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
6965         </parameter>
6966         <parameter name="user_data" transfer-ownership="none" closure="7">
6967           <doc xml:whitespace="preserve">The @user_data #gpointer passed to g_dbus_connection_register_object().</doc>
6968           <type name="gpointer" c:type="gpointer"/>
6969         </parameter>
6970       </parameters>
6971     </callback>
6972     <callback name="DBusInterfaceSetPropertyFunc"
6973               c:type="GDBusInterfaceSetPropertyFunc"
6974               version="2.26">
6975       <doc xml:whitespace="preserve">The type of the @set_property function in #GDBusInterfaceVTable.</doc>
6976       <return-value transfer-ownership="none">
6977         <doc xml:whitespace="preserve">%TRUE if the property was set to @value, %FALSE if @error is set.</doc>
6978         <type name="gboolean" c:type="gboolean"/>
6979       </return-value>
6980       <parameters>
6981         <parameter name="connection" transfer-ownership="none">
6982           <doc xml:whitespace="preserve">A #GDBusConnection.</doc>
6983           <type name="DBusConnection" c:type="GDBusConnection*"/>
6984         </parameter>
6985         <parameter name="sender" transfer-ownership="none">
6986           <doc xml:whitespace="preserve">The unique bus name of the remote caller.</doc>
6987           <type name="utf8" c:type="gchar*"/>
6988         </parameter>
6989         <parameter name="object_path" transfer-ownership="none">
6990           <doc xml:whitespace="preserve">The object path that the method was invoked on.</doc>
6991           <type name="utf8" c:type="gchar*"/>
6992         </parameter>
6993         <parameter name="interface_name" transfer-ownership="none">
6994           <doc xml:whitespace="preserve">The D-Bus interface name for the property.</doc>
6995           <type name="utf8" c:type="gchar*"/>
6996         </parameter>
6997         <parameter name="property_name" transfer-ownership="none">
6998           <doc xml:whitespace="preserve">The name of the property to get the value of.</doc>
6999           <type name="utf8" c:type="gchar*"/>
7000         </parameter>
7001         <parameter name="value" transfer-ownership="none">
7002           <doc xml:whitespace="preserve">The value to set the property to.</doc>
7003           <type name="GLib.Variant" c:type="GVariant*"/>
7004         </parameter>
7005         <parameter name="error" transfer-ownership="none">
7006           <doc xml:whitespace="preserve">Return location for error.</doc>
7007           <type name="GLib.Error" c:type="GError**"/>
7008         </parameter>
7009         <parameter name="user_data" transfer-ownership="none" closure="7">
7010           <doc xml:whitespace="preserve">The @user_data #gpointer passed to g_dbus_connection_register_object().</doc>
7011           <type name="gpointer" c:type="gpointer"/>
7012         </parameter>
7013       </parameters>
7014     </callback>
7015     <record name="DBusInterfaceVTable"
7016             c:type="GDBusInterfaceVTable"
7017             version="2.26">
7018       <doc xml:whitespace="preserve">Virtual table for handling properties and method calls for a D-Bus
7019 interface.
7020 If you want to handle getting/setting D-Bus properties asynchronously, simply
7021 register an object with the &lt;literal&gt;org.freedesktop.DBus.Properties&lt;/literal&gt;
7022 D-Bus interface using g_dbus_connection_register_object().</doc>
7023       <field name="method_call" writable="1">
7024         <type name="DBusInterfaceMethodCallFunc"
7025               c:type="GDBusInterfaceMethodCallFunc"/>
7026       </field>
7027       <field name="get_property" writable="1">
7028         <type name="DBusInterfaceGetPropertyFunc"
7029               c:type="GDBusInterfaceGetPropertyFunc"/>
7030       </field>
7031       <field name="set_property" writable="1">
7032         <type name="DBusInterfaceSetPropertyFunc"
7033               c:type="GDBusInterfaceSetPropertyFunc"/>
7034       </field>
7035       <field name="padding" writable="1">
7036         <array zero-terminated="0" c:type="gpointer" fixed-size="8">
7037           <type name="gpointer" c:type="gpointer"/>
7038         </array>
7039       </field>
7040     </record>
7041     <class name="DBusMessage"
7042            c:symbol-prefix="dbus_message"
7043            c:type="GDBusMessage"
7044            version="2.26"
7045            parent="GObject.Object"
7046            glib:type-name="GDBusMessage"
7047            glib:get-type="g_dbus_message_get_type">
7048       <doc xml:whitespace="preserve">The #GDBusMessage structure contains only private data and should
7049 only be accessed using the provided API.</doc>
7050       <constructor name="new" c:identifier="g_dbus_message_new" version="2.26">
7051         <doc xml:whitespace="preserve">Creates a new empty #GDBusMessage.</doc>
7052         <return-value transfer-ownership="full">
7053           <doc xml:whitespace="preserve">A #GDBusMessage. Free with g_object_unref().</doc>
7054           <type name="DBusMessage" c:type="GDBusMessage*"/>
7055         </return-value>
7056       </constructor>
7057       <constructor name="new_from_blob"
7058                    c:identifier="g_dbus_message_new_from_blob"
7059                    version="2.26"
7060                    throws="1">
7061         <doc xml:whitespace="preserve">Creates a new #GDBusMessage from the data stored at @blob. The byte
7062 order that the message was in can be retrieved using
7063 g_dbus_message_get_byte_order().
7064 g_object_unref().</doc>
7065         <return-value transfer-ownership="full">
7066           <doc xml:whitespace="preserve">A new #GDBusMessage or %NULL if @error is set. Free with</doc>
7067           <type name="DBusMessage" c:type="GDBusMessage*"/>
7068         </return-value>
7069         <parameters>
7070           <parameter name="blob" transfer-ownership="none">
7071             <doc xml:whitespace="preserve">A blob represent a binary D-Bus message.</doc>
7072             <type name="guint8" c:type="guchar*"/>
7073           </parameter>
7074           <parameter name="blob_len" transfer-ownership="none">
7075             <doc xml:whitespace="preserve">The length of @blob.</doc>
7076             <type name="gulong" c:type="gsize"/>
7077           </parameter>
7078           <parameter name="capabilities" transfer-ownership="none">
7079             <doc xml:whitespace="preserve">A #GDBusCapabilityFlags describing what protocol features are supported.</doc>
7080             <type name="DBusCapabilityFlags" c:type="GDBusCapabilityFlags"/>
7081           </parameter>
7082         </parameters>
7083       </constructor>
7084       <constructor name="new_method_call"
7085                    c:identifier="g_dbus_message_new_method_call"
7086                    version="2.26">
7087         <doc xml:whitespace="preserve">Creates a new #GDBusMessage for a method call.</doc>
7088         <return-value transfer-ownership="full">
7089           <doc xml:whitespace="preserve">A #GDBusMessage. Free with g_object_unref().</doc>
7090           <type name="DBusMessage" c:type="GDBusMessage*"/>
7091         </return-value>
7092         <parameters>
7093           <parameter name="name" transfer-ownership="none">
7094             <doc xml:whitespace="preserve">A valid D-Bus name or %NULL.</doc>
7095             <type name="utf8" c:type="gchar*"/>
7096           </parameter>
7097           <parameter name="path" transfer-ownership="none">
7098             <doc xml:whitespace="preserve">A valid object path.</doc>
7099             <type name="utf8" c:type="gchar*"/>
7100           </parameter>
7101           <parameter name="interface_" transfer-ownership="none">
7102             <doc xml:whitespace="preserve">A valid D-Bus interface name or %NULL.</doc>
7103             <type name="utf8" c:type="gchar*"/>
7104           </parameter>
7105           <parameter name="method" transfer-ownership="none">
7106             <doc xml:whitespace="preserve">A valid method name.</doc>
7107             <type name="utf8" c:type="gchar*"/>
7108           </parameter>
7109         </parameters>
7110       </constructor>
7111       <constructor name="new_signal"
7112                    c:identifier="g_dbus_message_new_signal"
7113                    version="2.26">
7114         <doc xml:whitespace="preserve">Creates a new #GDBusMessage for a signal emission.</doc>
7115         <return-value transfer-ownership="full">
7116           <doc xml:whitespace="preserve">A #GDBusMessage. Free with g_object_unref().</doc>
7117           <type name="DBusMessage" c:type="GDBusMessage*"/>
7118         </return-value>
7119         <parameters>
7120           <parameter name="path" transfer-ownership="none">
7121             <doc xml:whitespace="preserve">A valid object path.</doc>
7122             <type name="utf8" c:type="gchar*"/>
7123           </parameter>
7124           <parameter name="interface_" transfer-ownership="none">
7125             <doc xml:whitespace="preserve">A valid D-Bus interface name.</doc>
7126             <type name="utf8" c:type="gchar*"/>
7127           </parameter>
7128           <parameter name="signal" transfer-ownership="none">
7129             <doc xml:whitespace="preserve">A valid signal name.</doc>
7130             <type name="utf8" c:type="gchar*"/>
7131           </parameter>
7132         </parameters>
7133       </constructor>
7134       <function name="bytes_needed"
7135                 c:identifier="g_dbus_message_bytes_needed"
7136                 version="2.26"
7137                 throws="1">
7138         <doc xml:whitespace="preserve">Utility function to calculate how many bytes are needed to
7139 completely deserialize the D-Bus message stored at @blob.
7140 determine the size).</doc>
7141         <return-value transfer-ownership="none">
7142           <doc xml:whitespace="preserve">Number of bytes needed or -1 if @error is set (e.g. if</doc>
7143           <type name="glong" c:type="gssize"/>
7144         </return-value>
7145         <parameters>
7146           <parameter name="blob" transfer-ownership="none">
7147             <doc xml:whitespace="preserve">A blob represent a binary D-Bus message.</doc>
7148             <type name="guint8" c:type="guchar*"/>
7149           </parameter>
7150           <parameter name="blob_len" transfer-ownership="none">
7151             <doc xml:whitespace="preserve">The length of @blob (must be at least 16).</doc>
7152             <type name="gulong" c:type="gsize"/>
7153           </parameter>
7154         </parameters>
7155       </function>
7156       <method name="copy"
7157               c:identifier="g_dbus_message_copy"
7158               version="2.26"
7159               throws="1">
7160         <doc xml:whitespace="preserve">Copies @message. The copy is a deep copy and the returned
7161 #GDBusMessage is completely identical except that it is guaranteed
7162 to not be locked.
7163 This operation can fail if e.g. @message contains file descriptors
7164 and the per-process or system-wide open files limit is reached.
7165 g_object_unref().</doc>
7166         <return-value transfer-ownership="full">
7167           <doc xml:whitespace="preserve">A new #GDBusMessage or %NULL if @error is set. Free with</doc>
7168           <type name="DBusMessage" c:type="GDBusMessage*"/>
7169         </return-value>
7170       </method>
7171       <method name="get_arg0"
7172               c:identifier="g_dbus_message_get_arg0"
7173               version="2.26">
7174         <doc xml:whitespace="preserve">Convenience to get the first item in the body of @message.</doc>
7175         <return-value transfer-ownership="none">
7176           <doc xml:whitespace="preserve">The string item or %NULL if the first item in the body of</doc>
7177           <type name="utf8" c:type="gchar*"/>
7178         </return-value>
7179       </method>
7180       <method name="get_body"
7181               c:identifier="g_dbus_message_get_body"
7182               version="2.26">
7183         <doc xml:whitespace="preserve">Gets the body of a message.</doc>
7184         <return-value transfer-ownership="full">
7185           <doc xml:whitespace="preserve">A #GVariant or %NULL if the body is empty. Do not free, it is owned by @message.</doc>
7186           <type name="GLib.Variant" c:type="GVariant*"/>
7187         </return-value>
7188       </method>
7189       <method name="get_byte_order"
7190               c:identifier="g_dbus_message_get_byte_order">
7191         <doc xml:whitespace="preserve">Gets the byte order of @message.</doc>
7192         <return-value transfer-ownership="none">
7193           <doc xml:whitespace="preserve">The byte order.</doc>
7194           <type name="DBusMessageByteOrder" c:type="GDBusMessageByteOrder"/>
7195         </return-value>
7196       </method>
7197       <method name="get_destination"
7198               c:identifier="g_dbus_message_get_destination"
7199               version="2.26">
7200         <doc xml:whitespace="preserve">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field.</doc>
7201         <return-value transfer-ownership="none">
7202           <doc xml:whitespace="preserve">The value.</doc>
7203           <type name="utf8" c:type="gchar*"/>
7204         </return-value>
7205       </method>
7206       <method name="get_error_name"
7207               c:identifier="g_dbus_message_get_error_name"
7208               version="2.26">
7209         <doc xml:whitespace="preserve">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field.</doc>
7210         <return-value transfer-ownership="none">
7211           <doc xml:whitespace="preserve">The value.</doc>
7212           <type name="utf8" c:type="gchar*"/>
7213         </return-value>
7214       </method>
7215       <method name="get_flags"
7216               c:identifier="g_dbus_message_get_flags"
7217               version="2.26">
7218         <doc xml:whitespace="preserve">Gets the flags for @message.</doc>
7219         <return-value transfer-ownership="none">
7220           <doc xml:whitespace="preserve">Flags that are set (typically values from the #GDBusMessageFlags enumeration bitwise ORed together).</doc>
7221           <type name="DBusMessageFlags" c:type="GDBusMessageFlags"/>
7222         </return-value>
7223       </method>
7224       <method name="get_header"
7225               c:identifier="g_dbus_message_get_header"
7226               version="2.26">
7227         <doc xml:whitespace="preserve">Gets a header field on @message.
7228 otherwise. Do not free, it is owned by @message.</doc>
7229         <return-value transfer-ownership="full">
7230           <doc xml:whitespace="preserve">A #GVariant with the value if the header was found, %NULL</doc>
7231           <type name="GLib.Variant" c:type="GVariant*"/>
7232         </return-value>
7233         <parameters>
7234           <parameter name="header_field" transfer-ownership="none">
7235             <doc xml:whitespace="preserve">A 8-bit unsigned integer (typically a value from the #GDBusMessageHeaderField enumeration)</doc>
7236             <type name="DBusMessageHeaderField"
7237                   c:type="GDBusMessageHeaderField"/>
7238           </parameter>
7239         </parameters>
7240       </method>
7241       <method name="get_header_fields"
7242               c:identifier="g_dbus_message_get_header_fields"
7243               version="2.26">
7244         <doc xml:whitespace="preserve">Gets an array of all header fields on @message that are set.
7245 %G_DBUS_MESSAGE_HEADER_FIELD_INVALID.  Each element is a
7246 #guchar. Free with g_free().</doc>
7247         <return-value transfer-ownership="none">
7248           <doc xml:whitespace="preserve">An array of header fields terminated by</doc>
7249           <type name="guint8" c:type="guchar*"/>
7250         </return-value>
7251       </method>
7252       <method name="get_interface"
7253               c:identifier="g_dbus_message_get_interface"
7254               version="2.26">
7255         <doc xml:whitespace="preserve">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field.</doc>
7256         <return-value transfer-ownership="none">
7257           <doc xml:whitespace="preserve">The value.</doc>
7258           <type name="utf8" c:type="gchar*"/>
7259         </return-value>
7260       </method>
7261       <method name="get_locked"
7262               c:identifier="g_dbus_message_get_locked"
7263               version="2.26">
7264         <doc xml:whitespace="preserve">Checks whether @message is locked. To monitor changes to this
7265 value, conncet to the #GObject::notify signal to listen for changes
7266 on the #GDBusMessage:locked property.</doc>
7267         <return-value transfer-ownership="none">
7268           <doc xml:whitespace="preserve">%TRUE if @message is locked, %FALSE otherwise.</doc>
7269           <type name="gboolean" c:type="gboolean"/>
7270         </return-value>
7271       </method>
7272       <method name="get_member"
7273               c:identifier="g_dbus_message_get_member"
7274               version="2.26">
7275         <doc xml:whitespace="preserve">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field.</doc>
7276         <return-value transfer-ownership="none">
7277           <doc xml:whitespace="preserve">The value.</doc>
7278           <type name="utf8" c:type="gchar*"/>
7279         </return-value>
7280       </method>
7281       <method name="get_message_type"
7282               c:identifier="g_dbus_message_get_message_type"
7283               version="2.26">
7284         <doc xml:whitespace="preserve">Gets the type of @message.</doc>
7285         <return-value transfer-ownership="none">
7286           <doc xml:whitespace="preserve">A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration).</doc>
7287           <type name="DBusMessageType" c:type="GDBusMessageType"/>
7288         </return-value>
7289       </method>
7290       <method name="get_num_unix_fds"
7291               c:identifier="g_dbus_message_get_num_unix_fds"
7292               version="2.26">
7293         <doc xml:whitespace="preserve">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field.</doc>
7294         <return-value transfer-ownership="none">
7295           <doc xml:whitespace="preserve">The value.</doc>
7296           <type name="guint32" c:type="guint32"/>
7297         </return-value>
7298       </method>
7299       <method name="get_path"
7300               c:identifier="g_dbus_message_get_path"
7301               version="2.26">
7302         <doc xml:whitespace="preserve">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field.</doc>
7303         <return-value transfer-ownership="none">
7304           <doc xml:whitespace="preserve">The value.</doc>
7305           <type name="utf8" c:type="gchar*"/>
7306         </return-value>
7307       </method>
7308       <method name="get_reply_serial"
7309               c:identifier="g_dbus_message_get_reply_serial"
7310               version="2.26">
7311         <doc xml:whitespace="preserve">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field.</doc>
7312         <return-value transfer-ownership="none">
7313           <doc xml:whitespace="preserve">The value.</doc>
7314           <type name="guint32" c:type="guint32"/>
7315         </return-value>
7316       </method>
7317       <method name="get_sender"
7318               c:identifier="g_dbus_message_get_sender"
7319               version="2.26">
7320         <doc xml:whitespace="preserve">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field.</doc>
7321         <return-value transfer-ownership="none">
7322           <doc xml:whitespace="preserve">The value.</doc>
7323           <type name="utf8" c:type="gchar*"/>
7324         </return-value>
7325       </method>
7326       <method name="get_serial"
7327               c:identifier="g_dbus_message_get_serial"
7328               version="2.26">
7329         <doc xml:whitespace="preserve">Gets the serial for @message.</doc>
7330         <return-value transfer-ownership="none">
7331           <doc xml:whitespace="preserve">A #guint32.</doc>
7332           <type name="guint32" c:type="guint32"/>
7333         </return-value>
7334       </method>
7335       <method name="get_signature"
7336               c:identifier="g_dbus_message_get_signature"
7337               version="2.26">
7338         <doc xml:whitespace="preserve">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field.</doc>
7339         <return-value transfer-ownership="none">
7340           <doc xml:whitespace="preserve">The value.</doc>
7341           <type name="utf8" c:type="gchar*"/>
7342         </return-value>
7343       </method>
7344       <method name="get_unix_fd_list"
7345               c:identifier="g_dbus_message_get_unix_fd_list"
7346               version="2.26">
7347         <doc xml:whitespace="preserve">Gets the UNIX file descriptors associated with @message, if any.
7348 This method is only available on UNIX.
7349 associated. Do not free, this object is owned by @message.</doc>
7350         <return-value transfer-ownership="none">
7351           <doc xml:whitespace="preserve">A #GUnixFDList or %NULL if no file descriptors are</doc>
7352           <type name="UnixFDList" c:type="GUnixFDList*"/>
7353         </return-value>
7354       </method>
7355       <method name="lock" c:identifier="g_dbus_message_lock" version="2.26">
7356         <doc xml:whitespace="preserve">If @message is locked, does nothing. Otherwise locks the message.</doc>
7357         <return-value transfer-ownership="none">
7358           <type name="none" c:type="void"/>
7359         </return-value>
7360       </method>
7361       <method name="new_method_error"
7362               c:identifier="g_dbus_message_new_method_error"
7363               version="2.26"
7364               introspectable="0">
7365         <doc xml:whitespace="preserve">Creates a new #GDBusMessage that is an error reply to @method_call_message.</doc>
7366         <return-value transfer-ownership="full">
7367           <doc xml:whitespace="preserve">A #GDBusMessage. Free with g_object_unref().</doc>
7368           <type name="DBusMessage" c:type="GDBusMessage*"/>
7369         </return-value>
7370         <parameters>
7371           <parameter name="error_name" transfer-ownership="none">
7372             <doc xml:whitespace="preserve">A valid D-Bus error name.</doc>
7373             <type name="utf8" c:type="gchar*"/>
7374           </parameter>
7375           <parameter name="error_message_format" transfer-ownership="none">
7376             <doc xml:whitespace="preserve">The D-Bus error message in a printf() format.</doc>
7377             <type name="utf8" c:type="gchar*"/>
7378           </parameter>
7379           <parameter transfer-ownership="none">
7380             <varargs>
7381             </varargs>
7382           </parameter>
7383         </parameters>
7384       </method>
7385       <method name="new_method_error_literal"
7386               c:identifier="g_dbus_message_new_method_error_literal"
7387               version="2.26">
7388         <doc xml:whitespace="preserve">Creates a new #GDBusMessage that is an error reply to @method_call_message.</doc>
7389         <return-value transfer-ownership="full">
7390           <doc xml:whitespace="preserve">A #GDBusMessage. Free with g_object_unref().</doc>
7391           <type name="DBusMessage" c:type="GDBusMessage*"/>
7392         </return-value>
7393         <parameters>
7394           <parameter name="error_name" transfer-ownership="none">
7395             <doc xml:whitespace="preserve">A valid D-Bus error name.</doc>
7396             <type name="utf8" c:type="gchar*"/>
7397           </parameter>
7398           <parameter name="error_message" transfer-ownership="none">
7399             <doc xml:whitespace="preserve">The D-Bus error message.</doc>
7400             <type name="utf8" c:type="gchar*"/>
7401           </parameter>
7402         </parameters>
7403       </method>
7404       <method name="new_method_error_valist"
7405               c:identifier="g_dbus_message_new_method_error_valist"
7406               version="2.26"
7407               introspectable="0">
7408         <doc xml:whitespace="preserve">Like g_dbus_message_new_method_error() but intended for language bindings.</doc>
7409         <return-value transfer-ownership="full">
7410           <doc xml:whitespace="preserve">A #GDBusMessage. Free with g_object_unref().</doc>
7411           <type name="DBusMessage" c:type="GDBusMessage*"/>
7412         </return-value>
7413         <parameters>
7414           <parameter name="error_name" transfer-ownership="none">
7415             <doc xml:whitespace="preserve">A valid D-Bus error name.</doc>
7416             <type name="utf8" c:type="gchar*"/>
7417           </parameter>
7418           <parameter name="error_message_format" transfer-ownership="none">
7419             <doc xml:whitespace="preserve">The D-Bus error message in a printf() format.</doc>
7420             <type name="utf8" c:type="gchar*"/>
7421           </parameter>
7422           <parameter name="var_args" transfer-ownership="none">
7423             <doc xml:whitespace="preserve">Arguments for @error_message_format.</doc>
7424             <type name="va_list" c:type="va_list"/>
7425           </parameter>
7426         </parameters>
7427       </method>
7428       <method name="new_method_reply"
7429               c:identifier="g_dbus_message_new_method_reply"
7430               version="2.26">
7431         <doc xml:whitespace="preserve">Creates a new #GDBusMessage that is a reply to @method_call_message.</doc>
7432         <return-value transfer-ownership="full">
7433           <doc xml:whitespace="preserve">#GDBusMessage. Free with g_object_unref().</doc>
7434           <type name="DBusMessage" c:type="GDBusMessage*"/>
7435         </return-value>
7436       </method>
7437       <method name="print" c:identifier="g_dbus_message_print" version="2.26">
7438         <doc xml:whitespace="preserve">Produces a human-readable multi-line description of @message.
7439 The contents of the description has no ABI guarantees, the contents
7440 and formatting is subject to change at any time. Typical output
7441 looks something like this:
7442 &lt;programlisting&gt;
7443 Headers:
7444 path -&gt; objectpath '/org/gtk/GDBus/TestObject'
7445 interface -&gt; 'org.gtk.GDBus.TestInterface'
7446 member -&gt; 'GimmeStdout'
7447 destination -&gt; ':1.146'
7448 UNIX File Descriptors:
7449 (none)
7450 &lt;/programlisting&gt;
7451 or
7452 &lt;programlisting&gt;
7453 Headers:
7454 reply-serial -&gt; uint32 4
7455 destination -&gt; ':1.159'
7456 sender -&gt; ':1.146'
7457 num-unix-fds -&gt; uint32 1
7458 UNIX File Descriptors:
7459 &lt;/programlisting&gt;</doc>
7460         <return-value transfer-ownership="full">
7461           <doc xml:whitespace="preserve">A string that should be freed with g_free().</doc>
7462           <type name="utf8" c:type="gchar*"/>
7463         </return-value>
7464         <parameters>
7465           <parameter name="indent" transfer-ownership="none">
7466             <doc xml:whitespace="preserve">Indentation level.</doc>
7467             <type name="guint" c:type="guint"/>
7468           </parameter>
7469         </parameters>
7470       </method>
7471       <method name="set_body"
7472               c:identifier="g_dbus_message_set_body"
7473               version="2.26">
7474         <doc xml:whitespace="preserve">Sets the body @message. As a side-effect the
7475 %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field is set to the
7476 type string of @body (or cleared if @body is %NULL).
7477 If @body is floating, @message assumes ownership of @body.</doc>
7478         <return-value transfer-ownership="none">
7479           <type name="none" c:type="void"/>
7480         </return-value>
7481         <parameters>
7482           <parameter name="body" transfer-ownership="none">
7483             <doc xml:whitespace="preserve">Either %NULL or a #GVariant that is a tuple.</doc>
7484             <type name="GLib.Variant" c:type="GVariant*"/>
7485           </parameter>
7486         </parameters>
7487       </method>
7488       <method name="set_byte_order"
7489               c:identifier="g_dbus_message_set_byte_order">
7490         <doc xml:whitespace="preserve">Sets the byte order of @message.</doc>
7491         <return-value transfer-ownership="none">
7492           <type name="none" c:type="void"/>
7493         </return-value>
7494         <parameters>
7495           <parameter name="byte_order" transfer-ownership="none">
7496             <doc xml:whitespace="preserve">The byte order.</doc>
7497             <type name="DBusMessageByteOrder" c:type="GDBusMessageByteOrder"/>
7498           </parameter>
7499         </parameters>
7500       </method>
7501       <method name="set_destination"
7502               c:identifier="g_dbus_message_set_destination"
7503               version="2.26">
7504         <doc xml:whitespace="preserve">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field.</doc>
7505         <return-value transfer-ownership="none">
7506           <type name="none" c:type="void"/>
7507         </return-value>
7508         <parameters>
7509           <parameter name="value" transfer-ownership="none">
7510             <doc xml:whitespace="preserve">The value to set.</doc>
7511             <type name="utf8" c:type="gchar*"/>
7512           </parameter>
7513         </parameters>
7514       </method>
7515       <method name="set_error_name"
7516               c:identifier="g_dbus_message_set_error_name"
7517               version="2.26">
7518         <doc xml:whitespace="preserve">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field.</doc>
7519         <return-value transfer-ownership="none">
7520           <type name="none" c:type="void"/>
7521         </return-value>
7522         <parameters>
7523           <parameter name="value" transfer-ownership="none">
7524             <doc xml:whitespace="preserve">The value to set.</doc>
7525             <type name="utf8" c:type="gchar*"/>
7526           </parameter>
7527         </parameters>
7528       </method>
7529       <method name="set_flags"
7530               c:identifier="g_dbus_message_set_flags"
7531               version="2.26">
7532         <doc xml:whitespace="preserve">Sets the flags to set on @message.</doc>
7533         <return-value transfer-ownership="none">
7534           <type name="none" c:type="void"/>
7535         </return-value>
7536         <parameters>
7537           <parameter name="flags" transfer-ownership="none">
7538             <doc xml:whitespace="preserve">Flags for @message that are set (typically values from the #GDBusMessageFlags enumeration bitwise ORed together).</doc>
7539             <type name="DBusMessageFlags" c:type="GDBusMessageFlags"/>
7540           </parameter>
7541         </parameters>
7542       </method>
7543       <method name="set_header"
7544               c:identifier="g_dbus_message_set_header"
7545               version="2.26">
7546         <doc xml:whitespace="preserve">Sets a header field on @message.
7547 If @value is floating, @message assumes ownership of @value.</doc>
7548         <return-value transfer-ownership="none">
7549           <type name="none" c:type="void"/>
7550         </return-value>
7551         <parameters>
7552           <parameter name="header_field" transfer-ownership="none">
7553             <doc xml:whitespace="preserve">A 8-bit unsigned integer (typically a value from the #GDBusMessageHeaderField enumeration)</doc>
7554             <type name="DBusMessageHeaderField"
7555                   c:type="GDBusMessageHeaderField"/>
7556           </parameter>
7557           <parameter name="value" transfer-ownership="none">
7558             <doc xml:whitespace="preserve">A #GVariant to set the header field or %NULL to clear the header field.</doc>
7559             <type name="GLib.Variant" c:type="GVariant*"/>
7560           </parameter>
7561         </parameters>
7562       </method>
7563       <method name="set_interface"
7564               c:identifier="g_dbus_message_set_interface"
7565               version="2.26">
7566         <doc xml:whitespace="preserve">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field.</doc>
7567         <return-value transfer-ownership="none">
7568           <type name="none" c:type="void"/>
7569         </return-value>
7570         <parameters>
7571           <parameter name="value" transfer-ownership="none">
7572             <doc xml:whitespace="preserve">The value to set.</doc>
7573             <type name="utf8" c:type="gchar*"/>
7574           </parameter>
7575         </parameters>
7576       </method>
7577       <method name="set_member"
7578               c:identifier="g_dbus_message_set_member"
7579               version="2.26">
7580         <doc xml:whitespace="preserve">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field.</doc>
7581         <return-value transfer-ownership="none">
7582           <type name="none" c:type="void"/>
7583         </return-value>
7584         <parameters>
7585           <parameter name="value" transfer-ownership="none">
7586             <doc xml:whitespace="preserve">The value to set.</doc>
7587             <type name="utf8" c:type="gchar*"/>
7588           </parameter>
7589         </parameters>
7590       </method>
7591       <method name="set_message_type"
7592               c:identifier="g_dbus_message_set_message_type"
7593               version="2.26">
7594         <doc xml:whitespace="preserve">Sets @message to be of @type.</doc>
7595         <return-value transfer-ownership="none">
7596           <type name="none" c:type="void"/>
7597         </return-value>
7598         <parameters>
7599           <parameter name="type" transfer-ownership="none">
7600             <doc xml:whitespace="preserve">A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration).</doc>
7601             <type name="DBusMessageType" c:type="GDBusMessageType"/>
7602           </parameter>
7603         </parameters>
7604       </method>
7605       <method name="set_num_unix_fds"
7606               c:identifier="g_dbus_message_set_num_unix_fds"
7607               version="2.26">
7608         <doc xml:whitespace="preserve">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field.</doc>
7609         <return-value transfer-ownership="none">
7610           <type name="none" c:type="void"/>
7611         </return-value>
7612         <parameters>
7613           <parameter name="value" transfer-ownership="none">
7614             <doc xml:whitespace="preserve">The value to set.</doc>
7615             <type name="guint32" c:type="guint32"/>
7616           </parameter>
7617         </parameters>
7618       </method>
7619       <method name="set_path"
7620               c:identifier="g_dbus_message_set_path"
7621               version="2.26">
7622         <doc xml:whitespace="preserve">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field.</doc>
7623         <return-value transfer-ownership="none">
7624           <type name="none" c:type="void"/>
7625         </return-value>
7626         <parameters>
7627           <parameter name="value" transfer-ownership="none">
7628             <doc xml:whitespace="preserve">The value to set.</doc>
7629             <type name="utf8" c:type="gchar*"/>
7630           </parameter>
7631         </parameters>
7632       </method>
7633       <method name="set_reply_serial"
7634               c:identifier="g_dbus_message_set_reply_serial"
7635               version="2.26">
7636         <doc xml:whitespace="preserve">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field.</doc>
7637         <return-value transfer-ownership="none">
7638           <type name="none" c:type="void"/>
7639         </return-value>
7640         <parameters>
7641           <parameter name="value" transfer-ownership="none">
7642             <doc xml:whitespace="preserve">The value to set.</doc>
7643             <type name="guint32" c:type="guint32"/>
7644           </parameter>
7645         </parameters>
7646       </method>
7647       <method name="set_sender"
7648               c:identifier="g_dbus_message_set_sender"
7649               version="2.26">
7650         <doc xml:whitespace="preserve">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field.</doc>
7651         <return-value transfer-ownership="none">
7652           <type name="none" c:type="void"/>
7653         </return-value>
7654         <parameters>
7655           <parameter name="value" transfer-ownership="none">
7656             <doc xml:whitespace="preserve">The value to set.</doc>
7657             <type name="utf8" c:type="gchar*"/>
7658           </parameter>
7659         </parameters>
7660       </method>
7661       <method name="set_serial"
7662               c:identifier="g_dbus_message_set_serial"
7663               version="2.26">
7664         <doc xml:whitespace="preserve">Sets the serial for @message.</doc>
7665         <return-value transfer-ownership="none">
7666           <type name="none" c:type="void"/>
7667         </return-value>
7668         <parameters>
7669           <parameter name="serial" transfer-ownership="none">
7670             <doc xml:whitespace="preserve">A #guint32.</doc>
7671             <type name="guint32" c:type="guint32"/>
7672           </parameter>
7673         </parameters>
7674       </method>
7675       <method name="set_signature"
7676               c:identifier="g_dbus_message_set_signature"
7677               version="2.26">
7678         <doc xml:whitespace="preserve">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field.</doc>
7679         <return-value transfer-ownership="none">
7680           <type name="none" c:type="void"/>
7681         </return-value>
7682         <parameters>
7683           <parameter name="value" transfer-ownership="none">
7684             <doc xml:whitespace="preserve">The value to set.</doc>
7685             <type name="utf8" c:type="gchar*"/>
7686           </parameter>
7687         </parameters>
7688       </method>
7689       <method name="set_unix_fd_list"
7690               c:identifier="g_dbus_message_set_unix_fd_list"
7691               version="2.26">
7692         <doc xml:whitespace="preserve">Sets the UNIX file descriptors associated with @message. As a
7693 side-effect the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header
7694 field is set to the number of fds in @fd_list (or cleared if
7695 This method is only available on UNIX.</doc>
7696         <return-value transfer-ownership="none">
7697           <type name="none" c:type="void"/>
7698         </return-value>
7699         <parameters>
7700           <parameter name="fd_list" transfer-ownership="none" allow-none="1">
7701             <doc xml:whitespace="preserve">A #GUnixFDList or %NULL.</doc>
7702             <type name="UnixFDList" c:type="GUnixFDList*"/>
7703           </parameter>
7704         </parameters>
7705       </method>
7706       <method name="to_blob"
7707               c:identifier="g_dbus_message_to_blob"
7708               version="2.26"
7709               throws="1">
7710         <doc xml:whitespace="preserve">Serializes @message to a blob. The byte order returned by
7711 g_dbus_message_get_byte_order() will be used.
7712 generated by @message or %NULL if @error is set. Free with g_free().</doc>
7713         <return-value transfer-ownership="none">
7714           <doc xml:whitespace="preserve">A pointer to a valid binary D-Bus message of @out_size bytes</doc>
7715           <type name="guint8" c:type="guchar*"/>
7716         </return-value>
7717         <parameters>
7718           <parameter name="out_size" transfer-ownership="none">
7719             <doc xml:whitespace="preserve">Return location for size of generated blob.</doc>
7720             <type name="gulong" c:type="gsize*"/>
7721           </parameter>
7722           <parameter name="capabilities" transfer-ownership="none">
7723             <doc xml:whitespace="preserve">A #GDBusCapabilityFlags describing what protocol features are supported.</doc>
7724             <type name="DBusCapabilityFlags" c:type="GDBusCapabilityFlags"/>
7725           </parameter>
7726         </parameters>
7727       </method>
7728       <method name="to_gerror"
7729               c:identifier="g_dbus_message_to_gerror"
7730               version="2.26"
7731               throws="1">
7732         <doc xml:whitespace="preserve">If @message is not of type %G_DBUS_MESSAGE_TYPE_ERROR does
7733 nothing and returns %FALSE.
7734 Otherwise this method encodes the error in @message as a #GError
7735 using g_dbus_error_set_dbus_error() using the information in the
7736 %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field of @message as
7737 well as the first string item in @message's body.</doc>
7738         <return-value transfer-ownership="none">
7739           <doc xml:whitespace="preserve">%TRUE if @error was set, %FALSE otherwise.</doc>
7740           <type name="gboolean" c:type="gboolean"/>
7741         </return-value>
7742       </method>
7743       <property name="locked" transfer-ownership="none">
7744         <type name="gboolean"/>
7745       </property>
7746     </class>
7747     <enumeration name="DBusMessageByteOrder"
7748                  version="2.26"
7749                  glib:type-name="GDBusMessageByteOrder"
7750                  glib:get-type="g_dbus_message_byte_order_get_type"
7751                  c:type="GDBusMessageByteOrder">
7752       <doc xml:whitespace="preserve">Enumeration used to describe the byte order of a D-Bus message.</doc>
7753       <member name="big_endian"
7754               value="66"
7755               c:identifier="G_DBUS_MESSAGE_BYTE_ORDER_BIG_ENDIAN"
7756               glib:nick="big-endian"/>
7757       <member name="little_endian"
7758               value="108"
7759               c:identifier="G_DBUS_MESSAGE_BYTE_ORDER_LITTLE_ENDIAN"
7760               glib:nick="little-endian"/>
7761     </enumeration>
7762     <callback name="DBusMessageFilterFunction"
7763               c:type="GDBusMessageFilterFunction"
7764               version="2.26">
7765       <doc xml:whitespace="preserve">Signature for function used in g_dbus_connection_add_filter().
7766 A filter function is passed a #GDBusMessage and expected to return
7767 a #GDBusMessage too. Passive filter functions that don't modify the
7768 message can simply return the @message object:
7769 |[
7770 static GDBusMessage *
7771 passive_filter (GDBusConnection *connection
7772 GDBusMessage    *message,
7773 gboolean         incoming,
7774 gpointer         user_data)
7775 {
7776 /&lt;!-- --&gt;* inspect @message *&lt;!-- --&gt;/
7777 return message;
7778 }
7779 ]|
7780 Filter functions that wants to drop a message can simply return %NULL:
7781 |[
7782 static GDBusMessage *
7783 drop_filter (GDBusConnection *connection
7784 GDBusMessage    *message,
7785 gboolean         incoming,
7786 gpointer         user_data)
7787 {
7788 if (should_drop_message)
7789 {
7790 g_object_unref (message);
7791 message = NULL;
7792 }
7793 return message;
7794 }
7795 ]|
7796 Finally, a filter function may modify a message by copying it:
7797 |[
7798 static GDBusMessage *
7799 modifying_filter (GDBusConnection *connection
7800 GDBusMessage    *message,
7801 gboolean         incoming,
7802 gpointer         user_data)
7803 {
7804 GDBusMessage *copy;
7805 GError *error;
7806 error = NULL;
7807 copy = g_dbus_message_copy (message, &amp;error);
7808 /&lt;!-- --&gt;* handle @error being is set *&lt;!-- --&gt;/
7809 g_object_unref (message);
7810 /&lt;!-- --&gt;* modify @copy *&lt;!-- --&gt;/
7811 return copy;
7812 }
7813 ]|
7814 If the returned #GDBusMessage is different from @message and cannot
7815 be sent on @connection (it could use features, such as file
7816 descriptors, not compatible with @connection), then a warning is
7817 logged to &lt;emphasis&gt;standard error&lt;/emphasis&gt;. Applications can
7818 check this ahead of time using g_dbus_message_to_blob() passing a
7819 #GDBusCapabilityFlags value obtained from @connection.
7820 g_object_unref() or %NULL to drop the message. Passive filter
7821 functions can simply return the passed @message object.</doc>
7822       <return-value transfer-ownership="full">
7823         <doc xml:whitespace="preserve">A #GDBusMessage that will be freed with</doc>
7824         <type name="DBusMessage" c:type="GDBusMessage*"/>
7825       </return-value>
7826       <parameters>
7827         <parameter name="connection" transfer-ownership="none">
7828           <doc xml:whitespace="preserve">A #GDBusConnection.</doc>
7829           <type name="DBusConnection" c:type="GDBusConnection*"/>
7830         </parameter>
7831         <parameter name="message" transfer-ownership="full">
7832           <doc xml:whitespace="preserve">A locked #GDBusMessage that the filter function takes ownership of.</doc>
7833           <type name="DBusMessage" c:type="GDBusMessage*"/>
7834         </parameter>
7835         <parameter name="incoming" transfer-ownership="none">
7836           <doc xml:whitespace="preserve">%TRUE if it is a message received from the other peer, %FALSE if it is a message to be sent to the other peer.</doc>
7837           <type name="gboolean" c:type="gboolean"/>
7838         </parameter>
7839         <parameter name="user_data" transfer-ownership="none" closure="3">
7840           <doc xml:whitespace="preserve">User data passed when adding the filter.</doc>
7841           <type name="gpointer" c:type="gpointer"/>
7842         </parameter>
7843       </parameters>
7844     </callback>
7845     <bitfield name="DBusMessageFlags"
7846               version="2.26"
7847               glib:type-name="GDBusMessageFlags"
7848               glib:get-type="g_dbus_message_flags_get_type"
7849               c:type="GDBusMessageFlags">
7850       <doc xml:whitespace="preserve">Message flags used in #GDBusMessage.</doc>
7851       <member name="none"
7852               value="0"
7853               c:identifier="G_DBUS_MESSAGE_FLAGS_NONE"
7854               glib:nick="none"/>
7855       <member name="no_reply_expected"
7856               value="1"
7857               c:identifier="G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED"
7858               glib:nick="no-reply-expected"/>
7859       <member name="no_auto_start"
7860               value="2"
7861               c:identifier="G_DBUS_MESSAGE_FLAGS_NO_AUTO_START"
7862               glib:nick="no-auto-start"/>
7863     </bitfield>
7864     <enumeration name="DBusMessageHeaderField"
7865                  version="2.26"
7866                  glib:type-name="GDBusMessageHeaderField"
7867                  glib:get-type="g_dbus_message_header_field_get_type"
7868                  c:type="GDBusMessageHeaderField">
7869       <doc xml:whitespace="preserve">Header fields used in #GDBusMessage.</doc>
7870       <member name="invalid"
7871               value="0"
7872               c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_INVALID"
7873               glib:nick="invalid"/>
7874       <member name="path"
7875               value="1"
7876               c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_PATH"
7877               glib:nick="path"/>
7878       <member name="interface"
7879               value="2"
7880               c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE"
7881               glib:nick="interface"/>
7882       <member name="member"
7883               value="3"
7884               c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_MEMBER"
7885               glib:nick="member"/>
7886       <member name="error_name"
7887               value="4"
7888               c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME"
7889               glib:nick="error-name"/>
7890       <member name="reply_serial"
7891               value="5"
7892               c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL"
7893               glib:nick="reply-serial"/>
7894       <member name="destination"
7895               value="6"
7896               c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION"
7897               glib:nick="destination"/>
7898       <member name="sender"
7899               value="7"
7900               c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_SENDER"
7901               glib:nick="sender"/>
7902       <member name="signature"
7903               value="8"
7904               c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE"
7905               glib:nick="signature"/>
7906       <member name="num_unix_fds"
7907               value="9"
7908               c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS"
7909               glib:nick="num-unix-fds"/>
7910     </enumeration>
7911     <enumeration name="DBusMessageType"
7912                  version="2.26"
7913                  glib:type-name="GDBusMessageType"
7914                  glib:get-type="g_dbus_message_type_get_type"
7915                  c:type="GDBusMessageType">
7916       <doc xml:whitespace="preserve">Message types used in #GDBusMessage.</doc>
7917       <member name="invalid"
7918               value="0"
7919               c:identifier="G_DBUS_MESSAGE_TYPE_INVALID"
7920               glib:nick="invalid"/>
7921       <member name="method_call"
7922               value="1"
7923               c:identifier="G_DBUS_MESSAGE_TYPE_METHOD_CALL"
7924               glib:nick="method-call"/>
7925       <member name="method_return"
7926               value="2"
7927               c:identifier="G_DBUS_MESSAGE_TYPE_METHOD_RETURN"
7928               glib:nick="method-return"/>
7929       <member name="error"
7930               value="3"
7931               c:identifier="G_DBUS_MESSAGE_TYPE_ERROR"
7932               glib:nick="error"/>
7933       <member name="signal"
7934               value="4"
7935               c:identifier="G_DBUS_MESSAGE_TYPE_SIGNAL"
7936               glib:nick="signal"/>
7937     </enumeration>
7938     <record name="DBusMethodInfo"
7939             c:type="GDBusMethodInfo"
7940             version="2.26"
7941             glib:type-name="GDBusMethodInfo"
7942             glib:get-type="g_dbus_method_info_get_type"
7943             c:symbol-prefix="dbus_method_info">
7944       <doc xml:whitespace="preserve">Information about a method on an D-Bus interface.</doc>
7945       <field name="ref_count" writable="1">
7946         <type name="gint" c:type="gint"/>
7947       </field>
7948       <field name="name" writable="1">
7949         <type name="utf8" c:type="gchar*"/>
7950       </field>
7951       <field name="in_args" writable="1">
7952         <type name="DBusArgInfo" c:type="GDBusArgInfo**"/>
7953       </field>
7954       <field name="out_args" writable="1">
7955         <type name="DBusArgInfo" c:type="GDBusArgInfo**"/>
7956       </field>
7957       <field name="annotations" writable="1">
7958         <type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo**"/>
7959       </field>
7960       <method name="ref" c:identifier="g_dbus_method_info_ref" version="2.26">
7961         <doc xml:whitespace="preserve">If @info is statically allocated does nothing. Otherwise increases
7962 the reference count.</doc>
7963         <return-value transfer-ownership="full">
7964           <doc xml:whitespace="preserve">The same @info.</doc>
7965           <type name="DBusMethodInfo" c:type="GDBusMethodInfo*"/>
7966         </return-value>
7967       </method>
7968       <method name="unref"
7969               c:identifier="g_dbus_method_info_unref"
7970               version="2.26">
7971         <doc xml:whitespace="preserve">If @info is statically allocated, does nothing. Otherwise decreases
7972 the reference count of @info. When its reference count drops to 0,
7973 the memory used is freed.</doc>
7974         <return-value transfer-ownership="none">
7975           <type name="none" c:type="void"/>
7976         </return-value>
7977       </method>
7978     </record>
7979     <class name="DBusMethodInvocation"
7980            c:symbol-prefix="dbus_method_invocation"
7981            c:type="GDBusMethodInvocation"
7982            version="2.26"
7983            parent="GObject.Object"
7984            glib:type-name="GDBusMethodInvocation"
7985            glib:get-type="g_dbus_method_invocation_get_type">
7986       <doc xml:whitespace="preserve">The #GDBusMethodInvocation structure contains only private data and
7987 should only be accessed using the provided API.</doc>
7988       <method name="get_connection"
7989               c:identifier="g_dbus_method_invocation_get_connection"
7990               version="2.26">
7991         <doc xml:whitespace="preserve">Gets the #GDBusConnection the method was invoked on.</doc>
7992         <return-value transfer-ownership="none">
7993           <doc xml:whitespace="preserve">A #GDBusConnection. Do not free, it is owned by @invocation.</doc>
7994           <type name="DBusConnection" c:type="GDBusConnection*"/>
7995         </return-value>
7996       </method>
7997       <method name="get_interface_name"
7998               c:identifier="g_dbus_method_invocation_get_interface_name"
7999               version="2.26">
8000         <doc xml:whitespace="preserve">Gets the name of the D-Bus interface the method was invoked on.</doc>
8001         <return-value transfer-ownership="none">
8002           <doc xml:whitespace="preserve">A string. Do not free, it is owned by @invocation.</doc>
8003           <type name="utf8" c:type="gchar*"/>
8004         </return-value>
8005       </method>
8006       <method name="get_message"
8007               c:identifier="g_dbus_method_invocation_get_message"
8008               version="2.26">
8009         <doc xml:whitespace="preserve">Gets the #GDBusMessage for the method invocation. This is useful if
8010 you need to use low-level protocol features, such as UNIX file
8011 descriptor passing, that cannot be properly expressed in the
8012 #GVariant API.
8013 See &lt;xref linkend="gdbus-server"/&gt; and &lt;xref
8014 linkend="gdbus-unix-fd-client"/&gt; for an example of how to use this
8015 low-level API to send and receive UNIX file descriptors.</doc>
8016         <return-value transfer-ownership="none">
8017           <doc xml:whitespace="preserve">#GDBusMessage. Do not free, it is owned by @invocation.</doc>
8018           <type name="DBusMessage" c:type="GDBusMessage*"/>
8019         </return-value>
8020       </method>
8021       <method name="get_method_info"
8022               c:identifier="g_dbus_method_invocation_get_method_info"
8023               version="2.26">
8024         <doc xml:whitespace="preserve">Gets information about the method call, if any.</doc>
8025         <return-value transfer-ownership="none">
8026           <doc xml:whitespace="preserve">A #GDBusMethodInfo or %NULL. Do not free, it is owned by @invocation.</doc>
8027           <type name="DBusMethodInfo" c:type="GDBusMethodInfo*"/>
8028         </return-value>
8029       </method>
8030       <method name="get_method_name"
8031               c:identifier="g_dbus_method_invocation_get_method_name"
8032               version="2.26">
8033         <doc xml:whitespace="preserve">Gets the name of the method that was invoked.</doc>
8034         <return-value transfer-ownership="none">
8035           <doc xml:whitespace="preserve">A string. Do not free, it is owned by @invocation.</doc>
8036           <type name="utf8" c:type="gchar*"/>
8037         </return-value>
8038       </method>
8039       <method name="get_object_path"
8040               c:identifier="g_dbus_method_invocation_get_object_path"
8041               version="2.26">
8042         <doc xml:whitespace="preserve">Gets the object path the method was invoked on.</doc>
8043         <return-value transfer-ownership="none">
8044           <doc xml:whitespace="preserve">A string. Do not free, it is owned by @invocation.</doc>
8045           <type name="utf8" c:type="gchar*"/>
8046         </return-value>
8047       </method>
8048       <method name="get_parameters"
8049               c:identifier="g_dbus_method_invocation_get_parameters"
8050               version="2.26">
8051         <doc xml:whitespace="preserve">Gets the parameters of the method invocation.</doc>
8052         <return-value transfer-ownership="full">
8053           <doc xml:whitespace="preserve">A #GVariant. Do not free, it is owned by @invocation.</doc>
8054           <type name="GLib.Variant" c:type="GVariant*"/>
8055         </return-value>
8056       </method>
8057       <method name="get_sender"
8058               c:identifier="g_dbus_method_invocation_get_sender"
8059               version="2.26">
8060         <doc xml:whitespace="preserve">Gets the bus name that invoked the method.</doc>
8061         <return-value transfer-ownership="none">
8062           <doc xml:whitespace="preserve">A string. Do not free, it is owned by @invocation.</doc>
8063           <type name="utf8" c:type="gchar*"/>
8064         </return-value>
8065       </method>
8066       <method name="get_user_data"
8067               c:identifier="g_dbus_method_invocation_get_user_data"
8068               version="2.26"
8069               introspectable="0">
8070         <doc xml:whitespace="preserve">Gets the @user_data #gpointer passed to g_dbus_connection_register_object().</doc>
8071         <return-value>
8072           <doc xml:whitespace="preserve">A #gpointer.</doc>
8073           <type name="gpointer" c:type="gpointer"/>
8074         </return-value>
8075       </method>
8076       <method name="return_dbus_error"
8077               c:identifier="g_dbus_method_invocation_return_dbus_error"
8078               version="2.26">
8079         <doc xml:whitespace="preserve">Finishes handling a D-Bus method call by returning an error.
8080 This method will free @invocation, you cannot use it afterwards.</doc>
8081         <return-value transfer-ownership="none">
8082           <type name="none" c:type="void"/>
8083         </return-value>
8084         <parameters>
8085           <parameter name="error_name" transfer-ownership="none">
8086             <doc xml:whitespace="preserve">A valid D-Bus error name.</doc>
8087             <type name="utf8" c:type="gchar*"/>
8088           </parameter>
8089           <parameter name="error_message" transfer-ownership="none">
8090             <doc xml:whitespace="preserve">A valid D-Bus error message.</doc>
8091             <type name="utf8" c:type="gchar*"/>
8092           </parameter>
8093         </parameters>
8094       </method>
8095       <method name="return_error"
8096               c:identifier="g_dbus_method_invocation_return_error"
8097               version="2.26"
8098               introspectable="0">
8099         <doc xml:whitespace="preserve">Finishes handling a D-Bus method call by returning an error.
8100 See g_dbus_error_encode_gerror() for details about what error name
8101 will be returned on the wire. In a nutshell, if the given error is
8102 registered using g_dbus_error_register_error() the name given
8103 during registration is used. Otherwise, a name of the form
8104 &lt;literal&gt;org.gtk.GDBus.UnmappedGError.Quark...&lt;/literal&gt; is
8105 used. This provides transparent mapping of #GError between
8106 applications using GDBus.
8107 If you are writing an application intended to be portable,
8108 &lt;emphasis&gt;always&lt;/emphasis&gt; register errors with g_dbus_error_register_error()
8109 or use g_dbus_method_invocation_return_dbus_error().
8110 This method will free @invocation, you cannot use it afterwards.</doc>
8111         <return-value transfer-ownership="none">
8112           <type name="none" c:type="void"/>
8113         </return-value>
8114         <parameters>
8115           <parameter name="domain" transfer-ownership="none">
8116             <doc xml:whitespace="preserve">A #GQuark for the #GError error domain.</doc>
8117             <type name="GLib.Quark" c:type="GQuark"/>
8118           </parameter>
8119           <parameter name="code" transfer-ownership="none">
8120             <doc xml:whitespace="preserve">The error code.</doc>
8121             <type name="gint" c:type="gint"/>
8122           </parameter>
8123           <parameter name="format" transfer-ownership="none">
8124             <doc xml:whitespace="preserve">printf()-style format.</doc>
8125             <type name="utf8" c:type="gchar*"/>
8126           </parameter>
8127           <parameter transfer-ownership="none">
8128             <varargs>
8129             </varargs>
8130           </parameter>
8131         </parameters>
8132       </method>
8133       <method name="return_error_literal"
8134               c:identifier="g_dbus_method_invocation_return_error_literal"
8135               version="2.26">
8136         <doc xml:whitespace="preserve">Like g_dbus_method_invocation_return_error() but without printf()-style formatting.
8137 This method will free @invocation, you cannot use it afterwards.</doc>
8138         <return-value transfer-ownership="none">
8139           <type name="none" c:type="void"/>
8140         </return-value>
8141         <parameters>
8142           <parameter name="domain" transfer-ownership="none">
8143             <doc xml:whitespace="preserve">A #GQuark for the #GError error domain.</doc>
8144             <type name="GLib.Quark" c:type="GQuark"/>
8145           </parameter>
8146           <parameter name="code" transfer-ownership="none">
8147             <doc xml:whitespace="preserve">The error code.</doc>
8148             <type name="gint" c:type="gint"/>
8149           </parameter>
8150           <parameter name="message" transfer-ownership="none">
8151             <doc xml:whitespace="preserve">The error message.</doc>
8152             <type name="utf8" c:type="gchar*"/>
8153           </parameter>
8154         </parameters>
8155       </method>
8156       <method name="return_error_valist"
8157               c:identifier="g_dbus_method_invocation_return_error_valist"
8158               version="2.26"
8159               introspectable="0">
8160         <doc xml:whitespace="preserve">Like g_dbus_method_invocation_return_error() but intended for
8161 language bindings.
8162 This method will free @invocation, you cannot use it afterwards.</doc>
8163         <return-value transfer-ownership="none">
8164           <type name="none" c:type="void"/>
8165         </return-value>
8166         <parameters>
8167           <parameter name="domain" transfer-ownership="none">
8168             <doc xml:whitespace="preserve">A #GQuark for the #GError error domain.</doc>
8169             <type name="GLib.Quark" c:type="GQuark"/>
8170           </parameter>
8171           <parameter name="code" transfer-ownership="none">
8172             <doc xml:whitespace="preserve">The error code.</doc>
8173             <type name="gint" c:type="gint"/>
8174           </parameter>
8175           <parameter name="format" transfer-ownership="none">
8176             <doc xml:whitespace="preserve">printf()-style format.</doc>
8177             <type name="utf8" c:type="gchar*"/>
8178           </parameter>
8179           <parameter name="var_args" transfer-ownership="none">
8180             <doc xml:whitespace="preserve">#va_list of parameters for @format.</doc>
8181             <type name="va_list" c:type="va_list"/>
8182           </parameter>
8183         </parameters>
8184       </method>
8185       <method name="return_gerror"
8186               c:identifier="g_dbus_method_invocation_return_gerror"
8187               version="2.26">
8188         <doc xml:whitespace="preserve">Like g_dbus_method_invocation_return_error() but takes a #GError
8189 instead of the error domain, error code and message.
8190 This method will free @invocation, you cannot use it afterwards.</doc>
8191         <return-value transfer-ownership="none">
8192           <type name="none" c:type="void"/>
8193         </return-value>
8194         <parameters>
8195           <parameter name="error" transfer-ownership="none">
8196             <doc xml:whitespace="preserve">A #GError.</doc>
8197             <type name="GLib.Error" c:type="GError*"/>
8198           </parameter>
8199         </parameters>
8200       </method>
8201       <method name="return_value"
8202               c:identifier="g_dbus_method_invocation_return_value"
8203               version="2.26">
8204         <doc xml:whitespace="preserve">Finishes handling a D-Bus method call by returning @parameters.
8205 If the @parameters GVariant is floating, it is consumed.
8206 It is an error if @parameters is not of the right format.
8207 This method will free @invocation, you cannot use it afterwards.</doc>
8208         <return-value transfer-ownership="none">
8209           <type name="none" c:type="void"/>
8210         </return-value>
8211         <parameters>
8212           <parameter name="parameters" transfer-ownership="none">
8213             <doc xml:whitespace="preserve">A #GVariant tuple with out parameters for the method or %NULL if not passing any parameters.</doc>
8214             <type name="GLib.Variant" c:type="GVariant*"/>
8215           </parameter>
8216         </parameters>
8217       </method>
8218     </class>
8219     <record name="DBusNodeInfo"
8220             c:type="GDBusNodeInfo"
8221             version="2.26"
8222             glib:type-name="GDBusNodeInfo"
8223             glib:get-type="g_dbus_node_info_get_type"
8224             c:symbol-prefix="dbus_node_info">
8225       <doc xml:whitespace="preserve">Information about nodes in a remote object hierarchy.</doc>
8226       <field name="ref_count" writable="1">
8227         <type name="gint" c:type="gint"/>
8228       </field>
8229       <field name="path" writable="1">
8230         <type name="utf8" c:type="gchar*"/>
8231       </field>
8232       <field name="interfaces" writable="1">
8233         <type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo**"/>
8234       </field>
8235       <field name="nodes" writable="1">
8236         <type name="DBusNodeInfo" c:type="GDBusNodeInfo**"/>
8237       </field>
8238       <field name="annotations" writable="1">
8239         <type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo**"/>
8240       </field>
8241       <constructor name="new_for_xml"
8242                    c:identifier="g_dbus_node_info_new_for_xml"
8243                    version="2.26"
8244                    throws="1">
8245         <doc xml:whitespace="preserve">Parses @xml_data and returns a #GDBusNodeInfo representing the data.
8246 with g_dbus_node_info_unref().</doc>
8247         <return-value transfer-ownership="full">
8248           <doc xml:whitespace="preserve">A #GDBusNodeInfo structure or %NULL if @error is set. Free</doc>
8249           <type name="DBusNodeInfo" c:type="GDBusNodeInfo*"/>
8250         </return-value>
8251         <parameters>
8252           <parameter name="xml_data" transfer-ownership="none">
8253             <doc xml:whitespace="preserve">Valid D-Bus introspection XML.</doc>
8254             <type name="utf8" c:type="gchar*"/>
8255           </parameter>
8256         </parameters>
8257       </constructor>
8258       <method name="generate_xml"
8259               c:identifier="g_dbus_node_info_generate_xml"
8260               version="2.26">
8261         <doc xml:whitespace="preserve">Appends an XML representation of @info (and its children) to @string_builder.
8262 This function is typically used for generating introspection XML documents at run-time for
8263 handling the &lt;literal&gt;org.freedesktop.DBus.Introspectable.Introspect&lt;/literal&gt; method.</doc>
8264         <return-value transfer-ownership="none">
8265           <type name="none" c:type="void"/>
8266         </return-value>
8267         <parameters>
8268           <parameter name="indent" transfer-ownership="none">
8269             <doc xml:whitespace="preserve">Indentation level.</doc>
8270             <type name="guint" c:type="guint"/>
8271           </parameter>
8272           <parameter name="string_builder" transfer-ownership="none">
8273             <doc xml:whitespace="preserve">A #GString to to append XML data to.</doc>
8274             <type name="GLib.String" c:type="GString*"/>
8275           </parameter>
8276         </parameters>
8277       </method>
8278       <method name="lookup_interface"
8279               c:identifier="g_dbus_node_info_lookup_interface"
8280               version="2.26">
8281         <doc xml:whitespace="preserve">Looks up information about an interface.
8282 This cost of this function is O(n) in number of interfaces.</doc>
8283         <return-value transfer-ownership="full">
8284           <doc xml:whitespace="preserve">A #GDBusInterfaceInfo or %NULL if not found. Do not free, it is owned by @info.</doc>
8285           <type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
8286         </return-value>
8287         <parameters>
8288           <parameter name="name" transfer-ownership="none">
8289             <doc xml:whitespace="preserve">A D-Bus interface name.</doc>
8290             <type name="utf8" c:type="gchar*"/>
8291           </parameter>
8292         </parameters>
8293       </method>
8294       <method name="ref" c:identifier="g_dbus_node_info_ref" version="2.26">
8295         <doc xml:whitespace="preserve">If @info is statically allocated does nothing. Otherwise increases
8296 the reference count.</doc>
8297         <return-value transfer-ownership="full">
8298           <doc xml:whitespace="preserve">The same @info.</doc>
8299           <type name="DBusNodeInfo" c:type="GDBusNodeInfo*"/>
8300         </return-value>
8301       </method>
8302       <method name="unref"
8303               c:identifier="g_dbus_node_info_unref"
8304               version="2.26">
8305         <doc xml:whitespace="preserve">If @info is statically allocated, does nothing. Otherwise decreases
8306 the reference count of @info. When its reference count drops to 0,
8307 the memory used is freed.</doc>
8308         <return-value transfer-ownership="none">
8309           <type name="none" c:type="void"/>
8310         </return-value>
8311       </method>
8312     </record>
8313     <record name="DBusPropertyInfo"
8314             c:type="GDBusPropertyInfo"
8315             version="2.26"
8316             glib:type-name="GDBusPropertyInfo"
8317             glib:get-type="g_dbus_property_info_get_type"
8318             c:symbol-prefix="dbus_property_info">
8319       <doc xml:whitespace="preserve">Information about a D-Bus property on a D-Bus interface.</doc>
8320       <field name="ref_count" writable="1">
8321         <type name="gint" c:type="gint"/>
8322       </field>
8323       <field name="name" writable="1">
8324         <type name="utf8" c:type="gchar*"/>
8325       </field>
8326       <field name="signature" writable="1">
8327         <type name="utf8" c:type="gchar*"/>
8328       </field>
8329       <field name="flags" writable="1">
8330         <type name="DBusPropertyInfoFlags" c:type="GDBusPropertyInfoFlags"/>
8331       </field>
8332       <field name="annotations" writable="1">
8333         <type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo**"/>
8334       </field>
8335       <method name="ref"
8336               c:identifier="g_dbus_property_info_ref"
8337               version="2.26">
8338         <doc xml:whitespace="preserve">If @info is statically allocated does nothing. Otherwise increases
8339 the reference count.</doc>
8340         <return-value transfer-ownership="full">
8341           <doc xml:whitespace="preserve">The same @info.</doc>
8342           <type name="DBusPropertyInfo" c:type="GDBusPropertyInfo*"/>
8343         </return-value>
8344       </method>
8345       <method name="unref"
8346               c:identifier="g_dbus_property_info_unref"
8347               version="2.26">
8348         <doc xml:whitespace="preserve">If @info is statically allocated, does nothing. Otherwise decreases
8349 the reference count of @info. When its reference count drops to 0,
8350 the memory used is freed.</doc>
8351         <return-value transfer-ownership="none">
8352           <type name="none" c:type="void"/>
8353         </return-value>
8354       </method>
8355     </record>
8356     <bitfield name="DBusPropertyInfoFlags"
8357               version="2.26"
8358               glib:type-name="GDBusPropertyInfoFlags"
8359               glib:get-type="g_dbus_property_info_flags_get_type"
8360               c:type="GDBusPropertyInfoFlags">
8361       <doc xml:whitespace="preserve">Flags describing the access control of a D-Bus property.</doc>
8362       <member name="none"
8363               value="0"
8364               c:identifier="G_DBUS_PROPERTY_INFO_FLAGS_NONE"
8365               glib:nick="none"/>
8366       <member name="readable"
8367               value="1"
8368               c:identifier="G_DBUS_PROPERTY_INFO_FLAGS_READABLE"
8369               glib:nick="readable"/>
8370       <member name="writable"
8371               value="2"
8372               c:identifier="G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE"
8373               glib:nick="writable"/>
8374     </bitfield>
8375     <class name="DBusProxy"
8376            c:symbol-prefix="dbus_proxy"
8377            c:type="GDBusProxy"
8378            version="2.26"
8379            parent="GObject.Object"
8380            glib:type-name="GDBusProxy"
8381            glib:get-type="g_dbus_proxy_get_type"
8382            glib:type-struct="DBusProxyClass">
8383       <doc xml:whitespace="preserve">The #GDBusProxy structure contains only private data and
8384 should only be accessed using the provided API.</doc>
8385       <implements name="AsyncInitable"/>
8386       <implements name="Initable"/>
8387       <constructor name="new_finish"
8388                    c:identifier="g_dbus_proxy_new_finish"
8389                    version="2.26"
8390                    throws="1">
8391         <doc xml:whitespace="preserve">Finishes creating a #GDBusProxy.</doc>
8392         <return-value transfer-ownership="full">
8393           <doc xml:whitespace="preserve">A #GDBusProxy or %NULL if @error is set. Free with g_object_unref().</doc>
8394           <type name="DBusProxy" c:type="GDBusProxy*"/>
8395         </return-value>
8396         <parameters>
8397           <parameter name="res" transfer-ownership="none">
8398             <doc xml:whitespace="preserve">A #GAsyncResult obtained from the #GAsyncReadyCallback function passed to g_dbus_proxy_new().</doc>
8399             <type name="AsyncResult" c:type="GAsyncResult*"/>
8400           </parameter>
8401         </parameters>
8402       </constructor>
8403       <constructor name="new_for_bus_finish"
8404                    c:identifier="g_dbus_proxy_new_for_bus_finish"
8405                    version="2.26"
8406                    throws="1">
8407         <doc xml:whitespace="preserve">Finishes creating a #GDBusProxy.</doc>
8408         <return-value transfer-ownership="full">
8409           <doc xml:whitespace="preserve">A #GDBusProxy or %NULL if @error is set. Free with g_object_unref().</doc>
8410           <type name="DBusProxy" c:type="GDBusProxy*"/>
8411         </return-value>
8412         <parameters>
8413           <parameter name="res" transfer-ownership="none">
8414             <doc xml:whitespace="preserve">A #GAsyncResult obtained from the #GAsyncReadyCallback function passed to g_dbus_proxy_new_for_bus().</doc>
8415             <type name="AsyncResult" c:type="GAsyncResult*"/>
8416           </parameter>
8417         </parameters>
8418       </constructor>
8419       <constructor name="new_for_bus_sync"
8420                    c:identifier="g_dbus_proxy_new_for_bus_sync"
8421                    version="2.26"
8422                    throws="1">
8423         <doc xml:whitespace="preserve">Like g_dbus_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
8424 See &lt;xref linkend="gdbus-wellknown-proxy"/&gt; for an example of how #GDBusProxy can be used.</doc>
8425         <return-value transfer-ownership="full">
8426           <doc xml:whitespace="preserve">A #GDBusProxy or %NULL if error is set. Free with g_object_unref().</doc>
8427           <type name="DBusProxy" c:type="GDBusProxy*"/>
8428         </return-value>
8429         <parameters>
8430           <parameter name="bus_type" transfer-ownership="none">
8431             <doc xml:whitespace="preserve">A #GBusType.</doc>
8432             <type name="BusType" c:type="GBusType"/>
8433           </parameter>
8434           <parameter name="flags" transfer-ownership="none">
8435             <doc xml:whitespace="preserve">Flags used when constructing the proxy.</doc>
8436             <type name="DBusProxyFlags" c:type="GDBusProxyFlags"/>
8437           </parameter>
8438           <parameter name="info" transfer-ownership="none">
8439             <doc xml:whitespace="preserve">A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.</doc>
8440             <type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
8441           </parameter>
8442           <parameter name="name" transfer-ownership="none">
8443             <doc xml:whitespace="preserve">A bus name (well-known or unique).</doc>
8444             <type name="utf8" c:type="gchar*"/>
8445           </parameter>
8446           <parameter name="object_path" transfer-ownership="none">
8447             <doc xml:whitespace="preserve">An object path.</doc>
8448             <type name="utf8" c:type="gchar*"/>
8449           </parameter>
8450           <parameter name="interface_name" transfer-ownership="none">
8451             <doc xml:whitespace="preserve">A D-Bus interface name.</doc>
8452             <type name="utf8" c:type="gchar*"/>
8453           </parameter>
8454           <parameter name="cancellable"
8455                      transfer-ownership="none"
8456                      allow-none="1">
8457             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
8458             <type name="Cancellable" c:type="GCancellable*"/>
8459           </parameter>
8460         </parameters>
8461       </constructor>
8462       <constructor name="new_sync"
8463                    c:identifier="g_dbus_proxy_new_sync"
8464                    version="2.26"
8465                    throws="1">
8466         <doc xml:whitespace="preserve">Creates a proxy for accessing @interface_name on the remote object
8467 at @object_path owned by @name at @connection and synchronously
8468 loads D-Bus properties unless the
8469 %G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES flag is used.
8470 If the %G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS flag is not set, also sets up
8471 match rules for signals. Connect to the #GDBusProxy::g-signal signal
8472 to handle signals from the remote object.
8473 If @name is a well-known name and the
8474 %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START flag isn't set and no name
8475 owner currently exists, the message bus will be requested to launch
8476 a name owner for the name.
8477 This is a synchronous failable constructor. See g_dbus_proxy_new()
8478 and g_dbus_proxy_new_finish() for the asynchronous version.
8479 See &lt;xref linkend="gdbus-wellknown-proxy"/&gt; for an example of how #GDBusProxy can be used.</doc>
8480         <return-value transfer-ownership="full">
8481           <doc xml:whitespace="preserve">A #GDBusProxy or %NULL if error is set. Free with g_object_unref().</doc>
8482           <type name="DBusProxy" c:type="GDBusProxy*"/>
8483         </return-value>
8484         <parameters>
8485           <parameter name="connection" transfer-ownership="none">
8486             <doc xml:whitespace="preserve">A #GDBusConnection.</doc>
8487             <type name="DBusConnection" c:type="GDBusConnection*"/>
8488           </parameter>
8489           <parameter name="flags" transfer-ownership="none">
8490             <doc xml:whitespace="preserve">Flags used when constructing the proxy.</doc>
8491             <type name="DBusProxyFlags" c:type="GDBusProxyFlags"/>
8492           </parameter>
8493           <parameter name="info" transfer-ownership="none" allow-none="1">
8494             <doc xml:whitespace="preserve">A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.</doc>
8495             <type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
8496           </parameter>
8497           <parameter name="name" transfer-ownership="none" allow-none="1">
8498             <doc xml:whitespace="preserve">A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.</doc>
8499             <type name="utf8" c:type="gchar*"/>
8500           </parameter>
8501           <parameter name="object_path" transfer-ownership="none">
8502             <doc xml:whitespace="preserve">An object path.</doc>
8503             <type name="utf8" c:type="gchar*"/>
8504           </parameter>
8505           <parameter name="interface_name" transfer-ownership="none">
8506             <doc xml:whitespace="preserve">A D-Bus interface name.</doc>
8507             <type name="utf8" c:type="gchar*"/>
8508           </parameter>
8509           <parameter name="cancellable"
8510                      transfer-ownership="none"
8511                      allow-none="1">
8512             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
8513             <type name="Cancellable" c:type="GCancellable*"/>
8514           </parameter>
8515         </parameters>
8516       </constructor>
8517       <function name="new" c:identifier="g_dbus_proxy_new" version="2.26">
8518         <doc xml:whitespace="preserve">Creates a proxy for accessing @interface_name on the remote object
8519 at @object_path owned by @name at @connection and asynchronously
8520 loads D-Bus properties unless the
8521 %G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES flag is used. Connect to
8522 the #GDBusProxy::g-properties-changed signal to get notified about
8523 property changes.
8524 If the %G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS flag is not set, also sets up
8525 match rules for signals. Connect to the #GDBusProxy::g-signal signal
8526 to handle signals from the remote object.
8527 If @name is a well-known name and the
8528 %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START flag isn't set and no name
8529 owner currently exists, the message bus will be requested to launch
8530 a name owner for the name.
8531 This is a failable asynchronous constructor - when the proxy is
8532 ready, @callback will be invoked and you can use
8533 g_dbus_proxy_new_finish() to get the result.
8534 See g_dbus_proxy_new_sync() and for a synchronous version of this constructor.
8535 See &lt;xref linkend="gdbus-wellknown-proxy"/&gt; for an example of how #GDBusProxy can be used.</doc>
8536         <return-value transfer-ownership="none">
8537           <type name="none" c:type="void"/>
8538         </return-value>
8539         <parameters>
8540           <parameter name="connection" transfer-ownership="none">
8541             <doc xml:whitespace="preserve">A #GDBusConnection.</doc>
8542             <type name="DBusConnection" c:type="GDBusConnection*"/>
8543           </parameter>
8544           <parameter name="flags" transfer-ownership="none">
8545             <doc xml:whitespace="preserve">Flags used when constructing the proxy.</doc>
8546             <type name="DBusProxyFlags" c:type="GDBusProxyFlags"/>
8547           </parameter>
8548           <parameter name="info" transfer-ownership="none">
8549             <doc xml:whitespace="preserve">A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.</doc>
8550             <type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
8551           </parameter>
8552           <parameter name="name" transfer-ownership="none">
8553             <doc xml:whitespace="preserve">A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.</doc>
8554             <type name="utf8" c:type="gchar*"/>
8555           </parameter>
8556           <parameter name="object_path" transfer-ownership="none">
8557             <doc xml:whitespace="preserve">An object path.</doc>
8558             <type name="utf8" c:type="gchar*"/>
8559           </parameter>
8560           <parameter name="interface_name" transfer-ownership="none">
8561             <doc xml:whitespace="preserve">A D-Bus interface name.</doc>
8562             <type name="utf8" c:type="gchar*"/>
8563           </parameter>
8564           <parameter name="cancellable"
8565                      transfer-ownership="none"
8566                      allow-none="1">
8567             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
8568             <type name="Cancellable" c:type="GCancellable*"/>
8569           </parameter>
8570           <parameter name="callback"
8571                      transfer-ownership="none"
8572                      scope="async"
8573                      closure="8">
8574             <doc xml:whitespace="preserve">Callback function to invoke when the proxy is ready.</doc>
8575             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
8576           </parameter>
8577           <parameter name="user_data" transfer-ownership="none">
8578             <doc xml:whitespace="preserve">User data to pass to @callback.</doc>
8579             <type name="gpointer" c:type="gpointer"/>
8580           </parameter>
8581         </parameters>
8582       </function>
8583       <function name="new_for_bus"
8584                 c:identifier="g_dbus_proxy_new_for_bus"
8585                 version="2.26">
8586         <doc xml:whitespace="preserve">Like g_dbus_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
8587 See &lt;xref linkend="gdbus-wellknown-proxy"/&gt; for an example of how #GDBusProxy can be used.</doc>
8588         <return-value transfer-ownership="none">
8589           <type name="none" c:type="void"/>
8590         </return-value>
8591         <parameters>
8592           <parameter name="bus_type" transfer-ownership="none">
8593             <doc xml:whitespace="preserve">A #GBusType.</doc>
8594             <type name="BusType" c:type="GBusType"/>
8595           </parameter>
8596           <parameter name="flags" transfer-ownership="none">
8597             <doc xml:whitespace="preserve">Flags used when constructing the proxy.</doc>
8598             <type name="DBusProxyFlags" c:type="GDBusProxyFlags"/>
8599           </parameter>
8600           <parameter name="info" transfer-ownership="none">
8601             <doc xml:whitespace="preserve">A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.</doc>
8602             <type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
8603           </parameter>
8604           <parameter name="name" transfer-ownership="none">
8605             <doc xml:whitespace="preserve">A bus name (well-known or unique).</doc>
8606             <type name="utf8" c:type="gchar*"/>
8607           </parameter>
8608           <parameter name="object_path" transfer-ownership="none">
8609             <doc xml:whitespace="preserve">An object path.</doc>
8610             <type name="utf8" c:type="gchar*"/>
8611           </parameter>
8612           <parameter name="interface_name" transfer-ownership="none">
8613             <doc xml:whitespace="preserve">A D-Bus interface name.</doc>
8614             <type name="utf8" c:type="gchar*"/>
8615           </parameter>
8616           <parameter name="cancellable"
8617                      transfer-ownership="none"
8618                      allow-none="1">
8619             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
8620             <type name="Cancellable" c:type="GCancellable*"/>
8621           </parameter>
8622           <parameter name="callback"
8623                      transfer-ownership="none"
8624                      scope="async"
8625                      closure="8">
8626             <doc xml:whitespace="preserve">Callback function to invoke when the proxy is ready.</doc>
8627             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
8628           </parameter>
8629           <parameter name="user_data" transfer-ownership="none">
8630             <doc xml:whitespace="preserve">User data to pass to @callback.</doc>
8631             <type name="gpointer" c:type="gpointer"/>
8632           </parameter>
8633         </parameters>
8634       </function>
8635       <method name="call" c:identifier="g_dbus_proxy_call" version="2.26">
8636         <doc xml:whitespace="preserve">Asynchronously invokes the @method_name method on @proxy.
8637 If @method_name contains any dots, then @name is split into interface and
8638 method name parts. This allows using @proxy for invoking methods on
8639 other interfaces.
8640 If the #GDBusConnection associated with @proxy is closed then
8641 the operation will fail with %G_IO_ERROR_CLOSED. If
8642 %G_IO_ERROR_CANCELLED. If @parameters contains a value not
8643 compatible with the D-Bus protocol, the operation fails with
8644 %G_IO_ERROR_INVALID_ARGUMENT.
8645 If the @parameters #GVariant is floating, it is consumed. This allows
8646 convenient 'inline' use of g_variant_new(), e.g.:
8647 |[
8648 g_dbus_proxy_call (proxy,
8649 "TwoStrings",
8650 g_variant_new ("(ss)",
8651 "Thing One",
8652 "Thing Two"),
8653 G_DBUS_CALL_FLAGS_NONE,
8654 -1,
8655 NULL,
8656 (GAsyncReadyCallback) two_strings_done,
8657 &amp;amp;data);
8658 ]|
8659 This is an asynchronous method. When the operation is finished,
8660 &lt;link linkend="g-main-context-push-thread-default"&gt;thread-default
8661 main loop&lt;/link&gt; of the thread you are calling this method from.
8662 You can then call g_dbus_proxy_call_finish() to get the result of
8663 the operation. See g_dbus_proxy_call_sync() for the synchronous
8664 version of this method.</doc>
8665         <return-value transfer-ownership="none">
8666           <type name="none" c:type="void"/>
8667         </return-value>
8668         <parameters>
8669           <parameter name="method_name" transfer-ownership="none">
8670             <doc xml:whitespace="preserve">Name of method to invoke.</doc>
8671             <type name="utf8" c:type="gchar*"/>
8672           </parameter>
8673           <parameter name="parameters" transfer-ownership="none">
8674             <doc xml:whitespace="preserve">A #GVariant tuple with parameters for the signal or %NULL if not passing parameters.</doc>
8675             <type name="GLib.Variant" c:type="GVariant*"/>
8676           </parameter>
8677           <parameter name="flags" transfer-ownership="none">
8678             <doc xml:whitespace="preserve">Flags from the #GDBusCallFlags enumeration.</doc>
8679             <type name="DBusCallFlags" c:type="GDBusCallFlags"/>
8680           </parameter>
8681           <parameter name="timeout_msec" transfer-ownership="none">
8682             <doc xml:whitespace="preserve">The timeout in milliseconds or -1 to use the proxy default timeout.</doc>
8683             <type name="gint" c:type="gint"/>
8684           </parameter>
8685           <parameter name="cancellable"
8686                      transfer-ownership="none"
8687                      allow-none="1">
8688             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
8689             <type name="Cancellable" c:type="GCancellable*"/>
8690           </parameter>
8691           <parameter name="callback"
8692                      transfer-ownership="none"
8693                      scope="async"
8694                      closure="6">
8695             <doc xml:whitespace="preserve">A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't care about the result of the method invocation.</doc>
8696             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
8697           </parameter>
8698           <parameter name="user_data" transfer-ownership="none">
8699             <doc xml:whitespace="preserve">The data to pass to @callback.</doc>
8700             <type name="gpointer" c:type="gpointer"/>
8701           </parameter>
8702         </parameters>
8703       </method>
8704       <method name="call_finish"
8705               c:identifier="g_dbus_proxy_call_finish"
8706               version="2.26"
8707               throws="1">
8708         <doc xml:whitespace="preserve">Finishes an operation started with g_dbus_proxy_call().
8709 return values. Free with g_variant_unref().</doc>
8710         <return-value transfer-ownership="full">
8711           <doc xml:whitespace="preserve">%NULL if @error is set. Otherwise a #GVariant tuple with</doc>
8712           <type name="GLib.Variant" c:type="GVariant*"/>
8713         </return-value>
8714         <parameters>
8715           <parameter name="res" transfer-ownership="none">
8716             <doc xml:whitespace="preserve">A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_proxy_call().</doc>
8717             <type name="AsyncResult" c:type="GAsyncResult*"/>
8718           </parameter>
8719         </parameters>
8720       </method>
8721       <method name="call_sync"
8722               c:identifier="g_dbus_proxy_call_sync"
8723               version="2.26"
8724               throws="1">
8725         <doc xml:whitespace="preserve">Synchronously invokes the @method_name method on @proxy.
8726 If @method_name contains any dots, then @name is split into interface and
8727 method name parts. This allows using @proxy for invoking methods on
8728 other interfaces.
8729 If the #GDBusConnection associated with @proxy is disconnected then
8730 the operation will fail with %G_IO_ERROR_CLOSED. If
8731 %G_IO_ERROR_CANCELLED. If @parameters contains a value not
8732 compatible with the D-Bus protocol, the operation fails with
8733 %G_IO_ERROR_INVALID_ARGUMENT.
8734 If the @parameters #GVariant is floating, it is consumed. This allows
8735 convenient 'inline' use of g_variant_new(), e.g.:
8736 |[
8737 g_dbus_proxy_call_sync (proxy,
8738 "TwoStrings",
8739 g_variant_new ("(ss)",
8740 "Thing One",
8741 "Thing Two"),
8742 G_DBUS_CALL_FLAGS_NONE,
8743 -1,
8744 NULL,
8745 &amp;amp;error);
8746 ]|
8747 The calling thread is blocked until a reply is received. See
8748 g_dbus_proxy_call() for the asynchronous version of this
8749 method.
8750 return values. Free with g_variant_unref().</doc>
8751         <return-value transfer-ownership="full">
8752           <doc xml:whitespace="preserve">%NULL if @error is set. Otherwise a #GVariant tuple with</doc>
8753           <type name="GLib.Variant" c:type="GVariant*"/>
8754         </return-value>
8755         <parameters>
8756           <parameter name="method_name" transfer-ownership="none">
8757             <doc xml:whitespace="preserve">Name of method to invoke.</doc>
8758             <type name="utf8" c:type="gchar*"/>
8759           </parameter>
8760           <parameter name="parameters" transfer-ownership="none">
8761             <doc xml:whitespace="preserve">A #GVariant tuple with parameters for the signal or %NULL if not passing parameters.</doc>
8762             <type name="GLib.Variant" c:type="GVariant*"/>
8763           </parameter>
8764           <parameter name="flags" transfer-ownership="none">
8765             <doc xml:whitespace="preserve">Flags from the #GDBusCallFlags enumeration.</doc>
8766             <type name="DBusCallFlags" c:type="GDBusCallFlags"/>
8767           </parameter>
8768           <parameter name="timeout_msec" transfer-ownership="none">
8769             <doc xml:whitespace="preserve">The timeout in milliseconds or -1 to use the proxy default timeout.</doc>
8770             <type name="gint" c:type="gint"/>
8771           </parameter>
8772           <parameter name="cancellable"
8773                      transfer-ownership="none"
8774                      allow-none="1">
8775             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
8776             <type name="Cancellable" c:type="GCancellable*"/>
8777           </parameter>
8778         </parameters>
8779       </method>
8780       <method name="get_cached_property"
8781               c:identifier="g_dbus_proxy_get_cached_property"
8782               version="2.26">
8783         <doc xml:whitespace="preserve">Looks up the value for a property from the cache. This call does no
8784 blocking IO.
8785 If @proxy has an expected interface (see
8786 #GDBusProxy:g-interface-info), then @property_name (for existence)
8787 is checked against it.
8788 for @property_name or %NULL if the value is not in the cache. The
8789 returned reference must be freed with g_variant_unref().</doc>
8790         <return-value transfer-ownership="full">
8791           <doc xml:whitespace="preserve">A reference to the #GVariant instance that holds the value</doc>
8792           <type name="GLib.Variant" c:type="GVariant*"/>
8793         </return-value>
8794         <parameters>
8795           <parameter name="property_name" transfer-ownership="none">
8796             <doc xml:whitespace="preserve">Property name.</doc>
8797             <type name="utf8" c:type="gchar*"/>
8798           </parameter>
8799         </parameters>
8800       </method>
8801       <method name="get_cached_property_names"
8802               c:identifier="g_dbus_proxy_get_cached_property_names"
8803               version="2.26"
8804               introspectable="0">
8805         <doc xml:whitespace="preserve">Gets the names of all cached properties on @proxy.
8806 no cached properties. Free the returned array with g_strfreev().</doc>
8807         <return-value>
8808           <doc xml:whitespace="preserve">A %NULL-terminated array of strings or %NULL if @proxy has</doc>
8809           <array c:type="gchar**">
8810             <type name="utf8"/>
8811           </array>
8812         </return-value>
8813       </method>
8814       <method name="get_connection"
8815               c:identifier="g_dbus_proxy_get_connection"
8816               version="2.26">
8817         <doc xml:whitespace="preserve">Gets the connection @proxy is for.</doc>
8818         <return-value transfer-ownership="none">
8819           <doc xml:whitespace="preserve">A #GDBusConnection owned by @proxy. Do not free.</doc>
8820           <type name="DBusConnection" c:type="GDBusConnection*"/>
8821         </return-value>
8822       </method>
8823       <method name="get_default_timeout"
8824               c:identifier="g_dbus_proxy_get_default_timeout"
8825               version="2.26">
8826         <doc xml:whitespace="preserve">Gets the timeout to use if -1 (specifying default timeout) is
8827 passed as @timeout_msec in the g_dbus_proxy_call() and
8828 g_dbus_proxy_call_sync() functions.
8829 See the #GDBusProxy:g-default-timeout property for more details.</doc>
8830         <return-value transfer-ownership="none">
8831           <doc xml:whitespace="preserve">Timeout to use for @proxy.</doc>
8832           <type name="gint" c:type="gint"/>
8833         </return-value>
8834       </method>
8835       <method name="get_flags"
8836               c:identifier="g_dbus_proxy_get_flags"
8837               version="2.26">
8838         <doc xml:whitespace="preserve">Gets the flags that @proxy was constructed with.</doc>
8839         <return-value transfer-ownership="none">
8840           <doc xml:whitespace="preserve">Flags from the #GDBusProxyFlags enumeration.</doc>
8841           <type name="DBusProxyFlags" c:type="GDBusProxyFlags"/>
8842         </return-value>
8843       </method>
8844       <method name="get_interface_info"
8845               c:identifier="g_dbus_proxy_get_interface_info"
8846               version="2.26">
8847         <doc xml:whitespace="preserve">Returns the #GDBusInterfaceInfo, if any, specifying the minimal
8848 interface that @proxy conforms to.
8849 See the #GDBusProxy:g-interface-info property for more details.
8850 object, it is owned by @proxy.</doc>
8851         <return-value transfer-ownership="full">
8852           <doc xml:whitespace="preserve">A #GDBusInterfaceInfo or %NULL. Do not unref the returned</doc>
8853           <type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
8854         </return-value>
8855       </method>
8856       <method name="get_interface_name"
8857               c:identifier="g_dbus_proxy_get_interface_name"
8858               version="2.26">
8859         <doc xml:whitespace="preserve">Gets the D-Bus interface name @proxy is for.</doc>
8860         <return-value transfer-ownership="none">
8861           <doc xml:whitespace="preserve">A string owned by @proxy. Do not free.</doc>
8862           <type name="utf8" c:type="gchar*"/>
8863         </return-value>
8864       </method>
8865       <method name="get_name"
8866               c:identifier="g_dbus_proxy_get_name"
8867               version="2.26">
8868         <doc xml:whitespace="preserve">Gets the name that @proxy was constructed for.</doc>
8869         <return-value transfer-ownership="none">
8870           <doc xml:whitespace="preserve">A string owned by @proxy. Do not free.</doc>
8871           <type name="utf8" c:type="gchar*"/>
8872         </return-value>
8873       </method>
8874       <method name="get_name_owner"
8875               c:identifier="g_dbus_proxy_get_name_owner"
8876               version="2.26">
8877         <doc xml:whitespace="preserve">The unique name that owns the name that @proxy is for or %NULL if
8878 no-one currently owns that name. You may connect to the
8879 #GObject::notify signal to track changes to the
8880 #GDBusProxy:g-name-owner property.</doc>
8881         <return-value transfer-ownership="full">
8882           <doc xml:whitespace="preserve">The name owner or %NULL if no name owner exists. Free with g_free().</doc>
8883           <type name="utf8" c:type="gchar*"/>
8884         </return-value>
8885       </method>
8886       <method name="get_object_path"
8887               c:identifier="g_dbus_proxy_get_object_path"
8888               version="2.26">
8889         <doc xml:whitespace="preserve">Gets the object path @proxy is for.</doc>
8890         <return-value transfer-ownership="none">
8891           <doc xml:whitespace="preserve">A string owned by @proxy. Do not free.</doc>
8892           <type name="utf8" c:type="gchar*"/>
8893         </return-value>
8894       </method>
8895       <method name="set_cached_property"
8896               c:identifier="g_dbus_proxy_set_cached_property"
8897               version="2.26">
8898         <doc xml:whitespace="preserve">If @value is not %NULL, sets the cached value for the property with
8899 name @property_name to the value in @value.
8900 If @value is %NULL, then the cached value is removed from the
8901 property cache.
8902 If @proxy has an expected interface (see
8903 #GDBusProxy:g-interface-info), then @property_name (for existence)
8904 and @value (for the type) is checked against it.
8905 If the @value #GVariant is floating, it is consumed. This allows
8906 convenient 'inline' use of g_variant_new(), e.g.
8907 |[
8908 g_dbus_proxy_set_cached_property (proxy,
8909 "SomeProperty",
8910 g_variant_new ("(si)",
8911 "A String",
8912 42));
8913 ]|
8914 Normally you will not need to use this method since @proxy is
8915 tracking changes using the
8916 &lt;literal&gt;org.freedesktop.DBus.Properties.PropertiesChanged&lt;/literal&gt;
8917 D-Bus signal. However, for performance reasons an object may decide
8918 to not use this signal for some properties and instead use a
8919 proprietary out-of-band mechanism to transmit changes.
8920 As a concrete example, consider an object with a property
8921 &lt;literal&gt;ChatroomParticipants&lt;/literal&gt; which is an array of
8922 strings. Instead of transmitting the same (long) array every time
8923 the property changes, it is more efficient to only transmit the
8924 delta using e.g. signals &lt;literal&gt;ChatroomParticipantJoined(String
8925 name)&lt;/literal&gt; and &lt;literal&gt;ChatroomParticipantParted(String
8926 name)&lt;/literal&gt;.</doc>
8927         <return-value transfer-ownership="none">
8928           <type name="none" c:type="void"/>
8929         </return-value>
8930         <parameters>
8931           <parameter name="property_name" transfer-ownership="none">
8932             <doc xml:whitespace="preserve">Property name.</doc>
8933             <type name="utf8" c:type="gchar*"/>
8934           </parameter>
8935           <parameter name="value" transfer-ownership="none">
8936             <doc xml:whitespace="preserve">Value for the property or %NULL to remove it from the cache.</doc>
8937             <type name="GLib.Variant" c:type="GVariant*"/>
8938           </parameter>
8939         </parameters>
8940       </method>
8941       <method name="set_default_timeout"
8942               c:identifier="g_dbus_proxy_set_default_timeout"
8943               version="2.26">
8944         <doc xml:whitespace="preserve">Sets the timeout to use if -1 (specifying default timeout) is
8945 passed as @timeout_msec in the g_dbus_proxy_call() and
8946 g_dbus_proxy_call_sync() functions.
8947 See the #GDBusProxy:g-default-timeout property for more details.</doc>
8948         <return-value transfer-ownership="none">
8949           <type name="none" c:type="void"/>
8950         </return-value>
8951         <parameters>
8952           <parameter name="timeout_msec" transfer-ownership="none">
8953             <doc xml:whitespace="preserve">Timeout in milliseconds.</doc>
8954             <type name="gint" c:type="gint"/>
8955           </parameter>
8956         </parameters>
8957       </method>
8958       <method name="set_interface_info"
8959               c:identifier="g_dbus_proxy_set_interface_info"
8960               version="2.26">
8961         <doc xml:whitespace="preserve">Ensure that interactions with @proxy conform to the given
8962 interface.  For example, when completing a method call, if the type
8963 signature of the message isn't what's expected, the given #GError
8964 is set.  Signals that have a type signature mismatch are simply
8965 dropped.
8966 See the #GDBusProxy:g-interface-info property for more details.</doc>
8967         <return-value transfer-ownership="none">
8968           <type name="none" c:type="void"/>
8969         </return-value>
8970         <parameters>
8971           <parameter name="info" transfer-ownership="none">
8972             <doc xml:whitespace="preserve">Minimum interface this proxy conforms to or %NULL to unset.</doc>
8973             <type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
8974           </parameter>
8975         </parameters>
8976       </method>
8977       <property name="g-bus-type"
8978                 version="2.26"
8979                 readable="0"
8980                 writable="1"
8981                 construct-only="1"
8982                 transfer-ownership="none">
8983         <doc xml:whitespace="preserve">If this property is not %G_BUS_TYPE_NONE, then
8984 #GDBusProxy:g-connection must be %NULL and will be set to the
8985 #GDBusConnection obtained by calling g_bus_get() with the value
8986 of this property.</doc>
8987         <type name="BusType"/>
8988       </property>
8989       <property name="g-connection"
8990                 version="2.26"
8991                 writable="1"
8992                 construct-only="1"
8993                 transfer-ownership="none">
8994         <doc xml:whitespace="preserve">The #GDBusConnection the proxy is for.</doc>
8995         <type name="DBusConnection"/>
8996       </property>
8997       <property name="g-default-timeout"
8998                 version="2.26"
8999                 writable="1"
9000                 construct="1"
9001                 transfer-ownership="none">
9002         <doc xml:whitespace="preserve">The timeout to use if -1 (specifying default timeout) is passed
9003 as @timeout_msec in the g_dbus_proxy_call() and
9004 g_dbus_proxy_call_sync() functions.
9005 This allows applications to set a proxy-wide timeout for all
9006 remote method invocations on the proxy. If this property is -1,
9007 the default timeout (typically 25 seconds) is used. If set to
9008 %G_MAXINT, then no timeout is used.</doc>
9009         <type name="gint"/>
9010       </property>
9011       <property name="g-flags"
9012                 version="2.26"
9013                 writable="1"
9014                 construct-only="1"
9015                 transfer-ownership="none">
9016         <doc xml:whitespace="preserve">Flags from the #GDBusProxyFlags enumeration.</doc>
9017         <type name="DBusProxyFlags"/>
9018       </property>
9019       <property name="g-interface-info"
9020                 version="2.26"
9021                 writable="1"
9022                 transfer-ownership="none">
9023         <doc xml:whitespace="preserve">Ensure that interactions with this proxy conform to the given
9024 interface.  For example, when completing a method call, if the
9025 type signature of the message isn't what's expected, the given
9026 #GError is set.  Signals that have a type signature mismatch are
9027 simply dropped.</doc>
9028         <type name="DBusInterfaceInfo"/>
9029       </property>
9030       <property name="g-interface-name"
9031                 version="2.26"
9032                 writable="1"
9033                 construct-only="1"
9034                 transfer-ownership="none">
9035         <doc xml:whitespace="preserve">The D-Bus interface name the proxy is for.</doc>
9036         <type name="utf8"/>
9037       </property>
9038       <property name="g-name"
9039                 version="2.26"
9040                 writable="1"
9041                 construct-only="1"
9042                 transfer-ownership="none">
9043         <doc xml:whitespace="preserve">The well-known or unique name that the proxy is for.</doc>
9044         <type name="utf8"/>
9045       </property>
9046       <property name="g-name-owner" version="2.26" transfer-ownership="none">
9047         <doc xml:whitespace="preserve">The unique name that owns #GDBusProxy:name or %NULL if no-one
9048 currently owns that name. You may connect to #GObject::notify signal to
9049 track changes to this property.</doc>
9050         <type name="utf8"/>
9051       </property>
9052       <property name="g-object-path"
9053                 version="2.26"
9054                 writable="1"
9055                 construct-only="1"
9056                 transfer-ownership="none">
9057         <doc xml:whitespace="preserve">The object path the proxy is for.</doc>
9058         <type name="utf8"/>
9059       </property>
9060       <field name="parent_instance">
9061         <type name="GObject.Object" c:type="GObject"/>
9062       </field>
9063       <field name="priv">
9064         <type name="DBusProxyPrivate" c:type="GDBusProxyPrivate*"/>
9065       </field>
9066       <glib:signal name="g-properties-changed"
9067                    version="2.26"
9068                    introspectable="0">
9069         <doc xml:whitespace="preserve">Emitted when one or more D-Bus properties on @proxy changes. The
9070 local cache has already been updated when this signal fires. Note
9071 that both @changed_properties and @invalidated_properties are
9072 guaranteed to never be %NULL (either may be empty though).
9073 This signal corresponds to the
9074 &lt;literal&gt;PropertiesChanged&lt;/literal&gt; D-Bus signal on the
9075 &lt;literal&gt;org.freedesktop.DBus.Properties&lt;/literal&gt; interface.</doc>
9076         <return-value transfer-ownership="none">
9077           <type name="none"/>
9078         </return-value>
9079         <parameters>
9080           <parameter name="object" transfer-ownership="none">
9081             <doc xml:whitespace="preserve">A #GVariant containing the properties that changed</doc>
9082             <type name="GLib.Variant"/>
9083           </parameter>
9084           <parameter name="p0" transfer-ownership="none">
9085             <doc xml:whitespace="preserve">A %NULL terminated array of properties that was invalidated</doc>
9086             <type/>
9087           </parameter>
9088         </parameters>
9089       </glib:signal>
9090       <glib:signal name="g-signal" version="2.26">
9091         <doc xml:whitespace="preserve">Emitted when a signal from the remote object and interface that @proxy is for, has been received.</doc>
9092         <return-value transfer-ownership="none">
9093           <type name="none"/>
9094         </return-value>
9095         <parameters>
9096           <parameter name="object" transfer-ownership="none">
9097             <doc xml:whitespace="preserve">The sender of the signal or %NULL if the connection is not a bus connection.</doc>
9098             <type name="utf8"/>
9099           </parameter>
9100           <parameter name="p0" transfer-ownership="none">
9101             <doc xml:whitespace="preserve">The name of the signal.</doc>
9102             <type name="utf8"/>
9103           </parameter>
9104           <parameter name="p1" transfer-ownership="none">
9105             <doc xml:whitespace="preserve">A #GVariant tuple with parameters for the signal.</doc>
9106             <type name="GLib.Variant"/>
9107           </parameter>
9108         </parameters>
9109       </glib:signal>
9110     </class>
9111     <record name="DBusProxyClass"
9112             c:type="GDBusProxyClass"
9113             glib:is-gtype-struct-for="DBusProxy"
9114             version="2.26">
9115       <doc xml:whitespace="preserve">Class structure for #GDBusProxy.</doc>
9116       <field name="parent_class">
9117         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
9118       </field>
9119       <field name="g_properties_changed">
9120         <callback name="g_properties_changed">
9121           <return-value transfer-ownership="none">
9122             <type name="none" c:type="void"/>
9123           </return-value>
9124           <parameters>
9125             <parameter name="proxy" transfer-ownership="none">
9126               <type name="DBusProxy" c:type="GDBusProxy*"/>
9127             </parameter>
9128             <parameter name="changed_properties" transfer-ownership="none">
9129               <type name="GLib.Variant" c:type="GVariant*"/>
9130             </parameter>
9131             <parameter name="invalidated_properties" transfer-ownership="none">
9132               <type name="utf8" c:type="gchar**"/>
9133             </parameter>
9134           </parameters>
9135         </callback>
9136       </field>
9137       <field name="g_signal">
9138         <callback name="g_signal">
9139           <return-value transfer-ownership="none">
9140             <type name="none" c:type="void"/>
9141           </return-value>
9142           <parameters>
9143             <parameter name="proxy" transfer-ownership="none">
9144               <type name="DBusProxy" c:type="GDBusProxy*"/>
9145             </parameter>
9146             <parameter name="sender_name" transfer-ownership="none">
9147               <type name="utf8" c:type="gchar*"/>
9148             </parameter>
9149             <parameter name="signal_name" transfer-ownership="none">
9150               <type name="utf8" c:type="gchar*"/>
9151             </parameter>
9152             <parameter name="parameters" transfer-ownership="none">
9153               <type name="GLib.Variant" c:type="GVariant*"/>
9154             </parameter>
9155           </parameters>
9156         </callback>
9157       </field>
9158       <field name="padding">
9159         <array zero-terminated="0" c:type="gpointer" fixed-size="32">
9160           <type name="gpointer" c:type="gpointer"/>
9161         </array>
9162       </field>
9163     </record>
9164     <bitfield name="DBusProxyFlags"
9165               version="2.26"
9166               glib:type-name="GDBusProxyFlags"
9167               glib:get-type="g_dbus_proxy_flags_get_type"
9168               c:type="GDBusProxyFlags">
9169       <doc xml:whitespace="preserve">Flags used when constructing an instance of a #GDBusProxy derived class.</doc>
9170       <member name="none"
9171               value="0"
9172               c:identifier="G_DBUS_PROXY_FLAGS_NONE"
9173               glib:nick="none"/>
9174       <member name="do_not_load_properties"
9175               value="1"
9176               c:identifier="G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES"
9177               glib:nick="do-not-load-properties"/>
9178       <member name="do_not_connect_signals"
9179               value="2"
9180               c:identifier="G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS"
9181               glib:nick="do-not-connect-signals"/>
9182       <member name="do_not_auto_start"
9183               value="4"
9184               c:identifier="G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START"
9185               glib:nick="do-not-auto-start"/>
9186     </bitfield>
9187     <record name="DBusProxyPrivate" c:type="GDBusProxyPrivate" disguised="1">
9188     </record>
9189     <bitfield name="DBusSendMessageFlags"
9190               version="2.26"
9191               glib:type-name="GDBusSendMessageFlags"
9192               glib:get-type="g_dbus_send_message_flags_get_type"
9193               c:type="GDBusSendMessageFlags">
9194       <doc xml:whitespace="preserve">Flags used when sending #GDBusMessage&lt;!-- --&gt;s on a #GDBusConnection.</doc>
9195       <member name="none"
9196               value="0"
9197               c:identifier="G_DBUS_SEND_MESSAGE_FLAGS_NONE"
9198               glib:nick="none"/>
9199       <member name="preserve_serial"
9200               value="1"
9201               c:identifier="G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL"
9202               glib:nick="preserve-serial"/>
9203     </bitfield>
9204     <class name="DBusServer"
9205            c:symbol-prefix="dbus_server"
9206            c:type="GDBusServer"
9207            version="2.26"
9208            parent="GObject.Object"
9209            glib:type-name="GDBusServer"
9210            glib:get-type="g_dbus_server_get_type">
9211       <doc xml:whitespace="preserve">The #GDBusServer structure contains only private data and
9212 should only be accessed using the provided API.</doc>
9213       <implements name="Initable"/>
9214       <constructor name="new_sync"
9215                    c:identifier="g_dbus_server_new_sync"
9216                    version="2.26"
9217                    throws="1">
9218         <doc xml:whitespace="preserve">Creates a new D-Bus server that listens on the first address in
9219 Once constructed, you can use g_dbus_server_get_client_address() to
9220 get a D-Bus address string that clients can use to connect.
9221 Connect to the #GDBusServer::new-connection signal to handle
9222 incoming connections.
9223 The returned #GDBusServer isn't active - you have to start it with
9224 g_dbus_server_start().
9225 See &lt;xref linkend="gdbus-peer-to-peer"/&gt; for how #GDBusServer can
9226 be used.
9227 This is a synchronous failable constructor. See
9228 g_dbus_server_new() for the asynchronous version.
9229 g_object_unref().</doc>
9230         <return-value transfer-ownership="full">
9231           <doc xml:whitespace="preserve">A #GDBusServer or %NULL if @error is set. Free with</doc>
9232           <type name="DBusServer" c:type="GDBusServer*"/>
9233         </return-value>
9234         <parameters>
9235           <parameter name="address" transfer-ownership="none">
9236             <doc xml:whitespace="preserve">A D-Bus address.</doc>
9237             <type name="utf8" c:type="gchar*"/>
9238           </parameter>
9239           <parameter name="flags" transfer-ownership="none">
9240             <doc xml:whitespace="preserve">Flags from the #GDBusServerFlags enumeration.</doc>
9241             <type name="DBusServerFlags" c:type="GDBusServerFlags"/>
9242           </parameter>
9243           <parameter name="guid" transfer-ownership="none">
9244             <doc xml:whitespace="preserve">A D-Bus GUID.</doc>
9245             <type name="utf8" c:type="gchar*"/>
9246           </parameter>
9247           <parameter name="observer" transfer-ownership="none">
9248             <doc xml:whitespace="preserve">A #GDBusAuthObserver or %NULL.</doc>
9249             <type name="DBusAuthObserver" c:type="GDBusAuthObserver*"/>
9250           </parameter>
9251           <parameter name="cancellable"
9252                      transfer-ownership="none"
9253                      allow-none="1">
9254             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
9255             <type name="Cancellable" c:type="GCancellable*"/>
9256           </parameter>
9257         </parameters>
9258       </constructor>
9259       <method name="get_client_address"
9260               c:identifier="g_dbus_server_get_client_address"
9261               version="2.26">
9262         <doc xml:whitespace="preserve">Gets a D-Bus address string that can be used by clients to connect
9263 to @server.
9264 by @server.</doc>
9265         <return-value transfer-ownership="none">
9266           <doc xml:whitespace="preserve">A D-Bus address string. Do not free, the string is owned</doc>
9267           <type name="utf8" c:type="gchar*"/>
9268         </return-value>
9269       </method>
9270       <method name="get_flags"
9271               c:identifier="g_dbus_server_get_flags"
9272               version="2.26">
9273         <doc xml:whitespace="preserve">Gets the flags for @server.</doc>
9274         <return-value transfer-ownership="none">
9275           <doc xml:whitespace="preserve">A set of flags from the #GDBusServerFlags enumeration.</doc>
9276           <type name="DBusServerFlags" c:type="GDBusServerFlags"/>
9277         </return-value>
9278       </method>
9279       <method name="get_guid"
9280               c:identifier="g_dbus_server_get_guid"
9281               version="2.26">
9282         <doc xml:whitespace="preserve">Gets the GUID for @server.</doc>
9283         <return-value transfer-ownership="none">
9284           <doc xml:whitespace="preserve">A D-Bus GUID. Do not free this string, it is owned by @server.</doc>
9285           <type name="utf8" c:type="gchar*"/>
9286         </return-value>
9287       </method>
9288       <method name="is_active"
9289               c:identifier="g_dbus_server_is_active"
9290               version="2.26">
9291         <doc xml:whitespace="preserve">Gets whether @server is active.</doc>
9292         <return-value transfer-ownership="none">
9293           <doc xml:whitespace="preserve">%TRUE if server is active, %FALSE otherwise.</doc>
9294           <type name="gboolean" c:type="gboolean"/>
9295         </return-value>
9296       </method>
9297       <method name="start" c:identifier="g_dbus_server_start" version="2.26">
9298         <doc xml:whitespace="preserve">Starts @server.</doc>
9299         <return-value transfer-ownership="none">
9300           <type name="none" c:type="void"/>
9301         </return-value>
9302       </method>
9303       <method name="stop" c:identifier="g_dbus_server_stop" version="2.26">
9304         <doc xml:whitespace="preserve">Stops @server.</doc>
9305         <return-value transfer-ownership="none">
9306           <type name="none" c:type="void"/>
9307         </return-value>
9308       </method>
9309       <property name="active" version="2.26" transfer-ownership="none">
9310         <doc xml:whitespace="preserve">Whether the server is currently active.</doc>
9311         <type name="gboolean"/>
9312       </property>
9313       <property name="address"
9314                 version="2.26"
9315                 writable="1"
9316                 construct-only="1"
9317                 transfer-ownership="none">
9318         <doc xml:whitespace="preserve">The D-Bus address to listen on.</doc>
9319         <type name="utf8"/>
9320       </property>
9321       <property name="authentication-observer"
9322                 version="2.26"
9323                 writable="1"
9324                 construct-only="1"
9325                 transfer-ownership="none">
9326         <doc xml:whitespace="preserve">A #GDBusAuthObserver object to assist in the authentication process or %NULL.</doc>
9327         <type name="DBusAuthObserver"/>
9328       </property>
9329       <property name="client-address" version="2.26" transfer-ownership="none">
9330         <doc xml:whitespace="preserve">The D-Bus address that clients can use.</doc>
9331         <type name="utf8"/>
9332       </property>
9333       <property name="flags"
9334                 version="2.26"
9335                 writable="1"
9336                 construct-only="1"
9337                 transfer-ownership="none">
9338         <doc xml:whitespace="preserve">Flags from the #GDBusServerFlags enumeration.</doc>
9339         <type name="DBusServerFlags"/>
9340       </property>
9341       <property name="guid"
9342                 version="2.26"
9343                 writable="1"
9344                 construct-only="1"
9345                 transfer-ownership="none">
9346         <doc xml:whitespace="preserve">The guid of the server.</doc>
9347         <type name="utf8"/>
9348       </property>
9349       <glib:signal name="new-connection" version="2.26">
9350         <doc xml:whitespace="preserve">Emitted when a new authenticated connection has been made. Use
9351 g_dbus_connection_get_peer_credentials() to figure out what
9352 identity (if any), was authenticated.
9353 If you want to accept the connection, take a reference to the
9354 connection call g_dbus_connection_close() and give up your
9355 reference. Note that the other peer may disconnect at any time -
9356 a typical thing to do when accepting a connection is to listen to
9357 the #GDBusConnection::closed signal.
9358 If #GDBusServer:flags contains %G_DBUS_SERVER_FLAGS_RUN_IN_THREAD
9359 then the signal is emitted in a new thread dedicated to the
9360 connection. Otherwise the signal is emitted in the &lt;link
9361 linkend="g-main-context-push-thread-default"&gt;thread-default main
9362 loop&lt;/link&gt; of the thread that @server was constructed in.
9363 You are guaranteed that signal handlers for this signal runs
9364 before incoming messages on @connection are processed. This means
9365 that it's suitable to call g_dbus_connection_register_object() or
9366 similar from the signal handler.
9367 run.</doc>
9368         <return-value transfer-ownership="none">
9369           <doc xml:whitespace="preserve">%TRUE to claim @connection, %FALSE to let other handlers</doc>
9370           <type name="gboolean"/>
9371         </return-value>
9372         <parameters>
9373           <parameter name="object" transfer-ownership="none">
9374             <doc xml:whitespace="preserve">A #GDBusConnection for the new connection.</doc>
9375             <type name="DBusConnection"/>
9376           </parameter>
9377         </parameters>
9378       </glib:signal>
9379     </class>
9380     <bitfield name="DBusServerFlags"
9381               version="2.26"
9382               glib:type-name="GDBusServerFlags"
9383               glib:get-type="g_dbus_server_flags_get_type"
9384               c:type="GDBusServerFlags">
9385       <doc xml:whitespace="preserve">Flags used when creating a #GDBusServer.</doc>
9386       <member name="none"
9387               value="0"
9388               c:identifier="G_DBUS_SERVER_FLAGS_NONE"
9389               glib:nick="none"/>
9390       <member name="run_in_thread"
9391               value="1"
9392               c:identifier="G_DBUS_SERVER_FLAGS_RUN_IN_THREAD"
9393               glib:nick="run-in-thread"/>
9394       <member name="authentication_allow_anonymous"
9395               value="2"
9396               c:identifier="G_DBUS_SERVER_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS"
9397               glib:nick="authentication-allow-anonymous"/>
9398     </bitfield>
9399     <callback name="DBusSignalCallback"
9400               c:type="GDBusSignalCallback"
9401               version="2.26">
9402       <doc xml:whitespace="preserve">Signature for callback function used in g_dbus_connection_signal_subscribe().</doc>
9403       <return-value transfer-ownership="none">
9404         <type name="none" c:type="void"/>
9405       </return-value>
9406       <parameters>
9407         <parameter name="connection" transfer-ownership="none">
9408           <doc xml:whitespace="preserve">A #GDBusConnection.</doc>
9409           <type name="DBusConnection" c:type="GDBusConnection*"/>
9410         </parameter>
9411         <parameter name="sender_name" transfer-ownership="none">
9412           <doc xml:whitespace="preserve">The unique bus name of the sender of the signal.</doc>
9413           <type name="utf8" c:type="gchar*"/>
9414         </parameter>
9415         <parameter name="object_path" transfer-ownership="none">
9416           <doc xml:whitespace="preserve">The object path that the signal was emitted on.</doc>
9417           <type name="utf8" c:type="gchar*"/>
9418         </parameter>
9419         <parameter name="interface_name" transfer-ownership="none">
9420           <doc xml:whitespace="preserve">The name of the interface.</doc>
9421           <type name="utf8" c:type="gchar*"/>
9422         </parameter>
9423         <parameter name="signal_name" transfer-ownership="none">
9424           <doc xml:whitespace="preserve">The name of the signal.</doc>
9425           <type name="utf8" c:type="gchar*"/>
9426         </parameter>
9427         <parameter name="parameters" transfer-ownership="none">
9428           <doc xml:whitespace="preserve">A #GVariant tuple with parameters for the signal.</doc>
9429           <type name="GLib.Variant" c:type="GVariant*"/>
9430         </parameter>
9431         <parameter name="user_data" transfer-ownership="none" closure="6">
9432           <doc xml:whitespace="preserve">User data passed when subscribing to the signal.</doc>
9433           <type name="gpointer" c:type="gpointer"/>
9434         </parameter>
9435       </parameters>
9436     </callback>
9437     <bitfield name="DBusSignalFlags"
9438               version="2.26"
9439               glib:type-name="GDBusSignalFlags"
9440               glib:get-type="g_dbus_signal_flags_get_type"
9441               c:type="GDBusSignalFlags">
9442       <doc xml:whitespace="preserve">Flags used when subscribing to signals via g_dbus_connection_signal_subscribe().</doc>
9443       <member name="none"
9444               value="0"
9445               c:identifier="G_DBUS_SIGNAL_FLAGS_NONE"
9446               glib:nick="none"/>
9447     </bitfield>
9448     <record name="DBusSignalInfo"
9449             c:type="GDBusSignalInfo"
9450             version="2.26"
9451             glib:type-name="GDBusSignalInfo"
9452             glib:get-type="g_dbus_signal_info_get_type"
9453             c:symbol-prefix="dbus_signal_info">
9454       <doc xml:whitespace="preserve">Information about a signal on a D-Bus interface.</doc>
9455       <field name="ref_count" writable="1">
9456         <type name="gint" c:type="gint"/>
9457       </field>
9458       <field name="name" writable="1">
9459         <type name="utf8" c:type="gchar*"/>
9460       </field>
9461       <field name="args" writable="1">
9462         <type name="DBusArgInfo" c:type="GDBusArgInfo**"/>
9463       </field>
9464       <field name="annotations" writable="1">
9465         <type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo**"/>
9466       </field>
9467       <method name="ref" c:identifier="g_dbus_signal_info_ref" version="2.26">
9468         <doc xml:whitespace="preserve">If @info is statically allocated does nothing. Otherwise increases
9469 the reference count.</doc>
9470         <return-value transfer-ownership="full">
9471           <doc xml:whitespace="preserve">The same @info.</doc>
9472           <type name="DBusSignalInfo" c:type="GDBusSignalInfo*"/>
9473         </return-value>
9474       </method>
9475       <method name="unref"
9476               c:identifier="g_dbus_signal_info_unref"
9477               version="2.26">
9478         <doc xml:whitespace="preserve">If @info is statically allocated, does nothing. Otherwise decreases
9479 the reference count of @info. When its reference count drops to 0,
9480 the memory used is freed.</doc>
9481         <return-value transfer-ownership="none">
9482           <type name="none" c:type="void"/>
9483         </return-value>
9484       </method>
9485     </record>
9486     <callback name="DBusSubtreeDispatchFunc"
9487               c:type="GDBusSubtreeDispatchFunc"
9488               version="2.26">
9489       <doc xml:whitespace="preserve">The type of the @dispatch function in #GDBusSubtreeVTable.
9490 Subtrees are flat.  @node, if non-%NULL, is always exactly one</doc>
9491       <return-value transfer-ownership="none">
9492         <doc xml:whitespace="preserve">A #GDBusInterfaceVTable or %NULL if you don't want to handle the methods.</doc>
9493         <type name="DBusInterfaceVTable" c:type="GDBusInterfaceVTable*"/>
9494       </return-value>
9495       <parameters>
9496         <parameter name="connection" transfer-ownership="none">
9497           <doc xml:whitespace="preserve">A #GDBusConnection.</doc>
9498           <type name="DBusConnection" c:type="GDBusConnection*"/>
9499         </parameter>
9500         <parameter name="sender" transfer-ownership="none">
9501           <doc xml:whitespace="preserve">The unique bus name of the remote caller.</doc>
9502           <type name="utf8" c:type="gchar*"/>
9503         </parameter>
9504         <parameter name="object_path" transfer-ownership="none">
9505           <doc xml:whitespace="preserve">The object path that was registered with g_dbus_connection_register_subtree().</doc>
9506           <type name="utf8" c:type="gchar*"/>
9507         </parameter>
9508         <parameter name="interface_name" transfer-ownership="none">
9509           <doc xml:whitespace="preserve">The D-Bus interface name that the method call or property access is for.</doc>
9510           <type name="utf8" c:type="gchar*"/>
9511         </parameter>
9512         <parameter name="node" transfer-ownership="none">
9513           <doc xml:whitespace="preserve">A node that is a child of @object_path (relative to @object_path) or %NULL for the root of the subtree.</doc>
9514           <type name="utf8" c:type="gchar*"/>
9515         </parameter>
9516         <parameter name="out_user_data" transfer-ownership="none">
9517           <doc xml:whitespace="preserve">Return location for user data to pass to functions in the returned #GDBusInterfaceVTable (never %NULL).</doc>
9518           <type name="gpointer" c:type="gpointer*"/>
9519         </parameter>
9520         <parameter name="user_data" transfer-ownership="none" closure="6">
9521           <doc xml:whitespace="preserve">The @user_data #gpointer passed to g_dbus_connection_register_subtree().</doc>
9522           <type name="gpointer" c:type="gpointer"/>
9523         </parameter>
9524       </parameters>
9525     </callback>
9526     <callback name="DBusSubtreeEnumerateFunc"
9527               c:type="GDBusSubtreeEnumerateFunc"
9528               version="2.26"
9529               introspectable="0">
9530       <doc xml:whitespace="preserve">The type of the @enumerate function in #GDBusSubtreeVTable.
9531 This function is called when generating introspection data and also
9532 when preparing to dispatch incoming messages in the event that the
9533 %G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES flag is not
9534 Hierarchies are not supported; the items that you return should not
9535 contain the '/' character.
9536 The return value will be freed with g_strfreev().</doc>
9537       <return-value>
9538         <doc xml:whitespace="preserve">A newly allocated array of strings for node names that are children of @object_path.</doc>
9539         <array c:type="gchar**">
9540           <type name="utf8"/>
9541         </array>
9542       </return-value>
9543       <parameters>
9544         <parameter name="connection" transfer-ownership="none">
9545           <doc xml:whitespace="preserve">A #GDBusConnection.</doc>
9546           <type name="DBusConnection" c:type="GDBusConnection*"/>
9547         </parameter>
9548         <parameter name="sender" transfer-ownership="none">
9549           <doc xml:whitespace="preserve">The unique bus name of the remote caller.</doc>
9550           <type name="utf8" c:type="gchar*"/>
9551         </parameter>
9552         <parameter name="object_path" transfer-ownership="none">
9553           <doc xml:whitespace="preserve">The object path that was registered with g_dbus_connection_register_subtree().</doc>
9554           <type name="utf8" c:type="gchar*"/>
9555         </parameter>
9556         <parameter name="user_data" transfer-ownership="none" closure="3">
9557           <doc xml:whitespace="preserve">The @user_data #gpointer passed to g_dbus_connection_register_subtree().</doc>
9558           <type name="gpointer" c:type="gpointer"/>
9559         </parameter>
9560       </parameters>
9561     </callback>
9562     <bitfield name="DBusSubtreeFlags"
9563               version="2.26"
9564               glib:type-name="GDBusSubtreeFlags"
9565               glib:get-type="g_dbus_subtree_flags_get_type"
9566               c:type="GDBusSubtreeFlags">
9567       <doc xml:whitespace="preserve">Flags passed to g_dbus_connection_register_subtree().</doc>
9568       <member name="none"
9569               value="0"
9570               c:identifier="G_DBUS_SUBTREE_FLAGS_NONE"
9571               glib:nick="none"/>
9572       <member name="dispatch_to_unenumerated_nodes"
9573               value="1"
9574               c:identifier="G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES"
9575               glib:nick="dispatch-to-unenumerated-nodes"/>
9576     </bitfield>
9577     <callback name="DBusSubtreeIntrospectFunc"
9578               c:type="GDBusSubtreeIntrospectFunc"
9579               version="2.26">
9580       <doc xml:whitespace="preserve">The type of the @introspect function in #GDBusSubtreeVTable.
9581 Subtrees are flat.  @node, if non-%NULL, is always exactly one
9582 This function should return %NULL to indicate that there is no object
9583 at this node.
9584 If this function returns non-%NULL, the return value is expected to
9585 be a %NULL-terminated array of pointers to #GDBusInterfaceInfo
9586 structures describing the interfaces implemented by @node.  This
9587 array will have g_dbus_interface_info_unref() called on each item
9588 before being freed with g_free().
9589 The difference between returning %NULL and an array containing zero
9590 items is that the standard DBus interfaces will returned to the
9591 remote introspector in the empty array case, but not in the %NULL
9592 case.</doc>
9593       <return-value transfer-ownership="full">
9594         <doc xml:whitespace="preserve">A %NULL-terminated array of pointers to #GDBusInterfaceInfo, or %NULL.</doc>
9595         <type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo**"/>
9596       </return-value>
9597       <parameters>
9598         <parameter name="connection" transfer-ownership="none">
9599           <doc xml:whitespace="preserve">A #GDBusConnection.</doc>
9600           <type name="DBusConnection" c:type="GDBusConnection*"/>
9601         </parameter>
9602         <parameter name="sender" transfer-ownership="none">
9603           <doc xml:whitespace="preserve">The unique bus name of the remote caller.</doc>
9604           <type name="utf8" c:type="gchar*"/>
9605         </parameter>
9606         <parameter name="object_path" transfer-ownership="none">
9607           <doc xml:whitespace="preserve">The object path that was registered with g_dbus_connection_register_subtree().</doc>
9608           <type name="utf8" c:type="gchar*"/>
9609         </parameter>
9610         <parameter name="node" transfer-ownership="none">
9611           <doc xml:whitespace="preserve">A node that is a child of @object_path (relative to @object_path) or %NULL for the root of the subtree.</doc>
9612           <type name="utf8" c:type="gchar*"/>
9613         </parameter>
9614         <parameter name="user_data" transfer-ownership="none" closure="4">
9615           <doc xml:whitespace="preserve">The @user_data #gpointer passed to g_dbus_connection_register_subtree().</doc>
9616           <type name="gpointer" c:type="gpointer"/>
9617         </parameter>
9618       </parameters>
9619     </callback>
9620     <record name="DBusSubtreeVTable"
9621             c:type="GDBusSubtreeVTable"
9622             version="2.26">
9623       <doc xml:whitespace="preserve">Virtual table for handling subtrees registered with g_dbus_connection_register_subtree().</doc>
9624       <field name="enumerate" introspectable="0" writable="1">
9625         <type name="DBusSubtreeEnumerateFunc"
9626               c:type="GDBusSubtreeEnumerateFunc"/>
9627       </field>
9628       <field name="introspect" writable="1">
9629         <type name="DBusSubtreeIntrospectFunc"
9630               c:type="GDBusSubtreeIntrospectFunc"/>
9631       </field>
9632       <field name="dispatch" writable="1">
9633         <type name="DBusSubtreeDispatchFunc"
9634               c:type="GDBusSubtreeDispatchFunc"/>
9635       </field>
9636       <field name="padding" writable="1">
9637         <array zero-terminated="0" c:type="gpointer" fixed-size="8">
9638           <type name="gpointer" c:type="gpointer"/>
9639         </array>
9640       </field>
9641     </record>
9642     <constant name="DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME"
9643               value="gio-desktop-app-info-lookup">
9644       <type name="utf8" c:type="gchar*"/>
9645     </constant>
9646     <class name="DataInputStream"
9647            c:symbol-prefix="data_input_stream"
9648            c:type="GDataInputStream"
9649            parent="BufferedInputStream"
9650            glib:type-name="GDataInputStream"
9651            glib:get-type="g_data_input_stream_get_type"
9652            glib:type-struct="DataInputStreamClass">
9653       <doc xml:whitespace="preserve">An implementation of #GBufferedInputStream that allows for high-level
9654 data manipulation of arbitrary data (including binary operations).</doc>
9655       <constructor name="new" c:identifier="g_data_input_stream_new">
9656         <doc xml:whitespace="preserve">Creates a new data input stream for the @base_stream.</doc>
9657         <return-value transfer-ownership="full">
9658           <doc xml:whitespace="preserve">a new #GDataInputStream.</doc>
9659           <type name="DataInputStream" c:type="GDataInputStream*"/>
9660         </return-value>
9661         <parameters>
9662           <parameter name="base_stream" transfer-ownership="none">
9663             <doc xml:whitespace="preserve">a #GInputStream.</doc>
9664             <type name="InputStream" c:type="GInputStream*"/>
9665           </parameter>
9666         </parameters>
9667       </constructor>
9668       <method name="get_byte_order"
9669               c:identifier="g_data_input_stream_get_byte_order">
9670         <doc xml:whitespace="preserve">Gets the byte order for the data input stream.</doc>
9671         <return-value transfer-ownership="none">
9672           <doc xml:whitespace="preserve">the @stream's current #GDataStreamByteOrder.</doc>
9673           <type name="DataStreamByteOrder" c:type="GDataStreamByteOrder"/>
9674         </return-value>
9675       </method>
9676       <method name="get_newline_type"
9677               c:identifier="g_data_input_stream_get_newline_type">
9678         <doc xml:whitespace="preserve">Gets the current newline type for the @stream.</doc>
9679         <return-value transfer-ownership="none">
9680           <doc xml:whitespace="preserve">#GDataStreamNewlineType for the given @stream.</doc>
9681           <type name="DataStreamNewlineType" c:type="GDataStreamNewlineType"/>
9682         </return-value>
9683       </method>
9684       <method name="read_byte"
9685               c:identifier="g_data_input_stream_read_byte"
9686               throws="1">
9687         <doc xml:whitespace="preserve">Reads an unsigned 8-bit/1-byte value from @stream.
9688 if an error occurred.</doc>
9689         <return-value transfer-ownership="none">
9690           <doc xml:whitespace="preserve">an unsigned 8-bit/1-byte value read from the @stream or %0</doc>
9691           <type name="guint8" c:type="guchar"/>
9692         </return-value>
9693         <parameters>
9694           <parameter name="cancellable"
9695                      transfer-ownership="none"
9696                      allow-none="1">
9697             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
9698             <type name="Cancellable" c:type="GCancellable*"/>
9699           </parameter>
9700         </parameters>
9701       </method>
9702       <method name="read_int16"
9703               c:identifier="g_data_input_stream_read_int16"
9704               throws="1">
9705         <doc xml:whitespace="preserve">Reads a 16-bit/2-byte value from @stream.
9706 In order to get the correct byte order for this read operation,
9707 see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
9708 an error occurred.</doc>
9709         <return-value transfer-ownership="none">
9710           <doc xml:whitespace="preserve">a signed 16-bit/2-byte value read from @stream or %0 if</doc>
9711           <type name="gint16" c:type="gint16"/>
9712         </return-value>
9713         <parameters>
9714           <parameter name="cancellable"
9715                      transfer-ownership="none"
9716                      allow-none="1">
9717             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
9718             <type name="Cancellable" c:type="GCancellable*"/>
9719           </parameter>
9720         </parameters>
9721       </method>
9722       <method name="read_int32"
9723               c:identifier="g_data_input_stream_read_int32"
9724               throws="1">
9725         <doc xml:whitespace="preserve">Reads a signed 32-bit/4-byte value from @stream.
9726 In order to get the correct byte order for this read operation,
9727 see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
9728 If @cancellable is not %NULL, then the operation can be cancelled by
9729 triggering the cancellable object from another thread. If the operation
9730 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
9731 an error occurred.</doc>
9732         <return-value transfer-ownership="none">
9733           <doc xml:whitespace="preserve">a signed 32-bit/4-byte value read from the @stream or %0 if</doc>
9734           <type name="gint32" c:type="gint32"/>
9735         </return-value>
9736         <parameters>
9737           <parameter name="cancellable"
9738                      transfer-ownership="none"
9739                      allow-none="1">
9740             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
9741             <type name="Cancellable" c:type="GCancellable*"/>
9742           </parameter>
9743         </parameters>
9744       </method>
9745       <method name="read_int64"
9746               c:identifier="g_data_input_stream_read_int64"
9747               throws="1">
9748         <doc xml:whitespace="preserve">Reads a 64-bit/8-byte value from @stream.
9749 In order to get the correct byte order for this read operation,
9750 see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
9751 If @cancellable is not %NULL, then the operation can be cancelled by
9752 triggering the cancellable object from another thread. If the operation
9753 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
9754 an error occurred.</doc>
9755         <return-value transfer-ownership="none">
9756           <doc xml:whitespace="preserve">a signed 64-bit/8-byte value read from @stream or %0 if</doc>
9757           <type name="gint64" c:type="gint64"/>
9758         </return-value>
9759         <parameters>
9760           <parameter name="cancellable"
9761                      transfer-ownership="none"
9762                      allow-none="1">
9763             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
9764             <type name="Cancellable" c:type="GCancellable*"/>
9765           </parameter>
9766         </parameters>
9767       </method>
9768       <method name="read_line"
9769               c:identifier="g_data_input_stream_read_line"
9770               throws="1">
9771         <doc xml:whitespace="preserve">Reads a line from the data input stream.
9772 If @cancellable is not %NULL, then the operation can be cancelled by
9773 triggering the cancellable object from another thread. If the operation
9774 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
9775 Set @length to a #gsize to get the length of the read line.
9776 On an error, it will return %NULL and @error will be set. If there's no
9777 content to read, it will still return %NULL, but @error won't be set.</doc>
9778         <return-value transfer-ownership="full">
9779           <doc xml:whitespace="preserve">a string with the line that was read in (without the newlines).</doc>
9780           <type name="utf8" c:type="char*"/>
9781         </return-value>
9782         <parameters>
9783           <parameter name="length" transfer-ownership="none">
9784             <doc xml:whitespace="preserve">a #gsize to get the length of the data read in.</doc>
9785             <type name="gulong" c:type="gsize*"/>
9786           </parameter>
9787           <parameter name="cancellable"
9788                      transfer-ownership="none"
9789                      allow-none="1">
9790             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
9791             <type name="Cancellable" c:type="GCancellable*"/>
9792           </parameter>
9793         </parameters>
9794       </method>
9795       <method name="read_line_async"
9796               c:identifier="g_data_input_stream_read_line_async"
9797               version="2.20">
9798         <doc xml:whitespace="preserve">The asynchronous version of g_data_input_stream_read_line().  It is
9799 an error to have two outstanding calls to this function.
9800 When the operation is finished, @callback will be called. You
9801 can then call g_data_input_stream_read_line_finish() to get
9802 the result of the operation.</doc>
9803         <return-value transfer-ownership="none">
9804           <type name="none" c:type="void"/>
9805         </return-value>
9806         <parameters>
9807           <parameter name="io_priority" transfer-ownership="none">
9808             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
9809             <type name="gint" c:type="gint"/>
9810           </parameter>
9811           <parameter name="cancellable"
9812                      transfer-ownership="none"
9813                      allow-none="1">
9814             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
9815             <type name="Cancellable" c:type="GCancellable*"/>
9816           </parameter>
9817           <parameter name="callback"
9818                      transfer-ownership="none"
9819                      scope="async"
9820                      closure="3">
9821             <doc xml:whitespace="preserve">callback to call when the request is satisfied.</doc>
9822             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
9823           </parameter>
9824           <parameter name="user_data" transfer-ownership="none">
9825             <doc xml:whitespace="preserve">the data to pass to callback function.</doc>
9826             <type name="gpointer" c:type="gpointer"/>
9827           </parameter>
9828         </parameters>
9829       </method>
9830       <method name="read_line_finish"
9831               c:identifier="g_data_input_stream_read_line_finish"
9832               version="2.20"
9833               throws="1">
9834         <doc xml:whitespace="preserve">Finish an asynchronous call started by
9835 g_data_input_stream_read_line_async().
9836 Set @length to a #gsize to get the length of the read line.
9837 On an error, it will return %NULL and @error will be set. If there's no
9838 content to read, it will still return %NULL, but @error won't be set.</doc>
9839         <return-value transfer-ownership="full">
9840           <doc xml:whitespace="preserve">a string with the line that was read in (without the newlines).</doc>
9841           <type name="utf8" c:type="char*"/>
9842         </return-value>
9843         <parameters>
9844           <parameter name="result" transfer-ownership="none">
9845             <doc xml:whitespace="preserve">the #GAsyncResult that was provided to the callback.</doc>
9846             <type name="AsyncResult" c:type="GAsyncResult*"/>
9847           </parameter>
9848           <parameter name="length" transfer-ownership="none">
9849             <doc xml:whitespace="preserve">a #gsize to get the length of the data read in.</doc>
9850             <type name="gulong" c:type="gsize*"/>
9851           </parameter>
9852         </parameters>
9853       </method>
9854       <method name="read_uint16"
9855               c:identifier="g_data_input_stream_read_uint16"
9856               throws="1">
9857         <doc xml:whitespace="preserve">Reads an unsigned 16-bit/2-byte value from @stream.
9858 In order to get the correct byte order for this read operation,
9859 see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
9860 an error occurred.</doc>
9861         <return-value transfer-ownership="none">
9862           <doc xml:whitespace="preserve">an unsigned 16-bit/2-byte value read from the @stream or %0 if</doc>
9863           <type name="guint16" c:type="guint16"/>
9864         </return-value>
9865         <parameters>
9866           <parameter name="cancellable"
9867                      transfer-ownership="none"
9868                      allow-none="1">
9869             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
9870             <type name="Cancellable" c:type="GCancellable*"/>
9871           </parameter>
9872         </parameters>
9873       </method>
9874       <method name="read_uint32"
9875               c:identifier="g_data_input_stream_read_uint32"
9876               throws="1">
9877         <doc xml:whitespace="preserve">Reads an unsigned 32-bit/4-byte value from @stream.
9878 In order to get the correct byte order for this read operation,
9879 see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
9880 If @cancellable is not %NULL, then the operation can be cancelled by
9881 triggering the cancellable object from another thread. If the operation
9882 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
9883 an error occurred.</doc>
9884         <return-value transfer-ownership="none">
9885           <doc xml:whitespace="preserve">an unsigned 32-bit/4-byte value read from the @stream or %0 if</doc>
9886           <type name="guint32" c:type="guint32"/>
9887         </return-value>
9888         <parameters>
9889           <parameter name="cancellable"
9890                      transfer-ownership="none"
9891                      allow-none="1">
9892             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
9893             <type name="Cancellable" c:type="GCancellable*"/>
9894           </parameter>
9895         </parameters>
9896       </method>
9897       <method name="read_uint64"
9898               c:identifier="g_data_input_stream_read_uint64"
9899               throws="1">
9900         <doc xml:whitespace="preserve">Reads an unsigned 64-bit/8-byte value from @stream.
9901 In order to get the correct byte order for this read operation,
9902 see g_data_input_stream_get_byte_order().
9903 If @cancellable is not %NULL, then the operation can be cancelled by
9904 triggering the cancellable object from another thread. If the operation
9905 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
9906 an error occurred.</doc>
9907         <return-value transfer-ownership="none">
9908           <doc xml:whitespace="preserve">an unsigned 64-bit/8-byte read from @stream or %0 if</doc>
9909           <type name="guint64" c:type="guint64"/>
9910         </return-value>
9911         <parameters>
9912           <parameter name="cancellable"
9913                      transfer-ownership="none"
9914                      allow-none="1">
9915             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
9916             <type name="Cancellable" c:type="GCancellable*"/>
9917           </parameter>
9918         </parameters>
9919       </method>
9920       <method name="read_until"
9921               c:identifier="g_data_input_stream_read_until"
9922               throws="1">
9923         <doc xml:whitespace="preserve">Reads a string from the data input stream, up to the first
9924 occurrence of any of the stop characters.
9925 Note that, in contrast to g_data_input_stream_read_until_async(),
9926 this function consumes the stop character that it finds.
9927 Don't use this function in new code.  Its functionality is
9928 inconsistent with g_data_input_stream_read_until_async().  Both
9929 functions will be marked as deprecated in a future release.  Use
9930 g_data_input_stream_read_upto() instead, but note that that function
9931 does not consume the stop character.
9932 any of the stop characters. Set @length to a #gsize to get the length
9933 of the string. This function will return %NULL on an error.</doc>
9934         <return-value transfer-ownership="full">
9935           <doc xml:whitespace="preserve">a string with the data that was read before encountering</doc>
9936           <type name="utf8" c:type="char*"/>
9937         </return-value>
9938         <parameters>
9939           <parameter name="stop_chars" transfer-ownership="none">
9940             <doc xml:whitespace="preserve">characters to terminate the read.</doc>
9941             <type name="utf8" c:type="gchar*"/>
9942           </parameter>
9943           <parameter name="length" transfer-ownership="none">
9944             <doc xml:whitespace="preserve">a #gsize to get the length of the data read in.</doc>
9945             <type name="gulong" c:type="gsize*"/>
9946           </parameter>
9947           <parameter name="cancellable"
9948                      transfer-ownership="none"
9949                      allow-none="1">
9950             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
9951             <type name="Cancellable" c:type="GCancellable*"/>
9952           </parameter>
9953         </parameters>
9954       </method>
9955       <method name="read_until_async"
9956               c:identifier="g_data_input_stream_read_until_async"
9957               version="2.20">
9958         <doc xml:whitespace="preserve">The asynchronous version of g_data_input_stream_read_until().
9959 It is an error to have two outstanding calls to this function.
9960 Note that, in contrast to g_data_input_stream_read_until(),
9961 this function does not consume the stop character that it finds.  You
9962 must read it for yourself.
9963 When the operation is finished, @callback will be called. You
9964 can then call g_data_input_stream_read_until_finish() to get
9965 the result of the operation.
9966 Don't use this function in new code.  Its functionality is
9967 inconsistent with g_data_input_stream_read_until().  Both functions
9968 will be marked as deprecated in a future release.  Use
9969 g_data_input_stream_read_upto_async() instead.</doc>
9970         <return-value transfer-ownership="none">
9971           <type name="none" c:type="void"/>
9972         </return-value>
9973         <parameters>
9974           <parameter name="stop_chars" transfer-ownership="none">
9975             <doc xml:whitespace="preserve">characters to terminate the read.</doc>
9976             <type name="utf8" c:type="gchar*"/>
9977           </parameter>
9978           <parameter name="io_priority" transfer-ownership="none">
9979             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
9980             <type name="gint" c:type="gint"/>
9981           </parameter>
9982           <parameter name="cancellable"
9983                      transfer-ownership="none"
9984                      allow-none="1">
9985             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
9986             <type name="Cancellable" c:type="GCancellable*"/>
9987           </parameter>
9988           <parameter name="callback"
9989                      transfer-ownership="none"
9990                      scope="async"
9991                      closure="4">
9992             <doc xml:whitespace="preserve">callback to call when the request is satisfied.</doc>
9993             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
9994           </parameter>
9995           <parameter name="user_data" transfer-ownership="none">
9996             <doc xml:whitespace="preserve">the data to pass to callback function.</doc>
9997             <type name="gpointer" c:type="gpointer"/>
9998           </parameter>
9999         </parameters>
10000       </method>
10001       <method name="read_until_finish"
10002               c:identifier="g_data_input_stream_read_until_finish"
10003               version="2.20"
10004               throws="1">
10005         <doc xml:whitespace="preserve">Finish an asynchronous call started by
10006 g_data_input_stream_read_until_async().
10007 any of the stop characters. Set @length to a #gsize to get the length
10008 of the string. This function will return %NULL on an error.</doc>
10009         <return-value transfer-ownership="full">
10010           <doc xml:whitespace="preserve">a string with the data that was read before encountering</doc>
10011           <type name="utf8" c:type="char*"/>
10012         </return-value>
10013         <parameters>
10014           <parameter name="result" transfer-ownership="none">
10015             <doc xml:whitespace="preserve">the #GAsyncResult that was provided to the callback.</doc>
10016             <type name="AsyncResult" c:type="GAsyncResult*"/>
10017           </parameter>
10018           <parameter name="length" transfer-ownership="none">
10019             <doc xml:whitespace="preserve">a #gsize to get the length of the data read in.</doc>
10020             <type name="gulong" c:type="gsize*"/>
10021           </parameter>
10022         </parameters>
10023       </method>
10024       <method name="read_upto"
10025               c:identifier="g_data_input_stream_read_upto"
10026               version="2.24"
10027               throws="1">
10028         <doc xml:whitespace="preserve">Reads a string from the data input stream, up to the first
10029 occurrence of any of the stop characters.
10030 In contrast to g_data_input_stream_read_until(), this function
10031 does &lt;emphasis&gt;not&lt;/emphasis&gt; consume the stop character. You have
10032 to use g_data_input_stream_read_byte() to get it before calling
10033 g_data_input_stream_read_upto() again.
10034 Note that @stop_chars may contain '\0' if @stop_chars_len is
10035 specified.
10036 any of the stop characters. Set @length to a #gsize to get the length
10037 of the string. This function will return %NULL on an error</doc>
10038         <return-value transfer-ownership="full">
10039           <doc xml:whitespace="preserve">a string with the data that was read before encountering</doc>
10040           <type name="utf8" c:type="char*"/>
10041         </return-value>
10042         <parameters>
10043           <parameter name="stop_chars" transfer-ownership="none">
10044             <doc xml:whitespace="preserve">characters to terminate the read</doc>
10045             <type name="utf8" c:type="gchar*"/>
10046           </parameter>
10047           <parameter name="stop_chars_len" transfer-ownership="none">
10048             <doc xml:whitespace="preserve">length of @stop_chars. May be -1 if @stop_chars is nul-terminated</doc>
10049             <type name="glong" c:type="gssize"/>
10050           </parameter>
10051           <parameter name="length" transfer-ownership="none">
10052             <doc xml:whitespace="preserve">a #gsize to get the length of the data read in</doc>
10053             <type name="gulong" c:type="gsize*"/>
10054           </parameter>
10055           <parameter name="cancellable"
10056                      transfer-ownership="none"
10057                      allow-none="1">
10058             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
10059             <type name="Cancellable" c:type="GCancellable*"/>
10060           </parameter>
10061         </parameters>
10062       </method>
10063       <method name="read_upto_async"
10064               c:identifier="g_data_input_stream_read_upto_async"
10065               version="2.24">
10066         <doc xml:whitespace="preserve">The asynchronous version of g_data_input_stream_read_upto().
10067 It is an error to have two outstanding calls to this function.
10068 In contrast to g_data_input_stream_read_until(), this function
10069 does &lt;emphasis&gt;not&lt;/emphasis&gt; consume the stop character. You have
10070 to use g_data_input_stream_read_byte() to get it before calling
10071 g_data_input_stream_read_upto() again.
10072 Note that @stop_chars may contain '\0' if @stop_chars_len is
10073 specified.
10074 When the operation is finished, @callback will be called. You
10075 can then call g_data_input_stream_read_upto_finish() to get
10076 the result of the operation.</doc>
10077         <return-value transfer-ownership="none">
10078           <type name="none" c:type="void"/>
10079         </return-value>
10080         <parameters>
10081           <parameter name="stop_chars" transfer-ownership="none">
10082             <doc xml:whitespace="preserve">characters to terminate the read</doc>
10083             <type name="utf8" c:type="gchar*"/>
10084           </parameter>
10085           <parameter name="stop_chars_len" transfer-ownership="none">
10086             <doc xml:whitespace="preserve">length of @stop_chars. May be -1 if @stop_chars is nul-terminated</doc>
10087             <type name="glong" c:type="gssize"/>
10088           </parameter>
10089           <parameter name="io_priority" transfer-ownership="none">
10090             <type name="gint" c:type="gint"/>
10091           </parameter>
10092           <parameter name="cancellable"
10093                      transfer-ownership="none"
10094                      allow-none="1">
10095             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
10096             <type name="Cancellable" c:type="GCancellable*"/>
10097           </parameter>
10098           <parameter name="callback"
10099                      transfer-ownership="none"
10100                      scope="async"
10101                      closure="5">
10102             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
10103             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
10104           </parameter>
10105           <parameter name="user_data" transfer-ownership="none">
10106             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
10107             <type name="gpointer" c:type="gpointer"/>
10108           </parameter>
10109         </parameters>
10110       </method>
10111       <method name="read_upto_finish"
10112               c:identifier="g_data_input_stream_read_upto_finish"
10113               version="2.24"
10114               throws="1">
10115         <doc xml:whitespace="preserve">Finish an asynchronous call started by
10116 g_data_input_stream_read_upto_async().
10117 Note that this function does &lt;emphasis&gt;not&lt;/emphasis&gt; consume the
10118 stop character. You have to use g_data_input_stream_read_byte() to
10119 get it before calling g_data_input_stream_read_upto_async() again.
10120 any of the stop characters. Set @length to a #gsize to get the length
10121 of the string. This function will return %NULL on an error.</doc>
10122         <return-value transfer-ownership="full">
10123           <doc xml:whitespace="preserve">a string with the data that was read before encountering</doc>
10124           <type name="utf8" c:type="char*"/>
10125         </return-value>
10126         <parameters>
10127           <parameter name="result" transfer-ownership="none">
10128             <doc xml:whitespace="preserve">the #GAsyncResult that was provided to the callback</doc>
10129             <type name="AsyncResult" c:type="GAsyncResult*"/>
10130           </parameter>
10131           <parameter name="length" transfer-ownership="none">
10132             <doc xml:whitespace="preserve">a #gsize to get the length of the data read in</doc>
10133             <type name="gulong" c:type="gsize*"/>
10134           </parameter>
10135         </parameters>
10136       </method>
10137       <method name="set_byte_order"
10138               c:identifier="g_data_input_stream_set_byte_order">
10139         <doc xml:whitespace="preserve">This function sets the byte order for the given @stream. All subsequent
10140 reads from the @stream will be read in the given @order.</doc>
10141         <return-value transfer-ownership="none">
10142           <type name="none" c:type="void"/>
10143         </return-value>
10144         <parameters>
10145           <parameter name="order" transfer-ownership="none">
10146             <doc xml:whitespace="preserve">a #GDataStreamByteOrder to set.</doc>
10147             <type name="DataStreamByteOrder" c:type="GDataStreamByteOrder"/>
10148           </parameter>
10149         </parameters>
10150       </method>
10151       <method name="set_newline_type"
10152               c:identifier="g_data_input_stream_set_newline_type">
10153         <doc xml:whitespace="preserve">Sets the newline type for the @stream.
10154 Note that using G_DATA_STREAM_NEWLINE_TYPE_ANY is slightly unsafe. If a read
10155 chunk ends in "CR" we must read an additional byte to know if this is "CR" or
10156 "CR LF", and this might block if there is no more data availible.</doc>
10157         <return-value transfer-ownership="none">
10158           <type name="none" c:type="void"/>
10159         </return-value>
10160         <parameters>
10161           <parameter name="type" transfer-ownership="none">
10162             <doc xml:whitespace="preserve">the type of new line return as #GDataStreamNewlineType.</doc>
10163             <type name="DataStreamNewlineType"
10164                   c:type="GDataStreamNewlineType"/>
10165           </parameter>
10166         </parameters>
10167       </method>
10168       <property name="byte-order" writable="1" transfer-ownership="none">
10169         <type name="DataStreamByteOrder"/>
10170       </property>
10171       <property name="newline-type" writable="1" transfer-ownership="none">
10172         <type name="DataStreamNewlineType"/>
10173       </property>
10174       <field name="parent_instance">
10175         <type name="BufferedInputStream" c:type="GBufferedInputStream"/>
10176       </field>
10177       <field name="priv">
10178         <type name="DataInputStreamPrivate" c:type="GDataInputStreamPrivate*"/>
10179       </field>
10180     </class>
10181     <record name="DataInputStreamClass"
10182             c:type="GDataInputStreamClass"
10183             glib:is-gtype-struct-for="DataInputStream">
10184       <field name="parent_class">
10185         <type name="BufferedInputStreamClass"
10186               c:type="GBufferedInputStreamClass"/>
10187       </field>
10188       <field name="_g_reserved1" introspectable="0">
10189         <callback name="_g_reserved1">
10190           <return-value transfer-ownership="none">
10191             <type name="none" c:type="void"/>
10192           </return-value>
10193         </callback>
10194       </field>
10195       <field name="_g_reserved2" introspectable="0">
10196         <callback name="_g_reserved2">
10197           <return-value transfer-ownership="none">
10198             <type name="none" c:type="void"/>
10199           </return-value>
10200         </callback>
10201       </field>
10202       <field name="_g_reserved3" introspectable="0">
10203         <callback name="_g_reserved3">
10204           <return-value transfer-ownership="none">
10205             <type name="none" c:type="void"/>
10206           </return-value>
10207         </callback>
10208       </field>
10209       <field name="_g_reserved4" introspectable="0">
10210         <callback name="_g_reserved4">
10211           <return-value transfer-ownership="none">
10212             <type name="none" c:type="void"/>
10213           </return-value>
10214         </callback>
10215       </field>
10216       <field name="_g_reserved5" introspectable="0">
10217         <callback name="_g_reserved5">
10218           <return-value transfer-ownership="none">
10219             <type name="none" c:type="void"/>
10220           </return-value>
10221         </callback>
10222       </field>
10223     </record>
10224     <record name="DataInputStreamPrivate"
10225             c:type="GDataInputStreamPrivate"
10226             disguised="1">
10227     </record>
10228     <class name="DataOutputStream"
10229            c:symbol-prefix="data_output_stream"
10230            c:type="GDataOutputStream"
10231            parent="FilterOutputStream"
10232            glib:type-name="GDataOutputStream"
10233            glib:get-type="g_data_output_stream_get_type"
10234            glib:type-struct="DataOutputStreamClass">
10235       <doc xml:whitespace="preserve">An implementation of #GBufferedOutputStream that allows for high-level
10236 data manipulation of arbitrary data (including binary operations).</doc>
10237       <constructor name="new" c:identifier="g_data_output_stream_new">
10238         <doc xml:whitespace="preserve">Creates a new data output stream for @base_stream.</doc>
10239         <return-value transfer-ownership="full">
10240           <doc xml:whitespace="preserve">#GDataOutputStream.</doc>
10241           <type name="DataOutputStream" c:type="GDataOutputStream*"/>
10242         </return-value>
10243         <parameters>
10244           <parameter name="base_stream" transfer-ownership="none">
10245             <doc xml:whitespace="preserve">a #GOutputStream.</doc>
10246             <type name="OutputStream" c:type="GOutputStream*"/>
10247           </parameter>
10248         </parameters>
10249       </constructor>
10250       <method name="get_byte_order"
10251               c:identifier="g_data_output_stream_get_byte_order">
10252         <doc xml:whitespace="preserve">Gets the byte order for the stream.</doc>
10253         <return-value transfer-ownership="none">
10254           <doc xml:whitespace="preserve">the #GDataStreamByteOrder for the @stream.</doc>
10255           <type name="DataStreamByteOrder" c:type="GDataStreamByteOrder"/>
10256         </return-value>
10257       </method>
10258       <method name="put_byte"
10259               c:identifier="g_data_output_stream_put_byte"
10260               throws="1">
10261         <doc xml:whitespace="preserve">Puts a byte into the output stream.</doc>
10262         <return-value transfer-ownership="none">
10263           <doc xml:whitespace="preserve">%TRUE if @data was successfully added to the @stream.</doc>
10264           <type name="gboolean" c:type="gboolean"/>
10265         </return-value>
10266         <parameters>
10267           <parameter name="data" transfer-ownership="none">
10268             <doc xml:whitespace="preserve">a #guchar.</doc>
10269             <type name="guint8" c:type="guchar"/>
10270           </parameter>
10271           <parameter name="cancellable"
10272                      transfer-ownership="none"
10273                      allow-none="1">
10274             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
10275             <type name="Cancellable" c:type="GCancellable*"/>
10276           </parameter>
10277         </parameters>
10278       </method>
10279       <method name="put_int16"
10280               c:identifier="g_data_output_stream_put_int16"
10281               throws="1">
10282         <doc xml:whitespace="preserve">Puts a signed 16-bit integer into the output stream.</doc>
10283         <return-value transfer-ownership="none">
10284           <doc xml:whitespace="preserve">%TRUE if @data was successfully added to the @stream.</doc>
10285           <type name="gboolean" c:type="gboolean"/>
10286         </return-value>
10287         <parameters>
10288           <parameter name="data" transfer-ownership="none">
10289             <doc xml:whitespace="preserve">a #gint16.</doc>
10290             <type name="gint16" c:type="gint16"/>
10291           </parameter>
10292           <parameter name="cancellable"
10293                      transfer-ownership="none"
10294                      allow-none="1">
10295             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
10296             <type name="Cancellable" c:type="GCancellable*"/>
10297           </parameter>
10298         </parameters>
10299       </method>
10300       <method name="put_int32"
10301               c:identifier="g_data_output_stream_put_int32"
10302               throws="1">
10303         <doc xml:whitespace="preserve">Puts a signed 32-bit integer into the output stream.</doc>
10304         <return-value transfer-ownership="none">
10305           <doc xml:whitespace="preserve">%TRUE if @data was successfully added to the @stream.</doc>
10306           <type name="gboolean" c:type="gboolean"/>
10307         </return-value>
10308         <parameters>
10309           <parameter name="data" transfer-ownership="none">
10310             <doc xml:whitespace="preserve">a #gint32.</doc>
10311             <type name="gint32" c:type="gint32"/>
10312           </parameter>
10313           <parameter name="cancellable"
10314                      transfer-ownership="none"
10315                      allow-none="1">
10316             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
10317             <type name="Cancellable" c:type="GCancellable*"/>
10318           </parameter>
10319         </parameters>
10320       </method>
10321       <method name="put_int64"
10322               c:identifier="g_data_output_stream_put_int64"
10323               throws="1">
10324         <doc xml:whitespace="preserve">Puts a signed 64-bit integer into the stream.</doc>
10325         <return-value transfer-ownership="none">
10326           <doc xml:whitespace="preserve">%TRUE if @data was successfully added to the @stream.</doc>
10327           <type name="gboolean" c:type="gboolean"/>
10328         </return-value>
10329         <parameters>
10330           <parameter name="data" transfer-ownership="none">
10331             <doc xml:whitespace="preserve">a #gint64.</doc>
10332             <type name="gint64" c:type="gint64"/>
10333           </parameter>
10334           <parameter name="cancellable"
10335                      transfer-ownership="none"
10336                      allow-none="1">
10337             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
10338             <type name="Cancellable" c:type="GCancellable*"/>
10339           </parameter>
10340         </parameters>
10341       </method>
10342       <method name="put_string"
10343               c:identifier="g_data_output_stream_put_string"
10344               throws="1">
10345         <doc xml:whitespace="preserve">Puts a string into the output stream.</doc>
10346         <return-value transfer-ownership="none">
10347           <doc xml:whitespace="preserve">%TRUE if @string was successfully added to the @stream.</doc>
10348           <type name="gboolean" c:type="gboolean"/>
10349         </return-value>
10350         <parameters>
10351           <parameter name="str" transfer-ownership="none">
10352             <doc xml:whitespace="preserve">a string.</doc>
10353             <type name="utf8" c:type="char*"/>
10354           </parameter>
10355           <parameter name="cancellable"
10356                      transfer-ownership="none"
10357                      allow-none="1">
10358             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
10359             <type name="Cancellable" c:type="GCancellable*"/>
10360           </parameter>
10361         </parameters>
10362       </method>
10363       <method name="put_uint16"
10364               c:identifier="g_data_output_stream_put_uint16"
10365               throws="1">
10366         <doc xml:whitespace="preserve">Puts an unsigned 16-bit integer into the output stream.</doc>
10367         <return-value transfer-ownership="none">
10368           <doc xml:whitespace="preserve">%TRUE if @data was successfully added to the @stream.</doc>
10369           <type name="gboolean" c:type="gboolean"/>
10370         </return-value>
10371         <parameters>
10372           <parameter name="data" transfer-ownership="none">
10373             <doc xml:whitespace="preserve">a #guint16.</doc>
10374             <type name="guint16" c:type="guint16"/>
10375           </parameter>
10376           <parameter name="cancellable"
10377                      transfer-ownership="none"
10378                      allow-none="1">
10379             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
10380             <type name="Cancellable" c:type="GCancellable*"/>
10381           </parameter>
10382         </parameters>
10383       </method>
10384       <method name="put_uint32"
10385               c:identifier="g_data_output_stream_put_uint32"
10386               throws="1">
10387         <doc xml:whitespace="preserve">Puts an unsigned 32-bit integer into the stream.</doc>
10388         <return-value transfer-ownership="none">
10389           <doc xml:whitespace="preserve">%TRUE if @data was successfully added to the @stream.</doc>
10390           <type name="gboolean" c:type="gboolean"/>
10391         </return-value>
10392         <parameters>
10393           <parameter name="data" transfer-ownership="none">
10394             <doc xml:whitespace="preserve">a #guint32.</doc>
10395             <type name="guint32" c:type="guint32"/>
10396           </parameter>
10397           <parameter name="cancellable"
10398                      transfer-ownership="none"
10399                      allow-none="1">
10400             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
10401             <type name="Cancellable" c:type="GCancellable*"/>
10402           </parameter>
10403         </parameters>
10404       </method>
10405       <method name="put_uint64"
10406               c:identifier="g_data_output_stream_put_uint64"
10407               throws="1">
10408         <doc xml:whitespace="preserve">Puts an unsigned 64-bit integer into the stream.</doc>
10409         <return-value transfer-ownership="none">
10410           <doc xml:whitespace="preserve">%TRUE if @data was successfully added to the @stream.</doc>
10411           <type name="gboolean" c:type="gboolean"/>
10412         </return-value>
10413         <parameters>
10414           <parameter name="data" transfer-ownership="none">
10415             <doc xml:whitespace="preserve">a #guint64.</doc>
10416             <type name="guint64" c:type="guint64"/>
10417           </parameter>
10418           <parameter name="cancellable"
10419                      transfer-ownership="none"
10420                      allow-none="1">
10421             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
10422             <type name="Cancellable" c:type="GCancellable*"/>
10423           </parameter>
10424         </parameters>
10425       </method>
10426       <method name="set_byte_order"
10427               c:identifier="g_data_output_stream_set_byte_order">
10428         <doc xml:whitespace="preserve">Sets the byte order of the data output stream to @order.</doc>
10429         <return-value transfer-ownership="none">
10430           <type name="none" c:type="void"/>
10431         </return-value>
10432         <parameters>
10433           <parameter name="order" transfer-ownership="none">
10434             <doc xml:whitespace="preserve">a %GDataStreamByteOrder.</doc>
10435             <type name="DataStreamByteOrder" c:type="GDataStreamByteOrder"/>
10436           </parameter>
10437         </parameters>
10438       </method>
10439       <property name="byte-order" writable="1" transfer-ownership="none">
10440         <doc xml:whitespace="preserve">Determines the byte ordering that is used when writing
10441 multi-byte entities (such as integers) to the stream.</doc>
10442         <type name="DataStreamByteOrder"/>
10443       </property>
10444       <field name="parent_instance">
10445         <type name="FilterOutputStream" c:type="GFilterOutputStream"/>
10446       </field>
10447       <field name="priv">
10448         <type name="DataOutputStreamPrivate"
10449               c:type="GDataOutputStreamPrivate*"/>
10450       </field>
10451     </class>
10452     <record name="DataOutputStreamClass"
10453             c:type="GDataOutputStreamClass"
10454             glib:is-gtype-struct-for="DataOutputStream">
10455       <field name="parent_class">
10456         <type name="FilterOutputStreamClass"
10457               c:type="GFilterOutputStreamClass"/>
10458       </field>
10459       <field name="_g_reserved1" introspectable="0">
10460         <callback name="_g_reserved1">
10461           <return-value transfer-ownership="none">
10462             <type name="none" c:type="void"/>
10463           </return-value>
10464         </callback>
10465       </field>
10466       <field name="_g_reserved2" introspectable="0">
10467         <callback name="_g_reserved2">
10468           <return-value transfer-ownership="none">
10469             <type name="none" c:type="void"/>
10470           </return-value>
10471         </callback>
10472       </field>
10473       <field name="_g_reserved3" introspectable="0">
10474         <callback name="_g_reserved3">
10475           <return-value transfer-ownership="none">
10476             <type name="none" c:type="void"/>
10477           </return-value>
10478         </callback>
10479       </field>
10480       <field name="_g_reserved4" introspectable="0">
10481         <callback name="_g_reserved4">
10482           <return-value transfer-ownership="none">
10483             <type name="none" c:type="void"/>
10484           </return-value>
10485         </callback>
10486       </field>
10487       <field name="_g_reserved5" introspectable="0">
10488         <callback name="_g_reserved5">
10489           <return-value transfer-ownership="none">
10490             <type name="none" c:type="void"/>
10491           </return-value>
10492         </callback>
10493       </field>
10494     </record>
10495     <record name="DataOutputStreamPrivate"
10496             c:type="GDataOutputStreamPrivate"
10497             disguised="1">
10498     </record>
10499     <enumeration name="DataStreamByteOrder"
10500                  glib:type-name="GDataStreamByteOrder"
10501                  glib:get-type="g_data_stream_byte_order_get_type"
10502                  c:type="GDataStreamByteOrder">
10503       <doc xml:whitespace="preserve">#GDataStreamByteOrder is used to ensure proper endianness of streaming data sources
10504 across various machine architectures.</doc>
10505       <member name="big_endian"
10506               value="0"
10507               c:identifier="G_DATA_STREAM_BYTE_ORDER_BIG_ENDIAN"
10508               glib:nick="big-endian"/>
10509       <member name="little_endian"
10510               value="1"
10511               c:identifier="G_DATA_STREAM_BYTE_ORDER_LITTLE_ENDIAN"
10512               glib:nick="little-endian"/>
10513       <member name="host_endian"
10514               value="2"
10515               c:identifier="G_DATA_STREAM_BYTE_ORDER_HOST_ENDIAN"
10516               glib:nick="host-endian"/>
10517     </enumeration>
10518     <enumeration name="DataStreamNewlineType"
10519                  glib:type-name="GDataStreamNewlineType"
10520                  glib:get-type="g_data_stream_newline_type_get_type"
10521                  c:type="GDataStreamNewlineType">
10522       <doc xml:whitespace="preserve">#GDataStreamNewlineType is used when checking for or setting the line endings for a given file.</doc>
10523       <member name="lf"
10524               value="0"
10525               c:identifier="G_DATA_STREAM_NEWLINE_TYPE_LF"
10526               glib:nick="lf"/>
10527       <member name="cr"
10528               value="1"
10529               c:identifier="G_DATA_STREAM_NEWLINE_TYPE_CR"
10530               glib:nick="cr"/>
10531       <member name="cr_lf"
10532               value="2"
10533               c:identifier="G_DATA_STREAM_NEWLINE_TYPE_CR_LF"
10534               glib:nick="cr-lf"/>
10535       <member name="any"
10536               value="3"
10537               c:identifier="G_DATA_STREAM_NEWLINE_TYPE_ANY"
10538               glib:nick="any"/>
10539     </enumeration>
10540     <class name="DesktopAppInfo"
10541            c:symbol-prefix="desktop_app_info"
10542            c:type="GDesktopAppInfo"
10543            parent="GObject.Object"
10544            glib:type-name="GDesktopAppInfo"
10545            glib:get-type="g_desktop_app_info_get_type"
10546            glib:type-struct="DesktopAppInfoClass">
10547       <doc xml:whitespace="preserve">Information about an installed application from a desktop file.</doc>
10548       <implements name="AppInfo"/>
10549       <constructor name="new" c:identifier="g_desktop_app_info_new">
10550         <doc xml:whitespace="preserve">Creates a new #GDesktopAppInfo based on a desktop file id.
10551 A desktop file id is the basename of the desktop file, including the
10552 .desktop extension. GIO is looking for a desktop file with this name
10553 in the &lt;filename&gt;applications&lt;/filename&gt; subdirectories of the XDG data
10554 directories (i.e. the directories specified in the
10555 &lt;envar&gt;XDG_DATA_HOME&lt;/envar&gt; and &lt;envar&gt;XDG_DATA_DIRS&lt;/envar&gt; environment
10556 variables). GIO also supports the prefix-to-subdirectory mapping that is
10557 described in the &lt;ulink url="http://standards.freedesktop.org/menu-spec/latest/"&gt;Menu Spec&lt;/ulink&gt;
10558 (i.e. a desktop id of kde-foo.desktop will match
10559 &lt;filename&gt;/usr/share/applications/kde/foo.desktop&lt;/filename&gt;).</doc>
10560         <return-value transfer-ownership="full">
10561           <doc xml:whitespace="preserve">a new #GDesktopAppInfo, or %NULL if no desktop file with that id</doc>
10562           <type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
10563         </return-value>
10564         <parameters>
10565           <parameter name="desktop_id" transfer-ownership="none">
10566             <doc xml:whitespace="preserve">the desktop file id</doc>
10567             <type name="utf8" c:type="char*"/>
10568           </parameter>
10569         </parameters>
10570       </constructor>
10571       <constructor name="new_from_filename"
10572                    c:identifier="g_desktop_app_info_new_from_filename">
10573         <doc xml:whitespace="preserve">Creates a new #GDesktopAppInfo.</doc>
10574         <return-value transfer-ownership="full">
10575           <doc xml:whitespace="preserve">a new #GDesktopAppInfo or %NULL on error.</doc>
10576           <type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
10577         </return-value>
10578         <parameters>
10579           <parameter name="filename" transfer-ownership="none">
10580             <doc xml:whitespace="preserve">the path of a desktop file, in the GLib filename encoding</doc>
10581             <type name="utf8" c:type="char*"/>
10582           </parameter>
10583         </parameters>
10584       </constructor>
10585       <constructor name="new_from_keyfile"
10586                    c:identifier="g_desktop_app_info_new_from_keyfile"
10587                    version="2.18">
10588         <doc xml:whitespace="preserve">Creates a new #GDesktopAppInfo.</doc>
10589         <return-value transfer-ownership="full">
10590           <doc xml:whitespace="preserve">a new #GDesktopAppInfo or %NULL on error.</doc>
10591           <type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
10592         </return-value>
10593         <parameters>
10594           <parameter name="key_file" transfer-ownership="none">
10595             <doc xml:whitespace="preserve">an opened #GKeyFile</doc>
10596             <type name="GLib.KeyFile" c:type="GKeyFile*"/>
10597           </parameter>
10598         </parameters>
10599       </constructor>
10600       <function name="set_desktop_env"
10601                 c:identifier="g_desktop_app_info_set_desktop_env">
10602         <doc xml:whitespace="preserve">Sets the name of the desktop that the application is running in.
10603 This is used by g_app_info_should_show() to evaluate the
10604 &lt;literal&gt;OnlyShowIn&lt;/literal&gt; and &lt;literal&gt;NotShowIn&lt;/literal&gt;
10605 desktop entry fields.
10606 The &lt;ulink url="http://standards.freedesktop.org/menu-spec/latest/"&gt;Desktop
10607 Menu specification&lt;/ulink&gt; recognizes the following:
10608 &lt;simplelist&gt;
10609 &lt;member&gt;GNOME&lt;/member&gt;
10610 &lt;member&gt;KDE&lt;/member&gt;
10611 &lt;member&gt;ROX&lt;/member&gt;
10612 &lt;member&gt;XFCE&lt;/member&gt;
10613 &lt;member&gt;Old&lt;/member&gt;
10614 &lt;/simplelist&gt;
10615 Should be called only once; subsequent calls are ignored.</doc>
10616         <return-value transfer-ownership="none">
10617           <type name="none" c:type="void"/>
10618         </return-value>
10619         <parameters>
10620           <parameter name="desktop_env" transfer-ownership="none">
10621             <doc xml:whitespace="preserve">a string specifying what desktop this is</doc>
10622             <type name="utf8" c:type="char*"/>
10623           </parameter>
10624         </parameters>
10625       </function>
10626       <method name="get_filename"
10627               c:identifier="g_desktop_app_info_get_filename"
10628               version="2.24">
10629         <doc xml:whitespace="preserve">When @info was created from a known filename, return it.  In some
10630 situations such as the #GDesktopAppInfo returned from
10631 g_desktop_app_info_new_from_keyfile(), this function will return %NULL.</doc>
10632         <return-value transfer-ownership="none">
10633           <doc xml:whitespace="preserve">The full path to the file for @info, or %NULL if not known.</doc>
10634           <type name="utf8" c:type="char*"/>
10635         </return-value>
10636       </method>
10637       <method name="get_is_hidden"
10638               c:identifier="g_desktop_app_info_get_is_hidden">
10639         <doc xml:whitespace="preserve">A desktop file is hidden if the Hidden key in it is
10640 set to True.</doc>
10641         <return-value transfer-ownership="none">
10642           <doc xml:whitespace="preserve">%TRUE if hidden, %FALSE otherwise.</doc>
10643           <type name="gboolean" c:type="gboolean"/>
10644         </return-value>
10645       </method>
10646     </class>
10647     <record name="DesktopAppInfoClass"
10648             c:type="GDesktopAppInfoClass"
10649             glib:is-gtype-struct-for="DesktopAppInfo">
10650       <field name="parent_class">
10651         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
10652       </field>
10653     </record>
10654     <interface name="DesktopAppInfoLookup"
10655                c:symbol-prefix="desktop_app_info_lookup"
10656                c:type="GDesktopAppInfoLookup"
10657                glib:type-name="GDesktopAppInfoLookup"
10658                glib:get-type="g_desktop_app_info_lookup_get_type"
10659                glib:type-struct="DesktopAppInfoLookupIface">
10660       <doc xml:whitespace="preserve">Interface that is used by backends to associate default
10661 handlers with URI schemes.</doc>
10662       <virtual-method name="get_default_for_uri_scheme"
10663                       invoker="get_default_for_uri_scheme">
10664         <doc xml:whitespace="preserve">Gets the default application for launching applications
10665 using this URI scheme for a particular GDesktopAppInfoLookup
10666 implementation.
10667 The GDesktopAppInfoLookup interface and this function is used
10668 to implement g_app_info_get_default_for_uri_scheme() backends
10669 in a GIO module. There is no reason for applications to use it
10670 directly. Applications should use g_app_info_get_default_for_uri_scheme().</doc>
10671         <return-value transfer-ownership="full">
10672           <doc xml:whitespace="preserve">#GAppInfo for given @uri_scheme or %NULL on error.</doc>
10673           <type name="AppInfo" c:type="GAppInfo*"/>
10674         </return-value>
10675         <parameters>
10676           <parameter name="uri_scheme" transfer-ownership="none">
10677             <doc xml:whitespace="preserve">a string containing a URI scheme.</doc>
10678             <type name="utf8" c:type="char*"/>
10679           </parameter>
10680         </parameters>
10681       </virtual-method>
10682       <method name="get_default_for_uri_scheme"
10683               c:identifier="g_desktop_app_info_lookup_get_default_for_uri_scheme">
10684         <doc xml:whitespace="preserve">Gets the default application for launching applications
10685 using this URI scheme for a particular GDesktopAppInfoLookup
10686 implementation.
10687 The GDesktopAppInfoLookup interface and this function is used
10688 to implement g_app_info_get_default_for_uri_scheme() backends
10689 in a GIO module. There is no reason for applications to use it
10690 directly. Applications should use g_app_info_get_default_for_uri_scheme().</doc>
10691         <return-value transfer-ownership="full">
10692           <doc xml:whitespace="preserve">#GAppInfo for given @uri_scheme or %NULL on error.</doc>
10693           <type name="AppInfo" c:type="GAppInfo*"/>
10694         </return-value>
10695         <parameters>
10696           <parameter name="uri_scheme" transfer-ownership="none">
10697             <doc xml:whitespace="preserve">a string containing a URI scheme.</doc>
10698             <type name="utf8" c:type="char*"/>
10699           </parameter>
10700         </parameters>
10701       </method>
10702     </interface>
10703     <record name="DesktopAppInfoLookupIface"
10704             c:type="GDesktopAppInfoLookupIface"
10705             glib:is-gtype-struct-for="DesktopAppInfoLookup">
10706       <field name="g_iface">
10707         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
10708       </field>
10709       <field name="get_default_for_uri_scheme">
10710         <callback name="get_default_for_uri_scheme">
10711           <return-value transfer-ownership="full">
10712             <doc xml:whitespace="preserve">#GAppInfo for given @uri_scheme or %NULL on error.</doc>
10713             <type name="AppInfo" c:type="GAppInfo*"/>
10714           </return-value>
10715           <parameters>
10716             <parameter name="lookup" transfer-ownership="none">
10717               <type name="DesktopAppInfoLookup"
10718                     c:type="GDesktopAppInfoLookup*"/>
10719             </parameter>
10720             <parameter name="uri_scheme" transfer-ownership="none">
10721               <doc xml:whitespace="preserve">a string containing a URI scheme.</doc>
10722               <type name="utf8" c:type="char*"/>
10723             </parameter>
10724           </parameters>
10725         </callback>
10726       </field>
10727     </record>
10728     <interface name="Drive"
10729                c:symbol-prefix="drive"
10730                c:type="GDrive"
10731                glib:type-name="GDrive"
10732                glib:get-type="g_drive_get_type"
10733                glib:type-struct="DriveIface">
10734       <doc xml:whitespace="preserve">Opaque drive object.</doc>
10735       <virtual-method name="can_eject" invoker="can_eject">
10736         <doc xml:whitespace="preserve">Checks if a drive can be ejected.</doc>
10737         <return-value transfer-ownership="none">
10738           <doc xml:whitespace="preserve">%TRUE if the @drive can be ejected, %FALSE otherwise.</doc>
10739           <type name="gboolean" c:type="gboolean"/>
10740         </return-value>
10741       </virtual-method>
10742       <virtual-method name="can_poll_for_media" invoker="can_poll_for_media">
10743         <doc xml:whitespace="preserve">Checks if a drive can be polled for media changes.
10744 %FALSE otherwise.</doc>
10745         <return-value transfer-ownership="none">
10746           <doc xml:whitespace="preserve">%TRUE if the @drive can be polled for media changes,</doc>
10747           <type name="gboolean" c:type="gboolean"/>
10748         </return-value>
10749       </virtual-method>
10750       <virtual-method name="can_start" invoker="can_start" version="2.22">
10751         <doc xml:whitespace="preserve">Checks if a drive can be started.</doc>
10752         <return-value transfer-ownership="none">
10753           <doc xml:whitespace="preserve">%TRUE if the @drive can be started, %FALSE otherwise.</doc>
10754           <type name="gboolean" c:type="gboolean"/>
10755         </return-value>
10756       </virtual-method>
10757       <virtual-method name="can_start_degraded"
10758                       invoker="can_start_degraded"
10759                       version="2.22">
10760         <doc xml:whitespace="preserve">Checks if a drive can be started degraded.</doc>
10761         <return-value transfer-ownership="none">
10762           <doc xml:whitespace="preserve">%TRUE if the @drive can be started degraded, %FALSE otherwise.</doc>
10763           <type name="gboolean" c:type="gboolean"/>
10764         </return-value>
10765       </virtual-method>
10766       <virtual-method name="can_stop" invoker="can_stop" version="2.22">
10767         <doc xml:whitespace="preserve">Checks if a drive can be stopped.</doc>
10768         <return-value transfer-ownership="none">
10769           <doc xml:whitespace="preserve">%TRUE if the @drive can be stopped, %FALSE otherwise.</doc>
10770           <type name="gboolean" c:type="gboolean"/>
10771         </return-value>
10772       </virtual-method>
10773       <virtual-method name="eject"
10774                       invoker="eject"
10775                       deprecated="Use g_drive_eject_with_operation() instead."
10776                       deprecated-version="2.22">
10777         <doc xml:whitespace="preserve">Asynchronously ejects a drive.
10778 When the operation is finished, @callback will be called.
10779 You can then call g_drive_eject_finish() to obtain the
10780 result of the operation.</doc>
10781         <return-value transfer-ownership="none">
10782           <type name="none" c:type="void"/>
10783         </return-value>
10784         <parameters>
10785           <parameter name="flags" transfer-ownership="none">
10786             <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
10787             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
10788           </parameter>
10789           <parameter name="cancellable"
10790                      transfer-ownership="none"
10791                      allow-none="1">
10792             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
10793             <type name="Cancellable" c:type="GCancellable*"/>
10794           </parameter>
10795           <parameter name="callback"
10796                      transfer-ownership="none"
10797                      scope="async"
10798                      closure="3">
10799             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
10800             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
10801           </parameter>
10802           <parameter name="user_data" transfer-ownership="none" closure="3">
10803             <doc xml:whitespace="preserve">user data to pass to @callback</doc>
10804             <type name="gpointer" c:type="gpointer"/>
10805           </parameter>
10806         </parameters>
10807       </virtual-method>
10808       <virtual-method name="eject_finish"
10809                       invoker="eject_finish"
10810                       deprecated="Use g_drive_eject_with_operation_finish() instead."
10811                       deprecated-version="2.22"
10812                       throws="1">
10813         <doc xml:whitespace="preserve">Finishes ejecting a drive.
10814 %FALSE otherwise.</doc>
10815         <return-value transfer-ownership="none">
10816           <doc xml:whitespace="preserve">%TRUE if the drive has been ejected successfully,</doc>
10817           <type name="gboolean" c:type="gboolean"/>
10818         </return-value>
10819         <parameters>
10820           <parameter name="result" transfer-ownership="none">
10821             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
10822             <type name="AsyncResult" c:type="GAsyncResult*"/>
10823           </parameter>
10824         </parameters>
10825       </virtual-method>
10826       <virtual-method name="eject_with_operation"
10827                       invoker="eject_with_operation"
10828                       version="2.22">
10829         <doc xml:whitespace="preserve">Ejects a drive. This is an asynchronous operation, and is
10830 finished by calling g_drive_eject_with_operation_finish() with the @drive
10831 and #GAsyncResult data returned in the @callback.</doc>
10832         <return-value transfer-ownership="none">
10833           <type name="none" c:type="void"/>
10834         </return-value>
10835         <parameters>
10836           <parameter name="flags" transfer-ownership="none">
10837             <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
10838             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
10839           </parameter>
10840           <parameter name="mount_operation" transfer-ownership="none">
10841             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
10842             <type name="MountOperation" c:type="GMountOperation*"/>
10843           </parameter>
10844           <parameter name="cancellable"
10845                      transfer-ownership="none"
10846                      allow-none="1">
10847             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
10848             <type name="Cancellable" c:type="GCancellable*"/>
10849           </parameter>
10850           <parameter name="callback"
10851                      transfer-ownership="none"
10852                      scope="async"
10853                      closure="4">
10854             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
10855             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
10856           </parameter>
10857           <parameter name="user_data" transfer-ownership="none" closure="4">
10858             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
10859             <type name="gpointer" c:type="gpointer"/>
10860           </parameter>
10861         </parameters>
10862       </virtual-method>
10863       <virtual-method name="eject_with_operation_finish"
10864                       invoker="eject_with_operation_finish"
10865                       version="2.22"
10866                       throws="1">
10867         <doc xml:whitespace="preserve">Finishes ejecting a drive. If any errors occurred during the operation,</doc>
10868         <return-value transfer-ownership="none">
10869           <doc xml:whitespace="preserve">%TRUE if the drive was successfully ejected. %FALSE otherwise.</doc>
10870           <type name="gboolean" c:type="gboolean"/>
10871         </return-value>
10872         <parameters>
10873           <parameter name="result" transfer-ownership="none">
10874             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
10875             <type name="AsyncResult" c:type="GAsyncResult*"/>
10876           </parameter>
10877         </parameters>
10878       </virtual-method>
10879       <virtual-method name="enumerate_identifiers"
10880                       invoker="enumerate_identifiers">
10881         <doc xml:whitespace="preserve">Gets the kinds of identifiers that @drive has.
10882 Use g_drive_get_identifer() to obtain the identifiers
10883 themselves.
10884 kinds of identifiers. Use g_strfreev() to free.</doc>
10885         <return-value transfer-ownership="full">
10886           <doc xml:whitespace="preserve">a %NULL-terminated array of strings containing</doc>
10887           <array c:type="char**">
10888             <type name="utf8"/>
10889           </array>
10890         </return-value>
10891       </virtual-method>
10892       <virtual-method name="get_icon" invoker="get_icon">
10893         <doc xml:whitespace="preserve">Gets the icon for @drive.
10894 Free the returned object with g_object_unref().</doc>
10895         <return-value transfer-ownership="full">
10896           <doc xml:whitespace="preserve">#GIcon for the @drive.</doc>
10897           <type name="Icon" c:type="GIcon*"/>
10898         </return-value>
10899       </virtual-method>
10900       <virtual-method name="get_identifier" invoker="get_identifier">
10901         <doc xml:whitespace="preserve">Gets the identifier of the given kind for @drive.
10902 requested identfier, or %NULL if the #GDrive
10903 doesn't have this kind of identifier.</doc>
10904         <return-value transfer-ownership="full">
10905           <doc xml:whitespace="preserve">a newly allocated string containing the</doc>
10906           <type name="utf8" c:type="char*"/>
10907         </return-value>
10908         <parameters>
10909           <parameter name="kind" transfer-ownership="none">
10910             <doc xml:whitespace="preserve">the kind of identifier to return</doc>
10911             <type name="utf8" c:type="char*"/>
10912           </parameter>
10913         </parameters>
10914       </virtual-method>
10915       <virtual-method name="get_name" invoker="get_name">
10916         <doc xml:whitespace="preserve">Gets the name of @drive.
10917 string should be freed when no longer needed.</doc>
10918         <return-value transfer-ownership="full">
10919           <doc xml:whitespace="preserve">a string containing @drive's name. The returned</doc>
10920           <type name="utf8" c:type="char*"/>
10921         </return-value>
10922       </virtual-method>
10923       <virtual-method name="get_start_stop_type"
10924                       invoker="get_start_stop_type"
10925                       version="2.22">
10926         <doc xml:whitespace="preserve">Gets a hint about how a drive can be started/stopped.</doc>
10927         <return-value transfer-ownership="none">
10928           <doc xml:whitespace="preserve">A value from the #GDriveStartStopType enumeration.</doc>
10929           <type name="DriveStartStopType" c:type="GDriveStartStopType"/>
10930         </return-value>
10931       </virtual-method>
10932       <virtual-method name="get_volumes" invoker="get_volumes">
10933         <doc xml:whitespace="preserve">Get a list of mountable volumes for @drive.
10934 The returned list should be freed with g_list_free(), after
10935 its elements have been unreffed with g_object_unref().</doc>
10936         <return-value transfer-ownership="full">
10937           <doc xml:whitespace="preserve">#GList containing any #GVolume objects on the given @drive.</doc>
10938           <type name="GLib.List" c:type="GList*">
10939             <type name="Volume"/>
10940           </type>
10941         </return-value>
10942       </virtual-method>
10943       <virtual-method name="has_media" invoker="has_media">
10944         <doc xml:whitespace="preserve">Checks if the @drive has media. Note that the OS may not be polling
10945 the drive for media changes; see g_drive_is_media_check_automatic()
10946 for more details.</doc>
10947         <return-value transfer-ownership="none">
10948           <doc xml:whitespace="preserve">%TRUE if @drive has media, %FALSE otherwise.</doc>
10949           <type name="gboolean" c:type="gboolean"/>
10950         </return-value>
10951       </virtual-method>
10952       <virtual-method name="has_volumes" invoker="has_volumes">
10953         <doc xml:whitespace="preserve">Check if @drive has any mountable volumes.</doc>
10954         <return-value transfer-ownership="none">
10955           <doc xml:whitespace="preserve">%TRUE if the @drive contains volumes, %FALSE otherwise.</doc>
10956           <type name="gboolean" c:type="gboolean"/>
10957         </return-value>
10958       </virtual-method>
10959       <virtual-method name="is_media_check_automatic"
10960                       invoker="is_media_check_automatic">
10961         <doc xml:whitespace="preserve">Checks if @drive is capabable of automatically detecting media changes.
10962 media changes, %FALSE otherwise.</doc>
10963         <return-value transfer-ownership="none">
10964           <doc xml:whitespace="preserve">%TRUE if the @drive is capabable of automatically detecting</doc>
10965           <type name="gboolean" c:type="gboolean"/>
10966         </return-value>
10967       </virtual-method>
10968       <virtual-method name="is_media_removable" invoker="is_media_removable">
10969         <doc xml:whitespace="preserve">Checks if the @drive supports removable media.</doc>
10970         <return-value transfer-ownership="none">
10971           <doc xml:whitespace="preserve">%TRUE if @drive supports removable media, %FALSE otherwise.</doc>
10972           <type name="gboolean" c:type="gboolean"/>
10973         </return-value>
10974       </virtual-method>
10975       <virtual-method name="poll_for_media" invoker="poll_for_media">
10976         <doc xml:whitespace="preserve">Asynchronously polls @drive to see if media has been inserted or removed.
10977 When the operation is finished, @callback will be called.
10978 You can then call g_drive_poll_for_media_finish() to obtain the
10979 result of the operation.</doc>
10980         <return-value transfer-ownership="none">
10981           <type name="none" c:type="void"/>
10982         </return-value>
10983         <parameters>
10984           <parameter name="cancellable"
10985                      transfer-ownership="none"
10986                      allow-none="1">
10987             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
10988             <type name="Cancellable" c:type="GCancellable*"/>
10989           </parameter>
10990           <parameter name="callback"
10991                      transfer-ownership="none"
10992                      scope="async"
10993                      closure="2">
10994             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
10995             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
10996           </parameter>
10997           <parameter name="user_data" transfer-ownership="none" closure="2">
10998             <doc xml:whitespace="preserve">user data to pass to @callback</doc>
10999             <type name="gpointer" c:type="gpointer"/>
11000           </parameter>
11001         </parameters>
11002       </virtual-method>
11003       <virtual-method name="poll_for_media_finish"
11004                       invoker="poll_for_media_finish"
11005                       throws="1">
11006         <doc xml:whitespace="preserve">Finishes an operation started with g_drive_poll_for_media() on a drive.
11007 %FALSE otherwise.</doc>
11008         <return-value transfer-ownership="none">
11009           <doc xml:whitespace="preserve">%TRUE if the drive has been poll_for_mediaed successfully,</doc>
11010           <type name="gboolean" c:type="gboolean"/>
11011         </return-value>
11012         <parameters>
11013           <parameter name="result" transfer-ownership="none">
11014             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
11015             <type name="AsyncResult" c:type="GAsyncResult*"/>
11016           </parameter>
11017         </parameters>
11018       </virtual-method>
11019       <virtual-method name="start" invoker="start" version="2.22">
11020         <doc xml:whitespace="preserve">Asynchronously starts a drive.
11021 When the operation is finished, @callback will be called.
11022 You can then call g_drive_start_finish() to obtain the
11023 result of the operation.</doc>
11024         <return-value transfer-ownership="none">
11025           <type name="none" c:type="void"/>
11026         </return-value>
11027         <parameters>
11028           <parameter name="flags" transfer-ownership="none">
11029             <doc xml:whitespace="preserve">flags affecting the start operation.</doc>
11030             <type name="DriveStartFlags" c:type="GDriveStartFlags"/>
11031           </parameter>
11032           <parameter name="mount_operation" transfer-ownership="none">
11033             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
11034             <type name="MountOperation" c:type="GMountOperation*"/>
11035           </parameter>
11036           <parameter name="cancellable"
11037                      transfer-ownership="none"
11038                      allow-none="1">
11039             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
11040             <type name="Cancellable" c:type="GCancellable*"/>
11041           </parameter>
11042           <parameter name="callback"
11043                      transfer-ownership="none"
11044                      scope="async"
11045                      closure="4">
11046             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
11047             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
11048           </parameter>
11049           <parameter name="user_data" transfer-ownership="none" closure="4">
11050             <doc xml:whitespace="preserve">user data to pass to @callback</doc>
11051             <type name="gpointer" c:type="gpointer"/>
11052           </parameter>
11053         </parameters>
11054       </virtual-method>
11055       <virtual-method name="start_finish"
11056                       invoker="start_finish"
11057                       version="2.22"
11058                       throws="1">
11059         <doc xml:whitespace="preserve">Finishes starting a drive.
11060 %FALSE otherwise.</doc>
11061         <return-value transfer-ownership="none">
11062           <doc xml:whitespace="preserve">%TRUE if the drive has been started successfully,</doc>
11063           <type name="gboolean" c:type="gboolean"/>
11064         </return-value>
11065         <parameters>
11066           <parameter name="result" transfer-ownership="none">
11067             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
11068             <type name="AsyncResult" c:type="GAsyncResult*"/>
11069           </parameter>
11070         </parameters>
11071       </virtual-method>
11072       <virtual-method name="stop" invoker="stop" version="2.22">
11073         <doc xml:whitespace="preserve">Asynchronously stops a drive.
11074 When the operation is finished, @callback will be called.
11075 You can then call g_drive_stop_finish() to obtain the
11076 result of the operation.</doc>
11077         <return-value transfer-ownership="none">
11078           <type name="none" c:type="void"/>
11079         </return-value>
11080         <parameters>
11081           <parameter name="flags" transfer-ownership="none">
11082             <doc xml:whitespace="preserve">flags affecting the unmount if required for stopping.</doc>
11083             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
11084           </parameter>
11085           <parameter name="mount_operation" transfer-ownership="none">
11086             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
11087             <type name="MountOperation" c:type="GMountOperation*"/>
11088           </parameter>
11089           <parameter name="cancellable"
11090                      transfer-ownership="none"
11091                      allow-none="1">
11092             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
11093             <type name="Cancellable" c:type="GCancellable*"/>
11094           </parameter>
11095           <parameter name="callback"
11096                      transfer-ownership="none"
11097                      scope="async"
11098                      closure="4">
11099             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
11100             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
11101           </parameter>
11102           <parameter name="user_data" transfer-ownership="none" closure="4">
11103             <doc xml:whitespace="preserve">user data to pass to @callback</doc>
11104             <type name="gpointer" c:type="gpointer"/>
11105           </parameter>
11106         </parameters>
11107       </virtual-method>
11108       <virtual-method name="stop_finish"
11109                       invoker="stop_finish"
11110                       version="2.22"
11111                       throws="1">
11112         <doc xml:whitespace="preserve">Finishes stopping a drive.
11113 %FALSE otherwise.</doc>
11114         <return-value transfer-ownership="none">
11115           <doc xml:whitespace="preserve">%TRUE if the drive has been stopped successfully,</doc>
11116           <type name="gboolean" c:type="gboolean"/>
11117         </return-value>
11118         <parameters>
11119           <parameter name="result" transfer-ownership="none">
11120             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
11121             <type name="AsyncResult" c:type="GAsyncResult*"/>
11122           </parameter>
11123         </parameters>
11124       </virtual-method>
11125       <method name="can_eject" c:identifier="g_drive_can_eject">
11126         <doc xml:whitespace="preserve">Checks if a drive can be ejected.</doc>
11127         <return-value transfer-ownership="none">
11128           <doc xml:whitespace="preserve">%TRUE if the @drive can be ejected, %FALSE otherwise.</doc>
11129           <type name="gboolean" c:type="gboolean"/>
11130         </return-value>
11131       </method>
11132       <method name="can_poll_for_media"
11133               c:identifier="g_drive_can_poll_for_media">
11134         <doc xml:whitespace="preserve">Checks if a drive can be polled for media changes.
11135 %FALSE otherwise.</doc>
11136         <return-value transfer-ownership="none">
11137           <doc xml:whitespace="preserve">%TRUE if the @drive can be polled for media changes,</doc>
11138           <type name="gboolean" c:type="gboolean"/>
11139         </return-value>
11140       </method>
11141       <method name="can_start" c:identifier="g_drive_can_start" version="2.22">
11142         <doc xml:whitespace="preserve">Checks if a drive can be started.</doc>
11143         <return-value transfer-ownership="none">
11144           <doc xml:whitespace="preserve">%TRUE if the @drive can be started, %FALSE otherwise.</doc>
11145           <type name="gboolean" c:type="gboolean"/>
11146         </return-value>
11147       </method>
11148       <method name="can_start_degraded"
11149               c:identifier="g_drive_can_start_degraded"
11150               version="2.22">
11151         <doc xml:whitespace="preserve">Checks if a drive can be started degraded.</doc>
11152         <return-value transfer-ownership="none">
11153           <doc xml:whitespace="preserve">%TRUE if the @drive can be started degraded, %FALSE otherwise.</doc>
11154           <type name="gboolean" c:type="gboolean"/>
11155         </return-value>
11156       </method>
11157       <method name="can_stop" c:identifier="g_drive_can_stop" version="2.22">
11158         <doc xml:whitespace="preserve">Checks if a drive can be stopped.</doc>
11159         <return-value transfer-ownership="none">
11160           <doc xml:whitespace="preserve">%TRUE if the @drive can be stopped, %FALSE otherwise.</doc>
11161           <type name="gboolean" c:type="gboolean"/>
11162         </return-value>
11163       </method>
11164       <method name="eject"
11165               c:identifier="g_drive_eject"
11166               deprecated="Use g_drive_eject_with_operation() instead."
11167               deprecated-version="2.22">
11168         <doc xml:whitespace="preserve">Asynchronously ejects a drive.
11169 When the operation is finished, @callback will be called.
11170 You can then call g_drive_eject_finish() to obtain the
11171 result of the operation.</doc>
11172         <return-value transfer-ownership="none">
11173           <type name="none" c:type="void"/>
11174         </return-value>
11175         <parameters>
11176           <parameter name="flags" transfer-ownership="none">
11177             <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
11178             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
11179           </parameter>
11180           <parameter name="cancellable"
11181                      transfer-ownership="none"
11182                      allow-none="1">
11183             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
11184             <type name="Cancellable" c:type="GCancellable*"/>
11185           </parameter>
11186           <parameter name="callback"
11187                      transfer-ownership="none"
11188                      scope="async"
11189                      closure="3">
11190             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
11191             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
11192           </parameter>
11193           <parameter name="user_data" transfer-ownership="none">
11194             <doc xml:whitespace="preserve">user data to pass to @callback</doc>
11195             <type name="gpointer" c:type="gpointer"/>
11196           </parameter>
11197         </parameters>
11198       </method>
11199       <method name="eject_finish"
11200               c:identifier="g_drive_eject_finish"
11201               deprecated="Use g_drive_eject_with_operation_finish() instead."
11202               deprecated-version="2.22"
11203               throws="1">
11204         <doc xml:whitespace="preserve">Finishes ejecting a drive.
11205 %FALSE otherwise.</doc>
11206         <return-value transfer-ownership="none">
11207           <doc xml:whitespace="preserve">%TRUE if the drive has been ejected successfully,</doc>
11208           <type name="gboolean" c:type="gboolean"/>
11209         </return-value>
11210         <parameters>
11211           <parameter name="result" transfer-ownership="none">
11212             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
11213             <type name="AsyncResult" c:type="GAsyncResult*"/>
11214           </parameter>
11215         </parameters>
11216       </method>
11217       <method name="eject_with_operation"
11218               c:identifier="g_drive_eject_with_operation"
11219               version="2.22">
11220         <doc xml:whitespace="preserve">Ejects a drive. This is an asynchronous operation, and is
11221 finished by calling g_drive_eject_with_operation_finish() with the @drive
11222 and #GAsyncResult data returned in the @callback.</doc>
11223         <return-value transfer-ownership="none">
11224           <type name="none" c:type="void"/>
11225         </return-value>
11226         <parameters>
11227           <parameter name="flags" transfer-ownership="none">
11228             <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
11229             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
11230           </parameter>
11231           <parameter name="mount_operation" transfer-ownership="none">
11232             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
11233             <type name="MountOperation" c:type="GMountOperation*"/>
11234           </parameter>
11235           <parameter name="cancellable"
11236                      transfer-ownership="none"
11237                      allow-none="1">
11238             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
11239             <type name="Cancellable" c:type="GCancellable*"/>
11240           </parameter>
11241           <parameter name="callback"
11242                      transfer-ownership="none"
11243                      scope="async"
11244                      closure="4">
11245             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
11246             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
11247           </parameter>
11248           <parameter name="user_data" transfer-ownership="none">
11249             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
11250             <type name="gpointer" c:type="gpointer"/>
11251           </parameter>
11252         </parameters>
11253       </method>
11254       <method name="eject_with_operation_finish"
11255               c:identifier="g_drive_eject_with_operation_finish"
11256               version="2.22"
11257               throws="1">
11258         <doc xml:whitespace="preserve">Finishes ejecting a drive. If any errors occurred during the operation,</doc>
11259         <return-value transfer-ownership="none">
11260           <doc xml:whitespace="preserve">%TRUE if the drive was successfully ejected. %FALSE otherwise.</doc>
11261           <type name="gboolean" c:type="gboolean"/>
11262         </return-value>
11263         <parameters>
11264           <parameter name="result" transfer-ownership="none">
11265             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
11266             <type name="AsyncResult" c:type="GAsyncResult*"/>
11267           </parameter>
11268         </parameters>
11269       </method>
11270       <method name="enumerate_identifiers"
11271               c:identifier="g_drive_enumerate_identifiers">
11272         <doc xml:whitespace="preserve">Gets the kinds of identifiers that @drive has.
11273 Use g_drive_get_identifer() to obtain the identifiers
11274 themselves.
11275 kinds of identifiers. Use g_strfreev() to free.</doc>
11276         <return-value transfer-ownership="full">
11277           <doc xml:whitespace="preserve">a %NULL-terminated array of strings containing</doc>
11278           <array c:type="char**">
11279             <type name="utf8"/>
11280           </array>
11281         </return-value>
11282       </method>
11283       <method name="get_icon" c:identifier="g_drive_get_icon">
11284         <doc xml:whitespace="preserve">Gets the icon for @drive.
11285 Free the returned object with g_object_unref().</doc>
11286         <return-value transfer-ownership="full">
11287           <doc xml:whitespace="preserve">#GIcon for the @drive.</doc>
11288           <type name="Icon" c:type="GIcon*"/>
11289         </return-value>
11290       </method>
11291       <method name="get_identifier" c:identifier="g_drive_get_identifier">
11292         <doc xml:whitespace="preserve">Gets the identifier of the given kind for @drive.
11293 requested identfier, or %NULL if the #GDrive
11294 doesn't have this kind of identifier.</doc>
11295         <return-value transfer-ownership="full">
11296           <doc xml:whitespace="preserve">a newly allocated string containing the</doc>
11297           <type name="utf8" c:type="char*"/>
11298         </return-value>
11299         <parameters>
11300           <parameter name="kind" transfer-ownership="none">
11301             <doc xml:whitespace="preserve">the kind of identifier to return</doc>
11302             <type name="utf8" c:type="char*"/>
11303           </parameter>
11304         </parameters>
11305       </method>
11306       <method name="get_name" c:identifier="g_drive_get_name">
11307         <doc xml:whitespace="preserve">Gets the name of @drive.
11308 string should be freed when no longer needed.</doc>
11309         <return-value transfer-ownership="full">
11310           <doc xml:whitespace="preserve">a string containing @drive's name. The returned</doc>
11311           <type name="utf8" c:type="char*"/>
11312         </return-value>
11313       </method>
11314       <method name="get_start_stop_type"
11315               c:identifier="g_drive_get_start_stop_type"
11316               version="2.22">
11317         <doc xml:whitespace="preserve">Gets a hint about how a drive can be started/stopped.</doc>
11318         <return-value transfer-ownership="none">
11319           <doc xml:whitespace="preserve">A value from the #GDriveStartStopType enumeration.</doc>
11320           <type name="DriveStartStopType" c:type="GDriveStartStopType"/>
11321         </return-value>
11322       </method>
11323       <method name="get_volumes" c:identifier="g_drive_get_volumes">
11324         <doc xml:whitespace="preserve">Get a list of mountable volumes for @drive.
11325 The returned list should be freed with g_list_free(), after
11326 its elements have been unreffed with g_object_unref().</doc>
11327         <return-value transfer-ownership="full">
11328           <doc xml:whitespace="preserve">#GList containing any #GVolume objects on the given @drive.</doc>
11329           <type name="GLib.List" c:type="GList*">
11330             <type name="Volume"/>
11331           </type>
11332         </return-value>
11333       </method>
11334       <method name="has_media" c:identifier="g_drive_has_media">
11335         <doc xml:whitespace="preserve">Checks if the @drive has media. Note that the OS may not be polling
11336 the drive for media changes; see g_drive_is_media_check_automatic()
11337 for more details.</doc>
11338         <return-value transfer-ownership="none">
11339           <doc xml:whitespace="preserve">%TRUE if @drive has media, %FALSE otherwise.</doc>
11340           <type name="gboolean" c:type="gboolean"/>
11341         </return-value>
11342       </method>
11343       <method name="has_volumes" c:identifier="g_drive_has_volumes">
11344         <doc xml:whitespace="preserve">Check if @drive has any mountable volumes.</doc>
11345         <return-value transfer-ownership="none">
11346           <doc xml:whitespace="preserve">%TRUE if the @drive contains volumes, %FALSE otherwise.</doc>
11347           <type name="gboolean" c:type="gboolean"/>
11348         </return-value>
11349       </method>
11350       <method name="is_media_check_automatic"
11351               c:identifier="g_drive_is_media_check_automatic">
11352         <doc xml:whitespace="preserve">Checks if @drive is capabable of automatically detecting media changes.
11353 media changes, %FALSE otherwise.</doc>
11354         <return-value transfer-ownership="none">
11355           <doc xml:whitespace="preserve">%TRUE if the @drive is capabable of automatically detecting</doc>
11356           <type name="gboolean" c:type="gboolean"/>
11357         </return-value>
11358       </method>
11359       <method name="is_media_removable"
11360               c:identifier="g_drive_is_media_removable">
11361         <doc xml:whitespace="preserve">Checks if the @drive supports removable media.</doc>
11362         <return-value transfer-ownership="none">
11363           <doc xml:whitespace="preserve">%TRUE if @drive supports removable media, %FALSE otherwise.</doc>
11364           <type name="gboolean" c:type="gboolean"/>
11365         </return-value>
11366       </method>
11367       <method name="poll_for_media" c:identifier="g_drive_poll_for_media">
11368         <doc xml:whitespace="preserve">Asynchronously polls @drive to see if media has been inserted or removed.
11369 When the operation is finished, @callback will be called.
11370 You can then call g_drive_poll_for_media_finish() to obtain the
11371 result of the operation.</doc>
11372         <return-value transfer-ownership="none">
11373           <type name="none" c:type="void"/>
11374         </return-value>
11375         <parameters>
11376           <parameter name="cancellable"
11377                      transfer-ownership="none"
11378                      allow-none="1">
11379             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
11380             <type name="Cancellable" c:type="GCancellable*"/>
11381           </parameter>
11382           <parameter name="callback"
11383                      transfer-ownership="none"
11384                      scope="async"
11385                      closure="2">
11386             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
11387             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
11388           </parameter>
11389           <parameter name="user_data" transfer-ownership="none">
11390             <doc xml:whitespace="preserve">user data to pass to @callback</doc>
11391             <type name="gpointer" c:type="gpointer"/>
11392           </parameter>
11393         </parameters>
11394       </method>
11395       <method name="poll_for_media_finish"
11396               c:identifier="g_drive_poll_for_media_finish"
11397               throws="1">
11398         <doc xml:whitespace="preserve">Finishes an operation started with g_drive_poll_for_media() on a drive.
11399 %FALSE otherwise.</doc>
11400         <return-value transfer-ownership="none">
11401           <doc xml:whitespace="preserve">%TRUE if the drive has been poll_for_mediaed successfully,</doc>
11402           <type name="gboolean" c:type="gboolean"/>
11403         </return-value>
11404         <parameters>
11405           <parameter name="result" transfer-ownership="none">
11406             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
11407             <type name="AsyncResult" c:type="GAsyncResult*"/>
11408           </parameter>
11409         </parameters>
11410       </method>
11411       <method name="start" c:identifier="g_drive_start" version="2.22">
11412         <doc xml:whitespace="preserve">Asynchronously starts a drive.
11413 When the operation is finished, @callback will be called.
11414 You can then call g_drive_start_finish() to obtain the
11415 result of the operation.</doc>
11416         <return-value transfer-ownership="none">
11417           <type name="none" c:type="void"/>
11418         </return-value>
11419         <parameters>
11420           <parameter name="flags" transfer-ownership="none">
11421             <doc xml:whitespace="preserve">flags affecting the start operation.</doc>
11422             <type name="DriveStartFlags" c:type="GDriveStartFlags"/>
11423           </parameter>
11424           <parameter name="mount_operation" transfer-ownership="none">
11425             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
11426             <type name="MountOperation" c:type="GMountOperation*"/>
11427           </parameter>
11428           <parameter name="cancellable"
11429                      transfer-ownership="none"
11430                      allow-none="1">
11431             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
11432             <type name="Cancellable" c:type="GCancellable*"/>
11433           </parameter>
11434           <parameter name="callback"
11435                      transfer-ownership="none"
11436                      scope="async"
11437                      closure="4">
11438             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
11439             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
11440           </parameter>
11441           <parameter name="user_data" transfer-ownership="none">
11442             <doc xml:whitespace="preserve">user data to pass to @callback</doc>
11443             <type name="gpointer" c:type="gpointer"/>
11444           </parameter>
11445         </parameters>
11446       </method>
11447       <method name="start_finish"
11448               c:identifier="g_drive_start_finish"
11449               version="2.22"
11450               throws="1">
11451         <doc xml:whitespace="preserve">Finishes starting a drive.
11452 %FALSE otherwise.</doc>
11453         <return-value transfer-ownership="none">
11454           <doc xml:whitespace="preserve">%TRUE if the drive has been started successfully,</doc>
11455           <type name="gboolean" c:type="gboolean"/>
11456         </return-value>
11457         <parameters>
11458           <parameter name="result" transfer-ownership="none">
11459             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
11460             <type name="AsyncResult" c:type="GAsyncResult*"/>
11461           </parameter>
11462         </parameters>
11463       </method>
11464       <method name="stop" c:identifier="g_drive_stop" version="2.22">
11465         <doc xml:whitespace="preserve">Asynchronously stops a drive.
11466 When the operation is finished, @callback will be called.
11467 You can then call g_drive_stop_finish() to obtain the
11468 result of the operation.</doc>
11469         <return-value transfer-ownership="none">
11470           <type name="none" c:type="void"/>
11471         </return-value>
11472         <parameters>
11473           <parameter name="flags" transfer-ownership="none">
11474             <doc xml:whitespace="preserve">flags affecting the unmount if required for stopping.</doc>
11475             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
11476           </parameter>
11477           <parameter name="mount_operation" transfer-ownership="none">
11478             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
11479             <type name="MountOperation" c:type="GMountOperation*"/>
11480           </parameter>
11481           <parameter name="cancellable"
11482                      transfer-ownership="none"
11483                      allow-none="1">
11484             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
11485             <type name="Cancellable" c:type="GCancellable*"/>
11486           </parameter>
11487           <parameter name="callback"
11488                      transfer-ownership="none"
11489                      scope="async"
11490                      closure="4">
11491             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
11492             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
11493           </parameter>
11494           <parameter name="user_data" transfer-ownership="none">
11495             <doc xml:whitespace="preserve">user data to pass to @callback</doc>
11496             <type name="gpointer" c:type="gpointer"/>
11497           </parameter>
11498         </parameters>
11499       </method>
11500       <method name="stop_finish"
11501               c:identifier="g_drive_stop_finish"
11502               version="2.22"
11503               throws="1">
11504         <doc xml:whitespace="preserve">Finishes stopping a drive.
11505 %FALSE otherwise.</doc>
11506         <return-value transfer-ownership="none">
11507           <doc xml:whitespace="preserve">%TRUE if the drive has been stopped successfully,</doc>
11508           <type name="gboolean" c:type="gboolean"/>
11509         </return-value>
11510         <parameters>
11511           <parameter name="result" transfer-ownership="none">
11512             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
11513             <type name="AsyncResult" c:type="GAsyncResult*"/>
11514           </parameter>
11515         </parameters>
11516       </method>
11517       <glib:signal name="changed">
11518         <doc xml:whitespace="preserve">Emitted when the drive's state has changed.</doc>
11519         <return-value transfer-ownership="none">
11520           <type name="none"/>
11521         </return-value>
11522       </glib:signal>
11523       <glib:signal name="disconnected">
11524         <doc xml:whitespace="preserve">This signal is emitted when the #GDrive have been
11525 disconnected. If the recipient is holding references to the
11526 object they should release them so the object can be
11527 finalized.</doc>
11528         <return-value transfer-ownership="none">
11529           <type name="none"/>
11530         </return-value>
11531       </glib:signal>
11532       <glib:signal name="eject-button">
11533         <doc xml:whitespace="preserve">Emitted when the physical eject button (if any) of a drive has
11534 been pressed.</doc>
11535         <return-value transfer-ownership="none">
11536           <type name="none"/>
11537         </return-value>
11538       </glib:signal>
11539       <glib:signal name="stop-button" version="2.22">
11540         <doc xml:whitespace="preserve">Emitted when the physical stop button (if any) of a drive has
11541 been pressed.</doc>
11542         <return-value transfer-ownership="none">
11543           <type name="none"/>
11544         </return-value>
11545       </glib:signal>
11546     </interface>
11547     <record name="DriveIface"
11548             c:type="GDriveIface"
11549             glib:is-gtype-struct-for="Drive">
11550       <doc xml:whitespace="preserve">Interface for creating #GDrive implementations.</doc>
11551       <field name="g_iface">
11552         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
11553       </field>
11554       <field name="changed">
11555         <callback name="changed">
11556           <return-value transfer-ownership="none">
11557             <type name="none" c:type="void"/>
11558           </return-value>
11559           <parameters>
11560             <parameter name="drive" transfer-ownership="none">
11561               <type name="Drive" c:type="GDrive*"/>
11562             </parameter>
11563           </parameters>
11564         </callback>
11565       </field>
11566       <field name="disconnected">
11567         <callback name="disconnected">
11568           <return-value transfer-ownership="none">
11569             <type name="none" c:type="void"/>
11570           </return-value>
11571           <parameters>
11572             <parameter name="drive" transfer-ownership="none">
11573               <type name="Drive" c:type="GDrive*"/>
11574             </parameter>
11575           </parameters>
11576         </callback>
11577       </field>
11578       <field name="eject_button">
11579         <callback name="eject_button">
11580           <return-value transfer-ownership="none">
11581             <type name="none" c:type="void"/>
11582           </return-value>
11583           <parameters>
11584             <parameter name="drive" transfer-ownership="none">
11585               <type name="Drive" c:type="GDrive*"/>
11586             </parameter>
11587           </parameters>
11588         </callback>
11589       </field>
11590       <field name="get_name">
11591         <callback name="get_name">
11592           <return-value transfer-ownership="full">
11593             <doc xml:whitespace="preserve">a string containing @drive's name. The returned</doc>
11594             <type name="utf8" c:type="char*"/>
11595           </return-value>
11596           <parameters>
11597             <parameter name="drive" transfer-ownership="none">
11598               <type name="Drive" c:type="GDrive*"/>
11599             </parameter>
11600           </parameters>
11601         </callback>
11602       </field>
11603       <field name="get_icon">
11604         <callback name="get_icon">
11605           <return-value transfer-ownership="full">
11606             <doc xml:whitespace="preserve">#GIcon for the @drive.</doc>
11607             <type name="Icon" c:type="GIcon*"/>
11608           </return-value>
11609           <parameters>
11610             <parameter name="drive" transfer-ownership="none">
11611               <type name="Drive" c:type="GDrive*"/>
11612             </parameter>
11613           </parameters>
11614         </callback>
11615       </field>
11616       <field name="has_volumes">
11617         <callback name="has_volumes">
11618           <return-value transfer-ownership="none">
11619             <doc xml:whitespace="preserve">%TRUE if the @drive contains volumes, %FALSE otherwise.</doc>
11620             <type name="gboolean" c:type="gboolean"/>
11621           </return-value>
11622           <parameters>
11623             <parameter name="drive" transfer-ownership="none">
11624               <type name="Drive" c:type="GDrive*"/>
11625             </parameter>
11626           </parameters>
11627         </callback>
11628       </field>
11629       <field name="get_volumes">
11630         <callback name="get_volumes">
11631           <return-value transfer-ownership="full">
11632             <doc xml:whitespace="preserve">#GList containing any #GVolume objects on the given @drive.</doc>
11633             <type name="GLib.List" c:type="GList*">
11634               <type name="Volume"/>
11635             </type>
11636           </return-value>
11637           <parameters>
11638             <parameter name="drive" transfer-ownership="none">
11639               <type name="Drive" c:type="GDrive*"/>
11640             </parameter>
11641           </parameters>
11642         </callback>
11643       </field>
11644       <field name="is_media_removable">
11645         <callback name="is_media_removable">
11646           <return-value transfer-ownership="none">
11647             <doc xml:whitespace="preserve">%TRUE if @drive supports removable media, %FALSE otherwise.</doc>
11648             <type name="gboolean" c:type="gboolean"/>
11649           </return-value>
11650           <parameters>
11651             <parameter name="drive" transfer-ownership="none">
11652               <type name="Drive" c:type="GDrive*"/>
11653             </parameter>
11654           </parameters>
11655         </callback>
11656       </field>
11657       <field name="has_media">
11658         <callback name="has_media">
11659           <return-value transfer-ownership="none">
11660             <doc xml:whitespace="preserve">%TRUE if @drive has media, %FALSE otherwise.</doc>
11661             <type name="gboolean" c:type="gboolean"/>
11662           </return-value>
11663           <parameters>
11664             <parameter name="drive" transfer-ownership="none">
11665               <type name="Drive" c:type="GDrive*"/>
11666             </parameter>
11667           </parameters>
11668         </callback>
11669       </field>
11670       <field name="is_media_check_automatic">
11671         <callback name="is_media_check_automatic">
11672           <return-value transfer-ownership="none">
11673             <doc xml:whitespace="preserve">%TRUE if the @drive is capabable of automatically detecting</doc>
11674             <type name="gboolean" c:type="gboolean"/>
11675           </return-value>
11676           <parameters>
11677             <parameter name="drive" transfer-ownership="none">
11678               <type name="Drive" c:type="GDrive*"/>
11679             </parameter>
11680           </parameters>
11681         </callback>
11682       </field>
11683       <field name="can_eject">
11684         <callback name="can_eject">
11685           <return-value transfer-ownership="none">
11686             <doc xml:whitespace="preserve">%TRUE if the @drive can be ejected, %FALSE otherwise.</doc>
11687             <type name="gboolean" c:type="gboolean"/>
11688           </return-value>
11689           <parameters>
11690             <parameter name="drive" transfer-ownership="none">
11691               <type name="Drive" c:type="GDrive*"/>
11692             </parameter>
11693           </parameters>
11694         </callback>
11695       </field>
11696       <field name="can_poll_for_media">
11697         <callback name="can_poll_for_media">
11698           <return-value transfer-ownership="none">
11699             <doc xml:whitespace="preserve">%TRUE if the @drive can be polled for media changes,</doc>
11700             <type name="gboolean" c:type="gboolean"/>
11701           </return-value>
11702           <parameters>
11703             <parameter name="drive" transfer-ownership="none">
11704               <type name="Drive" c:type="GDrive*"/>
11705             </parameter>
11706           </parameters>
11707         </callback>
11708       </field>
11709       <field name="eject">
11710         <callback name="eject">
11711           <return-value transfer-ownership="none">
11712             <type name="none" c:type="void"/>
11713           </return-value>
11714           <parameters>
11715             <parameter name="drive" transfer-ownership="none">
11716               <type name="Drive" c:type="GDrive*"/>
11717             </parameter>
11718             <parameter name="flags" transfer-ownership="none">
11719               <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
11720               <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
11721             </parameter>
11722             <parameter name="cancellable"
11723                        transfer-ownership="none"
11724                        allow-none="1">
11725               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
11726               <type name="Cancellable" c:type="GCancellable*"/>
11727             </parameter>
11728             <parameter name="callback"
11729                        transfer-ownership="none"
11730                        scope="async"
11731                        closure="4">
11732               <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
11733               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
11734             </parameter>
11735             <parameter name="user_data" transfer-ownership="none" closure="4">
11736               <doc xml:whitespace="preserve">user data to pass to @callback</doc>
11737               <type name="gpointer" c:type="gpointer"/>
11738             </parameter>
11739           </parameters>
11740         </callback>
11741       </field>
11742       <field name="eject_finish">
11743         <callback name="eject_finish" throws="1">
11744           <return-value transfer-ownership="none">
11745             <doc xml:whitespace="preserve">%TRUE if the drive has been ejected successfully,</doc>
11746             <type name="gboolean" c:type="gboolean"/>
11747           </return-value>
11748           <parameters>
11749             <parameter name="drive" transfer-ownership="none">
11750               <type name="Drive" c:type="GDrive*"/>
11751             </parameter>
11752             <parameter name="result" transfer-ownership="none">
11753               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
11754               <type name="AsyncResult" c:type="GAsyncResult*"/>
11755             </parameter>
11756           </parameters>
11757         </callback>
11758       </field>
11759       <field name="poll_for_media">
11760         <callback name="poll_for_media">
11761           <return-value transfer-ownership="none">
11762             <type name="none" c:type="void"/>
11763           </return-value>
11764           <parameters>
11765             <parameter name="drive" transfer-ownership="none">
11766               <type name="Drive" c:type="GDrive*"/>
11767             </parameter>
11768             <parameter name="cancellable"
11769                        transfer-ownership="none"
11770                        allow-none="1">
11771               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
11772               <type name="Cancellable" c:type="GCancellable*"/>
11773             </parameter>
11774             <parameter name="callback"
11775                        transfer-ownership="none"
11776                        scope="async"
11777                        closure="3">
11778               <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
11779               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
11780             </parameter>
11781             <parameter name="user_data" transfer-ownership="none" closure="3">
11782               <doc xml:whitespace="preserve">user data to pass to @callback</doc>
11783               <type name="gpointer" c:type="gpointer"/>
11784             </parameter>
11785           </parameters>
11786         </callback>
11787       </field>
11788       <field name="poll_for_media_finish">
11789         <callback name="poll_for_media_finish" throws="1">
11790           <return-value transfer-ownership="none">
11791             <doc xml:whitespace="preserve">%TRUE if the drive has been poll_for_mediaed successfully,</doc>
11792             <type name="gboolean" c:type="gboolean"/>
11793           </return-value>
11794           <parameters>
11795             <parameter name="drive" transfer-ownership="none">
11796               <type name="Drive" c:type="GDrive*"/>
11797             </parameter>
11798             <parameter name="result" transfer-ownership="none">
11799               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
11800               <type name="AsyncResult" c:type="GAsyncResult*"/>
11801             </parameter>
11802           </parameters>
11803         </callback>
11804       </field>
11805       <field name="get_identifier">
11806         <callback name="get_identifier">
11807           <return-value transfer-ownership="full">
11808             <doc xml:whitespace="preserve">a newly allocated string containing the</doc>
11809             <type name="utf8" c:type="char*"/>
11810           </return-value>
11811           <parameters>
11812             <parameter name="drive" transfer-ownership="none">
11813               <type name="Drive" c:type="GDrive*"/>
11814             </parameter>
11815             <parameter name="kind" transfer-ownership="none">
11816               <doc xml:whitespace="preserve">the kind of identifier to return</doc>
11817               <type name="utf8" c:type="char*"/>
11818             </parameter>
11819           </parameters>
11820         </callback>
11821       </field>
11822       <field name="enumerate_identifiers">
11823         <callback name="enumerate_identifiers">
11824           <return-value transfer-ownership="full">
11825             <doc xml:whitespace="preserve">a %NULL-terminated array of strings containing</doc>
11826             <array c:type="char**">
11827               <type name="utf8"/>
11828             </array>
11829           </return-value>
11830           <parameters>
11831             <parameter name="drive" transfer-ownership="none">
11832               <type name="Drive" c:type="GDrive*"/>
11833             </parameter>
11834           </parameters>
11835         </callback>
11836       </field>
11837       <field name="get_start_stop_type">
11838         <callback name="get_start_stop_type">
11839           <return-value transfer-ownership="none">
11840             <doc xml:whitespace="preserve">A value from the #GDriveStartStopType enumeration.</doc>
11841             <type name="DriveStartStopType" c:type="GDriveStartStopType"/>
11842           </return-value>
11843           <parameters>
11844             <parameter name="drive" transfer-ownership="none">
11845               <type name="Drive" c:type="GDrive*"/>
11846             </parameter>
11847           </parameters>
11848         </callback>
11849       </field>
11850       <field name="can_start">
11851         <callback name="can_start">
11852           <return-value transfer-ownership="none">
11853             <doc xml:whitespace="preserve">%TRUE if the @drive can be started, %FALSE otherwise.</doc>
11854             <type name="gboolean" c:type="gboolean"/>
11855           </return-value>
11856           <parameters>
11857             <parameter name="drive" transfer-ownership="none">
11858               <type name="Drive" c:type="GDrive*"/>
11859             </parameter>
11860           </parameters>
11861         </callback>
11862       </field>
11863       <field name="can_start_degraded">
11864         <callback name="can_start_degraded">
11865           <return-value transfer-ownership="none">
11866             <doc xml:whitespace="preserve">%TRUE if the @drive can be started degraded, %FALSE otherwise.</doc>
11867             <type name="gboolean" c:type="gboolean"/>
11868           </return-value>
11869           <parameters>
11870             <parameter name="drive" transfer-ownership="none">
11871               <type name="Drive" c:type="GDrive*"/>
11872             </parameter>
11873           </parameters>
11874         </callback>
11875       </field>
11876       <field name="start">
11877         <callback name="start">
11878           <return-value transfer-ownership="none">
11879             <type name="none" c:type="void"/>
11880           </return-value>
11881           <parameters>
11882             <parameter name="drive" transfer-ownership="none">
11883               <type name="Drive" c:type="GDrive*"/>
11884             </parameter>
11885             <parameter name="flags" transfer-ownership="none">
11886               <doc xml:whitespace="preserve">flags affecting the start operation.</doc>
11887               <type name="DriveStartFlags" c:type="GDriveStartFlags"/>
11888             </parameter>
11889             <parameter name="mount_operation" transfer-ownership="none">
11890               <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
11891               <type name="MountOperation" c:type="GMountOperation*"/>
11892             </parameter>
11893             <parameter name="cancellable"
11894                        transfer-ownership="none"
11895                        allow-none="1">
11896               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
11897               <type name="Cancellable" c:type="GCancellable*"/>
11898             </parameter>
11899             <parameter name="callback"
11900                        transfer-ownership="none"
11901                        scope="async"
11902                        closure="5">
11903               <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
11904               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
11905             </parameter>
11906             <parameter name="user_data" transfer-ownership="none" closure="5">
11907               <doc xml:whitespace="preserve">user data to pass to @callback</doc>
11908               <type name="gpointer" c:type="gpointer"/>
11909             </parameter>
11910           </parameters>
11911         </callback>
11912       </field>
11913       <field name="start_finish">
11914         <callback name="start_finish" throws="1">
11915           <return-value transfer-ownership="none">
11916             <doc xml:whitespace="preserve">%TRUE if the drive has been started successfully,</doc>
11917             <type name="gboolean" c:type="gboolean"/>
11918           </return-value>
11919           <parameters>
11920             <parameter name="drive" transfer-ownership="none">
11921               <type name="Drive" c:type="GDrive*"/>
11922             </parameter>
11923             <parameter name="result" transfer-ownership="none">
11924               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
11925               <type name="AsyncResult" c:type="GAsyncResult*"/>
11926             </parameter>
11927           </parameters>
11928         </callback>
11929       </field>
11930       <field name="can_stop">
11931         <callback name="can_stop">
11932           <return-value transfer-ownership="none">
11933             <doc xml:whitespace="preserve">%TRUE if the @drive can be stopped, %FALSE otherwise.</doc>
11934             <type name="gboolean" c:type="gboolean"/>
11935           </return-value>
11936           <parameters>
11937             <parameter name="drive" transfer-ownership="none">
11938               <type name="Drive" c:type="GDrive*"/>
11939             </parameter>
11940           </parameters>
11941         </callback>
11942       </field>
11943       <field name="stop">
11944         <callback name="stop">
11945           <return-value transfer-ownership="none">
11946             <type name="none" c:type="void"/>
11947           </return-value>
11948           <parameters>
11949             <parameter name="drive" transfer-ownership="none">
11950               <type name="Drive" c:type="GDrive*"/>
11951             </parameter>
11952             <parameter name="flags" transfer-ownership="none">
11953               <doc xml:whitespace="preserve">flags affecting the unmount if required for stopping.</doc>
11954               <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
11955             </parameter>
11956             <parameter name="mount_operation" transfer-ownership="none">
11957               <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
11958               <type name="MountOperation" c:type="GMountOperation*"/>
11959             </parameter>
11960             <parameter name="cancellable"
11961                        transfer-ownership="none"
11962                        allow-none="1">
11963               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
11964               <type name="Cancellable" c:type="GCancellable*"/>
11965             </parameter>
11966             <parameter name="callback"
11967                        transfer-ownership="none"
11968                        scope="async"
11969                        closure="5">
11970               <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
11971               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
11972             </parameter>
11973             <parameter name="user_data" transfer-ownership="none" closure="5">
11974               <doc xml:whitespace="preserve">user data to pass to @callback</doc>
11975               <type name="gpointer" c:type="gpointer"/>
11976             </parameter>
11977           </parameters>
11978         </callback>
11979       </field>
11980       <field name="stop_finish">
11981         <callback name="stop_finish" throws="1">
11982           <return-value transfer-ownership="none">
11983             <doc xml:whitespace="preserve">%TRUE if the drive has been stopped successfully,</doc>
11984             <type name="gboolean" c:type="gboolean"/>
11985           </return-value>
11986           <parameters>
11987             <parameter name="drive" transfer-ownership="none">
11988               <type name="Drive" c:type="GDrive*"/>
11989             </parameter>
11990             <parameter name="result" transfer-ownership="none">
11991               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
11992               <type name="AsyncResult" c:type="GAsyncResult*"/>
11993             </parameter>
11994           </parameters>
11995         </callback>
11996       </field>
11997       <field name="stop_button">
11998         <callback name="stop_button">
11999           <return-value transfer-ownership="none">
12000             <type name="none" c:type="void"/>
12001           </return-value>
12002           <parameters>
12003             <parameter name="drive" transfer-ownership="none">
12004               <type name="Drive" c:type="GDrive*"/>
12005             </parameter>
12006           </parameters>
12007         </callback>
12008       </field>
12009       <field name="eject_with_operation">
12010         <callback name="eject_with_operation">
12011           <return-value transfer-ownership="none">
12012             <type name="none" c:type="void"/>
12013           </return-value>
12014           <parameters>
12015             <parameter name="drive" transfer-ownership="none">
12016               <type name="Drive" c:type="GDrive*"/>
12017             </parameter>
12018             <parameter name="flags" transfer-ownership="none">
12019               <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
12020               <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
12021             </parameter>
12022             <parameter name="mount_operation" transfer-ownership="none">
12023               <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
12024               <type name="MountOperation" c:type="GMountOperation*"/>
12025             </parameter>
12026             <parameter name="cancellable"
12027                        transfer-ownership="none"
12028                        allow-none="1">
12029               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
12030               <type name="Cancellable" c:type="GCancellable*"/>
12031             </parameter>
12032             <parameter name="callback"
12033                        transfer-ownership="none"
12034                        scope="async"
12035                        closure="5">
12036               <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
12037               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
12038             </parameter>
12039             <parameter name="user_data" transfer-ownership="none" closure="5">
12040               <doc xml:whitespace="preserve">user data passed to @callback.</doc>
12041               <type name="gpointer" c:type="gpointer"/>
12042             </parameter>
12043           </parameters>
12044         </callback>
12045       </field>
12046       <field name="eject_with_operation_finish">
12047         <callback name="eject_with_operation_finish" throws="1">
12048           <return-value transfer-ownership="none">
12049             <doc xml:whitespace="preserve">%TRUE if the drive was successfully ejected. %FALSE otherwise.</doc>
12050             <type name="gboolean" c:type="gboolean"/>
12051           </return-value>
12052           <parameters>
12053             <parameter name="drive" transfer-ownership="none">
12054               <type name="Drive" c:type="GDrive*"/>
12055             </parameter>
12056             <parameter name="result" transfer-ownership="none">
12057               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
12058               <type name="AsyncResult" c:type="GAsyncResult*"/>
12059             </parameter>
12060           </parameters>
12061         </callback>
12062       </field>
12063     </record>
12064     <enumeration name="DriveStartFlags"
12065                  version="2.22"
12066                  glib:type-name="GDriveStartFlags"
12067                  glib:get-type="g_drive_start_flags_get_type"
12068                  c:type="GDriveStartFlags">
12069       <doc xml:whitespace="preserve">Flags used when starting a drive.</doc>
12070       <member name="none"
12071               value="0"
12072               c:identifier="G_DRIVE_START_NONE"
12073               glib:nick="none"/>
12074     </enumeration>
12075     <enumeration name="DriveStartStopType"
12076                  version="2.22"
12077                  glib:type-name="GDriveStartStopType"
12078                  glib:get-type="g_drive_start_stop_type_get_type"
12079                  c:type="GDriveStartStopType">
12080       <doc xml:whitespace="preserve">Enumeration describing how a drive can be started/stopped.</doc>
12081       <member name="unknown"
12082               value="0"
12083               c:identifier="G_DRIVE_START_STOP_TYPE_UNKNOWN"
12084               glib:nick="unknown"/>
12085       <member name="shutdown"
12086               value="1"
12087               c:identifier="G_DRIVE_START_STOP_TYPE_SHUTDOWN"
12088               glib:nick="shutdown"/>
12089       <member name="network"
12090               value="2"
12091               c:identifier="G_DRIVE_START_STOP_TYPE_NETWORK"
12092               glib:nick="network"/>
12093       <member name="multidisk"
12094               value="3"
12095               c:identifier="G_DRIVE_START_STOP_TYPE_MULTIDISK"
12096               glib:nick="multidisk"/>
12097       <member name="password"
12098               value="4"
12099               c:identifier="G_DRIVE_START_STOP_TYPE_PASSWORD"
12100               glib:nick="password"/>
12101     </enumeration>
12102     <class name="Emblem"
12103            c:symbol-prefix="emblem"
12104            c:type="GEmblem"
12105            parent="GObject.Object"
12106            glib:type-name="GEmblem"
12107            glib:get-type="g_emblem_get_type"
12108            glib:type-struct="EmblemClass">
12109       <doc xml:whitespace="preserve">An object for Emblems</doc>
12110       <implements name="Icon"/>
12111       <constructor name="new" c:identifier="g_emblem_new" version="2.18">
12112         <doc xml:whitespace="preserve">Creates a new emblem for @icon.</doc>
12113         <return-value transfer-ownership="full">
12114           <doc xml:whitespace="preserve">a new #GEmblem.</doc>
12115           <type name="Emblem" c:type="GEmblem*"/>
12116         </return-value>
12117         <parameters>
12118           <parameter name="icon" transfer-ownership="none">
12119             <doc xml:whitespace="preserve">a GIcon containing the icon.</doc>
12120             <type name="Icon" c:type="GIcon*"/>
12121           </parameter>
12122         </parameters>
12123       </constructor>
12124       <constructor name="new_with_origin"
12125                    c:identifier="g_emblem_new_with_origin"
12126                    version="2.18">
12127         <doc xml:whitespace="preserve">Creates a new emblem for @icon.</doc>
12128         <return-value transfer-ownership="full">
12129           <doc xml:whitespace="preserve">a new #GEmblem.</doc>
12130           <type name="Emblem" c:type="GEmblem*"/>
12131         </return-value>
12132         <parameters>
12133           <parameter name="icon" transfer-ownership="none">
12134             <doc xml:whitespace="preserve">a GIcon containing the icon.</doc>
12135             <type name="Icon" c:type="GIcon*"/>
12136           </parameter>
12137           <parameter name="origin" transfer-ownership="none">
12138             <doc xml:whitespace="preserve">a GEmblemOrigin enum defining the emblem's origin</doc>
12139             <type name="EmblemOrigin" c:type="GEmblemOrigin"/>
12140           </parameter>
12141         </parameters>
12142       </constructor>
12143       <method name="get_icon" c:identifier="g_emblem_get_icon" version="2.18">
12144         <doc xml:whitespace="preserve">Gives back the icon from @emblem.
12145 and should not be modified or freed.</doc>
12146         <return-value transfer-ownership="full">
12147           <doc xml:whitespace="preserve">a #GIcon. The returned object belongs to the emblem</doc>
12148           <type name="Icon" c:type="GIcon*"/>
12149         </return-value>
12150       </method>
12151       <method name="get_origin"
12152               c:identifier="g_emblem_get_origin"
12153               version="2.18">
12154         <doc xml:whitespace="preserve">Gets the origin of the emblem.</doc>
12155         <return-value transfer-ownership="none">
12156           <doc xml:whitespace="preserve">the origin of the emblem</doc>
12157           <type name="EmblemOrigin" c:type="GEmblemOrigin"/>
12158         </return-value>
12159       </method>
12160       <property name="icon"
12161                 writable="1"
12162                 construct-only="1"
12163                 transfer-ownership="none">
12164         <type name="GObject.Object"/>
12165       </property>
12166       <property name="origin"
12167                 writable="1"
12168                 construct-only="1"
12169                 transfer-ownership="none">
12170         <type name="EmblemOrigin"/>
12171       </property>
12172     </class>
12173     <record name="EmblemClass"
12174             c:type="GEmblemClass"
12175             disguised="1"
12176             glib:is-gtype-struct-for="Emblem">
12177     </record>
12178     <enumeration name="EmblemOrigin"
12179                  version="2.18"
12180                  glib:type-name="GEmblemOrigin"
12181                  glib:get-type="g_emblem_origin_get_type"
12182                  c:type="GEmblemOrigin">
12183       <doc xml:whitespace="preserve">GEmblemOrigin is used to add information about the origin of the emblem
12184 to #GEmblem.</doc>
12185       <member name="unknown"
12186               value="0"
12187               c:identifier="G_EMBLEM_ORIGIN_UNKNOWN"
12188               glib:nick="unknown"/>
12189       <member name="device"
12190               value="1"
12191               c:identifier="G_EMBLEM_ORIGIN_DEVICE"
12192               glib:nick="device"/>
12193       <member name="livemetadata"
12194               value="2"
12195               c:identifier="G_EMBLEM_ORIGIN_LIVEMETADATA"
12196               glib:nick="livemetadata"/>
12197       <member name="tag"
12198               value="3"
12199               c:identifier="G_EMBLEM_ORIGIN_TAG"
12200               glib:nick="tag"/>
12201     </enumeration>
12202     <class name="EmblemedIcon"
12203            c:symbol-prefix="emblemed_icon"
12204            c:type="GEmblemedIcon"
12205            parent="GObject.Object"
12206            glib:type-name="GEmblemedIcon"
12207            glib:get-type="g_emblemed_icon_get_type"
12208            glib:type-struct="EmblemedIconClass">
12209       <doc xml:whitespace="preserve">An implementation of #GIcon for icons with emblems.</doc>
12210       <implements name="Icon"/>
12211       <function name="new" c:identifier="g_emblemed_icon_new" version="2.18">
12212         <doc xml:whitespace="preserve">Creates a new emblemed icon for @icon with the emblem @emblem.</doc>
12213         <return-value transfer-ownership="full">
12214           <doc xml:whitespace="preserve">a new #GIcon</doc>
12215           <type name="Icon" c:type="GIcon*"/>
12216         </return-value>
12217         <parameters>
12218           <parameter name="icon" transfer-ownership="none">
12219             <doc xml:whitespace="preserve">a #GIcon</doc>
12220             <type name="Icon" c:type="GIcon*"/>
12221           </parameter>
12222           <parameter name="emblem" transfer-ownership="none">
12223             <doc xml:whitespace="preserve">a #GEmblem</doc>
12224             <type name="Emblem" c:type="GEmblem*"/>
12225           </parameter>
12226         </parameters>
12227       </function>
12228       <method name="add_emblem"
12229               c:identifier="g_emblemed_icon_add_emblem"
12230               version="2.18">
12231         <doc xml:whitespace="preserve">Adds @emblem to the #GList of #GEmblem &lt;!-- --&gt;s.</doc>
12232         <return-value transfer-ownership="none">
12233           <type name="none" c:type="void"/>
12234         </return-value>
12235         <parameters>
12236           <parameter name="emblem" transfer-ownership="none">
12237             <doc xml:whitespace="preserve">a #GEmblem</doc>
12238             <type name="Emblem" c:type="GEmblem*"/>
12239           </parameter>
12240         </parameters>
12241       </method>
12242       <method name="get_emblems"
12243               c:identifier="g_emblemed_icon_get_emblems"
12244               version="2.18">
12245         <doc xml:whitespace="preserve">Gets the list of emblems for the @icon.
12246 is owned by @emblemed</doc>
12247         <return-value transfer-ownership="none">
12248           <doc xml:whitespace="preserve">a #GList of #GEmblem &lt;!-- --&gt;s that</doc>
12249           <type name="GLib.List" c:type="GList*">
12250             <type name="utf8"/>
12251           </type>
12252         </return-value>
12253       </method>
12254       <method name="get_icon"
12255               c:identifier="g_emblemed_icon_get_icon"
12256               version="2.18">
12257         <doc xml:whitespace="preserve">Gets the main icon for @emblemed.</doc>
12258         <return-value transfer-ownership="full">
12259           <doc xml:whitespace="preserve">a #GIcon that is owned by @emblemed</doc>
12260           <type name="Icon" c:type="GIcon*"/>
12261         </return-value>
12262       </method>
12263     </class>
12264     <record name="EmblemedIconClass"
12265             c:type="GEmblemedIconClass"
12266             disguised="1"
12267             glib:is-gtype-struct-for="EmblemedIcon">
12268     </record>
12269     <constant name="FILE_ATTRIBUTE_ACCESS_CAN_DELETE"
12270               value="access::can-delete">
12271       <type name="utf8" c:type="gchar*"/>
12272     </constant>
12273     <constant name="FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE"
12274               value="access::can-execute">
12275       <type name="utf8" c:type="gchar*"/>
12276     </constant>
12277     <constant name="FILE_ATTRIBUTE_ACCESS_CAN_READ" value="access::can-read">
12278       <type name="utf8" c:type="gchar*"/>
12279     </constant>
12280     <constant name="FILE_ATTRIBUTE_ACCESS_CAN_RENAME"
12281               value="access::can-rename">
12282       <type name="utf8" c:type="gchar*"/>
12283     </constant>
12284     <constant name="FILE_ATTRIBUTE_ACCESS_CAN_TRASH" value="access::can-trash">
12285       <type name="utf8" c:type="gchar*"/>
12286     </constant>
12287     <constant name="FILE_ATTRIBUTE_ACCESS_CAN_WRITE" value="access::can-write">
12288       <type name="utf8" c:type="gchar*"/>
12289     </constant>
12290     <constant name="FILE_ATTRIBUTE_DOS_IS_ARCHIVE" value="dos::is-archive">
12291       <type name="utf8" c:type="gchar*"/>
12292     </constant>
12293     <constant name="FILE_ATTRIBUTE_DOS_IS_SYSTEM" value="dos::is-system">
12294       <type name="utf8" c:type="gchar*"/>
12295     </constant>
12296     <constant name="FILE_ATTRIBUTE_ETAG_VALUE" value="etag::value">
12297       <type name="utf8" c:type="gchar*"/>
12298     </constant>
12299     <constant name="FILE_ATTRIBUTE_FILESYSTEM_FREE" value="filesystem::free">
12300       <type name="utf8" c:type="gchar*"/>
12301     </constant>
12302     <constant name="FILE_ATTRIBUTE_FILESYSTEM_READONLY"
12303               value="filesystem::readonly">
12304       <type name="utf8" c:type="gchar*"/>
12305     </constant>
12306     <constant name="FILE_ATTRIBUTE_FILESYSTEM_SIZE" value="filesystem::size">
12307       <type name="utf8" c:type="gchar*"/>
12308     </constant>
12309     <constant name="FILE_ATTRIBUTE_FILESYSTEM_TYPE" value="filesystem::type">
12310       <type name="utf8" c:type="gchar*"/>
12311     </constant>
12312     <constant name="FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW"
12313               value="filesystem::use-preview">
12314       <type name="utf8" c:type="gchar*"/>
12315     </constant>
12316     <constant name="FILE_ATTRIBUTE_GVFS_BACKEND" value="gvfs::backend">
12317       <type name="utf8" c:type="gchar*"/>
12318     </constant>
12319     <constant name="FILE_ATTRIBUTE_ID_FILE" value="id::file">
12320       <type name="utf8" c:type="gchar*"/>
12321     </constant>
12322     <constant name="FILE_ATTRIBUTE_ID_FILESYSTEM" value="id::filesystem">
12323       <type name="utf8" c:type="gchar*"/>
12324     </constant>
12325     <constant name="FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT"
12326               value="mountable::can-eject">
12327       <type name="utf8" c:type="gchar*"/>
12328     </constant>
12329     <constant name="FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT"
12330               value="mountable::can-mount">
12331       <type name="utf8" c:type="gchar*"/>
12332     </constant>
12333     <constant name="FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL"
12334               value="mountable::can-poll">
12335       <type name="utf8" c:type="gchar*"/>
12336     </constant>
12337     <constant name="FILE_ATTRIBUTE_MOUNTABLE_CAN_START"
12338               value="mountable::can-start">
12339       <type name="utf8" c:type="gchar*"/>
12340     </constant>
12341     <constant name="FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED"
12342               value="mountable::can-start-degraded">
12343       <type name="utf8" c:type="gchar*"/>
12344     </constant>
12345     <constant name="FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP"
12346               value="mountable::can-stop">
12347       <type name="utf8" c:type="gchar*"/>
12348     </constant>
12349     <constant name="FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT"
12350               value="mountable::can-unmount">
12351       <type name="utf8" c:type="gchar*"/>
12352     </constant>
12353     <constant name="FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI"
12354               value="mountable::hal-udi">
12355       <type name="utf8" c:type="gchar*"/>
12356     </constant>
12357     <constant name="FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC"
12358               value="mountable::is-media-check-automatic">
12359       <type name="utf8" c:type="gchar*"/>
12360     </constant>
12361     <constant name="FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE"
12362               value="mountable::start-stop-type">
12363       <type name="utf8" c:type="gchar*"/>
12364     </constant>
12365     <constant name="FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE"
12366               value="mountable::unix-device">
12367       <type name="utf8" c:type="gchar*"/>
12368     </constant>
12369     <constant name="FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE"
12370               value="mountable::unix-device-file">
12371       <type name="utf8" c:type="gchar*"/>
12372     </constant>
12373     <constant name="FILE_ATTRIBUTE_OWNER_GROUP" value="owner::group">
12374       <type name="utf8" c:type="gchar*"/>
12375     </constant>
12376     <constant name="FILE_ATTRIBUTE_OWNER_USER" value="owner::user">
12377       <type name="utf8" c:type="gchar*"/>
12378     </constant>
12379     <constant name="FILE_ATTRIBUTE_OWNER_USER_REAL" value="owner::user-real">
12380       <type name="utf8" c:type="gchar*"/>
12381     </constant>
12382     <constant name="FILE_ATTRIBUTE_PREVIEW_ICON" value="preview::icon">
12383       <type name="utf8" c:type="gchar*"/>
12384     </constant>
12385     <constant name="FILE_ATTRIBUTE_SELINUX_CONTEXT" value="selinux::context">
12386       <type name="utf8" c:type="gchar*"/>
12387     </constant>
12388     <constant name="FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE"
12389               value="standard::allocated-size">
12390       <type name="utf8" c:type="gchar*"/>
12391     </constant>
12392     <constant name="FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE"
12393               value="standard::content-type">
12394       <type name="utf8" c:type="gchar*"/>
12395     </constant>
12396     <constant name="FILE_ATTRIBUTE_STANDARD_COPY_NAME"
12397               value="standard::copy-name">
12398       <type name="utf8" c:type="gchar*"/>
12399     </constant>
12400     <constant name="FILE_ATTRIBUTE_STANDARD_DESCRIPTION"
12401               value="standard::description">
12402       <type name="utf8" c:type="gchar*"/>
12403     </constant>
12404     <constant name="FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME"
12405               value="standard::display-name">
12406       <type name="utf8" c:type="gchar*"/>
12407     </constant>
12408     <constant name="FILE_ATTRIBUTE_STANDARD_EDIT_NAME"
12409               value="standard::edit-name">
12410       <type name="utf8" c:type="gchar*"/>
12411     </constant>
12412     <constant name="FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE"
12413               value="standard::fast-content-type">
12414       <type name="utf8" c:type="gchar*"/>
12415     </constant>
12416     <constant name="FILE_ATTRIBUTE_STANDARD_ICON" value="standard::icon">
12417       <type name="utf8" c:type="gchar*"/>
12418     </constant>
12419     <constant name="FILE_ATTRIBUTE_STANDARD_IS_BACKUP"
12420               value="standard::is-backup">
12421       <type name="utf8" c:type="gchar*"/>
12422     </constant>
12423     <constant name="FILE_ATTRIBUTE_STANDARD_IS_HIDDEN"
12424               value="standard::is-hidden">
12425       <type name="utf8" c:type="gchar*"/>
12426     </constant>
12427     <constant name="FILE_ATTRIBUTE_STANDARD_IS_SYMLINK"
12428               value="standard::is-symlink">
12429       <type name="utf8" c:type="gchar*"/>
12430     </constant>
12431     <constant name="FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL"
12432               value="standard::is-virtual">
12433       <type name="utf8" c:type="gchar*"/>
12434     </constant>
12435     <constant name="FILE_ATTRIBUTE_STANDARD_NAME" value="standard::name">
12436       <type name="utf8" c:type="gchar*"/>
12437     </constant>
12438     <constant name="FILE_ATTRIBUTE_STANDARD_SIZE" value="standard::size">
12439       <type name="utf8" c:type="gchar*"/>
12440     </constant>
12441     <constant name="FILE_ATTRIBUTE_STANDARD_SORT_ORDER"
12442               value="standard::sort-order">
12443       <type name="utf8" c:type="gchar*"/>
12444     </constant>
12445     <constant name="FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET"
12446               value="standard::symlink-target">
12447       <type name="utf8" c:type="gchar*"/>
12448     </constant>
12449     <constant name="FILE_ATTRIBUTE_STANDARD_TARGET_URI"
12450               value="standard::target-uri">
12451       <type name="utf8" c:type="gchar*"/>
12452     </constant>
12453     <constant name="FILE_ATTRIBUTE_STANDARD_TYPE" value="standard::type">
12454       <type name="utf8" c:type="gchar*"/>
12455     </constant>
12456     <constant name="FILE_ATTRIBUTE_THUMBNAILING_FAILED"
12457               value="thumbnail::failed">
12458       <type name="utf8" c:type="gchar*"/>
12459     </constant>
12460     <constant name="FILE_ATTRIBUTE_THUMBNAIL_PATH" value="thumbnail::path">
12461       <type name="utf8" c:type="gchar*"/>
12462     </constant>
12463     <constant name="FILE_ATTRIBUTE_TIME_ACCESS" value="time::access">
12464       <type name="utf8" c:type="gchar*"/>
12465     </constant>
12466     <constant name="FILE_ATTRIBUTE_TIME_ACCESS_USEC" value="time::access-usec">
12467       <type name="utf8" c:type="gchar*"/>
12468     </constant>
12469     <constant name="FILE_ATTRIBUTE_TIME_CHANGED" value="time::changed">
12470       <type name="utf8" c:type="gchar*"/>
12471     </constant>
12472     <constant name="FILE_ATTRIBUTE_TIME_CHANGED_USEC"
12473               value="time::changed-usec">
12474       <type name="utf8" c:type="gchar*"/>
12475     </constant>
12476     <constant name="FILE_ATTRIBUTE_TIME_CREATED" value="time::created">
12477       <type name="utf8" c:type="gchar*"/>
12478     </constant>
12479     <constant name="FILE_ATTRIBUTE_TIME_CREATED_USEC"
12480               value="time::created-usec">
12481       <type name="utf8" c:type="gchar*"/>
12482     </constant>
12483     <constant name="FILE_ATTRIBUTE_TIME_MODIFIED" value="time::modified">
12484       <type name="utf8" c:type="gchar*"/>
12485     </constant>
12486     <constant name="FILE_ATTRIBUTE_TIME_MODIFIED_USEC"
12487               value="time::modified-usec">
12488       <type name="utf8" c:type="gchar*"/>
12489     </constant>
12490     <constant name="FILE_ATTRIBUTE_TRASH_DELETION_DATE"
12491               value="trash::deletion-date">
12492       <type name="utf8" c:type="gchar*"/>
12493     </constant>
12494     <constant name="FILE_ATTRIBUTE_TRASH_ITEM_COUNT" value="trash::item-count">
12495       <type name="utf8" c:type="gchar*"/>
12496     </constant>
12497     <constant name="FILE_ATTRIBUTE_TRASH_ORIG_PATH" value="trash::orig-path">
12498       <type name="utf8" c:type="gchar*"/>
12499     </constant>
12500     <constant name="FILE_ATTRIBUTE_UNIX_BLOCKS" value="unix::blocks">
12501       <type name="utf8" c:type="gchar*"/>
12502     </constant>
12503     <constant name="FILE_ATTRIBUTE_UNIX_BLOCK_SIZE" value="unix::block-size">
12504       <type name="utf8" c:type="gchar*"/>
12505     </constant>
12506     <constant name="FILE_ATTRIBUTE_UNIX_DEVICE" value="unix::device">
12507       <type name="utf8" c:type="gchar*"/>
12508     </constant>
12509     <constant name="FILE_ATTRIBUTE_UNIX_GID" value="unix::gid">
12510       <type name="utf8" c:type="gchar*"/>
12511     </constant>
12512     <constant name="FILE_ATTRIBUTE_UNIX_INODE" value="unix::inode">
12513       <type name="utf8" c:type="gchar*"/>
12514     </constant>
12515     <constant name="FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT"
12516               value="unix::is-mountpoint">
12517       <type name="utf8" c:type="gchar*"/>
12518     </constant>
12519     <constant name="FILE_ATTRIBUTE_UNIX_MODE" value="unix::mode">
12520       <type name="utf8" c:type="gchar*"/>
12521     </constant>
12522     <constant name="FILE_ATTRIBUTE_UNIX_NLINK" value="unix::nlink">
12523       <type name="utf8" c:type="gchar*"/>
12524     </constant>
12525     <constant name="FILE_ATTRIBUTE_UNIX_RDEV" value="unix::rdev">
12526       <type name="utf8" c:type="gchar*"/>
12527     </constant>
12528     <constant name="FILE_ATTRIBUTE_UNIX_UID" value="unix::uid">
12529       <type name="utf8" c:type="gchar*"/>
12530     </constant>
12531     <interface name="File"
12532                c:symbol-prefix="file"
12533                c:type="GFile"
12534                glib:type-name="GFile"
12535                glib:get-type="g_file_get_type"
12536                glib:type-struct="FileIface">
12537       <doc xml:whitespace="preserve">A handle to an object implementing the #GFileIface interface.
12538 Generally stores a location within the file system. Handles do not
12539 necessarily represent files or directories that currently exist.</doc>
12540       <virtual-method name="append_to" invoker="append_to" throws="1">
12541         <doc xml:whitespace="preserve">Gets an output stream for appending data to the file. If
12542 the file doesn't already exist it is created.
12543 By default files created are generally readable by everyone,
12544 but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
12545 will be made readable only to the current user, to the level that
12546 is supported on the target filesystem.
12547 If @cancellable is not %NULL, then the operation can be cancelled by
12548 triggering the cancellable object from another thread. If the operation
12549 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
12550 Some file systems don't allow all file names, and may
12551 return an %G_IO_ERROR_INVALID_FILENAME error.
12552 If the file is a directory the %G_IO_ERROR_IS_DIRECTORY error will be
12553 returned. Other errors are possible too, and depend on what kind of
12554 filesystem the file is on.
12555 Free the returned object with g_object_unref().</doc>
12556         <return-value transfer-ownership="full">
12557           <doc xml:whitespace="preserve">a #GFileOutputStream, or %NULL on error.</doc>
12558           <type name="FileOutputStream" c:type="GFileOutputStream*"/>
12559         </return-value>
12560         <parameters>
12561           <parameter name="flags" transfer-ownership="none">
12562             <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
12563             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
12564           </parameter>
12565           <parameter name="cancellable"
12566                      transfer-ownership="none"
12567                      allow-none="1">
12568             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
12569             <type name="Cancellable" c:type="GCancellable*"/>
12570           </parameter>
12571         </parameters>
12572       </virtual-method>
12573       <virtual-method name="append_to_async" invoker="append_to_async">
12574         <doc xml:whitespace="preserve">Asynchronously opens @file for appending.
12575 For more details, see g_file_append_to() which is
12576 the synchronous version of this call.
12577 When the operation is finished, @callback will be called. You can then call
12578 g_file_append_to_finish() to get the result of the operation.</doc>
12579         <return-value transfer-ownership="none">
12580           <type name="none" c:type="void"/>
12581         </return-value>
12582         <parameters>
12583           <parameter name="flags" transfer-ownership="none">
12584             <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
12585             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
12586           </parameter>
12587           <parameter name="io_priority" transfer-ownership="none">
12588             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
12589             <type name="gint" c:type="int"/>
12590           </parameter>
12591           <parameter name="cancellable"
12592                      transfer-ownership="none"
12593                      allow-none="1">
12594             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
12595             <type name="Cancellable" c:type="GCancellable*"/>
12596           </parameter>
12597           <parameter name="callback"
12598                      transfer-ownership="none"
12599                      scope="async"
12600                      closure="4">
12601             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
12602             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
12603           </parameter>
12604           <parameter name="user_data" transfer-ownership="none" closure="4">
12605             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
12606             <type name="gpointer" c:type="gpointer"/>
12607           </parameter>
12608         </parameters>
12609       </virtual-method>
12610       <virtual-method name="append_to_finish"
12611                       invoker="append_to_finish"
12612                       throws="1">
12613         <doc xml:whitespace="preserve">Finishes an asynchronous file append operation started with
12614 g_file_append_to_async().
12615 Free the returned object with g_object_unref().</doc>
12616         <return-value transfer-ownership="full">
12617           <doc xml:whitespace="preserve">a valid #GFileOutputStream or %NULL on error.</doc>
12618           <type name="FileOutputStream" c:type="GFileOutputStream*"/>
12619         </return-value>
12620         <parameters>
12621           <parameter name="res" transfer-ownership="none">
12622             <doc xml:whitespace="preserve">#GAsyncResult</doc>
12623             <type name="AsyncResult" c:type="GAsyncResult*"/>
12624           </parameter>
12625         </parameters>
12626       </virtual-method>
12627       <virtual-method name="copy" invoker="copy" introspectable="0" throws="1">
12628         <doc xml:whitespace="preserve">Copies the file @source to the location specified by @destination.
12629 Can not handle recursive copies of directories.
12630 If the flag #G_FILE_COPY_OVERWRITE is specified an already
12631 existing @destination file is overwritten.
12632 If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
12633 will be copied as symlinks, otherwise the target of the
12634 If @cancellable is not %NULL, then the operation can be cancelled by
12635 triggering the cancellable object from another thread. If the operation
12636 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
12637 If @progress_callback is not %NULL, then the operation can be monitored by
12638 setting this to a #GFileProgressCallback function. @progress_callback_data
12639 will be passed to this function. It is guaranteed that this callback will
12640 be called after all data has been transferred with the total number of bytes
12641 copied during the operation.
12642 If the @source file does not exist then the G_IO_ERROR_NOT_FOUND
12643 error is returned, independent on the status of the @destination.
12644 If #G_FILE_COPY_OVERWRITE is not specified and the target exists, then the
12645 error G_IO_ERROR_EXISTS is returned.
12646 If trying to overwrite a file over a directory the G_IO_ERROR_IS_DIRECTORY
12647 error is returned. If trying to overwrite a directory with a directory the
12648 G_IO_ERROR_WOULD_MERGE error is returned.
12649 If the source is a directory and the target does not exist, or #G_FILE_COPY_OVERWRITE is
12650 specified and the target is a file, then the G_IO_ERROR_WOULD_RECURSE error
12651 is returned.
12652 If you are interested in copying the #GFile object itself (not the on-disk
12653 file), see g_file_dup().</doc>
12654         <return-value transfer-ownership="none">
12655           <doc xml:whitespace="preserve">%TRUE on success, %FALSE otherwise.</doc>
12656           <type name="gboolean" c:type="gboolean"/>
12657         </return-value>
12658         <parameters>
12659           <parameter name="destination" transfer-ownership="none">
12660             <doc xml:whitespace="preserve">destination #GFile</doc>
12661             <type name="File" c:type="GFile*"/>
12662           </parameter>
12663           <parameter name="flags" transfer-ownership="none">
12664             <doc xml:whitespace="preserve">set of #GFileCopyFlags</doc>
12665             <type name="FileCopyFlags" c:type="GFileCopyFlags"/>
12666           </parameter>
12667           <parameter name="cancellable"
12668                      transfer-ownership="none"
12669                      allow-none="1">
12670             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
12671             <type name="Cancellable" c:type="GCancellable*"/>
12672           </parameter>
12673           <parameter name="progress_callback"
12674                      transfer-ownership="none"
12675                      closure="4">
12676             <doc xml:whitespace="preserve">function to callback with progress information</doc>
12677             <type name="FileProgressCallback" c:type="GFileProgressCallback"/>
12678           </parameter>
12679           <parameter name="progress_callback_data" transfer-ownership="none">
12680             <doc xml:whitespace="preserve">user data to pass to @progress_callback</doc>
12681             <type name="gpointer" c:type="gpointer"/>
12682           </parameter>
12683         </parameters>
12684       </virtual-method>
12685       <virtual-method name="copy_async"
12686                       invoker="copy_async"
12687                       introspectable="0">
12688         <doc xml:whitespace="preserve">Copies the file @source to the location specified by @destination
12689 asynchronously. For details of the behaviour, see g_file_copy().
12690 If @progress_callback is not %NULL, then that function that will be called
12691 just like in g_file_copy(), however the callback will run in the main loop,
12692 not in the thread that is doing the I/O operation.
12693 When the operation is finished, @callback will be called. You can then call
12694 g_file_copy_finish() to get the result of the operation.</doc>
12695         <return-value transfer-ownership="none">
12696           <type name="none" c:type="void"/>
12697         </return-value>
12698         <parameters>
12699           <parameter name="destination" transfer-ownership="none">
12700             <doc xml:whitespace="preserve">destination #GFile</doc>
12701             <type name="File" c:type="GFile*"/>
12702           </parameter>
12703           <parameter name="flags" transfer-ownership="none">
12704             <doc xml:whitespace="preserve">set of #GFileCopyFlags</doc>
12705             <type name="FileCopyFlags" c:type="GFileCopyFlags"/>
12706           </parameter>
12707           <parameter name="io_priority" transfer-ownership="none">
12708             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
12709             <type name="gint" c:type="int"/>
12710           </parameter>
12711           <parameter name="cancellable"
12712                      transfer-ownership="none"
12713                      allow-none="1">
12714             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
12715             <type name="Cancellable" c:type="GCancellable*"/>
12716           </parameter>
12717           <parameter name="progress_callback"
12718                      transfer-ownership="none"
12719                      closure="5">
12720             <doc xml:whitespace="preserve">function to callback with progress information</doc>
12721             <type name="FileProgressCallback" c:type="GFileProgressCallback"/>
12722           </parameter>
12723           <parameter name="progress_callback_data" transfer-ownership="none">
12724             <doc xml:whitespace="preserve">user data to pass to @progress_callback</doc>
12725             <type name="gpointer" c:type="gpointer"/>
12726           </parameter>
12727           <parameter name="callback"
12728                      transfer-ownership="none"
12729                      scope="async"
12730                      closure="7">
12731             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
12732             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
12733           </parameter>
12734           <parameter name="user_data" transfer-ownership="none" closure="7">
12735             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
12736             <type name="gpointer" c:type="gpointer"/>
12737           </parameter>
12738         </parameters>
12739       </virtual-method>
12740       <virtual-method name="copy_finish" invoker="copy_finish" throws="1">
12741         <doc xml:whitespace="preserve">Finishes copying the file started with
12742 g_file_copy_async().</doc>
12743         <return-value transfer-ownership="none">
12744           <doc xml:whitespace="preserve">a %TRUE on success, %FALSE on error.</doc>
12745           <type name="gboolean" c:type="gboolean"/>
12746         </return-value>
12747         <parameters>
12748           <parameter name="res" transfer-ownership="none">
12749             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
12750             <type name="AsyncResult" c:type="GAsyncResult*"/>
12751           </parameter>
12752         </parameters>
12753       </virtual-method>
12754       <virtual-method name="create" invoker="create" throws="1">
12755         <doc xml:whitespace="preserve">Creates a new file and returns an output stream for writing to it.
12756 The file must not already exist.
12757 By default files created are generally readable by everyone,
12758 but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
12759 will be made readable only to the current user, to the level that
12760 is supported on the target filesystem.
12761 If @cancellable is not %NULL, then the operation can be cancelled by
12762 triggering the cancellable object from another thread. If the operation
12763 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
12764 If a file or directory with this name already exists the G_IO_ERROR_EXISTS
12765 error will be returned.
12766 Some file systems don't allow all file names, and may
12767 return an G_IO_ERROR_INVALID_FILENAME error, and if the name
12768 is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned.
12769 Other errors are possible too, and depend on what kind of
12770 filesystem the file is on.
12771 %NULL on error.
12772 Free the returned object with g_object_unref().</doc>
12773         <return-value transfer-ownership="full">
12774           <doc xml:whitespace="preserve">a #GFileOutputStream for the newly created file, or</doc>
12775           <type name="FileOutputStream" c:type="GFileOutputStream*"/>
12776         </return-value>
12777         <parameters>
12778           <parameter name="flags" transfer-ownership="none">
12779             <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
12780             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
12781           </parameter>
12782           <parameter name="cancellable"
12783                      transfer-ownership="none"
12784                      allow-none="1">
12785             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
12786             <type name="Cancellable" c:type="GCancellable*"/>
12787           </parameter>
12788         </parameters>
12789       </virtual-method>
12790       <virtual-method name="create_async" invoker="create_async">
12791         <doc xml:whitespace="preserve">Asynchronously creates a new file and returns an output stream for writing to it.
12792 The file must not already exist.
12793 For more details, see g_file_create() which is
12794 the synchronous version of this call.
12795 When the operation is finished, @callback will be called. You can then call
12796 g_file_create_finish() to get the result of the operation.</doc>
12797         <return-value transfer-ownership="none">
12798           <type name="none" c:type="void"/>
12799         </return-value>
12800         <parameters>
12801           <parameter name="flags" transfer-ownership="none">
12802             <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
12803             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
12804           </parameter>
12805           <parameter name="io_priority" transfer-ownership="none">
12806             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
12807             <type name="gint" c:type="int"/>
12808           </parameter>
12809           <parameter name="cancellable"
12810                      transfer-ownership="none"
12811                      allow-none="1">
12812             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
12813             <type name="Cancellable" c:type="GCancellable*"/>
12814           </parameter>
12815           <parameter name="callback"
12816                      transfer-ownership="none"
12817                      scope="async"
12818                      closure="4">
12819             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
12820             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
12821           </parameter>
12822           <parameter name="user_data" transfer-ownership="none" closure="4">
12823             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
12824             <type name="gpointer" c:type="gpointer"/>
12825           </parameter>
12826         </parameters>
12827       </virtual-method>
12828       <virtual-method name="create_finish" invoker="create_finish" throws="1">
12829         <doc xml:whitespace="preserve">Finishes an asynchronous file create operation started with
12830 g_file_create_async().
12831 Free the returned object with g_object_unref().</doc>
12832         <return-value transfer-ownership="full">
12833           <doc xml:whitespace="preserve">a #GFileOutputStream or %NULL on error.</doc>
12834           <type name="FileOutputStream" c:type="GFileOutputStream*"/>
12835         </return-value>
12836         <parameters>
12837           <parameter name="res" transfer-ownership="none">
12838             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
12839             <type name="AsyncResult" c:type="GAsyncResult*"/>
12840           </parameter>
12841         </parameters>
12842       </virtual-method>
12843       <virtual-method name="create_readwrite"
12844                       invoker="create_readwrite"
12845                       version="2.22"
12846                       throws="1">
12847         <doc xml:whitespace="preserve">Creates a new file and returns a stream for reading and writing to it.
12848 The file must not already exist.
12849 By default files created are generally readable by everyone,
12850 but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
12851 will be made readable only to the current user, to the level that
12852 is supported on the target filesystem.
12853 If @cancellable is not %NULL, then the operation can be cancelled by
12854 triggering the cancellable object from another thread. If the operation
12855 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
12856 If a file or directory with this name already exists the %G_IO_ERROR_EXISTS
12857 error will be returned. Some file systems don't allow all file names,
12858 and may return an %G_IO_ERROR_INVALID_FILENAME error, and if the name
12859 is too long, %G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors
12860 are possible too, and depend on what kind of filesystem the file is on.
12861 Note that in many non-local file cases read and write streams are not
12862 supported, so make sure you really need to do read and write streaming,
12863 rather than just opening for reading or writing.
12864 Free the returned object with g_object_unref().</doc>
12865         <return-value transfer-ownership="full">
12866           <doc xml:whitespace="preserve">a #GFileIOStream for the newly created file, or %NULL on error.</doc>
12867           <type name="FileIOStream" c:type="GFileIOStream*"/>
12868         </return-value>
12869         <parameters>
12870           <parameter name="flags" transfer-ownership="none">
12871             <doc xml:whitespace="preserve">a set of #GFileCreateFlags</doc>
12872             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
12873           </parameter>
12874           <parameter name="cancellable"
12875                      transfer-ownership="none"
12876                      allow-none="1">
12877             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
12878             <type name="Cancellable" c:type="GCancellable*"/>
12879           </parameter>
12880         </parameters>
12881       </virtual-method>
12882       <virtual-method name="create_readwrite_async"
12883                       invoker="create_readwrite_async"
12884                       version="2.22">
12885         <doc xml:whitespace="preserve">Asynchronously creates a new file and returns a stream for reading and
12886 writing to it. The file must not already exist.
12887 For more details, see g_file_create_readwrite() which is
12888 the synchronous version of this call.
12889 When the operation is finished, @callback will be called. You can then
12890 call g_file_create_readwrite_finish() to get the result of the operation.</doc>
12891         <return-value transfer-ownership="none">
12892           <type name="none" c:type="void"/>
12893         </return-value>
12894         <parameters>
12895           <parameter name="flags" transfer-ownership="none">
12896             <doc xml:whitespace="preserve">a set of #GFileCreateFlags</doc>
12897             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
12898           </parameter>
12899           <parameter name="io_priority" transfer-ownership="none">
12900             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request</doc>
12901             <type name="gint" c:type="int"/>
12902           </parameter>
12903           <parameter name="cancellable"
12904                      transfer-ownership="none"
12905                      allow-none="1">
12906             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
12907             <type name="Cancellable" c:type="GCancellable*"/>
12908           </parameter>
12909           <parameter name="callback"
12910                      transfer-ownership="none"
12911                      scope="async"
12912                      closure="4">
12913             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
12914             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
12915           </parameter>
12916           <parameter name="user_data" transfer-ownership="none" closure="4">
12917             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
12918             <type name="gpointer" c:type="gpointer"/>
12919           </parameter>
12920         </parameters>
12921       </virtual-method>
12922       <virtual-method name="create_readwrite_finish"
12923                       invoker="create_readwrite_finish"
12924                       version="2.22"
12925                       throws="1">
12926         <doc xml:whitespace="preserve">Finishes an asynchronous file create operation started with
12927 g_file_create_readwrite_async().
12928 Free the returned object with g_object_unref().</doc>
12929         <return-value transfer-ownership="full">
12930           <doc xml:whitespace="preserve">a #GFileIOStream or %NULL on error.</doc>
12931           <type name="FileIOStream" c:type="GFileIOStream*"/>
12932         </return-value>
12933         <parameters>
12934           <parameter name="res" transfer-ownership="none">
12935             <doc xml:whitespace="preserve">a #GAsyncResult</doc>
12936             <type name="AsyncResult" c:type="GAsyncResult*"/>
12937           </parameter>
12938         </parameters>
12939       </virtual-method>
12940       <virtual-method name="delete_file" invoker="delete" throws="1">
12941         <doc xml:whitespace="preserve">Deletes a file. If the @file is a directory, it will only be deleted if it
12942 is empty.
12943 If @cancellable is not %NULL, then the operation can be cancelled by
12944 triggering the cancellable object from another thread. If the operation
12945 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
12946         <return-value transfer-ownership="none">
12947           <doc xml:whitespace="preserve">%TRUE if the file was deleted. %FALSE otherwise.</doc>
12948           <type name="gboolean" c:type="gboolean"/>
12949         </return-value>
12950         <parameters>
12951           <parameter name="cancellable"
12952                      transfer-ownership="none"
12953                      allow-none="1">
12954             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
12955             <type name="Cancellable" c:type="GCancellable*"/>
12956           </parameter>
12957         </parameters>
12958       </virtual-method>
12959       <virtual-method name="dup" invoker="dup">
12960         <doc xml:whitespace="preserve">Duplicates a #GFile handle. This operation does not duplicate
12961 the actual file or directory represented by the #GFile; see
12962 g_file_copy() if attempting to copy a file.
12963 This call does no blocking i/o.</doc>
12964         <return-value transfer-ownership="full">
12965           <doc xml:whitespace="preserve">a new #GFile that is a duplicate of the given #GFile.</doc>
12966           <type name="File" c:type="GFile*"/>
12967         </return-value>
12968       </virtual-method>
12969       <virtual-method name="eject_mountable"
12970                       invoker="eject_mountable"
12971                       deprecated="Use g_file_eject_mountable_with_operation() instead."
12972                       deprecated-version="2.22">
12973         <doc xml:whitespace="preserve">Starts an asynchronous eject on a mountable.
12974 When this operation has completed, @callback will be called with
12975 g_file_eject_mountable_finish().
12976 If @cancellable is not %NULL, then the operation can be cancelled by
12977 triggering the cancellable object from another thread. If the operation
12978 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
12979         <return-value transfer-ownership="none">
12980           <type name="none" c:type="void"/>
12981         </return-value>
12982         <parameters>
12983           <parameter name="flags" transfer-ownership="none">
12984             <doc xml:whitespace="preserve">flags affecting the operation</doc>
12985             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
12986           </parameter>
12987           <parameter name="cancellable"
12988                      transfer-ownership="none"
12989                      allow-none="1">
12990             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
12991             <type name="Cancellable" c:type="GCancellable*"/>
12992           </parameter>
12993           <parameter name="callback"
12994                      transfer-ownership="none"
12995                      scope="async"
12996                      closure="3">
12997             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
12998             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
12999           </parameter>
13000           <parameter name="user_data" transfer-ownership="none" closure="3">
13001             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
13002             <type name="gpointer" c:type="gpointer"/>
13003           </parameter>
13004         </parameters>
13005       </virtual-method>
13006       <virtual-method name="eject_mountable_finish"
13007                       invoker="eject_mountable_finish"
13008                       deprecated="Use g_file_eject_mountable_with_operation_finish() instead."
13009                       deprecated-version="2.22"
13010                       throws="1">
13011         <doc xml:whitespace="preserve">Finishes an asynchronous eject operation started by
13012 g_file_eject_mountable().
13013 otherwise.</doc>
13014         <return-value transfer-ownership="none">
13015           <doc xml:whitespace="preserve">%TRUE if the @file was ejected successfully. %FALSE</doc>
13016           <type name="gboolean" c:type="gboolean"/>
13017         </return-value>
13018         <parameters>
13019           <parameter name="result" transfer-ownership="none">
13020             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
13021             <type name="AsyncResult" c:type="GAsyncResult*"/>
13022           </parameter>
13023         </parameters>
13024       </virtual-method>
13025       <virtual-method name="eject_mountable_with_operation"
13026                       invoker="eject_mountable_with_operation"
13027                       version="2.22">
13028         <doc xml:whitespace="preserve">Starts an asynchronous eject on a mountable.
13029 When this operation has completed, @callback will be called with
13030 g_file_eject_mountable_with_operation_finish().
13031 If @cancellable is not %NULL, then the operation can be cancelled by
13032 triggering the cancellable object from another thread. If the operation
13033 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
13034         <return-value transfer-ownership="none">
13035           <type name="none" c:type="void"/>
13036         </return-value>
13037         <parameters>
13038           <parameter name="flags" transfer-ownership="none">
13039             <doc xml:whitespace="preserve">flags affecting the operation</doc>
13040             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
13041           </parameter>
13042           <parameter name="mount_operation" transfer-ownership="none">
13043             <doc xml:whitespace="preserve">a #GMountOperation, or %NULL to avoid user interaction.</doc>
13044             <type name="MountOperation" c:type="GMountOperation*"/>
13045           </parameter>
13046           <parameter name="cancellable"
13047                      transfer-ownership="none"
13048                      allow-none="1">
13049             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
13050             <type name="Cancellable" c:type="GCancellable*"/>
13051           </parameter>
13052           <parameter name="callback"
13053                      transfer-ownership="none"
13054                      scope="async"
13055                      closure="4">
13056             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
13057             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
13058           </parameter>
13059           <parameter name="user_data" transfer-ownership="none" closure="4">
13060             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
13061             <type name="gpointer" c:type="gpointer"/>
13062           </parameter>
13063         </parameters>
13064       </virtual-method>
13065       <virtual-method name="eject_mountable_with_operation_finish"
13066                       invoker="eject_mountable_with_operation_finish"
13067                       version="2.22"
13068                       throws="1">
13069         <doc xml:whitespace="preserve">Finishes an asynchronous eject operation started by
13070 g_file_eject_mountable_with_operation().
13071 otherwise.</doc>
13072         <return-value transfer-ownership="none">
13073           <doc xml:whitespace="preserve">%TRUE if the @file was ejected successfully. %FALSE</doc>
13074           <type name="gboolean" c:type="gboolean"/>
13075         </return-value>
13076         <parameters>
13077           <parameter name="result" transfer-ownership="none">
13078             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
13079             <type name="AsyncResult" c:type="GAsyncResult*"/>
13080           </parameter>
13081         </parameters>
13082       </virtual-method>
13083       <virtual-method name="enumerate_children"
13084                       invoker="enumerate_children"
13085                       throws="1">
13086         <doc xml:whitespace="preserve">Gets the requested information about the files in a directory. The result
13087 is a #GFileEnumerator object that will give out #GFileInfo objects for
13088 all the files in the directory.
13089 The @attributes value is a string that specifies the file attributes that
13090 should be gathered. It is not an error if it's not possible to read a particular
13091 requested attribute from a file - it just won't be set. @attributes should
13092 be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
13093 means all attributes, and a wildcard like "standard::*" means all attributes in the standard
13094 namespace. An example attribute query be "standard::*,owner::user".
13095 The standard attributes are available as defines, like #G_FILE_ATTRIBUTE_STANDARD_NAME.
13096 If @cancellable is not %NULL, then the operation can be cancelled by
13097 triggering the cancellable object from another thread. If the operation
13098 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
13099 If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
13100 If the file is not a directory, the G_FILE_ERROR_NOTDIR error will be returned.
13101 Other errors are possible too.
13102 Free the returned object with g_object_unref().</doc>
13103         <return-value transfer-ownership="full">
13104           <doc xml:whitespace="preserve">A #GFileEnumerator if successful, %NULL on error.</doc>
13105           <type name="FileEnumerator" c:type="GFileEnumerator*"/>
13106         </return-value>
13107         <parameters>
13108           <parameter name="attributes" transfer-ownership="none">
13109             <doc xml:whitespace="preserve">an attribute query string.</doc>
13110             <type name="utf8" c:type="char*"/>
13111           </parameter>
13112           <parameter name="flags" transfer-ownership="none">
13113             <doc xml:whitespace="preserve">a set of #GFileQueryInfoFlags.</doc>
13114             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
13115           </parameter>
13116           <parameter name="cancellable"
13117                      transfer-ownership="none"
13118                      allow-none="1">
13119             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
13120             <type name="Cancellable" c:type="GCancellable*"/>
13121           </parameter>
13122         </parameters>
13123       </virtual-method>
13124       <virtual-method name="enumerate_children_async"
13125                       invoker="enumerate_children_async">
13126         <doc xml:whitespace="preserve">Asynchronously gets the requested information about the files in a directory. The result
13127 is a #GFileEnumerator object that will give out #GFileInfo objects for
13128 all the files in the directory.
13129 For more details, see g_file_enumerate_children() which is
13130 the synchronous version of this call.
13131 When the operation is finished, @callback will be called. You can then call
13132 g_file_enumerate_children_finish() to get the result of the operation.</doc>
13133         <return-value transfer-ownership="none">
13134           <type name="none" c:type="void"/>
13135         </return-value>
13136         <parameters>
13137           <parameter name="attributes" transfer-ownership="none">
13138             <doc xml:whitespace="preserve">an attribute query string.</doc>
13139             <type name="utf8" c:type="char*"/>
13140           </parameter>
13141           <parameter name="flags" transfer-ownership="none">
13142             <doc xml:whitespace="preserve">a set of #GFileQueryInfoFlags.</doc>
13143             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
13144           </parameter>
13145           <parameter name="io_priority" transfer-ownership="none">
13146             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
13147             <type name="gint" c:type="int"/>
13148           </parameter>
13149           <parameter name="cancellable"
13150                      transfer-ownership="none"
13151                      allow-none="1">
13152             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
13153             <type name="Cancellable" c:type="GCancellable*"/>
13154           </parameter>
13155           <parameter name="callback"
13156                      transfer-ownership="none"
13157                      scope="async"
13158                      closure="5">
13159             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
13160             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
13161           </parameter>
13162           <parameter name="user_data" transfer-ownership="none" closure="5">
13163             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
13164             <type name="gpointer" c:type="gpointer"/>
13165           </parameter>
13166         </parameters>
13167       </virtual-method>
13168       <virtual-method name="enumerate_children_finish"
13169                       invoker="enumerate_children_finish"
13170                       throws="1">
13171         <doc xml:whitespace="preserve">Finishes an async enumerate children operation.
13172 See g_file_enumerate_children_async().
13173 Free the returned object with g_object_unref().</doc>
13174         <return-value transfer-ownership="full">
13175           <doc xml:whitespace="preserve">a #GFileEnumerator or %NULL if an error occurred.</doc>
13176           <type name="FileEnumerator" c:type="GFileEnumerator*"/>
13177         </return-value>
13178         <parameters>
13179           <parameter name="res" transfer-ownership="none">
13180             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
13181             <type name="AsyncResult" c:type="GAsyncResult*"/>
13182           </parameter>
13183         </parameters>
13184       </virtual-method>
13185       <virtual-method name="equal" invoker="equal">
13186         <doc xml:whitespace="preserve">Checks equality of two given #GFile&lt;!-- --&gt;s. Note that two
13187 #GFile&lt;!-- --&gt;s that differ can still refer to the same
13188 file on the filesystem due to various forms of filename
13189 aliasing.
13190 This call does no blocking i/o.
13191 %FALSE if either is not a #GFile.</doc>
13192         <return-value transfer-ownership="none">
13193           <doc xml:whitespace="preserve">%TRUE if @file1 and @file2 are equal.</doc>
13194           <type name="gboolean" c:type="gboolean"/>
13195         </return-value>
13196         <parameters>
13197           <parameter name="file2" transfer-ownership="none">
13198             <doc xml:whitespace="preserve">the second #GFile.</doc>
13199             <type name="File" c:type="GFile*"/>
13200           </parameter>
13201         </parameters>
13202       </virtual-method>
13203       <virtual-method name="find_enclosing_mount"
13204                       invoker="find_enclosing_mount"
13205                       throws="1">
13206         <doc xml:whitespace="preserve">Gets a #GMount for the #GFile.
13207 If the #GFileIface for @file does not have a mount (e.g. possibly a
13208 remote share), @error will be set to %G_IO_ERROR_NOT_FOUND and %NULL
13209 will be returned.
13210 If @cancellable is not %NULL, then the operation can be cancelled by
13211 triggering the cancellable object from another thread. If the operation
13212 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
13213 Free the returned object with g_object_unref().</doc>
13214         <return-value transfer-ownership="full">
13215           <doc xml:whitespace="preserve">a #GMount where the @file is located or %NULL on error.</doc>
13216           <type name="Mount" c:type="GMount*"/>
13217         </return-value>
13218         <parameters>
13219           <parameter name="cancellable"
13220                      transfer-ownership="none"
13221                      allow-none="1">
13222             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
13223             <type name="Cancellable" c:type="GCancellable*"/>
13224           </parameter>
13225         </parameters>
13226       </virtual-method>
13227       <virtual-method name="find_enclosing_mount_async"
13228                       invoker="find_enclosing_mount_async">
13229         <doc xml:whitespace="preserve">Asynchronously gets the mount for the file.
13230 For more details, see g_file_find_enclosing_mount() which is
13231 the synchronous version of this call.
13232 When the operation is finished, @callback will be called. You can then call
13233 g_file_find_enclosing_mount_finish() to get the result of the operation.</doc>
13234         <return-value transfer-ownership="none">
13235           <type name="none" c:type="void"/>
13236         </return-value>
13237         <parameters>
13238           <parameter name="io_priority" transfer-ownership="none">
13239             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
13240             <type name="gint" c:type="int"/>
13241           </parameter>
13242           <parameter name="cancellable"
13243                      transfer-ownership="none"
13244                      allow-none="1">
13245             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
13246             <type name="Cancellable" c:type="GCancellable*"/>
13247           </parameter>
13248           <parameter name="callback"
13249                      transfer-ownership="none"
13250                      scope="async"
13251                      closure="3">
13252             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
13253             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
13254           </parameter>
13255           <parameter name="user_data" transfer-ownership="none" closure="3">
13256             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
13257             <type name="gpointer" c:type="gpointer"/>
13258           </parameter>
13259         </parameters>
13260       </virtual-method>
13261       <virtual-method name="find_enclosing_mount_finish"
13262                       invoker="find_enclosing_mount_finish"
13263                       throws="1">
13264         <doc xml:whitespace="preserve">Finishes an asynchronous find mount request.
13265 See g_file_find_enclosing_mount_async().
13266 Free the returned object with g_object_unref().</doc>
13267         <return-value transfer-ownership="full">
13268           <doc xml:whitespace="preserve">#GMount for given @file or %NULL on error.</doc>
13269           <type name="Mount" c:type="GMount*"/>
13270         </return-value>
13271         <parameters>
13272           <parameter name="res" transfer-ownership="none">
13273             <doc xml:whitespace="preserve">a #GAsyncResult</doc>
13274             <type name="AsyncResult" c:type="GAsyncResult*"/>
13275           </parameter>
13276         </parameters>
13277       </virtual-method>
13278       <virtual-method name="get_basename" invoker="get_basename">
13279         <doc xml:whitespace="preserve">Gets the base name (the last component of the path) for a given #GFile.
13280 If called for the top level of a system (such as the filesystem root
13281 or a uri like sftp://host/) it will return a single directory separator
13282 (and on Windows, possibly a drive letter).
13283 The base name is a byte string (*not* UTF-8). It has no defined encoding
13284 or rules other than it may not contain zero bytes.  If you want to use
13285 filenames in a user interface you should use the display name that you
13286 can get by requesting the %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME
13287 attribute with g_file_query_info().
13288 This call does no blocking i/o.
13289 if given #GFile is invalid. The returned string should be
13290 freed with g_free() when no longer needed.</doc>
13291         <return-value transfer-ownership="full">
13292           <doc xml:whitespace="preserve">string containing the #GFile's base name, or %NULL</doc>
13293           <type name="utf8" c:type="char*"/>
13294         </return-value>
13295       </virtual-method>
13296       <virtual-method name="get_child_for_display_name"
13297                       invoker="get_child_for_display_name"
13298                       throws="1">
13299         <doc xml:whitespace="preserve">Gets the child of @file for a given @display_name (i.e. a UTF8
13300 version of the name). If this function fails, it returns %NULL and @error will be
13301 set. This is very useful when constructing a GFile for a new file
13302 and the user entered the filename in the user interface, for instance
13303 when you select a directory and type a filename in the file selector.
13304 This call does no blocking i/o.
13305 %NULL if the display name couldn't be converted.
13306 Free the returned object with g_object_unref().</doc>
13307         <return-value transfer-ownership="full">
13308           <doc xml:whitespace="preserve">a #GFile to the specified child, or</doc>
13309           <type name="File" c:type="GFile*"/>
13310         </return-value>
13311         <parameters>
13312           <parameter name="display_name" transfer-ownership="none">
13313             <doc xml:whitespace="preserve">string to a possible child.</doc>
13314             <type name="utf8" c:type="char*"/>
13315           </parameter>
13316         </parameters>
13317       </virtual-method>
13318       <virtual-method name="get_parent" invoker="get_parent">
13319         <doc xml:whitespace="preserve">Gets the parent directory for the @file.
13320 If the @file represents the root directory of the
13321 file system, then %NULL will be returned.
13322 This call does no blocking i/o.
13323 #GFile or %NULL if there is no parent.
13324 Free the returned object with g_object_unref().</doc>
13325         <return-value transfer-ownership="full">
13326           <doc xml:whitespace="preserve">a #GFile structure to the parent of the given</doc>
13327           <type name="File" c:type="GFile*"/>
13328         </return-value>
13329       </virtual-method>
13330       <virtual-method name="get_parse_name" invoker="get_parse_name">
13331         <doc xml:whitespace="preserve">Gets the parse name of the @file.
13332 A parse name is a UTF-8 string that describes the
13333 file such that one can get the #GFile back using
13334 g_file_parse_name().
13335 This is generally used to show the #GFile as a nice
13336 full-pathname kind of string in a user interface,
13337 like in a location entry.
13338 For local files with names that can safely be converted
13339 to UTF8 the pathname is used, otherwise the IRI is used
13340 (a form of URI that allows UTF8 characters unescaped).
13341 This call does no blocking i/o.
13342 string should be freed with g_free() when no longer needed.</doc>
13343         <return-value transfer-ownership="full">
13344           <doc xml:whitespace="preserve">a string containing the #GFile's parse name. The returned</doc>
13345           <type name="utf8" c:type="char*"/>
13346         </return-value>
13347       </virtual-method>
13348       <virtual-method name="get_path" invoker="get_path">
13349         <doc xml:whitespace="preserve">Gets the local pathname for #GFile, if one exists.
13350 This call does no blocking i/o.
13351 no such path exists. The returned string should be
13352 freed with g_free() when no longer needed.</doc>
13353         <return-value transfer-ownership="full">
13354           <doc xml:whitespace="preserve">string containing the #GFile's path, or %NULL if</doc>
13355           <type name="utf8" c:type="char*"/>
13356         </return-value>
13357       </virtual-method>
13358       <virtual-method name="get_relative_path" invoker="get_relative_path">
13359         <doc xml:whitespace="preserve">Gets the path for @descendant relative to @parent.
13360 This call does no blocking i/o.
13361 to @parent, or %NULL if @descendant doesn't have @parent as prefix.
13362 The returned string should be freed with g_free() when no longer needed.</doc>
13363         <return-value transfer-ownership="full">
13364           <doc xml:whitespace="preserve">string with the relative path from @descendant</doc>
13365           <type name="utf8" c:type="char*"/>
13366         </return-value>
13367         <parameters>
13368           <parameter name="descendant" transfer-ownership="none">
13369             <doc xml:whitespace="preserve">input #GFile.</doc>
13370             <type name="File" c:type="GFile*"/>
13371           </parameter>
13372         </parameters>
13373       </virtual-method>
13374       <virtual-method name="get_uri" invoker="get_uri">
13375         <doc xml:whitespace="preserve">Gets the URI for the @file.
13376 This call does no blocking i/o.
13377 The returned string should be freed with g_free() when no longer needed.</doc>
13378         <return-value transfer-ownership="full">
13379           <doc xml:whitespace="preserve">a string containing the #GFile's URI.</doc>
13380           <type name="utf8" c:type="char*"/>
13381         </return-value>
13382       </virtual-method>
13383       <virtual-method name="get_uri_scheme" invoker="get_uri_scheme">
13384         <doc xml:whitespace="preserve">Gets the URI scheme for a #GFile.
13385 RFC 3986 decodes the scheme as:
13386 &lt;programlisting&gt;
13387 URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ]
13388 &lt;/programlisting&gt;
13389 Common schemes include "file", "http", "ftp", etc.
13390 This call does no blocking i/o.
13391 #GFile. The returned string should be freed with g_free()
13392 when no longer needed.</doc>
13393         <return-value transfer-ownership="full">
13394           <doc xml:whitespace="preserve">a string containing the URI scheme for the given</doc>
13395           <type name="utf8" c:type="char*"/>
13396         </return-value>
13397       </virtual-method>
13398       <virtual-method name="has_uri_scheme" invoker="has_uri_scheme">
13399         <doc xml:whitespace="preserve">Checks to see if a #GFile has a given URI scheme.
13400 This call does no blocking i/o.
13401 given URI scheme, %FALSE if URI scheme is %NULL,
13402 not supported, or #GFile is invalid.</doc>
13403         <return-value transfer-ownership="none">
13404           <doc xml:whitespace="preserve">%TRUE if #GFile's backend supports the</doc>
13405           <type name="gboolean" c:type="gboolean"/>
13406         </return-value>
13407         <parameters>
13408           <parameter name="uri_scheme" transfer-ownership="none">
13409             <doc xml:whitespace="preserve">a string containing a URI scheme.</doc>
13410             <type name="utf8" c:type="char*"/>
13411           </parameter>
13412         </parameters>
13413       </virtual-method>
13414       <virtual-method name="hash">
13415         <return-value transfer-ownership="none">
13416           <type name="guint" c:type="guint"/>
13417         </return-value>
13418       </virtual-method>
13419       <virtual-method name="is_native" invoker="is_native">
13420         <doc xml:whitespace="preserve">Checks to see if a file is native to the platform.
13421 A native file s one expressed in the platform-native filename format,
13422 e.g. "C:\Windows" or "/usr/bin/". This does not mean the file is local,
13423 as it might be on a locally mounted remote filesystem.
13424 On some systems non-native files may be available using
13425 the native filesystem via a userspace filesystem (FUSE), in
13426 these cases this call will return %FALSE, but g_file_get_path()
13427 will still return a native path.
13428 This call does no blocking i/o.</doc>
13429         <return-value transfer-ownership="none">
13430           <doc xml:whitespace="preserve">%TRUE if file is native.</doc>
13431           <type name="gboolean" c:type="gboolean"/>
13432         </return-value>
13433       </virtual-method>
13434       <virtual-method name="make_directory"
13435                       invoker="make_directory"
13436                       throws="1">
13437         <return-value transfer-ownership="none">
13438           <type name="gboolean" c:type="gboolean"/>
13439         </return-value>
13440         <parameters>
13441           <parameter name="cancellable"
13442                      transfer-ownership="none"
13443                      allow-none="1">
13444             <type name="Cancellable" c:type="GCancellable*"/>
13445           </parameter>
13446         </parameters>
13447       </virtual-method>
13448       <virtual-method name="make_symbolic_link"
13449                       invoker="make_symbolic_link"
13450                       throws="1">
13451         <doc xml:whitespace="preserve">Creates a symbolic link named @file which contains the string
13452 If @cancellable is not %NULL, then the operation can be cancelled by
13453 triggering the cancellable object from another thread. If the operation
13454 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
13455         <return-value transfer-ownership="none">
13456           <doc xml:whitespace="preserve">%TRUE on the creation of a new symlink, %FALSE otherwise.</doc>
13457           <type name="gboolean" c:type="gboolean"/>
13458         </return-value>
13459         <parameters>
13460           <parameter name="symlink_value" transfer-ownership="none">
13461             <doc xml:whitespace="preserve">a string with the path for the target of the new symlink</doc>
13462             <type name="utf8" c:type="char*"/>
13463           </parameter>
13464           <parameter name="cancellable"
13465                      transfer-ownership="none"
13466                      allow-none="1">
13467             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
13468             <type name="Cancellable" c:type="GCancellable*"/>
13469           </parameter>
13470         </parameters>
13471       </virtual-method>
13472       <virtual-method name="monitor_dir"
13473                       invoker="monitor_directory"
13474                       throws="1">
13475         <doc xml:whitespace="preserve">Obtains a directory monitor for the given file.
13476 This may fail if directory monitoring is not supported.
13477 If @cancellable is not %NULL, then the operation can be cancelled by
13478 triggering the cancellable object from another thread. If the operation
13479 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
13480 Free the returned object with g_object_unref().</doc>
13481         <return-value transfer-ownership="full">
13482           <doc xml:whitespace="preserve">a #GFileMonitor for the given @file, or %NULL on error.</doc>
13483           <type name="FileMonitor" c:type="GFileMonitor*"/>
13484         </return-value>
13485         <parameters>
13486           <parameter name="flags" transfer-ownership="none">
13487             <doc xml:whitespace="preserve">a set of #GFileMonitorFlags.</doc>
13488             <type name="FileMonitorFlags" c:type="GFileMonitorFlags"/>
13489           </parameter>
13490           <parameter name="cancellable"
13491                      transfer-ownership="none"
13492                      allow-none="1">
13493             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
13494             <type name="Cancellable" c:type="GCancellable*"/>
13495           </parameter>
13496         </parameters>
13497       </virtual-method>
13498       <virtual-method name="monitor_file" invoker="monitor_file" throws="1">
13499         <doc xml:whitespace="preserve">Obtains a file monitor for the given file. If no file notification
13500 mechanism exists, then regular polling of the file is used.
13501 If @cancellable is not %NULL, then the operation can be cancelled by
13502 triggering the cancellable object from another thread. If the operation
13503 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
13504 Free the returned object with g_object_unref().</doc>
13505         <return-value transfer-ownership="full">
13506           <doc xml:whitespace="preserve">a #GFileMonitor for the given @file, or %NULL on error.</doc>
13507           <type name="FileMonitor" c:type="GFileMonitor*"/>
13508         </return-value>
13509         <parameters>
13510           <parameter name="flags" transfer-ownership="none">
13511             <doc xml:whitespace="preserve">a set of #GFileMonitorFlags.</doc>
13512             <type name="FileMonitorFlags" c:type="GFileMonitorFlags"/>
13513           </parameter>
13514           <parameter name="cancellable"
13515                      transfer-ownership="none"
13516                      allow-none="1">
13517             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
13518             <type name="Cancellable" c:type="GCancellable*"/>
13519           </parameter>
13520         </parameters>
13521       </virtual-method>
13522       <virtual-method name="mount_enclosing_volume"
13523                       invoker="mount_enclosing_volume">
13524         <doc xml:whitespace="preserve">Starts a @mount_operation, mounting the volume that contains the file @location.
13525 When this operation has completed, @callback will be called with
13526 g_file_mount_enclosing_volume_finish().
13527 If @cancellable is not %NULL, then the operation can be cancelled by
13528 triggering the cancellable object from another thread. If the operation
13529 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
13530         <return-value transfer-ownership="none">
13531           <type name="none" c:type="void"/>
13532         </return-value>
13533         <parameters>
13534           <parameter name="flags" transfer-ownership="none">
13535             <doc xml:whitespace="preserve">flags affecting the operation</doc>
13536             <type name="MountMountFlags" c:type="GMountMountFlags"/>
13537           </parameter>
13538           <parameter name="mount_operation" transfer-ownership="none">
13539             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
13540             <type name="MountOperation" c:type="GMountOperation*"/>
13541           </parameter>
13542           <parameter name="cancellable"
13543                      transfer-ownership="none"
13544                      allow-none="1">
13545             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
13546             <type name="Cancellable" c:type="GCancellable*"/>
13547           </parameter>
13548           <parameter name="callback"
13549                      transfer-ownership="none"
13550                      scope="async"
13551                      closure="4">
13552             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
13553             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
13554           </parameter>
13555           <parameter name="user_data" transfer-ownership="none" closure="4">
13556             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
13557             <type name="gpointer" c:type="gpointer"/>
13558           </parameter>
13559         </parameters>
13560       </virtual-method>
13561       <virtual-method name="mount_enclosing_volume_finish"
13562                       invoker="mount_enclosing_volume_finish"
13563                       throws="1">
13564         <doc xml:whitespace="preserve">Finishes a mount operation started by g_file_mount_enclosing_volume().
13565 has occurred, this function will return %FALSE and set @error
13566 appropriately if present.</doc>
13567         <return-value transfer-ownership="none">
13568           <doc xml:whitespace="preserve">%TRUE if successful. If an error</doc>
13569           <type name="gboolean" c:type="gboolean"/>
13570         </return-value>
13571         <parameters>
13572           <parameter name="result" transfer-ownership="none">
13573             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
13574             <type name="AsyncResult" c:type="GAsyncResult*"/>
13575           </parameter>
13576         </parameters>
13577       </virtual-method>
13578       <virtual-method name="mount_mountable" invoker="mount_mountable">
13579         <doc xml:whitespace="preserve">Mounts a file of type G_FILE_TYPE_MOUNTABLE.
13580 Using @mount_operation, you can request callbacks when, for instance,
13581 passwords are needed during authentication.
13582 If @cancellable is not %NULL, then the operation can be cancelled by
13583 triggering the cancellable object from another thread. If the operation
13584 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
13585 When the operation is finished, @callback will be called. You can then call
13586 g_file_mount_mountable_finish() to get the result of the operation.</doc>
13587         <return-value transfer-ownership="none">
13588           <type name="none" c:type="void"/>
13589         </return-value>
13590         <parameters>
13591           <parameter name="flags" transfer-ownership="none">
13592             <doc xml:whitespace="preserve">flags affecting the operation</doc>
13593             <type name="MountMountFlags" c:type="GMountMountFlags"/>
13594           </parameter>
13595           <parameter name="mount_operation" transfer-ownership="none">
13596             <doc xml:whitespace="preserve">a #GMountOperation, or %NULL to avoid user interaction.</doc>
13597             <type name="MountOperation" c:type="GMountOperation*"/>
13598           </parameter>
13599           <parameter name="cancellable"
13600                      transfer-ownership="none"
13601                      allow-none="1">
13602             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
13603             <type name="Cancellable" c:type="GCancellable*"/>
13604           </parameter>
13605           <parameter name="callback"
13606                      transfer-ownership="none"
13607                      scope="async"
13608                      closure="4">
13609             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
13610             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
13611           </parameter>
13612           <parameter name="user_data" transfer-ownership="none" closure="4">
13613             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
13614             <type name="gpointer" c:type="gpointer"/>
13615           </parameter>
13616         </parameters>
13617       </virtual-method>
13618       <virtual-method name="mount_mountable_finish"
13619                       invoker="mount_mountable_finish"
13620                       throws="1">
13621         <doc xml:whitespace="preserve">Finishes a mount operation. See g_file_mount_mountable() for details.
13622 Finish an asynchronous mount operation that was started
13623 with g_file_mount_mountable().
13624 Free the returned object with g_object_unref().</doc>
13625         <return-value transfer-ownership="full">
13626           <doc xml:whitespace="preserve">a #GFile or %NULL on error.</doc>
13627           <type name="File" c:type="GFile*"/>
13628         </return-value>
13629         <parameters>
13630           <parameter name="result" transfer-ownership="none">
13631             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
13632             <type name="AsyncResult" c:type="GAsyncResult*"/>
13633           </parameter>
13634         </parameters>
13635       </virtual-method>
13636       <virtual-method name="move" invoker="move" introspectable="0" throws="1">
13637         <doc xml:whitespace="preserve">Tries to move the file or directory @source to the location specified by @destination.
13638 If native move operations are supported then this is used, otherwise a copy + delete
13639 fallback is used. The native implementation may support moving directories (for instance
13640 on moves inside the same filesystem), but the fallback code does not.
13641 If the flag #G_FILE_COPY_OVERWRITE is specified an already
13642 existing @destination file is overwritten.
13643 If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
13644 will be copied as symlinks, otherwise the target of the
13645 If @cancellable is not %NULL, then the operation can be cancelled by
13646 triggering the cancellable object from another thread. If the operation
13647 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
13648 If @progress_callback is not %NULL, then the operation can be monitored by
13649 setting this to a #GFileProgressCallback function. @progress_callback_data
13650 will be passed to this function. It is guaranteed that this callback will
13651 be called after all data has been transferred with the total number of bytes
13652 copied during the operation.
13653 If the @source file does not exist then the G_IO_ERROR_NOT_FOUND
13654 error is returned, independent on the status of the @destination.
13655 If #G_FILE_COPY_OVERWRITE is not specified and the target exists, then the
13656 error G_IO_ERROR_EXISTS is returned.
13657 If trying to overwrite a file over a directory the G_IO_ERROR_IS_DIRECTORY
13658 error is returned. If trying to overwrite a directory with a directory the
13659 G_IO_ERROR_WOULD_MERGE error is returned.
13660 If the source is a directory and the target does not exist, or #G_FILE_COPY_OVERWRITE is
13661 specified and the target is a file, then the G_IO_ERROR_WOULD_RECURSE error
13662 may be returned (if the native move operation isn't available).</doc>
13663         <return-value transfer-ownership="none">
13664           <doc xml:whitespace="preserve">%TRUE on successful move, %FALSE otherwise.</doc>
13665           <type name="gboolean" c:type="gboolean"/>
13666         </return-value>
13667         <parameters>
13668           <parameter name="destination" transfer-ownership="none">
13669             <doc xml:whitespace="preserve">#GFile pointing to the destination location.</doc>
13670             <type name="File" c:type="GFile*"/>
13671           </parameter>
13672           <parameter name="flags" transfer-ownership="none">
13673             <doc xml:whitespace="preserve">set of #GFileCopyFlags.</doc>
13674             <type name="FileCopyFlags" c:type="GFileCopyFlags"/>
13675           </parameter>
13676           <parameter name="cancellable"
13677                      transfer-ownership="none"
13678                      allow-none="1">
13679             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
13680             <type name="Cancellable" c:type="GCancellable*"/>
13681           </parameter>
13682           <parameter name="progress_callback"
13683                      transfer-ownership="none"
13684                      closure="4">
13685             <doc xml:whitespace="preserve">#GFileProgressCallback function for updates.</doc>
13686             <type name="FileProgressCallback" c:type="GFileProgressCallback"/>
13687           </parameter>
13688           <parameter name="progress_callback_data" transfer-ownership="none">
13689             <doc xml:whitespace="preserve">gpointer to user data for the callback function.</doc>
13690             <type name="gpointer" c:type="gpointer"/>
13691           </parameter>
13692         </parameters>
13693       </virtual-method>
13694       <virtual-method name="open_readwrite"
13695                       invoker="open_readwrite"
13696                       version="2.22"
13697                       throws="1">
13698         <doc xml:whitespace="preserve">Opens an existing file for reading and writing. The result is
13699 a #GFileIOStream that can be used to read and write the contents of the file.
13700 If @cancellable is not %NULL, then the operation can be cancelled by
13701 triggering the cancellable object from another thread. If the operation
13702 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
13703 If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
13704 If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned.
13705 Other errors are possible too, and depend on what kind of filesystem the file is on.
13706 Note that in many non-local file cases read and write streams are not supported,
13707 so make sure you really need to do read and write streaming, rather than
13708 just opening for reading or writing.
13709 Free the returned object with g_object_unref().</doc>
13710         <return-value transfer-ownership="full">
13711           <doc xml:whitespace="preserve">#GFileIOStream or %NULL on error.</doc>
13712           <type name="FileIOStream" c:type="GFileIOStream*"/>
13713         </return-value>
13714         <parameters>
13715           <parameter name="cancellable"
13716                      transfer-ownership="none"
13717                      allow-none="1">
13718             <doc xml:whitespace="preserve">a #GCancellable</doc>
13719             <type name="Cancellable" c:type="GCancellable*"/>
13720           </parameter>
13721         </parameters>
13722       </virtual-method>
13723       <virtual-method name="open_readwrite_async"
13724                       invoker="open_readwrite_async"
13725                       version="2.22">
13726         <doc xml:whitespace="preserve">Asynchronously opens @file for reading and writing.
13727 For more details, see g_file_open_readwrite() which is
13728 the synchronous version of this call.
13729 When the operation is finished, @callback will be called. You can then call
13730 g_file_open_readwrite_finish() to get the result of the operation.</doc>
13731         <return-value transfer-ownership="none">
13732           <type name="none" c:type="void"/>
13733         </return-value>
13734         <parameters>
13735           <parameter name="io_priority" transfer-ownership="none">
13736             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
13737             <type name="gint" c:type="int"/>
13738           </parameter>
13739           <parameter name="cancellable"
13740                      transfer-ownership="none"
13741                      allow-none="1">
13742             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
13743             <type name="Cancellable" c:type="GCancellable*"/>
13744           </parameter>
13745           <parameter name="callback"
13746                      transfer-ownership="none"
13747                      scope="async"
13748                      closure="3">
13749             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
13750             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
13751           </parameter>
13752           <parameter name="user_data" transfer-ownership="none" closure="3">
13753             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
13754             <type name="gpointer" c:type="gpointer"/>
13755           </parameter>
13756         </parameters>
13757       </virtual-method>
13758       <virtual-method name="open_readwrite_finish"
13759                       invoker="open_readwrite_finish"
13760                       version="2.22"
13761                       throws="1">
13762         <doc xml:whitespace="preserve">Finishes an asynchronous file read operation started with
13763 g_file_open_readwrite_async().
13764 Free the returned object with g_object_unref().</doc>
13765         <return-value transfer-ownership="full">
13766           <doc xml:whitespace="preserve">a #GFileIOStream or %NULL on error.</doc>
13767           <type name="FileIOStream" c:type="GFileIOStream*"/>
13768         </return-value>
13769         <parameters>
13770           <parameter name="res" transfer-ownership="none">
13771             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
13772             <type name="AsyncResult" c:type="GAsyncResult*"/>
13773           </parameter>
13774         </parameters>
13775       </virtual-method>
13776       <virtual-method name="poll_mountable"
13777                       invoker="poll_mountable"
13778                       version="2.22">
13779         <doc xml:whitespace="preserve">Polls a file of type G_FILE_TYPE_MOUNTABLE.
13780 If @cancellable is not %NULL, then the operation can be cancelled by
13781 triggering the cancellable object from another thread. If the operation
13782 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
13783 When the operation is finished, @callback will be called. You can then call
13784 g_file_mount_mountable_finish() to get the result of the operation.</doc>
13785         <return-value transfer-ownership="none">
13786           <type name="none" c:type="void"/>
13787         </return-value>
13788         <parameters>
13789           <parameter name="cancellable"
13790                      transfer-ownership="none"
13791                      allow-none="1">
13792             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
13793             <type name="Cancellable" c:type="GCancellable*"/>
13794           </parameter>
13795           <parameter name="callback"
13796                      transfer-ownership="none"
13797                      scope="async"
13798                      closure="2">
13799             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
13800             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
13801           </parameter>
13802           <parameter name="user_data" transfer-ownership="none" closure="2">
13803             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
13804             <type name="gpointer" c:type="gpointer"/>
13805           </parameter>
13806         </parameters>
13807       </virtual-method>
13808       <virtual-method name="poll_mountable_finish"
13809                       invoker="poll_mountable_finish"
13810                       version="2.22"
13811                       throws="1">
13812         <doc xml:whitespace="preserve">Finishes a poll operation. See g_file_poll_mountable() for details.
13813 Finish an asynchronous poll operation that was polled
13814 with g_file_poll_mountable().
13815 otherwise.</doc>
13816         <return-value transfer-ownership="none">
13817           <doc xml:whitespace="preserve">%TRUE if the operation finished successfully. %FALSE</doc>
13818           <type name="gboolean" c:type="gboolean"/>
13819         </return-value>
13820         <parameters>
13821           <parameter name="result" transfer-ownership="none">
13822             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
13823             <type name="AsyncResult" c:type="GAsyncResult*"/>
13824           </parameter>
13825         </parameters>
13826       </virtual-method>
13827       <virtual-method name="prefix_matches" invoker="has_prefix">
13828         <doc xml:whitespace="preserve">Checks whether @file has the prefix specified by @prefix. In other word,
13829 if the names of inital elements of @file&lt;!-- --&gt;s pathname match @prefix.
13830 Only full pathname elements are matched, so a path like /foo is not
13831 considered a prefix of /foobar, only of /foo/bar.
13832 This call does no i/o, as it works purely on names. As such it can
13833 sometimes return %FALSE even if @file is inside a @prefix (from a
13834 filesystem point of view), because the prefix of @file is an alias
13835 of @prefix.
13836 %FALSE otherwise.</doc>
13837         <return-value transfer-ownership="none">
13838           <doc xml:whitespace="preserve">%TRUE if the @files's parent, grandparent, etc is @prefix.</doc>
13839           <type name="gboolean" c:type="gboolean"/>
13840         </return-value>
13841         <parameters>
13842           <parameter name="file" transfer-ownership="none">
13843             <doc xml:whitespace="preserve">input #GFile.</doc>
13844             <type name="File" c:type="GFile*"/>
13845           </parameter>
13846         </parameters>
13847       </virtual-method>
13848       <virtual-method name="query_filesystem_info"
13849                       invoker="query_filesystem_info"
13850                       throws="1">
13851         <doc xml:whitespace="preserve">Similar to g_file_query_info(), but obtains information
13852 about the filesystem the @file is on, rather than the file itself.
13853 For instance the amount of space available and the type of
13854 the filesystem.
13855 The @attributes value is a string that specifies the file attributes that
13856 should be gathered. It is not an error if it's not possible to read a particular
13857 requested attribute from a file - it just won't be set. @attributes should
13858 be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
13859 means all attributes, and a wildcard like "fs:*" means all attributes in the fs
13860 namespace. The standard namespace for filesystem attributes is "fs".
13861 Common attributes of interest are #G_FILE_ATTRIBUTE_FILESYSTEM_SIZE
13862 (the total size of the filesystem in bytes), #G_FILE_ATTRIBUTE_FILESYSTEM_FREE (number of
13863 bytes available), and #G_FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem).
13864 If @cancellable is not %NULL, then the operation can be cancelled by
13865 triggering the cancellable object from another thread. If the operation
13866 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
13867 If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
13868 Other errors are possible too, and depend on what kind of filesystem the file is on.
13869 Free the returned object with g_object_unref().</doc>
13870         <return-value transfer-ownership="full">
13871           <doc xml:whitespace="preserve">a #GFileInfo or %NULL if there was an error.</doc>
13872           <type name="FileInfo" c:type="GFileInfo*"/>
13873         </return-value>
13874         <parameters>
13875           <parameter name="attributes" transfer-ownership="none">
13876             <doc xml:whitespace="preserve">an attribute query string.</doc>
13877             <type name="utf8" c:type="char*"/>
13878           </parameter>
13879           <parameter name="cancellable"
13880                      transfer-ownership="none"
13881                      allow-none="1">
13882             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
13883             <type name="Cancellable" c:type="GCancellable*"/>
13884           </parameter>
13885         </parameters>
13886       </virtual-method>
13887       <virtual-method name="query_filesystem_info_async"
13888                       invoker="query_filesystem_info_async">
13889         <doc xml:whitespace="preserve">Asynchronously gets the requested information about the filesystem
13890 that the specified @file is on. The result is a #GFileInfo object
13891 that contains key-value attributes (such as type or size for the
13892 file).
13893 For more details, see g_file_query_filesystem_info() which is the
13894 synchronous version of this call.
13895 When the operation is finished, @callback will be called. You can
13896 then call g_file_query_info_finish() to get the result of the
13897 operation.</doc>
13898         <return-value transfer-ownership="none">
13899           <type name="none" c:type="void"/>
13900         </return-value>
13901         <parameters>
13902           <parameter name="attributes" transfer-ownership="none">
13903             <doc xml:whitespace="preserve">an attribute query string.</doc>
13904             <type name="utf8" c:type="char*"/>
13905           </parameter>
13906           <parameter name="io_priority" transfer-ownership="none">
13907             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
13908             <type name="gint" c:type="int"/>
13909           </parameter>
13910           <parameter name="cancellable"
13911                      transfer-ownership="none"
13912                      allow-none="1">
13913             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
13914             <type name="Cancellable" c:type="GCancellable*"/>
13915           </parameter>
13916           <parameter name="callback"
13917                      transfer-ownership="none"
13918                      scope="async"
13919                      closure="4">
13920             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
13921             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
13922           </parameter>
13923           <parameter name="user_data" transfer-ownership="none" closure="4">
13924             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
13925             <type name="gpointer" c:type="gpointer"/>
13926           </parameter>
13927         </parameters>
13928       </virtual-method>
13929       <virtual-method name="query_filesystem_info_finish"
13930                       invoker="query_filesystem_info_finish"
13931                       throws="1">
13932         <doc xml:whitespace="preserve">Finishes an asynchronous filesystem info query.  See
13933 g_file_query_filesystem_info_async().
13934 Free the returned object with g_object_unref().</doc>
13935         <return-value transfer-ownership="full">
13936           <doc xml:whitespace="preserve">#GFileInfo for given @file or %NULL on error.</doc>
13937           <type name="FileInfo" c:type="GFileInfo*"/>
13938         </return-value>
13939         <parameters>
13940           <parameter name="res" transfer-ownership="none">
13941             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
13942             <type name="AsyncResult" c:type="GAsyncResult*"/>
13943           </parameter>
13944         </parameters>
13945       </virtual-method>
13946       <virtual-method name="query_info" invoker="query_info" throws="1">
13947         <doc xml:whitespace="preserve">Gets the requested information about specified @file. The result
13948 is a #GFileInfo object that contains key-value attributes (such as
13949 the type or size of the file).
13950 The @attributes value is a string that specifies the file attributes that
13951 should be gathered. It is not an error if it's not possible to read a particular
13952 requested attribute from a file - it just won't be set. @attributes should
13953 be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
13954 means all attributes, and a wildcard like "standard::*" means all attributes in the standard
13955 namespace. An example attribute query be "standard::*,owner::user".
13956 The standard attributes are available as defines, like #G_FILE_ATTRIBUTE_STANDARD_NAME.
13957 If @cancellable is not %NULL, then the operation can be cancelled by
13958 triggering the cancellable object from another thread. If the operation
13959 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
13960 For symlinks, normally the information about the target of the
13961 symlink is returned, rather than information about the symlink itself.
13962 However if you pass #G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS in @flags the
13963 information about the symlink itself will be returned. Also, for symlinks
13964 that point to non-existing files the information about the symlink itself
13965 will be returned.
13966 If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
13967 Other errors are possible too, and depend on what kind of filesystem the file is on.
13968 Free the returned object with g_object_unref().</doc>
13969         <return-value transfer-ownership="full">
13970           <doc xml:whitespace="preserve">a #GFileInfo for the given @file, or %NULL on error.</doc>
13971           <type name="FileInfo" c:type="GFileInfo*"/>
13972         </return-value>
13973         <parameters>
13974           <parameter name="attributes" transfer-ownership="none">
13975             <doc xml:whitespace="preserve">an attribute query string.</doc>
13976             <type name="utf8" c:type="char*"/>
13977           </parameter>
13978           <parameter name="flags" transfer-ownership="none">
13979             <doc xml:whitespace="preserve">a set of #GFileQueryInfoFlags.</doc>
13980             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
13981           </parameter>
13982           <parameter name="cancellable"
13983                      transfer-ownership="none"
13984                      allow-none="1">
13985             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
13986             <type name="Cancellable" c:type="GCancellable*"/>
13987           </parameter>
13988         </parameters>
13989       </virtual-method>
13990       <virtual-method name="query_info_async" invoker="query_info_async">
13991         <doc xml:whitespace="preserve">Asynchronously gets the requested information about specified @file. The result
13992 is a #GFileInfo object that contains key-value attributes (such as type or size
13993 for the file).
13994 For more details, see g_file_query_info() which is
13995 the synchronous version of this call.
13996 When the operation is finished, @callback will be called. You can then call
13997 g_file_query_info_finish() to get the result of the operation.</doc>
13998         <return-value transfer-ownership="none">
13999           <type name="none" c:type="void"/>
14000         </return-value>
14001         <parameters>
14002           <parameter name="attributes" transfer-ownership="none">
14003             <doc xml:whitespace="preserve">an attribute query string.</doc>
14004             <type name="utf8" c:type="char*"/>
14005           </parameter>
14006           <parameter name="flags" transfer-ownership="none">
14007             <doc xml:whitespace="preserve">a set of #GFileQueryInfoFlags.</doc>
14008             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
14009           </parameter>
14010           <parameter name="io_priority" transfer-ownership="none">
14011             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
14012             <type name="gint" c:type="int"/>
14013           </parameter>
14014           <parameter name="cancellable"
14015                      transfer-ownership="none"
14016                      allow-none="1">
14017             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14018             <type name="Cancellable" c:type="GCancellable*"/>
14019           </parameter>
14020           <parameter name="callback"
14021                      transfer-ownership="none"
14022                      scope="async"
14023                      closure="5">
14024             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
14025             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
14026           </parameter>
14027           <parameter name="user_data" transfer-ownership="none" closure="5">
14028             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
14029             <type name="gpointer" c:type="gpointer"/>
14030           </parameter>
14031         </parameters>
14032       </virtual-method>
14033       <virtual-method name="query_info_finish"
14034                       invoker="query_info_finish"
14035                       throws="1">
14036         <doc xml:whitespace="preserve">Finishes an asynchronous file info query.
14037 See g_file_query_info_async().
14038 Free the returned object with g_object_unref().</doc>
14039         <return-value transfer-ownership="full">
14040           <doc xml:whitespace="preserve">#GFileInfo for given @file or %NULL on error.</doc>
14041           <type name="FileInfo" c:type="GFileInfo*"/>
14042         </return-value>
14043         <parameters>
14044           <parameter name="res" transfer-ownership="none">
14045             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
14046             <type name="AsyncResult" c:type="GAsyncResult*"/>
14047           </parameter>
14048         </parameters>
14049       </virtual-method>
14050       <virtual-method name="query_settable_attributes"
14051                       invoker="query_settable_attributes"
14052                       throws="1">
14053         <doc xml:whitespace="preserve">Obtain the list of settable attributes for the file.
14054 Returns the type and full attribute name of all the attributes
14055 that can be set on this file. This doesn't mean setting it will always
14056 succeed though, you might get an access failure, or some specific
14057 file may not support a specific attribute.
14058 If @cancellable is not %NULL, then the operation can be cancelled by
14059 triggering the cancellable object from another thread. If the operation
14060 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
14061 When you are done with it, release it with g_file_attribute_info_list_unref()</doc>
14062         <return-value transfer-ownership="full">
14063           <doc xml:whitespace="preserve">a #GFileAttributeInfoList describing the settable attributes.</doc>
14064           <type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
14065         </return-value>
14066         <parameters>
14067           <parameter name="cancellable"
14068                      transfer-ownership="none"
14069                      allow-none="1">
14070             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14071             <type name="Cancellable" c:type="GCancellable*"/>
14072           </parameter>
14073         </parameters>
14074       </virtual-method>
14075       <virtual-method name="query_writable_namespaces"
14076                       invoker="query_writable_namespaces"
14077                       throws="1">
14078         <doc xml:whitespace="preserve">Obtain the list of attribute namespaces where new attributes
14079 can be created by a user. An example of this is extended
14080 attributes (in the "xattr" namespace).
14081 If @cancellable is not %NULL, then the operation can be cancelled by
14082 triggering the cancellable object from another thread. If the operation
14083 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
14084 When you are done with it, release it with g_file_attribute_info_list_unref()</doc>
14085         <return-value transfer-ownership="full">
14086           <doc xml:whitespace="preserve">a #GFileAttributeInfoList describing the writable namespaces.</doc>
14087           <type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
14088         </return-value>
14089         <parameters>
14090           <parameter name="cancellable"
14091                      transfer-ownership="none"
14092                      allow-none="1">
14093             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14094             <type name="Cancellable" c:type="GCancellable*"/>
14095           </parameter>
14096         </parameters>
14097       </virtual-method>
14098       <virtual-method name="read_async" invoker="read_async">
14099         <doc xml:whitespace="preserve">Asynchronously opens @file for reading.
14100 For more details, see g_file_read() which is
14101 the synchronous version of this call.
14102 When the operation is finished, @callback will be called. You can then call
14103 g_file_read_finish() to get the result of the operation.</doc>
14104         <return-value transfer-ownership="none">
14105           <type name="none" c:type="void"/>
14106         </return-value>
14107         <parameters>
14108           <parameter name="io_priority" transfer-ownership="none">
14109             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
14110             <type name="gint" c:type="int"/>
14111           </parameter>
14112           <parameter name="cancellable"
14113                      transfer-ownership="none"
14114                      allow-none="1">
14115             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14116             <type name="Cancellable" c:type="GCancellable*"/>
14117           </parameter>
14118           <parameter name="callback"
14119                      transfer-ownership="none"
14120                      scope="async"
14121                      closure="3">
14122             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
14123             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
14124           </parameter>
14125           <parameter name="user_data" transfer-ownership="none" closure="3">
14126             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
14127             <type name="gpointer" c:type="gpointer"/>
14128           </parameter>
14129         </parameters>
14130       </virtual-method>
14131       <virtual-method name="read_finish" invoker="read_finish" throws="1">
14132         <doc xml:whitespace="preserve">Finishes an asynchronous file read operation started with
14133 g_file_read_async().
14134 Free the returned object with g_object_unref().</doc>
14135         <return-value transfer-ownership="full">
14136           <doc xml:whitespace="preserve">a #GFileInputStream or %NULL on error.</doc>
14137           <type name="FileInputStream" c:type="GFileInputStream*"/>
14138         </return-value>
14139         <parameters>
14140           <parameter name="res" transfer-ownership="none">
14141             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
14142             <type name="AsyncResult" c:type="GAsyncResult*"/>
14143           </parameter>
14144         </parameters>
14145       </virtual-method>
14146       <virtual-method name="read_fn" invoker="read" throws="1">
14147         <doc xml:whitespace="preserve">Opens a file for reading. The result is a #GFileInputStream that
14148 can be used to read the contents of the file.
14149 If @cancellable is not %NULL, then the operation can be cancelled by
14150 triggering the cancellable object from another thread. If the operation
14151 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
14152 If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
14153 If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned.
14154 Other errors are possible too, and depend on what kind of filesystem the file is on.
14155 Free the returned object with g_object_unref().</doc>
14156         <return-value transfer-ownership="full">
14157           <doc xml:whitespace="preserve">#GFileInputStream or %NULL on error.</doc>
14158           <type name="FileInputStream" c:type="GFileInputStream*"/>
14159         </return-value>
14160         <parameters>
14161           <parameter name="cancellable"
14162                      transfer-ownership="none"
14163                      allow-none="1">
14164             <doc xml:whitespace="preserve">a #GCancellable</doc>
14165             <type name="Cancellable" c:type="GCancellable*"/>
14166           </parameter>
14167         </parameters>
14168       </virtual-method>
14169       <virtual-method name="replace" invoker="replace" throws="1">
14170         <doc xml:whitespace="preserve">Returns an output stream for overwriting the file, possibly
14171 creating a backup copy of the file first. If the file doesn't exist,
14172 it will be created.
14173 This will try to replace the file in the safest way possible so
14174 that any errors during the writing will not affect an already
14175 existing copy of the file. For instance, for local files it
14176 may write to a temporary file and then atomically rename over
14177 the destination when the stream is closed.
14178 By default files created are generally readable by everyone,
14179 but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
14180 will be made readable only to the current user, to the level that
14181 is supported on the target filesystem.
14182 If @cancellable is not %NULL, then the operation can be cancelled by
14183 triggering the cancellable object from another thread. If the operation
14184 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
14185 If you pass in a non-#NULL @etag value, then this value is
14186 compared to the current entity tag of the file, and if they differ
14187 an G_IO_ERROR_WRONG_ETAG error is returned. This generally means
14188 that the file has been changed since you last read it. You can get
14189 the new etag from g_file_output_stream_get_etag() after you've
14190 finished writing and closed the #GFileOutputStream. When you load
14191 a new file you can use g_file_input_stream_query_info() to get
14192 the etag of the file.
14193 If @make_backup is %TRUE, this function will attempt to make a backup
14194 of the current file before overwriting it. If this fails a G_IO_ERROR_CANT_CREATE_BACKUP
14195 error will be returned. If you want to replace anyway, try again with
14196 If the file is a directory the G_IO_ERROR_IS_DIRECTORY error will be returned,
14197 and if the file is some other form of non-regular file then a
14198 G_IO_ERROR_NOT_REGULAR_FILE error will be returned.
14199 Some file systems don't allow all file names, and may
14200 return an G_IO_ERROR_INVALID_FILENAME error, and if the name
14201 is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned.
14202 Other errors are possible too, and depend on what kind of
14203 filesystem the file is on.
14204 Free the returned object with g_object_unref().</doc>
14205         <return-value transfer-ownership="full">
14206           <doc xml:whitespace="preserve">a #GFileOutputStream or %NULL on error.</doc>
14207           <type name="FileOutputStream" c:type="GFileOutputStream*"/>
14208         </return-value>
14209         <parameters>
14210           <parameter name="etag" transfer-ownership="none" allow-none="1">
14211             <doc xml:whitespace="preserve">an optional &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for the current #GFile, or #NULL to ignore.</doc>
14212             <type name="utf8" c:type="char*"/>
14213           </parameter>
14214           <parameter name="make_backup" transfer-ownership="none">
14215             <doc xml:whitespace="preserve">%TRUE if a backup should be created.</doc>
14216             <type name="gboolean" c:type="gboolean"/>
14217           </parameter>
14218           <parameter name="flags" transfer-ownership="none">
14219             <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
14220             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
14221           </parameter>
14222           <parameter name="cancellable"
14223                      transfer-ownership="none"
14224                      allow-none="1">
14225             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14226             <type name="Cancellable" c:type="GCancellable*"/>
14227           </parameter>
14228         </parameters>
14229       </virtual-method>
14230       <virtual-method name="replace_async" invoker="replace_async">
14231         <doc xml:whitespace="preserve">Asynchronously overwrites the file, replacing the contents, possibly
14232 creating a backup copy of the file first.
14233 For more details, see g_file_replace() which is
14234 the synchronous version of this call.
14235 When the operation is finished, @callback will be called. You can then call
14236 g_file_replace_finish() to get the result of the operation.</doc>
14237         <return-value transfer-ownership="none">
14238           <type name="none" c:type="void"/>
14239         </return-value>
14240         <parameters>
14241           <parameter name="etag" transfer-ownership="none" allow-none="1">
14242             <doc xml:whitespace="preserve">an &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for the current #GFile, or NULL to ignore.</doc>
14243             <type name="utf8" c:type="char*"/>
14244           </parameter>
14245           <parameter name="make_backup" transfer-ownership="none">
14246             <doc xml:whitespace="preserve">%TRUE if a backup should be created.</doc>
14247             <type name="gboolean" c:type="gboolean"/>
14248           </parameter>
14249           <parameter name="flags" transfer-ownership="none">
14250             <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
14251             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
14252           </parameter>
14253           <parameter name="io_priority" transfer-ownership="none">
14254             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
14255             <type name="gint" c:type="int"/>
14256           </parameter>
14257           <parameter name="cancellable"
14258                      transfer-ownership="none"
14259                      allow-none="1">
14260             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14261             <type name="Cancellable" c:type="GCancellable*"/>
14262           </parameter>
14263           <parameter name="callback"
14264                      transfer-ownership="none"
14265                      scope="async"
14266                      closure="6">
14267             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
14268             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
14269           </parameter>
14270           <parameter name="user_data" transfer-ownership="none" closure="6">
14271             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
14272             <type name="gpointer" c:type="gpointer"/>
14273           </parameter>
14274         </parameters>
14275       </virtual-method>
14276       <virtual-method name="replace_finish"
14277                       invoker="replace_finish"
14278                       throws="1">
14279         <doc xml:whitespace="preserve">Finishes an asynchronous file replace operation started with
14280 g_file_replace_async().
14281 Free the returned object with g_object_unref().</doc>
14282         <return-value transfer-ownership="full">
14283           <doc xml:whitespace="preserve">a #GFileOutputStream, or %NULL on error.</doc>
14284           <type name="FileOutputStream" c:type="GFileOutputStream*"/>
14285         </return-value>
14286         <parameters>
14287           <parameter name="res" transfer-ownership="none">
14288             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
14289             <type name="AsyncResult" c:type="GAsyncResult*"/>
14290           </parameter>
14291         </parameters>
14292       </virtual-method>
14293       <virtual-method name="replace_readwrite"
14294                       invoker="replace_readwrite"
14295                       version="2.22"
14296                       throws="1">
14297         <doc xml:whitespace="preserve">Returns an output stream for overwriting the file in readwrite mode,
14298 possibly creating a backup copy of the file first. If the file doesn't
14299 exist, it will be created.
14300 For details about the behaviour, see g_file_replace() which does the same
14301 thing but returns an output stream only.
14302 Note that in many non-local file cases read and write streams are not
14303 supported, so make sure you really need to do read and write streaming,
14304 rather than just opening for reading or writing.
14305 Free the returned object with g_object_unref().</doc>
14306         <return-value transfer-ownership="full">
14307           <doc xml:whitespace="preserve">a #GFileIOStream or %NULL on error.</doc>
14308           <type name="FileIOStream" c:type="GFileIOStream*"/>
14309         </return-value>
14310         <parameters>
14311           <parameter name="etag" transfer-ownership="none" allow-none="1">
14312             <doc xml:whitespace="preserve">an optional &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for the current #GFile, or #NULL to ignore</doc>
14313             <type name="utf8" c:type="char*"/>
14314           </parameter>
14315           <parameter name="make_backup" transfer-ownership="none">
14316             <doc xml:whitespace="preserve">%TRUE if a backup should be created</doc>
14317             <type name="gboolean" c:type="gboolean"/>
14318           </parameter>
14319           <parameter name="flags" transfer-ownership="none">
14320             <doc xml:whitespace="preserve">a set of #GFileCreateFlags</doc>
14321             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
14322           </parameter>
14323           <parameter name="cancellable"
14324                      transfer-ownership="none"
14325                      allow-none="1">
14326             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
14327             <type name="Cancellable" c:type="GCancellable*"/>
14328           </parameter>
14329         </parameters>
14330       </virtual-method>
14331       <virtual-method name="replace_readwrite_async"
14332                       invoker="replace_readwrite_async"
14333                       version="2.22">
14334         <doc xml:whitespace="preserve">Asynchronously overwrites the file in read-write mode, replacing the
14335 contents, possibly creating a backup copy of the file first.
14336 For more details, see g_file_replace_readwrite() which is
14337 the synchronous version of this call.
14338 When the operation is finished, @callback will be called. You can then
14339 call g_file_replace_readwrite_finish() to get the result of the operation.</doc>
14340         <return-value transfer-ownership="none">
14341           <type name="none" c:type="void"/>
14342         </return-value>
14343         <parameters>
14344           <parameter name="etag" transfer-ownership="none" allow-none="1">
14345             <doc xml:whitespace="preserve">an &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for the current #GFile, or NULL to ignore.</doc>
14346             <type name="utf8" c:type="char*"/>
14347           </parameter>
14348           <parameter name="make_backup" transfer-ownership="none">
14349             <doc xml:whitespace="preserve">%TRUE if a backup should be created.</doc>
14350             <type name="gboolean" c:type="gboolean"/>
14351           </parameter>
14352           <parameter name="flags" transfer-ownership="none">
14353             <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
14354             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
14355           </parameter>
14356           <parameter name="io_priority" transfer-ownership="none">
14357             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
14358             <type name="gint" c:type="int"/>
14359           </parameter>
14360           <parameter name="cancellable"
14361                      transfer-ownership="none"
14362                      allow-none="1">
14363             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14364             <type name="Cancellable" c:type="GCancellable*"/>
14365           </parameter>
14366           <parameter name="callback"
14367                      transfer-ownership="none"
14368                      scope="async"
14369                      closure="6">
14370             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
14371             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
14372           </parameter>
14373           <parameter name="user_data" transfer-ownership="none" closure="6">
14374             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
14375             <type name="gpointer" c:type="gpointer"/>
14376           </parameter>
14377         </parameters>
14378       </virtual-method>
14379       <virtual-method name="replace_readwrite_finish"
14380                       invoker="replace_readwrite_finish"
14381                       version="2.22"
14382                       throws="1">
14383         <doc xml:whitespace="preserve">Finishes an asynchronous file replace operation started with
14384 g_file_replace_readwrite_async().
14385 Free the returned object with g_object_unref().</doc>
14386         <return-value transfer-ownership="full">
14387           <doc xml:whitespace="preserve">a #GFileIOStream, or %NULL on error.</doc>
14388           <type name="FileIOStream" c:type="GFileIOStream*"/>
14389         </return-value>
14390         <parameters>
14391           <parameter name="res" transfer-ownership="none">
14392             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
14393             <type name="AsyncResult" c:type="GAsyncResult*"/>
14394           </parameter>
14395         </parameters>
14396       </virtual-method>
14397       <virtual-method name="resolve_relative_path"
14398                       invoker="resolve_relative_path">
14399         <doc xml:whitespace="preserve">Resolves a relative path for @file to an absolute path.
14400 This call does no blocking i/o.
14401 is %NULL or if @file is invalid.
14402 Free the returned object with g_object_unref().</doc>
14403         <return-value transfer-ownership="full">
14404           <doc xml:whitespace="preserve">#GFile to the resolved path. %NULL if @relative_path</doc>
14405           <type name="File" c:type="GFile*"/>
14406         </return-value>
14407         <parameters>
14408           <parameter name="relative_path" transfer-ownership="none">
14409             <doc xml:whitespace="preserve">a given relative path string.</doc>
14410             <type name="utf8" c:type="char*"/>
14411           </parameter>
14412         </parameters>
14413       </virtual-method>
14414       <virtual-method name="set_attribute" invoker="set_attribute" throws="1">
14415         <doc xml:whitespace="preserve">Sets an attribute in the file with attribute name @attribute to @value.
14416 If @cancellable is not %NULL, then the operation can be cancelled by
14417 triggering the cancellable object from another thread. If the operation
14418 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
14419         <return-value transfer-ownership="none">
14420           <doc xml:whitespace="preserve">%TRUE if the attribute was set, %FALSE otherwise.</doc>
14421           <type name="gboolean" c:type="gboolean"/>
14422         </return-value>
14423         <parameters>
14424           <parameter name="attribute" transfer-ownership="none">
14425             <doc xml:whitespace="preserve">a string containing the attribute's name.</doc>
14426             <type name="utf8" c:type="char*"/>
14427           </parameter>
14428           <parameter name="type" transfer-ownership="none">
14429             <doc xml:whitespace="preserve">The type of the attribute</doc>
14430             <type name="FileAttributeType" c:type="GFileAttributeType"/>
14431           </parameter>
14432           <parameter name="value_p" transfer-ownership="none">
14433             <doc xml:whitespace="preserve">a pointer to the value (or the pointer itself if the type is a pointer type)</doc>
14434             <type name="gpointer" c:type="gpointer"/>
14435           </parameter>
14436           <parameter name="flags" transfer-ownership="none">
14437             <doc xml:whitespace="preserve">a set of #GFileQueryInfoFlags.</doc>
14438             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
14439           </parameter>
14440           <parameter name="cancellable"
14441                      transfer-ownership="none"
14442                      allow-none="1">
14443             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14444             <type name="Cancellable" c:type="GCancellable*"/>
14445           </parameter>
14446         </parameters>
14447       </virtual-method>
14448       <virtual-method name="set_attributes_async"
14449                       invoker="set_attributes_async">
14450         <doc xml:whitespace="preserve">Asynchronously sets the attributes of @file with @info.
14451 For more details, see g_file_set_attributes_from_info() which is
14452 the synchronous version of this call.
14453 When the operation is finished, @callback will be called. You can then call
14454 g_file_set_attributes_finish() to get the result of the operation.</doc>
14455         <return-value transfer-ownership="none">
14456           <type name="none" c:type="void"/>
14457         </return-value>
14458         <parameters>
14459           <parameter name="info" transfer-ownership="none">
14460             <doc xml:whitespace="preserve">a #GFileInfo.</doc>
14461             <type name="FileInfo" c:type="GFileInfo*"/>
14462           </parameter>
14463           <parameter name="flags" transfer-ownership="none">
14464             <doc xml:whitespace="preserve">a #GFileQueryInfoFlags.</doc>
14465             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
14466           </parameter>
14467           <parameter name="io_priority" transfer-ownership="none">
14468             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
14469             <type name="gint" c:type="int"/>
14470           </parameter>
14471           <parameter name="cancellable"
14472                      transfer-ownership="none"
14473                      allow-none="1">
14474             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14475             <type name="Cancellable" c:type="GCancellable*"/>
14476           </parameter>
14477           <parameter name="callback"
14478                      transfer-ownership="none"
14479                      scope="async"
14480                      closure="5">
14481             <doc xml:whitespace="preserve">a #GAsyncReadyCallback.</doc>
14482             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
14483           </parameter>
14484           <parameter name="user_data" transfer-ownership="none" closure="5">
14485             <doc xml:whitespace="preserve">a #gpointer.</doc>
14486             <type name="gpointer" c:type="gpointer"/>
14487           </parameter>
14488         </parameters>
14489       </virtual-method>
14490       <virtual-method name="set_attributes_finish"
14491                       invoker="set_attributes_finish"
14492                       throws="1">
14493         <doc xml:whitespace="preserve">Finishes setting an attribute started in g_file_set_attributes_async().</doc>
14494         <return-value transfer-ownership="none">
14495           <doc xml:whitespace="preserve">%TRUE if the attributes were set correctly, %FALSE otherwise.</doc>
14496           <type name="gboolean" c:type="gboolean"/>
14497         </return-value>
14498         <parameters>
14499           <parameter name="result" transfer-ownership="none">
14500             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
14501             <type name="AsyncResult" c:type="GAsyncResult*"/>
14502           </parameter>
14503           <parameter name="info"
14504                      direction="out"
14505                      caller-allocates="0"
14506                      transfer-ownership="full">
14507             <doc xml:whitespace="preserve">a #GFileInfo.</doc>
14508             <type name="FileInfo" c:type="GFileInfo**"/>
14509           </parameter>
14510         </parameters>
14511       </virtual-method>
14512       <virtual-method name="set_attributes_from_info"
14513                       invoker="set_attributes_from_info"
14514                       throws="1">
14515         <doc xml:whitespace="preserve">Tries to set all attributes in the #GFileInfo on the target values,
14516 not stopping on the first error.
14517 If there is any error during this operation then @error will be set to
14518 the first error. Error on particular fields are flagged by setting
14519 the "status" field in the attribute value to
14520 %G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can also detect
14521 further errors.
14522 If @cancellable is not %NULL, then the operation can be cancelled by
14523 triggering the cancellable object from another thread. If the operation
14524 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
14525         <return-value transfer-ownership="none">
14526           <doc xml:whitespace="preserve">%TRUE if there was any error, %FALSE otherwise.</doc>
14527           <type name="gboolean" c:type="gboolean"/>
14528         </return-value>
14529         <parameters>
14530           <parameter name="info" transfer-ownership="none">
14531             <doc xml:whitespace="preserve">a #GFileInfo.</doc>
14532             <type name="FileInfo" c:type="GFileInfo*"/>
14533           </parameter>
14534           <parameter name="flags" transfer-ownership="none">
14535             <doc xml:whitespace="preserve">#GFileQueryInfoFlags</doc>
14536             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
14537           </parameter>
14538           <parameter name="cancellable"
14539                      transfer-ownership="none"
14540                      allow-none="1">
14541             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14542             <type name="Cancellable" c:type="GCancellable*"/>
14543           </parameter>
14544         </parameters>
14545       </virtual-method>
14546       <virtual-method name="set_display_name"
14547                       invoker="set_display_name"
14548                       throws="1">
14549         <doc xml:whitespace="preserve">Renames @file to the specified display name.
14550 The display name is converted from UTF8 to the correct encoding for the target
14551 filesystem if possible and the @file is renamed to this.
14552 If you want to implement a rename operation in the user interface the edit name
14553 (#G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME) should be used as the initial value in the rename
14554 widget, and then the result after editing should be passed to g_file_set_display_name().
14555 On success the resulting converted filename is returned.
14556 If @cancellable is not %NULL, then the operation can be cancelled by
14557 triggering the cancellable object from another thread. If the operation
14558 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
14559 if there was an error.
14560 Free the returned object with g_object_unref().</doc>
14561         <return-value transfer-ownership="full">
14562           <doc xml:whitespace="preserve">a #GFile specifying what @file was renamed to, or %NULL</doc>
14563           <type name="File" c:type="GFile*"/>
14564         </return-value>
14565         <parameters>
14566           <parameter name="display_name" transfer-ownership="none">
14567             <doc xml:whitespace="preserve">a string.</doc>
14568             <type name="utf8" c:type="char*"/>
14569           </parameter>
14570           <parameter name="cancellable"
14571                      transfer-ownership="none"
14572                      allow-none="1">
14573             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14574             <type name="Cancellable" c:type="GCancellable*"/>
14575           </parameter>
14576         </parameters>
14577       </virtual-method>
14578       <virtual-method name="set_display_name_async"
14579                       invoker="set_display_name_async">
14580         <doc xml:whitespace="preserve">Asynchronously sets the display name for a given #GFile.
14581 For more details, see g_file_set_display_name() which is
14582 the synchronous version of this call.
14583 When the operation is finished, @callback will be called. You can then call
14584 g_file_set_display_name_finish() to get the result of the operation.</doc>
14585         <return-value transfer-ownership="none">
14586           <type name="none" c:type="void"/>
14587         </return-value>
14588         <parameters>
14589           <parameter name="display_name" transfer-ownership="none">
14590             <doc xml:whitespace="preserve">a string.</doc>
14591             <type name="utf8" c:type="char*"/>
14592           </parameter>
14593           <parameter name="io_priority" transfer-ownership="none">
14594             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
14595             <type name="gint" c:type="int"/>
14596           </parameter>
14597           <parameter name="cancellable"
14598                      transfer-ownership="none"
14599                      allow-none="1">
14600             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14601             <type name="Cancellable" c:type="GCancellable*"/>
14602           </parameter>
14603           <parameter name="callback"
14604                      transfer-ownership="none"
14605                      scope="async"
14606                      closure="4">
14607             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
14608             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
14609           </parameter>
14610           <parameter name="user_data" transfer-ownership="none" closure="4">
14611             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
14612             <type name="gpointer" c:type="gpointer"/>
14613           </parameter>
14614         </parameters>
14615       </virtual-method>
14616       <virtual-method name="set_display_name_finish"
14617                       invoker="set_display_name_finish"
14618                       throws="1">
14619         <doc xml:whitespace="preserve">Finishes setting a display name started with
14620 g_file_set_display_name_async().
14621 Free the returned object with g_object_unref().</doc>
14622         <return-value transfer-ownership="full">
14623           <doc xml:whitespace="preserve">a #GFile or %NULL on error.</doc>
14624           <type name="File" c:type="GFile*"/>
14625         </return-value>
14626         <parameters>
14627           <parameter name="res" transfer-ownership="none">
14628             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
14629             <type name="AsyncResult" c:type="GAsyncResult*"/>
14630           </parameter>
14631         </parameters>
14632       </virtual-method>
14633       <virtual-method name="start_mountable"
14634                       invoker="start_mountable"
14635                       version="2.22">
14636         <doc xml:whitespace="preserve">Starts a file of type G_FILE_TYPE_MOUNTABLE.
14637 Using @start_operation, you can request callbacks when, for instance,
14638 passwords are needed during authentication.
14639 If @cancellable is not %NULL, then the operation can be cancelled by
14640 triggering the cancellable object from another thread. If the operation
14641 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
14642 When the operation is finished, @callback will be called. You can then call
14643 g_file_mount_mountable_finish() to get the result of the operation.</doc>
14644         <return-value transfer-ownership="none">
14645           <type name="none" c:type="void"/>
14646         </return-value>
14647         <parameters>
14648           <parameter name="flags" transfer-ownership="none">
14649             <doc xml:whitespace="preserve">flags affecting the operation</doc>
14650             <type name="DriveStartFlags" c:type="GDriveStartFlags"/>
14651           </parameter>
14652           <parameter name="start_operation" transfer-ownership="none">
14653             <doc xml:whitespace="preserve">a #GMountOperation, or %NULL to avoid user interaction.</doc>
14654             <type name="MountOperation" c:type="GMountOperation*"/>
14655           </parameter>
14656           <parameter name="cancellable"
14657                      transfer-ownership="none"
14658                      allow-none="1">
14659             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14660             <type name="Cancellable" c:type="GCancellable*"/>
14661           </parameter>
14662           <parameter name="callback"
14663                      transfer-ownership="none"
14664                      scope="async"
14665                      closure="4">
14666             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
14667             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
14668           </parameter>
14669           <parameter name="user_data" transfer-ownership="none" closure="4">
14670             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
14671             <type name="gpointer" c:type="gpointer"/>
14672           </parameter>
14673         </parameters>
14674       </virtual-method>
14675       <virtual-method name="start_mountable_finish"
14676                       invoker="start_mountable_finish"
14677                       version="2.22"
14678                       throws="1">
14679         <doc xml:whitespace="preserve">Finishes a start operation. See g_file_start_mountable() for details.
14680 Finish an asynchronous start operation that was started
14681 with g_file_start_mountable().
14682 otherwise.</doc>
14683         <return-value transfer-ownership="none">
14684           <doc xml:whitespace="preserve">%TRUE if the operation finished successfully. %FALSE</doc>
14685           <type name="gboolean" c:type="gboolean"/>
14686         </return-value>
14687         <parameters>
14688           <parameter name="result" transfer-ownership="none">
14689             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
14690             <type name="AsyncResult" c:type="GAsyncResult*"/>
14691           </parameter>
14692         </parameters>
14693       </virtual-method>
14694       <virtual-method name="stop_mountable"
14695                       invoker="stop_mountable"
14696                       version="2.22">
14697         <doc xml:whitespace="preserve">Stops a file of type G_FILE_TYPE_MOUNTABLE.
14698 If @cancellable is not %NULL, then the operation can be cancelled by
14699 triggering the cancellable object from another thread. If the operation
14700 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
14701 When the operation is finished, @callback will be called. You can then call
14702 g_file_stop_mountable_finish() to get the result of the operation.</doc>
14703         <return-value transfer-ownership="none">
14704           <type name="none" c:type="void"/>
14705         </return-value>
14706         <parameters>
14707           <parameter name="flags" transfer-ownership="none">
14708             <doc xml:whitespace="preserve">flags affecting the operation</doc>
14709             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
14710           </parameter>
14711           <parameter name="mount_operation" transfer-ownership="none">
14712             <doc xml:whitespace="preserve">a #GMountOperation, or %NULL to avoid user interaction.</doc>
14713             <type name="MountOperation" c:type="GMountOperation*"/>
14714           </parameter>
14715           <parameter name="cancellable"
14716                      transfer-ownership="none"
14717                      allow-none="1">
14718             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14719             <type name="Cancellable" c:type="GCancellable*"/>
14720           </parameter>
14721           <parameter name="callback"
14722                      transfer-ownership="none"
14723                      scope="async"
14724                      closure="4">
14725             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
14726             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
14727           </parameter>
14728           <parameter name="user_data" transfer-ownership="none" closure="4">
14729             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
14730             <type name="gpointer" c:type="gpointer"/>
14731           </parameter>
14732         </parameters>
14733       </virtual-method>
14734       <virtual-method name="stop_mountable_finish"
14735                       invoker="stop_mountable_finish"
14736                       version="2.22"
14737                       throws="1">
14738         <doc xml:whitespace="preserve">Finishes an stop operation, see g_file_stop_mountable() for details.
14739 Finish an asynchronous stop operation that was started
14740 with g_file_stop_mountable().
14741 otherwise.</doc>
14742         <return-value transfer-ownership="none">
14743           <doc xml:whitespace="preserve">%TRUE if the operation finished successfully. %FALSE</doc>
14744           <type name="gboolean" c:type="gboolean"/>
14745         </return-value>
14746         <parameters>
14747           <parameter name="result" transfer-ownership="none">
14748             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
14749             <type name="AsyncResult" c:type="GAsyncResult*"/>
14750           </parameter>
14751         </parameters>
14752       </virtual-method>
14753       <virtual-method name="trash" invoker="trash" throws="1">
14754         <doc xml:whitespace="preserve">Sends @file to the "Trashcan", if possible. This is similar to
14755 deleting it, but the user can recover it before emptying the trashcan.
14756 Not all file systems support trashing, so this call can return the
14757 %G_IO_ERROR_NOT_SUPPORTED error.
14758 If @cancellable is not %NULL, then the operation can be cancelled by
14759 triggering the cancellable object from another thread. If the operation
14760 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
14761         <return-value transfer-ownership="none">
14762           <doc xml:whitespace="preserve">%TRUE on successful trash, %FALSE otherwise.</doc>
14763           <type name="gboolean" c:type="gboolean"/>
14764         </return-value>
14765         <parameters>
14766           <parameter name="cancellable"
14767                      transfer-ownership="none"
14768                      allow-none="1">
14769             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14770             <type name="Cancellable" c:type="GCancellable*"/>
14771           </parameter>
14772         </parameters>
14773       </virtual-method>
14774       <virtual-method name="unmount_mountable"
14775                       invoker="unmount_mountable"
14776                       deprecated="Use g_file_unmount_mountable_with_operation() instead."
14777                       deprecated-version="2.22">
14778         <doc xml:whitespace="preserve">Unmounts a file of type G_FILE_TYPE_MOUNTABLE.
14779 If @cancellable is not %NULL, then the operation can be cancelled by
14780 triggering the cancellable object from another thread. If the operation
14781 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
14782 When the operation is finished, @callback will be called. You can then call
14783 g_file_unmount_mountable_finish() to get the result of the operation.</doc>
14784         <return-value transfer-ownership="none">
14785           <type name="none" c:type="void"/>
14786         </return-value>
14787         <parameters>
14788           <parameter name="flags" transfer-ownership="none">
14789             <doc xml:whitespace="preserve">flags affecting the operation</doc>
14790             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
14791           </parameter>
14792           <parameter name="cancellable"
14793                      transfer-ownership="none"
14794                      allow-none="1">
14795             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14796             <type name="Cancellable" c:type="GCancellable*"/>
14797           </parameter>
14798           <parameter name="callback"
14799                      transfer-ownership="none"
14800                      scope="async"
14801                      closure="3">
14802             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
14803             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
14804           </parameter>
14805           <parameter name="user_data" transfer-ownership="none" closure="3">
14806             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
14807             <type name="gpointer" c:type="gpointer"/>
14808           </parameter>
14809         </parameters>
14810       </virtual-method>
14811       <virtual-method name="unmount_mountable_finish"
14812                       invoker="unmount_mountable_finish"
14813                       deprecated="Use g_file_unmount_mountable_with_operation_finish() instead."
14814                       deprecated-version="2.22"
14815                       throws="1">
14816         <doc xml:whitespace="preserve">Finishes an unmount operation, see g_file_unmount_mountable() for details.
14817 Finish an asynchronous unmount operation that was started
14818 with g_file_unmount_mountable().
14819 otherwise.</doc>
14820         <return-value transfer-ownership="none">
14821           <doc xml:whitespace="preserve">%TRUE if the operation finished successfully. %FALSE</doc>
14822           <type name="gboolean" c:type="gboolean"/>
14823         </return-value>
14824         <parameters>
14825           <parameter name="result" transfer-ownership="none">
14826             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
14827             <type name="AsyncResult" c:type="GAsyncResult*"/>
14828           </parameter>
14829         </parameters>
14830       </virtual-method>
14831       <virtual-method name="unmount_mountable_with_operation"
14832                       invoker="unmount_mountable_with_operation"
14833                       version="2.22">
14834         <doc xml:whitespace="preserve">Unmounts a file of type G_FILE_TYPE_MOUNTABLE.
14835 If @cancellable is not %NULL, then the operation can be cancelled by
14836 triggering the cancellable object from another thread. If the operation
14837 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
14838 When the operation is finished, @callback will be called. You can then call
14839 g_file_unmount_mountable_finish() to get the result of the operation.</doc>
14840         <return-value transfer-ownership="none">
14841           <type name="none" c:type="void"/>
14842         </return-value>
14843         <parameters>
14844           <parameter name="flags" transfer-ownership="none">
14845             <doc xml:whitespace="preserve">flags affecting the operation</doc>
14846             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
14847           </parameter>
14848           <parameter name="mount_operation" transfer-ownership="none">
14849             <doc xml:whitespace="preserve">a #GMountOperation, or %NULL to avoid user interaction.</doc>
14850             <type name="MountOperation" c:type="GMountOperation*"/>
14851           </parameter>
14852           <parameter name="cancellable"
14853                      transfer-ownership="none"
14854                      allow-none="1">
14855             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14856             <type name="Cancellable" c:type="GCancellable*"/>
14857           </parameter>
14858           <parameter name="callback"
14859                      transfer-ownership="none"
14860                      scope="async"
14861                      closure="4">
14862             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
14863             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
14864           </parameter>
14865           <parameter name="user_data" transfer-ownership="none" closure="4">
14866             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
14867             <type name="gpointer" c:type="gpointer"/>
14868           </parameter>
14869         </parameters>
14870       </virtual-method>
14871       <virtual-method name="unmount_mountable_with_operation_finish"
14872                       invoker="unmount_mountable_with_operation_finish"
14873                       version="2.22"
14874                       throws="1">
14875         <doc xml:whitespace="preserve">Finishes an unmount operation, see g_file_unmount_mountable_with_operation() for details.
14876 Finish an asynchronous unmount operation that was started
14877 with g_file_unmount_mountable_with_operation().
14878 otherwise.</doc>
14879         <return-value transfer-ownership="none">
14880           <doc xml:whitespace="preserve">%TRUE if the operation finished successfully. %FALSE</doc>
14881           <type name="gboolean" c:type="gboolean"/>
14882         </return-value>
14883         <parameters>
14884           <parameter name="result" transfer-ownership="none">
14885             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
14886             <type name="AsyncResult" c:type="GAsyncResult*"/>
14887           </parameter>
14888         </parameters>
14889       </virtual-method>
14890       <method name="append_to" c:identifier="g_file_append_to" throws="1">
14891         <doc xml:whitespace="preserve">Gets an output stream for appending data to the file. If
14892 the file doesn't already exist it is created.
14893 By default files created are generally readable by everyone,
14894 but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
14895 will be made readable only to the current user, to the level that
14896 is supported on the target filesystem.
14897 If @cancellable is not %NULL, then the operation can be cancelled by
14898 triggering the cancellable object from another thread. If the operation
14899 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
14900 Some file systems don't allow all file names, and may
14901 return an %G_IO_ERROR_INVALID_FILENAME error.
14902 If the file is a directory the %G_IO_ERROR_IS_DIRECTORY error will be
14903 returned. Other errors are possible too, and depend on what kind of
14904 filesystem the file is on.
14905 Free the returned object with g_object_unref().</doc>
14906         <return-value transfer-ownership="full">
14907           <doc xml:whitespace="preserve">a #GFileOutputStream, or %NULL on error.</doc>
14908           <type name="FileOutputStream" c:type="GFileOutputStream*"/>
14909         </return-value>
14910         <parameters>
14911           <parameter name="flags" transfer-ownership="none">
14912             <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
14913             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
14914           </parameter>
14915           <parameter name="cancellable"
14916                      transfer-ownership="none"
14917                      allow-none="1">
14918             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14919             <type name="Cancellable" c:type="GCancellable*"/>
14920           </parameter>
14921         </parameters>
14922       </method>
14923       <method name="append_to_async" c:identifier="g_file_append_to_async">
14924         <doc xml:whitespace="preserve">Asynchronously opens @file for appending.
14925 For more details, see g_file_append_to() which is
14926 the synchronous version of this call.
14927 When the operation is finished, @callback will be called. You can then call
14928 g_file_append_to_finish() to get the result of the operation.</doc>
14929         <return-value transfer-ownership="none">
14930           <type name="none" c:type="void"/>
14931         </return-value>
14932         <parameters>
14933           <parameter name="flags" transfer-ownership="none">
14934             <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
14935             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
14936           </parameter>
14937           <parameter name="io_priority" transfer-ownership="none">
14938             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
14939             <type name="gint" c:type="int"/>
14940           </parameter>
14941           <parameter name="cancellable"
14942                      transfer-ownership="none"
14943                      allow-none="1">
14944             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
14945             <type name="Cancellable" c:type="GCancellable*"/>
14946           </parameter>
14947           <parameter name="callback"
14948                      transfer-ownership="none"
14949                      scope="async"
14950                      closure="4">
14951             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
14952             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
14953           </parameter>
14954           <parameter name="user_data" transfer-ownership="none">
14955             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
14956             <type name="gpointer" c:type="gpointer"/>
14957           </parameter>
14958         </parameters>
14959       </method>
14960       <method name="append_to_finish"
14961               c:identifier="g_file_append_to_finish"
14962               throws="1">
14963         <doc xml:whitespace="preserve">Finishes an asynchronous file append operation started with
14964 g_file_append_to_async().
14965 Free the returned object with g_object_unref().</doc>
14966         <return-value transfer-ownership="full">
14967           <doc xml:whitespace="preserve">a valid #GFileOutputStream or %NULL on error.</doc>
14968           <type name="FileOutputStream" c:type="GFileOutputStream*"/>
14969         </return-value>
14970         <parameters>
14971           <parameter name="res" transfer-ownership="none">
14972             <doc xml:whitespace="preserve">#GAsyncResult</doc>
14973             <type name="AsyncResult" c:type="GAsyncResult*"/>
14974           </parameter>
14975         </parameters>
14976       </method>
14977       <method name="copy"
14978               c:identifier="g_file_copy"
14979               introspectable="0"
14980               throws="1">
14981         <doc xml:whitespace="preserve">Copies the file @source to the location specified by @destination.
14982 Can not handle recursive copies of directories.
14983 If the flag #G_FILE_COPY_OVERWRITE is specified an already
14984 existing @destination file is overwritten.
14985 If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
14986 will be copied as symlinks, otherwise the target of the
14987 If @cancellable is not %NULL, then the operation can be cancelled by
14988 triggering the cancellable object from another thread. If the operation
14989 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
14990 If @progress_callback is not %NULL, then the operation can be monitored by
14991 setting this to a #GFileProgressCallback function. @progress_callback_data
14992 will be passed to this function. It is guaranteed that this callback will
14993 be called after all data has been transferred with the total number of bytes
14994 copied during the operation.
14995 If the @source file does not exist then the G_IO_ERROR_NOT_FOUND
14996 error is returned, independent on the status of the @destination.
14997 If #G_FILE_COPY_OVERWRITE is not specified and the target exists, then the
14998 error G_IO_ERROR_EXISTS is returned.
14999 If trying to overwrite a file over a directory the G_IO_ERROR_IS_DIRECTORY
15000 error is returned. If trying to overwrite a directory with a directory the
15001 G_IO_ERROR_WOULD_MERGE error is returned.
15002 If the source is a directory and the target does not exist, or #G_FILE_COPY_OVERWRITE is
15003 specified and the target is a file, then the G_IO_ERROR_WOULD_RECURSE error
15004 is returned.
15005 If you are interested in copying the #GFile object itself (not the on-disk
15006 file), see g_file_dup().</doc>
15007         <return-value transfer-ownership="none">
15008           <doc xml:whitespace="preserve">%TRUE on success, %FALSE otherwise.</doc>
15009           <type name="gboolean" c:type="gboolean"/>
15010         </return-value>
15011         <parameters>
15012           <parameter name="destination" transfer-ownership="none">
15013             <doc xml:whitespace="preserve">destination #GFile</doc>
15014             <type name="File" c:type="GFile*"/>
15015           </parameter>
15016           <parameter name="flags" transfer-ownership="none">
15017             <doc xml:whitespace="preserve">set of #GFileCopyFlags</doc>
15018             <type name="FileCopyFlags" c:type="GFileCopyFlags"/>
15019           </parameter>
15020           <parameter name="cancellable"
15021                      transfer-ownership="none"
15022                      allow-none="1">
15023             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
15024             <type name="Cancellable" c:type="GCancellable*"/>
15025           </parameter>
15026           <parameter name="progress_callback"
15027                      transfer-ownership="none"
15028                      closure="4">
15029             <doc xml:whitespace="preserve">function to callback with progress information</doc>
15030             <type name="FileProgressCallback" c:type="GFileProgressCallback"/>
15031           </parameter>
15032           <parameter name="progress_callback_data" transfer-ownership="none">
15033             <doc xml:whitespace="preserve">user data to pass to @progress_callback</doc>
15034             <type name="gpointer" c:type="gpointer"/>
15035           </parameter>
15036         </parameters>
15037       </method>
15038       <method name="copy_async"
15039               c:identifier="g_file_copy_async"
15040               introspectable="0">
15041         <doc xml:whitespace="preserve">Copies the file @source to the location specified by @destination
15042 asynchronously. For details of the behaviour, see g_file_copy().
15043 If @progress_callback is not %NULL, then that function that will be called
15044 just like in g_file_copy(), however the callback will run in the main loop,
15045 not in the thread that is doing the I/O operation.
15046 When the operation is finished, @callback will be called. You can then call
15047 g_file_copy_finish() to get the result of the operation.</doc>
15048         <return-value transfer-ownership="none">
15049           <type name="none" c:type="void"/>
15050         </return-value>
15051         <parameters>
15052           <parameter name="destination" transfer-ownership="none">
15053             <doc xml:whitespace="preserve">destination #GFile</doc>
15054             <type name="File" c:type="GFile*"/>
15055           </parameter>
15056           <parameter name="flags" transfer-ownership="none">
15057             <doc xml:whitespace="preserve">set of #GFileCopyFlags</doc>
15058             <type name="FileCopyFlags" c:type="GFileCopyFlags"/>
15059           </parameter>
15060           <parameter name="io_priority" transfer-ownership="none">
15061             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
15062             <type name="gint" c:type="int"/>
15063           </parameter>
15064           <parameter name="cancellable"
15065                      transfer-ownership="none"
15066                      allow-none="1">
15067             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
15068             <type name="Cancellable" c:type="GCancellable*"/>
15069           </parameter>
15070           <parameter name="progress_callback"
15071                      transfer-ownership="none"
15072                      closure="5">
15073             <doc xml:whitespace="preserve">function to callback with progress information</doc>
15074             <type name="FileProgressCallback" c:type="GFileProgressCallback"/>
15075           </parameter>
15076           <parameter name="progress_callback_data" transfer-ownership="none">
15077             <doc xml:whitespace="preserve">user data to pass to @progress_callback</doc>
15078             <type name="gpointer" c:type="gpointer"/>
15079           </parameter>
15080           <parameter name="callback"
15081                      transfer-ownership="none"
15082                      scope="async"
15083                      closure="7">
15084             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
15085             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
15086           </parameter>
15087           <parameter name="user_data" transfer-ownership="none">
15088             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
15089             <type name="gpointer" c:type="gpointer"/>
15090           </parameter>
15091         </parameters>
15092       </method>
15093       <method name="copy_attributes"
15094               c:identifier="g_file_copy_attributes"
15095               throws="1">
15096         <doc xml:whitespace="preserve">Copies the file attributes from @source to @destination.
15097 Normally only a subset of the file attributes are copied,
15098 those that are copies in a normal file copy operation
15099 (which for instance does not include e.g. owner). However
15100 if #G_FILE_COPY_ALL_METADATA is specified in @flags, then
15101 all the metadata that is possible to copy is copied. This
15102 is useful when implementing move by copy + delete source.</doc>
15103         <return-value transfer-ownership="none">
15104           <doc xml:whitespace="preserve">%TRUE if the attributes were copied successfully, %FALSE otherwise.</doc>
15105           <type name="gboolean" c:type="gboolean"/>
15106         </return-value>
15107         <parameters>
15108           <parameter name="destination" transfer-ownership="none">
15109             <doc xml:whitespace="preserve">a #GFile to copy attributes to.</doc>
15110             <type name="File" c:type="GFile*"/>
15111           </parameter>
15112           <parameter name="flags" transfer-ownership="none">
15113             <doc xml:whitespace="preserve">a set of #GFileCopyFlags.</doc>
15114             <type name="FileCopyFlags" c:type="GFileCopyFlags"/>
15115           </parameter>
15116           <parameter name="cancellable"
15117                      transfer-ownership="none"
15118                      allow-none="1">
15119             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
15120             <type name="Cancellable" c:type="GCancellable*"/>
15121           </parameter>
15122         </parameters>
15123       </method>
15124       <method name="copy_finish" c:identifier="g_file_copy_finish" throws="1">
15125         <doc xml:whitespace="preserve">Finishes copying the file started with
15126 g_file_copy_async().</doc>
15127         <return-value transfer-ownership="none">
15128           <doc xml:whitespace="preserve">a %TRUE on success, %FALSE on error.</doc>
15129           <type name="gboolean" c:type="gboolean"/>
15130         </return-value>
15131         <parameters>
15132           <parameter name="res" transfer-ownership="none">
15133             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
15134             <type name="AsyncResult" c:type="GAsyncResult*"/>
15135           </parameter>
15136         </parameters>
15137       </method>
15138       <method name="create" c:identifier="g_file_create" throws="1">
15139         <doc xml:whitespace="preserve">Creates a new file and returns an output stream for writing to it.
15140 The file must not already exist.
15141 By default files created are generally readable by everyone,
15142 but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
15143 will be made readable only to the current user, to the level that
15144 is supported on the target filesystem.
15145 If @cancellable is not %NULL, then the operation can be cancelled by
15146 triggering the cancellable object from another thread. If the operation
15147 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
15148 If a file or directory with this name already exists the G_IO_ERROR_EXISTS
15149 error will be returned.
15150 Some file systems don't allow all file names, and may
15151 return an G_IO_ERROR_INVALID_FILENAME error, and if the name
15152 is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned.
15153 Other errors are possible too, and depend on what kind of
15154 filesystem the file is on.
15155 %NULL on error.
15156 Free the returned object with g_object_unref().</doc>
15157         <return-value transfer-ownership="full">
15158           <doc xml:whitespace="preserve">a #GFileOutputStream for the newly created file, or</doc>
15159           <type name="FileOutputStream" c:type="GFileOutputStream*"/>
15160         </return-value>
15161         <parameters>
15162           <parameter name="flags" transfer-ownership="none">
15163             <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
15164             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
15165           </parameter>
15166           <parameter name="cancellable"
15167                      transfer-ownership="none"
15168                      allow-none="1">
15169             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
15170             <type name="Cancellable" c:type="GCancellable*"/>
15171           </parameter>
15172         </parameters>
15173       </method>
15174       <method name="create_async" c:identifier="g_file_create_async">
15175         <doc xml:whitespace="preserve">Asynchronously creates a new file and returns an output stream for writing to it.
15176 The file must not already exist.
15177 For more details, see g_file_create() which is
15178 the synchronous version of this call.
15179 When the operation is finished, @callback will be called. You can then call
15180 g_file_create_finish() to get the result of the operation.</doc>
15181         <return-value transfer-ownership="none">
15182           <type name="none" c:type="void"/>
15183         </return-value>
15184         <parameters>
15185           <parameter name="flags" transfer-ownership="none">
15186             <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
15187             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
15188           </parameter>
15189           <parameter name="io_priority" transfer-ownership="none">
15190             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
15191             <type name="gint" c:type="int"/>
15192           </parameter>
15193           <parameter name="cancellable"
15194                      transfer-ownership="none"
15195                      allow-none="1">
15196             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
15197             <type name="Cancellable" c:type="GCancellable*"/>
15198           </parameter>
15199           <parameter name="callback"
15200                      transfer-ownership="none"
15201                      scope="async"
15202                      closure="4">
15203             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
15204             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
15205           </parameter>
15206           <parameter name="user_data" transfer-ownership="none">
15207             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
15208             <type name="gpointer" c:type="gpointer"/>
15209           </parameter>
15210         </parameters>
15211       </method>
15212       <method name="create_finish"
15213               c:identifier="g_file_create_finish"
15214               throws="1">
15215         <doc xml:whitespace="preserve">Finishes an asynchronous file create operation started with
15216 g_file_create_async().
15217 Free the returned object with g_object_unref().</doc>
15218         <return-value transfer-ownership="full">
15219           <doc xml:whitespace="preserve">a #GFileOutputStream or %NULL on error.</doc>
15220           <type name="FileOutputStream" c:type="GFileOutputStream*"/>
15221         </return-value>
15222         <parameters>
15223           <parameter name="res" transfer-ownership="none">
15224             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
15225             <type name="AsyncResult" c:type="GAsyncResult*"/>
15226           </parameter>
15227         </parameters>
15228       </method>
15229       <method name="create_readwrite"
15230               c:identifier="g_file_create_readwrite"
15231               version="2.22"
15232               throws="1">
15233         <doc xml:whitespace="preserve">Creates a new file and returns a stream for reading and writing to it.
15234 The file must not already exist.
15235 By default files created are generally readable by everyone,
15236 but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
15237 will be made readable only to the current user, to the level that
15238 is supported on the target filesystem.
15239 If @cancellable is not %NULL, then the operation can be cancelled by
15240 triggering the cancellable object from another thread. If the operation
15241 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
15242 If a file or directory with this name already exists the %G_IO_ERROR_EXISTS
15243 error will be returned. Some file systems don't allow all file names,
15244 and may return an %G_IO_ERROR_INVALID_FILENAME error, and if the name
15245 is too long, %G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors
15246 are possible too, and depend on what kind of filesystem the file is on.
15247 Note that in many non-local file cases read and write streams are not
15248 supported, so make sure you really need to do read and write streaming,
15249 rather than just opening for reading or writing.
15250 Free the returned object with g_object_unref().</doc>
15251         <return-value transfer-ownership="full">
15252           <doc xml:whitespace="preserve">a #GFileIOStream for the newly created file, or %NULL on error.</doc>
15253           <type name="FileIOStream" c:type="GFileIOStream*"/>
15254         </return-value>
15255         <parameters>
15256           <parameter name="flags" transfer-ownership="none">
15257             <doc xml:whitespace="preserve">a set of #GFileCreateFlags</doc>
15258             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
15259           </parameter>
15260           <parameter name="cancellable"
15261                      transfer-ownership="none"
15262                      allow-none="1">
15263             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
15264             <type name="Cancellable" c:type="GCancellable*"/>
15265           </parameter>
15266         </parameters>
15267       </method>
15268       <method name="create_readwrite_async"
15269               c:identifier="g_file_create_readwrite_async"
15270               version="2.22">
15271         <doc xml:whitespace="preserve">Asynchronously creates a new file and returns a stream for reading and
15272 writing to it. The file must not already exist.
15273 For more details, see g_file_create_readwrite() which is
15274 the synchronous version of this call.
15275 When the operation is finished, @callback will be called. You can then
15276 call g_file_create_readwrite_finish() to get the result of the operation.</doc>
15277         <return-value transfer-ownership="none">
15278           <type name="none" c:type="void"/>
15279         </return-value>
15280         <parameters>
15281           <parameter name="flags" transfer-ownership="none">
15282             <doc xml:whitespace="preserve">a set of #GFileCreateFlags</doc>
15283             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
15284           </parameter>
15285           <parameter name="io_priority" transfer-ownership="none">
15286             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request</doc>
15287             <type name="gint" c:type="int"/>
15288           </parameter>
15289           <parameter name="cancellable"
15290                      transfer-ownership="none"
15291                      allow-none="1">
15292             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
15293             <type name="Cancellable" c:type="GCancellable*"/>
15294           </parameter>
15295           <parameter name="callback"
15296                      transfer-ownership="none"
15297                      scope="async"
15298                      closure="4">
15299             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
15300             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
15301           </parameter>
15302           <parameter name="user_data" transfer-ownership="none">
15303             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
15304             <type name="gpointer" c:type="gpointer"/>
15305           </parameter>
15306         </parameters>
15307       </method>
15308       <method name="create_readwrite_finish"
15309               c:identifier="g_file_create_readwrite_finish"
15310               version="2.22"
15311               throws="1">
15312         <doc xml:whitespace="preserve">Finishes an asynchronous file create operation started with
15313 g_file_create_readwrite_async().
15314 Free the returned object with g_object_unref().</doc>
15315         <return-value transfer-ownership="full">
15316           <doc xml:whitespace="preserve">a #GFileIOStream or %NULL on error.</doc>
15317           <type name="FileIOStream" c:type="GFileIOStream*"/>
15318         </return-value>
15319         <parameters>
15320           <parameter name="res" transfer-ownership="none">
15321             <doc xml:whitespace="preserve">a #GAsyncResult</doc>
15322             <type name="AsyncResult" c:type="GAsyncResult*"/>
15323           </parameter>
15324         </parameters>
15325       </method>
15326       <method name="delete" c:identifier="g_file_delete" throws="1">
15327         <doc xml:whitespace="preserve">Deletes a file. If the @file is a directory, it will only be deleted if it
15328 is empty.
15329 If @cancellable is not %NULL, then the operation can be cancelled by
15330 triggering the cancellable object from another thread. If the operation
15331 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
15332         <return-value transfer-ownership="none">
15333           <doc xml:whitespace="preserve">%TRUE if the file was deleted. %FALSE otherwise.</doc>
15334           <type name="gboolean" c:type="gboolean"/>
15335         </return-value>
15336         <parameters>
15337           <parameter name="cancellable"
15338                      transfer-ownership="none"
15339                      allow-none="1">
15340             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
15341             <type name="Cancellable" c:type="GCancellable*"/>
15342           </parameter>
15343         </parameters>
15344       </method>
15345       <method name="dup" c:identifier="g_file_dup">
15346         <doc xml:whitespace="preserve">Duplicates a #GFile handle. This operation does not duplicate
15347 the actual file or directory represented by the #GFile; see
15348 g_file_copy() if attempting to copy a file.
15349 This call does no blocking i/o.</doc>
15350         <return-value transfer-ownership="full">
15351           <doc xml:whitespace="preserve">a new #GFile that is a duplicate of the given #GFile.</doc>
15352           <type name="File" c:type="GFile*"/>
15353         </return-value>
15354       </method>
15355       <method name="eject_mountable"
15356               c:identifier="g_file_eject_mountable"
15357               deprecated="Use g_file_eject_mountable_with_operation() instead."
15358               deprecated-version="2.22">
15359         <doc xml:whitespace="preserve">Starts an asynchronous eject on a mountable.
15360 When this operation has completed, @callback will be called with
15361 g_file_eject_mountable_finish().
15362 If @cancellable is not %NULL, then the operation can be cancelled by
15363 triggering the cancellable object from another thread. If the operation
15364 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
15365         <return-value transfer-ownership="none">
15366           <type name="none" c:type="void"/>
15367         </return-value>
15368         <parameters>
15369           <parameter name="flags" transfer-ownership="none">
15370             <doc xml:whitespace="preserve">flags affecting the operation</doc>
15371             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
15372           </parameter>
15373           <parameter name="cancellable"
15374                      transfer-ownership="none"
15375                      allow-none="1">
15376             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
15377             <type name="Cancellable" c:type="GCancellable*"/>
15378           </parameter>
15379           <parameter name="callback"
15380                      transfer-ownership="none"
15381                      scope="async"
15382                      closure="3">
15383             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
15384             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
15385           </parameter>
15386           <parameter name="user_data" transfer-ownership="none">
15387             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
15388             <type name="gpointer" c:type="gpointer"/>
15389           </parameter>
15390         </parameters>
15391       </method>
15392       <method name="eject_mountable_finish"
15393               c:identifier="g_file_eject_mountable_finish"
15394               deprecated="Use g_file_eject_mountable_with_operation_finish() instead."
15395               deprecated-version="2.22"
15396               throws="1">
15397         <doc xml:whitespace="preserve">Finishes an asynchronous eject operation started by
15398 g_file_eject_mountable().
15399 otherwise.</doc>
15400         <return-value transfer-ownership="none">
15401           <doc xml:whitespace="preserve">%TRUE if the @file was ejected successfully. %FALSE</doc>
15402           <type name="gboolean" c:type="gboolean"/>
15403         </return-value>
15404         <parameters>
15405           <parameter name="result" transfer-ownership="none">
15406             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
15407             <type name="AsyncResult" c:type="GAsyncResult*"/>
15408           </parameter>
15409         </parameters>
15410       </method>
15411       <method name="eject_mountable_with_operation"
15412               c:identifier="g_file_eject_mountable_with_operation"
15413               version="2.22">
15414         <doc xml:whitespace="preserve">Starts an asynchronous eject on a mountable.
15415 When this operation has completed, @callback will be called with
15416 g_file_eject_mountable_with_operation_finish().
15417 If @cancellable is not %NULL, then the operation can be cancelled by
15418 triggering the cancellable object from another thread. If the operation
15419 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
15420         <return-value transfer-ownership="none">
15421           <type name="none" c:type="void"/>
15422         </return-value>
15423         <parameters>
15424           <parameter name="flags" transfer-ownership="none">
15425             <doc xml:whitespace="preserve">flags affecting the operation</doc>
15426             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
15427           </parameter>
15428           <parameter name="mount_operation" transfer-ownership="none">
15429             <doc xml:whitespace="preserve">a #GMountOperation, or %NULL to avoid user interaction.</doc>
15430             <type name="MountOperation" c:type="GMountOperation*"/>
15431           </parameter>
15432           <parameter name="cancellable"
15433                      transfer-ownership="none"
15434                      allow-none="1">
15435             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
15436             <type name="Cancellable" c:type="GCancellable*"/>
15437           </parameter>
15438           <parameter name="callback"
15439                      transfer-ownership="none"
15440                      scope="async"
15441                      closure="4">
15442             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
15443             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
15444           </parameter>
15445           <parameter name="user_data" transfer-ownership="none">
15446             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
15447             <type name="gpointer" c:type="gpointer"/>
15448           </parameter>
15449         </parameters>
15450       </method>
15451       <method name="eject_mountable_with_operation_finish"
15452               c:identifier="g_file_eject_mountable_with_operation_finish"
15453               version="2.22"
15454               throws="1">
15455         <doc xml:whitespace="preserve">Finishes an asynchronous eject operation started by
15456 g_file_eject_mountable_with_operation().
15457 otherwise.</doc>
15458         <return-value transfer-ownership="none">
15459           <doc xml:whitespace="preserve">%TRUE if the @file was ejected successfully. %FALSE</doc>
15460           <type name="gboolean" c:type="gboolean"/>
15461         </return-value>
15462         <parameters>
15463           <parameter name="result" transfer-ownership="none">
15464             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
15465             <type name="AsyncResult" c:type="GAsyncResult*"/>
15466           </parameter>
15467         </parameters>
15468       </method>
15469       <method name="enumerate_children"
15470               c:identifier="g_file_enumerate_children"
15471               throws="1">
15472         <doc xml:whitespace="preserve">Gets the requested information about the files in a directory. The result
15473 is a #GFileEnumerator object that will give out #GFileInfo objects for
15474 all the files in the directory.
15475 The @attributes value is a string that specifies the file attributes that
15476 should be gathered. It is not an error if it's not possible to read a particular
15477 requested attribute from a file - it just won't be set. @attributes should
15478 be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
15479 means all attributes, and a wildcard like "standard::*" means all attributes in the standard
15480 namespace. An example attribute query be "standard::*,owner::user".
15481 The standard attributes are available as defines, like #G_FILE_ATTRIBUTE_STANDARD_NAME.
15482 If @cancellable is not %NULL, then the operation can be cancelled by
15483 triggering the cancellable object from another thread. If the operation
15484 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
15485 If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
15486 If the file is not a directory, the G_FILE_ERROR_NOTDIR error will be returned.
15487 Other errors are possible too.
15488 Free the returned object with g_object_unref().</doc>
15489         <return-value transfer-ownership="full">
15490           <doc xml:whitespace="preserve">A #GFileEnumerator if successful, %NULL on error.</doc>
15491           <type name="FileEnumerator" c:type="GFileEnumerator*"/>
15492         </return-value>
15493         <parameters>
15494           <parameter name="attributes" transfer-ownership="none">
15495             <doc xml:whitespace="preserve">an attribute query string.</doc>
15496             <type name="utf8" c:type="char*"/>
15497           </parameter>
15498           <parameter name="flags" transfer-ownership="none">
15499             <doc xml:whitespace="preserve">a set of #GFileQueryInfoFlags.</doc>
15500             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
15501           </parameter>
15502           <parameter name="cancellable"
15503                      transfer-ownership="none"
15504                      allow-none="1">
15505             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
15506             <type name="Cancellable" c:type="GCancellable*"/>
15507           </parameter>
15508         </parameters>
15509       </method>
15510       <method name="enumerate_children_async"
15511               c:identifier="g_file_enumerate_children_async">
15512         <doc xml:whitespace="preserve">Asynchronously gets the requested information about the files in a directory. The result
15513 is a #GFileEnumerator object that will give out #GFileInfo objects for
15514 all the files in the directory.
15515 For more details, see g_file_enumerate_children() which is
15516 the synchronous version of this call.
15517 When the operation is finished, @callback will be called. You can then call
15518 g_file_enumerate_children_finish() to get the result of the operation.</doc>
15519         <return-value transfer-ownership="none">
15520           <type name="none" c:type="void"/>
15521         </return-value>
15522         <parameters>
15523           <parameter name="attributes" transfer-ownership="none">
15524             <doc xml:whitespace="preserve">an attribute query string.</doc>
15525             <type name="utf8" c:type="char*"/>
15526           </parameter>
15527           <parameter name="flags" transfer-ownership="none">
15528             <doc xml:whitespace="preserve">a set of #GFileQueryInfoFlags.</doc>
15529             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
15530           </parameter>
15531           <parameter name="io_priority" transfer-ownership="none">
15532             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
15533             <type name="gint" c:type="int"/>
15534           </parameter>
15535           <parameter name="cancellable"
15536                      transfer-ownership="none"
15537                      allow-none="1">
15538             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
15539             <type name="Cancellable" c:type="GCancellable*"/>
15540           </parameter>
15541           <parameter name="callback"
15542                      transfer-ownership="none"
15543                      scope="async"
15544                      closure="5">
15545             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
15546             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
15547           </parameter>
15548           <parameter name="user_data" transfer-ownership="none">
15549             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
15550             <type name="gpointer" c:type="gpointer"/>
15551           </parameter>
15552         </parameters>
15553       </method>
15554       <method name="enumerate_children_finish"
15555               c:identifier="g_file_enumerate_children_finish"
15556               throws="1">
15557         <doc xml:whitespace="preserve">Finishes an async enumerate children operation.
15558 See g_file_enumerate_children_async().
15559 Free the returned object with g_object_unref().</doc>
15560         <return-value transfer-ownership="full">
15561           <doc xml:whitespace="preserve">a #GFileEnumerator or %NULL if an error occurred.</doc>
15562           <type name="FileEnumerator" c:type="GFileEnumerator*"/>
15563         </return-value>
15564         <parameters>
15565           <parameter name="res" transfer-ownership="none">
15566             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
15567             <type name="AsyncResult" c:type="GAsyncResult*"/>
15568           </parameter>
15569         </parameters>
15570       </method>
15571       <method name="equal" c:identifier="g_file_equal">
15572         <doc xml:whitespace="preserve">Checks equality of two given #GFile&lt;!-- --&gt;s. Note that two
15573 #GFile&lt;!-- --&gt;s that differ can still refer to the same
15574 file on the filesystem due to various forms of filename
15575 aliasing.
15576 This call does no blocking i/o.
15577 %FALSE if either is not a #GFile.</doc>
15578         <return-value transfer-ownership="none">
15579           <doc xml:whitespace="preserve">%TRUE if @file1 and @file2 are equal.</doc>
15580           <type name="gboolean" c:type="gboolean"/>
15581         </return-value>
15582         <parameters>
15583           <parameter name="file2" transfer-ownership="none">
15584             <doc xml:whitespace="preserve">the second #GFile.</doc>
15585             <type name="File" c:type="GFile*"/>
15586           </parameter>
15587         </parameters>
15588       </method>
15589       <method name="find_enclosing_mount"
15590               c:identifier="g_file_find_enclosing_mount"
15591               throws="1">
15592         <doc xml:whitespace="preserve">Gets a #GMount for the #GFile.
15593 If the #GFileIface for @file does not have a mount (e.g. possibly a
15594 remote share), @error will be set to %G_IO_ERROR_NOT_FOUND and %NULL
15595 will be returned.
15596 If @cancellable is not %NULL, then the operation can be cancelled by
15597 triggering the cancellable object from another thread. If the operation
15598 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
15599 Free the returned object with g_object_unref().</doc>
15600         <return-value transfer-ownership="full">
15601           <doc xml:whitespace="preserve">a #GMount where the @file is located or %NULL on error.</doc>
15602           <type name="Mount" c:type="GMount*"/>
15603         </return-value>
15604         <parameters>
15605           <parameter name="cancellable"
15606                      transfer-ownership="none"
15607                      allow-none="1">
15608             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
15609             <type name="Cancellable" c:type="GCancellable*"/>
15610           </parameter>
15611         </parameters>
15612       </method>
15613       <method name="find_enclosing_mount_async"
15614               c:identifier="g_file_find_enclosing_mount_async">
15615         <doc xml:whitespace="preserve">Asynchronously gets the mount for the file.
15616 For more details, see g_file_find_enclosing_mount() which is
15617 the synchronous version of this call.
15618 When the operation is finished, @callback will be called. You can then call
15619 g_file_find_enclosing_mount_finish() to get the result of the operation.</doc>
15620         <return-value transfer-ownership="none">
15621           <type name="none" c:type="void"/>
15622         </return-value>
15623         <parameters>
15624           <parameter name="io_priority" transfer-ownership="none">
15625             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
15626             <type name="gint" c:type="int"/>
15627           </parameter>
15628           <parameter name="cancellable"
15629                      transfer-ownership="none"
15630                      allow-none="1">
15631             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
15632             <type name="Cancellable" c:type="GCancellable*"/>
15633           </parameter>
15634           <parameter name="callback"
15635                      transfer-ownership="none"
15636                      scope="async"
15637                      closure="3">
15638             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
15639             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
15640           </parameter>
15641           <parameter name="user_data" transfer-ownership="none">
15642             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
15643             <type name="gpointer" c:type="gpointer"/>
15644           </parameter>
15645         </parameters>
15646       </method>
15647       <method name="find_enclosing_mount_finish"
15648               c:identifier="g_file_find_enclosing_mount_finish"
15649               throws="1">
15650         <doc xml:whitespace="preserve">Finishes an asynchronous find mount request.
15651 See g_file_find_enclosing_mount_async().
15652 Free the returned object with g_object_unref().</doc>
15653         <return-value transfer-ownership="full">
15654           <doc xml:whitespace="preserve">#GMount for given @file or %NULL on error.</doc>
15655           <type name="Mount" c:type="GMount*"/>
15656         </return-value>
15657         <parameters>
15658           <parameter name="res" transfer-ownership="none">
15659             <doc xml:whitespace="preserve">a #GAsyncResult</doc>
15660             <type name="AsyncResult" c:type="GAsyncResult*"/>
15661           </parameter>
15662         </parameters>
15663       </method>
15664       <method name="get_basename" c:identifier="g_file_get_basename">
15665         <doc xml:whitespace="preserve">Gets the base name (the last component of the path) for a given #GFile.
15666 If called for the top level of a system (such as the filesystem root
15667 or a uri like sftp://host/) it will return a single directory separator
15668 (and on Windows, possibly a drive letter).
15669 The base name is a byte string (*not* UTF-8). It has no defined encoding
15670 or rules other than it may not contain zero bytes.  If you want to use
15671 filenames in a user interface you should use the display name that you
15672 can get by requesting the %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME
15673 attribute with g_file_query_info().
15674 This call does no blocking i/o.
15675 if given #GFile is invalid. The returned string should be
15676 freed with g_free() when no longer needed.</doc>
15677         <return-value transfer-ownership="full">
15678           <doc xml:whitespace="preserve">string containing the #GFile's base name, or %NULL</doc>
15679           <type name="utf8" c:type="char*"/>
15680         </return-value>
15681       </method>
15682       <method name="get_child" c:identifier="g_file_get_child">
15683         <doc xml:whitespace="preserve">Gets a child of @file with basename equal to @name.
15684 Note that the file with that specific name might not exist, but
15685 you can still have a #GFile that points to it. You can use this
15686 for instance to create that file.
15687 This call does no blocking i/o.
15688 Free the returned object with g_object_unref().</doc>
15689         <return-value transfer-ownership="full">
15690           <doc xml:whitespace="preserve">a #GFile to a child specified by @name.</doc>
15691           <type name="File" c:type="GFile*"/>
15692         </return-value>
15693         <parameters>
15694           <parameter name="name" transfer-ownership="none">
15695             <doc xml:whitespace="preserve">string containing the child's basename.</doc>
15696             <type name="utf8" c:type="char*"/>
15697           </parameter>
15698         </parameters>
15699       </method>
15700       <method name="get_child_for_display_name"
15701               c:identifier="g_file_get_child_for_display_name"
15702               throws="1">
15703         <doc xml:whitespace="preserve">Gets the child of @file for a given @display_name (i.e. a UTF8
15704 version of the name). If this function fails, it returns %NULL and @error will be
15705 set. This is very useful when constructing a GFile for a new file
15706 and the user entered the filename in the user interface, for instance
15707 when you select a directory and type a filename in the file selector.
15708 This call does no blocking i/o.
15709 %NULL if the display name couldn't be converted.
15710 Free the returned object with g_object_unref().</doc>
15711         <return-value transfer-ownership="full">
15712           <doc xml:whitespace="preserve">a #GFile to the specified child, or</doc>
15713           <type name="File" c:type="GFile*"/>
15714         </return-value>
15715         <parameters>
15716           <parameter name="display_name" transfer-ownership="none">
15717             <doc xml:whitespace="preserve">string to a possible child.</doc>
15718             <type name="utf8" c:type="char*"/>
15719           </parameter>
15720         </parameters>
15721       </method>
15722       <method name="get_parent" c:identifier="g_file_get_parent">
15723         <doc xml:whitespace="preserve">Gets the parent directory for the @file.
15724 If the @file represents the root directory of the
15725 file system, then %NULL will be returned.
15726 This call does no blocking i/o.
15727 #GFile or %NULL if there is no parent.
15728 Free the returned object with g_object_unref().</doc>
15729         <return-value transfer-ownership="full">
15730           <doc xml:whitespace="preserve">a #GFile structure to the parent of the given</doc>
15731           <type name="File" c:type="GFile*"/>
15732         </return-value>
15733       </method>
15734       <method name="get_parse_name" c:identifier="g_file_get_parse_name">
15735         <doc xml:whitespace="preserve">Gets the parse name of the @file.
15736 A parse name is a UTF-8 string that describes the
15737 file such that one can get the #GFile back using
15738 g_file_parse_name().
15739 This is generally used to show the #GFile as a nice
15740 full-pathname kind of string in a user interface,
15741 like in a location entry.
15742 For local files with names that can safely be converted
15743 to UTF8 the pathname is used, otherwise the IRI is used
15744 (a form of URI that allows UTF8 characters unescaped).
15745 This call does no blocking i/o.
15746 string should be freed with g_free() when no longer needed.</doc>
15747         <return-value transfer-ownership="full">
15748           <doc xml:whitespace="preserve">a string containing the #GFile's parse name. The returned</doc>
15749           <type name="utf8" c:type="char*"/>
15750         </return-value>
15751       </method>
15752       <method name="get_path" c:identifier="g_file_get_path">
15753         <doc xml:whitespace="preserve">Gets the local pathname for #GFile, if one exists.
15754 This call does no blocking i/o.
15755 no such path exists. The returned string should be
15756 freed with g_free() when no longer needed.</doc>
15757         <return-value transfer-ownership="full">
15758           <doc xml:whitespace="preserve">string containing the #GFile's path, or %NULL if</doc>
15759           <type name="utf8" c:type="char*"/>
15760         </return-value>
15761       </method>
15762       <method name="get_relative_path" c:identifier="g_file_get_relative_path">
15763         <doc xml:whitespace="preserve">Gets the path for @descendant relative to @parent.
15764 This call does no blocking i/o.
15765 to @parent, or %NULL if @descendant doesn't have @parent as prefix.
15766 The returned string should be freed with g_free() when no longer needed.</doc>
15767         <return-value transfer-ownership="full">
15768           <doc xml:whitespace="preserve">string with the relative path from @descendant</doc>
15769           <type name="utf8" c:type="char*"/>
15770         </return-value>
15771         <parameters>
15772           <parameter name="descendant" transfer-ownership="none">
15773             <doc xml:whitespace="preserve">input #GFile.</doc>
15774             <type name="File" c:type="GFile*"/>
15775           </parameter>
15776         </parameters>
15777       </method>
15778       <method name="get_uri" c:identifier="g_file_get_uri">
15779         <doc xml:whitespace="preserve">Gets the URI for the @file.
15780 This call does no blocking i/o.
15781 The returned string should be freed with g_free() when no longer needed.</doc>
15782         <return-value transfer-ownership="full">
15783           <doc xml:whitespace="preserve">a string containing the #GFile's URI.</doc>
15784           <type name="utf8" c:type="char*"/>
15785         </return-value>
15786       </method>
15787       <method name="get_uri_scheme" c:identifier="g_file_get_uri_scheme">
15788         <doc xml:whitespace="preserve">Gets the URI scheme for a #GFile.
15789 RFC 3986 decodes the scheme as:
15790 &lt;programlisting&gt;
15791 URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ]
15792 &lt;/programlisting&gt;
15793 Common schemes include "file", "http", "ftp", etc.
15794 This call does no blocking i/o.
15795 #GFile. The returned string should be freed with g_free()
15796 when no longer needed.</doc>
15797         <return-value transfer-ownership="full">
15798           <doc xml:whitespace="preserve">a string containing the URI scheme for the given</doc>
15799           <type name="utf8" c:type="char*"/>
15800         </return-value>
15801       </method>
15802       <method name="has_parent"
15803               c:identifier="g_file_has_parent"
15804               version="2.24">
15805         <doc xml:whitespace="preserve">Checks if @file has a parent, and optionally, if it is @parent.
15806 If @parent is %NULL then this function returns %TRUE if @file has any
15807 parent at all.  If @parent is non-%NULL then %TRUE is only returned
15808 if @file is a child of @parent.
15809 case that @parent is %NULL).</doc>
15810         <return-value transfer-ownership="none">
15811           <doc xml:whitespace="preserve">%TRUE if @file is a child of @parent (or any parent in the</doc>
15812           <type name="gboolean" c:type="gboolean"/>
15813         </return-value>
15814         <parameters>
15815           <parameter name="parent" transfer-ownership="none">
15816             <doc xml:whitespace="preserve">the parent to check for, or %NULL</doc>
15817             <type name="File" c:type="GFile*"/>
15818           </parameter>
15819         </parameters>
15820       </method>
15821       <method name="has_prefix" c:identifier="g_file_has_prefix">
15822         <doc xml:whitespace="preserve">Checks whether @file has the prefix specified by @prefix. In other word,
15823 if the names of inital elements of @file&lt;!-- --&gt;s pathname match @prefix.
15824 Only full pathname elements are matched, so a path like /foo is not
15825 considered a prefix of /foobar, only of /foo/bar.
15826 This call does no i/o, as it works purely on names. As such it can
15827 sometimes return %FALSE even if @file is inside a @prefix (from a
15828 filesystem point of view), because the prefix of @file is an alias
15829 of @prefix.
15830 %FALSE otherwise.</doc>
15831         <return-value transfer-ownership="none">
15832           <doc xml:whitespace="preserve">%TRUE if the @files's parent, grandparent, etc is @prefix.</doc>
15833           <type name="gboolean" c:type="gboolean"/>
15834         </return-value>
15835         <parameters>
15836           <parameter name="prefix" transfer-ownership="none">
15837             <doc xml:whitespace="preserve">input #GFile.</doc>
15838             <type name="File" c:type="GFile*"/>
15839           </parameter>
15840         </parameters>
15841       </method>
15842       <method name="has_uri_scheme" c:identifier="g_file_has_uri_scheme">
15843         <doc xml:whitespace="preserve">Checks to see if a #GFile has a given URI scheme.
15844 This call does no blocking i/o.
15845 given URI scheme, %FALSE if URI scheme is %NULL,
15846 not supported, or #GFile is invalid.</doc>
15847         <return-value transfer-ownership="none">
15848           <doc xml:whitespace="preserve">%TRUE if #GFile's backend supports the</doc>
15849           <type name="gboolean" c:type="gboolean"/>
15850         </return-value>
15851         <parameters>
15852           <parameter name="uri_scheme" transfer-ownership="none">
15853             <doc xml:whitespace="preserve">a string containing a URI scheme.</doc>
15854             <type name="utf8" c:type="char*"/>
15855           </parameter>
15856         </parameters>
15857       </method>
15858       <method name="icon_new" c:identifier="g_file_icon_new">
15859         <doc xml:whitespace="preserve">Creates a new icon for a file.</doc>
15860         <return-value transfer-ownership="full">
15861           <doc xml:whitespace="preserve">a #GIcon for the given @file, or %NULL on error.</doc>
15862           <type name="Icon" c:type="GIcon*"/>
15863         </return-value>
15864       </method>
15865       <method name="is_native" c:identifier="g_file_is_native">
15866         <doc xml:whitespace="preserve">Checks to see if a file is native to the platform.
15867 A native file s one expressed in the platform-native filename format,
15868 e.g. "C:\Windows" or "/usr/bin/". This does not mean the file is local,
15869 as it might be on a locally mounted remote filesystem.
15870 On some systems non-native files may be available using
15871 the native filesystem via a userspace filesystem (FUSE), in
15872 these cases this call will return %FALSE, but g_file_get_path()
15873 will still return a native path.
15874 This call does no blocking i/o.</doc>
15875         <return-value transfer-ownership="none">
15876           <doc xml:whitespace="preserve">%TRUE if file is native.</doc>
15877           <type name="gboolean" c:type="gboolean"/>
15878         </return-value>
15879       </method>
15880       <method name="load_contents"
15881               c:identifier="g_file_load_contents"
15882               throws="1">
15883         <doc xml:whitespace="preserve">Loads the content of the file into memory. The data is always
15884 zero-terminated, but this is not included in the resultant @length.
15885 The returned @content should be freed with g_free() when no longer
15886 needed.
15887 If @cancellable is not %NULL, then the operation can be cancelled by
15888 triggering the cancellable object from another thread. If the operation
15889 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
15890 %FALSE if there were errors.</doc>
15891         <return-value transfer-ownership="none">
15892           <doc xml:whitespace="preserve">%TRUE if the @file's contents were successfully loaded.</doc>
15893           <type name="gboolean" c:type="gboolean"/>
15894         </return-value>
15895         <parameters>
15896           <parameter name="cancellable"
15897                      transfer-ownership="none"
15898                      allow-none="1">
15899             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
15900             <type name="Cancellable" c:type="GCancellable*"/>
15901           </parameter>
15902           <parameter name="contents"
15903                      direction="out"
15904                      caller-allocates="0"
15905                      transfer-ownership="full">
15906             <doc xml:whitespace="preserve">a location to place the contents of the file.</doc>
15907             <type name="utf8" c:type="char**"/>
15908           </parameter>
15909           <parameter name="length"
15910                      direction="out"
15911                      caller-allocates="0"
15912                      transfer-ownership="full"
15913                      allow-none="1">
15914             <doc xml:whitespace="preserve">a location to place the length of the contents of the file, or %NULL if the length is not needed</doc>
15915             <type name="gulong" c:type="gsize*"/>
15916           </parameter>
15917           <parameter name="etag_out"
15918                      direction="out"
15919                      caller-allocates="0"
15920                      transfer-ownership="full"
15921                      allow-none="1">
15922             <doc xml:whitespace="preserve">a location to place the current entity tag for the file, or %NULL if the entity tag is not needed</doc>
15923             <type name="utf8" c:type="char**"/>
15924           </parameter>
15925         </parameters>
15926       </method>
15927       <method name="load_contents_async"
15928               c:identifier="g_file_load_contents_async">
15929         <doc xml:whitespace="preserve">Starts an asynchronous load of the @file's contents.
15930 For more details, see g_file_load_contents() which is
15931 the synchronous version of this call.
15932 When the load operation has completed, @callback will be called
15933 with @user data. To finish the operation, call
15934 g_file_load_contents_finish() with the #GAsyncResult returned by
15935 the @callback.
15936 If @cancellable is not %NULL, then the operation can be cancelled by
15937 triggering the cancellable object from another thread. If the operation
15938 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
15939         <return-value transfer-ownership="none">
15940           <type name="none" c:type="void"/>
15941         </return-value>
15942         <parameters>
15943           <parameter name="cancellable"
15944                      transfer-ownership="none"
15945                      allow-none="1">
15946             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
15947             <type name="Cancellable" c:type="GCancellable*"/>
15948           </parameter>
15949           <parameter name="callback"
15950                      transfer-ownership="none"
15951                      scope="async"
15952                      closure="2">
15953             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
15954             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
15955           </parameter>
15956           <parameter name="user_data" transfer-ownership="none">
15957             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
15958             <type name="gpointer" c:type="gpointer"/>
15959           </parameter>
15960         </parameters>
15961       </method>
15962       <method name="load_contents_finish"
15963               c:identifier="g_file_load_contents_finish"
15964               throws="1">
15965         <doc xml:whitespace="preserve">Finishes an asynchronous load of the @file's contents.
15966 The contents are placed in @contents, and @length is set to the
15967 size of the @contents string. The @content should be freed with
15968 g_free() when no longer needed. If @etag_out is present, it will be
15969 set to the new entity tag for the @file.
15970 present, it will be set appropriately.</doc>
15971         <return-value transfer-ownership="none">
15972           <doc xml:whitespace="preserve">%TRUE if the load was successful. If %FALSE and @error is</doc>
15973           <type name="gboolean" c:type="gboolean"/>
15974         </return-value>
15975         <parameters>
15976           <parameter name="res" transfer-ownership="none">
15977             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
15978             <type name="AsyncResult" c:type="GAsyncResult*"/>
15979           </parameter>
15980           <parameter name="contents"
15981                      direction="out"
15982                      caller-allocates="0"
15983                      transfer-ownership="full">
15984             <doc xml:whitespace="preserve">a location to place the contents of the file.</doc>
15985             <type name="utf8" c:type="char**"/>
15986           </parameter>
15987           <parameter name="length"
15988                      direction="out"
15989                      caller-allocates="0"
15990                      transfer-ownership="full"
15991                      allow-none="1">
15992             <doc xml:whitespace="preserve">a location to place the length of the contents of the file, or %NULL if the length is not needed</doc>
15993             <type name="gulong" c:type="gsize*"/>
15994           </parameter>
15995           <parameter name="etag_out"
15996                      direction="out"
15997                      caller-allocates="0"
15998                      transfer-ownership="full"
15999                      allow-none="1">
16000             <doc xml:whitespace="preserve">a location to place the current entity tag for the file, or %NULL if the entity tag is not needed</doc>
16001             <type name="utf8" c:type="char**"/>
16002           </parameter>
16003         </parameters>
16004       </method>
16005       <method name="load_partial_contents_async"
16006               c:identifier="g_file_load_partial_contents_async"
16007               introspectable="0">
16008         <doc xml:whitespace="preserve">Reads the partial contents of a file. A #GFileReadMoreCallback should be
16009 used to stop reading from the file when appropriate, else this function
16010 will behave exactly as g_file_load_contents_async(). This operation
16011 can be finished by g_file_load_partial_contents_finish().
16012 Users of this function should be aware that @user_data is passed to
16013 both the @read_more_callback and the @callback.
16014 If @cancellable is not %NULL, then the operation can be cancelled by
16015 triggering the cancellable object from another thread. If the operation
16016 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
16017         <return-value transfer-ownership="none">
16018           <type name="none" c:type="void"/>
16019         </return-value>
16020         <parameters>
16021           <parameter name="cancellable"
16022                      transfer-ownership="none"
16023                      allow-none="1">
16024             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16025             <type name="Cancellable" c:type="GCancellable*"/>
16026           </parameter>
16027           <parameter name="read_more_callback" transfer-ownership="none">
16028             <doc xml:whitespace="preserve">a #GFileReadMoreCallback to receive partial data and to specify whether further data should be read.</doc>
16029             <type name="FileReadMoreCallback" c:type="GFileReadMoreCallback"/>
16030           </parameter>
16031           <parameter name="callback"
16032                      transfer-ownership="none"
16033                      scope="async"
16034                      closure="3">
16035             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
16036             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
16037           </parameter>
16038           <parameter name="user_data" transfer-ownership="none">
16039             <doc xml:whitespace="preserve">the data to pass to the callback functions.</doc>
16040             <type name="gpointer" c:type="gpointer"/>
16041           </parameter>
16042         </parameters>
16043       </method>
16044       <method name="load_partial_contents_finish"
16045               c:identifier="g_file_load_partial_contents_finish"
16046               throws="1">
16047         <doc xml:whitespace="preserve">Finishes an asynchronous partial load operation that was started
16048 with g_file_load_partial_contents_async(). The data is always
16049 zero-terminated, but this is not included in the resultant @length.
16050 The returned @content should be freed with g_free() when no longer
16051 needed.
16052 present, it will be set appropriately.</doc>
16053         <return-value transfer-ownership="none">
16054           <doc xml:whitespace="preserve">%TRUE if the load was successful. If %FALSE and @error is</doc>
16055           <type name="gboolean" c:type="gboolean"/>
16056         </return-value>
16057         <parameters>
16058           <parameter name="res" transfer-ownership="none">
16059             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
16060             <type name="AsyncResult" c:type="GAsyncResult*"/>
16061           </parameter>
16062           <parameter name="contents"
16063                      direction="out"
16064                      caller-allocates="0"
16065                      transfer-ownership="full">
16066             <doc xml:whitespace="preserve">a location to place the contents of the file.</doc>
16067             <type name="utf8" c:type="char**"/>
16068           </parameter>
16069           <parameter name="length"
16070                      direction="out"
16071                      caller-allocates="0"
16072                      transfer-ownership="full"
16073                      allow-none="1">
16074             <doc xml:whitespace="preserve">a location to place the length of the contents of the file, or %NULL if the length is not needed</doc>
16075             <type name="gulong" c:type="gsize*"/>
16076           </parameter>
16077           <parameter name="etag_out"
16078                      direction="out"
16079                      caller-allocates="0"
16080                      transfer-ownership="full"
16081                      allow-none="1">
16082             <doc xml:whitespace="preserve">a location to place the current entity tag for the file, or %NULL if the entity tag is not needed</doc>
16083             <type name="utf8" c:type="char**"/>
16084           </parameter>
16085         </parameters>
16086       </method>
16087       <method name="make_directory"
16088               c:identifier="g_file_make_directory"
16089               throws="1">
16090         <return-value transfer-ownership="none">
16091           <type name="gboolean" c:type="gboolean"/>
16092         </return-value>
16093         <parameters>
16094           <parameter name="cancellable"
16095                      transfer-ownership="none"
16096                      allow-none="1">
16097             <type name="Cancellable" c:type="GCancellable*"/>
16098           </parameter>
16099         </parameters>
16100       </method>
16101       <method name="make_directory_with_parents"
16102               c:identifier="g_file_make_directory_with_parents"
16103               version="2.18"
16104               throws="1">
16105         <doc xml:whitespace="preserve">Creates a directory and any parent directories that may not exist similar to
16106 'mkdir -p'. If the file system does not support creating directories, this
16107 function will fail, setting @error to %G_IO_ERROR_NOT_SUPPORTED.
16108 For a local #GFile the newly created directories will have the default
16109 (current) ownership and permissions of the current process.
16110 If @cancellable is not %NULL, then the operation can be cancelled by
16111 triggering the cancellable object from another thread. If the operation
16112 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
16113 otherwise.</doc>
16114         <return-value transfer-ownership="none">
16115           <doc xml:whitespace="preserve">%TRUE if all directories have been successfully created, %FALSE</doc>
16116           <type name="gboolean" c:type="gboolean"/>
16117         </return-value>
16118         <parameters>
16119           <parameter name="cancellable"
16120                      transfer-ownership="none"
16121                      allow-none="1">
16122             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16123             <type name="Cancellable" c:type="GCancellable*"/>
16124           </parameter>
16125         </parameters>
16126       </method>
16127       <method name="make_symbolic_link"
16128               c:identifier="g_file_make_symbolic_link"
16129               throws="1">
16130         <doc xml:whitespace="preserve">Creates a symbolic link named @file which contains the string
16131 If @cancellable is not %NULL, then the operation can be cancelled by
16132 triggering the cancellable object from another thread. If the operation
16133 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
16134         <return-value transfer-ownership="none">
16135           <doc xml:whitespace="preserve">%TRUE on the creation of a new symlink, %FALSE otherwise.</doc>
16136           <type name="gboolean" c:type="gboolean"/>
16137         </return-value>
16138         <parameters>
16139           <parameter name="symlink_value" transfer-ownership="none">
16140             <doc xml:whitespace="preserve">a string with the path for the target of the new symlink</doc>
16141             <type name="utf8" c:type="char*"/>
16142           </parameter>
16143           <parameter name="cancellable"
16144                      transfer-ownership="none"
16145                      allow-none="1">
16146             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16147             <type name="Cancellable" c:type="GCancellable*"/>
16148           </parameter>
16149         </parameters>
16150       </method>
16151       <method name="monitor"
16152               c:identifier="g_file_monitor"
16153               version="2.18"
16154               throws="1">
16155         <doc xml:whitespace="preserve">Obtains a file or directory monitor for the given file, depending
16156 on the type of the file.
16157 If @cancellable is not %NULL, then the operation can be cancelled by
16158 triggering the cancellable object from another thread. If the operation
16159 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
16160 Free the returned object with g_object_unref().</doc>
16161         <return-value transfer-ownership="full">
16162           <doc xml:whitespace="preserve">a #GFileMonitor for the given @file, or %NULL on error.</doc>
16163           <type name="FileMonitor" c:type="GFileMonitor*"/>
16164         </return-value>
16165         <parameters>
16166           <parameter name="flags" transfer-ownership="none">
16167             <doc xml:whitespace="preserve">a set of #GFileMonitorFlags</doc>
16168             <type name="FileMonitorFlags" c:type="GFileMonitorFlags"/>
16169           </parameter>
16170           <parameter name="cancellable"
16171                      transfer-ownership="none"
16172                      allow-none="1">
16173             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
16174             <type name="Cancellable" c:type="GCancellable*"/>
16175           </parameter>
16176         </parameters>
16177       </method>
16178       <method name="monitor_directory"
16179               c:identifier="g_file_monitor_directory"
16180               throws="1">
16181         <doc xml:whitespace="preserve">Obtains a directory monitor for the given file.
16182 This may fail if directory monitoring is not supported.
16183 If @cancellable is not %NULL, then the operation can be cancelled by
16184 triggering the cancellable object from another thread. If the operation
16185 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
16186 Free the returned object with g_object_unref().</doc>
16187         <return-value transfer-ownership="full">
16188           <doc xml:whitespace="preserve">a #GFileMonitor for the given @file, or %NULL on error.</doc>
16189           <type name="FileMonitor" c:type="GFileMonitor*"/>
16190         </return-value>
16191         <parameters>
16192           <parameter name="flags" transfer-ownership="none">
16193             <doc xml:whitespace="preserve">a set of #GFileMonitorFlags.</doc>
16194             <type name="FileMonitorFlags" c:type="GFileMonitorFlags"/>
16195           </parameter>
16196           <parameter name="cancellable"
16197                      transfer-ownership="none"
16198                      allow-none="1">
16199             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16200             <type name="Cancellable" c:type="GCancellable*"/>
16201           </parameter>
16202         </parameters>
16203       </method>
16204       <method name="monitor_file"
16205               c:identifier="g_file_monitor_file"
16206               throws="1">
16207         <doc xml:whitespace="preserve">Obtains a file monitor for the given file. If no file notification
16208 mechanism exists, then regular polling of the file is used.
16209 If @cancellable is not %NULL, then the operation can be cancelled by
16210 triggering the cancellable object from another thread. If the operation
16211 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
16212 Free the returned object with g_object_unref().</doc>
16213         <return-value transfer-ownership="full">
16214           <doc xml:whitespace="preserve">a #GFileMonitor for the given @file, or %NULL on error.</doc>
16215           <type name="FileMonitor" c:type="GFileMonitor*"/>
16216         </return-value>
16217         <parameters>
16218           <parameter name="flags" transfer-ownership="none">
16219             <doc xml:whitespace="preserve">a set of #GFileMonitorFlags.</doc>
16220             <type name="FileMonitorFlags" c:type="GFileMonitorFlags"/>
16221           </parameter>
16222           <parameter name="cancellable"
16223                      transfer-ownership="none"
16224                      allow-none="1">
16225             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16226             <type name="Cancellable" c:type="GCancellable*"/>
16227           </parameter>
16228         </parameters>
16229       </method>
16230       <method name="mount_enclosing_volume"
16231               c:identifier="g_file_mount_enclosing_volume">
16232         <doc xml:whitespace="preserve">Starts a @mount_operation, mounting the volume that contains the file @location.
16233 When this operation has completed, @callback will be called with
16234 g_file_mount_enclosing_volume_finish().
16235 If @cancellable is not %NULL, then the operation can be cancelled by
16236 triggering the cancellable object from another thread. If the operation
16237 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
16238         <return-value transfer-ownership="none">
16239           <type name="none" c:type="void"/>
16240         </return-value>
16241         <parameters>
16242           <parameter name="flags" transfer-ownership="none">
16243             <doc xml:whitespace="preserve">flags affecting the operation</doc>
16244             <type name="MountMountFlags" c:type="GMountMountFlags"/>
16245           </parameter>
16246           <parameter name="mount_operation" transfer-ownership="none">
16247             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
16248             <type name="MountOperation" c:type="GMountOperation*"/>
16249           </parameter>
16250           <parameter name="cancellable"
16251                      transfer-ownership="none"
16252                      allow-none="1">
16253             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16254             <type name="Cancellable" c:type="GCancellable*"/>
16255           </parameter>
16256           <parameter name="callback"
16257                      transfer-ownership="none"
16258                      scope="async"
16259                      closure="4">
16260             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
16261             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
16262           </parameter>
16263           <parameter name="user_data" transfer-ownership="none">
16264             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
16265             <type name="gpointer" c:type="gpointer"/>
16266           </parameter>
16267         </parameters>
16268       </method>
16269       <method name="mount_enclosing_volume_finish"
16270               c:identifier="g_file_mount_enclosing_volume_finish"
16271               throws="1">
16272         <doc xml:whitespace="preserve">Finishes a mount operation started by g_file_mount_enclosing_volume().
16273 has occurred, this function will return %FALSE and set @error
16274 appropriately if present.</doc>
16275         <return-value transfer-ownership="none">
16276           <doc xml:whitespace="preserve">%TRUE if successful. If an error</doc>
16277           <type name="gboolean" c:type="gboolean"/>
16278         </return-value>
16279         <parameters>
16280           <parameter name="result" transfer-ownership="none">
16281             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
16282             <type name="AsyncResult" c:type="GAsyncResult*"/>
16283           </parameter>
16284         </parameters>
16285       </method>
16286       <method name="mount_mountable" c:identifier="g_file_mount_mountable">
16287         <doc xml:whitespace="preserve">Mounts a file of type G_FILE_TYPE_MOUNTABLE.
16288 Using @mount_operation, you can request callbacks when, for instance,
16289 passwords are needed during authentication.
16290 If @cancellable is not %NULL, then the operation can be cancelled by
16291 triggering the cancellable object from another thread. If the operation
16292 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
16293 When the operation is finished, @callback will be called. You can then call
16294 g_file_mount_mountable_finish() to get the result of the operation.</doc>
16295         <return-value transfer-ownership="none">
16296           <type name="none" c:type="void"/>
16297         </return-value>
16298         <parameters>
16299           <parameter name="flags" transfer-ownership="none">
16300             <doc xml:whitespace="preserve">flags affecting the operation</doc>
16301             <type name="MountMountFlags" c:type="GMountMountFlags"/>
16302           </parameter>
16303           <parameter name="mount_operation" transfer-ownership="none">
16304             <doc xml:whitespace="preserve">a #GMountOperation, or %NULL to avoid user interaction.</doc>
16305             <type name="MountOperation" c:type="GMountOperation*"/>
16306           </parameter>
16307           <parameter name="cancellable"
16308                      transfer-ownership="none"
16309                      allow-none="1">
16310             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16311             <type name="Cancellable" c:type="GCancellable*"/>
16312           </parameter>
16313           <parameter name="callback"
16314                      transfer-ownership="none"
16315                      scope="async"
16316                      closure="4">
16317             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
16318             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
16319           </parameter>
16320           <parameter name="user_data" transfer-ownership="none">
16321             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
16322             <type name="gpointer" c:type="gpointer"/>
16323           </parameter>
16324         </parameters>
16325       </method>
16326       <method name="mount_mountable_finish"
16327               c:identifier="g_file_mount_mountable_finish"
16328               throws="1">
16329         <doc xml:whitespace="preserve">Finishes a mount operation. See g_file_mount_mountable() for details.
16330 Finish an asynchronous mount operation that was started
16331 with g_file_mount_mountable().
16332 Free the returned object with g_object_unref().</doc>
16333         <return-value transfer-ownership="full">
16334           <doc xml:whitespace="preserve">a #GFile or %NULL on error.</doc>
16335           <type name="File" c:type="GFile*"/>
16336         </return-value>
16337         <parameters>
16338           <parameter name="result" transfer-ownership="none">
16339             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
16340             <type name="AsyncResult" c:type="GAsyncResult*"/>
16341           </parameter>
16342         </parameters>
16343       </method>
16344       <method name="move"
16345               c:identifier="g_file_move"
16346               introspectable="0"
16347               throws="1">
16348         <doc xml:whitespace="preserve">Tries to move the file or directory @source to the location specified by @destination.
16349 If native move operations are supported then this is used, otherwise a copy + delete
16350 fallback is used. The native implementation may support moving directories (for instance
16351 on moves inside the same filesystem), but the fallback code does not.
16352 If the flag #G_FILE_COPY_OVERWRITE is specified an already
16353 existing @destination file is overwritten.
16354 If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
16355 will be copied as symlinks, otherwise the target of the
16356 If @cancellable is not %NULL, then the operation can be cancelled by
16357 triggering the cancellable object from another thread. If the operation
16358 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
16359 If @progress_callback is not %NULL, then the operation can be monitored by
16360 setting this to a #GFileProgressCallback function. @progress_callback_data
16361 will be passed to this function. It is guaranteed that this callback will
16362 be called after all data has been transferred with the total number of bytes
16363 copied during the operation.
16364 If the @source file does not exist then the G_IO_ERROR_NOT_FOUND
16365 error is returned, independent on the status of the @destination.
16366 If #G_FILE_COPY_OVERWRITE is not specified and the target exists, then the
16367 error G_IO_ERROR_EXISTS is returned.
16368 If trying to overwrite a file over a directory the G_IO_ERROR_IS_DIRECTORY
16369 error is returned. If trying to overwrite a directory with a directory the
16370 G_IO_ERROR_WOULD_MERGE error is returned.
16371 If the source is a directory and the target does not exist, or #G_FILE_COPY_OVERWRITE is
16372 specified and the target is a file, then the G_IO_ERROR_WOULD_RECURSE error
16373 may be returned (if the native move operation isn't available).</doc>
16374         <return-value transfer-ownership="none">
16375           <doc xml:whitespace="preserve">%TRUE on successful move, %FALSE otherwise.</doc>
16376           <type name="gboolean" c:type="gboolean"/>
16377         </return-value>
16378         <parameters>
16379           <parameter name="destination" transfer-ownership="none">
16380             <doc xml:whitespace="preserve">#GFile pointing to the destination location.</doc>
16381             <type name="File" c:type="GFile*"/>
16382           </parameter>
16383           <parameter name="flags" transfer-ownership="none">
16384             <doc xml:whitespace="preserve">set of #GFileCopyFlags.</doc>
16385             <type name="FileCopyFlags" c:type="GFileCopyFlags"/>
16386           </parameter>
16387           <parameter name="cancellable"
16388                      transfer-ownership="none"
16389                      allow-none="1">
16390             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16391             <type name="Cancellable" c:type="GCancellable*"/>
16392           </parameter>
16393           <parameter name="progress_callback"
16394                      transfer-ownership="none"
16395                      closure="4">
16396             <doc xml:whitespace="preserve">#GFileProgressCallback function for updates.</doc>
16397             <type name="FileProgressCallback" c:type="GFileProgressCallback"/>
16398           </parameter>
16399           <parameter name="progress_callback_data" transfer-ownership="none">
16400             <doc xml:whitespace="preserve">gpointer to user data for the callback function.</doc>
16401             <type name="gpointer" c:type="gpointer"/>
16402           </parameter>
16403         </parameters>
16404       </method>
16405       <method name="open_readwrite"
16406               c:identifier="g_file_open_readwrite"
16407               version="2.22"
16408               throws="1">
16409         <doc xml:whitespace="preserve">Opens an existing file for reading and writing. The result is
16410 a #GFileIOStream that can be used to read and write the contents of the file.
16411 If @cancellable is not %NULL, then the operation can be cancelled by
16412 triggering the cancellable object from another thread. If the operation
16413 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
16414 If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
16415 If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned.
16416 Other errors are possible too, and depend on what kind of filesystem the file is on.
16417 Note that in many non-local file cases read and write streams are not supported,
16418 so make sure you really need to do read and write streaming, rather than
16419 just opening for reading or writing.
16420 Free the returned object with g_object_unref().</doc>
16421         <return-value transfer-ownership="full">
16422           <doc xml:whitespace="preserve">#GFileIOStream or %NULL on error.</doc>
16423           <type name="FileIOStream" c:type="GFileIOStream*"/>
16424         </return-value>
16425         <parameters>
16426           <parameter name="cancellable"
16427                      transfer-ownership="none"
16428                      allow-none="1">
16429             <doc xml:whitespace="preserve">a #GCancellable</doc>
16430             <type name="Cancellable" c:type="GCancellable*"/>
16431           </parameter>
16432         </parameters>
16433       </method>
16434       <method name="open_readwrite_async"
16435               c:identifier="g_file_open_readwrite_async"
16436               version="2.22">
16437         <doc xml:whitespace="preserve">Asynchronously opens @file for reading and writing.
16438 For more details, see g_file_open_readwrite() which is
16439 the synchronous version of this call.
16440 When the operation is finished, @callback will be called. You can then call
16441 g_file_open_readwrite_finish() to get the result of the operation.</doc>
16442         <return-value transfer-ownership="none">
16443           <type name="none" c:type="void"/>
16444         </return-value>
16445         <parameters>
16446           <parameter name="io_priority" transfer-ownership="none">
16447             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
16448             <type name="gint" c:type="int"/>
16449           </parameter>
16450           <parameter name="cancellable"
16451                      transfer-ownership="none"
16452                      allow-none="1">
16453             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16454             <type name="Cancellable" c:type="GCancellable*"/>
16455           </parameter>
16456           <parameter name="callback"
16457                      transfer-ownership="none"
16458                      scope="async"
16459                      closure="3">
16460             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
16461             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
16462           </parameter>
16463           <parameter name="user_data" transfer-ownership="none">
16464             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
16465             <type name="gpointer" c:type="gpointer"/>
16466           </parameter>
16467         </parameters>
16468       </method>
16469       <method name="open_readwrite_finish"
16470               c:identifier="g_file_open_readwrite_finish"
16471               version="2.22"
16472               throws="1">
16473         <doc xml:whitespace="preserve">Finishes an asynchronous file read operation started with
16474 g_file_open_readwrite_async().
16475 Free the returned object with g_object_unref().</doc>
16476         <return-value transfer-ownership="full">
16477           <doc xml:whitespace="preserve">a #GFileIOStream or %NULL on error.</doc>
16478           <type name="FileIOStream" c:type="GFileIOStream*"/>
16479         </return-value>
16480         <parameters>
16481           <parameter name="res" transfer-ownership="none">
16482             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
16483             <type name="AsyncResult" c:type="GAsyncResult*"/>
16484           </parameter>
16485         </parameters>
16486       </method>
16487       <method name="poll_mountable"
16488               c:identifier="g_file_poll_mountable"
16489               version="2.22">
16490         <doc xml:whitespace="preserve">Polls a file of type G_FILE_TYPE_MOUNTABLE.
16491 If @cancellable is not %NULL, then the operation can be cancelled by
16492 triggering the cancellable object from another thread. If the operation
16493 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
16494 When the operation is finished, @callback will be called. You can then call
16495 g_file_mount_mountable_finish() to get the result of the operation.</doc>
16496         <return-value transfer-ownership="none">
16497           <type name="none" c:type="void"/>
16498         </return-value>
16499         <parameters>
16500           <parameter name="cancellable"
16501                      transfer-ownership="none"
16502                      allow-none="1">
16503             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16504             <type name="Cancellable" c:type="GCancellable*"/>
16505           </parameter>
16506           <parameter name="callback"
16507                      transfer-ownership="none"
16508                      scope="async"
16509                      closure="2">
16510             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
16511             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
16512           </parameter>
16513           <parameter name="user_data" transfer-ownership="none">
16514             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
16515             <type name="gpointer" c:type="gpointer"/>
16516           </parameter>
16517         </parameters>
16518       </method>
16519       <method name="poll_mountable_finish"
16520               c:identifier="g_file_poll_mountable_finish"
16521               version="2.22"
16522               throws="1">
16523         <doc xml:whitespace="preserve">Finishes a poll operation. See g_file_poll_mountable() for details.
16524 Finish an asynchronous poll operation that was polled
16525 with g_file_poll_mountable().
16526 otherwise.</doc>
16527         <return-value transfer-ownership="none">
16528           <doc xml:whitespace="preserve">%TRUE if the operation finished successfully. %FALSE</doc>
16529           <type name="gboolean" c:type="gboolean"/>
16530         </return-value>
16531         <parameters>
16532           <parameter name="result" transfer-ownership="none">
16533             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
16534             <type name="AsyncResult" c:type="GAsyncResult*"/>
16535           </parameter>
16536         </parameters>
16537       </method>
16538       <method name="query_default_handler"
16539               c:identifier="g_file_query_default_handler"
16540               throws="1">
16541         <doc xml:whitespace="preserve">Returns the #GAppInfo that is registered as the default
16542 application to handle the file specified by @file.
16543 If @cancellable is not %NULL, then the operation can be cancelled by
16544 triggering the cancellable object from another thread. If the operation
16545 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
16546 When you are done with it, release it with g_object_unref()</doc>
16547         <return-value transfer-ownership="full">
16548           <doc xml:whitespace="preserve">a #GAppInfo if the handle was found, %NULL if there were errors.</doc>
16549           <type name="AppInfo" c:type="GAppInfo*"/>
16550         </return-value>
16551         <parameters>
16552           <parameter name="cancellable"
16553                      transfer-ownership="none"
16554                      allow-none="1">
16555             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16556             <type name="Cancellable" c:type="GCancellable*"/>
16557           </parameter>
16558         </parameters>
16559       </method>
16560       <method name="query_exists" c:identifier="g_file_query_exists">
16561         <doc xml:whitespace="preserve">Utility function to check if a particular file exists. This is
16562 implemented using g_file_query_info() and as such does blocking I/O.
16563 Note that in many cases it is racy to first check for file existence
16564 and then execute something based on the outcome of that, because the
16565 file might have been created or removed in between the operations. The
16566 general approach to handling that is to not check, but just do the
16567 operation and handle the errors as they come.
16568 As an example of race-free checking, take the case of reading a file, and
16569 can both result in two processes creating the file (with perhaps a partially
16570 written file as the result). The correct approach is to always try to create
16571 the file with g_file_create() which will either atomically create the file
16572 or fail with a G_IO_ERROR_EXISTS error.
16573 However, in many cases an existence check is useful in a user
16574 interface, for instance to make a menu item sensitive/insensitive, so that
16575 you don't have to fool users that something is possible and then just show
16576 and error dialog. If you do this, you should make sure to also handle the
16577 errors that can happen due to races when you execute the operation.</doc>
16578         <return-value transfer-ownership="none">
16579           <doc xml:whitespace="preserve">%TRUE if the file exists (and can be detected without error), %FALSE otherwise (or if cancelled).</doc>
16580           <type name="gboolean" c:type="gboolean"/>
16581         </return-value>
16582         <parameters>
16583           <parameter name="cancellable"
16584                      transfer-ownership="none"
16585                      allow-none="1">
16586             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16587             <type name="Cancellable" c:type="GCancellable*"/>
16588           </parameter>
16589         </parameters>
16590       </method>
16591       <method name="query_file_type"
16592               c:identifier="g_file_query_file_type"
16593               version="2.18">
16594         <doc xml:whitespace="preserve">Utility function to inspect the #GFileType of a file. This is
16595 implemented using g_file_query_info() and as such does blocking I/O.
16596 The primary use case of this method is to check if a file is a regular file,
16597 directory, or symlink.
16598 does not exist</doc>
16599         <return-value transfer-ownership="none">
16600           <doc xml:whitespace="preserve">The #GFileType of the file and #G_FILE_TYPE_UNKNOWN if the file</doc>
16601           <type name="FileType" c:type="GFileType"/>
16602         </return-value>
16603         <parameters>
16604           <parameter name="flags" transfer-ownership="none">
16605             <doc xml:whitespace="preserve">a set of #GFileQueryInfoFlags passed to g_file_query_info().</doc>
16606             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
16607           </parameter>
16608           <parameter name="cancellable"
16609                      transfer-ownership="none"
16610                      allow-none="1">
16611             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16612             <type name="Cancellable" c:type="GCancellable*"/>
16613           </parameter>
16614         </parameters>
16615       </method>
16616       <method name="query_filesystem_info"
16617               c:identifier="g_file_query_filesystem_info"
16618               throws="1">
16619         <doc xml:whitespace="preserve">Similar to g_file_query_info(), but obtains information
16620 about the filesystem the @file is on, rather than the file itself.
16621 For instance the amount of space available and the type of
16622 the filesystem.
16623 The @attributes value is a string that specifies the file attributes that
16624 should be gathered. It is not an error if it's not possible to read a particular
16625 requested attribute from a file - it just won't be set. @attributes should
16626 be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
16627 means all attributes, and a wildcard like "fs:*" means all attributes in the fs
16628 namespace. The standard namespace for filesystem attributes is "fs".
16629 Common attributes of interest are #G_FILE_ATTRIBUTE_FILESYSTEM_SIZE
16630 (the total size of the filesystem in bytes), #G_FILE_ATTRIBUTE_FILESYSTEM_FREE (number of
16631 bytes available), and #G_FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem).
16632 If @cancellable is not %NULL, then the operation can be cancelled by
16633 triggering the cancellable object from another thread. If the operation
16634 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
16635 If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
16636 Other errors are possible too, and depend on what kind of filesystem the file is on.
16637 Free the returned object with g_object_unref().</doc>
16638         <return-value transfer-ownership="full">
16639           <doc xml:whitespace="preserve">a #GFileInfo or %NULL if there was an error.</doc>
16640           <type name="FileInfo" c:type="GFileInfo*"/>
16641         </return-value>
16642         <parameters>
16643           <parameter name="attributes" transfer-ownership="none">
16644             <doc xml:whitespace="preserve">an attribute query string.</doc>
16645             <type name="utf8" c:type="char*"/>
16646           </parameter>
16647           <parameter name="cancellable"
16648                      transfer-ownership="none"
16649                      allow-none="1">
16650             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16651             <type name="Cancellable" c:type="GCancellable*"/>
16652           </parameter>
16653         </parameters>
16654       </method>
16655       <method name="query_filesystem_info_async"
16656               c:identifier="g_file_query_filesystem_info_async">
16657         <doc xml:whitespace="preserve">Asynchronously gets the requested information about the filesystem
16658 that the specified @file is on. The result is a #GFileInfo object
16659 that contains key-value attributes (such as type or size for the
16660 file).
16661 For more details, see g_file_query_filesystem_info() which is the
16662 synchronous version of this call.
16663 When the operation is finished, @callback will be called. You can
16664 then call g_file_query_info_finish() to get the result of the
16665 operation.</doc>
16666         <return-value transfer-ownership="none">
16667           <type name="none" c:type="void"/>
16668         </return-value>
16669         <parameters>
16670           <parameter name="attributes" transfer-ownership="none">
16671             <doc xml:whitespace="preserve">an attribute query string.</doc>
16672             <type name="utf8" c:type="char*"/>
16673           </parameter>
16674           <parameter name="io_priority" transfer-ownership="none">
16675             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
16676             <type name="gint" c:type="int"/>
16677           </parameter>
16678           <parameter name="cancellable"
16679                      transfer-ownership="none"
16680                      allow-none="1">
16681             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16682             <type name="Cancellable" c:type="GCancellable*"/>
16683           </parameter>
16684           <parameter name="callback"
16685                      transfer-ownership="none"
16686                      scope="async"
16687                      closure="4">
16688             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
16689             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
16690           </parameter>
16691           <parameter name="user_data" transfer-ownership="none">
16692             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
16693             <type name="gpointer" c:type="gpointer"/>
16694           </parameter>
16695         </parameters>
16696       </method>
16697       <method name="query_filesystem_info_finish"
16698               c:identifier="g_file_query_filesystem_info_finish"
16699               throws="1">
16700         <doc xml:whitespace="preserve">Finishes an asynchronous filesystem info query.  See
16701 g_file_query_filesystem_info_async().
16702 Free the returned object with g_object_unref().</doc>
16703         <return-value transfer-ownership="full">
16704           <doc xml:whitespace="preserve">#GFileInfo for given @file or %NULL on error.</doc>
16705           <type name="FileInfo" c:type="GFileInfo*"/>
16706         </return-value>
16707         <parameters>
16708           <parameter name="res" transfer-ownership="none">
16709             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
16710             <type name="AsyncResult" c:type="GAsyncResult*"/>
16711           </parameter>
16712         </parameters>
16713       </method>
16714       <method name="query_info" c:identifier="g_file_query_info" throws="1">
16715         <doc xml:whitespace="preserve">Gets the requested information about specified @file. The result
16716 is a #GFileInfo object that contains key-value attributes (such as
16717 the type or size of the file).
16718 The @attributes value is a string that specifies the file attributes that
16719 should be gathered. It is not an error if it's not possible to read a particular
16720 requested attribute from a file - it just won't be set. @attributes should
16721 be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
16722 means all attributes, and a wildcard like "standard::*" means all attributes in the standard
16723 namespace. An example attribute query be "standard::*,owner::user".
16724 The standard attributes are available as defines, like #G_FILE_ATTRIBUTE_STANDARD_NAME.
16725 If @cancellable is not %NULL, then the operation can be cancelled by
16726 triggering the cancellable object from another thread. If the operation
16727 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
16728 For symlinks, normally the information about the target of the
16729 symlink is returned, rather than information about the symlink itself.
16730 However if you pass #G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS in @flags the
16731 information about the symlink itself will be returned. Also, for symlinks
16732 that point to non-existing files the information about the symlink itself
16733 will be returned.
16734 If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
16735 Other errors are possible too, and depend on what kind of filesystem the file is on.
16736 Free the returned object with g_object_unref().</doc>
16737         <return-value transfer-ownership="full">
16738           <doc xml:whitespace="preserve">a #GFileInfo for the given @file, or %NULL on error.</doc>
16739           <type name="FileInfo" c:type="GFileInfo*"/>
16740         </return-value>
16741         <parameters>
16742           <parameter name="attributes" transfer-ownership="none">
16743             <doc xml:whitespace="preserve">an attribute query string.</doc>
16744             <type name="utf8" c:type="char*"/>
16745           </parameter>
16746           <parameter name="flags" transfer-ownership="none">
16747             <doc xml:whitespace="preserve">a set of #GFileQueryInfoFlags.</doc>
16748             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
16749           </parameter>
16750           <parameter name="cancellable"
16751                      transfer-ownership="none"
16752                      allow-none="1">
16753             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16754             <type name="Cancellable" c:type="GCancellable*"/>
16755           </parameter>
16756         </parameters>
16757       </method>
16758       <method name="query_info_async" c:identifier="g_file_query_info_async">
16759         <doc xml:whitespace="preserve">Asynchronously gets the requested information about specified @file. The result
16760 is a #GFileInfo object that contains key-value attributes (such as type or size
16761 for the file).
16762 For more details, see g_file_query_info() which is
16763 the synchronous version of this call.
16764 When the operation is finished, @callback will be called. You can then call
16765 g_file_query_info_finish() to get the result of the operation.</doc>
16766         <return-value transfer-ownership="none">
16767           <type name="none" c:type="void"/>
16768         </return-value>
16769         <parameters>
16770           <parameter name="attributes" transfer-ownership="none">
16771             <doc xml:whitespace="preserve">an attribute query string.</doc>
16772             <type name="utf8" c:type="char*"/>
16773           </parameter>
16774           <parameter name="flags" transfer-ownership="none">
16775             <doc xml:whitespace="preserve">a set of #GFileQueryInfoFlags.</doc>
16776             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
16777           </parameter>
16778           <parameter name="io_priority" transfer-ownership="none">
16779             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
16780             <type name="gint" c:type="int"/>
16781           </parameter>
16782           <parameter name="cancellable"
16783                      transfer-ownership="none"
16784                      allow-none="1">
16785             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16786             <type name="Cancellable" c:type="GCancellable*"/>
16787           </parameter>
16788           <parameter name="callback"
16789                      transfer-ownership="none"
16790                      scope="async"
16791                      closure="5">
16792             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
16793             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
16794           </parameter>
16795           <parameter name="user_data" transfer-ownership="none">
16796             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
16797             <type name="gpointer" c:type="gpointer"/>
16798           </parameter>
16799         </parameters>
16800       </method>
16801       <method name="query_info_finish"
16802               c:identifier="g_file_query_info_finish"
16803               throws="1">
16804         <doc xml:whitespace="preserve">Finishes an asynchronous file info query.
16805 See g_file_query_info_async().
16806 Free the returned object with g_object_unref().</doc>
16807         <return-value transfer-ownership="full">
16808           <doc xml:whitespace="preserve">#GFileInfo for given @file or %NULL on error.</doc>
16809           <type name="FileInfo" c:type="GFileInfo*"/>
16810         </return-value>
16811         <parameters>
16812           <parameter name="res" transfer-ownership="none">
16813             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
16814             <type name="AsyncResult" c:type="GAsyncResult*"/>
16815           </parameter>
16816         </parameters>
16817       </method>
16818       <method name="query_settable_attributes"
16819               c:identifier="g_file_query_settable_attributes"
16820               throws="1">
16821         <doc xml:whitespace="preserve">Obtain the list of settable attributes for the file.
16822 Returns the type and full attribute name of all the attributes
16823 that can be set on this file. This doesn't mean setting it will always
16824 succeed though, you might get an access failure, or some specific
16825 file may not support a specific attribute.
16826 If @cancellable is not %NULL, then the operation can be cancelled by
16827 triggering the cancellable object from another thread. If the operation
16828 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
16829 When you are done with it, release it with g_file_attribute_info_list_unref()</doc>
16830         <return-value transfer-ownership="full">
16831           <doc xml:whitespace="preserve">a #GFileAttributeInfoList describing the settable attributes.</doc>
16832           <type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
16833         </return-value>
16834         <parameters>
16835           <parameter name="cancellable"
16836                      transfer-ownership="none"
16837                      allow-none="1">
16838             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16839             <type name="Cancellable" c:type="GCancellable*"/>
16840           </parameter>
16841         </parameters>
16842       </method>
16843       <method name="query_writable_namespaces"
16844               c:identifier="g_file_query_writable_namespaces"
16845               throws="1">
16846         <doc xml:whitespace="preserve">Obtain the list of attribute namespaces where new attributes
16847 can be created by a user. An example of this is extended
16848 attributes (in the "xattr" namespace).
16849 If @cancellable is not %NULL, then the operation can be cancelled by
16850 triggering the cancellable object from another thread. If the operation
16851 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
16852 When you are done with it, release it with g_file_attribute_info_list_unref()</doc>
16853         <return-value transfer-ownership="full">
16854           <doc xml:whitespace="preserve">a #GFileAttributeInfoList describing the writable namespaces.</doc>
16855           <type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
16856         </return-value>
16857         <parameters>
16858           <parameter name="cancellable"
16859                      transfer-ownership="none"
16860                      allow-none="1">
16861             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16862             <type name="Cancellable" c:type="GCancellable*"/>
16863           </parameter>
16864         </parameters>
16865       </method>
16866       <method name="read" c:identifier="g_file_read" throws="1">
16867         <doc xml:whitespace="preserve">Opens a file for reading. The result is a #GFileInputStream that
16868 can be used to read the contents of the file.
16869 If @cancellable is not %NULL, then the operation can be cancelled by
16870 triggering the cancellable object from another thread. If the operation
16871 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
16872 If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
16873 If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned.
16874 Other errors are possible too, and depend on what kind of filesystem the file is on.
16875 Free the returned object with g_object_unref().</doc>
16876         <return-value transfer-ownership="full">
16877           <doc xml:whitespace="preserve">#GFileInputStream or %NULL on error.</doc>
16878           <type name="FileInputStream" c:type="GFileInputStream*"/>
16879         </return-value>
16880         <parameters>
16881           <parameter name="cancellable"
16882                      transfer-ownership="none"
16883                      allow-none="1">
16884             <doc xml:whitespace="preserve">a #GCancellable</doc>
16885             <type name="Cancellable" c:type="GCancellable*"/>
16886           </parameter>
16887         </parameters>
16888       </method>
16889       <method name="read_async" c:identifier="g_file_read_async">
16890         <doc xml:whitespace="preserve">Asynchronously opens @file for reading.
16891 For more details, see g_file_read() which is
16892 the synchronous version of this call.
16893 When the operation is finished, @callback will be called. You can then call
16894 g_file_read_finish() to get the result of the operation.</doc>
16895         <return-value transfer-ownership="none">
16896           <type name="none" c:type="void"/>
16897         </return-value>
16898         <parameters>
16899           <parameter name="io_priority" transfer-ownership="none">
16900             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
16901             <type name="gint" c:type="int"/>
16902           </parameter>
16903           <parameter name="cancellable"
16904                      transfer-ownership="none"
16905                      allow-none="1">
16906             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16907             <type name="Cancellable" c:type="GCancellable*"/>
16908           </parameter>
16909           <parameter name="callback"
16910                      transfer-ownership="none"
16911                      scope="async"
16912                      closure="3">
16913             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
16914             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
16915           </parameter>
16916           <parameter name="user_data" transfer-ownership="none">
16917             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
16918             <type name="gpointer" c:type="gpointer"/>
16919           </parameter>
16920         </parameters>
16921       </method>
16922       <method name="read_finish" c:identifier="g_file_read_finish" throws="1">
16923         <doc xml:whitespace="preserve">Finishes an asynchronous file read operation started with
16924 g_file_read_async().
16925 Free the returned object with g_object_unref().</doc>
16926         <return-value transfer-ownership="full">
16927           <doc xml:whitespace="preserve">a #GFileInputStream or %NULL on error.</doc>
16928           <type name="FileInputStream" c:type="GFileInputStream*"/>
16929         </return-value>
16930         <parameters>
16931           <parameter name="res" transfer-ownership="none">
16932             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
16933             <type name="AsyncResult" c:type="GAsyncResult*"/>
16934           </parameter>
16935         </parameters>
16936       </method>
16937       <method name="replace" c:identifier="g_file_replace" throws="1">
16938         <doc xml:whitespace="preserve">Returns an output stream for overwriting the file, possibly
16939 creating a backup copy of the file first. If the file doesn't exist,
16940 it will be created.
16941 This will try to replace the file in the safest way possible so
16942 that any errors during the writing will not affect an already
16943 existing copy of the file. For instance, for local files it
16944 may write to a temporary file and then atomically rename over
16945 the destination when the stream is closed.
16946 By default files created are generally readable by everyone,
16947 but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
16948 will be made readable only to the current user, to the level that
16949 is supported on the target filesystem.
16950 If @cancellable is not %NULL, then the operation can be cancelled by
16951 triggering the cancellable object from another thread. If the operation
16952 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
16953 If you pass in a non-#NULL @etag value, then this value is
16954 compared to the current entity tag of the file, and if they differ
16955 an G_IO_ERROR_WRONG_ETAG error is returned. This generally means
16956 that the file has been changed since you last read it. You can get
16957 the new etag from g_file_output_stream_get_etag() after you've
16958 finished writing and closed the #GFileOutputStream. When you load
16959 a new file you can use g_file_input_stream_query_info() to get
16960 the etag of the file.
16961 If @make_backup is %TRUE, this function will attempt to make a backup
16962 of the current file before overwriting it. If this fails a G_IO_ERROR_CANT_CREATE_BACKUP
16963 error will be returned. If you want to replace anyway, try again with
16964 If the file is a directory the G_IO_ERROR_IS_DIRECTORY error will be returned,
16965 and if the file is some other form of non-regular file then a
16966 G_IO_ERROR_NOT_REGULAR_FILE error will be returned.
16967 Some file systems don't allow all file names, and may
16968 return an G_IO_ERROR_INVALID_FILENAME error, and if the name
16969 is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned.
16970 Other errors are possible too, and depend on what kind of
16971 filesystem the file is on.
16972 Free the returned object with g_object_unref().</doc>
16973         <return-value transfer-ownership="full">
16974           <doc xml:whitespace="preserve">a #GFileOutputStream or %NULL on error.</doc>
16975           <type name="FileOutputStream" c:type="GFileOutputStream*"/>
16976         </return-value>
16977         <parameters>
16978           <parameter name="etag" transfer-ownership="none" allow-none="1">
16979             <doc xml:whitespace="preserve">an optional &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for the current #GFile, or #NULL to ignore.</doc>
16980             <type name="utf8" c:type="char*"/>
16981           </parameter>
16982           <parameter name="make_backup" transfer-ownership="none">
16983             <doc xml:whitespace="preserve">%TRUE if a backup should be created.</doc>
16984             <type name="gboolean" c:type="gboolean"/>
16985           </parameter>
16986           <parameter name="flags" transfer-ownership="none">
16987             <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
16988             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
16989           </parameter>
16990           <parameter name="cancellable"
16991                      transfer-ownership="none"
16992                      allow-none="1">
16993             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
16994             <type name="Cancellable" c:type="GCancellable*"/>
16995           </parameter>
16996         </parameters>
16997       </method>
16998       <method name="replace_async" c:identifier="g_file_replace_async">
16999         <doc xml:whitespace="preserve">Asynchronously overwrites the file, replacing the contents, possibly
17000 creating a backup copy of the file first.
17001 For more details, see g_file_replace() which is
17002 the synchronous version of this call.
17003 When the operation is finished, @callback will be called. You can then call
17004 g_file_replace_finish() to get the result of the operation.</doc>
17005         <return-value transfer-ownership="none">
17006           <type name="none" c:type="void"/>
17007         </return-value>
17008         <parameters>
17009           <parameter name="etag" transfer-ownership="none" allow-none="1">
17010             <doc xml:whitespace="preserve">an &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for the current #GFile, or NULL to ignore.</doc>
17011             <type name="utf8" c:type="char*"/>
17012           </parameter>
17013           <parameter name="make_backup" transfer-ownership="none">
17014             <doc xml:whitespace="preserve">%TRUE if a backup should be created.</doc>
17015             <type name="gboolean" c:type="gboolean"/>
17016           </parameter>
17017           <parameter name="flags" transfer-ownership="none">
17018             <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
17019             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
17020           </parameter>
17021           <parameter name="io_priority" transfer-ownership="none">
17022             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
17023             <type name="gint" c:type="int"/>
17024           </parameter>
17025           <parameter name="cancellable"
17026                      transfer-ownership="none"
17027                      allow-none="1">
17028             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17029             <type name="Cancellable" c:type="GCancellable*"/>
17030           </parameter>
17031           <parameter name="callback"
17032                      transfer-ownership="none"
17033                      scope="async"
17034                      closure="6">
17035             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
17036             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
17037           </parameter>
17038           <parameter name="user_data" transfer-ownership="none">
17039             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
17040             <type name="gpointer" c:type="gpointer"/>
17041           </parameter>
17042         </parameters>
17043       </method>
17044       <method name="replace_contents"
17045               c:identifier="g_file_replace_contents"
17046               throws="1">
17047         <doc xml:whitespace="preserve">Replaces the contents of @file with @contents of @length bytes.
17048 If @etag is specified (not %NULL) any existing file must have that etag, or
17049 the error %G_IO_ERROR_WRONG_ETAG will be returned.
17050 If @make_backup is %TRUE, this function will attempt to make a backup of @file.
17051 If @cancellable is not %NULL, then the operation can be cancelled by
17052 triggering the cancellable object from another thread. If the operation
17053 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
17054 The returned @new_etag can be used to verify that the file hasn't changed the
17055 next time it is saved over.
17056 has occurred, this function will return %FALSE and set @error
17057 appropriately if present.</doc>
17058         <return-value transfer-ownership="none">
17059           <doc xml:whitespace="preserve">%TRUE if successful. If an error</doc>
17060           <type name="gboolean" c:type="gboolean"/>
17061         </return-value>
17062         <parameters>
17063           <parameter name="contents" transfer-ownership="none">
17064             <doc xml:whitespace="preserve">a string containing the new contents for @file.</doc>
17065             <type name="utf8" c:type="char*"/>
17066           </parameter>
17067           <parameter name="length" transfer-ownership="none">
17068             <doc xml:whitespace="preserve">the length of @contents in bytes.</doc>
17069             <type name="gulong" c:type="gsize"/>
17070           </parameter>
17071           <parameter name="etag" transfer-ownership="none" allow-none="1">
17072             <doc xml:whitespace="preserve">the old &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for the document, or %NULL</doc>
17073             <type name="utf8" c:type="char*"/>
17074           </parameter>
17075           <parameter name="make_backup" transfer-ownership="none">
17076             <doc xml:whitespace="preserve">%TRUE if a backup should be created.</doc>
17077             <type name="gboolean" c:type="gboolean"/>
17078           </parameter>
17079           <parameter name="flags" transfer-ownership="none">
17080             <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
17081             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
17082           </parameter>
17083           <parameter name="new_etag"
17084                      direction="out"
17085                      caller-allocates="0"
17086                      transfer-ownership="full"
17087                      allow-none="1">
17088             <doc xml:whitespace="preserve">a location to a new &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for the document. This should be freed with g_free() when no longer needed, or %NULL</doc>
17089             <type name="utf8" c:type="char**"/>
17090           </parameter>
17091           <parameter name="cancellable"
17092                      transfer-ownership="none"
17093                      allow-none="1">
17094             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17095             <type name="Cancellable" c:type="GCancellable*"/>
17096           </parameter>
17097         </parameters>
17098       </method>
17099       <method name="replace_contents_async"
17100               c:identifier="g_file_replace_contents_async">
17101         <doc xml:whitespace="preserve">Starts an asynchronous replacement of @file with the given
17102 current entity tag.
17103 When this operation has completed, @callback will be called with
17104 g_file_replace_contents_finish().
17105 If @cancellable is not %NULL, then the operation can be cancelled by
17106 triggering the cancellable object from another thread. If the operation
17107 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
17108 If @make_backup is %TRUE, this function will attempt to
17109 make a backup of @file.</doc>
17110         <return-value transfer-ownership="none">
17111           <type name="none" c:type="void"/>
17112         </return-value>
17113         <parameters>
17114           <parameter name="contents" transfer-ownership="none">
17115             <doc xml:whitespace="preserve">string of contents to replace the file with.</doc>
17116             <type name="utf8" c:type="char*"/>
17117           </parameter>
17118           <parameter name="length" transfer-ownership="none">
17119             <doc xml:whitespace="preserve">the length of @contents in bytes.</doc>
17120             <type name="gulong" c:type="gsize"/>
17121           </parameter>
17122           <parameter name="etag" transfer-ownership="none" allow-none="1">
17123             <doc xml:whitespace="preserve">a new &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for the @file, or %NULL</doc>
17124             <type name="utf8" c:type="char*"/>
17125           </parameter>
17126           <parameter name="make_backup" transfer-ownership="none">
17127             <doc xml:whitespace="preserve">%TRUE if a backup should be created.</doc>
17128             <type name="gboolean" c:type="gboolean"/>
17129           </parameter>
17130           <parameter name="flags" transfer-ownership="none">
17131             <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
17132             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
17133           </parameter>
17134           <parameter name="cancellable"
17135                      transfer-ownership="none"
17136                      allow-none="1">
17137             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17138             <type name="Cancellable" c:type="GCancellable*"/>
17139           </parameter>
17140           <parameter name="callback"
17141                      transfer-ownership="none"
17142                      scope="async"
17143                      closure="7">
17144             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
17145             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
17146           </parameter>
17147           <parameter name="user_data" transfer-ownership="none">
17148             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
17149             <type name="gpointer" c:type="gpointer"/>
17150           </parameter>
17151         </parameters>
17152       </method>
17153       <method name="replace_contents_finish"
17154               c:identifier="g_file_replace_contents_finish"
17155               throws="1">
17156         <doc xml:whitespace="preserve">Finishes an asynchronous replace of the given @file. See
17157 g_file_replace_contents_async(). Sets @new_etag to the new entity
17158 tag for the document, if present.</doc>
17159         <return-value transfer-ownership="none">
17160           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on failure.</doc>
17161           <type name="gboolean" c:type="gboolean"/>
17162         </return-value>
17163         <parameters>
17164           <parameter name="res" transfer-ownership="none">
17165             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
17166             <type name="AsyncResult" c:type="GAsyncResult*"/>
17167           </parameter>
17168           <parameter name="new_etag"
17169                      direction="out"
17170                      caller-allocates="0"
17171                      transfer-ownership="full"
17172                      allow-none="1">
17173             <doc xml:whitespace="preserve">a location of a new &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for the document. This should be freed with g_free() when it is no longer needed, or %NULL</doc>
17174             <type name="utf8" c:type="char**"/>
17175           </parameter>
17176         </parameters>
17177       </method>
17178       <method name="replace_finish"
17179               c:identifier="g_file_replace_finish"
17180               throws="1">
17181         <doc xml:whitespace="preserve">Finishes an asynchronous file replace operation started with
17182 g_file_replace_async().
17183 Free the returned object with g_object_unref().</doc>
17184         <return-value transfer-ownership="full">
17185           <doc xml:whitespace="preserve">a #GFileOutputStream, or %NULL on error.</doc>
17186           <type name="FileOutputStream" c:type="GFileOutputStream*"/>
17187         </return-value>
17188         <parameters>
17189           <parameter name="res" transfer-ownership="none">
17190             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
17191             <type name="AsyncResult" c:type="GAsyncResult*"/>
17192           </parameter>
17193         </parameters>
17194       </method>
17195       <method name="replace_readwrite"
17196               c:identifier="g_file_replace_readwrite"
17197               version="2.22"
17198               throws="1">
17199         <doc xml:whitespace="preserve">Returns an output stream for overwriting the file in readwrite mode,
17200 possibly creating a backup copy of the file first. If the file doesn't
17201 exist, it will be created.
17202 For details about the behaviour, see g_file_replace() which does the same
17203 thing but returns an output stream only.
17204 Note that in many non-local file cases read and write streams are not
17205 supported, so make sure you really need to do read and write streaming,
17206 rather than just opening for reading or writing.
17207 Free the returned object with g_object_unref().</doc>
17208         <return-value transfer-ownership="full">
17209           <doc xml:whitespace="preserve">a #GFileIOStream or %NULL on error.</doc>
17210           <type name="FileIOStream" c:type="GFileIOStream*"/>
17211         </return-value>
17212         <parameters>
17213           <parameter name="etag" transfer-ownership="none" allow-none="1">
17214             <doc xml:whitespace="preserve">an optional &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for the current #GFile, or #NULL to ignore</doc>
17215             <type name="utf8" c:type="char*"/>
17216           </parameter>
17217           <parameter name="make_backup" transfer-ownership="none">
17218             <doc xml:whitespace="preserve">%TRUE if a backup should be created</doc>
17219             <type name="gboolean" c:type="gboolean"/>
17220           </parameter>
17221           <parameter name="flags" transfer-ownership="none">
17222             <doc xml:whitespace="preserve">a set of #GFileCreateFlags</doc>
17223             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
17224           </parameter>
17225           <parameter name="cancellable"
17226                      transfer-ownership="none"
17227                      allow-none="1">
17228             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
17229             <type name="Cancellable" c:type="GCancellable*"/>
17230           </parameter>
17231         </parameters>
17232       </method>
17233       <method name="replace_readwrite_async"
17234               c:identifier="g_file_replace_readwrite_async"
17235               version="2.22">
17236         <doc xml:whitespace="preserve">Asynchronously overwrites the file in read-write mode, replacing the
17237 contents, possibly creating a backup copy of the file first.
17238 For more details, see g_file_replace_readwrite() which is
17239 the synchronous version of this call.
17240 When the operation is finished, @callback will be called. You can then
17241 call g_file_replace_readwrite_finish() to get the result of the operation.</doc>
17242         <return-value transfer-ownership="none">
17243           <type name="none" c:type="void"/>
17244         </return-value>
17245         <parameters>
17246           <parameter name="etag" transfer-ownership="none" allow-none="1">
17247             <doc xml:whitespace="preserve">an &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for the current #GFile, or NULL to ignore.</doc>
17248             <type name="utf8" c:type="char*"/>
17249           </parameter>
17250           <parameter name="make_backup" transfer-ownership="none">
17251             <doc xml:whitespace="preserve">%TRUE if a backup should be created.</doc>
17252             <type name="gboolean" c:type="gboolean"/>
17253           </parameter>
17254           <parameter name="flags" transfer-ownership="none">
17255             <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
17256             <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
17257           </parameter>
17258           <parameter name="io_priority" transfer-ownership="none">
17259             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
17260             <type name="gint" c:type="int"/>
17261           </parameter>
17262           <parameter name="cancellable"
17263                      transfer-ownership="none"
17264                      allow-none="1">
17265             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17266             <type name="Cancellable" c:type="GCancellable*"/>
17267           </parameter>
17268           <parameter name="callback"
17269                      transfer-ownership="none"
17270                      scope="async"
17271                      closure="6">
17272             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
17273             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
17274           </parameter>
17275           <parameter name="user_data" transfer-ownership="none">
17276             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
17277             <type name="gpointer" c:type="gpointer"/>
17278           </parameter>
17279         </parameters>
17280       </method>
17281       <method name="replace_readwrite_finish"
17282               c:identifier="g_file_replace_readwrite_finish"
17283               version="2.22"
17284               throws="1">
17285         <doc xml:whitespace="preserve">Finishes an asynchronous file replace operation started with
17286 g_file_replace_readwrite_async().
17287 Free the returned object with g_object_unref().</doc>
17288         <return-value transfer-ownership="full">
17289           <doc xml:whitespace="preserve">a #GFileIOStream, or %NULL on error.</doc>
17290           <type name="FileIOStream" c:type="GFileIOStream*"/>
17291         </return-value>
17292         <parameters>
17293           <parameter name="res" transfer-ownership="none">
17294             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
17295             <type name="AsyncResult" c:type="GAsyncResult*"/>
17296           </parameter>
17297         </parameters>
17298       </method>
17299       <method name="resolve_relative_path"
17300               c:identifier="g_file_resolve_relative_path">
17301         <doc xml:whitespace="preserve">Resolves a relative path for @file to an absolute path.
17302 This call does no blocking i/o.
17303 is %NULL or if @file is invalid.
17304 Free the returned object with g_object_unref().</doc>
17305         <return-value transfer-ownership="full">
17306           <doc xml:whitespace="preserve">#GFile to the resolved path. %NULL if @relative_path</doc>
17307           <type name="File" c:type="GFile*"/>
17308         </return-value>
17309         <parameters>
17310           <parameter name="relative_path" transfer-ownership="none">
17311             <doc xml:whitespace="preserve">a given relative path string.</doc>
17312             <type name="utf8" c:type="char*"/>
17313           </parameter>
17314         </parameters>
17315       </method>
17316       <method name="set_attribute"
17317               c:identifier="g_file_set_attribute"
17318               throws="1">
17319         <doc xml:whitespace="preserve">Sets an attribute in the file with attribute name @attribute to @value.
17320 If @cancellable is not %NULL, then the operation can be cancelled by
17321 triggering the cancellable object from another thread. If the operation
17322 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
17323         <return-value transfer-ownership="none">
17324           <doc xml:whitespace="preserve">%TRUE if the attribute was set, %FALSE otherwise.</doc>
17325           <type name="gboolean" c:type="gboolean"/>
17326         </return-value>
17327         <parameters>
17328           <parameter name="attribute" transfer-ownership="none">
17329             <doc xml:whitespace="preserve">a string containing the attribute's name.</doc>
17330             <type name="utf8" c:type="char*"/>
17331           </parameter>
17332           <parameter name="type" transfer-ownership="none">
17333             <doc xml:whitespace="preserve">The type of the attribute</doc>
17334             <type name="FileAttributeType" c:type="GFileAttributeType"/>
17335           </parameter>
17336           <parameter name="value_p" transfer-ownership="none">
17337             <doc xml:whitespace="preserve">a pointer to the value (or the pointer itself if the type is a pointer type)</doc>
17338             <type name="gpointer" c:type="gpointer"/>
17339           </parameter>
17340           <parameter name="flags" transfer-ownership="none">
17341             <doc xml:whitespace="preserve">a set of #GFileQueryInfoFlags.</doc>
17342             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
17343           </parameter>
17344           <parameter name="cancellable"
17345                      transfer-ownership="none"
17346                      allow-none="1">
17347             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17348             <type name="Cancellable" c:type="GCancellable*"/>
17349           </parameter>
17350         </parameters>
17351       </method>
17352       <method name="set_attribute_byte_string"
17353               c:identifier="g_file_set_attribute_byte_string"
17354               throws="1">
17355         <doc xml:whitespace="preserve">Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING to @value.
17356 If @attribute is of a different type, this operation will fail,
17357 returning %FALSE.
17358 If @cancellable is not %NULL, then the operation can be cancelled by
17359 triggering the cancellable object from another thread. If the operation
17360 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
17361 in the @file, %FALSE otherwise.</doc>
17362         <return-value transfer-ownership="none">
17363           <doc xml:whitespace="preserve">%TRUE if the @attribute was successfully set to @value</doc>
17364           <type name="gboolean" c:type="gboolean"/>
17365         </return-value>
17366         <parameters>
17367           <parameter name="attribute" transfer-ownership="none">
17368             <doc xml:whitespace="preserve">a string containing the attribute's name.</doc>
17369             <type name="utf8" c:type="char*"/>
17370           </parameter>
17371           <parameter name="value" transfer-ownership="none">
17372             <doc xml:whitespace="preserve">a string containing the attribute's new value.</doc>
17373             <type name="utf8" c:type="char*"/>
17374           </parameter>
17375           <parameter name="flags" transfer-ownership="none">
17376             <doc xml:whitespace="preserve">a #GFileQueryInfoFlags.</doc>
17377             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
17378           </parameter>
17379           <parameter name="cancellable"
17380                      transfer-ownership="none"
17381                      allow-none="1">
17382             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17383             <type name="Cancellable" c:type="GCancellable*"/>
17384           </parameter>
17385         </parameters>
17386       </method>
17387       <method name="set_attribute_int32"
17388               c:identifier="g_file_set_attribute_int32"
17389               throws="1">
17390         <doc xml:whitespace="preserve">Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT32 to @value.
17391 If @attribute is of a different type, this operation will fail.
17392 If @cancellable is not %NULL, then the operation can be cancelled by
17393 triggering the cancellable object from another thread. If the operation
17394 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
17395 in the @file, %FALSE otherwise.</doc>
17396         <return-value transfer-ownership="none">
17397           <doc xml:whitespace="preserve">%TRUE if the @attribute was successfully set to @value</doc>
17398           <type name="gboolean" c:type="gboolean"/>
17399         </return-value>
17400         <parameters>
17401           <parameter name="attribute" transfer-ownership="none">
17402             <doc xml:whitespace="preserve">a string containing the attribute's name.</doc>
17403             <type name="utf8" c:type="char*"/>
17404           </parameter>
17405           <parameter name="value" transfer-ownership="none">
17406             <doc xml:whitespace="preserve">a #gint32 containing the attribute's new value.</doc>
17407             <type name="gint32" c:type="gint32"/>
17408           </parameter>
17409           <parameter name="flags" transfer-ownership="none">
17410             <doc xml:whitespace="preserve">a #GFileQueryInfoFlags.</doc>
17411             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
17412           </parameter>
17413           <parameter name="cancellable"
17414                      transfer-ownership="none"
17415                      allow-none="1">
17416             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17417             <type name="Cancellable" c:type="GCancellable*"/>
17418           </parameter>
17419         </parameters>
17420       </method>
17421       <method name="set_attribute_int64"
17422               c:identifier="g_file_set_attribute_int64"
17423               throws="1">
17424         <doc xml:whitespace="preserve">Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT64 to @value.
17425 If @attribute is of a different type, this operation will fail.
17426 If @cancellable is not %NULL, then the operation can be cancelled by
17427 triggering the cancellable object from another thread. If the operation
17428 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
17429         <return-value transfer-ownership="none">
17430           <doc xml:whitespace="preserve">%TRUE if the @attribute was successfully set, %FALSE otherwise.</doc>
17431           <type name="gboolean" c:type="gboolean"/>
17432         </return-value>
17433         <parameters>
17434           <parameter name="attribute" transfer-ownership="none">
17435             <doc xml:whitespace="preserve">a string containing the attribute's name.</doc>
17436             <type name="utf8" c:type="char*"/>
17437           </parameter>
17438           <parameter name="value" transfer-ownership="none">
17439             <doc xml:whitespace="preserve">a #guint64 containing the attribute's new value.</doc>
17440             <type name="gint64" c:type="gint64"/>
17441           </parameter>
17442           <parameter name="flags" transfer-ownership="none">
17443             <doc xml:whitespace="preserve">a #GFileQueryInfoFlags.</doc>
17444             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
17445           </parameter>
17446           <parameter name="cancellable"
17447                      transfer-ownership="none"
17448                      allow-none="1">
17449             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17450             <type name="Cancellable" c:type="GCancellable*"/>
17451           </parameter>
17452         </parameters>
17453       </method>
17454       <method name="set_attribute_string"
17455               c:identifier="g_file_set_attribute_string"
17456               throws="1">
17457         <doc xml:whitespace="preserve">Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_STRING to @value.
17458 If @attribute is of a different type, this operation will fail.
17459 If @cancellable is not %NULL, then the operation can be cancelled by
17460 triggering the cancellable object from another thread. If the operation
17461 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
17462         <return-value transfer-ownership="none">
17463           <doc xml:whitespace="preserve">%TRUE if the @attribute was successfully set, %FALSE otherwise.</doc>
17464           <type name="gboolean" c:type="gboolean"/>
17465         </return-value>
17466         <parameters>
17467           <parameter name="attribute" transfer-ownership="none">
17468             <doc xml:whitespace="preserve">a string containing the attribute's name.</doc>
17469             <type name="utf8" c:type="char*"/>
17470           </parameter>
17471           <parameter name="value" transfer-ownership="none">
17472             <doc xml:whitespace="preserve">a string containing the attribute's value.</doc>
17473             <type name="utf8" c:type="char*"/>
17474           </parameter>
17475           <parameter name="flags" transfer-ownership="none">
17476             <doc xml:whitespace="preserve">#GFileQueryInfoFlags.</doc>
17477             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
17478           </parameter>
17479           <parameter name="cancellable"
17480                      transfer-ownership="none"
17481                      allow-none="1">
17482             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17483             <type name="Cancellable" c:type="GCancellable*"/>
17484           </parameter>
17485         </parameters>
17486       </method>
17487       <method name="set_attribute_uint32"
17488               c:identifier="g_file_set_attribute_uint32"
17489               throws="1">
17490         <doc xml:whitespace="preserve">Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_UINT32 to @value.
17491 If @attribute is of a different type, this operation will fail.
17492 If @cancellable is not %NULL, then the operation can be cancelled by
17493 triggering the cancellable object from another thread. If the operation
17494 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
17495 in the @file, %FALSE otherwise.</doc>
17496         <return-value transfer-ownership="none">
17497           <doc xml:whitespace="preserve">%TRUE if the @attribute was successfully set to @value</doc>
17498           <type name="gboolean" c:type="gboolean"/>
17499         </return-value>
17500         <parameters>
17501           <parameter name="attribute" transfer-ownership="none">
17502             <doc xml:whitespace="preserve">a string containing the attribute's name.</doc>
17503             <type name="utf8" c:type="char*"/>
17504           </parameter>
17505           <parameter name="value" transfer-ownership="none">
17506             <doc xml:whitespace="preserve">a #guint32 containing the attribute's new value.</doc>
17507             <type name="guint32" c:type="guint32"/>
17508           </parameter>
17509           <parameter name="flags" transfer-ownership="none">
17510             <doc xml:whitespace="preserve">a #GFileQueryInfoFlags.</doc>
17511             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
17512           </parameter>
17513           <parameter name="cancellable"
17514                      transfer-ownership="none"
17515                      allow-none="1">
17516             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17517             <type name="Cancellable" c:type="GCancellable*"/>
17518           </parameter>
17519         </parameters>
17520       </method>
17521       <method name="set_attribute_uint64"
17522               c:identifier="g_file_set_attribute_uint64"
17523               throws="1">
17524         <doc xml:whitespace="preserve">Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_UINT64 to @value.
17525 If @attribute is of a different type, this operation will fail.
17526 If @cancellable is not %NULL, then the operation can be cancelled by
17527 triggering the cancellable object from another thread. If the operation
17528 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
17529 in the @file, %FALSE otherwise.</doc>
17530         <return-value transfer-ownership="none">
17531           <doc xml:whitespace="preserve">%TRUE if the @attribute was successfully set to @value</doc>
17532           <type name="gboolean" c:type="gboolean"/>
17533         </return-value>
17534         <parameters>
17535           <parameter name="attribute" transfer-ownership="none">
17536             <doc xml:whitespace="preserve">a string containing the attribute's name.</doc>
17537             <type name="utf8" c:type="char*"/>
17538           </parameter>
17539           <parameter name="value" transfer-ownership="none">
17540             <doc xml:whitespace="preserve">a #guint64 containing the attribute's new value.</doc>
17541             <type name="guint64" c:type="guint64"/>
17542           </parameter>
17543           <parameter name="flags" transfer-ownership="none">
17544             <doc xml:whitespace="preserve">a #GFileQueryInfoFlags.</doc>
17545             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
17546           </parameter>
17547           <parameter name="cancellable"
17548                      transfer-ownership="none"
17549                      allow-none="1">
17550             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17551             <type name="Cancellable" c:type="GCancellable*"/>
17552           </parameter>
17553         </parameters>
17554       </method>
17555       <method name="set_attributes_async"
17556               c:identifier="g_file_set_attributes_async">
17557         <doc xml:whitespace="preserve">Asynchronously sets the attributes of @file with @info.
17558 For more details, see g_file_set_attributes_from_info() which is
17559 the synchronous version of this call.
17560 When the operation is finished, @callback will be called. You can then call
17561 g_file_set_attributes_finish() to get the result of the operation.</doc>
17562         <return-value transfer-ownership="none">
17563           <type name="none" c:type="void"/>
17564         </return-value>
17565         <parameters>
17566           <parameter name="info" transfer-ownership="none">
17567             <doc xml:whitespace="preserve">a #GFileInfo.</doc>
17568             <type name="FileInfo" c:type="GFileInfo*"/>
17569           </parameter>
17570           <parameter name="flags" transfer-ownership="none">
17571             <doc xml:whitespace="preserve">a #GFileQueryInfoFlags.</doc>
17572             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
17573           </parameter>
17574           <parameter name="io_priority" transfer-ownership="none">
17575             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
17576             <type name="gint" c:type="int"/>
17577           </parameter>
17578           <parameter name="cancellable"
17579                      transfer-ownership="none"
17580                      allow-none="1">
17581             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17582             <type name="Cancellable" c:type="GCancellable*"/>
17583           </parameter>
17584           <parameter name="callback"
17585                      transfer-ownership="none"
17586                      scope="async"
17587                      closure="5">
17588             <doc xml:whitespace="preserve">a #GAsyncReadyCallback.</doc>
17589             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
17590           </parameter>
17591           <parameter name="user_data" transfer-ownership="none">
17592             <doc xml:whitespace="preserve">a #gpointer.</doc>
17593             <type name="gpointer" c:type="gpointer"/>
17594           </parameter>
17595         </parameters>
17596       </method>
17597       <method name="set_attributes_finish"
17598               c:identifier="g_file_set_attributes_finish"
17599               throws="1">
17600         <doc xml:whitespace="preserve">Finishes setting an attribute started in g_file_set_attributes_async().</doc>
17601         <return-value transfer-ownership="none">
17602           <doc xml:whitespace="preserve">%TRUE if the attributes were set correctly, %FALSE otherwise.</doc>
17603           <type name="gboolean" c:type="gboolean"/>
17604         </return-value>
17605         <parameters>
17606           <parameter name="result" transfer-ownership="none">
17607             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
17608             <type name="AsyncResult" c:type="GAsyncResult*"/>
17609           </parameter>
17610           <parameter name="info"
17611                      direction="out"
17612                      caller-allocates="0"
17613                      transfer-ownership="full">
17614             <doc xml:whitespace="preserve">a #GFileInfo.</doc>
17615             <type name="FileInfo" c:type="GFileInfo**"/>
17616           </parameter>
17617         </parameters>
17618       </method>
17619       <method name="set_attributes_from_info"
17620               c:identifier="g_file_set_attributes_from_info"
17621               throws="1">
17622         <doc xml:whitespace="preserve">Tries to set all attributes in the #GFileInfo on the target values,
17623 not stopping on the first error.
17624 If there is any error during this operation then @error will be set to
17625 the first error. Error on particular fields are flagged by setting
17626 the "status" field in the attribute value to
17627 %G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can also detect
17628 further errors.
17629 If @cancellable is not %NULL, then the operation can be cancelled by
17630 triggering the cancellable object from another thread. If the operation
17631 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
17632         <return-value transfer-ownership="none">
17633           <doc xml:whitespace="preserve">%TRUE if there was any error, %FALSE otherwise.</doc>
17634           <type name="gboolean" c:type="gboolean"/>
17635         </return-value>
17636         <parameters>
17637           <parameter name="info" transfer-ownership="none">
17638             <doc xml:whitespace="preserve">a #GFileInfo.</doc>
17639             <type name="FileInfo" c:type="GFileInfo*"/>
17640           </parameter>
17641           <parameter name="flags" transfer-ownership="none">
17642             <doc xml:whitespace="preserve">#GFileQueryInfoFlags</doc>
17643             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
17644           </parameter>
17645           <parameter name="cancellable"
17646                      transfer-ownership="none"
17647                      allow-none="1">
17648             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17649             <type name="Cancellable" c:type="GCancellable*"/>
17650           </parameter>
17651         </parameters>
17652       </method>
17653       <method name="set_display_name"
17654               c:identifier="g_file_set_display_name"
17655               throws="1">
17656         <doc xml:whitespace="preserve">Renames @file to the specified display name.
17657 The display name is converted from UTF8 to the correct encoding for the target
17658 filesystem if possible and the @file is renamed to this.
17659 If you want to implement a rename operation in the user interface the edit name
17660 (#G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME) should be used as the initial value in the rename
17661 widget, and then the result after editing should be passed to g_file_set_display_name().
17662 On success the resulting converted filename is returned.
17663 If @cancellable is not %NULL, then the operation can be cancelled by
17664 triggering the cancellable object from another thread. If the operation
17665 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
17666 if there was an error.
17667 Free the returned object with g_object_unref().</doc>
17668         <return-value transfer-ownership="full">
17669           <doc xml:whitespace="preserve">a #GFile specifying what @file was renamed to, or %NULL</doc>
17670           <type name="File" c:type="GFile*"/>
17671         </return-value>
17672         <parameters>
17673           <parameter name="display_name" transfer-ownership="none">
17674             <doc xml:whitespace="preserve">a string.</doc>
17675             <type name="utf8" c:type="char*"/>
17676           </parameter>
17677           <parameter name="cancellable"
17678                      transfer-ownership="none"
17679                      allow-none="1">
17680             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17681             <type name="Cancellable" c:type="GCancellable*"/>
17682           </parameter>
17683         </parameters>
17684       </method>
17685       <method name="set_display_name_async"
17686               c:identifier="g_file_set_display_name_async">
17687         <doc xml:whitespace="preserve">Asynchronously sets the display name for a given #GFile.
17688 For more details, see g_file_set_display_name() which is
17689 the synchronous version of this call.
17690 When the operation is finished, @callback will be called. You can then call
17691 g_file_set_display_name_finish() to get the result of the operation.</doc>
17692         <return-value transfer-ownership="none">
17693           <type name="none" c:type="void"/>
17694         </return-value>
17695         <parameters>
17696           <parameter name="display_name" transfer-ownership="none">
17697             <doc xml:whitespace="preserve">a string.</doc>
17698             <type name="utf8" c:type="char*"/>
17699           </parameter>
17700           <parameter name="io_priority" transfer-ownership="none">
17701             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
17702             <type name="gint" c:type="int"/>
17703           </parameter>
17704           <parameter name="cancellable"
17705                      transfer-ownership="none"
17706                      allow-none="1">
17707             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17708             <type name="Cancellable" c:type="GCancellable*"/>
17709           </parameter>
17710           <parameter name="callback"
17711                      transfer-ownership="none"
17712                      scope="async"
17713                      closure="4">
17714             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
17715             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
17716           </parameter>
17717           <parameter name="user_data" transfer-ownership="none">
17718             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
17719             <type name="gpointer" c:type="gpointer"/>
17720           </parameter>
17721         </parameters>
17722       </method>
17723       <method name="set_display_name_finish"
17724               c:identifier="g_file_set_display_name_finish"
17725               throws="1">
17726         <doc xml:whitespace="preserve">Finishes setting a display name started with
17727 g_file_set_display_name_async().
17728 Free the returned object with g_object_unref().</doc>
17729         <return-value transfer-ownership="full">
17730           <doc xml:whitespace="preserve">a #GFile or %NULL on error.</doc>
17731           <type name="File" c:type="GFile*"/>
17732         </return-value>
17733         <parameters>
17734           <parameter name="res" transfer-ownership="none">
17735             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
17736             <type name="AsyncResult" c:type="GAsyncResult*"/>
17737           </parameter>
17738         </parameters>
17739       </method>
17740       <method name="start_mountable"
17741               c:identifier="g_file_start_mountable"
17742               version="2.22">
17743         <doc xml:whitespace="preserve">Starts a file of type G_FILE_TYPE_MOUNTABLE.
17744 Using @start_operation, you can request callbacks when, for instance,
17745 passwords are needed during authentication.
17746 If @cancellable is not %NULL, then the operation can be cancelled by
17747 triggering the cancellable object from another thread. If the operation
17748 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
17749 When the operation is finished, @callback will be called. You can then call
17750 g_file_mount_mountable_finish() to get the result of the operation.</doc>
17751         <return-value transfer-ownership="none">
17752           <type name="none" c:type="void"/>
17753         </return-value>
17754         <parameters>
17755           <parameter name="flags" transfer-ownership="none">
17756             <doc xml:whitespace="preserve">flags affecting the operation</doc>
17757             <type name="DriveStartFlags" c:type="GDriveStartFlags"/>
17758           </parameter>
17759           <parameter name="start_operation" transfer-ownership="none">
17760             <doc xml:whitespace="preserve">a #GMountOperation, or %NULL to avoid user interaction.</doc>
17761             <type name="MountOperation" c:type="GMountOperation*"/>
17762           </parameter>
17763           <parameter name="cancellable"
17764                      transfer-ownership="none"
17765                      allow-none="1">
17766             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17767             <type name="Cancellable" c:type="GCancellable*"/>
17768           </parameter>
17769           <parameter name="callback"
17770                      transfer-ownership="none"
17771                      scope="async"
17772                      closure="4">
17773             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
17774             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
17775           </parameter>
17776           <parameter name="user_data" transfer-ownership="none">
17777             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
17778             <type name="gpointer" c:type="gpointer"/>
17779           </parameter>
17780         </parameters>
17781       </method>
17782       <method name="start_mountable_finish"
17783               c:identifier="g_file_start_mountable_finish"
17784               version="2.22"
17785               throws="1">
17786         <doc xml:whitespace="preserve">Finishes a start operation. See g_file_start_mountable() for details.
17787 Finish an asynchronous start operation that was started
17788 with g_file_start_mountable().
17789 otherwise.</doc>
17790         <return-value transfer-ownership="none">
17791           <doc xml:whitespace="preserve">%TRUE if the operation finished successfully. %FALSE</doc>
17792           <type name="gboolean" c:type="gboolean"/>
17793         </return-value>
17794         <parameters>
17795           <parameter name="result" transfer-ownership="none">
17796             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
17797             <type name="AsyncResult" c:type="GAsyncResult*"/>
17798           </parameter>
17799         </parameters>
17800       </method>
17801       <method name="stop_mountable"
17802               c:identifier="g_file_stop_mountable"
17803               version="2.22">
17804         <doc xml:whitespace="preserve">Stops a file of type G_FILE_TYPE_MOUNTABLE.
17805 If @cancellable is not %NULL, then the operation can be cancelled by
17806 triggering the cancellable object from another thread. If the operation
17807 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
17808 When the operation is finished, @callback will be called. You can then call
17809 g_file_stop_mountable_finish() to get the result of the operation.</doc>
17810         <return-value transfer-ownership="none">
17811           <type name="none" c:type="void"/>
17812         </return-value>
17813         <parameters>
17814           <parameter name="flags" transfer-ownership="none">
17815             <doc xml:whitespace="preserve">flags affecting the operation</doc>
17816             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
17817           </parameter>
17818           <parameter name="mount_operation" transfer-ownership="none">
17819             <doc xml:whitespace="preserve">a #GMountOperation, or %NULL to avoid user interaction.</doc>
17820             <type name="MountOperation" c:type="GMountOperation*"/>
17821           </parameter>
17822           <parameter name="cancellable"
17823                      transfer-ownership="none"
17824                      allow-none="1">
17825             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17826             <type name="Cancellable" c:type="GCancellable*"/>
17827           </parameter>
17828           <parameter name="callback"
17829                      transfer-ownership="none"
17830                      scope="async"
17831                      closure="4">
17832             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
17833             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
17834           </parameter>
17835           <parameter name="user_data" transfer-ownership="none">
17836             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
17837             <type name="gpointer" c:type="gpointer"/>
17838           </parameter>
17839         </parameters>
17840       </method>
17841       <method name="stop_mountable_finish"
17842               c:identifier="g_file_stop_mountable_finish"
17843               version="2.22"
17844               throws="1">
17845         <doc xml:whitespace="preserve">Finishes an stop operation, see g_file_stop_mountable() for details.
17846 Finish an asynchronous stop operation that was started
17847 with g_file_stop_mountable().
17848 otherwise.</doc>
17849         <return-value transfer-ownership="none">
17850           <doc xml:whitespace="preserve">%TRUE if the operation finished successfully. %FALSE</doc>
17851           <type name="gboolean" c:type="gboolean"/>
17852         </return-value>
17853         <parameters>
17854           <parameter name="result" transfer-ownership="none">
17855             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
17856             <type name="AsyncResult" c:type="GAsyncResult*"/>
17857           </parameter>
17858         </parameters>
17859       </method>
17860       <method name="supports_thread_contexts"
17861               c:identifier="g_file_supports_thread_contexts"
17862               version="2.22">
17863         <doc xml:whitespace="preserve">Checks if @file supports &lt;link
17864 linkend="g-main-context-push-thread-default-context"&gt;thread-default
17865 contexts&lt;/link&gt;. If this returns %FALSE, you cannot perform
17866 asynchronous operations on @file in a thread that has a
17867 thread-default context.</doc>
17868         <return-value transfer-ownership="none">
17869           <doc xml:whitespace="preserve">Whether or not @file supports thread-default contexts.</doc>
17870           <type name="gboolean" c:type="gboolean"/>
17871         </return-value>
17872       </method>
17873       <method name="trash" c:identifier="g_file_trash" throws="1">
17874         <doc xml:whitespace="preserve">Sends @file to the "Trashcan", if possible. This is similar to
17875 deleting it, but the user can recover it before emptying the trashcan.
17876 Not all file systems support trashing, so this call can return the
17877 %G_IO_ERROR_NOT_SUPPORTED error.
17878 If @cancellable is not %NULL, then the operation can be cancelled by
17879 triggering the cancellable object from another thread. If the operation
17880 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
17881         <return-value transfer-ownership="none">
17882           <doc xml:whitespace="preserve">%TRUE on successful trash, %FALSE otherwise.</doc>
17883           <type name="gboolean" c:type="gboolean"/>
17884         </return-value>
17885         <parameters>
17886           <parameter name="cancellable"
17887                      transfer-ownership="none"
17888                      allow-none="1">
17889             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17890             <type name="Cancellable" c:type="GCancellable*"/>
17891           </parameter>
17892         </parameters>
17893       </method>
17894       <method name="unmount_mountable"
17895               c:identifier="g_file_unmount_mountable"
17896               deprecated="Use g_file_unmount_mountable_with_operation() instead."
17897               deprecated-version="2.22">
17898         <doc xml:whitespace="preserve">Unmounts a file of type G_FILE_TYPE_MOUNTABLE.
17899 If @cancellable is not %NULL, then the operation can be cancelled by
17900 triggering the cancellable object from another thread. If the operation
17901 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
17902 When the operation is finished, @callback will be called. You can then call
17903 g_file_unmount_mountable_finish() to get the result of the operation.</doc>
17904         <return-value transfer-ownership="none">
17905           <type name="none" c:type="void"/>
17906         </return-value>
17907         <parameters>
17908           <parameter name="flags" transfer-ownership="none">
17909             <doc xml:whitespace="preserve">flags affecting the operation</doc>
17910             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
17911           </parameter>
17912           <parameter name="cancellable"
17913                      transfer-ownership="none"
17914                      allow-none="1">
17915             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17916             <type name="Cancellable" c:type="GCancellable*"/>
17917           </parameter>
17918           <parameter name="callback"
17919                      transfer-ownership="none"
17920                      scope="async"
17921                      closure="3">
17922             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
17923             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
17924           </parameter>
17925           <parameter name="user_data" transfer-ownership="none">
17926             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
17927             <type name="gpointer" c:type="gpointer"/>
17928           </parameter>
17929         </parameters>
17930       </method>
17931       <method name="unmount_mountable_finish"
17932               c:identifier="g_file_unmount_mountable_finish"
17933               deprecated="Use g_file_unmount_mountable_with_operation_finish() instead."
17934               deprecated-version="2.22"
17935               throws="1">
17936         <doc xml:whitespace="preserve">Finishes an unmount operation, see g_file_unmount_mountable() for details.
17937 Finish an asynchronous unmount operation that was started
17938 with g_file_unmount_mountable().
17939 otherwise.</doc>
17940         <return-value transfer-ownership="none">
17941           <doc xml:whitespace="preserve">%TRUE if the operation finished successfully. %FALSE</doc>
17942           <type name="gboolean" c:type="gboolean"/>
17943         </return-value>
17944         <parameters>
17945           <parameter name="result" transfer-ownership="none">
17946             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
17947             <type name="AsyncResult" c:type="GAsyncResult*"/>
17948           </parameter>
17949         </parameters>
17950       </method>
17951       <method name="unmount_mountable_with_operation"
17952               c:identifier="g_file_unmount_mountable_with_operation"
17953               version="2.22">
17954         <doc xml:whitespace="preserve">Unmounts a file of type G_FILE_TYPE_MOUNTABLE.
17955 If @cancellable is not %NULL, then the operation can be cancelled by
17956 triggering the cancellable object from another thread. If the operation
17957 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
17958 When the operation is finished, @callback will be called. You can then call
17959 g_file_unmount_mountable_finish() to get the result of the operation.</doc>
17960         <return-value transfer-ownership="none">
17961           <type name="none" c:type="void"/>
17962         </return-value>
17963         <parameters>
17964           <parameter name="flags" transfer-ownership="none">
17965             <doc xml:whitespace="preserve">flags affecting the operation</doc>
17966             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
17967           </parameter>
17968           <parameter name="mount_operation" transfer-ownership="none">
17969             <doc xml:whitespace="preserve">a #GMountOperation, or %NULL to avoid user interaction.</doc>
17970             <type name="MountOperation" c:type="GMountOperation*"/>
17971           </parameter>
17972           <parameter name="cancellable"
17973                      transfer-ownership="none"
17974                      allow-none="1">
17975             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
17976             <type name="Cancellable" c:type="GCancellable*"/>
17977           </parameter>
17978           <parameter name="callback"
17979                      transfer-ownership="none"
17980                      scope="async"
17981                      closure="4">
17982             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
17983             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
17984           </parameter>
17985           <parameter name="user_data" transfer-ownership="none">
17986             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
17987             <type name="gpointer" c:type="gpointer"/>
17988           </parameter>
17989         </parameters>
17990       </method>
17991       <method name="unmount_mountable_with_operation_finish"
17992               c:identifier="g_file_unmount_mountable_with_operation_finish"
17993               version="2.22"
17994               throws="1">
17995         <doc xml:whitespace="preserve">Finishes an unmount operation, see g_file_unmount_mountable_with_operation() for details.
17996 Finish an asynchronous unmount operation that was started
17997 with g_file_unmount_mountable_with_operation().
17998 otherwise.</doc>
17999         <return-value transfer-ownership="none">
18000           <doc xml:whitespace="preserve">%TRUE if the operation finished successfully. %FALSE</doc>
18001           <type name="gboolean" c:type="gboolean"/>
18002         </return-value>
18003         <parameters>
18004           <parameter name="result" transfer-ownership="none">
18005             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
18006             <type name="AsyncResult" c:type="GAsyncResult*"/>
18007           </parameter>
18008         </parameters>
18009       </method>
18010     </interface>
18011     <record name="FileAttributeInfo" c:type="GFileAttributeInfo">
18012       <doc xml:whitespace="preserve">Information about a specific attribute.</doc>
18013       <field name="name" writable="1">
18014         <type name="utf8" c:type="char*"/>
18015       </field>
18016       <field name="type" writable="1">
18017         <type name="FileAttributeType" c:type="GFileAttributeType"/>
18018       </field>
18019       <field name="flags" writable="1">
18020         <type name="FileAttributeInfoFlags" c:type="GFileAttributeInfoFlags"/>
18021       </field>
18022     </record>
18023     <bitfield name="FileAttributeInfoFlags"
18024               glib:type-name="GFileAttributeInfoFlags"
18025               glib:get-type="g_file_attribute_info_flags_get_type"
18026               c:type="GFileAttributeInfoFlags">
18027       <doc xml:whitespace="preserve">Flags specifying the behaviour of an attribute.</doc>
18028       <member name="none"
18029               value="0"
18030               c:identifier="G_FILE_ATTRIBUTE_INFO_NONE"
18031               glib:nick="none"/>
18032       <member name="copy_with_file"
18033               value="1"
18034               c:identifier="G_FILE_ATTRIBUTE_INFO_COPY_WITH_FILE"
18035               glib:nick="copy-with-file"/>
18036       <member name="copy_when_moved"
18037               value="2"
18038               c:identifier="G_FILE_ATTRIBUTE_INFO_COPY_WHEN_MOVED"
18039               glib:nick="copy-when-moved"/>
18040     </bitfield>
18041     <record name="FileAttributeInfoList"
18042             c:type="GFileAttributeInfoList"
18043             glib:type-name="GFileAttributeInfoList"
18044             glib:get-type="g_file_attribute_info_list_get_type"
18045             c:symbol-prefix="file_attribute_info_list">
18046       <doc xml:whitespace="preserve">Acts as a lightweight registry for possible valid file attributes.
18047 The registry stores Key-Value pair formats as #GFileAttributeInfo&lt;!-- --&gt;s.</doc>
18048       <field name="infos" writable="1">
18049         <type name="FileAttributeInfo" c:type="GFileAttributeInfo*"/>
18050       </field>
18051       <field name="n_infos" writable="1">
18052         <type name="gint" c:type="int"/>
18053       </field>
18054       <constructor name="new" c:identifier="g_file_attribute_info_list_new">
18055         <doc xml:whitespace="preserve">Creates a new file attribute info list.</doc>
18056         <return-value transfer-ownership="full">
18057           <doc xml:whitespace="preserve">a #GFileAttributeInfoList.</doc>
18058           <type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
18059         </return-value>
18060       </constructor>
18061       <method name="add" c:identifier="g_file_attribute_info_list_add">
18062         <doc xml:whitespace="preserve">Adds a new attribute with @name to the @list, setting
18063 its @type and @flags.</doc>
18064         <return-value transfer-ownership="none">
18065           <type name="none" c:type="void"/>
18066         </return-value>
18067         <parameters>
18068           <parameter name="name" transfer-ownership="none">
18069             <doc xml:whitespace="preserve">the name of the attribute to add.</doc>
18070             <type name="utf8" c:type="char*"/>
18071           </parameter>
18072           <parameter name="type" transfer-ownership="none">
18073             <doc xml:whitespace="preserve">the #GFileAttributeType for the attribute.</doc>
18074             <type name="FileAttributeType" c:type="GFileAttributeType"/>
18075           </parameter>
18076           <parameter name="flags" transfer-ownership="none">
18077             <doc xml:whitespace="preserve">#GFileAttributeInfoFlags for the attribute.</doc>
18078             <type name="FileAttributeInfoFlags"
18079                   c:type="GFileAttributeInfoFlags"/>
18080           </parameter>
18081         </parameters>
18082       </method>
18083       <method name="dup" c:identifier="g_file_attribute_info_list_dup">
18084         <doc xml:whitespace="preserve">Makes a duplicate of a file attribute info list.</doc>
18085         <return-value transfer-ownership="full">
18086           <doc xml:whitespace="preserve">a copy of the given @list.</doc>
18087           <type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
18088         </return-value>
18089       </method>
18090       <method name="lookup" c:identifier="g_file_attribute_info_list_lookup">
18091         <doc xml:whitespace="preserve">Gets the file attribute with the name @name from @list.
18092 attribute isn't found.</doc>
18093         <return-value transfer-ownership="none">
18094           <doc xml:whitespace="preserve">a #GFileAttributeInfo for the @name, or %NULL if an</doc>
18095           <type name="FileAttributeInfo" c:type="GFileAttributeInfo*"/>
18096         </return-value>
18097         <parameters>
18098           <parameter name="name" transfer-ownership="none">
18099             <doc xml:whitespace="preserve">the name of the attribute to lookup.</doc>
18100             <type name="utf8" c:type="char*"/>
18101           </parameter>
18102         </parameters>
18103       </method>
18104       <method name="ref" c:identifier="g_file_attribute_info_list_ref">
18105         <doc xml:whitespace="preserve">References a file attribute info list.</doc>
18106         <return-value transfer-ownership="full">
18107           <doc xml:whitespace="preserve">#GFileAttributeInfoList or %NULL on error.</doc>
18108           <type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
18109         </return-value>
18110       </method>
18111       <method name="unref" c:identifier="g_file_attribute_info_list_unref">
18112         <doc xml:whitespace="preserve">Removes a reference from the given @list. If the reference count
18113 falls to zero, the @list is deleted.</doc>
18114         <return-value transfer-ownership="none">
18115           <type name="none" c:type="void"/>
18116         </return-value>
18117       </method>
18118     </record>
18119     <record name="FileAttributeMatcher"
18120             c:type="GFileAttributeMatcher"
18121             glib:type-name="GFileAttributeMatcher"
18122             glib:get-type="g_file_attribute_matcher_get_type"
18123             c:symbol-prefix="file_attribute_matcher">
18124       <doc xml:whitespace="preserve">Determines if a string matches a file attribute.</doc>
18125       <constructor name="new" c:identifier="g_file_attribute_matcher_new">
18126         <doc xml:whitespace="preserve">Creates a new file attribute matcher, which matches attributes
18127 against a given string. #GFileAttributeMatcher&lt;!-- --&gt;s are reference
18128 counted structures, and are created with a reference count of 1. If
18129 the number of references falls to 0, the #GFileAttributeMatcher is
18130 automatically destroyed.
18131 The @attribute string should be formatted with specific keys separated
18132 from namespaces with a double colon. Several "namespace::key" strings may be
18133 concatenated with a single comma (e.g. "standard::type,standard::is-hidden").
18134 The wildcard "*" may be used to match all keys and namespaces, or
18135 "namespace::*" will match all keys in a given namespace.
18136 Examples of strings to use:
18137 &lt;table&gt;
18138 &lt;title&gt;File Attribute Matcher strings and results&lt;/title&gt;
18139 &lt;tgroup cols='2' align='left'&gt;&lt;thead&gt;
18140 &lt;row&gt;&lt;entry&gt; Matcher String &lt;/entry&gt;&lt;entry&gt; Matches &lt;/entry&gt;&lt;/row&gt;&lt;/thead&gt;
18141 &lt;tbody&gt;
18142 &lt;row&gt;&lt;entry&gt;"*"&lt;/entry&gt;&lt;entry&gt;matches all attributes.&lt;/entry&gt;&lt;/row&gt;
18143 &lt;row&gt;&lt;entry&gt;"standard::is-hidden"&lt;/entry&gt;&lt;entry&gt;matches only the key is-hidden in the standard namespace.&lt;/entry&gt;&lt;/row&gt;
18144 &lt;row&gt;&lt;entry&gt;"standard::type,unix::*"&lt;/entry&gt;&lt;entry&gt;matches the type key in the standard namespace and
18145 all keys in the unix namespace.&lt;/entry&gt;&lt;/row&gt;
18146 &lt;/tbody&gt;&lt;/tgroup&gt;
18147 &lt;/table&gt;</doc>
18148         <return-value transfer-ownership="full">
18149           <doc xml:whitespace="preserve">a #GFileAttributeMatcher.</doc>
18150           <type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
18151         </return-value>
18152         <parameters>
18153           <parameter name="attributes" transfer-ownership="none">
18154             <doc xml:whitespace="preserve">an attribute string to match.</doc>
18155             <type name="utf8" c:type="char*"/>
18156           </parameter>
18157         </parameters>
18158       </constructor>
18159       <method name="enumerate_namespace"
18160               c:identifier="g_file_attribute_matcher_enumerate_namespace">
18161         <doc xml:whitespace="preserve">Checks if the matcher will match all of the keys in a given namespace.
18162 This will always return %TRUE if a wildcard character is in use (e.g. if
18163 matcher was created with "standard::*" and @ns is "standard", or if matcher was created
18164 using "*" and namespace is anything.)
18165 in the given @ns, %FALSE otherwise.</doc>
18166         <return-value transfer-ownership="none">
18167           <doc xml:whitespace="preserve">%TRUE if the matcher matches all of the entries</doc>
18168           <type name="gboolean" c:type="gboolean"/>
18169         </return-value>
18170         <parameters>
18171           <parameter name="ns" transfer-ownership="none">
18172             <doc xml:whitespace="preserve">a string containing a file attribute namespace.</doc>
18173             <type name="utf8" c:type="char*"/>
18174           </parameter>
18175         </parameters>
18176       </method>
18177       <method name="enumerate_next"
18178               c:identifier="g_file_attribute_matcher_enumerate_next">
18179         <doc xml:whitespace="preserve">Gets the next matched attribute from a #GFileAttributeMatcher.
18180 no more attribute exist.</doc>
18181         <return-value transfer-ownership="none">
18182           <doc xml:whitespace="preserve">a string containing the next attribute or %NULL if</doc>
18183           <type name="utf8" c:type="char*"/>
18184         </return-value>
18185       </method>
18186       <method name="matches" c:identifier="g_file_attribute_matcher_matches">
18187         <doc xml:whitespace="preserve">Checks if an attribute will be matched by an attribute matcher. If
18188 the matcher was created with the "*" matching string, this function
18189 will always return %TRUE.</doc>
18190         <return-value transfer-ownership="none">
18191           <doc xml:whitespace="preserve">%TRUE if @attribute matches @matcher. %FALSE otherwise.</doc>
18192           <type name="gboolean" c:type="gboolean"/>
18193         </return-value>
18194         <parameters>
18195           <parameter name="attribute" transfer-ownership="none">
18196             <doc xml:whitespace="preserve">a file attribute key.</doc>
18197             <type name="utf8" c:type="char*"/>
18198           </parameter>
18199         </parameters>
18200       </method>
18201       <method name="matches_only"
18202               c:identifier="g_file_attribute_matcher_matches_only">
18203         <doc xml:whitespace="preserve">Checks if a attribute matcher only matches a given attribute. Always
18204 returns %FALSE if "*" was used when creating the matcher.</doc>
18205         <return-value transfer-ownership="none">
18206           <doc xml:whitespace="preserve">%TRUE if the matcher only matches @attribute. %FALSE otherwise.</doc>
18207           <type name="gboolean" c:type="gboolean"/>
18208         </return-value>
18209         <parameters>
18210           <parameter name="attribute" transfer-ownership="none">
18211             <doc xml:whitespace="preserve">a file attribute key.</doc>
18212             <type name="utf8" c:type="char*"/>
18213           </parameter>
18214         </parameters>
18215       </method>
18216       <method name="ref" c:identifier="g_file_attribute_matcher_ref">
18217         <doc xml:whitespace="preserve">References a file attribute matcher.</doc>
18218         <return-value transfer-ownership="full">
18219           <doc xml:whitespace="preserve">a #GFileAttributeMatcher.</doc>
18220           <type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
18221         </return-value>
18222       </method>
18223       <method name="unref" c:identifier="g_file_attribute_matcher_unref">
18224         <doc xml:whitespace="preserve">Unreferences @matcher. If the reference count falls below 1,
18225 the @matcher is automatically freed.</doc>
18226         <return-value transfer-ownership="none">
18227           <type name="none" c:type="void"/>
18228         </return-value>
18229       </method>
18230     </record>
18231     <enumeration name="FileAttributeStatus"
18232                  glib:type-name="GFileAttributeStatus"
18233                  glib:get-type="g_file_attribute_status_get_type"
18234                  c:type="GFileAttributeStatus">
18235       <doc xml:whitespace="preserve">Used by g_file_set_attributes_from_info() when setting file attributes.</doc>
18236       <member name="unset"
18237               value="0"
18238               c:identifier="G_FILE_ATTRIBUTE_STATUS_UNSET"
18239               glib:nick="unset"/>
18240       <member name="set"
18241               value="1"
18242               c:identifier="G_FILE_ATTRIBUTE_STATUS_SET"
18243               glib:nick="set"/>
18244       <member name="error_setting"
18245               value="2"
18246               c:identifier="G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING"
18247               glib:nick="error-setting"/>
18248     </enumeration>
18249     <enumeration name="FileAttributeType"
18250                  glib:type-name="GFileAttributeType"
18251                  glib:get-type="g_file_attribute_type_get_type"
18252                  c:type="GFileAttributeType">
18253       <doc xml:whitespace="preserve">The data types for file attributes.</doc>
18254       <member name="invalid"
18255               value="0"
18256               c:identifier="G_FILE_ATTRIBUTE_TYPE_INVALID"
18257               glib:nick="invalid"/>
18258       <member name="string"
18259               value="1"
18260               c:identifier="G_FILE_ATTRIBUTE_TYPE_STRING"
18261               glib:nick="string"/>
18262       <member name="byte_string"
18263               value="2"
18264               c:identifier="G_FILE_ATTRIBUTE_TYPE_BYTE_STRING"
18265               glib:nick="byte-string"/>
18266       <member name="boolean"
18267               value="3"
18268               c:identifier="G_FILE_ATTRIBUTE_TYPE_BOOLEAN"
18269               glib:nick="boolean"/>
18270       <member name="uint32"
18271               value="4"
18272               c:identifier="G_FILE_ATTRIBUTE_TYPE_UINT32"
18273               glib:nick="uint32"/>
18274       <member name="int32"
18275               value="5"
18276               c:identifier="G_FILE_ATTRIBUTE_TYPE_INT32"
18277               glib:nick="int32"/>
18278       <member name="uint64"
18279               value="6"
18280               c:identifier="G_FILE_ATTRIBUTE_TYPE_UINT64"
18281               glib:nick="uint64"/>
18282       <member name="int64"
18283               value="7"
18284               c:identifier="G_FILE_ATTRIBUTE_TYPE_INT64"
18285               glib:nick="int64"/>
18286       <member name="object"
18287               value="8"
18288               c:identifier="G_FILE_ATTRIBUTE_TYPE_OBJECT"
18289               glib:nick="object"/>
18290       <member name="stringv"
18291               value="9"
18292               c:identifier="G_FILE_ATTRIBUTE_TYPE_STRINGV"
18293               glib:nick="stringv"/>
18294     </enumeration>
18295     <bitfield name="FileCopyFlags"
18296               glib:type-name="GFileCopyFlags"
18297               glib:get-type="g_file_copy_flags_get_type"
18298               c:type="GFileCopyFlags">
18299       <doc xml:whitespace="preserve">Flags used when copying or moving files.</doc>
18300       <member name="none"
18301               value="0"
18302               c:identifier="G_FILE_COPY_NONE"
18303               glib:nick="none"/>
18304       <member name="overwrite"
18305               value="1"
18306               c:identifier="G_FILE_COPY_OVERWRITE"
18307               glib:nick="overwrite"/>
18308       <member name="backup"
18309               value="2"
18310               c:identifier="G_FILE_COPY_BACKUP"
18311               glib:nick="backup"/>
18312       <member name="nofollow_symlinks"
18313               value="4"
18314               c:identifier="G_FILE_COPY_NOFOLLOW_SYMLINKS"
18315               glib:nick="nofollow-symlinks"/>
18316       <member name="all_metadata"
18317               value="8"
18318               c:identifier="G_FILE_COPY_ALL_METADATA"
18319               glib:nick="all-metadata"/>
18320       <member name="no_fallback_for_move"
18321               value="16"
18322               c:identifier="G_FILE_COPY_NO_FALLBACK_FOR_MOVE"
18323               glib:nick="no-fallback-for-move"/>
18324       <member name="target_default_perms"
18325               value="32"
18326               c:identifier="G_FILE_COPY_TARGET_DEFAULT_PERMS"
18327               glib:nick="target-default-perms"/>
18328     </bitfield>
18329     <bitfield name="FileCreateFlags"
18330               glib:type-name="GFileCreateFlags"
18331               glib:get-type="g_file_create_flags_get_type"
18332               c:type="GFileCreateFlags">
18333       <doc xml:whitespace="preserve">Flags used when an operation may create a file.</doc>
18334       <member name="none"
18335               value="0"
18336               c:identifier="G_FILE_CREATE_NONE"
18337               glib:nick="none"/>
18338       <member name="private"
18339               value="1"
18340               c:identifier="G_FILE_CREATE_PRIVATE"
18341               glib:nick="private"/>
18342       <member name="replace_destination"
18343               value="2"
18344               c:identifier="G_FILE_CREATE_REPLACE_DESTINATION"
18345               glib:nick="replace-destination"/>
18346     </bitfield>
18347     <interface name="FileDescriptorBased"
18348                c:symbol-prefix="file_descriptor_based"
18349                c:type="GFileDescriptorBased"
18350                glib:type-name="GFileDescriptorBased"
18351                glib:get-type="g_file_descriptor_based_get_type"
18352                glib:type-struct="FileDescriptorBasedIface">
18353       <doc xml:whitespace="preserve">An interface for file descriptor based io objects.</doc>
18354       <virtual-method name="get_fd" invoker="get_fd" version="2.24">
18355         <doc xml:whitespace="preserve">Gets the underlying file descriptor.</doc>
18356         <return-value transfer-ownership="none">
18357           <doc xml:whitespace="preserve">The file descriptor</doc>
18358           <type name="gint" c:type="int"/>
18359         </return-value>
18360       </virtual-method>
18361       <method name="get_fd"
18362               c:identifier="g_file_descriptor_based_get_fd"
18363               version="2.24">
18364         <doc xml:whitespace="preserve">Gets the underlying file descriptor.</doc>
18365         <return-value transfer-ownership="none">
18366           <doc xml:whitespace="preserve">The file descriptor</doc>
18367           <type name="gint" c:type="int"/>
18368         </return-value>
18369       </method>
18370     </interface>
18371     <record name="FileDescriptorBasedIface"
18372             c:type="GFileDescriptorBasedIface"
18373             glib:is-gtype-struct-for="FileDescriptorBased">
18374       <field name="g_iface">
18375         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
18376       </field>
18377       <field name="get_fd">
18378         <callback name="get_fd">
18379           <return-value transfer-ownership="none">
18380             <doc xml:whitespace="preserve">The file descriptor</doc>
18381             <type name="gint" c:type="int"/>
18382           </return-value>
18383           <parameters>
18384             <parameter name="fd_based" transfer-ownership="none">
18385               <type name="FileDescriptorBased" c:type="GFileDescriptorBased*"/>
18386             </parameter>
18387           </parameters>
18388         </callback>
18389       </field>
18390     </record>
18391     <class name="FileEnumerator"
18392            c:symbol-prefix="file_enumerator"
18393            c:type="GFileEnumerator"
18394            parent="GObject.Object"
18395            glib:type-name="GFileEnumerator"
18396            glib:get-type="g_file_enumerator_get_type"
18397            glib:type-struct="FileEnumeratorClass">
18398       <doc xml:whitespace="preserve">A per matched file iterator.</doc>
18399       <virtual-method name="close_async" invoker="close_async">
18400         <doc xml:whitespace="preserve">Asynchronously closes the file enumerator.
18401 If @cancellable is not %NULL, then the operation can be cancelled by
18402 triggering the cancellable object from another thread. If the operation
18403 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned in
18404 g_file_enumerator_close_finish().</doc>
18405         <return-value transfer-ownership="none">
18406           <type name="none" c:type="void"/>
18407         </return-value>
18408         <parameters>
18409           <parameter name="io_priority" transfer-ownership="none">
18410             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
18411             <type name="gint" c:type="int"/>
18412           </parameter>
18413           <parameter name="cancellable"
18414                      transfer-ownership="none"
18415                      allow-none="1">
18416             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
18417             <type name="Cancellable" c:type="GCancellable*"/>
18418           </parameter>
18419           <parameter name="callback"
18420                      transfer-ownership="none"
18421                      scope="async"
18422                      closure="3">
18423             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
18424             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
18425           </parameter>
18426           <parameter name="user_data" transfer-ownership="none" closure="3">
18427             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
18428             <type name="gpointer" c:type="gpointer"/>
18429           </parameter>
18430         </parameters>
18431       </virtual-method>
18432       <virtual-method name="close_finish" invoker="close_finish" throws="1">
18433         <doc xml:whitespace="preserve">Finishes closing a file enumerator, started from g_file_enumerator_close_async().
18434 If the file enumerator was already closed when g_file_enumerator_close_async()
18435 was called, then this function will report %G_IO_ERROR_CLOSED in @error, and
18436 return %FALSE. If the file enumerator had pending operation when the close
18437 operation was started, then this function will report %G_IO_ERROR_PENDING, and
18438 return %FALSE.  If @cancellable was not %NULL, then the operation may have been
18439 cancelled by triggering the cancellable object from another thread. If the operation
18440 was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %FALSE will be
18441 returned.</doc>
18442         <return-value transfer-ownership="none">
18443           <doc xml:whitespace="preserve">%TRUE if the close operation has finished successfully.</doc>
18444           <type name="gboolean" c:type="gboolean"/>
18445         </return-value>
18446         <parameters>
18447           <parameter name="res" transfer-ownership="none">
18448             <type name="AsyncResult" c:type="GAsyncResult*"/>
18449           </parameter>
18450         </parameters>
18451       </virtual-method>
18452       <virtual-method name="close_fn" throws="1">
18453         <return-value transfer-ownership="none">
18454           <type name="gboolean" c:type="gboolean"/>
18455         </return-value>
18456         <parameters>
18457           <parameter name="cancellable" transfer-ownership="none">
18458             <type name="Cancellable" c:type="GCancellable*"/>
18459           </parameter>
18460         </parameters>
18461       </virtual-method>
18462       <virtual-method name="next_file" invoker="next_file" throws="1">
18463         <doc xml:whitespace="preserve">Returns information for the next file in the enumerated object.
18464 Will block until the information is available. The #GFileInfo
18465 returned from this function will contain attributes that match the
18466 attribute string that was passed when the #GFileEnumerator was created.
18467 On error, returns %NULL and sets @error to the error. If the
18468 enumerator is at the end, %NULL will be returned and @error will
18469 be unset.
18470 Free the returned object with g_object_unref() when no longer needed.</doc>
18471         <return-value transfer-ownership="full">
18472           <doc xml:whitespace="preserve">A #GFileInfo or %NULL on error or end of enumerator.</doc>
18473           <type name="FileInfo" c:type="GFileInfo*"/>
18474         </return-value>
18475         <parameters>
18476           <parameter name="cancellable"
18477                      transfer-ownership="none"
18478                      allow-none="1">
18479             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
18480             <type name="Cancellable" c:type="GCancellable*"/>
18481           </parameter>
18482         </parameters>
18483       </virtual-method>
18484       <virtual-method name="next_files_async" invoker="next_files_async">
18485         <doc xml:whitespace="preserve">Request information for a number of files from the enumerator asynchronously.
18486 When all i/o for the operation is finished the @callback will be called with
18487 the requested information.
18488 The callback can be called with less than @num_files files in case of error
18489 or at the end of the enumerator. In case of a partial error the callback will
18490 be called with any succeeding items and no error, and on the next request the
18491 error will be reported. If a request is cancelled the callback will be called
18492 with %G_IO_ERROR_CANCELLED.
18493 During an async request no other sync and async calls are allowed, and will
18494 result in %G_IO_ERROR_PENDING errors.
18495 Any outstanding i/o request with higher priority (lower numerical value) will
18496 be executed before an outstanding request with lower priority. Default
18497 priority is %G_PRIORITY_DEFAULT.</doc>
18498         <return-value transfer-ownership="none">
18499           <type name="none" c:type="void"/>
18500         </return-value>
18501         <parameters>
18502           <parameter name="num_files" transfer-ownership="none">
18503             <doc xml:whitespace="preserve">the number of file info objects to request</doc>
18504             <type name="gint" c:type="int"/>
18505           </parameter>
18506           <parameter name="io_priority" transfer-ownership="none">
18507             <doc xml:whitespace="preserve">the &lt;link linkend="gioscheduler"&gt;io priority&lt;/link&gt; of the request.</doc>
18508             <type name="gint" c:type="int"/>
18509           </parameter>
18510           <parameter name="cancellable"
18511                      transfer-ownership="none"
18512                      allow-none="1">
18513             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
18514             <type name="Cancellable" c:type="GCancellable*"/>
18515           </parameter>
18516           <parameter name="callback"
18517                      transfer-ownership="none"
18518                      scope="async"
18519                      closure="4">
18520             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
18521             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
18522           </parameter>
18523           <parameter name="user_data" transfer-ownership="none" closure="4">
18524             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
18525             <type name="gpointer" c:type="gpointer"/>
18526           </parameter>
18527         </parameters>
18528       </virtual-method>
18529       <virtual-method name="next_files_finish"
18530                       invoker="next_files_finish"
18531                       throws="1">
18532         <doc xml:whitespace="preserve">Finishes the asynchronous operation started with g_file_enumerator_next_files_async().
18533 g_list_free() and unref the infos with g_object_unref() when you're
18534 done with them.</doc>
18535         <return-value transfer-ownership="full">
18536           <doc xml:whitespace="preserve">a #GList of #GFileInfo&lt;!----&gt;s. You must free the list with</doc>
18537           <type name="GLib.List" c:type="GList*">
18538             <type name="FileInfo"/>
18539           </type>
18540         </return-value>
18541         <parameters>
18542           <parameter name="res" transfer-ownership="none">
18543             <type name="AsyncResult" c:type="GAsyncResult*"/>
18544           </parameter>
18545         </parameters>
18546       </virtual-method>
18547       <method name="close" c:identifier="g_file_enumerator_close" throws="1">
18548         <doc xml:whitespace="preserve">Releases all resources used by this enumerator, making the
18549 enumerator return %G_IO_ERROR_CLOSED on all calls.
18550 This will be automatically called when the last reference
18551 is dropped, but you might want to call this function to make
18552 sure resources are released as early as possible.</doc>
18553         <return-value transfer-ownership="none">
18554           <doc xml:whitespace="preserve">#TRUE on success or #FALSE on error.</doc>
18555           <type name="gboolean" c:type="gboolean"/>
18556         </return-value>
18557         <parameters>
18558           <parameter name="cancellable"
18559                      transfer-ownership="none"
18560                      allow-none="1">
18561             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
18562             <type name="Cancellable" c:type="GCancellable*"/>
18563           </parameter>
18564         </parameters>
18565       </method>
18566       <method name="close_async" c:identifier="g_file_enumerator_close_async">
18567         <doc xml:whitespace="preserve">Asynchronously closes the file enumerator.
18568 If @cancellable is not %NULL, then the operation can be cancelled by
18569 triggering the cancellable object from another thread. If the operation
18570 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned in
18571 g_file_enumerator_close_finish().</doc>
18572         <return-value transfer-ownership="none">
18573           <type name="none" c:type="void"/>
18574         </return-value>
18575         <parameters>
18576           <parameter name="io_priority" transfer-ownership="none">
18577             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
18578             <type name="gint" c:type="int"/>
18579           </parameter>
18580           <parameter name="cancellable"
18581                      transfer-ownership="none"
18582                      allow-none="1">
18583             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
18584             <type name="Cancellable" c:type="GCancellable*"/>
18585           </parameter>
18586           <parameter name="callback"
18587                      transfer-ownership="none"
18588                      scope="async"
18589                      closure="3">
18590             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
18591             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
18592           </parameter>
18593           <parameter name="user_data" transfer-ownership="none">
18594             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
18595             <type name="gpointer" c:type="gpointer"/>
18596           </parameter>
18597         </parameters>
18598       </method>
18599       <method name="close_finish"
18600               c:identifier="g_file_enumerator_close_finish"
18601               throws="1">
18602         <doc xml:whitespace="preserve">Finishes closing a file enumerator, started from g_file_enumerator_close_async().
18603 If the file enumerator was already closed when g_file_enumerator_close_async()
18604 was called, then this function will report %G_IO_ERROR_CLOSED in @error, and
18605 return %FALSE. If the file enumerator had pending operation when the close
18606 operation was started, then this function will report %G_IO_ERROR_PENDING, and
18607 return %FALSE.  If @cancellable was not %NULL, then the operation may have been
18608 cancelled by triggering the cancellable object from another thread. If the operation
18609 was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %FALSE will be
18610 returned.</doc>
18611         <return-value transfer-ownership="none">
18612           <doc xml:whitespace="preserve">%TRUE if the close operation has finished successfully.</doc>
18613           <type name="gboolean" c:type="gboolean"/>
18614         </return-value>
18615         <parameters>
18616           <parameter name="result" transfer-ownership="none">
18617             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
18618             <type name="AsyncResult" c:type="GAsyncResult*"/>
18619           </parameter>
18620         </parameters>
18621       </method>
18622       <method name="get_container"
18623               c:identifier="g_file_enumerator_get_container"
18624               version="2.18">
18625         <doc xml:whitespace="preserve">Get the #GFile container which is being enumerated.</doc>
18626         <return-value transfer-ownership="full">
18627           <doc xml:whitespace="preserve">the #GFile which is being enumerated.</doc>
18628           <type name="File" c:type="GFile*"/>
18629         </return-value>
18630       </method>
18631       <method name="has_pending" c:identifier="g_file_enumerator_has_pending">
18632         <doc xml:whitespace="preserve">Checks if the file enumerator has pending operations.</doc>
18633         <return-value transfer-ownership="none">
18634           <doc xml:whitespace="preserve">%TRUE if the @enumerator has pending operations.</doc>
18635           <type name="gboolean" c:type="gboolean"/>
18636         </return-value>
18637       </method>
18638       <method name="is_closed" c:identifier="g_file_enumerator_is_closed">
18639         <doc xml:whitespace="preserve">Checks if the file enumerator has been closed.</doc>
18640         <return-value transfer-ownership="none">
18641           <doc xml:whitespace="preserve">%TRUE if the @enumerator is closed.</doc>
18642           <type name="gboolean" c:type="gboolean"/>
18643         </return-value>
18644       </method>
18645       <method name="next_file"
18646               c:identifier="g_file_enumerator_next_file"
18647               throws="1">
18648         <doc xml:whitespace="preserve">Returns information for the next file in the enumerated object.
18649 Will block until the information is available. The #GFileInfo
18650 returned from this function will contain attributes that match the
18651 attribute string that was passed when the #GFileEnumerator was created.
18652 On error, returns %NULL and sets @error to the error. If the
18653 enumerator is at the end, %NULL will be returned and @error will
18654 be unset.
18655 Free the returned object with g_object_unref() when no longer needed.</doc>
18656         <return-value transfer-ownership="full">
18657           <doc xml:whitespace="preserve">A #GFileInfo or %NULL on error or end of enumerator.</doc>
18658           <type name="FileInfo" c:type="GFileInfo*"/>
18659         </return-value>
18660         <parameters>
18661           <parameter name="cancellable"
18662                      transfer-ownership="none"
18663                      allow-none="1">
18664             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
18665             <type name="Cancellable" c:type="GCancellable*"/>
18666           </parameter>
18667         </parameters>
18668       </method>
18669       <method name="next_files_async"
18670               c:identifier="g_file_enumerator_next_files_async">
18671         <doc xml:whitespace="preserve">Request information for a number of files from the enumerator asynchronously.
18672 When all i/o for the operation is finished the @callback will be called with
18673 the requested information.
18674 The callback can be called with less than @num_files files in case of error
18675 or at the end of the enumerator. In case of a partial error the callback will
18676 be called with any succeeding items and no error, and on the next request the
18677 error will be reported. If a request is cancelled the callback will be called
18678 with %G_IO_ERROR_CANCELLED.
18679 During an async request no other sync and async calls are allowed, and will
18680 result in %G_IO_ERROR_PENDING errors.
18681 Any outstanding i/o request with higher priority (lower numerical value) will
18682 be executed before an outstanding request with lower priority. Default
18683 priority is %G_PRIORITY_DEFAULT.</doc>
18684         <return-value transfer-ownership="none">
18685           <type name="none" c:type="void"/>
18686         </return-value>
18687         <parameters>
18688           <parameter name="num_files" transfer-ownership="none">
18689             <doc xml:whitespace="preserve">the number of file info objects to request</doc>
18690             <type name="gint" c:type="int"/>
18691           </parameter>
18692           <parameter name="io_priority" transfer-ownership="none">
18693             <doc xml:whitespace="preserve">the &lt;link linkend="gioscheduler"&gt;io priority&lt;/link&gt; of the request.</doc>
18694             <type name="gint" c:type="int"/>
18695           </parameter>
18696           <parameter name="cancellable"
18697                      transfer-ownership="none"
18698                      allow-none="1">
18699             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
18700             <type name="Cancellable" c:type="GCancellable*"/>
18701           </parameter>
18702           <parameter name="callback"
18703                      transfer-ownership="none"
18704                      scope="async"
18705                      closure="4">
18706             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
18707             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
18708           </parameter>
18709           <parameter name="user_data" transfer-ownership="none">
18710             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
18711             <type name="gpointer" c:type="gpointer"/>
18712           </parameter>
18713         </parameters>
18714       </method>
18715       <method name="next_files_finish"
18716               c:identifier="g_file_enumerator_next_files_finish"
18717               throws="1">
18718         <doc xml:whitespace="preserve">Finishes the asynchronous operation started with g_file_enumerator_next_files_async().
18719 g_list_free() and unref the infos with g_object_unref() when you're
18720 done with them.</doc>
18721         <return-value transfer-ownership="full">
18722           <doc xml:whitespace="preserve">a #GList of #GFileInfo&lt;!----&gt;s. You must free the list with</doc>
18723           <type name="GLib.List" c:type="GList*">
18724             <type name="FileInfo"/>
18725           </type>
18726         </return-value>
18727         <parameters>
18728           <parameter name="result" transfer-ownership="none">
18729             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
18730             <type name="AsyncResult" c:type="GAsyncResult*"/>
18731           </parameter>
18732         </parameters>
18733       </method>
18734       <method name="set_pending" c:identifier="g_file_enumerator_set_pending">
18735         <doc xml:whitespace="preserve">Sets the file enumerator as having pending operations.</doc>
18736         <return-value transfer-ownership="none">
18737           <type name="none" c:type="void"/>
18738         </return-value>
18739         <parameters>
18740           <parameter name="pending" transfer-ownership="none">
18741             <doc xml:whitespace="preserve">a boolean value.</doc>
18742             <type name="gboolean" c:type="gboolean"/>
18743           </parameter>
18744         </parameters>
18745       </method>
18746       <property name="container"
18747                 readable="0"
18748                 writable="1"
18749                 construct-only="1"
18750                 transfer-ownership="none">
18751         <type name="File"/>
18752       </property>
18753       <field name="parent_instance">
18754         <type name="GObject.Object" c:type="GObject"/>
18755       </field>
18756       <field name="priv">
18757         <type name="FileEnumeratorPrivate" c:type="GFileEnumeratorPrivate*"/>
18758       </field>
18759     </class>
18760     <record name="FileEnumeratorClass"
18761             c:type="GFileEnumeratorClass"
18762             glib:is-gtype-struct-for="FileEnumerator">
18763       <field name="parent_class">
18764         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
18765       </field>
18766       <field name="next_file">
18767         <callback name="next_file" throws="1">
18768           <return-value transfer-ownership="full">
18769             <doc xml:whitespace="preserve">A #GFileInfo or %NULL on error or end of enumerator.</doc>
18770             <type name="FileInfo" c:type="GFileInfo*"/>
18771           </return-value>
18772           <parameters>
18773             <parameter name="enumerator" transfer-ownership="none">
18774               <type name="FileEnumerator" c:type="GFileEnumerator*"/>
18775             </parameter>
18776             <parameter name="cancellable"
18777                        transfer-ownership="none"
18778                        allow-none="1">
18779               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
18780               <type name="Cancellable" c:type="GCancellable*"/>
18781             </parameter>
18782           </parameters>
18783         </callback>
18784       </field>
18785       <field name="close_fn">
18786         <callback name="close_fn" throws="1">
18787           <return-value transfer-ownership="none">
18788             <type name="gboolean" c:type="gboolean"/>
18789           </return-value>
18790           <parameters>
18791             <parameter name="enumerator" transfer-ownership="none">
18792               <type name="FileEnumerator" c:type="GFileEnumerator*"/>
18793             </parameter>
18794             <parameter name="cancellable" transfer-ownership="none">
18795               <type name="Cancellable" c:type="GCancellable*"/>
18796             </parameter>
18797           </parameters>
18798         </callback>
18799       </field>
18800       <field name="next_files_async">
18801         <callback name="next_files_async">
18802           <return-value transfer-ownership="none">
18803             <type name="none" c:type="void"/>
18804           </return-value>
18805           <parameters>
18806             <parameter name="enumerator" transfer-ownership="none">
18807               <type name="FileEnumerator" c:type="GFileEnumerator*"/>
18808             </parameter>
18809             <parameter name="num_files" transfer-ownership="none">
18810               <doc xml:whitespace="preserve">the number of file info objects to request</doc>
18811               <type name="gint" c:type="int"/>
18812             </parameter>
18813             <parameter name="io_priority" transfer-ownership="none">
18814               <doc xml:whitespace="preserve">the &lt;link linkend="gioscheduler"&gt;io priority&lt;/link&gt; of the request.</doc>
18815               <type name="gint" c:type="int"/>
18816             </parameter>
18817             <parameter name="cancellable"
18818                        transfer-ownership="none"
18819                        allow-none="1">
18820               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
18821               <type name="Cancellable" c:type="GCancellable*"/>
18822             </parameter>
18823             <parameter name="callback"
18824                        transfer-ownership="none"
18825                        scope="async"
18826                        closure="5">
18827               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
18828               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
18829             </parameter>
18830             <parameter name="user_data" transfer-ownership="none" closure="5">
18831               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
18832               <type name="gpointer" c:type="gpointer"/>
18833             </parameter>
18834           </parameters>
18835         </callback>
18836       </field>
18837       <field name="next_files_finish">
18838         <callback name="next_files_finish" throws="1">
18839           <return-value transfer-ownership="full">
18840             <doc xml:whitespace="preserve">a #GList of #GFileInfo&lt;!----&gt;s. You must free the list with</doc>
18841             <type name="GLib.List" c:type="GList*">
18842               <type name="FileInfo"/>
18843             </type>
18844           </return-value>
18845           <parameters>
18846             <parameter name="enumerator" transfer-ownership="none">
18847               <type name="FileEnumerator" c:type="GFileEnumerator*"/>
18848             </parameter>
18849             <parameter name="res" transfer-ownership="none">
18850               <type name="AsyncResult" c:type="GAsyncResult*"/>
18851             </parameter>
18852           </parameters>
18853         </callback>
18854       </field>
18855       <field name="close_async">
18856         <callback name="close_async">
18857           <return-value transfer-ownership="none">
18858             <type name="none" c:type="void"/>
18859           </return-value>
18860           <parameters>
18861             <parameter name="enumerator" transfer-ownership="none">
18862               <type name="FileEnumerator" c:type="GFileEnumerator*"/>
18863             </parameter>
18864             <parameter name="io_priority" transfer-ownership="none">
18865               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
18866               <type name="gint" c:type="int"/>
18867             </parameter>
18868             <parameter name="cancellable"
18869                        transfer-ownership="none"
18870                        allow-none="1">
18871               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
18872               <type name="Cancellable" c:type="GCancellable*"/>
18873             </parameter>
18874             <parameter name="callback"
18875                        transfer-ownership="none"
18876                        scope="async"
18877                        closure="4">
18878               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
18879               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
18880             </parameter>
18881             <parameter name="user_data" transfer-ownership="none" closure="4">
18882               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
18883               <type name="gpointer" c:type="gpointer"/>
18884             </parameter>
18885           </parameters>
18886         </callback>
18887       </field>
18888       <field name="close_finish">
18889         <callback name="close_finish" throws="1">
18890           <return-value transfer-ownership="none">
18891             <doc xml:whitespace="preserve">%TRUE if the close operation has finished successfully.</doc>
18892             <type name="gboolean" c:type="gboolean"/>
18893           </return-value>
18894           <parameters>
18895             <parameter name="enumerator" transfer-ownership="none">
18896               <type name="FileEnumerator" c:type="GFileEnumerator*"/>
18897             </parameter>
18898             <parameter name="res" transfer-ownership="none">
18899               <type name="AsyncResult" c:type="GAsyncResult*"/>
18900             </parameter>
18901           </parameters>
18902         </callback>
18903       </field>
18904       <field name="_g_reserved1" introspectable="0">
18905         <callback name="_g_reserved1">
18906           <return-value transfer-ownership="none">
18907             <type name="none" c:type="void"/>
18908           </return-value>
18909         </callback>
18910       </field>
18911       <field name="_g_reserved2" introspectable="0">
18912         <callback name="_g_reserved2">
18913           <return-value transfer-ownership="none">
18914             <type name="none" c:type="void"/>
18915           </return-value>
18916         </callback>
18917       </field>
18918       <field name="_g_reserved3" introspectable="0">
18919         <callback name="_g_reserved3">
18920           <return-value transfer-ownership="none">
18921             <type name="none" c:type="void"/>
18922           </return-value>
18923         </callback>
18924       </field>
18925       <field name="_g_reserved4" introspectable="0">
18926         <callback name="_g_reserved4">
18927           <return-value transfer-ownership="none">
18928             <type name="none" c:type="void"/>
18929           </return-value>
18930         </callback>
18931       </field>
18932       <field name="_g_reserved5" introspectable="0">
18933         <callback name="_g_reserved5">
18934           <return-value transfer-ownership="none">
18935             <type name="none" c:type="void"/>
18936           </return-value>
18937         </callback>
18938       </field>
18939       <field name="_g_reserved6" introspectable="0">
18940         <callback name="_g_reserved6">
18941           <return-value transfer-ownership="none">
18942             <type name="none" c:type="void"/>
18943           </return-value>
18944         </callback>
18945       </field>
18946       <field name="_g_reserved7" introspectable="0">
18947         <callback name="_g_reserved7">
18948           <return-value transfer-ownership="none">
18949             <type name="none" c:type="void"/>
18950           </return-value>
18951         </callback>
18952       </field>
18953     </record>
18954     <record name="FileEnumeratorPrivate"
18955             c:type="GFileEnumeratorPrivate"
18956             disguised="1">
18957     </record>
18958     <class name="FileIOStream"
18959            c:symbol-prefix="file_io_stream"
18960            c:type="GFileIOStream"
18961            parent="IOStream"
18962            glib:type-name="GFileIOStream"
18963            glib:get-type="g_file_io_stream_get_type"
18964            glib:type-struct="FileIOStreamClass">
18965       <doc xml:whitespace="preserve">A subclass of GIOStream for opened files. This adds
18966 a few file-specific operations and seeking and truncating.
18967 #GFileIOStream implements GSeekable.</doc>
18968       <implements name="Seekable"/>
18969       <virtual-method name="can_seek">
18970         <return-value transfer-ownership="none">
18971           <type name="gboolean" c:type="gboolean"/>
18972         </return-value>
18973       </virtual-method>
18974       <virtual-method name="can_truncate">
18975         <return-value transfer-ownership="none">
18976           <type name="gboolean" c:type="gboolean"/>
18977         </return-value>
18978       </virtual-method>
18979       <virtual-method name="get_etag" invoker="get_etag" version="2.22">
18980         <doc xml:whitespace="preserve">Gets the entity tag for the file when it has been written.
18981 This must be called after the stream has been written
18982 and closed, as the etag can change while writing.</doc>
18983         <return-value transfer-ownership="full">
18984           <doc xml:whitespace="preserve">the entity tag for the stream.</doc>
18985           <type name="utf8" c:type="char*"/>
18986         </return-value>
18987       </virtual-method>
18988       <virtual-method name="query_info"
18989                       invoker="query_info"
18990                       version="2.22"
18991                       throws="1">
18992         <doc xml:whitespace="preserve">Queries a file io stream for the given @attributes.
18993 This function blocks while querying the stream. For the asynchronous
18994 version of this function, see g_file_io_stream_query_info_async().
18995 While the stream is blocked, the stream will set the pending flag
18996 internally, and any other operations on the stream will fail with
18997 %G_IO_ERROR_PENDING.
18998 Can fail if the stream was already closed (with @error being set to
18999 %G_IO_ERROR_CLOSED), the stream has pending operations (with @error being
19000 set to %G_IO_ERROR_PENDING), or if querying info is not supported for
19001 the stream's interface (with @error being set to %G_IO_ERROR_NOT_SUPPORTED). I
19002 all cases of failure, %NULL will be returned.
19003 If @cancellable is not %NULL, then the operation can be cancelled by
19004 triggering the cancellable object from another thread. If the operation
19005 was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will
19006 be returned.</doc>
19007         <return-value transfer-ownership="full">
19008           <doc xml:whitespace="preserve">a #GFileInfo for the @stream, or %NULL on error.</doc>
19009           <type name="FileInfo" c:type="GFileInfo*"/>
19010         </return-value>
19011         <parameters>
19012           <parameter name="attributes" transfer-ownership="none">
19013             <doc xml:whitespace="preserve">a file attribute query string.</doc>
19014             <type name="utf8" c:type="char*"/>
19015           </parameter>
19016           <parameter name="cancellable"
19017                      transfer-ownership="none"
19018                      allow-none="1">
19019             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
19020             <type name="Cancellable" c:type="GCancellable*"/>
19021           </parameter>
19022         </parameters>
19023       </virtual-method>
19024       <virtual-method name="query_info_async"
19025                       invoker="query_info_async"
19026                       version="2.22">
19027         <doc xml:whitespace="preserve">Asynchronously queries the @stream for a #GFileInfo. When completed,
19028 finish the operation with g_file_io_stream_query_info_finish().
19029 For the synchronous version of this function, see
19030 g_file_io_stream_query_info().</doc>
19031         <return-value transfer-ownership="none">
19032           <type name="none" c:type="void"/>
19033         </return-value>
19034         <parameters>
19035           <parameter name="attributes" transfer-ownership="none">
19036             <doc xml:whitespace="preserve">a file attribute query string.</doc>
19037             <type name="utf8" c:type="char*"/>
19038           </parameter>
19039           <parameter name="io_priority" transfer-ownership="none">
19040             <doc xml:whitespace="preserve">the &lt;link linkend="gio-GIOScheduler"&gt;I/O priority&lt;/link&gt; of the request.</doc>
19041             <type name="gint" c:type="int"/>
19042           </parameter>
19043           <parameter name="cancellable"
19044                      transfer-ownership="none"
19045                      allow-none="1">
19046             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
19047             <type name="Cancellable" c:type="GCancellable*"/>
19048           </parameter>
19049           <parameter name="callback"
19050                      transfer-ownership="none"
19051                      scope="async"
19052                      closure="4">
19053             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
19054             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
19055           </parameter>
19056           <parameter name="user_data" transfer-ownership="none" closure="4">
19057             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
19058             <type name="gpointer" c:type="gpointer"/>
19059           </parameter>
19060         </parameters>
19061       </virtual-method>
19062       <virtual-method name="query_info_finish"
19063                       invoker="query_info_finish"
19064                       version="2.22"
19065                       throws="1">
19066         <doc xml:whitespace="preserve">Finalizes the asynchronous query started
19067 by g_file_io_stream_query_info_async().</doc>
19068         <return-value transfer-ownership="full">
19069           <doc xml:whitespace="preserve">A #GFileInfo for the finished query.</doc>
19070           <type name="FileInfo" c:type="GFileInfo*"/>
19071         </return-value>
19072         <parameters>
19073           <parameter name="res" transfer-ownership="none">
19074             <type name="AsyncResult" c:type="GAsyncResult*"/>
19075           </parameter>
19076         </parameters>
19077       </virtual-method>
19078       <virtual-method name="seek" throws="1">
19079         <return-value transfer-ownership="none">
19080           <type name="gboolean" c:type="gboolean"/>
19081         </return-value>
19082         <parameters>
19083           <parameter name="offset" transfer-ownership="none">
19084             <type name="gint64" c:type="goffset"/>
19085           </parameter>
19086           <parameter name="type" transfer-ownership="none">
19087             <type name="GLib.SeekType" c:type="GSeekType"/>
19088           </parameter>
19089           <parameter name="cancellable" transfer-ownership="none">
19090             <type name="Cancellable" c:type="GCancellable*"/>
19091           </parameter>
19092         </parameters>
19093       </virtual-method>
19094       <virtual-method name="tell">
19095         <return-value transfer-ownership="none">
19096           <type name="gint64" c:type="goffset"/>
19097         </return-value>
19098       </virtual-method>
19099       <virtual-method name="truncate_fn" throws="1">
19100         <return-value transfer-ownership="none">
19101           <type name="gboolean" c:type="gboolean"/>
19102         </return-value>
19103         <parameters>
19104           <parameter name="size" transfer-ownership="none">
19105             <type name="gint64" c:type="goffset"/>
19106           </parameter>
19107           <parameter name="cancellable" transfer-ownership="none">
19108             <type name="Cancellable" c:type="GCancellable*"/>
19109           </parameter>
19110         </parameters>
19111       </virtual-method>
19112       <method name="get_etag"
19113               c:identifier="g_file_io_stream_get_etag"
19114               version="2.22">
19115         <doc xml:whitespace="preserve">Gets the entity tag for the file when it has been written.
19116 This must be called after the stream has been written
19117 and closed, as the etag can change while writing.</doc>
19118         <return-value transfer-ownership="full">
19119           <doc xml:whitespace="preserve">the entity tag for the stream.</doc>
19120           <type name="utf8" c:type="char*"/>
19121         </return-value>
19122       </method>
19123       <method name="query_info"
19124               c:identifier="g_file_io_stream_query_info"
19125               version="2.22"
19126               throws="1">
19127         <doc xml:whitespace="preserve">Queries a file io stream for the given @attributes.
19128 This function blocks while querying the stream. For the asynchronous
19129 version of this function, see g_file_io_stream_query_info_async().
19130 While the stream is blocked, the stream will set the pending flag
19131 internally, and any other operations on the stream will fail with
19132 %G_IO_ERROR_PENDING.
19133 Can fail if the stream was already closed (with @error being set to
19134 %G_IO_ERROR_CLOSED), the stream has pending operations (with @error being
19135 set to %G_IO_ERROR_PENDING), or if querying info is not supported for
19136 the stream's interface (with @error being set to %G_IO_ERROR_NOT_SUPPORTED). I
19137 all cases of failure, %NULL will be returned.
19138 If @cancellable is not %NULL, then the operation can be cancelled by
19139 triggering the cancellable object from another thread. If the operation
19140 was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will
19141 be returned.</doc>
19142         <return-value transfer-ownership="full">
19143           <doc xml:whitespace="preserve">a #GFileInfo for the @stream, or %NULL on error.</doc>
19144           <type name="FileInfo" c:type="GFileInfo*"/>
19145         </return-value>
19146         <parameters>
19147           <parameter name="attributes" transfer-ownership="none">
19148             <doc xml:whitespace="preserve">a file attribute query string.</doc>
19149             <type name="utf8" c:type="char*"/>
19150           </parameter>
19151           <parameter name="cancellable"
19152                      transfer-ownership="none"
19153                      allow-none="1">
19154             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
19155             <type name="Cancellable" c:type="GCancellable*"/>
19156           </parameter>
19157         </parameters>
19158       </method>
19159       <method name="query_info_async"
19160               c:identifier="g_file_io_stream_query_info_async"
19161               version="2.22">
19162         <doc xml:whitespace="preserve">Asynchronously queries the @stream for a #GFileInfo. When completed,
19163 finish the operation with g_file_io_stream_query_info_finish().
19164 For the synchronous version of this function, see
19165 g_file_io_stream_query_info().</doc>
19166         <return-value transfer-ownership="none">
19167           <type name="none" c:type="void"/>
19168         </return-value>
19169         <parameters>
19170           <parameter name="attributes" transfer-ownership="none">
19171             <doc xml:whitespace="preserve">a file attribute query string.</doc>
19172             <type name="utf8" c:type="char*"/>
19173           </parameter>
19174           <parameter name="io_priority" transfer-ownership="none">
19175             <doc xml:whitespace="preserve">the &lt;link linkend="gio-GIOScheduler"&gt;I/O priority&lt;/link&gt; of the request.</doc>
19176             <type name="gint" c:type="int"/>
19177           </parameter>
19178           <parameter name="cancellable"
19179                      transfer-ownership="none"
19180                      allow-none="1">
19181             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
19182             <type name="Cancellable" c:type="GCancellable*"/>
19183           </parameter>
19184           <parameter name="callback"
19185                      transfer-ownership="none"
19186                      scope="async"
19187                      closure="4">
19188             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
19189             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
19190           </parameter>
19191           <parameter name="user_data" transfer-ownership="none">
19192             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
19193             <type name="gpointer" c:type="gpointer"/>
19194           </parameter>
19195         </parameters>
19196       </method>
19197       <method name="query_info_finish"
19198               c:identifier="g_file_io_stream_query_info_finish"
19199               version="2.22"
19200               throws="1">
19201         <doc xml:whitespace="preserve">Finalizes the asynchronous query started
19202 by g_file_io_stream_query_info_async().</doc>
19203         <return-value transfer-ownership="full">
19204           <doc xml:whitespace="preserve">A #GFileInfo for the finished query.</doc>
19205           <type name="FileInfo" c:type="GFileInfo*"/>
19206         </return-value>
19207         <parameters>
19208           <parameter name="result" transfer-ownership="none">
19209             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
19210             <type name="AsyncResult" c:type="GAsyncResult*"/>
19211           </parameter>
19212         </parameters>
19213       </method>
19214       <field name="parent_instance">
19215         <type name="IOStream" c:type="GIOStream"/>
19216       </field>
19217       <field name="priv">
19218         <type name="FileIOStreamPrivate" c:type="GFileIOStreamPrivate*"/>
19219       </field>
19220     </class>
19221     <record name="FileIOStreamClass"
19222             c:type="GFileIOStreamClass"
19223             glib:is-gtype-struct-for="FileIOStream">
19224       <field name="parent_class">
19225         <type name="IOStreamClass" c:type="GIOStreamClass"/>
19226       </field>
19227       <field name="tell">
19228         <callback name="tell">
19229           <return-value transfer-ownership="none">
19230             <type name="gint64" c:type="goffset"/>
19231           </return-value>
19232           <parameters>
19233             <parameter name="stream" transfer-ownership="none">
19234               <type name="FileIOStream" c:type="GFileIOStream*"/>
19235             </parameter>
19236           </parameters>
19237         </callback>
19238       </field>
19239       <field name="can_seek">
19240         <callback name="can_seek">
19241           <return-value transfer-ownership="none">
19242             <type name="gboolean" c:type="gboolean"/>
19243           </return-value>
19244           <parameters>
19245             <parameter name="stream" transfer-ownership="none">
19246               <type name="FileIOStream" c:type="GFileIOStream*"/>
19247             </parameter>
19248           </parameters>
19249         </callback>
19250       </field>
19251       <field name="seek">
19252         <callback name="seek" throws="1">
19253           <return-value transfer-ownership="none">
19254             <type name="gboolean" c:type="gboolean"/>
19255           </return-value>
19256           <parameters>
19257             <parameter name="stream" transfer-ownership="none">
19258               <type name="FileIOStream" c:type="GFileIOStream*"/>
19259             </parameter>
19260             <parameter name="offset" transfer-ownership="none">
19261               <type name="gint64" c:type="goffset"/>
19262             </parameter>
19263             <parameter name="type" transfer-ownership="none">
19264               <type name="GLib.SeekType" c:type="GSeekType"/>
19265             </parameter>
19266             <parameter name="cancellable" transfer-ownership="none">
19267               <type name="Cancellable" c:type="GCancellable*"/>
19268             </parameter>
19269           </parameters>
19270         </callback>
19271       </field>
19272       <field name="can_truncate">
19273         <callback name="can_truncate">
19274           <return-value transfer-ownership="none">
19275             <type name="gboolean" c:type="gboolean"/>
19276           </return-value>
19277           <parameters>
19278             <parameter name="stream" transfer-ownership="none">
19279               <type name="FileIOStream" c:type="GFileIOStream*"/>
19280             </parameter>
19281           </parameters>
19282         </callback>
19283       </field>
19284       <field name="truncate_fn">
19285         <callback name="truncate_fn" throws="1">
19286           <return-value transfer-ownership="none">
19287             <type name="gboolean" c:type="gboolean"/>
19288           </return-value>
19289           <parameters>
19290             <parameter name="stream" transfer-ownership="none">
19291               <type name="FileIOStream" c:type="GFileIOStream*"/>
19292             </parameter>
19293             <parameter name="size" transfer-ownership="none">
19294               <type name="gint64" c:type="goffset"/>
19295             </parameter>
19296             <parameter name="cancellable" transfer-ownership="none">
19297               <type name="Cancellable" c:type="GCancellable*"/>
19298             </parameter>
19299           </parameters>
19300         </callback>
19301       </field>
19302       <field name="query_info">
19303         <callback name="query_info" throws="1">
19304           <return-value transfer-ownership="full">
19305             <doc xml:whitespace="preserve">a #GFileInfo for the @stream, or %NULL on error.</doc>
19306             <type name="FileInfo" c:type="GFileInfo*"/>
19307           </return-value>
19308           <parameters>
19309             <parameter name="stream" transfer-ownership="none">
19310               <type name="FileIOStream" c:type="GFileIOStream*"/>
19311             </parameter>
19312             <parameter name="attributes" transfer-ownership="none">
19313               <doc xml:whitespace="preserve">a file attribute query string.</doc>
19314               <type name="utf8" c:type="char*"/>
19315             </parameter>
19316             <parameter name="cancellable"
19317                        transfer-ownership="none"
19318                        allow-none="1">
19319               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
19320               <type name="Cancellable" c:type="GCancellable*"/>
19321             </parameter>
19322           </parameters>
19323         </callback>
19324       </field>
19325       <field name="query_info_async">
19326         <callback name="query_info_async">
19327           <return-value transfer-ownership="none">
19328             <type name="none" c:type="void"/>
19329           </return-value>
19330           <parameters>
19331             <parameter name="stream" transfer-ownership="none">
19332               <type name="FileIOStream" c:type="GFileIOStream*"/>
19333             </parameter>
19334             <parameter name="attributes" transfer-ownership="none">
19335               <doc xml:whitespace="preserve">a file attribute query string.</doc>
19336               <type name="utf8" c:type="char*"/>
19337             </parameter>
19338             <parameter name="io_priority" transfer-ownership="none">
19339               <doc xml:whitespace="preserve">the &lt;link linkend="gio-GIOScheduler"&gt;I/O priority&lt;/link&gt; of the request.</doc>
19340               <type name="gint" c:type="int"/>
19341             </parameter>
19342             <parameter name="cancellable"
19343                        transfer-ownership="none"
19344                        allow-none="1">
19345               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
19346               <type name="Cancellable" c:type="GCancellable*"/>
19347             </parameter>
19348             <parameter name="callback"
19349                        transfer-ownership="none"
19350                        scope="async"
19351                        closure="5">
19352               <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
19353               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
19354             </parameter>
19355             <parameter name="user_data" transfer-ownership="none" closure="5">
19356               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
19357               <type name="gpointer" c:type="gpointer"/>
19358             </parameter>
19359           </parameters>
19360         </callback>
19361       </field>
19362       <field name="query_info_finish">
19363         <callback name="query_info_finish" throws="1">
19364           <return-value transfer-ownership="full">
19365             <doc xml:whitespace="preserve">A #GFileInfo for the finished query.</doc>
19366             <type name="FileInfo" c:type="GFileInfo*"/>
19367           </return-value>
19368           <parameters>
19369             <parameter name="stream" transfer-ownership="none">
19370               <type name="FileIOStream" c:type="GFileIOStream*"/>
19371             </parameter>
19372             <parameter name="res" transfer-ownership="none">
19373               <type name="AsyncResult" c:type="GAsyncResult*"/>
19374             </parameter>
19375           </parameters>
19376         </callback>
19377       </field>
19378       <field name="get_etag">
19379         <callback name="get_etag">
19380           <return-value transfer-ownership="full">
19381             <doc xml:whitespace="preserve">the entity tag for the stream.</doc>
19382             <type name="utf8" c:type="char*"/>
19383           </return-value>
19384           <parameters>
19385             <parameter name="stream" transfer-ownership="none">
19386               <type name="FileIOStream" c:type="GFileIOStream*"/>
19387             </parameter>
19388           </parameters>
19389         </callback>
19390       </field>
19391       <field name="_g_reserved1" introspectable="0">
19392         <callback name="_g_reserved1">
19393           <return-value transfer-ownership="none">
19394             <type name="none" c:type="void"/>
19395           </return-value>
19396         </callback>
19397       </field>
19398       <field name="_g_reserved2" introspectable="0">
19399         <callback name="_g_reserved2">
19400           <return-value transfer-ownership="none">
19401             <type name="none" c:type="void"/>
19402           </return-value>
19403         </callback>
19404       </field>
19405       <field name="_g_reserved3" introspectable="0">
19406         <callback name="_g_reserved3">
19407           <return-value transfer-ownership="none">
19408             <type name="none" c:type="void"/>
19409           </return-value>
19410         </callback>
19411       </field>
19412       <field name="_g_reserved4" introspectable="0">
19413         <callback name="_g_reserved4">
19414           <return-value transfer-ownership="none">
19415             <type name="none" c:type="void"/>
19416           </return-value>
19417         </callback>
19418       </field>
19419       <field name="_g_reserved5" introspectable="0">
19420         <callback name="_g_reserved5">
19421           <return-value transfer-ownership="none">
19422             <type name="none" c:type="void"/>
19423           </return-value>
19424         </callback>
19425       </field>
19426     </record>
19427     <record name="FileIOStreamPrivate"
19428             c:type="GFileIOStreamPrivate"
19429             disguised="1">
19430     </record>
19431     <class name="FileIcon"
19432            c:symbol-prefix="file_icon"
19433            c:type="GFileIcon"
19434            parent="GObject.Object"
19435            glib:type-name="GFileIcon"
19436            glib:get-type="g_file_icon_get_type"
19437            glib:type-struct="FileIconClass">
19438       <doc xml:whitespace="preserve">Gets an icon for a #GFile. Implements #GLoadableIcon.</doc>
19439       <implements name="Icon"/>
19440       <implements name="LoadableIcon"/>
19441       <method name="get_file" c:identifier="g_file_icon_get_file">
19442         <doc xml:whitespace="preserve">Gets the #GFile associated with the given @icon.</doc>
19443         <return-value transfer-ownership="none">
19444           <doc xml:whitespace="preserve">a #GFile, or %NULL.</doc>
19445           <type name="File" c:type="GFile*"/>
19446         </return-value>
19447       </method>
19448       <property name="file"
19449                 writable="1"
19450                 construct-only="1"
19451                 transfer-ownership="none">
19452         <doc xml:whitespace="preserve">The file containing the icon.</doc>
19453         <type name="File"/>
19454       </property>
19455     </class>
19456     <record name="FileIconClass"
19457             c:type="GFileIconClass"
19458             disguised="1"
19459             glib:is-gtype-struct-for="FileIcon">
19460     </record>
19461     <record name="FileIface"
19462             c:type="GFileIface"
19463             glib:is-gtype-struct-for="File">
19464       <doc xml:whitespace="preserve">An interface for writing VFS file handles.</doc>
19465       <field name="g_iface">
19466         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
19467       </field>
19468       <field name="dup">
19469         <callback name="dup">
19470           <return-value transfer-ownership="full">
19471             <doc xml:whitespace="preserve">a new #GFile that is a duplicate of the given #GFile.</doc>
19472             <type name="File" c:type="GFile*"/>
19473           </return-value>
19474           <parameters>
19475             <parameter name="file" transfer-ownership="none">
19476               <type name="File" c:type="GFile*"/>
19477             </parameter>
19478           </parameters>
19479         </callback>
19480       </field>
19481       <field name="hash">
19482         <callback name="hash">
19483           <return-value transfer-ownership="none">
19484             <type name="guint" c:type="guint"/>
19485           </return-value>
19486           <parameters>
19487             <parameter name="file" transfer-ownership="none">
19488               <type name="File" c:type="GFile*"/>
19489             </parameter>
19490           </parameters>
19491         </callback>
19492       </field>
19493       <field name="equal">
19494         <callback name="equal">
19495           <return-value transfer-ownership="none">
19496             <doc xml:whitespace="preserve">%TRUE if @file1 and @file2 are equal.</doc>
19497             <type name="gboolean" c:type="gboolean"/>
19498           </return-value>
19499           <parameters>
19500             <parameter name="file1" transfer-ownership="none">
19501               <type name="File" c:type="GFile*"/>
19502             </parameter>
19503             <parameter name="file2" transfer-ownership="none">
19504               <doc xml:whitespace="preserve">the second #GFile.</doc>
19505               <type name="File" c:type="GFile*"/>
19506             </parameter>
19507           </parameters>
19508         </callback>
19509       </field>
19510       <field name="is_native">
19511         <callback name="is_native">
19512           <return-value transfer-ownership="none">
19513             <doc xml:whitespace="preserve">%TRUE if file is native.</doc>
19514             <type name="gboolean" c:type="gboolean"/>
19515           </return-value>
19516           <parameters>
19517             <parameter name="file" transfer-ownership="none">
19518               <type name="File" c:type="GFile*"/>
19519             </parameter>
19520           </parameters>
19521         </callback>
19522       </field>
19523       <field name="has_uri_scheme">
19524         <callback name="has_uri_scheme">
19525           <return-value transfer-ownership="none">
19526             <doc xml:whitespace="preserve">%TRUE if #GFile's backend supports the</doc>
19527             <type name="gboolean" c:type="gboolean"/>
19528           </return-value>
19529           <parameters>
19530             <parameter name="file" transfer-ownership="none">
19531               <type name="File" c:type="GFile*"/>
19532             </parameter>
19533             <parameter name="uri_scheme" transfer-ownership="none">
19534               <doc xml:whitespace="preserve">a string containing a URI scheme.</doc>
19535               <type name="utf8" c:type="char*"/>
19536             </parameter>
19537           </parameters>
19538         </callback>
19539       </field>
19540       <field name="get_uri_scheme">
19541         <callback name="get_uri_scheme">
19542           <return-value transfer-ownership="full">
19543             <doc xml:whitespace="preserve">a string containing the URI scheme for the given</doc>
19544             <type name="utf8" c:type="char*"/>
19545           </return-value>
19546           <parameters>
19547             <parameter name="file" transfer-ownership="none">
19548               <type name="File" c:type="GFile*"/>
19549             </parameter>
19550           </parameters>
19551         </callback>
19552       </field>
19553       <field name="get_basename">
19554         <callback name="get_basename">
19555           <return-value transfer-ownership="full">
19556             <doc xml:whitespace="preserve">string containing the #GFile's base name, or %NULL</doc>
19557             <type name="utf8" c:type="char*"/>
19558           </return-value>
19559           <parameters>
19560             <parameter name="file" transfer-ownership="none">
19561               <type name="File" c:type="GFile*"/>
19562             </parameter>
19563           </parameters>
19564         </callback>
19565       </field>
19566       <field name="get_path">
19567         <callback name="get_path">
19568           <return-value transfer-ownership="full">
19569             <doc xml:whitespace="preserve">string containing the #GFile's path, or %NULL if</doc>
19570             <type name="utf8" c:type="char*"/>
19571           </return-value>
19572           <parameters>
19573             <parameter name="file" transfer-ownership="none">
19574               <type name="File" c:type="GFile*"/>
19575             </parameter>
19576           </parameters>
19577         </callback>
19578       </field>
19579       <field name="get_uri">
19580         <callback name="get_uri">
19581           <return-value transfer-ownership="full">
19582             <doc xml:whitespace="preserve">a string containing the #GFile's URI.</doc>
19583             <type name="utf8" c:type="char*"/>
19584           </return-value>
19585           <parameters>
19586             <parameter name="file" transfer-ownership="none">
19587               <type name="File" c:type="GFile*"/>
19588             </parameter>
19589           </parameters>
19590         </callback>
19591       </field>
19592       <field name="get_parse_name">
19593         <callback name="get_parse_name">
19594           <return-value transfer-ownership="full">
19595             <doc xml:whitespace="preserve">a string containing the #GFile's parse name. The returned</doc>
19596             <type name="utf8" c:type="char*"/>
19597           </return-value>
19598           <parameters>
19599             <parameter name="file" transfer-ownership="none">
19600               <type name="File" c:type="GFile*"/>
19601             </parameter>
19602           </parameters>
19603         </callback>
19604       </field>
19605       <field name="get_parent">
19606         <callback name="get_parent">
19607           <return-value transfer-ownership="full">
19608             <doc xml:whitespace="preserve">a #GFile structure to the parent of the given</doc>
19609             <type name="File" c:type="GFile*"/>
19610           </return-value>
19611           <parameters>
19612             <parameter name="file" transfer-ownership="none">
19613               <type name="File" c:type="GFile*"/>
19614             </parameter>
19615           </parameters>
19616         </callback>
19617       </field>
19618       <field name="prefix_matches">
19619         <callback name="prefix_matches">
19620           <return-value transfer-ownership="none">
19621             <doc xml:whitespace="preserve">%TRUE if the @files's parent, grandparent, etc is @prefix.</doc>
19622             <type name="gboolean" c:type="gboolean"/>
19623           </return-value>
19624           <parameters>
19625             <parameter name="prefix" transfer-ownership="none">
19626               <type name="File" c:type="GFile*"/>
19627             </parameter>
19628             <parameter name="file" transfer-ownership="none">
19629               <doc xml:whitespace="preserve">input #GFile.</doc>
19630               <type name="File" c:type="GFile*"/>
19631             </parameter>
19632           </parameters>
19633         </callback>
19634       </field>
19635       <field name="get_relative_path">
19636         <callback name="get_relative_path">
19637           <return-value transfer-ownership="full">
19638             <doc xml:whitespace="preserve">string with the relative path from @descendant</doc>
19639             <type name="utf8" c:type="char*"/>
19640           </return-value>
19641           <parameters>
19642             <parameter name="parent" transfer-ownership="none">
19643               <type name="File" c:type="GFile*"/>
19644             </parameter>
19645             <parameter name="descendant" transfer-ownership="none">
19646               <doc xml:whitespace="preserve">input #GFile.</doc>
19647               <type name="File" c:type="GFile*"/>
19648             </parameter>
19649           </parameters>
19650         </callback>
19651       </field>
19652       <field name="resolve_relative_path">
19653         <callback name="resolve_relative_path">
19654           <return-value transfer-ownership="full">
19655             <doc xml:whitespace="preserve">#GFile to the resolved path. %NULL if @relative_path</doc>
19656             <type name="File" c:type="GFile*"/>
19657           </return-value>
19658           <parameters>
19659             <parameter name="file" transfer-ownership="none">
19660               <type name="File" c:type="GFile*"/>
19661             </parameter>
19662             <parameter name="relative_path" transfer-ownership="none">
19663               <doc xml:whitespace="preserve">a given relative path string.</doc>
19664               <type name="utf8" c:type="char*"/>
19665             </parameter>
19666           </parameters>
19667         </callback>
19668       </field>
19669       <field name="get_child_for_display_name">
19670         <callback name="get_child_for_display_name" throws="1">
19671           <return-value transfer-ownership="full">
19672             <doc xml:whitespace="preserve">a #GFile to the specified child, or</doc>
19673             <type name="File" c:type="GFile*"/>
19674           </return-value>
19675           <parameters>
19676             <parameter name="file" transfer-ownership="none">
19677               <type name="File" c:type="GFile*"/>
19678             </parameter>
19679             <parameter name="display_name" transfer-ownership="none">
19680               <doc xml:whitespace="preserve">string to a possible child.</doc>
19681               <type name="utf8" c:type="char*"/>
19682             </parameter>
19683           </parameters>
19684         </callback>
19685       </field>
19686       <field name="enumerate_children">
19687         <callback name="enumerate_children" throws="1">
19688           <return-value transfer-ownership="full">
19689             <doc xml:whitespace="preserve">A #GFileEnumerator if successful, %NULL on error.</doc>
19690             <type name="FileEnumerator" c:type="GFileEnumerator*"/>
19691           </return-value>
19692           <parameters>
19693             <parameter name="file" transfer-ownership="none">
19694               <type name="File" c:type="GFile*"/>
19695             </parameter>
19696             <parameter name="attributes" transfer-ownership="none">
19697               <doc xml:whitespace="preserve">an attribute query string.</doc>
19698               <type name="utf8" c:type="char*"/>
19699             </parameter>
19700             <parameter name="flags" transfer-ownership="none">
19701               <doc xml:whitespace="preserve">a set of #GFileQueryInfoFlags.</doc>
19702               <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
19703             </parameter>
19704             <parameter name="cancellable"
19705                        transfer-ownership="none"
19706                        allow-none="1">
19707               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
19708               <type name="Cancellable" c:type="GCancellable*"/>
19709             </parameter>
19710           </parameters>
19711         </callback>
19712       </field>
19713       <field name="enumerate_children_async">
19714         <callback name="enumerate_children_async">
19715           <return-value transfer-ownership="none">
19716             <type name="none" c:type="void"/>
19717           </return-value>
19718           <parameters>
19719             <parameter name="file" transfer-ownership="none">
19720               <type name="File" c:type="GFile*"/>
19721             </parameter>
19722             <parameter name="attributes" transfer-ownership="none">
19723               <doc xml:whitespace="preserve">an attribute query string.</doc>
19724               <type name="utf8" c:type="char*"/>
19725             </parameter>
19726             <parameter name="flags" transfer-ownership="none">
19727               <doc xml:whitespace="preserve">a set of #GFileQueryInfoFlags.</doc>
19728               <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
19729             </parameter>
19730             <parameter name="io_priority" transfer-ownership="none">
19731               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
19732               <type name="gint" c:type="int"/>
19733             </parameter>
19734             <parameter name="cancellable"
19735                        transfer-ownership="none"
19736                        allow-none="1">
19737               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
19738               <type name="Cancellable" c:type="GCancellable*"/>
19739             </parameter>
19740             <parameter name="callback"
19741                        transfer-ownership="none"
19742                        scope="async"
19743                        closure="6">
19744               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
19745               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
19746             </parameter>
19747             <parameter name="user_data" transfer-ownership="none" closure="6">
19748               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
19749               <type name="gpointer" c:type="gpointer"/>
19750             </parameter>
19751           </parameters>
19752         </callback>
19753       </field>
19754       <field name="enumerate_children_finish">
19755         <callback name="enumerate_children_finish" throws="1">
19756           <return-value transfer-ownership="full">
19757             <doc xml:whitespace="preserve">a #GFileEnumerator or %NULL if an error occurred.</doc>
19758             <type name="FileEnumerator" c:type="GFileEnumerator*"/>
19759           </return-value>
19760           <parameters>
19761             <parameter name="file" transfer-ownership="none">
19762               <type name="File" c:type="GFile*"/>
19763             </parameter>
19764             <parameter name="res" transfer-ownership="none">
19765               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
19766               <type name="AsyncResult" c:type="GAsyncResult*"/>
19767             </parameter>
19768           </parameters>
19769         </callback>
19770       </field>
19771       <field name="query_info">
19772         <callback name="query_info" throws="1">
19773           <return-value transfer-ownership="full">
19774             <doc xml:whitespace="preserve">a #GFileInfo for the given @file, or %NULL on error.</doc>
19775             <type name="FileInfo" c:type="GFileInfo*"/>
19776           </return-value>
19777           <parameters>
19778             <parameter name="file" transfer-ownership="none">
19779               <type name="File" c:type="GFile*"/>
19780             </parameter>
19781             <parameter name="attributes" transfer-ownership="none">
19782               <doc xml:whitespace="preserve">an attribute query string.</doc>
19783               <type name="utf8" c:type="char*"/>
19784             </parameter>
19785             <parameter name="flags" transfer-ownership="none">
19786               <doc xml:whitespace="preserve">a set of #GFileQueryInfoFlags.</doc>
19787               <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
19788             </parameter>
19789             <parameter name="cancellable"
19790                        transfer-ownership="none"
19791                        allow-none="1">
19792               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
19793               <type name="Cancellable" c:type="GCancellable*"/>
19794             </parameter>
19795           </parameters>
19796         </callback>
19797       </field>
19798       <field name="query_info_async">
19799         <callback name="query_info_async">
19800           <return-value transfer-ownership="none">
19801             <type name="none" c:type="void"/>
19802           </return-value>
19803           <parameters>
19804             <parameter name="file" transfer-ownership="none">
19805               <type name="File" c:type="GFile*"/>
19806             </parameter>
19807             <parameter name="attributes" transfer-ownership="none">
19808               <doc xml:whitespace="preserve">an attribute query string.</doc>
19809               <type name="utf8" c:type="char*"/>
19810             </parameter>
19811             <parameter name="flags" transfer-ownership="none">
19812               <doc xml:whitespace="preserve">a set of #GFileQueryInfoFlags.</doc>
19813               <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
19814             </parameter>
19815             <parameter name="io_priority" transfer-ownership="none">
19816               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
19817               <type name="gint" c:type="int"/>
19818             </parameter>
19819             <parameter name="cancellable"
19820                        transfer-ownership="none"
19821                        allow-none="1">
19822               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
19823               <type name="Cancellable" c:type="GCancellable*"/>
19824             </parameter>
19825             <parameter name="callback"
19826                        transfer-ownership="none"
19827                        scope="async"
19828                        closure="6">
19829               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
19830               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
19831             </parameter>
19832             <parameter name="user_data" transfer-ownership="none" closure="6">
19833               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
19834               <type name="gpointer" c:type="gpointer"/>
19835             </parameter>
19836           </parameters>
19837         </callback>
19838       </field>
19839       <field name="query_info_finish">
19840         <callback name="query_info_finish" throws="1">
19841           <return-value transfer-ownership="full">
19842             <doc xml:whitespace="preserve">#GFileInfo for given @file or %NULL on error.</doc>
19843             <type name="FileInfo" c:type="GFileInfo*"/>
19844           </return-value>
19845           <parameters>
19846             <parameter name="file" transfer-ownership="none">
19847               <type name="File" c:type="GFile*"/>
19848             </parameter>
19849             <parameter name="res" transfer-ownership="none">
19850               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
19851               <type name="AsyncResult" c:type="GAsyncResult*"/>
19852             </parameter>
19853           </parameters>
19854         </callback>
19855       </field>
19856       <field name="query_filesystem_info">
19857         <callback name="query_filesystem_info" throws="1">
19858           <return-value transfer-ownership="full">
19859             <doc xml:whitespace="preserve">a #GFileInfo or %NULL if there was an error.</doc>
19860             <type name="FileInfo" c:type="GFileInfo*"/>
19861           </return-value>
19862           <parameters>
19863             <parameter name="file" transfer-ownership="none">
19864               <type name="File" c:type="GFile*"/>
19865             </parameter>
19866             <parameter name="attributes" transfer-ownership="none">
19867               <doc xml:whitespace="preserve">an attribute query string.</doc>
19868               <type name="utf8" c:type="char*"/>
19869             </parameter>
19870             <parameter name="cancellable"
19871                        transfer-ownership="none"
19872                        allow-none="1">
19873               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
19874               <type name="Cancellable" c:type="GCancellable*"/>
19875             </parameter>
19876           </parameters>
19877         </callback>
19878       </field>
19879       <field name="query_filesystem_info_async">
19880         <callback name="query_filesystem_info_async">
19881           <return-value transfer-ownership="none">
19882             <type name="none" c:type="void"/>
19883           </return-value>
19884           <parameters>
19885             <parameter name="file" transfer-ownership="none">
19886               <type name="File" c:type="GFile*"/>
19887             </parameter>
19888             <parameter name="attributes" transfer-ownership="none">
19889               <doc xml:whitespace="preserve">an attribute query string.</doc>
19890               <type name="utf8" c:type="char*"/>
19891             </parameter>
19892             <parameter name="io_priority" transfer-ownership="none">
19893               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
19894               <type name="gint" c:type="int"/>
19895             </parameter>
19896             <parameter name="cancellable"
19897                        transfer-ownership="none"
19898                        allow-none="1">
19899               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
19900               <type name="Cancellable" c:type="GCancellable*"/>
19901             </parameter>
19902             <parameter name="callback"
19903                        transfer-ownership="none"
19904                        scope="async"
19905                        closure="5">
19906               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
19907               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
19908             </parameter>
19909             <parameter name="user_data" transfer-ownership="none" closure="5">
19910               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
19911               <type name="gpointer" c:type="gpointer"/>
19912             </parameter>
19913           </parameters>
19914         </callback>
19915       </field>
19916       <field name="query_filesystem_info_finish">
19917         <callback name="query_filesystem_info_finish" throws="1">
19918           <return-value transfer-ownership="full">
19919             <doc xml:whitespace="preserve">#GFileInfo for given @file or %NULL on error.</doc>
19920             <type name="FileInfo" c:type="GFileInfo*"/>
19921           </return-value>
19922           <parameters>
19923             <parameter name="file" transfer-ownership="none">
19924               <type name="File" c:type="GFile*"/>
19925             </parameter>
19926             <parameter name="res" transfer-ownership="none">
19927               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
19928               <type name="AsyncResult" c:type="GAsyncResult*"/>
19929             </parameter>
19930           </parameters>
19931         </callback>
19932       </field>
19933       <field name="find_enclosing_mount">
19934         <callback name="find_enclosing_mount" throws="1">
19935           <return-value transfer-ownership="full">
19936             <doc xml:whitespace="preserve">a #GMount where the @file is located or %NULL on error.</doc>
19937             <type name="Mount" c:type="GMount*"/>
19938           </return-value>
19939           <parameters>
19940             <parameter name="file" transfer-ownership="none">
19941               <type name="File" c:type="GFile*"/>
19942             </parameter>
19943             <parameter name="cancellable"
19944                        transfer-ownership="none"
19945                        allow-none="1">
19946               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
19947               <type name="Cancellable" c:type="GCancellable*"/>
19948             </parameter>
19949           </parameters>
19950         </callback>
19951       </field>
19952       <field name="find_enclosing_mount_async">
19953         <callback name="find_enclosing_mount_async">
19954           <return-value transfer-ownership="none">
19955             <type name="none" c:type="void"/>
19956           </return-value>
19957           <parameters>
19958             <parameter name="file" transfer-ownership="none">
19959               <type name="File" c:type="GFile*"/>
19960             </parameter>
19961             <parameter name="io_priority" transfer-ownership="none">
19962               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
19963               <type name="gint" c:type="int"/>
19964             </parameter>
19965             <parameter name="cancellable"
19966                        transfer-ownership="none"
19967                        allow-none="1">
19968               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
19969               <type name="Cancellable" c:type="GCancellable*"/>
19970             </parameter>
19971             <parameter name="callback"
19972                        transfer-ownership="none"
19973                        scope="async"
19974                        closure="4">
19975               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
19976               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
19977             </parameter>
19978             <parameter name="user_data" transfer-ownership="none" closure="4">
19979               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
19980               <type name="gpointer" c:type="gpointer"/>
19981             </parameter>
19982           </parameters>
19983         </callback>
19984       </field>
19985       <field name="find_enclosing_mount_finish">
19986         <callback name="find_enclosing_mount_finish" throws="1">
19987           <return-value transfer-ownership="full">
19988             <doc xml:whitespace="preserve">#GMount for given @file or %NULL on error.</doc>
19989             <type name="Mount" c:type="GMount*"/>
19990           </return-value>
19991           <parameters>
19992             <parameter name="file" transfer-ownership="none">
19993               <type name="File" c:type="GFile*"/>
19994             </parameter>
19995             <parameter name="res" transfer-ownership="none">
19996               <doc xml:whitespace="preserve">a #GAsyncResult</doc>
19997               <type name="AsyncResult" c:type="GAsyncResult*"/>
19998             </parameter>
19999           </parameters>
20000         </callback>
20001       </field>
20002       <field name="set_display_name">
20003         <callback name="set_display_name" throws="1">
20004           <return-value transfer-ownership="full">
20005             <doc xml:whitespace="preserve">a #GFile specifying what @file was renamed to, or %NULL</doc>
20006             <type name="File" c:type="GFile*"/>
20007           </return-value>
20008           <parameters>
20009             <parameter name="file" transfer-ownership="none">
20010               <type name="File" c:type="GFile*"/>
20011             </parameter>
20012             <parameter name="display_name" transfer-ownership="none">
20013               <doc xml:whitespace="preserve">a string.</doc>
20014               <type name="utf8" c:type="char*"/>
20015             </parameter>
20016             <parameter name="cancellable"
20017                        transfer-ownership="none"
20018                        allow-none="1">
20019               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20020               <type name="Cancellable" c:type="GCancellable*"/>
20021             </parameter>
20022           </parameters>
20023         </callback>
20024       </field>
20025       <field name="set_display_name_async">
20026         <callback name="set_display_name_async">
20027           <return-value transfer-ownership="none">
20028             <type name="none" c:type="void"/>
20029           </return-value>
20030           <parameters>
20031             <parameter name="file" transfer-ownership="none">
20032               <type name="File" c:type="GFile*"/>
20033             </parameter>
20034             <parameter name="display_name" transfer-ownership="none">
20035               <doc xml:whitespace="preserve">a string.</doc>
20036               <type name="utf8" c:type="char*"/>
20037             </parameter>
20038             <parameter name="io_priority" transfer-ownership="none">
20039               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
20040               <type name="gint" c:type="int"/>
20041             </parameter>
20042             <parameter name="cancellable"
20043                        transfer-ownership="none"
20044                        allow-none="1">
20045               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20046               <type name="Cancellable" c:type="GCancellable*"/>
20047             </parameter>
20048             <parameter name="callback"
20049                        transfer-ownership="none"
20050                        scope="async"
20051                        closure="5">
20052               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
20053               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
20054             </parameter>
20055             <parameter name="user_data" transfer-ownership="none" closure="5">
20056               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
20057               <type name="gpointer" c:type="gpointer"/>
20058             </parameter>
20059           </parameters>
20060         </callback>
20061       </field>
20062       <field name="set_display_name_finish">
20063         <callback name="set_display_name_finish" throws="1">
20064           <return-value transfer-ownership="full">
20065             <doc xml:whitespace="preserve">a #GFile or %NULL on error.</doc>
20066             <type name="File" c:type="GFile*"/>
20067           </return-value>
20068           <parameters>
20069             <parameter name="file" transfer-ownership="none">
20070               <type name="File" c:type="GFile*"/>
20071             </parameter>
20072             <parameter name="res" transfer-ownership="none">
20073               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
20074               <type name="AsyncResult" c:type="GAsyncResult*"/>
20075             </parameter>
20076           </parameters>
20077         </callback>
20078       </field>
20079       <field name="query_settable_attributes">
20080         <callback name="query_settable_attributes" throws="1">
20081           <return-value transfer-ownership="full">
20082             <doc xml:whitespace="preserve">a #GFileAttributeInfoList describing the settable attributes.</doc>
20083             <type name="FileAttributeInfoList"
20084                   c:type="GFileAttributeInfoList*"/>
20085           </return-value>
20086           <parameters>
20087             <parameter name="file" transfer-ownership="none">
20088               <type name="File" c:type="GFile*"/>
20089             </parameter>
20090             <parameter name="cancellable"
20091                        transfer-ownership="none"
20092                        allow-none="1">
20093               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20094               <type name="Cancellable" c:type="GCancellable*"/>
20095             </parameter>
20096           </parameters>
20097         </callback>
20098       </field>
20099       <field name="_query_settable_attributes_async" introspectable="0">
20100         <callback name="_query_settable_attributes_async">
20101           <return-value transfer-ownership="none">
20102             <type name="none" c:type="void"/>
20103           </return-value>
20104         </callback>
20105       </field>
20106       <field name="_query_settable_attributes_finish" introspectable="0">
20107         <callback name="_query_settable_attributes_finish">
20108           <return-value transfer-ownership="none">
20109             <type name="none" c:type="void"/>
20110           </return-value>
20111         </callback>
20112       </field>
20113       <field name="query_writable_namespaces">
20114         <callback name="query_writable_namespaces" throws="1">
20115           <return-value transfer-ownership="full">
20116             <doc xml:whitespace="preserve">a #GFileAttributeInfoList describing the writable namespaces.</doc>
20117             <type name="FileAttributeInfoList"
20118                   c:type="GFileAttributeInfoList*"/>
20119           </return-value>
20120           <parameters>
20121             <parameter name="file" transfer-ownership="none">
20122               <type name="File" c:type="GFile*"/>
20123             </parameter>
20124             <parameter name="cancellable"
20125                        transfer-ownership="none"
20126                        allow-none="1">
20127               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20128               <type name="Cancellable" c:type="GCancellable*"/>
20129             </parameter>
20130           </parameters>
20131         </callback>
20132       </field>
20133       <field name="_query_writable_namespaces_async" introspectable="0">
20134         <callback name="_query_writable_namespaces_async">
20135           <return-value transfer-ownership="none">
20136             <type name="none" c:type="void"/>
20137           </return-value>
20138         </callback>
20139       </field>
20140       <field name="_query_writable_namespaces_finish" introspectable="0">
20141         <callback name="_query_writable_namespaces_finish">
20142           <return-value transfer-ownership="none">
20143             <type name="none" c:type="void"/>
20144           </return-value>
20145         </callback>
20146       </field>
20147       <field name="set_attribute">
20148         <callback name="set_attribute" throws="1">
20149           <return-value transfer-ownership="none">
20150             <doc xml:whitespace="preserve">%TRUE if the attribute was set, %FALSE otherwise.</doc>
20151             <type name="gboolean" c:type="gboolean"/>
20152           </return-value>
20153           <parameters>
20154             <parameter name="file" transfer-ownership="none">
20155               <type name="File" c:type="GFile*"/>
20156             </parameter>
20157             <parameter name="attribute" transfer-ownership="none">
20158               <doc xml:whitespace="preserve">a string containing the attribute's name.</doc>
20159               <type name="utf8" c:type="char*"/>
20160             </parameter>
20161             <parameter name="type" transfer-ownership="none">
20162               <doc xml:whitespace="preserve">The type of the attribute</doc>
20163               <type name="FileAttributeType" c:type="GFileAttributeType"/>
20164             </parameter>
20165             <parameter name="value_p" transfer-ownership="none">
20166               <doc xml:whitespace="preserve">a pointer to the value (or the pointer itself if the type is a pointer type)</doc>
20167               <type name="gpointer" c:type="gpointer"/>
20168             </parameter>
20169             <parameter name="flags" transfer-ownership="none">
20170               <doc xml:whitespace="preserve">a set of #GFileQueryInfoFlags.</doc>
20171               <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
20172             </parameter>
20173             <parameter name="cancellable"
20174                        transfer-ownership="none"
20175                        allow-none="1">
20176               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20177               <type name="Cancellable" c:type="GCancellable*"/>
20178             </parameter>
20179           </parameters>
20180         </callback>
20181       </field>
20182       <field name="set_attributes_from_info">
20183         <callback name="set_attributes_from_info" throws="1">
20184           <return-value transfer-ownership="none">
20185             <doc xml:whitespace="preserve">%TRUE if there was any error, %FALSE otherwise.</doc>
20186             <type name="gboolean" c:type="gboolean"/>
20187           </return-value>
20188           <parameters>
20189             <parameter name="file" transfer-ownership="none">
20190               <type name="File" c:type="GFile*"/>
20191             </parameter>
20192             <parameter name="info" transfer-ownership="none">
20193               <doc xml:whitespace="preserve">a #GFileInfo.</doc>
20194               <type name="FileInfo" c:type="GFileInfo*"/>
20195             </parameter>
20196             <parameter name="flags" transfer-ownership="none">
20197               <doc xml:whitespace="preserve">#GFileQueryInfoFlags</doc>
20198               <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
20199             </parameter>
20200             <parameter name="cancellable"
20201                        transfer-ownership="none"
20202                        allow-none="1">
20203               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20204               <type name="Cancellable" c:type="GCancellable*"/>
20205             </parameter>
20206           </parameters>
20207         </callback>
20208       </field>
20209       <field name="set_attributes_async">
20210         <callback name="set_attributes_async">
20211           <return-value transfer-ownership="none">
20212             <type name="none" c:type="void"/>
20213           </return-value>
20214           <parameters>
20215             <parameter name="file" transfer-ownership="none">
20216               <type name="File" c:type="GFile*"/>
20217             </parameter>
20218             <parameter name="info" transfer-ownership="none">
20219               <doc xml:whitespace="preserve">a #GFileInfo.</doc>
20220               <type name="FileInfo" c:type="GFileInfo*"/>
20221             </parameter>
20222             <parameter name="flags" transfer-ownership="none">
20223               <doc xml:whitespace="preserve">a #GFileQueryInfoFlags.</doc>
20224               <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
20225             </parameter>
20226             <parameter name="io_priority" transfer-ownership="none">
20227               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
20228               <type name="gint" c:type="int"/>
20229             </parameter>
20230             <parameter name="cancellable"
20231                        transfer-ownership="none"
20232                        allow-none="1">
20233               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20234               <type name="Cancellable" c:type="GCancellable*"/>
20235             </parameter>
20236             <parameter name="callback"
20237                        transfer-ownership="none"
20238                        scope="async"
20239                        closure="6">
20240               <doc xml:whitespace="preserve">a #GAsyncReadyCallback.</doc>
20241               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
20242             </parameter>
20243             <parameter name="user_data" transfer-ownership="none" closure="6">
20244               <doc xml:whitespace="preserve">a #gpointer.</doc>
20245               <type name="gpointer" c:type="gpointer"/>
20246             </parameter>
20247           </parameters>
20248         </callback>
20249       </field>
20250       <field name="set_attributes_finish">
20251         <callback name="set_attributes_finish" throws="1">
20252           <return-value transfer-ownership="none">
20253             <doc xml:whitespace="preserve">%TRUE if the attributes were set correctly, %FALSE otherwise.</doc>
20254             <type name="gboolean" c:type="gboolean"/>
20255           </return-value>
20256           <parameters>
20257             <parameter name="file" transfer-ownership="none">
20258               <type name="File" c:type="GFile*"/>
20259             </parameter>
20260             <parameter name="result" transfer-ownership="none">
20261               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
20262               <type name="AsyncResult" c:type="GAsyncResult*"/>
20263             </parameter>
20264             <parameter name="info"
20265                        direction="out"
20266                        caller-allocates="0"
20267                        transfer-ownership="full">
20268               <doc xml:whitespace="preserve">a #GFileInfo.</doc>
20269               <type name="FileInfo" c:type="GFileInfo**"/>
20270             </parameter>
20271           </parameters>
20272         </callback>
20273       </field>
20274       <field name="read_fn">
20275         <callback name="read_fn" throws="1">
20276           <return-value transfer-ownership="full">
20277             <doc xml:whitespace="preserve">#GFileInputStream or %NULL on error.</doc>
20278             <type name="FileInputStream" c:type="GFileInputStream*"/>
20279           </return-value>
20280           <parameters>
20281             <parameter name="file" transfer-ownership="none">
20282               <type name="File" c:type="GFile*"/>
20283             </parameter>
20284             <parameter name="cancellable"
20285                        transfer-ownership="none"
20286                        allow-none="1">
20287               <doc xml:whitespace="preserve">a #GCancellable</doc>
20288               <type name="Cancellable" c:type="GCancellable*"/>
20289             </parameter>
20290           </parameters>
20291         </callback>
20292       </field>
20293       <field name="read_async">
20294         <callback name="read_async">
20295           <return-value transfer-ownership="none">
20296             <type name="none" c:type="void"/>
20297           </return-value>
20298           <parameters>
20299             <parameter name="file" transfer-ownership="none">
20300               <type name="File" c:type="GFile*"/>
20301             </parameter>
20302             <parameter name="io_priority" transfer-ownership="none">
20303               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
20304               <type name="gint" c:type="int"/>
20305             </parameter>
20306             <parameter name="cancellable"
20307                        transfer-ownership="none"
20308                        allow-none="1">
20309               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20310               <type name="Cancellable" c:type="GCancellable*"/>
20311             </parameter>
20312             <parameter name="callback"
20313                        transfer-ownership="none"
20314                        scope="async"
20315                        closure="4">
20316               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
20317               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
20318             </parameter>
20319             <parameter name="user_data" transfer-ownership="none" closure="4">
20320               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
20321               <type name="gpointer" c:type="gpointer"/>
20322             </parameter>
20323           </parameters>
20324         </callback>
20325       </field>
20326       <field name="read_finish">
20327         <callback name="read_finish" throws="1">
20328           <return-value transfer-ownership="full">
20329             <doc xml:whitespace="preserve">a #GFileInputStream or %NULL on error.</doc>
20330             <type name="FileInputStream" c:type="GFileInputStream*"/>
20331           </return-value>
20332           <parameters>
20333             <parameter name="file" transfer-ownership="none">
20334               <type name="File" c:type="GFile*"/>
20335             </parameter>
20336             <parameter name="res" transfer-ownership="none">
20337               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
20338               <type name="AsyncResult" c:type="GAsyncResult*"/>
20339             </parameter>
20340           </parameters>
20341         </callback>
20342       </field>
20343       <field name="append_to">
20344         <callback name="append_to" throws="1">
20345           <return-value transfer-ownership="full">
20346             <doc xml:whitespace="preserve">a #GFileOutputStream, or %NULL on error.</doc>
20347             <type name="FileOutputStream" c:type="GFileOutputStream*"/>
20348           </return-value>
20349           <parameters>
20350             <parameter name="file" transfer-ownership="none">
20351               <type name="File" c:type="GFile*"/>
20352             </parameter>
20353             <parameter name="flags" transfer-ownership="none">
20354               <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
20355               <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
20356             </parameter>
20357             <parameter name="cancellable"
20358                        transfer-ownership="none"
20359                        allow-none="1">
20360               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20361               <type name="Cancellable" c:type="GCancellable*"/>
20362             </parameter>
20363           </parameters>
20364         </callback>
20365       </field>
20366       <field name="append_to_async">
20367         <callback name="append_to_async">
20368           <return-value transfer-ownership="none">
20369             <type name="none" c:type="void"/>
20370           </return-value>
20371           <parameters>
20372             <parameter name="file" transfer-ownership="none">
20373               <type name="File" c:type="GFile*"/>
20374             </parameter>
20375             <parameter name="flags" transfer-ownership="none">
20376               <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
20377               <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
20378             </parameter>
20379             <parameter name="io_priority" transfer-ownership="none">
20380               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
20381               <type name="gint" c:type="int"/>
20382             </parameter>
20383             <parameter name="cancellable"
20384                        transfer-ownership="none"
20385                        allow-none="1">
20386               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20387               <type name="Cancellable" c:type="GCancellable*"/>
20388             </parameter>
20389             <parameter name="callback"
20390                        transfer-ownership="none"
20391                        scope="async"
20392                        closure="5">
20393               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
20394               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
20395             </parameter>
20396             <parameter name="user_data" transfer-ownership="none" closure="5">
20397               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
20398               <type name="gpointer" c:type="gpointer"/>
20399             </parameter>
20400           </parameters>
20401         </callback>
20402       </field>
20403       <field name="append_to_finish">
20404         <callback name="append_to_finish" throws="1">
20405           <return-value transfer-ownership="full">
20406             <doc xml:whitespace="preserve">a valid #GFileOutputStream or %NULL on error.</doc>
20407             <type name="FileOutputStream" c:type="GFileOutputStream*"/>
20408           </return-value>
20409           <parameters>
20410             <parameter name="file" transfer-ownership="none">
20411               <type name="File" c:type="GFile*"/>
20412             </parameter>
20413             <parameter name="res" transfer-ownership="none">
20414               <doc xml:whitespace="preserve">#GAsyncResult</doc>
20415               <type name="AsyncResult" c:type="GAsyncResult*"/>
20416             </parameter>
20417           </parameters>
20418         </callback>
20419       </field>
20420       <field name="create">
20421         <callback name="create" throws="1">
20422           <return-value transfer-ownership="full">
20423             <doc xml:whitespace="preserve">a #GFileOutputStream for the newly created file, or</doc>
20424             <type name="FileOutputStream" c:type="GFileOutputStream*"/>
20425           </return-value>
20426           <parameters>
20427             <parameter name="file" transfer-ownership="none">
20428               <type name="File" c:type="GFile*"/>
20429             </parameter>
20430             <parameter name="flags" transfer-ownership="none">
20431               <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
20432               <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
20433             </parameter>
20434             <parameter name="cancellable"
20435                        transfer-ownership="none"
20436                        allow-none="1">
20437               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20438               <type name="Cancellable" c:type="GCancellable*"/>
20439             </parameter>
20440           </parameters>
20441         </callback>
20442       </field>
20443       <field name="create_async">
20444         <callback name="create_async">
20445           <return-value transfer-ownership="none">
20446             <type name="none" c:type="void"/>
20447           </return-value>
20448           <parameters>
20449             <parameter name="file" transfer-ownership="none">
20450               <type name="File" c:type="GFile*"/>
20451             </parameter>
20452             <parameter name="flags" transfer-ownership="none">
20453               <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
20454               <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
20455             </parameter>
20456             <parameter name="io_priority" transfer-ownership="none">
20457               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
20458               <type name="gint" c:type="int"/>
20459             </parameter>
20460             <parameter name="cancellable"
20461                        transfer-ownership="none"
20462                        allow-none="1">
20463               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20464               <type name="Cancellable" c:type="GCancellable*"/>
20465             </parameter>
20466             <parameter name="callback"
20467                        transfer-ownership="none"
20468                        scope="async"
20469                        closure="5">
20470               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
20471               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
20472             </parameter>
20473             <parameter name="user_data" transfer-ownership="none" closure="5">
20474               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
20475               <type name="gpointer" c:type="gpointer"/>
20476             </parameter>
20477           </parameters>
20478         </callback>
20479       </field>
20480       <field name="create_finish">
20481         <callback name="create_finish" throws="1">
20482           <return-value transfer-ownership="full">
20483             <doc xml:whitespace="preserve">a #GFileOutputStream or %NULL on error.</doc>
20484             <type name="FileOutputStream" c:type="GFileOutputStream*"/>
20485           </return-value>
20486           <parameters>
20487             <parameter name="file" transfer-ownership="none">
20488               <type name="File" c:type="GFile*"/>
20489             </parameter>
20490             <parameter name="res" transfer-ownership="none">
20491               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
20492               <type name="AsyncResult" c:type="GAsyncResult*"/>
20493             </parameter>
20494           </parameters>
20495         </callback>
20496       </field>
20497       <field name="replace">
20498         <callback name="replace" throws="1">
20499           <return-value transfer-ownership="full">
20500             <doc xml:whitespace="preserve">a #GFileOutputStream or %NULL on error.</doc>
20501             <type name="FileOutputStream" c:type="GFileOutputStream*"/>
20502           </return-value>
20503           <parameters>
20504             <parameter name="file" transfer-ownership="none">
20505               <type name="File" c:type="GFile*"/>
20506             </parameter>
20507             <parameter name="etag" transfer-ownership="none" allow-none="1">
20508               <doc xml:whitespace="preserve">an optional &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for the current #GFile, or #NULL to ignore.</doc>
20509               <type name="utf8" c:type="char*"/>
20510             </parameter>
20511             <parameter name="make_backup" transfer-ownership="none">
20512               <doc xml:whitespace="preserve">%TRUE if a backup should be created.</doc>
20513               <type name="gboolean" c:type="gboolean"/>
20514             </parameter>
20515             <parameter name="flags" transfer-ownership="none">
20516               <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
20517               <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
20518             </parameter>
20519             <parameter name="cancellable"
20520                        transfer-ownership="none"
20521                        allow-none="1">
20522               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20523               <type name="Cancellable" c:type="GCancellable*"/>
20524             </parameter>
20525           </parameters>
20526         </callback>
20527       </field>
20528       <field name="replace_async">
20529         <callback name="replace_async">
20530           <return-value transfer-ownership="none">
20531             <type name="none" c:type="void"/>
20532           </return-value>
20533           <parameters>
20534             <parameter name="file" transfer-ownership="none">
20535               <type name="File" c:type="GFile*"/>
20536             </parameter>
20537             <parameter name="etag" transfer-ownership="none" allow-none="1">
20538               <doc xml:whitespace="preserve">an &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for the current #GFile, or NULL to ignore.</doc>
20539               <type name="utf8" c:type="char*"/>
20540             </parameter>
20541             <parameter name="make_backup" transfer-ownership="none">
20542               <doc xml:whitespace="preserve">%TRUE if a backup should be created.</doc>
20543               <type name="gboolean" c:type="gboolean"/>
20544             </parameter>
20545             <parameter name="flags" transfer-ownership="none">
20546               <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
20547               <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
20548             </parameter>
20549             <parameter name="io_priority" transfer-ownership="none">
20550               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
20551               <type name="gint" c:type="int"/>
20552             </parameter>
20553             <parameter name="cancellable"
20554                        transfer-ownership="none"
20555                        allow-none="1">
20556               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20557               <type name="Cancellable" c:type="GCancellable*"/>
20558             </parameter>
20559             <parameter name="callback"
20560                        transfer-ownership="none"
20561                        scope="async"
20562                        closure="7">
20563               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
20564               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
20565             </parameter>
20566             <parameter name="user_data" transfer-ownership="none" closure="7">
20567               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
20568               <type name="gpointer" c:type="gpointer"/>
20569             </parameter>
20570           </parameters>
20571         </callback>
20572       </field>
20573       <field name="replace_finish">
20574         <callback name="replace_finish" throws="1">
20575           <return-value transfer-ownership="full">
20576             <doc xml:whitespace="preserve">a #GFileOutputStream, or %NULL on error.</doc>
20577             <type name="FileOutputStream" c:type="GFileOutputStream*"/>
20578           </return-value>
20579           <parameters>
20580             <parameter name="file" transfer-ownership="none">
20581               <type name="File" c:type="GFile*"/>
20582             </parameter>
20583             <parameter name="res" transfer-ownership="none">
20584               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
20585               <type name="AsyncResult" c:type="GAsyncResult*"/>
20586             </parameter>
20587           </parameters>
20588         </callback>
20589       </field>
20590       <field name="delete_file">
20591         <callback name="delete_file" throws="1">
20592           <return-value transfer-ownership="none">
20593             <doc xml:whitespace="preserve">%TRUE if the file was deleted. %FALSE otherwise.</doc>
20594             <type name="gboolean" c:type="gboolean"/>
20595           </return-value>
20596           <parameters>
20597             <parameter name="file" transfer-ownership="none">
20598               <type name="File" c:type="GFile*"/>
20599             </parameter>
20600             <parameter name="cancellable"
20601                        transfer-ownership="none"
20602                        allow-none="1">
20603               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20604               <type name="Cancellable" c:type="GCancellable*"/>
20605             </parameter>
20606           </parameters>
20607         </callback>
20608       </field>
20609       <field name="_delete_file_async" introspectable="0">
20610         <callback name="_delete_file_async">
20611           <return-value transfer-ownership="none">
20612             <type name="none" c:type="void"/>
20613           </return-value>
20614         </callback>
20615       </field>
20616       <field name="_delete_file_finish" introspectable="0">
20617         <callback name="_delete_file_finish">
20618           <return-value transfer-ownership="none">
20619             <type name="none" c:type="void"/>
20620           </return-value>
20621         </callback>
20622       </field>
20623       <field name="trash">
20624         <callback name="trash" throws="1">
20625           <return-value transfer-ownership="none">
20626             <doc xml:whitespace="preserve">%TRUE on successful trash, %FALSE otherwise.</doc>
20627             <type name="gboolean" c:type="gboolean"/>
20628           </return-value>
20629           <parameters>
20630             <parameter name="file" transfer-ownership="none">
20631               <type name="File" c:type="GFile*"/>
20632             </parameter>
20633             <parameter name="cancellable"
20634                        transfer-ownership="none"
20635                        allow-none="1">
20636               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20637               <type name="Cancellable" c:type="GCancellable*"/>
20638             </parameter>
20639           </parameters>
20640         </callback>
20641       </field>
20642       <field name="_trash_async" introspectable="0">
20643         <callback name="_trash_async">
20644           <return-value transfer-ownership="none">
20645             <type name="none" c:type="void"/>
20646           </return-value>
20647         </callback>
20648       </field>
20649       <field name="_trash_finish" introspectable="0">
20650         <callback name="_trash_finish">
20651           <return-value transfer-ownership="none">
20652             <type name="none" c:type="void"/>
20653           </return-value>
20654         </callback>
20655       </field>
20656       <field name="make_directory">
20657         <callback name="make_directory" throws="1">
20658           <return-value transfer-ownership="none">
20659             <type name="gboolean" c:type="gboolean"/>
20660           </return-value>
20661           <parameters>
20662             <parameter name="file" transfer-ownership="none">
20663               <type name="File" c:type="GFile*"/>
20664             </parameter>
20665             <parameter name="cancellable"
20666                        transfer-ownership="none"
20667                        allow-none="1">
20668               <type name="Cancellable" c:type="GCancellable*"/>
20669             </parameter>
20670           </parameters>
20671         </callback>
20672       </field>
20673       <field name="_make_directory_async" introspectable="0">
20674         <callback name="_make_directory_async">
20675           <return-value transfer-ownership="none">
20676             <type name="none" c:type="void"/>
20677           </return-value>
20678         </callback>
20679       </field>
20680       <field name="_make_directory_finish" introspectable="0">
20681         <callback name="_make_directory_finish">
20682           <return-value transfer-ownership="none">
20683             <type name="none" c:type="void"/>
20684           </return-value>
20685         </callback>
20686       </field>
20687       <field name="make_symbolic_link">
20688         <callback name="make_symbolic_link" throws="1">
20689           <return-value transfer-ownership="none">
20690             <doc xml:whitespace="preserve">%TRUE on the creation of a new symlink, %FALSE otherwise.</doc>
20691             <type name="gboolean" c:type="gboolean"/>
20692           </return-value>
20693           <parameters>
20694             <parameter name="file" transfer-ownership="none">
20695               <type name="File" c:type="GFile*"/>
20696             </parameter>
20697             <parameter name="symlink_value" transfer-ownership="none">
20698               <doc xml:whitespace="preserve">a string with the path for the target of the new symlink</doc>
20699               <type name="utf8" c:type="char*"/>
20700             </parameter>
20701             <parameter name="cancellable"
20702                        transfer-ownership="none"
20703                        allow-none="1">
20704               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20705               <type name="Cancellable" c:type="GCancellable*"/>
20706             </parameter>
20707           </parameters>
20708         </callback>
20709       </field>
20710       <field name="_make_symbolic_link_async" introspectable="0">
20711         <callback name="_make_symbolic_link_async">
20712           <return-value transfer-ownership="none">
20713             <type name="none" c:type="void"/>
20714           </return-value>
20715         </callback>
20716       </field>
20717       <field name="_make_symbolic_link_finish" introspectable="0">
20718         <callback name="_make_symbolic_link_finish">
20719           <return-value transfer-ownership="none">
20720             <type name="none" c:type="void"/>
20721           </return-value>
20722         </callback>
20723       </field>
20724       <field name="copy" introspectable="0">
20725         <callback name="copy" introspectable="0" throws="1">
20726           <return-value transfer-ownership="none">
20727             <doc xml:whitespace="preserve">%TRUE on success, %FALSE otherwise.</doc>
20728             <type name="gboolean" c:type="gboolean"/>
20729           </return-value>
20730           <parameters>
20731             <parameter name="source" transfer-ownership="none">
20732               <type name="File" c:type="GFile*"/>
20733             </parameter>
20734             <parameter name="destination" transfer-ownership="none">
20735               <doc xml:whitespace="preserve">destination #GFile</doc>
20736               <type name="File" c:type="GFile*"/>
20737             </parameter>
20738             <parameter name="flags" transfer-ownership="none">
20739               <doc xml:whitespace="preserve">set of #GFileCopyFlags</doc>
20740               <type name="FileCopyFlags" c:type="GFileCopyFlags"/>
20741             </parameter>
20742             <parameter name="cancellable"
20743                        transfer-ownership="none"
20744                        allow-none="1">
20745               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20746               <type name="Cancellable" c:type="GCancellable*"/>
20747             </parameter>
20748             <parameter name="progress_callback"
20749                        transfer-ownership="none"
20750                        closure="5">
20751               <doc xml:whitespace="preserve">function to callback with progress information</doc>
20752               <type name="FileProgressCallback"
20753                     c:type="GFileProgressCallback"/>
20754             </parameter>
20755             <parameter name="progress_callback_data" transfer-ownership="none">
20756               <doc xml:whitespace="preserve">user data to pass to @progress_callback</doc>
20757               <type name="gpointer" c:type="gpointer"/>
20758             </parameter>
20759           </parameters>
20760         </callback>
20761       </field>
20762       <field name="copy_async" introspectable="0">
20763         <callback name="copy_async" introspectable="0">
20764           <return-value transfer-ownership="none">
20765             <type name="none" c:type="void"/>
20766           </return-value>
20767           <parameters>
20768             <parameter name="source" transfer-ownership="none">
20769               <type name="File" c:type="GFile*"/>
20770             </parameter>
20771             <parameter name="destination" transfer-ownership="none">
20772               <doc xml:whitespace="preserve">destination #GFile</doc>
20773               <type name="File" c:type="GFile*"/>
20774             </parameter>
20775             <parameter name="flags" transfer-ownership="none">
20776               <doc xml:whitespace="preserve">set of #GFileCopyFlags</doc>
20777               <type name="FileCopyFlags" c:type="GFileCopyFlags"/>
20778             </parameter>
20779             <parameter name="io_priority" transfer-ownership="none">
20780               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
20781               <type name="gint" c:type="int"/>
20782             </parameter>
20783             <parameter name="cancellable"
20784                        transfer-ownership="none"
20785                        allow-none="1">
20786               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20787               <type name="Cancellable" c:type="GCancellable*"/>
20788             </parameter>
20789             <parameter name="progress_callback"
20790                        transfer-ownership="none"
20791                        closure="6">
20792               <doc xml:whitespace="preserve">function to callback with progress information</doc>
20793               <type name="FileProgressCallback"
20794                     c:type="GFileProgressCallback"/>
20795             </parameter>
20796             <parameter name="progress_callback_data" transfer-ownership="none">
20797               <doc xml:whitespace="preserve">user data to pass to @progress_callback</doc>
20798               <type name="gpointer" c:type="gpointer"/>
20799             </parameter>
20800             <parameter name="callback"
20801                        transfer-ownership="none"
20802                        scope="async"
20803                        closure="8">
20804               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
20805               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
20806             </parameter>
20807             <parameter name="user_data" transfer-ownership="none" closure="8">
20808               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
20809               <type name="gpointer" c:type="gpointer"/>
20810             </parameter>
20811           </parameters>
20812         </callback>
20813       </field>
20814       <field name="copy_finish">
20815         <callback name="copy_finish" throws="1">
20816           <return-value transfer-ownership="none">
20817             <doc xml:whitespace="preserve">a %TRUE on success, %FALSE on error.</doc>
20818             <type name="gboolean" c:type="gboolean"/>
20819           </return-value>
20820           <parameters>
20821             <parameter name="file" transfer-ownership="none">
20822               <type name="File" c:type="GFile*"/>
20823             </parameter>
20824             <parameter name="res" transfer-ownership="none">
20825               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
20826               <type name="AsyncResult" c:type="GAsyncResult*"/>
20827             </parameter>
20828           </parameters>
20829         </callback>
20830       </field>
20831       <field name="move" introspectable="0">
20832         <callback name="move" introspectable="0" throws="1">
20833           <return-value transfer-ownership="none">
20834             <doc xml:whitespace="preserve">%TRUE on successful move, %FALSE otherwise.</doc>
20835             <type name="gboolean" c:type="gboolean"/>
20836           </return-value>
20837           <parameters>
20838             <parameter name="source" transfer-ownership="none">
20839               <type name="File" c:type="GFile*"/>
20840             </parameter>
20841             <parameter name="destination" transfer-ownership="none">
20842               <doc xml:whitespace="preserve">#GFile pointing to the destination location.</doc>
20843               <type name="File" c:type="GFile*"/>
20844             </parameter>
20845             <parameter name="flags" transfer-ownership="none">
20846               <doc xml:whitespace="preserve">set of #GFileCopyFlags.</doc>
20847               <type name="FileCopyFlags" c:type="GFileCopyFlags"/>
20848             </parameter>
20849             <parameter name="cancellable"
20850                        transfer-ownership="none"
20851                        allow-none="1">
20852               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20853               <type name="Cancellable" c:type="GCancellable*"/>
20854             </parameter>
20855             <parameter name="progress_callback"
20856                        transfer-ownership="none"
20857                        closure="5">
20858               <doc xml:whitespace="preserve">#GFileProgressCallback function for updates.</doc>
20859               <type name="FileProgressCallback"
20860                     c:type="GFileProgressCallback"/>
20861             </parameter>
20862             <parameter name="progress_callback_data" transfer-ownership="none">
20863               <doc xml:whitespace="preserve">gpointer to user data for the callback function.</doc>
20864               <type name="gpointer" c:type="gpointer"/>
20865             </parameter>
20866           </parameters>
20867         </callback>
20868       </field>
20869       <field name="_move_async" introspectable="0">
20870         <callback name="_move_async">
20871           <return-value transfer-ownership="none">
20872             <type name="none" c:type="void"/>
20873           </return-value>
20874         </callback>
20875       </field>
20876       <field name="_move_finish" introspectable="0">
20877         <callback name="_move_finish">
20878           <return-value transfer-ownership="none">
20879             <type name="none" c:type="void"/>
20880           </return-value>
20881         </callback>
20882       </field>
20883       <field name="mount_mountable">
20884         <callback name="mount_mountable">
20885           <return-value transfer-ownership="none">
20886             <type name="none" c:type="void"/>
20887           </return-value>
20888           <parameters>
20889             <parameter name="file" transfer-ownership="none">
20890               <type name="File" c:type="GFile*"/>
20891             </parameter>
20892             <parameter name="flags" transfer-ownership="none">
20893               <doc xml:whitespace="preserve">flags affecting the operation</doc>
20894               <type name="MountMountFlags" c:type="GMountMountFlags"/>
20895             </parameter>
20896             <parameter name="mount_operation" transfer-ownership="none">
20897               <doc xml:whitespace="preserve">a #GMountOperation, or %NULL to avoid user interaction.</doc>
20898               <type name="MountOperation" c:type="GMountOperation*"/>
20899             </parameter>
20900             <parameter name="cancellable"
20901                        transfer-ownership="none"
20902                        allow-none="1">
20903               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20904               <type name="Cancellable" c:type="GCancellable*"/>
20905             </parameter>
20906             <parameter name="callback"
20907                        transfer-ownership="none"
20908                        scope="async"
20909                        closure="5">
20910               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
20911               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
20912             </parameter>
20913             <parameter name="user_data" transfer-ownership="none" closure="5">
20914               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
20915               <type name="gpointer" c:type="gpointer"/>
20916             </parameter>
20917           </parameters>
20918         </callback>
20919       </field>
20920       <field name="mount_mountable_finish">
20921         <callback name="mount_mountable_finish" throws="1">
20922           <return-value transfer-ownership="full">
20923             <doc xml:whitespace="preserve">a #GFile or %NULL on error.</doc>
20924             <type name="File" c:type="GFile*"/>
20925           </return-value>
20926           <parameters>
20927             <parameter name="file" transfer-ownership="none">
20928               <type name="File" c:type="GFile*"/>
20929             </parameter>
20930             <parameter name="result" transfer-ownership="none">
20931               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
20932               <type name="AsyncResult" c:type="GAsyncResult*"/>
20933             </parameter>
20934           </parameters>
20935         </callback>
20936       </field>
20937       <field name="unmount_mountable">
20938         <callback name="unmount_mountable">
20939           <return-value transfer-ownership="none">
20940             <type name="none" c:type="void"/>
20941           </return-value>
20942           <parameters>
20943             <parameter name="file" transfer-ownership="none">
20944               <type name="File" c:type="GFile*"/>
20945             </parameter>
20946             <parameter name="flags" transfer-ownership="none">
20947               <doc xml:whitespace="preserve">flags affecting the operation</doc>
20948               <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
20949             </parameter>
20950             <parameter name="cancellable"
20951                        transfer-ownership="none"
20952                        allow-none="1">
20953               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
20954               <type name="Cancellable" c:type="GCancellable*"/>
20955             </parameter>
20956             <parameter name="callback"
20957                        transfer-ownership="none"
20958                        scope="async"
20959                        closure="4">
20960               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
20961               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
20962             </parameter>
20963             <parameter name="user_data" transfer-ownership="none" closure="4">
20964               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
20965               <type name="gpointer" c:type="gpointer"/>
20966             </parameter>
20967           </parameters>
20968         </callback>
20969       </field>
20970       <field name="unmount_mountable_finish">
20971         <callback name="unmount_mountable_finish" throws="1">
20972           <return-value transfer-ownership="none">
20973             <doc xml:whitespace="preserve">%TRUE if the operation finished successfully. %FALSE</doc>
20974             <type name="gboolean" c:type="gboolean"/>
20975           </return-value>
20976           <parameters>
20977             <parameter name="file" transfer-ownership="none">
20978               <type name="File" c:type="GFile*"/>
20979             </parameter>
20980             <parameter name="result" transfer-ownership="none">
20981               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
20982               <type name="AsyncResult" c:type="GAsyncResult*"/>
20983             </parameter>
20984           </parameters>
20985         </callback>
20986       </field>
20987       <field name="eject_mountable">
20988         <callback name="eject_mountable">
20989           <return-value transfer-ownership="none">
20990             <type name="none" c:type="void"/>
20991           </return-value>
20992           <parameters>
20993             <parameter name="file" transfer-ownership="none">
20994               <type name="File" c:type="GFile*"/>
20995             </parameter>
20996             <parameter name="flags" transfer-ownership="none">
20997               <doc xml:whitespace="preserve">flags affecting the operation</doc>
20998               <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
20999             </parameter>
21000             <parameter name="cancellable"
21001                        transfer-ownership="none"
21002                        allow-none="1">
21003               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
21004               <type name="Cancellable" c:type="GCancellable*"/>
21005             </parameter>
21006             <parameter name="callback"
21007                        transfer-ownership="none"
21008                        scope="async"
21009                        closure="4">
21010               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
21011               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
21012             </parameter>
21013             <parameter name="user_data" transfer-ownership="none" closure="4">
21014               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
21015               <type name="gpointer" c:type="gpointer"/>
21016             </parameter>
21017           </parameters>
21018         </callback>
21019       </field>
21020       <field name="eject_mountable_finish">
21021         <callback name="eject_mountable_finish" throws="1">
21022           <return-value transfer-ownership="none">
21023             <doc xml:whitespace="preserve">%TRUE if the @file was ejected successfully. %FALSE</doc>
21024             <type name="gboolean" c:type="gboolean"/>
21025           </return-value>
21026           <parameters>
21027             <parameter name="file" transfer-ownership="none">
21028               <type name="File" c:type="GFile*"/>
21029             </parameter>
21030             <parameter name="result" transfer-ownership="none">
21031               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
21032               <type name="AsyncResult" c:type="GAsyncResult*"/>
21033             </parameter>
21034           </parameters>
21035         </callback>
21036       </field>
21037       <field name="mount_enclosing_volume">
21038         <callback name="mount_enclosing_volume">
21039           <return-value transfer-ownership="none">
21040             <type name="none" c:type="void"/>
21041           </return-value>
21042           <parameters>
21043             <parameter name="location" transfer-ownership="none">
21044               <type name="File" c:type="GFile*"/>
21045             </parameter>
21046             <parameter name="flags" transfer-ownership="none">
21047               <doc xml:whitespace="preserve">flags affecting the operation</doc>
21048               <type name="MountMountFlags" c:type="GMountMountFlags"/>
21049             </parameter>
21050             <parameter name="mount_operation" transfer-ownership="none">
21051               <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
21052               <type name="MountOperation" c:type="GMountOperation*"/>
21053             </parameter>
21054             <parameter name="cancellable"
21055                        transfer-ownership="none"
21056                        allow-none="1">
21057               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
21058               <type name="Cancellable" c:type="GCancellable*"/>
21059             </parameter>
21060             <parameter name="callback"
21061                        transfer-ownership="none"
21062                        scope="async"
21063                        closure="5">
21064               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
21065               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
21066             </parameter>
21067             <parameter name="user_data" transfer-ownership="none" closure="5">
21068               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
21069               <type name="gpointer" c:type="gpointer"/>
21070             </parameter>
21071           </parameters>
21072         </callback>
21073       </field>
21074       <field name="mount_enclosing_volume_finish">
21075         <callback name="mount_enclosing_volume_finish" throws="1">
21076           <return-value transfer-ownership="none">
21077             <doc xml:whitespace="preserve">%TRUE if successful. If an error</doc>
21078             <type name="gboolean" c:type="gboolean"/>
21079           </return-value>
21080           <parameters>
21081             <parameter name="location" transfer-ownership="none">
21082               <type name="File" c:type="GFile*"/>
21083             </parameter>
21084             <parameter name="result" transfer-ownership="none">
21085               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
21086               <type name="AsyncResult" c:type="GAsyncResult*"/>
21087             </parameter>
21088           </parameters>
21089         </callback>
21090       </field>
21091       <field name="monitor_dir">
21092         <callback name="monitor_dir" throws="1">
21093           <return-value transfer-ownership="full">
21094             <doc xml:whitespace="preserve">a #GFileMonitor for the given @file, or %NULL on error.</doc>
21095             <type name="FileMonitor" c:type="GFileMonitor*"/>
21096           </return-value>
21097           <parameters>
21098             <parameter name="file" transfer-ownership="none">
21099               <type name="File" c:type="GFile*"/>
21100             </parameter>
21101             <parameter name="flags" transfer-ownership="none">
21102               <doc xml:whitespace="preserve">a set of #GFileMonitorFlags.</doc>
21103               <type name="FileMonitorFlags" c:type="GFileMonitorFlags"/>
21104             </parameter>
21105             <parameter name="cancellable"
21106                        transfer-ownership="none"
21107                        allow-none="1">
21108               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
21109               <type name="Cancellable" c:type="GCancellable*"/>
21110             </parameter>
21111           </parameters>
21112         </callback>
21113       </field>
21114       <field name="monitor_file">
21115         <callback name="monitor_file" throws="1">
21116           <return-value transfer-ownership="full">
21117             <doc xml:whitespace="preserve">a #GFileMonitor for the given @file, or %NULL on error.</doc>
21118             <type name="FileMonitor" c:type="GFileMonitor*"/>
21119           </return-value>
21120           <parameters>
21121             <parameter name="file" transfer-ownership="none">
21122               <type name="File" c:type="GFile*"/>
21123             </parameter>
21124             <parameter name="flags" transfer-ownership="none">
21125               <doc xml:whitespace="preserve">a set of #GFileMonitorFlags.</doc>
21126               <type name="FileMonitorFlags" c:type="GFileMonitorFlags"/>
21127             </parameter>
21128             <parameter name="cancellable"
21129                        transfer-ownership="none"
21130                        allow-none="1">
21131               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
21132               <type name="Cancellable" c:type="GCancellable*"/>
21133             </parameter>
21134           </parameters>
21135         </callback>
21136       </field>
21137       <field name="open_readwrite">
21138         <callback name="open_readwrite" throws="1">
21139           <return-value transfer-ownership="full">
21140             <doc xml:whitespace="preserve">#GFileIOStream or %NULL on error.</doc>
21141             <type name="FileIOStream" c:type="GFileIOStream*"/>
21142           </return-value>
21143           <parameters>
21144             <parameter name="file" transfer-ownership="none">
21145               <type name="File" c:type="GFile*"/>
21146             </parameter>
21147             <parameter name="cancellable"
21148                        transfer-ownership="none"
21149                        allow-none="1">
21150               <doc xml:whitespace="preserve">a #GCancellable</doc>
21151               <type name="Cancellable" c:type="GCancellable*"/>
21152             </parameter>
21153           </parameters>
21154         </callback>
21155       </field>
21156       <field name="open_readwrite_async">
21157         <callback name="open_readwrite_async">
21158           <return-value transfer-ownership="none">
21159             <type name="none" c:type="void"/>
21160           </return-value>
21161           <parameters>
21162             <parameter name="file" transfer-ownership="none">
21163               <type name="File" c:type="GFile*"/>
21164             </parameter>
21165             <parameter name="io_priority" transfer-ownership="none">
21166               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
21167               <type name="gint" c:type="int"/>
21168             </parameter>
21169             <parameter name="cancellable"
21170                        transfer-ownership="none"
21171                        allow-none="1">
21172               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
21173               <type name="Cancellable" c:type="GCancellable*"/>
21174             </parameter>
21175             <parameter name="callback"
21176                        transfer-ownership="none"
21177                        scope="async"
21178                        closure="4">
21179               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
21180               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
21181             </parameter>
21182             <parameter name="user_data" transfer-ownership="none" closure="4">
21183               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
21184               <type name="gpointer" c:type="gpointer"/>
21185             </parameter>
21186           </parameters>
21187         </callback>
21188       </field>
21189       <field name="open_readwrite_finish">
21190         <callback name="open_readwrite_finish" throws="1">
21191           <return-value transfer-ownership="full">
21192             <doc xml:whitespace="preserve">a #GFileIOStream or %NULL on error.</doc>
21193             <type name="FileIOStream" c:type="GFileIOStream*"/>
21194           </return-value>
21195           <parameters>
21196             <parameter name="file" transfer-ownership="none">
21197               <type name="File" c:type="GFile*"/>
21198             </parameter>
21199             <parameter name="res" transfer-ownership="none">
21200               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
21201               <type name="AsyncResult" c:type="GAsyncResult*"/>
21202             </parameter>
21203           </parameters>
21204         </callback>
21205       </field>
21206       <field name="create_readwrite">
21207         <callback name="create_readwrite" throws="1">
21208           <return-value transfer-ownership="full">
21209             <doc xml:whitespace="preserve">a #GFileIOStream for the newly created file, or %NULL on error.</doc>
21210             <type name="FileIOStream" c:type="GFileIOStream*"/>
21211           </return-value>
21212           <parameters>
21213             <parameter name="file" transfer-ownership="none">
21214               <type name="File" c:type="GFile*"/>
21215             </parameter>
21216             <parameter name="flags" transfer-ownership="none">
21217               <doc xml:whitespace="preserve">a set of #GFileCreateFlags</doc>
21218               <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
21219             </parameter>
21220             <parameter name="cancellable"
21221                        transfer-ownership="none"
21222                        allow-none="1">
21223               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
21224               <type name="Cancellable" c:type="GCancellable*"/>
21225             </parameter>
21226           </parameters>
21227         </callback>
21228       </field>
21229       <field name="create_readwrite_async">
21230         <callback name="create_readwrite_async">
21231           <return-value transfer-ownership="none">
21232             <type name="none" c:type="void"/>
21233           </return-value>
21234           <parameters>
21235             <parameter name="file" transfer-ownership="none">
21236               <type name="File" c:type="GFile*"/>
21237             </parameter>
21238             <parameter name="flags" transfer-ownership="none">
21239               <doc xml:whitespace="preserve">a set of #GFileCreateFlags</doc>
21240               <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
21241             </parameter>
21242             <parameter name="io_priority" transfer-ownership="none">
21243               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request</doc>
21244               <type name="gint" c:type="int"/>
21245             </parameter>
21246             <parameter name="cancellable"
21247                        transfer-ownership="none"
21248                        allow-none="1">
21249               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
21250               <type name="Cancellable" c:type="GCancellable*"/>
21251             </parameter>
21252             <parameter name="callback"
21253                        transfer-ownership="none"
21254                        scope="async"
21255                        closure="5">
21256               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
21257               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
21258             </parameter>
21259             <parameter name="user_data" transfer-ownership="none" closure="5">
21260               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
21261               <type name="gpointer" c:type="gpointer"/>
21262             </parameter>
21263           </parameters>
21264         </callback>
21265       </field>
21266       <field name="create_readwrite_finish">
21267         <callback name="create_readwrite_finish" throws="1">
21268           <return-value transfer-ownership="full">
21269             <doc xml:whitespace="preserve">a #GFileIOStream or %NULL on error.</doc>
21270             <type name="FileIOStream" c:type="GFileIOStream*"/>
21271           </return-value>
21272           <parameters>
21273             <parameter name="file" transfer-ownership="none">
21274               <type name="File" c:type="GFile*"/>
21275             </parameter>
21276             <parameter name="res" transfer-ownership="none">
21277               <doc xml:whitespace="preserve">a #GAsyncResult</doc>
21278               <type name="AsyncResult" c:type="GAsyncResult*"/>
21279             </parameter>
21280           </parameters>
21281         </callback>
21282       </field>
21283       <field name="replace_readwrite">
21284         <callback name="replace_readwrite" throws="1">
21285           <return-value transfer-ownership="full">
21286             <doc xml:whitespace="preserve">a #GFileIOStream or %NULL on error.</doc>
21287             <type name="FileIOStream" c:type="GFileIOStream*"/>
21288           </return-value>
21289           <parameters>
21290             <parameter name="file" transfer-ownership="none">
21291               <type name="File" c:type="GFile*"/>
21292             </parameter>
21293             <parameter name="etag" transfer-ownership="none" allow-none="1">
21294               <doc xml:whitespace="preserve">an optional &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for the current #GFile, or #NULL to ignore</doc>
21295               <type name="utf8" c:type="char*"/>
21296             </parameter>
21297             <parameter name="make_backup" transfer-ownership="none">
21298               <doc xml:whitespace="preserve">%TRUE if a backup should be created</doc>
21299               <type name="gboolean" c:type="gboolean"/>
21300             </parameter>
21301             <parameter name="flags" transfer-ownership="none">
21302               <doc xml:whitespace="preserve">a set of #GFileCreateFlags</doc>
21303               <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
21304             </parameter>
21305             <parameter name="cancellable"
21306                        transfer-ownership="none"
21307                        allow-none="1">
21308               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
21309               <type name="Cancellable" c:type="GCancellable*"/>
21310             </parameter>
21311           </parameters>
21312         </callback>
21313       </field>
21314       <field name="replace_readwrite_async">
21315         <callback name="replace_readwrite_async">
21316           <return-value transfer-ownership="none">
21317             <type name="none" c:type="void"/>
21318           </return-value>
21319           <parameters>
21320             <parameter name="file" transfer-ownership="none">
21321               <type name="File" c:type="GFile*"/>
21322             </parameter>
21323             <parameter name="etag" transfer-ownership="none" allow-none="1">
21324               <doc xml:whitespace="preserve">an &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for the current #GFile, or NULL to ignore.</doc>
21325               <type name="utf8" c:type="char*"/>
21326             </parameter>
21327             <parameter name="make_backup" transfer-ownership="none">
21328               <doc xml:whitespace="preserve">%TRUE if a backup should be created.</doc>
21329               <type name="gboolean" c:type="gboolean"/>
21330             </parameter>
21331             <parameter name="flags" transfer-ownership="none">
21332               <doc xml:whitespace="preserve">a set of #GFileCreateFlags.</doc>
21333               <type name="FileCreateFlags" c:type="GFileCreateFlags"/>
21334             </parameter>
21335             <parameter name="io_priority" transfer-ownership="none">
21336               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
21337               <type name="gint" c:type="int"/>
21338             </parameter>
21339             <parameter name="cancellable"
21340                        transfer-ownership="none"
21341                        allow-none="1">
21342               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
21343               <type name="Cancellable" c:type="GCancellable*"/>
21344             </parameter>
21345             <parameter name="callback"
21346                        transfer-ownership="none"
21347                        scope="async"
21348                        closure="7">
21349               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
21350               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
21351             </parameter>
21352             <parameter name="user_data" transfer-ownership="none" closure="7">
21353               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
21354               <type name="gpointer" c:type="gpointer"/>
21355             </parameter>
21356           </parameters>
21357         </callback>
21358       </field>
21359       <field name="replace_readwrite_finish">
21360         <callback name="replace_readwrite_finish" throws="1">
21361           <return-value transfer-ownership="full">
21362             <doc xml:whitespace="preserve">a #GFileIOStream, or %NULL on error.</doc>
21363             <type name="FileIOStream" c:type="GFileIOStream*"/>
21364           </return-value>
21365           <parameters>
21366             <parameter name="file" transfer-ownership="none">
21367               <type name="File" c:type="GFile*"/>
21368             </parameter>
21369             <parameter name="res" transfer-ownership="none">
21370               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
21371               <type name="AsyncResult" c:type="GAsyncResult*"/>
21372             </parameter>
21373           </parameters>
21374         </callback>
21375       </field>
21376       <field name="start_mountable">
21377         <callback name="start_mountable">
21378           <return-value transfer-ownership="none">
21379             <type name="none" c:type="void"/>
21380           </return-value>
21381           <parameters>
21382             <parameter name="file" transfer-ownership="none">
21383               <type name="File" c:type="GFile*"/>
21384             </parameter>
21385             <parameter name="flags" transfer-ownership="none">
21386               <doc xml:whitespace="preserve">flags affecting the operation</doc>
21387               <type name="DriveStartFlags" c:type="GDriveStartFlags"/>
21388             </parameter>
21389             <parameter name="start_operation" transfer-ownership="none">
21390               <doc xml:whitespace="preserve">a #GMountOperation, or %NULL to avoid user interaction.</doc>
21391               <type name="MountOperation" c:type="GMountOperation*"/>
21392             </parameter>
21393             <parameter name="cancellable"
21394                        transfer-ownership="none"
21395                        allow-none="1">
21396               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
21397               <type name="Cancellable" c:type="GCancellable*"/>
21398             </parameter>
21399             <parameter name="callback"
21400                        transfer-ownership="none"
21401                        scope="async"
21402                        closure="5">
21403               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
21404               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
21405             </parameter>
21406             <parameter name="user_data" transfer-ownership="none" closure="5">
21407               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
21408               <type name="gpointer" c:type="gpointer"/>
21409             </parameter>
21410           </parameters>
21411         </callback>
21412       </field>
21413       <field name="start_mountable_finish">
21414         <callback name="start_mountable_finish" throws="1">
21415           <return-value transfer-ownership="none">
21416             <doc xml:whitespace="preserve">%TRUE if the operation finished successfully. %FALSE</doc>
21417             <type name="gboolean" c:type="gboolean"/>
21418           </return-value>
21419           <parameters>
21420             <parameter name="file" transfer-ownership="none">
21421               <type name="File" c:type="GFile*"/>
21422             </parameter>
21423             <parameter name="result" transfer-ownership="none">
21424               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
21425               <type name="AsyncResult" c:type="GAsyncResult*"/>
21426             </parameter>
21427           </parameters>
21428         </callback>
21429       </field>
21430       <field name="stop_mountable">
21431         <callback name="stop_mountable">
21432           <return-value transfer-ownership="none">
21433             <type name="none" c:type="void"/>
21434           </return-value>
21435           <parameters>
21436             <parameter name="file" transfer-ownership="none">
21437               <type name="File" c:type="GFile*"/>
21438             </parameter>
21439             <parameter name="flags" transfer-ownership="none">
21440               <doc xml:whitespace="preserve">flags affecting the operation</doc>
21441               <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
21442             </parameter>
21443             <parameter name="mount_operation" transfer-ownership="none">
21444               <doc xml:whitespace="preserve">a #GMountOperation, or %NULL to avoid user interaction.</doc>
21445               <type name="MountOperation" c:type="GMountOperation*"/>
21446             </parameter>
21447             <parameter name="cancellable"
21448                        transfer-ownership="none"
21449                        allow-none="1">
21450               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
21451               <type name="Cancellable" c:type="GCancellable*"/>
21452             </parameter>
21453             <parameter name="callback"
21454                        transfer-ownership="none"
21455                        scope="async"
21456                        closure="5">
21457               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
21458               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
21459             </parameter>
21460             <parameter name="user_data" transfer-ownership="none" closure="5">
21461               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
21462               <type name="gpointer" c:type="gpointer"/>
21463             </parameter>
21464           </parameters>
21465         </callback>
21466       </field>
21467       <field name="stop_mountable_finish">
21468         <callback name="stop_mountable_finish" throws="1">
21469           <return-value transfer-ownership="none">
21470             <doc xml:whitespace="preserve">%TRUE if the operation finished successfully. %FALSE</doc>
21471             <type name="gboolean" c:type="gboolean"/>
21472           </return-value>
21473           <parameters>
21474             <parameter name="file" transfer-ownership="none">
21475               <type name="File" c:type="GFile*"/>
21476             </parameter>
21477             <parameter name="result" transfer-ownership="none">
21478               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
21479               <type name="AsyncResult" c:type="GAsyncResult*"/>
21480             </parameter>
21481           </parameters>
21482         </callback>
21483       </field>
21484       <field name="supports_thread_contexts">
21485         <type name="gboolean" c:type="gboolean"/>
21486       </field>
21487       <field name="unmount_mountable_with_operation">
21488         <callback name="unmount_mountable_with_operation">
21489           <return-value transfer-ownership="none">
21490             <type name="none" c:type="void"/>
21491           </return-value>
21492           <parameters>
21493             <parameter name="file" transfer-ownership="none">
21494               <type name="File" c:type="GFile*"/>
21495             </parameter>
21496             <parameter name="flags" transfer-ownership="none">
21497               <doc xml:whitespace="preserve">flags affecting the operation</doc>
21498               <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
21499             </parameter>
21500             <parameter name="mount_operation" transfer-ownership="none">
21501               <doc xml:whitespace="preserve">a #GMountOperation, or %NULL to avoid user interaction.</doc>
21502               <type name="MountOperation" c:type="GMountOperation*"/>
21503             </parameter>
21504             <parameter name="cancellable"
21505                        transfer-ownership="none"
21506                        allow-none="1">
21507               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
21508               <type name="Cancellable" c:type="GCancellable*"/>
21509             </parameter>
21510             <parameter name="callback"
21511                        transfer-ownership="none"
21512                        scope="async"
21513                        closure="5">
21514               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
21515               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
21516             </parameter>
21517             <parameter name="user_data" transfer-ownership="none" closure="5">
21518               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
21519               <type name="gpointer" c:type="gpointer"/>
21520             </parameter>
21521           </parameters>
21522         </callback>
21523       </field>
21524       <field name="unmount_mountable_with_operation_finish">
21525         <callback name="unmount_mountable_with_operation_finish" throws="1">
21526           <return-value transfer-ownership="none">
21527             <doc xml:whitespace="preserve">%TRUE if the operation finished successfully. %FALSE</doc>
21528             <type name="gboolean" c:type="gboolean"/>
21529           </return-value>
21530           <parameters>
21531             <parameter name="file" transfer-ownership="none">
21532               <type name="File" c:type="GFile*"/>
21533             </parameter>
21534             <parameter name="result" transfer-ownership="none">
21535               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
21536               <type name="AsyncResult" c:type="GAsyncResult*"/>
21537             </parameter>
21538           </parameters>
21539         </callback>
21540       </field>
21541       <field name="eject_mountable_with_operation">
21542         <callback name="eject_mountable_with_operation">
21543           <return-value transfer-ownership="none">
21544             <type name="none" c:type="void"/>
21545           </return-value>
21546           <parameters>
21547             <parameter name="file" transfer-ownership="none">
21548               <type name="File" c:type="GFile*"/>
21549             </parameter>
21550             <parameter name="flags" transfer-ownership="none">
21551               <doc xml:whitespace="preserve">flags affecting the operation</doc>
21552               <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
21553             </parameter>
21554             <parameter name="mount_operation" transfer-ownership="none">
21555               <doc xml:whitespace="preserve">a #GMountOperation, or %NULL to avoid user interaction.</doc>
21556               <type name="MountOperation" c:type="GMountOperation*"/>
21557             </parameter>
21558             <parameter name="cancellable"
21559                        transfer-ownership="none"
21560                        allow-none="1">
21561               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
21562               <type name="Cancellable" c:type="GCancellable*"/>
21563             </parameter>
21564             <parameter name="callback"
21565                        transfer-ownership="none"
21566                        scope="async"
21567                        closure="5">
21568               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
21569               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
21570             </parameter>
21571             <parameter name="user_data" transfer-ownership="none" closure="5">
21572               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
21573               <type name="gpointer" c:type="gpointer"/>
21574             </parameter>
21575           </parameters>
21576         </callback>
21577       </field>
21578       <field name="eject_mountable_with_operation_finish">
21579         <callback name="eject_mountable_with_operation_finish" throws="1">
21580           <return-value transfer-ownership="none">
21581             <doc xml:whitespace="preserve">%TRUE if the @file was ejected successfully. %FALSE</doc>
21582             <type name="gboolean" c:type="gboolean"/>
21583           </return-value>
21584           <parameters>
21585             <parameter name="file" transfer-ownership="none">
21586               <type name="File" c:type="GFile*"/>
21587             </parameter>
21588             <parameter name="result" transfer-ownership="none">
21589               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
21590               <type name="AsyncResult" c:type="GAsyncResult*"/>
21591             </parameter>
21592           </parameters>
21593         </callback>
21594       </field>
21595       <field name="poll_mountable">
21596         <callback name="poll_mountable">
21597           <return-value transfer-ownership="none">
21598             <type name="none" c:type="void"/>
21599           </return-value>
21600           <parameters>
21601             <parameter name="file" transfer-ownership="none">
21602               <type name="File" c:type="GFile*"/>
21603             </parameter>
21604             <parameter name="cancellable"
21605                        transfer-ownership="none"
21606                        allow-none="1">
21607               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
21608               <type name="Cancellable" c:type="GCancellable*"/>
21609             </parameter>
21610             <parameter name="callback"
21611                        transfer-ownership="none"
21612                        scope="async"
21613                        closure="3">
21614               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.</doc>
21615               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
21616             </parameter>
21617             <parameter name="user_data" transfer-ownership="none" closure="3">
21618               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
21619               <type name="gpointer" c:type="gpointer"/>
21620             </parameter>
21621           </parameters>
21622         </callback>
21623       </field>
21624       <field name="poll_mountable_finish">
21625         <callback name="poll_mountable_finish" throws="1">
21626           <return-value transfer-ownership="none">
21627             <doc xml:whitespace="preserve">%TRUE if the operation finished successfully. %FALSE</doc>
21628             <type name="gboolean" c:type="gboolean"/>
21629           </return-value>
21630           <parameters>
21631             <parameter name="file" transfer-ownership="none">
21632               <type name="File" c:type="GFile*"/>
21633             </parameter>
21634             <parameter name="result" transfer-ownership="none">
21635               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
21636               <type name="AsyncResult" c:type="GAsyncResult*"/>
21637             </parameter>
21638           </parameters>
21639         </callback>
21640       </field>
21641     </record>
21642     <class name="FileInfo"
21643            c:symbol-prefix="file_info"
21644            c:type="GFileInfo"
21645            parent="GObject.Object"
21646            glib:type-name="GFileInfo"
21647            glib:get-type="g_file_info_get_type"
21648            glib:type-struct="FileInfoClass">
21649       <doc xml:whitespace="preserve">Stores information about a file system object referenced by a #GFile.</doc>
21650       <constructor name="new" c:identifier="g_file_info_new">
21651         <doc xml:whitespace="preserve">Creates a new file info structure.</doc>
21652         <return-value transfer-ownership="full">
21653           <doc xml:whitespace="preserve">a #GFileInfo.</doc>
21654           <type name="FileInfo" c:type="GFileInfo*"/>
21655         </return-value>
21656       </constructor>
21657       <method name="clear_status" c:identifier="g_file_info_clear_status">
21658         <doc xml:whitespace="preserve">Clears the status information from @info.</doc>
21659         <return-value transfer-ownership="none">
21660           <type name="none" c:type="void"/>
21661         </return-value>
21662       </method>
21663       <method name="copy_into" c:identifier="g_file_info_copy_into">
21664         <doc xml:whitespace="preserve">Copies all of the #GFileAttribute&lt;!-- --&gt;s from @src_info to @dest_info.</doc>
21665         <return-value transfer-ownership="none">
21666           <type name="none" c:type="void"/>
21667         </return-value>
21668         <parameters>
21669           <parameter name="dest_info" transfer-ownership="none">
21670             <doc xml:whitespace="preserve">destination to copy attributes to.</doc>
21671             <type name="FileInfo" c:type="GFileInfo*"/>
21672           </parameter>
21673         </parameters>
21674       </method>
21675       <method name="dup" c:identifier="g_file_info_dup">
21676         <doc xml:whitespace="preserve">Duplicates a file info structure.</doc>
21677         <return-value transfer-ownership="full">
21678           <doc xml:whitespace="preserve">a duplicate #GFileInfo of @other.</doc>
21679           <type name="FileInfo" c:type="GFileInfo*"/>
21680         </return-value>
21681       </method>
21682       <method name="get_attribute_as_string"
21683               c:identifier="g_file_info_get_attribute_as_string">
21684         <doc xml:whitespace="preserve">Gets the value of a attribute, formated as a string.
21685 This escapes things as needed to make the string valid
21686 utf8.
21687 When you're done with the string it must be freed with g_free().</doc>
21688         <return-value transfer-ownership="full">
21689           <doc xml:whitespace="preserve">a UTF-8 string associated with the given @attribute.</doc>
21690           <type name="utf8" c:type="char*"/>
21691         </return-value>
21692         <parameters>
21693           <parameter name="attribute" transfer-ownership="none">
21694             <doc xml:whitespace="preserve">a file attribute key.</doc>
21695             <type name="utf8" c:type="char*"/>
21696           </parameter>
21697         </parameters>
21698       </method>
21699       <method name="get_attribute_boolean"
21700               c:identifier="g_file_info_get_attribute_boolean">
21701         <doc xml:whitespace="preserve">Gets the value of a boolean attribute. If the attribute does not
21702 contain a boolean value, %FALSE will be returned.</doc>
21703         <return-value transfer-ownership="none">
21704           <doc xml:whitespace="preserve">the boolean value contained within the attribute.</doc>
21705           <type name="gboolean" c:type="gboolean"/>
21706         </return-value>
21707         <parameters>
21708           <parameter name="attribute" transfer-ownership="none">
21709             <doc xml:whitespace="preserve">a file attribute key.</doc>
21710             <type name="utf8" c:type="char*"/>
21711           </parameter>
21712         </parameters>
21713       </method>
21714       <method name="get_attribute_byte_string"
21715               c:identifier="g_file_info_get_attribute_byte_string">
21716         <doc xml:whitespace="preserve">Gets the value of a byte string attribute. If the attribute does
21717 not contain a byte string, %NULL will be returned.
21718 %NULL otherwise.</doc>
21719         <return-value transfer-ownership="none">
21720           <doc xml:whitespace="preserve">the contents of the @attribute value as a byte string, or</doc>
21721           <type name="utf8" c:type="char*"/>
21722         </return-value>
21723         <parameters>
21724           <parameter name="attribute" transfer-ownership="none">
21725             <doc xml:whitespace="preserve">a file attribute key.</doc>
21726             <type name="utf8" c:type="char*"/>
21727           </parameter>
21728         </parameters>
21729       </method>
21730       <method name="get_attribute_data"
21731               c:identifier="g_file_info_get_attribute_data">
21732         <doc xml:whitespace="preserve">Gets the attribute type, value and status for an attribute key.
21733 %FALSE otherwise.</doc>
21734         <return-value transfer-ownership="none">
21735           <doc xml:whitespace="preserve">%TRUE if @info has an attribute named @attribute,</doc>
21736           <type name="gboolean" c:type="gboolean"/>
21737         </return-value>
21738         <parameters>
21739           <parameter name="attribute" transfer-ownership="none">
21740             <doc xml:whitespace="preserve">a file attribute key</doc>
21741             <type name="utf8" c:type="char*"/>
21742           </parameter>
21743           <parameter name="type"
21744                      direction="out"
21745                      caller-allocates="1"
21746                      transfer-ownership="none"
21747                      allow-none="1">
21748             <doc xml:whitespace="preserve">return location for the attribute type, or %NULL</doc>
21749             <type name="FileAttributeType" c:type="GFileAttributeType*"/>
21750           </parameter>
21751           <parameter name="value_pp"
21752                      direction="out"
21753                      caller-allocates="0"
21754                      transfer-ownership="full"
21755                      allow-none="1">
21756             <doc xml:whitespace="preserve">return location for the attribute value, or %NULL</doc>
21757             <type name="gpointer" c:type="gpointer*"/>
21758           </parameter>
21759           <parameter name="status"
21760                      direction="out"
21761                      caller-allocates="1"
21762                      transfer-ownership="none"
21763                      allow-none="1">
21764             <doc xml:whitespace="preserve">return location for the attribute status, or %NULL</doc>
21765             <type name="FileAttributeStatus" c:type="GFileAttributeStatus*"/>
21766           </parameter>
21767         </parameters>
21768       </method>
21769       <method name="get_attribute_int32"
21770               c:identifier="g_file_info_get_attribute_int32">
21771         <doc xml:whitespace="preserve">Gets a signed 32-bit integer contained within the attribute. If the
21772 attribute does not contain a signed 32-bit integer, or is invalid,
21773 0 will be returned.</doc>
21774         <return-value transfer-ownership="none">
21775           <doc xml:whitespace="preserve">a signed 32-bit integer from the attribute.</doc>
21776           <type name="gint32" c:type="gint32"/>
21777         </return-value>
21778         <parameters>
21779           <parameter name="attribute" transfer-ownership="none">
21780             <doc xml:whitespace="preserve">a file attribute key.</doc>
21781             <type name="utf8" c:type="char*"/>
21782           </parameter>
21783         </parameters>
21784       </method>
21785       <method name="get_attribute_int64"
21786               c:identifier="g_file_info_get_attribute_int64">
21787         <doc xml:whitespace="preserve">Gets a signed 64-bit integer contained within the attribute. If the
21788 attribute does not contain an signed 64-bit integer, or is invalid,
21789 0 will be returned.</doc>
21790         <return-value transfer-ownership="none">
21791           <doc xml:whitespace="preserve">a signed 64-bit integer from the attribute.</doc>
21792           <type name="gint64" c:type="gint64"/>
21793         </return-value>
21794         <parameters>
21795           <parameter name="attribute" transfer-ownership="none">
21796             <doc xml:whitespace="preserve">a file attribute key.</doc>
21797             <type name="utf8" c:type="char*"/>
21798           </parameter>
21799         </parameters>
21800       </method>
21801       <method name="get_attribute_object"
21802               c:identifier="g_file_info_get_attribute_object">
21803         <doc xml:whitespace="preserve">Gets the value of a #GObject attribute. If the attribute does
21804 not contain a #GObject, %NULL will be returned.
21805 %NULL otherwise.</doc>
21806         <return-value transfer-ownership="none">
21807           <doc xml:whitespace="preserve">a #GObject associated with the given @attribute, or</doc>
21808           <type name="GObject.Object" c:type="GObject*"/>
21809         </return-value>
21810         <parameters>
21811           <parameter name="attribute" transfer-ownership="none">
21812             <doc xml:whitespace="preserve">a file attribute key.</doc>
21813             <type name="utf8" c:type="char*"/>
21814           </parameter>
21815         </parameters>
21816       </method>
21817       <method name="get_attribute_status"
21818               c:identifier="g_file_info_get_attribute_status">
21819         <return-value transfer-ownership="none">
21820           <type name="FileAttributeStatus" c:type="GFileAttributeStatus"/>
21821         </return-value>
21822         <parameters>
21823           <parameter name="attribute" transfer-ownership="none">
21824             <type name="utf8" c:type="char*"/>
21825           </parameter>
21826         </parameters>
21827       </method>
21828       <method name="get_attribute_string"
21829               c:identifier="g_file_info_get_attribute_string">
21830         <doc xml:whitespace="preserve">Gets the value of a string attribute. If the attribute does
21831 not contain a string, %NULL will be returned.
21832 %NULL otherwise.</doc>
21833         <return-value transfer-ownership="none">
21834           <doc xml:whitespace="preserve">the contents of the @attribute value as a string, or</doc>
21835           <type name="utf8" c:type="char*"/>
21836         </return-value>
21837         <parameters>
21838           <parameter name="attribute" transfer-ownership="none">
21839             <doc xml:whitespace="preserve">a file attribute key.</doc>
21840             <type name="utf8" c:type="char*"/>
21841           </parameter>
21842         </parameters>
21843       </method>
21844       <method name="get_attribute_stringv"
21845               c:identifier="g_file_info_get_attribute_stringv"
21846               version="2.22">
21847         <doc xml:whitespace="preserve">Gets the value of a stringv attribute. If the attribute does
21848 not contain a stringv, %NULL will be returned.
21849 %NULL otherwise. Do not free.</doc>
21850         <return-value transfer-ownership="none">
21851           <doc xml:whitespace="preserve">the contents of the @attribute value as a stringv, or</doc>
21852           <array c:type="char**">
21853             <type name="utf8"/>
21854           </array>
21855         </return-value>
21856         <parameters>
21857           <parameter name="attribute" transfer-ownership="none">
21858             <doc xml:whitespace="preserve">a file attribute key.</doc>
21859             <type name="utf8" c:type="char*"/>
21860           </parameter>
21861         </parameters>
21862       </method>
21863       <method name="get_attribute_type"
21864               c:identifier="g_file_info_get_attribute_type">
21865         <doc xml:whitespace="preserve">Gets the attribute type for an attribute key.
21866 %G_FILE_ATTRIBUTE_TYPE_INVALID if the key is not set.</doc>
21867         <return-value transfer-ownership="none">
21868           <doc xml:whitespace="preserve">a #GFileAttributeType for the given @attribute, or</doc>
21869           <type name="FileAttributeType" c:type="GFileAttributeType"/>
21870         </return-value>
21871         <parameters>
21872           <parameter name="attribute" transfer-ownership="none">
21873             <doc xml:whitespace="preserve">a file attribute key.</doc>
21874             <type name="utf8" c:type="char*"/>
21875           </parameter>
21876         </parameters>
21877       </method>
21878       <method name="get_attribute_uint32"
21879               c:identifier="g_file_info_get_attribute_uint32">
21880         <doc xml:whitespace="preserve">Gets an unsigned 32-bit integer contained within the attribute. If the
21881 attribute does not contain an unsigned 32-bit integer, or is invalid,
21882 0 will be returned.</doc>
21883         <return-value transfer-ownership="none">
21884           <doc xml:whitespace="preserve">an unsigned 32-bit integer from the attribute.</doc>
21885           <type name="guint32" c:type="guint32"/>
21886         </return-value>
21887         <parameters>
21888           <parameter name="attribute" transfer-ownership="none">
21889             <doc xml:whitespace="preserve">a file attribute key.</doc>
21890             <type name="utf8" c:type="char*"/>
21891           </parameter>
21892         </parameters>
21893       </method>
21894       <method name="get_attribute_uint64"
21895               c:identifier="g_file_info_get_attribute_uint64">
21896         <doc xml:whitespace="preserve">Gets a unsigned 64-bit integer contained within the attribute. If the
21897 attribute does not contain an unsigned 64-bit integer, or is invalid,
21898 0 will be returned.</doc>
21899         <return-value transfer-ownership="none">
21900           <doc xml:whitespace="preserve">a unsigned 64-bit integer from the attribute.</doc>
21901           <type name="guint64" c:type="guint64"/>
21902         </return-value>
21903         <parameters>
21904           <parameter name="attribute" transfer-ownership="none">
21905             <doc xml:whitespace="preserve">a file attribute key.</doc>
21906             <type name="utf8" c:type="char*"/>
21907           </parameter>
21908         </parameters>
21909       </method>
21910       <method name="get_content_type"
21911               c:identifier="g_file_info_get_content_type">
21912         <doc xml:whitespace="preserve">Gets the file's content type.</doc>
21913         <return-value transfer-ownership="none">
21914           <doc xml:whitespace="preserve">a string containing the file's content type.</doc>
21915           <type name="utf8" c:type="char*"/>
21916         </return-value>
21917       </method>
21918       <method name="get_display_name"
21919               c:identifier="g_file_info_get_display_name">
21920         <doc xml:whitespace="preserve">Gets a display name for a file.</doc>
21921         <return-value transfer-ownership="none">
21922           <doc xml:whitespace="preserve">a string containing the display name.</doc>
21923           <type name="utf8" c:type="char*"/>
21924         </return-value>
21925       </method>
21926       <method name="get_edit_name" c:identifier="g_file_info_get_edit_name">
21927         <doc xml:whitespace="preserve">Gets the edit name for a file.</doc>
21928         <return-value transfer-ownership="none">
21929           <doc xml:whitespace="preserve">a string containing the edit name.</doc>
21930           <type name="utf8" c:type="char*"/>
21931         </return-value>
21932       </method>
21933       <method name="get_etag" c:identifier="g_file_info_get_etag">
21934         <doc xml:whitespace="preserve">Gets the &lt;link linkend="gfile-etag"&gt;entity tag&lt;/link&gt; for a given
21935 #GFileInfo. See %G_FILE_ATTRIBUTE_ETAG_VALUE.</doc>
21936         <return-value transfer-ownership="none">
21937           <doc xml:whitespace="preserve">a string containing the value of the "etag:value" attribute.</doc>
21938           <type name="utf8" c:type="char*"/>
21939         </return-value>
21940       </method>
21941       <method name="get_file_type" c:identifier="g_file_info_get_file_type">
21942         <doc xml:whitespace="preserve">Gets a file's type (whether it is a regular file, symlink, etc).
21943 This is different from the file's content type, see g_file_info_get_content_type().</doc>
21944         <return-value transfer-ownership="none">
21945           <doc xml:whitespace="preserve">a #GFileType for the given file.</doc>
21946           <type name="FileType" c:type="GFileType"/>
21947         </return-value>
21948       </method>
21949       <method name="get_icon" c:identifier="g_file_info_get_icon">
21950         <doc xml:whitespace="preserve">Gets the icon for a file.</doc>
21951         <return-value transfer-ownership="none">
21952           <doc xml:whitespace="preserve">#GIcon for the given @info.</doc>
21953           <type name="Icon" c:type="GIcon*"/>
21954         </return-value>
21955       </method>
21956       <method name="get_is_backup" c:identifier="g_file_info_get_is_backup">
21957         <doc xml:whitespace="preserve">Checks if a file is a backup file.</doc>
21958         <return-value transfer-ownership="none">
21959           <doc xml:whitespace="preserve">%TRUE if file is a backup file, %FALSE otherwise.</doc>
21960           <type name="gboolean" c:type="gboolean"/>
21961         </return-value>
21962       </method>
21963       <method name="get_is_hidden" c:identifier="g_file_info_get_is_hidden">
21964         <doc xml:whitespace="preserve">Checks if a file is hidden.</doc>
21965         <return-value transfer-ownership="none">
21966           <doc xml:whitespace="preserve">%TRUE if the file is a hidden file, %FALSE otherwise.</doc>
21967           <type name="gboolean" c:type="gboolean"/>
21968         </return-value>
21969       </method>
21970       <method name="get_is_symlink" c:identifier="g_file_info_get_is_symlink">
21971         <doc xml:whitespace="preserve">Checks if a file is a symlink.</doc>
21972         <return-value transfer-ownership="none">
21973           <doc xml:whitespace="preserve">%TRUE if the given @info is a symlink.</doc>
21974           <type name="gboolean" c:type="gboolean"/>
21975         </return-value>
21976       </method>
21977       <method name="get_modification_time"
21978               c:identifier="g_file_info_get_modification_time">
21979         <doc xml:whitespace="preserve">Gets the modification time of the current @info and sets it
21980 in @result.</doc>
21981         <return-value transfer-ownership="none">
21982           <type name="none" c:type="void"/>
21983         </return-value>
21984         <parameters>
21985           <parameter name="result" transfer-ownership="none">
21986             <doc xml:whitespace="preserve">a #GTimeVal.</doc>
21987             <type name="GLib.TimeVal" c:type="GTimeVal*"/>
21988           </parameter>
21989         </parameters>
21990       </method>
21991       <method name="get_name" c:identifier="g_file_info_get_name">
21992         <doc xml:whitespace="preserve">Gets the name for a file.</doc>
21993         <return-value transfer-ownership="none">
21994           <doc xml:whitespace="preserve">a string containing the file name.</doc>
21995           <type name="utf8" c:type="char*"/>
21996         </return-value>
21997       </method>
21998       <method name="get_size" c:identifier="g_file_info_get_size">
21999         <doc xml:whitespace="preserve">Gets the file's size.</doc>
22000         <return-value transfer-ownership="none">
22001           <doc xml:whitespace="preserve">a #goffset containing the file's size.</doc>
22002           <type name="gint64" c:type="goffset"/>
22003         </return-value>
22004       </method>
22005       <method name="get_sort_order" c:identifier="g_file_info_get_sort_order">
22006         <doc xml:whitespace="preserve">Gets the value of the sort_order attribute from the #GFileInfo.
22007 See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.</doc>
22008         <return-value transfer-ownership="none">
22009           <doc xml:whitespace="preserve">a #gint32 containing the value of the "standard::sort_order" attribute.</doc>
22010           <type name="gint32" c:type="gint32"/>
22011         </return-value>
22012       </method>
22013       <method name="get_symlink_target"
22014               c:identifier="g_file_info_get_symlink_target">
22015         <doc xml:whitespace="preserve">Gets the symlink target for a given #GFileInfo.</doc>
22016         <return-value transfer-ownership="none">
22017           <doc xml:whitespace="preserve">a string containing the symlink target.</doc>
22018           <type name="utf8" c:type="char*"/>
22019         </return-value>
22020       </method>
22021       <method name="has_attribute" c:identifier="g_file_info_has_attribute">
22022         <doc xml:whitespace="preserve">Checks if a file info structure has an attribute named @attribute.
22023 %FALSE otherwise.</doc>
22024         <return-value transfer-ownership="none">
22025           <doc xml:whitespace="preserve">%TRUE if @Ginfo has an attribute named @attribute,</doc>
22026           <type name="gboolean" c:type="gboolean"/>
22027         </return-value>
22028         <parameters>
22029           <parameter name="attribute" transfer-ownership="none">
22030             <doc xml:whitespace="preserve">a file attribute key.</doc>
22031             <type name="utf8" c:type="char*"/>
22032           </parameter>
22033         </parameters>
22034       </method>
22035       <method name="has_namespace"
22036               c:identifier="g_file_info_has_namespace"
22037               version="2.22">
22038         <doc xml:whitespace="preserve">Checks if a file info structure has an attribute in the
22039 specified @name_space.
22040 %FALSE otherwise.</doc>
22041         <return-value transfer-ownership="none">
22042           <doc xml:whitespace="preserve">%TRUE if @Ginfo has an attribute in @name_space,</doc>
22043           <type name="gboolean" c:type="gboolean"/>
22044         </return-value>
22045         <parameters>
22046           <parameter name="name_space" transfer-ownership="none">
22047             <doc xml:whitespace="preserve">a file attribute namespace.</doc>
22048             <type name="utf8" c:type="char*"/>
22049           </parameter>
22050         </parameters>
22051       </method>
22052       <method name="list_attributes"
22053               c:identifier="g_file_info_list_attributes">
22054         <doc xml:whitespace="preserve">Lists the file info structure's attributes.
22055 possible attribute types for the given @name_space, or
22056 %NULL on error.</doc>
22057         <return-value transfer-ownership="full">
22058           <doc xml:whitespace="preserve">a null-terminated array of strings of all of the</doc>
22059           <array c:type="char**">
22060             <type name="utf8"/>
22061           </array>
22062         </return-value>
22063         <parameters>
22064           <parameter name="name_space" transfer-ownership="none">
22065             <doc xml:whitespace="preserve">a file attribute key's namespace.</doc>
22066             <type name="utf8" c:type="char*"/>
22067           </parameter>
22068         </parameters>
22069       </method>
22070       <method name="remove_attribute"
22071               c:identifier="g_file_info_remove_attribute">
22072         <doc xml:whitespace="preserve">Removes all cases of @attribute from @info if it exists.</doc>
22073         <return-value transfer-ownership="none">
22074           <type name="none" c:type="void"/>
22075         </return-value>
22076         <parameters>
22077           <parameter name="attribute" transfer-ownership="none">
22078             <doc xml:whitespace="preserve">a file attribute key.</doc>
22079             <type name="utf8" c:type="char*"/>
22080           </parameter>
22081         </parameters>
22082       </method>
22083       <method name="set_attribute" c:identifier="g_file_info_set_attribute">
22084         <doc xml:whitespace="preserve">Sets the @attribute to contain the given value, if possible.</doc>
22085         <return-value transfer-ownership="none">
22086           <type name="none" c:type="void"/>
22087         </return-value>
22088         <parameters>
22089           <parameter name="attribute" transfer-ownership="none">
22090             <doc xml:whitespace="preserve">a file attribute key.</doc>
22091             <type name="utf8" c:type="char*"/>
22092           </parameter>
22093           <parameter name="type" transfer-ownership="none">
22094             <doc xml:whitespace="preserve">a #GFileAttributeType</doc>
22095             <type name="FileAttributeType" c:type="GFileAttributeType"/>
22096           </parameter>
22097           <parameter name="value_p" transfer-ownership="none">
22098             <doc xml:whitespace="preserve">pointer to the value</doc>
22099             <type name="gpointer" c:type="gpointer"/>
22100           </parameter>
22101         </parameters>
22102       </method>
22103       <method name="set_attribute_boolean"
22104               c:identifier="g_file_info_set_attribute_boolean">
22105         <doc xml:whitespace="preserve">Sets the @attribute to contain the given @attr_value,
22106 if possible.</doc>
22107         <return-value transfer-ownership="none">
22108           <type name="none" c:type="void"/>
22109         </return-value>
22110         <parameters>
22111           <parameter name="attribute" transfer-ownership="none">
22112             <doc xml:whitespace="preserve">a file attribute key.</doc>
22113             <type name="utf8" c:type="char*"/>
22114           </parameter>
22115           <parameter name="attr_value" transfer-ownership="none">
22116             <doc xml:whitespace="preserve">a boolean value.</doc>
22117             <type name="gboolean" c:type="gboolean"/>
22118           </parameter>
22119         </parameters>
22120       </method>
22121       <method name="set_attribute_byte_string"
22122               c:identifier="g_file_info_set_attribute_byte_string">
22123         <doc xml:whitespace="preserve">Sets the @attribute to contain the given @attr_value,
22124 if possible.</doc>
22125         <return-value transfer-ownership="none">
22126           <type name="none" c:type="void"/>
22127         </return-value>
22128         <parameters>
22129           <parameter name="attribute" transfer-ownership="none">
22130             <doc xml:whitespace="preserve">a file attribute key.</doc>
22131             <type name="utf8" c:type="char*"/>
22132           </parameter>
22133           <parameter name="attr_value" transfer-ownership="none">
22134             <doc xml:whitespace="preserve">a byte string.</doc>
22135             <type name="utf8" c:type="char*"/>
22136           </parameter>
22137         </parameters>
22138       </method>
22139       <method name="set_attribute_int32"
22140               c:identifier="g_file_info_set_attribute_int32">
22141         <doc xml:whitespace="preserve">Sets the @attribute to contain the given @attr_value,
22142 if possible.</doc>
22143         <return-value transfer-ownership="none">
22144           <type name="none" c:type="void"/>
22145         </return-value>
22146         <parameters>
22147           <parameter name="attribute" transfer-ownership="none">
22148             <doc xml:whitespace="preserve">a file attribute key.</doc>
22149             <type name="utf8" c:type="char*"/>
22150           </parameter>
22151           <parameter name="attr_value" transfer-ownership="none">
22152             <doc xml:whitespace="preserve">a signed 32-bit integer</doc>
22153             <type name="gint32" c:type="gint32"/>
22154           </parameter>
22155         </parameters>
22156       </method>
22157       <method name="set_attribute_int64"
22158               c:identifier="g_file_info_set_attribute_int64">
22159         <doc xml:whitespace="preserve">Sets the @attribute to contain the given @attr_value,
22160 if possible.</doc>
22161         <return-value transfer-ownership="none">
22162           <type name="none" c:type="void"/>
22163         </return-value>
22164         <parameters>
22165           <parameter name="attribute" transfer-ownership="none">
22166             <doc xml:whitespace="preserve">attribute name to set.</doc>
22167             <type name="utf8" c:type="char*"/>
22168           </parameter>
22169           <parameter name="attr_value" transfer-ownership="none">
22170             <doc xml:whitespace="preserve">int64 value to set attribute to.</doc>
22171             <type name="gint64" c:type="gint64"/>
22172           </parameter>
22173         </parameters>
22174       </method>
22175       <method name="set_attribute_mask"
22176               c:identifier="g_file_info_set_attribute_mask">
22177         <doc xml:whitespace="preserve">Sets @mask on @info to match specific attribute types.</doc>
22178         <return-value transfer-ownership="none">
22179           <type name="none" c:type="void"/>
22180         </return-value>
22181         <parameters>
22182           <parameter name="mask" transfer-ownership="none">
22183             <doc xml:whitespace="preserve">a #GFileAttributeMatcher.</doc>
22184             <type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
22185           </parameter>
22186         </parameters>
22187       </method>
22188       <method name="set_attribute_object"
22189               c:identifier="g_file_info_set_attribute_object">
22190         <doc xml:whitespace="preserve">Sets the @attribute to contain the given @attr_value,
22191 if possible.</doc>
22192         <return-value transfer-ownership="none">
22193           <type name="none" c:type="void"/>
22194         </return-value>
22195         <parameters>
22196           <parameter name="attribute" transfer-ownership="none">
22197             <doc xml:whitespace="preserve">a file attribute key.</doc>
22198             <type name="utf8" c:type="char*"/>
22199           </parameter>
22200           <parameter name="attr_value" transfer-ownership="none">
22201             <doc xml:whitespace="preserve">a #GObject.</doc>
22202             <type name="GObject.Object" c:type="GObject*"/>
22203           </parameter>
22204         </parameters>
22205       </method>
22206       <method name="set_attribute_status"
22207               c:identifier="g_file_info_set_attribute_status"
22208               version="2.22">
22209         <doc xml:whitespace="preserve">Sets the attribute status for an attribute key. This is only
22210 needed by external code that implement g_file_set_attributes_from_info()
22211 or similar functions.
22212 The attribute must exist in @info for this to work. Otherwise %FALSE
22213 is returned and @info is unchanged.</doc>
22214         <return-value transfer-ownership="none">
22215           <doc xml:whitespace="preserve">%TRUE if the status was changed, %FALSE if the key was not set.</doc>
22216           <type name="gboolean" c:type="gboolean"/>
22217         </return-value>
22218         <parameters>
22219           <parameter name="attribute" transfer-ownership="none">
22220             <doc xml:whitespace="preserve">a file attribute key</doc>
22221             <type name="utf8" c:type="char*"/>
22222           </parameter>
22223           <parameter name="status" transfer-ownership="none">
22224             <doc xml:whitespace="preserve">a #GFileAttributeStatus</doc>
22225             <type name="FileAttributeStatus" c:type="GFileAttributeStatus"/>
22226           </parameter>
22227         </parameters>
22228       </method>
22229       <method name="set_attribute_string"
22230               c:identifier="g_file_info_set_attribute_string">
22231         <doc xml:whitespace="preserve">Sets the @attribute to contain the given @attr_value,
22232 if possible.</doc>
22233         <return-value transfer-ownership="none">
22234           <type name="none" c:type="void"/>
22235         </return-value>
22236         <parameters>
22237           <parameter name="attribute" transfer-ownership="none">
22238             <doc xml:whitespace="preserve">a file attribute key.</doc>
22239             <type name="utf8" c:type="char*"/>
22240           </parameter>
22241           <parameter name="attr_value" transfer-ownership="none">
22242             <doc xml:whitespace="preserve">a string.</doc>
22243             <type name="utf8" c:type="char*"/>
22244           </parameter>
22245         </parameters>
22246       </method>
22247       <method name="set_attribute_stringv"
22248               c:identifier="g_file_info_set_attribute_stringv">
22249         <doc xml:whitespace="preserve">Sets the @attribute to contain the given @attr_value,
22250 if possible.</doc>
22251         <return-value transfer-ownership="none">
22252           <type name="none" c:type="void"/>
22253         </return-value>
22254         <parameters>
22255           <parameter name="attribute" transfer-ownership="none">
22256             <doc xml:whitespace="preserve">a file attribute key.</doc>
22257             <type name="utf8" c:type="char*"/>
22258           </parameter>
22259           <parameter name="attr_value" transfer-ownership="none">
22260             <doc xml:whitespace="preserve">a %NULL terminated string array</doc>
22261             <type name="utf8" c:type="char**"/>
22262           </parameter>
22263         </parameters>
22264       </method>
22265       <method name="set_attribute_uint32"
22266               c:identifier="g_file_info_set_attribute_uint32">
22267         <doc xml:whitespace="preserve">Sets the @attribute to contain the given @attr_value,
22268 if possible.</doc>
22269         <return-value transfer-ownership="none">
22270           <type name="none" c:type="void"/>
22271         </return-value>
22272         <parameters>
22273           <parameter name="attribute" transfer-ownership="none">
22274             <doc xml:whitespace="preserve">a file attribute key.</doc>
22275             <type name="utf8" c:type="char*"/>
22276           </parameter>
22277           <parameter name="attr_value" transfer-ownership="none">
22278             <doc xml:whitespace="preserve">an unsigned 32-bit integer.</doc>
22279             <type name="guint32" c:type="guint32"/>
22280           </parameter>
22281         </parameters>
22282       </method>
22283       <method name="set_attribute_uint64"
22284               c:identifier="g_file_info_set_attribute_uint64">
22285         <doc xml:whitespace="preserve">Sets the @attribute to contain the given @attr_value,
22286 if possible.</doc>
22287         <return-value transfer-ownership="none">
22288           <type name="none" c:type="void"/>
22289         </return-value>
22290         <parameters>
22291           <parameter name="attribute" transfer-ownership="none">
22292             <doc xml:whitespace="preserve">a file attribute key.</doc>
22293             <type name="utf8" c:type="char*"/>
22294           </parameter>
22295           <parameter name="attr_value" transfer-ownership="none">
22296             <doc xml:whitespace="preserve">an unsigned 64-bit integer.</doc>
22297             <type name="guint64" c:type="guint64"/>
22298           </parameter>
22299         </parameters>
22300       </method>
22301       <method name="set_content_type"
22302               c:identifier="g_file_info_set_content_type">
22303         <doc xml:whitespace="preserve">Sets the content type attribute for a given #GFileInfo.
22304 See %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE.</doc>
22305         <return-value transfer-ownership="none">
22306           <type name="none" c:type="void"/>
22307         </return-value>
22308         <parameters>
22309           <parameter name="content_type" transfer-ownership="none">
22310             <doc xml:whitespace="preserve">a content type. See #GContentType.</doc>
22311             <type name="utf8" c:type="char*"/>
22312           </parameter>
22313         </parameters>
22314       </method>
22315       <method name="set_display_name"
22316               c:identifier="g_file_info_set_display_name">
22317         <doc xml:whitespace="preserve">Sets the display name for the current #GFileInfo.
22318 See %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME.</doc>
22319         <return-value transfer-ownership="none">
22320           <type name="none" c:type="void"/>
22321         </return-value>
22322         <parameters>
22323           <parameter name="display_name" transfer-ownership="none">
22324             <doc xml:whitespace="preserve">a string containing a display name.</doc>
22325             <type name="utf8" c:type="char*"/>
22326           </parameter>
22327         </parameters>
22328       </method>
22329       <method name="set_edit_name" c:identifier="g_file_info_set_edit_name">
22330         <doc xml:whitespace="preserve">Sets the edit name for the current file.
22331 See %G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME.</doc>
22332         <return-value transfer-ownership="none">
22333           <type name="none" c:type="void"/>
22334         </return-value>
22335         <parameters>
22336           <parameter name="edit_name" transfer-ownership="none">
22337             <doc xml:whitespace="preserve">a string containing an edit name.</doc>
22338             <type name="utf8" c:type="char*"/>
22339           </parameter>
22340         </parameters>
22341       </method>
22342       <method name="set_file_type" c:identifier="g_file_info_set_file_type">
22343         <doc xml:whitespace="preserve">Sets the file type in a #GFileInfo to @type.
22344 See %G_FILE_ATTRIBUTE_STANDARD_TYPE.</doc>
22345         <return-value transfer-ownership="none">
22346           <type name="none" c:type="void"/>
22347         </return-value>
22348         <parameters>
22349           <parameter name="type" transfer-ownership="none">
22350             <doc xml:whitespace="preserve">a #GFileType.</doc>
22351             <type name="FileType" c:type="GFileType"/>
22352           </parameter>
22353         </parameters>
22354       </method>
22355       <method name="set_icon" c:identifier="g_file_info_set_icon">
22356         <doc xml:whitespace="preserve">Sets the icon for a given #GFileInfo.
22357 See %G_FILE_ATTRIBUTE_STANDARD_ICON.</doc>
22358         <return-value transfer-ownership="none">
22359           <type name="none" c:type="void"/>
22360         </return-value>
22361         <parameters>
22362           <parameter name="icon" transfer-ownership="none">
22363             <doc xml:whitespace="preserve">a #GIcon.</doc>
22364             <type name="Icon" c:type="GIcon*"/>
22365           </parameter>
22366         </parameters>
22367       </method>
22368       <method name="set_is_hidden" c:identifier="g_file_info_set_is_hidden">
22369         <doc xml:whitespace="preserve">Sets the "is_hidden" attribute in a #GFileInfo according to @is_symlink.
22370 See %G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN.</doc>
22371         <return-value transfer-ownership="none">
22372           <type name="none" c:type="void"/>
22373         </return-value>
22374         <parameters>
22375           <parameter name="is_hidden" transfer-ownership="none">
22376             <doc xml:whitespace="preserve">a #gboolean.</doc>
22377             <type name="gboolean" c:type="gboolean"/>
22378           </parameter>
22379         </parameters>
22380       </method>
22381       <method name="set_is_symlink" c:identifier="g_file_info_set_is_symlink">
22382         <doc xml:whitespace="preserve">Sets the "is_symlink" attribute in a #GFileInfo according to @is_symlink.
22383 See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK.</doc>
22384         <return-value transfer-ownership="none">
22385           <type name="none" c:type="void"/>
22386         </return-value>
22387         <parameters>
22388           <parameter name="is_symlink" transfer-ownership="none">
22389             <doc xml:whitespace="preserve">a #gboolean.</doc>
22390             <type name="gboolean" c:type="gboolean"/>
22391           </parameter>
22392         </parameters>
22393       </method>
22394       <method name="set_modification_time"
22395               c:identifier="g_file_info_set_modification_time">
22396         <return-value transfer-ownership="none">
22397           <type name="none" c:type="void"/>
22398         </return-value>
22399         <parameters>
22400           <parameter name="mtime" transfer-ownership="none">
22401             <type name="GLib.TimeVal" c:type="GTimeVal*"/>
22402           </parameter>
22403         </parameters>
22404       </method>
22405       <method name="set_name" c:identifier="g_file_info_set_name">
22406         <doc xml:whitespace="preserve">Sets the name attribute for the current #GFileInfo.
22407 See %G_FILE_ATTRIBUTE_STANDARD_NAME.</doc>
22408         <return-value transfer-ownership="none">
22409           <type name="none" c:type="void"/>
22410         </return-value>
22411         <parameters>
22412           <parameter name="name" transfer-ownership="none">
22413             <doc xml:whitespace="preserve">a string containing a name.</doc>
22414             <type name="utf8" c:type="char*"/>
22415           </parameter>
22416         </parameters>
22417       </method>
22418       <method name="set_size" c:identifier="g_file_info_set_size">
22419         <doc xml:whitespace="preserve">Sets the %G_FILE_ATTRIBUTE_STANDARD_SIZE attribute in the file info
22420 to the given size.</doc>
22421         <return-value transfer-ownership="none">
22422           <type name="none" c:type="void"/>
22423         </return-value>
22424         <parameters>
22425           <parameter name="size" transfer-ownership="none">
22426             <doc xml:whitespace="preserve">a #goffset containing the file's size.</doc>
22427             <type name="gint64" c:type="goffset"/>
22428           </parameter>
22429         </parameters>
22430       </method>
22431       <method name="set_sort_order" c:identifier="g_file_info_set_sort_order">
22432         <doc xml:whitespace="preserve">Sets the sort order attribute in the file info structure. See
22433 %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.</doc>
22434         <return-value transfer-ownership="none">
22435           <type name="none" c:type="void"/>
22436         </return-value>
22437         <parameters>
22438           <parameter name="sort_order" transfer-ownership="none">
22439             <doc xml:whitespace="preserve">a sort order integer.</doc>
22440             <type name="gint32" c:type="gint32"/>
22441           </parameter>
22442         </parameters>
22443       </method>
22444       <method name="set_symlink_target"
22445               c:identifier="g_file_info_set_symlink_target">
22446         <doc xml:whitespace="preserve">Sets the %G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET attribute in the file info
22447 to the given symlink target.</doc>
22448         <return-value transfer-ownership="none">
22449           <type name="none" c:type="void"/>
22450         </return-value>
22451         <parameters>
22452           <parameter name="symlink_target" transfer-ownership="none">
22453             <doc xml:whitespace="preserve">a static string containing a path to a symlink target.</doc>
22454             <type name="utf8" c:type="char*"/>
22455           </parameter>
22456         </parameters>
22457       </method>
22458       <method name="unset_attribute_mask"
22459               c:identifier="g_file_info_unset_attribute_mask">
22460         <doc xml:whitespace="preserve">Unsets a mask set by g_file_info_set_attribute_mask(), if one
22461 is set.</doc>
22462         <return-value transfer-ownership="none">
22463           <type name="none" c:type="void"/>
22464         </return-value>
22465       </method>
22466     </class>
22467     <record name="FileInfoClass"
22468             c:type="GFileInfoClass"
22469             disguised="1"
22470             glib:is-gtype-struct-for="FileInfo">
22471     </record>
22472     <class name="FileInputStream"
22473            c:symbol-prefix="file_input_stream"
22474            c:type="GFileInputStream"
22475            parent="InputStream"
22476            glib:type-name="GFileInputStream"
22477            glib:get-type="g_file_input_stream_get_type"
22478            glib:type-struct="FileInputStreamClass">
22479       <doc xml:whitespace="preserve">A subclass of GInputStream for opened files. This adds
22480 a few file-specific operations and seeking.
22481 #GFileInputStream implements #GSeekable.</doc>
22482       <implements name="Seekable"/>
22483       <virtual-method name="can_seek">
22484         <return-value transfer-ownership="none">
22485           <type name="gboolean" c:type="gboolean"/>
22486         </return-value>
22487       </virtual-method>
22488       <virtual-method name="query_info" invoker="query_info" throws="1">
22489         <doc xml:whitespace="preserve">Queries a file input stream the given @attributes. This function blocks
22490 while querying the stream. For the asynchronous (non-blocking) version
22491 of this function, see g_file_input_stream_query_info_async(). While the
22492 stream is blocked, the stream will set the pending flag internally, and
22493 any other operations on the stream will fail with %G_IO_ERROR_PENDING.</doc>
22494         <return-value transfer-ownership="full">
22495           <doc xml:whitespace="preserve">a #GFileInfo, or %NULL on error.</doc>
22496           <type name="FileInfo" c:type="GFileInfo*"/>
22497         </return-value>
22498         <parameters>
22499           <parameter name="attributes" transfer-ownership="none">
22500             <doc xml:whitespace="preserve">a file attribute query string.</doc>
22501             <type name="utf8" c:type="char*"/>
22502           </parameter>
22503           <parameter name="cancellable"
22504                      transfer-ownership="none"
22505                      allow-none="1">
22506             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
22507             <type name="Cancellable" c:type="GCancellable*"/>
22508           </parameter>
22509         </parameters>
22510       </virtual-method>
22511       <virtual-method name="query_info_async" invoker="query_info_async">
22512         <doc xml:whitespace="preserve">Queries the stream information asynchronously.
22513 When the operation is finished @callback will be called.
22514 You can then call g_file_input_stream_query_info_finish()
22515 to get the result of the operation.
22516 For the synchronous version of this function,
22517 see g_file_input_stream_query_info().
22518 If @cancellable is not %NULL, then the operation can be cancelled by
22519 triggering the cancellable object from another thread. If the operation
22520 was cancelled, the error %G_IO_ERROR_CANCELLED will be set</doc>
22521         <return-value transfer-ownership="none">
22522           <type name="none" c:type="void"/>
22523         </return-value>
22524         <parameters>
22525           <parameter name="attributes" transfer-ownership="none">
22526             <doc xml:whitespace="preserve">a file attribute query string.</doc>
22527             <type name="utf8" c:type="char*"/>
22528           </parameter>
22529           <parameter name="io_priority" transfer-ownership="none">
22530             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
22531             <type name="gint" c:type="int"/>
22532           </parameter>
22533           <parameter name="cancellable"
22534                      transfer-ownership="none"
22535                      allow-none="1">
22536             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
22537             <type name="Cancellable" c:type="GCancellable*"/>
22538           </parameter>
22539           <parameter name="callback"
22540                      transfer-ownership="none"
22541                      scope="async"
22542                      closure="4">
22543             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
22544             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
22545           </parameter>
22546           <parameter name="user_data" transfer-ownership="none" closure="4">
22547             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
22548             <type name="gpointer" c:type="gpointer"/>
22549           </parameter>
22550         </parameters>
22551       </virtual-method>
22552       <virtual-method name="query_info_finish"
22553                       invoker="query_info_finish"
22554                       throws="1">
22555         <doc xml:whitespace="preserve">Finishes an asynchronous info query operation.</doc>
22556         <return-value transfer-ownership="full">
22557           <doc xml:whitespace="preserve">#GFileInfo.</doc>
22558           <type name="FileInfo" c:type="GFileInfo*"/>
22559         </return-value>
22560         <parameters>
22561           <parameter name="res" transfer-ownership="none">
22562             <type name="AsyncResult" c:type="GAsyncResult*"/>
22563           </parameter>
22564         </parameters>
22565       </virtual-method>
22566       <virtual-method name="seek" throws="1">
22567         <return-value transfer-ownership="none">
22568           <type name="gboolean" c:type="gboolean"/>
22569         </return-value>
22570         <parameters>
22571           <parameter name="offset" transfer-ownership="none">
22572             <type name="gint64" c:type="goffset"/>
22573           </parameter>
22574           <parameter name="type" transfer-ownership="none">
22575             <type name="GLib.SeekType" c:type="GSeekType"/>
22576           </parameter>
22577           <parameter name="cancellable" transfer-ownership="none">
22578             <type name="Cancellable" c:type="GCancellable*"/>
22579           </parameter>
22580         </parameters>
22581       </virtual-method>
22582       <virtual-method name="tell">
22583         <return-value transfer-ownership="none">
22584           <type name="gint64" c:type="goffset"/>
22585         </return-value>
22586       </virtual-method>
22587       <method name="query_info"
22588               c:identifier="g_file_input_stream_query_info"
22589               throws="1">
22590         <doc xml:whitespace="preserve">Queries a file input stream the given @attributes. This function blocks
22591 while querying the stream. For the asynchronous (non-blocking) version
22592 of this function, see g_file_input_stream_query_info_async(). While the
22593 stream is blocked, the stream will set the pending flag internally, and
22594 any other operations on the stream will fail with %G_IO_ERROR_PENDING.</doc>
22595         <return-value transfer-ownership="full">
22596           <doc xml:whitespace="preserve">a #GFileInfo, or %NULL on error.</doc>
22597           <type name="FileInfo" c:type="GFileInfo*"/>
22598         </return-value>
22599         <parameters>
22600           <parameter name="attributes" transfer-ownership="none">
22601             <doc xml:whitespace="preserve">a file attribute query string.</doc>
22602             <type name="utf8" c:type="char*"/>
22603           </parameter>
22604           <parameter name="cancellable"
22605                      transfer-ownership="none"
22606                      allow-none="1">
22607             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
22608             <type name="Cancellable" c:type="GCancellable*"/>
22609           </parameter>
22610         </parameters>
22611       </method>
22612       <method name="query_info_async"
22613               c:identifier="g_file_input_stream_query_info_async">
22614         <doc xml:whitespace="preserve">Queries the stream information asynchronously.
22615 When the operation is finished @callback will be called.
22616 You can then call g_file_input_stream_query_info_finish()
22617 to get the result of the operation.
22618 For the synchronous version of this function,
22619 see g_file_input_stream_query_info().
22620 If @cancellable is not %NULL, then the operation can be cancelled by
22621 triggering the cancellable object from another thread. If the operation
22622 was cancelled, the error %G_IO_ERROR_CANCELLED will be set</doc>
22623         <return-value transfer-ownership="none">
22624           <type name="none" c:type="void"/>
22625         </return-value>
22626         <parameters>
22627           <parameter name="attributes" transfer-ownership="none">
22628             <doc xml:whitespace="preserve">a file attribute query string.</doc>
22629             <type name="utf8" c:type="char*"/>
22630           </parameter>
22631           <parameter name="io_priority" transfer-ownership="none">
22632             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
22633             <type name="gint" c:type="int"/>
22634           </parameter>
22635           <parameter name="cancellable"
22636                      transfer-ownership="none"
22637                      allow-none="1">
22638             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
22639             <type name="Cancellable" c:type="GCancellable*"/>
22640           </parameter>
22641           <parameter name="callback"
22642                      transfer-ownership="none"
22643                      scope="async"
22644                      closure="4">
22645             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
22646             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
22647           </parameter>
22648           <parameter name="user_data" transfer-ownership="none">
22649             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
22650             <type name="gpointer" c:type="gpointer"/>
22651           </parameter>
22652         </parameters>
22653       </method>
22654       <method name="query_info_finish"
22655               c:identifier="g_file_input_stream_query_info_finish"
22656               throws="1">
22657         <doc xml:whitespace="preserve">Finishes an asynchronous info query operation.</doc>
22658         <return-value transfer-ownership="full">
22659           <doc xml:whitespace="preserve">#GFileInfo.</doc>
22660           <type name="FileInfo" c:type="GFileInfo*"/>
22661         </return-value>
22662         <parameters>
22663           <parameter name="result" transfer-ownership="none">
22664             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
22665             <type name="AsyncResult" c:type="GAsyncResult*"/>
22666           </parameter>
22667         </parameters>
22668       </method>
22669       <field name="parent_instance">
22670         <type name="InputStream" c:type="GInputStream"/>
22671       </field>
22672       <field name="priv">
22673         <type name="FileInputStreamPrivate" c:type="GFileInputStreamPrivate*"/>
22674       </field>
22675     </class>
22676     <record name="FileInputStreamClass"
22677             c:type="GFileInputStreamClass"
22678             glib:is-gtype-struct-for="FileInputStream">
22679       <field name="parent_class">
22680         <type name="InputStreamClass" c:type="GInputStreamClass"/>
22681       </field>
22682       <field name="tell">
22683         <callback name="tell">
22684           <return-value transfer-ownership="none">
22685             <type name="gint64" c:type="goffset"/>
22686           </return-value>
22687           <parameters>
22688             <parameter name="stream" transfer-ownership="none">
22689               <type name="FileInputStream" c:type="GFileInputStream*"/>
22690             </parameter>
22691           </parameters>
22692         </callback>
22693       </field>
22694       <field name="can_seek">
22695         <callback name="can_seek">
22696           <return-value transfer-ownership="none">
22697             <type name="gboolean" c:type="gboolean"/>
22698           </return-value>
22699           <parameters>
22700             <parameter name="stream" transfer-ownership="none">
22701               <type name="FileInputStream" c:type="GFileInputStream*"/>
22702             </parameter>
22703           </parameters>
22704         </callback>
22705       </field>
22706       <field name="seek">
22707         <callback name="seek" throws="1">
22708           <return-value transfer-ownership="none">
22709             <type name="gboolean" c:type="gboolean"/>
22710           </return-value>
22711           <parameters>
22712             <parameter name="stream" transfer-ownership="none">
22713               <type name="FileInputStream" c:type="GFileInputStream*"/>
22714             </parameter>
22715             <parameter name="offset" transfer-ownership="none">
22716               <type name="gint64" c:type="goffset"/>
22717             </parameter>
22718             <parameter name="type" transfer-ownership="none">
22719               <type name="GLib.SeekType" c:type="GSeekType"/>
22720             </parameter>
22721             <parameter name="cancellable" transfer-ownership="none">
22722               <type name="Cancellable" c:type="GCancellable*"/>
22723             </parameter>
22724           </parameters>
22725         </callback>
22726       </field>
22727       <field name="query_info">
22728         <callback name="query_info" throws="1">
22729           <return-value transfer-ownership="full">
22730             <doc xml:whitespace="preserve">a #GFileInfo, or %NULL on error.</doc>
22731             <type name="FileInfo" c:type="GFileInfo*"/>
22732           </return-value>
22733           <parameters>
22734             <parameter name="stream" transfer-ownership="none">
22735               <type name="FileInputStream" c:type="GFileInputStream*"/>
22736             </parameter>
22737             <parameter name="attributes" transfer-ownership="none">
22738               <doc xml:whitespace="preserve">a file attribute query string.</doc>
22739               <type name="utf8" c:type="char*"/>
22740             </parameter>
22741             <parameter name="cancellable"
22742                        transfer-ownership="none"
22743                        allow-none="1">
22744               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
22745               <type name="Cancellable" c:type="GCancellable*"/>
22746             </parameter>
22747           </parameters>
22748         </callback>
22749       </field>
22750       <field name="query_info_async">
22751         <callback name="query_info_async">
22752           <return-value transfer-ownership="none">
22753             <type name="none" c:type="void"/>
22754           </return-value>
22755           <parameters>
22756             <parameter name="stream" transfer-ownership="none">
22757               <type name="FileInputStream" c:type="GFileInputStream*"/>
22758             </parameter>
22759             <parameter name="attributes" transfer-ownership="none">
22760               <doc xml:whitespace="preserve">a file attribute query string.</doc>
22761               <type name="utf8" c:type="char*"/>
22762             </parameter>
22763             <parameter name="io_priority" transfer-ownership="none">
22764               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
22765               <type name="gint" c:type="int"/>
22766             </parameter>
22767             <parameter name="cancellable"
22768                        transfer-ownership="none"
22769                        allow-none="1">
22770               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
22771               <type name="Cancellable" c:type="GCancellable*"/>
22772             </parameter>
22773             <parameter name="callback"
22774                        transfer-ownership="none"
22775                        scope="async"
22776                        closure="5">
22777               <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
22778               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
22779             </parameter>
22780             <parameter name="user_data" transfer-ownership="none" closure="5">
22781               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
22782               <type name="gpointer" c:type="gpointer"/>
22783             </parameter>
22784           </parameters>
22785         </callback>
22786       </field>
22787       <field name="query_info_finish">
22788         <callback name="query_info_finish" throws="1">
22789           <return-value transfer-ownership="full">
22790             <doc xml:whitespace="preserve">#GFileInfo.</doc>
22791             <type name="FileInfo" c:type="GFileInfo*"/>
22792           </return-value>
22793           <parameters>
22794             <parameter name="stream" transfer-ownership="none">
22795               <type name="FileInputStream" c:type="GFileInputStream*"/>
22796             </parameter>
22797             <parameter name="res" transfer-ownership="none">
22798               <type name="AsyncResult" c:type="GAsyncResult*"/>
22799             </parameter>
22800           </parameters>
22801         </callback>
22802       </field>
22803       <field name="_g_reserved1" introspectable="0">
22804         <callback name="_g_reserved1">
22805           <return-value transfer-ownership="none">
22806             <type name="none" c:type="void"/>
22807           </return-value>
22808         </callback>
22809       </field>
22810       <field name="_g_reserved2" introspectable="0">
22811         <callback name="_g_reserved2">
22812           <return-value transfer-ownership="none">
22813             <type name="none" c:type="void"/>
22814           </return-value>
22815         </callback>
22816       </field>
22817       <field name="_g_reserved3" introspectable="0">
22818         <callback name="_g_reserved3">
22819           <return-value transfer-ownership="none">
22820             <type name="none" c:type="void"/>
22821           </return-value>
22822         </callback>
22823       </field>
22824       <field name="_g_reserved4" introspectable="0">
22825         <callback name="_g_reserved4">
22826           <return-value transfer-ownership="none">
22827             <type name="none" c:type="void"/>
22828           </return-value>
22829         </callback>
22830       </field>
22831       <field name="_g_reserved5" introspectable="0">
22832         <callback name="_g_reserved5">
22833           <return-value transfer-ownership="none">
22834             <type name="none" c:type="void"/>
22835           </return-value>
22836         </callback>
22837       </field>
22838     </record>
22839     <record name="FileInputStreamPrivate"
22840             c:type="GFileInputStreamPrivate"
22841             disguised="1">
22842     </record>
22843     <class name="FileMonitor"
22844            c:symbol-prefix="file_monitor"
22845            c:type="GFileMonitor"
22846            parent="GObject.Object"
22847            abstract="1"
22848            glib:type-name="GFileMonitor"
22849            glib:get-type="g_file_monitor_get_type"
22850            glib:type-struct="FileMonitorClass">
22851       <doc xml:whitespace="preserve">Watches for changes to a file.</doc>
22852       <virtual-method name="cancel" invoker="cancel">
22853         <doc xml:whitespace="preserve">Cancels a file monitor.</doc>
22854         <return-value transfer-ownership="none">
22855           <doc xml:whitespace="preserve">%TRUE if monitor was cancelled.</doc>
22856           <type name="gboolean" c:type="gboolean"/>
22857         </return-value>
22858       </virtual-method>
22859       <method name="cancel" c:identifier="g_file_monitor_cancel">
22860         <doc xml:whitespace="preserve">Cancels a file monitor.</doc>
22861         <return-value transfer-ownership="none">
22862           <doc xml:whitespace="preserve">%TRUE if monitor was cancelled.</doc>
22863           <type name="gboolean" c:type="gboolean"/>
22864         </return-value>
22865       </method>
22866       <method name="emit_event" c:identifier="g_file_monitor_emit_event">
22867         <doc xml:whitespace="preserve">Emits the #GFileMonitor::changed signal if a change
22868 has taken place. Should be called from file monitor
22869 implementations only.
22870 The signal will be emitted from an idle handler (in the &lt;link
22871 linkend="g-main-context-push-thread-default"&gt;thread-default main
22872 context&lt;/link&gt;).</doc>
22873         <return-value transfer-ownership="none">
22874           <type name="none" c:type="void"/>
22875         </return-value>
22876         <parameters>
22877           <parameter name="child" transfer-ownership="none">
22878             <doc xml:whitespace="preserve">a #GFile.</doc>
22879             <type name="File" c:type="GFile*"/>
22880           </parameter>
22881           <parameter name="other_file" transfer-ownership="none">
22882             <doc xml:whitespace="preserve">a #GFile.</doc>
22883             <type name="File" c:type="GFile*"/>
22884           </parameter>
22885           <parameter name="event_type" transfer-ownership="none">
22886             <doc xml:whitespace="preserve">a set of #GFileMonitorEvent flags.</doc>
22887             <type name="FileMonitorEvent" c:type="GFileMonitorEvent"/>
22888           </parameter>
22889         </parameters>
22890       </method>
22891       <method name="is_cancelled" c:identifier="g_file_monitor_is_cancelled">
22892         <doc xml:whitespace="preserve">Returns whether the monitor is canceled.</doc>
22893         <return-value transfer-ownership="none">
22894           <doc xml:whitespace="preserve">%TRUE if monitor is canceled. %FALSE otherwise.</doc>
22895           <type name="gboolean" c:type="gboolean"/>
22896         </return-value>
22897       </method>
22898       <method name="set_rate_limit"
22899               c:identifier="g_file_monitor_set_rate_limit">
22900         <doc xml:whitespace="preserve">Sets the rate limit to which the @monitor will report
22901 consecutive change events to the same file.</doc>
22902         <return-value transfer-ownership="none">
22903           <type name="none" c:type="void"/>
22904         </return-value>
22905         <parameters>
22906           <parameter name="limit_msecs" transfer-ownership="none">
22907             <doc xml:whitespace="preserve">a integer with the limit in milliseconds to poll for changes.</doc>
22908             <type name="gint" c:type="int"/>
22909           </parameter>
22910         </parameters>
22911       </method>
22912       <property name="cancelled" transfer-ownership="none">
22913         <type name="gboolean"/>
22914       </property>
22915       <property name="rate-limit" writable="1" transfer-ownership="none">
22916         <type name="gint"/>
22917       </property>
22918       <field name="parent_instance">
22919         <type name="GObject.Object" c:type="GObject"/>
22920       </field>
22921       <field name="priv">
22922         <type name="FileMonitorPrivate" c:type="GFileMonitorPrivate*"/>
22923       </field>
22924       <glib:signal name="changed">
22925         <doc xml:whitespace="preserve">Emitted when a file has been changed.</doc>
22926         <return-value transfer-ownership="none">
22927           <type name="none"/>
22928         </return-value>
22929         <parameters>
22930           <parameter name="object" transfer-ownership="none">
22931             <doc xml:whitespace="preserve">a #GFile.</doc>
22932             <type name="File"/>
22933           </parameter>
22934           <parameter name="p0" transfer-ownership="none">
22935             <doc xml:whitespace="preserve">a #GFile.</doc>
22936             <type name="File"/>
22937           </parameter>
22938           <parameter name="p1" transfer-ownership="none">
22939             <doc xml:whitespace="preserve">a #GFileMonitorEvent.</doc>
22940             <type name="FileMonitorEvent"/>
22941           </parameter>
22942         </parameters>
22943       </glib:signal>
22944     </class>
22945     <record name="FileMonitorClass"
22946             c:type="GFileMonitorClass"
22947             glib:is-gtype-struct-for="FileMonitor">
22948       <field name="parent_class">
22949         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
22950       </field>
22951       <field name="changed">
22952         <callback name="changed">
22953           <return-value transfer-ownership="none">
22954             <type name="none" c:type="void"/>
22955           </return-value>
22956           <parameters>
22957             <parameter name="monitor" transfer-ownership="none">
22958               <type name="FileMonitor" c:type="GFileMonitor*"/>
22959             </parameter>
22960             <parameter name="file" transfer-ownership="none">
22961               <type name="File" c:type="GFile*"/>
22962             </parameter>
22963             <parameter name="other_file" transfer-ownership="none">
22964               <type name="File" c:type="GFile*"/>
22965             </parameter>
22966             <parameter name="event_type" transfer-ownership="none">
22967               <type name="FileMonitorEvent" c:type="GFileMonitorEvent"/>
22968             </parameter>
22969           </parameters>
22970         </callback>
22971       </field>
22972       <field name="cancel">
22973         <callback name="cancel">
22974           <return-value transfer-ownership="none">
22975             <doc xml:whitespace="preserve">%TRUE if monitor was cancelled.</doc>
22976             <type name="gboolean" c:type="gboolean"/>
22977           </return-value>
22978           <parameters>
22979             <parameter name="monitor" transfer-ownership="none">
22980               <type name="FileMonitor" c:type="GFileMonitor*"/>
22981             </parameter>
22982           </parameters>
22983         </callback>
22984       </field>
22985       <field name="_g_reserved1" introspectable="0">
22986         <callback name="_g_reserved1">
22987           <return-value transfer-ownership="none">
22988             <type name="none" c:type="void"/>
22989           </return-value>
22990         </callback>
22991       </field>
22992       <field name="_g_reserved2" introspectable="0">
22993         <callback name="_g_reserved2">
22994           <return-value transfer-ownership="none">
22995             <type name="none" c:type="void"/>
22996           </return-value>
22997         </callback>
22998       </field>
22999       <field name="_g_reserved3" introspectable="0">
23000         <callback name="_g_reserved3">
23001           <return-value transfer-ownership="none">
23002             <type name="none" c:type="void"/>
23003           </return-value>
23004         </callback>
23005       </field>
23006       <field name="_g_reserved4" introspectable="0">
23007         <callback name="_g_reserved4">
23008           <return-value transfer-ownership="none">
23009             <type name="none" c:type="void"/>
23010           </return-value>
23011         </callback>
23012       </field>
23013       <field name="_g_reserved5" introspectable="0">
23014         <callback name="_g_reserved5">
23015           <return-value transfer-ownership="none">
23016             <type name="none" c:type="void"/>
23017           </return-value>
23018         </callback>
23019       </field>
23020     </record>
23021     <enumeration name="FileMonitorEvent"
23022                  glib:type-name="GFileMonitorEvent"
23023                  glib:get-type="g_file_monitor_event_get_type"
23024                  c:type="GFileMonitorEvent">
23025       <doc xml:whitespace="preserve">Specifies what type of event a monitor event is.</doc>
23026       <member name="changed"
23027               value="0"
23028               c:identifier="G_FILE_MONITOR_EVENT_CHANGED"
23029               glib:nick="changed"/>
23030       <member name="changes_done_hint"
23031               value="1"
23032               c:identifier="G_FILE_MONITOR_EVENT_CHANGES_DONE_HINT"
23033               glib:nick="changes-done-hint"/>
23034       <member name="deleted"
23035               value="2"
23036               c:identifier="G_FILE_MONITOR_EVENT_DELETED"
23037               glib:nick="deleted"/>
23038       <member name="created"
23039               value="3"
23040               c:identifier="G_FILE_MONITOR_EVENT_CREATED"
23041               glib:nick="created"/>
23042       <member name="attribute_changed"
23043               value="4"
23044               c:identifier="G_FILE_MONITOR_EVENT_ATTRIBUTE_CHANGED"
23045               glib:nick="attribute-changed"/>
23046       <member name="pre_unmount"
23047               value="5"
23048               c:identifier="G_FILE_MONITOR_EVENT_PRE_UNMOUNT"
23049               glib:nick="pre-unmount"/>
23050       <member name="unmounted"
23051               value="6"
23052               c:identifier="G_FILE_MONITOR_EVENT_UNMOUNTED"
23053               glib:nick="unmounted"/>
23054       <member name="moved"
23055               value="7"
23056               c:identifier="G_FILE_MONITOR_EVENT_MOVED"
23057               glib:nick="moved"/>
23058     </enumeration>
23059     <bitfield name="FileMonitorFlags"
23060               glib:type-name="GFileMonitorFlags"
23061               glib:get-type="g_file_monitor_flags_get_type"
23062               c:type="GFileMonitorFlags">
23063       <doc xml:whitespace="preserve">Flags used to set what a #GFileMonitor will watch for.</doc>
23064       <member name="none"
23065               value="0"
23066               c:identifier="G_FILE_MONITOR_NONE"
23067               glib:nick="none"/>
23068       <member name="watch_mounts"
23069               value="1"
23070               c:identifier="G_FILE_MONITOR_WATCH_MOUNTS"
23071               glib:nick="watch-mounts"/>
23072       <member name="send_moved"
23073               value="2"
23074               c:identifier="G_FILE_MONITOR_SEND_MOVED"
23075               glib:nick="send-moved"/>
23076     </bitfield>
23077     <record name="FileMonitorPrivate"
23078             c:type="GFileMonitorPrivate"
23079             disguised="1">
23080     </record>
23081     <class name="FileOutputStream"
23082            c:symbol-prefix="file_output_stream"
23083            c:type="GFileOutputStream"
23084            parent="OutputStream"
23085            glib:type-name="GFileOutputStream"
23086            glib:get-type="g_file_output_stream_get_type"
23087            glib:type-struct="FileOutputStreamClass">
23088       <doc xml:whitespace="preserve">A subclass of GOutputStream for opened files. This adds
23089 a few file-specific operations and seeking and truncating.
23090 #GFileOutputStream implements GSeekable.</doc>
23091       <implements name="Seekable"/>
23092       <virtual-method name="can_seek">
23093         <return-value transfer-ownership="none">
23094           <type name="gboolean" c:type="gboolean"/>
23095         </return-value>
23096       </virtual-method>
23097       <virtual-method name="can_truncate">
23098         <return-value transfer-ownership="none">
23099           <type name="gboolean" c:type="gboolean"/>
23100         </return-value>
23101       </virtual-method>
23102       <virtual-method name="get_etag" invoker="get_etag">
23103         <doc xml:whitespace="preserve">Gets the entity tag for the file when it has been written.
23104 This must be called after the stream has been written
23105 and closed, as the etag can change while writing.</doc>
23106         <return-value transfer-ownership="full">
23107           <doc xml:whitespace="preserve">the entity tag for the stream.</doc>
23108           <type name="utf8" c:type="char*"/>
23109         </return-value>
23110       </virtual-method>
23111       <virtual-method name="query_info" invoker="query_info" throws="1">
23112         <doc xml:whitespace="preserve">Queries a file output stream for the given @attributes.
23113 This function blocks while querying the stream. For the asynchronous
23114 version of this function, see g_file_output_stream_query_info_async().
23115 While the stream is blocked, the stream will set the pending flag
23116 internally, and any other operations on the stream will fail with
23117 %G_IO_ERROR_PENDING.
23118 Can fail if the stream was already closed (with @error being set to
23119 %G_IO_ERROR_CLOSED), the stream has pending operations (with @error being
23120 set to %G_IO_ERROR_PENDING), or if querying info is not supported for
23121 the stream's interface (with @error being set to %G_IO_ERROR_NOT_SUPPORTED). In
23122 all cases of failure, %NULL will be returned.
23123 If @cancellable is not %NULL, then the operation can be cancelled by
23124 triggering the cancellable object from another thread. If the operation
23125 was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will
23126 be returned.</doc>
23127         <return-value transfer-ownership="full">
23128           <doc xml:whitespace="preserve">a #GFileInfo for the @stream, or %NULL on error.</doc>
23129           <type name="FileInfo" c:type="GFileInfo*"/>
23130         </return-value>
23131         <parameters>
23132           <parameter name="attributes" transfer-ownership="none">
23133             <doc xml:whitespace="preserve">a file attribute query string.</doc>
23134             <type name="utf8" c:type="char*"/>
23135           </parameter>
23136           <parameter name="cancellable"
23137                      transfer-ownership="none"
23138                      allow-none="1">
23139             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
23140             <type name="Cancellable" c:type="GCancellable*"/>
23141           </parameter>
23142         </parameters>
23143       </virtual-method>
23144       <virtual-method name="query_info_async" invoker="query_info_async">
23145         <doc xml:whitespace="preserve">Asynchronously queries the @stream for a #GFileInfo. When completed,
23146 finish the operation with g_file_output_stream_query_info_finish().
23147 For the synchronous version of this function, see
23148 g_file_output_stream_query_info().</doc>
23149         <return-value transfer-ownership="none">
23150           <type name="none" c:type="void"/>
23151         </return-value>
23152         <parameters>
23153           <parameter name="attributes" transfer-ownership="none">
23154             <doc xml:whitespace="preserve">a file attribute query string.</doc>
23155             <type name="utf8" c:type="char*"/>
23156           </parameter>
23157           <parameter name="io_priority" transfer-ownership="none">
23158             <doc xml:whitespace="preserve">the &lt;link linkend="gio-GIOScheduler"&gt;I/O priority&lt;/link&gt; of the request.</doc>
23159             <type name="gint" c:type="int"/>
23160           </parameter>
23161           <parameter name="cancellable"
23162                      transfer-ownership="none"
23163                      allow-none="1">
23164             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
23165             <type name="Cancellable" c:type="GCancellable*"/>
23166           </parameter>
23167           <parameter name="callback"
23168                      transfer-ownership="none"
23169                      scope="async"
23170                      closure="4">
23171             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
23172             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
23173           </parameter>
23174           <parameter name="user_data" transfer-ownership="none" closure="4">
23175             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
23176             <type name="gpointer" c:type="gpointer"/>
23177           </parameter>
23178         </parameters>
23179       </virtual-method>
23180       <virtual-method name="query_info_finish"
23181                       invoker="query_info_finish"
23182                       throws="1">
23183         <doc xml:whitespace="preserve">Finalizes the asynchronous query started
23184 by g_file_output_stream_query_info_async().</doc>
23185         <return-value transfer-ownership="full">
23186           <doc xml:whitespace="preserve">A #GFileInfo for the finished query.</doc>
23187           <type name="FileInfo" c:type="GFileInfo*"/>
23188         </return-value>
23189         <parameters>
23190           <parameter name="res" transfer-ownership="none">
23191             <type name="AsyncResult" c:type="GAsyncResult*"/>
23192           </parameter>
23193         </parameters>
23194       </virtual-method>
23195       <virtual-method name="seek" throws="1">
23196         <return-value transfer-ownership="none">
23197           <type name="gboolean" c:type="gboolean"/>
23198         </return-value>
23199         <parameters>
23200           <parameter name="offset" transfer-ownership="none">
23201             <type name="gint64" c:type="goffset"/>
23202           </parameter>
23203           <parameter name="type" transfer-ownership="none">
23204             <type name="GLib.SeekType" c:type="GSeekType"/>
23205           </parameter>
23206           <parameter name="cancellable" transfer-ownership="none">
23207             <type name="Cancellable" c:type="GCancellable*"/>
23208           </parameter>
23209         </parameters>
23210       </virtual-method>
23211       <virtual-method name="tell">
23212         <return-value transfer-ownership="none">
23213           <type name="gint64" c:type="goffset"/>
23214         </return-value>
23215       </virtual-method>
23216       <virtual-method name="truncate_fn" throws="1">
23217         <return-value transfer-ownership="none">
23218           <type name="gboolean" c:type="gboolean"/>
23219         </return-value>
23220         <parameters>
23221           <parameter name="size" transfer-ownership="none">
23222             <type name="gint64" c:type="goffset"/>
23223           </parameter>
23224           <parameter name="cancellable" transfer-ownership="none">
23225             <type name="Cancellable" c:type="GCancellable*"/>
23226           </parameter>
23227         </parameters>
23228       </virtual-method>
23229       <method name="get_etag" c:identifier="g_file_output_stream_get_etag">
23230         <doc xml:whitespace="preserve">Gets the entity tag for the file when it has been written.
23231 This must be called after the stream has been written
23232 and closed, as the etag can change while writing.</doc>
23233         <return-value transfer-ownership="full">
23234           <doc xml:whitespace="preserve">the entity tag for the stream.</doc>
23235           <type name="utf8" c:type="char*"/>
23236         </return-value>
23237       </method>
23238       <method name="query_info"
23239               c:identifier="g_file_output_stream_query_info"
23240               throws="1">
23241         <doc xml:whitespace="preserve">Queries a file output stream for the given @attributes.
23242 This function blocks while querying the stream. For the asynchronous
23243 version of this function, see g_file_output_stream_query_info_async().
23244 While the stream is blocked, the stream will set the pending flag
23245 internally, and any other operations on the stream will fail with
23246 %G_IO_ERROR_PENDING.
23247 Can fail if the stream was already closed (with @error being set to
23248 %G_IO_ERROR_CLOSED), the stream has pending operations (with @error being
23249 set to %G_IO_ERROR_PENDING), or if querying info is not supported for
23250 the stream's interface (with @error being set to %G_IO_ERROR_NOT_SUPPORTED). In
23251 all cases of failure, %NULL will be returned.
23252 If @cancellable is not %NULL, then the operation can be cancelled by
23253 triggering the cancellable object from another thread. If the operation
23254 was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will
23255 be returned.</doc>
23256         <return-value transfer-ownership="full">
23257           <doc xml:whitespace="preserve">a #GFileInfo for the @stream, or %NULL on error.</doc>
23258           <type name="FileInfo" c:type="GFileInfo*"/>
23259         </return-value>
23260         <parameters>
23261           <parameter name="attributes" transfer-ownership="none">
23262             <doc xml:whitespace="preserve">a file attribute query string.</doc>
23263             <type name="utf8" c:type="char*"/>
23264           </parameter>
23265           <parameter name="cancellable"
23266                      transfer-ownership="none"
23267                      allow-none="1">
23268             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
23269             <type name="Cancellable" c:type="GCancellable*"/>
23270           </parameter>
23271         </parameters>
23272       </method>
23273       <method name="query_info_async"
23274               c:identifier="g_file_output_stream_query_info_async">
23275         <doc xml:whitespace="preserve">Asynchronously queries the @stream for a #GFileInfo. When completed,
23276 finish the operation with g_file_output_stream_query_info_finish().
23277 For the synchronous version of this function, see
23278 g_file_output_stream_query_info().</doc>
23279         <return-value transfer-ownership="none">
23280           <type name="none" c:type="void"/>
23281         </return-value>
23282         <parameters>
23283           <parameter name="attributes" transfer-ownership="none">
23284             <doc xml:whitespace="preserve">a file attribute query string.</doc>
23285             <type name="utf8" c:type="char*"/>
23286           </parameter>
23287           <parameter name="io_priority" transfer-ownership="none">
23288             <doc xml:whitespace="preserve">the &lt;link linkend="gio-GIOScheduler"&gt;I/O priority&lt;/link&gt; of the request.</doc>
23289             <type name="gint" c:type="int"/>
23290           </parameter>
23291           <parameter name="cancellable"
23292                      transfer-ownership="none"
23293                      allow-none="1">
23294             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
23295             <type name="Cancellable" c:type="GCancellable*"/>
23296           </parameter>
23297           <parameter name="callback"
23298                      transfer-ownership="none"
23299                      scope="async"
23300                      closure="4">
23301             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
23302             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
23303           </parameter>
23304           <parameter name="user_data" transfer-ownership="none">
23305             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
23306             <type name="gpointer" c:type="gpointer"/>
23307           </parameter>
23308         </parameters>
23309       </method>
23310       <method name="query_info_finish"
23311               c:identifier="g_file_output_stream_query_info_finish"
23312               throws="1">
23313         <doc xml:whitespace="preserve">Finalizes the asynchronous query started
23314 by g_file_output_stream_query_info_async().</doc>
23315         <return-value transfer-ownership="full">
23316           <doc xml:whitespace="preserve">A #GFileInfo for the finished query.</doc>
23317           <type name="FileInfo" c:type="GFileInfo*"/>
23318         </return-value>
23319         <parameters>
23320           <parameter name="result" transfer-ownership="none">
23321             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
23322             <type name="AsyncResult" c:type="GAsyncResult*"/>
23323           </parameter>
23324         </parameters>
23325       </method>
23326       <field name="parent_instance">
23327         <type name="OutputStream" c:type="GOutputStream"/>
23328       </field>
23329       <field name="priv">
23330         <type name="FileOutputStreamPrivate"
23331               c:type="GFileOutputStreamPrivate*"/>
23332       </field>
23333     </class>
23334     <record name="FileOutputStreamClass"
23335             c:type="GFileOutputStreamClass"
23336             glib:is-gtype-struct-for="FileOutputStream">
23337       <field name="parent_class">
23338         <type name="OutputStreamClass" c:type="GOutputStreamClass"/>
23339       </field>
23340       <field name="tell">
23341         <callback name="tell">
23342           <return-value transfer-ownership="none">
23343             <type name="gint64" c:type="goffset"/>
23344           </return-value>
23345           <parameters>
23346             <parameter name="stream" transfer-ownership="none">
23347               <type name="FileOutputStream" c:type="GFileOutputStream*"/>
23348             </parameter>
23349           </parameters>
23350         </callback>
23351       </field>
23352       <field name="can_seek">
23353         <callback name="can_seek">
23354           <return-value transfer-ownership="none">
23355             <type name="gboolean" c:type="gboolean"/>
23356           </return-value>
23357           <parameters>
23358             <parameter name="stream" transfer-ownership="none">
23359               <type name="FileOutputStream" c:type="GFileOutputStream*"/>
23360             </parameter>
23361           </parameters>
23362         </callback>
23363       </field>
23364       <field name="seek">
23365         <callback name="seek" throws="1">
23366           <return-value transfer-ownership="none">
23367             <type name="gboolean" c:type="gboolean"/>
23368           </return-value>
23369           <parameters>
23370             <parameter name="stream" transfer-ownership="none">
23371               <type name="FileOutputStream" c:type="GFileOutputStream*"/>
23372             </parameter>
23373             <parameter name="offset" transfer-ownership="none">
23374               <type name="gint64" c:type="goffset"/>
23375             </parameter>
23376             <parameter name="type" transfer-ownership="none">
23377               <type name="GLib.SeekType" c:type="GSeekType"/>
23378             </parameter>
23379             <parameter name="cancellable" transfer-ownership="none">
23380               <type name="Cancellable" c:type="GCancellable*"/>
23381             </parameter>
23382           </parameters>
23383         </callback>
23384       </field>
23385       <field name="can_truncate">
23386         <callback name="can_truncate">
23387           <return-value transfer-ownership="none">
23388             <type name="gboolean" c:type="gboolean"/>
23389           </return-value>
23390           <parameters>
23391             <parameter name="stream" transfer-ownership="none">
23392               <type name="FileOutputStream" c:type="GFileOutputStream*"/>
23393             </parameter>
23394           </parameters>
23395         </callback>
23396       </field>
23397       <field name="truncate_fn">
23398         <callback name="truncate_fn" throws="1">
23399           <return-value transfer-ownership="none">
23400             <type name="gboolean" c:type="gboolean"/>
23401           </return-value>
23402           <parameters>
23403             <parameter name="stream" transfer-ownership="none">
23404               <type name="FileOutputStream" c:type="GFileOutputStream*"/>
23405             </parameter>
23406             <parameter name="size" transfer-ownership="none">
23407               <type name="gint64" c:type="goffset"/>
23408             </parameter>
23409             <parameter name="cancellable" transfer-ownership="none">
23410               <type name="Cancellable" c:type="GCancellable*"/>
23411             </parameter>
23412           </parameters>
23413         </callback>
23414       </field>
23415       <field name="query_info">
23416         <callback name="query_info" throws="1">
23417           <return-value transfer-ownership="full">
23418             <doc xml:whitespace="preserve">a #GFileInfo for the @stream, or %NULL on error.</doc>
23419             <type name="FileInfo" c:type="GFileInfo*"/>
23420           </return-value>
23421           <parameters>
23422             <parameter name="stream" transfer-ownership="none">
23423               <type name="FileOutputStream" c:type="GFileOutputStream*"/>
23424             </parameter>
23425             <parameter name="attributes" transfer-ownership="none">
23426               <doc xml:whitespace="preserve">a file attribute query string.</doc>
23427               <type name="utf8" c:type="char*"/>
23428             </parameter>
23429             <parameter name="cancellable"
23430                        transfer-ownership="none"
23431                        allow-none="1">
23432               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
23433               <type name="Cancellable" c:type="GCancellable*"/>
23434             </parameter>
23435           </parameters>
23436         </callback>
23437       </field>
23438       <field name="query_info_async">
23439         <callback name="query_info_async">
23440           <return-value transfer-ownership="none">
23441             <type name="none" c:type="void"/>
23442           </return-value>
23443           <parameters>
23444             <parameter name="stream" transfer-ownership="none">
23445               <type name="FileOutputStream" c:type="GFileOutputStream*"/>
23446             </parameter>
23447             <parameter name="attributes" transfer-ownership="none">
23448               <doc xml:whitespace="preserve">a file attribute query string.</doc>
23449               <type name="utf8" c:type="char*"/>
23450             </parameter>
23451             <parameter name="io_priority" transfer-ownership="none">
23452               <doc xml:whitespace="preserve">the &lt;link linkend="gio-GIOScheduler"&gt;I/O priority&lt;/link&gt; of the request.</doc>
23453               <type name="gint" c:type="int"/>
23454             </parameter>
23455             <parameter name="cancellable"
23456                        transfer-ownership="none"
23457                        allow-none="1">
23458               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
23459               <type name="Cancellable" c:type="GCancellable*"/>
23460             </parameter>
23461             <parameter name="callback"
23462                        transfer-ownership="none"
23463                        scope="async"
23464                        closure="5">
23465               <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
23466               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
23467             </parameter>
23468             <parameter name="user_data" transfer-ownership="none" closure="5">
23469               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
23470               <type name="gpointer" c:type="gpointer"/>
23471             </parameter>
23472           </parameters>
23473         </callback>
23474       </field>
23475       <field name="query_info_finish">
23476         <callback name="query_info_finish" throws="1">
23477           <return-value transfer-ownership="full">
23478             <doc xml:whitespace="preserve">A #GFileInfo for the finished query.</doc>
23479             <type name="FileInfo" c:type="GFileInfo*"/>
23480           </return-value>
23481           <parameters>
23482             <parameter name="stream" transfer-ownership="none">
23483               <type name="FileOutputStream" c:type="GFileOutputStream*"/>
23484             </parameter>
23485             <parameter name="res" transfer-ownership="none">
23486               <type name="AsyncResult" c:type="GAsyncResult*"/>
23487             </parameter>
23488           </parameters>
23489         </callback>
23490       </field>
23491       <field name="get_etag">
23492         <callback name="get_etag">
23493           <return-value transfer-ownership="full">
23494             <doc xml:whitespace="preserve">the entity tag for the stream.</doc>
23495             <type name="utf8" c:type="char*"/>
23496           </return-value>
23497           <parameters>
23498             <parameter name="stream" transfer-ownership="none">
23499               <type name="FileOutputStream" c:type="GFileOutputStream*"/>
23500             </parameter>
23501           </parameters>
23502         </callback>
23503       </field>
23504       <field name="_g_reserved1" introspectable="0">
23505         <callback name="_g_reserved1">
23506           <return-value transfer-ownership="none">
23507             <type name="none" c:type="void"/>
23508           </return-value>
23509         </callback>
23510       </field>
23511       <field name="_g_reserved2" introspectable="0">
23512         <callback name="_g_reserved2">
23513           <return-value transfer-ownership="none">
23514             <type name="none" c:type="void"/>
23515           </return-value>
23516         </callback>
23517       </field>
23518       <field name="_g_reserved3" introspectable="0">
23519         <callback name="_g_reserved3">
23520           <return-value transfer-ownership="none">
23521             <type name="none" c:type="void"/>
23522           </return-value>
23523         </callback>
23524       </field>
23525       <field name="_g_reserved4" introspectable="0">
23526         <callback name="_g_reserved4">
23527           <return-value transfer-ownership="none">
23528             <type name="none" c:type="void"/>
23529           </return-value>
23530         </callback>
23531       </field>
23532       <field name="_g_reserved5" introspectable="0">
23533         <callback name="_g_reserved5">
23534           <return-value transfer-ownership="none">
23535             <type name="none" c:type="void"/>
23536           </return-value>
23537         </callback>
23538       </field>
23539     </record>
23540     <record name="FileOutputStreamPrivate"
23541             c:type="GFileOutputStreamPrivate"
23542             disguised="1">
23543     </record>
23544     <callback name="FileProgressCallback" c:type="GFileProgressCallback">
23545       <doc xml:whitespace="preserve">When doing file operations that may take a while, such as moving
23546 a file or copying a file, a progress callback is used to pass how
23547 far along that operation is to the application.</doc>
23548       <return-value transfer-ownership="none">
23549         <type name="none" c:type="void"/>
23550       </return-value>
23551       <parameters>
23552         <parameter name="current_num_bytes" transfer-ownership="none">
23553           <doc xml:whitespace="preserve">the current number of bytes in the operation.</doc>
23554           <type name="gint64" c:type="goffset"/>
23555         </parameter>
23556         <parameter name="total_num_bytes" transfer-ownership="none">
23557           <doc xml:whitespace="preserve">the total number of bytes in the operation.</doc>
23558           <type name="gint64" c:type="goffset"/>
23559         </parameter>
23560         <parameter name="user_data" transfer-ownership="none" closure="2">
23561           <doc xml:whitespace="preserve">user data passed to the callback.</doc>
23562           <type name="gpointer" c:type="gpointer"/>
23563         </parameter>
23564       </parameters>
23565     </callback>
23566     <bitfield name="FileQueryInfoFlags"
23567               glib:type-name="GFileQueryInfoFlags"
23568               glib:get-type="g_file_query_info_flags_get_type"
23569               c:type="GFileQueryInfoFlags">
23570       <doc xml:whitespace="preserve">Flags used when querying a #GFileInfo.</doc>
23571       <member name="none"
23572               value="0"
23573               c:identifier="G_FILE_QUERY_INFO_NONE"
23574               glib:nick="none"/>
23575       <member name="nofollow_symlinks"
23576               value="1"
23577               c:identifier="G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS"
23578               glib:nick="nofollow-symlinks"/>
23579     </bitfield>
23580     <callback name="FileReadMoreCallback" c:type="GFileReadMoreCallback">
23581       <doc xml:whitespace="preserve">When loading the partial contents of a file with g_file_load_partial_contents_async(),
23582 it may become necessary to determine if any more data from the file should be loaded.
23583 A #GFileReadMoreCallback function facilitates this by returning %TRUE if more data
23584 should be read, or %FALSE otherwise.</doc>
23585       <return-value transfer-ownership="none">
23586         <doc xml:whitespace="preserve">%TRUE if more data should be read back. %FALSE otherwise.</doc>
23587         <type name="gboolean" c:type="gboolean"/>
23588       </return-value>
23589       <parameters>
23590         <parameter name="file_contents" transfer-ownership="none">
23591           <doc xml:whitespace="preserve">the data as currently read.</doc>
23592           <type name="utf8" c:type="char*"/>
23593         </parameter>
23594         <parameter name="file_size" transfer-ownership="none">
23595           <doc xml:whitespace="preserve">the size of the data currently read.</doc>
23596           <type name="gint64" c:type="goffset"/>
23597         </parameter>
23598         <parameter name="callback_data" transfer-ownership="none">
23599           <doc xml:whitespace="preserve">data passed to the callback.</doc>
23600           <type name="gpointer" c:type="gpointer"/>
23601         </parameter>
23602       </parameters>
23603     </callback>
23604     <enumeration name="FileType"
23605                  glib:type-name="GFileType"
23606                  glib:get-type="g_file_type_get_type"
23607                  c:type="GFileType">
23608       <doc xml:whitespace="preserve">Indicates the file's on-disk type.</doc>
23609       <member name="unknown"
23610               value="0"
23611               c:identifier="G_FILE_TYPE_UNKNOWN"
23612               glib:nick="unknown"/>
23613       <member name="regular"
23614               value="1"
23615               c:identifier="G_FILE_TYPE_REGULAR"
23616               glib:nick="regular"/>
23617       <member name="directory"
23618               value="2"
23619               c:identifier="G_FILE_TYPE_DIRECTORY"
23620               glib:nick="directory"/>
23621       <member name="symbolic_link"
23622               value="3"
23623               c:identifier="G_FILE_TYPE_SYMBOLIC_LINK"
23624               glib:nick="symbolic-link"/>
23625       <member name="special"
23626               value="4"
23627               c:identifier="G_FILE_TYPE_SPECIAL"
23628               glib:nick="special"/>
23629       <member name="shortcut"
23630               value="5"
23631               c:identifier="G_FILE_TYPE_SHORTCUT"
23632               glib:nick="shortcut"/>
23633       <member name="mountable"
23634               value="6"
23635               c:identifier="G_FILE_TYPE_MOUNTABLE"
23636               glib:nick="mountable"/>
23637     </enumeration>
23638     <class name="FilenameCompleter"
23639            c:symbol-prefix="filename_completer"
23640            c:type="GFilenameCompleter"
23641            parent="GObject.Object"
23642            glib:type-name="GFilenameCompleter"
23643            glib:get-type="g_filename_completer_get_type"
23644            glib:type-struct="FilenameCompleterClass">
23645       <doc xml:whitespace="preserve">Completes filenames based on files that exist within the file system.</doc>
23646       <constructor name="new" c:identifier="g_filename_completer_new">
23647         <doc xml:whitespace="preserve">Creates a new filename completer.</doc>
23648         <return-value transfer-ownership="full">
23649           <doc xml:whitespace="preserve">a #GFilenameCompleter.</doc>
23650           <type name="FilenameCompleter" c:type="GFilenameCompleter*"/>
23651         </return-value>
23652       </constructor>
23653       <method name="get_completion_suffix"
23654               c:identifier="g_filename_completer_get_completion_suffix">
23655         <doc xml:whitespace="preserve">Obtains a completion for @initial_text from @completer.
23656 This string is not owned by GIO, so remember to g_free() it
23657 when finished.</doc>
23658         <return-value transfer-ownership="full">
23659           <doc xml:whitespace="preserve">a completed string, or %NULL if no completion exists.</doc>
23660           <type name="utf8" c:type="char*"/>
23661         </return-value>
23662         <parameters>
23663           <parameter name="initial_text" transfer-ownership="none">
23664             <doc xml:whitespace="preserve">text to be completed.</doc>
23665             <type name="utf8" c:type="char*"/>
23666           </parameter>
23667         </parameters>
23668       </method>
23669       <method name="get_completions"
23670               c:identifier="g_filename_completer_get_completions">
23671         <doc xml:whitespace="preserve">Gets an array of completion strings for a given initial text.
23672 This array must be freed by g_strfreev() when finished.</doc>
23673         <return-value transfer-ownership="full">
23674           <doc xml:whitespace="preserve">array of strings with possible completions for @initial_text.</doc>
23675           <array c:type="char**">
23676             <type name="utf8"/>
23677           </array>
23678         </return-value>
23679         <parameters>
23680           <parameter name="initial_text" transfer-ownership="none">
23681             <doc xml:whitespace="preserve">text to be completed.</doc>
23682             <type name="utf8" c:type="char*"/>
23683           </parameter>
23684         </parameters>
23685       </method>
23686       <method name="set_dirs_only"
23687               c:identifier="g_filename_completer_set_dirs_only">
23688         <doc xml:whitespace="preserve">If @dirs_only is %TRUE, @completer will only
23689 complete directory names, and not file names.</doc>
23690         <return-value transfer-ownership="none">
23691           <type name="none" c:type="void"/>
23692         </return-value>
23693         <parameters>
23694           <parameter name="dirs_only" transfer-ownership="none">
23695             <doc xml:whitespace="preserve">a #gboolean.</doc>
23696             <type name="gboolean" c:type="gboolean"/>
23697           </parameter>
23698         </parameters>
23699       </method>
23700       <glib:signal name="got-completion-data">
23701         <doc xml:whitespace="preserve">Emitted when the file name completion information comes available.</doc>
23702         <return-value transfer-ownership="none">
23703           <type name="none"/>
23704         </return-value>
23705       </glib:signal>
23706     </class>
23707     <record name="FilenameCompleterClass"
23708             c:type="GFilenameCompleterClass"
23709             glib:is-gtype-struct-for="FilenameCompleter">
23710       <field name="parent_class">
23711         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
23712       </field>
23713       <field name="got_completion_data">
23714         <callback name="got_completion_data">
23715           <return-value transfer-ownership="none">
23716             <type name="none" c:type="void"/>
23717           </return-value>
23718           <parameters>
23719             <parameter name="filename_completer" transfer-ownership="none">
23720               <type name="FilenameCompleter" c:type="GFilenameCompleter*"/>
23721             </parameter>
23722           </parameters>
23723         </callback>
23724       </field>
23725       <field name="_g_reserved1" introspectable="0">
23726         <callback name="_g_reserved1">
23727           <return-value transfer-ownership="none">
23728             <type name="none" c:type="void"/>
23729           </return-value>
23730         </callback>
23731       </field>
23732       <field name="_g_reserved2" introspectable="0">
23733         <callback name="_g_reserved2">
23734           <return-value transfer-ownership="none">
23735             <type name="none" c:type="void"/>
23736           </return-value>
23737         </callback>
23738       </field>
23739       <field name="_g_reserved3" introspectable="0">
23740         <callback name="_g_reserved3">
23741           <return-value transfer-ownership="none">
23742             <type name="none" c:type="void"/>
23743           </return-value>
23744         </callback>
23745       </field>
23746     </record>
23747     <enumeration name="FilesystemPreviewType"
23748                  glib:type-name="GFilesystemPreviewType"
23749                  glib:get-type="g_filesystem_preview_type_get_type"
23750                  c:type="GFilesystemPreviewType">
23751       <doc xml:whitespace="preserve">Indicates a hint from the file system whether files should be
23752 previewed in a file manager. Returned as the value of the key
23753 #G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW.</doc>
23754       <member name="if_always"
23755               value="0"
23756               c:identifier="G_FILESYSTEM_PREVIEW_TYPE_IF_ALWAYS"
23757               glib:nick="if-always"/>
23758       <member name="if_local"
23759               value="1"
23760               c:identifier="G_FILESYSTEM_PREVIEW_TYPE_IF_LOCAL"
23761               glib:nick="if-local"/>
23762       <member name="never"
23763               value="2"
23764               c:identifier="G_FILESYSTEM_PREVIEW_TYPE_NEVER"
23765               glib:nick="never"/>
23766     </enumeration>
23767     <class name="FilterInputStream"
23768            c:symbol-prefix="filter_input_stream"
23769            c:type="GFilterInputStream"
23770            parent="InputStream"
23771            abstract="1"
23772            glib:type-name="GFilterInputStream"
23773            glib:get-type="g_filter_input_stream_get_type"
23774            glib:type-struct="FilterInputStreamClass">
23775       <doc xml:whitespace="preserve">A base class for all input streams that work on an underlying stream.</doc>
23776       <method name="get_base_stream"
23777               c:identifier="g_filter_input_stream_get_base_stream">
23778         <doc xml:whitespace="preserve">Gets the base stream for the filter stream.</doc>
23779         <return-value transfer-ownership="none">
23780           <doc xml:whitespace="preserve">a #GInputStream.</doc>
23781           <type name="InputStream" c:type="GInputStream*"/>
23782         </return-value>
23783       </method>
23784       <method name="get_close_base_stream"
23785               c:identifier="g_filter_input_stream_get_close_base_stream">
23786         <doc xml:whitespace="preserve">Returns whether the base stream will be closed when @stream is
23787 closed.</doc>
23788         <return-value transfer-ownership="none">
23789           <doc xml:whitespace="preserve">%TRUE if the base stream will be closed.</doc>
23790           <type name="gboolean" c:type="gboolean"/>
23791         </return-value>
23792       </method>
23793       <method name="set_close_base_stream"
23794               c:identifier="g_filter_input_stream_set_close_base_stream">
23795         <doc xml:whitespace="preserve">Sets whether the base stream will be closed when @stream is closed.</doc>
23796         <return-value transfer-ownership="none">
23797           <type name="none" c:type="void"/>
23798         </return-value>
23799         <parameters>
23800           <parameter name="close_base" transfer-ownership="none">
23801             <doc xml:whitespace="preserve">%TRUE to close the base stream.</doc>
23802             <type name="gboolean" c:type="gboolean"/>
23803           </parameter>
23804         </parameters>
23805       </method>
23806       <property name="base-stream"
23807                 writable="1"
23808                 construct-only="1"
23809                 transfer-ownership="none">
23810         <type name="InputStream"/>
23811       </property>
23812       <property name="close-base-stream"
23813                 writable="1"
23814                 construct-only="1"
23815                 transfer-ownership="none">
23816         <type name="gboolean"/>
23817       </property>
23818       <field name="parent_instance">
23819         <type name="InputStream" c:type="GInputStream"/>
23820       </field>
23821       <field name="base_stream">
23822         <type name="InputStream" c:type="GInputStream*"/>
23823       </field>
23824     </class>
23825     <record name="FilterInputStreamClass"
23826             c:type="GFilterInputStreamClass"
23827             glib:is-gtype-struct-for="FilterInputStream">
23828       <field name="parent_class">
23829         <type name="InputStreamClass" c:type="GInputStreamClass"/>
23830       </field>
23831       <field name="_g_reserved1" introspectable="0">
23832         <callback name="_g_reserved1">
23833           <return-value transfer-ownership="none">
23834             <type name="none" c:type="void"/>
23835           </return-value>
23836         </callback>
23837       </field>
23838       <field name="_g_reserved2" introspectable="0">
23839         <callback name="_g_reserved2">
23840           <return-value transfer-ownership="none">
23841             <type name="none" c:type="void"/>
23842           </return-value>
23843         </callback>
23844       </field>
23845       <field name="_g_reserved3" introspectable="0">
23846         <callback name="_g_reserved3">
23847           <return-value transfer-ownership="none">
23848             <type name="none" c:type="void"/>
23849           </return-value>
23850         </callback>
23851       </field>
23852     </record>
23853     <class name="FilterOutputStream"
23854            c:symbol-prefix="filter_output_stream"
23855            c:type="GFilterOutputStream"
23856            parent="OutputStream"
23857            abstract="1"
23858            glib:type-name="GFilterOutputStream"
23859            glib:get-type="g_filter_output_stream_get_type"
23860            glib:type-struct="FilterOutputStreamClass">
23861       <doc xml:whitespace="preserve">A base class for all output streams that work on an underlying stream.</doc>
23862       <method name="get_base_stream"
23863               c:identifier="g_filter_output_stream_get_base_stream">
23864         <doc xml:whitespace="preserve">Gets the base stream for the filter stream.</doc>
23865         <return-value transfer-ownership="none">
23866           <doc xml:whitespace="preserve">a #GOutputStream.</doc>
23867           <type name="OutputStream" c:type="GOutputStream*"/>
23868         </return-value>
23869       </method>
23870       <method name="get_close_base_stream"
23871               c:identifier="g_filter_output_stream_get_close_base_stream">
23872         <doc xml:whitespace="preserve">Returns whether the base stream will be closed when @stream is
23873 closed.</doc>
23874         <return-value transfer-ownership="none">
23875           <doc xml:whitespace="preserve">%TRUE if the base stream will be closed.</doc>
23876           <type name="gboolean" c:type="gboolean"/>
23877         </return-value>
23878       </method>
23879       <method name="set_close_base_stream"
23880               c:identifier="g_filter_output_stream_set_close_base_stream">
23881         <doc xml:whitespace="preserve">Sets whether the base stream will be closed when @stream is closed.</doc>
23882         <return-value transfer-ownership="none">
23883           <type name="none" c:type="void"/>
23884         </return-value>
23885         <parameters>
23886           <parameter name="close_base" transfer-ownership="none">
23887             <doc xml:whitespace="preserve">%TRUE to close the base stream.</doc>
23888             <type name="gboolean" c:type="gboolean"/>
23889           </parameter>
23890         </parameters>
23891       </method>
23892       <property name="base-stream"
23893                 writable="1"
23894                 construct-only="1"
23895                 transfer-ownership="none">
23896         <type name="OutputStream"/>
23897       </property>
23898       <property name="close-base-stream"
23899                 writable="1"
23900                 construct-only="1"
23901                 transfer-ownership="none">
23902         <type name="gboolean"/>
23903       </property>
23904       <field name="parent_instance">
23905         <type name="OutputStream" c:type="GOutputStream"/>
23906       </field>
23907       <field name="base_stream">
23908         <type name="OutputStream" c:type="GOutputStream*"/>
23909       </field>
23910     </class>
23911     <record name="FilterOutputStreamClass"
23912             c:type="GFilterOutputStreamClass"
23913             glib:is-gtype-struct-for="FilterOutputStream">
23914       <field name="parent_class">
23915         <type name="OutputStreamClass" c:type="GOutputStreamClass"/>
23916       </field>
23917       <field name="_g_reserved1" introspectable="0">
23918         <callback name="_g_reserved1">
23919           <return-value transfer-ownership="none">
23920             <type name="none" c:type="void"/>
23921           </return-value>
23922         </callback>
23923       </field>
23924       <field name="_g_reserved2" introspectable="0">
23925         <callback name="_g_reserved2">
23926           <return-value transfer-ownership="none">
23927             <type name="none" c:type="void"/>
23928           </return-value>
23929         </callback>
23930       </field>
23931       <field name="_g_reserved3" introspectable="0">
23932         <callback name="_g_reserved3">
23933           <return-value transfer-ownership="none">
23934             <type name="none" c:type="void"/>
23935           </return-value>
23936         </callback>
23937       </field>
23938     </record>
23939     <enumeration name="IOErrorEnum"
23940                  glib:type-name="GIOErrorEnum"
23941                  glib:get-type="g_io_error_enum_get_type"
23942                  c:type="GIOErrorEnum"
23943                  glib:error-quark="g_io_error_quark">
23944       <doc xml:whitespace="preserve">Error codes returned by GIO functions.</doc>
23945       <member name="failed"
23946               value="0"
23947               c:identifier="G_IO_ERROR_FAILED"
23948               glib:nick="failed"/>
23949       <member name="not_found"
23950               value="1"
23951               c:identifier="G_IO_ERROR_NOT_FOUND"
23952               glib:nick="not-found"/>
23953       <member name="exists"
23954               value="2"
23955               c:identifier="G_IO_ERROR_EXISTS"
23956               glib:nick="exists"/>
23957       <member name="is_directory"
23958               value="3"
23959               c:identifier="G_IO_ERROR_IS_DIRECTORY"
23960               glib:nick="is-directory"/>
23961       <member name="not_directory"
23962               value="4"
23963               c:identifier="G_IO_ERROR_NOT_DIRECTORY"
23964               glib:nick="not-directory"/>
23965       <member name="not_empty"
23966               value="5"
23967               c:identifier="G_IO_ERROR_NOT_EMPTY"
23968               glib:nick="not-empty"/>
23969       <member name="not_regular_file"
23970               value="6"
23971               c:identifier="G_IO_ERROR_NOT_REGULAR_FILE"
23972               glib:nick="not-regular-file"/>
23973       <member name="not_symbolic_link"
23974               value="7"
23975               c:identifier="G_IO_ERROR_NOT_SYMBOLIC_LINK"
23976               glib:nick="not-symbolic-link"/>
23977       <member name="not_mountable_file"
23978               value="8"
23979               c:identifier="G_IO_ERROR_NOT_MOUNTABLE_FILE"
23980               glib:nick="not-mountable-file"/>
23981       <member name="filename_too_long"
23982               value="9"
23983               c:identifier="G_IO_ERROR_FILENAME_TOO_LONG"
23984               glib:nick="filename-too-long"/>
23985       <member name="invalid_filename"
23986               value="10"
23987               c:identifier="G_IO_ERROR_INVALID_FILENAME"
23988               glib:nick="invalid-filename"/>
23989       <member name="too_many_links"
23990               value="11"
23991               c:identifier="G_IO_ERROR_TOO_MANY_LINKS"
23992               glib:nick="too-many-links"/>
23993       <member name="no_space"
23994               value="12"
23995               c:identifier="G_IO_ERROR_NO_SPACE"
23996               glib:nick="no-space"/>
23997       <member name="invalid_argument"
23998               value="13"
23999               c:identifier="G_IO_ERROR_INVALID_ARGUMENT"
24000               glib:nick="invalid-argument"/>
24001       <member name="permission_denied"
24002               value="14"
24003               c:identifier="G_IO_ERROR_PERMISSION_DENIED"
24004               glib:nick="permission-denied"/>
24005       <member name="not_supported"
24006               value="15"
24007               c:identifier="G_IO_ERROR_NOT_SUPPORTED"
24008               glib:nick="not-supported"/>
24009       <member name="not_mounted"
24010               value="16"
24011               c:identifier="G_IO_ERROR_NOT_MOUNTED"
24012               glib:nick="not-mounted"/>
24013       <member name="already_mounted"
24014               value="17"
24015               c:identifier="G_IO_ERROR_ALREADY_MOUNTED"
24016               glib:nick="already-mounted"/>
24017       <member name="closed"
24018               value="18"
24019               c:identifier="G_IO_ERROR_CLOSED"
24020               glib:nick="closed"/>
24021       <member name="cancelled"
24022               value="19"
24023               c:identifier="G_IO_ERROR_CANCELLED"
24024               glib:nick="cancelled"/>
24025       <member name="pending"
24026               value="20"
24027               c:identifier="G_IO_ERROR_PENDING"
24028               glib:nick="pending"/>
24029       <member name="read_only"
24030               value="21"
24031               c:identifier="G_IO_ERROR_READ_ONLY"
24032               glib:nick="read-only"/>
24033       <member name="cant_create_backup"
24034               value="22"
24035               c:identifier="G_IO_ERROR_CANT_CREATE_BACKUP"
24036               glib:nick="cant-create-backup"/>
24037       <member name="wrong_etag"
24038               value="23"
24039               c:identifier="G_IO_ERROR_WRONG_ETAG"
24040               glib:nick="wrong-etag"/>
24041       <member name="timed_out"
24042               value="24"
24043               c:identifier="G_IO_ERROR_TIMED_OUT"
24044               glib:nick="timed-out"/>
24045       <member name="would_recurse"
24046               value="25"
24047               c:identifier="G_IO_ERROR_WOULD_RECURSE"
24048               glib:nick="would-recurse"/>
24049       <member name="busy"
24050               value="26"
24051               c:identifier="G_IO_ERROR_BUSY"
24052               glib:nick="busy"/>
24053       <member name="would_block"
24054               value="27"
24055               c:identifier="G_IO_ERROR_WOULD_BLOCK"
24056               glib:nick="would-block"/>
24057       <member name="host_not_found"
24058               value="28"
24059               c:identifier="G_IO_ERROR_HOST_NOT_FOUND"
24060               glib:nick="host-not-found"/>
24061       <member name="would_merge"
24062               value="29"
24063               c:identifier="G_IO_ERROR_WOULD_MERGE"
24064               glib:nick="would-merge"/>
24065       <member name="failed_handled"
24066               value="30"
24067               c:identifier="G_IO_ERROR_FAILED_HANDLED"
24068               glib:nick="failed-handled"/>
24069       <member name="too_many_open_files"
24070               value="31"
24071               c:identifier="G_IO_ERROR_TOO_MANY_OPEN_FILES"
24072               glib:nick="too-many-open-files"/>
24073       <member name="not_initialized"
24074               value="32"
24075               c:identifier="G_IO_ERROR_NOT_INITIALIZED"
24076               glib:nick="not-initialized"/>
24077       <member name="address_in_use"
24078               value="33"
24079               c:identifier="G_IO_ERROR_ADDRESS_IN_USE"
24080               glib:nick="address-in-use"/>
24081       <member name="partial_input"
24082               value="34"
24083               c:identifier="G_IO_ERROR_PARTIAL_INPUT"
24084               glib:nick="partial-input"/>
24085       <member name="invalid_data"
24086               value="35"
24087               c:identifier="G_IO_ERROR_INVALID_DATA"
24088               glib:nick="invalid-data"/>
24089       <member name="dbus_error"
24090               value="36"
24091               c:identifier="G_IO_ERROR_DBUS_ERROR"
24092               glib:nick="dbus-error"/>
24093       <member name="host_unreachable"
24094               value="37"
24095               c:identifier="G_IO_ERROR_HOST_UNREACHABLE"
24096               glib:nick="host-unreachable"/>
24097       <member name="network_unreachable"
24098               value="38"
24099               c:identifier="G_IO_ERROR_NETWORK_UNREACHABLE"
24100               glib:nick="network-unreachable"/>
24101       <member name="connection_refused"
24102               value="39"
24103               c:identifier="G_IO_ERROR_CONNECTION_REFUSED"
24104               glib:nick="connection-refused"/>
24105       <member name="proxy_failed"
24106               value="40"
24107               c:identifier="G_IO_ERROR_PROXY_FAILED"
24108               glib:nick="proxy-failed"/>
24109       <member name="proxy_auth_failed"
24110               value="41"
24111               c:identifier="G_IO_ERROR_PROXY_AUTH_FAILED"
24112               glib:nick="proxy-auth-failed"/>
24113       <member name="proxy_need_auth"
24114               value="42"
24115               c:identifier="G_IO_ERROR_PROXY_NEED_AUTH"
24116               glib:nick="proxy-need-auth"/>
24117       <member name="proxy_not_allowed"
24118               value="43"
24119               c:identifier="G_IO_ERROR_PROXY_NOT_ALLOWED"
24120               glib:nick="proxy-not-allowed"/>
24121     </enumeration>
24122     <record name="IOExtension" c:type="GIOExtension" disguised="1">
24123       <method name="get_name" c:identifier="g_io_extension_get_name">
24124         <doc xml:whitespace="preserve">Gets the name under which @extension was registered.
24125 Note that the same type may be registered as extension
24126 for multiple extension points, under different names.</doc>
24127         <return-value transfer-ownership="none">
24128           <doc xml:whitespace="preserve">the name of @extension.</doc>
24129           <type name="utf8" c:type="char*"/>
24130         </return-value>
24131       </method>
24132       <method name="get_priority" c:identifier="g_io_extension_get_priority">
24133         <doc xml:whitespace="preserve">Gets the priority with which @extension was registered.</doc>
24134         <return-value transfer-ownership="none">
24135           <doc xml:whitespace="preserve">the priority of @extension</doc>
24136           <type name="gint" c:type="gint"/>
24137         </return-value>
24138       </method>
24139       <method name="ref_class"
24140               c:identifier="g_io_extension_ref_class"
24141               introspectable="0">
24142         <doc xml:whitespace="preserve">Gets a reference to the class for the type that is
24143 associated with @extension.</doc>
24144         <return-value transfer-ownership="full">
24145           <doc xml:whitespace="preserve">the #GTypeClass for the type of @extension</doc>
24146           <type name="GObject.TypeClass" c:type="GTypeClass*"/>
24147         </return-value>
24148       </method>
24149     </record>
24150     <record name="IOExtensionPoint" c:type="GIOExtensionPoint" disguised="1">
24151       <method name="get_extension_by_name"
24152               c:identifier="g_io_extension_point_get_extension_by_name">
24153         <doc xml:whitespace="preserve">Finds a #GIOExtension for an extension point by name.
24154 given name, or %NULL if there is no extension with that name</doc>
24155         <return-value transfer-ownership="none">
24156           <doc xml:whitespace="preserve">the #GIOExtension for @extension_point that has the</doc>
24157           <type name="IOExtension" c:type="GIOExtension*"/>
24158         </return-value>
24159         <parameters>
24160           <parameter name="name" transfer-ownership="none">
24161             <doc xml:whitespace="preserve">the name of the extension to get</doc>
24162             <type name="utf8" c:type="char*"/>
24163           </parameter>
24164         </parameters>
24165       </method>
24166       <method name="get_extensions"
24167               c:identifier="g_io_extension_point_get_extensions">
24168         <doc xml:whitespace="preserve">Gets a list of all extensions that implement this extension point.
24169 The list is sorted by priority, beginning with the highest priority.
24170 #GIOExtension&lt;!-- --&gt;s. The list is owned by GIO and should not be
24171 modified.</doc>
24172         <return-value transfer-ownership="none">
24173           <doc xml:whitespace="preserve">a #GList of</doc>
24174           <type name="GLib.List" c:type="GList*">
24175             <type name="IOExtension"/>
24176           </type>
24177         </return-value>
24178       </method>
24179       <method name="get_required_type"
24180               c:identifier="g_io_extension_point_get_required_type">
24181         <doc xml:whitespace="preserve">Gets the required type for @extension_point.
24182 or #G_TYPE_INVALID if the extension point has no required type</doc>
24183         <return-value transfer-ownership="none">
24184           <doc xml:whitespace="preserve">the #GType that all implementations must have,</doc>
24185           <type name="GType" c:type="GType"/>
24186         </return-value>
24187       </method>
24188       <method name="set_required_type"
24189               c:identifier="g_io_extension_point_set_required_type">
24190         <doc xml:whitespace="preserve">Sets the required type for @extension_point to @type.
24191 All implementations must henceforth have this type.</doc>
24192         <return-value transfer-ownership="none">
24193           <type name="none" c:type="void"/>
24194         </return-value>
24195         <parameters>
24196           <parameter name="type" transfer-ownership="none">
24197             <doc xml:whitespace="preserve">the #GType to require</doc>
24198             <type name="GType" c:type="GType"/>
24199           </parameter>
24200         </parameters>
24201       </method>
24202     </record>
24203     <class name="IOModule"
24204            c:symbol-prefix="io_module"
24205            c:type="GIOModule"
24206            parent="GObject.TypeModule"
24207            glib:type-name="GIOModule"
24208            glib:get-type="g_io_module_get_type"
24209            glib:type-struct="IOModuleClass">
24210       <doc xml:whitespace="preserve">Opaque module base class for extending GIO.</doc>
24211       <implements name="GObject.TypePlugin"/>
24212       <constructor name="new" c:identifier="g_io_module_new">
24213         <doc xml:whitespace="preserve">Creates a new GIOModule that will load the specific
24214 shared library when in use.
24215 or %NULL on error.</doc>
24216         <return-value transfer-ownership="full">
24217           <doc xml:whitespace="preserve">a #GIOModule from given @filename,</doc>
24218           <type name="IOModule" c:type="GIOModule*"/>
24219         </return-value>
24220         <parameters>
24221           <parameter name="filename" transfer-ownership="none">
24222             <doc xml:whitespace="preserve">filename of the shared library module.</doc>
24223             <type name="utf8" c:type="gchar*"/>
24224           </parameter>
24225         </parameters>
24226       </constructor>
24227       <function name="query"
24228                 c:identifier="g_io_module_query"
24229                 version="2.24"
24230                 introspectable="0">
24231         <doc xml:whitespace="preserve">Optional API for GIO modules to implement.
24232 Should return a list of all the extension points that may be
24233 implemented in this module.
24234 This method will not be called in normal use, however it may be
24235 called when probing existing modules and recording which extension
24236 points that this modle is used for. This means we won't have to
24237 load and initialze this module unless its needed.
24238 If this function is not implemented by the module the module will
24239 always be loaded, initialized and then unloaded on application startup
24240 so that it can register its extension points during init.
24241 Note that a module need not actually implement all the extension points
24242 that g_io_module_query returns, since the exact list of extension may
24243 depend on runtime issues. However all extension points actually implemented
24244 must be returned by g_io_module_query() (if defined).
24245 When installing a module that implements g_io_module_query you must
24246 run gio-querymodules in order to build the cache files required for
24247 lazy loading.
24248 extension points of the module. The array must be suitable for
24249 freeing with g_strfreev().</doc>
24250         <return-value>
24251           <doc xml:whitespace="preserve">A %NULL-terminated array of strings, listing the supported</doc>
24252           <array c:type="char**">
24253             <type name="utf8"/>
24254           </array>
24255         </return-value>
24256       </function>
24257       <method name="load" c:identifier="g_io_module_load">
24258         <doc xml:whitespace="preserve">Required API for GIO modules to implement.
24259 This function is ran after the module has been loaded into GIO,
24260 to initialize the module.</doc>
24261         <return-value transfer-ownership="none">
24262           <type name="none" c:type="void"/>
24263         </return-value>
24264       </method>
24265       <method name="unload" c:identifier="g_io_module_unload">
24266         <doc xml:whitespace="preserve">Required API for GIO modules to implement.
24267 This function is ran when the module is being unloaded from GIO,
24268 to finalize the module.</doc>
24269         <return-value transfer-ownership="none">
24270           <type name="none" c:type="void"/>
24271         </return-value>
24272       </method>
24273     </class>
24274     <record name="IOModuleClass"
24275             c:type="GIOModuleClass"
24276             disguised="1"
24277             glib:is-gtype-struct-for="IOModule">
24278     </record>
24279     <record name="IOSchedulerJob" c:type="GIOSchedulerJob" disguised="1">
24280       <doc xml:whitespace="preserve">Opaque class for definining and scheduling IO jobs.</doc>
24281       <method name="send_to_mainloop"
24282               c:identifier="g_io_scheduler_job_send_to_mainloop">
24283         <doc xml:whitespace="preserve">Used from an I/O job to send a callback to be run in the thread
24284 that the job was started from, waiting for the result (and thus
24285 blocking the I/O job).</doc>
24286         <return-value transfer-ownership="none">
24287           <doc xml:whitespace="preserve">The return value of @func</doc>
24288           <type name="gboolean" c:type="gboolean"/>
24289         </return-value>
24290         <parameters>
24291           <parameter name="func"
24292                      transfer-ownership="none"
24293                      scope="notified"
24294                      closure="1"
24295                      destroy="2">
24296             <doc xml:whitespace="preserve">a #GSourceFunc callback that will be called in the original thread</doc>
24297             <type name="GLib.SourceFunc" c:type="GSourceFunc"/>
24298           </parameter>
24299           <parameter name="user_data" transfer-ownership="none">
24300             <doc xml:whitespace="preserve">data to pass to @func</doc>
24301             <type name="gpointer" c:type="gpointer"/>
24302           </parameter>
24303           <parameter name="notify" transfer-ownership="none" scope="async">
24304             <doc xml:whitespace="preserve">a #GDestroyNotify for @user_data, or %NULL</doc>
24305             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
24306           </parameter>
24307         </parameters>
24308       </method>
24309       <method name="send_to_mainloop_async"
24310               c:identifier="g_io_scheduler_job_send_to_mainloop_async">
24311         <doc xml:whitespace="preserve">Used from an I/O job to send a callback to be run asynchronously in
24312 the thread that the job was started from. The callback will be run
24313 when the main loop is available, but at that time the I/O job might
24314 have finished. The return value from the callback is ignored.
24315 Note that if you are passing the @user_data from g_io_scheduler_push_job()
24316 on to this function you have to ensure that it is not freed before
24317 g_io_scheduler_push_job() or by using refcounting for @user_data.</doc>
24318         <return-value transfer-ownership="none">
24319           <type name="none" c:type="void"/>
24320         </return-value>
24321         <parameters>
24322           <parameter name="func"
24323                      transfer-ownership="none"
24324                      scope="notified"
24325                      closure="1"
24326                      destroy="2">
24327             <doc xml:whitespace="preserve">a #GSourceFunc callback that will be called in the original thread</doc>
24328             <type name="GLib.SourceFunc" c:type="GSourceFunc"/>
24329           </parameter>
24330           <parameter name="user_data" transfer-ownership="none">
24331             <doc xml:whitespace="preserve">data to pass to @func</doc>
24332             <type name="gpointer" c:type="gpointer"/>
24333           </parameter>
24334           <parameter name="notify" transfer-ownership="none" scope="async">
24335             <doc xml:whitespace="preserve">a #GDestroyNotify for @user_data, or %NULL</doc>
24336             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
24337           </parameter>
24338         </parameters>
24339       </method>
24340     </record>
24341     <callback name="IOSchedulerJobFunc" c:type="GIOSchedulerJobFunc">
24342       <doc xml:whitespace="preserve">I/O Job function.
24343 Note that depending on whether threads are available, the
24344 #GIOScheduler may run jobs in separate threads or in an idle
24345 in the mainloop.
24346 Long-running jobs should periodically check the @cancellable
24347 to see if they have been cancelled.
24348 complete the job, %FALSE if the job is complete (or cancelled)</doc>
24349       <return-value transfer-ownership="none">
24350         <doc xml:whitespace="preserve">%TRUE if this function should be called again to</doc>
24351         <type name="gboolean" c:type="gboolean"/>
24352       </return-value>
24353       <parameters>
24354         <parameter name="job" transfer-ownership="none">
24355           <doc xml:whitespace="preserve">a #GIOSchedulerJob.</doc>
24356           <type name="IOSchedulerJob" c:type="GIOSchedulerJob*"/>
24357         </parameter>
24358         <parameter name="cancellable" transfer-ownership="none" allow-none="1">
24359           <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
24360           <type name="Cancellable" c:type="GCancellable*"/>
24361         </parameter>
24362         <parameter name="user_data" transfer-ownership="none" closure="2">
24363           <doc xml:whitespace="preserve">the data to pass to callback function</doc>
24364           <type name="gpointer" c:type="gpointer"/>
24365         </parameter>
24366       </parameters>
24367     </callback>
24368     <class name="IOStream"
24369            c:symbol-prefix="io_stream"
24370            c:type="GIOStream"
24371            parent="GObject.Object"
24372            abstract="1"
24373            glib:type-name="GIOStream"
24374            glib:get-type="g_io_stream_get_type"
24375            glib:type-struct="IOStreamClass">
24376       <doc xml:whitespace="preserve">Base class for read-write streams.</doc>
24377       <virtual-method name="close_async" invoker="close_async" version="2.22">
24378         <doc xml:whitespace="preserve">Requests an asynchronous close of the stream, releasing resources
24379 related to it. When the operation is finished @callback will be
24380 called. You can then call g_io_stream_close_finish() to get
24381 the result of the operation.
24382 For behaviour details see g_io_stream_close().
24383 The asynchronous methods have a default fallback that uses threads
24384 to implement asynchronicity, so they are optional for inheriting
24385 classes. However, if you override one you must override all.</doc>
24386         <return-value transfer-ownership="none">
24387           <type name="none" c:type="void"/>
24388         </return-value>
24389         <parameters>
24390           <parameter name="io_priority" transfer-ownership="none">
24391             <doc xml:whitespace="preserve">the io priority of the request</doc>
24392             <type name="gint" c:type="int"/>
24393           </parameter>
24394           <parameter name="cancellable"
24395                      transfer-ownership="none"
24396                      allow-none="1">
24397             <doc xml:whitespace="preserve">optional cancellable object</doc>
24398             <type name="Cancellable" c:type="GCancellable*"/>
24399           </parameter>
24400           <parameter name="callback"
24401                      transfer-ownership="none"
24402                      scope="async"
24403                      closure="3">
24404             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
24405             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
24406           </parameter>
24407           <parameter name="user_data" transfer-ownership="none" closure="3">
24408             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
24409             <type name="gpointer" c:type="gpointer"/>
24410           </parameter>
24411         </parameters>
24412       </virtual-method>
24413       <virtual-method name="close_finish"
24414                       invoker="close_finish"
24415                       version="2.22"
24416                       throws="1">
24417         <doc xml:whitespace="preserve">Closes a stream.</doc>
24418         <return-value transfer-ownership="none">
24419           <doc xml:whitespace="preserve">%TRUE if stream was successfully closed, %FALSE otherwise.</doc>
24420           <type name="gboolean" c:type="gboolean"/>
24421         </return-value>
24422         <parameters>
24423           <parameter name="result" transfer-ownership="none">
24424             <doc xml:whitespace="preserve">a #GAsyncResult</doc>
24425             <type name="AsyncResult" c:type="GAsyncResult*"/>
24426           </parameter>
24427         </parameters>
24428       </virtual-method>
24429       <virtual-method name="close_fn" throws="1">
24430         <return-value transfer-ownership="none">
24431           <type name="gboolean" c:type="gboolean"/>
24432         </return-value>
24433         <parameters>
24434           <parameter name="cancellable" transfer-ownership="none">
24435             <type name="Cancellable" c:type="GCancellable*"/>
24436           </parameter>
24437         </parameters>
24438       </virtual-method>
24439       <virtual-method name="get_input_stream"
24440                       invoker="get_input_stream"
24441                       version="2.22">
24442         <doc xml:whitespace="preserve">Gets the input stream for this object. This is used
24443 for reading.
24444 Do not free.</doc>
24445         <return-value transfer-ownership="none">
24446           <doc xml:whitespace="preserve">a #GInputStream, owned by the #GIOStream.</doc>
24447           <type name="InputStream" c:type="GInputStream*"/>
24448         </return-value>
24449       </virtual-method>
24450       <virtual-method name="get_output_stream"
24451                       invoker="get_output_stream"
24452                       version="2.22">
24453         <doc xml:whitespace="preserve">Gets the output stream for this object. This is used for
24454 writing.
24455 Do not free.</doc>
24456         <return-value transfer-ownership="none">
24457           <doc xml:whitespace="preserve">a #GOutputStream, owned by the #GIOStream.</doc>
24458           <type name="OutputStream" c:type="GOutputStream*"/>
24459         </return-value>
24460       </virtual-method>
24461       <method name="clear_pending"
24462               c:identifier="g_io_stream_clear_pending"
24463               version="2.22">
24464         <doc xml:whitespace="preserve">Clears the pending flag on @stream.</doc>
24465         <return-value transfer-ownership="none">
24466           <type name="none" c:type="void"/>
24467         </return-value>
24468       </method>
24469       <method name="close"
24470               c:identifier="g_io_stream_close"
24471               version="2.22"
24472               throws="1">
24473         <doc xml:whitespace="preserve">Closes the stream, releasing resources related to it. This will also
24474 closes the individual input and output streams, if they are not already
24475 closed.
24476 Once the stream is closed, all other operations will return
24477 %G_IO_ERROR_CLOSED. Closing a stream multiple times will not
24478 return an error.
24479 Closing a stream will automatically flush any outstanding buffers
24480 in the stream.
24481 Streams will be automatically closed when the last reference
24482 is dropped, but you might want to call this function to make sure
24483 resources are released as early as possible.
24484 Some streams might keep the backing store of the stream (e.g. a file
24485 descriptor) open after the stream is closed. See the documentation for
24486 the individual stream for details.
24487 On failure the first error that happened will be reported, but the
24488 close operation will finish as much as possible. A stream that failed
24489 to close will still return %G_IO_ERROR_CLOSED for all operations.
24490 Still, it is important to check and report the error to the user,
24491 otherwise there might be a loss of data as all data might not be written.
24492 If @cancellable is not NULL, then the operation can be cancelled by
24493 triggering the cancellable object from another thread. If the operation
24494 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
24495 Cancelling a close will still leave the stream closed, but some streams
24496 can use a faster close that doesn't block to e.g. check errors.
24497 The default implementation of this method just calls close on the
24498 individual input/output streams.</doc>
24499         <return-value transfer-ownership="none">
24500           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on failure</doc>
24501           <type name="gboolean" c:type="gboolean"/>
24502         </return-value>
24503         <parameters>
24504           <parameter name="cancellable"
24505                      transfer-ownership="none"
24506                      allow-none="1">
24507             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
24508             <type name="Cancellable" c:type="GCancellable*"/>
24509           </parameter>
24510         </parameters>
24511       </method>
24512       <method name="close_async"
24513               c:identifier="g_io_stream_close_async"
24514               version="2.22">
24515         <doc xml:whitespace="preserve">Requests an asynchronous close of the stream, releasing resources
24516 related to it. When the operation is finished @callback will be
24517 called. You can then call g_io_stream_close_finish() to get
24518 the result of the operation.
24519 For behaviour details see g_io_stream_close().
24520 The asynchronous methods have a default fallback that uses threads
24521 to implement asynchronicity, so they are optional for inheriting
24522 classes. However, if you override one you must override all.</doc>
24523         <return-value transfer-ownership="none">
24524           <type name="none" c:type="void"/>
24525         </return-value>
24526         <parameters>
24527           <parameter name="io_priority" transfer-ownership="none">
24528             <doc xml:whitespace="preserve">the io priority of the request</doc>
24529             <type name="gint" c:type="int"/>
24530           </parameter>
24531           <parameter name="cancellable"
24532                      transfer-ownership="none"
24533                      allow-none="1">
24534             <doc xml:whitespace="preserve">optional cancellable object</doc>
24535             <type name="Cancellable" c:type="GCancellable*"/>
24536           </parameter>
24537           <parameter name="callback"
24538                      transfer-ownership="none"
24539                      scope="async"
24540                      closure="3">
24541             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
24542             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
24543           </parameter>
24544           <parameter name="user_data" transfer-ownership="none">
24545             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
24546             <type name="gpointer" c:type="gpointer"/>
24547           </parameter>
24548         </parameters>
24549       </method>
24550       <method name="close_finish"
24551               c:identifier="g_io_stream_close_finish"
24552               version="2.22"
24553               throws="1">
24554         <doc xml:whitespace="preserve">Closes a stream.</doc>
24555         <return-value transfer-ownership="none">
24556           <doc xml:whitespace="preserve">%TRUE if stream was successfully closed, %FALSE otherwise.</doc>
24557           <type name="gboolean" c:type="gboolean"/>
24558         </return-value>
24559         <parameters>
24560           <parameter name="result" transfer-ownership="none">
24561             <doc xml:whitespace="preserve">a #GAsyncResult</doc>
24562             <type name="AsyncResult" c:type="GAsyncResult*"/>
24563           </parameter>
24564         </parameters>
24565       </method>
24566       <method name="get_input_stream"
24567               c:identifier="g_io_stream_get_input_stream"
24568               version="2.22">
24569         <doc xml:whitespace="preserve">Gets the input stream for this object. This is used
24570 for reading.
24571 Do not free.</doc>
24572         <return-value transfer-ownership="none">
24573           <doc xml:whitespace="preserve">a #GInputStream, owned by the #GIOStream.</doc>
24574           <type name="InputStream" c:type="GInputStream*"/>
24575         </return-value>
24576       </method>
24577       <method name="get_output_stream"
24578               c:identifier="g_io_stream_get_output_stream"
24579               version="2.22">
24580         <doc xml:whitespace="preserve">Gets the output stream for this object. This is used for
24581 writing.
24582 Do not free.</doc>
24583         <return-value transfer-ownership="none">
24584           <doc xml:whitespace="preserve">a #GOutputStream, owned by the #GIOStream.</doc>
24585           <type name="OutputStream" c:type="GOutputStream*"/>
24586         </return-value>
24587       </method>
24588       <method name="has_pending"
24589               c:identifier="g_io_stream_has_pending"
24590               version="2.22">
24591         <doc xml:whitespace="preserve">Checks if a stream has pending actions.</doc>
24592         <return-value transfer-ownership="none">
24593           <doc xml:whitespace="preserve">%TRUE if @stream has pending actions.</doc>
24594           <type name="gboolean" c:type="gboolean"/>
24595         </return-value>
24596       </method>
24597       <method name="is_closed"
24598               c:identifier="g_io_stream_is_closed"
24599               version="2.22">
24600         <doc xml:whitespace="preserve">Checks if a stream is closed.</doc>
24601         <return-value transfer-ownership="none">
24602           <doc xml:whitespace="preserve">%TRUE if the stream is closed.</doc>
24603           <type name="gboolean" c:type="gboolean"/>
24604         </return-value>
24605       </method>
24606       <method name="set_pending"
24607               c:identifier="g_io_stream_set_pending"
24608               version="2.22"
24609               throws="1">
24610         <doc xml:whitespace="preserve">Sets @stream to have actions pending. If the pending flag is
24611 already set or @stream is closed, it will return %FALSE and set</doc>
24612         <return-value transfer-ownership="none">
24613           <doc xml:whitespace="preserve">%TRUE if pending was previously unset and is now set.</doc>
24614           <type name="gboolean" c:type="gboolean"/>
24615         </return-value>
24616       </method>
24617       <property name="closed" writable="1" transfer-ownership="none">
24618         <type name="gboolean"/>
24619       </property>
24620       <property name="input-stream" transfer-ownership="none">
24621         <type name="InputStream"/>
24622       </property>
24623       <property name="output-stream" transfer-ownership="none">
24624         <type name="OutputStream"/>
24625       </property>
24626       <field name="parent_instance">
24627         <type name="GObject.Object" c:type="GObject"/>
24628       </field>
24629       <field name="priv">
24630         <type name="IOStreamPrivate" c:type="GIOStreamPrivate*"/>
24631       </field>
24632     </class>
24633     <record name="IOStreamClass"
24634             c:type="GIOStreamClass"
24635             glib:is-gtype-struct-for="IOStream">
24636       <field name="parent_class">
24637         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
24638       </field>
24639       <field name="get_input_stream">
24640         <callback name="get_input_stream">
24641           <return-value transfer-ownership="none">
24642             <doc xml:whitespace="preserve">a #GInputStream, owned by the #GIOStream.</doc>
24643             <type name="InputStream" c:type="GInputStream*"/>
24644           </return-value>
24645           <parameters>
24646             <parameter name="stream" transfer-ownership="none">
24647               <type name="IOStream" c:type="GIOStream*"/>
24648             </parameter>
24649           </parameters>
24650         </callback>
24651       </field>
24652       <field name="get_output_stream">
24653         <callback name="get_output_stream">
24654           <return-value transfer-ownership="none">
24655             <doc xml:whitespace="preserve">a #GOutputStream, owned by the #GIOStream.</doc>
24656             <type name="OutputStream" c:type="GOutputStream*"/>
24657           </return-value>
24658           <parameters>
24659             <parameter name="stream" transfer-ownership="none">
24660               <type name="IOStream" c:type="GIOStream*"/>
24661             </parameter>
24662           </parameters>
24663         </callback>
24664       </field>
24665       <field name="close_fn">
24666         <callback name="close_fn" throws="1">
24667           <return-value transfer-ownership="none">
24668             <type name="gboolean" c:type="gboolean"/>
24669           </return-value>
24670           <parameters>
24671             <parameter name="stream" transfer-ownership="none">
24672               <type name="IOStream" c:type="GIOStream*"/>
24673             </parameter>
24674             <parameter name="cancellable" transfer-ownership="none">
24675               <type name="Cancellable" c:type="GCancellable*"/>
24676             </parameter>
24677           </parameters>
24678         </callback>
24679       </field>
24680       <field name="close_async">
24681         <callback name="close_async">
24682           <return-value transfer-ownership="none">
24683             <type name="none" c:type="void"/>
24684           </return-value>
24685           <parameters>
24686             <parameter name="stream" transfer-ownership="none">
24687               <type name="IOStream" c:type="GIOStream*"/>
24688             </parameter>
24689             <parameter name="io_priority" transfer-ownership="none">
24690               <doc xml:whitespace="preserve">the io priority of the request</doc>
24691               <type name="gint" c:type="int"/>
24692             </parameter>
24693             <parameter name="cancellable"
24694                        transfer-ownership="none"
24695                        allow-none="1">
24696               <doc xml:whitespace="preserve">optional cancellable object</doc>
24697               <type name="Cancellable" c:type="GCancellable*"/>
24698             </parameter>
24699             <parameter name="callback"
24700                        transfer-ownership="none"
24701                        scope="async"
24702                        closure="4">
24703               <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
24704               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
24705             </parameter>
24706             <parameter name="user_data" transfer-ownership="none" closure="4">
24707               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
24708               <type name="gpointer" c:type="gpointer"/>
24709             </parameter>
24710           </parameters>
24711         </callback>
24712       </field>
24713       <field name="close_finish">
24714         <callback name="close_finish" throws="1">
24715           <return-value transfer-ownership="none">
24716             <doc xml:whitespace="preserve">%TRUE if stream was successfully closed, %FALSE otherwise.</doc>
24717             <type name="gboolean" c:type="gboolean"/>
24718           </return-value>
24719           <parameters>
24720             <parameter name="stream" transfer-ownership="none">
24721               <type name="IOStream" c:type="GIOStream*"/>
24722             </parameter>
24723             <parameter name="result" transfer-ownership="none">
24724               <doc xml:whitespace="preserve">a #GAsyncResult</doc>
24725               <type name="AsyncResult" c:type="GAsyncResult*"/>
24726             </parameter>
24727           </parameters>
24728         </callback>
24729       </field>
24730       <field name="_g_reserved1" introspectable="0">
24731         <callback name="_g_reserved1">
24732           <return-value transfer-ownership="none">
24733             <type name="none" c:type="void"/>
24734           </return-value>
24735         </callback>
24736       </field>
24737       <field name="_g_reserved2" introspectable="0">
24738         <callback name="_g_reserved2">
24739           <return-value transfer-ownership="none">
24740             <type name="none" c:type="void"/>
24741           </return-value>
24742         </callback>
24743       </field>
24744       <field name="_g_reserved3" introspectable="0">
24745         <callback name="_g_reserved3">
24746           <return-value transfer-ownership="none">
24747             <type name="none" c:type="void"/>
24748           </return-value>
24749         </callback>
24750       </field>
24751       <field name="_g_reserved4" introspectable="0">
24752         <callback name="_g_reserved4">
24753           <return-value transfer-ownership="none">
24754             <type name="none" c:type="void"/>
24755           </return-value>
24756         </callback>
24757       </field>
24758       <field name="_g_reserved5" introspectable="0">
24759         <callback name="_g_reserved5">
24760           <return-value transfer-ownership="none">
24761             <type name="none" c:type="void"/>
24762           </return-value>
24763         </callback>
24764       </field>
24765       <field name="_g_reserved6" introspectable="0">
24766         <callback name="_g_reserved6">
24767           <return-value transfer-ownership="none">
24768             <type name="none" c:type="void"/>
24769           </return-value>
24770         </callback>
24771       </field>
24772       <field name="_g_reserved7" introspectable="0">
24773         <callback name="_g_reserved7">
24774           <return-value transfer-ownership="none">
24775             <type name="none" c:type="void"/>
24776           </return-value>
24777         </callback>
24778       </field>
24779       <field name="_g_reserved8" introspectable="0">
24780         <callback name="_g_reserved8">
24781           <return-value transfer-ownership="none">
24782             <type name="none" c:type="void"/>
24783           </return-value>
24784         </callback>
24785       </field>
24786       <field name="_g_reserved9" introspectable="0">
24787         <callback name="_g_reserved9">
24788           <return-value transfer-ownership="none">
24789             <type name="none" c:type="void"/>
24790           </return-value>
24791         </callback>
24792       </field>
24793       <field name="_g_reserved10" introspectable="0">
24794         <callback name="_g_reserved10">
24795           <return-value transfer-ownership="none">
24796             <type name="none" c:type="void"/>
24797           </return-value>
24798         </callback>
24799       </field>
24800     </record>
24801     <record name="IOStreamPrivate" c:type="GIOStreamPrivate" disguised="1">
24802     </record>
24803     <interface name="Icon"
24804                c:symbol-prefix="icon"
24805                c:type="GIcon"
24806                glib:type-name="GIcon"
24807                glib:get-type="g_icon_get_type"
24808                glib:type-struct="IconIface">
24809       <doc xml:whitespace="preserve">An abstract type that specifies an icon.</doc>
24810       <virtual-method name="equal" invoker="equal">
24811         <doc xml:whitespace="preserve">Checks if two icons are equal.</doc>
24812         <return-value transfer-ownership="none">
24813           <doc xml:whitespace="preserve">%TRUE if @icon1 is equal to @icon2. %FALSE otherwise.</doc>
24814           <type name="gboolean" c:type="gboolean"/>
24815         </return-value>
24816         <parameters>
24817           <parameter name="icon2" transfer-ownership="none">
24818             <doc xml:whitespace="preserve">pointer to the second #GIcon.</doc>
24819             <type name="Icon" c:type="GIcon*"/>
24820           </parameter>
24821         </parameters>
24822       </virtual-method>
24823       <virtual-method name="hash">
24824         <return-value transfer-ownership="none">
24825           <type name="guint" c:type="guint"/>
24826         </return-value>
24827       </virtual-method>
24828       <virtual-method name="to_tokens" invoker="to_string" version="2.20">
24829         <doc xml:whitespace="preserve">Generates a textual representation of @icon that can be used for
24830 serialization such as when passing @icon to a different process or
24831 saving it to persistent storage. Use g_icon_new_for_string() to
24832 get @icon back from the returned string.
24833 The encoding of the returned string is proprietary to #GIcon except
24834 in the following two cases
24835 &lt;itemizedlist&gt;
24836 &lt;listitem&gt;&lt;para&gt;
24837 If @icon is a #GFileIcon, the returned string is a native path
24838 (such as &lt;literal&gt;/path/to/my icon.png&lt;/literal&gt;) without escaping
24839 if the #GFile for @icon is a native file.  If the file is not
24840 native, the returned string is the result of g_file_get_uri()
24841 (such as &lt;literal&gt;sftp://path/to/my%%20icon.png&lt;/literal&gt;).
24842 &lt;/para&gt;&lt;/listitem&gt;
24843 &lt;listitem&gt;&lt;para&gt;
24844 If @icon is a #GThemedIcon with exactly one name, the encoding is
24845 simply the name (such as &lt;literal&gt;network-server&lt;/literal&gt;).
24846 &lt;/para&gt;&lt;/listitem&gt;
24847 &lt;/itemizedlist&gt;
24848 be serialized. Use g_free() to free.</doc>
24849         <return-value transfer-ownership="none">
24850           <doc xml:whitespace="preserve">An allocated NUL-terminated UTF8 string or %NULL if @icon can't</doc>
24851           <type name="gboolean" c:type="gboolean"/>
24852         </return-value>
24853         <parameters>
24854           <parameter name="tokens" transfer-ownership="none">
24855             <array name="GLib.PtrArray" c:type="GPtrArray*">
24856               <type name="gpointer" c:type="gpointer"/>
24857             </array>
24858           </parameter>
24859           <parameter name="out_version" transfer-ownership="none">
24860             <type name="gint" c:type="gint*"/>
24861           </parameter>
24862         </parameters>
24863       </virtual-method>
24864       <method name="equal" c:identifier="g_icon_equal">
24865         <doc xml:whitespace="preserve">Checks if two icons are equal.</doc>
24866         <return-value transfer-ownership="none">
24867           <doc xml:whitespace="preserve">%TRUE if @icon1 is equal to @icon2. %FALSE otherwise.</doc>
24868           <type name="gboolean" c:type="gboolean"/>
24869         </return-value>
24870         <parameters>
24871           <parameter name="icon2" transfer-ownership="none">
24872             <doc xml:whitespace="preserve">pointer to the second #GIcon.</doc>
24873             <type name="Icon" c:type="GIcon*"/>
24874           </parameter>
24875         </parameters>
24876       </method>
24877       <method name="to_string" c:identifier="g_icon_to_string" version="2.20">
24878         <doc xml:whitespace="preserve">Generates a textual representation of @icon that can be used for
24879 serialization such as when passing @icon to a different process or
24880 saving it to persistent storage. Use g_icon_new_for_string() to
24881 get @icon back from the returned string.
24882 The encoding of the returned string is proprietary to #GIcon except
24883 in the following two cases
24884 &lt;itemizedlist&gt;
24885 &lt;listitem&gt;&lt;para&gt;
24886 If @icon is a #GFileIcon, the returned string is a native path
24887 (such as &lt;literal&gt;/path/to/my icon.png&lt;/literal&gt;) without escaping
24888 if the #GFile for @icon is a native file.  If the file is not
24889 native, the returned string is the result of g_file_get_uri()
24890 (such as &lt;literal&gt;sftp://path/to/my%%20icon.png&lt;/literal&gt;).
24891 &lt;/para&gt;&lt;/listitem&gt;
24892 &lt;listitem&gt;&lt;para&gt;
24893 If @icon is a #GThemedIcon with exactly one name, the encoding is
24894 simply the name (such as &lt;literal&gt;network-server&lt;/literal&gt;).
24895 &lt;/para&gt;&lt;/listitem&gt;
24896 &lt;/itemizedlist&gt;
24897 be serialized. Use g_free() to free.</doc>
24898         <return-value transfer-ownership="full">
24899           <doc xml:whitespace="preserve">An allocated NUL-terminated UTF8 string or %NULL if @icon can't</doc>
24900           <type name="utf8" c:type="gchar*"/>
24901         </return-value>
24902       </method>
24903     </interface>
24904     <record name="IconIface"
24905             c:type="GIconIface"
24906             glib:is-gtype-struct-for="Icon">
24907       <doc xml:whitespace="preserve">GIconIface is used to implement GIcon types for various
24908 different systems. See #GThemedIcon and #GLoadableIcon for
24909 examples of how to implement this interface.</doc>
24910       <field name="g_iface">
24911         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
24912       </field>
24913       <field name="hash">
24914         <callback name="hash">
24915           <return-value transfer-ownership="none">
24916             <type name="guint" c:type="guint"/>
24917           </return-value>
24918           <parameters>
24919             <parameter name="icon" transfer-ownership="none">
24920               <type name="Icon" c:type="GIcon*"/>
24921             </parameter>
24922           </parameters>
24923         </callback>
24924       </field>
24925       <field name="equal">
24926         <callback name="equal">
24927           <return-value transfer-ownership="none">
24928             <doc xml:whitespace="preserve">%TRUE if @icon1 is equal to @icon2. %FALSE otherwise.</doc>
24929             <type name="gboolean" c:type="gboolean"/>
24930           </return-value>
24931           <parameters>
24932             <parameter name="icon1" transfer-ownership="none">
24933               <type name="Icon" c:type="GIcon*"/>
24934             </parameter>
24935             <parameter name="icon2" transfer-ownership="none">
24936               <doc xml:whitespace="preserve">pointer to the second #GIcon.</doc>
24937               <type name="Icon" c:type="GIcon*"/>
24938             </parameter>
24939           </parameters>
24940         </callback>
24941       </field>
24942       <field name="to_tokens">
24943         <callback name="to_tokens">
24944           <return-value transfer-ownership="none">
24945             <doc xml:whitespace="preserve">An allocated NUL-terminated UTF8 string or %NULL if @icon can't</doc>
24946             <type name="gboolean" c:type="gboolean"/>
24947           </return-value>
24948           <parameters>
24949             <parameter name="icon" transfer-ownership="none">
24950               <type name="Icon" c:type="GIcon*"/>
24951             </parameter>
24952             <parameter name="tokens" transfer-ownership="none">
24953               <array name="GLib.PtrArray" c:type="GPtrArray*">
24954                 <type name="gpointer" c:type="gpointer"/>
24955               </array>
24956             </parameter>
24957             <parameter name="out_version" transfer-ownership="none">
24958               <type name="gint" c:type="gint*"/>
24959             </parameter>
24960           </parameters>
24961         </callback>
24962       </field>
24963       <field name="from_tokens" introspectable="0">
24964         <callback name="from_tokens" introspectable="0" throws="1">
24965           <return-value>
24966             <type name="Icon" c:type="GIcon*"/>
24967           </return-value>
24968           <parameters>
24969             <parameter name="tokens" transfer-ownership="none">
24970               <type name="utf8" c:type="gchar**"/>
24971             </parameter>
24972             <parameter name="num_tokens" transfer-ownership="none">
24973               <type name="gint" c:type="gint"/>
24974             </parameter>
24975             <parameter name="version" transfer-ownership="none">
24976               <type name="gint" c:type="gint"/>
24977             </parameter>
24978           </parameters>
24979         </callback>
24980       </field>
24981     </record>
24982     <class name="InetAddress"
24983            c:symbol-prefix="inet_address"
24984            c:type="GInetAddress"
24985            parent="GObject.Object"
24986            glib:type-name="GInetAddress"
24987            glib:get-type="g_inet_address_get_type"
24988            glib:type-struct="InetAddressClass">
24989       <doc xml:whitespace="preserve">An IPv4 or IPv6 internet address.</doc>
24990       <constructor name="new_any"
24991                    c:identifier="g_inet_address_new_any"
24992                    version="2.22">
24993         <doc xml:whitespace="preserve">Creates a #GInetAddress for the "any" address (unassigned/"don't
24994 care") for @family.
24995 for @family.</doc>
24996         <return-value transfer-ownership="full">
24997           <doc xml:whitespace="preserve">a new #GInetAddress corresponding to the "any" address</doc>
24998           <type name="InetAddress" c:type="GInetAddress*"/>
24999         </return-value>
25000         <parameters>
25001           <parameter name="family" transfer-ownership="none">
25002             <doc xml:whitespace="preserve">the address family</doc>
25003             <type name="SocketFamily" c:type="GSocketFamily"/>
25004           </parameter>
25005         </parameters>
25006       </constructor>
25007       <constructor name="new_from_bytes"
25008                    c:identifier="g_inet_address_new_from_bytes"
25009                    version="2.22">
25010         <doc xml:whitespace="preserve">Creates a new #GInetAddress from the given @family and @bytes.
25011 %G_INET_ADDRESS_IPV6.</doc>
25012         <return-value transfer-ownership="full">
25013           <doc xml:whitespace="preserve">a new #GInetAddress corresponding to @family and @bytes.</doc>
25014           <type name="InetAddress" c:type="GInetAddress*"/>
25015         </return-value>
25016         <parameters>
25017           <parameter name="bytes" transfer-ownership="none">
25018             <doc xml:whitespace="preserve">raw address data</doc>
25019             <type name="guint8" c:type="guint8*"/>
25020           </parameter>
25021           <parameter name="family" transfer-ownership="none">
25022             <doc xml:whitespace="preserve">the address family of @bytes</doc>
25023             <type name="SocketFamily" c:type="GSocketFamily"/>
25024           </parameter>
25025         </parameters>
25026       </constructor>
25027       <constructor name="new_from_string"
25028                    c:identifier="g_inet_address_new_from_string"
25029                    version="2.22">
25030         <doc xml:whitespace="preserve">Parses @string as an IP address and creates a new #GInetAddress.</doc>
25031         <return-value transfer-ownership="full">
25032           <doc xml:whitespace="preserve">a new #GInetAddress corresponding to @string, or %NULL if</doc>
25033           <type name="InetAddress" c:type="GInetAddress*"/>
25034         </return-value>
25035         <parameters>
25036           <parameter name="string" transfer-ownership="none">
25037             <doc xml:whitespace="preserve">a string representation of an IP address</doc>
25038             <type name="utf8" c:type="gchar*"/>
25039           </parameter>
25040         </parameters>
25041       </constructor>
25042       <constructor name="new_loopback"
25043                    c:identifier="g_inet_address_new_loopback"
25044                    version="2.22">
25045         <doc xml:whitespace="preserve">Creates a #GInetAddress for the loopback address for @family.
25046 for @family.</doc>
25047         <return-value transfer-ownership="full">
25048           <doc xml:whitespace="preserve">a new #GInetAddress corresponding to the loopback address</doc>
25049           <type name="InetAddress" c:type="GInetAddress*"/>
25050         </return-value>
25051         <parameters>
25052           <parameter name="family" transfer-ownership="none">
25053             <doc xml:whitespace="preserve">the address family</doc>
25054             <type name="SocketFamily" c:type="GSocketFamily"/>
25055           </parameter>
25056         </parameters>
25057       </constructor>
25058       <virtual-method name="to_bytes" invoker="to_bytes" version="2.22">
25059         <doc xml:whitespace="preserve">Gets the raw binary address data from @address.
25060 which should not be modified, stored, or freed. The size of this
25061 array can be gotten with g_inet_address_get_native_size().</doc>
25062         <return-value transfer-ownership="none">
25063           <doc xml:whitespace="preserve">a pointer to an internal array of the bytes in @address,</doc>
25064           <type name="guint8" c:type="guint8*"/>
25065         </return-value>
25066       </virtual-method>
25067       <virtual-method name="to_string" invoker="to_string" version="2.22">
25068         <doc xml:whitespace="preserve">Converts @address to string form.
25069 freed after use.</doc>
25070         <return-value transfer-ownership="full">
25071           <doc xml:whitespace="preserve">a representation of @address as a string, which should be</doc>
25072           <type name="utf8" c:type="gchar*"/>
25073         </return-value>
25074       </virtual-method>
25075       <method name="get_family"
25076               c:identifier="g_inet_address_get_family"
25077               version="2.22">
25078         <doc xml:whitespace="preserve">Gets @address's family</doc>
25079         <return-value transfer-ownership="none">
25080           <doc xml:whitespace="preserve">@address's family</doc>
25081           <type name="SocketFamily" c:type="GSocketFamily"/>
25082         </return-value>
25083       </method>
25084       <method name="get_is_any"
25085               c:identifier="g_inet_address_get_is_any"
25086               version="2.22">
25087         <doc xml:whitespace="preserve">Tests whether @address is the "any" address for its family.</doc>
25088         <return-value transfer-ownership="none">
25089           <doc xml:whitespace="preserve">%TRUE if @address is the "any" address for its family.</doc>
25090           <type name="gboolean" c:type="gboolean"/>
25091         </return-value>
25092       </method>
25093       <method name="get_is_link_local"
25094               c:identifier="g_inet_address_get_is_link_local"
25095               version="2.22">
25096         <doc xml:whitespace="preserve">Tests whether @address is a link-local address (that is, if it
25097 identifies a host on a local network that is not connected to the
25098 Internet).</doc>
25099         <return-value transfer-ownership="none">
25100           <doc xml:whitespace="preserve">%TRUE if @address is a link-local address.</doc>
25101           <type name="gboolean" c:type="gboolean"/>
25102         </return-value>
25103       </method>
25104       <method name="get_is_loopback"
25105               c:identifier="g_inet_address_get_is_loopback"
25106               version="2.22">
25107         <doc xml:whitespace="preserve">Tests whether @address is the loopback address for its family.</doc>
25108         <return-value transfer-ownership="none">
25109           <doc xml:whitespace="preserve">%TRUE if @address is the loopback address for its family.</doc>
25110           <type name="gboolean" c:type="gboolean"/>
25111         </return-value>
25112       </method>
25113       <method name="get_is_mc_global"
25114               c:identifier="g_inet_address_get_is_mc_global"
25115               version="2.22">
25116         <doc xml:whitespace="preserve">Tests whether @address is a global multicast address.</doc>
25117         <return-value transfer-ownership="none">
25118           <doc xml:whitespace="preserve">%TRUE if @address is a global multicast address.</doc>
25119           <type name="gboolean" c:type="gboolean"/>
25120         </return-value>
25121       </method>
25122       <method name="get_is_mc_link_local"
25123               c:identifier="g_inet_address_get_is_mc_link_local"
25124               version="2.22">
25125         <doc xml:whitespace="preserve">Tests whether @address is a link-local multicast address.</doc>
25126         <return-value transfer-ownership="none">
25127           <doc xml:whitespace="preserve">%TRUE if @address is a link-local multicast address.</doc>
25128           <type name="gboolean" c:type="gboolean"/>
25129         </return-value>
25130       </method>
25131       <method name="get_is_mc_node_local"
25132               c:identifier="g_inet_address_get_is_mc_node_local"
25133               version="2.22">
25134         <doc xml:whitespace="preserve">Tests whether @address is a node-local multicast address.</doc>
25135         <return-value transfer-ownership="none">
25136           <doc xml:whitespace="preserve">%TRUE if @address is a node-local multicast address.</doc>
25137           <type name="gboolean" c:type="gboolean"/>
25138         </return-value>
25139       </method>
25140       <method name="get_is_mc_org_local"
25141               c:identifier="g_inet_address_get_is_mc_org_local"
25142               version="2.22">
25143         <doc xml:whitespace="preserve">Tests whether @address is an organization-local multicast address.</doc>
25144         <return-value transfer-ownership="none">
25145           <doc xml:whitespace="preserve">%TRUE if @address is an organization-local multicast address.</doc>
25146           <type name="gboolean" c:type="gboolean"/>
25147         </return-value>
25148       </method>
25149       <method name="get_is_mc_site_local"
25150               c:identifier="g_inet_address_get_is_mc_site_local"
25151               version="2.22">
25152         <doc xml:whitespace="preserve">Tests whether @address is a site-local multicast address.</doc>
25153         <return-value transfer-ownership="none">
25154           <doc xml:whitespace="preserve">%TRUE if @address is a site-local multicast address.</doc>
25155           <type name="gboolean" c:type="gboolean"/>
25156         </return-value>
25157       </method>
25158       <method name="get_is_multicast"
25159               c:identifier="g_inet_address_get_is_multicast"
25160               version="2.22">
25161         <doc xml:whitespace="preserve">Tests whether @address is a multicast address.</doc>
25162         <return-value transfer-ownership="none">
25163           <doc xml:whitespace="preserve">%TRUE if @address is a multicast address.</doc>
25164           <type name="gboolean" c:type="gboolean"/>
25165         </return-value>
25166       </method>
25167       <method name="get_is_site_local"
25168               c:identifier="g_inet_address_get_is_site_local"
25169               version="2.22">
25170         <doc xml:whitespace="preserve">Tests whether @address is a site-local address such as 10.0.0.1
25171 (that is, the address identifies a host on a local network that can
25172 not be reached directly from the Internet, but which may have
25173 outgoing Internet connectivity via a NAT or firewall).</doc>
25174         <return-value transfer-ownership="none">
25175           <doc xml:whitespace="preserve">%TRUE if @address is a site-local address.</doc>
25176           <type name="gboolean" c:type="gboolean"/>
25177         </return-value>
25178       </method>
25179       <method name="get_native_size"
25180               c:identifier="g_inet_address_get_native_size"
25181               version="2.22">
25182         <doc xml:whitespace="preserve">Gets the size of the native raw binary address for @address. This
25183 is the size of the data that you get from g_inet_address_to_bytes().</doc>
25184         <return-value transfer-ownership="none">
25185           <doc xml:whitespace="preserve">the number of bytes used for the native version of @address.</doc>
25186           <type name="gulong" c:type="gsize"/>
25187         </return-value>
25188       </method>
25189       <method name="to_bytes"
25190               c:identifier="g_inet_address_to_bytes"
25191               version="2.22">
25192         <doc xml:whitespace="preserve">Gets the raw binary address data from @address.
25193 which should not be modified, stored, or freed. The size of this
25194 array can be gotten with g_inet_address_get_native_size().</doc>
25195         <return-value transfer-ownership="none">
25196           <doc xml:whitespace="preserve">a pointer to an internal array of the bytes in @address,</doc>
25197           <type name="guint8" c:type="guint8*"/>
25198         </return-value>
25199       </method>
25200       <method name="to_string"
25201               c:identifier="g_inet_address_to_string"
25202               version="2.22">
25203         <doc xml:whitespace="preserve">Converts @address to string form.
25204 freed after use.</doc>
25205         <return-value transfer-ownership="full">
25206           <doc xml:whitespace="preserve">a representation of @address as a string, which should be</doc>
25207           <type name="utf8" c:type="gchar*"/>
25208         </return-value>
25209       </method>
25210       <property name="bytes"
25211                 writable="1"
25212                 construct-only="1"
25213                 transfer-ownership="none">
25214         <type name="gpointer"/>
25215       </property>
25216       <property name="family"
25217                 writable="1"
25218                 construct-only="1"
25219                 transfer-ownership="none">
25220         <type name="SocketFamily"/>
25221       </property>
25222       <property name="is-any" version="2.22" transfer-ownership="none">
25223         <doc xml:whitespace="preserve">Whether this is the "any" address for its family.
25224 See g_inet_address_get_is_any().</doc>
25225         <type name="gboolean"/>
25226       </property>
25227       <property name="is-link-local" version="2.22" transfer-ownership="none">
25228         <doc xml:whitespace="preserve">Whether this is a link-local address.
25229 See g_inet_address_get_is_link_local().</doc>
25230         <type name="gboolean"/>
25231       </property>
25232       <property name="is-loopback" version="2.22" transfer-ownership="none">
25233         <doc xml:whitespace="preserve">Whether this is the loopback address for its family.
25234 See g_inet_address_get_is_loopback().</doc>
25235         <type name="gboolean"/>
25236       </property>
25237       <property name="is-mc-global" version="2.22" transfer-ownership="none">
25238         <doc xml:whitespace="preserve">Whether this is a global multicast address.
25239 See g_inet_address_get_is_mc_global().</doc>
25240         <type name="gboolean"/>
25241       </property>
25242       <property name="is-mc-link-local"
25243                 version="2.22"
25244                 transfer-ownership="none">
25245         <doc xml:whitespace="preserve">Whether this is a link-local multicast address.
25246 See g_inet_address_get_is_mc_link_local().</doc>
25247         <type name="gboolean"/>
25248       </property>
25249       <property name="is-mc-node-local"
25250                 version="2.22"
25251                 transfer-ownership="none">
25252         <doc xml:whitespace="preserve">Whether this is a node-local multicast address.
25253 See g_inet_address_get_is_mc_node_local().</doc>
25254         <type name="gboolean"/>
25255       </property>
25256       <property name="is-mc-org-local"
25257                 version="2.22"
25258                 transfer-ownership="none">
25259         <doc xml:whitespace="preserve">Whether this is an organization-local multicast address.
25260 See g_inet_address_get_is_mc_org_local().</doc>
25261         <type name="gboolean"/>
25262       </property>
25263       <property name="is-mc-site-local"
25264                 version="2.22"
25265                 transfer-ownership="none">
25266         <doc xml:whitespace="preserve">Whether this is a site-local multicast address.
25267 See g_inet_address_get_is_mc_site_local().</doc>
25268         <type name="gboolean"/>
25269       </property>
25270       <property name="is-multicast" version="2.22" transfer-ownership="none">
25271         <doc xml:whitespace="preserve">Whether this is a multicast address.
25272 See g_inet_address_get_is_multicast().</doc>
25273         <type name="gboolean"/>
25274       </property>
25275       <property name="is-site-local" version="2.22" transfer-ownership="none">
25276         <doc xml:whitespace="preserve">Whether this is a site-local address.
25277 See g_inet_address_get_is_loopback().</doc>
25278         <type name="gboolean"/>
25279       </property>
25280       <field name="parent_instance">
25281         <type name="GObject.Object" c:type="GObject"/>
25282       </field>
25283       <field name="priv">
25284         <type name="InetAddressPrivate" c:type="GInetAddressPrivate*"/>
25285       </field>
25286     </class>
25287     <record name="InetAddressClass"
25288             c:type="GInetAddressClass"
25289             glib:is-gtype-struct-for="InetAddress">
25290       <field name="parent_class">
25291         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
25292       </field>
25293       <field name="to_string">
25294         <callback name="to_string">
25295           <return-value transfer-ownership="full">
25296             <doc xml:whitespace="preserve">a representation of @address as a string, which should be</doc>
25297             <type name="utf8" c:type="gchar*"/>
25298           </return-value>
25299           <parameters>
25300             <parameter name="address" transfer-ownership="none">
25301               <type name="InetAddress" c:type="GInetAddress*"/>
25302             </parameter>
25303           </parameters>
25304         </callback>
25305       </field>
25306       <field name="to_bytes">
25307         <callback name="to_bytes">
25308           <return-value transfer-ownership="none">
25309             <doc xml:whitespace="preserve">a pointer to an internal array of the bytes in @address,</doc>
25310             <type name="guint8" c:type="guint8*"/>
25311           </return-value>
25312           <parameters>
25313             <parameter name="address" transfer-ownership="none">
25314               <type name="InetAddress" c:type="GInetAddress*"/>
25315             </parameter>
25316           </parameters>
25317         </callback>
25318       </field>
25319     </record>
25320     <record name="InetAddressPrivate"
25321             c:type="GInetAddressPrivate"
25322             disguised="1">
25323     </record>
25324     <class name="InetSocketAddress"
25325            c:symbol-prefix="inet_socket_address"
25326            c:type="GInetSocketAddress"
25327            parent="SocketAddress"
25328            glib:type-name="GInetSocketAddress"
25329            glib:get-type="g_inet_socket_address_get_type"
25330            glib:type-struct="InetSocketAddressClass">
25331       <doc xml:whitespace="preserve">An IPv4 or IPv6 socket address, corresponding to a &lt;type&gt;struct
25332 sockaddr_in&lt;/type&gt; or &lt;type&gt;struct sockaddr_in6&lt;/type&gt;.</doc>
25333       <implements name="SocketConnectable"/>
25334       <constructor name="new"
25335                    c:identifier="g_inet_socket_address_new"
25336                    version="2.22">
25337         <doc xml:whitespace="preserve">Creates a new #GInetSocketAddress for @address and @port.</doc>
25338         <return-value transfer-ownership="full">
25339           <doc xml:whitespace="preserve">a new #GInetSocketAddress</doc>
25340           <type name="SocketAddress" c:type="GSocketAddress*"/>
25341         </return-value>
25342         <parameters>
25343           <parameter name="address" transfer-ownership="none">
25344             <doc xml:whitespace="preserve">a #GInetAddress</doc>
25345             <type name="InetAddress" c:type="GInetAddress*"/>
25346           </parameter>
25347           <parameter name="port" transfer-ownership="none">
25348             <doc xml:whitespace="preserve">a port number</doc>
25349             <type name="guint16" c:type="guint16"/>
25350           </parameter>
25351         </parameters>
25352       </constructor>
25353       <method name="get_address"
25354               c:identifier="g_inet_socket_address_get_address"
25355               version="2.22">
25356         <doc xml:whitespace="preserve">Gets @address's #GInetAddress.
25357 g_object_ref()'d if it will be stored</doc>
25358         <return-value transfer-ownership="full">
25359           <doc xml:whitespace="preserve">the #GInetAddress for @address, which must be</doc>
25360           <type name="InetAddress" c:type="GInetAddress*"/>
25361         </return-value>
25362       </method>
25363       <method name="get_port"
25364               c:identifier="g_inet_socket_address_get_port"
25365               version="2.22">
25366         <doc xml:whitespace="preserve">Gets @address's port.</doc>
25367         <return-value transfer-ownership="none">
25368           <doc xml:whitespace="preserve">the port for @address</doc>
25369           <type name="guint16" c:type="guint16"/>
25370         </return-value>
25371       </method>
25372       <property name="address"
25373                 writable="1"
25374                 construct-only="1"
25375                 transfer-ownership="none">
25376         <type name="InetAddress"/>
25377       </property>
25378       <property name="port"
25379                 writable="1"
25380                 construct-only="1"
25381                 transfer-ownership="none">
25382         <type name="guint"/>
25383       </property>
25384       <field name="parent_instance">
25385         <type name="SocketAddress" c:type="GSocketAddress"/>
25386       </field>
25387       <field name="priv">
25388         <type name="InetSocketAddressPrivate"
25389               c:type="GInetSocketAddressPrivate*"/>
25390       </field>
25391     </class>
25392     <record name="InetSocketAddressClass"
25393             c:type="GInetSocketAddressClass"
25394             glib:is-gtype-struct-for="InetSocketAddress">
25395       <field name="parent_class">
25396         <type name="SocketAddressClass" c:type="GSocketAddressClass"/>
25397       </field>
25398     </record>
25399     <record name="InetSocketAddressPrivate"
25400             c:type="GInetSocketAddressPrivate"
25401             disguised="1">
25402     </record>
25403     <interface name="Initable"
25404                c:symbol-prefix="initable"
25405                c:type="GInitable"
25406                version="2.22"
25407                glib:type-name="GInitable"
25408                glib:get-type="g_initable_get_type"
25409                glib:type-struct="InitableIface">
25410       <doc xml:whitespace="preserve">Interface for initializable objects.</doc>
25411       <virtual-method name="init" invoker="init" version="2.22" throws="1">
25412         <doc xml:whitespace="preserve">Initializes the object implementing the interface. This must be
25413 done before any real use of the object after initial construction.
25414 Implementations may also support cancellation. If @cancellable is not %NULL,
25415 then initialization can be cancelled by triggering the cancellable object
25416 from another thread. If the operation was cancelled, the error
25417 %G_IO_ERROR_CANCELLED will be returned. If @cancellable is not %NULL and
25418 the object doesn't support cancellable initialization the error
25419 %G_IO_ERROR_NOT_SUPPORTED will be returned.
25420 If this function is not called, or returns with an error then all
25421 operations on the object should fail, generally returning the
25422 error %G_IO_ERROR_NOT_INITIALIZED.
25423 Implementations of this method must be idempotent, i.e. multiple calls
25424 to this function with the same argument should return the same results.
25425 Only the first call initializes the object, further calls return the result
25426 of the first call. This is so that its safe to implement the singleton
25427 pattern in the GObject constructor function.
25428 return %FALSE and set @error appropriately if present.</doc>
25429         <return-value transfer-ownership="none">
25430           <doc xml:whitespace="preserve">%TRUE if successful. If an error has occurred, this function will</doc>
25431           <type name="gboolean" c:type="gboolean"/>
25432         </return-value>
25433         <parameters>
25434           <parameter name="cancellable"
25435                      transfer-ownership="none"
25436                      allow-none="1">
25437             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
25438             <type name="Cancellable" c:type="GCancellable*"/>
25439           </parameter>
25440         </parameters>
25441       </virtual-method>
25442       <method name="init"
25443               c:identifier="g_initable_init"
25444               version="2.22"
25445               throws="1">
25446         <doc xml:whitespace="preserve">Initializes the object implementing the interface. This must be
25447 done before any real use of the object after initial construction.
25448 Implementations may also support cancellation. If @cancellable is not %NULL,
25449 then initialization can be cancelled by triggering the cancellable object
25450 from another thread. If the operation was cancelled, the error
25451 %G_IO_ERROR_CANCELLED will be returned. If @cancellable is not %NULL and
25452 the object doesn't support cancellable initialization the error
25453 %G_IO_ERROR_NOT_SUPPORTED will be returned.
25454 If this function is not called, or returns with an error then all
25455 operations on the object should fail, generally returning the
25456 error %G_IO_ERROR_NOT_INITIALIZED.
25457 Implementations of this method must be idempotent, i.e. multiple calls
25458 to this function with the same argument should return the same results.
25459 Only the first call initializes the object, further calls return the result
25460 of the first call. This is so that its safe to implement the singleton
25461 pattern in the GObject constructor function.
25462 return %FALSE and set @error appropriately if present.</doc>
25463         <return-value transfer-ownership="none">
25464           <doc xml:whitespace="preserve">%TRUE if successful. If an error has occurred, this function will</doc>
25465           <type name="gboolean" c:type="gboolean"/>
25466         </return-value>
25467         <parameters>
25468           <parameter name="cancellable"
25469                      transfer-ownership="none"
25470                      allow-none="1">
25471             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
25472             <type name="Cancellable" c:type="GCancellable*"/>
25473           </parameter>
25474         </parameters>
25475       </method>
25476     </interface>
25477     <record name="InitableIface"
25478             c:type="GInitableIface"
25479             glib:is-gtype-struct-for="Initable"
25480             version="2.22">
25481       <doc xml:whitespace="preserve">Provides an interface for initializing object such that initialization
25482 may fail.</doc>
25483       <field name="g_iface">
25484         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
25485       </field>
25486       <field name="init">
25487         <callback name="init" throws="1">
25488           <return-value transfer-ownership="none">
25489             <doc xml:whitespace="preserve">%TRUE if successful. If an error has occurred, this function will</doc>
25490             <type name="gboolean" c:type="gboolean"/>
25491           </return-value>
25492           <parameters>
25493             <parameter name="initable" transfer-ownership="none">
25494               <type name="Initable" c:type="GInitable*"/>
25495             </parameter>
25496             <parameter name="cancellable"
25497                        transfer-ownership="none"
25498                        allow-none="1">
25499               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
25500               <type name="Cancellable" c:type="GCancellable*"/>
25501             </parameter>
25502           </parameters>
25503         </callback>
25504       </field>
25505     </record>
25506     <class name="InputStream"
25507            c:symbol-prefix="input_stream"
25508            c:type="GInputStream"
25509            parent="GObject.Object"
25510            abstract="1"
25511            glib:type-name="GInputStream"
25512            glib:get-type="g_input_stream_get_type"
25513            glib:type-struct="InputStreamClass">
25514       <doc xml:whitespace="preserve">Base class for streaming input operations.</doc>
25515       <virtual-method name="close_async" invoker="close_async">
25516         <doc xml:whitespace="preserve">Requests an asynchronous closes of the stream, releasing resources related to it.
25517 When the operation is finished @callback will be called.
25518 You can then call g_input_stream_close_finish() to get the result of the
25519 operation.
25520 For behaviour details see g_input_stream_close().
25521 The asyncronous methods have a default fallback that uses threads to implement
25522 asynchronicity, so they are optional for inheriting classes. However, if you
25523 override one you must override all.</doc>
25524         <return-value transfer-ownership="none">
25525           <type name="none" c:type="void"/>
25526         </return-value>
25527         <parameters>
25528           <parameter name="io_priority" transfer-ownership="none">
25529             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
25530             <type name="gint" c:type="int"/>
25531           </parameter>
25532           <parameter name="cancellable"
25533                      transfer-ownership="none"
25534                      allow-none="1">
25535             <doc xml:whitespace="preserve">optional cancellable object</doc>
25536             <type name="Cancellable" c:type="GCancellable*"/>
25537           </parameter>
25538           <parameter name="callback"
25539                      transfer-ownership="none"
25540                      scope="async"
25541                      closure="3">
25542             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
25543             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
25544           </parameter>
25545           <parameter name="user_data" transfer-ownership="none" closure="3">
25546             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
25547             <type name="gpointer" c:type="gpointer"/>
25548           </parameter>
25549         </parameters>
25550       </virtual-method>
25551       <virtual-method name="close_finish" invoker="close_finish" throws="1">
25552         <doc xml:whitespace="preserve">Finishes closing a stream asynchronously, started from g_input_stream_close_async().</doc>
25553         <return-value transfer-ownership="none">
25554           <doc xml:whitespace="preserve">%TRUE if the stream was closed successfully.</doc>
25555           <type name="gboolean" c:type="gboolean"/>
25556         </return-value>
25557         <parameters>
25558           <parameter name="result" transfer-ownership="none">
25559             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
25560             <type name="AsyncResult" c:type="GAsyncResult*"/>
25561           </parameter>
25562         </parameters>
25563       </virtual-method>
25564       <virtual-method name="close_fn" throws="1">
25565         <return-value transfer-ownership="none">
25566           <type name="gboolean" c:type="gboolean"/>
25567         </return-value>
25568         <parameters>
25569           <parameter name="cancellable" transfer-ownership="none">
25570             <type name="Cancellable" c:type="GCancellable*"/>
25571           </parameter>
25572         </parameters>
25573       </virtual-method>
25574       <virtual-method name="read_async" invoker="read_async">
25575         <doc xml:whitespace="preserve">Request an asynchronous read of @count bytes from the stream into the buffer
25576 starting at @buffer. When the operation is finished @callback will be called.
25577 You can then call g_input_stream_read_finish() to get the result of the
25578 operation.
25579 During an async request no other sync and async calls are allowed on @stream, and will
25580 result in %G_IO_ERROR_PENDING errors.
25581 A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
25582 On success, the number of bytes read into the buffer will be passed to the
25583 callback. It is not an error if this is not the same as the requested size, as it
25584 can happen e.g. near the end of a file, but generally we try to read
25585 as many bytes as requested. Zero is returned on end of file
25586 (or if @count is zero),  but never otherwise.
25587 Any outstanding i/o request with higher priority (lower numerical value) will
25588 be executed before an outstanding request with lower priority. Default
25589 priority is %G_PRIORITY_DEFAULT.
25590 The asyncronous methods have a default fallback that uses threads to implement
25591 asynchronicity, so they are optional for inheriting classes. However, if you
25592 override one you must override all.</doc>
25593         <return-value transfer-ownership="none">
25594           <type name="none" c:type="void"/>
25595         </return-value>
25596         <parameters>
25597           <parameter name="buffer" transfer-ownership="none">
25598             <doc xml:whitespace="preserve">a buffer to read data into (which should be at least count bytes long).</doc>
25599             <type name="gpointer" c:type="void*"/>
25600           </parameter>
25601           <parameter name="count" transfer-ownership="none">
25602             <doc xml:whitespace="preserve">the number of bytes that will be read from the stream</doc>
25603             <type name="gulong" c:type="gsize"/>
25604           </parameter>
25605           <parameter name="io_priority" transfer-ownership="none">
25606             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
25607             <type name="gint" c:type="int"/>
25608           </parameter>
25609           <parameter name="cancellable"
25610                      transfer-ownership="none"
25611                      allow-none="1">
25612             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
25613             <type name="Cancellable" c:type="GCancellable*"/>
25614           </parameter>
25615           <parameter name="callback"
25616                      transfer-ownership="none"
25617                      scope="async"
25618                      closure="5">
25619             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
25620             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
25621           </parameter>
25622           <parameter name="user_data" transfer-ownership="none" closure="5">
25623             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
25624             <type name="gpointer" c:type="gpointer"/>
25625           </parameter>
25626         </parameters>
25627       </virtual-method>
25628       <virtual-method name="read_finish" invoker="read_finish" throws="1">
25629         <doc xml:whitespace="preserve">Finishes an asynchronous stream read operation.</doc>
25630         <return-value transfer-ownership="none">
25631           <doc xml:whitespace="preserve">number of bytes read in, or -1 on error.</doc>
25632           <type name="glong" c:type="gssize"/>
25633         </return-value>
25634         <parameters>
25635           <parameter name="result" transfer-ownership="none">
25636             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
25637             <type name="AsyncResult" c:type="GAsyncResult*"/>
25638           </parameter>
25639         </parameters>
25640       </virtual-method>
25641       <virtual-method name="read_fn" throws="1">
25642         <return-value transfer-ownership="none">
25643           <type name="glong" c:type="gssize"/>
25644         </return-value>
25645         <parameters>
25646           <parameter name="buffer" transfer-ownership="none">
25647             <type name="gpointer" c:type="void*"/>
25648           </parameter>
25649           <parameter name="count" transfer-ownership="none">
25650             <type name="gulong" c:type="gsize"/>
25651           </parameter>
25652           <parameter name="cancellable" transfer-ownership="none">
25653             <type name="Cancellable" c:type="GCancellable*"/>
25654           </parameter>
25655         </parameters>
25656       </virtual-method>
25657       <virtual-method name="skip" invoker="skip" throws="1">
25658         <doc xml:whitespace="preserve">Tries to skip @count bytes from the stream. Will block during the operation.
25659 This is identical to g_input_stream_read(), from a behaviour standpoint,
25660 but the bytes that are skipped are not returned to the user. Some
25661 streams have an implementation that is more efficient than reading the data.
25662 This function is optional for inherited classes, as the default implementation
25663 emulates it using read.
25664 If @cancellable is not %NULL, then the operation can be cancelled by
25665 triggering the cancellable object from another thread. If the operation
25666 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
25667 operation was partially finished when the operation was cancelled the
25668 partial result will be returned, without an error.</doc>
25669         <return-value transfer-ownership="none">
25670           <doc xml:whitespace="preserve">Number of bytes skipped, or -1 on error</doc>
25671           <type name="glong" c:type="gssize"/>
25672         </return-value>
25673         <parameters>
25674           <parameter name="count" transfer-ownership="none">
25675             <doc xml:whitespace="preserve">the number of bytes that will be skipped from the stream</doc>
25676             <type name="gulong" c:type="gsize"/>
25677           </parameter>
25678           <parameter name="cancellable"
25679                      transfer-ownership="none"
25680                      allow-none="1">
25681             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
25682             <type name="Cancellable" c:type="GCancellable*"/>
25683           </parameter>
25684         </parameters>
25685       </virtual-method>
25686       <virtual-method name="skip_async" invoker="skip_async">
25687         <doc xml:whitespace="preserve">Request an asynchronous skip of @count bytes from the stream.
25688 When the operation is finished @callback will be called.
25689 You can then call g_input_stream_skip_finish() to get the result
25690 of the operation.
25691 During an async request no other sync and async calls are allowed,
25692 and will result in %G_IO_ERROR_PENDING errors.
25693 A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
25694 On success, the number of bytes skipped will be passed to the callback.
25695 It is not an error if this is not the same as the requested size, as it
25696 can happen e.g. near the end of a file, but generally we try to skip
25697 as many bytes as requested. Zero is returned on end of file
25698 (or if @count is zero), but never otherwise.
25699 Any outstanding i/o request with higher priority (lower numerical value)
25700 will be executed before an outstanding request with lower priority.
25701 Default priority is %G_PRIORITY_DEFAULT.
25702 The asynchronous methods have a default fallback that uses threads to
25703 implement asynchronicity, so they are optional for inheriting classes.
25704 However, if you override one, you must override all.</doc>
25705         <return-value transfer-ownership="none">
25706           <type name="none" c:type="void"/>
25707         </return-value>
25708         <parameters>
25709           <parameter name="count" transfer-ownership="none">
25710             <doc xml:whitespace="preserve">the number of bytes that will be skipped from the stream</doc>
25711             <type name="gulong" c:type="gsize"/>
25712           </parameter>
25713           <parameter name="io_priority" transfer-ownership="none">
25714             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
25715             <type name="gint" c:type="int"/>
25716           </parameter>
25717           <parameter name="cancellable"
25718                      transfer-ownership="none"
25719                      allow-none="1">
25720             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
25721             <type name="Cancellable" c:type="GCancellable*"/>
25722           </parameter>
25723           <parameter name="callback"
25724                      transfer-ownership="none"
25725                      scope="async"
25726                      closure="4">
25727             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
25728             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
25729           </parameter>
25730           <parameter name="user_data" transfer-ownership="none" closure="4">
25731             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
25732             <type name="gpointer" c:type="gpointer"/>
25733           </parameter>
25734         </parameters>
25735       </virtual-method>
25736       <virtual-method name="skip_finish" invoker="skip_finish" throws="1">
25737         <doc xml:whitespace="preserve">Finishes a stream skip operation.</doc>
25738         <return-value transfer-ownership="none">
25739           <doc xml:whitespace="preserve">the size of the bytes skipped, or %-1 on error.</doc>
25740           <type name="glong" c:type="gssize"/>
25741         </return-value>
25742         <parameters>
25743           <parameter name="result" transfer-ownership="none">
25744             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
25745             <type name="AsyncResult" c:type="GAsyncResult*"/>
25746           </parameter>
25747         </parameters>
25748       </virtual-method>
25749       <method name="clear_pending" c:identifier="g_input_stream_clear_pending">
25750         <doc xml:whitespace="preserve">Clears the pending flag on @stream.</doc>
25751         <return-value transfer-ownership="none">
25752           <type name="none" c:type="void"/>
25753         </return-value>
25754       </method>
25755       <method name="close" c:identifier="g_input_stream_close" throws="1">
25756         <doc xml:whitespace="preserve">Closes the stream, releasing resources related to it.
25757 Once the stream is closed, all other operations will return %G_IO_ERROR_CLOSED.
25758 Closing a stream multiple times will not return an error.
25759 Streams will be automatically closed when the last reference
25760 is dropped, but you might want to call this function to make sure
25761 resources are released as early as possible.
25762 Some streams might keep the backing store of the stream (e.g. a file descriptor)
25763 open after the stream is closed. See the documentation for the individual
25764 stream for details.
25765 On failure the first error that happened will be reported, but the close
25766 operation will finish as much as possible. A stream that failed to
25767 close will still return %G_IO_ERROR_CLOSED for all operations. Still, it
25768 is important to check and report the error to the user.
25769 If @cancellable is not NULL, then the operation can be cancelled by
25770 triggering the cancellable object from another thread. If the operation
25771 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
25772 Cancelling a close will still leave the stream closed, but some streams
25773 can use a faster close that doesn't block to e.g. check errors.</doc>
25774         <return-value transfer-ownership="none">
25775           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on failure</doc>
25776           <type name="gboolean" c:type="gboolean"/>
25777         </return-value>
25778         <parameters>
25779           <parameter name="cancellable"
25780                      transfer-ownership="none"
25781                      allow-none="1">
25782             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
25783             <type name="Cancellable" c:type="GCancellable*"/>
25784           </parameter>
25785         </parameters>
25786       </method>
25787       <method name="close_async" c:identifier="g_input_stream_close_async">
25788         <doc xml:whitespace="preserve">Requests an asynchronous closes of the stream, releasing resources related to it.
25789 When the operation is finished @callback will be called.
25790 You can then call g_input_stream_close_finish() to get the result of the
25791 operation.
25792 For behaviour details see g_input_stream_close().
25793 The asyncronous methods have a default fallback that uses threads to implement
25794 asynchronicity, so they are optional for inheriting classes. However, if you
25795 override one you must override all.</doc>
25796         <return-value transfer-ownership="none">
25797           <type name="none" c:type="void"/>
25798         </return-value>
25799         <parameters>
25800           <parameter name="io_priority" transfer-ownership="none">
25801             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
25802             <type name="gint" c:type="int"/>
25803           </parameter>
25804           <parameter name="cancellable"
25805                      transfer-ownership="none"
25806                      allow-none="1">
25807             <doc xml:whitespace="preserve">optional cancellable object</doc>
25808             <type name="Cancellable" c:type="GCancellable*"/>
25809           </parameter>
25810           <parameter name="callback"
25811                      transfer-ownership="none"
25812                      scope="async"
25813                      closure="3">
25814             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
25815             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
25816           </parameter>
25817           <parameter name="user_data" transfer-ownership="none">
25818             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
25819             <type name="gpointer" c:type="gpointer"/>
25820           </parameter>
25821         </parameters>
25822       </method>
25823       <method name="close_finish"
25824               c:identifier="g_input_stream_close_finish"
25825               throws="1">
25826         <doc xml:whitespace="preserve">Finishes closing a stream asynchronously, started from g_input_stream_close_async().</doc>
25827         <return-value transfer-ownership="none">
25828           <doc xml:whitespace="preserve">%TRUE if the stream was closed successfully.</doc>
25829           <type name="gboolean" c:type="gboolean"/>
25830         </return-value>
25831         <parameters>
25832           <parameter name="result" transfer-ownership="none">
25833             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
25834             <type name="AsyncResult" c:type="GAsyncResult*"/>
25835           </parameter>
25836         </parameters>
25837       </method>
25838       <method name="has_pending" c:identifier="g_input_stream_has_pending">
25839         <doc xml:whitespace="preserve">Checks if an input stream has pending actions.</doc>
25840         <return-value transfer-ownership="none">
25841           <doc xml:whitespace="preserve">%TRUE if @stream has pending actions.</doc>
25842           <type name="gboolean" c:type="gboolean"/>
25843         </return-value>
25844       </method>
25845       <method name="is_closed" c:identifier="g_input_stream_is_closed">
25846         <doc xml:whitespace="preserve">Checks if an input stream is closed.</doc>
25847         <return-value transfer-ownership="none">
25848           <doc xml:whitespace="preserve">%TRUE if the stream is closed.</doc>
25849           <type name="gboolean" c:type="gboolean"/>
25850         </return-value>
25851       </method>
25852       <method name="read" c:identifier="g_input_stream_read" throws="1">
25853         <doc xml:whitespace="preserve">Tries to read @count bytes from the stream into the buffer starting at
25854 If count is zero returns zero and does nothing. A value of @count
25855 larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
25856 On success, the number of bytes read into the buffer is returned.
25857 It is not an error if this is not the same as the requested size, as it
25858 can happen e.g. near the end of a file. Zero is returned on end of file
25859 (or if @count is zero),  but never otherwise.
25860 If @cancellable is not NULL, then the operation can be cancelled by
25861 triggering the cancellable object from another thread. If the operation
25862 was cancelled, the error G_IO_ERROR_CANCELLED will be returned. If an
25863 operation was partially finished when the operation was cancelled the
25864 partial result will be returned, without an error.
25865 On error -1 is returned and @error is set accordingly.</doc>
25866         <return-value transfer-ownership="none">
25867           <doc xml:whitespace="preserve">Number of bytes read, or -1 on error</doc>
25868           <type name="glong" c:type="gssize"/>
25869         </return-value>
25870         <parameters>
25871           <parameter name="buffer" transfer-ownership="none">
25872             <doc xml:whitespace="preserve">a buffer to read data into (which should be at least count bytes long).</doc>
25873             <type name="gpointer" c:type="void*"/>
25874           </parameter>
25875           <parameter name="count" transfer-ownership="none">
25876             <doc xml:whitespace="preserve">the number of bytes that will be read from the stream</doc>
25877             <type name="gulong" c:type="gsize"/>
25878           </parameter>
25879           <parameter name="cancellable"
25880                      transfer-ownership="none"
25881                      allow-none="1">
25882             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
25883             <type name="Cancellable" c:type="GCancellable*"/>
25884           </parameter>
25885         </parameters>
25886       </method>
25887       <method name="read_all"
25888               c:identifier="g_input_stream_read_all"
25889               throws="1">
25890         <doc xml:whitespace="preserve">Tries to read @count bytes from the stream into the buffer starting at
25891 This function is similar to g_input_stream_read(), except it tries to
25892 read as many bytes as requested, only stopping on an error or end of stream.
25893 On a successful read of @count bytes, or if we reached the end of the
25894 stream,  %TRUE is returned, and @bytes_read is set to the number of bytes
25895 read into @buffer.
25896 If there is an error during the operation %FALSE is returned and @error
25897 is set to indicate the error status, @bytes_read is updated to contain
25898 the number of bytes read into @buffer before the error occurred.</doc>
25899         <return-value transfer-ownership="none">
25900           <doc xml:whitespace="preserve">%TRUE on success, %FALSE if there was an error</doc>
25901           <type name="gboolean" c:type="gboolean"/>
25902         </return-value>
25903         <parameters>
25904           <parameter name="buffer" transfer-ownership="none">
25905             <doc xml:whitespace="preserve">a buffer to read data into (which should be at least count bytes long).</doc>
25906             <type name="gpointer" c:type="void*"/>
25907           </parameter>
25908           <parameter name="count" transfer-ownership="none">
25909             <doc xml:whitespace="preserve">the number of bytes that will be read from the stream</doc>
25910             <type name="gulong" c:type="gsize"/>
25911           </parameter>
25912           <parameter name="bytes_read" transfer-ownership="none">
25913             <doc xml:whitespace="preserve">location to store the number of bytes that was read from the stream</doc>
25914             <type name="gulong" c:type="gsize*"/>
25915           </parameter>
25916           <parameter name="cancellable"
25917                      transfer-ownership="none"
25918                      allow-none="1">
25919             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
25920             <type name="Cancellable" c:type="GCancellable*"/>
25921           </parameter>
25922         </parameters>
25923       </method>
25924       <method name="read_async" c:identifier="g_input_stream_read_async">
25925         <doc xml:whitespace="preserve">Request an asynchronous read of @count bytes from the stream into the buffer
25926 starting at @buffer. When the operation is finished @callback will be called.
25927 You can then call g_input_stream_read_finish() to get the result of the
25928 operation.
25929 During an async request no other sync and async calls are allowed on @stream, and will
25930 result in %G_IO_ERROR_PENDING errors.
25931 A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
25932 On success, the number of bytes read into the buffer will be passed to the
25933 callback. It is not an error if this is not the same as the requested size, as it
25934 can happen e.g. near the end of a file, but generally we try to read
25935 as many bytes as requested. Zero is returned on end of file
25936 (or if @count is zero),  but never otherwise.
25937 Any outstanding i/o request with higher priority (lower numerical value) will
25938 be executed before an outstanding request with lower priority. Default
25939 priority is %G_PRIORITY_DEFAULT.
25940 The asyncronous methods have a default fallback that uses threads to implement
25941 asynchronicity, so they are optional for inheriting classes. However, if you
25942 override one you must override all.</doc>
25943         <return-value transfer-ownership="none">
25944           <type name="none" c:type="void"/>
25945         </return-value>
25946         <parameters>
25947           <parameter name="buffer" transfer-ownership="none">
25948             <doc xml:whitespace="preserve">a buffer to read data into (which should be at least count bytes long).</doc>
25949             <type name="gpointer" c:type="void*"/>
25950           </parameter>
25951           <parameter name="count" transfer-ownership="none">
25952             <doc xml:whitespace="preserve">the number of bytes that will be read from the stream</doc>
25953             <type name="gulong" c:type="gsize"/>
25954           </parameter>
25955           <parameter name="io_priority" transfer-ownership="none">
25956             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
25957             <type name="gint" c:type="int"/>
25958           </parameter>
25959           <parameter name="cancellable"
25960                      transfer-ownership="none"
25961                      allow-none="1">
25962             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
25963             <type name="Cancellable" c:type="GCancellable*"/>
25964           </parameter>
25965           <parameter name="callback"
25966                      transfer-ownership="none"
25967                      scope="async"
25968                      closure="5">
25969             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
25970             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
25971           </parameter>
25972           <parameter name="user_data" transfer-ownership="none">
25973             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
25974             <type name="gpointer" c:type="gpointer"/>
25975           </parameter>
25976         </parameters>
25977       </method>
25978       <method name="read_finish"
25979               c:identifier="g_input_stream_read_finish"
25980               throws="1">
25981         <doc xml:whitespace="preserve">Finishes an asynchronous stream read operation.</doc>
25982         <return-value transfer-ownership="none">
25983           <doc xml:whitespace="preserve">number of bytes read in, or -1 on error.</doc>
25984           <type name="glong" c:type="gssize"/>
25985         </return-value>
25986         <parameters>
25987           <parameter name="result" transfer-ownership="none">
25988             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
25989             <type name="AsyncResult" c:type="GAsyncResult*"/>
25990           </parameter>
25991         </parameters>
25992       </method>
25993       <method name="set_pending"
25994               c:identifier="g_input_stream_set_pending"
25995               throws="1">
25996         <doc xml:whitespace="preserve">Sets @stream to have actions pending. If the pending flag is
25997 already set or @stream is closed, it will return %FALSE and set</doc>
25998         <return-value transfer-ownership="none">
25999           <doc xml:whitespace="preserve">%TRUE if pending was previously unset and is now set.</doc>
26000           <type name="gboolean" c:type="gboolean"/>
26001         </return-value>
26002       </method>
26003       <method name="skip" c:identifier="g_input_stream_skip" throws="1">
26004         <doc xml:whitespace="preserve">Tries to skip @count bytes from the stream. Will block during the operation.
26005 This is identical to g_input_stream_read(), from a behaviour standpoint,
26006 but the bytes that are skipped are not returned to the user. Some
26007 streams have an implementation that is more efficient than reading the data.
26008 This function is optional for inherited classes, as the default implementation
26009 emulates it using read.
26010 If @cancellable is not %NULL, then the operation can be cancelled by
26011 triggering the cancellable object from another thread. If the operation
26012 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
26013 operation was partially finished when the operation was cancelled the
26014 partial result will be returned, without an error.</doc>
26015         <return-value transfer-ownership="none">
26016           <doc xml:whitespace="preserve">Number of bytes skipped, or -1 on error</doc>
26017           <type name="glong" c:type="gssize"/>
26018         </return-value>
26019         <parameters>
26020           <parameter name="count" transfer-ownership="none">
26021             <doc xml:whitespace="preserve">the number of bytes that will be skipped from the stream</doc>
26022             <type name="gulong" c:type="gsize"/>
26023           </parameter>
26024           <parameter name="cancellable"
26025                      transfer-ownership="none"
26026                      allow-none="1">
26027             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
26028             <type name="Cancellable" c:type="GCancellable*"/>
26029           </parameter>
26030         </parameters>
26031       </method>
26032       <method name="skip_async" c:identifier="g_input_stream_skip_async">
26033         <doc xml:whitespace="preserve">Request an asynchronous skip of @count bytes from the stream.
26034 When the operation is finished @callback will be called.
26035 You can then call g_input_stream_skip_finish() to get the result
26036 of the operation.
26037 During an async request no other sync and async calls are allowed,
26038 and will result in %G_IO_ERROR_PENDING errors.
26039 A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
26040 On success, the number of bytes skipped will be passed to the callback.
26041 It is not an error if this is not the same as the requested size, as it
26042 can happen e.g. near the end of a file, but generally we try to skip
26043 as many bytes as requested. Zero is returned on end of file
26044 (or if @count is zero), but never otherwise.
26045 Any outstanding i/o request with higher priority (lower numerical value)
26046 will be executed before an outstanding request with lower priority.
26047 Default priority is %G_PRIORITY_DEFAULT.
26048 The asynchronous methods have a default fallback that uses threads to
26049 implement asynchronicity, so they are optional for inheriting classes.
26050 However, if you override one, you must override all.</doc>
26051         <return-value transfer-ownership="none">
26052           <type name="none" c:type="void"/>
26053         </return-value>
26054         <parameters>
26055           <parameter name="count" transfer-ownership="none">
26056             <doc xml:whitespace="preserve">the number of bytes that will be skipped from the stream</doc>
26057             <type name="gulong" c:type="gsize"/>
26058           </parameter>
26059           <parameter name="io_priority" transfer-ownership="none">
26060             <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
26061             <type name="gint" c:type="int"/>
26062           </parameter>
26063           <parameter name="cancellable"
26064                      transfer-ownership="none"
26065                      allow-none="1">
26066             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
26067             <type name="Cancellable" c:type="GCancellable*"/>
26068           </parameter>
26069           <parameter name="callback"
26070                      transfer-ownership="none"
26071                      scope="async"
26072                      closure="4">
26073             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
26074             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
26075           </parameter>
26076           <parameter name="user_data" transfer-ownership="none">
26077             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
26078             <type name="gpointer" c:type="gpointer"/>
26079           </parameter>
26080         </parameters>
26081       </method>
26082       <method name="skip_finish"
26083               c:identifier="g_input_stream_skip_finish"
26084               throws="1">
26085         <doc xml:whitespace="preserve">Finishes a stream skip operation.</doc>
26086         <return-value transfer-ownership="none">
26087           <doc xml:whitespace="preserve">the size of the bytes skipped, or %-1 on error.</doc>
26088           <type name="glong" c:type="gssize"/>
26089         </return-value>
26090         <parameters>
26091           <parameter name="result" transfer-ownership="none">
26092             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
26093             <type name="AsyncResult" c:type="GAsyncResult*"/>
26094           </parameter>
26095         </parameters>
26096       </method>
26097       <field name="parent_instance">
26098         <type name="GObject.Object" c:type="GObject"/>
26099       </field>
26100       <field name="priv">
26101         <type name="InputStreamPrivate" c:type="GInputStreamPrivate*"/>
26102       </field>
26103     </class>
26104     <record name="InputStreamClass"
26105             c:type="GInputStreamClass"
26106             glib:is-gtype-struct-for="InputStream">
26107       <field name="parent_class">
26108         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
26109       </field>
26110       <field name="read_fn">
26111         <callback name="read_fn" throws="1">
26112           <return-value transfer-ownership="none">
26113             <type name="glong" c:type="gssize"/>
26114           </return-value>
26115           <parameters>
26116             <parameter name="stream" transfer-ownership="none">
26117               <type name="InputStream" c:type="GInputStream*"/>
26118             </parameter>
26119             <parameter name="buffer" transfer-ownership="none">
26120               <type name="gpointer" c:type="void*"/>
26121             </parameter>
26122             <parameter name="count" transfer-ownership="none">
26123               <type name="gulong" c:type="gsize"/>
26124             </parameter>
26125             <parameter name="cancellable" transfer-ownership="none">
26126               <type name="Cancellable" c:type="GCancellable*"/>
26127             </parameter>
26128           </parameters>
26129         </callback>
26130       </field>
26131       <field name="skip">
26132         <callback name="skip" throws="1">
26133           <return-value transfer-ownership="none">
26134             <doc xml:whitespace="preserve">Number of bytes skipped, or -1 on error</doc>
26135             <type name="glong" c:type="gssize"/>
26136           </return-value>
26137           <parameters>
26138             <parameter name="stream" transfer-ownership="none">
26139               <type name="InputStream" c:type="GInputStream*"/>
26140             </parameter>
26141             <parameter name="count" transfer-ownership="none">
26142               <doc xml:whitespace="preserve">the number of bytes that will be skipped from the stream</doc>
26143               <type name="gulong" c:type="gsize"/>
26144             </parameter>
26145             <parameter name="cancellable"
26146                        transfer-ownership="none"
26147                        allow-none="1">
26148               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
26149               <type name="Cancellable" c:type="GCancellable*"/>
26150             </parameter>
26151           </parameters>
26152         </callback>
26153       </field>
26154       <field name="close_fn">
26155         <callback name="close_fn" throws="1">
26156           <return-value transfer-ownership="none">
26157             <type name="gboolean" c:type="gboolean"/>
26158           </return-value>
26159           <parameters>
26160             <parameter name="stream" transfer-ownership="none">
26161               <type name="InputStream" c:type="GInputStream*"/>
26162             </parameter>
26163             <parameter name="cancellable" transfer-ownership="none">
26164               <type name="Cancellable" c:type="GCancellable*"/>
26165             </parameter>
26166           </parameters>
26167         </callback>
26168       </field>
26169       <field name="read_async">
26170         <callback name="read_async">
26171           <return-value transfer-ownership="none">
26172             <type name="none" c:type="void"/>
26173           </return-value>
26174           <parameters>
26175             <parameter name="stream" transfer-ownership="none">
26176               <type name="InputStream" c:type="GInputStream*"/>
26177             </parameter>
26178             <parameter name="buffer" transfer-ownership="none">
26179               <doc xml:whitespace="preserve">a buffer to read data into (which should be at least count bytes long).</doc>
26180               <type name="gpointer" c:type="void*"/>
26181             </parameter>
26182             <parameter name="count" transfer-ownership="none">
26183               <doc xml:whitespace="preserve">the number of bytes that will be read from the stream</doc>
26184               <type name="gulong" c:type="gsize"/>
26185             </parameter>
26186             <parameter name="io_priority" transfer-ownership="none">
26187               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
26188               <type name="gint" c:type="int"/>
26189             </parameter>
26190             <parameter name="cancellable"
26191                        transfer-ownership="none"
26192                        allow-none="1">
26193               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
26194               <type name="Cancellable" c:type="GCancellable*"/>
26195             </parameter>
26196             <parameter name="callback"
26197                        transfer-ownership="none"
26198                        scope="async"
26199                        closure="6">
26200               <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
26201               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
26202             </parameter>
26203             <parameter name="user_data" transfer-ownership="none" closure="6">
26204               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
26205               <type name="gpointer" c:type="gpointer"/>
26206             </parameter>
26207           </parameters>
26208         </callback>
26209       </field>
26210       <field name="read_finish">
26211         <callback name="read_finish" throws="1">
26212           <return-value transfer-ownership="none">
26213             <doc xml:whitespace="preserve">number of bytes read in, or -1 on error.</doc>
26214             <type name="glong" c:type="gssize"/>
26215           </return-value>
26216           <parameters>
26217             <parameter name="stream" transfer-ownership="none">
26218               <type name="InputStream" c:type="GInputStream*"/>
26219             </parameter>
26220             <parameter name="result" transfer-ownership="none">
26221               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
26222               <type name="AsyncResult" c:type="GAsyncResult*"/>
26223             </parameter>
26224           </parameters>
26225         </callback>
26226       </field>
26227       <field name="skip_async">
26228         <callback name="skip_async">
26229           <return-value transfer-ownership="none">
26230             <type name="none" c:type="void"/>
26231           </return-value>
26232           <parameters>
26233             <parameter name="stream" transfer-ownership="none">
26234               <type name="InputStream" c:type="GInputStream*"/>
26235             </parameter>
26236             <parameter name="count" transfer-ownership="none">
26237               <doc xml:whitespace="preserve">the number of bytes that will be skipped from the stream</doc>
26238               <type name="gulong" c:type="gsize"/>
26239             </parameter>
26240             <parameter name="io_priority" transfer-ownership="none">
26241               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
26242               <type name="gint" c:type="int"/>
26243             </parameter>
26244             <parameter name="cancellable"
26245                        transfer-ownership="none"
26246                        allow-none="1">
26247               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
26248               <type name="Cancellable" c:type="GCancellable*"/>
26249             </parameter>
26250             <parameter name="callback"
26251                        transfer-ownership="none"
26252                        scope="async"
26253                        closure="5">
26254               <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
26255               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
26256             </parameter>
26257             <parameter name="user_data" transfer-ownership="none" closure="5">
26258               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
26259               <type name="gpointer" c:type="gpointer"/>
26260             </parameter>
26261           </parameters>
26262         </callback>
26263       </field>
26264       <field name="skip_finish">
26265         <callback name="skip_finish" throws="1">
26266           <return-value transfer-ownership="none">
26267             <doc xml:whitespace="preserve">the size of the bytes skipped, or %-1 on error.</doc>
26268             <type name="glong" c:type="gssize"/>
26269           </return-value>
26270           <parameters>
26271             <parameter name="stream" transfer-ownership="none">
26272               <type name="InputStream" c:type="GInputStream*"/>
26273             </parameter>
26274             <parameter name="result" transfer-ownership="none">
26275               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
26276               <type name="AsyncResult" c:type="GAsyncResult*"/>
26277             </parameter>
26278           </parameters>
26279         </callback>
26280       </field>
26281       <field name="close_async">
26282         <callback name="close_async">
26283           <return-value transfer-ownership="none">
26284             <type name="none" c:type="void"/>
26285           </return-value>
26286           <parameters>
26287             <parameter name="stream" transfer-ownership="none">
26288               <type name="InputStream" c:type="GInputStream*"/>
26289             </parameter>
26290             <parameter name="io_priority" transfer-ownership="none">
26291               <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the request.</doc>
26292               <type name="gint" c:type="int"/>
26293             </parameter>
26294             <parameter name="cancellable"
26295                        transfer-ownership="none"
26296                        allow-none="1">
26297               <doc xml:whitespace="preserve">optional cancellable object</doc>
26298               <type name="Cancellable" c:type="GCancellable*"/>
26299             </parameter>
26300             <parameter name="callback"
26301                        transfer-ownership="none"
26302                        scope="async"
26303                        closure="4">
26304               <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
26305               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
26306             </parameter>
26307             <parameter name="user_data" transfer-ownership="none" closure="4">
26308               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
26309               <type name="gpointer" c:type="gpointer"/>
26310             </parameter>
26311           </parameters>
26312         </callback>
26313       </field>
26314       <field name="close_finish">
26315         <callback name="close_finish" throws="1">
26316           <return-value transfer-ownership="none">
26317             <doc xml:whitespace="preserve">%TRUE if the stream was closed successfully.</doc>
26318             <type name="gboolean" c:type="gboolean"/>
26319           </return-value>
26320           <parameters>
26321             <parameter name="stream" transfer-ownership="none">
26322               <type name="InputStream" c:type="GInputStream*"/>
26323             </parameter>
26324             <parameter name="result" transfer-ownership="none">
26325               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
26326               <type name="AsyncResult" c:type="GAsyncResult*"/>
26327             </parameter>
26328           </parameters>
26329         </callback>
26330       </field>
26331       <field name="_g_reserved1" introspectable="0">
26332         <callback name="_g_reserved1">
26333           <return-value transfer-ownership="none">
26334             <type name="none" c:type="void"/>
26335           </return-value>
26336         </callback>
26337       </field>
26338       <field name="_g_reserved2" introspectable="0">
26339         <callback name="_g_reserved2">
26340           <return-value transfer-ownership="none">
26341             <type name="none" c:type="void"/>
26342           </return-value>
26343         </callback>
26344       </field>
26345       <field name="_g_reserved3" introspectable="0">
26346         <callback name="_g_reserved3">
26347           <return-value transfer-ownership="none">
26348             <type name="none" c:type="void"/>
26349           </return-value>
26350         </callback>
26351       </field>
26352       <field name="_g_reserved4" introspectable="0">
26353         <callback name="_g_reserved4">
26354           <return-value transfer-ownership="none">
26355             <type name="none" c:type="void"/>
26356           </return-value>
26357         </callback>
26358       </field>
26359       <field name="_g_reserved5" introspectable="0">
26360         <callback name="_g_reserved5">
26361           <return-value transfer-ownership="none">
26362             <type name="none" c:type="void"/>
26363           </return-value>
26364         </callback>
26365       </field>
26366     </record>
26367     <record name="InputStreamPrivate"
26368             c:type="GInputStreamPrivate"
26369             disguised="1">
26370     </record>
26371     <record name="InputVector" c:type="GInputVector" version="2.22">
26372       <doc xml:whitespace="preserve">Structure used for scatter/gather data input.
26373 You generally pass in an array of #GInputVector&lt;!-- --&gt;s
26374 and the operation will store the read data starting in the
26375 first buffer, switching to the next as needed.</doc>
26376       <field name="buffer" writable="1">
26377         <type name="gpointer" c:type="gpointer"/>
26378       </field>
26379       <field name="size" writable="1">
26380         <type name="gulong" c:type="gsize"/>
26381       </field>
26382     </record>
26383     <interface name="LoadableIcon"
26384                c:symbol-prefix="loadable_icon"
26385                c:type="GLoadableIcon"
26386                glib:type-name="GLoadableIcon"
26387                glib:get-type="g_loadable_icon_get_type"
26388                glib:type-struct="LoadableIconIface">
26389       <doc xml:whitespace="preserve">Generic type for all kinds of icons that can be loaded
26390 as a stream.</doc>
26391       <prerequisite name="Icon"/>
26392       <virtual-method name="load" invoker="load" throws="1">
26393         <doc xml:whitespace="preserve">Loads a loadable icon. For the asynchronous version of this function,
26394 see g_loadable_icon_load_async().</doc>
26395         <return-value transfer-ownership="full">
26396           <doc xml:whitespace="preserve">a #GInputStream to read the icon from.</doc>
26397           <type name="InputStream" c:type="GInputStream*"/>
26398         </return-value>
26399         <parameters>
26400           <parameter name="size" transfer-ownership="none">
26401             <doc xml:whitespace="preserve">an integer.</doc>
26402             <type name="gint" c:type="int"/>
26403           </parameter>
26404           <parameter name="type" transfer-ownership="none">
26405             <doc xml:whitespace="preserve">a location to store the type of the loaded icon, %NULL to ignore.</doc>
26406             <type name="utf8" c:type="char**"/>
26407           </parameter>
26408           <parameter name="cancellable"
26409                      transfer-ownership="none"
26410                      allow-none="1">
26411             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
26412             <type name="Cancellable" c:type="GCancellable*"/>
26413           </parameter>
26414         </parameters>
26415       </virtual-method>
26416       <virtual-method name="load_async" invoker="load_async">
26417         <doc xml:whitespace="preserve">Loads an icon asynchronously. To finish this function, see
26418 g_loadable_icon_load_finish(). For the synchronous, blocking
26419 version of this function, see g_loadable_icon_load().</doc>
26420         <return-value transfer-ownership="none">
26421           <type name="none" c:type="void"/>
26422         </return-value>
26423         <parameters>
26424           <parameter name="size" transfer-ownership="none">
26425             <doc xml:whitespace="preserve">an integer.</doc>
26426             <type name="gint" c:type="int"/>
26427           </parameter>
26428           <parameter name="cancellable"
26429                      transfer-ownership="none"
26430                      allow-none="1">
26431             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
26432             <type name="Cancellable" c:type="GCancellable*"/>
26433           </parameter>
26434           <parameter name="callback"
26435                      transfer-ownership="none"
26436                      scope="async"
26437                      closure="3">
26438             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
26439             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
26440           </parameter>
26441           <parameter name="user_data" transfer-ownership="none" closure="3">
26442             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
26443             <type name="gpointer" c:type="gpointer"/>
26444           </parameter>
26445         </parameters>
26446       </virtual-method>
26447       <virtual-method name="load_finish" invoker="load_finish" throws="1">
26448         <doc xml:whitespace="preserve">Finishes an asynchronous icon load started in g_loadable_icon_load_async().</doc>
26449         <return-value transfer-ownership="full">
26450           <doc xml:whitespace="preserve">a #GInputStream to read the icon from.</doc>
26451           <type name="InputStream" c:type="GInputStream*"/>
26452         </return-value>
26453         <parameters>
26454           <parameter name="res" transfer-ownership="none">
26455             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
26456             <type name="AsyncResult" c:type="GAsyncResult*"/>
26457           </parameter>
26458           <parameter name="type" transfer-ownership="none">
26459             <doc xml:whitespace="preserve">a location to store the type of the loaded icon, %NULL to ignore.</doc>
26460             <type name="utf8" c:type="char**"/>
26461           </parameter>
26462         </parameters>
26463       </virtual-method>
26464       <method name="load" c:identifier="g_loadable_icon_load" throws="1">
26465         <doc xml:whitespace="preserve">Loads a loadable icon. For the asynchronous version of this function,
26466 see g_loadable_icon_load_async().</doc>
26467         <return-value transfer-ownership="full">
26468           <doc xml:whitespace="preserve">a #GInputStream to read the icon from.</doc>
26469           <type name="InputStream" c:type="GInputStream*"/>
26470         </return-value>
26471         <parameters>
26472           <parameter name="size" transfer-ownership="none">
26473             <doc xml:whitespace="preserve">an integer.</doc>
26474             <type name="gint" c:type="int"/>
26475           </parameter>
26476           <parameter name="type" transfer-ownership="none">
26477             <doc xml:whitespace="preserve">a location to store the type of the loaded icon, %NULL to ignore.</doc>
26478             <type name="utf8" c:type="char**"/>
26479           </parameter>
26480           <parameter name="cancellable"
26481                      transfer-ownership="none"
26482                      allow-none="1">
26483             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
26484             <type name="Cancellable" c:type="GCancellable*"/>
26485           </parameter>
26486         </parameters>
26487       </method>
26488       <method name="load_async" c:identifier="g_loadable_icon_load_async">
26489         <doc xml:whitespace="preserve">Loads an icon asynchronously. To finish this function, see
26490 g_loadable_icon_load_finish(). For the synchronous, blocking
26491 version of this function, see g_loadable_icon_load().</doc>
26492         <return-value transfer-ownership="none">
26493           <type name="none" c:type="void"/>
26494         </return-value>
26495         <parameters>
26496           <parameter name="size" transfer-ownership="none">
26497             <doc xml:whitespace="preserve">an integer.</doc>
26498             <type name="gint" c:type="int"/>
26499           </parameter>
26500           <parameter name="cancellable"
26501                      transfer-ownership="none"
26502                      allow-none="1">
26503             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
26504             <type name="Cancellable" c:type="GCancellable*"/>
26505           </parameter>
26506           <parameter name="callback"
26507                      transfer-ownership="none"
26508                      scope="async"
26509                      closure="3">
26510             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
26511             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
26512           </parameter>
26513           <parameter name="user_data" transfer-ownership="none">
26514             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
26515             <type name="gpointer" c:type="gpointer"/>
26516           </parameter>
26517         </parameters>
26518       </method>
26519       <method name="load_finish"
26520               c:identifier="g_loadable_icon_load_finish"
26521               throws="1">
26522         <doc xml:whitespace="preserve">Finishes an asynchronous icon load started in g_loadable_icon_load_async().</doc>
26523         <return-value transfer-ownership="full">
26524           <doc xml:whitespace="preserve">a #GInputStream to read the icon from.</doc>
26525           <type name="InputStream" c:type="GInputStream*"/>
26526         </return-value>
26527         <parameters>
26528           <parameter name="res" transfer-ownership="none">
26529             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
26530             <type name="AsyncResult" c:type="GAsyncResult*"/>
26531           </parameter>
26532           <parameter name="type" transfer-ownership="none">
26533             <doc xml:whitespace="preserve">a location to store the type of the loaded icon, %NULL to ignore.</doc>
26534             <type name="utf8" c:type="char**"/>
26535           </parameter>
26536         </parameters>
26537       </method>
26538     </interface>
26539     <record name="LoadableIconIface"
26540             c:type="GLoadableIconIface"
26541             glib:is-gtype-struct-for="LoadableIcon">
26542       <doc xml:whitespace="preserve">Interface for icons that can be loaded as a stream.</doc>
26543       <field name="g_iface">
26544         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
26545       </field>
26546       <field name="load">
26547         <callback name="load" throws="1">
26548           <return-value transfer-ownership="full">
26549             <doc xml:whitespace="preserve">a #GInputStream to read the icon from.</doc>
26550             <type name="InputStream" c:type="GInputStream*"/>
26551           </return-value>
26552           <parameters>
26553             <parameter name="icon" transfer-ownership="none">
26554               <type name="LoadableIcon" c:type="GLoadableIcon*"/>
26555             </parameter>
26556             <parameter name="size" transfer-ownership="none">
26557               <doc xml:whitespace="preserve">an integer.</doc>
26558               <type name="gint" c:type="int"/>
26559             </parameter>
26560             <parameter name="type" transfer-ownership="none">
26561               <doc xml:whitespace="preserve">a location to store the type of the loaded icon, %NULL to ignore.</doc>
26562               <type name="utf8" c:type="char**"/>
26563             </parameter>
26564             <parameter name="cancellable"
26565                        transfer-ownership="none"
26566                        allow-none="1">
26567               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
26568               <type name="Cancellable" c:type="GCancellable*"/>
26569             </parameter>
26570           </parameters>
26571         </callback>
26572       </field>
26573       <field name="load_async">
26574         <callback name="load_async">
26575           <return-value transfer-ownership="none">
26576             <type name="none" c:type="void"/>
26577           </return-value>
26578           <parameters>
26579             <parameter name="icon" transfer-ownership="none">
26580               <type name="LoadableIcon" c:type="GLoadableIcon*"/>
26581             </parameter>
26582             <parameter name="size" transfer-ownership="none">
26583               <doc xml:whitespace="preserve">an integer.</doc>
26584               <type name="gint" c:type="int"/>
26585             </parameter>
26586             <parameter name="cancellable"
26587                        transfer-ownership="none"
26588                        allow-none="1">
26589               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
26590               <type name="Cancellable" c:type="GCancellable*"/>
26591             </parameter>
26592             <parameter name="callback"
26593                        transfer-ownership="none"
26594                        scope="async"
26595                        closure="4">
26596               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
26597               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
26598             </parameter>
26599             <parameter name="user_data" transfer-ownership="none" closure="4">
26600               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
26601               <type name="gpointer" c:type="gpointer"/>
26602             </parameter>
26603           </parameters>
26604         </callback>
26605       </field>
26606       <field name="load_finish">
26607         <callback name="load_finish" throws="1">
26608           <return-value transfer-ownership="full">
26609             <doc xml:whitespace="preserve">a #GInputStream to read the icon from.</doc>
26610             <type name="InputStream" c:type="GInputStream*"/>
26611           </return-value>
26612           <parameters>
26613             <parameter name="icon" transfer-ownership="none">
26614               <type name="LoadableIcon" c:type="GLoadableIcon*"/>
26615             </parameter>
26616             <parameter name="res" transfer-ownership="none">
26617               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
26618               <type name="AsyncResult" c:type="GAsyncResult*"/>
26619             </parameter>
26620             <parameter name="type" transfer-ownership="none">
26621               <doc xml:whitespace="preserve">a location to store the type of the loaded icon, %NULL to ignore.</doc>
26622               <type name="utf8" c:type="char**"/>
26623             </parameter>
26624           </parameters>
26625         </callback>
26626       </field>
26627     </record>
26628     <class name="MemoryInputStream"
26629            c:symbol-prefix="memory_input_stream"
26630            c:type="GMemoryInputStream"
26631            parent="InputStream"
26632            glib:type-name="GMemoryInputStream"
26633            glib:get-type="g_memory_input_stream_get_type"
26634            glib:type-struct="MemoryInputStreamClass">
26635       <doc xml:whitespace="preserve">Implements #GInputStream for arbitrary memory chunks.</doc>
26636       <implements name="Seekable"/>
26637       <constructor name="new" c:identifier="g_memory_input_stream_new">
26638         <doc xml:whitespace="preserve">Creates a new empty #GMemoryInputStream.</doc>
26639         <return-value transfer-ownership="full">
26640           <doc xml:whitespace="preserve">a new #GInputStream</doc>
26641           <type name="InputStream" c:type="GInputStream*"/>
26642         </return-value>
26643       </constructor>
26644       <constructor name="new_from_data"
26645                    c:identifier="g_memory_input_stream_new_from_data">
26646         <doc xml:whitespace="preserve">Creates a new #GMemoryInputStream with data in memory of a given size.</doc>
26647         <return-value transfer-ownership="full">
26648           <doc xml:whitespace="preserve">new #GInputStream read from @data of @len bytes.</doc>
26649           <type name="InputStream" c:type="GInputStream*"/>
26650         </return-value>
26651         <parameters>
26652           <parameter name="data" transfer-ownership="none">
26653             <doc xml:whitespace="preserve">input data</doc>
26654             <type name="gpointer" c:type="void*"/>
26655           </parameter>
26656           <parameter name="len" transfer-ownership="none">
26657             <doc xml:whitespace="preserve">length of the data, may be -1 if @data is a nul-terminated string</doc>
26658             <type name="glong" c:type="gssize"/>
26659           </parameter>
26660           <parameter name="destroy" transfer-ownership="none" scope="async">
26661             <doc xml:whitespace="preserve">function that is called to free @data, or %NULL</doc>
26662             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
26663           </parameter>
26664         </parameters>
26665       </constructor>
26666       <method name="add_data" c:identifier="g_memory_input_stream_add_data">
26667         <doc xml:whitespace="preserve">Appends @data to data that can be read from the input stream</doc>
26668         <return-value transfer-ownership="none">
26669           <type name="none" c:type="void"/>
26670         </return-value>
26671         <parameters>
26672           <parameter name="data" transfer-ownership="none">
26673             <doc xml:whitespace="preserve">input data</doc>
26674             <type name="gpointer" c:type="void*"/>
26675           </parameter>
26676           <parameter name="len" transfer-ownership="none">
26677             <doc xml:whitespace="preserve">length of the data, may be -1 if @data is a nul-terminated string</doc>
26678             <type name="glong" c:type="gssize"/>
26679           </parameter>
26680           <parameter name="destroy" transfer-ownership="none" scope="async">
26681             <doc xml:whitespace="preserve">function that is called to free @data, or %NULL</doc>
26682             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
26683           </parameter>
26684         </parameters>
26685       </method>
26686       <field name="parent_instance">
26687         <type name="InputStream" c:type="GInputStream"/>
26688       </field>
26689       <field name="priv">
26690         <type name="MemoryInputStreamPrivate"
26691               c:type="GMemoryInputStreamPrivate*"/>
26692       </field>
26693     </class>
26694     <record name="MemoryInputStreamClass"
26695             c:type="GMemoryInputStreamClass"
26696             glib:is-gtype-struct-for="MemoryInputStream">
26697       <field name="parent_class">
26698         <type name="InputStreamClass" c:type="GInputStreamClass"/>
26699       </field>
26700       <field name="_g_reserved1" introspectable="0">
26701         <callback name="_g_reserved1">
26702           <return-value transfer-ownership="none">
26703             <type name="none" c:type="void"/>
26704           </return-value>
26705         </callback>
26706       </field>
26707       <field name="_g_reserved2" introspectable="0">
26708         <callback name="_g_reserved2">
26709           <return-value transfer-ownership="none">
26710             <type name="none" c:type="void"/>
26711           </return-value>
26712         </callback>
26713       </field>
26714       <field name="_g_reserved3" introspectable="0">
26715         <callback name="_g_reserved3">
26716           <return-value transfer-ownership="none">
26717             <type name="none" c:type="void"/>
26718           </return-value>
26719         </callback>
26720       </field>
26721       <field name="_g_reserved4" introspectable="0">
26722         <callback name="_g_reserved4">
26723           <return-value transfer-ownership="none">
26724             <type name="none" c:type="void"/>
26725           </return-value>
26726         </callback>
26727       </field>
26728       <field name="_g_reserved5" introspectable="0">
26729         <callback name="_g_reserved5">
26730           <return-value transfer-ownership="none">
26731             <type name="none" c:type="void"/>
26732           </return-value>
26733         </callback>
26734       </field>
26735     </record>
26736     <record name="MemoryInputStreamPrivate"
26737             c:type="GMemoryInputStreamPrivate"
26738             disguised="1">
26739     </record>
26740     <class name="MemoryOutputStream"
26741            c:symbol-prefix="memory_output_stream"
26742            c:type="GMemoryOutputStream"
26743            parent="OutputStream"
26744            glib:type-name="GMemoryOutputStream"
26745            glib:get-type="g_memory_output_stream_get_type"
26746            glib:type-struct="MemoryOutputStreamClass">
26747       <doc xml:whitespace="preserve">Implements #GOutputStream for arbitrary memory chunks.</doc>
26748       <implements name="Seekable"/>
26749       <constructor name="new"
26750                    c:identifier="g_memory_output_stream_new"
26751                    introspectable="0">
26752         <doc xml:whitespace="preserve">Creates a new #GMemoryOutputStream.
26753 If @data is non-%NULL, the stream  will use that for its internal storage.
26754 If @realloc_fn is non-%NULL, it will be used for resizing the internal
26755 storage when necessary. To construct a fixed-size output stream,
26756 pass %NULL as @realloc_fn.
26757 |[
26758 /&amp;ast; a stream that can grow &amp;ast;/
26759 stream = g_memory_output_stream_new (NULL, 0, realloc, free);
26760 /&amp;ast; another stream that can grow &amp;ast;/
26761 stream2 = g_memory_output_stream_new (NULL, 0, g_realloc, g_free);
26762 /&amp;ast; a fixed-size stream &amp;ast;/
26763 data = malloc (200);
26764 stream3 = g_memory_output_stream_new (data, 200, NULL, free);
26765 ]|</doc>
26766         <return-value transfer-ownership="full">
26767           <doc xml:whitespace="preserve">A newly created #GMemoryOutputStream object.</doc>
26768           <type name="OutputStream" c:type="GOutputStream*"/>
26769         </return-value>
26770         <parameters>
26771           <parameter name="data" transfer-ownership="none">
26772             <doc xml:whitespace="preserve">pointer to a chunk of memory to use, or %NULL</doc>
26773             <type name="gpointer" c:type="gpointer"/>
26774           </parameter>
26775           <parameter name="size" transfer-ownership="none">
26776             <doc xml:whitespace="preserve">the size of @data</doc>
26777             <type name="gulong" c:type="gsize"/>
26778           </parameter>
26779           <parameter name="realloc_function"
26780                      transfer-ownership="none"
26781                      scope="notified"
26782                      destroy="3">
26783             <doc xml:whitespace="preserve">a function with realloc() semantics (like g_realloc()) to be called when @data needs to be grown, or %NULL</doc>
26784             <type name="ReallocFunc" c:type="GReallocFunc"/>
26785           </parameter>
26786           <parameter name="destroy_function"
26787                      transfer-ownership="none"
26788                      scope="async">
26789             <doc xml:whitespace="preserve">a function to be called on @data when the stream is finalized, or %NULL</doc>
26790             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
26791           </parameter>
26792         </parameters>
26793       </constructor>
26794       <method name="get_data"
26795               c:identifier="g_memory_output_stream_get_data"
26796               introspectable="0">
26797         <doc xml:whitespace="preserve">Gets any loaded data from the @ostream.
26798 Note that the returned pointer may become invalid on the next
26799 write or truncate operation on the stream.</doc>
26800         <return-value>
26801           <doc xml:whitespace="preserve">pointer to the stream's data</doc>
26802           <type name="gpointer" c:type="gpointer"/>
26803         </return-value>
26804       </method>
26805       <method name="get_data_size"
26806               c:identifier="g_memory_output_stream_get_data_size"
26807               version="2.18">
26808         <doc xml:whitespace="preserve">Returns the number of bytes from the start up
26809 to including the last byte written in the stream
26810 that has not been truncated away.</doc>
26811         <return-value transfer-ownership="none">
26812           <doc xml:whitespace="preserve">the number of bytes written to the stream</doc>
26813           <type name="gulong" c:type="gsize"/>
26814         </return-value>
26815       </method>
26816       <method name="get_size" c:identifier="g_memory_output_stream_get_size">
26817         <doc xml:whitespace="preserve">Gets the size of the currently allocated data area (availible from
26818 g_memory_output_stream_get_data()). If the stream isn't
26819 growable (no realloc was passed to g_memory_output_stream_new()) then
26820 this is the maximum size of the stream and further writes
26821 will return %G_IO_ERROR_NO_SPACE.
26822 Note that for growable streams the returned size may become invalid on
26823 the next write or truncate operation on the stream.
26824 If you want the number of bytes currently written to the stream, use
26825 g_memory_output_stream_get_data_size().</doc>
26826         <return-value transfer-ownership="none">
26827           <doc xml:whitespace="preserve">the number of bytes allocated for the data buffer</doc>
26828           <type name="gulong" c:type="gsize"/>
26829         </return-value>
26830       </method>
26831       <method name="steal_data"
26832               c:identifier="g_memory_output_stream_steal_data"
26833               version="2.26">
26834         <doc xml:whitespace="preserve">Gets any loaded data from the @ostream. Ownership of the data
26835 is transferred to the caller; when no longer needed it must be
26836 freed using the free function set in @ostream's
26837 #GMemoryOutputStream:destroy-function property.</doc>
26838         <return-value transfer-ownership="full">
26839           <doc xml:whitespace="preserve">the stream's data</doc>
26840           <type name="gpointer" c:type="gpointer"/>
26841         </return-value>
26842       </method>
26843       <property name="data"
26844                 version="2.24"
26845                 writable="1"
26846                 construct-only="1"
26847                 transfer-ownership="none">
26848         <doc xml:whitespace="preserve">Pointer to buffer where data will be written.</doc>
26849         <type name="gpointer"/>
26850       </property>
26851       <property name="data-size" version="2.24" transfer-ownership="none">
26852         <doc xml:whitespace="preserve">Size of data written to the buffer.</doc>
26853         <type name="gulong"/>
26854       </property>
26855       <property name="destroy-function"
26856                 version="2.24"
26857                 writable="1"
26858                 construct-only="1"
26859                 transfer-ownership="none">
26860         <doc xml:whitespace="preserve">Function called with the buffer as argument when the stream is destroyed.</doc>
26861         <type name="gpointer"/>
26862       </property>
26863       <property name="realloc-function"
26864                 version="2.24"
26865                 writable="1"
26866                 construct-only="1"
26867                 transfer-ownership="none">
26868         <doc xml:whitespace="preserve">Function with realloc semantics called to enlarge the buffer.</doc>
26869         <type name="gpointer"/>
26870       </property>
26871       <property name="size"
26872                 version="2.24"
26873                 writable="1"
26874                 construct-only="1"
26875                 transfer-ownership="none">
26876         <doc xml:whitespace="preserve">Current size of the data buffer.</doc>
26877         <type name="gulong"/>
26878       </property>
26879       <field name="parent_instance">
26880         <type name="OutputStream" c:type="GOutputStream"/>
26881       </field>
26882       <field name="priv">
26883         <type name="MemoryOutputStreamPrivate"
26884               c:type="GMemoryOutputStreamPrivate*"/>
26885       </field>
26886     </class>
26887     <record name="MemoryOutputStreamClass"
26888             c:type="GMemoryOutputStreamClass"
26889             glib:is-gtype-struct-for="MemoryOutputStream">
26890       <field name="parent_class">
26891         <type name="OutputStreamClass" c:type="GOutputStreamClass"/>
26892       </field>
26893       <field name="_g_reserved1" introspectable="0">
26894         <callback name="_g_reserved1">
26895           <return-value transfer-ownership="none">
26896             <type name="none" c:type="void"/>
26897           </return-value>
26898         </callback>
26899       </field>
26900       <field name="_g_reserved2" introspectable="0">
26901         <callback name="_g_reserved2">
26902           <return-value transfer-ownership="none">
26903             <type name="none" c:type="void"/>
26904           </return-value>
26905         </callback>
26906       </field>
26907       <field name="_g_reserved3" introspectable="0">
26908         <callback name="_g_reserved3">
26909           <return-value transfer-ownership="none">
26910             <type name="none" c:type="void"/>
26911           </return-value>
26912         </callback>
26913       </field>
26914       <field name="_g_reserved4" introspectable="0">
26915         <callback name="_g_reserved4">
26916           <return-value transfer-ownership="none">
26917             <type name="none" c:type="void"/>
26918           </return-value>
26919         </callback>
26920       </field>
26921       <field name="_g_reserved5" introspectable="0">
26922         <callback name="_g_reserved5">
26923           <return-value transfer-ownership="none">
26924             <type name="none" c:type="void"/>
26925           </return-value>
26926         </callback>
26927       </field>
26928     </record>
26929     <record name="MemoryOutputStreamPrivate"
26930             c:type="GMemoryOutputStreamPrivate"
26931             disguised="1">
26932     </record>
26933     <interface name="Mount"
26934                c:symbol-prefix="mount"
26935                c:type="GMount"
26936                glib:type-name="GMount"
26937                glib:get-type="g_mount_get_type"
26938                glib:type-struct="MountIface">
26939       <doc xml:whitespace="preserve">A handle to an object implementing the #GMountIface interface.</doc>
26940       <virtual-method name="can_eject" invoker="can_eject">
26941         <doc xml:whitespace="preserve">Checks if @mount can be eject.</doc>
26942         <return-value transfer-ownership="none">
26943           <doc xml:whitespace="preserve">%TRUE if the @mount can be ejected.</doc>
26944           <type name="gboolean" c:type="gboolean"/>
26945         </return-value>
26946       </virtual-method>
26947       <virtual-method name="can_unmount" invoker="can_unmount">
26948         <doc xml:whitespace="preserve">Checks if @mount can be mounted.</doc>
26949         <return-value transfer-ownership="none">
26950           <doc xml:whitespace="preserve">%TRUE if the @mount can be unmounted.</doc>
26951           <type name="gboolean" c:type="gboolean"/>
26952         </return-value>
26953       </virtual-method>
26954       <virtual-method name="eject"
26955                       invoker="eject"
26956                       deprecated="Use g_mount_eject_with_operation() instead."
26957                       deprecated-version="2.22">
26958         <doc xml:whitespace="preserve">Ejects a mount. This is an asynchronous operation, and is
26959 finished by calling g_mount_eject_finish() with the @mount
26960 and #GAsyncResult data returned in the @callback.</doc>
26961         <return-value transfer-ownership="none">
26962           <type name="none" c:type="void"/>
26963         </return-value>
26964         <parameters>
26965           <parameter name="flags" transfer-ownership="none">
26966             <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
26967             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
26968           </parameter>
26969           <parameter name="cancellable"
26970                      transfer-ownership="none"
26971                      allow-none="1">
26972             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
26973             <type name="Cancellable" c:type="GCancellable*"/>
26974           </parameter>
26975           <parameter name="callback"
26976                      transfer-ownership="none"
26977                      scope="async"
26978                      closure="3">
26979             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
26980             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
26981           </parameter>
26982           <parameter name="user_data" transfer-ownership="none" closure="3">
26983             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
26984             <type name="gpointer" c:type="gpointer"/>
26985           </parameter>
26986         </parameters>
26987       </virtual-method>
26988       <virtual-method name="eject_finish"
26989                       invoker="eject_finish"
26990                       deprecated="Use g_mount_eject_with_operation_finish() instead."
26991                       deprecated-version="2.22"
26992                       throws="1">
26993         <doc xml:whitespace="preserve">Finishes ejecting a mount. If any errors occurred during the operation,</doc>
26994         <return-value transfer-ownership="none">
26995           <doc xml:whitespace="preserve">%TRUE if the mount was successfully ejected. %FALSE otherwise.</doc>
26996           <type name="gboolean" c:type="gboolean"/>
26997         </return-value>
26998         <parameters>
26999           <parameter name="result" transfer-ownership="none">
27000             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
27001             <type name="AsyncResult" c:type="GAsyncResult*"/>
27002           </parameter>
27003         </parameters>
27004       </virtual-method>
27005       <virtual-method name="eject_with_operation"
27006                       invoker="eject_with_operation"
27007                       version="2.22">
27008         <doc xml:whitespace="preserve">Ejects a mount. This is an asynchronous operation, and is
27009 finished by calling g_mount_eject_with_operation_finish() with the @mount
27010 and #GAsyncResult data returned in the @callback.</doc>
27011         <return-value transfer-ownership="none">
27012           <type name="none" c:type="void"/>
27013         </return-value>
27014         <parameters>
27015           <parameter name="flags" transfer-ownership="none">
27016             <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
27017             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
27018           </parameter>
27019           <parameter name="mount_operation" transfer-ownership="none">
27020             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
27021             <type name="MountOperation" c:type="GMountOperation*"/>
27022           </parameter>
27023           <parameter name="cancellable"
27024                      transfer-ownership="none"
27025                      allow-none="1">
27026             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
27027             <type name="Cancellable" c:type="GCancellable*"/>
27028           </parameter>
27029           <parameter name="callback"
27030                      transfer-ownership="none"
27031                      scope="async"
27032                      closure="4">
27033             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
27034             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
27035           </parameter>
27036           <parameter name="user_data" transfer-ownership="none" closure="4">
27037             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
27038             <type name="gpointer" c:type="gpointer"/>
27039           </parameter>
27040         </parameters>
27041       </virtual-method>
27042       <virtual-method name="eject_with_operation_finish"
27043                       invoker="eject_with_operation_finish"
27044                       version="2.22"
27045                       throws="1">
27046         <doc xml:whitespace="preserve">Finishes ejecting a mount. If any errors occurred during the operation,</doc>
27047         <return-value transfer-ownership="none">
27048           <doc xml:whitespace="preserve">%TRUE if the mount was successfully ejected. %FALSE otherwise.</doc>
27049           <type name="gboolean" c:type="gboolean"/>
27050         </return-value>
27051         <parameters>
27052           <parameter name="result" transfer-ownership="none">
27053             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
27054             <type name="AsyncResult" c:type="GAsyncResult*"/>
27055           </parameter>
27056         </parameters>
27057       </virtual-method>
27058       <virtual-method name="get_default_location"
27059                       invoker="get_default_location">
27060         <doc xml:whitespace="preserve">Gets the default location of @mount. The default location of the given
27061 the home directory, or the root of the volume).
27062 The returned object should be unreffed with
27063 g_object_unref() when no longer needed.</doc>
27064         <return-value transfer-ownership="full">
27065           <doc xml:whitespace="preserve">a #GFile.</doc>
27066           <type name="File" c:type="GFile*"/>
27067         </return-value>
27068       </virtual-method>
27069       <virtual-method name="get_drive" invoker="get_drive">
27070         <doc xml:whitespace="preserve">Gets the drive for the @mount.
27071 This is a convenience method for getting the #GVolume and then
27072 using that object to get the #GDrive.
27073 The returned object should be unreffed with
27074 g_object_unref() when no longer needed.</doc>
27075         <return-value transfer-ownership="full">
27076           <doc xml:whitespace="preserve">a #GDrive or %NULL if @mount is not associated with a volume or a drive.</doc>
27077           <type name="Drive" c:type="GDrive*"/>
27078         </return-value>
27079       </virtual-method>
27080       <virtual-method name="get_icon" invoker="get_icon">
27081         <doc xml:whitespace="preserve">Gets the icon for @mount.
27082 The returned object should be unreffed with
27083 g_object_unref() when no longer needed.</doc>
27084         <return-value transfer-ownership="full">
27085           <doc xml:whitespace="preserve">a #GIcon.</doc>
27086           <type name="Icon" c:type="GIcon*"/>
27087         </return-value>
27088       </virtual-method>
27089       <virtual-method name="get_name" invoker="get_name">
27090         <doc xml:whitespace="preserve">Gets the name of @mount.
27091 The returned string should be freed with g_free()
27092 when no longer needed.</doc>
27093         <return-value transfer-ownership="full">
27094           <doc xml:whitespace="preserve">the name for the given @mount.</doc>
27095           <type name="utf8" c:type="char*"/>
27096         </return-value>
27097       </virtual-method>
27098       <virtual-method name="get_root" invoker="get_root">
27099         <doc xml:whitespace="preserve">Gets the root directory on @mount.
27100 The returned object should be unreffed with
27101 g_object_unref() when no longer needed.</doc>
27102         <return-value transfer-ownership="full">
27103           <doc xml:whitespace="preserve">a #GFile.</doc>
27104           <type name="File" c:type="GFile*"/>
27105         </return-value>
27106       </virtual-method>
27107       <virtual-method name="get_uuid" invoker="get_uuid">
27108         <doc xml:whitespace="preserve">Gets the UUID for the @mount. The reference is typically based on
27109 the file system UUID for the mount in question and should be
27110 considered an opaque string. Returns %NULL if there is no UUID
27111 available.
27112 The returned string should be freed with g_free()
27113 when no longer needed.</doc>
27114         <return-value transfer-ownership="full">
27115           <doc xml:whitespace="preserve">the UUID for @mount or %NULL if no UUID can be computed.</doc>
27116           <type name="utf8" c:type="char*"/>
27117         </return-value>
27118       </virtual-method>
27119       <virtual-method name="get_volume" invoker="get_volume">
27120         <doc xml:whitespace="preserve">Gets the volume for the @mount.
27121 The returned object should be unreffed with
27122 g_object_unref() when no longer needed.</doc>
27123         <return-value transfer-ownership="full">
27124           <doc xml:whitespace="preserve">a #GVolume or %NULL if @mount is not associated with a volume.</doc>
27125           <type name="Volume" c:type="GVolume*"/>
27126         </return-value>
27127       </virtual-method>
27128       <virtual-method name="guess_content_type"
27129                       invoker="guess_content_type"
27130                       version="2.18">
27131         <doc xml:whitespace="preserve">Tries to guess the type of content stored on @mount. Returns one or
27132 more textual identifiers of well-known content types (typically
27133 prefixed with "x-content/"), e.g. x-content/image-dcf for camera
27134 memory cards. See the &lt;ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec"&gt;shared-mime-info&lt;/ulink&gt;
27135 specification for more on x-content types.
27136 This is an asynchronous operation (see
27137 g_mount_guess_content_type_sync() for the synchronous version), and
27138 is finished by calling g_mount_guess_content_type_finish() with the</doc>
27139         <return-value transfer-ownership="none">
27140           <type name="none" c:type="void"/>
27141         </return-value>
27142         <parameters>
27143           <parameter name="force_rescan" transfer-ownership="none">
27144             <doc xml:whitespace="preserve">Whether to force a rescan of the content. Otherwise a cached result will be used if available</doc>
27145             <type name="gboolean" c:type="gboolean"/>
27146           </parameter>
27147           <parameter name="cancellable"
27148                      transfer-ownership="none"
27149                      allow-none="1">
27150             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
27151             <type name="Cancellable" c:type="GCancellable*"/>
27152           </parameter>
27153           <parameter name="callback"
27154                      transfer-ownership="none"
27155                      scope="async"
27156                      closure="3">
27157             <doc xml:whitespace="preserve">a #GAsyncReadyCallback</doc>
27158             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
27159           </parameter>
27160           <parameter name="user_data" transfer-ownership="none" closure="3">
27161             <doc xml:whitespace="preserve">user data passed to @callback</doc>
27162             <type name="gpointer" c:type="gpointer"/>
27163           </parameter>
27164         </parameters>
27165       </virtual-method>
27166       <virtual-method name="guess_content_type_finish"
27167                       invoker="guess_content_type_finish"
27168                       version="2.18"
27169                       throws="1">
27170         <doc xml:whitespace="preserve">Finishes guessing content types of @mount. If any errors occured
27171 during the operation, @error will be set to contain the errors and
27172 %FALSE will be returned. In particular, you may get an
27173 %G_IO_ERROR_NOT_SUPPORTED if the mount does not support content
27174 guessing.
27175 Caller should free this array with g_strfreev() when done with it.</doc>
27176         <return-value transfer-ownership="full">
27177           <doc xml:whitespace="preserve">a %NULL-terminated array of content types or %NULL on error.</doc>
27178           <array c:type="gchar**">
27179             <type name="utf8"/>
27180           </array>
27181         </return-value>
27182         <parameters>
27183           <parameter name="result" transfer-ownership="none">
27184             <doc xml:whitespace="preserve">a #GAsyncResult</doc>
27185             <type name="AsyncResult" c:type="GAsyncResult*"/>
27186           </parameter>
27187         </parameters>
27188       </virtual-method>
27189       <virtual-method name="guess_content_type_sync"
27190                       invoker="guess_content_type_sync"
27191                       version="2.18"
27192                       throws="1">
27193         <doc xml:whitespace="preserve">Tries to guess the type of content stored on @mount. Returns one or
27194 more textual identifiers of well-known content types (typically
27195 prefixed with "x-content/"), e.g. x-content/image-dcf for camera
27196 memory cards. See the &lt;ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec"&gt;shared-mime-info&lt;/ulink&gt;
27197 specification for more on x-content types.
27198 This is an synchronous operation and as such may block doing IO;
27199 see g_mount_guess_content_type() for the asynchronous version.
27200 Caller should free this array with g_strfreev() when done with it.</doc>
27201         <return-value transfer-ownership="full">
27202           <doc xml:whitespace="preserve">a %NULL-terminated array of content types or %NULL on error.</doc>
27203           <array c:type="gchar**">
27204             <type name="utf8"/>
27205           </array>
27206         </return-value>
27207         <parameters>
27208           <parameter name="force_rescan" transfer-ownership="none">
27209             <doc xml:whitespace="preserve">Whether to force a rescan of the content. Otherwise a cached result will be used if available</doc>
27210             <type name="gboolean" c:type="gboolean"/>
27211           </parameter>
27212           <parameter name="cancellable"
27213                      transfer-ownership="none"
27214                      allow-none="1">
27215             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
27216             <type name="Cancellable" c:type="GCancellable*"/>
27217           </parameter>
27218         </parameters>
27219       </virtual-method>
27220       <virtual-method name="remount" invoker="remount">
27221         <doc xml:whitespace="preserve">Remounts a mount. This is an asynchronous operation, and is
27222 finished by calling g_mount_remount_finish() with the @mount
27223 and #GAsyncResults data returned in the @callback.
27224 Remounting is useful when some setting affecting the operation
27225 of the volume has been changed, as these may need a remount to
27226 take affect. While this is semantically equivalent with unmounting
27227 and then remounting not all backends might need to actually be
27228 unmounted.</doc>
27229         <return-value transfer-ownership="none">
27230           <type name="none" c:type="void"/>
27231         </return-value>
27232         <parameters>
27233           <parameter name="flags" transfer-ownership="none">
27234             <doc xml:whitespace="preserve">flags affecting the operation</doc>
27235             <type name="MountMountFlags" c:type="GMountMountFlags"/>
27236           </parameter>
27237           <parameter name="mount_operation" transfer-ownership="none">
27238             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
27239             <type name="MountOperation" c:type="GMountOperation*"/>
27240           </parameter>
27241           <parameter name="cancellable"
27242                      transfer-ownership="none"
27243                      allow-none="1">
27244             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
27245             <type name="Cancellable" c:type="GCancellable*"/>
27246           </parameter>
27247           <parameter name="callback"
27248                      transfer-ownership="none"
27249                      scope="async"
27250                      closure="4">
27251             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
27252             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
27253           </parameter>
27254           <parameter name="user_data" transfer-ownership="none" closure="4">
27255             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
27256             <type name="gpointer" c:type="gpointer"/>
27257           </parameter>
27258         </parameters>
27259       </virtual-method>
27260       <virtual-method name="remount_finish"
27261                       invoker="remount_finish"
27262                       throws="1">
27263         <doc xml:whitespace="preserve">Finishes remounting a mount. If any errors occurred during the operation,</doc>
27264         <return-value transfer-ownership="none">
27265           <doc xml:whitespace="preserve">%TRUE if the mount was successfully remounted. %FALSE otherwise.</doc>
27266           <type name="gboolean" c:type="gboolean"/>
27267         </return-value>
27268         <parameters>
27269           <parameter name="result" transfer-ownership="none">
27270             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
27271             <type name="AsyncResult" c:type="GAsyncResult*"/>
27272           </parameter>
27273         </parameters>
27274       </virtual-method>
27275       <virtual-method name="unmount"
27276                       invoker="unmount"
27277                       deprecated="Use g_mount_unmount_with_operation() instead."
27278                       deprecated-version="2.22">
27279         <doc xml:whitespace="preserve">Unmounts a mount. This is an asynchronous operation, and is
27280 finished by calling g_mount_unmount_finish() with the @mount
27281 and #GAsyncResult data returned in the @callback.</doc>
27282         <return-value transfer-ownership="none">
27283           <type name="none" c:type="void"/>
27284         </return-value>
27285         <parameters>
27286           <parameter name="flags" transfer-ownership="none">
27287             <doc xml:whitespace="preserve">flags affecting the operation</doc>
27288             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
27289           </parameter>
27290           <parameter name="cancellable"
27291                      transfer-ownership="none"
27292                      allow-none="1">
27293             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
27294             <type name="Cancellable" c:type="GCancellable*"/>
27295           </parameter>
27296           <parameter name="callback"
27297                      transfer-ownership="none"
27298                      scope="async"
27299                      closure="3">
27300             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
27301             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
27302           </parameter>
27303           <parameter name="user_data" transfer-ownership="none" closure="3">
27304             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
27305             <type name="gpointer" c:type="gpointer"/>
27306           </parameter>
27307         </parameters>
27308       </virtual-method>
27309       <virtual-method name="unmount_finish"
27310                       invoker="unmount_finish"
27311                       deprecated="Use g_mount_unmount_with_operation_finish() instead."
27312                       deprecated-version="2.22"
27313                       throws="1">
27314         <doc xml:whitespace="preserve">Finishes unmounting a mount. If any errors occurred during the operation,</doc>
27315         <return-value transfer-ownership="none">
27316           <doc xml:whitespace="preserve">%TRUE if the mount was successfully unmounted. %FALSE otherwise.</doc>
27317           <type name="gboolean" c:type="gboolean"/>
27318         </return-value>
27319         <parameters>
27320           <parameter name="result" transfer-ownership="none">
27321             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
27322             <type name="AsyncResult" c:type="GAsyncResult*"/>
27323           </parameter>
27324         </parameters>
27325       </virtual-method>
27326       <virtual-method name="unmount_with_operation"
27327                       invoker="unmount_with_operation"
27328                       version="2.22">
27329         <doc xml:whitespace="preserve">Unmounts a mount. This is an asynchronous operation, and is
27330 finished by calling g_mount_unmount_with_operation_finish() with the @mount
27331 and #GAsyncResult data returned in the @callback.</doc>
27332         <return-value transfer-ownership="none">
27333           <type name="none" c:type="void"/>
27334         </return-value>
27335         <parameters>
27336           <parameter name="flags" transfer-ownership="none">
27337             <doc xml:whitespace="preserve">flags affecting the operation</doc>
27338             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
27339           </parameter>
27340           <parameter name="mount_operation" transfer-ownership="none">
27341             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
27342             <type name="MountOperation" c:type="GMountOperation*"/>
27343           </parameter>
27344           <parameter name="cancellable"
27345                      transfer-ownership="none"
27346                      allow-none="1">
27347             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
27348             <type name="Cancellable" c:type="GCancellable*"/>
27349           </parameter>
27350           <parameter name="callback"
27351                      transfer-ownership="none"
27352                      scope="async"
27353                      closure="4">
27354             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
27355             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
27356           </parameter>
27357           <parameter name="user_data" transfer-ownership="none" closure="4">
27358             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
27359             <type name="gpointer" c:type="gpointer"/>
27360           </parameter>
27361         </parameters>
27362       </virtual-method>
27363       <virtual-method name="unmount_with_operation_finish"
27364                       invoker="unmount_with_operation_finish"
27365                       version="2.22"
27366                       throws="1">
27367         <doc xml:whitespace="preserve">Finishes unmounting a mount. If any errors occurred during the operation,</doc>
27368         <return-value transfer-ownership="none">
27369           <doc xml:whitespace="preserve">%TRUE if the mount was successfully unmounted. %FALSE otherwise.</doc>
27370           <type name="gboolean" c:type="gboolean"/>
27371         </return-value>
27372         <parameters>
27373           <parameter name="result" transfer-ownership="none">
27374             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
27375             <type name="AsyncResult" c:type="GAsyncResult*"/>
27376           </parameter>
27377         </parameters>
27378       </virtual-method>
27379       <method name="can_eject" c:identifier="g_mount_can_eject">
27380         <doc xml:whitespace="preserve">Checks if @mount can be eject.</doc>
27381         <return-value transfer-ownership="none">
27382           <doc xml:whitespace="preserve">%TRUE if the @mount can be ejected.</doc>
27383           <type name="gboolean" c:type="gboolean"/>
27384         </return-value>
27385       </method>
27386       <method name="can_unmount" c:identifier="g_mount_can_unmount">
27387         <doc xml:whitespace="preserve">Checks if @mount can be mounted.</doc>
27388         <return-value transfer-ownership="none">
27389           <doc xml:whitespace="preserve">%TRUE if the @mount can be unmounted.</doc>
27390           <type name="gboolean" c:type="gboolean"/>
27391         </return-value>
27392       </method>
27393       <method name="eject"
27394               c:identifier="g_mount_eject"
27395               deprecated="Use g_mount_eject_with_operation() instead."
27396               deprecated-version="2.22">
27397         <doc xml:whitespace="preserve">Ejects a mount. This is an asynchronous operation, and is
27398 finished by calling g_mount_eject_finish() with the @mount
27399 and #GAsyncResult data returned in the @callback.</doc>
27400         <return-value transfer-ownership="none">
27401           <type name="none" c:type="void"/>
27402         </return-value>
27403         <parameters>
27404           <parameter name="flags" transfer-ownership="none">
27405             <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
27406             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
27407           </parameter>
27408           <parameter name="cancellable"
27409                      transfer-ownership="none"
27410                      allow-none="1">
27411             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
27412             <type name="Cancellable" c:type="GCancellable*"/>
27413           </parameter>
27414           <parameter name="callback"
27415                      transfer-ownership="none"
27416                      scope="async"
27417                      closure="3">
27418             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
27419             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
27420           </parameter>
27421           <parameter name="user_data" transfer-ownership="none">
27422             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
27423             <type name="gpointer" c:type="gpointer"/>
27424           </parameter>
27425         </parameters>
27426       </method>
27427       <method name="eject_finish"
27428               c:identifier="g_mount_eject_finish"
27429               deprecated="Use g_mount_eject_with_operation_finish() instead."
27430               deprecated-version="2.22"
27431               throws="1">
27432         <doc xml:whitespace="preserve">Finishes ejecting a mount. If any errors occurred during the operation,</doc>
27433         <return-value transfer-ownership="none">
27434           <doc xml:whitespace="preserve">%TRUE if the mount was successfully ejected. %FALSE otherwise.</doc>
27435           <type name="gboolean" c:type="gboolean"/>
27436         </return-value>
27437         <parameters>
27438           <parameter name="result" transfer-ownership="none">
27439             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
27440             <type name="AsyncResult" c:type="GAsyncResult*"/>
27441           </parameter>
27442         </parameters>
27443       </method>
27444       <method name="eject_with_operation"
27445               c:identifier="g_mount_eject_with_operation"
27446               version="2.22">
27447         <doc xml:whitespace="preserve">Ejects a mount. This is an asynchronous operation, and is
27448 finished by calling g_mount_eject_with_operation_finish() with the @mount
27449 and #GAsyncResult data returned in the @callback.</doc>
27450         <return-value transfer-ownership="none">
27451           <type name="none" c:type="void"/>
27452         </return-value>
27453         <parameters>
27454           <parameter name="flags" transfer-ownership="none">
27455             <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
27456             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
27457           </parameter>
27458           <parameter name="mount_operation" transfer-ownership="none">
27459             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
27460             <type name="MountOperation" c:type="GMountOperation*"/>
27461           </parameter>
27462           <parameter name="cancellable"
27463                      transfer-ownership="none"
27464                      allow-none="1">
27465             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
27466             <type name="Cancellable" c:type="GCancellable*"/>
27467           </parameter>
27468           <parameter name="callback"
27469                      transfer-ownership="none"
27470                      scope="async"
27471                      closure="4">
27472             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
27473             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
27474           </parameter>
27475           <parameter name="user_data" transfer-ownership="none">
27476             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
27477             <type name="gpointer" c:type="gpointer"/>
27478           </parameter>
27479         </parameters>
27480       </method>
27481       <method name="eject_with_operation_finish"
27482               c:identifier="g_mount_eject_with_operation_finish"
27483               version="2.22"
27484               throws="1">
27485         <doc xml:whitespace="preserve">Finishes ejecting a mount. If any errors occurred during the operation,</doc>
27486         <return-value transfer-ownership="none">
27487           <doc xml:whitespace="preserve">%TRUE if the mount was successfully ejected. %FALSE otherwise.</doc>
27488           <type name="gboolean" c:type="gboolean"/>
27489         </return-value>
27490         <parameters>
27491           <parameter name="result" transfer-ownership="none">
27492             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
27493             <type name="AsyncResult" c:type="GAsyncResult*"/>
27494           </parameter>
27495         </parameters>
27496       </method>
27497       <method name="get_default_location"
27498               c:identifier="g_mount_get_default_location">
27499         <doc xml:whitespace="preserve">Gets the default location of @mount. The default location of the given
27500 the home directory, or the root of the volume).
27501 The returned object should be unreffed with
27502 g_object_unref() when no longer needed.</doc>
27503         <return-value transfer-ownership="full">
27504           <doc xml:whitespace="preserve">a #GFile.</doc>
27505           <type name="File" c:type="GFile*"/>
27506         </return-value>
27507       </method>
27508       <method name="get_drive" c:identifier="g_mount_get_drive">
27509         <doc xml:whitespace="preserve">Gets the drive for the @mount.
27510 This is a convenience method for getting the #GVolume and then
27511 using that object to get the #GDrive.
27512 The returned object should be unreffed with
27513 g_object_unref() when no longer needed.</doc>
27514         <return-value transfer-ownership="full">
27515           <doc xml:whitespace="preserve">a #GDrive or %NULL if @mount is not associated with a volume or a drive.</doc>
27516           <type name="Drive" c:type="GDrive*"/>
27517         </return-value>
27518       </method>
27519       <method name="get_icon" c:identifier="g_mount_get_icon">
27520         <doc xml:whitespace="preserve">Gets the icon for @mount.
27521 The returned object should be unreffed with
27522 g_object_unref() when no longer needed.</doc>
27523         <return-value transfer-ownership="full">
27524           <doc xml:whitespace="preserve">a #GIcon.</doc>
27525           <type name="Icon" c:type="GIcon*"/>
27526         </return-value>
27527       </method>
27528       <method name="get_name" c:identifier="g_mount_get_name">
27529         <doc xml:whitespace="preserve">Gets the name of @mount.
27530 The returned string should be freed with g_free()
27531 when no longer needed.</doc>
27532         <return-value transfer-ownership="full">
27533           <doc xml:whitespace="preserve">the name for the given @mount.</doc>
27534           <type name="utf8" c:type="char*"/>
27535         </return-value>
27536       </method>
27537       <method name="get_root" c:identifier="g_mount_get_root">
27538         <doc xml:whitespace="preserve">Gets the root directory on @mount.
27539 The returned object should be unreffed with
27540 g_object_unref() when no longer needed.</doc>
27541         <return-value transfer-ownership="full">
27542           <doc xml:whitespace="preserve">a #GFile.</doc>
27543           <type name="File" c:type="GFile*"/>
27544         </return-value>
27545       </method>
27546       <method name="get_uuid" c:identifier="g_mount_get_uuid">
27547         <doc xml:whitespace="preserve">Gets the UUID for the @mount. The reference is typically based on
27548 the file system UUID for the mount in question and should be
27549 considered an opaque string. Returns %NULL if there is no UUID
27550 available.
27551 The returned string should be freed with g_free()
27552 when no longer needed.</doc>
27553         <return-value transfer-ownership="full">
27554           <doc xml:whitespace="preserve">the UUID for @mount or %NULL if no UUID can be computed.</doc>
27555           <type name="utf8" c:type="char*"/>
27556         </return-value>
27557       </method>
27558       <method name="get_volume" c:identifier="g_mount_get_volume">
27559         <doc xml:whitespace="preserve">Gets the volume for the @mount.
27560 The returned object should be unreffed with
27561 g_object_unref() when no longer needed.</doc>
27562         <return-value transfer-ownership="full">
27563           <doc xml:whitespace="preserve">a #GVolume or %NULL if @mount is not associated with a volume.</doc>
27564           <type name="Volume" c:type="GVolume*"/>
27565         </return-value>
27566       </method>
27567       <method name="guess_content_type"
27568               c:identifier="g_mount_guess_content_type"
27569               version="2.18">
27570         <doc xml:whitespace="preserve">Tries to guess the type of content stored on @mount. Returns one or
27571 more textual identifiers of well-known content types (typically
27572 prefixed with "x-content/"), e.g. x-content/image-dcf for camera
27573 memory cards. See the &lt;ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec"&gt;shared-mime-info&lt;/ulink&gt;
27574 specification for more on x-content types.
27575 This is an asynchronous operation (see
27576 g_mount_guess_content_type_sync() for the synchronous version), and
27577 is finished by calling g_mount_guess_content_type_finish() with the</doc>
27578         <return-value transfer-ownership="none">
27579           <type name="none" c:type="void"/>
27580         </return-value>
27581         <parameters>
27582           <parameter name="force_rescan" transfer-ownership="none">
27583             <doc xml:whitespace="preserve">Whether to force a rescan of the content. Otherwise a cached result will be used if available</doc>
27584             <type name="gboolean" c:type="gboolean"/>
27585           </parameter>
27586           <parameter name="cancellable"
27587                      transfer-ownership="none"
27588                      allow-none="1">
27589             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
27590             <type name="Cancellable" c:type="GCancellable*"/>
27591           </parameter>
27592           <parameter name="callback"
27593                      transfer-ownership="none"
27594                      scope="async"
27595                      closure="3">
27596             <doc xml:whitespace="preserve">a #GAsyncReadyCallback</doc>
27597             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
27598           </parameter>
27599           <parameter name="user_data" transfer-ownership="none">
27600             <doc xml:whitespace="preserve">user data passed to @callback</doc>
27601             <type name="gpointer" c:type="gpointer"/>
27602           </parameter>
27603         </parameters>
27604       </method>
27605       <method name="guess_content_type_finish"
27606               c:identifier="g_mount_guess_content_type_finish"
27607               version="2.18"
27608               throws="1">
27609         <doc xml:whitespace="preserve">Finishes guessing content types of @mount. If any errors occured
27610 during the operation, @error will be set to contain the errors and
27611 %FALSE will be returned. In particular, you may get an
27612 %G_IO_ERROR_NOT_SUPPORTED if the mount does not support content
27613 guessing.
27614 Caller should free this array with g_strfreev() when done with it.</doc>
27615         <return-value transfer-ownership="full">
27616           <doc xml:whitespace="preserve">a %NULL-terminated array of content types or %NULL on error.</doc>
27617           <array c:type="gchar**">
27618             <type name="utf8"/>
27619           </array>
27620         </return-value>
27621         <parameters>
27622           <parameter name="result" transfer-ownership="none">
27623             <doc xml:whitespace="preserve">a #GAsyncResult</doc>
27624             <type name="AsyncResult" c:type="GAsyncResult*"/>
27625           </parameter>
27626         </parameters>
27627       </method>
27628       <method name="guess_content_type_sync"
27629               c:identifier="g_mount_guess_content_type_sync"
27630               version="2.18"
27631               throws="1">
27632         <doc xml:whitespace="preserve">Tries to guess the type of content stored on @mount. Returns one or
27633 more textual identifiers of well-known content types (typically
27634 prefixed with "x-content/"), e.g. x-content/image-dcf for camera
27635 memory cards. See the &lt;ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec"&gt;shared-mime-info&lt;/ulink&gt;
27636 specification for more on x-content types.
27637 This is an synchronous operation and as such may block doing IO;
27638 see g_mount_guess_content_type() for the asynchronous version.
27639 Caller should free this array with g_strfreev() when done with it.</doc>
27640         <return-value transfer-ownership="full">
27641           <doc xml:whitespace="preserve">a %NULL-terminated array of content types or %NULL on error.</doc>
27642           <array c:type="gchar**">
27643             <type name="utf8"/>
27644           </array>
27645         </return-value>
27646         <parameters>
27647           <parameter name="force_rescan" transfer-ownership="none">
27648             <doc xml:whitespace="preserve">Whether to force a rescan of the content. Otherwise a cached result will be used if available</doc>
27649             <type name="gboolean" c:type="gboolean"/>
27650           </parameter>
27651           <parameter name="cancellable"
27652                      transfer-ownership="none"
27653                      allow-none="1">
27654             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
27655             <type name="Cancellable" c:type="GCancellable*"/>
27656           </parameter>
27657         </parameters>
27658       </method>
27659       <method name="is_shadowed"
27660               c:identifier="g_mount_is_shadowed"
27661               version="2.20">
27662         <doc xml:whitespace="preserve">Determines if @mount is shadowed. Applications or libraries should
27663 avoid displaying @mount in the user interface if it is shadowed.
27664 A mount is said to be shadowed if there exists one or more user
27665 visible objects (currently #GMount objects) with a root that is
27666 inside the root of @mount.
27667 One application of shadow mounts is when exposing a single file
27668 system that is used to address several logical volumes. In this
27669 situation, a #GVolumeMonitor implementation would create two
27670 #GVolume objects (for example, one for the camera functionality of
27671 the device and one for a SD card reader on the device) with
27672 activation URIs &lt;literal&gt;gphoto2://[usb:001,002]/store1/&lt;/literal&gt;
27673 and &lt;literal&gt;gphoto2://[usb:001,002]/store2/&lt;/literal&gt;. When the
27674 underlying mount (with root
27675 &lt;literal&gt;gphoto2://[usb:001,002]/&lt;/literal&gt;) is mounted, said
27676 #GVolumeMonitor implementation would create two #GMount objects
27677 (each with their root matching the corresponding volume activation
27678 root) that would shadow the original mount.
27679 The proxy monitor in GVfs 2.26 and later, automatically creates and
27680 manage shadow mounts (and shadows the underlying mount) if the
27681 activation root on a #GVolume is set.</doc>
27682         <return-value transfer-ownership="none">
27683           <doc xml:whitespace="preserve">%TRUE if @mount is shadowed.</doc>
27684           <type name="gboolean" c:type="gboolean"/>
27685         </return-value>
27686       </method>
27687       <method name="remount" c:identifier="g_mount_remount">
27688         <doc xml:whitespace="preserve">Remounts a mount. This is an asynchronous operation, and is
27689 finished by calling g_mount_remount_finish() with the @mount
27690 and #GAsyncResults data returned in the @callback.
27691 Remounting is useful when some setting affecting the operation
27692 of the volume has been changed, as these may need a remount to
27693 take affect. While this is semantically equivalent with unmounting
27694 and then remounting not all backends might need to actually be
27695 unmounted.</doc>
27696         <return-value transfer-ownership="none">
27697           <type name="none" c:type="void"/>
27698         </return-value>
27699         <parameters>
27700           <parameter name="flags" transfer-ownership="none">
27701             <doc xml:whitespace="preserve">flags affecting the operation</doc>
27702             <type name="MountMountFlags" c:type="GMountMountFlags"/>
27703           </parameter>
27704           <parameter name="mount_operation" transfer-ownership="none">
27705             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
27706             <type name="MountOperation" c:type="GMountOperation*"/>
27707           </parameter>
27708           <parameter name="cancellable"
27709                      transfer-ownership="none"
27710                      allow-none="1">
27711             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
27712             <type name="Cancellable" c:type="GCancellable*"/>
27713           </parameter>
27714           <parameter name="callback"
27715                      transfer-ownership="none"
27716                      scope="async"
27717                      closure="4">
27718             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
27719             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
27720           </parameter>
27721           <parameter name="user_data" transfer-ownership="none">
27722             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
27723             <type name="gpointer" c:type="gpointer"/>
27724           </parameter>
27725         </parameters>
27726       </method>
27727       <method name="remount_finish"
27728               c:identifier="g_mount_remount_finish"
27729               throws="1">
27730         <doc xml:whitespace="preserve">Finishes remounting a mount. If any errors occurred during the operation,</doc>
27731         <return-value transfer-ownership="none">
27732           <doc xml:whitespace="preserve">%TRUE if the mount was successfully remounted. %FALSE otherwise.</doc>
27733           <type name="gboolean" c:type="gboolean"/>
27734         </return-value>
27735         <parameters>
27736           <parameter name="result" transfer-ownership="none">
27737             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
27738             <type name="AsyncResult" c:type="GAsyncResult*"/>
27739           </parameter>
27740         </parameters>
27741       </method>
27742       <method name="shadow" c:identifier="g_mount_shadow" version="2.20">
27743         <doc xml:whitespace="preserve">Increments the shadow count on @mount. Usually used by
27744 #GVolumeMonitor implementations when creating a shadow mount for
27745 will need to emit the #GMount::changed signal on @mount manually.</doc>
27746         <return-value transfer-ownership="none">
27747           <type name="none" c:type="void"/>
27748         </return-value>
27749       </method>
27750       <method name="unmount"
27751               c:identifier="g_mount_unmount"
27752               deprecated="Use g_mount_unmount_with_operation() instead."
27753               deprecated-version="2.22">
27754         <doc xml:whitespace="preserve">Unmounts a mount. This is an asynchronous operation, and is
27755 finished by calling g_mount_unmount_finish() with the @mount
27756 and #GAsyncResult data returned in the @callback.</doc>
27757         <return-value transfer-ownership="none">
27758           <type name="none" c:type="void"/>
27759         </return-value>
27760         <parameters>
27761           <parameter name="flags" transfer-ownership="none">
27762             <doc xml:whitespace="preserve">flags affecting the operation</doc>
27763             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
27764           </parameter>
27765           <parameter name="cancellable"
27766                      transfer-ownership="none"
27767                      allow-none="1">
27768             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
27769             <type name="Cancellable" c:type="GCancellable*"/>
27770           </parameter>
27771           <parameter name="callback"
27772                      transfer-ownership="none"
27773                      scope="async"
27774                      closure="3">
27775             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
27776             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
27777           </parameter>
27778           <parameter name="user_data" transfer-ownership="none">
27779             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
27780             <type name="gpointer" c:type="gpointer"/>
27781           </parameter>
27782         </parameters>
27783       </method>
27784       <method name="unmount_finish"
27785               c:identifier="g_mount_unmount_finish"
27786               deprecated="Use g_mount_unmount_with_operation_finish() instead."
27787               deprecated-version="2.22"
27788               throws="1">
27789         <doc xml:whitespace="preserve">Finishes unmounting a mount. If any errors occurred during the operation,</doc>
27790         <return-value transfer-ownership="none">
27791           <doc xml:whitespace="preserve">%TRUE if the mount was successfully unmounted. %FALSE otherwise.</doc>
27792           <type name="gboolean" c:type="gboolean"/>
27793         </return-value>
27794         <parameters>
27795           <parameter name="result" transfer-ownership="none">
27796             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
27797             <type name="AsyncResult" c:type="GAsyncResult*"/>
27798           </parameter>
27799         </parameters>
27800       </method>
27801       <method name="unmount_with_operation"
27802               c:identifier="g_mount_unmount_with_operation"
27803               version="2.22">
27804         <doc xml:whitespace="preserve">Unmounts a mount. This is an asynchronous operation, and is
27805 finished by calling g_mount_unmount_with_operation_finish() with the @mount
27806 and #GAsyncResult data returned in the @callback.</doc>
27807         <return-value transfer-ownership="none">
27808           <type name="none" c:type="void"/>
27809         </return-value>
27810         <parameters>
27811           <parameter name="flags" transfer-ownership="none">
27812             <doc xml:whitespace="preserve">flags affecting the operation</doc>
27813             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
27814           </parameter>
27815           <parameter name="mount_operation" transfer-ownership="none">
27816             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
27817             <type name="MountOperation" c:type="GMountOperation*"/>
27818           </parameter>
27819           <parameter name="cancellable"
27820                      transfer-ownership="none"
27821                      allow-none="1">
27822             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
27823             <type name="Cancellable" c:type="GCancellable*"/>
27824           </parameter>
27825           <parameter name="callback"
27826                      transfer-ownership="none"
27827                      scope="async"
27828                      closure="4">
27829             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
27830             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
27831           </parameter>
27832           <parameter name="user_data" transfer-ownership="none">
27833             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
27834             <type name="gpointer" c:type="gpointer"/>
27835           </parameter>
27836         </parameters>
27837       </method>
27838       <method name="unmount_with_operation_finish"
27839               c:identifier="g_mount_unmount_with_operation_finish"
27840               version="2.22"
27841               throws="1">
27842         <doc xml:whitespace="preserve">Finishes unmounting a mount. If any errors occurred during the operation,</doc>
27843         <return-value transfer-ownership="none">
27844           <doc xml:whitespace="preserve">%TRUE if the mount was successfully unmounted. %FALSE otherwise.</doc>
27845           <type name="gboolean" c:type="gboolean"/>
27846         </return-value>
27847         <parameters>
27848           <parameter name="result" transfer-ownership="none">
27849             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
27850             <type name="AsyncResult" c:type="GAsyncResult*"/>
27851           </parameter>
27852         </parameters>
27853       </method>
27854       <method name="unshadow" c:identifier="g_mount_unshadow" version="2.20">
27855         <doc xml:whitespace="preserve">Decrements the shadow count on @mount. Usually used by
27856 #GVolumeMonitor implementations when destroying a shadow mount for
27857 will need to emit the #GMount::changed signal on @mount manually.</doc>
27858         <return-value transfer-ownership="none">
27859           <type name="none" c:type="void"/>
27860         </return-value>
27861       </method>
27862       <glib:signal name="changed">
27863         <doc xml:whitespace="preserve">Emitted when the mount has been changed.</doc>
27864         <return-value transfer-ownership="none">
27865           <type name="none"/>
27866         </return-value>
27867       </glib:signal>
27868       <glib:signal name="pre-unmount" version="2.22">
27869         <doc xml:whitespace="preserve">This signal is emitted when the #GMount is about to be
27870 unmounted.</doc>
27871         <return-value transfer-ownership="none">
27872           <type name="none"/>
27873         </return-value>
27874       </glib:signal>
27875       <glib:signal name="unmounted">
27876         <doc xml:whitespace="preserve">This signal is emitted when the #GMount have been
27877 unmounted. If the recipient is holding references to the
27878 object they should release them so the object can be
27879 finalized.</doc>
27880         <return-value transfer-ownership="none">
27881           <type name="none"/>
27882         </return-value>
27883       </glib:signal>
27884     </interface>
27885     <record name="MountIface"
27886             c:type="GMountIface"
27887             glib:is-gtype-struct-for="Mount">
27888       <doc xml:whitespace="preserve">Interface for implementing operations for mounts.</doc>
27889       <field name="g_iface">
27890         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
27891       </field>
27892       <field name="changed">
27893         <callback name="changed">
27894           <return-value transfer-ownership="none">
27895             <type name="none" c:type="void"/>
27896           </return-value>
27897           <parameters>
27898             <parameter name="mount" transfer-ownership="none">
27899               <type name="Mount" c:type="GMount*"/>
27900             </parameter>
27901           </parameters>
27902         </callback>
27903       </field>
27904       <field name="unmounted">
27905         <callback name="unmounted">
27906           <return-value transfer-ownership="none">
27907             <type name="none" c:type="void"/>
27908           </return-value>
27909           <parameters>
27910             <parameter name="mount" transfer-ownership="none">
27911               <type name="Mount" c:type="GMount*"/>
27912             </parameter>
27913           </parameters>
27914         </callback>
27915       </field>
27916       <field name="get_root">
27917         <callback name="get_root">
27918           <return-value transfer-ownership="full">
27919             <doc xml:whitespace="preserve">a #GFile.</doc>
27920             <type name="File" c:type="GFile*"/>
27921           </return-value>
27922           <parameters>
27923             <parameter name="mount" transfer-ownership="none">
27924               <type name="Mount" c:type="GMount*"/>
27925             </parameter>
27926           </parameters>
27927         </callback>
27928       </field>
27929       <field name="get_name">
27930         <callback name="get_name">
27931           <return-value transfer-ownership="full">
27932             <doc xml:whitespace="preserve">the name for the given @mount.</doc>
27933             <type name="utf8" c:type="char*"/>
27934           </return-value>
27935           <parameters>
27936             <parameter name="mount" transfer-ownership="none">
27937               <type name="Mount" c:type="GMount*"/>
27938             </parameter>
27939           </parameters>
27940         </callback>
27941       </field>
27942       <field name="get_icon">
27943         <callback name="get_icon">
27944           <return-value transfer-ownership="full">
27945             <doc xml:whitespace="preserve">a #GIcon.</doc>
27946             <type name="Icon" c:type="GIcon*"/>
27947           </return-value>
27948           <parameters>
27949             <parameter name="mount" transfer-ownership="none">
27950               <type name="Mount" c:type="GMount*"/>
27951             </parameter>
27952           </parameters>
27953         </callback>
27954       </field>
27955       <field name="get_uuid">
27956         <callback name="get_uuid">
27957           <return-value transfer-ownership="full">
27958             <doc xml:whitespace="preserve">the UUID for @mount or %NULL if no UUID can be computed.</doc>
27959             <type name="utf8" c:type="char*"/>
27960           </return-value>
27961           <parameters>
27962             <parameter name="mount" transfer-ownership="none">
27963               <type name="Mount" c:type="GMount*"/>
27964             </parameter>
27965           </parameters>
27966         </callback>
27967       </field>
27968       <field name="get_volume">
27969         <callback name="get_volume">
27970           <return-value transfer-ownership="full">
27971             <doc xml:whitespace="preserve">a #GVolume or %NULL if @mount is not associated with a volume.</doc>
27972             <type name="Volume" c:type="GVolume*"/>
27973           </return-value>
27974           <parameters>
27975             <parameter name="mount" transfer-ownership="none">
27976               <type name="Mount" c:type="GMount*"/>
27977             </parameter>
27978           </parameters>
27979         </callback>
27980       </field>
27981       <field name="get_drive">
27982         <callback name="get_drive">
27983           <return-value transfer-ownership="full">
27984             <doc xml:whitespace="preserve">a #GDrive or %NULL if @mount is not associated with a volume or a drive.</doc>
27985             <type name="Drive" c:type="GDrive*"/>
27986           </return-value>
27987           <parameters>
27988             <parameter name="mount" transfer-ownership="none">
27989               <type name="Mount" c:type="GMount*"/>
27990             </parameter>
27991           </parameters>
27992         </callback>
27993       </field>
27994       <field name="can_unmount">
27995         <callback name="can_unmount">
27996           <return-value transfer-ownership="none">
27997             <doc xml:whitespace="preserve">%TRUE if the @mount can be unmounted.</doc>
27998             <type name="gboolean" c:type="gboolean"/>
27999           </return-value>
28000           <parameters>
28001             <parameter name="mount" transfer-ownership="none">
28002               <type name="Mount" c:type="GMount*"/>
28003             </parameter>
28004           </parameters>
28005         </callback>
28006       </field>
28007       <field name="can_eject">
28008         <callback name="can_eject">
28009           <return-value transfer-ownership="none">
28010             <doc xml:whitespace="preserve">%TRUE if the @mount can be ejected.</doc>
28011             <type name="gboolean" c:type="gboolean"/>
28012           </return-value>
28013           <parameters>
28014             <parameter name="mount" transfer-ownership="none">
28015               <type name="Mount" c:type="GMount*"/>
28016             </parameter>
28017           </parameters>
28018         </callback>
28019       </field>
28020       <field name="unmount">
28021         <callback name="unmount">
28022           <return-value transfer-ownership="none">
28023             <type name="none" c:type="void"/>
28024           </return-value>
28025           <parameters>
28026             <parameter name="mount" transfer-ownership="none">
28027               <type name="Mount" c:type="GMount*"/>
28028             </parameter>
28029             <parameter name="flags" transfer-ownership="none">
28030               <doc xml:whitespace="preserve">flags affecting the operation</doc>
28031               <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
28032             </parameter>
28033             <parameter name="cancellable"
28034                        transfer-ownership="none"
28035                        allow-none="1">
28036               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
28037               <type name="Cancellable" c:type="GCancellable*"/>
28038             </parameter>
28039             <parameter name="callback"
28040                        transfer-ownership="none"
28041                        scope="async"
28042                        closure="4">
28043               <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
28044               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
28045             </parameter>
28046             <parameter name="user_data" transfer-ownership="none" closure="4">
28047               <doc xml:whitespace="preserve">user data passed to @callback.</doc>
28048               <type name="gpointer" c:type="gpointer"/>
28049             </parameter>
28050           </parameters>
28051         </callback>
28052       </field>
28053       <field name="unmount_finish">
28054         <callback name="unmount_finish" throws="1">
28055           <return-value transfer-ownership="none">
28056             <doc xml:whitespace="preserve">%TRUE if the mount was successfully unmounted. %FALSE otherwise.</doc>
28057             <type name="gboolean" c:type="gboolean"/>
28058           </return-value>
28059           <parameters>
28060             <parameter name="mount" transfer-ownership="none">
28061               <type name="Mount" c:type="GMount*"/>
28062             </parameter>
28063             <parameter name="result" transfer-ownership="none">
28064               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
28065               <type name="AsyncResult" c:type="GAsyncResult*"/>
28066             </parameter>
28067           </parameters>
28068         </callback>
28069       </field>
28070       <field name="eject">
28071         <callback name="eject">
28072           <return-value transfer-ownership="none">
28073             <type name="none" c:type="void"/>
28074           </return-value>
28075           <parameters>
28076             <parameter name="mount" transfer-ownership="none">
28077               <type name="Mount" c:type="GMount*"/>
28078             </parameter>
28079             <parameter name="flags" transfer-ownership="none">
28080               <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
28081               <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
28082             </parameter>
28083             <parameter name="cancellable"
28084                        transfer-ownership="none"
28085                        allow-none="1">
28086               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
28087               <type name="Cancellable" c:type="GCancellable*"/>
28088             </parameter>
28089             <parameter name="callback"
28090                        transfer-ownership="none"
28091                        scope="async"
28092                        closure="4">
28093               <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
28094               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
28095             </parameter>
28096             <parameter name="user_data" transfer-ownership="none" closure="4">
28097               <doc xml:whitespace="preserve">user data passed to @callback.</doc>
28098               <type name="gpointer" c:type="gpointer"/>
28099             </parameter>
28100           </parameters>
28101         </callback>
28102       </field>
28103       <field name="eject_finish">
28104         <callback name="eject_finish" throws="1">
28105           <return-value transfer-ownership="none">
28106             <doc xml:whitespace="preserve">%TRUE if the mount was successfully ejected. %FALSE otherwise.</doc>
28107             <type name="gboolean" c:type="gboolean"/>
28108           </return-value>
28109           <parameters>
28110             <parameter name="mount" transfer-ownership="none">
28111               <type name="Mount" c:type="GMount*"/>
28112             </parameter>
28113             <parameter name="result" transfer-ownership="none">
28114               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
28115               <type name="AsyncResult" c:type="GAsyncResult*"/>
28116             </parameter>
28117           </parameters>
28118         </callback>
28119       </field>
28120       <field name="remount">
28121         <callback name="remount">
28122           <return-value transfer-ownership="none">
28123             <type name="none" c:type="void"/>
28124           </return-value>
28125           <parameters>
28126             <parameter name="mount" transfer-ownership="none">
28127               <type name="Mount" c:type="GMount*"/>
28128             </parameter>
28129             <parameter name="flags" transfer-ownership="none">
28130               <doc xml:whitespace="preserve">flags affecting the operation</doc>
28131               <type name="MountMountFlags" c:type="GMountMountFlags"/>
28132             </parameter>
28133             <parameter name="mount_operation" transfer-ownership="none">
28134               <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
28135               <type name="MountOperation" c:type="GMountOperation*"/>
28136             </parameter>
28137             <parameter name="cancellable"
28138                        transfer-ownership="none"
28139                        allow-none="1">
28140               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
28141               <type name="Cancellable" c:type="GCancellable*"/>
28142             </parameter>
28143             <parameter name="callback"
28144                        transfer-ownership="none"
28145                        scope="async"
28146                        closure="5">
28147               <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
28148               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
28149             </parameter>
28150             <parameter name="user_data" transfer-ownership="none" closure="5">
28151               <doc xml:whitespace="preserve">user data passed to @callback.</doc>
28152               <type name="gpointer" c:type="gpointer"/>
28153             </parameter>
28154           </parameters>
28155         </callback>
28156       </field>
28157       <field name="remount_finish">
28158         <callback name="remount_finish" throws="1">
28159           <return-value transfer-ownership="none">
28160             <doc xml:whitespace="preserve">%TRUE if the mount was successfully remounted. %FALSE otherwise.</doc>
28161             <type name="gboolean" c:type="gboolean"/>
28162           </return-value>
28163           <parameters>
28164             <parameter name="mount" transfer-ownership="none">
28165               <type name="Mount" c:type="GMount*"/>
28166             </parameter>
28167             <parameter name="result" transfer-ownership="none">
28168               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
28169               <type name="AsyncResult" c:type="GAsyncResult*"/>
28170             </parameter>
28171           </parameters>
28172         </callback>
28173       </field>
28174       <field name="guess_content_type">
28175         <callback name="guess_content_type">
28176           <return-value transfer-ownership="none">
28177             <type name="none" c:type="void"/>
28178           </return-value>
28179           <parameters>
28180             <parameter name="mount" transfer-ownership="none">
28181               <type name="Mount" c:type="GMount*"/>
28182             </parameter>
28183             <parameter name="force_rescan" transfer-ownership="none">
28184               <doc xml:whitespace="preserve">Whether to force a rescan of the content. Otherwise a cached result will be used if available</doc>
28185               <type name="gboolean" c:type="gboolean"/>
28186             </parameter>
28187             <parameter name="cancellable"
28188                        transfer-ownership="none"
28189                        allow-none="1">
28190               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
28191               <type name="Cancellable" c:type="GCancellable*"/>
28192             </parameter>
28193             <parameter name="callback"
28194                        transfer-ownership="none"
28195                        scope="async"
28196                        closure="4">
28197               <doc xml:whitespace="preserve">a #GAsyncReadyCallback</doc>
28198               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
28199             </parameter>
28200             <parameter name="user_data" transfer-ownership="none" closure="4">
28201               <doc xml:whitespace="preserve">user data passed to @callback</doc>
28202               <type name="gpointer" c:type="gpointer"/>
28203             </parameter>
28204           </parameters>
28205         </callback>
28206       </field>
28207       <field name="guess_content_type_finish">
28208         <callback name="guess_content_type_finish" throws="1">
28209           <return-value transfer-ownership="full">
28210             <doc xml:whitespace="preserve">a %NULL-terminated array of content types or %NULL on error.</doc>
28211             <array c:type="gchar**">
28212               <type name="utf8"/>
28213             </array>
28214           </return-value>
28215           <parameters>
28216             <parameter name="mount" transfer-ownership="none">
28217               <type name="Mount" c:type="GMount*"/>
28218             </parameter>
28219             <parameter name="result" transfer-ownership="none">
28220               <doc xml:whitespace="preserve">a #GAsyncResult</doc>
28221               <type name="AsyncResult" c:type="GAsyncResult*"/>
28222             </parameter>
28223           </parameters>
28224         </callback>
28225       </field>
28226       <field name="guess_content_type_sync">
28227         <callback name="guess_content_type_sync" throws="1">
28228           <return-value transfer-ownership="full">
28229             <doc xml:whitespace="preserve">a %NULL-terminated array of content types or %NULL on error.</doc>
28230             <array c:type="gchar**">
28231               <type name="utf8"/>
28232             </array>
28233           </return-value>
28234           <parameters>
28235             <parameter name="mount" transfer-ownership="none">
28236               <type name="Mount" c:type="GMount*"/>
28237             </parameter>
28238             <parameter name="force_rescan" transfer-ownership="none">
28239               <doc xml:whitespace="preserve">Whether to force a rescan of the content. Otherwise a cached result will be used if available</doc>
28240               <type name="gboolean" c:type="gboolean"/>
28241             </parameter>
28242             <parameter name="cancellable"
28243                        transfer-ownership="none"
28244                        allow-none="1">
28245               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
28246               <type name="Cancellable" c:type="GCancellable*"/>
28247             </parameter>
28248           </parameters>
28249         </callback>
28250       </field>
28251       <field name="pre_unmount">
28252         <callback name="pre_unmount">
28253           <return-value transfer-ownership="none">
28254             <type name="none" c:type="void"/>
28255           </return-value>
28256           <parameters>
28257             <parameter name="mount" transfer-ownership="none">
28258               <type name="Mount" c:type="GMount*"/>
28259             </parameter>
28260           </parameters>
28261         </callback>
28262       </field>
28263       <field name="unmount_with_operation">
28264         <callback name="unmount_with_operation">
28265           <return-value transfer-ownership="none">
28266             <type name="none" c:type="void"/>
28267           </return-value>
28268           <parameters>
28269             <parameter name="mount" transfer-ownership="none">
28270               <type name="Mount" c:type="GMount*"/>
28271             </parameter>
28272             <parameter name="flags" transfer-ownership="none">
28273               <doc xml:whitespace="preserve">flags affecting the operation</doc>
28274               <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
28275             </parameter>
28276             <parameter name="mount_operation" transfer-ownership="none">
28277               <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
28278               <type name="MountOperation" c:type="GMountOperation*"/>
28279             </parameter>
28280             <parameter name="cancellable"
28281                        transfer-ownership="none"
28282                        allow-none="1">
28283               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
28284               <type name="Cancellable" c:type="GCancellable*"/>
28285             </parameter>
28286             <parameter name="callback"
28287                        transfer-ownership="none"
28288                        scope="async"
28289                        closure="5">
28290               <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
28291               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
28292             </parameter>
28293             <parameter name="user_data" transfer-ownership="none" closure="5">
28294               <doc xml:whitespace="preserve">user data passed to @callback.</doc>
28295               <type name="gpointer" c:type="gpointer"/>
28296             </parameter>
28297           </parameters>
28298         </callback>
28299       </field>
28300       <field name="unmount_with_operation_finish">
28301         <callback name="unmount_with_operation_finish" throws="1">
28302           <return-value transfer-ownership="none">
28303             <doc xml:whitespace="preserve">%TRUE if the mount was successfully unmounted. %FALSE otherwise.</doc>
28304             <type name="gboolean" c:type="gboolean"/>
28305           </return-value>
28306           <parameters>
28307             <parameter name="mount" transfer-ownership="none">
28308               <type name="Mount" c:type="GMount*"/>
28309             </parameter>
28310             <parameter name="result" transfer-ownership="none">
28311               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
28312               <type name="AsyncResult" c:type="GAsyncResult*"/>
28313             </parameter>
28314           </parameters>
28315         </callback>
28316       </field>
28317       <field name="eject_with_operation">
28318         <callback name="eject_with_operation">
28319           <return-value transfer-ownership="none">
28320             <type name="none" c:type="void"/>
28321           </return-value>
28322           <parameters>
28323             <parameter name="mount" transfer-ownership="none">
28324               <type name="Mount" c:type="GMount*"/>
28325             </parameter>
28326             <parameter name="flags" transfer-ownership="none">
28327               <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
28328               <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
28329             </parameter>
28330             <parameter name="mount_operation" transfer-ownership="none">
28331               <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
28332               <type name="MountOperation" c:type="GMountOperation*"/>
28333             </parameter>
28334             <parameter name="cancellable"
28335                        transfer-ownership="none"
28336                        allow-none="1">
28337               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
28338               <type name="Cancellable" c:type="GCancellable*"/>
28339             </parameter>
28340             <parameter name="callback"
28341                        transfer-ownership="none"
28342                        scope="async"
28343                        closure="5">
28344               <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
28345               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
28346             </parameter>
28347             <parameter name="user_data" transfer-ownership="none" closure="5">
28348               <doc xml:whitespace="preserve">user data passed to @callback.</doc>
28349               <type name="gpointer" c:type="gpointer"/>
28350             </parameter>
28351           </parameters>
28352         </callback>
28353       </field>
28354       <field name="eject_with_operation_finish">
28355         <callback name="eject_with_operation_finish" throws="1">
28356           <return-value transfer-ownership="none">
28357             <doc xml:whitespace="preserve">%TRUE if the mount was successfully ejected. %FALSE otherwise.</doc>
28358             <type name="gboolean" c:type="gboolean"/>
28359           </return-value>
28360           <parameters>
28361             <parameter name="mount" transfer-ownership="none">
28362               <type name="Mount" c:type="GMount*"/>
28363             </parameter>
28364             <parameter name="result" transfer-ownership="none">
28365               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
28366               <type name="AsyncResult" c:type="GAsyncResult*"/>
28367             </parameter>
28368           </parameters>
28369         </callback>
28370       </field>
28371       <field name="get_default_location">
28372         <callback name="get_default_location">
28373           <return-value transfer-ownership="full">
28374             <doc xml:whitespace="preserve">a #GFile.</doc>
28375             <type name="File" c:type="GFile*"/>
28376           </return-value>
28377           <parameters>
28378             <parameter name="mount" transfer-ownership="none">
28379               <type name="Mount" c:type="GMount*"/>
28380             </parameter>
28381           </parameters>
28382         </callback>
28383       </field>
28384     </record>
28385     <enumeration name="MountMountFlags"
28386                  glib:type-name="GMountMountFlags"
28387                  glib:get-type="g_mount_mount_flags_get_type"
28388                  c:type="GMountMountFlags">
28389       <doc xml:whitespace="preserve">Flags used when mounting a mount.</doc>
28390       <member name="none"
28391               value="0"
28392               c:identifier="G_MOUNT_MOUNT_NONE"
28393               glib:nick="none"/>
28394     </enumeration>
28395     <class name="MountOperation"
28396            c:symbol-prefix="mount_operation"
28397            c:type="GMountOperation"
28398            parent="GObject.Object"
28399            glib:type-name="GMountOperation"
28400            glib:get-type="g_mount_operation_get_type"
28401            glib:type-struct="MountOperationClass">
28402       <doc xml:whitespace="preserve">Class for providing authentication methods for mounting operations,
28403 such as mounting a file locally, or authenticating with a server.</doc>
28404       <constructor name="new" c:identifier="g_mount_operation_new">
28405         <doc xml:whitespace="preserve">Creates a new mount operation.</doc>
28406         <return-value transfer-ownership="full">
28407           <doc xml:whitespace="preserve">a #GMountOperation.</doc>
28408           <type name="MountOperation" c:type="GMountOperation*"/>
28409         </return-value>
28410       </constructor>
28411       <method name="get_anonymous"
28412               c:identifier="g_mount_operation_get_anonymous">
28413         <doc xml:whitespace="preserve">Check to see whether the mount operation is being used
28414 for an anonymous user.</doc>
28415         <return-value transfer-ownership="none">
28416           <doc xml:whitespace="preserve">%TRUE if mount operation is anonymous.</doc>
28417           <type name="gboolean" c:type="gboolean"/>
28418         </return-value>
28419       </method>
28420       <method name="get_choice" c:identifier="g_mount_operation_get_choice">
28421         <doc xml:whitespace="preserve">Gets a choice from the mount operation.
28422 the choice's list, or %0.</doc>
28423         <return-value transfer-ownership="none">
28424           <doc xml:whitespace="preserve">an integer containing an index of the user's choice from</doc>
28425           <type name="gint" c:type="int"/>
28426         </return-value>
28427       </method>
28428       <method name="get_domain" c:identifier="g_mount_operation_get_domain">
28429         <doc xml:whitespace="preserve">Gets the domain of the mount operation.</doc>
28430         <return-value transfer-ownership="none">
28431           <doc xml:whitespace="preserve">a string set to the domain.</doc>
28432           <type name="utf8" c:type="char*"/>
28433         </return-value>
28434       </method>
28435       <method name="get_password"
28436               c:identifier="g_mount_operation_get_password">
28437         <doc xml:whitespace="preserve">Gets a password from the mount operation.</doc>
28438         <return-value transfer-ownership="none">
28439           <doc xml:whitespace="preserve">a string containing the password within @op.</doc>
28440           <type name="utf8" c:type="char*"/>
28441         </return-value>
28442       </method>
28443       <method name="get_password_save"
28444               c:identifier="g_mount_operation_get_password_save">
28445         <doc xml:whitespace="preserve">Gets the state of saving passwords for the mount operation.</doc>
28446         <return-value transfer-ownership="none">
28447           <doc xml:whitespace="preserve">a #GPasswordSave flag.</doc>
28448           <type name="PasswordSave" c:type="GPasswordSave"/>
28449         </return-value>
28450       </method>
28451       <method name="get_username"
28452               c:identifier="g_mount_operation_get_username">
28453         <return-value transfer-ownership="none">
28454           <type name="utf8" c:type="char*"/>
28455         </return-value>
28456       </method>
28457       <method name="reply" c:identifier="g_mount_operation_reply">
28458         <doc xml:whitespace="preserve">Emits the #GMountOperation::reply signal.</doc>
28459         <return-value transfer-ownership="none">
28460           <type name="none" c:type="void"/>
28461         </return-value>
28462         <parameters>
28463           <parameter name="result" transfer-ownership="none">
28464             <doc xml:whitespace="preserve">a #GMountOperationResult</doc>
28465             <type name="MountOperationResult" c:type="GMountOperationResult"/>
28466           </parameter>
28467         </parameters>
28468       </method>
28469       <method name="set_anonymous"
28470               c:identifier="g_mount_operation_set_anonymous">
28471         <doc xml:whitespace="preserve">Sets the mount operation to use an anonymous user if @anonymous is %TRUE.</doc>
28472         <return-value transfer-ownership="none">
28473           <type name="none" c:type="void"/>
28474         </return-value>
28475         <parameters>
28476           <parameter name="anonymous" transfer-ownership="none">
28477             <doc xml:whitespace="preserve">boolean value.</doc>
28478             <type name="gboolean" c:type="gboolean"/>
28479           </parameter>
28480         </parameters>
28481       </method>
28482       <method name="set_choice" c:identifier="g_mount_operation_set_choice">
28483         <doc xml:whitespace="preserve">Sets a default choice for the mount operation.</doc>
28484         <return-value transfer-ownership="none">
28485           <type name="none" c:type="void"/>
28486         </return-value>
28487         <parameters>
28488           <parameter name="choice" transfer-ownership="none">
28489             <doc xml:whitespace="preserve">an integer.</doc>
28490             <type name="gint" c:type="int"/>
28491           </parameter>
28492         </parameters>
28493       </method>
28494       <method name="set_domain" c:identifier="g_mount_operation_set_domain">
28495         <doc xml:whitespace="preserve">Sets the mount operation's domain.</doc>
28496         <return-value transfer-ownership="none">
28497           <type name="none" c:type="void"/>
28498         </return-value>
28499         <parameters>
28500           <parameter name="domain" transfer-ownership="none">
28501             <doc xml:whitespace="preserve">the domain to set.</doc>
28502             <type name="utf8" c:type="char*"/>
28503           </parameter>
28504         </parameters>
28505       </method>
28506       <method name="set_password"
28507               c:identifier="g_mount_operation_set_password">
28508         <doc xml:whitespace="preserve">Sets the mount operation's password to @password.</doc>
28509         <return-value transfer-ownership="none">
28510           <type name="none" c:type="void"/>
28511         </return-value>
28512         <parameters>
28513           <parameter name="password" transfer-ownership="none">
28514             <doc xml:whitespace="preserve">password to set.</doc>
28515             <type name="utf8" c:type="char*"/>
28516           </parameter>
28517         </parameters>
28518       </method>
28519       <method name="set_password_save"
28520               c:identifier="g_mount_operation_set_password_save">
28521         <doc xml:whitespace="preserve">Sets the state of saving passwords for the mount operation.</doc>
28522         <return-value transfer-ownership="none">
28523           <type name="none" c:type="void"/>
28524         </return-value>
28525         <parameters>
28526           <parameter name="save" transfer-ownership="none">
28527             <doc xml:whitespace="preserve">a set of #GPasswordSave flags.</doc>
28528             <type name="PasswordSave" c:type="GPasswordSave"/>
28529           </parameter>
28530         </parameters>
28531       </method>
28532       <method name="set_username"
28533               c:identifier="g_mount_operation_set_username">
28534         <doc xml:whitespace="preserve">Sets the user name within @op to @username.</doc>
28535         <return-value transfer-ownership="none">
28536           <type name="none" c:type="void"/>
28537         </return-value>
28538         <parameters>
28539           <parameter name="username" transfer-ownership="none">
28540             <doc xml:whitespace="preserve">input username.</doc>
28541             <type name="utf8" c:type="char*"/>
28542           </parameter>
28543         </parameters>
28544       </method>
28545       <property name="anonymous" writable="1" transfer-ownership="none">
28546         <doc xml:whitespace="preserve">Whether to use an anonymous user when authenticating.</doc>
28547         <type name="gboolean"/>
28548       </property>
28549       <property name="choice" writable="1" transfer-ownership="none">
28550         <doc xml:whitespace="preserve">The index of the user's choice when a question is asked during the
28551 mount operation. See the #GMountOperation::ask-question signal.</doc>
28552         <type name="gint"/>
28553       </property>
28554       <property name="domain" writable="1" transfer-ownership="none">
28555         <doc xml:whitespace="preserve">The domain to use for the mount operation.</doc>
28556         <type name="utf8"/>
28557       </property>
28558       <property name="password" writable="1" transfer-ownership="none">
28559         <doc xml:whitespace="preserve">The password that is used for authentication when carrying out
28560 the mount operation.</doc>
28561         <type name="utf8"/>
28562       </property>
28563       <property name="password-save" writable="1" transfer-ownership="none">
28564         <doc xml:whitespace="preserve">Determines if and how the password information should be saved.</doc>
28565         <type name="PasswordSave"/>
28566       </property>
28567       <property name="username" writable="1" transfer-ownership="none">
28568         <doc xml:whitespace="preserve">The user name that is used for authentication when carrying out
28569 the mount operation.</doc>
28570         <type name="utf8"/>
28571       </property>
28572       <field name="parent_instance">
28573         <type name="GObject.Object" c:type="GObject"/>
28574       </field>
28575       <field name="priv">
28576         <type name="MountOperationPrivate" c:type="GMountOperationPrivate*"/>
28577       </field>
28578       <glib:signal name="aborted" version="2.20">
28579         <doc xml:whitespace="preserve">Emitted by the backend when e.g. a device becomes unavailable
28580 while a mount operation is in progress.
28581 Implementations of GMountOperation should handle this signal
28582 by dismissing open password dialogs.</doc>
28583         <return-value transfer-ownership="none">
28584           <type name="none"/>
28585         </return-value>
28586       </glib:signal>
28587       <glib:signal name="ask-password">
28588         <doc xml:whitespace="preserve">Emitted when a mount operation asks the user for a password.
28589 If the message contains a line break, the first line should be
28590 presented as a heading. For example, it may be used as the
28591 primary text in a #GtkMessageDialog.</doc>
28592         <return-value transfer-ownership="none">
28593           <type name="none"/>
28594         </return-value>
28595         <parameters>
28596           <parameter name="object" transfer-ownership="none">
28597             <doc xml:whitespace="preserve">string containing a message to display to the user.</doc>
28598             <type name="utf8"/>
28599           </parameter>
28600           <parameter name="p0" transfer-ownership="none">
28601             <doc xml:whitespace="preserve">string containing the default user name.</doc>
28602             <type name="utf8"/>
28603           </parameter>
28604           <parameter name="p1" transfer-ownership="none">
28605             <doc xml:whitespace="preserve">string containing the default domain.</doc>
28606             <type name="utf8"/>
28607           </parameter>
28608           <parameter name="p2" transfer-ownership="none">
28609             <doc xml:whitespace="preserve">a set of #GAskPasswordFlags.</doc>
28610             <type name="AskPasswordFlags"/>
28611           </parameter>
28612         </parameters>
28613       </glib:signal>
28614       <glib:signal name="ask-question" introspectable="0">
28615         <doc xml:whitespace="preserve">Emitted when asking the user a question and gives a list of
28616 choices for the user to choose from.
28617 If the message contains a line break, the first line should be
28618 presented as a heading. For example, it may be used as the
28619 primary text in a #GtkMessageDialog.</doc>
28620         <return-value transfer-ownership="none">
28621           <type name="none"/>
28622         </return-value>
28623         <parameters>
28624           <parameter name="object" transfer-ownership="none">
28625             <doc xml:whitespace="preserve">string containing a message to display to the user.</doc>
28626             <type name="utf8"/>
28627           </parameter>
28628           <parameter name="p0" transfer-ownership="none">
28629             <doc xml:whitespace="preserve">an array of strings for each possible choice.</doc>
28630             <type/>
28631           </parameter>
28632         </parameters>
28633       </glib:signal>
28634       <glib:signal name="reply">
28635         <doc xml:whitespace="preserve">Emitted when the user has replied to the mount operation.</doc>
28636         <return-value transfer-ownership="none">
28637           <type name="none"/>
28638         </return-value>
28639         <parameters>
28640           <parameter name="object" transfer-ownership="none">
28641             <doc xml:whitespace="preserve">a #GMountOperationResult indicating how the request was handled</doc>
28642             <type name="MountOperationResult"/>
28643           </parameter>
28644         </parameters>
28645       </glib:signal>
28646       <glib:signal name="show-processes" version="2.22" introspectable="0">
28647         <doc xml:whitespace="preserve">Emitted when one or more processes are blocking an operation
28648 e.g. unmounting/ejecting a #GMount or stopping a #GDrive.
28649 Note that this signal may be emitted several times to update the
28650 list of blocking processes as processes close files. The
28651 application should only respond with g_mount_operation_reply() to
28652 the latest signal (setting #GMountOperation:choice to the choice
28653 the user made).
28654 If the message contains a line break, the first line should be
28655 presented as a heading. For example, it may be used as the
28656 primary text in a #GtkMessageDialog.</doc>
28657         <return-value transfer-ownership="none">
28658           <type name="none"/>
28659         </return-value>
28660         <parameters>
28661           <parameter name="object" transfer-ownership="none">
28662             <doc xml:whitespace="preserve">string containing a message to display to the user.</doc>
28663             <type name="utf8"/>
28664           </parameter>
28665           <parameter name="p0" transfer-ownership="none">
28666             <doc xml:whitespace="preserve">an array of #GPid for processes blocking the operation.</doc>
28667             <array name="GLib.Array">
28668               <type name="gpointer" c:type="gpointer"/>
28669             </array>
28670           </parameter>
28671           <parameter name="p1" transfer-ownership="none">
28672             <doc xml:whitespace="preserve">an array of strings for each possible choice.</doc>
28673             <type/>
28674           </parameter>
28675         </parameters>
28676       </glib:signal>
28677     </class>
28678     <record name="MountOperationClass"
28679             c:type="GMountOperationClass"
28680             glib:is-gtype-struct-for="MountOperation">
28681       <field name="parent_class">
28682         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
28683       </field>
28684       <field name="ask_password">
28685         <callback name="ask_password">
28686           <return-value transfer-ownership="none">
28687             <type name="none" c:type="void"/>
28688           </return-value>
28689           <parameters>
28690             <parameter name="op" transfer-ownership="none">
28691               <type name="MountOperation" c:type="GMountOperation*"/>
28692             </parameter>
28693             <parameter name="message" transfer-ownership="none">
28694               <type name="utf8" c:type="char*"/>
28695             </parameter>
28696             <parameter name="default_user" transfer-ownership="none">
28697               <type name="utf8" c:type="char*"/>
28698             </parameter>
28699             <parameter name="default_domain" transfer-ownership="none">
28700               <type name="utf8" c:type="char*"/>
28701             </parameter>
28702             <parameter name="flags" transfer-ownership="none">
28703               <type name="AskPasswordFlags" c:type="GAskPasswordFlags"/>
28704             </parameter>
28705           </parameters>
28706         </callback>
28707       </field>
28708       <field name="ask_question">
28709         <callback name="ask_question">
28710           <return-value transfer-ownership="none">
28711             <type name="none" c:type="void"/>
28712           </return-value>
28713           <parameters>
28714             <parameter name="op" transfer-ownership="none">
28715               <type name="MountOperation" c:type="GMountOperation*"/>
28716             </parameter>
28717             <parameter name="message" transfer-ownership="none">
28718               <type name="utf8" c:type="char*"/>
28719             </parameter>
28720             <parameter name="choices" transfer-ownership="none">
28721               <type name="utf8" c:type="char*"/>
28722             </parameter>
28723           </parameters>
28724         </callback>
28725       </field>
28726       <field name="reply">
28727         <callback name="reply">
28728           <return-value transfer-ownership="none">
28729             <type name="none" c:type="void"/>
28730           </return-value>
28731           <parameters>
28732             <parameter name="op" transfer-ownership="none">
28733               <type name="MountOperation" c:type="GMountOperation*"/>
28734             </parameter>
28735             <parameter name="result" transfer-ownership="none">
28736               <type name="MountOperationResult"
28737                     c:type="GMountOperationResult"/>
28738             </parameter>
28739           </parameters>
28740         </callback>
28741       </field>
28742       <field name="aborted">
28743         <callback name="aborted">
28744           <return-value transfer-ownership="none">
28745             <type name="none" c:type="void"/>
28746           </return-value>
28747           <parameters>
28748             <parameter name="op" transfer-ownership="none">
28749               <type name="MountOperation" c:type="GMountOperation*"/>
28750             </parameter>
28751           </parameters>
28752         </callback>
28753       </field>
28754       <field name="show_processes">
28755         <callback name="show_processes">
28756           <return-value transfer-ownership="none">
28757             <type name="none" c:type="void"/>
28758           </return-value>
28759           <parameters>
28760             <parameter name="op" transfer-ownership="none">
28761               <type name="MountOperation" c:type="GMountOperation*"/>
28762             </parameter>
28763             <parameter name="message" transfer-ownership="none">
28764               <type name="utf8" c:type="gchar*"/>
28765             </parameter>
28766             <parameter name="processes" transfer-ownership="none">
28767               <array name="GLib.Array" c:type="GArray*">
28768                 <type name="gpointer" c:type="gpointer"/>
28769               </array>
28770             </parameter>
28771             <parameter name="choices" transfer-ownership="none">
28772               <type name="utf8" c:type="gchar*"/>
28773             </parameter>
28774           </parameters>
28775         </callback>
28776       </field>
28777       <field name="_g_reserved1" introspectable="0">
28778         <callback name="_g_reserved1">
28779           <return-value transfer-ownership="none">
28780             <type name="none" c:type="void"/>
28781           </return-value>
28782         </callback>
28783       </field>
28784       <field name="_g_reserved2" introspectable="0">
28785         <callback name="_g_reserved2">
28786           <return-value transfer-ownership="none">
28787             <type name="none" c:type="void"/>
28788           </return-value>
28789         </callback>
28790       </field>
28791       <field name="_g_reserved3" introspectable="0">
28792         <callback name="_g_reserved3">
28793           <return-value transfer-ownership="none">
28794             <type name="none" c:type="void"/>
28795           </return-value>
28796         </callback>
28797       </field>
28798       <field name="_g_reserved4" introspectable="0">
28799         <callback name="_g_reserved4">
28800           <return-value transfer-ownership="none">
28801             <type name="none" c:type="void"/>
28802           </return-value>
28803         </callback>
28804       </field>
28805       <field name="_g_reserved5" introspectable="0">
28806         <callback name="_g_reserved5">
28807           <return-value transfer-ownership="none">
28808             <type name="none" c:type="void"/>
28809           </return-value>
28810         </callback>
28811       </field>
28812       <field name="_g_reserved6" introspectable="0">
28813         <callback name="_g_reserved6">
28814           <return-value transfer-ownership="none">
28815             <type name="none" c:type="void"/>
28816           </return-value>
28817         </callback>
28818       </field>
28819       <field name="_g_reserved7" introspectable="0">
28820         <callback name="_g_reserved7">
28821           <return-value transfer-ownership="none">
28822             <type name="none" c:type="void"/>
28823           </return-value>
28824         </callback>
28825       </field>
28826       <field name="_g_reserved8" introspectable="0">
28827         <callback name="_g_reserved8">
28828           <return-value transfer-ownership="none">
28829             <type name="none" c:type="void"/>
28830           </return-value>
28831         </callback>
28832       </field>
28833       <field name="_g_reserved9" introspectable="0">
28834         <callback name="_g_reserved9">
28835           <return-value transfer-ownership="none">
28836             <type name="none" c:type="void"/>
28837           </return-value>
28838         </callback>
28839       </field>
28840       <field name="_g_reserved10" introspectable="0">
28841         <callback name="_g_reserved10">
28842           <return-value transfer-ownership="none">
28843             <type name="none" c:type="void"/>
28844           </return-value>
28845         </callback>
28846       </field>
28847     </record>
28848     <record name="MountOperationPrivate"
28849             c:type="GMountOperationPrivate"
28850             disguised="1">
28851     </record>
28852     <enumeration name="MountOperationResult"
28853                  glib:type-name="GMountOperationResult"
28854                  glib:get-type="g_mount_operation_result_get_type"
28855                  c:type="GMountOperationResult">
28856       <doc xml:whitespace="preserve">#GMountOperationResult is returned as a result when a request for
28857 information is send by the mounting operation.</doc>
28858       <member name="handled"
28859               value="0"
28860               c:identifier="G_MOUNT_OPERATION_HANDLED"
28861               glib:nick="handled"/>
28862       <member name="aborted"
28863               value="1"
28864               c:identifier="G_MOUNT_OPERATION_ABORTED"
28865               glib:nick="aborted"/>
28866       <member name="unhandled"
28867               value="2"
28868               c:identifier="G_MOUNT_OPERATION_UNHANDLED"
28869               glib:nick="unhandled"/>
28870     </enumeration>
28871     <bitfield name="MountUnmountFlags"
28872               glib:type-name="GMountUnmountFlags"
28873               glib:get-type="g_mount_unmount_flags_get_type"
28874               c:type="GMountUnmountFlags">
28875       <doc xml:whitespace="preserve">Flags used when an unmounting a mount.</doc>
28876       <member name="none"
28877               value="0"
28878               c:identifier="G_MOUNT_UNMOUNT_NONE"
28879               glib:nick="none"/>
28880       <member name="force"
28881               value="1"
28882               c:identifier="G_MOUNT_UNMOUNT_FORCE"
28883               glib:nick="force"/>
28884     </bitfield>
28885     <constant name="NATIVE_VOLUME_MONITOR_EXTENSION_POINT_NAME"
28886               value="gio-native-volume-monitor">
28887       <type name="utf8" c:type="gchar*"/>
28888     </constant>
28889     <class name="NativeVolumeMonitor"
28890            c:symbol-prefix="native_volume_monitor"
28891            c:type="GNativeVolumeMonitor"
28892            parent="VolumeMonitor"
28893            abstract="1"
28894            glib:type-name="GNativeVolumeMonitor"
28895            glib:get-type="g_native_volume_monitor_get_type"
28896            glib:type-struct="NativeVolumeMonitorClass">
28897       <field name="parent_instance">
28898         <type name="VolumeMonitor" c:type="GVolumeMonitor"/>
28899       </field>
28900     </class>
28901     <record name="NativeVolumeMonitorClass"
28902             c:type="GNativeVolumeMonitorClass"
28903             glib:is-gtype-struct-for="NativeVolumeMonitor">
28904       <field name="parent_class">
28905         <type name="VolumeMonitorClass" c:type="GVolumeMonitorClass"/>
28906       </field>
28907       <field name="get_mount_for_mount_path" introspectable="0">
28908         <callback name="get_mount_for_mount_path" introspectable="0">
28909           <return-value>
28910             <type name="Mount" c:type="GMount*"/>
28911           </return-value>
28912           <parameters>
28913             <parameter name="mount_path" transfer-ownership="none">
28914               <type name="utf8" c:type="char*"/>
28915             </parameter>
28916             <parameter name="cancellable" transfer-ownership="none">
28917               <type name="Cancellable" c:type="GCancellable*"/>
28918             </parameter>
28919           </parameters>
28920         </callback>
28921       </field>
28922     </record>
28923     <class name="NetworkAddress"
28924            c:symbol-prefix="network_address"
28925            c:type="GNetworkAddress"
28926            parent="GObject.Object"
28927            glib:type-name="GNetworkAddress"
28928            glib:get-type="g_network_address_get_type"
28929            glib:type-struct="NetworkAddressClass">
28930       <doc xml:whitespace="preserve">A #GSocketConnectable for resolving a hostname and connecting to
28931 that host.</doc>
28932       <implements name="SocketConnectable"/>
28933       <function name="new" c:identifier="g_network_address_new" version="2.22">
28934         <doc xml:whitespace="preserve">Creates a new #GSocketConnectable for connecting to the given</doc>
28935         <return-value transfer-ownership="full">
28936           <doc xml:whitespace="preserve">the new #GNetworkAddress</doc>
28937           <type name="SocketConnectable" c:type="GSocketConnectable*"/>
28938         </return-value>
28939         <parameters>
28940           <parameter name="hostname" transfer-ownership="none">
28941             <doc xml:whitespace="preserve">the hostname</doc>
28942             <type name="utf8" c:type="gchar*"/>
28943           </parameter>
28944           <parameter name="port" transfer-ownership="none">
28945             <doc xml:whitespace="preserve">the port</doc>
28946             <type name="guint16" c:type="guint16"/>
28947           </parameter>
28948         </parameters>
28949       </function>
28950       <function name="parse"
28951                 c:identifier="g_network_address_parse"
28952                 version="2.22"
28953                 throws="1">
28954         <doc xml:whitespace="preserve">Creates a new #GSocketConnectable for connecting to the given
28955 parsing @host_and_port fails.
28956 address, an IPv4 address, or a domain name (in which case a DNS
28957 lookup is performed). Quoting with [] is supported for all address
28958 types. A port override may be specified in the usual way with a
28959 colon. Ports may be given as decimal numbers or symbolic names (in
28960 which case an /etc/services lookup is performed).
28961 If no port is specified in @host_and_port then @default_port will be
28962 used as the port number to connect to.
28963 In general, @host_and_port is expected to be provided by the user
28964 (allowing them to give the hostname, and a port overide if necessary)
28965 and @default_port is expected to be provided by the application.</doc>
28966         <return-value transfer-ownership="full">
28967           <doc xml:whitespace="preserve">the new #GNetworkAddress, or %NULL on error</doc>
28968           <type name="SocketConnectable" c:type="GSocketConnectable*"/>
28969         </return-value>
28970         <parameters>
28971           <parameter name="host_and_port" transfer-ownership="none">
28972             <doc xml:whitespace="preserve">the hostname and optionally a port</doc>
28973             <type name="utf8" c:type="gchar*"/>
28974           </parameter>
28975           <parameter name="default_port" transfer-ownership="none">
28976             <doc xml:whitespace="preserve">the default port if not in @host_and_port</doc>
28977             <type name="guint16" c:type="guint16"/>
28978           </parameter>
28979         </parameters>
28980       </function>
28981       <function name="parse_uri"
28982                 c:identifier="g_network_address_parse_uri"
28983                 version="2.26"
28984                 throws="1">
28985         <doc xml:whitespace="preserve">Creates a new #GSocketConnectable for connecting to the given
28986 Using this rather than g_network_address_new() or
28987 g_network_address_parse_host() allows #GSocketClient to determine
28988 when to use application-specific proxy protocols.</doc>
28989         <return-value transfer-ownership="full">
28990           <doc xml:whitespace="preserve">the new #GNetworkAddress, or %NULL on error</doc>
28991           <type name="SocketConnectable" c:type="GSocketConnectable*"/>
28992         </return-value>
28993         <parameters>
28994           <parameter name="uri" transfer-ownership="none">
28995             <doc xml:whitespace="preserve">the hostname and optionally a port</doc>
28996             <type name="utf8" c:type="gchar*"/>
28997           </parameter>
28998           <parameter name="default_port" transfer-ownership="none">
28999             <doc xml:whitespace="preserve">The default port if none is found in the URI</doc>
29000             <type name="guint16" c:type="guint16"/>
29001           </parameter>
29002         </parameters>
29003       </function>
29004       <method name="get_hostname"
29005               c:identifier="g_network_address_get_hostname"
29006               version="2.22">
29007         <doc xml:whitespace="preserve">Gets @addr's hostname. This might be either UTF-8 or ASCII-encoded,
29008 depending on what @addr was created with.</doc>
29009         <return-value transfer-ownership="none">
29010           <doc xml:whitespace="preserve">@addr's hostname</doc>
29011           <type name="utf8" c:type="gchar*"/>
29012         </return-value>
29013       </method>
29014       <method name="get_port"
29015               c:identifier="g_network_address_get_port"
29016               version="2.22">
29017         <doc xml:whitespace="preserve">Gets @addr's port number</doc>
29018         <return-value transfer-ownership="none">
29019           <doc xml:whitespace="preserve">@addr's port (which may be 0)</doc>
29020           <type name="guint16" c:type="guint16"/>
29021         </return-value>
29022       </method>
29023       <method name="get_scheme"
29024               c:identifier="g_network_address_get_scheme"
29025               version="2.26">
29026         <doc xml:whitespace="preserve">Gets @addr's scheme</doc>
29027         <return-value transfer-ownership="none">
29028           <doc xml:whitespace="preserve">@addr's scheme (%NULL if not built from URI)</doc>
29029           <type name="utf8" c:type="gchar*"/>
29030         </return-value>
29031       </method>
29032       <property name="hostname"
29033                 writable="1"
29034                 construct-only="1"
29035                 transfer-ownership="none">
29036         <type name="utf8"/>
29037       </property>
29038       <property name="port"
29039                 writable="1"
29040                 construct-only="1"
29041                 transfer-ownership="none">
29042         <type name="guint"/>
29043       </property>
29044       <property name="scheme"
29045                 writable="1"
29046                 construct-only="1"
29047                 transfer-ownership="none">
29048         <type name="utf8"/>
29049       </property>
29050       <field name="parent_instance">
29051         <type name="GObject.Object" c:type="GObject"/>
29052       </field>
29053       <field name="priv">
29054         <type name="NetworkAddressPrivate" c:type="GNetworkAddressPrivate*"/>
29055       </field>
29056     </class>
29057     <record name="NetworkAddressClass"
29058             c:type="GNetworkAddressClass"
29059             glib:is-gtype-struct-for="NetworkAddress">
29060       <field name="parent_class">
29061         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
29062       </field>
29063     </record>
29064     <record name="NetworkAddressPrivate"
29065             c:type="GNetworkAddressPrivate"
29066             disguised="1">
29067     </record>
29068     <class name="NetworkService"
29069            c:symbol-prefix="network_service"
29070            c:type="GNetworkService"
29071            parent="GObject.Object"
29072            glib:type-name="GNetworkService"
29073            glib:get-type="g_network_service_get_type"
29074            glib:type-struct="NetworkServiceClass">
29075       <doc xml:whitespace="preserve">A #GSocketConnectable for resolving a SRV record and connecting to
29076 that service.</doc>
29077       <implements name="SocketConnectable"/>
29078       <function name="new" c:identifier="g_network_service_new" version="2.22">
29079         <doc xml:whitespace="preserve">Creates a new #GNetworkService representing the given @service,
29080 #GSocketConnectable interface to resolve it.</doc>
29081         <return-value transfer-ownership="full">
29082           <doc xml:whitespace="preserve">a new #GNetworkService</doc>
29083           <type name="SocketConnectable" c:type="GSocketConnectable*"/>
29084         </return-value>
29085         <parameters>
29086           <parameter name="service" transfer-ownership="none">
29087             <doc xml:whitespace="preserve">the service type to look up (eg, "ldap")</doc>
29088             <type name="utf8" c:type="gchar*"/>
29089           </parameter>
29090           <parameter name="protocol" transfer-ownership="none">
29091             <doc xml:whitespace="preserve">the networking protocol to use for @service (eg, "tcp")</doc>
29092             <type name="utf8" c:type="gchar*"/>
29093           </parameter>
29094           <parameter name="domain" transfer-ownership="none">
29095             <doc xml:whitespace="preserve">the DNS domain to look up the service in</doc>
29096             <type name="utf8" c:type="gchar*"/>
29097           </parameter>
29098         </parameters>
29099       </function>
29100       <method name="get_domain"
29101               c:identifier="g_network_service_get_domain"
29102               version="2.22">
29103         <doc xml:whitespace="preserve">Gets the domain that @srv serves. This might be either UTF-8 or
29104 ASCII-encoded, depending on what @srv was created with.</doc>
29105         <return-value transfer-ownership="none">
29106           <doc xml:whitespace="preserve">@srv's domain name</doc>
29107           <type name="utf8" c:type="gchar*"/>
29108         </return-value>
29109       </method>
29110       <method name="get_protocol"
29111               c:identifier="g_network_service_get_protocol"
29112               version="2.22">
29113         <doc xml:whitespace="preserve">Gets @srv's protocol name (eg, "tcp").</doc>
29114         <return-value transfer-ownership="none">
29115           <doc xml:whitespace="preserve">@srv's protocol name</doc>
29116           <type name="utf8" c:type="gchar*"/>
29117         </return-value>
29118       </method>
29119       <method name="get_scheme"
29120               c:identifier="g_network_service_get_scheme"
29121               version="2.26">
29122         <doc xml:whitespace="preserve">Get's the URI scheme used to resolve proxies. By default, the service name
29123 is used as scheme.</doc>
29124         <return-value transfer-ownership="none">
29125           <doc xml:whitespace="preserve">@srv's scheme name</doc>
29126           <type name="utf8" c:type="gchar*"/>
29127         </return-value>
29128       </method>
29129       <method name="get_service"
29130               c:identifier="g_network_service_get_service"
29131               version="2.22">
29132         <doc xml:whitespace="preserve">Gets @srv's service name (eg, "ldap").</doc>
29133         <return-value transfer-ownership="none">
29134           <doc xml:whitespace="preserve">@srv's service name</doc>
29135           <type name="utf8" c:type="gchar*"/>
29136         </return-value>
29137       </method>
29138       <method name="set_scheme"
29139               c:identifier="g_network_service_set_scheme"
29140               version="2.26">
29141         <doc xml:whitespace="preserve">Set's the URI scheme used to resolve proxies. By default, the service name
29142 is used as scheme.</doc>
29143         <return-value transfer-ownership="none">
29144           <type name="none" c:type="void"/>
29145         </return-value>
29146         <parameters>
29147           <parameter name="scheme" transfer-ownership="none">
29148             <doc xml:whitespace="preserve">a URI scheme</doc>
29149             <type name="utf8" c:type="gchar*"/>
29150           </parameter>
29151         </parameters>
29152       </method>
29153       <property name="domain"
29154                 writable="1"
29155                 construct-only="1"
29156                 transfer-ownership="none">
29157         <type name="utf8"/>
29158       </property>
29159       <property name="protocol"
29160                 writable="1"
29161                 construct-only="1"
29162                 transfer-ownership="none">
29163         <type name="utf8"/>
29164       </property>
29165       <property name="scheme" writable="1" transfer-ownership="none">
29166         <type name="utf8"/>
29167       </property>
29168       <property name="service"
29169                 writable="1"
29170                 construct-only="1"
29171                 transfer-ownership="none">
29172         <type name="utf8"/>
29173       </property>
29174       <field name="parent_instance">
29175         <type name="GObject.Object" c:type="GObject"/>
29176       </field>
29177       <field name="priv">
29178         <type name="NetworkServicePrivate" c:type="GNetworkServicePrivate*"/>
29179       </field>
29180     </class>
29181     <record name="NetworkServiceClass"
29182             c:type="GNetworkServiceClass"
29183             glib:is-gtype-struct-for="NetworkService">
29184       <field name="parent_class">
29185         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
29186       </field>
29187     </record>
29188     <record name="NetworkServicePrivate"
29189             c:type="GNetworkServicePrivate"
29190             disguised="1">
29191     </record>
29192     <class name="OutputStream"
29193            c:symbol-prefix="output_stream"
29194            c:type="GOutputStream"
29195            parent="GObject.Object"
29196            abstract="1"
29197            glib:type-name="GOutputStream"
29198            glib:get-type="g_output_stream_get_type"
29199            glib:type-struct="OutputStreamClass">
29200       <doc xml:whitespace="preserve">Base class for writing output.
29201 All classes derived from GOutputStream should implement synchronous
29202 writing, splicing, flushing and closing streams, but may implement
29203 asynchronous versions.</doc>
29204       <virtual-method name="close_async" invoker="close_async">
29205         <doc xml:whitespace="preserve">Requests an asynchronous close of the stream, releasing resources
29206 related to it. When the operation is finished @callback will be
29207 called. You can then call g_output_stream_close_finish() to get
29208 the result of the operation.
29209 For behaviour details see g_output_stream_close().
29210 The asyncronous methods have a default fallback that uses threads
29211 to implement asynchronicity, so they are optional for inheriting
29212 classes. However, if you override one you must override all.</doc>
29213         <return-value transfer-ownership="none">
29214           <type name="none" c:type="void"/>
29215         </return-value>
29216         <parameters>
29217           <parameter name="io_priority" transfer-ownership="none">
29218             <doc xml:whitespace="preserve">the io priority of the request.</doc>
29219             <type name="gint" c:type="int"/>
29220           </parameter>
29221           <parameter name="cancellable"
29222                      transfer-ownership="none"
29223                      allow-none="1">
29224             <doc xml:whitespace="preserve">optional cancellable object</doc>
29225             <type name="Cancellable" c:type="GCancellable*"/>
29226           </parameter>
29227           <parameter name="callback"
29228                      transfer-ownership="none"
29229                      scope="async"
29230                      closure="3">
29231             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
29232             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
29233           </parameter>
29234           <parameter name="user_data" transfer-ownership="none" closure="3">
29235             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
29236             <type name="gpointer" c:type="gpointer"/>
29237           </parameter>
29238         </parameters>
29239       </virtual-method>
29240       <virtual-method name="close_finish" invoker="close_finish" throws="1">
29241         <doc xml:whitespace="preserve">Closes an output stream.</doc>
29242         <return-value transfer-ownership="none">
29243           <doc xml:whitespace="preserve">%TRUE if stream was successfully closed, %FALSE otherwise.</doc>
29244           <type name="gboolean" c:type="gboolean"/>
29245         </return-value>
29246         <parameters>
29247           <parameter name="result" transfer-ownership="none">
29248             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
29249             <type name="AsyncResult" c:type="GAsyncResult*"/>
29250           </parameter>
29251         </parameters>
29252       </virtual-method>
29253       <virtual-method name="close_fn" throws="1">
29254         <return-value transfer-ownership="none">
29255           <type name="gboolean" c:type="gboolean"/>
29256         </return-value>
29257         <parameters>
29258           <parameter name="cancellable" transfer-ownership="none">
29259             <type name="Cancellable" c:type="GCancellable*"/>
29260           </parameter>
29261         </parameters>
29262       </virtual-method>
29263       <virtual-method name="flush" invoker="flush" throws="1">
29264         <doc xml:whitespace="preserve">Flushed any outstanding buffers in the stream. Will block during
29265 the operation. Closing the stream will implicitly cause a flush.
29266 This function is optional for inherited classes.
29267 If @cancellable is not %NULL, then the operation can be cancelled by
29268 triggering the cancellable object from another thread. If the operation
29269 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
29270         <return-value transfer-ownership="none">
29271           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error</doc>
29272           <type name="gboolean" c:type="gboolean"/>
29273         </return-value>
29274         <parameters>
29275           <parameter name="cancellable"
29276                      transfer-ownership="none"
29277                      allow-none="1">
29278             <doc xml:whitespace="preserve">optional cancellable object</doc>
29279             <type name="Cancellable" c:type="GCancellable*"/>
29280           </parameter>
29281         </parameters>
29282       </virtual-method>
29283       <virtual-method name="flush_async" invoker="flush_async">
29284         <doc xml:whitespace="preserve">Flushes a stream asynchronously.
29285 For behaviour details see g_output_stream_flush().
29286 When the operation is finished @callback will be
29287 called. You can then call g_output_stream_flush_finish() to get the
29288 result of the operation.</doc>
29289         <return-value transfer-ownership="none">
29290           <type name="none" c:type="void"/>
29291         </return-value>
29292         <parameters>
29293           <parameter name="io_priority" transfer-ownership="none">
29294             <doc xml:whitespace="preserve">the io priority of the request.</doc>
29295             <type name="gint" c:type="int"/>
29296           </parameter>
29297           <parameter name="cancellable"
29298                      transfer-ownership="none"
29299                      allow-none="1">
29300             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
29301             <type name="Cancellable" c:type="GCancellable*"/>
29302           </parameter>
29303           <parameter name="callback"
29304                      transfer-ownership="none"
29305                      scope="async"
29306                      closure="3">
29307             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
29308             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
29309           </parameter>
29310           <parameter name="user_data" transfer-ownership="none" closure="3">
29311             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
29312             <type name="gpointer" c:type="gpointer"/>
29313           </parameter>
29314         </parameters>
29315       </virtual-method>
29316       <virtual-method name="flush_finish" invoker="flush_finish" throws="1">
29317         <doc xml:whitespace="preserve">Finishes flushing an output stream.</doc>
29318         <return-value transfer-ownership="none">
29319           <doc xml:whitespace="preserve">%TRUE if flush operation suceeded, %FALSE otherwise.</doc>
29320           <type name="gboolean" c:type="gboolean"/>
29321         </return-value>
29322         <parameters>
29323           <parameter name="result" transfer-ownership="none">
29324             <doc xml:whitespace="preserve">a GAsyncResult.</doc>
29325             <type name="AsyncResult" c:type="GAsyncResult*"/>
29326           </parameter>
29327         </parameters>
29328       </virtual-method>
29329       <virtual-method name="splice" invoker="splice" throws="1">
29330         <doc xml:whitespace="preserve">Splices an input stream into an output stream.
29331 -1 if an error occurred.</doc>
29332         <return-value transfer-ownership="none">
29333           <doc xml:whitespace="preserve">a #gssize containing the size of the data spliced, or</doc>
29334           <type name="glong" c:type="gssize"/>
29335         </return-value>
29336         <parameters>
29337           <parameter name="source" transfer-ownership="none">
29338             <doc xml:whitespace="preserve">a #GInputStream.</doc>
29339             <type name="InputStream" c:type="GInputStream*"/>
29340           </parameter>
29341           <parameter name="flags" transfer-ownership="none">
29342             <doc xml:whitespace="preserve">a set of #GOutputStreamSpliceFlags.</doc>
29343             <type name="OutputStreamSpliceFlags"
29344                   c:type="GOutputStreamSpliceFlags"/>
29345           </parameter>
29346           <parameter name="cancellable"
29347                      transfer-ownership="none"
29348                      allow-none="1">
29349             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
29350             <type name="Cancellable" c:type="GCancellable*"/>
29351           </parameter>
29352         </parameters>
29353       </virtual-method>
29354       <virtual-method name="splice_async" invoker="splice_async">
29355         <doc xml:whitespace="preserve">Splices a stream asynchronously.
29356 When the operation is finished @callback will be called.
29357 You can then call g_output_stream_splice_finish() to get the
29358 result of the operation.
29359 For the synchronous, blocking version of this function, see
29360 g_output_stream_splice().</doc>
29361         <return-value transfer-ownership="none">
29362           <type name="none" c:type="void"/>
29363         </return-value>
29364         <parameters>
29365           <parameter name="source" transfer-ownership="none">
29366             <doc xml:whitespace="preserve">a #GInputStream.</doc>
29367             <type name="InputStream" c:type="GInputStream*"/>
29368           </parameter>
29369           <parameter name="flags" transfer-ownership="none">
29370             <doc xml:whitespace="preserve">a set of #GOutputStreamSpliceFlags.</doc>
29371             <type name="OutputStreamSpliceFlags"
29372                   c:type="GOutputStreamSpliceFlags"/>
29373           </parameter>
29374           <parameter name="io_priority" transfer-ownership="none">
29375             <doc xml:whitespace="preserve">the io priority of the request.</doc>
29376             <type name="gint" c:type="int"/>
29377           </parameter>
29378           <parameter name="cancellable"
29379                      transfer-ownership="none"
29380                      allow-none="1">
29381             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
29382             <type name="Cancellable" c:type="GCancellable*"/>
29383           </parameter>
29384           <parameter name="callback"
29385                      transfer-ownership="none"
29386                      scope="async"
29387                      closure="5">
29388             <doc xml:whitespace="preserve">a #GAsyncReadyCallback.</doc>
29389             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
29390           </parameter>
29391           <parameter name="data" transfer-ownership="none">
29392             <type name="gpointer" c:type="gpointer"/>
29393           </parameter>
29394         </parameters>
29395       </virtual-method>
29396       <virtual-method name="splice_finish" invoker="splice_finish" throws="1">
29397         <doc xml:whitespace="preserve">Finishes an asynchronous stream splice operation.</doc>
29398         <return-value transfer-ownership="none">
29399           <doc xml:whitespace="preserve">a #gssize of the number of bytes spliced.</doc>
29400           <type name="glong" c:type="gssize"/>
29401         </return-value>
29402         <parameters>
29403           <parameter name="result" transfer-ownership="none">
29404             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
29405             <type name="AsyncResult" c:type="GAsyncResult*"/>
29406           </parameter>
29407         </parameters>
29408       </virtual-method>
29409       <virtual-method name="write_async" invoker="write_async">
29410         <doc xml:whitespace="preserve">Request an asynchronous write of @count bytes from @buffer into
29411 the stream. When the operation is finished @callback will be called.
29412 You can then call g_output_stream_write_finish() to get the result of the
29413 operation.
29414 During an async request no other sync and async calls are allowed,
29415 and will result in %G_IO_ERROR_PENDING errors.
29416 A value of @count larger than %G_MAXSSIZE will cause a
29417 %G_IO_ERROR_INVALID_ARGUMENT error.
29418 On success, the number of bytes written will be passed to the
29419 requested size, as it can happen e.g. on a partial I/O error,
29420 but generally we try to write as many bytes as requested.
29421 You are guaranteed that this method will never fail with
29422 %G_IO_ERROR_WOULD_BLOCK - if @stream can't accept more data, the
29423 method will just wait until this changes.
29424 Any outstanding I/O request with higher priority (lower numerical
29425 value) will be executed before an outstanding request with lower
29426 priority. Default priority is %G_PRIORITY_DEFAULT.
29427 The asyncronous methods have a default fallback that uses threads
29428 to implement asynchronicity, so they are optional for inheriting
29429 classes. However, if you override one you must override all.
29430 For the synchronous, blocking version of this function, see
29431 g_output_stream_write().</doc>
29432         <return-value transfer-ownership="none">
29433           <type name="none" c:type="void"/>
29434         </return-value>
29435         <parameters>
29436           <parameter name="buffer" transfer-ownership="none">
29437             <doc xml:whitespace="preserve">the buffer containing the data to write.</doc>
29438             <array length="1" c:type="void*">
29439               <type name="guint8"/>
29440             </array>
29441           </parameter>
29442           <parameter name="count" transfer-ownership="none">
29443             <doc xml:whitespace="preserve">the number of bytes to write</doc>
29444             <type name="gulong" c:type="gsize"/>
29445           </parameter>
29446           <parameter name="io_priority" transfer-ownership="none">
29447             <doc xml:whitespace="preserve">the io priority of the request.</doc>
29448             <type name="gint" c:type="int"/>
29449           </parameter>
29450           <parameter name="cancellable"
29451                      transfer-ownership="none"
29452                      allow-none="1">
29453             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
29454             <type name="Cancellable" c:type="GCancellable*"/>
29455           </parameter>
29456           <parameter name="callback"
29457                      transfer-ownership="none"
29458                      scope="async"
29459                      closure="5">
29460             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
29461             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
29462           </parameter>
29463           <parameter name="user_data" transfer-ownership="none" closure="5">
29464             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
29465             <type name="gpointer" c:type="gpointer"/>
29466           </parameter>
29467         </parameters>
29468       </virtual-method>
29469       <virtual-method name="write_finish" invoker="write_finish" throws="1">
29470         <doc xml:whitespace="preserve">Finishes a stream write operation.</doc>
29471         <return-value transfer-ownership="none">
29472           <doc xml:whitespace="preserve">a #gssize containing the number of bytes written to the stream.</doc>
29473           <type name="glong" c:type="gssize"/>
29474         </return-value>
29475         <parameters>
29476           <parameter name="result" transfer-ownership="none">
29477             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
29478             <type name="AsyncResult" c:type="GAsyncResult*"/>
29479           </parameter>
29480         </parameters>
29481       </virtual-method>
29482       <virtual-method name="write_fn" throws="1">
29483         <return-value transfer-ownership="none">
29484           <type name="glong" c:type="gssize"/>
29485         </return-value>
29486         <parameters>
29487           <parameter name="buffer" transfer-ownership="none">
29488             <type name="gpointer" c:type="void*"/>
29489           </parameter>
29490           <parameter name="count" transfer-ownership="none">
29491             <type name="gulong" c:type="gsize"/>
29492           </parameter>
29493           <parameter name="cancellable" transfer-ownership="none">
29494             <type name="Cancellable" c:type="GCancellable*"/>
29495           </parameter>
29496         </parameters>
29497       </virtual-method>
29498       <method name="clear_pending"
29499               c:identifier="g_output_stream_clear_pending">
29500         <doc xml:whitespace="preserve">Clears the pending flag on @stream.</doc>
29501         <return-value transfer-ownership="none">
29502           <type name="none" c:type="void"/>
29503         </return-value>
29504       </method>
29505       <method name="close" c:identifier="g_output_stream_close" throws="1">
29506         <doc xml:whitespace="preserve">Closes the stream, releasing resources related to it.
29507 Once the stream is closed, all other operations will return %G_IO_ERROR_CLOSED.
29508 Closing a stream multiple times will not return an error.
29509 Closing a stream will automatically flush any outstanding buffers in the
29510 stream.
29511 Streams will be automatically closed when the last reference
29512 is dropped, but you might want to call this function to make sure
29513 resources are released as early as possible.
29514 Some streams might keep the backing store of the stream (e.g. a file descriptor)
29515 open after the stream is closed. See the documentation for the individual
29516 stream for details.
29517 On failure the first error that happened will be reported, but the close
29518 operation will finish as much as possible. A stream that failed to
29519 close will still return %G_IO_ERROR_CLOSED for all operations. Still, it
29520 is important to check and report the error to the user, otherwise
29521 there might be a loss of data as all data might not be written.
29522 If @cancellable is not NULL, then the operation can be cancelled by
29523 triggering the cancellable object from another thread. If the operation
29524 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
29525 Cancelling a close will still leave the stream closed, but there some streams
29526 can use a faster close that doesn't block to e.g. check errors. On
29527 cancellation (as with any error) there is no guarantee that all written
29528 data will reach the target.</doc>
29529         <return-value transfer-ownership="none">
29530           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on failure</doc>
29531           <type name="gboolean" c:type="gboolean"/>
29532         </return-value>
29533         <parameters>
29534           <parameter name="cancellable"
29535                      transfer-ownership="none"
29536                      allow-none="1">
29537             <doc xml:whitespace="preserve">optional cancellable object</doc>
29538             <type name="Cancellable" c:type="GCancellable*"/>
29539           </parameter>
29540         </parameters>
29541       </method>
29542       <method name="close_async" c:identifier="g_output_stream_close_async">
29543         <doc xml:whitespace="preserve">Requests an asynchronous close of the stream, releasing resources
29544 related to it. When the operation is finished @callback will be
29545 called. You can then call g_output_stream_close_finish() to get
29546 the result of the operation.
29547 For behaviour details see g_output_stream_close().
29548 The asyncronous methods have a default fallback that uses threads
29549 to implement asynchronicity, so they are optional for inheriting
29550 classes. However, if you override one you must override all.</doc>
29551         <return-value transfer-ownership="none">
29552           <type name="none" c:type="void"/>
29553         </return-value>
29554         <parameters>
29555           <parameter name="io_priority" transfer-ownership="none">
29556             <doc xml:whitespace="preserve">the io priority of the request.</doc>
29557             <type name="gint" c:type="int"/>
29558           </parameter>
29559           <parameter name="cancellable"
29560                      transfer-ownership="none"
29561                      allow-none="1">
29562             <doc xml:whitespace="preserve">optional cancellable object</doc>
29563             <type name="Cancellable" c:type="GCancellable*"/>
29564           </parameter>
29565           <parameter name="callback"
29566                      transfer-ownership="none"
29567                      scope="async"
29568                      closure="3">
29569             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
29570             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
29571           </parameter>
29572           <parameter name="user_data" transfer-ownership="none">
29573             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
29574             <type name="gpointer" c:type="gpointer"/>
29575           </parameter>
29576         </parameters>
29577       </method>
29578       <method name="close_finish"
29579               c:identifier="g_output_stream_close_finish"
29580               throws="1">
29581         <doc xml:whitespace="preserve">Closes an output stream.</doc>
29582         <return-value transfer-ownership="none">
29583           <doc xml:whitespace="preserve">%TRUE if stream was successfully closed, %FALSE otherwise.</doc>
29584           <type name="gboolean" c:type="gboolean"/>
29585         </return-value>
29586         <parameters>
29587           <parameter name="result" transfer-ownership="none">
29588             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
29589             <type name="AsyncResult" c:type="GAsyncResult*"/>
29590           </parameter>
29591         </parameters>
29592       </method>
29593       <method name="flush" c:identifier="g_output_stream_flush" throws="1">
29594         <doc xml:whitespace="preserve">Flushed any outstanding buffers in the stream. Will block during
29595 the operation. Closing the stream will implicitly cause a flush.
29596 This function is optional for inherited classes.
29597 If @cancellable is not %NULL, then the operation can be cancelled by
29598 triggering the cancellable object from another thread. If the operation
29599 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
29600         <return-value transfer-ownership="none">
29601           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error</doc>
29602           <type name="gboolean" c:type="gboolean"/>
29603         </return-value>
29604         <parameters>
29605           <parameter name="cancellable"
29606                      transfer-ownership="none"
29607                      allow-none="1">
29608             <doc xml:whitespace="preserve">optional cancellable object</doc>
29609             <type name="Cancellable" c:type="GCancellable*"/>
29610           </parameter>
29611         </parameters>
29612       </method>
29613       <method name="flush_async" c:identifier="g_output_stream_flush_async">
29614         <doc xml:whitespace="preserve">Flushes a stream asynchronously.
29615 For behaviour details see g_output_stream_flush().
29616 When the operation is finished @callback will be
29617 called. You can then call g_output_stream_flush_finish() to get the
29618 result of the operation.</doc>
29619         <return-value transfer-ownership="none">
29620           <type name="none" c:type="void"/>
29621         </return-value>
29622         <parameters>
29623           <parameter name="io_priority" transfer-ownership="none">
29624             <doc xml:whitespace="preserve">the io priority of the request.</doc>
29625             <type name="gint" c:type="int"/>
29626           </parameter>
29627           <parameter name="cancellable"
29628                      transfer-ownership="none"
29629                      allow-none="1">
29630             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
29631             <type name="Cancellable" c:type="GCancellable*"/>
29632           </parameter>
29633           <parameter name="callback"
29634                      transfer-ownership="none"
29635                      scope="async"
29636                      closure="3">
29637             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
29638             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
29639           </parameter>
29640           <parameter name="user_data" transfer-ownership="none">
29641             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
29642             <type name="gpointer" c:type="gpointer"/>
29643           </parameter>
29644         </parameters>
29645       </method>
29646       <method name="flush_finish"
29647               c:identifier="g_output_stream_flush_finish"
29648               throws="1">
29649         <doc xml:whitespace="preserve">Finishes flushing an output stream.</doc>
29650         <return-value transfer-ownership="none">
29651           <doc xml:whitespace="preserve">%TRUE if flush operation suceeded, %FALSE otherwise.</doc>
29652           <type name="gboolean" c:type="gboolean"/>
29653         </return-value>
29654         <parameters>
29655           <parameter name="result" transfer-ownership="none">
29656             <doc xml:whitespace="preserve">a GAsyncResult.</doc>
29657             <type name="AsyncResult" c:type="GAsyncResult*"/>
29658           </parameter>
29659         </parameters>
29660       </method>
29661       <method name="has_pending" c:identifier="g_output_stream_has_pending">
29662         <doc xml:whitespace="preserve">Checks if an ouput stream has pending actions.</doc>
29663         <return-value transfer-ownership="none">
29664           <doc xml:whitespace="preserve">%TRUE if @stream has pending actions.</doc>
29665           <type name="gboolean" c:type="gboolean"/>
29666         </return-value>
29667       </method>
29668       <method name="is_closed" c:identifier="g_output_stream_is_closed">
29669         <doc xml:whitespace="preserve">Checks if an output stream has already been closed.</doc>
29670         <return-value transfer-ownership="none">
29671           <doc xml:whitespace="preserve">%TRUE if @stream is closed. %FALSE otherwise.</doc>
29672           <type name="gboolean" c:type="gboolean"/>
29673         </return-value>
29674       </method>
29675       <method name="is_closing"
29676               c:identifier="g_output_stream_is_closing"
29677               version="2.24">
29678         <doc xml:whitespace="preserve">Checks if an output stream is being closed. This can be
29679 used inside e.g. a flush implementation to see if the
29680 flush (or other i/o operation) is called from within
29681 the closing operation.</doc>
29682         <return-value transfer-ownership="none">
29683           <doc xml:whitespace="preserve">%TRUE if @stream is being closed. %FALSE otherwise.</doc>
29684           <type name="gboolean" c:type="gboolean"/>
29685         </return-value>
29686       </method>
29687       <method name="set_pending"
29688               c:identifier="g_output_stream_set_pending"
29689               throws="1">
29690         <doc xml:whitespace="preserve">Sets @stream to have actions pending. If the pending flag is
29691 already set or @stream is closed, it will return %FALSE and set</doc>
29692         <return-value transfer-ownership="none">
29693           <doc xml:whitespace="preserve">%TRUE if pending was previously unset and is now set.</doc>
29694           <type name="gboolean" c:type="gboolean"/>
29695         </return-value>
29696       </method>
29697       <method name="splice" c:identifier="g_output_stream_splice" throws="1">
29698         <doc xml:whitespace="preserve">Splices an input stream into an output stream.
29699 -1 if an error occurred.</doc>
29700         <return-value transfer-ownership="none">
29701           <doc xml:whitespace="preserve">a #gssize containing the size of the data spliced, or</doc>
29702           <type name="glong" c:type="gssize"/>
29703         </return-value>
29704         <parameters>
29705           <parameter name="source" transfer-ownership="none">
29706             <doc xml:whitespace="preserve">a #GInputStream.</doc>
29707             <type name="InputStream" c:type="GInputStream*"/>
29708           </parameter>
29709           <parameter name="flags" transfer-ownership="none">
29710             <doc xml:whitespace="preserve">a set of #GOutputStreamSpliceFlags.</doc>
29711             <type name="OutputStreamSpliceFlags"
29712                   c:type="GOutputStreamSpliceFlags"/>
29713           </parameter>
29714           <parameter name="cancellable"
29715                      transfer-ownership="none"
29716                      allow-none="1">
29717             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
29718             <type name="Cancellable" c:type="GCancellable*"/>
29719           </parameter>
29720         </parameters>
29721       </method>
29722       <method name="splice_async" c:identifier="g_output_stream_splice_async">
29723         <doc xml:whitespace="preserve">Splices a stream asynchronously.
29724 When the operation is finished @callback will be called.
29725 You can then call g_output_stream_splice_finish() to get the
29726 result of the operation.
29727 For the synchronous, blocking version of this function, see
29728 g_output_stream_splice().</doc>
29729         <return-value transfer-ownership="none">
29730           <type name="none" c:type="void"/>
29731         </return-value>
29732         <parameters>
29733           <parameter name="source" transfer-ownership="none">
29734             <doc xml:whitespace="preserve">a #GInputStream.</doc>
29735             <type name="InputStream" c:type="GInputStream*"/>
29736           </parameter>
29737           <parameter name="flags" transfer-ownership="none">
29738             <doc xml:whitespace="preserve">a set of #GOutputStreamSpliceFlags.</doc>
29739             <type name="OutputStreamSpliceFlags"
29740                   c:type="GOutputStreamSpliceFlags"/>
29741           </parameter>
29742           <parameter name="io_priority" transfer-ownership="none">
29743             <doc xml:whitespace="preserve">the io priority of the request.</doc>
29744             <type name="gint" c:type="int"/>
29745           </parameter>
29746           <parameter name="cancellable"
29747                      transfer-ownership="none"
29748                      allow-none="1">
29749             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
29750             <type name="Cancellable" c:type="GCancellable*"/>
29751           </parameter>
29752           <parameter name="callback"
29753                      transfer-ownership="none"
29754                      scope="async"
29755                      closure="5">
29756             <doc xml:whitespace="preserve">a #GAsyncReadyCallback.</doc>
29757             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
29758           </parameter>
29759           <parameter name="user_data" transfer-ownership="none">
29760             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
29761             <type name="gpointer" c:type="gpointer"/>
29762           </parameter>
29763         </parameters>
29764       </method>
29765       <method name="splice_finish"
29766               c:identifier="g_output_stream_splice_finish"
29767               throws="1">
29768         <doc xml:whitespace="preserve">Finishes an asynchronous stream splice operation.</doc>
29769         <return-value transfer-ownership="none">
29770           <doc xml:whitespace="preserve">a #gssize of the number of bytes spliced.</doc>
29771           <type name="glong" c:type="gssize"/>
29772         </return-value>
29773         <parameters>
29774           <parameter name="result" transfer-ownership="none">
29775             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
29776             <type name="AsyncResult" c:type="GAsyncResult*"/>
29777           </parameter>
29778         </parameters>
29779       </method>
29780       <method name="write" c:identifier="g_output_stream_write" throws="1">
29781         <doc xml:whitespace="preserve">Tries to write @count bytes from @buffer into the stream. Will block
29782 during the operation.
29783 If count is 0, returns 0 and does nothing. A value of @count
29784 larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
29785 On success, the number of bytes written to the stream is returned.
29786 It is not an error if this is not the same as the requested size, as it
29787 can happen e.g. on a partial I/O error, or if there is not enough
29788 storage in the stream. All writes block until at least one byte
29789 is written or an error occurs; 0 is never returned (unless
29790 If @cancellable is not NULL, then the operation can be cancelled by
29791 triggering the cancellable object from another thread. If the operation
29792 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
29793 operation was partially finished when the operation was cancelled the
29794 partial result will be returned, without an error.
29795 On error -1 is returned and @error is set accordingly.</doc>
29796         <return-value transfer-ownership="none">
29797           <doc xml:whitespace="preserve">Number of bytes written, or -1 on error</doc>
29798           <type name="glong" c:type="gssize"/>
29799         </return-value>
29800         <parameters>
29801           <parameter name="buffer" transfer-ownership="none">
29802             <doc xml:whitespace="preserve">the buffer containing the data to write.</doc>
29803             <array length="1" c:type="void*">
29804               <type name="guint8"/>
29805             </array>
29806           </parameter>
29807           <parameter name="count" transfer-ownership="none">
29808             <doc xml:whitespace="preserve">the number of bytes to write</doc>
29809             <type name="gulong" c:type="gsize"/>
29810           </parameter>
29811           <parameter name="cancellable"
29812                      transfer-ownership="none"
29813                      allow-none="1">
29814             <doc xml:whitespace="preserve">optional cancellable object</doc>
29815             <type name="Cancellable" c:type="GCancellable*"/>
29816           </parameter>
29817         </parameters>
29818       </method>
29819       <method name="write_all"
29820               c:identifier="g_output_stream_write_all"
29821               throws="1">
29822         <doc xml:whitespace="preserve">Tries to write @count bytes from @buffer into the stream. Will block
29823 during the operation.
29824 This function is similar to g_output_stream_write(), except it tries to
29825 write as many bytes as requested, only stopping on an error.
29826 On a successful write of @count bytes, %TRUE is returned, and @bytes_written
29827 is set to @count.
29828 If there is an error during the operation FALSE is returned and @error
29829 is set to indicate the error status, @bytes_written is updated to contain
29830 the number of bytes written into the stream before the error occurred.</doc>
29831         <return-value transfer-ownership="none">
29832           <doc xml:whitespace="preserve">%TRUE on success, %FALSE if there was an error</doc>
29833           <type name="gboolean" c:type="gboolean"/>
29834         </return-value>
29835         <parameters>
29836           <parameter name="buffer" transfer-ownership="none">
29837             <doc xml:whitespace="preserve">the buffer containing the data to write.</doc>
29838             <array length="1" c:type="void*">
29839               <type name="guint8"/>
29840             </array>
29841           </parameter>
29842           <parameter name="count" transfer-ownership="none">
29843             <doc xml:whitespace="preserve">the number of bytes to write</doc>
29844             <type name="gulong" c:type="gsize"/>
29845           </parameter>
29846           <parameter name="bytes_written" transfer-ownership="none">
29847             <doc xml:whitespace="preserve">location to store the number of bytes that was written to the stream</doc>
29848             <type name="gulong" c:type="gsize*"/>
29849           </parameter>
29850           <parameter name="cancellable"
29851                      transfer-ownership="none"
29852                      allow-none="1">
29853             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
29854             <type name="Cancellable" c:type="GCancellable*"/>
29855           </parameter>
29856         </parameters>
29857       </method>
29858       <method name="write_async" c:identifier="g_output_stream_write_async">
29859         <doc xml:whitespace="preserve">Request an asynchronous write of @count bytes from @buffer into
29860 the stream. When the operation is finished @callback will be called.
29861 You can then call g_output_stream_write_finish() to get the result of the
29862 operation.
29863 During an async request no other sync and async calls are allowed,
29864 and will result in %G_IO_ERROR_PENDING errors.
29865 A value of @count larger than %G_MAXSSIZE will cause a
29866 %G_IO_ERROR_INVALID_ARGUMENT error.
29867 On success, the number of bytes written will be passed to the
29868 requested size, as it can happen e.g. on a partial I/O error,
29869 but generally we try to write as many bytes as requested.
29870 You are guaranteed that this method will never fail with
29871 %G_IO_ERROR_WOULD_BLOCK - if @stream can't accept more data, the
29872 method will just wait until this changes.
29873 Any outstanding I/O request with higher priority (lower numerical
29874 value) will be executed before an outstanding request with lower
29875 priority. Default priority is %G_PRIORITY_DEFAULT.
29876 The asyncronous methods have a default fallback that uses threads
29877 to implement asynchronicity, so they are optional for inheriting
29878 classes. However, if you override one you must override all.
29879 For the synchronous, blocking version of this function, see
29880 g_output_stream_write().</doc>
29881         <return-value transfer-ownership="none">
29882           <type name="none" c:type="void"/>
29883         </return-value>
29884         <parameters>
29885           <parameter name="buffer" transfer-ownership="none">
29886             <doc xml:whitespace="preserve">the buffer containing the data to write.</doc>
29887             <array length="1" c:type="void*">
29888               <type name="guint8"/>
29889             </array>
29890           </parameter>
29891           <parameter name="count" transfer-ownership="none">
29892             <doc xml:whitespace="preserve">the number of bytes to write</doc>
29893             <type name="gulong" c:type="gsize"/>
29894           </parameter>
29895           <parameter name="io_priority" transfer-ownership="none">
29896             <doc xml:whitespace="preserve">the io priority of the request.</doc>
29897             <type name="gint" c:type="int"/>
29898           </parameter>
29899           <parameter name="cancellable"
29900                      transfer-ownership="none"
29901                      allow-none="1">
29902             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
29903             <type name="Cancellable" c:type="GCancellable*"/>
29904           </parameter>
29905           <parameter name="callback"
29906                      transfer-ownership="none"
29907                      scope="async"
29908                      closure="5">
29909             <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
29910             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
29911           </parameter>
29912           <parameter name="user_data" transfer-ownership="none">
29913             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
29914             <type name="gpointer" c:type="gpointer"/>
29915           </parameter>
29916         </parameters>
29917       </method>
29918       <method name="write_finish"
29919               c:identifier="g_output_stream_write_finish"
29920               throws="1">
29921         <doc xml:whitespace="preserve">Finishes a stream write operation.</doc>
29922         <return-value transfer-ownership="none">
29923           <doc xml:whitespace="preserve">a #gssize containing the number of bytes written to the stream.</doc>
29924           <type name="glong" c:type="gssize"/>
29925         </return-value>
29926         <parameters>
29927           <parameter name="result" transfer-ownership="none">
29928             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
29929             <type name="AsyncResult" c:type="GAsyncResult*"/>
29930           </parameter>
29931         </parameters>
29932       </method>
29933       <field name="parent_instance">
29934         <type name="GObject.Object" c:type="GObject"/>
29935       </field>
29936       <field name="priv">
29937         <type name="OutputStreamPrivate" c:type="GOutputStreamPrivate*"/>
29938       </field>
29939     </class>
29940     <record name="OutputStreamClass"
29941             c:type="GOutputStreamClass"
29942             glib:is-gtype-struct-for="OutputStream">
29943       <field name="parent_class">
29944         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
29945       </field>
29946       <field name="write_fn">
29947         <callback name="write_fn" throws="1">
29948           <return-value transfer-ownership="none">
29949             <type name="glong" c:type="gssize"/>
29950           </return-value>
29951           <parameters>
29952             <parameter name="stream" transfer-ownership="none">
29953               <type name="OutputStream" c:type="GOutputStream*"/>
29954             </parameter>
29955             <parameter name="buffer" transfer-ownership="none">
29956               <type name="gpointer" c:type="void*"/>
29957             </parameter>
29958             <parameter name="count" transfer-ownership="none">
29959               <type name="gulong" c:type="gsize"/>
29960             </parameter>
29961             <parameter name="cancellable" transfer-ownership="none">
29962               <type name="Cancellable" c:type="GCancellable*"/>
29963             </parameter>
29964           </parameters>
29965         </callback>
29966       </field>
29967       <field name="splice">
29968         <callback name="splice" throws="1">
29969           <return-value transfer-ownership="none">
29970             <doc xml:whitespace="preserve">a #gssize containing the size of the data spliced, or</doc>
29971             <type name="glong" c:type="gssize"/>
29972           </return-value>
29973           <parameters>
29974             <parameter name="stream" transfer-ownership="none">
29975               <type name="OutputStream" c:type="GOutputStream*"/>
29976             </parameter>
29977             <parameter name="source" transfer-ownership="none">
29978               <doc xml:whitespace="preserve">a #GInputStream.</doc>
29979               <type name="InputStream" c:type="GInputStream*"/>
29980             </parameter>
29981             <parameter name="flags" transfer-ownership="none">
29982               <doc xml:whitespace="preserve">a set of #GOutputStreamSpliceFlags.</doc>
29983               <type name="OutputStreamSpliceFlags"
29984                     c:type="GOutputStreamSpliceFlags"/>
29985             </parameter>
29986             <parameter name="cancellable"
29987                        transfer-ownership="none"
29988                        allow-none="1">
29989               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
29990               <type name="Cancellable" c:type="GCancellable*"/>
29991             </parameter>
29992           </parameters>
29993         </callback>
29994       </field>
29995       <field name="flush">
29996         <callback name="flush" throws="1">
29997           <return-value transfer-ownership="none">
29998             <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error</doc>
29999             <type name="gboolean" c:type="gboolean"/>
30000           </return-value>
30001           <parameters>
30002             <parameter name="stream" transfer-ownership="none">
30003               <type name="OutputStream" c:type="GOutputStream*"/>
30004             </parameter>
30005             <parameter name="cancellable"
30006                        transfer-ownership="none"
30007                        allow-none="1">
30008               <doc xml:whitespace="preserve">optional cancellable object</doc>
30009               <type name="Cancellable" c:type="GCancellable*"/>
30010             </parameter>
30011           </parameters>
30012         </callback>
30013       </field>
30014       <field name="close_fn">
30015         <callback name="close_fn" throws="1">
30016           <return-value transfer-ownership="none">
30017             <type name="gboolean" c:type="gboolean"/>
30018           </return-value>
30019           <parameters>
30020             <parameter name="stream" transfer-ownership="none">
30021               <type name="OutputStream" c:type="GOutputStream*"/>
30022             </parameter>
30023             <parameter name="cancellable" transfer-ownership="none">
30024               <type name="Cancellable" c:type="GCancellable*"/>
30025             </parameter>
30026           </parameters>
30027         </callback>
30028       </field>
30029       <field name="write_async">
30030         <callback name="write_async">
30031           <return-value transfer-ownership="none">
30032             <type name="none" c:type="void"/>
30033           </return-value>
30034           <parameters>
30035             <parameter name="stream" transfer-ownership="none">
30036               <type name="OutputStream" c:type="GOutputStream*"/>
30037             </parameter>
30038             <parameter name="buffer" transfer-ownership="none">
30039               <doc xml:whitespace="preserve">the buffer containing the data to write.</doc>
30040               <array length="2" c:type="void*">
30041                 <type name="guint8"/>
30042               </array>
30043             </parameter>
30044             <parameter name="count" transfer-ownership="none">
30045               <doc xml:whitespace="preserve">the number of bytes to write</doc>
30046               <type name="gulong" c:type="gsize"/>
30047             </parameter>
30048             <parameter name="io_priority" transfer-ownership="none">
30049               <doc xml:whitespace="preserve">the io priority of the request.</doc>
30050               <type name="gint" c:type="int"/>
30051             </parameter>
30052             <parameter name="cancellable"
30053                        transfer-ownership="none"
30054                        allow-none="1">
30055               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
30056               <type name="Cancellable" c:type="GCancellable*"/>
30057             </parameter>
30058             <parameter name="callback"
30059                        transfer-ownership="none"
30060                        scope="async"
30061                        closure="6">
30062               <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
30063               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
30064             </parameter>
30065             <parameter name="user_data" transfer-ownership="none" closure="6">
30066               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
30067               <type name="gpointer" c:type="gpointer"/>
30068             </parameter>
30069           </parameters>
30070         </callback>
30071       </field>
30072       <field name="write_finish">
30073         <callback name="write_finish" throws="1">
30074           <return-value transfer-ownership="none">
30075             <doc xml:whitespace="preserve">a #gssize containing the number of bytes written to the stream.</doc>
30076             <type name="glong" c:type="gssize"/>
30077           </return-value>
30078           <parameters>
30079             <parameter name="stream" transfer-ownership="none">
30080               <type name="OutputStream" c:type="GOutputStream*"/>
30081             </parameter>
30082             <parameter name="result" transfer-ownership="none">
30083               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
30084               <type name="AsyncResult" c:type="GAsyncResult*"/>
30085             </parameter>
30086           </parameters>
30087         </callback>
30088       </field>
30089       <field name="splice_async">
30090         <callback name="splice_async">
30091           <return-value transfer-ownership="none">
30092             <type name="none" c:type="void"/>
30093           </return-value>
30094           <parameters>
30095             <parameter name="stream" transfer-ownership="none">
30096               <type name="OutputStream" c:type="GOutputStream*"/>
30097             </parameter>
30098             <parameter name="source" transfer-ownership="none">
30099               <doc xml:whitespace="preserve">a #GInputStream.</doc>
30100               <type name="InputStream" c:type="GInputStream*"/>
30101             </parameter>
30102             <parameter name="flags" transfer-ownership="none">
30103               <doc xml:whitespace="preserve">a set of #GOutputStreamSpliceFlags.</doc>
30104               <type name="OutputStreamSpliceFlags"
30105                     c:type="GOutputStreamSpliceFlags"/>
30106             </parameter>
30107             <parameter name="io_priority" transfer-ownership="none">
30108               <doc xml:whitespace="preserve">the io priority of the request.</doc>
30109               <type name="gint" c:type="int"/>
30110             </parameter>
30111             <parameter name="cancellable"
30112                        transfer-ownership="none"
30113                        allow-none="1">
30114               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
30115               <type name="Cancellable" c:type="GCancellable*"/>
30116             </parameter>
30117             <parameter name="callback"
30118                        transfer-ownership="none"
30119                        scope="async"
30120                        closure="6">
30121               <doc xml:whitespace="preserve">a #GAsyncReadyCallback.</doc>
30122               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
30123             </parameter>
30124             <parameter name="data" transfer-ownership="none">
30125               <type name="gpointer" c:type="gpointer"/>
30126             </parameter>
30127           </parameters>
30128         </callback>
30129       </field>
30130       <field name="splice_finish">
30131         <callback name="splice_finish" throws="1">
30132           <return-value transfer-ownership="none">
30133             <doc xml:whitespace="preserve">a #gssize of the number of bytes spliced.</doc>
30134             <type name="glong" c:type="gssize"/>
30135           </return-value>
30136           <parameters>
30137             <parameter name="stream" transfer-ownership="none">
30138               <type name="OutputStream" c:type="GOutputStream*"/>
30139             </parameter>
30140             <parameter name="result" transfer-ownership="none">
30141               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
30142               <type name="AsyncResult" c:type="GAsyncResult*"/>
30143             </parameter>
30144           </parameters>
30145         </callback>
30146       </field>
30147       <field name="flush_async">
30148         <callback name="flush_async">
30149           <return-value transfer-ownership="none">
30150             <type name="none" c:type="void"/>
30151           </return-value>
30152           <parameters>
30153             <parameter name="stream" transfer-ownership="none">
30154               <type name="OutputStream" c:type="GOutputStream*"/>
30155             </parameter>
30156             <parameter name="io_priority" transfer-ownership="none">
30157               <doc xml:whitespace="preserve">the io priority of the request.</doc>
30158               <type name="gint" c:type="int"/>
30159             </parameter>
30160             <parameter name="cancellable"
30161                        transfer-ownership="none"
30162                        allow-none="1">
30163               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
30164               <type name="Cancellable" c:type="GCancellable*"/>
30165             </parameter>
30166             <parameter name="callback"
30167                        transfer-ownership="none"
30168                        scope="async"
30169                        closure="4">
30170               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
30171               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
30172             </parameter>
30173             <parameter name="user_data" transfer-ownership="none" closure="4">
30174               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
30175               <type name="gpointer" c:type="gpointer"/>
30176             </parameter>
30177           </parameters>
30178         </callback>
30179       </field>
30180       <field name="flush_finish">
30181         <callback name="flush_finish" throws="1">
30182           <return-value transfer-ownership="none">
30183             <doc xml:whitespace="preserve">%TRUE if flush operation suceeded, %FALSE otherwise.</doc>
30184             <type name="gboolean" c:type="gboolean"/>
30185           </return-value>
30186           <parameters>
30187             <parameter name="stream" transfer-ownership="none">
30188               <type name="OutputStream" c:type="GOutputStream*"/>
30189             </parameter>
30190             <parameter name="result" transfer-ownership="none">
30191               <doc xml:whitespace="preserve">a GAsyncResult.</doc>
30192               <type name="AsyncResult" c:type="GAsyncResult*"/>
30193             </parameter>
30194           </parameters>
30195         </callback>
30196       </field>
30197       <field name="close_async">
30198         <callback name="close_async">
30199           <return-value transfer-ownership="none">
30200             <type name="none" c:type="void"/>
30201           </return-value>
30202           <parameters>
30203             <parameter name="stream" transfer-ownership="none">
30204               <type name="OutputStream" c:type="GOutputStream*"/>
30205             </parameter>
30206             <parameter name="io_priority" transfer-ownership="none">
30207               <doc xml:whitespace="preserve">the io priority of the request.</doc>
30208               <type name="gint" c:type="int"/>
30209             </parameter>
30210             <parameter name="cancellable"
30211                        transfer-ownership="none"
30212                        allow-none="1">
30213               <doc xml:whitespace="preserve">optional cancellable object</doc>
30214               <type name="Cancellable" c:type="GCancellable*"/>
30215             </parameter>
30216             <parameter name="callback"
30217                        transfer-ownership="none"
30218                        scope="async"
30219                        closure="4">
30220               <doc xml:whitespace="preserve">callback to call when the request is satisfied</doc>
30221               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
30222             </parameter>
30223             <parameter name="user_data" transfer-ownership="none" closure="4">
30224               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
30225               <type name="gpointer" c:type="gpointer"/>
30226             </parameter>
30227           </parameters>
30228         </callback>
30229       </field>
30230       <field name="close_finish">
30231         <callback name="close_finish" throws="1">
30232           <return-value transfer-ownership="none">
30233             <doc xml:whitespace="preserve">%TRUE if stream was successfully closed, %FALSE otherwise.</doc>
30234             <type name="gboolean" c:type="gboolean"/>
30235           </return-value>
30236           <parameters>
30237             <parameter name="stream" transfer-ownership="none">
30238               <type name="OutputStream" c:type="GOutputStream*"/>
30239             </parameter>
30240             <parameter name="result" transfer-ownership="none">
30241               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
30242               <type name="AsyncResult" c:type="GAsyncResult*"/>
30243             </parameter>
30244           </parameters>
30245         </callback>
30246       </field>
30247       <field name="_g_reserved1" introspectable="0">
30248         <callback name="_g_reserved1">
30249           <return-value transfer-ownership="none">
30250             <type name="none" c:type="void"/>
30251           </return-value>
30252         </callback>
30253       </field>
30254       <field name="_g_reserved2" introspectable="0">
30255         <callback name="_g_reserved2">
30256           <return-value transfer-ownership="none">
30257             <type name="none" c:type="void"/>
30258           </return-value>
30259         </callback>
30260       </field>
30261       <field name="_g_reserved3" introspectable="0">
30262         <callback name="_g_reserved3">
30263           <return-value transfer-ownership="none">
30264             <type name="none" c:type="void"/>
30265           </return-value>
30266         </callback>
30267       </field>
30268       <field name="_g_reserved4" introspectable="0">
30269         <callback name="_g_reserved4">
30270           <return-value transfer-ownership="none">
30271             <type name="none" c:type="void"/>
30272           </return-value>
30273         </callback>
30274       </field>
30275       <field name="_g_reserved5" introspectable="0">
30276         <callback name="_g_reserved5">
30277           <return-value transfer-ownership="none">
30278             <type name="none" c:type="void"/>
30279           </return-value>
30280         </callback>
30281       </field>
30282       <field name="_g_reserved6" introspectable="0">
30283         <callback name="_g_reserved6">
30284           <return-value transfer-ownership="none">
30285             <type name="none" c:type="void"/>
30286           </return-value>
30287         </callback>
30288       </field>
30289       <field name="_g_reserved7" introspectable="0">
30290         <callback name="_g_reserved7">
30291           <return-value transfer-ownership="none">
30292             <type name="none" c:type="void"/>
30293           </return-value>
30294         </callback>
30295       </field>
30296       <field name="_g_reserved8" introspectable="0">
30297         <callback name="_g_reserved8">
30298           <return-value transfer-ownership="none">
30299             <type name="none" c:type="void"/>
30300           </return-value>
30301         </callback>
30302       </field>
30303     </record>
30304     <record name="OutputStreamPrivate"
30305             c:type="GOutputStreamPrivate"
30306             disguised="1">
30307     </record>
30308     <bitfield name="OutputStreamSpliceFlags"
30309               glib:type-name="GOutputStreamSpliceFlags"
30310               glib:get-type="g_output_stream_splice_flags_get_type"
30311               c:type="GOutputStreamSpliceFlags">
30312       <doc xml:whitespace="preserve">GOutputStreamSpliceFlags determine how streams should be spliced.</doc>
30313       <member name="none"
30314               value="0"
30315               c:identifier="G_OUTPUT_STREAM_SPLICE_NONE"
30316               glib:nick="none"/>
30317       <member name="close_source"
30318               value="1"
30319               c:identifier="G_OUTPUT_STREAM_SPLICE_CLOSE_SOURCE"
30320               glib:nick="close-source"/>
30321       <member name="close_target"
30322               value="2"
30323               c:identifier="G_OUTPUT_STREAM_SPLICE_CLOSE_TARGET"
30324               glib:nick="close-target"/>
30325     </bitfield>
30326     <record name="OutputVector" c:type="GOutputVector" version="2.22">
30327       <doc xml:whitespace="preserve">Structure used for scatter/gather data output.
30328 You generally pass in an array of #GOutputVector&lt;!-- --&gt;s
30329 and the operation will use all the buffers as if they were
30330 one buffer.</doc>
30331       <field name="buffer" writable="1">
30332         <type name="gpointer" c:type="gconstpointer"/>
30333       </field>
30334       <field name="size" writable="1">
30335         <type name="gulong" c:type="gsize"/>
30336       </field>
30337     </record>
30338     <constant name="PROXY_EXTENSION_POINT_NAME" value="gio-proxy">
30339       <type name="utf8" c:type="gchar*"/>
30340     </constant>
30341     <constant name="PROXY_RESOLVER_EXTENSION_POINT_NAME"
30342               value="gio-proxy-resolver">
30343       <type name="utf8" c:type="gchar*"/>
30344     </constant>
30345     <enumeration name="PasswordSave"
30346                  glib:type-name="GPasswordSave"
30347                  glib:get-type="g_password_save_get_type"
30348                  c:type="GPasswordSave">
30349       <doc xml:whitespace="preserve">#GPasswordSave is used to indicate the lifespan of a saved password.
30350 #Gvfs stores passwords in the Gnome keyring when this flag allows it
30351 to, and later retrieves it again from there.</doc>
30352       <member name="never"
30353               value="0"
30354               c:identifier="G_PASSWORD_SAVE_NEVER"
30355               glib:nick="never"/>
30356       <member name="for_session"
30357               value="1"
30358               c:identifier="G_PASSWORD_SAVE_FOR_SESSION"
30359               glib:nick="for-session"/>
30360       <member name="permanently"
30361               value="2"
30362               c:identifier="G_PASSWORD_SAVE_PERMANENTLY"
30363               glib:nick="permanently"/>
30364     </enumeration>
30365     <class name="Permission"
30366            c:symbol-prefix="permission"
30367            c:type="GPermission"
30368            parent="GObject.Object"
30369            abstract="1"
30370            glib:type-name="GPermission"
30371            glib:get-type="g_permission_get_type"
30372            glib:type-struct="PermissionClass">
30373       <doc xml:whitespace="preserve">#GPermission is an opaque data structure and can only be accessed
30374 using the following functions.</doc>
30375       <virtual-method name="acquire"
30376                       invoker="acquire"
30377                       version="2.26"
30378                       throws="1">
30379         <doc xml:whitespace="preserve">Attempts to acquire the permission represented by @permission.
30380 The precise method by which this happens depends on the permission
30381 and the underlying authentication mechanism.  A simple example is
30382 that a dialog may appear asking the user to enter their password.
30383 You should check with g_permission_get_can_acquire() before calling
30384 this function.
30385 If the permission is acquired then %TRUE is returned.  Otherwise,
30386 %FALSE is returned and @error is set appropriately.
30387 This call is blocking, likely for a very long time (in the case that
30388 user interaction is required).  See g_permission_acquire_async() for
30389 the non-blocking version.</doc>
30390         <return-value transfer-ownership="none">
30391           <doc xml:whitespace="preserve">%TRUE if the permission was successfully acquired</doc>
30392           <type name="gboolean" c:type="gboolean"/>
30393         </return-value>
30394         <parameters>
30395           <parameter name="cancellable"
30396                      transfer-ownership="none"
30397                      allow-none="1">
30398             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
30399             <type name="Cancellable" c:type="GCancellable*"/>
30400           </parameter>
30401         </parameters>
30402       </virtual-method>
30403       <virtual-method name="acquire_async"
30404                       invoker="acquire_async"
30405                       version="2.26">
30406         <doc xml:whitespace="preserve">Attempts to acquire the permission represented by @permission.
30407 This is the first half of the asynchronous version of
30408 g_permission_acquire().</doc>
30409         <return-value transfer-ownership="none">
30410           <type name="none" c:type="void"/>
30411         </return-value>
30412         <parameters>
30413           <parameter name="cancellable"
30414                      transfer-ownership="none"
30415                      allow-none="1">
30416             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
30417             <type name="Cancellable" c:type="GCancellable*"/>
30418           </parameter>
30419           <parameter name="callback"
30420                      transfer-ownership="none"
30421                      scope="async"
30422                      closure="2">
30423             <doc xml:whitespace="preserve">the #GAsyncReadyCallback to call when done</doc>
30424             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
30425           </parameter>
30426           <parameter name="user_data" transfer-ownership="none" closure="2">
30427             <doc xml:whitespace="preserve">the user data to pass to @callback</doc>
30428             <type name="gpointer" c:type="gpointer"/>
30429           </parameter>
30430         </parameters>
30431       </virtual-method>
30432       <virtual-method name="acquire_finish"
30433                       invoker="acquire_finish"
30434                       version="2.26"
30435                       throws="1">
30436         <doc xml:whitespace="preserve">Collects the result of attempting to acquire the permission
30437 represented by @permission.
30438 This is the second half of the asynchronous version of
30439 g_permission_acquire().</doc>
30440         <return-value transfer-ownership="none">
30441           <doc xml:whitespace="preserve">%TRUE if the permission was successfully acquired</doc>
30442           <type name="gboolean" c:type="gboolean"/>
30443         </return-value>
30444         <parameters>
30445           <parameter name="result" transfer-ownership="none">
30446             <doc xml:whitespace="preserve">the #GAsyncResult given to the #GAsyncReadyCallback</doc>
30447             <type name="AsyncResult" c:type="GAsyncResult*"/>
30448           </parameter>
30449         </parameters>
30450       </virtual-method>
30451       <virtual-method name="release"
30452                       invoker="release"
30453                       version="2.26"
30454                       throws="1">
30455         <doc xml:whitespace="preserve">Attempts to release the permission represented by @permission.
30456 The precise method by which this happens depends on the permission
30457 and the underlying authentication mechanism.  In most cases the
30458 permission will be dropped immediately without further action.
30459 You should check with g_permission_get_can_release() before calling
30460 this function.
30461 If the permission is released then %TRUE is returned.  Otherwise,
30462 %FALSE is returned and @error is set appropriately.
30463 This call is blocking, likely for a very long time (in the case that
30464 user interaction is required).  See g_permission_release_async() for
30465 the non-blocking version.</doc>
30466         <return-value transfer-ownership="none">
30467           <doc xml:whitespace="preserve">%TRUE if the permission was successfully released</doc>
30468           <type name="gboolean" c:type="gboolean"/>
30469         </return-value>
30470         <parameters>
30471           <parameter name="cancellable"
30472                      transfer-ownership="none"
30473                      allow-none="1">
30474             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
30475             <type name="Cancellable" c:type="GCancellable*"/>
30476           </parameter>
30477         </parameters>
30478       </virtual-method>
30479       <virtual-method name="release_async"
30480                       invoker="release_async"
30481                       version="2.26">
30482         <doc xml:whitespace="preserve">Attempts to release the permission represented by @permission.
30483 This is the first half of the asynchronous version of
30484 g_permission_release().</doc>
30485         <return-value transfer-ownership="none">
30486           <type name="none" c:type="void"/>
30487         </return-value>
30488         <parameters>
30489           <parameter name="cancellable"
30490                      transfer-ownership="none"
30491                      allow-none="1">
30492             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
30493             <type name="Cancellable" c:type="GCancellable*"/>
30494           </parameter>
30495           <parameter name="callback"
30496                      transfer-ownership="none"
30497                      scope="async"
30498                      closure="2">
30499             <doc xml:whitespace="preserve">the #GAsyncReadyCallback to call when done</doc>
30500             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
30501           </parameter>
30502           <parameter name="user_data" transfer-ownership="none" closure="2">
30503             <doc xml:whitespace="preserve">the user data to pass to @callback</doc>
30504             <type name="gpointer" c:type="gpointer"/>
30505           </parameter>
30506         </parameters>
30507       </virtual-method>
30508       <virtual-method name="release_finish"
30509                       invoker="release_finish"
30510                       version="2.26"
30511                       throws="1">
30512         <doc xml:whitespace="preserve">Collects the result of attempting to release the permission
30513 represented by @permission.
30514 This is the second half of the asynchronous version of
30515 g_permission_release().</doc>
30516         <return-value transfer-ownership="none">
30517           <doc xml:whitespace="preserve">%TRUE if the permission was successfully released</doc>
30518           <type name="gboolean" c:type="gboolean"/>
30519         </return-value>
30520         <parameters>
30521           <parameter name="result" transfer-ownership="none">
30522             <doc xml:whitespace="preserve">the #GAsyncResult given to the #GAsyncReadyCallback</doc>
30523             <type name="AsyncResult" c:type="GAsyncResult*"/>
30524           </parameter>
30525         </parameters>
30526       </virtual-method>
30527       <method name="acquire"
30528               c:identifier="g_permission_acquire"
30529               version="2.26"
30530               throws="1">
30531         <doc xml:whitespace="preserve">Attempts to acquire the permission represented by @permission.
30532 The precise method by which this happens depends on the permission
30533 and the underlying authentication mechanism.  A simple example is
30534 that a dialog may appear asking the user to enter their password.
30535 You should check with g_permission_get_can_acquire() before calling
30536 this function.
30537 If the permission is acquired then %TRUE is returned.  Otherwise,
30538 %FALSE is returned and @error is set appropriately.
30539 This call is blocking, likely for a very long time (in the case that
30540 user interaction is required).  See g_permission_acquire_async() for
30541 the non-blocking version.</doc>
30542         <return-value transfer-ownership="none">
30543           <doc xml:whitespace="preserve">%TRUE if the permission was successfully acquired</doc>
30544           <type name="gboolean" c:type="gboolean"/>
30545         </return-value>
30546         <parameters>
30547           <parameter name="cancellable"
30548                      transfer-ownership="none"
30549                      allow-none="1">
30550             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
30551             <type name="Cancellable" c:type="GCancellable*"/>
30552           </parameter>
30553         </parameters>
30554       </method>
30555       <method name="acquire_async"
30556               c:identifier="g_permission_acquire_async"
30557               version="2.26">
30558         <doc xml:whitespace="preserve">Attempts to acquire the permission represented by @permission.
30559 This is the first half of the asynchronous version of
30560 g_permission_acquire().</doc>
30561         <return-value transfer-ownership="none">
30562           <type name="none" c:type="void"/>
30563         </return-value>
30564         <parameters>
30565           <parameter name="cancellable"
30566                      transfer-ownership="none"
30567                      allow-none="1">
30568             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
30569             <type name="Cancellable" c:type="GCancellable*"/>
30570           </parameter>
30571           <parameter name="callback"
30572                      transfer-ownership="none"
30573                      scope="async"
30574                      closure="2">
30575             <doc xml:whitespace="preserve">the #GAsyncReadyCallback to call when done</doc>
30576             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
30577           </parameter>
30578           <parameter name="user_data" transfer-ownership="none">
30579             <doc xml:whitespace="preserve">the user data to pass to @callback</doc>
30580             <type name="gpointer" c:type="gpointer"/>
30581           </parameter>
30582         </parameters>
30583       </method>
30584       <method name="acquire_finish"
30585               c:identifier="g_permission_acquire_finish"
30586               version="2.26"
30587               throws="1">
30588         <doc xml:whitespace="preserve">Collects the result of attempting to acquire the permission
30589 represented by @permission.
30590 This is the second half of the asynchronous version of
30591 g_permission_acquire().</doc>
30592         <return-value transfer-ownership="none">
30593           <doc xml:whitespace="preserve">%TRUE if the permission was successfully acquired</doc>
30594           <type name="gboolean" c:type="gboolean"/>
30595         </return-value>
30596         <parameters>
30597           <parameter name="result" transfer-ownership="none">
30598             <doc xml:whitespace="preserve">the #GAsyncResult given to the #GAsyncReadyCallback</doc>
30599             <type name="AsyncResult" c:type="GAsyncResult*"/>
30600           </parameter>
30601         </parameters>
30602       </method>
30603       <method name="get_allowed"
30604               c:identifier="g_permission_get_allowed"
30605               version="2.26">
30606         <doc xml:whitespace="preserve">Gets the value of the 'allowed' property.  This property is %TRUE if
30607 the caller currently has permission to perform the action that</doc>
30608         <return-value transfer-ownership="none">
30609           <doc xml:whitespace="preserve">the value of the 'allowed' property</doc>
30610           <type name="gboolean" c:type="gboolean"/>
30611         </return-value>
30612       </method>
30613       <method name="get_can_acquire"
30614               c:identifier="g_permission_get_can_acquire"
30615               version="2.26">
30616         <doc xml:whitespace="preserve">Gets the value of the 'can-acquire' property.  This property is %TRUE
30617 if it is generally possible to acquire the permission by calling
30618 g_permission_acquire().</doc>
30619         <return-value transfer-ownership="none">
30620           <doc xml:whitespace="preserve">the value of the 'can-acquire' property</doc>
30621           <type name="gboolean" c:type="gboolean"/>
30622         </return-value>
30623       </method>
30624       <method name="get_can_release"
30625               c:identifier="g_permission_get_can_release"
30626               version="2.26">
30627         <doc xml:whitespace="preserve">Gets the value of the 'can-release' property.  This property is %TRUE
30628 if it is generally possible to release the permission by calling
30629 g_permission_release().</doc>
30630         <return-value transfer-ownership="none">
30631           <doc xml:whitespace="preserve">the value of the 'can-release' property</doc>
30632           <type name="gboolean" c:type="gboolean"/>
30633         </return-value>
30634       </method>
30635       <method name="impl_update"
30636               c:identifier="g_permission_impl_update"
30637               version="2.26">
30638         <doc xml:whitespace="preserve">This function is called by the #GPermission implementation to update
30639 the properties of the permission.  You should never call this
30640 function except from a #GPermission implementation.
30641 GObject notify signals are generated, as appropriate.</doc>
30642         <return-value transfer-ownership="none">
30643           <type name="none" c:type="void"/>
30644         </return-value>
30645         <parameters>
30646           <parameter name="allowed" transfer-ownership="none">
30647             <doc xml:whitespace="preserve">the new value for the 'allowed' property</doc>
30648             <type name="gboolean" c:type="gboolean"/>
30649           </parameter>
30650           <parameter name="can_acquire" transfer-ownership="none">
30651             <doc xml:whitespace="preserve">the new value for the 'can-acquire' property</doc>
30652             <type name="gboolean" c:type="gboolean"/>
30653           </parameter>
30654           <parameter name="can_release" transfer-ownership="none">
30655             <doc xml:whitespace="preserve">the new value for the 'can-release' property</doc>
30656             <type name="gboolean" c:type="gboolean"/>
30657           </parameter>
30658         </parameters>
30659       </method>
30660       <method name="release"
30661               c:identifier="g_permission_release"
30662               version="2.26"
30663               throws="1">
30664         <doc xml:whitespace="preserve">Attempts to release the permission represented by @permission.
30665 The precise method by which this happens depends on the permission
30666 and the underlying authentication mechanism.  In most cases the
30667 permission will be dropped immediately without further action.
30668 You should check with g_permission_get_can_release() before calling
30669 this function.
30670 If the permission is released then %TRUE is returned.  Otherwise,
30671 %FALSE is returned and @error is set appropriately.
30672 This call is blocking, likely for a very long time (in the case that
30673 user interaction is required).  See g_permission_release_async() for
30674 the non-blocking version.</doc>
30675         <return-value transfer-ownership="none">
30676           <doc xml:whitespace="preserve">%TRUE if the permission was successfully released</doc>
30677           <type name="gboolean" c:type="gboolean"/>
30678         </return-value>
30679         <parameters>
30680           <parameter name="cancellable"
30681                      transfer-ownership="none"
30682                      allow-none="1">
30683             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
30684             <type name="Cancellable" c:type="GCancellable*"/>
30685           </parameter>
30686         </parameters>
30687       </method>
30688       <method name="release_async"
30689               c:identifier="g_permission_release_async"
30690               version="2.26">
30691         <doc xml:whitespace="preserve">Attempts to release the permission represented by @permission.
30692 This is the first half of the asynchronous version of
30693 g_permission_release().</doc>
30694         <return-value transfer-ownership="none">
30695           <type name="none" c:type="void"/>
30696         </return-value>
30697         <parameters>
30698           <parameter name="cancellable"
30699                      transfer-ownership="none"
30700                      allow-none="1">
30701             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
30702             <type name="Cancellable" c:type="GCancellable*"/>
30703           </parameter>
30704           <parameter name="callback"
30705                      transfer-ownership="none"
30706                      scope="async"
30707                      closure="2">
30708             <doc xml:whitespace="preserve">the #GAsyncReadyCallback to call when done</doc>
30709             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
30710           </parameter>
30711           <parameter name="user_data" transfer-ownership="none">
30712             <doc xml:whitespace="preserve">the user data to pass to @callback</doc>
30713             <type name="gpointer" c:type="gpointer"/>
30714           </parameter>
30715         </parameters>
30716       </method>
30717       <method name="release_finish"
30718               c:identifier="g_permission_release_finish"
30719               version="2.26"
30720               throws="1">
30721         <doc xml:whitespace="preserve">Collects the result of attempting to release the permission
30722 represented by @permission.
30723 This is the second half of the asynchronous version of
30724 g_permission_release().</doc>
30725         <return-value transfer-ownership="none">
30726           <doc xml:whitespace="preserve">%TRUE if the permission was successfully released</doc>
30727           <type name="gboolean" c:type="gboolean"/>
30728         </return-value>
30729         <parameters>
30730           <parameter name="result" transfer-ownership="none">
30731             <doc xml:whitespace="preserve">the #GAsyncResult given to the #GAsyncReadyCallback</doc>
30732             <type name="AsyncResult" c:type="GAsyncResult*"/>
30733           </parameter>
30734         </parameters>
30735       </method>
30736       <property name="allowed" transfer-ownership="none">
30737         <doc xml:whitespace="preserve">%TRUE if the caller currently has permission to perform the action that</doc>
30738         <type name="gboolean"/>
30739       </property>
30740       <property name="can-acquire" transfer-ownership="none">
30741         <doc xml:whitespace="preserve">%TRUE if it is generally possible to acquire the permission by calling
30742 g_permission_acquire().</doc>
30743         <type name="gboolean"/>
30744       </property>
30745       <property name="can-release" transfer-ownership="none">
30746         <doc xml:whitespace="preserve">%TRUE if it is generally possible to release the permission by calling
30747 g_permission_release().</doc>
30748         <type name="gboolean"/>
30749       </property>
30750       <field name="parent_instance">
30751         <type name="GObject.Object" c:type="GObject"/>
30752       </field>
30753       <field name="priv">
30754         <type name="PermissionPrivate" c:type="GPermissionPrivate*"/>
30755       </field>
30756     </class>
30757     <record name="PermissionClass"
30758             c:type="GPermissionClass"
30759             glib:is-gtype-struct-for="Permission">
30760       <field name="parent_class">
30761         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
30762       </field>
30763       <field name="acquire">
30764         <callback name="acquire" throws="1">
30765           <return-value transfer-ownership="none">
30766             <doc xml:whitespace="preserve">%TRUE if the permission was successfully acquired</doc>
30767             <type name="gboolean" c:type="gboolean"/>
30768           </return-value>
30769           <parameters>
30770             <parameter name="permission" transfer-ownership="none">
30771               <type name="Permission" c:type="GPermission*"/>
30772             </parameter>
30773             <parameter name="cancellable"
30774                        transfer-ownership="none"
30775                        allow-none="1">
30776               <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
30777               <type name="Cancellable" c:type="GCancellable*"/>
30778             </parameter>
30779           </parameters>
30780         </callback>
30781       </field>
30782       <field name="acquire_async">
30783         <callback name="acquire_async">
30784           <return-value transfer-ownership="none">
30785             <type name="none" c:type="void"/>
30786           </return-value>
30787           <parameters>
30788             <parameter name="permission" transfer-ownership="none">
30789               <type name="Permission" c:type="GPermission*"/>
30790             </parameter>
30791             <parameter name="cancellable"
30792                        transfer-ownership="none"
30793                        allow-none="1">
30794               <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
30795               <type name="Cancellable" c:type="GCancellable*"/>
30796             </parameter>
30797             <parameter name="callback"
30798                        transfer-ownership="none"
30799                        scope="async"
30800                        closure="3">
30801               <doc xml:whitespace="preserve">the #GAsyncReadyCallback to call when done</doc>
30802               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
30803             </parameter>
30804             <parameter name="user_data" transfer-ownership="none" closure="3">
30805               <doc xml:whitespace="preserve">the user data to pass to @callback</doc>
30806               <type name="gpointer" c:type="gpointer"/>
30807             </parameter>
30808           </parameters>
30809         </callback>
30810       </field>
30811       <field name="acquire_finish">
30812         <callback name="acquire_finish" throws="1">
30813           <return-value transfer-ownership="none">
30814             <doc xml:whitespace="preserve">%TRUE if the permission was successfully acquired</doc>
30815             <type name="gboolean" c:type="gboolean"/>
30816           </return-value>
30817           <parameters>
30818             <parameter name="permission" transfer-ownership="none">
30819               <type name="Permission" c:type="GPermission*"/>
30820             </parameter>
30821             <parameter name="result" transfer-ownership="none">
30822               <doc xml:whitespace="preserve">the #GAsyncResult given to the #GAsyncReadyCallback</doc>
30823               <type name="AsyncResult" c:type="GAsyncResult*"/>
30824             </parameter>
30825           </parameters>
30826         </callback>
30827       </field>
30828       <field name="release">
30829         <callback name="release" throws="1">
30830           <return-value transfer-ownership="none">
30831             <doc xml:whitespace="preserve">%TRUE if the permission was successfully released</doc>
30832             <type name="gboolean" c:type="gboolean"/>
30833           </return-value>
30834           <parameters>
30835             <parameter name="permission" transfer-ownership="none">
30836               <type name="Permission" c:type="GPermission*"/>
30837             </parameter>
30838             <parameter name="cancellable"
30839                        transfer-ownership="none"
30840                        allow-none="1">
30841               <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
30842               <type name="Cancellable" c:type="GCancellable*"/>
30843             </parameter>
30844           </parameters>
30845         </callback>
30846       </field>
30847       <field name="release_async">
30848         <callback name="release_async">
30849           <return-value transfer-ownership="none">
30850             <type name="none" c:type="void"/>
30851           </return-value>
30852           <parameters>
30853             <parameter name="permission" transfer-ownership="none">
30854               <type name="Permission" c:type="GPermission*"/>
30855             </parameter>
30856             <parameter name="cancellable"
30857                        transfer-ownership="none"
30858                        allow-none="1">
30859               <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
30860               <type name="Cancellable" c:type="GCancellable*"/>
30861             </parameter>
30862             <parameter name="callback"
30863                        transfer-ownership="none"
30864                        scope="async"
30865                        closure="3">
30866               <doc xml:whitespace="preserve">the #GAsyncReadyCallback to call when done</doc>
30867               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
30868             </parameter>
30869             <parameter name="user_data" transfer-ownership="none" closure="3">
30870               <doc xml:whitespace="preserve">the user data to pass to @callback</doc>
30871               <type name="gpointer" c:type="gpointer"/>
30872             </parameter>
30873           </parameters>
30874         </callback>
30875       </field>
30876       <field name="release_finish">
30877         <callback name="release_finish" throws="1">
30878           <return-value transfer-ownership="none">
30879             <doc xml:whitespace="preserve">%TRUE if the permission was successfully released</doc>
30880             <type name="gboolean" c:type="gboolean"/>
30881           </return-value>
30882           <parameters>
30883             <parameter name="permission" transfer-ownership="none">
30884               <type name="Permission" c:type="GPermission*"/>
30885             </parameter>
30886             <parameter name="result" transfer-ownership="none">
30887               <doc xml:whitespace="preserve">the #GAsyncResult given to the #GAsyncReadyCallback</doc>
30888               <type name="AsyncResult" c:type="GAsyncResult*"/>
30889             </parameter>
30890           </parameters>
30891         </callback>
30892       </field>
30893       <field name="reserved">
30894         <array zero-terminated="0" c:type="gpointer" fixed-size="16">
30895           <type name="gpointer" c:type="gpointer"/>
30896         </array>
30897       </field>
30898     </record>
30899     <record name="PermissionPrivate" c:type="GPermissionPrivate" disguised="1">
30900     </record>
30901     <interface name="Proxy"
30902                c:symbol-prefix="proxy"
30903                c:type="GProxy"
30904                version="2.26"
30905                glib:type-name="GProxy"
30906                glib:get-type="g_proxy_get_type"
30907                glib:type-struct="ProxyInterface">
30908       <doc xml:whitespace="preserve">Interface that handles proxy connection and payload.</doc>
30909       <virtual-method name="connect"
30910                       invoker="connect"
30911                       version="2.26"
30912                       throws="1">
30913         <doc xml:whitespace="preserve">Given @connection to communicate with a proxy (eg, a
30914 #GSocketConnection that is connected to the proxy server), this
30915 does the necessary handshake to connect to @proxy_address, and if
30916 required, wraps the #GIOStream to handle proxy payload.
30917 be the same as @connection, in which case a reference
30918 will be added.</doc>
30919         <return-value transfer-ownership="full">
30920           <doc xml:whitespace="preserve">a #GIOStream that will replace @connection. This might</doc>
30921           <type name="IOStream" c:type="GIOStream*"/>
30922         </return-value>
30923         <parameters>
30924           <parameter name="connection" transfer-ownership="none">
30925             <doc xml:whitespace="preserve">a #GIOStream</doc>
30926             <type name="IOStream" c:type="GIOStream*"/>
30927           </parameter>
30928           <parameter name="proxy_address" transfer-ownership="none">
30929             <doc xml:whitespace="preserve">a #GProxyAddress</doc>
30930             <type name="ProxyAddress" c:type="GProxyAddress*"/>
30931           </parameter>
30932           <parameter name="cancellable"
30933                      transfer-ownership="none"
30934                      allow-none="1">
30935             <doc xml:whitespace="preserve">a #GCancellable</doc>
30936             <type name="Cancellable" c:type="GCancellable*"/>
30937           </parameter>
30938         </parameters>
30939       </virtual-method>
30940       <virtual-method name="connect_async"
30941                       invoker="connect_async"
30942                       version="2.26">
30943         <doc xml:whitespace="preserve">Asynchronous version of g_proxy_connect().</doc>
30944         <return-value transfer-ownership="none">
30945           <type name="none" c:type="void"/>
30946         </return-value>
30947         <parameters>
30948           <parameter name="connection" transfer-ownership="none">
30949             <doc xml:whitespace="preserve">a #GIOStream</doc>
30950             <type name="IOStream" c:type="GIOStream*"/>
30951           </parameter>
30952           <parameter name="proxy_address" transfer-ownership="none">
30953             <doc xml:whitespace="preserve">a #GProxyAddress</doc>
30954             <type name="ProxyAddress" c:type="GProxyAddress*"/>
30955           </parameter>
30956           <parameter name="cancellable"
30957                      transfer-ownership="none"
30958                      allow-none="1">
30959             <doc xml:whitespace="preserve">a #GCancellable</doc>
30960             <type name="Cancellable" c:type="GCancellable*"/>
30961           </parameter>
30962           <parameter name="callback"
30963                      transfer-ownership="none"
30964                      scope="async"
30965                      closure="4">
30966             <doc xml:whitespace="preserve">a #GAsyncReadyCallback</doc>
30967             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
30968           </parameter>
30969           <parameter name="user_data" transfer-ownership="none" closure="4">
30970             <doc xml:whitespace="preserve">callback data</doc>
30971             <type name="gpointer" c:type="gpointer"/>
30972           </parameter>
30973         </parameters>
30974       </virtual-method>
30975       <virtual-method name="connect_finish"
30976                       invoker="connect_finish"
30977                       version="2.26"
30978                       throws="1">
30979         <doc xml:whitespace="preserve">See g_proxy_connect().</doc>
30980         <return-value transfer-ownership="full">
30981           <doc xml:whitespace="preserve">a #GIOStream.</doc>
30982           <type name="IOStream" c:type="GIOStream*"/>
30983         </return-value>
30984         <parameters>
30985           <parameter name="result" transfer-ownership="none">
30986             <doc xml:whitespace="preserve">a #GAsyncRetult</doc>
30987             <type name="AsyncResult" c:type="GAsyncResult*"/>
30988           </parameter>
30989         </parameters>
30990       </virtual-method>
30991       <virtual-method name="supports_hostname"
30992                       invoker="supports_hostname"
30993                       version="2.26">
30994         <doc xml:whitespace="preserve">Some proxy protocols expect to be passed a hostname, which they
30995 will resolve to an IP address themselves. Others, like SOCKS4, do
30996 not allow this. This function will return %FALSE if @proxy is
30997 implementing such a protocol. When %FALSE is returned, the caller
30998 should resolve the destination hostname first, and then pass a
30999 #GProxyAddress containing the stringified IP address to
31000 g_proxy_connect() or g_proxy_connect_async().</doc>
31001         <return-value transfer-ownership="none">
31002           <doc xml:whitespace="preserve">%TRUE if hostname resolution is supported.</doc>
31003           <type name="gboolean" c:type="gboolean"/>
31004         </return-value>
31005       </virtual-method>
31006       <method name="connect"
31007               c:identifier="g_proxy_connect"
31008               version="2.26"
31009               throws="1">
31010         <doc xml:whitespace="preserve">Given @connection to communicate with a proxy (eg, a
31011 #GSocketConnection that is connected to the proxy server), this
31012 does the necessary handshake to connect to @proxy_address, and if
31013 required, wraps the #GIOStream to handle proxy payload.
31014 be the same as @connection, in which case a reference
31015 will be added.</doc>
31016         <return-value transfer-ownership="full">
31017           <doc xml:whitespace="preserve">a #GIOStream that will replace @connection. This might</doc>
31018           <type name="IOStream" c:type="GIOStream*"/>
31019         </return-value>
31020         <parameters>
31021           <parameter name="connection" transfer-ownership="none">
31022             <doc xml:whitespace="preserve">a #GIOStream</doc>
31023             <type name="IOStream" c:type="GIOStream*"/>
31024           </parameter>
31025           <parameter name="proxy_address" transfer-ownership="none">
31026             <doc xml:whitespace="preserve">a #GProxyAddress</doc>
31027             <type name="ProxyAddress" c:type="GProxyAddress*"/>
31028           </parameter>
31029           <parameter name="cancellable"
31030                      transfer-ownership="none"
31031                      allow-none="1">
31032             <doc xml:whitespace="preserve">a #GCancellable</doc>
31033             <type name="Cancellable" c:type="GCancellable*"/>
31034           </parameter>
31035         </parameters>
31036       </method>
31037       <method name="connect_async"
31038               c:identifier="g_proxy_connect_async"
31039               version="2.26">
31040         <doc xml:whitespace="preserve">Asynchronous version of g_proxy_connect().</doc>
31041         <return-value transfer-ownership="none">
31042           <type name="none" c:type="void"/>
31043         </return-value>
31044         <parameters>
31045           <parameter name="connection" transfer-ownership="none">
31046             <doc xml:whitespace="preserve">a #GIOStream</doc>
31047             <type name="IOStream" c:type="GIOStream*"/>
31048           </parameter>
31049           <parameter name="proxy_address" transfer-ownership="none">
31050             <doc xml:whitespace="preserve">a #GProxyAddress</doc>
31051             <type name="ProxyAddress" c:type="GProxyAddress*"/>
31052           </parameter>
31053           <parameter name="cancellable"
31054                      transfer-ownership="none"
31055                      allow-none="1">
31056             <doc xml:whitespace="preserve">a #GCancellable</doc>
31057             <type name="Cancellable" c:type="GCancellable*"/>
31058           </parameter>
31059           <parameter name="callback"
31060                      transfer-ownership="none"
31061                      scope="async"
31062                      closure="4">
31063             <doc xml:whitespace="preserve">a #GAsyncReadyCallback</doc>
31064             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
31065           </parameter>
31066           <parameter name="user_data" transfer-ownership="none">
31067             <doc xml:whitespace="preserve">callback data</doc>
31068             <type name="gpointer" c:type="gpointer"/>
31069           </parameter>
31070         </parameters>
31071       </method>
31072       <method name="connect_finish"
31073               c:identifier="g_proxy_connect_finish"
31074               version="2.26"
31075               throws="1">
31076         <doc xml:whitespace="preserve">See g_proxy_connect().</doc>
31077         <return-value transfer-ownership="full">
31078           <doc xml:whitespace="preserve">a #GIOStream.</doc>
31079           <type name="IOStream" c:type="GIOStream*"/>
31080         </return-value>
31081         <parameters>
31082           <parameter name="result" transfer-ownership="none">
31083             <doc xml:whitespace="preserve">a #GAsyncRetult</doc>
31084             <type name="AsyncResult" c:type="GAsyncResult*"/>
31085           </parameter>
31086         </parameters>
31087       </method>
31088       <method name="supports_hostname"
31089               c:identifier="g_proxy_supports_hostname"
31090               version="2.26">
31091         <doc xml:whitespace="preserve">Some proxy protocols expect to be passed a hostname, which they
31092 will resolve to an IP address themselves. Others, like SOCKS4, do
31093 not allow this. This function will return %FALSE if @proxy is
31094 implementing such a protocol. When %FALSE is returned, the caller
31095 should resolve the destination hostname first, and then pass a
31096 #GProxyAddress containing the stringified IP address to
31097 g_proxy_connect() or g_proxy_connect_async().</doc>
31098         <return-value transfer-ownership="none">
31099           <doc xml:whitespace="preserve">%TRUE if hostname resolution is supported.</doc>
31100           <type name="gboolean" c:type="gboolean"/>
31101         </return-value>
31102       </method>
31103     </interface>
31104     <class name="ProxyAddress"
31105            c:symbol-prefix="proxy_address"
31106            c:type="GProxyAddress"
31107            version="2.26"
31108            parent="InetSocketAddress"
31109            glib:type-name="GProxyAddress"
31110            glib:get-type="g_proxy_address_get_type"
31111            glib:type-struct="ProxyAddressClass">
31112       <doc xml:whitespace="preserve">A #GInetSocketAddress representing a connection via a proxy server</doc>
31113       <implements name="SocketConnectable"/>
31114       <constructor name="new"
31115                    c:identifier="g_proxy_address_new"
31116                    version="2.26">
31117         <doc xml:whitespace="preserve">Creates a new #GProxyAddress for @inetaddr with @protocol that should
31118 tunnel through @dest_hostname and @dest_port.</doc>
31119         <return-value transfer-ownership="full">
31120           <doc xml:whitespace="preserve">a new #GProxyAddress</doc>
31121           <type name="SocketAddress" c:type="GSocketAddress*"/>
31122         </return-value>
31123         <parameters>
31124           <parameter name="inetaddr" transfer-ownership="none">
31125             <doc xml:whitespace="preserve">The proxy server #GInetAddress.</doc>
31126             <type name="InetAddress" c:type="GInetAddress*"/>
31127           </parameter>
31128           <parameter name="port" transfer-ownership="none">
31129             <doc xml:whitespace="preserve">The proxy server port.</doc>
31130             <type name="guint16" c:type="guint16"/>
31131           </parameter>
31132           <parameter name="protocol" transfer-ownership="none">
31133             <doc xml:whitespace="preserve">The proxy protocol to support, in lower case (e.g. socks, http).</doc>
31134             <type name="utf8" c:type="gchar*"/>
31135           </parameter>
31136           <parameter name="dest_hostname" transfer-ownership="none">
31137             <doc xml:whitespace="preserve">The destination hostname the the proxy should tunnel to.</doc>
31138             <type name="utf8" c:type="gchar*"/>
31139           </parameter>
31140           <parameter name="dest_port" transfer-ownership="none">
31141             <doc xml:whitespace="preserve">The destination port to tunnel to.</doc>
31142             <type name="guint16" c:type="guint16"/>
31143           </parameter>
31144           <parameter name="username" transfer-ownership="none">
31145             <doc xml:whitespace="preserve">The username to authenticate to the proxy server (or %NULL).</doc>
31146             <type name="utf8" c:type="gchar*"/>
31147           </parameter>
31148           <parameter name="password" transfer-ownership="none">
31149             <doc xml:whitespace="preserve">The password to authenticate to the proxy server (or %NULL).</doc>
31150             <type name="utf8" c:type="gchar*"/>
31151           </parameter>
31152         </parameters>
31153       </constructor>
31154       <method name="get_destination_hostname"
31155               c:identifier="g_proxy_address_get_destination_hostname">
31156         <return-value transfer-ownership="none">
31157           <type name="utf8" c:type="gchar*"/>
31158         </return-value>
31159       </method>
31160       <method name="get_destination_port"
31161               c:identifier="g_proxy_address_get_destination_port">
31162         <return-value transfer-ownership="none">
31163           <type name="guint16" c:type="guint16"/>
31164         </return-value>
31165       </method>
31166       <method name="get_password" c:identifier="g_proxy_address_get_password">
31167         <return-value transfer-ownership="none">
31168           <type name="utf8" c:type="gchar*"/>
31169         </return-value>
31170       </method>
31171       <method name="get_protocol"
31172               c:identifier="g_proxy_address_get_protocol"
31173               version="2.26">
31174         <doc xml:whitespace="preserve">Gets @proxy's protocol.</doc>
31175         <return-value transfer-ownership="none">
31176           <doc xml:whitespace="preserve">the @proxy's protocol</doc>
31177           <type name="utf8" c:type="gchar*"/>
31178         </return-value>
31179       </method>
31180       <method name="get_username" c:identifier="g_proxy_address_get_username">
31181         <return-value transfer-ownership="none">
31182           <type name="utf8" c:type="gchar*"/>
31183         </return-value>
31184       </method>
31185       <property name="destination-hostname"
31186                 writable="1"
31187                 construct-only="1"
31188                 transfer-ownership="none">
31189         <type name="utf8"/>
31190       </property>
31191       <property name="destination-port"
31192                 writable="1"
31193                 construct-only="1"
31194                 transfer-ownership="none">
31195         <type name="guint"/>
31196       </property>
31197       <property name="password"
31198                 writable="1"
31199                 construct-only="1"
31200                 transfer-ownership="none">
31201         <type name="utf8"/>
31202       </property>
31203       <property name="protocol"
31204                 writable="1"
31205                 construct-only="1"
31206                 transfer-ownership="none">
31207         <type name="utf8"/>
31208       </property>
31209       <property name="username"
31210                 writable="1"
31211                 construct-only="1"
31212                 transfer-ownership="none">
31213         <type name="utf8"/>
31214       </property>
31215       <field name="parent_instance">
31216         <type name="InetSocketAddress" c:type="GInetSocketAddress"/>
31217       </field>
31218       <field name="priv">
31219         <type name="ProxyAddressPrivate" c:type="GProxyAddressPrivate*"/>
31220       </field>
31221     </class>
31222     <record name="ProxyAddressClass"
31223             c:type="GProxyAddressClass"
31224             glib:is-gtype-struct-for="ProxyAddress">
31225       <field name="parent_class">
31226         <type name="InetSocketAddressClass" c:type="GInetSocketAddressClass"/>
31227       </field>
31228     </record>
31229     <class name="ProxyAddressEnumerator"
31230            c:symbol-prefix="proxy_address_enumerator"
31231            c:type="GProxyAddressEnumerator"
31232            parent="SocketAddressEnumerator"
31233            glib:type-name="GProxyAddressEnumerator"
31234            glib:get-type="g_proxy_address_enumerator_get_type"
31235            glib:type-struct="ProxyAddressEnumeratorClass">
31236       <doc xml:whitespace="preserve">A subclass of #GSocketAddressEnumerator that takes another address
31237 enumerator and wraps its results in #GProxyAddress&lt;!-- --&gt;es as
31238 directed by the default #GProxyResolver.</doc>
31239       <property name="connectable"
31240                 writable="1"
31241                 construct-only="1"
31242                 transfer-ownership="none">
31243         <type name="SocketConnectable"/>
31244       </property>
31245       <property name="uri"
31246                 writable="1"
31247                 construct-only="1"
31248                 transfer-ownership="none">
31249         <type name="utf8"/>
31250       </property>
31251       <field name="parent_instance">
31252         <type name="SocketAddressEnumerator"
31253               c:type="GSocketAddressEnumerator"/>
31254       </field>
31255       <field name="priv">
31256         <type name="ProxyAddressEnumeratorPrivate"
31257               c:type="GProxyAddressEnumeratorPrivate*"/>
31258       </field>
31259     </class>
31260     <record name="ProxyAddressEnumeratorClass"
31261             c:type="GProxyAddressEnumeratorClass"
31262             glib:is-gtype-struct-for="ProxyAddressEnumerator">
31263       <field name="parent_class">
31264         <type name="SocketAddressEnumeratorClass"
31265               c:type="GSocketAddressEnumeratorClass"/>
31266       </field>
31267       <field name="_g_reserved1" introspectable="0">
31268         <callback name="_g_reserved1">
31269           <return-value transfer-ownership="none">
31270             <type name="none" c:type="void"/>
31271           </return-value>
31272         </callback>
31273       </field>
31274       <field name="_g_reserved2" introspectable="0">
31275         <callback name="_g_reserved2">
31276           <return-value transfer-ownership="none">
31277             <type name="none" c:type="void"/>
31278           </return-value>
31279         </callback>
31280       </field>
31281       <field name="_g_reserved3" introspectable="0">
31282         <callback name="_g_reserved3">
31283           <return-value transfer-ownership="none">
31284             <type name="none" c:type="void"/>
31285           </return-value>
31286         </callback>
31287       </field>
31288       <field name="_g_reserved4" introspectable="0">
31289         <callback name="_g_reserved4">
31290           <return-value transfer-ownership="none">
31291             <type name="none" c:type="void"/>
31292           </return-value>
31293         </callback>
31294       </field>
31295       <field name="_g_reserved5" introspectable="0">
31296         <callback name="_g_reserved5">
31297           <return-value transfer-ownership="none">
31298             <type name="none" c:type="void"/>
31299           </return-value>
31300         </callback>
31301       </field>
31302       <field name="_g_reserved6" introspectable="0">
31303         <callback name="_g_reserved6">
31304           <return-value transfer-ownership="none">
31305             <type name="none" c:type="void"/>
31306           </return-value>
31307         </callback>
31308       </field>
31309       <field name="_g_reserved7" introspectable="0">
31310         <callback name="_g_reserved7">
31311           <return-value transfer-ownership="none">
31312             <type name="none" c:type="void"/>
31313           </return-value>
31314         </callback>
31315       </field>
31316     </record>
31317     <record name="ProxyAddressEnumeratorPrivate"
31318             c:type="GProxyAddressEnumeratorPrivate"
31319             disguised="1">
31320     </record>
31321     <record name="ProxyAddressPrivate"
31322             c:type="GProxyAddressPrivate"
31323             disguised="1">
31324     </record>
31325     <record name="ProxyInterface"
31326             c:type="GProxyInterface"
31327             glib:is-gtype-struct-for="Proxy"
31328             version="2.26">
31329       <doc xml:whitespace="preserve">Provides an interface for handling proxy connection and payload.</doc>
31330       <field name="g_iface">
31331         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
31332       </field>
31333       <field name="connect">
31334         <callback name="connect" throws="1">
31335           <return-value transfer-ownership="full">
31336             <doc xml:whitespace="preserve">a #GIOStream that will replace @connection. This might</doc>
31337             <type name="IOStream" c:type="GIOStream*"/>
31338           </return-value>
31339           <parameters>
31340             <parameter name="proxy" transfer-ownership="none">
31341               <type name="Proxy" c:type="GProxy*"/>
31342             </parameter>
31343             <parameter name="connection" transfer-ownership="none">
31344               <doc xml:whitespace="preserve">a #GIOStream</doc>
31345               <type name="IOStream" c:type="GIOStream*"/>
31346             </parameter>
31347             <parameter name="proxy_address" transfer-ownership="none">
31348               <doc xml:whitespace="preserve">a #GProxyAddress</doc>
31349               <type name="ProxyAddress" c:type="GProxyAddress*"/>
31350             </parameter>
31351             <parameter name="cancellable"
31352                        transfer-ownership="none"
31353                        allow-none="1">
31354               <doc xml:whitespace="preserve">a #GCancellable</doc>
31355               <type name="Cancellable" c:type="GCancellable*"/>
31356             </parameter>
31357           </parameters>
31358         </callback>
31359       </field>
31360       <field name="connect_async">
31361         <callback name="connect_async">
31362           <return-value transfer-ownership="none">
31363             <type name="none" c:type="void"/>
31364           </return-value>
31365           <parameters>
31366             <parameter name="proxy" transfer-ownership="none">
31367               <type name="Proxy" c:type="GProxy*"/>
31368             </parameter>
31369             <parameter name="connection" transfer-ownership="none">
31370               <doc xml:whitespace="preserve">a #GIOStream</doc>
31371               <type name="IOStream" c:type="GIOStream*"/>
31372             </parameter>
31373             <parameter name="proxy_address" transfer-ownership="none">
31374               <doc xml:whitespace="preserve">a #GProxyAddress</doc>
31375               <type name="ProxyAddress" c:type="GProxyAddress*"/>
31376             </parameter>
31377             <parameter name="cancellable"
31378                        transfer-ownership="none"
31379                        allow-none="1">
31380               <doc xml:whitespace="preserve">a #GCancellable</doc>
31381               <type name="Cancellable" c:type="GCancellable*"/>
31382             </parameter>
31383             <parameter name="callback"
31384                        transfer-ownership="none"
31385                        scope="async"
31386                        closure="5">
31387               <doc xml:whitespace="preserve">a #GAsyncReadyCallback</doc>
31388               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
31389             </parameter>
31390             <parameter name="user_data" transfer-ownership="none" closure="5">
31391               <doc xml:whitespace="preserve">callback data</doc>
31392               <type name="gpointer" c:type="gpointer"/>
31393             </parameter>
31394           </parameters>
31395         </callback>
31396       </field>
31397       <field name="connect_finish">
31398         <callback name="connect_finish" throws="1">
31399           <return-value transfer-ownership="full">
31400             <doc xml:whitespace="preserve">a #GIOStream.</doc>
31401             <type name="IOStream" c:type="GIOStream*"/>
31402           </return-value>
31403           <parameters>
31404             <parameter name="proxy" transfer-ownership="none">
31405               <type name="Proxy" c:type="GProxy*"/>
31406             </parameter>
31407             <parameter name="result" transfer-ownership="none">
31408               <doc xml:whitespace="preserve">a #GAsyncRetult</doc>
31409               <type name="AsyncResult" c:type="GAsyncResult*"/>
31410             </parameter>
31411           </parameters>
31412         </callback>
31413       </field>
31414       <field name="supports_hostname">
31415         <callback name="supports_hostname">
31416           <return-value transfer-ownership="none">
31417             <doc xml:whitespace="preserve">%TRUE if hostname resolution is supported.</doc>
31418             <type name="gboolean" c:type="gboolean"/>
31419           </return-value>
31420           <parameters>
31421             <parameter name="proxy" transfer-ownership="none">
31422               <type name="Proxy" c:type="GProxy*"/>
31423             </parameter>
31424           </parameters>
31425         </callback>
31426       </field>
31427     </record>
31428     <interface name="ProxyResolver"
31429                c:symbol-prefix="proxy_resolver"
31430                c:type="GProxyResolver"
31431                glib:type-name="GProxyResolver"
31432                glib:get-type="g_proxy_resolver_get_type"
31433                glib:type-struct="ProxyResolverInterface">
31434       <doc xml:whitespace="preserve">Interface that can be used to resolve proxy address.</doc>
31435       <virtual-method name="is_supported"
31436                       invoker="is_supported"
31437                       version="2.26">
31438         <doc xml:whitespace="preserve">Checks if @resolver can be used on this system. (This is used
31439 internally; g_proxy_resolver_get_default() will only return a proxy
31440 resolver that returns %TRUE for this method.)</doc>
31441         <return-value transfer-ownership="none">
31442           <doc xml:whitespace="preserve">%TRUE if @resolver is supported.</doc>
31443           <type name="gboolean" c:type="gboolean"/>
31444         </return-value>
31445       </virtual-method>
31446       <virtual-method name="lookup" invoker="lookup" version="2.26" throws="1">
31447         <doc xml:whitespace="preserve">Looks into the system proxy configuration to determine what proxy,
31448 if any, to use to connect to @uri. The returned proxy URIs are of the
31449 form &lt;literal&gt;&amp;lt;protocol&amp;gt;://[user[:password]@]host:port&lt;/literal&gt;
31450 or &lt;literal&gt;direct://&lt;/literal&gt;, where &amp;lt;protocol&amp;gt; could be
31451 http, rtsp, socks or other proxying protocol.
31452 If you don't know what network protocol is being used on the
31453 socket, you should use &lt;literal&gt;none&lt;/literal&gt; as the URI protocol.
31454 In this case, the resolver might still return a generic proxy type
31455 (such as SOCKS), but would not return protocol-specific proxy types
31456 (such as http).
31457 &lt;literal&gt;direct://&lt;/literal&gt; is used when no proxy is needed.
31458 Direct connection should not be attempted unless it is part of the
31459 returned array of proxies.
31460 g_strfreev().</doc>
31461         <return-value transfer-ownership="full">
31462           <doc xml:whitespace="preserve">A NULL-terminated array of proxy URIs. Must be freed with</doc>
31463           <array c:type="gchar**">
31464             <type name="utf8"/>
31465           </array>
31466         </return-value>
31467         <parameters>
31468           <parameter name="uri" transfer-ownership="none">
31469             <doc xml:whitespace="preserve">a URI representing the destination to connect to</doc>
31470             <type name="utf8" c:type="gchar*"/>
31471           </parameter>
31472           <parameter name="cancellable"
31473                      transfer-ownership="none"
31474                      allow-none="1">
31475             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
31476             <type name="Cancellable" c:type="GCancellable*"/>
31477           </parameter>
31478         </parameters>
31479       </virtual-method>
31480       <virtual-method name="lookup_async"
31481                       invoker="lookup_async"
31482                       version="2.26">
31483         <doc xml:whitespace="preserve">Asynchronous lookup of proxy. See g_proxy_resolver_lookup() for more
31484 details.</doc>
31485         <return-value transfer-ownership="none">
31486           <type name="none" c:type="void"/>
31487         </return-value>
31488         <parameters>
31489           <parameter name="uri" transfer-ownership="none">
31490             <doc xml:whitespace="preserve">a URI representing the destination to connect to</doc>
31491             <type name="utf8" c:type="gchar*"/>
31492           </parameter>
31493           <parameter name="cancellable"
31494                      transfer-ownership="none"
31495                      allow-none="1">
31496             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
31497             <type name="Cancellable" c:type="GCancellable*"/>
31498           </parameter>
31499           <parameter name="callback"
31500                      transfer-ownership="none"
31501                      scope="async"
31502                      closure="3">
31503             <doc xml:whitespace="preserve">callback to call after resolution completes</doc>
31504             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
31505           </parameter>
31506           <parameter name="user_data" transfer-ownership="none" closure="3">
31507             <doc xml:whitespace="preserve">data for @callback</doc>
31508             <type name="gpointer" c:type="gpointer"/>
31509           </parameter>
31510         </parameters>
31511       </virtual-method>
31512       <virtual-method name="lookup_finish"
31513                       invoker="lookup_finish"
31514                       version="2.26"
31515                       throws="1">
31516         <doc xml:whitespace="preserve">Call this function to obtain the array of proxy URIs when
31517 g_proxy_resolver_lookup_async() is complete. See
31518 g_proxy_resolver_lookup() for more details.
31519 g_strfreev().</doc>
31520         <return-value transfer-ownership="full">
31521           <doc xml:whitespace="preserve">A NULL-terminated array of proxy URIs. Must be freed with</doc>
31522           <array c:type="gchar**">
31523             <type name="utf8"/>
31524           </array>
31525         </return-value>
31526         <parameters>
31527           <parameter name="result" transfer-ownership="none">
31528             <doc xml:whitespace="preserve">the result passed to your #GAsyncReadyCallback</doc>
31529             <type name="AsyncResult" c:type="GAsyncResult*"/>
31530           </parameter>
31531         </parameters>
31532       </virtual-method>
31533       <method name="is_supported"
31534               c:identifier="g_proxy_resolver_is_supported"
31535               version="2.26">
31536         <doc xml:whitespace="preserve">Checks if @resolver can be used on this system. (This is used
31537 internally; g_proxy_resolver_get_default() will only return a proxy
31538 resolver that returns %TRUE for this method.)</doc>
31539         <return-value transfer-ownership="none">
31540           <doc xml:whitespace="preserve">%TRUE if @resolver is supported.</doc>
31541           <type name="gboolean" c:type="gboolean"/>
31542         </return-value>
31543       </method>
31544       <method name="lookup"
31545               c:identifier="g_proxy_resolver_lookup"
31546               version="2.26"
31547               throws="1">
31548         <doc xml:whitespace="preserve">Looks into the system proxy configuration to determine what proxy,
31549 if any, to use to connect to @uri. The returned proxy URIs are of the
31550 form &lt;literal&gt;&amp;lt;protocol&amp;gt;://[user[:password]@]host:port&lt;/literal&gt;
31551 or &lt;literal&gt;direct://&lt;/literal&gt;, where &amp;lt;protocol&amp;gt; could be
31552 http, rtsp, socks or other proxying protocol.
31553 If you don't know what network protocol is being used on the
31554 socket, you should use &lt;literal&gt;none&lt;/literal&gt; as the URI protocol.
31555 In this case, the resolver might still return a generic proxy type
31556 (such as SOCKS), but would not return protocol-specific proxy types
31557 (such as http).
31558 &lt;literal&gt;direct://&lt;/literal&gt; is used when no proxy is needed.
31559 Direct connection should not be attempted unless it is part of the
31560 returned array of proxies.
31561 g_strfreev().</doc>
31562         <return-value transfer-ownership="full">
31563           <doc xml:whitespace="preserve">A NULL-terminated array of proxy URIs. Must be freed with</doc>
31564           <array c:type="gchar**">
31565             <type name="utf8"/>
31566           </array>
31567         </return-value>
31568         <parameters>
31569           <parameter name="uri" transfer-ownership="none">
31570             <doc xml:whitespace="preserve">a URI representing the destination to connect to</doc>
31571             <type name="utf8" c:type="gchar*"/>
31572           </parameter>
31573           <parameter name="cancellable"
31574                      transfer-ownership="none"
31575                      allow-none="1">
31576             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
31577             <type name="Cancellable" c:type="GCancellable*"/>
31578           </parameter>
31579         </parameters>
31580       </method>
31581       <method name="lookup_async"
31582               c:identifier="g_proxy_resolver_lookup_async"
31583               version="2.26">
31584         <doc xml:whitespace="preserve">Asynchronous lookup of proxy. See g_proxy_resolver_lookup() for more
31585 details.</doc>
31586         <return-value transfer-ownership="none">
31587           <type name="none" c:type="void"/>
31588         </return-value>
31589         <parameters>
31590           <parameter name="uri" transfer-ownership="none">
31591             <doc xml:whitespace="preserve">a URI representing the destination to connect to</doc>
31592             <type name="utf8" c:type="gchar*"/>
31593           </parameter>
31594           <parameter name="cancellable"
31595                      transfer-ownership="none"
31596                      allow-none="1">
31597             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
31598             <type name="Cancellable" c:type="GCancellable*"/>
31599           </parameter>
31600           <parameter name="callback"
31601                      transfer-ownership="none"
31602                      scope="async"
31603                      closure="3">
31604             <doc xml:whitespace="preserve">callback to call after resolution completes</doc>
31605             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
31606           </parameter>
31607           <parameter name="user_data" transfer-ownership="none">
31608             <doc xml:whitespace="preserve">data for @callback</doc>
31609             <type name="gpointer" c:type="gpointer"/>
31610           </parameter>
31611         </parameters>
31612       </method>
31613       <method name="lookup_finish"
31614               c:identifier="g_proxy_resolver_lookup_finish"
31615               version="2.26"
31616               throws="1">
31617         <doc xml:whitespace="preserve">Call this function to obtain the array of proxy URIs when
31618 g_proxy_resolver_lookup_async() is complete. See
31619 g_proxy_resolver_lookup() for more details.
31620 g_strfreev().</doc>
31621         <return-value transfer-ownership="full">
31622           <doc xml:whitespace="preserve">A NULL-terminated array of proxy URIs. Must be freed with</doc>
31623           <array c:type="gchar**">
31624             <type name="utf8"/>
31625           </array>
31626         </return-value>
31627         <parameters>
31628           <parameter name="result" transfer-ownership="none">
31629             <doc xml:whitespace="preserve">the result passed to your #GAsyncReadyCallback</doc>
31630             <type name="AsyncResult" c:type="GAsyncResult*"/>
31631           </parameter>
31632         </parameters>
31633       </method>
31634     </interface>
31635     <record name="ProxyResolverInterface"
31636             c:type="GProxyResolverInterface"
31637             glib:is-gtype-struct-for="ProxyResolver">
31638       <field name="g_iface">
31639         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
31640       </field>
31641       <field name="is_supported">
31642         <callback name="is_supported">
31643           <return-value transfer-ownership="none">
31644             <doc xml:whitespace="preserve">%TRUE if @resolver is supported.</doc>
31645             <type name="gboolean" c:type="gboolean"/>
31646           </return-value>
31647           <parameters>
31648             <parameter name="resolver" transfer-ownership="none">
31649               <type name="ProxyResolver" c:type="GProxyResolver*"/>
31650             </parameter>
31651           </parameters>
31652         </callback>
31653       </field>
31654       <field name="lookup">
31655         <callback name="lookup" throws="1">
31656           <return-value transfer-ownership="full">
31657             <doc xml:whitespace="preserve">A NULL-terminated array of proxy URIs. Must be freed with</doc>
31658             <array c:type="gchar**">
31659               <type name="utf8"/>
31660             </array>
31661           </return-value>
31662           <parameters>
31663             <parameter name="resolver" transfer-ownership="none">
31664               <type name="ProxyResolver" c:type="GProxyResolver*"/>
31665             </parameter>
31666             <parameter name="uri" transfer-ownership="none">
31667               <doc xml:whitespace="preserve">a URI representing the destination to connect to</doc>
31668               <type name="utf8" c:type="gchar*"/>
31669             </parameter>
31670             <parameter name="cancellable"
31671                        transfer-ownership="none"
31672                        allow-none="1">
31673               <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
31674               <type name="Cancellable" c:type="GCancellable*"/>
31675             </parameter>
31676           </parameters>
31677         </callback>
31678       </field>
31679       <field name="lookup_async">
31680         <callback name="lookup_async">
31681           <return-value transfer-ownership="none">
31682             <type name="none" c:type="void"/>
31683           </return-value>
31684           <parameters>
31685             <parameter name="resolver" transfer-ownership="none">
31686               <type name="ProxyResolver" c:type="GProxyResolver*"/>
31687             </parameter>
31688             <parameter name="uri" transfer-ownership="none">
31689               <doc xml:whitespace="preserve">a URI representing the destination to connect to</doc>
31690               <type name="utf8" c:type="gchar*"/>
31691             </parameter>
31692             <parameter name="cancellable"
31693                        transfer-ownership="none"
31694                        allow-none="1">
31695               <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
31696               <type name="Cancellable" c:type="GCancellable*"/>
31697             </parameter>
31698             <parameter name="callback"
31699                        transfer-ownership="none"
31700                        scope="async"
31701                        closure="4">
31702               <doc xml:whitespace="preserve">callback to call after resolution completes</doc>
31703               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
31704             </parameter>
31705             <parameter name="user_data" transfer-ownership="none" closure="4">
31706               <doc xml:whitespace="preserve">data for @callback</doc>
31707               <type name="gpointer" c:type="gpointer"/>
31708             </parameter>
31709           </parameters>
31710         </callback>
31711       </field>
31712       <field name="lookup_finish">
31713         <callback name="lookup_finish" throws="1">
31714           <return-value transfer-ownership="full">
31715             <doc xml:whitespace="preserve">A NULL-terminated array of proxy URIs. Must be freed with</doc>
31716             <array c:type="gchar**">
31717               <type name="utf8"/>
31718             </array>
31719           </return-value>
31720           <parameters>
31721             <parameter name="resolver" transfer-ownership="none">
31722               <type name="ProxyResolver" c:type="GProxyResolver*"/>
31723             </parameter>
31724             <parameter name="result" transfer-ownership="none">
31725               <doc xml:whitespace="preserve">the result passed to your #GAsyncReadyCallback</doc>
31726               <type name="AsyncResult" c:type="GAsyncResult*"/>
31727             </parameter>
31728           </parameters>
31729         </callback>
31730       </field>
31731     </record>
31732     <callback name="ReallocFunc" c:type="GReallocFunc" introspectable="0">
31733       <doc xml:whitespace="preserve">Changes the size of the memory block pointed to by @data to
31734 The function should have the same semantics as realloc().</doc>
31735       <return-value>
31736         <doc xml:whitespace="preserve">a pointer to the reallocated memory</doc>
31737         <type name="gpointer" c:type="gpointer"/>
31738       </return-value>
31739       <parameters>
31740         <parameter name="data" transfer-ownership="none">
31741           <doc xml:whitespace="preserve">memory block to reallocate</doc>
31742           <type name="gpointer" c:type="gpointer"/>
31743         </parameter>
31744         <parameter name="size" transfer-ownership="none">
31745           <doc xml:whitespace="preserve">size to reallocate @data to</doc>
31746           <type name="gulong" c:type="gsize"/>
31747         </parameter>
31748       </parameters>
31749     </callback>
31750     <class name="Resolver"
31751            c:symbol-prefix="resolver"
31752            c:type="GResolver"
31753            parent="GObject.Object"
31754            glib:type-name="GResolver"
31755            glib:get-type="g_resolver_get_type"
31756            glib:type-struct="ResolverClass">
31757       <doc xml:whitespace="preserve">The object that handles DNS resolution. Use g_resolver_get_default()
31758 to get the default resolver.</doc>
31759       <function name="free_addresses"
31760                 c:identifier="g_resolver_free_addresses"
31761                 version="2.22">
31762         <doc xml:whitespace="preserve">Frees @addresses (which should be the return value from
31763 g_resolver_lookup_by_name() or g_resolver_lookup_by_name_finish()).
31764 (This is a convenience method; you can also simply free the results
31765 by hand.)</doc>
31766         <return-value transfer-ownership="none">
31767           <type name="none" c:type="void"/>
31768         </return-value>
31769         <parameters>
31770           <parameter name="addresses" transfer-ownership="none">
31771             <doc xml:whitespace="preserve">a #GList of #GInetAddress</doc>
31772             <type name="GLib.List" c:type="GList*">
31773               <type name="gpointer" c:type="gpointer"/>
31774             </type>
31775           </parameter>
31776         </parameters>
31777       </function>
31778       <function name="free_targets"
31779                 c:identifier="g_resolver_free_targets"
31780                 version="2.22">
31781         <doc xml:whitespace="preserve">Frees @targets (which should be the return value from
31782 g_resolver_lookup_service() or g_resolver_lookup_service_finish()).
31783 (This is a convenience method; you can also simply free the
31784 results by hand.)</doc>
31785         <return-value transfer-ownership="none">
31786           <type name="none" c:type="void"/>
31787         </return-value>
31788         <parameters>
31789           <parameter name="targets" transfer-ownership="none">
31790             <doc xml:whitespace="preserve">a #GList of #GSrvTarget</doc>
31791             <type name="GLib.List" c:type="GList*">
31792               <type name="gpointer" c:type="gpointer"/>
31793             </type>
31794           </parameter>
31795         </parameters>
31796       </function>
31797       <function name="get_default"
31798                 c:identifier="g_resolver_get_default"
31799                 version="2.22">
31800         <doc xml:whitespace="preserve">Gets the default #GResolver. You should unref it when you are done
31801 with it. #GResolver may use its reference count as a hint about how
31802 many threads/processes, etc it should allocate for concurrent DNS
31803 resolutions.</doc>
31804         <return-value transfer-ownership="full">
31805           <doc xml:whitespace="preserve">the default #GResolver.</doc>
31806           <type name="Resolver" c:type="GResolver*"/>
31807         </return-value>
31808       </function>
31809       <virtual-method name="lookup_by_address"
31810                       invoker="lookup_by_address"
31811                       version="2.22"
31812                       throws="1">
31813         <doc xml:whitespace="preserve">Synchronously reverse-resolves @address to determine its
31814 associated hostname.
31815 If the DNS resolution fails, @error (if non-%NULL) will be set to
31816 a value from #GResolverError.
31817 If @cancellable is non-%NULL, it can be used to cancel the
31818 operation, in which case @error (if non-%NULL) will be set to
31819 %G_IO_ERROR_CANCELLED.
31820 form), or %NULL on error.</doc>
31821         <return-value transfer-ownership="full">
31822           <doc xml:whitespace="preserve">a hostname (either ASCII-only, or in ASCII-encoded</doc>
31823           <type name="utf8" c:type="gchar*"/>
31824         </return-value>
31825         <parameters>
31826           <parameter name="address" transfer-ownership="none">
31827             <doc xml:whitespace="preserve">the address to reverse-resolve</doc>
31828             <type name="InetAddress" c:type="GInetAddress*"/>
31829           </parameter>
31830           <parameter name="cancellable"
31831                      transfer-ownership="none"
31832                      allow-none="1">
31833             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
31834             <type name="Cancellable" c:type="GCancellable*"/>
31835           </parameter>
31836         </parameters>
31837       </virtual-method>
31838       <virtual-method name="lookup_by_address_async"
31839                       invoker="lookup_by_address_async"
31840                       version="2.22">
31841         <doc xml:whitespace="preserve">Begins asynchronously reverse-resolving @address to determine its
31842 associated hostname, and eventually calls @callback, which must
31843 call g_resolver_lookup_by_address_finish() to get the final result.</doc>
31844         <return-value transfer-ownership="none">
31845           <type name="none" c:type="void"/>
31846         </return-value>
31847         <parameters>
31848           <parameter name="address" transfer-ownership="none">
31849             <doc xml:whitespace="preserve">the address to reverse-resolve</doc>
31850             <type name="InetAddress" c:type="GInetAddress*"/>
31851           </parameter>
31852           <parameter name="cancellable"
31853                      transfer-ownership="none"
31854                      allow-none="1">
31855             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
31856             <type name="Cancellable" c:type="GCancellable*"/>
31857           </parameter>
31858           <parameter name="callback"
31859                      transfer-ownership="none"
31860                      scope="async"
31861                      closure="3">
31862             <doc xml:whitespace="preserve">callback to call after resolution completes</doc>
31863             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
31864           </parameter>
31865           <parameter name="user_data" transfer-ownership="none" closure="3">
31866             <doc xml:whitespace="preserve">data for @callback</doc>
31867             <type name="gpointer" c:type="gpointer"/>
31868           </parameter>
31869         </parameters>
31870       </virtual-method>
31871       <virtual-method name="lookup_by_address_finish"
31872                       invoker="lookup_by_address_finish"
31873                       version="2.22"
31874                       throws="1">
31875         <doc xml:whitespace="preserve">Retrieves the result of a previous call to
31876 g_resolver_lookup_by_address_async().
31877 If the DNS resolution failed, @error (if non-%NULL) will be set to
31878 a value from #GResolverError. If the operation was cancelled,
31879 form), or %NULL on error.</doc>
31880         <return-value transfer-ownership="full">
31881           <doc xml:whitespace="preserve">a hostname (either ASCII-only, or in ASCII-encoded</doc>
31882           <type name="utf8" c:type="gchar*"/>
31883         </return-value>
31884         <parameters>
31885           <parameter name="result" transfer-ownership="none">
31886             <doc xml:whitespace="preserve">the result passed to your #GAsyncReadyCallback</doc>
31887             <type name="AsyncResult" c:type="GAsyncResult*"/>
31888           </parameter>
31889         </parameters>
31890       </virtual-method>
31891       <virtual-method name="lookup_by_name"
31892                       invoker="lookup_by_name"
31893                       version="2.22"
31894                       throws="1">
31895         <doc xml:whitespace="preserve">Synchronously resolves @hostname to determine its associated IP
31896 address(es). @hostname may be an ASCII-only or UTF-8 hostname, or
31897 the textual form of an IP address (in which case this just becomes
31898 a wrapper around g_inet_address_new_from_string()).
31899 On success, g_resolver_lookup_by_name() will return a #GList of
31900 #GInetAddress, sorted in order of preference. (That is, you should
31901 attempt to connect to the first address first, then the second if
31902 the first fails, etc.)
31903 If the DNS resolution fails, @error (if non-%NULL) will be set to a
31904 value from #GResolverError.
31905 If @cancellable is non-%NULL, it can be used to cancel the
31906 operation, in which case @error (if non-%NULL) will be set to
31907 %G_IO_ERROR_CANCELLED.
31908 If you are planning to connect to a socket on the resolved IP
31909 address, it may be easier to create a #GNetworkAddress and use its
31910 #GSocketConnectable interface.
31911 of #GInetAddress, or %NULL on error. You
31912 must unref each of the addresses and free the list when you are
31913 done with it. (You can use g_resolver_free_addresses() to do this.)</doc>
31914         <return-value transfer-ownership="full">
31915           <doc xml:whitespace="preserve">a #GList</doc>
31916           <type name="GLib.List" c:type="GList*">
31917             <type name="InetAddress"/>
31918           </type>
31919         </return-value>
31920         <parameters>
31921           <parameter name="hostname" transfer-ownership="none">
31922             <doc xml:whitespace="preserve">the hostname to look up</doc>
31923             <type name="utf8" c:type="gchar*"/>
31924           </parameter>
31925           <parameter name="cancellable"
31926                      transfer-ownership="none"
31927                      allow-none="1">
31928             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
31929             <type name="Cancellable" c:type="GCancellable*"/>
31930           </parameter>
31931         </parameters>
31932       </virtual-method>
31933       <virtual-method name="lookup_by_name_async"
31934                       invoker="lookup_by_name_async"
31935                       version="2.22">
31936         <doc xml:whitespace="preserve">Begins asynchronously resolving @hostname to determine its
31937 associated IP address(es), and eventually calls @callback, which
31938 must call g_resolver_lookup_by_name_finish() to get the result.
31939 See g_resolver_lookup_by_name() for more details.</doc>
31940         <return-value transfer-ownership="none">
31941           <type name="none" c:type="void"/>
31942         </return-value>
31943         <parameters>
31944           <parameter name="hostname" transfer-ownership="none">
31945             <doc xml:whitespace="preserve">the hostname to look up the address of</doc>
31946             <type name="utf8" c:type="gchar*"/>
31947           </parameter>
31948           <parameter name="cancellable"
31949                      transfer-ownership="none"
31950                      allow-none="1">
31951             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
31952             <type name="Cancellable" c:type="GCancellable*"/>
31953           </parameter>
31954           <parameter name="callback"
31955                      transfer-ownership="none"
31956                      scope="async"
31957                      closure="3">
31958             <doc xml:whitespace="preserve">callback to call after resolution completes</doc>
31959             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
31960           </parameter>
31961           <parameter name="user_data" transfer-ownership="none" closure="3">
31962             <doc xml:whitespace="preserve">data for @callback</doc>
31963             <type name="gpointer" c:type="gpointer"/>
31964           </parameter>
31965         </parameters>
31966       </virtual-method>
31967       <virtual-method name="lookup_by_name_finish"
31968                       invoker="lookup_by_name_finish"
31969                       version="2.22"
31970                       throws="1">
31971         <doc xml:whitespace="preserve">Retrieves the result of a call to
31972 g_resolver_lookup_by_name_async().
31973 If the DNS resolution failed, @error (if non-%NULL) will be set to
31974 a value from #GResolverError. If the operation was cancelled,
31975 of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name()
31976 for more details.</doc>
31977         <return-value transfer-ownership="full">
31978           <doc xml:whitespace="preserve">a #GList</doc>
31979           <type name="GLib.List" c:type="GList*">
31980             <type name="InetAddress"/>
31981           </type>
31982         </return-value>
31983         <parameters>
31984           <parameter name="result" transfer-ownership="none">
31985             <doc xml:whitespace="preserve">the result passed to your #GAsyncReadyCallback</doc>
31986             <type name="AsyncResult" c:type="GAsyncResult*"/>
31987           </parameter>
31988         </parameters>
31989       </virtual-method>
31990       <virtual-method name="lookup_service" introspectable="0" throws="1">
31991         <return-value>
31992           <type name="GLib.List" c:type="GList*">
31993             <type name="gpointer" c:type="gpointer"/>
31994           </type>
31995         </return-value>
31996         <parameters>
31997           <parameter name="rrname" transfer-ownership="none">
31998             <type name="utf8" c:type="gchar*"/>
31999           </parameter>
32000           <parameter name="cancellable" transfer-ownership="none">
32001             <type name="Cancellable" c:type="GCancellable*"/>
32002           </parameter>
32003         </parameters>
32004       </virtual-method>
32005       <virtual-method name="lookup_service_async">
32006         <return-value transfer-ownership="none">
32007           <type name="none" c:type="void"/>
32008         </return-value>
32009         <parameters>
32010           <parameter name="rrname" transfer-ownership="none">
32011             <type name="utf8" c:type="gchar*"/>
32012           </parameter>
32013           <parameter name="cancellable" transfer-ownership="none">
32014             <type name="Cancellable" c:type="GCancellable*"/>
32015           </parameter>
32016           <parameter name="callback"
32017                      transfer-ownership="none"
32018                      scope="async"
32019                      closure="3">
32020             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
32021           </parameter>
32022           <parameter name="user_data" transfer-ownership="none" closure="3">
32023             <type name="gpointer" c:type="gpointer"/>
32024           </parameter>
32025         </parameters>
32026       </virtual-method>
32027       <virtual-method name="lookup_service_finish"
32028                       invoker="lookup_service_finish"
32029                       version="2.22"
32030                       throws="1">
32031         <doc xml:whitespace="preserve">Retrieves the result of a previous call to
32032 g_resolver_lookup_service_async().
32033 If the DNS resolution failed, @error (if non-%NULL) will be set to
32034 a value from #GResolverError. If the operation was cancelled,
32035 or %NULL on error. See g_resolver_lookup_service() for more details.</doc>
32036         <return-value transfer-ownership="full">
32037           <doc xml:whitespace="preserve">a #GList of #GSrvTarget,</doc>
32038           <type name="GLib.List" c:type="GList*">
32039             <type name="SrvTarget"/>
32040           </type>
32041         </return-value>
32042         <parameters>
32043           <parameter name="result" transfer-ownership="none">
32044             <doc xml:whitespace="preserve">the result passed to your #GAsyncReadyCallback</doc>
32045             <type name="AsyncResult" c:type="GAsyncResult*"/>
32046           </parameter>
32047         </parameters>
32048       </virtual-method>
32049       <method name="lookup_by_address"
32050               c:identifier="g_resolver_lookup_by_address"
32051               version="2.22"
32052               throws="1">
32053         <doc xml:whitespace="preserve">Synchronously reverse-resolves @address to determine its
32054 associated hostname.
32055 If the DNS resolution fails, @error (if non-%NULL) will be set to
32056 a value from #GResolverError.
32057 If @cancellable is non-%NULL, it can be used to cancel the
32058 operation, in which case @error (if non-%NULL) will be set to
32059 %G_IO_ERROR_CANCELLED.
32060 form), or %NULL on error.</doc>
32061         <return-value transfer-ownership="full">
32062           <doc xml:whitespace="preserve">a hostname (either ASCII-only, or in ASCII-encoded</doc>
32063           <type name="utf8" c:type="gchar*"/>
32064         </return-value>
32065         <parameters>
32066           <parameter name="address" transfer-ownership="none">
32067             <doc xml:whitespace="preserve">the address to reverse-resolve</doc>
32068             <type name="InetAddress" c:type="GInetAddress*"/>
32069           </parameter>
32070           <parameter name="cancellable"
32071                      transfer-ownership="none"
32072                      allow-none="1">
32073             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
32074             <type name="Cancellable" c:type="GCancellable*"/>
32075           </parameter>
32076         </parameters>
32077       </method>
32078       <method name="lookup_by_address_async"
32079               c:identifier="g_resolver_lookup_by_address_async"
32080               version="2.22">
32081         <doc xml:whitespace="preserve">Begins asynchronously reverse-resolving @address to determine its
32082 associated hostname, and eventually calls @callback, which must
32083 call g_resolver_lookup_by_address_finish() to get the final result.</doc>
32084         <return-value transfer-ownership="none">
32085           <type name="none" c:type="void"/>
32086         </return-value>
32087         <parameters>
32088           <parameter name="address" transfer-ownership="none">
32089             <doc xml:whitespace="preserve">the address to reverse-resolve</doc>
32090             <type name="InetAddress" c:type="GInetAddress*"/>
32091           </parameter>
32092           <parameter name="cancellable"
32093                      transfer-ownership="none"
32094                      allow-none="1">
32095             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
32096             <type name="Cancellable" c:type="GCancellable*"/>
32097           </parameter>
32098           <parameter name="callback"
32099                      transfer-ownership="none"
32100                      scope="async"
32101                      closure="3">
32102             <doc xml:whitespace="preserve">callback to call after resolution completes</doc>
32103             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
32104           </parameter>
32105           <parameter name="user_data" transfer-ownership="none">
32106             <doc xml:whitespace="preserve">data for @callback</doc>
32107             <type name="gpointer" c:type="gpointer"/>
32108           </parameter>
32109         </parameters>
32110       </method>
32111       <method name="lookup_by_address_finish"
32112               c:identifier="g_resolver_lookup_by_address_finish"
32113               version="2.22"
32114               throws="1">
32115         <doc xml:whitespace="preserve">Retrieves the result of a previous call to
32116 g_resolver_lookup_by_address_async().
32117 If the DNS resolution failed, @error (if non-%NULL) will be set to
32118 a value from #GResolverError. If the operation was cancelled,
32119 form), or %NULL on error.</doc>
32120         <return-value transfer-ownership="full">
32121           <doc xml:whitespace="preserve">a hostname (either ASCII-only, or in ASCII-encoded</doc>
32122           <type name="utf8" c:type="gchar*"/>
32123         </return-value>
32124         <parameters>
32125           <parameter name="result" transfer-ownership="none">
32126             <doc xml:whitespace="preserve">the result passed to your #GAsyncReadyCallback</doc>
32127             <type name="AsyncResult" c:type="GAsyncResult*"/>
32128           </parameter>
32129         </parameters>
32130       </method>
32131       <method name="lookup_by_name"
32132               c:identifier="g_resolver_lookup_by_name"
32133               version="2.22"
32134               throws="1">
32135         <doc xml:whitespace="preserve">Synchronously resolves @hostname to determine its associated IP
32136 address(es). @hostname may be an ASCII-only or UTF-8 hostname, or
32137 the textual form of an IP address (in which case this just becomes
32138 a wrapper around g_inet_address_new_from_string()).
32139 On success, g_resolver_lookup_by_name() will return a #GList of
32140 #GInetAddress, sorted in order of preference. (That is, you should
32141 attempt to connect to the first address first, then the second if
32142 the first fails, etc.)
32143 If the DNS resolution fails, @error (if non-%NULL) will be set to a
32144 value from #GResolverError.
32145 If @cancellable is non-%NULL, it can be used to cancel the
32146 operation, in which case @error (if non-%NULL) will be set to
32147 %G_IO_ERROR_CANCELLED.
32148 If you are planning to connect to a socket on the resolved IP
32149 address, it may be easier to create a #GNetworkAddress and use its
32150 #GSocketConnectable interface.
32151 of #GInetAddress, or %NULL on error. You
32152 must unref each of the addresses and free the list when you are
32153 done with it. (You can use g_resolver_free_addresses() to do this.)</doc>
32154         <return-value transfer-ownership="full">
32155           <doc xml:whitespace="preserve">a #GList</doc>
32156           <type name="GLib.List" c:type="GList*">
32157             <type name="InetAddress"/>
32158           </type>
32159         </return-value>
32160         <parameters>
32161           <parameter name="hostname" transfer-ownership="none">
32162             <doc xml:whitespace="preserve">the hostname to look up</doc>
32163             <type name="utf8" c:type="gchar*"/>
32164           </parameter>
32165           <parameter name="cancellable"
32166                      transfer-ownership="none"
32167                      allow-none="1">
32168             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
32169             <type name="Cancellable" c:type="GCancellable*"/>
32170           </parameter>
32171         </parameters>
32172       </method>
32173       <method name="lookup_by_name_async"
32174               c:identifier="g_resolver_lookup_by_name_async"
32175               version="2.22">
32176         <doc xml:whitespace="preserve">Begins asynchronously resolving @hostname to determine its
32177 associated IP address(es), and eventually calls @callback, which
32178 must call g_resolver_lookup_by_name_finish() to get the result.
32179 See g_resolver_lookup_by_name() for more details.</doc>
32180         <return-value transfer-ownership="none">
32181           <type name="none" c:type="void"/>
32182         </return-value>
32183         <parameters>
32184           <parameter name="hostname" transfer-ownership="none">
32185             <doc xml:whitespace="preserve">the hostname to look up the address of</doc>
32186             <type name="utf8" c:type="gchar*"/>
32187           </parameter>
32188           <parameter name="cancellable"
32189                      transfer-ownership="none"
32190                      allow-none="1">
32191             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
32192             <type name="Cancellable" c:type="GCancellable*"/>
32193           </parameter>
32194           <parameter name="callback"
32195                      transfer-ownership="none"
32196                      scope="async"
32197                      closure="3">
32198             <doc xml:whitespace="preserve">callback to call after resolution completes</doc>
32199             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
32200           </parameter>
32201           <parameter name="user_data" transfer-ownership="none">
32202             <doc xml:whitespace="preserve">data for @callback</doc>
32203             <type name="gpointer" c:type="gpointer"/>
32204           </parameter>
32205         </parameters>
32206       </method>
32207       <method name="lookup_by_name_finish"
32208               c:identifier="g_resolver_lookup_by_name_finish"
32209               version="2.22"
32210               throws="1">
32211         <doc xml:whitespace="preserve">Retrieves the result of a call to
32212 g_resolver_lookup_by_name_async().
32213 If the DNS resolution failed, @error (if non-%NULL) will be set to
32214 a value from #GResolverError. If the operation was cancelled,
32215 of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name()
32216 for more details.</doc>
32217         <return-value transfer-ownership="full">
32218           <doc xml:whitespace="preserve">a #GList</doc>
32219           <type name="GLib.List" c:type="GList*">
32220             <type name="InetAddress"/>
32221           </type>
32222         </return-value>
32223         <parameters>
32224           <parameter name="result" transfer-ownership="none">
32225             <doc xml:whitespace="preserve">the result passed to your #GAsyncReadyCallback</doc>
32226             <type name="AsyncResult" c:type="GAsyncResult*"/>
32227           </parameter>
32228         </parameters>
32229       </method>
32230       <method name="lookup_service"
32231               c:identifier="g_resolver_lookup_service"
32232               version="2.22"
32233               throws="1">
32234         <doc xml:whitespace="preserve">Synchronously performs a DNS SRV lookup for the given @service and
32235 include the leading underscore that appears in the actual DNS
32236 entry.
32237 On success, g_resolver_lookup_service() will return a #GList of
32238 #GSrvTarget, sorted in order of preference. (That is, you should
32239 attempt to connect to the first target first, then the second if
32240 the first fails, etc.)
32241 If the DNS resolution fails, @error (if non-%NULL) will be set to
32242 a value from #GResolverError.
32243 If @cancellable is non-%NULL, it can be used to cancel the
32244 operation, in which case @error (if non-%NULL) will be set to
32245 %G_IO_ERROR_CANCELLED.
32246 If you are planning to connect to the service, it is usually easier
32247 to create a #GNetworkService and use its #GSocketConnectable
32248 interface.
32249 or %NULL on error. You must free each of the targets and the list when you are
32250 done with it. (You can use g_resolver_free_targets() to do this.)</doc>
32251         <return-value transfer-ownership="full">
32252           <doc xml:whitespace="preserve">a #GList of #GSrvTarget,</doc>
32253           <type name="GLib.List" c:type="GList*">
32254             <type name="SrvTarget"/>
32255           </type>
32256         </return-value>
32257         <parameters>
32258           <parameter name="service" transfer-ownership="none">
32259             <doc xml:whitespace="preserve">the service type to look up (eg, "ldap")</doc>
32260             <type name="utf8" c:type="gchar*"/>
32261           </parameter>
32262           <parameter name="protocol" transfer-ownership="none">
32263             <doc xml:whitespace="preserve">the networking protocol to use for @service (eg, "tcp")</doc>
32264             <type name="utf8" c:type="gchar*"/>
32265           </parameter>
32266           <parameter name="domain" transfer-ownership="none">
32267             <doc xml:whitespace="preserve">the DNS domain to look up the service in</doc>
32268             <type name="utf8" c:type="gchar*"/>
32269           </parameter>
32270           <parameter name="cancellable"
32271                      transfer-ownership="none"
32272                      allow-none="1">
32273             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
32274             <type name="Cancellable" c:type="GCancellable*"/>
32275           </parameter>
32276         </parameters>
32277       </method>
32278       <method name="lookup_service_async"
32279               c:identifier="g_resolver_lookup_service_async"
32280               version="2.22">
32281         <doc xml:whitespace="preserve">Begins asynchronously performing a DNS SRV lookup for the given
32282 get the final result. See g_resolver_lookup_service() for more
32283 details.</doc>
32284         <return-value transfer-ownership="none">
32285           <type name="none" c:type="void"/>
32286         </return-value>
32287         <parameters>
32288           <parameter name="service" transfer-ownership="none">
32289             <doc xml:whitespace="preserve">the service type to look up (eg, "ldap")</doc>
32290             <type name="utf8" c:type="gchar*"/>
32291           </parameter>
32292           <parameter name="protocol" transfer-ownership="none">
32293             <doc xml:whitespace="preserve">the networking protocol to use for @service (eg, "tcp")</doc>
32294             <type name="utf8" c:type="gchar*"/>
32295           </parameter>
32296           <parameter name="domain" transfer-ownership="none">
32297             <doc xml:whitespace="preserve">the DNS domain to look up the service in</doc>
32298             <type name="utf8" c:type="gchar*"/>
32299           </parameter>
32300           <parameter name="cancellable"
32301                      transfer-ownership="none"
32302                      allow-none="1">
32303             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
32304             <type name="Cancellable" c:type="GCancellable*"/>
32305           </parameter>
32306           <parameter name="callback"
32307                      transfer-ownership="none"
32308                      scope="async"
32309                      closure="5">
32310             <doc xml:whitespace="preserve">callback to call after resolution completes</doc>
32311             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
32312           </parameter>
32313           <parameter name="user_data" transfer-ownership="none">
32314             <doc xml:whitespace="preserve">data for @callback</doc>
32315             <type name="gpointer" c:type="gpointer"/>
32316           </parameter>
32317         </parameters>
32318       </method>
32319       <method name="lookup_service_finish"
32320               c:identifier="g_resolver_lookup_service_finish"
32321               version="2.22"
32322               throws="1">
32323         <doc xml:whitespace="preserve">Retrieves the result of a previous call to
32324 g_resolver_lookup_service_async().
32325 If the DNS resolution failed, @error (if non-%NULL) will be set to
32326 a value from #GResolverError. If the operation was cancelled,
32327 or %NULL on error. See g_resolver_lookup_service() for more details.</doc>
32328         <return-value transfer-ownership="full">
32329           <doc xml:whitespace="preserve">a #GList of #GSrvTarget,</doc>
32330           <type name="GLib.List" c:type="GList*">
32331             <type name="SrvTarget"/>
32332           </type>
32333         </return-value>
32334         <parameters>
32335           <parameter name="result" transfer-ownership="none">
32336             <doc xml:whitespace="preserve">the result passed to your #GAsyncReadyCallback</doc>
32337             <type name="AsyncResult" c:type="GAsyncResult*"/>
32338           </parameter>
32339         </parameters>
32340       </method>
32341       <method name="set_default"
32342               c:identifier="g_resolver_set_default"
32343               version="2.22">
32344         <doc xml:whitespace="preserve">Sets @resolver to be the application's default resolver (reffing
32345 Future calls to g_resolver_get_default() will return this resolver.
32346 This can be used if an application wants to perform any sort of DNS
32347 caching or "pinning"; it can implement its own #GResolver that
32348 calls the original default resolver for DNS operations, and
32349 implements its own cache policies on top of that, and then set
32350 itself as the default resolver for all later code to use.</doc>
32351         <return-value transfer-ownership="none">
32352           <type name="none" c:type="void"/>
32353         </return-value>
32354       </method>
32355       <field name="parent_instance">
32356         <type name="GObject.Object" c:type="GObject"/>
32357       </field>
32358       <field name="priv">
32359         <type name="ResolverPrivate" c:type="GResolverPrivate*"/>
32360       </field>
32361       <glib:signal name="reload">
32362         <doc xml:whitespace="preserve">Emitted when the resolver notices that the system resolver
32363 configuration has changed.</doc>
32364         <return-value transfer-ownership="none">
32365           <type name="none"/>
32366         </return-value>
32367       </glib:signal>
32368     </class>
32369     <record name="ResolverClass"
32370             c:type="GResolverClass"
32371             glib:is-gtype-struct-for="Resolver">
32372       <field name="parent_class">
32373         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
32374       </field>
32375       <field name="reload">
32376         <callback name="reload">
32377           <return-value transfer-ownership="none">
32378             <type name="none" c:type="void"/>
32379           </return-value>
32380           <parameters>
32381             <parameter name="resolver" transfer-ownership="none">
32382               <type name="Resolver" c:type="GResolver*"/>
32383             </parameter>
32384           </parameters>
32385         </callback>
32386       </field>
32387       <field name="lookup_by_name">
32388         <callback name="lookup_by_name" throws="1">
32389           <return-value transfer-ownership="full">
32390             <doc xml:whitespace="preserve">a #GList</doc>
32391             <type name="GLib.List" c:type="GList*">
32392               <type name="InetAddress"/>
32393             </type>
32394           </return-value>
32395           <parameters>
32396             <parameter name="resolver" transfer-ownership="none">
32397               <type name="Resolver" c:type="GResolver*"/>
32398             </parameter>
32399             <parameter name="hostname" transfer-ownership="none">
32400               <doc xml:whitespace="preserve">the hostname to look up</doc>
32401               <type name="utf8" c:type="gchar*"/>
32402             </parameter>
32403             <parameter name="cancellable"
32404                        transfer-ownership="none"
32405                        allow-none="1">
32406               <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
32407               <type name="Cancellable" c:type="GCancellable*"/>
32408             </parameter>
32409           </parameters>
32410         </callback>
32411       </field>
32412       <field name="lookup_by_name_async">
32413         <callback name="lookup_by_name_async">
32414           <return-value transfer-ownership="none">
32415             <type name="none" c:type="void"/>
32416           </return-value>
32417           <parameters>
32418             <parameter name="resolver" transfer-ownership="none">
32419               <type name="Resolver" c:type="GResolver*"/>
32420             </parameter>
32421             <parameter name="hostname" transfer-ownership="none">
32422               <doc xml:whitespace="preserve">the hostname to look up the address of</doc>
32423               <type name="utf8" c:type="gchar*"/>
32424             </parameter>
32425             <parameter name="cancellable"
32426                        transfer-ownership="none"
32427                        allow-none="1">
32428               <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
32429               <type name="Cancellable" c:type="GCancellable*"/>
32430             </parameter>
32431             <parameter name="callback"
32432                        transfer-ownership="none"
32433                        scope="async"
32434                        closure="4">
32435               <doc xml:whitespace="preserve">callback to call after resolution completes</doc>
32436               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
32437             </parameter>
32438             <parameter name="user_data" transfer-ownership="none" closure="4">
32439               <doc xml:whitespace="preserve">data for @callback</doc>
32440               <type name="gpointer" c:type="gpointer"/>
32441             </parameter>
32442           </parameters>
32443         </callback>
32444       </field>
32445       <field name="lookup_by_name_finish">
32446         <callback name="lookup_by_name_finish" throws="1">
32447           <return-value transfer-ownership="full">
32448             <doc xml:whitespace="preserve">a #GList</doc>
32449             <type name="GLib.List" c:type="GList*">
32450               <type name="InetAddress"/>
32451             </type>
32452           </return-value>
32453           <parameters>
32454             <parameter name="resolver" transfer-ownership="none">
32455               <type name="Resolver" c:type="GResolver*"/>
32456             </parameter>
32457             <parameter name="result" transfer-ownership="none">
32458               <doc xml:whitespace="preserve">the result passed to your #GAsyncReadyCallback</doc>
32459               <type name="AsyncResult" c:type="GAsyncResult*"/>
32460             </parameter>
32461           </parameters>
32462         </callback>
32463       </field>
32464       <field name="lookup_by_address">
32465         <callback name="lookup_by_address" throws="1">
32466           <return-value transfer-ownership="full">
32467             <doc xml:whitespace="preserve">a hostname (either ASCII-only, or in ASCII-encoded</doc>
32468             <type name="utf8" c:type="gchar*"/>
32469           </return-value>
32470           <parameters>
32471             <parameter name="resolver" transfer-ownership="none">
32472               <type name="Resolver" c:type="GResolver*"/>
32473             </parameter>
32474             <parameter name="address" transfer-ownership="none">
32475               <doc xml:whitespace="preserve">the address to reverse-resolve</doc>
32476               <type name="InetAddress" c:type="GInetAddress*"/>
32477             </parameter>
32478             <parameter name="cancellable"
32479                        transfer-ownership="none"
32480                        allow-none="1">
32481               <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
32482               <type name="Cancellable" c:type="GCancellable*"/>
32483             </parameter>
32484           </parameters>
32485         </callback>
32486       </field>
32487       <field name="lookup_by_address_async">
32488         <callback name="lookup_by_address_async">
32489           <return-value transfer-ownership="none">
32490             <type name="none" c:type="void"/>
32491           </return-value>
32492           <parameters>
32493             <parameter name="resolver" transfer-ownership="none">
32494               <type name="Resolver" c:type="GResolver*"/>
32495             </parameter>
32496             <parameter name="address" transfer-ownership="none">
32497               <doc xml:whitespace="preserve">the address to reverse-resolve</doc>
32498               <type name="InetAddress" c:type="GInetAddress*"/>
32499             </parameter>
32500             <parameter name="cancellable"
32501                        transfer-ownership="none"
32502                        allow-none="1">
32503               <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
32504               <type name="Cancellable" c:type="GCancellable*"/>
32505             </parameter>
32506             <parameter name="callback"
32507                        transfer-ownership="none"
32508                        scope="async"
32509                        closure="4">
32510               <doc xml:whitespace="preserve">callback to call after resolution completes</doc>
32511               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
32512             </parameter>
32513             <parameter name="user_data" transfer-ownership="none" closure="4">
32514               <doc xml:whitespace="preserve">data for @callback</doc>
32515               <type name="gpointer" c:type="gpointer"/>
32516             </parameter>
32517           </parameters>
32518         </callback>
32519       </field>
32520       <field name="lookup_by_address_finish">
32521         <callback name="lookup_by_address_finish" throws="1">
32522           <return-value transfer-ownership="full">
32523             <doc xml:whitespace="preserve">a hostname (either ASCII-only, or in ASCII-encoded</doc>
32524             <type name="utf8" c:type="gchar*"/>
32525           </return-value>
32526           <parameters>
32527             <parameter name="resolver" transfer-ownership="none">
32528               <type name="Resolver" c:type="GResolver*"/>
32529             </parameter>
32530             <parameter name="result" transfer-ownership="none">
32531               <doc xml:whitespace="preserve">the result passed to your #GAsyncReadyCallback</doc>
32532               <type name="AsyncResult" c:type="GAsyncResult*"/>
32533             </parameter>
32534           </parameters>
32535         </callback>
32536       </field>
32537       <field name="lookup_service" introspectable="0">
32538         <callback name="lookup_service" introspectable="0" throws="1">
32539           <return-value>
32540             <type name="GLib.List" c:type="GList*">
32541               <type name="gpointer" c:type="gpointer"/>
32542             </type>
32543           </return-value>
32544           <parameters>
32545             <parameter name="resolver" transfer-ownership="none">
32546               <type name="Resolver" c:type="GResolver*"/>
32547             </parameter>
32548             <parameter name="rrname" transfer-ownership="none">
32549               <type name="utf8" c:type="gchar*"/>
32550             </parameter>
32551             <parameter name="cancellable" transfer-ownership="none">
32552               <type name="Cancellable" c:type="GCancellable*"/>
32553             </parameter>
32554           </parameters>
32555         </callback>
32556       </field>
32557       <field name="lookup_service_async">
32558         <callback name="lookup_service_async">
32559           <return-value transfer-ownership="none">
32560             <type name="none" c:type="void"/>
32561           </return-value>
32562           <parameters>
32563             <parameter name="resolver" transfer-ownership="none">
32564               <type name="Resolver" c:type="GResolver*"/>
32565             </parameter>
32566             <parameter name="rrname" transfer-ownership="none">
32567               <type name="utf8" c:type="gchar*"/>
32568             </parameter>
32569             <parameter name="cancellable" transfer-ownership="none">
32570               <type name="Cancellable" c:type="GCancellable*"/>
32571             </parameter>
32572             <parameter name="callback"
32573                        transfer-ownership="none"
32574                        scope="async"
32575                        closure="4">
32576               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
32577             </parameter>
32578             <parameter name="user_data" transfer-ownership="none" closure="4">
32579               <type name="gpointer" c:type="gpointer"/>
32580             </parameter>
32581           </parameters>
32582         </callback>
32583       </field>
32584       <field name="lookup_service_finish">
32585         <callback name="lookup_service_finish" throws="1">
32586           <return-value transfer-ownership="full">
32587             <doc xml:whitespace="preserve">a #GList of #GSrvTarget,</doc>
32588             <type name="GLib.List" c:type="GList*">
32589               <type name="SrvTarget"/>
32590             </type>
32591           </return-value>
32592           <parameters>
32593             <parameter name="resolver" transfer-ownership="none">
32594               <type name="Resolver" c:type="GResolver*"/>
32595             </parameter>
32596             <parameter name="result" transfer-ownership="none">
32597               <doc xml:whitespace="preserve">the result passed to your #GAsyncReadyCallback</doc>
32598               <type name="AsyncResult" c:type="GAsyncResult*"/>
32599             </parameter>
32600           </parameters>
32601         </callback>
32602       </field>
32603       <field name="_g_reserved1" introspectable="0">
32604         <callback name="_g_reserved1">
32605           <return-value transfer-ownership="none">
32606             <type name="none" c:type="void"/>
32607           </return-value>
32608         </callback>
32609       </field>
32610       <field name="_g_reserved2" introspectable="0">
32611         <callback name="_g_reserved2">
32612           <return-value transfer-ownership="none">
32613             <type name="none" c:type="void"/>
32614           </return-value>
32615         </callback>
32616       </field>
32617       <field name="_g_reserved3" introspectable="0">
32618         <callback name="_g_reserved3">
32619           <return-value transfer-ownership="none">
32620             <type name="none" c:type="void"/>
32621           </return-value>
32622         </callback>
32623       </field>
32624       <field name="_g_reserved4" introspectable="0">
32625         <callback name="_g_reserved4">
32626           <return-value transfer-ownership="none">
32627             <type name="none" c:type="void"/>
32628           </return-value>
32629         </callback>
32630       </field>
32631       <field name="_g_reserved5" introspectable="0">
32632         <callback name="_g_reserved5">
32633           <return-value transfer-ownership="none">
32634             <type name="none" c:type="void"/>
32635           </return-value>
32636         </callback>
32637       </field>
32638       <field name="_g_reserved6" introspectable="0">
32639         <callback name="_g_reserved6">
32640           <return-value transfer-ownership="none">
32641             <type name="none" c:type="void"/>
32642           </return-value>
32643         </callback>
32644       </field>
32645     </record>
32646     <enumeration name="ResolverError"
32647                  version="2.22"
32648                  glib:type-name="GResolverError"
32649                  glib:get-type="g_resolver_error_get_type"
32650                  c:type="GResolverError"
32651                  glib:error-quark="g_resolver_error_quark">
32652       <doc xml:whitespace="preserve">An error code used with %G_RESOLVER_ERROR in a #GError returned
32653 from a #GResolver routine.</doc>
32654       <member name="not_found"
32655               value="0"
32656               c:identifier="G_RESOLVER_ERROR_NOT_FOUND"
32657               glib:nick="not-found"/>
32658       <member name="temporary_failure"
32659               value="1"
32660               c:identifier="G_RESOLVER_ERROR_TEMPORARY_FAILURE"
32661               glib:nick="temporary-failure"/>
32662       <member name="internal"
32663               value="2"
32664               c:identifier="G_RESOLVER_ERROR_INTERNAL"
32665               glib:nick="internal"/>
32666     </enumeration>
32667     <record name="ResolverPrivate" c:type="GResolverPrivate" disguised="1">
32668     </record>
32669     <constant name="SETTINGS_BACKEND_EXTENSION_POINT_NAME"
32670               value="gsettings-backend">
32671       <type name="utf8" c:type="gchar*"/>
32672     </constant>
32673     <interface name="Seekable"
32674                c:symbol-prefix="seekable"
32675                c:type="GSeekable"
32676                glib:type-name="GSeekable"
32677                glib:get-type="g_seekable_get_type"
32678                glib:type-struct="SeekableIface">
32679       <doc xml:whitespace="preserve">Seek object for streaming operations.</doc>
32680       <virtual-method name="can_seek" invoker="can_seek">
32681         <doc xml:whitespace="preserve">Tests if the stream supports the #GSeekableIface.</doc>
32682         <return-value transfer-ownership="none">
32683           <doc xml:whitespace="preserve">%TRUE if @seekable can be seeked. %FALSE otherwise.</doc>
32684           <type name="gboolean" c:type="gboolean"/>
32685         </return-value>
32686       </virtual-method>
32687       <virtual-method name="can_truncate" invoker="can_truncate">
32688         <doc xml:whitespace="preserve">Tests if the stream can be truncated.</doc>
32689         <return-value transfer-ownership="none">
32690           <doc xml:whitespace="preserve">%TRUE if the stream can be truncated, %FALSE otherwise.</doc>
32691           <type name="gboolean" c:type="gboolean"/>
32692         </return-value>
32693       </virtual-method>
32694       <virtual-method name="seek" invoker="seek" throws="1">
32695         <doc xml:whitespace="preserve">Seeks in the stream by the given @offset, modified by @type.
32696 If @cancellable is not %NULL, then the operation can be cancelled by
32697 triggering the cancellable object from another thread. If the operation
32698 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
32699 has occurred, this function will return %FALSE and set @error
32700 appropriately if present.</doc>
32701         <return-value transfer-ownership="none">
32702           <doc xml:whitespace="preserve">%TRUE if successful. If an error</doc>
32703           <type name="gboolean" c:type="gboolean"/>
32704         </return-value>
32705         <parameters>
32706           <parameter name="offset" transfer-ownership="none">
32707             <doc xml:whitespace="preserve">a #goffset.</doc>
32708             <type name="gint64" c:type="goffset"/>
32709           </parameter>
32710           <parameter name="type" transfer-ownership="none">
32711             <doc xml:whitespace="preserve">a #GSeekType.</doc>
32712             <type name="GLib.SeekType" c:type="GSeekType"/>
32713           </parameter>
32714           <parameter name="cancellable"
32715                      transfer-ownership="none"
32716                      allow-none="1">
32717             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
32718             <type name="Cancellable" c:type="GCancellable*"/>
32719           </parameter>
32720         </parameters>
32721       </virtual-method>
32722       <virtual-method name="tell" invoker="tell">
32723         <doc xml:whitespace="preserve">Tells the current position within the stream.</doc>
32724         <return-value transfer-ownership="none">
32725           <doc xml:whitespace="preserve">the offset from the beginning of the buffer.</doc>
32726           <type name="gint64" c:type="goffset"/>
32727         </return-value>
32728       </virtual-method>
32729       <virtual-method name="truncate_fn" invoker="truncate" throws="1">
32730         <doc xml:whitespace="preserve">Truncates a stream with a given #offset.
32731 If @cancellable is not %NULL, then the operation can be cancelled by
32732 triggering the cancellable object from another thread. If the operation
32733 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
32734 operation was partially finished when the operation was cancelled the
32735 partial result will be returned, without an error.
32736 has occurred, this function will return %FALSE and set @error
32737 appropriately if present.</doc>
32738         <return-value transfer-ownership="none">
32739           <doc xml:whitespace="preserve">%TRUE if successful. If an error</doc>
32740           <type name="gboolean" c:type="gboolean"/>
32741         </return-value>
32742         <parameters>
32743           <parameter name="offset" transfer-ownership="none">
32744             <doc xml:whitespace="preserve">a #goffset.</doc>
32745             <type name="gint64" c:type="goffset"/>
32746           </parameter>
32747           <parameter name="cancellable"
32748                      transfer-ownership="none"
32749                      allow-none="1">
32750             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
32751             <type name="Cancellable" c:type="GCancellable*"/>
32752           </parameter>
32753         </parameters>
32754       </virtual-method>
32755       <method name="can_seek" c:identifier="g_seekable_can_seek">
32756         <doc xml:whitespace="preserve">Tests if the stream supports the #GSeekableIface.</doc>
32757         <return-value transfer-ownership="none">
32758           <doc xml:whitespace="preserve">%TRUE if @seekable can be seeked. %FALSE otherwise.</doc>
32759           <type name="gboolean" c:type="gboolean"/>
32760         </return-value>
32761       </method>
32762       <method name="can_truncate" c:identifier="g_seekable_can_truncate">
32763         <doc xml:whitespace="preserve">Tests if the stream can be truncated.</doc>
32764         <return-value transfer-ownership="none">
32765           <doc xml:whitespace="preserve">%TRUE if the stream can be truncated, %FALSE otherwise.</doc>
32766           <type name="gboolean" c:type="gboolean"/>
32767         </return-value>
32768       </method>
32769       <method name="seek" c:identifier="g_seekable_seek" throws="1">
32770         <doc xml:whitespace="preserve">Seeks in the stream by the given @offset, modified by @type.
32771 If @cancellable is not %NULL, then the operation can be cancelled by
32772 triggering the cancellable object from another thread. If the operation
32773 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
32774 has occurred, this function will return %FALSE and set @error
32775 appropriately if present.</doc>
32776         <return-value transfer-ownership="none">
32777           <doc xml:whitespace="preserve">%TRUE if successful. If an error</doc>
32778           <type name="gboolean" c:type="gboolean"/>
32779         </return-value>
32780         <parameters>
32781           <parameter name="offset" transfer-ownership="none">
32782             <doc xml:whitespace="preserve">a #goffset.</doc>
32783             <type name="gint64" c:type="goffset"/>
32784           </parameter>
32785           <parameter name="type" transfer-ownership="none">
32786             <doc xml:whitespace="preserve">a #GSeekType.</doc>
32787             <type name="GLib.SeekType" c:type="GSeekType"/>
32788           </parameter>
32789           <parameter name="cancellable"
32790                      transfer-ownership="none"
32791                      allow-none="1">
32792             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
32793             <type name="Cancellable" c:type="GCancellable*"/>
32794           </parameter>
32795         </parameters>
32796       </method>
32797       <method name="tell" c:identifier="g_seekable_tell">
32798         <doc xml:whitespace="preserve">Tells the current position within the stream.</doc>
32799         <return-value transfer-ownership="none">
32800           <doc xml:whitespace="preserve">the offset from the beginning of the buffer.</doc>
32801           <type name="gint64" c:type="goffset"/>
32802         </return-value>
32803       </method>
32804       <method name="truncate" c:identifier="g_seekable_truncate" throws="1">
32805         <doc xml:whitespace="preserve">Truncates a stream with a given #offset.
32806 If @cancellable is not %NULL, then the operation can be cancelled by
32807 triggering the cancellable object from another thread. If the operation
32808 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
32809 operation was partially finished when the operation was cancelled the
32810 partial result will be returned, without an error.
32811 has occurred, this function will return %FALSE and set @error
32812 appropriately if present.</doc>
32813         <return-value transfer-ownership="none">
32814           <doc xml:whitespace="preserve">%TRUE if successful. If an error</doc>
32815           <type name="gboolean" c:type="gboolean"/>
32816         </return-value>
32817         <parameters>
32818           <parameter name="offset" transfer-ownership="none">
32819             <doc xml:whitespace="preserve">a #goffset.</doc>
32820             <type name="gint64" c:type="goffset"/>
32821           </parameter>
32822           <parameter name="cancellable"
32823                      transfer-ownership="none"
32824                      allow-none="1">
32825             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
32826             <type name="Cancellable" c:type="GCancellable*"/>
32827           </parameter>
32828         </parameters>
32829       </method>
32830     </interface>
32831     <record name="SeekableIface"
32832             c:type="GSeekableIface"
32833             glib:is-gtype-struct-for="Seekable">
32834       <doc xml:whitespace="preserve">Provides an interface for implementing seekable functionality on I/O Streams.</doc>
32835       <field name="g_iface">
32836         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
32837       </field>
32838       <field name="tell">
32839         <callback name="tell">
32840           <return-value transfer-ownership="none">
32841             <doc xml:whitespace="preserve">the offset from the beginning of the buffer.</doc>
32842             <type name="gint64" c:type="goffset"/>
32843           </return-value>
32844           <parameters>
32845             <parameter name="seekable" transfer-ownership="none">
32846               <type name="Seekable" c:type="GSeekable*"/>
32847             </parameter>
32848           </parameters>
32849         </callback>
32850       </field>
32851       <field name="can_seek">
32852         <callback name="can_seek">
32853           <return-value transfer-ownership="none">
32854             <doc xml:whitespace="preserve">%TRUE if @seekable can be seeked. %FALSE otherwise.</doc>
32855             <type name="gboolean" c:type="gboolean"/>
32856           </return-value>
32857           <parameters>
32858             <parameter name="seekable" transfer-ownership="none">
32859               <type name="Seekable" c:type="GSeekable*"/>
32860             </parameter>
32861           </parameters>
32862         </callback>
32863       </field>
32864       <field name="seek">
32865         <callback name="seek" throws="1">
32866           <return-value transfer-ownership="none">
32867             <doc xml:whitespace="preserve">%TRUE if successful. If an error</doc>
32868             <type name="gboolean" c:type="gboolean"/>
32869           </return-value>
32870           <parameters>
32871             <parameter name="seekable" transfer-ownership="none">
32872               <type name="Seekable" c:type="GSeekable*"/>
32873             </parameter>
32874             <parameter name="offset" transfer-ownership="none">
32875               <doc xml:whitespace="preserve">a #goffset.</doc>
32876               <type name="gint64" c:type="goffset"/>
32877             </parameter>
32878             <parameter name="type" transfer-ownership="none">
32879               <doc xml:whitespace="preserve">a #GSeekType.</doc>
32880               <type name="GLib.SeekType" c:type="GSeekType"/>
32881             </parameter>
32882             <parameter name="cancellable"
32883                        transfer-ownership="none"
32884                        allow-none="1">
32885               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
32886               <type name="Cancellable" c:type="GCancellable*"/>
32887             </parameter>
32888           </parameters>
32889         </callback>
32890       </field>
32891       <field name="can_truncate">
32892         <callback name="can_truncate">
32893           <return-value transfer-ownership="none">
32894             <doc xml:whitespace="preserve">%TRUE if the stream can be truncated, %FALSE otherwise.</doc>
32895             <type name="gboolean" c:type="gboolean"/>
32896           </return-value>
32897           <parameters>
32898             <parameter name="seekable" transfer-ownership="none">
32899               <type name="Seekable" c:type="GSeekable*"/>
32900             </parameter>
32901           </parameters>
32902         </callback>
32903       </field>
32904       <field name="truncate_fn">
32905         <callback name="truncate_fn" throws="1">
32906           <return-value transfer-ownership="none">
32907             <doc xml:whitespace="preserve">%TRUE if successful. If an error</doc>
32908             <type name="gboolean" c:type="gboolean"/>
32909           </return-value>
32910           <parameters>
32911             <parameter name="seekable" transfer-ownership="none">
32912               <type name="Seekable" c:type="GSeekable*"/>
32913             </parameter>
32914             <parameter name="offset" transfer-ownership="none">
32915               <doc xml:whitespace="preserve">a #goffset.</doc>
32916               <type name="gint64" c:type="goffset"/>
32917             </parameter>
32918             <parameter name="cancellable"
32919                        transfer-ownership="none"
32920                        allow-none="1">
32921               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
32922               <type name="Cancellable" c:type="GCancellable*"/>
32923             </parameter>
32924           </parameters>
32925         </callback>
32926       </field>
32927     </record>
32928     <class name="Settings"
32929            c:symbol-prefix="settings"
32930            c:type="GSettings"
32931            parent="GObject.Object"
32932            glib:type-name="GSettings"
32933            glib:get-type="g_settings_get_type"
32934            glib:type-struct="SettingsClass">
32935       <constructor name="new" c:identifier="g_settings_new" version="2.26">
32936         <doc xml:whitespace="preserve">Creates a new #GSettings object with a given schema.
32937 Signals on the newly created #GSettings object will be dispatched
32938 via the thread-default #GMainContext in effect at the time of the
32939 call to g_settings_new().  The new #GSettings will hold a reference
32940 on the context.  See g_main_context_push_thread_default().</doc>
32941         <return-value transfer-ownership="full">
32942           <doc xml:whitespace="preserve">a new #GSettings object</doc>
32943           <type name="Settings" c:type="GSettings*"/>
32944         </return-value>
32945         <parameters>
32946           <parameter name="schema" transfer-ownership="none">
32947             <doc xml:whitespace="preserve">the name of the schema</doc>
32948             <type name="utf8" c:type="gchar*"/>
32949           </parameter>
32950         </parameters>
32951       </constructor>
32952       <constructor name="new_with_backend"
32953                    c:identifier="g_settings_new_with_backend"
32954                    version="2.26">
32955         <doc xml:whitespace="preserve">Creates a new #GSettings object with a given schema and backend.
32956 Creating settings objects with an different backend allows accessing settings
32957 from a database other than the usual one.  For example, it may make
32958 sense to pass a backend corresponding to the "defaults" settings database on
32959 the system to get a settings object that modifies the system default
32960 settings instead of the settings for this user.</doc>
32961         <return-value transfer-ownership="full">
32962           <doc xml:whitespace="preserve">a new #GSettings object</doc>
32963           <type name="Settings" c:type="GSettings*"/>
32964         </return-value>
32965         <parameters>
32966           <parameter name="schema" transfer-ownership="none">
32967             <doc xml:whitespace="preserve">the name of the schema</doc>
32968             <type name="utf8" c:type="gchar*"/>
32969           </parameter>
32970           <parameter name="backend" transfer-ownership="none">
32971             <doc xml:whitespace="preserve">the #GSettingsBackend to use</doc>
32972             <type name="SettingsBackend" c:type="GSettingsBackend*"/>
32973           </parameter>
32974         </parameters>
32975       </constructor>
32976       <constructor name="new_with_backend_and_path"
32977                    c:identifier="g_settings_new_with_backend_and_path"
32978                    version="2.26">
32979         <doc xml:whitespace="preserve">Creates a new #GSettings object with a given schema, backend and
32980 path.
32981 This is a mix of g_settings_new_with_backend() and
32982 g_settings_new_with_path().</doc>
32983         <return-value transfer-ownership="full">
32984           <doc xml:whitespace="preserve">a new #GSettings object</doc>
32985           <type name="Settings" c:type="GSettings*"/>
32986         </return-value>
32987         <parameters>
32988           <parameter name="schema" transfer-ownership="none">
32989             <doc xml:whitespace="preserve">the name of the schema</doc>
32990             <type name="utf8" c:type="gchar*"/>
32991           </parameter>
32992           <parameter name="backend" transfer-ownership="none">
32993             <doc xml:whitespace="preserve">the #GSettingsBackend to use</doc>
32994             <type name="SettingsBackend" c:type="GSettingsBackend*"/>
32995           </parameter>
32996           <parameter name="path" transfer-ownership="none">
32997             <doc xml:whitespace="preserve">the path to use</doc>
32998             <type name="utf8" c:type="gchar*"/>
32999           </parameter>
33000         </parameters>
33001       </constructor>
33002       <constructor name="new_with_path"
33003                    c:identifier="g_settings_new_with_path"
33004                    version="2.26">
33005         <doc xml:whitespace="preserve">Creates a new #GSettings object with a given schema and path.
33006 You only need to do this if you want to directly create a settings
33007 object with a schema that doesn't have a specified path of its own.
33008 That's quite rare.
33009 It is a programmer error to call this function for a schema that
33010 has an explicitly specified path.</doc>
33011         <return-value transfer-ownership="full">
33012           <doc xml:whitespace="preserve">a new #GSettings object</doc>
33013           <type name="Settings" c:type="GSettings*"/>
33014         </return-value>
33015         <parameters>
33016           <parameter name="schema" transfer-ownership="none">
33017             <doc xml:whitespace="preserve">the name of the schema</doc>
33018             <type name="utf8" c:type="gchar*"/>
33019           </parameter>
33020           <parameter name="path" transfer-ownership="none">
33021             <doc xml:whitespace="preserve">the path to use</doc>
33022             <type name="utf8" c:type="gchar*"/>
33023           </parameter>
33024         </parameters>
33025       </constructor>
33026       <function name="list_schemas" c:identifier="g_settings_list_schemas">
33027         <doc xml:whitespace="preserve">must not be modified or freed.</doc>
33028         <return-value transfer-ownership="none">
33029           <doc xml:whitespace="preserve">a list of GSettings schemas that are available.  The list</doc>
33030           <array c:type="gchar**">
33031             <type name="utf8"/>
33032           </array>
33033         </return-value>
33034       </function>
33035       <function name="sync" c:identifier="g_settings_sync">
33036         <doc xml:whitespace="preserve">Ensures that all pending operations for the given are complete for
33037 the default backend.
33038 Writes made to a #GSettings are handled asynchronously.  For this
33039 reason, it is very unlikely that the changes have it to disk by the
33040 time g_settings_set() returns.
33041 This call will block until all of the writes have made it to the
33042 backend.  Since the mainloop is not running, no change notifications
33043 will be dispatched during this call (but some may be queued by the
33044 time the call is done).</doc>
33045         <return-value transfer-ownership="none">
33046           <type name="none" c:type="void"/>
33047         </return-value>
33048       </function>
33049       <function name="unbind" c:identifier="g_settings_unbind" version="2.26">
33050         <doc xml:whitespace="preserve">Removes an existing binding for @property on @object.
33051 Note that bindings are automatically removed when the
33052 object is finalized, so it is rarely necessary to call this
33053 function.</doc>
33054         <return-value transfer-ownership="none">
33055           <type name="none" c:type="void"/>
33056         </return-value>
33057         <parameters>
33058           <parameter name="object" transfer-ownership="none">
33059             <doc xml:whitespace="preserve">the object</doc>
33060             <type name="gpointer" c:type="gpointer"/>
33061           </parameter>
33062           <parameter name="property" transfer-ownership="none">
33063             <doc xml:whitespace="preserve">the property whose binding is removed</doc>
33064             <type name="utf8" c:type="gchar*"/>
33065           </parameter>
33066         </parameters>
33067       </function>
33068       <method name="apply" c:identifier="g_settings_apply">
33069         <doc xml:whitespace="preserve">Applies any changes that have been made to the settings.  This
33070 function does nothing unless @settings is in 'delay-apply' mode;
33071 see g_settings_delay().  In the normal case settings are always
33072 applied immediately.</doc>
33073         <return-value transfer-ownership="none">
33074           <type name="none" c:type="void"/>
33075         </return-value>
33076       </method>
33077       <method name="bind" c:identifier="g_settings_bind" version="2.26">
33078         <doc xml:whitespace="preserve">Create a binding between the @key in the @settings object
33079 and the property @property of @object.
33080 The binding uses the default GIO mapping functions to map
33081 between the settings and property values. These functions
33082 handle booleans, numeric types and string types in a
33083 straightforward way. Use g_settings_bind_with_mapping() if
33084 you need a custom mapping, or map between types that are not
33085 supported by the default mapping functions.
33086 Unless the @flags include %G_SETTINGS_BIND_NO_SENSITIVITY, this
33087 function also establishes a binding between the writability of
33088 a boolean property by that name). See g_settings_bind_writable()
33089 for more details about writable bindings.
33090 Note that the lifecycle of the binding is tied to the object,
33091 and that you can have only one binding per object property.
33092 If you bind the same property twice on the same object, the second
33093 binding overrides the first one.</doc>
33094         <return-value transfer-ownership="none">
33095           <type name="none" c:type="void"/>
33096         </return-value>
33097         <parameters>
33098           <parameter name="key" transfer-ownership="none">
33099             <doc xml:whitespace="preserve">the key to bind</doc>
33100             <type name="utf8" c:type="gchar*"/>
33101           </parameter>
33102           <parameter name="object" transfer-ownership="none">
33103             <doc xml:whitespace="preserve">a #GObject</doc>
33104             <type name="gpointer" c:type="gpointer"/>
33105           </parameter>
33106           <parameter name="property" transfer-ownership="none">
33107             <doc xml:whitespace="preserve">the name of the property to bind</doc>
33108             <type name="utf8" c:type="gchar*"/>
33109           </parameter>
33110           <parameter name="flags" transfer-ownership="none">
33111             <doc xml:whitespace="preserve">flags for the binding</doc>
33112             <type name="SettingsBindFlags" c:type="GSettingsBindFlags"/>
33113           </parameter>
33114         </parameters>
33115       </method>
33116       <method name="bind_with_mapping"
33117               c:identifier="g_settings_bind_with_mapping"
33118               version="2.26"
33119               introspectable="0">
33120         <doc xml:whitespace="preserve">Create a binding between the @key in the @settings object
33121 and the property @property of @object.
33122 The binding uses the provided mapping functions to map between
33123 settings and property values.
33124 Note that the lifecycle of the binding is tied to the object,
33125 and that you can have only one binding per object property.
33126 If you bind the same property twice on the same object, the second
33127 binding overrides the first one.</doc>
33128         <return-value transfer-ownership="none">
33129           <type name="none" c:type="void"/>
33130         </return-value>
33131         <parameters>
33132           <parameter name="key" transfer-ownership="none">
33133             <doc xml:whitespace="preserve">the key to bind</doc>
33134             <type name="utf8" c:type="gchar*"/>
33135           </parameter>
33136           <parameter name="object" transfer-ownership="none">
33137             <doc xml:whitespace="preserve">a #GObject</doc>
33138             <type name="gpointer" c:type="gpointer"/>
33139           </parameter>
33140           <parameter name="property" transfer-ownership="none">
33141             <doc xml:whitespace="preserve">the name of the property to bind</doc>
33142             <type name="utf8" c:type="gchar*"/>
33143           </parameter>
33144           <parameter name="flags" transfer-ownership="none">
33145             <doc xml:whitespace="preserve">flags for the binding</doc>
33146             <type name="SettingsBindFlags" c:type="GSettingsBindFlags"/>
33147           </parameter>
33148           <parameter name="get_mapping" transfer-ownership="none">
33149             <doc xml:whitespace="preserve">a function that gets called to convert values from @settings to @object, or %NULL to use the default GIO mapping</doc>
33150             <type name="SettingsBindGetMapping"
33151                   c:type="GSettingsBindGetMapping"/>
33152           </parameter>
33153           <parameter name="set_mapping"
33154                      transfer-ownership="none"
33155                      scope="notified"
33156                      closure="6"
33157                      destroy="7">
33158             <doc xml:whitespace="preserve">a function that gets called to convert values from @object to @settings, or %NULL to use the default GIO mapping</doc>
33159             <type name="SettingsBindSetMapping"
33160                   c:type="GSettingsBindSetMapping"/>
33161           </parameter>
33162           <parameter name="user_data" transfer-ownership="none">
33163             <doc xml:whitespace="preserve">data that gets passed to @get_mapping and @set_mapping</doc>
33164             <type name="gpointer" c:type="gpointer"/>
33165           </parameter>
33166           <parameter name="destroy" transfer-ownership="none" scope="async">
33167             <doc xml:whitespace="preserve">#GDestroyNotify function for @user_data</doc>
33168             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
33169           </parameter>
33170         </parameters>
33171       </method>
33172       <method name="bind_writable"
33173               c:identifier="g_settings_bind_writable"
33174               version="2.26">
33175         <doc xml:whitespace="preserve">Create a binding between the writability of @key in the
33176 The property must be boolean; "sensitive" or "visible"
33177 properties of widgets are the most likely candidates.
33178 Writable bindings are always uni-directional; changes of the
33179 writability of the setting will be propagated to the object
33180 property, not the other way.
33181 When the @inverted argument is %TRUE, the binding inverts the
33182 value as it passes from the setting to the object, i.e. @property
33183 will be set to %TRUE if the key is &lt;emphasis&gt;not&lt;/emphasis&gt;
33184 writable.
33185 Note that the lifecycle of the binding is tied to the object,
33186 and that you can have only one binding per object property.
33187 If you bind the same property twice on the same object, the second
33188 binding overrides the first one.</doc>
33189         <return-value transfer-ownership="none">
33190           <type name="none" c:type="void"/>
33191         </return-value>
33192         <parameters>
33193           <parameter name="key" transfer-ownership="none">
33194             <doc xml:whitespace="preserve">the key to bind</doc>
33195             <type name="utf8" c:type="gchar*"/>
33196           </parameter>
33197           <parameter name="object" transfer-ownership="none">
33198             <doc xml:whitespace="preserve">a #GObject</doc>
33199             <type name="gpointer" c:type="gpointer"/>
33200           </parameter>
33201           <parameter name="property" transfer-ownership="none">
33202             <doc xml:whitespace="preserve">the name of a boolean property to bind</doc>
33203             <type name="utf8" c:type="gchar*"/>
33204           </parameter>
33205           <parameter name="inverted" transfer-ownership="none">
33206             <doc xml:whitespace="preserve">whether to 'invert' the value</doc>
33207             <type name="gboolean" c:type="gboolean"/>
33208           </parameter>
33209         </parameters>
33210       </method>
33211       <method name="delay" c:identifier="g_settings_delay" version="2.26">
33212         <doc xml:whitespace="preserve">Changes the #GSettings object into 'delay-apply' mode. In this
33213 mode, changes to @settings are not immediately propagated to the
33214 backend, but kept locally until g_settings_apply() is called.</doc>
33215         <return-value transfer-ownership="none">
33216           <type name="none" c:type="void"/>
33217         </return-value>
33218       </method>
33219       <method name="get"
33220               c:identifier="g_settings_get"
33221               version="2.26"
33222               introspectable="0">
33223         <doc xml:whitespace="preserve">Gets the value that is stored at @key in @settings.
33224 A convenience function that combines g_settings_get_value() with
33225 g_variant_get().
33226 It is a programmer error to give a @key that isn't contained in the
33227 schema for @settings or for the #GVariantType of @format to mismatch
33228 the type given in the schema.</doc>
33229         <return-value transfer-ownership="none">
33230           <type name="none" c:type="void"/>
33231         </return-value>
33232         <parameters>
33233           <parameter name="key" transfer-ownership="none">
33234             <doc xml:whitespace="preserve">the key to get the value for</doc>
33235             <type name="utf8" c:type="gchar*"/>
33236           </parameter>
33237           <parameter name="format" transfer-ownership="none">
33238             <doc xml:whitespace="preserve">a #GVariant format string</doc>
33239             <type name="utf8" c:type="gchar*"/>
33240           </parameter>
33241           <parameter transfer-ownership="none">
33242             <varargs>
33243             </varargs>
33244           </parameter>
33245         </parameters>
33246       </method>
33247       <method name="get_boolean"
33248               c:identifier="g_settings_get_boolean"
33249               version="2.26">
33250         <doc xml:whitespace="preserve">Gets the value that is stored at @key in @settings.
33251 A convenience variant of g_settings_get() for booleans.
33252 It is a programmer error to give a @key that isn't specified as
33253 having a boolean type in the schema for @settings.</doc>
33254         <return-value transfer-ownership="none">
33255           <doc xml:whitespace="preserve">a boolean</doc>
33256           <type name="gboolean" c:type="gboolean"/>
33257         </return-value>
33258         <parameters>
33259           <parameter name="key" transfer-ownership="none">
33260             <doc xml:whitespace="preserve">the key to get the value for</doc>
33261             <type name="utf8" c:type="gchar*"/>
33262           </parameter>
33263         </parameters>
33264       </method>
33265       <method name="get_child"
33266               c:identifier="g_settings_get_child"
33267               version="2.26">
33268         <doc xml:whitespace="preserve">Creates a 'child' settings object which has a base path of
33269 &lt;replaceable&gt;base-path&lt;/replaceable&gt;/@name", where
33270 &lt;replaceable&gt;base-path&lt;/replaceable&gt; is the base path of @settings.
33271 The schema for the child settings object must have been declared
33272 in the schema of @settings using a &lt;tag class="starttag"&gt;child&lt;/tag&gt; element.</doc>
33273         <return-value transfer-ownership="full">
33274           <doc xml:whitespace="preserve">a 'child' settings object</doc>
33275           <type name="Settings" c:type="GSettings*"/>
33276         </return-value>
33277         <parameters>
33278           <parameter name="name" transfer-ownership="none">
33279             <doc xml:whitespace="preserve">the name of the 'child' schema</doc>
33280             <type name="utf8" c:type="gchar*"/>
33281           </parameter>
33282         </parameters>
33283       </method>
33284       <method name="get_double"
33285               c:identifier="g_settings_get_double"
33286               version="2.26">
33287         <doc xml:whitespace="preserve">Gets the value that is stored at @key in @settings.
33288 A convenience variant of g_settings_get() for doubles.
33289 It is a programmer error to give a @key that isn't specified as
33290 having a 'double' type in the schema for @settings.</doc>
33291         <return-value transfer-ownership="none">
33292           <doc xml:whitespace="preserve">a double</doc>
33293           <type name="gdouble" c:type="gdouble"/>
33294         </return-value>
33295         <parameters>
33296           <parameter name="key" transfer-ownership="none">
33297             <doc xml:whitespace="preserve">the key to get the value for</doc>
33298             <type name="utf8" c:type="gchar*"/>
33299           </parameter>
33300         </parameters>
33301       </method>
33302       <method name="get_enum"
33303               c:identifier="g_settings_get_enum"
33304               version="2.26">
33305         <doc xml:whitespace="preserve">Gets the value that is stored in @settings for @key and converts it
33306 to the enum value that it represents.
33307 In order to use this function the type of the value must be a string
33308 and it must be marked in the schema file as an enumerated type.
33309 It is a programmer error to give a @key that isn't contained in the
33310 schema for @settings or is not marked as an enumerated type.
33311 If the value stored in the configuration database is not a valid
33312 value for the enumerated type then this function will return the
33313 default value.</doc>
33314         <return-value transfer-ownership="none">
33315           <doc xml:whitespace="preserve">the enum value</doc>
33316           <type name="gint" c:type="gint"/>
33317         </return-value>
33318         <parameters>
33319           <parameter name="key" transfer-ownership="none">
33320             <doc xml:whitespace="preserve">the key to get the value for</doc>
33321             <type name="utf8" c:type="gchar*"/>
33322           </parameter>
33323         </parameters>
33324       </method>
33325       <method name="get_flags"
33326               c:identifier="g_settings_get_flags"
33327               version="2.26">
33328         <doc xml:whitespace="preserve">Gets the value that is stored in @settings for @key and converts it
33329 to the flags value that it represents.
33330 In order to use this function the type of the value must be an array
33331 of strings and it must be marked in the schema file as an flags type.
33332 It is a programmer error to give a @key that isn't contained in the
33333 schema for @settings or is not marked as a flags type.
33334 If the value stored in the configuration database is not a valid
33335 value for the flags type then this function will return the default
33336 value.</doc>
33337         <return-value transfer-ownership="none">
33338           <doc xml:whitespace="preserve">the flags value</doc>
33339           <type name="guint" c:type="guint"/>
33340         </return-value>
33341         <parameters>
33342           <parameter name="key" transfer-ownership="none">
33343             <doc xml:whitespace="preserve">the key to get the value for</doc>
33344             <type name="utf8" c:type="gchar*"/>
33345           </parameter>
33346         </parameters>
33347       </method>
33348       <method name="get_has_unapplied"
33349               c:identifier="g_settings_get_has_unapplied"
33350               version="2.26">
33351         <doc xml:whitespace="preserve">Returns whether the #GSettings object has any unapplied
33352 changes.  This can only be the case if it is in 'delayed-apply' mode.</doc>
33353         <return-value transfer-ownership="none">
33354           <doc xml:whitespace="preserve">%TRUE if @settings has unapplied changes</doc>
33355           <type name="gboolean" c:type="gboolean"/>
33356         </return-value>
33357       </method>
33358       <method name="get_int" c:identifier="g_settings_get_int" version="2.26">
33359         <doc xml:whitespace="preserve">Gets the value that is stored at @key in @settings.
33360 A convenience variant of g_settings_get() for 32-bit integers.
33361 It is a programmer error to give a @key that isn't specified as
33362 having a int32 type in the schema for @settings.</doc>
33363         <return-value transfer-ownership="none">
33364           <doc xml:whitespace="preserve">an integer</doc>
33365           <type name="gint" c:type="gint"/>
33366         </return-value>
33367         <parameters>
33368           <parameter name="key" transfer-ownership="none">
33369             <doc xml:whitespace="preserve">the key to get the value for</doc>
33370             <type name="utf8" c:type="gchar*"/>
33371           </parameter>
33372         </parameters>
33373       </method>
33374       <method name="get_mapped"
33375               c:identifier="g_settings_get_mapped"
33376               introspectable="0">
33377         <doc xml:whitespace="preserve">Gets the value that is stored at @key in @settings, subject to
33378 application-level validation/mapping.
33379 You should use this function when the application needs to perform
33380 some processing on the value of the key (for example, parsing).  The
33381 indicates that the processing was unsuccessful (due to a parse error,
33382 for example) then the mapping is tried again with another value.
33383 This allows a robust 'fall back to defaults' behaviour to be
33384 implemented somewhat automatically.
33385 The first value that is tried is the user's setting for the key.  If
33386 the mapping function fails to map this value, other values may be
33387 tried in an unspecified order (system or site defaults, translated
33388 schema default values, untranslated schema default values, etc).
33389 If the mapping function fails for all possible values, one additional
33390 If the mapping function still indicates failure at this point then
33391 the application will be aborted.
33392 The result parameter for the @mapping function is pointed to a
33393 #gpointer which is initially set to %NULL.  The same pointer is given
33394 to each invocation of @mapping.  The final value of that #gpointer is
33395 what is returned by this function.  %NULL is valid; it is returned
33396 just as any other value would be.</doc>
33397         <return-value transfer-ownership="full">
33398           <doc xml:whitespace="preserve">the result, which may be %NULL</doc>
33399           <type name="gpointer" c:type="gpointer"/>
33400         </return-value>
33401         <parameters>
33402           <parameter name="key" transfer-ownership="none">
33403             <doc xml:whitespace="preserve">the key to get the value for</doc>
33404             <type name="utf8" c:type="gchar*"/>
33405           </parameter>
33406           <parameter name="mapping" transfer-ownership="none" closure="2">
33407             <doc xml:whitespace="preserve">the function to map the value in the settings database to the value used by the application</doc>
33408             <type name="SettingsGetMapping" c:type="GSettingsGetMapping"/>
33409           </parameter>
33410           <parameter name="user_data" transfer-ownership="none">
33411             <doc xml:whitespace="preserve">user data for @mapping</doc>
33412             <type name="gpointer" c:type="gpointer"/>
33413           </parameter>
33414         </parameters>
33415       </method>
33416       <method name="get_string"
33417               c:identifier="g_settings_get_string"
33418               version="2.26">
33419         <doc xml:whitespace="preserve">Gets the value that is stored at @key in @settings.
33420 A convenience variant of g_settings_get() for strings.
33421 It is a programmer error to give a @key that isn't specified as
33422 having a string type in the schema for @settings.</doc>
33423         <return-value transfer-ownership="full">
33424           <doc xml:whitespace="preserve">a newly-allocated string</doc>
33425           <type name="utf8" c:type="gchar*"/>
33426         </return-value>
33427         <parameters>
33428           <parameter name="key" transfer-ownership="none">
33429             <doc xml:whitespace="preserve">the key to get the value for</doc>
33430             <type name="utf8" c:type="gchar*"/>
33431           </parameter>
33432         </parameters>
33433       </method>
33434       <method name="get_strv"
33435               c:identifier="g_settings_get_strv"
33436               version="2.26">
33437         <doc xml:whitespace="preserve">A convenience variant of g_settings_get() for string arrays.
33438 It is a programmer error to give a @key that isn't specified as
33439 having an array of strings type in the schema for @settings.
33440 stored at @key in @settings.</doc>
33441         <return-value transfer-ownership="full">
33442           <doc xml:whitespace="preserve">the value that is</doc>
33443           <array c:type="gchar**">
33444             <type name="utf8"/>
33445           </array>
33446         </return-value>
33447         <parameters>
33448           <parameter name="key" transfer-ownership="none">
33449             <doc xml:whitespace="preserve">the key to get the value for</doc>
33450             <type name="utf8" c:type="gchar*"/>
33451           </parameter>
33452         </parameters>
33453       </method>
33454       <method name="get_value"
33455               c:identifier="g_settings_get_value"
33456               version="2.26">
33457         <doc xml:whitespace="preserve">Gets the value that is stored in @settings for @key.
33458 It is a programmer error to give a @key that isn't contained in the
33459 schema for @settings.</doc>
33460         <return-value transfer-ownership="full">
33461           <doc xml:whitespace="preserve">a new #GVariant</doc>
33462           <type name="GLib.Variant" c:type="GVariant*"/>
33463         </return-value>
33464         <parameters>
33465           <parameter name="key" transfer-ownership="none">
33466             <doc xml:whitespace="preserve">the key to get the value for</doc>
33467             <type name="utf8" c:type="gchar*"/>
33468           </parameter>
33469         </parameters>
33470       </method>
33471       <method name="is_writable"
33472               c:identifier="g_settings_is_writable"
33473               version="2.26">
33474         <doc xml:whitespace="preserve">Finds out if a key can be written or not</doc>
33475         <return-value transfer-ownership="none">
33476           <doc xml:whitespace="preserve">%TRUE if the key @name is writable</doc>
33477           <type name="gboolean" c:type="gboolean"/>
33478         </return-value>
33479         <parameters>
33480           <parameter name="name" transfer-ownership="none">
33481             <doc xml:whitespace="preserve">the name of a key</doc>
33482             <type name="utf8" c:type="gchar*"/>
33483           </parameter>
33484         </parameters>
33485       </method>
33486       <method name="list_children" c:identifier="g_settings_list_children">
33487         <doc xml:whitespace="preserve">Gets the list of children on @settings.
33488 The list is exactly the list of strings for which it is not an error
33489 to call g_settings_get_child().
33490 For GSettings objects that are lists, this value can change at any
33491 time and you should connect to the "children-changed" signal to watch
33492 request a child after listing it only for it to have been destroyed
33493 in the meantime.  For this reason, g_settings_get_chuld() may return
33494 %NULL even for a child that was listed by this function.
33495 For GSettings objects that are not lists, you should probably not be
33496 calling this function from "normal" code (since you should already
33497 know what children are in your schema).  This function may still be
33498 useful there for introspection reasons, however.
33499 You should free the return value with g_strfreev() when you are done
33500 with it.</doc>
33501         <return-value transfer-ownership="full">
33502           <doc xml:whitespace="preserve">a list of the children on @settings</doc>
33503           <array c:type="gchar**">
33504             <type name="utf8"/>
33505           </array>
33506         </return-value>
33507       </method>
33508       <method name="list_keys" c:identifier="g_settings_list_keys">
33509         <doc xml:whitespace="preserve">Introspects the list of keys on @settings.
33510 You should probably not be calling this function from "normal" code
33511 (since you should already know what keys are in your schema).  This
33512 function is intended for introspection reasons.
33513 You should free the return value with g_strfreev() when you are done
33514 with it.</doc>
33515         <return-value transfer-ownership="full">
33516           <doc xml:whitespace="preserve">a list of the keys on @settings</doc>
33517           <array c:type="gchar**">
33518             <type name="utf8"/>
33519           </array>
33520         </return-value>
33521       </method>
33522       <method name="reset" c:identifier="g_settings_reset">
33523         <doc xml:whitespace="preserve">Resets @key to its default value.
33524 This call resets the key, as much as possible, to its default value.
33525 That might the value specified in the schema or the one set by the
33526 administrator.</doc>
33527         <return-value transfer-ownership="none">
33528           <type name="none" c:type="void"/>
33529         </return-value>
33530         <parameters>
33531           <parameter name="key" transfer-ownership="none">
33532             <doc xml:whitespace="preserve">the name of a key</doc>
33533             <type name="utf8" c:type="gchar*"/>
33534           </parameter>
33535         </parameters>
33536       </method>
33537       <method name="revert" c:identifier="g_settings_revert">
33538         <doc xml:whitespace="preserve">Reverts all non-applied changes to the settings.  This function
33539 does nothing unless @settings is in 'delay-apply' mode; see
33540 g_settings_delay().  In the normal case settings are always applied
33541 immediately.
33542 Change notifications will be emitted for affected keys.</doc>
33543         <return-value transfer-ownership="none">
33544           <type name="none" c:type="void"/>
33545         </return-value>
33546       </method>
33547       <method name="set"
33548               c:identifier="g_settings_set"
33549               version="2.26"
33550               introspectable="0">
33551         <doc xml:whitespace="preserve">Sets @key in @settings to @value.
33552 A convenience function that combines g_settings_set_value() with
33553 g_variant_new().
33554 It is a programmer error to give a @key that isn't contained in the
33555 schema for @settings or for the #GVariantType of @format to mismatch
33556 the type given in the schema.</doc>
33557         <return-value transfer-ownership="none">
33558           <doc xml:whitespace="preserve">%TRUE if setting the key succeeded, %FALSE if the key was not writable</doc>
33559           <type name="gboolean" c:type="gboolean"/>
33560         </return-value>
33561         <parameters>
33562           <parameter name="key" transfer-ownership="none">
33563             <doc xml:whitespace="preserve">the name of the key to set</doc>
33564             <type name="utf8" c:type="gchar*"/>
33565           </parameter>
33566           <parameter name="format" transfer-ownership="none">
33567             <doc xml:whitespace="preserve">a #GVariant format string</doc>
33568             <type name="utf8" c:type="gchar*"/>
33569           </parameter>
33570           <parameter transfer-ownership="none">
33571             <varargs>
33572             </varargs>
33573           </parameter>
33574         </parameters>
33575       </method>
33576       <method name="set_boolean"
33577               c:identifier="g_settings_set_boolean"
33578               version="2.26">
33579         <doc xml:whitespace="preserve">Sets @key in @settings to @value.
33580 A convenience variant of g_settings_set() for booleans.
33581 It is a programmer error to give a @key that isn't specified as
33582 having a boolean type in the schema for @settings.</doc>
33583         <return-value transfer-ownership="none">
33584           <doc xml:whitespace="preserve">%TRUE if setting the key succeeded, %FALSE if the key was not writable</doc>
33585           <type name="gboolean" c:type="gboolean"/>
33586         </return-value>
33587         <parameters>
33588           <parameter name="key" transfer-ownership="none">
33589             <doc xml:whitespace="preserve">the name of the key to set</doc>
33590             <type name="utf8" c:type="gchar*"/>
33591           </parameter>
33592           <parameter name="value" transfer-ownership="none">
33593             <doc xml:whitespace="preserve">the value to set it to</doc>
33594             <type name="gboolean" c:type="gboolean"/>
33595           </parameter>
33596         </parameters>
33597       </method>
33598       <method name="set_double"
33599               c:identifier="g_settings_set_double"
33600               version="2.26">
33601         <doc xml:whitespace="preserve">Sets @key in @settings to @value.
33602 A convenience variant of g_settings_set() for doubles.
33603 It is a programmer error to give a @key that isn't specified as
33604 having a 'double' type in the schema for @settings.</doc>
33605         <return-value transfer-ownership="none">
33606           <doc xml:whitespace="preserve">%TRUE if setting the key succeeded, %FALSE if the key was not writable</doc>
33607           <type name="gboolean" c:type="gboolean"/>
33608         </return-value>
33609         <parameters>
33610           <parameter name="key" transfer-ownership="none">
33611             <doc xml:whitespace="preserve">the name of the key to set</doc>
33612             <type name="utf8" c:type="gchar*"/>
33613           </parameter>
33614           <parameter name="value" transfer-ownership="none">
33615             <doc xml:whitespace="preserve">the value to set it to</doc>
33616             <type name="gdouble" c:type="gdouble"/>
33617           </parameter>
33618         </parameters>
33619       </method>
33620       <method name="set_enum" c:identifier="g_settings_set_enum">
33621         <doc xml:whitespace="preserve">Looks up the enumerated type nick for @value and writes it to @key,
33622 within @settings.
33623 It is a programmer error to give a @key that isn't contained in the
33624 schema for @settings or is not marked as an enumerated type, or for
33625 After performing the write, accessing @key directly with
33626 g_settings_get_string() will return the 'nick' associated with</doc>
33627         <return-value transfer-ownership="none">
33628           <doc xml:whitespace="preserve">%TRUE, if the set succeeds</doc>
33629           <type name="gboolean" c:type="gboolean"/>
33630         </return-value>
33631         <parameters>
33632           <parameter name="key" transfer-ownership="none">
33633             <doc xml:whitespace="preserve">a key, within @settings</doc>
33634             <type name="utf8" c:type="gchar*"/>
33635           </parameter>
33636           <parameter name="value" transfer-ownership="none">
33637             <doc xml:whitespace="preserve">an enumerated value</doc>
33638             <type name="gint" c:type="gint"/>
33639           </parameter>
33640         </parameters>
33641       </method>
33642       <method name="set_flags" c:identifier="g_settings_set_flags">
33643         <doc xml:whitespace="preserve">Looks up the flags type nicks for the bits specified by @value, puts
33644 them in an array of strings and writes the array to @key, withing
33645 It is a programmer error to give a @key that isn't contained in the
33646 schema for @settings or is not marked as a flags type, or for @value
33647 to contain any bits that are not value for the named type.
33648 After performing the write, accessing @key directly with
33649 g_settings_get_strv() will return an array of 'nicks'; one for each
33650 bit in @value.</doc>
33651         <return-value transfer-ownership="none">
33652           <doc xml:whitespace="preserve">%TRUE, if the set succeeds</doc>
33653           <type name="gboolean" c:type="gboolean"/>
33654         </return-value>
33655         <parameters>
33656           <parameter name="key" transfer-ownership="none">
33657             <doc xml:whitespace="preserve">a key, within @settings</doc>
33658             <type name="utf8" c:type="gchar*"/>
33659           </parameter>
33660           <parameter name="value" transfer-ownership="none">
33661             <doc xml:whitespace="preserve">a flags value</doc>
33662             <type name="guint" c:type="guint"/>
33663           </parameter>
33664         </parameters>
33665       </method>
33666       <method name="set_int" c:identifier="g_settings_set_int" version="2.26">
33667         <doc xml:whitespace="preserve">Sets @key in @settings to @value.
33668 A convenience variant of g_settings_set() for 32-bit integers.
33669 It is a programmer error to give a @key that isn't specified as
33670 having a int32 type in the schema for @settings.</doc>
33671         <return-value transfer-ownership="none">
33672           <doc xml:whitespace="preserve">%TRUE if setting the key succeeded, %FALSE if the key was not writable</doc>
33673           <type name="gboolean" c:type="gboolean"/>
33674         </return-value>
33675         <parameters>
33676           <parameter name="key" transfer-ownership="none">
33677             <doc xml:whitespace="preserve">the name of the key to set</doc>
33678             <type name="utf8" c:type="gchar*"/>
33679           </parameter>
33680           <parameter name="value" transfer-ownership="none">
33681             <doc xml:whitespace="preserve">the value to set it to</doc>
33682             <type name="gint" c:type="gint"/>
33683           </parameter>
33684         </parameters>
33685       </method>
33686       <method name="set_string"
33687               c:identifier="g_settings_set_string"
33688               version="2.26">
33689         <doc xml:whitespace="preserve">Sets @key in @settings to @value.
33690 A convenience variant of g_settings_set() for strings.
33691 It is a programmer error to give a @key that isn't specified as
33692 having a string type in the schema for @settings.</doc>
33693         <return-value transfer-ownership="none">
33694           <doc xml:whitespace="preserve">%TRUE if setting the key succeeded, %FALSE if the key was not writable</doc>
33695           <type name="gboolean" c:type="gboolean"/>
33696         </return-value>
33697         <parameters>
33698           <parameter name="key" transfer-ownership="none">
33699             <doc xml:whitespace="preserve">the name of the key to set</doc>
33700             <type name="utf8" c:type="gchar*"/>
33701           </parameter>
33702           <parameter name="value" transfer-ownership="none">
33703             <doc xml:whitespace="preserve">the value to set it to</doc>
33704             <type name="utf8" c:type="gchar*"/>
33705           </parameter>
33706         </parameters>
33707       </method>
33708       <method name="set_strv"
33709               c:identifier="g_settings_set_strv"
33710               version="2.26">
33711         <doc xml:whitespace="preserve">Sets @key in @settings to @value.
33712 A convenience variant of g_settings_set() for string arrays.  If
33713 It is a programmer error to give a @key that isn't specified as
33714 having an array of strings type in the schema for @settings.</doc>
33715         <return-value transfer-ownership="none">
33716           <doc xml:whitespace="preserve">%TRUE if setting the key succeeded, %FALSE if the key was not writable</doc>
33717           <type name="gboolean" c:type="gboolean"/>
33718         </return-value>
33719         <parameters>
33720           <parameter name="key" transfer-ownership="none">
33721             <doc xml:whitespace="preserve">the name of the key to set</doc>
33722             <type name="utf8" c:type="gchar*"/>
33723           </parameter>
33724           <parameter name="value" transfer-ownership="none" allow-none="1">
33725             <doc xml:whitespace="preserve">the value to set it to, or %NULL</doc>
33726             <array c:type="gchar**">
33727               <type name="utf8"/>
33728             </array>
33729           </parameter>
33730         </parameters>
33731       </method>
33732       <method name="set_value"
33733               c:identifier="g_settings_set_value"
33734               version="2.26">
33735         <doc xml:whitespace="preserve">Sets @key in @settings to @value.
33736 It is a programmer error to give a @key that isn't contained in the
33737 schema for @settings or for @value to have the incorrect type, per
33738 the schema.
33739 If @value is floating then this function consumes the reference.</doc>
33740         <return-value transfer-ownership="none">
33741           <doc xml:whitespace="preserve">%TRUE if setting the key succeeded, %FALSE if the key was not writable</doc>
33742           <type name="gboolean" c:type="gboolean"/>
33743         </return-value>
33744         <parameters>
33745           <parameter name="key" transfer-ownership="none">
33746             <doc xml:whitespace="preserve">the name of the key to set</doc>
33747             <type name="utf8" c:type="gchar*"/>
33748           </parameter>
33749           <parameter name="value" transfer-ownership="none">
33750             <doc xml:whitespace="preserve">a #GVariant of the correct type</doc>
33751             <type name="GLib.Variant" c:type="GVariant*"/>
33752           </parameter>
33753         </parameters>
33754       </method>
33755       <property name="backend"
33756                 writable="1"
33757                 construct-only="1"
33758                 transfer-ownership="none">
33759         <type name="SettingsBackend"/>
33760       </property>
33761       <property name="has-unapplied" transfer-ownership="none">
33762         <doc xml:whitespace="preserve">If this property is %TRUE, the #GSettings object has outstanding
33763 changes that will be applied when g_settings_apply() is called.</doc>
33764         <type name="gboolean"/>
33765       </property>
33766       <property name="path"
33767                 writable="1"
33768                 construct-only="1"
33769                 transfer-ownership="none">
33770         <doc xml:whitespace="preserve">The path within the backend where the settings are stored.</doc>
33771         <type name="utf8"/>
33772       </property>
33773       <property name="schema"
33774                 writable="1"
33775                 construct-only="1"
33776                 transfer-ownership="none">
33777         <doc xml:whitespace="preserve">The name of the schema that describes the types of keys
33778 for this #GSettings object.</doc>
33779         <type name="utf8"/>
33780       </property>
33781       <field name="parent_instance">
33782         <type name="GObject.Object" c:type="GObject"/>
33783       </field>
33784       <field name="priv">
33785         <type name="SettingsPrivate" c:type="GSettingsPrivate*"/>
33786       </field>
33787       <glib:signal name="change-event">
33788         <doc xml:whitespace="preserve">The "change-event" signal is emitted once per change event that
33789 affects this settings object.  You should connect to this signal
33790 only if you are interested in viewing groups of changes before they
33791 are split out into multiple emissions of the "changed" signal.
33792 For most use cases it is more appropriate to use the "changed" signal.
33793 In the event that the change event applies to one or more specified
33794 keys, @keys will be an array of #GQuark of length @n_keys.  In the
33795 event that the change event applies to the #GSettings object as a
33796 be %NULL and @n_keys will be 0.
33797 The default handler for this signal invokes the "changed" signal
33798 for each affected key.  If any other connected handler returns
33799 %TRUE then this default functionality will be supressed.</doc>
33800         <return-value transfer-ownership="none">
33801           <doc xml:whitespace="preserve">%TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further.</doc>
33802           <type name="gboolean"/>
33803         </return-value>
33804         <parameters>
33805           <parameter name="object" transfer-ownership="none">
33806             <doc xml:whitespace="preserve">an array of #GQuark&lt;!-- --&gt;s for the changed keys, or %NULL</doc>
33807             <type name="gpointer"/>
33808           </parameter>
33809           <parameter name="p0" transfer-ownership="none">
33810             <doc xml:whitespace="preserve">the length of the @keys array, or 0</doc>
33811             <type name="gint"/>
33812           </parameter>
33813         </parameters>
33814       </glib:signal>
33815       <glib:signal name="changed">
33816         <doc xml:whitespace="preserve">The "changed" signal is emitted when a key has potentially changed.
33817 You should call one of the g_settings_get() calls to check the new
33818 value.
33819 This signal supports detailed connections.  You can connect to the
33820 detailed signal "changed::x" in order to only receive callbacks
33821 when key "x" changes.</doc>
33822         <return-value transfer-ownership="none">
33823           <type name="none"/>
33824         </return-value>
33825         <parameters>
33826           <parameter name="object" transfer-ownership="none">
33827             <doc xml:whitespace="preserve">the name of the key that changed</doc>
33828             <type name="utf8"/>
33829           </parameter>
33830         </parameters>
33831       </glib:signal>
33832       <glib:signal name="writable-change-event">
33833         <doc xml:whitespace="preserve">The "writable-change-event" signal is emitted once per writability
33834 change event that affects this settings object.  You should connect
33835 to this signal if you are interested in viewing groups of changes
33836 before they are split out into multiple emissions of the
33837 "writable-changed" signal.  For most use cases it is more
33838 appropriate to use the "writable-changed" signal.
33839 In the event that the writability change applies only to a single
33840 key, @key will be set to the #GQuark for that key.  In the event
33841 that the writability change affects the entire settings object,
33842 The default handler for this signal invokes the "writable-changed"
33843 and "changed" signals for each affected key.  This is done because
33844 changes in writability might also imply changes in value (if for
33845 example, a new mandatory setting is introduced).  If any other
33846 connected handler returns %TRUE then this default functionality
33847 will be supressed.</doc>
33848         <return-value transfer-ownership="none">
33849           <doc xml:whitespace="preserve">%TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further.</doc>
33850           <type name="gboolean"/>
33851         </return-value>
33852         <parameters>
33853           <parameter name="object" transfer-ownership="none">
33854             <doc xml:whitespace="preserve">the quark of the key, or 0</doc>
33855             <type name="guint"/>
33856           </parameter>
33857         </parameters>
33858       </glib:signal>
33859       <glib:signal name="writable-changed">
33860         <doc xml:whitespace="preserve">The "writable-changed" signal is emitted when the writability of a
33861 key has potentially changed.  You should call
33862 g_settings_is_writable() in order to determine the new status.
33863 This signal supports detailed connections.  You can connect to the
33864 detailed signal "writable-changed::x" in order to only receive
33865 callbacks when the writability of "x" changes.</doc>
33866         <return-value transfer-ownership="none">
33867           <type name="none"/>
33868         </return-value>
33869         <parameters>
33870           <parameter name="object" transfer-ownership="none">
33871             <doc xml:whitespace="preserve">the key</doc>
33872             <type name="utf8"/>
33873           </parameter>
33874         </parameters>
33875       </glib:signal>
33876     </class>
33877     <class name="SettingsBackend"
33878            c:symbol-prefix="settings_backend"
33879            c:type="GSettingsBackend"
33880            parent="GObject.Object"
33881            abstract="1"
33882            glib:type-name="GSettingsBackend"
33883            glib:get-type="g_settings_backend_get_type"
33884            glib:type-struct="SettingsBackendClass">
33885       <doc xml:whitespace="preserve">An implementation of a settings storage repository.</doc>
33886       <function name="flatten_tree"
33887                 c:identifier="g_settings_backend_flatten_tree"
33888                 version="2.26">
33889         <doc xml:whitespace="preserve">Calculate the longest common prefix of all keys in a tree and write
33890 out an array of the key names relative to that prefix and,
33891 optionally, the value to store at each of those keys.
33892 You must free the value returned in @path, @keys and @values using
33893 g_free().  You should not attempt to free or unref the contents of</doc>
33894         <return-value transfer-ownership="none">
33895           <type name="none" c:type="void"/>
33896         </return-value>
33897         <parameters>
33898           <parameter name="tree" transfer-ownership="none">
33899             <doc xml:whitespace="preserve">a #GTree containing the changes</doc>
33900             <type name="GLib.Tree" c:type="GTree*"/>
33901           </parameter>
33902           <parameter name="path" transfer-ownership="none">
33903             <doc xml:whitespace="preserve">the location to save the path</doc>
33904             <type name="utf8" c:type="gchar**"/>
33905           </parameter>
33906           <parameter name="keys" transfer-ownership="none">
33907             <doc xml:whitespace="preserve">the location to save the relative keys</doc>
33908             <type name="utf8" c:type="gchar***"/>
33909           </parameter>
33910           <parameter name="values" transfer-ownership="none">
33911             <doc xml:whitespace="preserve">the location to save the values, or %NULL</doc>
33912             <type name="GLib.Variant" c:type="GVariant***"/>
33913           </parameter>
33914         </parameters>
33915       </function>
33916       <virtual-method name="get_permission" introspectable="0">
33917         <return-value>
33918           <type name="Permission" c:type="GPermission*"/>
33919         </return-value>
33920         <parameters>
33921           <parameter name="path" transfer-ownership="none">
33922             <type name="utf8" c:type="gchar*"/>
33923           </parameter>
33924         </parameters>
33925       </virtual-method>
33926       <virtual-method name="get_writable">
33927         <return-value transfer-ownership="none">
33928           <type name="gboolean" c:type="gboolean"/>
33929         </return-value>
33930         <parameters>
33931           <parameter name="key" transfer-ownership="none">
33932             <type name="utf8" c:type="gchar*"/>
33933           </parameter>
33934         </parameters>
33935       </virtual-method>
33936       <virtual-method name="read">
33937         <return-value transfer-ownership="full">
33938           <type name="GLib.Variant" c:type="GVariant*"/>
33939         </return-value>
33940         <parameters>
33941           <parameter name="key" transfer-ownership="none">
33942             <type name="utf8" c:type="gchar*"/>
33943           </parameter>
33944           <parameter name="expected_type" transfer-ownership="none">
33945             <type name="GLib.VariantType" c:type="GVariantType*"/>
33946           </parameter>
33947           <parameter name="default_value" transfer-ownership="none">
33948             <type name="gboolean" c:type="gboolean"/>
33949           </parameter>
33950         </parameters>
33951       </virtual-method>
33952       <virtual-method name="reset">
33953         <return-value transfer-ownership="none">
33954           <type name="none" c:type="void"/>
33955         </return-value>
33956         <parameters>
33957           <parameter name="key" transfer-ownership="none">
33958             <type name="utf8" c:type="gchar*"/>
33959           </parameter>
33960           <parameter name="origin_tag" transfer-ownership="none">
33961             <type name="gpointer" c:type="gpointer"/>
33962           </parameter>
33963         </parameters>
33964       </virtual-method>
33965       <virtual-method name="subscribe">
33966         <return-value transfer-ownership="none">
33967           <type name="none" c:type="void"/>
33968         </return-value>
33969         <parameters>
33970           <parameter name="name" transfer-ownership="none">
33971             <type name="utf8" c:type="gchar*"/>
33972           </parameter>
33973         </parameters>
33974       </virtual-method>
33975       <virtual-method name="sync">
33976         <return-value transfer-ownership="none">
33977           <type name="none" c:type="void"/>
33978         </return-value>
33979       </virtual-method>
33980       <virtual-method name="unsubscribe">
33981         <return-value transfer-ownership="none">
33982           <type name="none" c:type="void"/>
33983         </return-value>
33984         <parameters>
33985           <parameter name="name" transfer-ownership="none">
33986             <type name="utf8" c:type="gchar*"/>
33987           </parameter>
33988         </parameters>
33989       </virtual-method>
33990       <virtual-method name="write">
33991         <return-value transfer-ownership="none">
33992           <type name="gboolean" c:type="gboolean"/>
33993         </return-value>
33994         <parameters>
33995           <parameter name="key" transfer-ownership="none">
33996             <type name="utf8" c:type="gchar*"/>
33997           </parameter>
33998           <parameter name="value" transfer-ownership="none">
33999             <type name="GLib.Variant" c:type="GVariant*"/>
34000           </parameter>
34001           <parameter name="origin_tag" transfer-ownership="none">
34002             <type name="gpointer" c:type="gpointer"/>
34003           </parameter>
34004         </parameters>
34005       </virtual-method>
34006       <virtual-method name="write_tree">
34007         <return-value transfer-ownership="none">
34008           <type name="gboolean" c:type="gboolean"/>
34009         </return-value>
34010         <parameters>
34011           <parameter name="tree" transfer-ownership="none">
34012             <type name="GLib.Tree" c:type="GTree*"/>
34013           </parameter>
34014           <parameter name="origin_tag" transfer-ownership="none">
34015             <type name="gpointer" c:type="gpointer"/>
34016           </parameter>
34017         </parameters>
34018       </virtual-method>
34019       <method name="changed"
34020               c:identifier="g_settings_backend_changed"
34021               version="2.26">
34022         <doc xml:whitespace="preserve">Signals that a single key has possibly changed.  Backend
34023 implementations should call this if a key has possibly changed its
34024 value.
34025 '//', and not ending with a slash).
34026 The implementation must call this function during any call to
34027 g_settings_backend_write(), before the call returns (except in the
34028 case that no keys are actually changed and it cares to detect this
34029 fact).  It may not rely on the existence of a mainloop for
34030 dispatching the signal later.
34031 The implementation may call this function at any other time it likes
34032 in response to other events (such as changes occuring outside of the
34033 program).  These calls may originate from a mainloop or may originate
34034 in response to any other action (including from calls to
34035 g_settings_backend_write()).
34036 In the case that this call is in response to a call to
34037 g_settings_backend_write() then @origin_tag must be set to the same
34038 value that was passed to that call.</doc>
34039         <return-value transfer-ownership="none">
34040           <type name="none" c:type="void"/>
34041         </return-value>
34042         <parameters>
34043           <parameter name="key" transfer-ownership="none">
34044             <doc xml:whitespace="preserve">the name of the key</doc>
34045             <type name="utf8" c:type="gchar*"/>
34046           </parameter>
34047           <parameter name="origin_tag" transfer-ownership="none">
34048             <doc xml:whitespace="preserve">the origin tag</doc>
34049             <type name="gpointer" c:type="gpointer"/>
34050           </parameter>
34051         </parameters>
34052       </method>
34053       <method name="changed_tree"
34054               c:identifier="g_settings_backend_changed_tree"
34055               version="2.26">
34056         <doc xml:whitespace="preserve">This call is a convenience wrapper.  It gets the list of changes from
34057 g_settings_backend_changed().</doc>
34058         <return-value transfer-ownership="none">
34059           <type name="none" c:type="void"/>
34060         </return-value>
34061         <parameters>
34062           <parameter name="tree" transfer-ownership="none">
34063             <doc xml:whitespace="preserve">a #GTree containing the changes</doc>
34064             <type name="GLib.Tree" c:type="GTree*"/>
34065           </parameter>
34066           <parameter name="origin_tag" transfer-ownership="none">
34067             <doc xml:whitespace="preserve">the origin tag</doc>
34068             <type name="gpointer" c:type="gpointer"/>
34069           </parameter>
34070         </parameters>
34071       </method>
34072       <method name="keys_changed"
34073               c:identifier="g_settings_backend_keys_changed"
34074               version="2.26">
34075         <doc xml:whitespace="preserve">Signals that a list of keys have possibly changed.  Backend
34076 implementations should call this if keys have possibly changed their
34077 values.
34078 not containing '//').  Each string in @items must form a valid key
34079 end with '/' and must not contain '//').
34080 The meaning of this signal is that any of the key names resulting
34081 from the contatenation of @path with each item in @items may have
34082 changed.
34083 The same rules for when notifications must occur apply as per
34084 g_settings_backend_changed().  These two calls can be used
34085 interchangeably if exactly one item has changed (although in that
34086 case g_settings_backend_changed() is definitely preferred).
34087 For efficiency reasons, the implementation should strive for @path to
34088 keys that were changed) but this is not strictly required.</doc>
34089         <return-value transfer-ownership="none">
34090           <type name="none" c:type="void"/>
34091         </return-value>
34092         <parameters>
34093           <parameter name="path" transfer-ownership="none">
34094             <doc xml:whitespace="preserve">the path containing the changes</doc>
34095             <type name="utf8" c:type="gchar*"/>
34096           </parameter>
34097           <parameter name="items" transfer-ownership="none">
34098             <doc xml:whitespace="preserve">the %NULL-terminated list of changed keys</doc>
34099             <type name="utf8" c:type="gchar**"/>
34100           </parameter>
34101           <parameter name="origin_tag" transfer-ownership="none">
34102             <doc xml:whitespace="preserve">the origin tag</doc>
34103             <type name="gpointer" c:type="gpointer"/>
34104           </parameter>
34105         </parameters>
34106       </method>
34107       <method name="path_changed"
34108               c:identifier="g_settings_backend_path_changed"
34109               version="2.26">
34110         <doc xml:whitespace="preserve">Signals that all keys below a given path may have possibly changed.
34111 Backend implementations should call this if an entire path of keys
34112 have possibly changed their values.
34113 not containing '//').
34114 The meaning of this signal is that any of the key which has a name
34115 starting with @path may have changed.
34116 The same rules for when notifications must occur apply as per
34117 g_settings_backend_changed().  This call might be an appropriate
34118 reasponse to a 'reset' call but implementations are also free to
34119 explicitly list the keys that were affected by that call if they can
34120 easily do so.
34121 For efficiency reasons, the implementation should strive for @path to
34122 keys that were changed) but this is not strictly required.  As an
34123 example, if this function is called with the path of "/" then every
34124 single key in the application will be notified of a possible change.</doc>
34125         <return-value transfer-ownership="none">
34126           <type name="none" c:type="void"/>
34127         </return-value>
34128         <parameters>
34129           <parameter name="path" transfer-ownership="none">
34130             <doc xml:whitespace="preserve">the path containing the changes</doc>
34131             <type name="utf8" c:type="gchar*"/>
34132           </parameter>
34133           <parameter name="origin_tag" transfer-ownership="none">
34134             <doc xml:whitespace="preserve">the origin tag</doc>
34135             <type name="gpointer" c:type="gpointer"/>
34136           </parameter>
34137         </parameters>
34138       </method>
34139       <method name="path_writable_changed"
34140               c:identifier="g_settings_backend_path_writable_changed"
34141               version="2.26">
34142         <doc xml:whitespace="preserve">Signals that the writability of all keys below a given path may have
34143 changed.
34144 Since GSettings performs no locking operations for itself, this call
34145 will always be made in response to external events.</doc>
34146         <return-value transfer-ownership="none">
34147           <type name="none" c:type="void"/>
34148         </return-value>
34149         <parameters>
34150           <parameter name="path" transfer-ownership="none">
34151             <doc xml:whitespace="preserve">the name of the path</doc>
34152             <type name="utf8" c:type="gchar*"/>
34153           </parameter>
34154         </parameters>
34155       </method>
34156       <method name="writable_changed"
34157               c:identifier="g_settings_backend_writable_changed"
34158               version="2.26">
34159         <doc xml:whitespace="preserve">Signals that the writability of a single key has possibly changed.
34160 Since GSettings performs no locking operations for itself, this call
34161 will always be made in response to external events.</doc>
34162         <return-value transfer-ownership="none">
34163           <type name="none" c:type="void"/>
34164         </return-value>
34165         <parameters>
34166           <parameter name="key" transfer-ownership="none">
34167             <doc xml:whitespace="preserve">the name of the key</doc>
34168             <type name="utf8" c:type="gchar*"/>
34169           </parameter>
34170         </parameters>
34171       </method>
34172       <field name="parent_instance">
34173         <type name="GObject.Object" c:type="GObject"/>
34174       </field>
34175       <field name="priv">
34176         <type name="SettingsBackendPrivate" c:type="GSettingsBackendPrivate*"/>
34177       </field>
34178     </class>
34179     <record name="SettingsBackendClass"
34180             c:type="GSettingsBackendClass"
34181             glib:is-gtype-struct-for="SettingsBackend">
34182       <field name="parent_class">
34183         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
34184       </field>
34185       <field name="read">
34186         <callback name="read">
34187           <return-value transfer-ownership="full">
34188             <type name="GLib.Variant" c:type="GVariant*"/>
34189           </return-value>
34190           <parameters>
34191             <parameter name="backend" transfer-ownership="none">
34192               <type name="SettingsBackend" c:type="GSettingsBackend*"/>
34193             </parameter>
34194             <parameter name="key" transfer-ownership="none">
34195               <type name="utf8" c:type="gchar*"/>
34196             </parameter>
34197             <parameter name="expected_type" transfer-ownership="none">
34198               <type name="GLib.VariantType" c:type="GVariantType*"/>
34199             </parameter>
34200             <parameter name="default_value" transfer-ownership="none">
34201               <type name="gboolean" c:type="gboolean"/>
34202             </parameter>
34203           </parameters>
34204         </callback>
34205       </field>
34206       <field name="get_writable">
34207         <callback name="get_writable">
34208           <return-value transfer-ownership="none">
34209             <type name="gboolean" c:type="gboolean"/>
34210           </return-value>
34211           <parameters>
34212             <parameter name="backend" transfer-ownership="none">
34213               <type name="SettingsBackend" c:type="GSettingsBackend*"/>
34214             </parameter>
34215             <parameter name="key" transfer-ownership="none">
34216               <type name="utf8" c:type="gchar*"/>
34217             </parameter>
34218           </parameters>
34219         </callback>
34220       </field>
34221       <field name="write">
34222         <callback name="write">
34223           <return-value transfer-ownership="none">
34224             <type name="gboolean" c:type="gboolean"/>
34225           </return-value>
34226           <parameters>
34227             <parameter name="backend" transfer-ownership="none">
34228               <type name="SettingsBackend" c:type="GSettingsBackend*"/>
34229             </parameter>
34230             <parameter name="key" transfer-ownership="none">
34231               <type name="utf8" c:type="gchar*"/>
34232             </parameter>
34233             <parameter name="value" transfer-ownership="none">
34234               <type name="GLib.Variant" c:type="GVariant*"/>
34235             </parameter>
34236             <parameter name="origin_tag" transfer-ownership="none">
34237               <type name="gpointer" c:type="gpointer"/>
34238             </parameter>
34239           </parameters>
34240         </callback>
34241       </field>
34242       <field name="write_tree">
34243         <callback name="write_tree">
34244           <return-value transfer-ownership="none">
34245             <type name="gboolean" c:type="gboolean"/>
34246           </return-value>
34247           <parameters>
34248             <parameter name="backend" transfer-ownership="none">
34249               <type name="SettingsBackend" c:type="GSettingsBackend*"/>
34250             </parameter>
34251             <parameter name="tree" transfer-ownership="none">
34252               <type name="GLib.Tree" c:type="GTree*"/>
34253             </parameter>
34254             <parameter name="origin_tag" transfer-ownership="none">
34255               <type name="gpointer" c:type="gpointer"/>
34256             </parameter>
34257           </parameters>
34258         </callback>
34259       </field>
34260       <field name="reset">
34261         <callback name="reset">
34262           <return-value transfer-ownership="none">
34263             <type name="none" c:type="void"/>
34264           </return-value>
34265           <parameters>
34266             <parameter name="backend" transfer-ownership="none">
34267               <type name="SettingsBackend" c:type="GSettingsBackend*"/>
34268             </parameter>
34269             <parameter name="key" transfer-ownership="none">
34270               <type name="utf8" c:type="gchar*"/>
34271             </parameter>
34272             <parameter name="origin_tag" transfer-ownership="none">
34273               <type name="gpointer" c:type="gpointer"/>
34274             </parameter>
34275           </parameters>
34276         </callback>
34277       </field>
34278       <field name="subscribe">
34279         <callback name="subscribe">
34280           <return-value transfer-ownership="none">
34281             <type name="none" c:type="void"/>
34282           </return-value>
34283           <parameters>
34284             <parameter name="backend" transfer-ownership="none">
34285               <type name="SettingsBackend" c:type="GSettingsBackend*"/>
34286             </parameter>
34287             <parameter name="name" transfer-ownership="none">
34288               <type name="utf8" c:type="gchar*"/>
34289             </parameter>
34290           </parameters>
34291         </callback>
34292       </field>
34293       <field name="unsubscribe">
34294         <callback name="unsubscribe">
34295           <return-value transfer-ownership="none">
34296             <type name="none" c:type="void"/>
34297           </return-value>
34298           <parameters>
34299             <parameter name="backend" transfer-ownership="none">
34300               <type name="SettingsBackend" c:type="GSettingsBackend*"/>
34301             </parameter>
34302             <parameter name="name" transfer-ownership="none">
34303               <type name="utf8" c:type="gchar*"/>
34304             </parameter>
34305           </parameters>
34306         </callback>
34307       </field>
34308       <field name="sync">
34309         <callback name="sync">
34310           <return-value transfer-ownership="none">
34311             <type name="none" c:type="void"/>
34312           </return-value>
34313           <parameters>
34314             <parameter name="backend" transfer-ownership="none">
34315               <type name="SettingsBackend" c:type="GSettingsBackend*"/>
34316             </parameter>
34317           </parameters>
34318         </callback>
34319       </field>
34320       <field name="get_permission" introspectable="0">
34321         <callback name="get_permission" introspectable="0">
34322           <return-value>
34323             <type name="Permission" c:type="GPermission*"/>
34324           </return-value>
34325           <parameters>
34326             <parameter name="backend" transfer-ownership="none">
34327               <type name="SettingsBackend" c:type="GSettingsBackend*"/>
34328             </parameter>
34329             <parameter name="path" transfer-ownership="none">
34330               <type name="utf8" c:type="gchar*"/>
34331             </parameter>
34332           </parameters>
34333         </callback>
34334       </field>
34335       <field name="padding">
34336         <array zero-terminated="0" c:type="gpointer" fixed-size="24">
34337           <type name="gpointer" c:type="gpointer"/>
34338         </array>
34339       </field>
34340     </record>
34341     <record name="SettingsBackendPrivate"
34342             c:type="GSettingsBackendPrivate"
34343             disguised="1">
34344     </record>
34345     <bitfield name="SettingsBindFlags"
34346               glib:type-name="GSettingsBindFlags"
34347               glib:get-type="g_settings_bind_flags_get_type"
34348               c:type="GSettingsBindFlags">
34349       <doc xml:whitespace="preserve">Flags used when creating a binding. These flags determine in which
34350 direction the binding works. The default is to synchronize in both
34351 directions.</doc>
34352       <member name="default"
34353               value="0"
34354               c:identifier="G_SETTINGS_BIND_DEFAULT"
34355               glib:nick="default"/>
34356       <member name="get"
34357               value="1"
34358               c:identifier="G_SETTINGS_BIND_GET"
34359               glib:nick="get"/>
34360       <member name="set"
34361               value="2"
34362               c:identifier="G_SETTINGS_BIND_SET"
34363               glib:nick="set"/>
34364       <member name="no_sensitivity"
34365               value="4"
34366               c:identifier="G_SETTINGS_BIND_NO_SENSITIVITY"
34367               glib:nick="no-sensitivity"/>
34368       <member name="get_no_changes"
34369               value="8"
34370               c:identifier="G_SETTINGS_BIND_GET_NO_CHANGES"
34371               glib:nick="get-no-changes"/>
34372       <member name="invert_boolean"
34373               value="16"
34374               c:identifier="G_SETTINGS_BIND_INVERT_BOOLEAN"
34375               glib:nick="invert-boolean"/>
34376     </bitfield>
34377     <callback name="SettingsBindGetMapping" c:type="GSettingsBindGetMapping">
34378       <doc xml:whitespace="preserve">The type for the function that is used to convert from #GSettings to
34379 an object property. The @value is already initialized to hold values
34380 of the appropriate type.</doc>
34381       <return-value transfer-ownership="none">
34382         <doc xml:whitespace="preserve">%TRUE if the conversion succeeded, %FALSE in case of an error</doc>
34383         <type name="gboolean" c:type="gboolean"/>
34384       </return-value>
34385       <parameters>
34386         <parameter name="value" transfer-ownership="none">
34387           <doc xml:whitespace="preserve">return location for the property value</doc>
34388           <type name="GObject.Value" c:type="GValue*"/>
34389         </parameter>
34390         <parameter name="variant" transfer-ownership="none">
34391           <doc xml:whitespace="preserve">the #GVariant</doc>
34392           <type name="GLib.Variant" c:type="GVariant*"/>
34393         </parameter>
34394         <parameter name="user_data" transfer-ownership="none" closure="2">
34395           <doc xml:whitespace="preserve">user data that was specified when the binding was created</doc>
34396           <type name="gpointer" c:type="gpointer"/>
34397         </parameter>
34398       </parameters>
34399     </callback>
34400     <callback name="SettingsBindSetMapping" c:type="GSettingsBindSetMapping">
34401       <doc xml:whitespace="preserve">The type for the function that is used to convert an object property
34402 value to a #GVariant for storing it in #GSettings.</doc>
34403       <return-value transfer-ownership="full">
34404         <doc xml:whitespace="preserve">a new #GVariant holding the data from @value, or %NULL in case of an error</doc>
34405         <type name="GLib.Variant" c:type="GVariant*"/>
34406       </return-value>
34407       <parameters>
34408         <parameter name="value" transfer-ownership="none">
34409           <doc xml:whitespace="preserve">a #GValue containing the property value to map</doc>
34410           <type name="GObject.Value" c:type="GValue*"/>
34411         </parameter>
34412         <parameter name="expected_type" transfer-ownership="none">
34413           <doc xml:whitespace="preserve">the #GVariantType to create</doc>
34414           <type name="GLib.VariantType" c:type="GVariantType*"/>
34415         </parameter>
34416         <parameter name="user_data" transfer-ownership="none" closure="2">
34417           <doc xml:whitespace="preserve">user data that was specified when the binding was created</doc>
34418           <type name="gpointer" c:type="gpointer"/>
34419         </parameter>
34420       </parameters>
34421     </callback>
34422     <record name="SettingsClass"
34423             c:type="GSettingsClass"
34424             glib:is-gtype-struct-for="Settings">
34425       <field name="parent_class">
34426         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
34427       </field>
34428       <field name="writable_changed">
34429         <callback name="writable_changed">
34430           <return-value transfer-ownership="none">
34431             <type name="none" c:type="void"/>
34432           </return-value>
34433           <parameters>
34434             <parameter name="settings" transfer-ownership="none">
34435               <type name="Settings" c:type="GSettings*"/>
34436             </parameter>
34437             <parameter name="key" transfer-ownership="none">
34438               <type name="utf8" c:type="gchar*"/>
34439             </parameter>
34440           </parameters>
34441         </callback>
34442       </field>
34443       <field name="changed">
34444         <callback name="changed">
34445           <return-value transfer-ownership="none">
34446             <type name="none" c:type="void"/>
34447           </return-value>
34448           <parameters>
34449             <parameter name="settings" transfer-ownership="none">
34450               <type name="Settings" c:type="GSettings*"/>
34451             </parameter>
34452             <parameter name="key" transfer-ownership="none">
34453               <type name="utf8" c:type="gchar*"/>
34454             </parameter>
34455           </parameters>
34456         </callback>
34457       </field>
34458       <field name="writable_change_event">
34459         <callback name="writable_change_event">
34460           <return-value transfer-ownership="none">
34461             <type name="gboolean" c:type="gboolean"/>
34462           </return-value>
34463           <parameters>
34464             <parameter name="settings" transfer-ownership="none">
34465               <type name="Settings" c:type="GSettings*"/>
34466             </parameter>
34467             <parameter name="key" transfer-ownership="none">
34468               <type name="GLib.Quark" c:type="GQuark"/>
34469             </parameter>
34470           </parameters>
34471         </callback>
34472       </field>
34473       <field name="change_event">
34474         <callback name="change_event">
34475           <return-value transfer-ownership="none">
34476             <type name="gboolean" c:type="gboolean"/>
34477           </return-value>
34478           <parameters>
34479             <parameter name="settings" transfer-ownership="none">
34480               <type name="Settings" c:type="GSettings*"/>
34481             </parameter>
34482             <parameter name="keys" transfer-ownership="none">
34483               <type name="GLib.Quark" c:type="GQuark*"/>
34484             </parameter>
34485             <parameter name="n_keys" transfer-ownership="none">
34486               <type name="gint" c:type="gint"/>
34487             </parameter>
34488           </parameters>
34489         </callback>
34490       </field>
34491       <field name="padding">
34492         <array zero-terminated="0" c:type="gpointer" fixed-size="20">
34493           <type name="gpointer" c:type="gpointer"/>
34494         </array>
34495       </field>
34496     </record>
34497     <callback name="SettingsGetMapping" c:type="GSettingsGetMapping">
34498       <doc xml:whitespace="preserve">The type of the function that is used to convert from a value stored
34499 in a #GSettings to a value that is useful to the application.
34500 If the value is successfully mapped, the result should be stored at
34501 is not in the right format) then %FALSE should be returned.
34502 If @value is %NULL then it means that the mapping function is being
34503 given a "last chance" to successfully return a valid value.  %TRUE
34504 must be returned in this case.</doc>
34505       <return-value transfer-ownership="none">
34506         <doc xml:whitespace="preserve">%TRUE if the conversion succeeded, %FALSE in case of an error</doc>
34507         <type name="gboolean" c:type="gboolean"/>
34508       </return-value>
34509       <parameters>
34510         <parameter name="value" transfer-ownership="none">
34511           <doc xml:whitespace="preserve">the #GVariant to map, or %NULL</doc>
34512           <type name="GLib.Variant" c:type="GVariant*"/>
34513         </parameter>
34514         <parameter name="result" transfer-ownership="none">
34515           <doc xml:whitespace="preserve">the result of the mapping</doc>
34516           <type name="gpointer" c:type="gpointer*"/>
34517         </parameter>
34518         <parameter name="user_data" transfer-ownership="none" closure="2">
34519           <doc xml:whitespace="preserve">the user data that was passed to g_settings_get_mapped()</doc>
34520           <type name="gpointer" c:type="gpointer"/>
34521         </parameter>
34522       </parameters>
34523     </callback>
34524     <record name="SettingsPrivate" c:type="GSettingsPrivate" disguised="1">
34525     </record>
34526     <class name="SimpleAction"
34527            c:symbol-prefix="simple_action"
34528            c:type="GSimpleAction"
34529            version="2.26"
34530            parent="GObject.Object"
34531            glib:type-name="GSimpleAction"
34532            glib:get-type="g_simple_action_get_type"
34533            glib:type-struct="SimpleActionClass">
34534       <doc xml:whitespace="preserve">The &lt;structname&gt;GSimpleAction&lt;/structname&gt; structure contains private
34535 data and should only be accessed using the provided API</doc>
34536       <implements name="Action"/>
34537       <constructor name="new"
34538                    c:identifier="g_simple_action_new"
34539                    version="2.26">
34540         <doc xml:whitespace="preserve">Creates a new action.
34541 The created action is stateless.  See g_simple_action_new_stateful().</doc>
34542         <return-value transfer-ownership="full">
34543           <doc xml:whitespace="preserve">a new #GSimpleAction</doc>
34544           <type name="SimpleAction" c:type="GSimpleAction*"/>
34545         </return-value>
34546         <parameters>
34547           <parameter name="name" transfer-ownership="none">
34548             <doc xml:whitespace="preserve">the name of the action</doc>
34549             <type name="utf8" c:type="gchar*"/>
34550           </parameter>
34551           <parameter name="parameter_type"
34552                      transfer-ownership="none"
34553                      allow-none="1">
34554             <doc xml:whitespace="preserve">the type of parameter to the activate function</doc>
34555             <type name="GLib.VariantType" c:type="GVariantType*"/>
34556           </parameter>
34557         </parameters>
34558       </constructor>
34559       <constructor name="new_stateful"
34560                    c:identifier="g_simple_action_new_stateful"
34561                    version="2.26">
34562         <doc xml:whitespace="preserve">Creates a new stateful action.
34563 must have the same #GVariantType as the initial state.
34564 If the @state GVariant is floating, it is consumed.</doc>
34565         <return-value transfer-ownership="full">
34566           <doc xml:whitespace="preserve">a new #GSimpleAction</doc>
34567           <type name="SimpleAction" c:type="GSimpleAction*"/>
34568         </return-value>
34569         <parameters>
34570           <parameter name="name" transfer-ownership="none">
34571             <doc xml:whitespace="preserve">the name of the action</doc>
34572             <type name="utf8" c:type="gchar*"/>
34573           </parameter>
34574           <parameter name="parameter_type"
34575                      transfer-ownership="none"
34576                      allow-none="1">
34577             <doc xml:whitespace="preserve">the type of the parameter to the activate function</doc>
34578             <type name="GLib.VariantType" c:type="GVariantType*"/>
34579           </parameter>
34580           <parameter name="state" transfer-ownership="none">
34581             <doc xml:whitespace="preserve">the initial state of the action</doc>
34582             <type name="GLib.Variant" c:type="GVariant*"/>
34583           </parameter>
34584         </parameters>
34585       </constructor>
34586       <method name="set_enabled"
34587               c:identifier="g_simple_action_set_enabled"
34588               version="2.26">
34589         <doc xml:whitespace="preserve">Sets the action as enabled or not.
34590 An action must be enabled in order to be activated or in order to
34591 have its state changed from outside callers.</doc>
34592         <return-value transfer-ownership="none">
34593           <type name="none" c:type="void"/>
34594         </return-value>
34595         <parameters>
34596           <parameter name="enabled" transfer-ownership="none">
34597             <doc xml:whitespace="preserve">whether the action is enabled</doc>
34598             <type name="gboolean" c:type="gboolean"/>
34599           </parameter>
34600         </parameters>
34601       </method>
34602       <property name="enabled"
34603                 version="2.26"
34604                 writable="1"
34605                 construct="1"
34606                 transfer-ownership="none">
34607         <doc xml:whitespace="preserve">If @action is currently enabled.
34608 If the action is disabled then calls to g_simple_action_activate() and
34609 g_simple_action_set_state() have no effect.</doc>
34610         <type name="gboolean"/>
34611       </property>
34612       <property name="name"
34613                 version="2.26"
34614                 writable="1"
34615                 construct-only="1"
34616                 transfer-ownership="none">
34617         <doc xml:whitespace="preserve">The name of the action.  This is mostly meaningful for identifying
34618 the action once it has been added to a #GSimpleActionGroup.</doc>
34619         <type name="utf8"/>
34620       </property>
34621       <property name="parameter-type"
34622                 version="2.26"
34623                 introspectable="0"
34624                 writable="1"
34625                 construct-only="1"
34626                 transfer-ownership="none">
34627         <doc xml:whitespace="preserve">The type of the parameter that must be given when activating the
34628 action.</doc>
34629         <type/>
34630       </property>
34631       <property name="state"
34632                 version="2.26"
34633                 writable="1"
34634                 construct="1"
34635                 transfer-ownership="none">
34636         <doc xml:whitespace="preserve">The state of the action, or %NULL if the action is stateless.</doc>
34637         <type name="GLib.Variant"/>
34638       </property>
34639       <property name="state-type"
34640                 version="2.26"
34641                 introspectable="0"
34642                 transfer-ownership="none">
34643         <doc xml:whitespace="preserve">The #GVariantType of the state that the action has, or %NULL if the
34644 action is stateless.</doc>
34645         <type/>
34646       </property>
34647       <field name="parent_instance">
34648         <type name="GObject.Object" c:type="GObject"/>
34649       </field>
34650       <field name="priv">
34651         <type name="SimpleActionPrivate" c:type="GSimpleActionPrivate*"/>
34652       </field>
34653       <glib:signal name="activate" version="2.26">
34654         <doc xml:whitespace="preserve">Indicates that the action was just activated.
34655 an incorrect type was given, no signal will be emitted.</doc>
34656         <return-value transfer-ownership="none">
34657           <type name="none"/>
34658         </return-value>
34659         <parameters>
34660           <parameter name="object" transfer-ownership="none" allow-none="1">
34661             <doc xml:whitespace="preserve">the parameter to the activation</doc>
34662             <type name="GLib.Variant"/>
34663           </parameter>
34664         </parameters>
34665       </glib:signal>
34666     </class>
34667     <record name="SimpleActionClass"
34668             c:type="GSimpleActionClass"
34669             glib:is-gtype-struct-for="SimpleAction"
34670             version="2.26">
34671       <field name="parent_class">
34672         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
34673       </field>
34674       <field name="activate">
34675         <callback name="activate">
34676           <return-value transfer-ownership="none">
34677             <type name="none" c:type="void"/>
34678           </return-value>
34679           <parameters>
34680             <parameter name="simple" transfer-ownership="none">
34681               <type name="SimpleAction" c:type="GSimpleAction*"/>
34682             </parameter>
34683             <parameter name="parameter" transfer-ownership="none">
34684               <type name="GLib.Variant" c:type="GVariant*"/>
34685             </parameter>
34686           </parameters>
34687         </callback>
34688       </field>
34689       <field name="padding">
34690         <array zero-terminated="0" c:type="gpointer" fixed-size="6">
34691           <type name="gpointer" c:type="gpointer"/>
34692         </array>
34693       </field>
34694     </record>
34695     <class name="SimpleActionGroup"
34696            c:symbol-prefix="simple_action_group"
34697            c:type="GSimpleActionGroup"
34698            version="2.26"
34699            parent="GObject.Object"
34700            glib:type-name="GSimpleActionGroup"
34701            glib:get-type="g_simple_action_group_get_type"
34702            glib:type-struct="SimpleActionGroupClass">
34703       <doc xml:whitespace="preserve">The #GSimpleActionGroup structure contains private data and should only be accessed using the provided API.</doc>
34704       <implements name="ActionGroup"/>
34705       <constructor name="new"
34706                    c:identifier="g_simple_action_group_new"
34707                    version="2.26">
34708         <doc xml:whitespace="preserve">Creates a new, empty, #GSimpleActionGroup.</doc>
34709         <return-value transfer-ownership="full">
34710           <doc xml:whitespace="preserve">a new #GSimpleActionGroup</doc>
34711           <type name="SimpleActionGroup" c:type="GSimpleActionGroup*"/>
34712         </return-value>
34713       </constructor>
34714       <method name="insert"
34715               c:identifier="g_simple_action_group_insert"
34716               version="2.26">
34717         <doc xml:whitespace="preserve">Adds an action to the action group.
34718 If the action group already contains an action with the same name as
34719 The action group takes its own reference on @action.</doc>
34720         <return-value transfer-ownership="none">
34721           <type name="none" c:type="void"/>
34722         </return-value>
34723         <parameters>
34724           <parameter name="action" transfer-ownership="none">
34725             <doc xml:whitespace="preserve">a #GAction</doc>
34726             <type name="Action" c:type="GAction*"/>
34727           </parameter>
34728         </parameters>
34729       </method>
34730       <method name="lookup"
34731               c:identifier="g_simple_action_group_lookup"
34732               version="2.26">
34733         <doc xml:whitespace="preserve">Looks up the action with the name @action_name in the group.
34734 If no such action exists, returns %NULL.</doc>
34735         <return-value transfer-ownership="none">
34736           <doc xml:whitespace="preserve">a #GAction, or %NULL</doc>
34737           <type name="Action" c:type="GAction*"/>
34738         </return-value>
34739         <parameters>
34740           <parameter name="action_name" transfer-ownership="none">
34741             <doc xml:whitespace="preserve">the name of an action</doc>
34742             <type name="utf8" c:type="gchar*"/>
34743           </parameter>
34744         </parameters>
34745       </method>
34746       <method name="remove"
34747               c:identifier="g_simple_action_group_remove"
34748               version="2.26">
34749         <doc xml:whitespace="preserve">Removes the named action from the action group.
34750 If no action of this name is in the group then nothing happens.</doc>
34751         <return-value transfer-ownership="none">
34752           <type name="none" c:type="void"/>
34753         </return-value>
34754         <parameters>
34755           <parameter name="action_name" transfer-ownership="none">
34756             <doc xml:whitespace="preserve">the name of the action</doc>
34757             <type name="utf8" c:type="gchar*"/>
34758           </parameter>
34759         </parameters>
34760       </method>
34761       <field name="parent_instance">
34762         <type name="GObject.Object" c:type="GObject"/>
34763       </field>
34764       <field name="priv">
34765         <type name="SimpleActionGroupPrivate"
34766               c:type="GSimpleActionGroupPrivate*"/>
34767       </field>
34768     </class>
34769     <record name="SimpleActionGroupClass"
34770             c:type="GSimpleActionGroupClass"
34771             glib:is-gtype-struct-for="SimpleActionGroup">
34772       <field name="parent_class">
34773         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
34774       </field>
34775       <field name="padding">
34776         <array zero-terminated="0" c:type="gpointer" fixed-size="12">
34777           <type name="gpointer" c:type="gpointer"/>
34778         </array>
34779       </field>
34780     </record>
34781     <record name="SimpleActionGroupPrivate"
34782             c:type="GSimpleActionGroupPrivate"
34783             disguised="1">
34784     </record>
34785     <record name="SimpleActionPrivate"
34786             c:type="GSimpleActionPrivate"
34787             disguised="1">
34788     </record>
34789     <class name="SimpleAsyncResult"
34790            c:symbol-prefix="simple_async_result"
34791            c:type="GSimpleAsyncResult"
34792            parent="GObject.Object"
34793            glib:type-name="GSimpleAsyncResult"
34794            glib:get-type="g_simple_async_result_get_type"
34795            glib:type-struct="SimpleAsyncResultClass">
34796       <doc xml:whitespace="preserve">A simple implementation of #GAsyncResult.</doc>
34797       <implements name="AsyncResult"/>
34798       <constructor name="new" c:identifier="g_simple_async_result_new">
34799         <doc xml:whitespace="preserve">Creates a #GSimpleAsyncResult.</doc>
34800         <return-value transfer-ownership="full">
34801           <doc xml:whitespace="preserve">a #GSimpleAsyncResult.</doc>
34802           <type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
34803         </return-value>
34804         <parameters>
34805           <parameter name="source_object" transfer-ownership="none">
34806             <doc xml:whitespace="preserve">a #GObject the asynchronous function was called with, or %NULL.</doc>
34807             <type name="GObject.Object" c:type="GObject*"/>
34808           </parameter>
34809           <parameter name="callback"
34810                      transfer-ownership="none"
34811                      scope="async"
34812                      closure="2">
34813             <doc xml:whitespace="preserve">a #GAsyncReadyCallback.</doc>
34814             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
34815           </parameter>
34816           <parameter name="user_data" transfer-ownership="none">
34817             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
34818             <type name="gpointer" c:type="gpointer"/>
34819           </parameter>
34820           <parameter name="source_tag" transfer-ownership="none">
34821             <doc xml:whitespace="preserve">the asynchronous function.</doc>
34822             <type name="gpointer" c:type="gpointer"/>
34823           </parameter>
34824         </parameters>
34825       </constructor>
34826       <constructor name="new_error"
34827                    c:identifier="g_simple_async_result_new_error"
34828                    introspectable="0">
34829         <doc xml:whitespace="preserve">Creates a new #GSimpleAsyncResult with a set error.</doc>
34830         <return-value transfer-ownership="full">
34831           <doc xml:whitespace="preserve">a #GSimpleAsyncResult.</doc>
34832           <type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
34833         </return-value>
34834         <parameters>
34835           <parameter name="source_object" transfer-ownership="none">
34836             <doc xml:whitespace="preserve">a #GObject, or %NULL.</doc>
34837             <type name="GObject.Object" c:type="GObject*"/>
34838           </parameter>
34839           <parameter name="callback"
34840                      transfer-ownership="none"
34841                      scope="async"
34842                      closure="2">
34843             <doc xml:whitespace="preserve">a #GAsyncReadyCallback.</doc>
34844             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
34845           </parameter>
34846           <parameter name="user_data" transfer-ownership="none">
34847             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
34848             <type name="gpointer" c:type="gpointer"/>
34849           </parameter>
34850           <parameter name="domain" transfer-ownership="none">
34851             <doc xml:whitespace="preserve">a #GQuark.</doc>
34852             <type name="GLib.Quark" c:type="GQuark"/>
34853           </parameter>
34854           <parameter name="code" transfer-ownership="none">
34855             <doc xml:whitespace="preserve">an error code.</doc>
34856             <type name="gint" c:type="gint"/>
34857           </parameter>
34858           <parameter name="format" transfer-ownership="none">
34859             <doc xml:whitespace="preserve">a string with format characters.</doc>
34860             <type name="utf8" c:type="char*"/>
34861           </parameter>
34862           <parameter transfer-ownership="none">
34863             <varargs>
34864             </varargs>
34865           </parameter>
34866         </parameters>
34867       </constructor>
34868       <constructor name="new_from_error"
34869                    c:identifier="g_simple_async_result_new_from_error">
34870         <doc xml:whitespace="preserve">Creates a #GSimpleAsyncResult from an error condition.</doc>
34871         <return-value transfer-ownership="full">
34872           <doc xml:whitespace="preserve">a #GSimpleAsyncResult.</doc>
34873           <type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
34874         </return-value>
34875         <parameters>
34876           <parameter name="source_object" transfer-ownership="none">
34877             <doc xml:whitespace="preserve">a #GObject, or %NULL.</doc>
34878             <type name="GObject.Object" c:type="GObject*"/>
34879           </parameter>
34880           <parameter name="callback"
34881                      transfer-ownership="none"
34882                      scope="async"
34883                      closure="2">
34884             <doc xml:whitespace="preserve">a #GAsyncReadyCallback.</doc>
34885             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
34886           </parameter>
34887           <parameter name="user_data" transfer-ownership="none">
34888             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
34889             <type name="gpointer" c:type="gpointer"/>
34890           </parameter>
34891           <parameter name="error" transfer-ownership="none">
34892             <doc xml:whitespace="preserve">a #GError location.</doc>
34893             <type name="GLib.Error" c:type="GError*"/>
34894           </parameter>
34895         </parameters>
34896       </constructor>
34897       <function name="is_valid" c:identifier="g_simple_async_result_is_valid">
34898         <doc xml:whitespace="preserve">Ensures that the data passed to the _finish function of an async
34899 operation is consistent.  Three checks are performed.
34900 First, @result is checked to ensure that it is really a
34901 #GSimpleAsyncResult.  Second, @source is checked to ensure that it
34902 matches the source object of @result.  Third, @source_tag is
34903 checked to ensure that it is either %NULL (as it is when the result was
34904 created by g_simple_async_report_error_in_idle() or
34905 g_simple_async_report_gerror_in_idle()) or equal to the
34906 convention, is a pointer to the _async function corresponding to the
34907 _finish function from which this function is called).</doc>
34908         <return-value transfer-ownership="none">
34909           <doc xml:whitespace="preserve">#TRUE if all checks passed or #FALSE if any failed.</doc>
34910           <type name="gboolean" c:type="gboolean"/>
34911         </return-value>
34912         <parameters>
34913           <parameter name="result" transfer-ownership="none">
34914             <doc xml:whitespace="preserve">the #GAsyncResult passed to the _finish function.</doc>
34915             <type name="AsyncResult" c:type="GAsyncResult*"/>
34916           </parameter>
34917           <parameter name="source" transfer-ownership="none">
34918             <doc xml:whitespace="preserve">the #GObject passed to the _finish function.</doc>
34919             <type name="GObject.Object" c:type="GObject*"/>
34920           </parameter>
34921           <parameter name="source_tag" transfer-ownership="none">
34922             <doc xml:whitespace="preserve">the asynchronous function.</doc>
34923             <type name="gpointer" c:type="gpointer"/>
34924           </parameter>
34925         </parameters>
34926       </function>
34927       <method name="complete" c:identifier="g_simple_async_result_complete">
34928         <doc xml:whitespace="preserve">Completes an asynchronous I/O job immediately. Must be called in
34929 the thread where the asynchronous result was to be delivered, as it
34930 invokes the callback directly. If you are in a different thread use
34931 g_simple_async_result_complete_in_idle().
34932 Calling this function takes a reference to @simple for as long as
34933 is needed to complete the call.</doc>
34934         <return-value transfer-ownership="none">
34935           <type name="none" c:type="void"/>
34936         </return-value>
34937       </method>
34938       <method name="complete_in_idle"
34939               c:identifier="g_simple_async_result_complete_in_idle">
34940         <doc xml:whitespace="preserve">Completes an asynchronous function in an idle handler in the &lt;link
34941 linkend="g-main-context-push-thread-default"&gt;thread-default main
34942 loop&lt;/link&gt; of the thread that @simple was initially created in.
34943 Calling this function takes a reference to @simple for as long as
34944 is needed to complete the call.</doc>
34945         <return-value transfer-ownership="none">
34946           <type name="none" c:type="void"/>
34947         </return-value>
34948       </method>
34949       <method name="get_op_res_gboolean"
34950               c:identifier="g_simple_async_result_get_op_res_gboolean">
34951         <doc xml:whitespace="preserve">Gets the operation result boolean from within the asynchronous result.
34952 if the operation's result was %FALSE.</doc>
34953         <return-value transfer-ownership="none">
34954           <doc xml:whitespace="preserve">%TRUE if the operation's result was %TRUE, %FALSE</doc>
34955           <type name="gboolean" c:type="gboolean"/>
34956         </return-value>
34957       </method>
34958       <method name="get_op_res_gpointer"
34959               c:identifier="g_simple_async_result_get_op_res_gpointer"
34960               introspectable="0">
34961         <doc xml:whitespace="preserve">Gets a pointer result as returned by the asynchronous function.</doc>
34962         <return-value>
34963           <doc xml:whitespace="preserve">a pointer from the result.</doc>
34964           <type name="gpointer" c:type="gpointer"/>
34965         </return-value>
34966       </method>
34967       <method name="get_op_res_gssize"
34968               c:identifier="g_simple_async_result_get_op_res_gssize">
34969         <doc xml:whitespace="preserve">Gets a gssize from the asynchronous result.</doc>
34970         <return-value transfer-ownership="none">
34971           <doc xml:whitespace="preserve">a gssize returned from the asynchronous function.</doc>
34972           <type name="glong" c:type="gssize"/>
34973         </return-value>
34974       </method>
34975       <method name="get_source_tag"
34976               c:identifier="g_simple_async_result_get_source_tag"
34977               introspectable="0">
34978         <doc xml:whitespace="preserve">Gets the source tag for the #GSimpleAsyncResult.</doc>
34979         <return-value>
34980           <doc xml:whitespace="preserve">a #gpointer to the source object for the #GSimpleAsyncResult.</doc>
34981           <type name="gpointer" c:type="gpointer"/>
34982         </return-value>
34983       </method>
34984       <method name="propagate_error"
34985               c:identifier="g_simple_async_result_propagate_error"
34986               throws="1">
34987         <doc xml:whitespace="preserve">Propagates an error from within the simple asynchronous result to
34988 a given destination.</doc>
34989         <return-value transfer-ownership="none">
34990           <doc xml:whitespace="preserve">%TRUE if the error was propagated to @dest. %FALSE otherwise.</doc>
34991           <type name="gboolean" c:type="gboolean"/>
34992         </return-value>
34993       </method>
34994       <method name="run_in_thread"
34995               c:identifier="g_simple_async_result_run_in_thread"
34996               introspectable="0">
34997         <doc xml:whitespace="preserve">Runs the asynchronous job in a separate thread and then calls
34998 g_simple_async_result_complete_in_idle() on @simple to return
34999 the result to the appropriate main loop.
35000 Calling this function takes a reference to @simple for as long as
35001 is needed to run the job and report its completion.</doc>
35002         <return-value transfer-ownership="none">
35003           <type name="none" c:type="void"/>
35004         </return-value>
35005         <parameters>
35006           <parameter name="func" transfer-ownership="none">
35007             <doc xml:whitespace="preserve">a #GSimpleAsyncThreadFunc.</doc>
35008             <type name="SimpleAsyncThreadFunc"
35009                   c:type="GSimpleAsyncThreadFunc"/>
35010           </parameter>
35011           <parameter name="io_priority" transfer-ownership="none">
35012             <doc xml:whitespace="preserve">the io priority of the request.</doc>
35013             <type name="gint" c:type="int"/>
35014           </parameter>
35015           <parameter name="cancellable"
35016                      transfer-ownership="none"
35017                      allow-none="1">
35018             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
35019             <type name="Cancellable" c:type="GCancellable*"/>
35020           </parameter>
35021         </parameters>
35022       </method>
35023       <method name="set_error"
35024               c:identifier="g_simple_async_result_set_error"
35025               introspectable="0">
35026         <doc xml:whitespace="preserve">Sets an error within the asynchronous result without a #GError.</doc>
35027         <return-value transfer-ownership="none">
35028           <type name="none" c:type="void"/>
35029         </return-value>
35030         <parameters>
35031           <parameter name="domain" transfer-ownership="none">
35032             <doc xml:whitespace="preserve">a #GQuark (usually #G_IO_ERROR).</doc>
35033             <type name="GLib.Quark" c:type="GQuark"/>
35034           </parameter>
35035           <parameter name="code" transfer-ownership="none">
35036             <doc xml:whitespace="preserve">an error code.</doc>
35037             <type name="gint" c:type="gint"/>
35038           </parameter>
35039           <parameter name="format" transfer-ownership="none">
35040             <doc xml:whitespace="preserve">a formatted error reporting string.</doc>
35041             <type name="utf8" c:type="char*"/>
35042           </parameter>
35043           <parameter transfer-ownership="none">
35044             <varargs>
35045             </varargs>
35046           </parameter>
35047         </parameters>
35048       </method>
35049       <method name="set_error_va"
35050               c:identifier="g_simple_async_result_set_error_va"
35051               introspectable="0">
35052         <doc xml:whitespace="preserve">Sets an error within the asynchronous result without a #GError.
35053 Unless writing a binding, see g_simple_async_result_set_error().</doc>
35054         <return-value transfer-ownership="none">
35055           <type name="none" c:type="void"/>
35056         </return-value>
35057         <parameters>
35058           <parameter name="domain" transfer-ownership="none">
35059             <doc xml:whitespace="preserve">a #GQuark (usually #G_IO_ERROR).</doc>
35060             <type name="GLib.Quark" c:type="GQuark"/>
35061           </parameter>
35062           <parameter name="code" transfer-ownership="none">
35063             <doc xml:whitespace="preserve">an error code.</doc>
35064             <type name="gint" c:type="gint"/>
35065           </parameter>
35066           <parameter name="format" transfer-ownership="none">
35067             <doc xml:whitespace="preserve">a formatted error reporting string.</doc>
35068             <type name="utf8" c:type="char*"/>
35069           </parameter>
35070           <parameter name="args" transfer-ownership="none">
35071             <doc xml:whitespace="preserve">va_list of arguments.</doc>
35072             <type name="va_list" c:type="va_list"/>
35073           </parameter>
35074         </parameters>
35075       </method>
35076       <method name="set_from_error"
35077               c:identifier="g_simple_async_result_set_from_error">
35078         <doc xml:whitespace="preserve">Sets the result from a #GError.</doc>
35079         <return-value transfer-ownership="none">
35080           <type name="none" c:type="void"/>
35081         </return-value>
35082         <parameters>
35083           <parameter name="error" transfer-ownership="none">
35084             <doc xml:whitespace="preserve">#GError.</doc>
35085             <type name="GLib.Error" c:type="GError*"/>
35086           </parameter>
35087         </parameters>
35088       </method>
35089       <method name="set_handle_cancellation"
35090               c:identifier="g_simple_async_result_set_handle_cancellation">
35091         <doc xml:whitespace="preserve">Sets whether to handle cancellation within the asynchronous operation.</doc>
35092         <return-value transfer-ownership="none">
35093           <type name="none" c:type="void"/>
35094         </return-value>
35095         <parameters>
35096           <parameter name="handle_cancellation" transfer-ownership="none">
35097             <doc xml:whitespace="preserve">a #gboolean.</doc>
35098             <type name="gboolean" c:type="gboolean"/>
35099           </parameter>
35100         </parameters>
35101       </method>
35102       <method name="set_op_res_gboolean"
35103               c:identifier="g_simple_async_result_set_op_res_gboolean">
35104         <doc xml:whitespace="preserve">Sets the operation result to a boolean within the asynchronous result.</doc>
35105         <return-value transfer-ownership="none">
35106           <type name="none" c:type="void"/>
35107         </return-value>
35108         <parameters>
35109           <parameter name="op_res" transfer-ownership="none">
35110             <doc xml:whitespace="preserve">a #gboolean.</doc>
35111             <type name="gboolean" c:type="gboolean"/>
35112           </parameter>
35113         </parameters>
35114       </method>
35115       <method name="set_op_res_gpointer"
35116               c:identifier="g_simple_async_result_set_op_res_gpointer">
35117         <doc xml:whitespace="preserve">Sets the operation result within the asynchronous result to a pointer.</doc>
35118         <return-value transfer-ownership="none">
35119           <type name="none" c:type="void"/>
35120         </return-value>
35121         <parameters>
35122           <parameter name="op_res" transfer-ownership="none">
35123             <doc xml:whitespace="preserve">a pointer result from an asynchronous function.</doc>
35124             <type name="gpointer" c:type="gpointer"/>
35125           </parameter>
35126           <parameter name="destroy_op_res"
35127                      transfer-ownership="none"
35128                      scope="async">
35129             <doc xml:whitespace="preserve">a #GDestroyNotify function.</doc>
35130             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
35131           </parameter>
35132         </parameters>
35133       </method>
35134       <method name="set_op_res_gssize"
35135               c:identifier="g_simple_async_result_set_op_res_gssize">
35136         <doc xml:whitespace="preserve">Sets the operation result within the asynchronous result to
35137 the given @op_res.</doc>
35138         <return-value transfer-ownership="none">
35139           <type name="none" c:type="void"/>
35140         </return-value>
35141         <parameters>
35142           <parameter name="op_res" transfer-ownership="none">
35143             <doc xml:whitespace="preserve">a #gssize.</doc>
35144             <type name="glong" c:type="gssize"/>
35145           </parameter>
35146         </parameters>
35147       </method>
35148     </class>
35149     <record name="SimpleAsyncResultClass"
35150             c:type="GSimpleAsyncResultClass"
35151             disguised="1"
35152             glib:is-gtype-struct-for="SimpleAsyncResult">
35153     </record>
35154     <callback name="SimpleAsyncThreadFunc" c:type="GSimpleAsyncThreadFunc">
35155       <doc xml:whitespace="preserve">Simple thread function that runs an asynchronous operation and
35156 checks for cancellation.</doc>
35157       <return-value transfer-ownership="none">
35158         <type name="none" c:type="void"/>
35159       </return-value>
35160       <parameters>
35161         <parameter name="res" transfer-ownership="none">
35162           <doc xml:whitespace="preserve">a #GSimpleAsyncResult.</doc>
35163           <type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
35164         </parameter>
35165         <parameter name="object" transfer-ownership="none">
35166           <doc xml:whitespace="preserve">a #GObject.</doc>
35167           <type name="GObject.Object" c:type="GObject*"/>
35168         </parameter>
35169         <parameter name="cancellable" transfer-ownership="none" allow-none="1">
35170           <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
35171           <type name="Cancellable" c:type="GCancellable*"/>
35172         </parameter>
35173       </parameters>
35174     </callback>
35175     <class name="SimplePermission"
35176            c:symbol-prefix="simple_permission"
35177            c:type="GSimplePermission"
35178            parent="Permission"
35179            glib:type-name="GSimplePermission"
35180            glib:get-type="g_simple_permission_get_type">
35181       <doc xml:whitespace="preserve">#GSimplePermission is an opaque data structure.  There are no methods
35182 except for those defined by #GPermission.</doc>
35183       <constructor name="new"
35184                    c:identifier="g_simple_permission_new"
35185                    version="2.26">
35186         <doc xml:whitespace="preserve">Creates a new #GPermission instance that represents an action that is
35187 either always or never allowed.</doc>
35188         <return-value transfer-ownership="full">
35189           <doc xml:whitespace="preserve">the #GSimplePermission, as a #GPermission</doc>
35190           <type name="Permission" c:type="GPermission*"/>
35191         </return-value>
35192         <parameters>
35193           <parameter name="allowed" transfer-ownership="none">
35194             <doc xml:whitespace="preserve">%TRUE if the action is allowed</doc>
35195             <type name="gboolean" c:type="gboolean"/>
35196           </parameter>
35197         </parameters>
35198       </constructor>
35199     </class>
35200     <class name="Socket"
35201            c:symbol-prefix="socket"
35202            c:type="GSocket"
35203            version="2.22"
35204            parent="GObject.Object"
35205            glib:type-name="GSocket"
35206            glib:get-type="g_socket_get_type"
35207            glib:type-struct="SocketClass">
35208       <doc xml:whitespace="preserve">A lowlevel network socket object.</doc>
35209       <implements name="Initable"/>
35210       <constructor name="new"
35211                    c:identifier="g_socket_new"
35212                    version="2.22"
35213                    throws="1">
35214         <doc xml:whitespace="preserve">Creates a new #GSocket with the defined family, type and protocol.
35215 If @protocol is 0 (%G_SOCKET_PROTOCOL_DEFAULT) the default protocol type
35216 for the family and type is used.
35217 The @protocol is a family and type specific int that specifies what
35218 kind of protocol to use. #GSocketProtocol lists several common ones.
35219 Many families only support one protocol, and use 0 for this, others
35220 support several and using 0 means to use the default protocol for
35221 the family and type.
35222 The protocol id is passed directly to the operating
35223 system, so you can use protocols not listed in #GSocketProtocol if you
35224 know the protocol number used for it.
35225 Free the returned object with g_object_unref().</doc>
35226         <return-value transfer-ownership="full">
35227           <doc xml:whitespace="preserve">a #GSocket or %NULL on error.</doc>
35228           <type name="Socket" c:type="GSocket*"/>
35229         </return-value>
35230         <parameters>
35231           <parameter name="family" transfer-ownership="none">
35232             <doc xml:whitespace="preserve">the socket family to use, e.g. %G_SOCKET_FAMILY_IPV4.</doc>
35233             <type name="SocketFamily" c:type="GSocketFamily"/>
35234           </parameter>
35235           <parameter name="type" transfer-ownership="none">
35236             <doc xml:whitespace="preserve">the socket type to use.</doc>
35237             <type name="SocketType" c:type="GSocketType"/>
35238           </parameter>
35239           <parameter name="protocol" transfer-ownership="none">
35240             <doc xml:whitespace="preserve">the id of the protocol to use, or 0 for default.</doc>
35241             <type name="SocketProtocol" c:type="GSocketProtocol"/>
35242           </parameter>
35243         </parameters>
35244       </constructor>
35245       <constructor name="new_from_fd"
35246                    c:identifier="g_socket_new_from_fd"
35247                    version="2.22"
35248                    throws="1">
35249         <doc xml:whitespace="preserve">Creates a new #GSocket from a native file descriptor
35250 or winsock SOCKET handle.
35251 This reads all the settings from the file descriptor so that
35252 all properties should work. Note that the file descriptor
35253 will be set to non-blocking mode, independent on the blocking
35254 mode of the #GSocket.
35255 Free the returned object with g_object_unref().</doc>
35256         <return-value transfer-ownership="full">
35257           <doc xml:whitespace="preserve">a #GSocket or %NULL on error.</doc>
35258           <type name="Socket" c:type="GSocket*"/>
35259         </return-value>
35260         <parameters>
35261           <parameter name="fd" transfer-ownership="none">
35262             <doc xml:whitespace="preserve">a native socket file descriptor.</doc>
35263             <type name="gint" c:type="gint"/>
35264           </parameter>
35265         </parameters>
35266       </constructor>
35267       <method name="accept"
35268               c:identifier="g_socket_accept"
35269               version="2.22"
35270               throws="1">
35271         <doc xml:whitespace="preserve">Accept incoming connections on a connection-based socket. This removes
35272 the first outstanding connection request from the listening socket and
35273 creates a #GSocket object for it.
35274 The @socket must be bound to a local address with g_socket_bind() and
35275 must be listening for incoming connections (g_socket_listen()).
35276 If there are no outstanding connections then the operation will block
35277 or return %G_IO_ERROR_WOULD_BLOCK if non-blocking I/O is enabled.
35278 To be notified of an incoming connection, wait for the %G_IO_IN condition.
35279 Free the returned object with g_object_unref().</doc>
35280         <return-value transfer-ownership="full">
35281           <doc xml:whitespace="preserve">a new #GSocket, or %NULL on error.</doc>
35282           <type name="Socket" c:type="GSocket*"/>
35283         </return-value>
35284         <parameters>
35285           <parameter name="cancellable"
35286                      transfer-ownership="none"
35287                      allow-none="1">
35288             <doc xml:whitespace="preserve">a %GCancellable or %NULL</doc>
35289             <type name="Cancellable" c:type="GCancellable*"/>
35290           </parameter>
35291         </parameters>
35292       </method>
35293       <method name="bind"
35294               c:identifier="g_socket_bind"
35295               version="2.22"
35296               throws="1">
35297         <doc xml:whitespace="preserve">When a socket is created it is attached to an address family, but it
35298 doesn't have an address in this family. g_socket_bind() assigns the
35299 address (sometimes called name) of the socket.
35300 It is generally required to bind to a local address before you can
35301 receive connections. (See g_socket_listen() and g_socket_accept() ).
35302 In certain situations, you may also want to bind a socket that will be
35303 used to initiate connections, though this is not normally required.
35304 eventually call g_socket_accept() on), and %FALSE for client sockets.
35305 (Specifically, if it is %TRUE, then g_socket_bind() will set the
35306 %SO_REUSEADDR flag on the socket, allowing it to bind @address even if
35307 that address was previously used by another socket that has not yet been
35308 fully cleaned-up by the kernel. Failing to set this flag on a server
35309 socket may cause the bind call to return %G_IO_ERROR_ADDRESS_IN_USE if
35310 the server program is stopped and then immediately restarted.)</doc>
35311         <return-value transfer-ownership="none">
35312           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
35313           <type name="gboolean" c:type="gboolean"/>
35314         </return-value>
35315         <parameters>
35316           <parameter name="address" transfer-ownership="none">
35317             <doc xml:whitespace="preserve">a #GSocketAddress specifying the local address.</doc>
35318             <type name="SocketAddress" c:type="GSocketAddress*"/>
35319           </parameter>
35320           <parameter name="allow_reuse" transfer-ownership="none">
35321             <doc xml:whitespace="preserve">whether to allow reusing this address</doc>
35322             <type name="gboolean" c:type="gboolean"/>
35323           </parameter>
35324         </parameters>
35325       </method>
35326       <method name="check_connect_result"
35327               c:identifier="g_socket_check_connect_result"
35328               version="2.22"
35329               throws="1">
35330         <doc xml:whitespace="preserve">Checks and resets the pending connect error for the socket.
35331 This is used to check for errors when g_socket_connect() is
35332 used in non-blocking mode.</doc>
35333         <return-value transfer-ownership="none">
35334           <doc xml:whitespace="preserve">%TRUE if no error, %FALSE otherwise, setting @error to the error</doc>
35335           <type name="gboolean" c:type="gboolean"/>
35336         </return-value>
35337       </method>
35338       <method name="close"
35339               c:identifier="g_socket_close"
35340               version="2.22"
35341               throws="1">
35342         <doc xml:whitespace="preserve">Closes the socket, shutting down any active connection.
35343 Closing a socket does not wait for all outstanding I/O operations
35344 to finish, so the caller should not rely on them to be guaranteed
35345 to complete even if the close returns with no error.
35346 Once the socket is closed, all other operations will return
35347 %G_IO_ERROR_CLOSED. Closing a socket multiple times will not
35348 return an error.
35349 Sockets will be automatically closed when the last reference
35350 is dropped, but you might want to call this function to make sure
35351 resources are released as early as possible.
35352 Beware that due to the way that TCP works, it is possible for
35353 recently-sent data to be lost if either you close a socket while the
35354 %G_IO_IN condition is set, or else if the remote connection tries to
35355 send something to you after you close the socket but before it has
35356 finished reading all of the data you sent. There is no easy generic
35357 way to avoid this problem; the easiest fix is to design the network
35358 protocol such that the client will never send data "out of turn".
35359 Another solution is for the server to half-close the connection by
35360 calling g_socket_shutdown() with only the @shutdown_write flag set,
35361 and then wait for the client to notice this and close its side of the
35362 connection, after which the server can safely call g_socket_close().
35363 (This is what #GTcpConnection does if you call
35364 g_tcp_connection_set_graceful_disconnect(). But of course, this
35365 only works if the client will close its connection after the server
35366 does.)</doc>
35367         <return-value transfer-ownership="none">
35368           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error</doc>
35369           <type name="gboolean" c:type="gboolean"/>
35370         </return-value>
35371       </method>
35372       <method name="condition_check"
35373               c:identifier="g_socket_condition_check"
35374               version="2.22">
35375         <doc xml:whitespace="preserve">Checks on the readiness of @socket to perform operations.
35376 The operations specified in @condition are checked for and masked
35377 against the currently-satisfied conditions on @socket. The result
35378 is returned.
35379 Note that on Windows, it is possible for an operation to return
35380 %G_IO_ERROR_WOULD_BLOCK even immediately after
35381 g_socket_condition_check() has claimed that the socket is ready for
35382 writing. Rather than calling g_socket_condition_check() and then
35383 writing to the socket if it succeeds, it is generally better to
35384 simply try writing to the socket right away, and try again later if
35385 the initial attempt returns %G_IO_ERROR_WOULD_BLOCK.
35386 It is meaningless to specify %G_IO_ERR or %G_IO_HUP in condition;
35387 these conditions will always be set in the output if they are true.
35388 This call never blocks.</doc>
35389         <return-value transfer-ownership="none">
35390           <doc xml:whitespace="preserve">the @GIOCondition mask of the current state</doc>
35391           <type name="GLib.IOCondition" c:type="GIOCondition"/>
35392         </return-value>
35393         <parameters>
35394           <parameter name="condition" transfer-ownership="none">
35395             <doc xml:whitespace="preserve">a #GIOCondition mask to check</doc>
35396             <type name="GLib.IOCondition" c:type="GIOCondition"/>
35397           </parameter>
35398         </parameters>
35399       </method>
35400       <method name="condition_wait"
35401               c:identifier="g_socket_condition_wait"
35402               version="2.22"
35403               throws="1">
35404         <doc xml:whitespace="preserve">Waits for @condition to become true on @socket. When the condition
35405 is met, %TRUE is returned.
35406 If @cancellable is cancelled before the condition is met, or if the
35407 socket has a timeout set and it is reached before the condition is
35408 met, then %FALSE is returned and @error, if non-%NULL, is set to
35409 the appropriate value (%G_IO_ERROR_CANCELLED or
35410 %G_IO_ERROR_TIMED_OUT).</doc>
35411         <return-value transfer-ownership="none">
35412           <doc xml:whitespace="preserve">%TRUE if the condition was met, %FALSE otherwise</doc>
35413           <type name="gboolean" c:type="gboolean"/>
35414         </return-value>
35415         <parameters>
35416           <parameter name="condition" transfer-ownership="none">
35417             <doc xml:whitespace="preserve">a #GIOCondition mask to wait for</doc>
35418             <type name="GLib.IOCondition" c:type="GIOCondition"/>
35419           </parameter>
35420           <parameter name="cancellable"
35421                      transfer-ownership="none"
35422                      allow-none="1">
35423             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
35424             <type name="Cancellable" c:type="GCancellable*"/>
35425           </parameter>
35426         </parameters>
35427       </method>
35428       <method name="connect"
35429               c:identifier="g_socket_connect"
35430               version="2.22"
35431               throws="1">
35432         <doc xml:whitespace="preserve">Connect the socket to the specified remote address.
35433 For connection oriented socket this generally means we attempt to make
35434 a connection to the @address. For a connection-less socket it sets
35435 the default address for g_socket_send() and discards all incoming datagrams
35436 from other sources.
35437 Generally connection oriented sockets can only connect once, but
35438 connection-less sockets can connect multiple times to change the
35439 default address.
35440 If the connect call needs to do network I/O it will block, unless
35441 non-blocking I/O is enabled. Then %G_IO_ERROR_PENDING is returned
35442 and the user can be notified of the connection finishing by waiting
35443 for the G_IO_OUT condition. The result of the connection can then be
35444 checked with g_socket_check_connect_result().</doc>
35445         <return-value transfer-ownership="none">
35446           <doc xml:whitespace="preserve">%TRUE if connected, %FALSE on error.</doc>
35447           <type name="gboolean" c:type="gboolean"/>
35448         </return-value>
35449         <parameters>
35450           <parameter name="address" transfer-ownership="none">
35451             <doc xml:whitespace="preserve">a #GSocketAddress specifying the remote address.</doc>
35452             <type name="SocketAddress" c:type="GSocketAddress*"/>
35453           </parameter>
35454           <parameter name="cancellable"
35455                      transfer-ownership="none"
35456                      allow-none="1">
35457             <doc xml:whitespace="preserve">a %GCancellable or %NULL</doc>
35458             <type name="Cancellable" c:type="GCancellable*"/>
35459           </parameter>
35460         </parameters>
35461       </method>
35462       <method name="connection_factory_create_connection"
35463               c:identifier="g_socket_connection_factory_create_connection"
35464               version="2.22">
35465         <doc xml:whitespace="preserve">Creates a #GSocketConnection subclass of the right type for</doc>
35466         <return-value transfer-ownership="full">
35467           <doc xml:whitespace="preserve">a #GSocketConnection</doc>
35468           <type name="SocketConnection" c:type="GSocketConnection*"/>
35469         </return-value>
35470       </method>
35471       <method name="create_source"
35472               c:identifier="g_socket_create_source"
35473               version="2.22"
35474               introspectable="0">
35475         <doc xml:whitespace="preserve">Creates a %GSource that can be attached to a %GMainContext to monitor
35476 for the availibility of the specified @condition on the socket.
35477 The callback on the source is of the #GSocketSourceFunc type.
35478 It is meaningless to specify %G_IO_ERR or %G_IO_HUP in @condition;
35479 these conditions will always be reported output if they are true.
35480 cause the source to trigger, reporting the current condition (which
35481 is likely 0 unless cancellation happened at the same time as a
35482 condition change). You can check for this in the callback using
35483 g_cancellable_is_cancelled().
35484 If @socket has a timeout set, and it is reached before @condition
35485 occurs, the source will then trigger anyway, reporting %G_IO_IN or
35486 %G_IO_OUT depending on @condition. However, @socket will have been
35487 marked as having had a timeout, and so the next #GSocket I/O method
35488 you call will then fail with a %G_IO_ERROR_TIMED_OUT.</doc>
35489         <return-value transfer-ownership="full">
35490           <doc xml:whitespace="preserve">a newly allocated %GSource, free with g_source_unref().</doc>
35491           <type name="GLib.Source" c:type="GSource*"/>
35492         </return-value>
35493         <parameters>
35494           <parameter name="condition" transfer-ownership="none">
35495             <doc xml:whitespace="preserve">a #GIOCondition mask to monitor</doc>
35496             <type name="GLib.IOCondition" c:type="GIOCondition"/>
35497           </parameter>
35498           <parameter name="cancellable"
35499                      transfer-ownership="none"
35500                      allow-none="1">
35501             <doc xml:whitespace="preserve">a %GCancellable or %NULL</doc>
35502             <type name="Cancellable" c:type="GCancellable*"/>
35503           </parameter>
35504         </parameters>
35505       </method>
35506       <method name="get_blocking"
35507               c:identifier="g_socket_get_blocking"
35508               version="2.22">
35509         <doc xml:whitespace="preserve">Gets the blocking mode of the socket. For details on blocking I/O,
35510 see g_socket_set_blocking().</doc>
35511         <return-value transfer-ownership="none">
35512           <doc xml:whitespace="preserve">%TRUE if blocking I/O is used, %FALSE otherwise.</doc>
35513           <type name="gboolean" c:type="gboolean"/>
35514         </return-value>
35515       </method>
35516       <method name="get_credentials"
35517               c:identifier="g_socket_get_credentials"
35518               version="2.26"
35519               throws="1">
35520         <doc xml:whitespace="preserve">Returns the credentials of the foreign process connected to this
35521 socket, if any (e.g. it is only supported for %G_SOCKET_FAMILY_UNIX
35522 sockets).
35523 If this operation isn't supported on the OS, the method fails with
35524 the %G_IO_ERROR_NOT_SUPPORTED error. On Linux this is implemented
35525 by reading the %SO_PEERCRED option on the underlying socket.
35526 Other ways to obtain credentials from a foreign peer includes the
35527 #GUnixCredentialsMessage type and
35528 g_unix_connection_send_credentials() /
35529 g_unix_connection_receive_credentials() functions.
35530 that must be freed with g_object_unref().</doc>
35531         <return-value transfer-ownership="full">
35532           <doc xml:whitespace="preserve">%NULL if @error is set, otherwise a #GCredentials object</doc>
35533           <type name="Credentials" c:type="GCredentials*"/>
35534         </return-value>
35535       </method>
35536       <method name="get_family"
35537               c:identifier="g_socket_get_family"
35538               version="2.22">
35539         <doc xml:whitespace="preserve">Gets the socket family of the socket.</doc>
35540         <return-value transfer-ownership="none">
35541           <doc xml:whitespace="preserve">a #GSocketFamily</doc>
35542           <type name="SocketFamily" c:type="GSocketFamily"/>
35543         </return-value>
35544       </method>
35545       <method name="get_fd" c:identifier="g_socket_get_fd" version="2.22">
35546         <doc xml:whitespace="preserve">Returns the underlying OS socket object. On unix this
35547 is a socket file descriptor, and on windows this is
35548 a Winsock2 SOCKET handle. This may be useful for
35549 doing platform specific or otherwise unusual operations
35550 on the socket.</doc>
35551         <return-value transfer-ownership="none">
35552           <doc xml:whitespace="preserve">the file descriptor of the socket.</doc>
35553           <type name="gint" c:type="int"/>
35554         </return-value>
35555       </method>
35556       <method name="get_keepalive"
35557               c:identifier="g_socket_get_keepalive"
35558               version="2.22">
35559         <doc xml:whitespace="preserve">Gets the keepalive mode of the socket. For details on this,
35560 see g_socket_set_keepalive().</doc>
35561         <return-value transfer-ownership="none">
35562           <doc xml:whitespace="preserve">%TRUE if keepalive is active, %FALSE otherwise.</doc>
35563           <type name="gboolean" c:type="gboolean"/>
35564         </return-value>
35565       </method>
35566       <method name="get_listen_backlog"
35567               c:identifier="g_socket_get_listen_backlog"
35568               version="2.22">
35569         <doc xml:whitespace="preserve">Gets the listen backlog setting of the socket. For details on this,
35570 see g_socket_set_listen_backlog().</doc>
35571         <return-value transfer-ownership="none">
35572           <doc xml:whitespace="preserve">the maximum number of pending connections.</doc>
35573           <type name="gint" c:type="gint"/>
35574         </return-value>
35575       </method>
35576       <method name="get_local_address"
35577               c:identifier="g_socket_get_local_address"
35578               version="2.22"
35579               throws="1">
35580         <doc xml:whitespace="preserve">Try to get the local address of a bound socket. This is only
35581 useful if the socket has been bound to a local address,
35582 either explicitly or implicitly when connecting.
35583 Free the returned object with g_object_unref().</doc>
35584         <return-value transfer-ownership="full">
35585           <doc xml:whitespace="preserve">a #GSocketAddress or %NULL on error.</doc>
35586           <type name="SocketAddress" c:type="GSocketAddress*"/>
35587         </return-value>
35588       </method>
35589       <method name="get_protocol"
35590               c:identifier="g_socket_get_protocol"
35591               version="2.22">
35592         <doc xml:whitespace="preserve">Gets the socket protocol id the socket was created with.
35593 In case the protocol is unknown, -1 is returned.</doc>
35594         <return-value transfer-ownership="none">
35595           <doc xml:whitespace="preserve">a protocol id, or -1 if unknown</doc>
35596           <type name="SocketProtocol" c:type="GSocketProtocol"/>
35597         </return-value>
35598       </method>
35599       <method name="get_remote_address"
35600               c:identifier="g_socket_get_remote_address"
35601               version="2.22"
35602               throws="1">
35603         <doc xml:whitespace="preserve">Try to get the remove address of a connected socket. This is only
35604 useful for connection oriented sockets that have been connected.
35605 Free the returned object with g_object_unref().</doc>
35606         <return-value transfer-ownership="full">
35607           <doc xml:whitespace="preserve">a #GSocketAddress or %NULL on error.</doc>
35608           <type name="SocketAddress" c:type="GSocketAddress*"/>
35609         </return-value>
35610       </method>
35611       <method name="get_socket_type"
35612               c:identifier="g_socket_get_socket_type"
35613               version="2.22">
35614         <doc xml:whitespace="preserve">Gets the socket type of the socket.</doc>
35615         <return-value transfer-ownership="none">
35616           <doc xml:whitespace="preserve">a #GSocketType</doc>
35617           <type name="SocketType" c:type="GSocketType"/>
35618         </return-value>
35619       </method>
35620       <method name="get_timeout"
35621               c:identifier="g_socket_get_timeout"
35622               version="2.26">
35623         <doc xml:whitespace="preserve">Gets the timeout setting of the socket. For details on this, see
35624 g_socket_set_timeout().</doc>
35625         <return-value transfer-ownership="none">
35626           <doc xml:whitespace="preserve">the timeout in seconds</doc>
35627           <type name="guint" c:type="guint"/>
35628         </return-value>
35629       </method>
35630       <method name="is_closed"
35631               c:identifier="g_socket_is_closed"
35632               version="2.22">
35633         <doc xml:whitespace="preserve">Checks whether a socket is closed.</doc>
35634         <return-value transfer-ownership="none">
35635           <doc xml:whitespace="preserve">%TRUE if socket is closed, %FALSE otherwise</doc>
35636           <type name="gboolean" c:type="gboolean"/>
35637         </return-value>
35638       </method>
35639       <method name="is_connected"
35640               c:identifier="g_socket_is_connected"
35641               version="2.22">
35642         <doc xml:whitespace="preserve">Check whether the socket is connected. This is only useful for
35643 connection-oriented sockets.</doc>
35644         <return-value transfer-ownership="none">
35645           <doc xml:whitespace="preserve">%TRUE if socket is connected, %FALSE otherwise.</doc>
35646           <type name="gboolean" c:type="gboolean"/>
35647         </return-value>
35648       </method>
35649       <method name="listen"
35650               c:identifier="g_socket_listen"
35651               version="2.22"
35652               throws="1">
35653         <doc xml:whitespace="preserve">Marks the socket as a server socket, i.e. a socket that is used
35654 to accept incoming requests using g_socket_accept().
35655 Before calling this the socket must be bound to a local address using
35656 g_socket_bind().
35657 To set the maximum amount of outstanding clients, use
35658 g_socket_set_listen_backlog().</doc>
35659         <return-value transfer-ownership="none">
35660           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
35661           <type name="gboolean" c:type="gboolean"/>
35662         </return-value>
35663       </method>
35664       <method name="receive"
35665               c:identifier="g_socket_receive"
35666               version="2.22"
35667               throws="1">
35668         <doc xml:whitespace="preserve">Receive data (up to @size bytes) from a socket. This is mainly used by
35669 connection-oriented sockets; it is identical to g_socket_receive_from()
35670 with @address set to %NULL.
35671 For %G_SOCKET_TYPE_DATAGRAM and %G_SOCKET_TYPE_SEQPACKET sockets,
35672 g_socket_receive() will always read either 0 or 1 complete messages from
35673 the socket. If the received message is too large to fit in @buffer, then
35674 the data beyond @size bytes will be discarded, without any explicit
35675 indication that this has occurred.
35676 For %G_SOCKET_TYPE_STREAM sockets, g_socket_receive() can return any
35677 number of bytes, up to @size. If more than @size bytes have been
35678 received, the additional data will be returned in future calls to
35679 g_socket_receive().
35680 If the socket is in blocking mode the call will block until there is
35681 some data to receive or there is an error. If there is no data available
35682 and the socket is in non-blocking mode, a %G_IO_ERROR_WOULD_BLOCK error
35683 will be returned. To be notified when data is available, wait for the
35684 %G_IO_IN condition.
35685 On error -1 is returned and @error is set accordingly.</doc>
35686         <return-value transfer-ownership="none">
35687           <doc xml:whitespace="preserve">Number of bytes read, or -1 on error</doc>
35688           <type name="glong" c:type="gssize"/>
35689         </return-value>
35690         <parameters>
35691           <parameter name="buffer" transfer-ownership="none">
35692             <doc xml:whitespace="preserve">a buffer to read data into (which should be at least @size bytes long).</doc>
35693             <type name="utf8" c:type="gchar*"/>
35694           </parameter>
35695           <parameter name="size" transfer-ownership="none">
35696             <doc xml:whitespace="preserve">the number of bytes you want to read from the socket</doc>
35697             <type name="gulong" c:type="gsize"/>
35698           </parameter>
35699           <parameter name="cancellable"
35700                      transfer-ownership="none"
35701                      allow-none="1">
35702             <doc xml:whitespace="preserve">a %GCancellable or %NULL</doc>
35703             <type name="Cancellable" c:type="GCancellable*"/>
35704           </parameter>
35705         </parameters>
35706       </method>
35707       <method name="receive_from"
35708               c:identifier="g_socket_receive_from"
35709               version="2.22"
35710               throws="1">
35711         <doc xml:whitespace="preserve">Receive data (up to @size bytes) from a socket.
35712 If @address is non-%NULL then @address will be set equal to the
35713 source address of the received packet.
35714 See g_socket_receive() for additional information.</doc>
35715         <return-value transfer-ownership="none">
35716           <doc xml:whitespace="preserve">Number of bytes read, or -1 on error</doc>
35717           <type name="glong" c:type="gssize"/>
35718         </return-value>
35719         <parameters>
35720           <parameter name="address" transfer-ownership="none">
35721             <doc xml:whitespace="preserve">a pointer to a #GSocketAddress pointer, or %NULL</doc>
35722             <type name="SocketAddress" c:type="GSocketAddress**"/>
35723           </parameter>
35724           <parameter name="buffer" transfer-ownership="none">
35725             <doc xml:whitespace="preserve">a buffer to read data into (which should be at least @size bytes long).</doc>
35726             <type name="utf8" c:type="gchar*"/>
35727           </parameter>
35728           <parameter name="size" transfer-ownership="none">
35729             <doc xml:whitespace="preserve">the number of bytes you want to read from the socket</doc>
35730             <type name="gulong" c:type="gsize"/>
35731           </parameter>
35732           <parameter name="cancellable"
35733                      transfer-ownership="none"
35734                      allow-none="1">
35735             <doc xml:whitespace="preserve">a %GCancellable or %NULL</doc>
35736             <type name="Cancellable" c:type="GCancellable*"/>
35737           </parameter>
35738         </parameters>
35739       </method>
35740       <method name="receive_message"
35741               c:identifier="g_socket_receive_message"
35742               version="2.22"
35743               throws="1">
35744         <doc xml:whitespace="preserve">Receive data from a socket.  This is the most complicated and
35745 fully-featured version of this call. For easier use, see
35746 g_socket_receive() and g_socket_receive_from().
35747 If @address is non-%NULL then @address will be set equal to the
35748 source address of the received packet.
35749 describe the buffers that received data will be scattered into.
35750 If @num_vectors is -1, then @vectors is assumed to be terminated
35751 by a #GInputVector with a %NULL buffer pointer.
35752 As a special case, if @num_vectors is 0 (in which case, @vectors
35753 may of course be %NULL), then a single byte is received and
35754 discarded. This is to facilitate the common practice of sending a
35755 single '\0' byte for the purposes of transferring ancillary data.
35756 array of #GSocketControlMessage instances or %NULL if no such
35757 messages was received. These correspond to the control messages
35758 received from the kernel, one #GSocketControlMessage per message
35759 from the kernel. This array is %NULL-terminated and must be freed
35760 by the caller using g_free() after calling g_object_unref() on each
35761 element. If @messages is %NULL, any control messages received will
35762 be discarded.
35763 messages received.
35764 If both @messages and @num_messages are non-%NULL, then
35765 for this are available in the #GSocketMsgFlags enum, but the
35766 values there are the same as the system values, and the flags
35767 are passed in as-is, so you can pass in system-specific flags too
35768 (and g_socket_receive_message() may pass system-specific flags out).
35769 As with g_socket_receive(), data may be discarded if @socket is
35770 %G_SOCKET_TYPE_DATAGRAM or %G_SOCKET_TYPE_SEQPACKET and you do not
35771 provide enough buffer space to read a complete message. You can pass
35772 %G_SOCKET_MSG_PEEK in @flags to peek at the current message without
35773 removing it from the receive queue, but there is no portable way to find
35774 out the length of the message other than by reading it into a
35775 sufficiently-large buffer.
35776 If the socket is in blocking mode the call will block until there
35777 is some data to receive or there is an error. If there is no data
35778 available and the socket is in non-blocking mode, a
35779 %G_IO_ERROR_WOULD_BLOCK error will be returned. To be notified when
35780 data is available, wait for the %G_IO_IN condition.
35781 On error -1 is returned and @error is set accordingly.</doc>
35782         <return-value transfer-ownership="none">
35783           <doc xml:whitespace="preserve">Number of bytes read, or -1 on error</doc>
35784           <type name="glong" c:type="gssize"/>
35785         </return-value>
35786         <parameters>
35787           <parameter name="address" transfer-ownership="none">
35788             <doc xml:whitespace="preserve">a pointer to a #GSocketAddress pointer, or %NULL</doc>
35789             <type name="SocketAddress" c:type="GSocketAddress**"/>
35790           </parameter>
35791           <parameter name="vectors" transfer-ownership="none">
35792             <doc xml:whitespace="preserve">an array of #GInputVector structs</doc>
35793             <type name="InputVector" c:type="GInputVector*"/>
35794           </parameter>
35795           <parameter name="num_vectors" transfer-ownership="none">
35796             <doc xml:whitespace="preserve">the number of elements in @vectors, or -1</doc>
35797             <type name="gint" c:type="gint"/>
35798           </parameter>
35799           <parameter name="messages" transfer-ownership="none">
35800             <doc xml:whitespace="preserve">a pointer which may be filled with an array of #GSocketControlMessages, or %NULL</doc>
35801             <type name="SocketControlMessage"
35802                   c:type="GSocketControlMessage***"/>
35803           </parameter>
35804           <parameter name="num_messages" transfer-ownership="none">
35805             <doc xml:whitespace="preserve">a pointer which will be filled with the number of elements in @messages, or %NULL</doc>
35806             <type name="gint" c:type="gint*"/>
35807           </parameter>
35808           <parameter name="flags" transfer-ownership="none">
35809             <doc xml:whitespace="preserve">a pointer to an int containing #GSocketMsgFlags flags</doc>
35810             <type name="gint" c:type="gint*"/>
35811           </parameter>
35812           <parameter name="cancellable"
35813                      transfer-ownership="none"
35814                      allow-none="1">
35815             <doc xml:whitespace="preserve">a %GCancellable or %NULL</doc>
35816             <type name="Cancellable" c:type="GCancellable*"/>
35817           </parameter>
35818         </parameters>
35819       </method>
35820       <method name="receive_with_blocking"
35821               c:identifier="g_socket_receive_with_blocking"
35822               version="2.26"
35823               throws="1">
35824         <doc xml:whitespace="preserve">This behaves exactly the same as g_socket_receive(), except that
35825 the choice of blocking or non-blocking behavior is determined by
35826 the @blocking argument rather than by @socket's properties.</doc>
35827         <return-value transfer-ownership="none">
35828           <doc xml:whitespace="preserve">Number of bytes read, or -1 on error</doc>
35829           <type name="glong" c:type="gssize"/>
35830         </return-value>
35831         <parameters>
35832           <parameter name="buffer" transfer-ownership="none">
35833             <doc xml:whitespace="preserve">a buffer to read data into (which should be at least @size bytes long).</doc>
35834             <type name="utf8" c:type="gchar*"/>
35835           </parameter>
35836           <parameter name="size" transfer-ownership="none">
35837             <doc xml:whitespace="preserve">the number of bytes you want to read from the socket</doc>
35838             <type name="gulong" c:type="gsize"/>
35839           </parameter>
35840           <parameter name="blocking" transfer-ownership="none">
35841             <doc xml:whitespace="preserve">whether to do blocking or non-blocking I/O</doc>
35842             <type name="gboolean" c:type="gboolean"/>
35843           </parameter>
35844           <parameter name="cancellable"
35845                      transfer-ownership="none"
35846                      allow-none="1">
35847             <doc xml:whitespace="preserve">a %GCancellable or %NULL</doc>
35848             <type name="Cancellable" c:type="GCancellable*"/>
35849           </parameter>
35850         </parameters>
35851       </method>
35852       <method name="send"
35853               c:identifier="g_socket_send"
35854               version="2.22"
35855               throws="1">
35856         <doc xml:whitespace="preserve">Tries to send @size bytes from @buffer on the socket. This is
35857 mainly used by connection-oriented sockets; it is identical to
35858 g_socket_send_to() with @address set to %NULL.
35859 If the socket is in blocking mode the call will block until there is
35860 space for the data in the socket queue. If there is no space available
35861 and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error
35862 will be returned. To be notified when space is available, wait for the
35863 %G_IO_OUT condition. Note though that you may still receive
35864 %G_IO_ERROR_WOULD_BLOCK from g_socket_send() even if you were previously
35865 notified of a %G_IO_OUT condition. (On Windows in particular, this is
35866 very common due to the way the underlying APIs work.)
35867 On error -1 is returned and @error is set accordingly.
35868 on error</doc>
35869         <return-value transfer-ownership="none">
35870           <doc xml:whitespace="preserve">Number of bytes written (which may be less than @size), or -1</doc>
35871           <type name="glong" c:type="gssize"/>
35872         </return-value>
35873         <parameters>
35874           <parameter name="buffer" transfer-ownership="none">
35875             <doc xml:whitespace="preserve">the buffer containing the data to send.</doc>
35876             <type name="utf8" c:type="gchar*"/>
35877           </parameter>
35878           <parameter name="size" transfer-ownership="none">
35879             <doc xml:whitespace="preserve">the number of bytes to send</doc>
35880             <type name="gulong" c:type="gsize"/>
35881           </parameter>
35882           <parameter name="cancellable"
35883                      transfer-ownership="none"
35884                      allow-none="1">
35885             <doc xml:whitespace="preserve">a %GCancellable or %NULL</doc>
35886             <type name="Cancellable" c:type="GCancellable*"/>
35887           </parameter>
35888         </parameters>
35889       </method>
35890       <method name="send_message"
35891               c:identifier="g_socket_send_message"
35892               version="2.22"
35893               throws="1">
35894         <doc xml:whitespace="preserve">Send data to @address on @socket.  This is the most complicated and
35895 fully-featured version of this call. For easier use, see
35896 g_socket_send() and g_socket_send_to().
35897 If @address is %NULL then the message is sent to the default receiver
35898 (set by g_socket_connect()).
35899 then @vectors is assumed to be terminated by a #GOutputVector with a
35900 %NULL buffer pointer.) The #GOutputVector structs describe the buffers
35901 that the sent data will be gathered from. Using multiple
35902 #GOutputVector&lt;!-- --&gt;s is more memory-efficient than manually copying
35903 data from multiple sources into a single buffer, and more
35904 network-efficient than making multiple calls to g_socket_send().
35905 #GSocketControlMessage instances. These correspond to the control
35906 messages to be sent on the socket.
35907 If @num_messages is -1 then @messages is treated as a %NULL-terminated
35908 array.
35909 for this are available in the #GSocketMsgFlags enum, but the
35910 values there are the same as the system values, and the flags
35911 are passed in as-is, so you can pass in system-specific flags too.
35912 If the socket is in blocking mode the call will block until there is
35913 space for the data in the socket queue. If there is no space available
35914 and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error
35915 will be returned. To be notified when space is available, wait for the
35916 %G_IO_OUT condition. Note though that you may still receive
35917 %G_IO_ERROR_WOULD_BLOCK from g_socket_send() even if you were previously
35918 notified of a %G_IO_OUT condition. (On Windows in particular, this is
35919 very common due to the way the underlying APIs work.)
35920 On error -1 is returned and @error is set accordingly.
35921 on error</doc>
35922         <return-value transfer-ownership="none">
35923           <doc xml:whitespace="preserve">Number of bytes written (which may be less than @size), or -1</doc>
35924           <type name="glong" c:type="gssize"/>
35925         </return-value>
35926         <parameters>
35927           <parameter name="address" transfer-ownership="none">
35928             <doc xml:whitespace="preserve">a #GSocketAddress, or %NULL</doc>
35929             <type name="SocketAddress" c:type="GSocketAddress*"/>
35930           </parameter>
35931           <parameter name="vectors" transfer-ownership="none">
35932             <doc xml:whitespace="preserve">an array of #GOutputVector structs</doc>
35933             <type name="OutputVector" c:type="GOutputVector*"/>
35934           </parameter>
35935           <parameter name="num_vectors" transfer-ownership="none">
35936             <doc xml:whitespace="preserve">the number of elements in @vectors, or -1</doc>
35937             <type name="gint" c:type="gint"/>
35938           </parameter>
35939           <parameter name="messages" transfer-ownership="none">
35940             <doc xml:whitespace="preserve">a pointer to an array of #GSocketControlMessages, or %NULL.</doc>
35941             <type name="SocketControlMessage"
35942                   c:type="GSocketControlMessage**"/>
35943           </parameter>
35944           <parameter name="num_messages" transfer-ownership="none">
35945             <doc xml:whitespace="preserve">number of elements in @messages, or -1.</doc>
35946             <type name="gint" c:type="gint"/>
35947           </parameter>
35948           <parameter name="flags" transfer-ownership="none">
35949             <doc xml:whitespace="preserve">an int containing #GSocketMsgFlags flags</doc>
35950             <type name="gint" c:type="gint"/>
35951           </parameter>
35952           <parameter name="cancellable"
35953                      transfer-ownership="none"
35954                      allow-none="1">
35955             <doc xml:whitespace="preserve">a %GCancellable or %NULL</doc>
35956             <type name="Cancellable" c:type="GCancellable*"/>
35957           </parameter>
35958         </parameters>
35959       </method>
35960       <method name="send_to"
35961               c:identifier="g_socket_send_to"
35962               version="2.22"
35963               throws="1">
35964         <doc xml:whitespace="preserve">Tries to send @size bytes from @buffer to @address. If @address is
35965 %NULL then the message is sent to the default receiver (set by
35966 g_socket_connect()).
35967 See g_socket_send() for additional information.
35968 on error</doc>
35969         <return-value transfer-ownership="none">
35970           <doc xml:whitespace="preserve">Number of bytes written (which may be less than @size), or -1</doc>
35971           <type name="glong" c:type="gssize"/>
35972         </return-value>
35973         <parameters>
35974           <parameter name="address" transfer-ownership="none">
35975             <doc xml:whitespace="preserve">a #GSocketAddress, or %NULL</doc>
35976             <type name="SocketAddress" c:type="GSocketAddress*"/>
35977           </parameter>
35978           <parameter name="buffer" transfer-ownership="none">
35979             <doc xml:whitespace="preserve">the buffer containing the data to send.</doc>
35980             <type name="utf8" c:type="gchar*"/>
35981           </parameter>
35982           <parameter name="size" transfer-ownership="none">
35983             <doc xml:whitespace="preserve">the number of bytes to send</doc>
35984             <type name="gulong" c:type="gsize"/>
35985           </parameter>
35986           <parameter name="cancellable"
35987                      transfer-ownership="none"
35988                      allow-none="1">
35989             <doc xml:whitespace="preserve">a %GCancellable or %NULL</doc>
35990             <type name="Cancellable" c:type="GCancellable*"/>
35991           </parameter>
35992         </parameters>
35993       </method>
35994       <method name="send_with_blocking"
35995               c:identifier="g_socket_send_with_blocking"
35996               version="2.26"
35997               throws="1">
35998         <doc xml:whitespace="preserve">This behaves exactly the same as g_socket_send(), except that
35999 the choice of blocking or non-blocking behavior is determined by
36000 the @blocking argument rather than by @socket's properties.
36001 on error</doc>
36002         <return-value transfer-ownership="none">
36003           <doc xml:whitespace="preserve">Number of bytes written (which may be less than @size), or -1</doc>
36004           <type name="glong" c:type="gssize"/>
36005         </return-value>
36006         <parameters>
36007           <parameter name="buffer" transfer-ownership="none">
36008             <doc xml:whitespace="preserve">the buffer containing the data to send.</doc>
36009             <type name="utf8" c:type="gchar*"/>
36010           </parameter>
36011           <parameter name="size" transfer-ownership="none">
36012             <doc xml:whitespace="preserve">the number of bytes to send</doc>
36013             <type name="gulong" c:type="gsize"/>
36014           </parameter>
36015           <parameter name="blocking" transfer-ownership="none">
36016             <doc xml:whitespace="preserve">whether to do blocking or non-blocking I/O</doc>
36017             <type name="gboolean" c:type="gboolean"/>
36018           </parameter>
36019           <parameter name="cancellable"
36020                      transfer-ownership="none"
36021                      allow-none="1">
36022             <doc xml:whitespace="preserve">a %GCancellable or %NULL</doc>
36023             <type name="Cancellable" c:type="GCancellable*"/>
36024           </parameter>
36025         </parameters>
36026       </method>
36027       <method name="set_blocking"
36028               c:identifier="g_socket_set_blocking"
36029               version="2.22">
36030         <doc xml:whitespace="preserve">Sets the blocking mode of the socket. In blocking mode
36031 all operations block until they succeed or there is an error. In
36032 non-blocking mode all functions return results immediately or
36033 with a %G_IO_ERROR_WOULD_BLOCK error.
36034 All sockets are created in blocking mode. However, note that the
36035 platform level socket is always non-blocking, and blocking mode
36036 is a GSocket level feature.</doc>
36037         <return-value transfer-ownership="none">
36038           <type name="none" c:type="void"/>
36039         </return-value>
36040         <parameters>
36041           <parameter name="blocking" transfer-ownership="none">
36042             <doc xml:whitespace="preserve">Whether to use blocking I/O or not.</doc>
36043             <type name="gboolean" c:type="gboolean"/>
36044           </parameter>
36045         </parameters>
36046       </method>
36047       <method name="set_keepalive"
36048               c:identifier="g_socket_set_keepalive"
36049               version="2.22">
36050         <doc xml:whitespace="preserve">Sets or unsets the %SO_KEEPALIVE flag on the underlying socket. When
36051 this flag is set on a socket, the system will attempt to verify that the
36052 remote socket endpoint is still present if a sufficiently long period of
36053 time passes with no data being exchanged. If the system is unable to
36054 verify the presence of the remote endpoint, it will automatically close
36055 the connection.
36056 This option is only functional on certain kinds of sockets. (Notably,
36057 %G_SOCKET_PROTOCOL_TCP sockets.)
36058 The exact time between pings is system- and protocol-dependent, but will
36059 normally be at least two hours. Most commonly, you would set this flag
36060 on a server socket if you want to allow clients to remain idle for long
36061 periods of time, but also want to ensure that connections are eventually
36062 garbage-collected if clients crash or become unreachable.</doc>
36063         <return-value transfer-ownership="none">
36064           <type name="none" c:type="void"/>
36065         </return-value>
36066         <parameters>
36067           <parameter name="keepalive" transfer-ownership="none">
36068             <doc xml:whitespace="preserve">Value for the keepalive flag</doc>
36069             <type name="gboolean" c:type="gboolean"/>
36070           </parameter>
36071         </parameters>
36072       </method>
36073       <method name="set_listen_backlog"
36074               c:identifier="g_socket_set_listen_backlog"
36075               version="2.22">
36076         <doc xml:whitespace="preserve">Sets the maximum number of outstanding connections allowed
36077 when listening on this socket. If more clients than this are
36078 connecting to the socket and the application is not handling them
36079 on time then the new connections will be refused.
36080 Note that this must be called before g_socket_listen() and has no
36081 effect if called after that.</doc>
36082         <return-value transfer-ownership="none">
36083           <type name="none" c:type="void"/>
36084         </return-value>
36085         <parameters>
36086           <parameter name="backlog" transfer-ownership="none">
36087             <doc xml:whitespace="preserve">the maximum number of pending connections.</doc>
36088             <type name="gint" c:type="gint"/>
36089           </parameter>
36090         </parameters>
36091       </method>
36092       <method name="set_timeout"
36093               c:identifier="g_socket_set_timeout"
36094               version="2.26">
36095         <doc xml:whitespace="preserve">Sets the time in seconds after which I/O operations on @socket will
36096 time out if they have not yet completed.
36097 On a blocking socket, this means that any blocking #GSocket
36098 operation will time out after @timeout seconds of inactivity,
36099 returning %G_IO_ERROR_TIMED_OUT.
36100 On a non-blocking socket, calls to g_socket_condition_wait() will
36101 also fail with %G_IO_ERROR_TIMED_OUT after the given time. Sources
36102 created with g_socket_create_source() will trigger after
36103 set, at which point calling g_socket_receive(), g_socket_send(),
36104 g_socket_check_connect_result(), etc, will fail with
36105 %G_IO_ERROR_TIMED_OUT.
36106 If @timeout is 0 (the default), operations will never time out
36107 on their own.
36108 Note that if an I/O operation is interrupted by a signal, this may
36109 cause the timeout to be reset.</doc>
36110         <return-value transfer-ownership="none">
36111           <type name="none" c:type="void"/>
36112         </return-value>
36113         <parameters>
36114           <parameter name="timeout" transfer-ownership="none">
36115             <doc xml:whitespace="preserve">the timeout for @socket, in seconds, or 0 for none</doc>
36116             <type name="guint" c:type="guint"/>
36117           </parameter>
36118         </parameters>
36119       </method>
36120       <method name="shutdown"
36121               c:identifier="g_socket_shutdown"
36122               version="2.22"
36123               throws="1">
36124         <doc xml:whitespace="preserve">Shut down part of a full-duplex connection.
36125 If @shutdown_read is %TRUE then the recieving side of the connection
36126 is shut down, and further reading is disallowed.
36127 If @shutdown_write is %TRUE then the sending side of the connection
36128 is shut down, and further writing is disallowed.
36129 It is allowed for both @shutdown_read and @shutdown_write to be %TRUE.
36130 One example where this is used is graceful disconnect for TCP connections
36131 where you close the sending side, then wait for the other side to close
36132 the connection, thus ensuring that the other side saw all sent data.</doc>
36133         <return-value transfer-ownership="none">
36134           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error</doc>
36135           <type name="gboolean" c:type="gboolean"/>
36136         </return-value>
36137         <parameters>
36138           <parameter name="shutdown_read" transfer-ownership="none">
36139             <doc xml:whitespace="preserve">whether to shut down the read side</doc>
36140             <type name="gboolean" c:type="gboolean"/>
36141           </parameter>
36142           <parameter name="shutdown_write" transfer-ownership="none">
36143             <doc xml:whitespace="preserve">whether to shut down the write side</doc>
36144             <type name="gboolean" c:type="gboolean"/>
36145           </parameter>
36146         </parameters>
36147       </method>
36148       <method name="speaks_ipv4"
36149               c:identifier="g_socket_speaks_ipv4"
36150               version="2.22">
36151         <doc xml:whitespace="preserve">Checks if a socket is capable of speaking IPv4.
36152 IPv4 sockets are capable of speaking IPv4.  On some operating systems
36153 and under some combinations of circumstances IPv6 sockets are also
36154 capable of speaking IPv4.  See RFC 3493 section 3.7 for more
36155 information.
36156 No other types of sockets are currently considered as being capable
36157 of speaking IPv4.</doc>
36158         <return-value transfer-ownership="none">
36159           <doc xml:whitespace="preserve">%TRUE if this socket can be used with IPv4.</doc>
36160           <type name="gboolean" c:type="gboolean"/>
36161         </return-value>
36162       </method>
36163       <property name="blocking" writable="1" transfer-ownership="none">
36164         <type name="gboolean"/>
36165       </property>
36166       <property name="family"
36167                 writable="1"
36168                 construct-only="1"
36169                 transfer-ownership="none">
36170         <type name="SocketFamily"/>
36171       </property>
36172       <property name="fd"
36173                 writable="1"
36174                 construct-only="1"
36175                 transfer-ownership="none">
36176         <type name="gint"/>
36177       </property>
36178       <property name="keepalive" writable="1" transfer-ownership="none">
36179         <type name="gboolean"/>
36180       </property>
36181       <property name="listen-backlog" writable="1" transfer-ownership="none">
36182         <type name="gint"/>
36183       </property>
36184       <property name="local-address" transfer-ownership="none">
36185         <type name="SocketAddress"/>
36186       </property>
36187       <property name="protocol"
36188                 writable="1"
36189                 construct-only="1"
36190                 transfer-ownership="none">
36191         <type name="SocketProtocol"/>
36192       </property>
36193       <property name="remote-address" transfer-ownership="none">
36194         <type name="SocketAddress"/>
36195       </property>
36196       <property name="timeout"
36197                 version="2.26"
36198                 writable="1"
36199                 transfer-ownership="none">
36200         <doc xml:whitespace="preserve">The timeout in seconds on socket I/O</doc>
36201         <type name="guint"/>
36202       </property>
36203       <property name="type"
36204                 writable="1"
36205                 construct-only="1"
36206                 transfer-ownership="none">
36207         <type name="SocketType"/>
36208       </property>
36209       <field name="parent_instance">
36210         <type name="GObject.Object" c:type="GObject"/>
36211       </field>
36212       <field name="priv">
36213         <type name="SocketPrivate" c:type="GSocketPrivate*"/>
36214       </field>
36215     </class>
36216     <class name="SocketAddress"
36217            c:symbol-prefix="socket_address"
36218            c:type="GSocketAddress"
36219            parent="GObject.Object"
36220            abstract="1"
36221            glib:type-name="GSocketAddress"
36222            glib:get-type="g_socket_address_get_type"
36223            glib:type-struct="SocketAddressClass">
36224       <doc xml:whitespace="preserve">A socket endpoint address, corresponding to &lt;type&gt;struct sockaddr&lt;/type&gt;
36225 or one of its subtypes.</doc>
36226       <implements name="SocketConnectable"/>
36227       <constructor name="new_from_native"
36228                    c:identifier="g_socket_address_new_from_native"
36229                    version="2.22">
36230         <doc xml:whitespace="preserve">Creates a #GSocketAddress subclass corresponding to the native
36231 &lt;type&gt;struct sockaddr&lt;/type&gt; @native.
36232 otherwise %NULL.</doc>
36233         <return-value transfer-ownership="full">
36234           <doc xml:whitespace="preserve">a new #GSocketAddress if @native could successfully be converted,</doc>
36235           <type name="SocketAddress" c:type="GSocketAddress*"/>
36236         </return-value>
36237         <parameters>
36238           <parameter name="native" transfer-ownership="none">
36239             <doc xml:whitespace="preserve">a pointer to a &lt;type&gt;struct sockaddr&lt;/type&gt;</doc>
36240             <type name="gpointer" c:type="gpointer"/>
36241           </parameter>
36242           <parameter name="len" transfer-ownership="none">
36243             <doc xml:whitespace="preserve">the size of the memory location pointed to by @native</doc>
36244             <type name="gulong" c:type="gsize"/>
36245           </parameter>
36246         </parameters>
36247       </constructor>
36248       <virtual-method name="get_family" invoker="get_family" version="2.22">
36249         <doc xml:whitespace="preserve">Gets the socket family type of @address.</doc>
36250         <return-value transfer-ownership="none">
36251           <doc xml:whitespace="preserve">the socket family type of @address.</doc>
36252           <type name="SocketFamily" c:type="GSocketFamily"/>
36253         </return-value>
36254       </virtual-method>
36255       <virtual-method name="get_native_size"
36256                       invoker="get_native_size"
36257                       version="2.22">
36258         <doc xml:whitespace="preserve">Gets the size of @address's native &lt;type&gt;struct sockaddr&lt;/type&gt;.
36259 You can use this to allocate memory to pass to
36260 g_socket_address_to_native().</doc>
36261         <return-value transfer-ownership="none">
36262           <doc xml:whitespace="preserve">the size of the native &lt;type&gt;struct sockaddr&lt;/type&gt; that</doc>
36263           <type name="glong" c:type="gssize"/>
36264         </return-value>
36265       </virtual-method>
36266       <virtual-method name="to_native"
36267                       invoker="to_native"
36268                       version="2.22"
36269                       throws="1">
36270         <doc xml:whitespace="preserve">Converts a #GSocketAddress to a native &lt;type&gt;struct
36271 sockaddr&lt;/type&gt;, which can be passed to low-level functions like
36272 connect() or bind().
36273 If not enough space is availible, a %G_IO_ERROR_NO_SPACE error is
36274 returned. If the address type is not known on the system
36275 then a %G_IO_ERROR_NOT_SUPPORTED error is returned.</doc>
36276         <return-value transfer-ownership="none">
36277           <doc xml:whitespace="preserve">%TRUE if @dest was filled in, %FALSE on error</doc>
36278           <type name="gboolean" c:type="gboolean"/>
36279         </return-value>
36280         <parameters>
36281           <parameter name="dest" transfer-ownership="none">
36282             <doc xml:whitespace="preserve">a pointer to a memory location that will contain the native &lt;type&gt;struct sockaddr&lt;/type&gt;.</doc>
36283             <type name="gpointer" c:type="gpointer"/>
36284           </parameter>
36285           <parameter name="destlen" transfer-ownership="none">
36286             <doc xml:whitespace="preserve">the size of @dest. Must be at least as large as g_socket_address_get_native_size().</doc>
36287             <type name="gulong" c:type="gsize"/>
36288           </parameter>
36289         </parameters>
36290       </virtual-method>
36291       <method name="get_family"
36292               c:identifier="g_socket_address_get_family"
36293               version="2.22">
36294         <doc xml:whitespace="preserve">Gets the socket family type of @address.</doc>
36295         <return-value transfer-ownership="none">
36296           <doc xml:whitespace="preserve">the socket family type of @address.</doc>
36297           <type name="SocketFamily" c:type="GSocketFamily"/>
36298         </return-value>
36299       </method>
36300       <method name="get_native_size"
36301               c:identifier="g_socket_address_get_native_size"
36302               version="2.22">
36303         <doc xml:whitespace="preserve">Gets the size of @address's native &lt;type&gt;struct sockaddr&lt;/type&gt;.
36304 You can use this to allocate memory to pass to
36305 g_socket_address_to_native().</doc>
36306         <return-value transfer-ownership="none">
36307           <doc xml:whitespace="preserve">the size of the native &lt;type&gt;struct sockaddr&lt;/type&gt; that</doc>
36308           <type name="glong" c:type="gssize"/>
36309         </return-value>
36310       </method>
36311       <method name="to_native"
36312               c:identifier="g_socket_address_to_native"
36313               version="2.22"
36314               throws="1">
36315         <doc xml:whitespace="preserve">Converts a #GSocketAddress to a native &lt;type&gt;struct
36316 sockaddr&lt;/type&gt;, which can be passed to low-level functions like
36317 connect() or bind().
36318 If not enough space is availible, a %G_IO_ERROR_NO_SPACE error is
36319 returned. If the address type is not known on the system
36320 then a %G_IO_ERROR_NOT_SUPPORTED error is returned.</doc>
36321         <return-value transfer-ownership="none">
36322           <doc xml:whitespace="preserve">%TRUE if @dest was filled in, %FALSE on error</doc>
36323           <type name="gboolean" c:type="gboolean"/>
36324         </return-value>
36325         <parameters>
36326           <parameter name="dest" transfer-ownership="none">
36327             <doc xml:whitespace="preserve">a pointer to a memory location that will contain the native &lt;type&gt;struct sockaddr&lt;/type&gt;.</doc>
36328             <type name="gpointer" c:type="gpointer"/>
36329           </parameter>
36330           <parameter name="destlen" transfer-ownership="none">
36331             <doc xml:whitespace="preserve">the size of @dest. Must be at least as large as g_socket_address_get_native_size().</doc>
36332             <type name="gulong" c:type="gsize"/>
36333           </parameter>
36334         </parameters>
36335       </method>
36336       <property name="family" transfer-ownership="none">
36337         <type name="SocketFamily"/>
36338       </property>
36339       <field name="parent_instance">
36340         <type name="GObject.Object" c:type="GObject"/>
36341       </field>
36342     </class>
36343     <record name="SocketAddressClass"
36344             c:type="GSocketAddressClass"
36345             glib:is-gtype-struct-for="SocketAddress">
36346       <field name="parent_class">
36347         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
36348       </field>
36349       <field name="get_family">
36350         <callback name="get_family">
36351           <return-value transfer-ownership="none">
36352             <doc xml:whitespace="preserve">the socket family type of @address.</doc>
36353             <type name="SocketFamily" c:type="GSocketFamily"/>
36354           </return-value>
36355           <parameters>
36356             <parameter name="address" transfer-ownership="none">
36357               <type name="SocketAddress" c:type="GSocketAddress*"/>
36358             </parameter>
36359           </parameters>
36360         </callback>
36361       </field>
36362       <field name="get_native_size">
36363         <callback name="get_native_size">
36364           <return-value transfer-ownership="none">
36365             <doc xml:whitespace="preserve">the size of the native &lt;type&gt;struct sockaddr&lt;/type&gt; that</doc>
36366             <type name="glong" c:type="gssize"/>
36367           </return-value>
36368           <parameters>
36369             <parameter name="address" transfer-ownership="none">
36370               <type name="SocketAddress" c:type="GSocketAddress*"/>
36371             </parameter>
36372           </parameters>
36373         </callback>
36374       </field>
36375       <field name="to_native">
36376         <callback name="to_native" throws="1">
36377           <return-value transfer-ownership="none">
36378             <doc xml:whitespace="preserve">%TRUE if @dest was filled in, %FALSE on error</doc>
36379             <type name="gboolean" c:type="gboolean"/>
36380           </return-value>
36381           <parameters>
36382             <parameter name="address" transfer-ownership="none">
36383               <type name="SocketAddress" c:type="GSocketAddress*"/>
36384             </parameter>
36385             <parameter name="dest" transfer-ownership="none">
36386               <doc xml:whitespace="preserve">a pointer to a memory location that will contain the native &lt;type&gt;struct sockaddr&lt;/type&gt;.</doc>
36387               <type name="gpointer" c:type="gpointer"/>
36388             </parameter>
36389             <parameter name="destlen" transfer-ownership="none">
36390               <doc xml:whitespace="preserve">the size of @dest. Must be at least as large as g_socket_address_get_native_size().</doc>
36391               <type name="gulong" c:type="gsize"/>
36392             </parameter>
36393           </parameters>
36394         </callback>
36395       </field>
36396     </record>
36397     <class name="SocketAddressEnumerator"
36398            c:symbol-prefix="socket_address_enumerator"
36399            c:type="GSocketAddressEnumerator"
36400            parent="GObject.Object"
36401            abstract="1"
36402            glib:type-name="GSocketAddressEnumerator"
36403            glib:get-type="g_socket_address_enumerator_get_type"
36404            glib:type-struct="SocketAddressEnumeratorClass">
36405       <doc xml:whitespace="preserve">Enumerator type for objects that contain or generate
36406 #GSocketAddress&lt;!-- --&gt;es.</doc>
36407       <virtual-method name="next" invoker="next" throws="1">
36408         <doc xml:whitespace="preserve">Retrieves the next #GSocketAddress from @enumerator. Note that this
36409 may block for some amount of time. (Eg, a #GNetworkAddress may need
36410 to do a DNS lookup before it can return an address.) Use
36411 g_socket_address_enumerator_next_async() if you need to avoid
36412 blocking.
36413 If @enumerator is expected to yield addresses, but for some reason
36414 is unable to (eg, because of a DNS error), then the first call to
36415 g_socket_address_enumerator_next() will return an appropriate error
36416 in *@error. However, if the first call to
36417 g_socket_address_enumerator_next() succeeds, then any further
36418 internal errors (other than @cancellable being triggered) will be
36419 ignored.
36420 error (in which case *@error will be set) or if there are no
36421 more addresses.</doc>
36422         <return-value transfer-ownership="full">
36423           <doc xml:whitespace="preserve">a #GSocketAddress (owned by the caller), or %NULL on</doc>
36424           <type name="SocketAddress" c:type="GSocketAddress*"/>
36425         </return-value>
36426         <parameters>
36427           <parameter name="cancellable"
36428                      transfer-ownership="none"
36429                      allow-none="1">
36430             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
36431             <type name="Cancellable" c:type="GCancellable*"/>
36432           </parameter>
36433         </parameters>
36434       </virtual-method>
36435       <virtual-method name="next_async" invoker="next_async">
36436         <doc xml:whitespace="preserve">Asynchronously retrieves the next #GSocketAddress from @enumerator
36437 and then calls @callback, which must call
36438 g_socket_address_enumerator_next_finish() to get the result.</doc>
36439         <return-value transfer-ownership="none">
36440           <type name="none" c:type="void"/>
36441         </return-value>
36442         <parameters>
36443           <parameter name="cancellable"
36444                      transfer-ownership="none"
36445                      allow-none="1">
36446             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
36447             <type name="Cancellable" c:type="GCancellable*"/>
36448           </parameter>
36449           <parameter name="callback"
36450                      transfer-ownership="none"
36451                      scope="async"
36452                      closure="2">
36453             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
36454             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
36455           </parameter>
36456           <parameter name="user_data" transfer-ownership="none" closure="2">
36457             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
36458             <type name="gpointer" c:type="gpointer"/>
36459           </parameter>
36460         </parameters>
36461       </virtual-method>
36462       <virtual-method name="next_finish" invoker="next_finish" throws="1">
36463         <doc xml:whitespace="preserve">Retrieves the result of a completed call to
36464 g_socket_address_enumerator_next_async(). See
36465 g_socket_address_enumerator_next() for more information about
36466 error handling.
36467 error (in which case *@error will be set) or if there are no
36468 more addresses.</doc>
36469         <return-value transfer-ownership="full">
36470           <doc xml:whitespace="preserve">a #GSocketAddress (owned by the caller), or %NULL on</doc>
36471           <type name="SocketAddress" c:type="GSocketAddress*"/>
36472         </return-value>
36473         <parameters>
36474           <parameter name="result" transfer-ownership="none">
36475             <doc xml:whitespace="preserve">a #GAsyncResult</doc>
36476             <type name="AsyncResult" c:type="GAsyncResult*"/>
36477           </parameter>
36478         </parameters>
36479       </virtual-method>
36480       <method name="next"
36481               c:identifier="g_socket_address_enumerator_next"
36482               throws="1">
36483         <doc xml:whitespace="preserve">Retrieves the next #GSocketAddress from @enumerator. Note that this
36484 may block for some amount of time. (Eg, a #GNetworkAddress may need
36485 to do a DNS lookup before it can return an address.) Use
36486 g_socket_address_enumerator_next_async() if you need to avoid
36487 blocking.
36488 If @enumerator is expected to yield addresses, but for some reason
36489 is unable to (eg, because of a DNS error), then the first call to
36490 g_socket_address_enumerator_next() will return an appropriate error
36491 in *@error. However, if the first call to
36492 g_socket_address_enumerator_next() succeeds, then any further
36493 internal errors (other than @cancellable being triggered) will be
36494 ignored.
36495 error (in which case *@error will be set) or if there are no
36496 more addresses.</doc>
36497         <return-value transfer-ownership="full">
36498           <doc xml:whitespace="preserve">a #GSocketAddress (owned by the caller), or %NULL on</doc>
36499           <type name="SocketAddress" c:type="GSocketAddress*"/>
36500         </return-value>
36501         <parameters>
36502           <parameter name="cancellable"
36503                      transfer-ownership="none"
36504                      allow-none="1">
36505             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
36506             <type name="Cancellable" c:type="GCancellable*"/>
36507           </parameter>
36508         </parameters>
36509       </method>
36510       <method name="next_async"
36511               c:identifier="g_socket_address_enumerator_next_async">
36512         <doc xml:whitespace="preserve">Asynchronously retrieves the next #GSocketAddress from @enumerator
36513 and then calls @callback, which must call
36514 g_socket_address_enumerator_next_finish() to get the result.</doc>
36515         <return-value transfer-ownership="none">
36516           <type name="none" c:type="void"/>
36517         </return-value>
36518         <parameters>
36519           <parameter name="cancellable"
36520                      transfer-ownership="none"
36521                      allow-none="1">
36522             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
36523             <type name="Cancellable" c:type="GCancellable*"/>
36524           </parameter>
36525           <parameter name="callback"
36526                      transfer-ownership="none"
36527                      scope="async"
36528                      closure="2">
36529             <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
36530             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
36531           </parameter>
36532           <parameter name="user_data" transfer-ownership="none">
36533             <doc xml:whitespace="preserve">the data to pass to callback function</doc>
36534             <type name="gpointer" c:type="gpointer"/>
36535           </parameter>
36536         </parameters>
36537       </method>
36538       <method name="next_finish"
36539               c:identifier="g_socket_address_enumerator_next_finish"
36540               throws="1">
36541         <doc xml:whitespace="preserve">Retrieves the result of a completed call to
36542 g_socket_address_enumerator_next_async(). See
36543 g_socket_address_enumerator_next() for more information about
36544 error handling.
36545 error (in which case *@error will be set) or if there are no
36546 more addresses.</doc>
36547         <return-value transfer-ownership="full">
36548           <doc xml:whitespace="preserve">a #GSocketAddress (owned by the caller), or %NULL on</doc>
36549           <type name="SocketAddress" c:type="GSocketAddress*"/>
36550         </return-value>
36551         <parameters>
36552           <parameter name="result" transfer-ownership="none">
36553             <doc xml:whitespace="preserve">a #GAsyncResult</doc>
36554             <type name="AsyncResult" c:type="GAsyncResult*"/>
36555           </parameter>
36556         </parameters>
36557       </method>
36558       <field name="parent_instance">
36559         <type name="GObject.Object" c:type="GObject"/>
36560       </field>
36561     </class>
36562     <record name="SocketAddressEnumeratorClass"
36563             c:type="GSocketAddressEnumeratorClass"
36564             glib:is-gtype-struct-for="SocketAddressEnumerator">
36565       <field name="parent_class">
36566         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
36567       </field>
36568       <field name="next">
36569         <callback name="next" throws="1">
36570           <return-value transfer-ownership="full">
36571             <doc xml:whitespace="preserve">a #GSocketAddress (owned by the caller), or %NULL on</doc>
36572             <type name="SocketAddress" c:type="GSocketAddress*"/>
36573           </return-value>
36574           <parameters>
36575             <parameter name="enumerator" transfer-ownership="none">
36576               <type name="SocketAddressEnumerator"
36577                     c:type="GSocketAddressEnumerator*"/>
36578             </parameter>
36579             <parameter name="cancellable"
36580                        transfer-ownership="none"
36581                        allow-none="1">
36582               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
36583               <type name="Cancellable" c:type="GCancellable*"/>
36584             </parameter>
36585           </parameters>
36586         </callback>
36587       </field>
36588       <field name="next_async">
36589         <callback name="next_async">
36590           <return-value transfer-ownership="none">
36591             <type name="none" c:type="void"/>
36592           </return-value>
36593           <parameters>
36594             <parameter name="enumerator" transfer-ownership="none">
36595               <type name="SocketAddressEnumerator"
36596                     c:type="GSocketAddressEnumerator*"/>
36597             </parameter>
36598             <parameter name="cancellable"
36599                        transfer-ownership="none"
36600                        allow-none="1">
36601               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
36602               <type name="Cancellable" c:type="GCancellable*"/>
36603             </parameter>
36604             <parameter name="callback"
36605                        transfer-ownership="none"
36606                        scope="async"
36607                        closure="3">
36608               <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
36609               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
36610             </parameter>
36611             <parameter name="user_data" transfer-ownership="none" closure="3">
36612               <doc xml:whitespace="preserve">the data to pass to callback function</doc>
36613               <type name="gpointer" c:type="gpointer"/>
36614             </parameter>
36615           </parameters>
36616         </callback>
36617       </field>
36618       <field name="next_finish">
36619         <callback name="next_finish" throws="1">
36620           <return-value transfer-ownership="full">
36621             <doc xml:whitespace="preserve">a #GSocketAddress (owned by the caller), or %NULL on</doc>
36622             <type name="SocketAddress" c:type="GSocketAddress*"/>
36623           </return-value>
36624           <parameters>
36625             <parameter name="enumerator" transfer-ownership="none">
36626               <type name="SocketAddressEnumerator"
36627                     c:type="GSocketAddressEnumerator*"/>
36628             </parameter>
36629             <parameter name="result" transfer-ownership="none">
36630               <doc xml:whitespace="preserve">a #GAsyncResult</doc>
36631               <type name="AsyncResult" c:type="GAsyncResult*"/>
36632             </parameter>
36633           </parameters>
36634         </callback>
36635       </field>
36636     </record>
36637     <record name="SocketClass"
36638             c:type="GSocketClass"
36639             glib:is-gtype-struct-for="Socket">
36640       <field name="parent_class">
36641         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
36642       </field>
36643       <field name="_g_reserved1" introspectable="0">
36644         <callback name="_g_reserved1">
36645           <return-value transfer-ownership="none">
36646             <type name="none" c:type="void"/>
36647           </return-value>
36648         </callback>
36649       </field>
36650       <field name="_g_reserved2" introspectable="0">
36651         <callback name="_g_reserved2">
36652           <return-value transfer-ownership="none">
36653             <type name="none" c:type="void"/>
36654           </return-value>
36655         </callback>
36656       </field>
36657       <field name="_g_reserved3" introspectable="0">
36658         <callback name="_g_reserved3">
36659           <return-value transfer-ownership="none">
36660             <type name="none" c:type="void"/>
36661           </return-value>
36662         </callback>
36663       </field>
36664       <field name="_g_reserved4" introspectable="0">
36665         <callback name="_g_reserved4">
36666           <return-value transfer-ownership="none">
36667             <type name="none" c:type="void"/>
36668           </return-value>
36669         </callback>
36670       </field>
36671       <field name="_g_reserved5" introspectable="0">
36672         <callback name="_g_reserved5">
36673           <return-value transfer-ownership="none">
36674             <type name="none" c:type="void"/>
36675           </return-value>
36676         </callback>
36677       </field>
36678       <field name="_g_reserved6" introspectable="0">
36679         <callback name="_g_reserved6">
36680           <return-value transfer-ownership="none">
36681             <type name="none" c:type="void"/>
36682           </return-value>
36683         </callback>
36684       </field>
36685       <field name="_g_reserved7" introspectable="0">
36686         <callback name="_g_reserved7">
36687           <return-value transfer-ownership="none">
36688             <type name="none" c:type="void"/>
36689           </return-value>
36690         </callback>
36691       </field>
36692       <field name="_g_reserved8" introspectable="0">
36693         <callback name="_g_reserved8">
36694           <return-value transfer-ownership="none">
36695             <type name="none" c:type="void"/>
36696           </return-value>
36697         </callback>
36698       </field>
36699       <field name="_g_reserved9" introspectable="0">
36700         <callback name="_g_reserved9">
36701           <return-value transfer-ownership="none">
36702             <type name="none" c:type="void"/>
36703           </return-value>
36704         </callback>
36705       </field>
36706       <field name="_g_reserved10" introspectable="0">
36707         <callback name="_g_reserved10">
36708           <return-value transfer-ownership="none">
36709             <type name="none" c:type="void"/>
36710           </return-value>
36711         </callback>
36712       </field>
36713     </record>
36714     <class name="SocketClient"
36715            c:symbol-prefix="socket_client"
36716            c:type="GSocketClient"
36717            version="2.22"
36718            parent="GObject.Object"
36719            glib:type-name="GSocketClient"
36720            glib:get-type="g_socket_client_get_type"
36721            glib:type-struct="SocketClientClass">
36722       <doc xml:whitespace="preserve">A helper class for network servers to listen for and accept connections.</doc>
36723       <constructor name="new"
36724                    c:identifier="g_socket_client_new"
36725                    version="2.22">
36726         <doc xml:whitespace="preserve">Creates a new #GSocketClient with the default options.
36727 Free the returned object with g_object_unref().</doc>
36728         <return-value transfer-ownership="full">
36729           <doc xml:whitespace="preserve">a #GSocketClient.</doc>
36730           <type name="SocketClient" c:type="GSocketClient*"/>
36731         </return-value>
36732       </constructor>
36733       <method name="add_application_proxy"
36734               c:identifier="g_socket_client_add_application_proxy">
36735         <doc xml:whitespace="preserve">Enable proxy protocols to be handled by the application. When the
36736 indicated proxy protocol is returned by the #GProxyResolver,
36737 #GSocketClient will consider this protocol as supported but will
36738 not try find a #GProxy instance to handle handshaking. The
36739 application must check for this case by calling
36740 g_socket_connection_get_remote_address() on the returned
36741 #GSocketConnection, and seeing if it's a #GProxyAddress of the
36742 appropriate type, to determine whether or not it needs to handle
36743 the proxy handshaking itself.
36744 This should be used for proxy protocols that are dialects of
36745 another protocol such as HTTP proxy. It also allows cohabitation of
36746 proxy protocols that are reused between protocols. A good example
36747 is HTTP. It can be used to proxy HTTP, FTP and Gopher and can also
36748 be use as generic socket proxy through the HTTP CONNECT method.</doc>
36749         <return-value transfer-ownership="none">
36750           <type name="none" c:type="void"/>
36751         </return-value>
36752         <parameters>
36753           <parameter name="protocol" transfer-ownership="none">
36754             <doc xml:whitespace="preserve">The proxy protocol</doc>
36755             <type name="utf8" c:type="gchar*"/>
36756           </parameter>
36757         </parameters>
36758       </method>
36759       <method name="connect"
36760               c:identifier="g_socket_client_connect"
36761               version="2.22"
36762               throws="1">
36763         <doc xml:whitespace="preserve">Tries to resolve the @connectable and make a network connection to it..
36764 Upon a successful connection, a new #GSocketConnection is constructed
36765 and returned.  The caller owns this new object and must drop their
36766 reference to it when finished with it.
36767 The type of the #GSocketConnection object returned depends on the type of
36768 the underlying socket that is used. For instance, for a TCP/IP connection
36769 it will be a #GTcpConnection.
36770 The socket created will be the same family as the the address that the
36771 or indirectly via g_socket_client_set_local_address(). The socket type
36772 defaults to %G_SOCKET_TYPE_STREAM but can be set with
36773 g_socket_client_set_socket_type().
36774 If a local address is specified with g_socket_client_set_local_address() the
36775 socket will be bound to this address before connecting.</doc>
36776         <return-value transfer-ownership="full">
36777           <doc xml:whitespace="preserve">a #GSocketConnection on success, %NULL on error.</doc>
36778           <type name="SocketConnection" c:type="GSocketConnection*"/>
36779         </return-value>
36780         <parameters>
36781           <parameter name="connectable" transfer-ownership="none">
36782             <doc xml:whitespace="preserve">a #GSocketConnectable specifying the remote address.</doc>
36783             <type name="SocketConnectable" c:type="GSocketConnectable*"/>
36784           </parameter>
36785           <parameter name="cancellable"
36786                      transfer-ownership="none"
36787                      allow-none="1">
36788             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
36789             <type name="Cancellable" c:type="GCancellable*"/>
36790           </parameter>
36791         </parameters>
36792       </method>
36793       <method name="connect_async"
36794               c:identifier="g_socket_client_connect_async"
36795               version="2.22">
36796         <doc xml:whitespace="preserve">This is the asynchronous version of g_socket_client_connect().
36797 When the operation is finished @callback will be
36798 called. You can then call g_socket_client_connect_finish() to get
36799 the result of the operation.</doc>
36800         <return-value transfer-ownership="none">
36801           <type name="none" c:type="void"/>
36802         </return-value>
36803         <parameters>
36804           <parameter name="connectable" transfer-ownership="none">
36805             <doc xml:whitespace="preserve">a #GSocketConnectable specifying the remote address.</doc>
36806             <type name="SocketConnectable" c:type="GSocketConnectable*"/>
36807           </parameter>
36808           <parameter name="cancellable"
36809                      transfer-ownership="none"
36810                      allow-none="1">
36811             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
36812             <type name="Cancellable" c:type="GCancellable*"/>
36813           </parameter>
36814           <parameter name="callback"
36815                      transfer-ownership="none"
36816                      scope="async"
36817                      closure="3">
36818             <doc xml:whitespace="preserve">a #GAsyncReadyCallback</doc>
36819             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
36820           </parameter>
36821           <parameter name="user_data" transfer-ownership="none">
36822             <doc xml:whitespace="preserve">user data for the callback</doc>
36823             <type name="gpointer" c:type="gpointer"/>
36824           </parameter>
36825         </parameters>
36826       </method>
36827       <method name="connect_finish"
36828               c:identifier="g_socket_client_connect_finish"
36829               version="2.22"
36830               throws="1">
36831         <doc xml:whitespace="preserve">Finishes an async connect operation. See g_socket_client_connect_async()</doc>
36832         <return-value transfer-ownership="full">
36833           <doc xml:whitespace="preserve">a #GSocketConnection on success, %NULL on error.</doc>
36834           <type name="SocketConnection" c:type="GSocketConnection*"/>
36835         </return-value>
36836         <parameters>
36837           <parameter name="result" transfer-ownership="none">
36838             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
36839             <type name="AsyncResult" c:type="GAsyncResult*"/>
36840           </parameter>
36841         </parameters>
36842       </method>
36843       <method name="connect_to_host"
36844               c:identifier="g_socket_client_connect_to_host"
36845               version="2.22"
36846               throws="1">
36847         <doc xml:whitespace="preserve">This is a helper function for g_socket_client_connect().
36848 Attempts to create a TCP connection to the named host.
36849 address, an IPv4 address, or a domain name (in which case a DNS
36850 lookup is performed).  Quoting with [] is supported for all address
36851 types.  A port override may be specified in the usual way with a
36852 colon.  Ports may be given as decimal numbers or symbolic names (in
36853 which case an /etc/services lookup is performed).
36854 If no port override is given in @host_and_port then @default_port will be
36855 used as the port number to connect to.
36856 In general, @host_and_port is expected to be provided by the user (allowing
36857 them to give the hostname, and a port overide if necessary) and
36858 In the case that an IP address is given, a single connection
36859 attempt is made.  In the case that a name is given, multiple
36860 connection attempts may be made, in turn and according to the
36861 number of address records in DNS, until a connection succeeds.
36862 Upon a successful connection, a new #GSocketConnection is constructed
36863 and returned.  The caller owns this new object and must drop their
36864 reference to it when finished with it.
36865 In the event of any failure (DNS error, service not found, no hosts
36866 connectable) %NULL is returned and @error (if non-%NULL) is set
36867 accordingly.</doc>
36868         <return-value transfer-ownership="full">
36869           <doc xml:whitespace="preserve">a #GSocketConnection on success, %NULL on error.</doc>
36870           <type name="SocketConnection" c:type="GSocketConnection*"/>
36871         </return-value>
36872         <parameters>
36873           <parameter name="host_and_port" transfer-ownership="none">
36874             <doc xml:whitespace="preserve">the name and optionally port of the host to connect to</doc>
36875             <type name="utf8" c:type="gchar*"/>
36876           </parameter>
36877           <parameter name="default_port" transfer-ownership="none">
36878             <doc xml:whitespace="preserve">the default port to connect to</doc>
36879             <type name="guint16" c:type="guint16"/>
36880           </parameter>
36881           <parameter name="cancellable"
36882                      transfer-ownership="none"
36883                      allow-none="1">
36884             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
36885             <type name="Cancellable" c:type="GCancellable*"/>
36886           </parameter>
36887         </parameters>
36888       </method>
36889       <method name="connect_to_host_async"
36890               c:identifier="g_socket_client_connect_to_host_async"
36891               version="2.22">
36892         <doc xml:whitespace="preserve">This is the asynchronous version of g_socket_client_connect_to_host().
36893 When the operation is finished @callback will be
36894 called. You can then call g_socket_client_connect_to_host_finish() to get
36895 the result of the operation.</doc>
36896         <return-value transfer-ownership="none">
36897           <type name="none" c:type="void"/>
36898         </return-value>
36899         <parameters>
36900           <parameter name="host_and_port" transfer-ownership="none">
36901             <doc xml:whitespace="preserve">the name and optionally the port of the host to connect to</doc>
36902             <type name="utf8" c:type="gchar*"/>
36903           </parameter>
36904           <parameter name="default_port" transfer-ownership="none">
36905             <doc xml:whitespace="preserve">the default port to connect to</doc>
36906             <type name="guint16" c:type="guint16"/>
36907           </parameter>
36908           <parameter name="cancellable"
36909                      transfer-ownership="none"
36910                      allow-none="1">
36911             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
36912             <type name="Cancellable" c:type="GCancellable*"/>
36913           </parameter>
36914           <parameter name="callback"
36915                      transfer-ownership="none"
36916                      scope="async"
36917                      closure="4">
36918             <doc xml:whitespace="preserve">a #GAsyncReadyCallback</doc>
36919             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
36920           </parameter>
36921           <parameter name="user_data" transfer-ownership="none">
36922             <doc xml:whitespace="preserve">user data for the callback</doc>
36923             <type name="gpointer" c:type="gpointer"/>
36924           </parameter>
36925         </parameters>
36926       </method>
36927       <method name="connect_to_host_finish"
36928               c:identifier="g_socket_client_connect_to_host_finish"
36929               version="2.22"
36930               throws="1">
36931         <doc xml:whitespace="preserve">Finishes an async connect operation. See g_socket_client_connect_to_host_async()</doc>
36932         <return-value transfer-ownership="full">
36933           <doc xml:whitespace="preserve">a #GSocketConnection on success, %NULL on error.</doc>
36934           <type name="SocketConnection" c:type="GSocketConnection*"/>
36935         </return-value>
36936         <parameters>
36937           <parameter name="result" transfer-ownership="none">
36938             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
36939             <type name="AsyncResult" c:type="GAsyncResult*"/>
36940           </parameter>
36941         </parameters>
36942       </method>
36943       <method name="connect_to_service"
36944               c:identifier="g_socket_client_connect_to_service"
36945               throws="1">
36946         <doc xml:whitespace="preserve">Attempts to create a TCP connection to a service.
36947 This call looks up the SRV record for @service at @domain for the
36948 "tcp" protocol.  It then attempts to connect, in turn, to each of
36949 the hosts providing the service until either a connection succeeds
36950 or there are no hosts remaining.
36951 Upon a successful connection, a new #GSocketConnection is constructed
36952 and returned.  The caller owns this new object and must drop their
36953 reference to it when finished with it.
36954 In the event of any failure (DNS error, service not found, no hosts
36955 connectable) %NULL is returned and @error (if non-%NULL) is set
36956 accordingly.</doc>
36957         <return-value transfer-ownership="full">
36958           <doc xml:whitespace="preserve">a #GSocketConnection if successful, or %NULL on error</doc>
36959           <type name="SocketConnection" c:type="GSocketConnection*"/>
36960         </return-value>
36961         <parameters>
36962           <parameter name="domain" transfer-ownership="none">
36963             <doc xml:whitespace="preserve">a domain name</doc>
36964             <type name="utf8" c:type="gchar*"/>
36965           </parameter>
36966           <parameter name="service" transfer-ownership="none">
36967             <doc xml:whitespace="preserve">the name of the service to connect to</doc>
36968             <type name="utf8" c:type="gchar*"/>
36969           </parameter>
36970           <parameter name="cancellable"
36971                      transfer-ownership="none"
36972                      allow-none="1">
36973             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
36974             <type name="Cancellable" c:type="GCancellable*"/>
36975           </parameter>
36976         </parameters>
36977       </method>
36978       <method name="connect_to_service_async"
36979               c:identifier="g_socket_client_connect_to_service_async"
36980               version="2.22">
36981         <doc xml:whitespace="preserve">This is the asynchronous version of
36982 g_socket_client_connect_to_service().</doc>
36983         <return-value transfer-ownership="none">
36984           <type name="none" c:type="void"/>
36985         </return-value>
36986         <parameters>
36987           <parameter name="domain" transfer-ownership="none">
36988             <doc xml:whitespace="preserve">a domain name</doc>
36989             <type name="utf8" c:type="gchar*"/>
36990           </parameter>
36991           <parameter name="service" transfer-ownership="none">
36992             <doc xml:whitespace="preserve">the name of the service to connect to</doc>
36993             <type name="utf8" c:type="gchar*"/>
36994           </parameter>
36995           <parameter name="cancellable"
36996                      transfer-ownership="none"
36997                      allow-none="1">
36998             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
36999             <type name="Cancellable" c:type="GCancellable*"/>
37000           </parameter>
37001           <parameter name="callback"
37002                      transfer-ownership="none"
37003                      scope="async"
37004                      closure="4">
37005             <doc xml:whitespace="preserve">a #GAsyncReadyCallback</doc>
37006             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
37007           </parameter>
37008           <parameter name="user_data" transfer-ownership="none">
37009             <doc xml:whitespace="preserve">user data for the callback</doc>
37010             <type name="gpointer" c:type="gpointer"/>
37011           </parameter>
37012         </parameters>
37013       </method>
37014       <method name="connect_to_service_finish"
37015               c:identifier="g_socket_client_connect_to_service_finish"
37016               version="2.22"
37017               throws="1">
37018         <doc xml:whitespace="preserve">Finishes an async connect operation. See g_socket_client_connect_to_service_async()</doc>
37019         <return-value transfer-ownership="full">
37020           <doc xml:whitespace="preserve">a #GSocketConnection on success, %NULL on error.</doc>
37021           <type name="SocketConnection" c:type="GSocketConnection*"/>
37022         </return-value>
37023         <parameters>
37024           <parameter name="result" transfer-ownership="none">
37025             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
37026             <type name="AsyncResult" c:type="GAsyncResult*"/>
37027           </parameter>
37028         </parameters>
37029       </method>
37030       <method name="connect_to_uri"
37031               c:identifier="g_socket_client_connect_to_uri"
37032               version="2.26"
37033               throws="1">
37034         <doc xml:whitespace="preserve">This is a helper function for g_socket_client_connect().
37035 Attempts to create a TCP connection with a network URI.
37036 component. If a port is not specified in the URI, @default_port
37037 will be used.
37038 Using this rather than g_socket_client_connect() or
37039 g_socket_client_connect_to_host() allows #GSocketClient to
37040 determine when to use application-specific proxy protocols.
37041 Upon a successful connection, a new #GSocketConnection is constructed
37042 and returned.  The caller owns this new object and must drop their
37043 reference to it when finished with it.
37044 In the event of any failure (DNS error, service not found, no hosts
37045 connectable) %NULL is returned and @error (if non-%NULL) is set
37046 accordingly.</doc>
37047         <return-value transfer-ownership="full">
37048           <doc xml:whitespace="preserve">a #GSocketConnection on success, %NULL on error.</doc>
37049           <type name="SocketConnection" c:type="GSocketConnection*"/>
37050         </return-value>
37051         <parameters>
37052           <parameter name="uri" transfer-ownership="none">
37053             <doc xml:whitespace="preserve">A network URI</doc>
37054             <type name="utf8" c:type="gchar*"/>
37055           </parameter>
37056           <parameter name="default_port" transfer-ownership="none">
37057             <doc xml:whitespace="preserve">the default port to connect to</doc>
37058             <type name="guint16" c:type="guint16"/>
37059           </parameter>
37060           <parameter name="cancellable"
37061                      transfer-ownership="none"
37062                      allow-none="1">
37063             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
37064             <type name="Cancellable" c:type="GCancellable*"/>
37065           </parameter>
37066         </parameters>
37067       </method>
37068       <method name="connect_to_uri_async"
37069               c:identifier="g_socket_client_connect_to_uri_async"
37070               version="2.26">
37071         <doc xml:whitespace="preserve">This is the asynchronous version of g_socket_client_connect_to_uri().
37072 When the operation is finished @callback will be
37073 called. You can then call g_socket_client_connect_to_uri_finish() to get
37074 the result of the operation.</doc>
37075         <return-value transfer-ownership="none">
37076           <type name="none" c:type="void"/>
37077         </return-value>
37078         <parameters>
37079           <parameter name="uri" transfer-ownership="none">
37080             <doc xml:whitespace="preserve">a network uri</doc>
37081             <type name="utf8" c:type="gchar*"/>
37082           </parameter>
37083           <parameter name="default_port" transfer-ownership="none">
37084             <doc xml:whitespace="preserve">the default port to connect to</doc>
37085             <type name="guint16" c:type="guint16"/>
37086           </parameter>
37087           <parameter name="cancellable"
37088                      transfer-ownership="none"
37089                      allow-none="1">
37090             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
37091             <type name="Cancellable" c:type="GCancellable*"/>
37092           </parameter>
37093           <parameter name="callback"
37094                      transfer-ownership="none"
37095                      scope="async"
37096                      closure="4">
37097             <doc xml:whitespace="preserve">a #GAsyncReadyCallback</doc>
37098             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
37099           </parameter>
37100           <parameter name="user_data" transfer-ownership="none">
37101             <doc xml:whitespace="preserve">user data for the callback</doc>
37102             <type name="gpointer" c:type="gpointer"/>
37103           </parameter>
37104         </parameters>
37105       </method>
37106       <method name="connect_to_uri_finish"
37107               c:identifier="g_socket_client_connect_to_uri_finish"
37108               version="2.26"
37109               throws="1">
37110         <doc xml:whitespace="preserve">Finishes an async connect operation. See g_socket_client_connect_to_uri_async()</doc>
37111         <return-value transfer-ownership="full">
37112           <doc xml:whitespace="preserve">a #GSocketConnection on success, %NULL on error.</doc>
37113           <type name="SocketConnection" c:type="GSocketConnection*"/>
37114         </return-value>
37115         <parameters>
37116           <parameter name="result" transfer-ownership="none">
37117             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
37118             <type name="AsyncResult" c:type="GAsyncResult*"/>
37119           </parameter>
37120         </parameters>
37121       </method>
37122       <method name="get_enable_proxy"
37123               c:identifier="g_socket_client_get_enable_proxy"
37124               version="2.26">
37125         <doc xml:whitespace="preserve">Gets the proxy enable state; see g_socket_client_set_enable_proxy()</doc>
37126         <return-value transfer-ownership="none">
37127           <doc xml:whitespace="preserve">whether proxying is enabled</doc>
37128           <type name="gboolean" c:type="gboolean"/>
37129         </return-value>
37130       </method>
37131       <method name="get_family"
37132               c:identifier="g_socket_client_get_family"
37133               version="2.22">
37134         <doc xml:whitespace="preserve">Gets the socket family of the socket client.
37135 See g_socket_client_set_family() for details.</doc>
37136         <return-value transfer-ownership="none">
37137           <doc xml:whitespace="preserve">a #GSocketFamily</doc>
37138           <type name="SocketFamily" c:type="GSocketFamily"/>
37139         </return-value>
37140       </method>
37141       <method name="get_local_address"
37142               c:identifier="g_socket_client_get_local_address"
37143               version="2.22">
37144         <doc xml:whitespace="preserve">Gets the local address of the socket client.
37145 See g_socket_client_set_local_address() for details.</doc>
37146         <return-value transfer-ownership="none">
37147           <doc xml:whitespace="preserve">a #GSocketAddres or %NULL. don't free</doc>
37148           <type name="SocketAddress" c:type="GSocketAddress*"/>
37149         </return-value>
37150       </method>
37151       <method name="get_protocol"
37152               c:identifier="g_socket_client_get_protocol"
37153               version="2.22">
37154         <doc xml:whitespace="preserve">Gets the protocol name type of the socket client.
37155 See g_socket_client_set_protocol() for details.</doc>
37156         <return-value transfer-ownership="none">
37157           <doc xml:whitespace="preserve">a #GSocketProtocol</doc>
37158           <type name="SocketProtocol" c:type="GSocketProtocol"/>
37159         </return-value>
37160       </method>
37161       <method name="get_socket_type"
37162               c:identifier="g_socket_client_get_socket_type"
37163               version="2.22">
37164         <doc xml:whitespace="preserve">Gets the socket type of the socket client.
37165 See g_socket_client_set_socket_type() for details.</doc>
37166         <return-value transfer-ownership="none">
37167           <doc xml:whitespace="preserve">a #GSocketFamily</doc>
37168           <type name="SocketType" c:type="GSocketType"/>
37169         </return-value>
37170       </method>
37171       <method name="get_timeout"
37172               c:identifier="g_socket_client_get_timeout"
37173               version="2.26">
37174         <doc xml:whitespace="preserve">Gets the I/O timeout time for sockets created by @client.
37175 See g_socket_client_set_timeout() for details.</doc>
37176         <return-value transfer-ownership="none">
37177           <doc xml:whitespace="preserve">the timeout in seconds</doc>
37178           <type name="guint" c:type="guint"/>
37179         </return-value>
37180       </method>
37181       <method name="set_enable_proxy"
37182               c:identifier="g_socket_client_set_enable_proxy"
37183               version="2.26">
37184         <doc xml:whitespace="preserve">Sets whether or not @client attempts to make connections via a
37185 proxy server. When enabled (the default), #GSocketClient will use a
37186 #GProxyResolver to determine if a proxy protocol such as SOCKS is
37187 needed, and automatically do the necessary proxy negotiation.</doc>
37188         <return-value transfer-ownership="none">
37189           <type name="none" c:type="void"/>
37190         </return-value>
37191         <parameters>
37192           <parameter name="enable" transfer-ownership="none">
37193             <doc xml:whitespace="preserve">whether to enable proxies</doc>
37194             <type name="gboolean" c:type="gboolean"/>
37195           </parameter>
37196         </parameters>
37197       </method>
37198       <method name="set_family"
37199               c:identifier="g_socket_client_set_family"
37200               version="2.22">
37201         <doc xml:whitespace="preserve">Sets the socket family of the socket client.
37202 If this is set to something other than %G_SOCKET_FAMILY_INVALID
37203 then the sockets created by this object will be of the specified
37204 family.
37205 This might be useful for instance if you want to force the local
37206 connection to be an ipv4 socket, even though the address might
37207 be an ipv6 mapped to ipv4 address.</doc>
37208         <return-value transfer-ownership="none">
37209           <type name="none" c:type="void"/>
37210         </return-value>
37211         <parameters>
37212           <parameter name="family" transfer-ownership="none">
37213             <doc xml:whitespace="preserve">a #GSocketFamily</doc>
37214             <type name="SocketFamily" c:type="GSocketFamily"/>
37215           </parameter>
37216         </parameters>
37217       </method>
37218       <method name="set_local_address"
37219               c:identifier="g_socket_client_set_local_address"
37220               version="2.22">
37221         <doc xml:whitespace="preserve">Sets the local address of the socket client.
37222 The sockets created by this object will bound to the
37223 specified address (if not %NULL) before connecting.
37224 This is useful if you want to ensure the the local
37225 side of the connection is on a specific port, or on
37226 a specific interface.</doc>
37227         <return-value transfer-ownership="none">
37228           <type name="none" c:type="void"/>
37229         </return-value>
37230         <parameters>
37231           <parameter name="address" transfer-ownership="none">
37232             <doc xml:whitespace="preserve">a #GSocketAddress, or %NULL</doc>
37233             <type name="SocketAddress" c:type="GSocketAddress*"/>
37234           </parameter>
37235         </parameters>
37236       </method>
37237       <method name="set_protocol"
37238               c:identifier="g_socket_client_set_protocol"
37239               version="2.22">
37240         <doc xml:whitespace="preserve">Sets the protocol of the socket client.
37241 The sockets created by this object will use of the specified
37242 protocol.
37243 If @protocol is %0 that means to use the default
37244 protocol for the socket family and type.</doc>
37245         <return-value transfer-ownership="none">
37246           <type name="none" c:type="void"/>
37247         </return-value>
37248         <parameters>
37249           <parameter name="protocol" transfer-ownership="none">
37250             <doc xml:whitespace="preserve">a #GSocketProtocol</doc>
37251             <type name="SocketProtocol" c:type="GSocketProtocol"/>
37252           </parameter>
37253         </parameters>
37254       </method>
37255       <method name="set_socket_type"
37256               c:identifier="g_socket_client_set_socket_type"
37257               version="2.22">
37258         <doc xml:whitespace="preserve">Sets the socket type of the socket client.
37259 The sockets created by this object will be of the specified
37260 type.
37261 It doesn't make sense to specify a type of %G_SOCKET_TYPE_DATAGRAM,
37262 as GSocketClient is used for connection oriented services.</doc>
37263         <return-value transfer-ownership="none">
37264           <type name="none" c:type="void"/>
37265         </return-value>
37266         <parameters>
37267           <parameter name="type" transfer-ownership="none">
37268             <doc xml:whitespace="preserve">a #GSocketType</doc>
37269             <type name="SocketType" c:type="GSocketType"/>
37270           </parameter>
37271         </parameters>
37272       </method>
37273       <method name="set_timeout"
37274               c:identifier="g_socket_client_set_timeout"
37275               version="2.26">
37276         <doc xml:whitespace="preserve">Sets the I/O timeout for sockets created by @client. @timeout is a
37277 time in seconds, or 0 for no timeout (the default).
37278 The timeout value affects the initial connection attempt as well,
37279 so setting this may cause calls to g_socket_client_connect(), etc,
37280 to fail with %G_IO_ERROR_TIMED_OUT.</doc>
37281         <return-value transfer-ownership="none">
37282           <type name="none" c:type="void"/>
37283         </return-value>
37284         <parameters>
37285           <parameter name="timeout" transfer-ownership="none">
37286             <doc xml:whitespace="preserve">the timeout</doc>
37287             <type name="guint" c:type="guint"/>
37288           </parameter>
37289         </parameters>
37290       </method>
37291       <property name="enable-proxy"
37292                 writable="1"
37293                 construct="1"
37294                 transfer-ownership="none">
37295         <type name="gboolean"/>
37296       </property>
37297       <property name="family"
37298                 writable="1"
37299                 construct="1"
37300                 transfer-ownership="none">
37301         <type name="SocketFamily"/>
37302       </property>
37303       <property name="local-address"
37304                 writable="1"
37305                 construct="1"
37306                 transfer-ownership="none">
37307         <type name="SocketAddress"/>
37308       </property>
37309       <property name="protocol"
37310                 writable="1"
37311                 construct="1"
37312                 transfer-ownership="none">
37313         <type name="SocketProtocol"/>
37314       </property>
37315       <property name="timeout"
37316                 writable="1"
37317                 construct="1"
37318                 transfer-ownership="none">
37319         <type name="guint"/>
37320       </property>
37321       <property name="type"
37322                 writable="1"
37323                 construct="1"
37324                 transfer-ownership="none">
37325         <type name="SocketType"/>
37326       </property>
37327       <field name="parent_instance">
37328         <type name="GObject.Object" c:type="GObject"/>
37329       </field>
37330       <field name="priv">
37331         <type name="SocketClientPrivate" c:type="GSocketClientPrivate*"/>
37332       </field>
37333     </class>
37334     <record name="SocketClientClass"
37335             c:type="GSocketClientClass"
37336             glib:is-gtype-struct-for="SocketClient">
37337       <field name="parent_class">
37338         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
37339       </field>
37340       <field name="_g_reserved1" introspectable="0">
37341         <callback name="_g_reserved1">
37342           <return-value transfer-ownership="none">
37343             <type name="none" c:type="void"/>
37344           </return-value>
37345         </callback>
37346       </field>
37347       <field name="_g_reserved2" introspectable="0">
37348         <callback name="_g_reserved2">
37349           <return-value transfer-ownership="none">
37350             <type name="none" c:type="void"/>
37351           </return-value>
37352         </callback>
37353       </field>
37354       <field name="_g_reserved3" introspectable="0">
37355         <callback name="_g_reserved3">
37356           <return-value transfer-ownership="none">
37357             <type name="none" c:type="void"/>
37358           </return-value>
37359         </callback>
37360       </field>
37361       <field name="_g_reserved4" introspectable="0">
37362         <callback name="_g_reserved4">
37363           <return-value transfer-ownership="none">
37364             <type name="none" c:type="void"/>
37365           </return-value>
37366         </callback>
37367       </field>
37368       <field name="_g_reserved5" introspectable="0">
37369         <callback name="_g_reserved5">
37370           <return-value transfer-ownership="none">
37371             <type name="none" c:type="void"/>
37372           </return-value>
37373         </callback>
37374       </field>
37375     </record>
37376     <record name="SocketClientPrivate"
37377             c:type="GSocketClientPrivate"
37378             disguised="1">
37379     </record>
37380     <interface name="SocketConnectable"
37381                c:symbol-prefix="socket_connectable"
37382                c:type="GSocketConnectable"
37383                glib:type-name="GSocketConnectable"
37384                glib:get-type="g_socket_connectable_get_type"
37385                glib:type-struct="SocketConnectableIface">
37386       <doc xml:whitespace="preserve">Interface for objects that contain or generate #GSocketAddress&lt;!-- --&gt;es.</doc>
37387       <virtual-method name="enumerate" invoker="enumerate" version="2.22">
37388         <doc xml:whitespace="preserve">Creates a #GSocketAddressEnumerator for @connectable.</doc>
37389         <return-value transfer-ownership="full">
37390           <doc xml:whitespace="preserve">a new #GSocketAddressEnumerator.</doc>
37391           <type name="SocketAddressEnumerator"
37392                 c:type="GSocketAddressEnumerator*"/>
37393         </return-value>
37394       </virtual-method>
37395       <virtual-method name="proxy_enumerate"
37396                       invoker="proxy_enumerate"
37397                       version="2.26">
37398         <doc xml:whitespace="preserve">Creates a #GSocketAddressEnumerator for @connectable that will
37399 return #GProxyAddress&lt;!-- --&gt;es for addresses that you must connect
37400 to via a proxy.
37401 If @connectable does not implement
37402 g_socket_connectable_proxy_enumerate(), this will fall back to
37403 calling g_socket_connectable_enumerate().</doc>
37404         <return-value transfer-ownership="full">
37405           <doc xml:whitespace="preserve">a new #GSocketAddressEnumerator.</doc>
37406           <type name="SocketAddressEnumerator"
37407                 c:type="GSocketAddressEnumerator*"/>
37408         </return-value>
37409       </virtual-method>
37410       <method name="enumerate"
37411               c:identifier="g_socket_connectable_enumerate"
37412               version="2.22">
37413         <doc xml:whitespace="preserve">Creates a #GSocketAddressEnumerator for @connectable.</doc>
37414         <return-value transfer-ownership="full">
37415           <doc xml:whitespace="preserve">a new #GSocketAddressEnumerator.</doc>
37416           <type name="SocketAddressEnumerator"
37417                 c:type="GSocketAddressEnumerator*"/>
37418         </return-value>
37419       </method>
37420       <method name="proxy_enumerate"
37421               c:identifier="g_socket_connectable_proxy_enumerate"
37422               version="2.26">
37423         <doc xml:whitespace="preserve">Creates a #GSocketAddressEnumerator for @connectable that will
37424 return #GProxyAddress&lt;!-- --&gt;es for addresses that you must connect
37425 to via a proxy.
37426 If @connectable does not implement
37427 g_socket_connectable_proxy_enumerate(), this will fall back to
37428 calling g_socket_connectable_enumerate().</doc>
37429         <return-value transfer-ownership="full">
37430           <doc xml:whitespace="preserve">a new #GSocketAddressEnumerator.</doc>
37431           <type name="SocketAddressEnumerator"
37432                 c:type="GSocketAddressEnumerator*"/>
37433         </return-value>
37434       </method>
37435     </interface>
37436     <record name="SocketConnectableIface"
37437             c:type="GSocketConnectableIface"
37438             glib:is-gtype-struct-for="SocketConnectable">
37439       <doc xml:whitespace="preserve">Provides an interface for returning a #GSocketAddressEnumerator
37440 and #GProxyAddressEnumerator</doc>
37441       <field name="g_iface">
37442         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
37443       </field>
37444       <field name="enumerate">
37445         <callback name="enumerate">
37446           <return-value transfer-ownership="full">
37447             <doc xml:whitespace="preserve">a new #GSocketAddressEnumerator.</doc>
37448             <type name="SocketAddressEnumerator"
37449                   c:type="GSocketAddressEnumerator*"/>
37450           </return-value>
37451           <parameters>
37452             <parameter name="connectable" transfer-ownership="none">
37453               <type name="SocketConnectable" c:type="GSocketConnectable*"/>
37454             </parameter>
37455           </parameters>
37456         </callback>
37457       </field>
37458       <field name="proxy_enumerate">
37459         <callback name="proxy_enumerate">
37460           <return-value transfer-ownership="full">
37461             <doc xml:whitespace="preserve">a new #GSocketAddressEnumerator.</doc>
37462             <type name="SocketAddressEnumerator"
37463                   c:type="GSocketAddressEnumerator*"/>
37464           </return-value>
37465           <parameters>
37466             <parameter name="connectable" transfer-ownership="none">
37467               <type name="SocketConnectable" c:type="GSocketConnectable*"/>
37468             </parameter>
37469           </parameters>
37470         </callback>
37471       </field>
37472     </record>
37473     <class name="SocketConnection"
37474            c:symbol-prefix="socket_connection"
37475            c:type="GSocketConnection"
37476            version="2.22"
37477            parent="IOStream"
37478            glib:type-name="GSocketConnection"
37479            glib:get-type="g_socket_connection_get_type"
37480            glib:type-struct="SocketConnectionClass">
37481       <doc xml:whitespace="preserve">A socket connection GIOStream object for connection-oriented sockets.</doc>
37482       <function name="factory_lookup_type"
37483                 c:identifier="g_socket_connection_factory_lookup_type"
37484                 version="2.22">
37485         <doc xml:whitespace="preserve">Looks up the #GType to be used when creating socket connections on
37486 sockets with the specified @family,@type and @protocol_id.
37487 If no type is registered, the #GSocketConnection base type is returned.</doc>
37488         <return-value transfer-ownership="none">
37489           <doc xml:whitespace="preserve">a #GType</doc>
37490           <type name="GType" c:type="GType"/>
37491         </return-value>
37492         <parameters>
37493           <parameter name="family" transfer-ownership="none">
37494             <doc xml:whitespace="preserve">a #GSocketFamily</doc>
37495             <type name="SocketFamily" c:type="GSocketFamily"/>
37496           </parameter>
37497           <parameter name="type" transfer-ownership="none">
37498             <doc xml:whitespace="preserve">a #GSocketType</doc>
37499             <type name="SocketType" c:type="GSocketType"/>
37500           </parameter>
37501           <parameter name="protocol_id" transfer-ownership="none">
37502             <doc xml:whitespace="preserve">a protocol id</doc>
37503             <type name="gint" c:type="gint"/>
37504           </parameter>
37505         </parameters>
37506       </function>
37507       <function name="factory_register_type"
37508                 c:identifier="g_socket_connection_factory_register_type"
37509                 version="2.22">
37510         <doc xml:whitespace="preserve">Looks up the #GType to be used when creating socket connections on
37511 sockets with the specified @family,@type and @protocol.
37512 If no type is registered, the #GSocketConnection base type is returned.</doc>
37513         <return-value transfer-ownership="none">
37514           <type name="none" c:type="void"/>
37515         </return-value>
37516         <parameters>
37517           <parameter name="g_type" transfer-ownership="none">
37518             <doc xml:whitespace="preserve">a #GType, inheriting from %G_TYPE_SOCKET_CONNECTION</doc>
37519             <type name="GType" c:type="GType"/>
37520           </parameter>
37521           <parameter name="family" transfer-ownership="none">
37522             <doc xml:whitespace="preserve">a #GSocketFamily</doc>
37523             <type name="SocketFamily" c:type="GSocketFamily"/>
37524           </parameter>
37525           <parameter name="type" transfer-ownership="none">
37526             <doc xml:whitespace="preserve">a #GSocketType</doc>
37527             <type name="SocketType" c:type="GSocketType"/>
37528           </parameter>
37529           <parameter name="protocol" transfer-ownership="none">
37530             <doc xml:whitespace="preserve">a protocol id</doc>
37531             <type name="gint" c:type="gint"/>
37532           </parameter>
37533         </parameters>
37534       </function>
37535       <method name="get_local_address"
37536               c:identifier="g_socket_connection_get_local_address"
37537               version="2.22"
37538               throws="1">
37539         <doc xml:whitespace="preserve">Try to get the local address of a socket connection.
37540 Free the returned object with g_object_unref().</doc>
37541         <return-value transfer-ownership="full">
37542           <doc xml:whitespace="preserve">a #GSocketAddress or %NULL on error.</doc>
37543           <type name="SocketAddress" c:type="GSocketAddress*"/>
37544         </return-value>
37545       </method>
37546       <method name="get_remote_address"
37547               c:identifier="g_socket_connection_get_remote_address"
37548               version="2.22"
37549               throws="1">
37550         <doc xml:whitespace="preserve">Try to get the remote address of a socket connection.
37551 Free the returned object with g_object_unref().</doc>
37552         <return-value transfer-ownership="full">
37553           <doc xml:whitespace="preserve">a #GSocketAddress or %NULL on error.</doc>
37554           <type name="SocketAddress" c:type="GSocketAddress*"/>
37555         </return-value>
37556       </method>
37557       <method name="get_socket"
37558               c:identifier="g_socket_connection_get_socket"
37559               version="2.22">
37560         <doc xml:whitespace="preserve">Gets the underlying #GSocket object of the connection.
37561 This can be useful if you want to do something unusual on it
37562 not supported by the #GSocketConnection APIs.</doc>
37563         <return-value transfer-ownership="none">
37564           <doc xml:whitespace="preserve">a #GSocketAddress or %NULL on error.</doc>
37565           <type name="Socket" c:type="GSocket*"/>
37566         </return-value>
37567       </method>
37568       <property name="socket"
37569                 writable="1"
37570                 construct-only="1"
37571                 transfer-ownership="none">
37572         <type name="Socket"/>
37573       </property>
37574       <field name="parent_instance">
37575         <type name="IOStream" c:type="GIOStream"/>
37576       </field>
37577       <field name="priv">
37578         <type name="SocketConnectionPrivate"
37579               c:type="GSocketConnectionPrivate*"/>
37580       </field>
37581     </class>
37582     <record name="SocketConnectionClass"
37583             c:type="GSocketConnectionClass"
37584             glib:is-gtype-struct-for="SocketConnection">
37585       <field name="parent_class">
37586         <type name="IOStreamClass" c:type="GIOStreamClass"/>
37587       </field>
37588       <field name="_g_reserved1" introspectable="0">
37589         <callback name="_g_reserved1">
37590           <return-value transfer-ownership="none">
37591             <type name="none" c:type="void"/>
37592           </return-value>
37593         </callback>
37594       </field>
37595       <field name="_g_reserved2" introspectable="0">
37596         <callback name="_g_reserved2">
37597           <return-value transfer-ownership="none">
37598             <type name="none" c:type="void"/>
37599           </return-value>
37600         </callback>
37601       </field>
37602       <field name="_g_reserved3" introspectable="0">
37603         <callback name="_g_reserved3">
37604           <return-value transfer-ownership="none">
37605             <type name="none" c:type="void"/>
37606           </return-value>
37607         </callback>
37608       </field>
37609       <field name="_g_reserved4" introspectable="0">
37610         <callback name="_g_reserved4">
37611           <return-value transfer-ownership="none">
37612             <type name="none" c:type="void"/>
37613           </return-value>
37614         </callback>
37615       </field>
37616       <field name="_g_reserved5" introspectable="0">
37617         <callback name="_g_reserved5">
37618           <return-value transfer-ownership="none">
37619             <type name="none" c:type="void"/>
37620           </return-value>
37621         </callback>
37622       </field>
37623       <field name="_g_reserved6" introspectable="0">
37624         <callback name="_g_reserved6">
37625           <return-value transfer-ownership="none">
37626             <type name="none" c:type="void"/>
37627           </return-value>
37628         </callback>
37629       </field>
37630     </record>
37631     <record name="SocketConnectionPrivate"
37632             c:type="GSocketConnectionPrivate"
37633             disguised="1">
37634     </record>
37635     <class name="SocketControlMessage"
37636            c:symbol-prefix="socket_control_message"
37637            c:type="GSocketControlMessage"
37638            parent="GObject.Object"
37639            abstract="1"
37640            glib:type-name="GSocketControlMessage"
37641            glib:get-type="g_socket_control_message_get_type"
37642            glib:type-struct="SocketControlMessageClass">
37643       <doc xml:whitespace="preserve">Base class for socket-type specific control messages that can be sent and
37644 received over #GSocket.</doc>
37645       <function name="deserialize"
37646                 c:identifier="g_socket_control_message_deserialize"
37647                 version="2.22">
37648         <doc xml:whitespace="preserve">Tries to deserialize a socket control message of a given
37649 of #GSocketControlMessage if they can understand this kind
37650 of message and if so deserialize it into a #GSocketControlMessage.
37651 If there is no implementation for this kind of control message, %NULL
37652 will be returned.</doc>
37653         <return-value transfer-ownership="full">
37654           <doc xml:whitespace="preserve">the deserialized message or %NULL</doc>
37655           <type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
37656         </return-value>
37657         <parameters>
37658           <parameter name="level" transfer-ownership="none">
37659             <doc xml:whitespace="preserve">a socket level</doc>
37660             <type name="gint" c:type="int"/>
37661           </parameter>
37662           <parameter name="type" transfer-ownership="none">
37663             <doc xml:whitespace="preserve">a socket control message type for the given @level</doc>
37664             <type name="gint" c:type="int"/>
37665           </parameter>
37666           <parameter name="size" transfer-ownership="none">
37667             <doc xml:whitespace="preserve">the size of the data in bytes</doc>
37668             <type name="gulong" c:type="gsize"/>
37669           </parameter>
37670           <parameter name="data" transfer-ownership="none">
37671             <doc xml:whitespace="preserve">pointer to the message data</doc>
37672             <type name="gpointer" c:type="gpointer"/>
37673           </parameter>
37674         </parameters>
37675       </function>
37676       <virtual-method name="get_level" invoker="get_level" version="2.22">
37677         <doc xml:whitespace="preserve">Returns the "level" (i.e. the originating protocol) of the control message.
37678 This is often SOL_SOCKET.</doc>
37679         <return-value transfer-ownership="none">
37680           <doc xml:whitespace="preserve">an integer describing the level</doc>
37681           <type name="gint" c:type="int"/>
37682         </return-value>
37683       </virtual-method>
37684       <virtual-method name="get_size" invoker="get_size" version="2.22">
37685         <doc xml:whitespace="preserve">Returns the space required for the control message, not including
37686 headers or alignment.</doc>
37687         <return-value transfer-ownership="none">
37688           <doc xml:whitespace="preserve">The number of bytes required.</doc>
37689           <type name="gulong" c:type="gsize"/>
37690         </return-value>
37691       </virtual-method>
37692       <virtual-method name="get_type">
37693         <return-value transfer-ownership="none">
37694           <type name="gint" c:type="int"/>
37695         </return-value>
37696       </virtual-method>
37697       <virtual-method name="serialize" invoker="serialize" version="2.22">
37698         <doc xml:whitespace="preserve">Converts the data in the message to bytes placed in the
37699 message.
37700 returned by g_socket_control_message_get_size() on this
37701 object.</doc>
37702         <return-value transfer-ownership="none">
37703           <type name="none" c:type="void"/>
37704         </return-value>
37705         <parameters>
37706           <parameter name="data" transfer-ownership="none">
37707             <doc xml:whitespace="preserve">A buffer to write data to</doc>
37708             <type name="gpointer" c:type="gpointer"/>
37709           </parameter>
37710         </parameters>
37711       </virtual-method>
37712       <method name="get_level"
37713               c:identifier="g_socket_control_message_get_level"
37714               version="2.22">
37715         <doc xml:whitespace="preserve">Returns the "level" (i.e. the originating protocol) of the control message.
37716 This is often SOL_SOCKET.</doc>
37717         <return-value transfer-ownership="none">
37718           <doc xml:whitespace="preserve">an integer describing the level</doc>
37719           <type name="gint" c:type="int"/>
37720         </return-value>
37721       </method>
37722       <method name="get_msg_type"
37723               c:identifier="g_socket_control_message_get_msg_type"
37724               version="2.22">
37725         <doc xml:whitespace="preserve">Returns the protocol specific type of the control message.
37726 For instance, for UNIX fd passing this would be SCM_RIGHTS.</doc>
37727         <return-value transfer-ownership="none">
37728           <doc xml:whitespace="preserve">an integer describing the type of control message</doc>
37729           <type name="gint" c:type="int"/>
37730         </return-value>
37731       </method>
37732       <method name="get_size"
37733               c:identifier="g_socket_control_message_get_size"
37734               version="2.22">
37735         <doc xml:whitespace="preserve">Returns the space required for the control message, not including
37736 headers or alignment.</doc>
37737         <return-value transfer-ownership="none">
37738           <doc xml:whitespace="preserve">The number of bytes required.</doc>
37739           <type name="gulong" c:type="gsize"/>
37740         </return-value>
37741       </method>
37742       <method name="serialize"
37743               c:identifier="g_socket_control_message_serialize"
37744               version="2.22">
37745         <doc xml:whitespace="preserve">Converts the data in the message to bytes placed in the
37746 message.
37747 returned by g_socket_control_message_get_size() on this
37748 object.</doc>
37749         <return-value transfer-ownership="none">
37750           <type name="none" c:type="void"/>
37751         </return-value>
37752         <parameters>
37753           <parameter name="data" transfer-ownership="none">
37754             <doc xml:whitespace="preserve">A buffer to write data to</doc>
37755             <type name="gpointer" c:type="gpointer"/>
37756           </parameter>
37757         </parameters>
37758       </method>
37759       <field name="parent_instance">
37760         <type name="GObject.Object" c:type="GObject"/>
37761       </field>
37762       <field name="priv">
37763         <type name="SocketControlMessagePrivate"
37764               c:type="GSocketControlMessagePrivate*"/>
37765       </field>
37766     </class>
37767     <record name="SocketControlMessageClass"
37768             c:type="GSocketControlMessageClass"
37769             glib:is-gtype-struct-for="SocketControlMessage">
37770       <field name="parent_class">
37771         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
37772       </field>
37773       <field name="get_size">
37774         <callback name="get_size">
37775           <return-value transfer-ownership="none">
37776             <doc xml:whitespace="preserve">The number of bytes required.</doc>
37777             <type name="gulong" c:type="gsize"/>
37778           </return-value>
37779           <parameters>
37780             <parameter name="message" transfer-ownership="none">
37781               <type name="SocketControlMessage"
37782                     c:type="GSocketControlMessage*"/>
37783             </parameter>
37784           </parameters>
37785         </callback>
37786       </field>
37787       <field name="get_level">
37788         <callback name="get_level">
37789           <return-value transfer-ownership="none">
37790             <doc xml:whitespace="preserve">an integer describing the level</doc>
37791             <type name="gint" c:type="int"/>
37792           </return-value>
37793           <parameters>
37794             <parameter name="message" transfer-ownership="none">
37795               <type name="SocketControlMessage"
37796                     c:type="GSocketControlMessage*"/>
37797             </parameter>
37798           </parameters>
37799         </callback>
37800       </field>
37801       <field name="get_type">
37802         <callback name="get_type">
37803           <return-value transfer-ownership="none">
37804             <type name="gint" c:type="int"/>
37805           </return-value>
37806           <parameters>
37807             <parameter name="message" transfer-ownership="none">
37808               <type name="SocketControlMessage"
37809                     c:type="GSocketControlMessage*"/>
37810             </parameter>
37811           </parameters>
37812         </callback>
37813       </field>
37814       <field name="serialize">
37815         <callback name="serialize">
37816           <return-value transfer-ownership="none">
37817             <type name="none" c:type="void"/>
37818           </return-value>
37819           <parameters>
37820             <parameter name="message" transfer-ownership="none">
37821               <type name="SocketControlMessage"
37822                     c:type="GSocketControlMessage*"/>
37823             </parameter>
37824             <parameter name="data" transfer-ownership="none">
37825               <doc xml:whitespace="preserve">A buffer to write data to</doc>
37826               <type name="gpointer" c:type="gpointer"/>
37827             </parameter>
37828           </parameters>
37829         </callback>
37830       </field>
37831       <field name="deserialize" introspectable="0">
37832         <callback name="deserialize" introspectable="0">
37833           <return-value>
37834             <type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
37835           </return-value>
37836           <parameters>
37837             <parameter name="level" transfer-ownership="none">
37838               <type name="gint" c:type="int"/>
37839             </parameter>
37840             <parameter name="type" transfer-ownership="none">
37841               <type name="gint" c:type="int"/>
37842             </parameter>
37843             <parameter name="size" transfer-ownership="none">
37844               <type name="gulong" c:type="gsize"/>
37845             </parameter>
37846             <parameter name="data" transfer-ownership="none">
37847               <type name="gpointer" c:type="gpointer"/>
37848             </parameter>
37849           </parameters>
37850         </callback>
37851       </field>
37852       <field name="_g_reserved1" introspectable="0">
37853         <callback name="_g_reserved1">
37854           <return-value transfer-ownership="none">
37855             <type name="none" c:type="void"/>
37856           </return-value>
37857         </callback>
37858       </field>
37859       <field name="_g_reserved2" introspectable="0">
37860         <callback name="_g_reserved2">
37861           <return-value transfer-ownership="none">
37862             <type name="none" c:type="void"/>
37863           </return-value>
37864         </callback>
37865       </field>
37866       <field name="_g_reserved3" introspectable="0">
37867         <callback name="_g_reserved3">
37868           <return-value transfer-ownership="none">
37869             <type name="none" c:type="void"/>
37870           </return-value>
37871         </callback>
37872       </field>
37873       <field name="_g_reserved4" introspectable="0">
37874         <callback name="_g_reserved4">
37875           <return-value transfer-ownership="none">
37876             <type name="none" c:type="void"/>
37877           </return-value>
37878         </callback>
37879       </field>
37880       <field name="_g_reserved5" introspectable="0">
37881         <callback name="_g_reserved5">
37882           <return-value transfer-ownership="none">
37883             <type name="none" c:type="void"/>
37884           </return-value>
37885         </callback>
37886       </field>
37887     </record>
37888     <record name="SocketControlMessagePrivate"
37889             c:type="GSocketControlMessagePrivate"
37890             disguised="1">
37891     </record>
37892     <enumeration name="SocketFamily"
37893                  version="2.22"
37894                  glib:type-name="GSocketFamily"
37895                  glib:get-type="g_socket_family_get_type"
37896                  c:type="GSocketFamily">
37897       <doc xml:whitespace="preserve">The protocol family of a #GSocketAddress. (These values are
37898 identical to the system defines %AF_INET, %AF_INET6 and %AF_UNIX,
37899 if available.)</doc>
37900       <member name="invalid"
37901               value="0"
37902               c:identifier="G_SOCKET_FAMILY_INVALID"
37903               glib:nick="invalid"/>
37904       <member name="unix"
37905               value="1"
37906               c:identifier="G_SOCKET_FAMILY_UNIX"
37907               glib:nick="unix"/>
37908       <member name="ipv4"
37909               value="2"
37910               c:identifier="G_SOCKET_FAMILY_IPV4"
37911               glib:nick="ipv4"/>
37912       <member name="ipv6"
37913               value="10"
37914               c:identifier="G_SOCKET_FAMILY_IPV6"
37915               glib:nick="ipv6"/>
37916     </enumeration>
37917     <class name="SocketListener"
37918            c:symbol-prefix="socket_listener"
37919            c:type="GSocketListener"
37920            parent="GObject.Object"
37921            glib:type-name="GSocketListener"
37922            glib:get-type="g_socket_listener_get_type"
37923            glib:type-struct="SocketListenerClass">
37924       <constructor name="new"
37925                    c:identifier="g_socket_listener_new"
37926                    version="2.22">
37927         <doc xml:whitespace="preserve">Creates a new #GSocketListener with no sockets to listen for.
37928 New listeners can be added with e.g. g_socket_listener_add_address()
37929 or g_socket_listener_add_inet_port().</doc>
37930         <return-value transfer-ownership="full">
37931           <doc xml:whitespace="preserve">a new #GSocketListener.</doc>
37932           <type name="SocketListener" c:type="GSocketListener*"/>
37933         </return-value>
37934       </constructor>
37935       <virtual-method name="changed">
37936         <return-value transfer-ownership="none">
37937           <type name="none" c:type="void"/>
37938         </return-value>
37939       </virtual-method>
37940       <method name="accept"
37941               c:identifier="g_socket_listener_accept"
37942               version="2.22"
37943               throws="1">
37944         <doc xml:whitespace="preserve">Blocks waiting for a client to connect to any of the sockets added
37945 to the listener. Returns a #GSocketConnection for the socket that was
37946 accepted.
37947 If @source_object is not %NULL it will be filled out with the source
37948 object specified when the corresponding socket or address was added
37949 to the listener.
37950 If @cancellable is not %NULL, then the operation can be cancelled by
37951 triggering the cancellable object from another thread. If the operation
37952 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
37953         <return-value transfer-ownership="full">
37954           <doc xml:whitespace="preserve">a #GSocketConnection on success, %NULL on error.</doc>
37955           <type name="SocketConnection" c:type="GSocketConnection*"/>
37956         </return-value>
37957         <parameters>
37958           <parameter name="source_object"
37959                      direction="out"
37960                      caller-allocates="0"
37961                      transfer-ownership="none"
37962                      allow-none="1">
37963             <doc xml:whitespace="preserve">location where #GObject pointer will be stored, or %NULL</doc>
37964             <type name="GObject.Object" c:type="GObject**"/>
37965           </parameter>
37966           <parameter name="cancellable"
37967                      transfer-ownership="none"
37968                      allow-none="1">
37969             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
37970             <type name="Cancellable" c:type="GCancellable*"/>
37971           </parameter>
37972         </parameters>
37973       </method>
37974       <method name="accept_async"
37975               c:identifier="g_socket_listener_accept_async"
37976               version="2.22">
37977         <doc xml:whitespace="preserve">This is the asynchronous version of g_socket_listener_accept().
37978 When the operation is finished @callback will be
37979 called. You can then call g_socket_listener_accept_socket()
37980 to get the result of the operation.</doc>
37981         <return-value transfer-ownership="none">
37982           <type name="none" c:type="void"/>
37983         </return-value>
37984         <parameters>
37985           <parameter name="cancellable"
37986                      transfer-ownership="none"
37987                      allow-none="1">
37988             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
37989             <type name="Cancellable" c:type="GCancellable*"/>
37990           </parameter>
37991           <parameter name="callback"
37992                      transfer-ownership="none"
37993                      scope="async"
37994                      closure="2">
37995             <doc xml:whitespace="preserve">a #GAsyncReadyCallback</doc>
37996             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
37997           </parameter>
37998           <parameter name="user_data" transfer-ownership="none">
37999             <doc xml:whitespace="preserve">user data for the callback</doc>
38000             <type name="gpointer" c:type="gpointer"/>
38001           </parameter>
38002         </parameters>
38003       </method>
38004       <method name="accept_finish"
38005               c:identifier="g_socket_listener_accept_finish"
38006               version="2.22"
38007               throws="1">
38008         <doc xml:whitespace="preserve">Finishes an async accept operation. See g_socket_listener_accept_async()</doc>
38009         <return-value transfer-ownership="full">
38010           <doc xml:whitespace="preserve">a #GSocketConnection on success, %NULL on error.</doc>
38011           <type name="SocketConnection" c:type="GSocketConnection*"/>
38012         </return-value>
38013         <parameters>
38014           <parameter name="result" transfer-ownership="none">
38015             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
38016             <type name="AsyncResult" c:type="GAsyncResult*"/>
38017           </parameter>
38018           <parameter name="source_object" transfer-ownership="none">
38019             <doc xml:whitespace="preserve">Optional #GObject identifying this source</doc>
38020             <type name="GObject.Object" c:type="GObject**"/>
38021           </parameter>
38022         </parameters>
38023       </method>
38024       <method name="accept_socket"
38025               c:identifier="g_socket_listener_accept_socket"
38026               version="2.22"
38027               throws="1">
38028         <doc xml:whitespace="preserve">Blocks waiting for a client to connect to any of the sockets added
38029 to the listener. Returns the #GSocket that was accepted.
38030 If you want to accept the high-level #GSocketConnection, not a #GSocket,
38031 which is often the case, then you should use g_socket_listener_accept()
38032 instead.
38033 If @source_object is not %NULL it will be filled out with the source
38034 object specified when the corresponding socket or address was added
38035 to the listener.
38036 If @cancellable is not %NULL, then the operation can be cancelled by
38037 triggering the cancellable object from another thread. If the operation
38038 was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
38039         <return-value transfer-ownership="full">
38040           <doc xml:whitespace="preserve">a #GSocket on success, %NULL on error.</doc>
38041           <type name="Socket" c:type="GSocket*"/>
38042         </return-value>
38043         <parameters>
38044           <parameter name="source_object"
38045                      direction="out"
38046                      caller-allocates="0"
38047                      transfer-ownership="none"
38048                      allow-none="1">
38049             <doc xml:whitespace="preserve">location where #GObject pointer will be stored, or %NULL.</doc>
38050             <type name="GObject.Object" c:type="GObject**"/>
38051           </parameter>
38052           <parameter name="cancellable"
38053                      transfer-ownership="none"
38054                      allow-none="1">
38055             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
38056             <type name="Cancellable" c:type="GCancellable*"/>
38057           </parameter>
38058         </parameters>
38059       </method>
38060       <method name="accept_socket_async"
38061               c:identifier="g_socket_listener_accept_socket_async"
38062               version="2.22">
38063         <doc xml:whitespace="preserve">This is the asynchronous version of g_socket_listener_accept_socket().
38064 When the operation is finished @callback will be
38065 called. You can then call g_socket_listener_accept_socket_finish()
38066 to get the result of the operation.</doc>
38067         <return-value transfer-ownership="none">
38068           <type name="none" c:type="void"/>
38069         </return-value>
38070         <parameters>
38071           <parameter name="cancellable"
38072                      transfer-ownership="none"
38073                      allow-none="1">
38074             <doc xml:whitespace="preserve">a #GCancellable, or %NULL</doc>
38075             <type name="Cancellable" c:type="GCancellable*"/>
38076           </parameter>
38077           <parameter name="callback"
38078                      transfer-ownership="none"
38079                      scope="async"
38080                      closure="2">
38081             <doc xml:whitespace="preserve">a #GAsyncReadyCallback</doc>
38082             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
38083           </parameter>
38084           <parameter name="user_data" transfer-ownership="none">
38085             <doc xml:whitespace="preserve">user data for the callback</doc>
38086             <type name="gpointer" c:type="gpointer"/>
38087           </parameter>
38088         </parameters>
38089       </method>
38090       <method name="accept_socket_finish"
38091               c:identifier="g_socket_listener_accept_socket_finish"
38092               version="2.22"
38093               throws="1">
38094         <doc xml:whitespace="preserve">Finishes an async accept operation. See g_socket_listener_accept_socket_async()</doc>
38095         <return-value transfer-ownership="full">
38096           <doc xml:whitespace="preserve">a #GSocket on success, %NULL on error.</doc>
38097           <type name="Socket" c:type="GSocket*"/>
38098         </return-value>
38099         <parameters>
38100           <parameter name="result" transfer-ownership="none">
38101             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
38102             <type name="AsyncResult" c:type="GAsyncResult*"/>
38103           </parameter>
38104           <parameter name="source_object" transfer-ownership="none">
38105             <doc xml:whitespace="preserve">Optional #GObject identifying this source</doc>
38106             <type name="GObject.Object" c:type="GObject**"/>
38107           </parameter>
38108         </parameters>
38109       </method>
38110       <method name="add_address"
38111               c:identifier="g_socket_listener_add_address"
38112               version="2.22"
38113               throws="1">
38114         <doc xml:whitespace="preserve">Creates a socket of type @type and protocol @protocol, binds
38115 it to @address and adds it to the set of sockets we're accepting
38116 sockets from.
38117 Note that adding an IPv6 address, depending on the platform,
38118 may or may not result in a listener that also accepts IPv4
38119 connections.  For more determinstic behaviour, see
38120 g_socket_listener_add_inet_port().
38121 to accept to identify this particular source, which is
38122 useful if you're listening on multiple addresses and do
38123 different things depending on what address is connected to.
38124 If successful and @effective_address is non-%NULL then it will
38125 be set to the address that the binding actually occured at.  This
38126 is helpful for determining the port number that was used for when
38127 requested, belongs to the caller and must be freed.</doc>
38128         <return-value transfer-ownership="none">
38129           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
38130           <type name="gboolean" c:type="gboolean"/>
38131         </return-value>
38132         <parameters>
38133           <parameter name="address" transfer-ownership="none">
38134             <doc xml:whitespace="preserve">a #GSocketAddress</doc>
38135             <type name="SocketAddress" c:type="GSocketAddress*"/>
38136           </parameter>
38137           <parameter name="type" transfer-ownership="none">
38138             <doc xml:whitespace="preserve">a #GSocketType</doc>
38139             <type name="SocketType" c:type="GSocketType"/>
38140           </parameter>
38141           <parameter name="protocol" transfer-ownership="none">
38142             <doc xml:whitespace="preserve">a #GSocketProtocol</doc>
38143             <type name="SocketProtocol" c:type="GSocketProtocol"/>
38144           </parameter>
38145           <parameter name="source_object" transfer-ownership="none">
38146             <doc xml:whitespace="preserve">Optional #GObject identifying this source</doc>
38147             <type name="GObject.Object" c:type="GObject*"/>
38148           </parameter>
38149           <parameter name="effective_address"
38150                      direction="out"
38151                      caller-allocates="0"
38152                      transfer-ownership="full"
38153                      allow-none="1">
38154             <doc xml:whitespace="preserve">location to store the address that was bound to, or %NULL.</doc>
38155             <type name="SocketAddress" c:type="GSocketAddress**"/>
38156           </parameter>
38157         </parameters>
38158       </method>
38159       <method name="add_any_inet_port"
38160               c:identifier="g_socket_listener_add_any_inet_port"
38161               version="2.24"
38162               throws="1">
38163         <doc xml:whitespace="preserve">Listens for TCP connections on any available port number for both
38164 IPv6 and IPv4 (if each are available).
38165 This is useful if you need to have a socket for incoming connections
38166 but don't care about the specific port number.
38167 to accept to identify this particular source, which is
38168 useful if you're listening on multiple addresses and do
38169 different things depending on what address is connected to.</doc>
38170         <return-value transfer-ownership="none">
38171           <doc xml:whitespace="preserve">the port number, or 0 in case of failure.</doc>
38172           <type name="guint16" c:type="guint16"/>
38173         </return-value>
38174         <parameters>
38175           <parameter name="source_object" transfer-ownership="none">
38176             <doc xml:whitespace="preserve">Optional #GObject identifying this source</doc>
38177             <type name="GObject.Object" c:type="GObject*"/>
38178           </parameter>
38179         </parameters>
38180       </method>
38181       <method name="add_inet_port"
38182               c:identifier="g_socket_listener_add_inet_port"
38183               version="2.22"
38184               throws="1">
38185         <doc xml:whitespace="preserve">Helper function for g_socket_listener_add_address() that
38186 creates a TCP/IP socket listening on IPv4 and IPv6 (if
38187 supported) on the specified port on all interfaces.
38188 to accept to identify this particular source, which is
38189 useful if you're listening on multiple addresses and do
38190 different things depending on what address is connected to.</doc>
38191         <return-value transfer-ownership="none">
38192           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
38193           <type name="gboolean" c:type="gboolean"/>
38194         </return-value>
38195         <parameters>
38196           <parameter name="port" transfer-ownership="none">
38197             <doc xml:whitespace="preserve">an IP port number (non-zero)</doc>
38198             <type name="guint16" c:type="guint16"/>
38199           </parameter>
38200           <parameter name="source_object" transfer-ownership="none">
38201             <doc xml:whitespace="preserve">Optional #GObject identifying this source</doc>
38202             <type name="GObject.Object" c:type="GObject*"/>
38203           </parameter>
38204         </parameters>
38205       </method>
38206       <method name="add_socket"
38207               c:identifier="g_socket_listener_add_socket"
38208               version="2.22"
38209               throws="1">
38210         <doc xml:whitespace="preserve">Adds @socket to the set of sockets that we try to accept
38211 new clients from. The socket must be bound to a local
38212 address and listened to.
38213 to accept to identify this particular source, which is
38214 useful if you're listening on multiple addresses and do
38215 different things depending on what address is connected to.</doc>
38216         <return-value transfer-ownership="none">
38217           <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
38218           <type name="gboolean" c:type="gboolean"/>
38219         </return-value>
38220         <parameters>
38221           <parameter name="socket" transfer-ownership="none">
38222             <doc xml:whitespace="preserve">a listening #GSocket</doc>
38223             <type name="Socket" c:type="GSocket*"/>
38224           </parameter>
38225           <parameter name="source_object" transfer-ownership="none">
38226             <doc xml:whitespace="preserve">Optional #GObject identifying this source</doc>
38227             <type name="GObject.Object" c:type="GObject*"/>
38228           </parameter>
38229         </parameters>
38230       </method>
38231       <method name="close"
38232               c:identifier="g_socket_listener_close"
38233               version="2.22">
38234         <doc xml:whitespace="preserve">Closes all the sockets in the listener.</doc>
38235         <return-value transfer-ownership="none">
38236           <type name="none" c:type="void"/>
38237         </return-value>
38238       </method>
38239       <method name="set_backlog"
38240               c:identifier="g_socket_listener_set_backlog"
38241               version="2.22">
38242         <doc xml:whitespace="preserve">Sets the listen backlog on the sockets in the listener.
38243 See g_socket_set_listen_backlog() for details</doc>
38244         <return-value transfer-ownership="none">
38245           <type name="none" c:type="void"/>
38246         </return-value>
38247         <parameters>
38248           <parameter name="listen_backlog" transfer-ownership="none">
38249             <doc xml:whitespace="preserve">an integer</doc>
38250             <type name="gint" c:type="int"/>
38251           </parameter>
38252         </parameters>
38253       </method>
38254       <property name="listen-backlog"
38255                 writable="1"
38256                 construct="1"
38257                 transfer-ownership="none">
38258         <type name="gint"/>
38259       </property>
38260       <field name="parent_instance">
38261         <type name="GObject.Object" c:type="GObject"/>
38262       </field>
38263       <field name="priv">
38264         <type name="SocketListenerPrivate" c:type="GSocketListenerPrivate*"/>
38265       </field>
38266     </class>
38267     <record name="SocketListenerClass"
38268             c:type="GSocketListenerClass"
38269             glib:is-gtype-struct-for="SocketListener">
38270       <field name="parent_class">
38271         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
38272       </field>
38273       <field name="changed">
38274         <callback name="changed">
38275           <return-value transfer-ownership="none">
38276             <type name="none" c:type="void"/>
38277           </return-value>
38278           <parameters>
38279             <parameter name="listener" transfer-ownership="none">
38280               <type name="SocketListener" c:type="GSocketListener*"/>
38281             </parameter>
38282           </parameters>
38283         </callback>
38284       </field>
38285       <field name="_g_reserved1" introspectable="0">
38286         <callback name="_g_reserved1">
38287           <return-value transfer-ownership="none">
38288             <type name="none" c:type="void"/>
38289           </return-value>
38290         </callback>
38291       </field>
38292       <field name="_g_reserved2" introspectable="0">
38293         <callback name="_g_reserved2">
38294           <return-value transfer-ownership="none">
38295             <type name="none" c:type="void"/>
38296           </return-value>
38297         </callback>
38298       </field>
38299       <field name="_g_reserved3" introspectable="0">
38300         <callback name="_g_reserved3">
38301           <return-value transfer-ownership="none">
38302             <type name="none" c:type="void"/>
38303           </return-value>
38304         </callback>
38305       </field>
38306       <field name="_g_reserved4" introspectable="0">
38307         <callback name="_g_reserved4">
38308           <return-value transfer-ownership="none">
38309             <type name="none" c:type="void"/>
38310           </return-value>
38311         </callback>
38312       </field>
38313       <field name="_g_reserved5" introspectable="0">
38314         <callback name="_g_reserved5">
38315           <return-value transfer-ownership="none">
38316             <type name="none" c:type="void"/>
38317           </return-value>
38318         </callback>
38319       </field>
38320       <field name="_g_reserved6" introspectable="0">
38321         <callback name="_g_reserved6">
38322           <return-value transfer-ownership="none">
38323             <type name="none" c:type="void"/>
38324           </return-value>
38325         </callback>
38326       </field>
38327     </record>
38328     <record name="SocketListenerPrivate"
38329             c:type="GSocketListenerPrivate"
38330             disguised="1">
38331     </record>
38332     <enumeration name="SocketMsgFlags"
38333                  version="2.22"
38334                  glib:type-name="GSocketMsgFlags"
38335                  glib:get-type="g_socket_msg_flags_get_type"
38336                  c:type="GSocketMsgFlags">
38337       <doc xml:whitespace="preserve">Flags used in g_socket_receive_message() and g_socket_send_message().
38338 The flags listed in the enum are some commonly available flags, but the
38339 values used for them are the same as on the platform, and any other flags
38340 are passed in/out as is. So to use a platform specific flag, just include
38341 the right system header and pass in the flag.</doc>
38342       <member name="none"
38343               value="0"
38344               c:identifier="G_SOCKET_MSG_NONE"
38345               glib:nick="none"/>
38346       <member name="oob"
38347               value="1"
38348               c:identifier="G_SOCKET_MSG_OOB"
38349               glib:nick="oob"/>
38350       <member name="peek"
38351               value="2"
38352               c:identifier="G_SOCKET_MSG_PEEK"
38353               glib:nick="peek"/>
38354       <member name="dontroute"
38355               value="4"
38356               c:identifier="G_SOCKET_MSG_DONTROUTE"
38357               glib:nick="dontroute"/>
38358     </enumeration>
38359     <record name="SocketPrivate" c:type="GSocketPrivate" disguised="1">
38360     </record>
38361     <enumeration name="SocketProtocol"
38362                  version="2.22"
38363                  glib:type-name="GSocketProtocol"
38364                  glib:get-type="g_socket_protocol_get_type"
38365                  c:type="GSocketProtocol">
38366       <doc xml:whitespace="preserve">A protocol identifier is specified when creating a #GSocket, which is a
38367 family/type specific identifier, where 0 means the default protocol for
38368 the particular family/type.
38369 This enum contains a set of commonly available and used protocols. You
38370 can also pass any other identifiers handled by the platform in order to
38371 use protocols not listed here.</doc>
38372       <member name="unknown"
38373               value="-1"
38374               c:identifier="G_SOCKET_PROTOCOL_UNKNOWN"
38375               glib:nick="unknown"/>
38376       <member name="default"
38377               value="0"
38378               c:identifier="G_SOCKET_PROTOCOL_DEFAULT"
38379               glib:nick="default"/>
38380       <member name="tcp"
38381               value="6"
38382               c:identifier="G_SOCKET_PROTOCOL_TCP"
38383               glib:nick="tcp"/>
38384       <member name="udp"
38385               value="17"
38386               c:identifier="G_SOCKET_PROTOCOL_UDP"
38387               glib:nick="udp"/>
38388       <member name="sctp"
38389               value="132"
38390               c:identifier="G_SOCKET_PROTOCOL_SCTP"
38391               glib:nick="sctp"/>
38392     </enumeration>
38393     <class name="SocketService"
38394            c:symbol-prefix="socket_service"
38395            c:type="GSocketService"
38396            version="2.22"
38397            parent="SocketListener"
38398            glib:type-name="GSocketService"
38399            glib:get-type="g_socket_service_get_type"
38400            glib:type-struct="SocketServiceClass">
38401       <doc xml:whitespace="preserve">A helper class for handling accepting incomming connections in the
38402 glib mainloop.</doc>
38403       <constructor name="new"
38404                    c:identifier="g_socket_service_new"
38405                    version="2.22">
38406         <doc xml:whitespace="preserve">Creates a new #GSocketService with no sockets to listen for.
38407 New listeners can be added with e.g. g_socket_listener_add_address()
38408 or g_socket_listener_add_inet_port().</doc>
38409         <return-value transfer-ownership="full">
38410           <doc xml:whitespace="preserve">a new #GSocketService.</doc>
38411           <type name="SocketService" c:type="GSocketService*"/>
38412         </return-value>
38413       </constructor>
38414       <method name="is_active"
38415               c:identifier="g_socket_service_is_active"
38416               version="2.22">
38417         <doc xml:whitespace="preserve">Check whether the service is active or not. An active
38418 service will accept new clients that connect, while
38419 a non-active service will let connecting clients queue
38420 up until the service is started.</doc>
38421         <return-value transfer-ownership="none">
38422           <doc xml:whitespace="preserve">%TRUE if the service is active, %FALSE otherwise</doc>
38423           <type name="gboolean" c:type="gboolean"/>
38424         </return-value>
38425       </method>
38426       <method name="start"
38427               c:identifier="g_socket_service_start"
38428               version="2.22">
38429         <doc xml:whitespace="preserve">Starts the service, i.e. start accepting connections
38430 from the added sockets when the mainloop runs.
38431 This call is threadsafe, so it may be called from a thread
38432 handling an incomming client request.</doc>
38433         <return-value transfer-ownership="none">
38434           <type name="none" c:type="void"/>
38435         </return-value>
38436       </method>
38437       <method name="stop" c:identifier="g_socket_service_stop" version="2.22">
38438         <doc xml:whitespace="preserve">Stops the service, i.e. stops accepting connections
38439 from the added sockets when the mainloop runs.
38440 This call is threadsafe, so it may be called from a thread
38441 handling an incomming client request.</doc>
38442         <return-value transfer-ownership="none">
38443           <type name="none" c:type="void"/>
38444         </return-value>
38445       </method>
38446       <field name="parent_instance">
38447         <type name="SocketListener" c:type="GSocketListener"/>
38448       </field>
38449       <field name="priv">
38450         <type name="SocketServicePrivate" c:type="GSocketServicePrivate*"/>
38451       </field>
38452       <glib:signal name="incoming" version="2.22">
38453         <doc xml:whitespace="preserve">The ::incoming signal is emitted when a new incoming connection
38454 to @service needs to be handled. The handler must initiate the
38455 handling of @connection, but may not block; in essence,
38456 asynchronous operations must be used.</doc>
38457         <return-value transfer-ownership="none">
38458           <doc xml:whitespace="preserve">%TRUE to stop other handlers from being called</doc>
38459           <type name="gboolean"/>
38460         </return-value>
38461         <parameters>
38462           <parameter name="object" transfer-ownership="none">
38463             <doc xml:whitespace="preserve">a new #GSocketConnection object.</doc>
38464             <type name="SocketConnection"/>
38465           </parameter>
38466           <parameter name="p0" transfer-ownership="none">
38467             <doc xml:whitespace="preserve">the source_object passed to g_socket_listener_add_address().</doc>
38468             <type name="GObject.Object"/>
38469           </parameter>
38470         </parameters>
38471       </glib:signal>
38472     </class>
38473     <record name="SocketServiceClass"
38474             c:type="GSocketServiceClass"
38475             glib:is-gtype-struct-for="SocketService">
38476       <field name="parent_class">
38477         <type name="SocketListenerClass" c:type="GSocketListenerClass"/>
38478       </field>
38479       <field name="incoming">
38480         <callback name="incoming">
38481           <return-value transfer-ownership="none">
38482             <type name="gboolean" c:type="gboolean"/>
38483           </return-value>
38484           <parameters>
38485             <parameter name="service" transfer-ownership="none">
38486               <type name="SocketService" c:type="GSocketService*"/>
38487             </parameter>
38488             <parameter name="connection" transfer-ownership="none">
38489               <type name="SocketConnection" c:type="GSocketConnection*"/>
38490             </parameter>
38491             <parameter name="source_object" transfer-ownership="none">
38492               <type name="GObject.Object" c:type="GObject*"/>
38493             </parameter>
38494           </parameters>
38495         </callback>
38496       </field>
38497       <field name="_g_reserved1" introspectable="0">
38498         <callback name="_g_reserved1">
38499           <return-value transfer-ownership="none">
38500             <type name="none" c:type="void"/>
38501           </return-value>
38502         </callback>
38503       </field>
38504       <field name="_g_reserved2" introspectable="0">
38505         <callback name="_g_reserved2">
38506           <return-value transfer-ownership="none">
38507             <type name="none" c:type="void"/>
38508           </return-value>
38509         </callback>
38510       </field>
38511       <field name="_g_reserved3" introspectable="0">
38512         <callback name="_g_reserved3">
38513           <return-value transfer-ownership="none">
38514             <type name="none" c:type="void"/>
38515           </return-value>
38516         </callback>
38517       </field>
38518       <field name="_g_reserved4" introspectable="0">
38519         <callback name="_g_reserved4">
38520           <return-value transfer-ownership="none">
38521             <type name="none" c:type="void"/>
38522           </return-value>
38523         </callback>
38524       </field>
38525       <field name="_g_reserved5" introspectable="0">
38526         <callback name="_g_reserved5">
38527           <return-value transfer-ownership="none">
38528             <type name="none" c:type="void"/>
38529           </return-value>
38530         </callback>
38531       </field>
38532       <field name="_g_reserved6" introspectable="0">
38533         <callback name="_g_reserved6">
38534           <return-value transfer-ownership="none">
38535             <type name="none" c:type="void"/>
38536           </return-value>
38537         </callback>
38538       </field>
38539     </record>
38540     <record name="SocketServicePrivate"
38541             c:type="GSocketServicePrivate"
38542             disguised="1">
38543     </record>
38544     <callback name="SocketSourceFunc"
38545               c:type="GSocketSourceFunc"
38546               version="2.22">
38547       <doc xml:whitespace="preserve">This is the function type of the callback used for the #GSource
38548 returned by g_socket_create_source().</doc>
38549       <return-value transfer-ownership="none">
38550         <doc xml:whitespace="preserve">it should return %FALSE if the source should be removed.</doc>
38551         <type name="gboolean" c:type="gboolean"/>
38552       </return-value>
38553       <parameters>
38554         <parameter name="socket" transfer-ownership="none">
38555           <doc xml:whitespace="preserve">the #GSocket</doc>
38556           <type name="Socket" c:type="GSocket*"/>
38557         </parameter>
38558         <parameter name="condition" transfer-ownership="none">
38559           <doc xml:whitespace="preserve">the current condition at the source fired.</doc>
38560           <type name="GLib.IOCondition" c:type="GIOCondition"/>
38561         </parameter>
38562         <parameter name="user_data" transfer-ownership="none" closure="2">
38563           <doc xml:whitespace="preserve">data passed in by the user.</doc>
38564           <type name="gpointer" c:type="gpointer"/>
38565         </parameter>
38566       </parameters>
38567     </callback>
38568     <enumeration name="SocketType"
38569                  version="2.22"
38570                  glib:type-name="GSocketType"
38571                  glib:get-type="g_socket_type_get_type"
38572                  c:type="GSocketType">
38573       <doc xml:whitespace="preserve">Flags used when creating a #GSocket. Some protocols may not implement
38574 all the socket types.</doc>
38575       <member name="invalid"
38576               value="0"
38577               c:identifier="G_SOCKET_TYPE_INVALID"
38578               glib:nick="invalid"/>
38579       <member name="stream"
38580               value="1"
38581               c:identifier="G_SOCKET_TYPE_STREAM"
38582               glib:nick="stream"/>
38583       <member name="datagram"
38584               value="2"
38585               c:identifier="G_SOCKET_TYPE_DATAGRAM"
38586               glib:nick="datagram"/>
38587       <member name="seqpacket"
38588               value="3"
38589               c:identifier="G_SOCKET_TYPE_SEQPACKET"
38590               glib:nick="seqpacket"/>
38591     </enumeration>
38592     <record name="SrvTarget"
38593             c:type="GSrvTarget"
38594             glib:type-name="GSrvTarget"
38595             glib:get-type="g_srv_target_get_type"
38596             c:symbol-prefix="srv_target">
38597       <doc xml:whitespace="preserve">A single target host/port that a network service is running on.</doc>
38598       <constructor name="new" c:identifier="g_srv_target_new" version="2.22">
38599         <doc xml:whitespace="preserve">Creates a new #GSrvTarget with the given parameters.
38600 You should not need to use this; normally #GSrvTarget&lt;!-- --&gt;s are
38601 created by #GResolver.</doc>
38602         <return-value transfer-ownership="full">
38603           <doc xml:whitespace="preserve">a new #GSrvTarget.</doc>
38604           <type name="SrvTarget" c:type="GSrvTarget*"/>
38605         </return-value>
38606         <parameters>
38607           <parameter name="hostname" transfer-ownership="none">
38608             <doc xml:whitespace="preserve">the host that the service is running on</doc>
38609             <type name="utf8" c:type="gchar*"/>
38610           </parameter>
38611           <parameter name="port" transfer-ownership="none">
38612             <doc xml:whitespace="preserve">the port that the service is running on</doc>
38613             <type name="guint16" c:type="guint16"/>
38614           </parameter>
38615           <parameter name="priority" transfer-ownership="none">
38616             <doc xml:whitespace="preserve">the target's priority</doc>
38617             <type name="guint16" c:type="guint16"/>
38618           </parameter>
38619           <parameter name="weight" transfer-ownership="none">
38620             <doc xml:whitespace="preserve">the target's weight</doc>
38621             <type name="guint16" c:type="guint16"/>
38622           </parameter>
38623         </parameters>
38624       </constructor>
38625       <method name="copy" c:identifier="g_srv_target_copy" version="2.22">
38626         <doc xml:whitespace="preserve">Copies @target</doc>
38627         <return-value transfer-ownership="full">
38628           <doc xml:whitespace="preserve">a copy of @target</doc>
38629           <type name="SrvTarget" c:type="GSrvTarget*"/>
38630         </return-value>
38631       </method>
38632       <method name="free" c:identifier="g_srv_target_free" version="2.22">
38633         <doc xml:whitespace="preserve">Frees @target</doc>
38634         <return-value transfer-ownership="none">
38635           <type name="none" c:type="void"/>
38636         </return-value>
38637       </method>
38638       <method name="get_hostname"
38639               c:identifier="g_srv_target_get_hostname"
38640               version="2.22">
38641         <doc xml:whitespace="preserve">Gets @target's hostname (in ASCII form; if you are going to present
38642 this to the user, you should use g_hostname_is_ascii_encoded() to
38643 check if it contains encoded Unicode segments, and use
38644 g_hostname_to_unicode() to convert it if it does.)</doc>
38645         <return-value transfer-ownership="none">
38646           <doc xml:whitespace="preserve">@target's hostname</doc>
38647           <type name="utf8" c:type="gchar*"/>
38648         </return-value>
38649       </method>
38650       <method name="get_port"
38651               c:identifier="g_srv_target_get_port"
38652               version="2.22">
38653         <doc xml:whitespace="preserve">Gets @target's port</doc>
38654         <return-value transfer-ownership="none">
38655           <doc xml:whitespace="preserve">@target's port</doc>
38656           <type name="guint16" c:type="guint16"/>
38657         </return-value>
38658       </method>
38659       <method name="get_priority"
38660               c:identifier="g_srv_target_get_priority"
38661               version="2.22">
38662         <doc xml:whitespace="preserve">Gets @target's priority. You should not need to look at this;
38663 #GResolver already sorts the targets according to the algorithm in
38664 RFC 2782.</doc>
38665         <return-value transfer-ownership="none">
38666           <doc xml:whitespace="preserve">@target's priority</doc>
38667           <type name="guint16" c:type="guint16"/>
38668         </return-value>
38669       </method>
38670       <method name="get_weight"
38671               c:identifier="g_srv_target_get_weight"
38672               version="2.22">
38673         <doc xml:whitespace="preserve">Gets @target's weight. You should not need to look at this;
38674 #GResolver already sorts the targets according to the algorithm in
38675 RFC 2782.</doc>
38676         <return-value transfer-ownership="none">
38677           <doc xml:whitespace="preserve">@target's weight</doc>
38678           <type name="guint16" c:type="guint16"/>
38679         </return-value>
38680       </method>
38681     </record>
38682     <class name="TcpConnection"
38683            c:symbol-prefix="tcp_connection"
38684            c:type="GTcpConnection"
38685            version="2.22"
38686            parent="SocketConnection"
38687            glib:type-name="GTcpConnection"
38688            glib:get-type="g_tcp_connection_get_type"
38689            glib:type-struct="TcpConnectionClass">
38690       <doc xml:whitespace="preserve">A #GSocketConnection for UNIX domain socket connections.</doc>
38691       <method name="get_graceful_disconnect"
38692               c:identifier="g_tcp_connection_get_graceful_disconnect"
38693               version="2.22">
38694         <doc xml:whitespace="preserve">Checks if graceful disconnects are used. See
38695 g_tcp_connection_set_graceful_disconnect().</doc>
38696         <return-value transfer-ownership="none">
38697           <doc xml:whitespace="preserve">%TRUE if graceful disconnect is used on close, %FALSE otherwise</doc>
38698           <type name="gboolean" c:type="gboolean"/>
38699         </return-value>
38700       </method>
38701       <method name="set_graceful_disconnect"
38702               c:identifier="g_tcp_connection_set_graceful_disconnect"
38703               version="2.22">
38704         <doc xml:whitespace="preserve">This enabled graceful disconnects on close. A graceful disconnect
38705 means that we signal the recieving end that the connection is terminated
38706 and wait for it to close the connection before closing the connection.
38707 A graceful disconnect means that we can be sure that we successfully sent
38708 all the outstanding data to the other end, or get an error reported.
38709 However, it also means we have to wait for all the data to reach the
38710 other side and for it to acknowledge this by closing the socket, which may
38711 take a while. For this reason it is disabled by default.</doc>
38712         <return-value transfer-ownership="none">
38713           <type name="none" c:type="void"/>
38714         </return-value>
38715         <parameters>
38716           <parameter name="graceful_disconnect" transfer-ownership="none">
38717             <doc xml:whitespace="preserve">Whether to do graceful disconnects or not</doc>
38718             <type name="gboolean" c:type="gboolean"/>
38719           </parameter>
38720         </parameters>
38721       </method>
38722       <property name="graceful-disconnect"
38723                 writable="1"
38724                 transfer-ownership="none">
38725         <type name="gboolean"/>
38726       </property>
38727       <field name="parent_instance">
38728         <type name="SocketConnection" c:type="GSocketConnection"/>
38729       </field>
38730       <field name="priv">
38731         <type name="TcpConnectionPrivate" c:type="GTcpConnectionPrivate*"/>
38732       </field>
38733     </class>
38734     <record name="TcpConnectionClass"
38735             c:type="GTcpConnectionClass"
38736             glib:is-gtype-struct-for="TcpConnection">
38737       <field name="parent_class">
38738         <type name="SocketConnectionClass" c:type="GSocketConnectionClass"/>
38739       </field>
38740     </record>
38741     <record name="TcpConnectionPrivate"
38742             c:type="GTcpConnectionPrivate"
38743             disguised="1">
38744     </record>
38745     <class name="ThemedIcon"
38746            c:symbol-prefix="themed_icon"
38747            c:type="GThemedIcon"
38748            parent="GObject.Object"
38749            glib:type-name="GThemedIcon"
38750            glib:get-type="g_themed_icon_get_type"
38751            glib:type-struct="ThemedIconClass">
38752       <doc xml:whitespace="preserve">An implementation of #GIcon for themed icons.</doc>
38753       <implements name="Icon"/>
38754       <function name="new" c:identifier="g_themed_icon_new">
38755         <doc xml:whitespace="preserve">Creates a new themed icon for @iconname.</doc>
38756         <return-value transfer-ownership="full">
38757           <doc xml:whitespace="preserve">a new #GThemedIcon.</doc>
38758           <type name="Icon" c:type="GIcon*"/>
38759         </return-value>
38760         <parameters>
38761           <parameter name="iconname" transfer-ownership="none">
38762             <doc xml:whitespace="preserve">a string containing an icon name.</doc>
38763             <type name="utf8" c:type="char*"/>
38764           </parameter>
38765         </parameters>
38766       </function>
38767       <function name="new_from_names"
38768                 c:identifier="g_themed_icon_new_from_names">
38769         <doc xml:whitespace="preserve">Creates a new themed icon for @iconnames.</doc>
38770         <return-value transfer-ownership="full">
38771           <doc xml:whitespace="preserve">a new #GThemedIcon</doc>
38772           <type name="Icon" c:type="GIcon*"/>
38773         </return-value>
38774         <parameters>
38775           <parameter name="iconnames" transfer-ownership="none">
38776             <doc xml:whitespace="preserve">an array of strings containing icon names.</doc>
38777             <type name="utf8" c:type="char**"/>
38778           </parameter>
38779           <parameter name="len" transfer-ownership="none">
38780             <doc xml:whitespace="preserve">the length of the @iconnames array, or -1 if @iconnames is %NULL-terminated</doc>
38781             <type name="gint" c:type="int"/>
38782           </parameter>
38783         </parameters>
38784       </function>
38785       <function name="new_with_default_fallbacks"
38786                 c:identifier="g_themed_icon_new_with_default_fallbacks">
38787         <doc xml:whitespace="preserve">Creates a new themed icon for @iconname, and all the names
38788 that can be created by shortening @iconname at '-' characters.
38789 In the following example, @icon1 and @icon2 are equivalent:
38790 |[
38791 const char *names[] = {
38792 "gnome-dev-cdrom-audio",
38793 "gnome-dev-cdrom",
38794 "gnome-dev",
38795 "gnome"
38796 };
38797 icon1 = g_themed_icon_new_from_names (names, 4);
38798 icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio");
38799 ]|</doc>
38800         <return-value transfer-ownership="full">
38801           <doc xml:whitespace="preserve">a new #GThemedIcon.</doc>
38802           <type name="Icon" c:type="GIcon*"/>
38803         </return-value>
38804         <parameters>
38805           <parameter name="iconname" transfer-ownership="none">
38806             <doc xml:whitespace="preserve">a string containing an icon name</doc>
38807             <type name="utf8" c:type="char*"/>
38808           </parameter>
38809         </parameters>
38810       </function>
38811       <method name="append_name" c:identifier="g_themed_icon_append_name">
38812         <doc xml:whitespace="preserve">Append a name to the list of icons from within @icon.
38813 &lt;note&gt;&lt;para&gt;
38814 Note that doing so invalidates the hash computed by prior calls
38815 to g_icon_hash().
38816 &lt;/para&gt;&lt;/note&gt;</doc>
38817         <return-value transfer-ownership="none">
38818           <type name="none" c:type="void"/>
38819         </return-value>
38820         <parameters>
38821           <parameter name="iconname" transfer-ownership="none">
38822             <doc xml:whitespace="preserve">name of icon to append to list of icons from within @icon.</doc>
38823             <type name="utf8" c:type="char*"/>
38824           </parameter>
38825         </parameters>
38826       </method>
38827       <method name="get_names" c:identifier="g_themed_icon_get_names">
38828         <doc xml:whitespace="preserve">Gets the names of icons from within @icon.</doc>
38829         <return-value transfer-ownership="full">
38830           <doc xml:whitespace="preserve">a list of icon names.</doc>
38831           <array c:type="gchar**">
38832             <type name="utf8"/>
38833           </array>
38834         </return-value>
38835       </method>
38836       <method name="prepend_name"
38837               c:identifier="g_themed_icon_prepend_name"
38838               version="2.18">
38839         <doc xml:whitespace="preserve">Prepend a name to the list of icons from within @icon.
38840 &lt;note&gt;&lt;para&gt;
38841 Note that doing so invalidates the hash computed by prior calls
38842 to g_icon_hash().
38843 &lt;/para&gt;&lt;/note&gt;</doc>
38844         <return-value transfer-ownership="none">
38845           <type name="none" c:type="void"/>
38846         </return-value>
38847         <parameters>
38848           <parameter name="iconname" transfer-ownership="none">
38849             <doc xml:whitespace="preserve">name of icon to prepend to list of icons from within @icon.</doc>
38850             <type name="utf8" c:type="char*"/>
38851           </parameter>
38852         </parameters>
38853       </method>
38854       <property name="name"
38855                 readable="0"
38856                 writable="1"
38857                 construct-only="1"
38858                 transfer-ownership="none">
38859         <doc xml:whitespace="preserve">The icon name.</doc>
38860         <type name="utf8"/>
38861       </property>
38862       <property name="names"
38863                 introspectable="0"
38864                 writable="1"
38865                 construct-only="1"
38866                 transfer-ownership="none">
38867         <doc xml:whitespace="preserve">A %NULL-terminated array of icon names.</doc>
38868         <type/>
38869       </property>
38870       <property name="use-default-fallbacks"
38871                 writable="1"
38872                 construct-only="1"
38873                 transfer-ownership="none">
38874         <doc xml:whitespace="preserve">Whether to use the default fallbacks found by shortening the icon name
38875 at '-' characters. If the "names" array has more than one element,
38876 ignores any past the first.
38877 For example, if the icon name was "gnome-dev-cdrom-audio", the array
38878 would become
38879 |[
38880 {
38881 "gnome-dev-cdrom-audio",
38882 "gnome-dev-cdrom",
38883 "gnome-dev",
38884 "gnome",
38885 NULL
38886 };
38887 ]|</doc>
38888         <type name="gboolean"/>
38889       </property>
38890     </class>
38891     <record name="ThemedIconClass"
38892             c:type="GThemedIconClass"
38893             disguised="1"
38894             glib:is-gtype-struct-for="ThemedIcon">
38895     </record>
38896     <class name="ThreadedSocketService"
38897            c:symbol-prefix="threaded_socket_service"
38898            c:type="GThreadedSocketService"
38899            version="2.22"
38900            parent="SocketService"
38901            glib:type-name="GThreadedSocketService"
38902            glib:get-type="g_threaded_socket_service_get_type"
38903            glib:type-struct="ThreadedSocketServiceClass">
38904       <doc xml:whitespace="preserve">A helper class for handling accepting incomming connections in the
38905 glib mainloop and handling them in a thread.</doc>
38906       <constructor name="new"
38907                    c:identifier="g_threaded_socket_service_new"
38908                    version="2.22">
38909         <doc xml:whitespace="preserve">Creates a new #GThreadedSocketService with no listeners. Listeners
38910 must be added with g_socket_service_add_listeners().</doc>
38911         <return-value transfer-ownership="full">
38912           <doc xml:whitespace="preserve">a new #GSocketService.</doc>
38913           <type name="SocketService" c:type="GSocketService*"/>
38914         </return-value>
38915         <parameters>
38916           <parameter name="max_threads" transfer-ownership="none">
38917             <doc xml:whitespace="preserve">the maximal number of threads to execute concurrently handling incoming clients, -1 means no limit</doc>
38918             <type name="gint" c:type="int"/>
38919           </parameter>
38920         </parameters>
38921       </constructor>
38922       <property name="max-threads"
38923                 writable="1"
38924                 construct-only="1"
38925                 transfer-ownership="none">
38926         <type name="gint"/>
38927       </property>
38928       <field name="parent_instance">
38929         <type name="SocketService" c:type="GSocketService"/>
38930       </field>
38931       <field name="priv">
38932         <type name="ThreadedSocketServicePrivate"
38933               c:type="GThreadedSocketServicePrivate*"/>
38934       </field>
38935       <glib:signal name="run">
38936         <doc xml:whitespace="preserve">The ::run signal is emitted in a worker thread in response to an
38937 incoming connection. This thread is dedicated to handling
38938 not return until the connection is closed.</doc>
38939         <return-value transfer-ownership="none">
38940           <doc xml:whitespace="preserve">%TRUE to stope further signal handlers from being called</doc>
38941           <type name="gboolean"/>
38942         </return-value>
38943         <parameters>
38944           <parameter name="object" transfer-ownership="none">
38945             <doc xml:whitespace="preserve">a new #GSocketConnection object.</doc>
38946             <type name="SocketConnection"/>
38947           </parameter>
38948           <parameter name="p0" transfer-ownership="none">
38949             <doc xml:whitespace="preserve">the source_object passed to g_socket_listener_add_address().</doc>
38950             <type name="GObject.Object"/>
38951           </parameter>
38952         </parameters>
38953       </glib:signal>
38954     </class>
38955     <record name="ThreadedSocketServiceClass"
38956             c:type="GThreadedSocketServiceClass"
38957             glib:is-gtype-struct-for="ThreadedSocketService">
38958       <field name="parent_class">
38959         <type name="SocketServiceClass" c:type="GSocketServiceClass"/>
38960       </field>
38961       <field name="run">
38962         <callback name="run">
38963           <return-value transfer-ownership="none">
38964             <type name="gboolean" c:type="gboolean"/>
38965           </return-value>
38966           <parameters>
38967             <parameter name="service" transfer-ownership="none">
38968               <type name="ThreadedSocketService"
38969                     c:type="GThreadedSocketService*"/>
38970             </parameter>
38971             <parameter name="connection" transfer-ownership="none">
38972               <type name="SocketConnection" c:type="GSocketConnection*"/>
38973             </parameter>
38974             <parameter name="source_object" transfer-ownership="none">
38975               <type name="GObject.Object" c:type="GObject*"/>
38976             </parameter>
38977           </parameters>
38978         </callback>
38979       </field>
38980       <field name="_g_reserved1" introspectable="0">
38981         <callback name="_g_reserved1">
38982           <return-value transfer-ownership="none">
38983             <type name="none" c:type="void"/>
38984           </return-value>
38985         </callback>
38986       </field>
38987       <field name="_g_reserved2" introspectable="0">
38988         <callback name="_g_reserved2">
38989           <return-value transfer-ownership="none">
38990             <type name="none" c:type="void"/>
38991           </return-value>
38992         </callback>
38993       </field>
38994       <field name="_g_reserved3" introspectable="0">
38995         <callback name="_g_reserved3">
38996           <return-value transfer-ownership="none">
38997             <type name="none" c:type="void"/>
38998           </return-value>
38999         </callback>
39000       </field>
39001       <field name="_g_reserved4" introspectable="0">
39002         <callback name="_g_reserved4">
39003           <return-value transfer-ownership="none">
39004             <type name="none" c:type="void"/>
39005           </return-value>
39006         </callback>
39007       </field>
39008       <field name="_g_reserved5" introspectable="0">
39009         <callback name="_g_reserved5">
39010           <return-value transfer-ownership="none">
39011             <type name="none" c:type="void"/>
39012           </return-value>
39013         </callback>
39014       </field>
39015     </record>
39016     <record name="ThreadedSocketServicePrivate"
39017             c:type="GThreadedSocketServicePrivate"
39018             disguised="1">
39019     </record>
39020     <class name="UnixConnection"
39021            c:symbol-prefix="unix_connection"
39022            c:type="GUnixConnection"
39023            parent="SocketConnection"
39024            glib:type-name="GUnixConnection"
39025            glib:get-type="g_unix_connection_get_type"
39026            glib:type-struct="UnixConnectionClass">
39027       <method name="receive_credentials"
39028               c:identifier="g_unix_connection_receive_credentials"
39029               version="2.26"
39030               throws="1">
39031         <doc xml:whitespace="preserve">Receives credentials from the sending end of the connection.  The
39032 sending end has to call g_unix_connection_send_credentials() (or
39033 similar) for this to work.
39034 As well as reading the credentials this also reads (and discards) a
39035 single byte from the stream, as this is required for credentials
39036 passing to work on some implementations.
39037 Other ways to exchange credentials with a foreign peer includes the
39038 #GUnixCredentialsMessage type and g_socket_get_credentials() function.
39039 g_object_unref()), %NULL if @error is set.</doc>
39040         <return-value transfer-ownership="full">
39041           <doc xml:whitespace="preserve">Received credentials on success (free with</doc>
39042           <type name="Credentials" c:type="GCredentials*"/>
39043         </return-value>
39044         <parameters>
39045           <parameter name="cancellable"
39046                      transfer-ownership="none"
39047                      allow-none="1">
39048             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
39049             <type name="Cancellable" c:type="GCancellable*"/>
39050           </parameter>
39051         </parameters>
39052       </method>
39053       <method name="receive_fd"
39054               c:identifier="g_unix_connection_receive_fd"
39055               version="2.22"
39056               throws="1">
39057         <doc xml:whitespace="preserve">Receives a file descriptor from the sending end of the connection.
39058 The sending end has to call g_unix_connection_send_fd() for this
39059 to work.
39060 As well as reading the fd this also reads a single byte from the
39061 stream, as this is required for fd passing to work on some
39062 implementations.</doc>
39063         <return-value transfer-ownership="none">
39064           <doc xml:whitespace="preserve">a file descriptor on success, -1 on error.</doc>
39065           <type name="gint" c:type="gint"/>
39066         </return-value>
39067         <parameters>
39068           <parameter name="cancellable"
39069                      transfer-ownership="none"
39070                      allow-none="1">
39071             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore</doc>
39072             <type name="Cancellable" c:type="GCancellable*"/>
39073           </parameter>
39074         </parameters>
39075       </method>
39076       <method name="send_credentials"
39077               c:identifier="g_unix_connection_send_credentials"
39078               version="2.26"
39079               throws="1">
39080         <doc xml:whitespace="preserve">Passes the credentials of the current user the receiving side
39081 of the connection. The recieving end has to call
39082 g_unix_connection_receive_credentials() (or similar) to accept the
39083 credentials.
39084 As well as sending the credentials this also writes a single NUL
39085 byte to the stream, as this is required for credentials passing to
39086 work on some implementations.
39087 Other ways to exchange credentials with a foreign peer includes the
39088 #GUnixCredentialsMessage type and g_socket_get_credentials() function.</doc>
39089         <return-value transfer-ownership="none">
39090           <doc xml:whitespace="preserve">%TRUE on success, %FALSE if @error is set.</doc>
39091           <type name="gboolean" c:type="gboolean"/>
39092         </return-value>
39093         <parameters>
39094           <parameter name="cancellable"
39095                      transfer-ownership="none"
39096                      allow-none="1">
39097             <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
39098             <type name="Cancellable" c:type="GCancellable*"/>
39099           </parameter>
39100         </parameters>
39101       </method>
39102       <method name="send_fd"
39103               c:identifier="g_unix_connection_send_fd"
39104               version="2.22"
39105               throws="1">
39106         <doc xml:whitespace="preserve">Passes a file descriptor to the recieving side of the
39107 connection. The recieving end has to call g_unix_connection_receive_fd()
39108 to accept the file descriptor.
39109 As well as sending the fd this also writes a single byte to the
39110 stream, as this is required for fd passing to work on some
39111 implementations.</doc>
39112         <return-value transfer-ownership="none">
39113           <doc xml:whitespace="preserve">a %TRUE on success, %NULL on error.</doc>
39114           <type name="gboolean" c:type="gboolean"/>
39115         </return-value>
39116         <parameters>
39117           <parameter name="fd" transfer-ownership="none">
39118             <doc xml:whitespace="preserve">a file descriptor</doc>
39119             <type name="gint" c:type="gint"/>
39120           </parameter>
39121           <parameter name="cancellable"
39122                      transfer-ownership="none"
39123                      allow-none="1">
39124             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
39125             <type name="Cancellable" c:type="GCancellable*"/>
39126           </parameter>
39127         </parameters>
39128       </method>
39129       <field name="parent_instance">
39130         <type name="SocketConnection" c:type="GSocketConnection"/>
39131       </field>
39132       <field name="priv">
39133         <type name="UnixConnectionPrivate" c:type="GUnixConnectionPrivate*"/>
39134       </field>
39135     </class>
39136     <record name="UnixConnectionClass"
39137             c:type="GUnixConnectionClass"
39138             glib:is-gtype-struct-for="UnixConnection">
39139       <field name="parent_class">
39140         <type name="SocketConnectionClass" c:type="GSocketConnectionClass"/>
39141       </field>
39142     </record>
39143     <record name="UnixConnectionPrivate"
39144             c:type="GUnixConnectionPrivate"
39145             disguised="1">
39146     </record>
39147     <class name="UnixCredentialsMessage"
39148            c:symbol-prefix="unix_credentials_message"
39149            c:type="GUnixCredentialsMessage"
39150            version="2.26"
39151            parent="SocketControlMessage"
39152            glib:type-name="GUnixCredentialsMessage"
39153            glib:get-type="g_unix_credentials_message_get_type"
39154            glib:type-struct="UnixCredentialsMessageClass">
39155       <doc xml:whitespace="preserve">The #GUnixCredentialsMessage structure contains only private data
39156 and should only be accessed using the provided API.</doc>
39157       <constructor name="new"
39158                    c:identifier="g_unix_credentials_message_new"
39159                    version="2.26">
39160         <doc xml:whitespace="preserve">Creates a new #GUnixCredentialsMessage with credentials matching the current processes.</doc>
39161         <return-value transfer-ownership="full">
39162           <doc xml:whitespace="preserve">a new #GUnixCredentialsMessage</doc>
39163           <type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
39164         </return-value>
39165       </constructor>
39166       <constructor name="new_with_credentials"
39167                    c:identifier="g_unix_credentials_message_new_with_credentials"
39168                    version="2.26">
39169         <doc xml:whitespace="preserve">Creates a new #GUnixCredentialsMessage holding @credentials.</doc>
39170         <return-value transfer-ownership="full">
39171           <doc xml:whitespace="preserve">a new #GUnixCredentialsMessage</doc>
39172           <type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
39173         </return-value>
39174         <parameters>
39175           <parameter name="credentials" transfer-ownership="none">
39176             <doc xml:whitespace="preserve">A #GCredentials object.</doc>
39177             <type name="Credentials" c:type="GCredentials*"/>
39178           </parameter>
39179         </parameters>
39180       </constructor>
39181       <function name="is_supported"
39182                 c:identifier="g_unix_credentials_message_is_supported"
39183                 version="2.26">
39184         <doc xml:whitespace="preserve">Checks if passing a #GCredential on a #GSocket is supported on this platform.</doc>
39185         <return-value transfer-ownership="none">
39186           <doc xml:whitespace="preserve">%TRUE if supported, %FALSE otherwise</doc>
39187           <type name="gboolean" c:type="gboolean"/>
39188         </return-value>
39189       </function>
39190       <method name="get_credentials"
39191               c:identifier="g_unix_credentials_message_get_credentials"
39192               version="2.26">
39193         <doc xml:whitespace="preserve">Gets the credentials stored in @message.</doc>
39194         <return-value transfer-ownership="none">
39195           <doc xml:whitespace="preserve">A #GCredentials instance. Do not free, it is owned by @message.</doc>
39196           <type name="Credentials" c:type="GCredentials*"/>
39197         </return-value>
39198       </method>
39199       <property name="credentials"
39200                 version="2.26"
39201                 writable="1"
39202                 construct-only="1"
39203                 transfer-ownership="none">
39204         <doc xml:whitespace="preserve">The credentials stored in the message.</doc>
39205         <type name="Credentials"/>
39206       </property>
39207       <field name="parent_instance">
39208         <type name="SocketControlMessage" c:type="GSocketControlMessage"/>
39209       </field>
39210       <field name="priv">
39211         <type name="UnixCredentialsMessagePrivate"
39212               c:type="GUnixCredentialsMessagePrivate*"/>
39213       </field>
39214     </class>
39215     <record name="UnixCredentialsMessageClass"
39216             c:type="GUnixCredentialsMessageClass"
39217             glib:is-gtype-struct-for="UnixCredentialsMessage"
39218             version="2.26">
39219       <doc xml:whitespace="preserve">Class structure for #GUnixCredentialsMessage.</doc>
39220       <field name="parent_class">
39221         <type name="SocketControlMessageClass"
39222               c:type="GSocketControlMessageClass"/>
39223       </field>
39224       <field name="_g_reserved1" introspectable="0">
39225         <callback name="_g_reserved1">
39226           <return-value transfer-ownership="none">
39227             <type name="none" c:type="void"/>
39228           </return-value>
39229         </callback>
39230       </field>
39231       <field name="_g_reserved2" introspectable="0">
39232         <callback name="_g_reserved2">
39233           <return-value transfer-ownership="none">
39234             <type name="none" c:type="void"/>
39235           </return-value>
39236         </callback>
39237       </field>
39238     </record>
39239     <record name="UnixCredentialsMessagePrivate"
39240             c:type="GUnixCredentialsMessagePrivate"
39241             disguised="1">
39242     </record>
39243     <class name="UnixFDList"
39244            c:symbol-prefix="unix_fd_list"
39245            c:type="GUnixFDList"
39246            parent="GObject.Object"
39247            glib:type-name="GUnixFDList"
39248            glib:get-type="g_unix_fd_list_get_type"
39249            glib:type-struct="UnixFDListClass">
39250       <constructor name="new" c:identifier="g_unix_fd_list_new" version="2.24">
39251         <doc xml:whitespace="preserve">Creates a new #GUnixFDList containing no file descriptors.</doc>
39252         <return-value transfer-ownership="full">
39253           <doc xml:whitespace="preserve">a new #GUnixFDList</doc>
39254           <type name="UnixFDList" c:type="GUnixFDList*"/>
39255         </return-value>
39256       </constructor>
39257       <constructor name="new_from_array"
39258                    c:identifier="g_unix_fd_list_new_from_array"
39259                    version="2.24">
39260         <doc xml:whitespace="preserve">Creates a new #GUnixFDList containing the file descriptors given in
39261 may no longer be used by the caller.  The array itself is owned by
39262 the caller.
39263 Each file descriptor in the array should be set to close-on-exec.
39264 If @n_fds is -1 then @fds must be terminated with -1.</doc>
39265         <return-value transfer-ownership="full">
39266           <doc xml:whitespace="preserve">a new #GUnixFDList</doc>
39267           <type name="UnixFDList" c:type="GUnixFDList*"/>
39268         </return-value>
39269         <parameters>
39270           <parameter name="fds" transfer-ownership="none">
39271             <doc xml:whitespace="preserve">the initial list of file descriptors</doc>
39272             <type name="gint" c:type="gint*"/>
39273           </parameter>
39274           <parameter name="n_fds" transfer-ownership="none">
39275             <doc xml:whitespace="preserve">the length of #fds, or -1</doc>
39276             <type name="gint" c:type="gint"/>
39277           </parameter>
39278         </parameters>
39279       </constructor>
39280       <method name="append"
39281               c:identifier="g_unix_fd_list_append"
39282               version="2.24"
39283               throws="1">
39284         <doc xml:whitespace="preserve">Adds a file descriptor to @list.
39285 The file descriptor is duplicated using dup(). You keep your copy
39286 of the descriptor and the copy contained in @list will be closed
39287 when @list is finalized.
39288 A possible cause of failure is exceeding the per-process or
39289 system-wide file descriptor limit.
39290 The index of the file descriptor in the list is returned.  If you use
39291 this index with g_unix_fd_list_get() then you will receive back a
39292 duplicated copy of the same file descriptor.
39293 (and @error is set)</doc>
39294         <return-value transfer-ownership="none">
39295           <doc xml:whitespace="preserve">the index of the appended fd in case of success, else -1</doc>
39296           <type name="gint" c:type="gint"/>
39297         </return-value>
39298         <parameters>
39299           <parameter name="fd" transfer-ownership="none">
39300             <doc xml:whitespace="preserve">a valid open file descriptor</doc>
39301             <type name="gint" c:type="gint"/>
39302           </parameter>
39303         </parameters>
39304       </method>
39305       <method name="get"
39306               c:identifier="g_unix_fd_list_get"
39307               version="2.24"
39308               throws="1">
39309         <doc xml:whitespace="preserve">Gets a file descriptor out of @list.
39310 programmer error for @index_ to be out of range; see
39311 g_unix_fd_list_get_length().
39312 The file descriptor is duplicated using dup() and set as
39313 close-on-exec before being returned.  You must call close() on it
39314 when you are done.
39315 A possible cause of failure is exceeding the per-process or
39316 system-wide file descriptor limit.</doc>
39317         <return-value transfer-ownership="none">
39318           <doc xml:whitespace="preserve">the file descriptor, or -1 in case of error</doc>
39319           <type name="gint" c:type="gint"/>
39320         </return-value>
39321         <parameters>
39322           <parameter name="index_" transfer-ownership="none">
39323             <doc xml:whitespace="preserve">the index into the list</doc>
39324             <type name="gint" c:type="gint"/>
39325           </parameter>
39326         </parameters>
39327       </method>
39328       <method name="get_length"
39329               c:identifier="g_unix_fd_list_get_length"
39330               version="2.24">
39331         <doc xml:whitespace="preserve">contained within).</doc>
39332         <return-value transfer-ownership="none">
39333           <doc xml:whitespace="preserve">the length of @list</doc>
39334           <type name="gint" c:type="gint"/>
39335         </return-value>
39336       </method>
39337       <method name="peek_fds"
39338               c:identifier="g_unix_fd_list_peek_fds"
39339               version="2.24">
39340         <doc xml:whitespace="preserve">Returns the array of file descriptors that is contained in this
39341 object.
39342 After this call, the descriptors remain the property of @list.  The
39343 caller must not close them and must not free the array.  The array is
39344 valid only until @list is changed in any way.
39345 If @length is non-%NULL then it is set to the number of file
39346 descriptors in the returned array. The returned array is also
39347 terminated with -1.
39348 This function never returns %NULL. In case there are no file
39349 descriptors contained in @list, an empty array is returned.</doc>
39350         <return-value transfer-ownership="none">
39351           <doc xml:whitespace="preserve">an array of file descriptors</doc>
39352           <type name="gint" c:type="gint*"/>
39353         </return-value>
39354         <parameters>
39355           <parameter name="length" transfer-ownership="none">
39356             <doc xml:whitespace="preserve">pointer to the length of the returned array, or %NULL</doc>
39357             <type name="gint" c:type="gint*"/>
39358           </parameter>
39359         </parameters>
39360       </method>
39361       <method name="steal_fds"
39362               c:identifier="g_unix_fd_list_steal_fds"
39363               version="2.24">
39364         <doc xml:whitespace="preserve">Returns the array of file descriptors that is contained in this
39365 object.
39366 After this call, the descriptors are no longer contained in
39367 descriptors have been added).
39368 The return result of this function must be freed with g_free().
39369 The caller is also responsible for closing all of the file
39370 descriptors.  The file descriptors in the array are set to
39371 close-on-exec.
39372 If @length is non-%NULL then it is set to the number of file
39373 descriptors in the returned array. The returned array is also
39374 terminated with -1.
39375 This function never returns %NULL. In case there are no file
39376 descriptors contained in @list, an empty array is returned.</doc>
39377         <return-value transfer-ownership="none">
39378           <doc xml:whitespace="preserve">an array of file descriptors</doc>
39379           <type name="gint" c:type="gint*"/>
39380         </return-value>
39381         <parameters>
39382           <parameter name="length" transfer-ownership="none">
39383             <doc xml:whitespace="preserve">pointer to the length of the returned array, or %NULL</doc>
39384             <type name="gint" c:type="gint*"/>
39385           </parameter>
39386         </parameters>
39387       </method>
39388       <field name="parent_instance">
39389         <type name="GObject.Object" c:type="GObject"/>
39390       </field>
39391       <field name="priv">
39392         <type name="UnixFDListPrivate" c:type="GUnixFDListPrivate*"/>
39393       </field>
39394     </class>
39395     <record name="UnixFDListClass"
39396             c:type="GUnixFDListClass"
39397             glib:is-gtype-struct-for="UnixFDList">
39398       <field name="parent_class">
39399         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
39400       </field>
39401       <field name="_g_reserved1" introspectable="0">
39402         <callback name="_g_reserved1">
39403           <return-value transfer-ownership="none">
39404             <type name="none" c:type="void"/>
39405           </return-value>
39406         </callback>
39407       </field>
39408       <field name="_g_reserved2" introspectable="0">
39409         <callback name="_g_reserved2">
39410           <return-value transfer-ownership="none">
39411             <type name="none" c:type="void"/>
39412           </return-value>
39413         </callback>
39414       </field>
39415       <field name="_g_reserved3" introspectable="0">
39416         <callback name="_g_reserved3">
39417           <return-value transfer-ownership="none">
39418             <type name="none" c:type="void"/>
39419           </return-value>
39420         </callback>
39421       </field>
39422       <field name="_g_reserved4" introspectable="0">
39423         <callback name="_g_reserved4">
39424           <return-value transfer-ownership="none">
39425             <type name="none" c:type="void"/>
39426           </return-value>
39427         </callback>
39428       </field>
39429       <field name="_g_reserved5" introspectable="0">
39430         <callback name="_g_reserved5">
39431           <return-value transfer-ownership="none">
39432             <type name="none" c:type="void"/>
39433           </return-value>
39434         </callback>
39435       </field>
39436     </record>
39437     <record name="UnixFDListPrivate" c:type="GUnixFDListPrivate" disguised="1">
39438     </record>
39439     <class name="UnixFDMessage"
39440            c:symbol-prefix="unix_fd_message"
39441            c:type="GUnixFDMessage"
39442            parent="SocketControlMessage"
39443            glib:type-name="GUnixFDMessage"
39444            glib:get-type="g_unix_fd_message_get_type"
39445            glib:type-struct="UnixFDMessageClass">
39446       <constructor name="new"
39447                    c:identifier="g_unix_fd_message_new"
39448                    version="2.22">
39449         <doc xml:whitespace="preserve">Creates a new #GUnixFDMessage containing an empty file descriptor
39450 list.</doc>
39451         <return-value transfer-ownership="full">
39452           <doc xml:whitespace="preserve">a new #GUnixFDMessage</doc>
39453           <type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
39454         </return-value>
39455       </constructor>
39456       <constructor name="new_with_fd_list"
39457                    c:identifier="g_unix_fd_message_new_with_fd_list"
39458                    version="2.24">
39459         <doc xml:whitespace="preserve">Creates a new #GUnixFDMessage containing @list.</doc>
39460         <return-value transfer-ownership="full">
39461           <doc xml:whitespace="preserve">a new #GUnixFDMessage</doc>
39462           <type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
39463         </return-value>
39464         <parameters>
39465           <parameter name="fd_list" transfer-ownership="none">
39466             <doc xml:whitespace="preserve">a #GUnixFDList</doc>
39467             <type name="UnixFDList" c:type="GUnixFDList*"/>
39468           </parameter>
39469         </parameters>
39470       </constructor>
39471       <method name="append_fd"
39472               c:identifier="g_unix_fd_message_append_fd"
39473               version="2.22"
39474               throws="1">
39475         <doc xml:whitespace="preserve">Adds a file descriptor to @message.
39476 The file descriptor is duplicated using dup(). You keep your copy
39477 of the descriptor and the copy contained in @message will be closed
39478 when @message is finalized.
39479 A possible cause of failure is exceeding the per-process or
39480 system-wide file descriptor limit.</doc>
39481         <return-value transfer-ownership="none">
39482           <doc xml:whitespace="preserve">%TRUE in case of success, else %FALSE (and @error is set)</doc>
39483           <type name="gboolean" c:type="gboolean"/>
39484         </return-value>
39485         <parameters>
39486           <parameter name="fd" transfer-ownership="none">
39487             <doc xml:whitespace="preserve">a valid open file descriptor</doc>
39488             <type name="gint" c:type="gint"/>
39489           </parameter>
39490         </parameters>
39491       </method>
39492       <method name="get_fd_list"
39493               c:identifier="g_unix_fd_message_get_fd_list"
39494               version="2.24">
39495         <doc xml:whitespace="preserve">Gets the #GUnixFDList contained in @message.  This function does not
39496 return a reference to the caller, but the returned list is valid for
39497 the lifetime of @message.</doc>
39498         <return-value transfer-ownership="none">
39499           <doc xml:whitespace="preserve">the #GUnixFDList from @message</doc>
39500           <type name="UnixFDList" c:type="GUnixFDList*"/>
39501         </return-value>
39502       </method>
39503       <method name="steal_fds"
39504               c:identifier="g_unix_fd_message_steal_fds"
39505               version="2.22">
39506         <doc xml:whitespace="preserve">Returns the array of file descriptors that is contained in this
39507 object.
39508 After this call, the descriptors are no longer contained in
39509 descriptors have been added).
39510 The return result of this function must be freed with g_free().
39511 The caller is also responsible for closing all of the file
39512 descriptors.
39513 If @length is non-%NULL then it is set to the number of file
39514 descriptors in the returned array. The returned array is also
39515 terminated with -1.
39516 This function never returns %NULL. In case there are no file
39517 descriptors contained in @message, an empty array is returned.</doc>
39518         <return-value transfer-ownership="none">
39519           <doc xml:whitespace="preserve">an array of file descriptors</doc>
39520           <type name="gint" c:type="gint*"/>
39521         </return-value>
39522         <parameters>
39523           <parameter name="length" transfer-ownership="none">
39524             <doc xml:whitespace="preserve">pointer to the length of the returned array, or %NULL</doc>
39525             <type name="gint" c:type="gint*"/>
39526           </parameter>
39527         </parameters>
39528       </method>
39529       <property name="fd-list"
39530                 writable="1"
39531                 construct-only="1"
39532                 transfer-ownership="none">
39533         <type name="UnixFDList"/>
39534       </property>
39535       <field name="parent_instance">
39536         <type name="SocketControlMessage" c:type="GSocketControlMessage"/>
39537       </field>
39538       <field name="priv">
39539         <type name="UnixFDMessagePrivate" c:type="GUnixFDMessagePrivate*"/>
39540       </field>
39541     </class>
39542     <record name="UnixFDMessageClass"
39543             c:type="GUnixFDMessageClass"
39544             glib:is-gtype-struct-for="UnixFDMessage">
39545       <field name="parent_class">
39546         <type name="SocketControlMessageClass"
39547               c:type="GSocketControlMessageClass"/>
39548       </field>
39549       <field name="_g_reserved1" introspectable="0">
39550         <callback name="_g_reserved1">
39551           <return-value transfer-ownership="none">
39552             <type name="none" c:type="void"/>
39553           </return-value>
39554         </callback>
39555       </field>
39556       <field name="_g_reserved2" introspectable="0">
39557         <callback name="_g_reserved2">
39558           <return-value transfer-ownership="none">
39559             <type name="none" c:type="void"/>
39560           </return-value>
39561         </callback>
39562       </field>
39563     </record>
39564     <record name="UnixFDMessagePrivate"
39565             c:type="GUnixFDMessagePrivate"
39566             disguised="1">
39567     </record>
39568     <class name="UnixInputStream"
39569            c:symbol-prefix="unix_input_stream"
39570            c:type="GUnixInputStream"
39571            parent="InputStream"
39572            glib:type-name="GUnixInputStream"
39573            glib:get-type="g_unix_input_stream_get_type"
39574            glib:type-struct="UnixInputStreamClass">
39575       <doc xml:whitespace="preserve">Implements #GInputStream for reading from selectable unix file descriptors</doc>
39576       <constructor name="new" c:identifier="g_unix_input_stream_new">
39577         <doc xml:whitespace="preserve">Creates a new #GUnixInputStream for the given @fd.
39578 If @close_fd is %TRUE, the file descriptor will be closed
39579 when the stream is closed.</doc>
39580         <return-value transfer-ownership="full">
39581           <doc xml:whitespace="preserve">a new #GUnixInputStream</doc>
39582           <type name="InputStream" c:type="GInputStream*"/>
39583         </return-value>
39584         <parameters>
39585           <parameter name="fd" transfer-ownership="none">
39586             <doc xml:whitespace="preserve">a UNIX file descriptor</doc>
39587             <type name="gint" c:type="gint"/>
39588           </parameter>
39589           <parameter name="close_fd" transfer-ownership="none">
39590             <doc xml:whitespace="preserve">%TRUE to close the file descriptor when done</doc>
39591             <type name="gboolean" c:type="gboolean"/>
39592           </parameter>
39593         </parameters>
39594       </constructor>
39595       <method name="get_close_fd"
39596               c:identifier="g_unix_input_stream_get_close_fd"
39597               version="2.20">
39598         <doc xml:whitespace="preserve">Returns whether the file descriptor of @stream will be
39599 closed when the stream is closed.</doc>
39600         <return-value transfer-ownership="none">
39601           <doc xml:whitespace="preserve">%TRUE if the file descriptor is closed when done</doc>
39602           <type name="gboolean" c:type="gboolean"/>
39603         </return-value>
39604       </method>
39605       <method name="get_fd"
39606               c:identifier="g_unix_input_stream_get_fd"
39607               version="2.20">
39608         <doc xml:whitespace="preserve">Return the UNIX file descriptor that the stream reads from.</doc>
39609         <return-value transfer-ownership="none">
39610           <doc xml:whitespace="preserve">The file descriptor of @stream</doc>
39611           <type name="gint" c:type="gint"/>
39612         </return-value>
39613       </method>
39614       <method name="set_close_fd"
39615               c:identifier="g_unix_input_stream_set_close_fd"
39616               version="2.20">
39617         <doc xml:whitespace="preserve">Sets whether the file descriptor of @stream shall be closed
39618 when the stream is closed.</doc>
39619         <return-value transfer-ownership="none">
39620           <type name="none" c:type="void"/>
39621         </return-value>
39622         <parameters>
39623           <parameter name="close_fd" transfer-ownership="none">
39624             <doc xml:whitespace="preserve">%TRUE to close the file descriptor when done</doc>
39625             <type name="gboolean" c:type="gboolean"/>
39626           </parameter>
39627         </parameters>
39628       </method>
39629       <property name="close-fd"
39630                 version="2.20"
39631                 writable="1"
39632                 transfer-ownership="none">
39633         <doc xml:whitespace="preserve">Whether to close the file descriptor when the stream is closed.</doc>
39634         <type name="gboolean"/>
39635       </property>
39636       <property name="fd"
39637                 version="2.20"
39638                 writable="1"
39639                 construct-only="1"
39640                 transfer-ownership="none">
39641         <doc xml:whitespace="preserve">The file descriptor that the stream reads from.</doc>
39642         <type name="gint"/>
39643       </property>
39644       <field name="parent_instance">
39645         <type name="InputStream" c:type="GInputStream"/>
39646       </field>
39647       <field name="priv">
39648         <type name="UnixInputStreamPrivate" c:type="GUnixInputStreamPrivate*"/>
39649       </field>
39650     </class>
39651     <record name="UnixInputStreamClass"
39652             c:type="GUnixInputStreamClass"
39653             glib:is-gtype-struct-for="UnixInputStream">
39654       <field name="parent_class">
39655         <type name="InputStreamClass" c:type="GInputStreamClass"/>
39656       </field>
39657       <field name="_g_reserved1" introspectable="0">
39658         <callback name="_g_reserved1">
39659           <return-value transfer-ownership="none">
39660             <type name="none" c:type="void"/>
39661           </return-value>
39662         </callback>
39663       </field>
39664       <field name="_g_reserved2" introspectable="0">
39665         <callback name="_g_reserved2">
39666           <return-value transfer-ownership="none">
39667             <type name="none" c:type="void"/>
39668           </return-value>
39669         </callback>
39670       </field>
39671       <field name="_g_reserved3" introspectable="0">
39672         <callback name="_g_reserved3">
39673           <return-value transfer-ownership="none">
39674             <type name="none" c:type="void"/>
39675           </return-value>
39676         </callback>
39677       </field>
39678       <field name="_g_reserved4" introspectable="0">
39679         <callback name="_g_reserved4">
39680           <return-value transfer-ownership="none">
39681             <type name="none" c:type="void"/>
39682           </return-value>
39683         </callback>
39684       </field>
39685       <field name="_g_reserved5" introspectable="0">
39686         <callback name="_g_reserved5">
39687           <return-value transfer-ownership="none">
39688             <type name="none" c:type="void"/>
39689           </return-value>
39690         </callback>
39691       </field>
39692     </record>
39693     <record name="UnixInputStreamPrivate"
39694             c:type="GUnixInputStreamPrivate"
39695             disguised="1">
39696     </record>
39697     <record name="UnixMountEntry" c:type="GUnixMountEntry" disguised="1">
39698       <doc xml:whitespace="preserve">Defines a Unix mount entry (e.g. &lt;filename&gt;/media/cdrom&lt;/filename&gt;).
39699 This corresponds roughly to a mtab entry.</doc>
39700     </record>
39701     <class name="UnixMountMonitor"
39702            c:symbol-prefix="unix_mount_monitor"
39703            c:type="GUnixMountMonitor"
39704            parent="GObject.Object"
39705            glib:type-name="GUnixMountMonitor"
39706            glib:get-type="g_unix_mount_monitor_get_type"
39707            glib:type-struct="UnixMountMonitorClass">
39708       <doc xml:whitespace="preserve">Watches #GUnixMount&lt;!-- --&gt;s for changes.</doc>
39709       <constructor name="new" c:identifier="g_unix_mount_monitor_new">
39710         <doc xml:whitespace="preserve">Gets a new #GUnixMountMonitor. The default rate limit for which the
39711 monitor will report consecutive changes for the mount and mount
39712 point entry files is the default for a #GFileMonitor. Use
39713 g_unix_mount_monitor_set_rate_limit() to change this.</doc>
39714         <return-value transfer-ownership="full">
39715           <doc xml:whitespace="preserve">a #GUnixMountMonitor.</doc>
39716           <type name="UnixMountMonitor" c:type="GUnixMountMonitor*"/>
39717         </return-value>
39718       </constructor>
39719       <method name="set_rate_limit"
39720               c:identifier="g_unix_mount_monitor_set_rate_limit"
39721               version="2.18">
39722         <doc xml:whitespace="preserve">Sets the rate limit to which the @mount_monitor will report
39723 consecutive change events to the mount and mount point entry files.</doc>
39724         <return-value transfer-ownership="none">
39725           <type name="none" c:type="void"/>
39726         </return-value>
39727         <parameters>
39728           <parameter name="limit_msec" transfer-ownership="none">
39729             <doc xml:whitespace="preserve">a integer with the limit in milliseconds to poll for changes.</doc>
39730             <type name="gint" c:type="int"/>
39731           </parameter>
39732         </parameters>
39733       </method>
39734       <glib:signal name="mountpoints-changed">
39735         <doc xml:whitespace="preserve">Emitted when the unix mount points have changed.</doc>
39736         <return-value transfer-ownership="none">
39737           <type name="none"/>
39738         </return-value>
39739       </glib:signal>
39740       <glib:signal name="mounts-changed">
39741         <doc xml:whitespace="preserve">Emitted when the unix mounts have changed.</doc>
39742         <return-value transfer-ownership="none">
39743           <type name="none"/>
39744         </return-value>
39745       </glib:signal>
39746     </class>
39747     <record name="UnixMountMonitorClass"
39748             c:type="GUnixMountMonitorClass"
39749             disguised="1"
39750             glib:is-gtype-struct-for="UnixMountMonitor">
39751     </record>
39752     <record name="UnixMountPoint" c:type="GUnixMountPoint" disguised="1">
39753       <doc xml:whitespace="preserve">Defines a Unix mount point (e.g. &lt;filename&gt;/dev&lt;/filename&gt;).
39754 This corresponds roughly to a fstab entry.</doc>
39755       <method name="compare" c:identifier="g_unix_mount_point_compare">
39756         <doc xml:whitespace="preserve">Compares two unix mount points.
39757 or less than @mount2, respectively.</doc>
39758         <return-value transfer-ownership="none">
39759           <doc xml:whitespace="preserve">1, 0 or -1 if @mount1 is greater than, equal to,</doc>
39760           <type name="gint" c:type="gint"/>
39761         </return-value>
39762         <parameters>
39763           <parameter name="mount2" transfer-ownership="none">
39764             <doc xml:whitespace="preserve">a #GUnixMount.</doc>
39765             <type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
39766           </parameter>
39767         </parameters>
39768       </method>
39769       <method name="free" c:identifier="g_unix_mount_point_free">
39770         <doc xml:whitespace="preserve">Frees a unix mount point.</doc>
39771         <return-value transfer-ownership="none">
39772           <type name="none" c:type="void"/>
39773         </return-value>
39774       </method>
39775       <method name="get_device_path"
39776               c:identifier="g_unix_mount_point_get_device_path">
39777         <doc xml:whitespace="preserve">Gets the device path for a unix mount point.</doc>
39778         <return-value transfer-ownership="none">
39779           <doc xml:whitespace="preserve">a string containing the device path.</doc>
39780           <type name="utf8" c:type="char*"/>
39781         </return-value>
39782       </method>
39783       <method name="get_fs_type" c:identifier="g_unix_mount_point_get_fs_type">
39784         <doc xml:whitespace="preserve">Gets the file system type for the mount point.</doc>
39785         <return-value transfer-ownership="none">
39786           <doc xml:whitespace="preserve">a string containing the file system type.</doc>
39787           <type name="utf8" c:type="char*"/>
39788         </return-value>
39789       </method>
39790       <method name="get_mount_path"
39791               c:identifier="g_unix_mount_point_get_mount_path">
39792         <doc xml:whitespace="preserve">Gets the mount path for a unix mount point.</doc>
39793         <return-value transfer-ownership="none">
39794           <doc xml:whitespace="preserve">a string containing the mount path.</doc>
39795           <type name="utf8" c:type="char*"/>
39796         </return-value>
39797       </method>
39798       <method name="guess_can_eject"
39799               c:identifier="g_unix_mount_point_guess_can_eject">
39800         <doc xml:whitespace="preserve">Guesses whether a Unix mount point can be ejected.</doc>
39801         <return-value transfer-ownership="none">
39802           <doc xml:whitespace="preserve">%TRUE if @mount_point is deemed to be ejectable.</doc>
39803           <type name="gboolean" c:type="gboolean"/>
39804         </return-value>
39805       </method>
39806       <method name="guess_icon" c:identifier="g_unix_mount_point_guess_icon">
39807         <doc xml:whitespace="preserve">Guesses the icon of a Unix mount point.</doc>
39808         <return-value transfer-ownership="full">
39809           <doc xml:whitespace="preserve">a #GIcon</doc>
39810           <type name="Icon" c:type="GIcon*"/>
39811         </return-value>
39812       </method>
39813       <method name="guess_name" c:identifier="g_unix_mount_point_guess_name">
39814         <doc xml:whitespace="preserve">Guesses the name of a Unix mount point.
39815 The result is a translated string.
39816 be freed with g_free()</doc>
39817         <return-value transfer-ownership="full">
39818           <doc xml:whitespace="preserve">A newly allocated string that must</doc>
39819           <type name="utf8" c:type="char*"/>
39820         </return-value>
39821       </method>
39822       <method name="is_loopback" c:identifier="g_unix_mount_point_is_loopback">
39823         <doc xml:whitespace="preserve">Checks if a unix mount point is a loopback device.</doc>
39824         <return-value transfer-ownership="none">
39825           <doc xml:whitespace="preserve">%TRUE if the mount point is a loopback. %FALSE otherwise.</doc>
39826           <type name="gboolean" c:type="gboolean"/>
39827         </return-value>
39828       </method>
39829       <method name="is_readonly" c:identifier="g_unix_mount_point_is_readonly">
39830         <doc xml:whitespace="preserve">Checks if a unix mount point is read only.</doc>
39831         <return-value transfer-ownership="none">
39832           <doc xml:whitespace="preserve">%TRUE if a mount point is read only.</doc>
39833           <type name="gboolean" c:type="gboolean"/>
39834         </return-value>
39835       </method>
39836       <method name="is_user_mountable"
39837               c:identifier="g_unix_mount_point_is_user_mountable">
39838         <doc xml:whitespace="preserve">Checks if a unix mount point is mountable by the user.</doc>
39839         <return-value transfer-ownership="none">
39840           <doc xml:whitespace="preserve">%TRUE if the mount point is user mountable.</doc>
39841           <type name="gboolean" c:type="gboolean"/>
39842         </return-value>
39843       </method>
39844     </record>
39845     <class name="UnixOutputStream"
39846            c:symbol-prefix="unix_output_stream"
39847            c:type="GUnixOutputStream"
39848            parent="OutputStream"
39849            glib:type-name="GUnixOutputStream"
39850            glib:get-type="g_unix_output_stream_get_type"
39851            glib:type-struct="UnixOutputStreamClass">
39852       <doc xml:whitespace="preserve">Implements #GOutputStream for outputting to selectable unix file descriptors</doc>
39853       <constructor name="new" c:identifier="g_unix_output_stream_new">
39854         <doc xml:whitespace="preserve">Creates a new #GUnixOutputStream for the given @fd.
39855 If @close_fd, is %TRUE, the file descriptor will be closed when
39856 the output stream is destroyed.</doc>
39857         <return-value transfer-ownership="full">
39858           <doc xml:whitespace="preserve">a new #GOutputStream</doc>
39859           <type name="OutputStream" c:type="GOutputStream*"/>
39860         </return-value>
39861         <parameters>
39862           <parameter name="fd" transfer-ownership="none">
39863             <doc xml:whitespace="preserve">a UNIX file descriptor</doc>
39864             <type name="gint" c:type="gint"/>
39865           </parameter>
39866           <parameter name="close_fd" transfer-ownership="none">
39867             <doc xml:whitespace="preserve">%TRUE to close the file descriptor when done</doc>
39868             <type name="gboolean" c:type="gboolean"/>
39869           </parameter>
39870         </parameters>
39871       </constructor>
39872       <method name="get_close_fd"
39873               c:identifier="g_unix_output_stream_get_close_fd"
39874               version="2.20">
39875         <doc xml:whitespace="preserve">Returns whether the file descriptor of @stream will be
39876 closed when the stream is closed.</doc>
39877         <return-value transfer-ownership="none">
39878           <doc xml:whitespace="preserve">%TRUE if the file descriptor is closed when done</doc>
39879           <type name="gboolean" c:type="gboolean"/>
39880         </return-value>
39881       </method>
39882       <method name="get_fd"
39883               c:identifier="g_unix_output_stream_get_fd"
39884               version="2.20">
39885         <doc xml:whitespace="preserve">Return the UNIX file descriptor that the stream writes to.</doc>
39886         <return-value transfer-ownership="none">
39887           <doc xml:whitespace="preserve">The file descriptor of @stream</doc>
39888           <type name="gint" c:type="gint"/>
39889         </return-value>
39890       </method>
39891       <method name="set_close_fd"
39892               c:identifier="g_unix_output_stream_set_close_fd"
39893               version="2.20">
39894         <doc xml:whitespace="preserve">Sets whether the file descriptor of @stream shall be closed
39895 when the stream is closed.</doc>
39896         <return-value transfer-ownership="none">
39897           <type name="none" c:type="void"/>
39898         </return-value>
39899         <parameters>
39900           <parameter name="close_fd" transfer-ownership="none">
39901             <doc xml:whitespace="preserve">%TRUE to close the file descriptor when done</doc>
39902             <type name="gboolean" c:type="gboolean"/>
39903           </parameter>
39904         </parameters>
39905       </method>
39906       <property name="close-fd"
39907                 version="2.20"
39908                 writable="1"
39909                 transfer-ownership="none">
39910         <doc xml:whitespace="preserve">Whether to close the file descriptor when the stream is closed.</doc>
39911         <type name="gboolean"/>
39912       </property>
39913       <property name="fd"
39914                 version="2.20"
39915                 writable="1"
39916                 construct-only="1"
39917                 transfer-ownership="none">
39918         <doc xml:whitespace="preserve">The file descriptor that the stream writes to.</doc>
39919         <type name="gint"/>
39920       </property>
39921       <field name="parent_instance">
39922         <type name="OutputStream" c:type="GOutputStream"/>
39923       </field>
39924       <field name="priv">
39925         <type name="UnixOutputStreamPrivate"
39926               c:type="GUnixOutputStreamPrivate*"/>
39927       </field>
39928     </class>
39929     <record name="UnixOutputStreamClass"
39930             c:type="GUnixOutputStreamClass"
39931             glib:is-gtype-struct-for="UnixOutputStream">
39932       <field name="parent_class">
39933         <type name="OutputStreamClass" c:type="GOutputStreamClass"/>
39934       </field>
39935       <field name="_g_reserved1" introspectable="0">
39936         <callback name="_g_reserved1">
39937           <return-value transfer-ownership="none">
39938             <type name="none" c:type="void"/>
39939           </return-value>
39940         </callback>
39941       </field>
39942       <field name="_g_reserved2" introspectable="0">
39943         <callback name="_g_reserved2">
39944           <return-value transfer-ownership="none">
39945             <type name="none" c:type="void"/>
39946           </return-value>
39947         </callback>
39948       </field>
39949       <field name="_g_reserved3" introspectable="0">
39950         <callback name="_g_reserved3">
39951           <return-value transfer-ownership="none">
39952             <type name="none" c:type="void"/>
39953           </return-value>
39954         </callback>
39955       </field>
39956       <field name="_g_reserved4" introspectable="0">
39957         <callback name="_g_reserved4">
39958           <return-value transfer-ownership="none">
39959             <type name="none" c:type="void"/>
39960           </return-value>
39961         </callback>
39962       </field>
39963       <field name="_g_reserved5" introspectable="0">
39964         <callback name="_g_reserved5">
39965           <return-value transfer-ownership="none">
39966             <type name="none" c:type="void"/>
39967           </return-value>
39968         </callback>
39969       </field>
39970     </record>
39971     <record name="UnixOutputStreamPrivate"
39972             c:type="GUnixOutputStreamPrivate"
39973             disguised="1">
39974     </record>
39975     <class name="UnixSocketAddress"
39976            c:symbol-prefix="unix_socket_address"
39977            c:type="GUnixSocketAddress"
39978            parent="SocketAddress"
39979            glib:type-name="GUnixSocketAddress"
39980            glib:get-type="g_unix_socket_address_get_type"
39981            glib:type-struct="UnixSocketAddressClass">
39982       <doc xml:whitespace="preserve">A UNIX-domain (local) socket address, corresponding to a
39983 &lt;type&gt;struct sockaddr_un&lt;/type&gt;.</doc>
39984       <implements name="SocketConnectable"/>
39985       <constructor name="new"
39986                    c:identifier="g_unix_socket_address_new"
39987                    version="2.22">
39988         <doc xml:whitespace="preserve">Creates a new #GUnixSocketAddress for @path.
39989 To create abstract socket addresses, on systems that support that,
39990 use g_unix_socket_address_new_abstract().</doc>
39991         <return-value transfer-ownership="full">
39992           <doc xml:whitespace="preserve">a new #GUnixSocketAddress</doc>
39993           <type name="SocketAddress" c:type="GSocketAddress*"/>
39994         </return-value>
39995         <parameters>
39996           <parameter name="path" transfer-ownership="none">
39997             <doc xml:whitespace="preserve">the socket path</doc>
39998             <type name="utf8" c:type="gchar*"/>
39999           </parameter>
40000         </parameters>
40001       </constructor>
40002       <constructor name="new_abstract"
40003                    c:identifier="g_unix_socket_address_new_abstract"
40004                    deprecated="Use g_unix_socket_address_new_with_type().">
40005         <doc xml:whitespace="preserve">Creates a new %G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED
40006 #GUnixSocketAddress for @path.</doc>
40007         <return-value transfer-ownership="full">
40008           <doc xml:whitespace="preserve">a new #GUnixSocketAddress</doc>
40009           <type name="SocketAddress" c:type="GSocketAddress*"/>
40010         </return-value>
40011         <parameters>
40012           <parameter name="path" transfer-ownership="none">
40013             <doc xml:whitespace="preserve">the abstract name</doc>
40014             <type name="utf8" c:type="gchar*"/>
40015           </parameter>
40016           <parameter name="path_len" transfer-ownership="none">
40017             <doc xml:whitespace="preserve">the length of @path, or -1</doc>
40018             <type name="gint" c:type="gint"/>
40019           </parameter>
40020         </parameters>
40021       </constructor>
40022       <constructor name="new_with_type"
40023                    c:identifier="g_unix_socket_address_new_with_type"
40024                    version="2.26">
40025         <doc xml:whitespace="preserve">Creates a new #GUnixSocketAddress of type @type with name @path.
40026 If @type is %G_UNIX_SOCKET_ADDRESS_PATH, this is equivalent to
40027 calling g_unix_socket_address_new().
40028 If @path_type is %G_UNIX_SOCKET_ADDRESS_ABSTRACT, then @path_len
40029 bytes of @path will be copied to the socket's path, and only those
40030 bytes will be considered part of the name. (If @path_len is -1,
40031 then @path is assumed to be NUL-terminated.) For example, if @path
40032 was "test", then calling g_socket_address_get_native_size() on the
40033 returned socket would return 7 (2 bytes of overhead, 1 byte for the
40034 abstract-socket indicator byte, and 4 bytes for the name "test").
40035 If @path_type is %G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED, then
40036 rest of the path will be padded with 0 bytes, and the entire
40037 zero-padded buffer will be considered the name. (As above, if
40038 this case, g_socket_address_get_native_size() will always return
40039 the full size of a &lt;literal&gt;struct sockaddr_un&lt;/literal&gt;, although
40040 g_unix_socket_address_get_path_len() will still return just the
40041 length of @path.
40042 %G_UNIX_SOCKET_ADDRESS_ABSTRACT is preferred over
40043 %G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED for new programs. Of course,
40044 when connecting to a server created by another process, you must
40045 use the appropriate type corresponding to how that process created
40046 its listening socket.</doc>
40047         <return-value transfer-ownership="full">
40048           <doc xml:whitespace="preserve">a new #GUnixSocketAddress</doc>
40049           <type name="SocketAddress" c:type="GSocketAddress*"/>
40050         </return-value>
40051         <parameters>
40052           <parameter name="path" transfer-ownership="none">
40053             <doc xml:whitespace="preserve">the name</doc>
40054             <type name="utf8" c:type="gchar*"/>
40055           </parameter>
40056           <parameter name="path_len" transfer-ownership="none">
40057             <doc xml:whitespace="preserve">the length of @path, or -1</doc>
40058             <type name="gint" c:type="gint"/>
40059           </parameter>
40060           <parameter name="type" transfer-ownership="none">
40061             <doc xml:whitespace="preserve">a #GUnixSocketAddressType</doc>
40062             <type name="UnixSocketAddressType"
40063                   c:type="GUnixSocketAddressType"/>
40064           </parameter>
40065         </parameters>
40066       </constructor>
40067       <function name="abstract_names_supported"
40068                 c:identifier="g_unix_socket_address_abstract_names_supported"
40069                 version="2.22">
40070         <doc xml:whitespace="preserve">Checks if abstract unix domain socket names are supported.</doc>
40071         <return-value transfer-ownership="none">
40072           <doc xml:whitespace="preserve">%TRUE if supported, %FALSE otherwise</doc>
40073           <type name="gboolean" c:type="gboolean"/>
40074         </return-value>
40075       </function>
40076       <method name="get_address_type"
40077               c:identifier="g_unix_socket_address_get_address_type"
40078               version="2.26">
40079         <doc xml:whitespace="preserve">Gets @address's type.</doc>
40080         <return-value transfer-ownership="none">
40081           <doc xml:whitespace="preserve">a #GUnixSocketAddressType</doc>
40082           <type name="UnixSocketAddressType" c:type="GUnixSocketAddressType"/>
40083         </return-value>
40084       </method>
40085       <method name="get_is_abstract"
40086               c:identifier="g_unix_socket_address_get_is_abstract"
40087               version="2.22"
40088               deprecated="Use g_unix_socket_address_get_address_type()">
40089         <doc xml:whitespace="preserve">Tests if @address is abstract.</doc>
40090         <return-value transfer-ownership="none">
40091           <doc xml:whitespace="preserve">%TRUE if the address is abstract, %FALSE otherwise</doc>
40092           <type name="gboolean" c:type="gboolean"/>
40093         </return-value>
40094       </method>
40095       <method name="get_path"
40096               c:identifier="g_unix_socket_address_get_path"
40097               version="2.22">
40098         <doc xml:whitespace="preserve">Gets @address's path, or for abstract sockets the "name".
40099 Guaranteed to be zero-terminated, but an abstract socket
40100 may contain embedded zeros, and thus you should use
40101 g_unix_socket_address_get_path_len() to get the true length
40102 of this string.</doc>
40103         <return-value transfer-ownership="none">
40104           <doc xml:whitespace="preserve">the path for @address</doc>
40105           <type name="utf8" c:type="char*"/>
40106         </return-value>
40107       </method>
40108       <method name="get_path_len"
40109               c:identifier="g_unix_socket_address_get_path_len"
40110               version="2.22">
40111         <doc xml:whitespace="preserve">Gets the length of @address's path.
40112 For details, see g_unix_socket_address_get_path().</doc>
40113         <return-value transfer-ownership="none">
40114           <doc xml:whitespace="preserve">the length of the path</doc>
40115           <type name="gulong" c:type="gsize"/>
40116         </return-value>
40117       </method>
40118       <property name="abstract"
40119                 deprecated="Use #GUnixSocketAddress:address-type, which"
40120                 writable="1"
40121                 construct-only="1"
40122                 transfer-ownership="none">
40123         <doc xml:whitespace="preserve">Whether or not this is an abstract address
40124 distinguishes between zero-padded and non-zero-padded
40125 abstract addresses.</doc>
40126         <type name="gboolean"/>
40127       </property>
40128       <property name="address-type"
40129                 writable="1"
40130                 construct-only="1"
40131                 transfer-ownership="none">
40132         <type name="UnixSocketAddressType"/>
40133       </property>
40134       <property name="path"
40135                 writable="1"
40136                 construct-only="1"
40137                 transfer-ownership="none">
40138         <type name="utf8"/>
40139       </property>
40140       <property name="path-as-array"
40141                 writable="1"
40142                 construct-only="1"
40143                 transfer-ownership="none">
40144         <array name="GLib.ByteArray">
40145           <type name="gpointer" c:type="gpointer"/>
40146         </array>
40147       </property>
40148       <field name="parent_instance">
40149         <type name="SocketAddress" c:type="GSocketAddress"/>
40150       </field>
40151       <field name="priv">
40152         <type name="UnixSocketAddressPrivate"
40153               c:type="GUnixSocketAddressPrivate*"/>
40154       </field>
40155     </class>
40156     <record name="UnixSocketAddressClass"
40157             c:type="GUnixSocketAddressClass"
40158             glib:is-gtype-struct-for="UnixSocketAddress">
40159       <field name="parent_class">
40160         <type name="SocketAddressClass" c:type="GSocketAddressClass"/>
40161       </field>
40162     </record>
40163     <record name="UnixSocketAddressPrivate"
40164             c:type="GUnixSocketAddressPrivate"
40165             disguised="1">
40166     </record>
40167     <enumeration name="UnixSocketAddressType"
40168                  version="2.26"
40169                  glib:type-name="GUnixSocketAddressType"
40170                  glib:get-type="g_unix_socket_address_type_get_type"
40171                  c:type="GUnixSocketAddressType">
40172       <doc xml:whitespace="preserve">The type of name used by a #GUnixSocketAddress.
40173 %G_UNIX_SOCKET_ADDRESS_PATH indicates a traditional unix domain
40174 socket bound to a filesystem path. %G_UNIX_SOCKET_ADDRESS_ANONYMOUS
40175 indicates a socket not bound to any name (eg, a client-side socket,
40176 or a socket created with socketpair()).
40177 For abstract sockets, there are two incompatible ways of naming
40178 sockaddr_un&lt;/literal&gt; as the name, padding the unused parts of the
40179 %sun_path field with zeroes; this corresponds to
40180 %G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED. However, many programs
40181 instead just use a portion of %sun_path, and pass an appropriate
40182 smaller length to bind() or connect(). This is
40183 %G_UNIX_SOCKET_ADDRESS_ABSTRACT.</doc>
40184       <member name="invalid"
40185               value="0"
40186               c:identifier="G_UNIX_SOCKET_ADDRESS_INVALID"
40187               glib:nick="invalid"/>
40188       <member name="anonymous"
40189               value="1"
40190               c:identifier="G_UNIX_SOCKET_ADDRESS_ANONYMOUS"
40191               glib:nick="anonymous"/>
40192       <member name="path"
40193               value="2"
40194               c:identifier="G_UNIX_SOCKET_ADDRESS_PATH"
40195               glib:nick="path"/>
40196       <member name="abstract"
40197               value="3"
40198               c:identifier="G_UNIX_SOCKET_ADDRESS_ABSTRACT"
40199               glib:nick="abstract"/>
40200       <member name="abstract_padded"
40201               value="4"
40202               c:identifier="G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED"
40203               glib:nick="abstract-padded"/>
40204     </enumeration>
40205     <constant name="VFS_EXTENSION_POINT_NAME" value="gio-vfs">
40206       <type name="utf8" c:type="gchar*"/>
40207     </constant>
40208     <constant name="VOLUME_IDENTIFIER_KIND_HAL_UDI" value="hal-udi">
40209       <type name="utf8" c:type="gchar*"/>
40210     </constant>
40211     <constant name="VOLUME_IDENTIFIER_KIND_LABEL" value="label">
40212       <type name="utf8" c:type="gchar*"/>
40213     </constant>
40214     <constant name="VOLUME_IDENTIFIER_KIND_NFS_MOUNT" value="nfs-mount">
40215       <type name="utf8" c:type="gchar*"/>
40216     </constant>
40217     <constant name="VOLUME_IDENTIFIER_KIND_UNIX_DEVICE" value="unix-device">
40218       <type name="utf8" c:type="gchar*"/>
40219     </constant>
40220     <constant name="VOLUME_IDENTIFIER_KIND_UUID" value="uuid">
40221       <type name="utf8" c:type="gchar*"/>
40222     </constant>
40223     <constant name="VOLUME_MONITOR_EXTENSION_POINT_NAME"
40224               value="gio-volume-monitor">
40225       <type name="utf8" c:type="gchar*"/>
40226     </constant>
40227     <class name="Vfs"
40228            c:symbol-prefix="vfs"
40229            c:type="GVfs"
40230            parent="GObject.Object"
40231            glib:type-name="GVfs"
40232            glib:get-type="g_vfs_get_type"
40233            glib:type-struct="VfsClass">
40234       <doc xml:whitespace="preserve">Virtual File System object.</doc>
40235       <function name="get_default" c:identifier="g_vfs_get_default">
40236         <doc xml:whitespace="preserve">Gets the default #GVfs for the system.</doc>
40237         <return-value transfer-ownership="none">
40238           <doc xml:whitespace="preserve">a #GVfs.</doc>
40239           <type name="Vfs" c:type="GVfs*"/>
40240         </return-value>
40241       </function>
40242       <function name="get_local" c:identifier="g_vfs_get_local">
40243         <doc xml:whitespace="preserve">Gets the local #GVfs for the system.</doc>
40244         <return-value transfer-ownership="none">
40245           <doc xml:whitespace="preserve">a #GVfs.</doc>
40246           <type name="Vfs" c:type="GVfs*"/>
40247         </return-value>
40248       </function>
40249       <virtual-method name="add_writable_namespaces">
40250         <return-value transfer-ownership="none">
40251           <type name="none" c:type="void"/>
40252         </return-value>
40253         <parameters>
40254           <parameter name="list" transfer-ownership="none">
40255             <type name="FileAttributeInfoList"
40256                   c:type="GFileAttributeInfoList*"/>
40257           </parameter>
40258         </parameters>
40259       </virtual-method>
40260       <virtual-method name="get_file_for_path" invoker="get_file_for_path">
40261         <doc xml:whitespace="preserve">Gets a #GFile for @path.
40262 Free the returned object with g_object_unref().</doc>
40263         <return-value transfer-ownership="full">
40264           <doc xml:whitespace="preserve">a #GFile.</doc>
40265           <type name="File" c:type="GFile*"/>
40266         </return-value>
40267         <parameters>
40268           <parameter name="path" transfer-ownership="none">
40269             <doc xml:whitespace="preserve">a string containing a VFS path.</doc>
40270             <type name="utf8" c:type="char*"/>
40271           </parameter>
40272         </parameters>
40273       </virtual-method>
40274       <virtual-method name="get_file_for_uri" invoker="get_file_for_uri">
40275         <doc xml:whitespace="preserve">Gets a #GFile for @uri.
40276 This operation never fails, but the returned object
40277 might not support any I/O operation if the URI
40278 is malformed or if the URI scheme is not supported.
40279 Free the returned object with g_object_unref().</doc>
40280         <return-value transfer-ownership="full">
40281           <doc xml:whitespace="preserve">a #GFile.</doc>
40282           <type name="File" c:type="GFile*"/>
40283         </return-value>
40284         <parameters>
40285           <parameter name="uri" transfer-ownership="none">
40286             <doc xml:whitespace="preserve">a string containing a URI</doc>
40287             <type name="utf8" c:type="char*"/>
40288           </parameter>
40289         </parameters>
40290       </virtual-method>
40291       <virtual-method name="get_supported_uri_schemes"
40292                       invoker="get_supported_uri_schemes">
40293         <doc xml:whitespace="preserve">Gets a list of URI schemes supported by @vfs.
40294 The returned array belongs to GIO and must
40295 not be freed or modified.</doc>
40296         <return-value transfer-ownership="none">
40297           <doc xml:whitespace="preserve">a %NULL-terminated array of strings.</doc>
40298           <array c:type="gchar**">
40299             <type name="utf8"/>
40300           </array>
40301         </return-value>
40302       </virtual-method>
40303       <virtual-method name="is_active" invoker="is_active">
40304         <doc xml:whitespace="preserve">Checks if the VFS is active.</doc>
40305         <return-value transfer-ownership="none">
40306           <doc xml:whitespace="preserve">%TRUE if construction of the @vfs was successful and it is now active.</doc>
40307           <type name="gboolean" c:type="gboolean"/>
40308         </return-value>
40309       </virtual-method>
40310       <virtual-method name="local_file_add_info">
40311         <return-value transfer-ownership="none">
40312           <type name="none" c:type="void"/>
40313         </return-value>
40314         <parameters>
40315           <parameter name="filename" transfer-ownership="none">
40316             <type name="utf8" c:type="char*"/>
40317           </parameter>
40318           <parameter name="device" transfer-ownership="none">
40319             <type name="guint64" c:type="guint64"/>
40320           </parameter>
40321           <parameter name="attribute_matcher" transfer-ownership="none">
40322             <type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
40323           </parameter>
40324           <parameter name="info" transfer-ownership="none">
40325             <type name="FileInfo" c:type="GFileInfo*"/>
40326           </parameter>
40327           <parameter name="cancellable" transfer-ownership="none">
40328             <type name="Cancellable" c:type="GCancellable*"/>
40329           </parameter>
40330           <parameter name="extra_data" transfer-ownership="none">
40331             <type name="gpointer" c:type="gpointer*"/>
40332           </parameter>
40333           <parameter name="free_extra_data"
40334                      transfer-ownership="none"
40335                      scope="async">
40336             <type name="GLib.DestroyNotify" c:type="GDestroyNotify*"/>
40337           </parameter>
40338         </parameters>
40339       </virtual-method>
40340       <virtual-method name="local_file_moved">
40341         <return-value transfer-ownership="none">
40342           <type name="none" c:type="void"/>
40343         </return-value>
40344         <parameters>
40345           <parameter name="source" transfer-ownership="none">
40346             <type name="utf8" c:type="char*"/>
40347           </parameter>
40348           <parameter name="dest" transfer-ownership="none">
40349             <type name="utf8" c:type="char*"/>
40350           </parameter>
40351         </parameters>
40352       </virtual-method>
40353       <virtual-method name="local_file_removed">
40354         <return-value transfer-ownership="none">
40355           <type name="none" c:type="void"/>
40356         </return-value>
40357         <parameters>
40358           <parameter name="filename" transfer-ownership="none">
40359             <type name="utf8" c:type="char*"/>
40360           </parameter>
40361         </parameters>
40362       </virtual-method>
40363       <virtual-method name="local_file_set_attributes" throws="1">
40364         <return-value transfer-ownership="none">
40365           <type name="gboolean" c:type="gboolean"/>
40366         </return-value>
40367         <parameters>
40368           <parameter name="filename" transfer-ownership="none">
40369             <type name="utf8" c:type="char*"/>
40370           </parameter>
40371           <parameter name="info" transfer-ownership="none">
40372             <type name="FileInfo" c:type="GFileInfo*"/>
40373           </parameter>
40374           <parameter name="flags" transfer-ownership="none">
40375             <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
40376           </parameter>
40377           <parameter name="cancellable" transfer-ownership="none">
40378             <type name="Cancellable" c:type="GCancellable*"/>
40379           </parameter>
40380         </parameters>
40381       </virtual-method>
40382       <virtual-method name="parse_name" invoker="parse_name">
40383         <doc xml:whitespace="preserve">This operation never fails, but the returned object might
40384 not support any I/O operations if the @parse_name cannot
40385 be parsed by the #GVfs module.
40386 Free the returned object with g_object_unref().</doc>
40387         <return-value transfer-ownership="full">
40388           <doc xml:whitespace="preserve">a #GFile for the given @parse_name.</doc>
40389           <type name="File" c:type="GFile*"/>
40390         </return-value>
40391         <parameters>
40392           <parameter name="parse_name" transfer-ownership="none">
40393             <doc xml:whitespace="preserve">a string to be parsed by the VFS module.</doc>
40394             <type name="utf8" c:type="char*"/>
40395           </parameter>
40396         </parameters>
40397       </virtual-method>
40398       <method name="get_file_for_path" c:identifier="g_vfs_get_file_for_path">
40399         <doc xml:whitespace="preserve">Gets a #GFile for @path.
40400 Free the returned object with g_object_unref().</doc>
40401         <return-value transfer-ownership="full">
40402           <doc xml:whitespace="preserve">a #GFile.</doc>
40403           <type name="File" c:type="GFile*"/>
40404         </return-value>
40405         <parameters>
40406           <parameter name="path" transfer-ownership="none">
40407             <doc xml:whitespace="preserve">a string containing a VFS path.</doc>
40408             <type name="utf8" c:type="char*"/>
40409           </parameter>
40410         </parameters>
40411       </method>
40412       <method name="get_file_for_uri" c:identifier="g_vfs_get_file_for_uri">
40413         <doc xml:whitespace="preserve">Gets a #GFile for @uri.
40414 This operation never fails, but the returned object
40415 might not support any I/O operation if the URI
40416 is malformed or if the URI scheme is not supported.
40417 Free the returned object with g_object_unref().</doc>
40418         <return-value transfer-ownership="full">
40419           <doc xml:whitespace="preserve">a #GFile.</doc>
40420           <type name="File" c:type="GFile*"/>
40421         </return-value>
40422         <parameters>
40423           <parameter name="uri" transfer-ownership="none">
40424             <doc xml:whitespace="preserve">a string containing a URI</doc>
40425             <type name="utf8" c:type="char*"/>
40426           </parameter>
40427         </parameters>
40428       </method>
40429       <method name="get_supported_uri_schemes"
40430               c:identifier="g_vfs_get_supported_uri_schemes">
40431         <doc xml:whitespace="preserve">Gets a list of URI schemes supported by @vfs.
40432 The returned array belongs to GIO and must
40433 not be freed or modified.</doc>
40434         <return-value transfer-ownership="none">
40435           <doc xml:whitespace="preserve">a %NULL-terminated array of strings.</doc>
40436           <array c:type="gchar**">
40437             <type name="utf8"/>
40438           </array>
40439         </return-value>
40440       </method>
40441       <method name="is_active" c:identifier="g_vfs_is_active">
40442         <doc xml:whitespace="preserve">Checks if the VFS is active.</doc>
40443         <return-value transfer-ownership="none">
40444           <doc xml:whitespace="preserve">%TRUE if construction of the @vfs was successful and it is now active.</doc>
40445           <type name="gboolean" c:type="gboolean"/>
40446         </return-value>
40447       </method>
40448       <method name="parse_name" c:identifier="g_vfs_parse_name">
40449         <doc xml:whitespace="preserve">This operation never fails, but the returned object might
40450 not support any I/O operations if the @parse_name cannot
40451 be parsed by the #GVfs module.
40452 Free the returned object with g_object_unref().</doc>
40453         <return-value transfer-ownership="full">
40454           <doc xml:whitespace="preserve">a #GFile for the given @parse_name.</doc>
40455           <type name="File" c:type="GFile*"/>
40456         </return-value>
40457         <parameters>
40458           <parameter name="parse_name" transfer-ownership="none">
40459             <doc xml:whitespace="preserve">a string to be parsed by the VFS module.</doc>
40460             <type name="utf8" c:type="char*"/>
40461           </parameter>
40462         </parameters>
40463       </method>
40464       <field name="parent_instance">
40465         <type name="GObject.Object" c:type="GObject"/>
40466       </field>
40467     </class>
40468     <record name="VfsClass" c:type="GVfsClass" glib:is-gtype-struct-for="Vfs">
40469       <field name="parent_class">
40470         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
40471       </field>
40472       <field name="is_active">
40473         <callback name="is_active">
40474           <return-value transfer-ownership="none">
40475             <doc xml:whitespace="preserve">%TRUE if construction of the @vfs was successful and it is now active.</doc>
40476             <type name="gboolean" c:type="gboolean"/>
40477           </return-value>
40478           <parameters>
40479             <parameter name="vfs" transfer-ownership="none">
40480               <type name="Vfs" c:type="GVfs*"/>
40481             </parameter>
40482           </parameters>
40483         </callback>
40484       </field>
40485       <field name="get_file_for_path">
40486         <callback name="get_file_for_path">
40487           <return-value transfer-ownership="full">
40488             <doc xml:whitespace="preserve">a #GFile.</doc>
40489             <type name="File" c:type="GFile*"/>
40490           </return-value>
40491           <parameters>
40492             <parameter name="vfs" transfer-ownership="none">
40493               <type name="Vfs" c:type="GVfs*"/>
40494             </parameter>
40495             <parameter name="path" transfer-ownership="none">
40496               <doc xml:whitespace="preserve">a string containing a VFS path.</doc>
40497               <type name="utf8" c:type="char*"/>
40498             </parameter>
40499           </parameters>
40500         </callback>
40501       </field>
40502       <field name="get_file_for_uri">
40503         <callback name="get_file_for_uri">
40504           <return-value transfer-ownership="full">
40505             <doc xml:whitespace="preserve">a #GFile.</doc>
40506             <type name="File" c:type="GFile*"/>
40507           </return-value>
40508           <parameters>
40509             <parameter name="vfs" transfer-ownership="none">
40510               <type name="Vfs" c:type="GVfs*"/>
40511             </parameter>
40512             <parameter name="uri" transfer-ownership="none">
40513               <doc xml:whitespace="preserve">a string containing a URI</doc>
40514               <type name="utf8" c:type="char*"/>
40515             </parameter>
40516           </parameters>
40517         </callback>
40518       </field>
40519       <field name="get_supported_uri_schemes">
40520         <callback name="get_supported_uri_schemes">
40521           <return-value transfer-ownership="none">
40522             <doc xml:whitespace="preserve">a %NULL-terminated array of strings.</doc>
40523             <array c:type="gchar**">
40524               <type name="utf8"/>
40525             </array>
40526           </return-value>
40527           <parameters>
40528             <parameter name="vfs" transfer-ownership="none">
40529               <type name="Vfs" c:type="GVfs*"/>
40530             </parameter>
40531           </parameters>
40532         </callback>
40533       </field>
40534       <field name="parse_name">
40535         <callback name="parse_name">
40536           <return-value transfer-ownership="full">
40537             <doc xml:whitespace="preserve">a #GFile for the given @parse_name.</doc>
40538             <type name="File" c:type="GFile*"/>
40539           </return-value>
40540           <parameters>
40541             <parameter name="vfs" transfer-ownership="none">
40542               <type name="Vfs" c:type="GVfs*"/>
40543             </parameter>
40544             <parameter name="parse_name" transfer-ownership="none">
40545               <doc xml:whitespace="preserve">a string to be parsed by the VFS module.</doc>
40546               <type name="utf8" c:type="char*"/>
40547             </parameter>
40548           </parameters>
40549         </callback>
40550       </field>
40551       <field name="local_file_add_info">
40552         <callback name="local_file_add_info">
40553           <return-value transfer-ownership="none">
40554             <type name="none" c:type="void"/>
40555           </return-value>
40556           <parameters>
40557             <parameter name="vfs" transfer-ownership="none">
40558               <type name="Vfs" c:type="GVfs*"/>
40559             </parameter>
40560             <parameter name="filename" transfer-ownership="none">
40561               <type name="utf8" c:type="char*"/>
40562             </parameter>
40563             <parameter name="device" transfer-ownership="none">
40564               <type name="guint64" c:type="guint64"/>
40565             </parameter>
40566             <parameter name="attribute_matcher" transfer-ownership="none">
40567               <type name="FileAttributeMatcher"
40568                     c:type="GFileAttributeMatcher*"/>
40569             </parameter>
40570             <parameter name="info" transfer-ownership="none">
40571               <type name="FileInfo" c:type="GFileInfo*"/>
40572             </parameter>
40573             <parameter name="cancellable" transfer-ownership="none">
40574               <type name="Cancellable" c:type="GCancellable*"/>
40575             </parameter>
40576             <parameter name="extra_data" transfer-ownership="none">
40577               <type name="gpointer" c:type="gpointer*"/>
40578             </parameter>
40579             <parameter name="free_extra_data"
40580                        transfer-ownership="none"
40581                        scope="async">
40582               <type name="GLib.DestroyNotify" c:type="GDestroyNotify*"/>
40583             </parameter>
40584           </parameters>
40585         </callback>
40586       </field>
40587       <field name="add_writable_namespaces">
40588         <callback name="add_writable_namespaces">
40589           <return-value transfer-ownership="none">
40590             <type name="none" c:type="void"/>
40591           </return-value>
40592           <parameters>
40593             <parameter name="vfs" transfer-ownership="none">
40594               <type name="Vfs" c:type="GVfs*"/>
40595             </parameter>
40596             <parameter name="list" transfer-ownership="none">
40597               <type name="FileAttributeInfoList"
40598                     c:type="GFileAttributeInfoList*"/>
40599             </parameter>
40600           </parameters>
40601         </callback>
40602       </field>
40603       <field name="local_file_set_attributes">
40604         <callback name="local_file_set_attributes" throws="1">
40605           <return-value transfer-ownership="none">
40606             <type name="gboolean" c:type="gboolean"/>
40607           </return-value>
40608           <parameters>
40609             <parameter name="vfs" transfer-ownership="none">
40610               <type name="Vfs" c:type="GVfs*"/>
40611             </parameter>
40612             <parameter name="filename" transfer-ownership="none">
40613               <type name="utf8" c:type="char*"/>
40614             </parameter>
40615             <parameter name="info" transfer-ownership="none">
40616               <type name="FileInfo" c:type="GFileInfo*"/>
40617             </parameter>
40618             <parameter name="flags" transfer-ownership="none">
40619               <type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
40620             </parameter>
40621             <parameter name="cancellable" transfer-ownership="none">
40622               <type name="Cancellable" c:type="GCancellable*"/>
40623             </parameter>
40624           </parameters>
40625         </callback>
40626       </field>
40627       <field name="local_file_removed">
40628         <callback name="local_file_removed">
40629           <return-value transfer-ownership="none">
40630             <type name="none" c:type="void"/>
40631           </return-value>
40632           <parameters>
40633             <parameter name="vfs" transfer-ownership="none">
40634               <type name="Vfs" c:type="GVfs*"/>
40635             </parameter>
40636             <parameter name="filename" transfer-ownership="none">
40637               <type name="utf8" c:type="char*"/>
40638             </parameter>
40639           </parameters>
40640         </callback>
40641       </field>
40642       <field name="local_file_moved">
40643         <callback name="local_file_moved">
40644           <return-value transfer-ownership="none">
40645             <type name="none" c:type="void"/>
40646           </return-value>
40647           <parameters>
40648             <parameter name="vfs" transfer-ownership="none">
40649               <type name="Vfs" c:type="GVfs*"/>
40650             </parameter>
40651             <parameter name="source" transfer-ownership="none">
40652               <type name="utf8" c:type="char*"/>
40653             </parameter>
40654             <parameter name="dest" transfer-ownership="none">
40655               <type name="utf8" c:type="char*"/>
40656             </parameter>
40657           </parameters>
40658         </callback>
40659       </field>
40660       <field name="_g_reserved1" introspectable="0">
40661         <callback name="_g_reserved1">
40662           <return-value transfer-ownership="none">
40663             <type name="none" c:type="void"/>
40664           </return-value>
40665         </callback>
40666       </field>
40667       <field name="_g_reserved2" introspectable="0">
40668         <callback name="_g_reserved2">
40669           <return-value transfer-ownership="none">
40670             <type name="none" c:type="void"/>
40671           </return-value>
40672         </callback>
40673       </field>
40674       <field name="_g_reserved3" introspectable="0">
40675         <callback name="_g_reserved3">
40676           <return-value transfer-ownership="none">
40677             <type name="none" c:type="void"/>
40678           </return-value>
40679         </callback>
40680       </field>
40681       <field name="_g_reserved4" introspectable="0">
40682         <callback name="_g_reserved4">
40683           <return-value transfer-ownership="none">
40684             <type name="none" c:type="void"/>
40685           </return-value>
40686         </callback>
40687       </field>
40688       <field name="_g_reserved5" introspectable="0">
40689         <callback name="_g_reserved5">
40690           <return-value transfer-ownership="none">
40691             <type name="none" c:type="void"/>
40692           </return-value>
40693         </callback>
40694       </field>
40695       <field name="_g_reserved6" introspectable="0">
40696         <callback name="_g_reserved6">
40697           <return-value transfer-ownership="none">
40698             <type name="none" c:type="void"/>
40699           </return-value>
40700         </callback>
40701       </field>
40702       <field name="_g_reserved7" introspectable="0">
40703         <callback name="_g_reserved7">
40704           <return-value transfer-ownership="none">
40705             <type name="none" c:type="void"/>
40706           </return-value>
40707         </callback>
40708       </field>
40709     </record>
40710     <interface name="Volume"
40711                c:symbol-prefix="volume"
40712                c:type="GVolume"
40713                glib:type-name="GVolume"
40714                glib:get-type="g_volume_get_type"
40715                glib:type-struct="VolumeIface">
40716       <doc xml:whitespace="preserve">Opaque mountable volume object.</doc>
40717       <virtual-method name="can_eject" invoker="can_eject">
40718         <doc xml:whitespace="preserve">Checks if a volume can be ejected.</doc>
40719         <return-value transfer-ownership="none">
40720           <doc xml:whitespace="preserve">%TRUE if the @volume can be ejected. %FALSE otherwise.</doc>
40721           <type name="gboolean" c:type="gboolean"/>
40722         </return-value>
40723       </virtual-method>
40724       <virtual-method name="can_mount" invoker="can_mount">
40725         <doc xml:whitespace="preserve">Checks if a volume can be mounted.</doc>
40726         <return-value transfer-ownership="none">
40727           <doc xml:whitespace="preserve">%TRUE if the @volume can be mounted. %FALSE otherwise.</doc>
40728           <type name="gboolean" c:type="gboolean"/>
40729         </return-value>
40730       </virtual-method>
40731       <virtual-method name="eject"
40732                       invoker="eject"
40733                       deprecated="Use g_volume_eject_with_operation() instead."
40734                       deprecated-version="2.22">
40735         <doc xml:whitespace="preserve">Ejects a volume. This is an asynchronous operation, and is
40736 finished by calling g_volume_eject_finish() with the @volume
40737 and #GAsyncResult returned in the @callback.</doc>
40738         <return-value transfer-ownership="none">
40739           <type name="none" c:type="void"/>
40740         </return-value>
40741         <parameters>
40742           <parameter name="flags" transfer-ownership="none">
40743             <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
40744             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
40745           </parameter>
40746           <parameter name="cancellable"
40747                      transfer-ownership="none"
40748                      allow-none="1">
40749             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
40750             <type name="Cancellable" c:type="GCancellable*"/>
40751           </parameter>
40752           <parameter name="callback"
40753                      transfer-ownership="none"
40754                      scope="async"
40755                      closure="3">
40756             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
40757             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
40758           </parameter>
40759           <parameter name="user_data" transfer-ownership="none" closure="3">
40760             <doc xml:whitespace="preserve">user data that gets passed to @callback</doc>
40761             <type name="gpointer" c:type="gpointer"/>
40762           </parameter>
40763         </parameters>
40764       </virtual-method>
40765       <virtual-method name="eject_finish"
40766                       invoker="eject_finish"
40767                       deprecated="Use g_volume_eject_with_operation_finish() instead."
40768                       deprecated-version="2.22"
40769                       throws="1">
40770         <doc xml:whitespace="preserve">Finishes ejecting a volume. If any errors occured during the operation,</doc>
40771         <return-value transfer-ownership="none">
40772           <doc xml:whitespace="preserve">%TRUE, %FALSE if operation failed.</doc>
40773           <type name="gboolean" c:type="gboolean"/>
40774         </return-value>
40775         <parameters>
40776           <parameter name="result" transfer-ownership="none">
40777             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
40778             <type name="AsyncResult" c:type="GAsyncResult*"/>
40779           </parameter>
40780         </parameters>
40781       </virtual-method>
40782       <virtual-method name="eject_with_operation"
40783                       invoker="eject_with_operation"
40784                       version="2.22">
40785         <doc xml:whitespace="preserve">Ejects a volume. This is an asynchronous operation, and is
40786 finished by calling g_volume_eject_with_operation_finish() with the @volume
40787 and #GAsyncResult data returned in the @callback.</doc>
40788         <return-value transfer-ownership="none">
40789           <type name="none" c:type="void"/>
40790         </return-value>
40791         <parameters>
40792           <parameter name="flags" transfer-ownership="none">
40793             <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
40794             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
40795           </parameter>
40796           <parameter name="mount_operation" transfer-ownership="none">
40797             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
40798             <type name="MountOperation" c:type="GMountOperation*"/>
40799           </parameter>
40800           <parameter name="cancellable"
40801                      transfer-ownership="none"
40802                      allow-none="1">
40803             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
40804             <type name="Cancellable" c:type="GCancellable*"/>
40805           </parameter>
40806           <parameter name="callback"
40807                      transfer-ownership="none"
40808                      scope="async"
40809                      closure="4">
40810             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
40811             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
40812           </parameter>
40813           <parameter name="user_data" transfer-ownership="none" closure="4">
40814             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
40815             <type name="gpointer" c:type="gpointer"/>
40816           </parameter>
40817         </parameters>
40818       </virtual-method>
40819       <virtual-method name="eject_with_operation_finish"
40820                       invoker="eject_with_operation_finish"
40821                       version="2.22"
40822                       throws="1">
40823         <doc xml:whitespace="preserve">Finishes ejecting a volume. If any errors occurred during the operation,</doc>
40824         <return-value transfer-ownership="none">
40825           <doc xml:whitespace="preserve">%TRUE if the volume was successfully ejected. %FALSE otherwise.</doc>
40826           <type name="gboolean" c:type="gboolean"/>
40827         </return-value>
40828         <parameters>
40829           <parameter name="result" transfer-ownership="none">
40830             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
40831             <type name="AsyncResult" c:type="GAsyncResult*"/>
40832           </parameter>
40833         </parameters>
40834       </virtual-method>
40835       <virtual-method name="enumerate_identifiers"
40836                       invoker="enumerate_identifiers">
40837         <doc xml:whitespace="preserve">Gets the kinds of &lt;link linkend="volume-identifier"&gt;identifiers&lt;/link&gt;
40838 that @volume has. Use g_volume_get_identifer() to obtain
40839 the identifiers themselves.
40840 of strings containing kinds of identifiers. Use g_strfreev() to free.</doc>
40841         <return-value transfer-ownership="full">
40842           <doc xml:whitespace="preserve">a %NULL-terminated array</doc>
40843           <array c:type="char**">
40844             <type name="utf8"/>
40845           </array>
40846         </return-value>
40847       </virtual-method>
40848       <virtual-method name="get_activation_root"
40849                       invoker="get_activation_root"
40850                       version="2.18">
40851         <doc xml:whitespace="preserve">Gets the activation root for a #GVolume if it is known ahead of
40852 mount time. Returns %NULL otherwise. If not %NULL and if @volume
40853 is mounted, then the result of g_mount_get_root() on the
40854 #GMount object obtained from g_volume_get_mount() will always
40855 either be equal or a prefix of what this function returns. In
40856 other words, in code
40857 &lt;programlisting&gt;
40858 GMount *mount;
40859 GFile *mount_root
40860 GFile *volume_activation_root;
40861 mount = g_volume_get_mount (volume); /&amp;ast; mounted, so never NULL &amp;ast;/
40862 mount_root = g_mount_get_root (mount);
40863 volume_activation_root = g_volume_get_activation_root(volume); /&amp;ast; assume not NULL &amp;ast;/
40864 &lt;/programlisting&gt;
40865 then the expression
40866 &lt;programlisting&gt;
40867 (g_file_has_prefix (volume_activation_root, mount_root) ||
40868 &lt;/programlisting&gt;
40869 will always be %TRUE.
40870 Activation roots are typically used in #GVolumeMonitor
40871 implementations to find the underlying mount to shadow, see
40872 g_mount_is_shadowed() for more details.
40873 g_object_unref() to free.</doc>
40874         <return-value transfer-ownership="full">
40875           <doc xml:whitespace="preserve">the activation root of @volume or %NULL. Use</doc>
40876           <type name="File" c:type="GFile*"/>
40877         </return-value>
40878       </virtual-method>
40879       <virtual-method name="get_drive" invoker="get_drive">
40880         <doc xml:whitespace="preserve">Gets the drive for the @volume.
40881 The returned object should be unreffed with g_object_unref()
40882 when no longer needed.</doc>
40883         <return-value transfer-ownership="full">
40884           <doc xml:whitespace="preserve">a #GDrive or %NULL if @volume is not associated with a drive.</doc>
40885           <type name="Drive" c:type="GDrive*"/>
40886         </return-value>
40887       </virtual-method>
40888       <virtual-method name="get_icon" invoker="get_icon">
40889         <doc xml:whitespace="preserve">Gets the icon for @volume.
40890 The returned object should be unreffed with g_object_unref()
40891 when no longer needed.</doc>
40892         <return-value transfer-ownership="full">
40893           <doc xml:whitespace="preserve">a #GIcon.</doc>
40894           <type name="Icon" c:type="GIcon*"/>
40895         </return-value>
40896       </virtual-method>
40897       <virtual-method name="get_identifier" invoker="get_identifier">
40898         <doc xml:whitespace="preserve">Gets the identifier of the given kind for @volume.
40899 See the &lt;link linkend="volume-identifier"&gt;introduction&lt;/link&gt;
40900 for more information about volume identifiers.
40901 requested identfier, or %NULL if the #GVolume
40902 doesn't have this kind of identifier</doc>
40903         <return-value transfer-ownership="full">
40904           <doc xml:whitespace="preserve">a newly allocated string containing the</doc>
40905           <type name="utf8" c:type="char*"/>
40906         </return-value>
40907         <parameters>
40908           <parameter name="kind" transfer-ownership="none">
40909             <doc xml:whitespace="preserve">the kind of identifier to return</doc>
40910             <type name="utf8" c:type="char*"/>
40911           </parameter>
40912         </parameters>
40913       </virtual-method>
40914       <virtual-method name="get_mount" invoker="get_mount">
40915         <doc xml:whitespace="preserve">Gets the mount for the @volume.
40916 The returned object should be unreffed with g_object_unref()
40917 when no longer needed.</doc>
40918         <return-value transfer-ownership="full">
40919           <doc xml:whitespace="preserve">a #GMount or %NULL if @volume isn't mounted.</doc>
40920           <type name="Mount" c:type="GMount*"/>
40921         </return-value>
40922       </virtual-method>
40923       <virtual-method name="get_name" invoker="get_name">
40924         <doc xml:whitespace="preserve">Gets the name of @volume.
40925 be freed with g_free() when no longer needed.</doc>
40926         <return-value transfer-ownership="full">
40927           <doc xml:whitespace="preserve">the name for the given @volume. The returned string should</doc>
40928           <type name="utf8" c:type="char*"/>
40929         </return-value>
40930       </virtual-method>
40931       <virtual-method name="get_uuid" invoker="get_uuid">
40932         <doc xml:whitespace="preserve">Gets the UUID for the @volume. The reference is typically based on
40933 the file system UUID for the volume in question and should be
40934 considered an opaque string. Returns %NULL if there is no UUID
40935 available.
40936 The returned string should be freed with g_free()
40937 when no longer needed.</doc>
40938         <return-value transfer-ownership="full">
40939           <doc xml:whitespace="preserve">the UUID for @volume or %NULL if no UUID can be computed.</doc>
40940           <type name="utf8" c:type="char*"/>
40941         </return-value>
40942       </virtual-method>
40943       <virtual-method name="mount_finish" invoker="mount_finish" throws="1">
40944         <doc xml:whitespace="preserve">Finishes mounting a volume. If any errors occured during the operation,
40945 If the mount operation succeeded, g_volume_get_mount() on @volume
40946 is guaranteed to return the mount right after calling this
40947 function; there's no need to listen for the 'mount-added' signal on
40948 #GVolumeMonitor.</doc>
40949         <return-value transfer-ownership="none">
40950           <doc xml:whitespace="preserve">%TRUE, %FALSE if operation failed.</doc>
40951           <type name="gboolean" c:type="gboolean"/>
40952         </return-value>
40953         <parameters>
40954           <parameter name="result" transfer-ownership="none">
40955             <doc xml:whitespace="preserve">a #GAsyncResult</doc>
40956             <type name="AsyncResult" c:type="GAsyncResult*"/>
40957           </parameter>
40958         </parameters>
40959       </virtual-method>
40960       <virtual-method name="mount_fn" invoker="mount">
40961         <doc xml:whitespace="preserve">Mounts a volume. This is an asynchronous operation, and is
40962 finished by calling g_volume_mount_finish() with the @volume
40963 and #GAsyncResult returned in the @callback.</doc>
40964         <return-value transfer-ownership="none">
40965           <type name="none" c:type="void"/>
40966         </return-value>
40967         <parameters>
40968           <parameter name="flags" transfer-ownership="none">
40969             <doc xml:whitespace="preserve">flags affecting the operation</doc>
40970             <type name="MountMountFlags" c:type="GMountMountFlags"/>
40971           </parameter>
40972           <parameter name="mount_operation"
40973                      transfer-ownership="none"
40974                      allow-none="1">
40975             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
40976             <type name="MountOperation" c:type="GMountOperation*"/>
40977           </parameter>
40978           <parameter name="cancellable"
40979                      transfer-ownership="none"
40980                      allow-none="1">
40981             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
40982             <type name="Cancellable" c:type="GCancellable*"/>
40983           </parameter>
40984           <parameter name="callback"
40985                      transfer-ownership="none"
40986                      scope="async"
40987                      closure="4">
40988             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
40989             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
40990           </parameter>
40991           <parameter name="user_data" transfer-ownership="none" closure="4">
40992             <doc xml:whitespace="preserve">user data that gets passed to @callback</doc>
40993             <type name="gpointer" c:type="gpointer"/>
40994           </parameter>
40995         </parameters>
40996       </virtual-method>
40997       <virtual-method name="should_automount" invoker="should_automount">
40998         <doc xml:whitespace="preserve">Returns whether the volume should be automatically mounted.</doc>
40999         <return-value transfer-ownership="none">
41000           <doc xml:whitespace="preserve">%TRUE if the volume should be automatically mounted.</doc>
41001           <type name="gboolean" c:type="gboolean"/>
41002         </return-value>
41003       </virtual-method>
41004       <method name="can_eject" c:identifier="g_volume_can_eject">
41005         <doc xml:whitespace="preserve">Checks if a volume can be ejected.</doc>
41006         <return-value transfer-ownership="none">
41007           <doc xml:whitespace="preserve">%TRUE if the @volume can be ejected. %FALSE otherwise.</doc>
41008           <type name="gboolean" c:type="gboolean"/>
41009         </return-value>
41010       </method>
41011       <method name="can_mount" c:identifier="g_volume_can_mount">
41012         <doc xml:whitespace="preserve">Checks if a volume can be mounted.</doc>
41013         <return-value transfer-ownership="none">
41014           <doc xml:whitespace="preserve">%TRUE if the @volume can be mounted. %FALSE otherwise.</doc>
41015           <type name="gboolean" c:type="gboolean"/>
41016         </return-value>
41017       </method>
41018       <method name="eject"
41019               c:identifier="g_volume_eject"
41020               deprecated="Use g_volume_eject_with_operation() instead."
41021               deprecated-version="2.22">
41022         <doc xml:whitespace="preserve">Ejects a volume. This is an asynchronous operation, and is
41023 finished by calling g_volume_eject_finish() with the @volume
41024 and #GAsyncResult returned in the @callback.</doc>
41025         <return-value transfer-ownership="none">
41026           <type name="none" c:type="void"/>
41027         </return-value>
41028         <parameters>
41029           <parameter name="flags" transfer-ownership="none">
41030             <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
41031             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
41032           </parameter>
41033           <parameter name="cancellable"
41034                      transfer-ownership="none"
41035                      allow-none="1">
41036             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
41037             <type name="Cancellable" c:type="GCancellable*"/>
41038           </parameter>
41039           <parameter name="callback"
41040                      transfer-ownership="none"
41041                      scope="async"
41042                      closure="3">
41043             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
41044             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
41045           </parameter>
41046           <parameter name="user_data" transfer-ownership="none">
41047             <doc xml:whitespace="preserve">user data that gets passed to @callback</doc>
41048             <type name="gpointer" c:type="gpointer"/>
41049           </parameter>
41050         </parameters>
41051       </method>
41052       <method name="eject_finish"
41053               c:identifier="g_volume_eject_finish"
41054               deprecated="Use g_volume_eject_with_operation_finish() instead."
41055               deprecated-version="2.22"
41056               throws="1">
41057         <doc xml:whitespace="preserve">Finishes ejecting a volume. If any errors occured during the operation,</doc>
41058         <return-value transfer-ownership="none">
41059           <doc xml:whitespace="preserve">%TRUE, %FALSE if operation failed.</doc>
41060           <type name="gboolean" c:type="gboolean"/>
41061         </return-value>
41062         <parameters>
41063           <parameter name="result" transfer-ownership="none">
41064             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
41065             <type name="AsyncResult" c:type="GAsyncResult*"/>
41066           </parameter>
41067         </parameters>
41068       </method>
41069       <method name="eject_with_operation"
41070               c:identifier="g_volume_eject_with_operation"
41071               version="2.22">
41072         <doc xml:whitespace="preserve">Ejects a volume. This is an asynchronous operation, and is
41073 finished by calling g_volume_eject_with_operation_finish() with the @volume
41074 and #GAsyncResult data returned in the @callback.</doc>
41075         <return-value transfer-ownership="none">
41076           <type name="none" c:type="void"/>
41077         </return-value>
41078         <parameters>
41079           <parameter name="flags" transfer-ownership="none">
41080             <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
41081             <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
41082           </parameter>
41083           <parameter name="mount_operation" transfer-ownership="none">
41084             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
41085             <type name="MountOperation" c:type="GMountOperation*"/>
41086           </parameter>
41087           <parameter name="cancellable"
41088                      transfer-ownership="none"
41089                      allow-none="1">
41090             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
41091             <type name="Cancellable" c:type="GCancellable*"/>
41092           </parameter>
41093           <parameter name="callback"
41094                      transfer-ownership="none"
41095                      scope="async"
41096                      closure="4">
41097             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
41098             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
41099           </parameter>
41100           <parameter name="user_data" transfer-ownership="none">
41101             <doc xml:whitespace="preserve">user data passed to @callback.</doc>
41102             <type name="gpointer" c:type="gpointer"/>
41103           </parameter>
41104         </parameters>
41105       </method>
41106       <method name="eject_with_operation_finish"
41107               c:identifier="g_volume_eject_with_operation_finish"
41108               version="2.22"
41109               throws="1">
41110         <doc xml:whitespace="preserve">Finishes ejecting a volume. If any errors occurred during the operation,</doc>
41111         <return-value transfer-ownership="none">
41112           <doc xml:whitespace="preserve">%TRUE if the volume was successfully ejected. %FALSE otherwise.</doc>
41113           <type name="gboolean" c:type="gboolean"/>
41114         </return-value>
41115         <parameters>
41116           <parameter name="result" transfer-ownership="none">
41117             <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
41118             <type name="AsyncResult" c:type="GAsyncResult*"/>
41119           </parameter>
41120         </parameters>
41121       </method>
41122       <method name="enumerate_identifiers"
41123               c:identifier="g_volume_enumerate_identifiers">
41124         <doc xml:whitespace="preserve">Gets the kinds of &lt;link linkend="volume-identifier"&gt;identifiers&lt;/link&gt;
41125 that @volume has. Use g_volume_get_identifer() to obtain
41126 the identifiers themselves.
41127 of strings containing kinds of identifiers. Use g_strfreev() to free.</doc>
41128         <return-value transfer-ownership="full">
41129           <doc xml:whitespace="preserve">a %NULL-terminated array</doc>
41130           <array c:type="char**">
41131             <type name="utf8"/>
41132           </array>
41133         </return-value>
41134       </method>
41135       <method name="get_activation_root"
41136               c:identifier="g_volume_get_activation_root"
41137               version="2.18">
41138         <doc xml:whitespace="preserve">Gets the activation root for a #GVolume if it is known ahead of
41139 mount time. Returns %NULL otherwise. If not %NULL and if @volume
41140 is mounted, then the result of g_mount_get_root() on the
41141 #GMount object obtained from g_volume_get_mount() will always
41142 either be equal or a prefix of what this function returns. In
41143 other words, in code
41144 &lt;programlisting&gt;
41145 GMount *mount;
41146 GFile *mount_root
41147 GFile *volume_activation_root;
41148 mount = g_volume_get_mount (volume); /&amp;ast; mounted, so never NULL &amp;ast;/
41149 mount_root = g_mount_get_root (mount);
41150 volume_activation_root = g_volume_get_activation_root(volume); /&amp;ast; assume not NULL &amp;ast;/
41151 &lt;/programlisting&gt;
41152 then the expression
41153 &lt;programlisting&gt;
41154 (g_file_has_prefix (volume_activation_root, mount_root) ||
41155 &lt;/programlisting&gt;
41156 will always be %TRUE.
41157 Activation roots are typically used in #GVolumeMonitor
41158 implementations to find the underlying mount to shadow, see
41159 g_mount_is_shadowed() for more details.
41160 g_object_unref() to free.</doc>
41161         <return-value transfer-ownership="full">
41162           <doc xml:whitespace="preserve">the activation root of @volume or %NULL. Use</doc>
41163           <type name="File" c:type="GFile*"/>
41164         </return-value>
41165       </method>
41166       <method name="get_drive" c:identifier="g_volume_get_drive">
41167         <doc xml:whitespace="preserve">Gets the drive for the @volume.
41168 The returned object should be unreffed with g_object_unref()
41169 when no longer needed.</doc>
41170         <return-value transfer-ownership="full">
41171           <doc xml:whitespace="preserve">a #GDrive or %NULL if @volume is not associated with a drive.</doc>
41172           <type name="Drive" c:type="GDrive*"/>
41173         </return-value>
41174       </method>
41175       <method name="get_icon" c:identifier="g_volume_get_icon">
41176         <doc xml:whitespace="preserve">Gets the icon for @volume.
41177 The returned object should be unreffed with g_object_unref()
41178 when no longer needed.</doc>
41179         <return-value transfer-ownership="full">
41180           <doc xml:whitespace="preserve">a #GIcon.</doc>
41181           <type name="Icon" c:type="GIcon*"/>
41182         </return-value>
41183       </method>
41184       <method name="get_identifier" c:identifier="g_volume_get_identifier">
41185         <doc xml:whitespace="preserve">Gets the identifier of the given kind for @volume.
41186 See the &lt;link linkend="volume-identifier"&gt;introduction&lt;/link&gt;
41187 for more information about volume identifiers.
41188 requested identfier, or %NULL if the #GVolume
41189 doesn't have this kind of identifier</doc>
41190         <return-value transfer-ownership="full">
41191           <doc xml:whitespace="preserve">a newly allocated string containing the</doc>
41192           <type name="utf8" c:type="char*"/>
41193         </return-value>
41194         <parameters>
41195           <parameter name="kind" transfer-ownership="none">
41196             <doc xml:whitespace="preserve">the kind of identifier to return</doc>
41197             <type name="utf8" c:type="char*"/>
41198           </parameter>
41199         </parameters>
41200       </method>
41201       <method name="get_mount" c:identifier="g_volume_get_mount">
41202         <doc xml:whitespace="preserve">Gets the mount for the @volume.
41203 The returned object should be unreffed with g_object_unref()
41204 when no longer needed.</doc>
41205         <return-value transfer-ownership="full">
41206           <doc xml:whitespace="preserve">a #GMount or %NULL if @volume isn't mounted.</doc>
41207           <type name="Mount" c:type="GMount*"/>
41208         </return-value>
41209       </method>
41210       <method name="get_name" c:identifier="g_volume_get_name">
41211         <doc xml:whitespace="preserve">Gets the name of @volume.
41212 be freed with g_free() when no longer needed.</doc>
41213         <return-value transfer-ownership="full">
41214           <doc xml:whitespace="preserve">the name for the given @volume. The returned string should</doc>
41215           <type name="utf8" c:type="char*"/>
41216         </return-value>
41217       </method>
41218       <method name="get_uuid" c:identifier="g_volume_get_uuid">
41219         <doc xml:whitespace="preserve">Gets the UUID for the @volume. The reference is typically based on
41220 the file system UUID for the volume in question and should be
41221 considered an opaque string. Returns %NULL if there is no UUID
41222 available.
41223 The returned string should be freed with g_free()
41224 when no longer needed.</doc>
41225         <return-value transfer-ownership="full">
41226           <doc xml:whitespace="preserve">the UUID for @volume or %NULL if no UUID can be computed.</doc>
41227           <type name="utf8" c:type="char*"/>
41228         </return-value>
41229       </method>
41230       <method name="mount" c:identifier="g_volume_mount">
41231         <doc xml:whitespace="preserve">Mounts a volume. This is an asynchronous operation, and is
41232 finished by calling g_volume_mount_finish() with the @volume
41233 and #GAsyncResult returned in the @callback.</doc>
41234         <return-value transfer-ownership="none">
41235           <type name="none" c:type="void"/>
41236         </return-value>
41237         <parameters>
41238           <parameter name="flags" transfer-ownership="none">
41239             <doc xml:whitespace="preserve">flags affecting the operation</doc>
41240             <type name="MountMountFlags" c:type="GMountMountFlags"/>
41241           </parameter>
41242           <parameter name="mount_operation"
41243                      transfer-ownership="none"
41244                      allow-none="1">
41245             <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
41246             <type name="MountOperation" c:type="GMountOperation*"/>
41247           </parameter>
41248           <parameter name="cancellable"
41249                      transfer-ownership="none"
41250                      allow-none="1">
41251             <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
41252             <type name="Cancellable" c:type="GCancellable*"/>
41253           </parameter>
41254           <parameter name="callback"
41255                      transfer-ownership="none"
41256                      scope="async"
41257                      closure="4">
41258             <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
41259             <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
41260           </parameter>
41261           <parameter name="user_data" transfer-ownership="none">
41262             <doc xml:whitespace="preserve">user data that gets passed to @callback</doc>
41263             <type name="gpointer" c:type="gpointer"/>
41264           </parameter>
41265         </parameters>
41266       </method>
41267       <method name="mount_finish"
41268               c:identifier="g_volume_mount_finish"
41269               throws="1">
41270         <doc xml:whitespace="preserve">Finishes mounting a volume. If any errors occured during the operation,
41271 If the mount operation succeeded, g_volume_get_mount() on @volume
41272 is guaranteed to return the mount right after calling this
41273 function; there's no need to listen for the 'mount-added' signal on
41274 #GVolumeMonitor.</doc>
41275         <return-value transfer-ownership="none">
41276           <doc xml:whitespace="preserve">%TRUE, %FALSE if operation failed.</doc>
41277           <type name="gboolean" c:type="gboolean"/>
41278         </return-value>
41279         <parameters>
41280           <parameter name="result" transfer-ownership="none">
41281             <doc xml:whitespace="preserve">a #GAsyncResult</doc>
41282             <type name="AsyncResult" c:type="GAsyncResult*"/>
41283           </parameter>
41284         </parameters>
41285       </method>
41286       <method name="should_automount" c:identifier="g_volume_should_automount">
41287         <doc xml:whitespace="preserve">Returns whether the volume should be automatically mounted.</doc>
41288         <return-value transfer-ownership="none">
41289           <doc xml:whitespace="preserve">%TRUE if the volume should be automatically mounted.</doc>
41290           <type name="gboolean" c:type="gboolean"/>
41291         </return-value>
41292       </method>
41293       <glib:signal name="changed">
41294         <doc xml:whitespace="preserve">Emitted when the volume has been changed.</doc>
41295         <return-value transfer-ownership="none">
41296           <type name="none"/>
41297         </return-value>
41298       </glib:signal>
41299       <glib:signal name="removed">
41300         <doc xml:whitespace="preserve">This signal is emitted when the #GVolume have been removed. If
41301 the recipient is holding references to the object they should
41302 release them so the object can be finalized.</doc>
41303         <return-value transfer-ownership="none">
41304           <type name="none"/>
41305         </return-value>
41306       </glib:signal>
41307     </interface>
41308     <record name="VolumeIface"
41309             c:type="GVolumeIface"
41310             glib:is-gtype-struct-for="Volume">
41311       <doc xml:whitespace="preserve">Interface for implementing operations for mountable volumes.</doc>
41312       <field name="g_iface">
41313         <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
41314       </field>
41315       <field name="changed">
41316         <callback name="changed">
41317           <return-value transfer-ownership="none">
41318             <type name="none" c:type="void"/>
41319           </return-value>
41320           <parameters>
41321             <parameter name="volume" transfer-ownership="none">
41322               <type name="Volume" c:type="GVolume*"/>
41323             </parameter>
41324           </parameters>
41325         </callback>
41326       </field>
41327       <field name="removed">
41328         <callback name="removed">
41329           <return-value transfer-ownership="none">
41330             <type name="none" c:type="void"/>
41331           </return-value>
41332           <parameters>
41333             <parameter name="volume" transfer-ownership="none">
41334               <type name="Volume" c:type="GVolume*"/>
41335             </parameter>
41336           </parameters>
41337         </callback>
41338       </field>
41339       <field name="get_name">
41340         <callback name="get_name">
41341           <return-value transfer-ownership="full">
41342             <doc xml:whitespace="preserve">the name for the given @volume. The returned string should</doc>
41343             <type name="utf8" c:type="char*"/>
41344           </return-value>
41345           <parameters>
41346             <parameter name="volume" transfer-ownership="none">
41347               <type name="Volume" c:type="GVolume*"/>
41348             </parameter>
41349           </parameters>
41350         </callback>
41351       </field>
41352       <field name="get_icon">
41353         <callback name="get_icon">
41354           <return-value transfer-ownership="full">
41355             <doc xml:whitespace="preserve">a #GIcon.</doc>
41356             <type name="Icon" c:type="GIcon*"/>
41357           </return-value>
41358           <parameters>
41359             <parameter name="volume" transfer-ownership="none">
41360               <type name="Volume" c:type="GVolume*"/>
41361             </parameter>
41362           </parameters>
41363         </callback>
41364       </field>
41365       <field name="get_uuid">
41366         <callback name="get_uuid">
41367           <return-value transfer-ownership="full">
41368             <doc xml:whitespace="preserve">the UUID for @volume or %NULL if no UUID can be computed.</doc>
41369             <type name="utf8" c:type="char*"/>
41370           </return-value>
41371           <parameters>
41372             <parameter name="volume" transfer-ownership="none">
41373               <type name="Volume" c:type="GVolume*"/>
41374             </parameter>
41375           </parameters>
41376         </callback>
41377       </field>
41378       <field name="get_drive">
41379         <callback name="get_drive">
41380           <return-value transfer-ownership="full">
41381             <doc xml:whitespace="preserve">a #GDrive or %NULL if @volume is not associated with a drive.</doc>
41382             <type name="Drive" c:type="GDrive*"/>
41383           </return-value>
41384           <parameters>
41385             <parameter name="volume" transfer-ownership="none">
41386               <type name="Volume" c:type="GVolume*"/>
41387             </parameter>
41388           </parameters>
41389         </callback>
41390       </field>
41391       <field name="get_mount">
41392         <callback name="get_mount">
41393           <return-value transfer-ownership="full">
41394             <doc xml:whitespace="preserve">a #GMount or %NULL if @volume isn't mounted.</doc>
41395             <type name="Mount" c:type="GMount*"/>
41396           </return-value>
41397           <parameters>
41398             <parameter name="volume" transfer-ownership="none">
41399               <type name="Volume" c:type="GVolume*"/>
41400             </parameter>
41401           </parameters>
41402         </callback>
41403       </field>
41404       <field name="can_mount">
41405         <callback name="can_mount">
41406           <return-value transfer-ownership="none">
41407             <doc xml:whitespace="preserve">%TRUE if the @volume can be mounted. %FALSE otherwise.</doc>
41408             <type name="gboolean" c:type="gboolean"/>
41409           </return-value>
41410           <parameters>
41411             <parameter name="volume" transfer-ownership="none">
41412               <type name="Volume" c:type="GVolume*"/>
41413             </parameter>
41414           </parameters>
41415         </callback>
41416       </field>
41417       <field name="can_eject">
41418         <callback name="can_eject">
41419           <return-value transfer-ownership="none">
41420             <doc xml:whitespace="preserve">%TRUE if the @volume can be ejected. %FALSE otherwise.</doc>
41421             <type name="gboolean" c:type="gboolean"/>
41422           </return-value>
41423           <parameters>
41424             <parameter name="volume" transfer-ownership="none">
41425               <type name="Volume" c:type="GVolume*"/>
41426             </parameter>
41427           </parameters>
41428         </callback>
41429       </field>
41430       <field name="mount_fn">
41431         <callback name="mount_fn">
41432           <return-value transfer-ownership="none">
41433             <type name="none" c:type="void"/>
41434           </return-value>
41435           <parameters>
41436             <parameter name="volume" transfer-ownership="none">
41437               <type name="Volume" c:type="GVolume*"/>
41438             </parameter>
41439             <parameter name="flags" transfer-ownership="none">
41440               <doc xml:whitespace="preserve">flags affecting the operation</doc>
41441               <type name="MountMountFlags" c:type="GMountMountFlags"/>
41442             </parameter>
41443             <parameter name="mount_operation"
41444                        transfer-ownership="none"
41445                        allow-none="1">
41446               <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
41447               <type name="MountOperation" c:type="GMountOperation*"/>
41448             </parameter>
41449             <parameter name="cancellable"
41450                        transfer-ownership="none"
41451                        allow-none="1">
41452               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
41453               <type name="Cancellable" c:type="GCancellable*"/>
41454             </parameter>
41455             <parameter name="callback"
41456                        transfer-ownership="none"
41457                        scope="async"
41458                        closure="5">
41459               <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
41460               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
41461             </parameter>
41462             <parameter name="user_data" transfer-ownership="none" closure="5">
41463               <doc xml:whitespace="preserve">user data that gets passed to @callback</doc>
41464               <type name="gpointer" c:type="gpointer"/>
41465             </parameter>
41466           </parameters>
41467         </callback>
41468       </field>
41469       <field name="mount_finish">
41470         <callback name="mount_finish" throws="1">
41471           <return-value transfer-ownership="none">
41472             <doc xml:whitespace="preserve">%TRUE, %FALSE if operation failed.</doc>
41473             <type name="gboolean" c:type="gboolean"/>
41474           </return-value>
41475           <parameters>
41476             <parameter name="volume" transfer-ownership="none">
41477               <type name="Volume" c:type="GVolume*"/>
41478             </parameter>
41479             <parameter name="result" transfer-ownership="none">
41480               <doc xml:whitespace="preserve">a #GAsyncResult</doc>
41481               <type name="AsyncResult" c:type="GAsyncResult*"/>
41482             </parameter>
41483           </parameters>
41484         </callback>
41485       </field>
41486       <field name="eject">
41487         <callback name="eject">
41488           <return-value transfer-ownership="none">
41489             <type name="none" c:type="void"/>
41490           </return-value>
41491           <parameters>
41492             <parameter name="volume" transfer-ownership="none">
41493               <type name="Volume" c:type="GVolume*"/>
41494             </parameter>
41495             <parameter name="flags" transfer-ownership="none">
41496               <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
41497               <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
41498             </parameter>
41499             <parameter name="cancellable"
41500                        transfer-ownership="none"
41501                        allow-none="1">
41502               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
41503               <type name="Cancellable" c:type="GCancellable*"/>
41504             </parameter>
41505             <parameter name="callback"
41506                        transfer-ownership="none"
41507                        scope="async"
41508                        closure="4">
41509               <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
41510               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
41511             </parameter>
41512             <parameter name="user_data" transfer-ownership="none" closure="4">
41513               <doc xml:whitespace="preserve">user data that gets passed to @callback</doc>
41514               <type name="gpointer" c:type="gpointer"/>
41515             </parameter>
41516           </parameters>
41517         </callback>
41518       </field>
41519       <field name="eject_finish">
41520         <callback name="eject_finish" throws="1">
41521           <return-value transfer-ownership="none">
41522             <doc xml:whitespace="preserve">%TRUE, %FALSE if operation failed.</doc>
41523             <type name="gboolean" c:type="gboolean"/>
41524           </return-value>
41525           <parameters>
41526             <parameter name="volume" transfer-ownership="none">
41527               <type name="Volume" c:type="GVolume*"/>
41528             </parameter>
41529             <parameter name="result" transfer-ownership="none">
41530               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
41531               <type name="AsyncResult" c:type="GAsyncResult*"/>
41532             </parameter>
41533           </parameters>
41534         </callback>
41535       </field>
41536       <field name="get_identifier">
41537         <callback name="get_identifier">
41538           <return-value transfer-ownership="full">
41539             <doc xml:whitespace="preserve">a newly allocated string containing the</doc>
41540             <type name="utf8" c:type="char*"/>
41541           </return-value>
41542           <parameters>
41543             <parameter name="volume" transfer-ownership="none">
41544               <type name="Volume" c:type="GVolume*"/>
41545             </parameter>
41546             <parameter name="kind" transfer-ownership="none">
41547               <doc xml:whitespace="preserve">the kind of identifier to return</doc>
41548               <type name="utf8" c:type="char*"/>
41549             </parameter>
41550           </parameters>
41551         </callback>
41552       </field>
41553       <field name="enumerate_identifiers">
41554         <callback name="enumerate_identifiers">
41555           <return-value transfer-ownership="full">
41556             <doc xml:whitespace="preserve">a %NULL-terminated array</doc>
41557             <array c:type="char**">
41558               <type name="utf8"/>
41559             </array>
41560           </return-value>
41561           <parameters>
41562             <parameter name="volume" transfer-ownership="none">
41563               <type name="Volume" c:type="GVolume*"/>
41564             </parameter>
41565           </parameters>
41566         </callback>
41567       </field>
41568       <field name="should_automount">
41569         <callback name="should_automount">
41570           <return-value transfer-ownership="none">
41571             <doc xml:whitespace="preserve">%TRUE if the volume should be automatically mounted.</doc>
41572             <type name="gboolean" c:type="gboolean"/>
41573           </return-value>
41574           <parameters>
41575             <parameter name="volume" transfer-ownership="none">
41576               <type name="Volume" c:type="GVolume*"/>
41577             </parameter>
41578           </parameters>
41579         </callback>
41580       </field>
41581       <field name="get_activation_root">
41582         <callback name="get_activation_root">
41583           <return-value transfer-ownership="full">
41584             <doc xml:whitespace="preserve">the activation root of @volume or %NULL. Use</doc>
41585             <type name="File" c:type="GFile*"/>
41586           </return-value>
41587           <parameters>
41588             <parameter name="volume" transfer-ownership="none">
41589               <type name="Volume" c:type="GVolume*"/>
41590             </parameter>
41591           </parameters>
41592         </callback>
41593       </field>
41594       <field name="eject_with_operation">
41595         <callback name="eject_with_operation">
41596           <return-value transfer-ownership="none">
41597             <type name="none" c:type="void"/>
41598           </return-value>
41599           <parameters>
41600             <parameter name="volume" transfer-ownership="none">
41601               <type name="Volume" c:type="GVolume*"/>
41602             </parameter>
41603             <parameter name="flags" transfer-ownership="none">
41604               <doc xml:whitespace="preserve">flags affecting the unmount if required for eject</doc>
41605               <type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
41606             </parameter>
41607             <parameter name="mount_operation" transfer-ownership="none">
41608               <doc xml:whitespace="preserve">a #GMountOperation or %NULL to avoid user interaction.</doc>
41609               <type name="MountOperation" c:type="GMountOperation*"/>
41610             </parameter>
41611             <parameter name="cancellable"
41612                        transfer-ownership="none"
41613                        allow-none="1">
41614               <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
41615               <type name="Cancellable" c:type="GCancellable*"/>
41616             </parameter>
41617             <parameter name="callback"
41618                        transfer-ownership="none"
41619                        scope="async"
41620                        closure="5">
41621               <doc xml:whitespace="preserve">a #GAsyncReadyCallback, or %NULL.</doc>
41622               <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
41623             </parameter>
41624             <parameter name="user_data" transfer-ownership="none" closure="5">
41625               <doc xml:whitespace="preserve">user data passed to @callback.</doc>
41626               <type name="gpointer" c:type="gpointer"/>
41627             </parameter>
41628           </parameters>
41629         </callback>
41630       </field>
41631       <field name="eject_with_operation_finish">
41632         <callback name="eject_with_operation_finish" throws="1">
41633           <return-value transfer-ownership="none">
41634             <doc xml:whitespace="preserve">%TRUE if the volume was successfully ejected. %FALSE otherwise.</doc>
41635             <type name="gboolean" c:type="gboolean"/>
41636           </return-value>
41637           <parameters>
41638             <parameter name="volume" transfer-ownership="none">
41639               <type name="Volume" c:type="GVolume*"/>
41640             </parameter>
41641             <parameter name="result" transfer-ownership="none">
41642               <doc xml:whitespace="preserve">a #GAsyncResult.</doc>
41643               <type name="AsyncResult" c:type="GAsyncResult*"/>
41644             </parameter>
41645           </parameters>
41646         </callback>
41647       </field>
41648     </record>
41649     <class name="VolumeMonitor"
41650            c:symbol-prefix="volume_monitor"
41651            c:type="GVolumeMonitor"
41652            parent="GObject.Object"
41653            glib:type-name="GVolumeMonitor"
41654            glib:get-type="g_volume_monitor_get_type"
41655            glib:type-struct="VolumeMonitorClass">
41656       <doc xml:whitespace="preserve">A Volume Monitor that watches for volume events.</doc>
41657       <function name="adopt_orphan_mount"
41658                 c:identifier="g_volume_monitor_adopt_orphan_mount"
41659                 deprecated="Instead of using this function, #GVolumeMonitor"
41660                 deprecated-version="2.20">
41661         <doc xml:whitespace="preserve">This function should be called by any #GVolumeMonitor
41662 implementation when a new #GMount object is created that is not
41663 associated with a #GVolume object. It must be called just before
41664 emitting the @mount_added signal.
41665 If the return value is not %NULL, the caller must associate the
41666 returned #GVolume object with the #GMount. This involves returning
41667 it in its g_mount_get_volume() implementation. The caller must
41668 also listen for the "removed" signal on the returned object
41669 and give up its reference when handling that signal
41670 Similary, if implementing g_volume_monitor_adopt_orphan_mount(),
41671 the implementor must take a reference to @mount and return it in
41672 its g_volume_get_mount() implemented. Also, the implementor must
41673 listen for the "unmounted" signal on @mount and give up its
41674 reference upon handling that signal.
41675 There are two main use cases for this function.
41676 One is when implementing a user space file system driver that reads
41677 blocks of a block device that is already represented by the native
41678 volume monitor (for example a CD Audio file system driver). Such
41679 a driver will generate its own #GMount object that needs to be
41680 assoicated with the #GVolume object that represents the volume.
41681 The other is for implementing a #GVolumeMonitor whose sole purpose
41682 is to return #GVolume objects representing entries in the users
41683 "favorite servers" list or similar.
41684 if no wants to adopt the #GMount.
41685 implementations should instead create shadow mounts with the URI of
41686 the mount they intend to adopt. See the proxy volume monitor in
41687 gvfs for an example of this. Also see g_mount_is_shadowed(),
41688 g_mount_shadow() and g_mount_unshadow() functions.</doc>
41689         <return-value transfer-ownership="full">
41690           <doc xml:whitespace="preserve">the #GVolume object that is the parent for @mount or %NULL</doc>
41691           <type name="Volume" c:type="GVolume*"/>
41692         </return-value>
41693         <parameters>
41694           <parameter name="mount" transfer-ownership="none">
41695             <doc xml:whitespace="preserve">a #GMount object to find a parent for</doc>
41696             <type name="Mount" c:type="GMount*"/>
41697           </parameter>
41698         </parameters>
41699       </function>
41700       <function name="get" c:identifier="g_volume_monitor_get">
41701         <doc xml:whitespace="preserve">Gets the volume monitor used by gio.
41702 g_object_unref() when done with it.</doc>
41703         <return-value transfer-ownership="full">
41704           <doc xml:whitespace="preserve">a reference to the #GVolumeMonitor used by gio. Call</doc>
41705           <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
41706         </return-value>
41707       </function>
41708       <virtual-method name="get_connected_drives"
41709                       invoker="get_connected_drives">
41710         <doc xml:whitespace="preserve">Gets a list of drives connected to the system.
41711 The returned list should be freed with g_list_free(), after
41712 its elements have been unreffed with g_object_unref().</doc>
41713         <return-value transfer-ownership="full">
41714           <doc xml:whitespace="preserve">a #GList of connected #GDrive objects.</doc>
41715           <type name="GLib.List" c:type="GList*">
41716             <type name="Drive"/>
41717           </type>
41718         </return-value>
41719       </virtual-method>
41720       <virtual-method name="get_mount_for_uuid" invoker="get_mount_for_uuid">
41721         <doc xml:whitespace="preserve">Finds a #GMount object by its UUID (see g_mount_get_uuid())
41722 Free the returned object with g_object_unref().</doc>
41723         <return-value transfer-ownership="full">
41724           <doc xml:whitespace="preserve">a #GMount or %NULL if no such mount is available.</doc>
41725           <type name="Mount" c:type="GMount*"/>
41726         </return-value>
41727         <parameters>
41728           <parameter name="uuid" transfer-ownership="none">
41729             <doc xml:whitespace="preserve">the UUID to look for</doc>
41730             <type name="utf8" c:type="char*"/>
41731           </parameter>
41732         </parameters>
41733       </virtual-method>
41734       <virtual-method name="get_mounts" invoker="get_mounts">
41735         <doc xml:whitespace="preserve">Gets a list of the mounts on the system.
41736 The returned list should be freed with g_list_free(), after
41737 its elements have been unreffed with g_object_unref().</doc>
41738         <return-value transfer-ownership="full">
41739           <doc xml:whitespace="preserve">a #GList of #GMount objects.</doc>
41740           <type name="GLib.List" c:type="GList*">
41741             <type name="Mount"/>
41742           </type>
41743         </return-value>
41744       </virtual-method>
41745       <virtual-method name="get_volume_for_uuid" invoker="get_volume_for_uuid">
41746         <doc xml:whitespace="preserve">Finds a #GVolume object by its UUID (see g_volume_get_uuid())
41747 Free the returned object with g_object_unref().</doc>
41748         <return-value transfer-ownership="full">
41749           <doc xml:whitespace="preserve">a #GVolume or %NULL if no such volume is available.</doc>
41750           <type name="Volume" c:type="GVolume*"/>
41751         </return-value>
41752         <parameters>
41753           <parameter name="uuid" transfer-ownership="none">
41754             <doc xml:whitespace="preserve">the UUID to look for</doc>
41755             <type name="utf8" c:type="char*"/>
41756           </parameter>
41757         </parameters>
41758       </virtual-method>
41759       <virtual-method name="get_volumes" invoker="get_volumes">
41760         <doc xml:whitespace="preserve">Gets a list of the volumes on the system.
41761 The returned list should be freed with g_list_free(), after
41762 its elements have been unreffed with g_object_unref().</doc>
41763         <return-value transfer-ownership="full">
41764           <doc xml:whitespace="preserve">a #GList of #GVolume objects.</doc>
41765           <type name="GLib.List" c:type="GList*">
41766             <type name="Volume"/>
41767           </type>
41768         </return-value>
41769       </virtual-method>
41770       <method name="get_connected_drives"
41771               c:identifier="g_volume_monitor_get_connected_drives">
41772         <doc xml:whitespace="preserve">Gets a list of drives connected to the system.
41773 The returned list should be freed with g_list_free(), after
41774 its elements have been unreffed with g_object_unref().</doc>
41775         <return-value transfer-ownership="full">
41776           <doc xml:whitespace="preserve">a #GList of connected #GDrive objects.</doc>
41777           <type name="GLib.List" c:type="GList*">
41778             <type name="Drive"/>
41779           </type>
41780         </return-value>
41781       </method>
41782       <method name="get_mount_for_uuid"
41783               c:identifier="g_volume_monitor_get_mount_for_uuid">
41784         <doc xml:whitespace="preserve">Finds a #GMount object by its UUID (see g_mount_get_uuid())
41785 Free the returned object with g_object_unref().</doc>
41786         <return-value transfer-ownership="full">
41787           <doc xml:whitespace="preserve">a #GMount or %NULL if no such mount is available.</doc>
41788           <type name="Mount" c:type="GMount*"/>
41789         </return-value>
41790         <parameters>
41791           <parameter name="uuid" transfer-ownership="none">
41792             <doc xml:whitespace="preserve">the UUID to look for</doc>
41793             <type name="utf8" c:type="char*"/>
41794           </parameter>
41795         </parameters>
41796       </method>
41797       <method name="get_mounts" c:identifier="g_volume_monitor_get_mounts">
41798         <doc xml:whitespace="preserve">Gets a list of the mounts on the system.
41799 The returned list should be freed with g_list_free(), after
41800 its elements have been unreffed with g_object_unref().</doc>
41801         <return-value transfer-ownership="full">
41802           <doc xml:whitespace="preserve">a #GList of #GMount objects.</doc>
41803           <type name="GLib.List" c:type="GList*">
41804             <type name="Mount"/>
41805           </type>
41806         </return-value>
41807       </method>
41808       <method name="get_volume_for_uuid"
41809               c:identifier="g_volume_monitor_get_volume_for_uuid">
41810         <doc xml:whitespace="preserve">Finds a #GVolume object by its UUID (see g_volume_get_uuid())
41811 Free the returned object with g_object_unref().</doc>
41812         <return-value transfer-ownership="full">
41813           <doc xml:whitespace="preserve">a #GVolume or %NULL if no such volume is available.</doc>
41814           <type name="Volume" c:type="GVolume*"/>
41815         </return-value>
41816         <parameters>
41817           <parameter name="uuid" transfer-ownership="none">
41818             <doc xml:whitespace="preserve">the UUID to look for</doc>
41819             <type name="utf8" c:type="char*"/>
41820           </parameter>
41821         </parameters>
41822       </method>
41823       <method name="get_volumes" c:identifier="g_volume_monitor_get_volumes">
41824         <doc xml:whitespace="preserve">Gets a list of the volumes on the system.
41825 The returned list should be freed with g_list_free(), after
41826 its elements have been unreffed with g_object_unref().</doc>
41827         <return-value transfer-ownership="full">
41828           <doc xml:whitespace="preserve">a #GList of #GVolume objects.</doc>
41829           <type name="GLib.List" c:type="GList*">
41830             <type name="Volume"/>
41831           </type>
41832         </return-value>
41833       </method>
41834       <field name="parent_instance">
41835         <type name="GObject.Object" c:type="GObject"/>
41836       </field>
41837       <field name="priv">
41838         <type name="gpointer" c:type="gpointer"/>
41839       </field>
41840       <glib:signal name="drive-changed">
41841         <doc xml:whitespace="preserve">Emitted when a drive changes.</doc>
41842         <return-value transfer-ownership="none">
41843           <type name="none"/>
41844         </return-value>
41845         <parameters>
41846           <parameter name="object" transfer-ownership="none">
41847             <doc xml:whitespace="preserve">the drive that changed</doc>
41848             <type name="Drive"/>
41849           </parameter>
41850         </parameters>
41851       </glib:signal>
41852       <glib:signal name="drive-connected">
41853         <doc xml:whitespace="preserve">Emitted when a drive is connected to the system.</doc>
41854         <return-value transfer-ownership="none">
41855           <type name="none"/>
41856         </return-value>
41857         <parameters>
41858           <parameter name="object" transfer-ownership="none">
41859             <doc xml:whitespace="preserve">a #GDrive that was connected.</doc>
41860             <type name="Drive"/>
41861           </parameter>
41862         </parameters>
41863       </glib:signal>
41864       <glib:signal name="drive-disconnected">
41865         <doc xml:whitespace="preserve">Emitted when a drive is disconnected from the system.</doc>
41866         <return-value transfer-ownership="none">
41867           <type name="none"/>
41868         </return-value>
41869         <parameters>
41870           <parameter name="object" transfer-ownership="none">
41871             <doc xml:whitespace="preserve">a #GDrive that was disconnected.</doc>
41872             <type name="Drive"/>
41873           </parameter>
41874         </parameters>
41875       </glib:signal>
41876       <glib:signal name="drive-eject-button" version="2.18">
41877         <doc xml:whitespace="preserve">Emitted when the eject button is pressed on @drive.</doc>
41878         <return-value transfer-ownership="none">
41879           <type name="none"/>
41880         </return-value>
41881         <parameters>
41882           <parameter name="object" transfer-ownership="none">
41883             <doc xml:whitespace="preserve">the drive where the eject button was pressed</doc>
41884             <type name="Drive"/>
41885           </parameter>
41886         </parameters>
41887       </glib:signal>
41888       <glib:signal name="drive-stop-button" version="2.22">
41889         <doc xml:whitespace="preserve">Emitted when the stop button is pressed on @drive.</doc>
41890         <return-value transfer-ownership="none">
41891           <type name="none"/>
41892         </return-value>
41893         <parameters>
41894           <parameter name="object" transfer-ownership="none">
41895             <doc xml:whitespace="preserve">the drive where the stop button was pressed</doc>
41896             <type name="Drive"/>
41897           </parameter>
41898         </parameters>
41899       </glib:signal>
41900       <glib:signal name="mount-added">
41901         <doc xml:whitespace="preserve">Emitted when a mount is added.</doc>
41902         <return-value transfer-ownership="none">
41903           <type name="none"/>
41904         </return-value>
41905         <parameters>
41906           <parameter name="object" transfer-ownership="none">
41907             <doc xml:whitespace="preserve">a #GMount that was added.</doc>
41908             <type name="Mount"/>
41909           </parameter>
41910         </parameters>
41911       </glib:signal>
41912       <glib:signal name="mount-changed">
41913         <doc xml:whitespace="preserve">Emitted when a mount changes.</doc>
41914         <return-value transfer-ownership="none">
41915           <type name="none"/>
41916         </return-value>
41917         <parameters>
41918           <parameter name="object" transfer-ownership="none">
41919             <doc xml:whitespace="preserve">a #GMount that changed.</doc>
41920             <type name="Mount"/>
41921           </parameter>
41922         </parameters>
41923       </glib:signal>
41924       <glib:signal name="mount-pre-unmount">
41925         <doc xml:whitespace="preserve">Emitted when a mount is about to be removed.</doc>
41926         <return-value transfer-ownership="none">
41927           <type name="none"/>
41928         </return-value>
41929         <parameters>
41930           <parameter name="object" transfer-ownership="none">
41931             <doc xml:whitespace="preserve">a #GMount that is being unmounted.</doc>
41932             <type name="Mount"/>
41933           </parameter>
41934         </parameters>
41935       </glib:signal>
41936       <glib:signal name="mount-removed">
41937         <doc xml:whitespace="preserve">Emitted when a mount is removed.</doc>
41938         <return-value transfer-ownership="none">
41939           <type name="none"/>
41940         </return-value>
41941         <parameters>
41942           <parameter name="object" transfer-ownership="none">
41943             <doc xml:whitespace="preserve">a #GMount that was removed.</doc>
41944             <type name="Mount"/>
41945           </parameter>
41946         </parameters>
41947       </glib:signal>
41948       <glib:signal name="volume-added">
41949         <doc xml:whitespace="preserve">Emitted when a mountable volume is added to the system.</doc>
41950         <return-value transfer-ownership="none">
41951           <type name="none"/>
41952         </return-value>
41953         <parameters>
41954           <parameter name="object" transfer-ownership="none">
41955             <doc xml:whitespace="preserve">a #GVolume that was added.</doc>
41956             <type name="Volume"/>
41957           </parameter>
41958         </parameters>
41959       </glib:signal>
41960       <glib:signal name="volume-changed">
41961         <doc xml:whitespace="preserve">Emitted when mountable volume is changed.</doc>
41962         <return-value transfer-ownership="none">
41963           <type name="none"/>
41964         </return-value>
41965         <parameters>
41966           <parameter name="object" transfer-ownership="none">
41967             <doc xml:whitespace="preserve">a #GVolume that changed.</doc>
41968             <type name="Volume"/>
41969           </parameter>
41970         </parameters>
41971       </glib:signal>
41972       <glib:signal name="volume-removed">
41973         <doc xml:whitespace="preserve">Emitted when a mountable volume is removed from the system.</doc>
41974         <return-value transfer-ownership="none">
41975           <type name="none"/>
41976         </return-value>
41977         <parameters>
41978           <parameter name="object" transfer-ownership="none">
41979             <doc xml:whitespace="preserve">a #GVolume that was removed.</doc>
41980             <type name="Volume"/>
41981           </parameter>
41982         </parameters>
41983       </glib:signal>
41984     </class>
41985     <record name="VolumeMonitorClass"
41986             c:type="GVolumeMonitorClass"
41987             glib:is-gtype-struct-for="VolumeMonitor">
41988       <field name="parent_class">
41989         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
41990       </field>
41991       <field name="volume_added">
41992         <callback name="volume_added">
41993           <return-value transfer-ownership="none">
41994             <type name="none" c:type="void"/>
41995           </return-value>
41996           <parameters>
41997             <parameter name="volume_monitor" transfer-ownership="none">
41998               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
41999             </parameter>
42000             <parameter name="volume" transfer-ownership="none">
42001               <type name="Volume" c:type="GVolume*"/>
42002             </parameter>
42003           </parameters>
42004         </callback>
42005       </field>
42006       <field name="volume_removed">
42007         <callback name="volume_removed">
42008           <return-value transfer-ownership="none">
42009             <type name="none" c:type="void"/>
42010           </return-value>
42011           <parameters>
42012             <parameter name="volume_monitor" transfer-ownership="none">
42013               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42014             </parameter>
42015             <parameter name="volume" transfer-ownership="none">
42016               <type name="Volume" c:type="GVolume*"/>
42017             </parameter>
42018           </parameters>
42019         </callback>
42020       </field>
42021       <field name="volume_changed">
42022         <callback name="volume_changed">
42023           <return-value transfer-ownership="none">
42024             <type name="none" c:type="void"/>
42025           </return-value>
42026           <parameters>
42027             <parameter name="volume_monitor" transfer-ownership="none">
42028               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42029             </parameter>
42030             <parameter name="volume" transfer-ownership="none">
42031               <type name="Volume" c:type="GVolume*"/>
42032             </parameter>
42033           </parameters>
42034         </callback>
42035       </field>
42036       <field name="mount_added">
42037         <callback name="mount_added">
42038           <return-value transfer-ownership="none">
42039             <type name="none" c:type="void"/>
42040           </return-value>
42041           <parameters>
42042             <parameter name="volume_monitor" transfer-ownership="none">
42043               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42044             </parameter>
42045             <parameter name="mount" transfer-ownership="none">
42046               <type name="Mount" c:type="GMount*"/>
42047             </parameter>
42048           </parameters>
42049         </callback>
42050       </field>
42051       <field name="mount_removed">
42052         <callback name="mount_removed">
42053           <return-value transfer-ownership="none">
42054             <type name="none" c:type="void"/>
42055           </return-value>
42056           <parameters>
42057             <parameter name="volume_monitor" transfer-ownership="none">
42058               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42059             </parameter>
42060             <parameter name="mount" transfer-ownership="none">
42061               <type name="Mount" c:type="GMount*"/>
42062             </parameter>
42063           </parameters>
42064         </callback>
42065       </field>
42066       <field name="mount_pre_unmount">
42067         <callback name="mount_pre_unmount">
42068           <return-value transfer-ownership="none">
42069             <type name="none" c:type="void"/>
42070           </return-value>
42071           <parameters>
42072             <parameter name="volume_monitor" transfer-ownership="none">
42073               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42074             </parameter>
42075             <parameter name="mount" transfer-ownership="none">
42076               <type name="Mount" c:type="GMount*"/>
42077             </parameter>
42078           </parameters>
42079         </callback>
42080       </field>
42081       <field name="mount_changed">
42082         <callback name="mount_changed">
42083           <return-value transfer-ownership="none">
42084             <type name="none" c:type="void"/>
42085           </return-value>
42086           <parameters>
42087             <parameter name="volume_monitor" transfer-ownership="none">
42088               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42089             </parameter>
42090             <parameter name="mount" transfer-ownership="none">
42091               <type name="Mount" c:type="GMount*"/>
42092             </parameter>
42093           </parameters>
42094         </callback>
42095       </field>
42096       <field name="drive_connected">
42097         <callback name="drive_connected">
42098           <return-value transfer-ownership="none">
42099             <type name="none" c:type="void"/>
42100           </return-value>
42101           <parameters>
42102             <parameter name="volume_monitor" transfer-ownership="none">
42103               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42104             </parameter>
42105             <parameter name="drive" transfer-ownership="none">
42106               <type name="Drive" c:type="GDrive*"/>
42107             </parameter>
42108           </parameters>
42109         </callback>
42110       </field>
42111       <field name="drive_disconnected">
42112         <callback name="drive_disconnected">
42113           <return-value transfer-ownership="none">
42114             <type name="none" c:type="void"/>
42115           </return-value>
42116           <parameters>
42117             <parameter name="volume_monitor" transfer-ownership="none">
42118               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42119             </parameter>
42120             <parameter name="drive" transfer-ownership="none">
42121               <type name="Drive" c:type="GDrive*"/>
42122             </parameter>
42123           </parameters>
42124         </callback>
42125       </field>
42126       <field name="drive_changed">
42127         <callback name="drive_changed">
42128           <return-value transfer-ownership="none">
42129             <type name="none" c:type="void"/>
42130           </return-value>
42131           <parameters>
42132             <parameter name="volume_monitor" transfer-ownership="none">
42133               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42134             </parameter>
42135             <parameter name="drive" transfer-ownership="none">
42136               <type name="Drive" c:type="GDrive*"/>
42137             </parameter>
42138           </parameters>
42139         </callback>
42140       </field>
42141       <field name="is_supported">
42142         <callback name="is_supported">
42143           <return-value transfer-ownership="none">
42144             <type name="gboolean" c:type="gboolean"/>
42145           </return-value>
42146         </callback>
42147       </field>
42148       <field name="get_connected_drives">
42149         <callback name="get_connected_drives">
42150           <return-value transfer-ownership="full">
42151             <doc xml:whitespace="preserve">a #GList of connected #GDrive objects.</doc>
42152             <type name="GLib.List" c:type="GList*">
42153               <type name="Drive"/>
42154             </type>
42155           </return-value>
42156           <parameters>
42157             <parameter name="volume_monitor" transfer-ownership="none">
42158               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42159             </parameter>
42160           </parameters>
42161         </callback>
42162       </field>
42163       <field name="get_volumes">
42164         <callback name="get_volumes">
42165           <return-value transfer-ownership="full">
42166             <doc xml:whitespace="preserve">a #GList of #GVolume objects.</doc>
42167             <type name="GLib.List" c:type="GList*">
42168               <type name="Volume"/>
42169             </type>
42170           </return-value>
42171           <parameters>
42172             <parameter name="volume_monitor" transfer-ownership="none">
42173               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42174             </parameter>
42175           </parameters>
42176         </callback>
42177       </field>
42178       <field name="get_mounts">
42179         <callback name="get_mounts">
42180           <return-value transfer-ownership="full">
42181             <doc xml:whitespace="preserve">a #GList of #GMount objects.</doc>
42182             <type name="GLib.List" c:type="GList*">
42183               <type name="Mount"/>
42184             </type>
42185           </return-value>
42186           <parameters>
42187             <parameter name="volume_monitor" transfer-ownership="none">
42188               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42189             </parameter>
42190           </parameters>
42191         </callback>
42192       </field>
42193       <field name="get_volume_for_uuid">
42194         <callback name="get_volume_for_uuid">
42195           <return-value transfer-ownership="full">
42196             <doc xml:whitespace="preserve">a #GVolume or %NULL if no such volume is available.</doc>
42197             <type name="Volume" c:type="GVolume*"/>
42198           </return-value>
42199           <parameters>
42200             <parameter name="volume_monitor" transfer-ownership="none">
42201               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42202             </parameter>
42203             <parameter name="uuid" transfer-ownership="none">
42204               <doc xml:whitespace="preserve">the UUID to look for</doc>
42205               <type name="utf8" c:type="char*"/>
42206             </parameter>
42207           </parameters>
42208         </callback>
42209       </field>
42210       <field name="get_mount_for_uuid">
42211         <callback name="get_mount_for_uuid">
42212           <return-value transfer-ownership="full">
42213             <doc xml:whitespace="preserve">a #GMount or %NULL if no such mount is available.</doc>
42214             <type name="Mount" c:type="GMount*"/>
42215           </return-value>
42216           <parameters>
42217             <parameter name="volume_monitor" transfer-ownership="none">
42218               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42219             </parameter>
42220             <parameter name="uuid" transfer-ownership="none">
42221               <doc xml:whitespace="preserve">the UUID to look for</doc>
42222               <type name="utf8" c:type="char*"/>
42223             </parameter>
42224           </parameters>
42225         </callback>
42226       </field>
42227       <field name="adopt_orphan_mount" introspectable="0">
42228         <callback name="adopt_orphan_mount" introspectable="0">
42229           <return-value>
42230             <type name="Volume" c:type="GVolume*"/>
42231           </return-value>
42232           <parameters>
42233             <parameter name="mount" transfer-ownership="none">
42234               <type name="Mount" c:type="GMount*"/>
42235             </parameter>
42236             <parameter name="volume_monitor" transfer-ownership="none">
42237               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42238             </parameter>
42239           </parameters>
42240         </callback>
42241       </field>
42242       <field name="drive_eject_button">
42243         <callback name="drive_eject_button">
42244           <return-value transfer-ownership="none">
42245             <type name="none" c:type="void"/>
42246           </return-value>
42247           <parameters>
42248             <parameter name="volume_monitor" transfer-ownership="none">
42249               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42250             </parameter>
42251             <parameter name="drive" transfer-ownership="none">
42252               <type name="Drive" c:type="GDrive*"/>
42253             </parameter>
42254           </parameters>
42255         </callback>
42256       </field>
42257       <field name="drive_stop_button">
42258         <callback name="drive_stop_button">
42259           <return-value transfer-ownership="none">
42260             <type name="none" c:type="void"/>
42261           </return-value>
42262           <parameters>
42263             <parameter name="volume_monitor" transfer-ownership="none">
42264               <type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
42265             </parameter>
42266             <parameter name="drive" transfer-ownership="none">
42267               <type name="Drive" c:type="GDrive*"/>
42268             </parameter>
42269           </parameters>
42270         </callback>
42271       </field>
42272       <field name="_g_reserved1" introspectable="0">
42273         <callback name="_g_reserved1">
42274           <return-value transfer-ownership="none">
42275             <type name="none" c:type="void"/>
42276           </return-value>
42277         </callback>
42278       </field>
42279       <field name="_g_reserved2" introspectable="0">
42280         <callback name="_g_reserved2">
42281           <return-value transfer-ownership="none">
42282             <type name="none" c:type="void"/>
42283           </return-value>
42284         </callback>
42285       </field>
42286       <field name="_g_reserved3" introspectable="0">
42287         <callback name="_g_reserved3">
42288           <return-value transfer-ownership="none">
42289             <type name="none" c:type="void"/>
42290           </return-value>
42291         </callback>
42292       </field>
42293       <field name="_g_reserved4" introspectable="0">
42294         <callback name="_g_reserved4">
42295           <return-value transfer-ownership="none">
42296             <type name="none" c:type="void"/>
42297           </return-value>
42298         </callback>
42299       </field>
42300       <field name="_g_reserved5" introspectable="0">
42301         <callback name="_g_reserved5">
42302           <return-value transfer-ownership="none">
42303             <type name="none" c:type="void"/>
42304           </return-value>
42305         </callback>
42306       </field>
42307       <field name="_g_reserved6" introspectable="0">
42308         <callback name="_g_reserved6">
42309           <return-value transfer-ownership="none">
42310             <type name="none" c:type="void"/>
42311           </return-value>
42312         </callback>
42313       </field>
42314     </record>
42315     <class name="ZlibCompressor"
42316            c:symbol-prefix="zlib_compressor"
42317            c:type="GZlibCompressor"
42318            parent="GObject.Object"
42319            glib:type-name="GZlibCompressor"
42320            glib:get-type="g_zlib_compressor_get_type"
42321            glib:type-struct="ZlibCompressorClass">
42322       <doc xml:whitespace="preserve">Zlib decompression</doc>
42323       <implements name="Converter"/>
42324       <constructor name="new"
42325                    c:identifier="g_zlib_compressor_new"
42326                    version="2.24">
42327         <doc xml:whitespace="preserve">Creates a new #GZlibCompressor.</doc>
42328         <return-value transfer-ownership="full">
42329           <doc xml:whitespace="preserve">a new #GZlibCompressor</doc>
42330           <type name="ZlibCompressor" c:type="GZlibCompressor*"/>
42331         </return-value>
42332         <parameters>
42333           <parameter name="format" transfer-ownership="none">
42334             <doc xml:whitespace="preserve">The format to use for the compressed data</doc>
42335             <type name="ZlibCompressorFormat" c:type="GZlibCompressorFormat"/>
42336           </parameter>
42337           <parameter name="level" transfer-ownership="none">
42338             <doc xml:whitespace="preserve">compression level (0-9), -1 for default</doc>
42339             <type name="gint" c:type="int"/>
42340           </parameter>
42341         </parameters>
42342       </constructor>
42343       <method name="get_file_info"
42344               c:identifier="g_zlib_compressor_get_file_info"
42345               version="2.26">
42346         <doc xml:whitespace="preserve">Returns the #GZlibCompressor:file-info property.</doc>
42347         <return-value transfer-ownership="none">
42348           <doc xml:whitespace="preserve">a #GFileInfo, or %NULL</doc>
42349           <type name="FileInfo" c:type="GFileInfo*"/>
42350         </return-value>
42351       </method>
42352       <method name="set_file_info"
42353               c:identifier="g_zlib_compressor_set_file_info"
42354               version="2.26">
42355         <doc xml:whitespace="preserve">Sets @file_info in @compressor. If non-%NULL, and @compressor's
42356 #GZlibCompressor:format property is %G_ZLIB_COMPRESSOR_FORMAT_GZIP,
42357 it will be used to set the file name and modification time in
42358 the GZIP header of the compressed data.
42359 progress; it may only be called immediately after creation of @compressor,
42360 or after resetting it with g_converter_reset().</doc>
42361         <return-value transfer-ownership="none">
42362           <type name="none" c:type="void"/>
42363         </return-value>
42364         <parameters>
42365           <parameter name="file_info" transfer-ownership="none" allow-none="1">
42366             <doc xml:whitespace="preserve">a #GFileInfo</doc>
42367             <type name="FileInfo" c:type="GFileInfo*"/>
42368           </parameter>
42369         </parameters>
42370       </method>
42371       <property name="file-info"
42372                 version="2.26"
42373                 writable="1"
42374                 transfer-ownership="none">
42375         <doc xml:whitespace="preserve">If set to a non-%NULL #GFileInfo object, and #GZlibCompressor:format is
42376 %G_ZLIB_COMPRESSOR_FORMAT_GZIP, the compressor will write the file name
42377 and modification time from the file info to the the GZIP header.</doc>
42378         <type name="FileInfo"/>
42379       </property>
42380       <property name="format"
42381                 writable="1"
42382                 construct-only="1"
42383                 transfer-ownership="none">
42384         <type name="ZlibCompressorFormat"/>
42385       </property>
42386       <property name="level"
42387                 writable="1"
42388                 construct-only="1"
42389                 transfer-ownership="none">
42390         <type name="gint"/>
42391       </property>
42392     </class>
42393     <record name="ZlibCompressorClass"
42394             c:type="GZlibCompressorClass"
42395             glib:is-gtype-struct-for="ZlibCompressor">
42396       <field name="parent_class">
42397         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
42398       </field>
42399     </record>
42400     <enumeration name="ZlibCompressorFormat"
42401                  version="2.24"
42402                  glib:type-name="GZlibCompressorFormat"
42403                  glib:get-type="g_zlib_compressor_format_get_type"
42404                  c:type="GZlibCompressorFormat">
42405       <doc xml:whitespace="preserve">Used to select the type of data format to use for #GZlibDecompressor
42406 and #GZlibCompressor.</doc>
42407       <member name="zlib"
42408               value="0"
42409               c:identifier="G_ZLIB_COMPRESSOR_FORMAT_ZLIB"
42410               glib:nick="zlib"/>
42411       <member name="gzip"
42412               value="1"
42413               c:identifier="G_ZLIB_COMPRESSOR_FORMAT_GZIP"
42414               glib:nick="gzip"/>
42415       <member name="raw"
42416               value="2"
42417               c:identifier="G_ZLIB_COMPRESSOR_FORMAT_RAW"
42418               glib:nick="raw"/>
42419     </enumeration>
42420     <class name="ZlibDecompressor"
42421            c:symbol-prefix="zlib_decompressor"
42422            c:type="GZlibDecompressor"
42423            parent="GObject.Object"
42424            glib:type-name="GZlibDecompressor"
42425            glib:get-type="g_zlib_decompressor_get_type"
42426            glib:type-struct="ZlibDecompressorClass">
42427       <doc xml:whitespace="preserve">Zlib decompression</doc>
42428       <implements name="Converter"/>
42429       <constructor name="new"
42430                    c:identifier="g_zlib_decompressor_new"
42431                    version="2.24">
42432         <doc xml:whitespace="preserve">Creates a new #GZlibDecompressor.</doc>
42433         <return-value transfer-ownership="full">
42434           <doc xml:whitespace="preserve">a new #GZlibDecompressor</doc>
42435           <type name="ZlibDecompressor" c:type="GZlibDecompressor*"/>
42436         </return-value>
42437         <parameters>
42438           <parameter name="format" transfer-ownership="none">
42439             <doc xml:whitespace="preserve">The format to use for the compressed data</doc>
42440             <type name="ZlibCompressorFormat" c:type="GZlibCompressorFormat"/>
42441           </parameter>
42442         </parameters>
42443       </constructor>
42444       <method name="get_file_info"
42445               c:identifier="g_zlib_decompressor_get_file_info"
42446               version="2.26">
42447         <doc xml:whitespace="preserve">Retrieves the #GFileInfo constructed from the GZIP header data
42448 of compressed data processed by @compressor, or %NULL if @decompressor's
42449 #GZlibDecompressor:format property is not %G_ZLIB_COMPRESSOR_FORMAT_GZIP,
42450 or the header data was not fully processed yet, or it not present in the
42451 data stream at all.</doc>
42452         <return-value transfer-ownership="none">
42453           <doc xml:whitespace="preserve">a #GFileInfo, or %NULL</doc>
42454           <type name="FileInfo" c:type="GFileInfo*"/>
42455         </return-value>
42456       </method>
42457       <property name="file-info" version="2.26" transfer-ownership="none">
42458         <doc xml:whitespace="preserve">A #GFileInfo containing the information found in the GZIP header
42459 of the data stream processed, or %NULL if the header was not yet
42460 fully processed, is not present at all, or the compressor's
42461 #GZlibDecompressor:format property is not %G_ZLIB_COMPRESSOR_FORMAT_GZIP.</doc>
42462         <type name="FileInfo"/>
42463       </property>
42464       <property name="format"
42465                 writable="1"
42466                 construct-only="1"
42467                 transfer-ownership="none">
42468         <type name="ZlibCompressorFormat"/>
42469       </property>
42470     </class>
42471     <record name="ZlibDecompressorClass"
42472             c:type="GZlibDecompressorClass"
42473             glib:is-gtype-struct-for="ZlibDecompressor">
42474       <field name="parent_class">
42475         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
42476       </field>
42477     </record>
42478     <function name="app_info_create_from_commandline"
42479               c:identifier="g_app_info_create_from_commandline"
42480               throws="1">
42481       <doc xml:whitespace="preserve">Creates a new #GAppInfo from the given information.</doc>
42482       <return-value transfer-ownership="full">
42483         <doc xml:whitespace="preserve">new #GAppInfo for given command.</doc>
42484         <type name="AppInfo" c:type="GAppInfo*"/>
42485       </return-value>
42486       <parameters>
42487         <parameter name="commandline" transfer-ownership="none">
42488           <doc xml:whitespace="preserve">the commandline to use</doc>
42489           <type name="utf8" c:type="char*"/>
42490         </parameter>
42491         <parameter name="application_name"
42492                    transfer-ownership="none"
42493                    allow-none="1">
42494           <doc xml:whitespace="preserve">the application name, or %NULL to use @commandline</doc>
42495           <type name="utf8" c:type="char*"/>
42496         </parameter>
42497         <parameter name="flags" transfer-ownership="none">
42498           <doc xml:whitespace="preserve">flags that can specify details of the created #GAppInfo</doc>
42499           <type name="AppInfoCreateFlags" c:type="GAppInfoCreateFlags"/>
42500         </parameter>
42501       </parameters>
42502     </function>
42503     <function name="app_info_get_all" c:identifier="g_app_info_get_all">
42504       <doc xml:whitespace="preserve">Gets a list of all of the applications currently registered
42505 on this system.
42506 For desktop files, this includes applications that have
42507 &lt;literal&gt;NoDisplay=true&lt;/literal&gt; set or are excluded from
42508 display by means of &lt;literal&gt;OnlyShowIn&lt;/literal&gt; or
42509 &lt;literal&gt;NotShowIn&lt;/literal&gt;. See g_app_info_should_show().
42510 The returned list does not include applications which have
42511 the &lt;literal&gt;Hidden&lt;/literal&gt; key set.</doc>
42512       <return-value transfer-ownership="full">
42513         <doc xml:whitespace="preserve">a newly allocated #GList of references to #GAppInfo&lt;!----&gt;s.</doc>
42514         <type name="GLib.List" c:type="GList*">
42515           <type name="AppInfo"/>
42516         </type>
42517       </return-value>
42518     </function>
42519     <function name="app_info_get_all_for_type"
42520               c:identifier="g_app_info_get_all_for_type">
42521       <doc xml:whitespace="preserve">Gets a list of all #GAppInfo&lt;!-- --&gt;s for a given content type.
42522 or %NULL on error.</doc>
42523       <return-value transfer-ownership="full">
42524         <doc xml:whitespace="preserve">#GList of #GAppInfo&lt;!-- --&gt;s for given @content_type</doc>
42525         <type name="GLib.List" c:type="GList*">
42526           <type name="AppInfo"/>
42527         </type>
42528       </return-value>
42529       <parameters>
42530         <parameter name="content_type" transfer-ownership="none">
42531           <doc xml:whitespace="preserve">the content type to find a #GAppInfo for</doc>
42532           <type name="utf8" c:type="char*"/>
42533         </parameter>
42534       </parameters>
42535     </function>
42536     <function name="app_info_get_default_for_type"
42537               c:identifier="g_app_info_get_default_for_type"
42538               introspectable="0">
42539       <doc xml:whitespace="preserve">Gets the #GAppInfo that corresponds to a given content type.</doc>
42540       <return-value>
42541         <doc xml:whitespace="preserve">#GAppInfo for given @content_type or %NULL on error.</doc>
42542         <type name="AppInfo" c:type="GAppInfo*"/>
42543       </return-value>
42544       <parameters>
42545         <parameter name="content_type" transfer-ownership="none">
42546           <doc xml:whitespace="preserve">the content type to find a #GAppInfo for</doc>
42547           <type name="utf8" c:type="char*"/>
42548         </parameter>
42549         <parameter name="must_support_uris" transfer-ownership="none">
42550           <doc xml:whitespace="preserve">if %TRUE, the #GAppInfo is expected to support URIs</doc>
42551           <type name="gboolean" c:type="gboolean"/>
42552         </parameter>
42553       </parameters>
42554     </function>
42555     <function name="app_info_get_default_for_uri_scheme"
42556               c:identifier="g_app_info_get_default_for_uri_scheme"
42557               introspectable="0">
42558       <doc xml:whitespace="preserve">Gets the default application for launching applications
42559 using this URI scheme. A URI scheme is the initial part
42560 of the URI, up to but not including the ':', e.g. "http",
42561 "ftp" or "sip".</doc>
42562       <return-value>
42563         <doc xml:whitespace="preserve">#GAppInfo for given @uri_scheme or %NULL on error.</doc>
42564         <type name="AppInfo" c:type="GAppInfo*"/>
42565       </return-value>
42566       <parameters>
42567         <parameter name="uri_scheme" transfer-ownership="none">
42568           <doc xml:whitespace="preserve">a string containing a URI scheme.</doc>
42569           <type name="utf8" c:type="char*"/>
42570         </parameter>
42571       </parameters>
42572     </function>
42573     <function name="app_info_launch_default_for_uri"
42574               c:identifier="g_app_info_launch_default_for_uri"
42575               throws="1">
42576       <doc xml:whitespace="preserve">Utility function that launches the default application
42577 registered to handle the specified uri. Synchronous I/O
42578 is done on the uri to detect the type of the file if
42579 required.</doc>
42580       <return-value transfer-ownership="none">
42581         <doc xml:whitespace="preserve">%TRUE on success, %FALSE on error.</doc>
42582         <type name="gboolean" c:type="gboolean"/>
42583       </return-value>
42584       <parameters>
42585         <parameter name="uri" transfer-ownership="none">
42586           <doc xml:whitespace="preserve">the uri to show</doc>
42587           <type name="utf8" c:type="char*"/>
42588         </parameter>
42589         <parameter name="launch_context" transfer-ownership="none">
42590           <doc xml:whitespace="preserve">an optional #GAppLaunchContext.</doc>
42591           <type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
42592         </parameter>
42593       </parameters>
42594     </function>
42595     <function name="app_info_reset_type_associations"
42596               c:identifier="g_app_info_reset_type_associations"
42597               version="2.20">
42598       <doc xml:whitespace="preserve">Removes all changes to the type associations done by
42599 g_app_info_set_as_default_for_type(),
42600 g_app_info_set_as_default_for_extension(),
42601 g_app_info_add_supports_type() or g_app_info_remove_supports_type().</doc>
42602       <return-value transfer-ownership="none">
42603         <type name="none" c:type="void"/>
42604       </return-value>
42605       <parameters>
42606         <parameter name="content_type" transfer-ownership="none">
42607           <doc xml:whitespace="preserve">a content type</doc>
42608           <type name="utf8" c:type="char*"/>
42609         </parameter>
42610       </parameters>
42611     </function>
42612     <function name="async_initable_new_async"
42613               c:identifier="g_async_initable_new_async"
42614               version="2.22"
42615               introspectable="0">
42616       <doc xml:whitespace="preserve">Helper function for constructing #GAsyncInitiable object. This is
42617 similar to g_object_new() but also initializes the object asynchronously.
42618 When the initialization is finished, @callback will be called. You can
42619 then call g_async_initable_new_finish() to get the new object and check
42620 for any errors.</doc>
42621       <return-value transfer-ownership="none">
42622         <type name="none" c:type="void"/>
42623       </return-value>
42624       <parameters>
42625         <parameter name="object_type" transfer-ownership="none">
42626           <doc xml:whitespace="preserve">a #GType supporting #GAsyncInitable.</doc>
42627           <type name="GType" c:type="GType"/>
42628         </parameter>
42629         <parameter name="io_priority" transfer-ownership="none">
42630           <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the operation.</doc>
42631           <type name="gint" c:type="int"/>
42632         </parameter>
42633         <parameter name="cancellable" transfer-ownership="none" allow-none="1">
42634           <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
42635           <type name="Cancellable" c:type="GCancellable*"/>
42636         </parameter>
42637         <parameter name="callback"
42638                    transfer-ownership="none"
42639                    scope="async"
42640                    closure="4">
42641           <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the initialization is finished</doc>
42642           <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
42643         </parameter>
42644         <parameter name="user_data" transfer-ownership="none">
42645           <doc xml:whitespace="preserve">the data to pass to callback function</doc>
42646           <type name="gpointer" c:type="gpointer"/>
42647         </parameter>
42648         <parameter name="first_property_name" transfer-ownership="none">
42649           <doc xml:whitespace="preserve">the name of the first property, or %NULL if no properties</doc>
42650           <type name="utf8" c:type="gchar*"/>
42651         </parameter>
42652         <parameter transfer-ownership="none">
42653           <varargs>
42654           </varargs>
42655         </parameter>
42656       </parameters>
42657     </function>
42658     <function name="async_initable_new_valist_async"
42659               c:identifier="g_async_initable_new_valist_async"
42660               version="2.22"
42661               introspectable="0">
42662       <doc xml:whitespace="preserve">Helper function for constructing #GAsyncInitiable object. This is
42663 similar to g_object_new_valist() but also initializes the object
42664 asynchronously.
42665 When the initialization is finished, @callback will be called. You can
42666 then call g_async_initable_new_finish() to get the new object and check
42667 for any errors.</doc>
42668       <return-value transfer-ownership="none">
42669         <type name="none" c:type="void"/>
42670       </return-value>
42671       <parameters>
42672         <parameter name="object_type" transfer-ownership="none">
42673           <doc xml:whitespace="preserve">a #GType supporting #GAsyncInitable.</doc>
42674           <type name="GType" c:type="GType"/>
42675         </parameter>
42676         <parameter name="first_property_name" transfer-ownership="none">
42677           <doc xml:whitespace="preserve">the name of the first property, followed by the value, and other property value pairs, and ended by %NULL.</doc>
42678           <type name="utf8" c:type="gchar*"/>
42679         </parameter>
42680         <parameter name="var_args" transfer-ownership="none">
42681           <doc xml:whitespace="preserve">The var args list generated from @first_property_name.</doc>
42682           <type name="va_list" c:type="va_list"/>
42683         </parameter>
42684         <parameter name="io_priority" transfer-ownership="none">
42685           <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the operation.</doc>
42686           <type name="gint" c:type="int"/>
42687         </parameter>
42688         <parameter name="cancellable" transfer-ownership="none" allow-none="1">
42689           <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
42690           <type name="Cancellable" c:type="GCancellable*"/>
42691         </parameter>
42692         <parameter name="callback"
42693                    transfer-ownership="none"
42694                    scope="async"
42695                    closure="6">
42696           <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the initialization is finished</doc>
42697           <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
42698         </parameter>
42699         <parameter name="user_data" transfer-ownership="none">
42700           <doc xml:whitespace="preserve">the data to pass to callback function</doc>
42701           <type name="gpointer" c:type="gpointer"/>
42702         </parameter>
42703       </parameters>
42704     </function>
42705     <function name="async_initable_newv_async"
42706               c:identifier="g_async_initable_newv_async"
42707               version="2.22">
42708       <doc xml:whitespace="preserve">Helper function for constructing #GAsyncInitiable object. This is
42709 similar to g_object_newv() but also initializes the object asynchronously.
42710 When the initialization is finished, @callback will be called. You can
42711 then call g_async_initable_new_finish() to get the new object and check
42712 for any errors.</doc>
42713       <return-value transfer-ownership="none">
42714         <type name="none" c:type="void"/>
42715       </return-value>
42716       <parameters>
42717         <parameter name="object_type" transfer-ownership="none">
42718           <doc xml:whitespace="preserve">a #GType supporting #GAsyncInitable.</doc>
42719           <type name="GType" c:type="GType"/>
42720         </parameter>
42721         <parameter name="n_parameters" transfer-ownership="none">
42722           <doc xml:whitespace="preserve">the number of parameters in @parameters</doc>
42723           <type name="guint" c:type="guint"/>
42724         </parameter>
42725         <parameter name="parameters" transfer-ownership="none">
42726           <doc xml:whitespace="preserve">the parameters to use to construct the object</doc>
42727           <type name="GObject.Parameter" c:type="GParameter*"/>
42728         </parameter>
42729         <parameter name="io_priority" transfer-ownership="none">
42730           <doc xml:whitespace="preserve">the &lt;link linkend="io-priority"&gt;I/O priority&lt;/link&gt; of the operation.</doc>
42731           <type name="gint" c:type="int"/>
42732         </parameter>
42733         <parameter name="cancellable" transfer-ownership="none" allow-none="1">
42734           <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
42735           <type name="Cancellable" c:type="GCancellable*"/>
42736         </parameter>
42737         <parameter name="callback"
42738                    transfer-ownership="none"
42739                    scope="async"
42740                    closure="6">
42741           <doc xml:whitespace="preserve">a #GAsyncReadyCallback to call when the initialization is finished</doc>
42742           <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
42743         </parameter>
42744         <parameter name="user_data" transfer-ownership="none">
42745           <doc xml:whitespace="preserve">the data to pass to callback function</doc>
42746           <type name="gpointer" c:type="gpointer"/>
42747         </parameter>
42748       </parameters>
42749     </function>
42750     <function name="bus_get" c:identifier="g_bus_get" version="2.26">
42751       <doc xml:whitespace="preserve">Asynchronously connects to the message bus specified by @bus_type.
42752 When the operation is finished, @callback will be invoked. You can
42753 then call g_bus_get_finish() to get the result of the operation.
42754 This is a asynchronous failable function. See g_bus_get_sync() for
42755 the synchronous version.</doc>
42756       <return-value transfer-ownership="none">
42757         <type name="none" c:type="void"/>
42758       </return-value>
42759       <parameters>
42760         <parameter name="bus_type" transfer-ownership="none">
42761           <doc xml:whitespace="preserve">A #GBusType.</doc>
42762           <type name="BusType" c:type="GBusType"/>
42763         </parameter>
42764         <parameter name="cancellable" transfer-ownership="none" allow-none="1">
42765           <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
42766           <type name="Cancellable" c:type="GCancellable*"/>
42767         </parameter>
42768         <parameter name="callback"
42769                    transfer-ownership="none"
42770                    scope="async"
42771                    closure="3">
42772           <doc xml:whitespace="preserve">A #GAsyncReadyCallback to call when the request is satisfied.</doc>
42773           <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
42774         </parameter>
42775         <parameter name="user_data" transfer-ownership="none">
42776           <doc xml:whitespace="preserve">The data to pass to @callback.</doc>
42777           <type name="gpointer" c:type="gpointer"/>
42778         </parameter>
42779       </parameters>
42780     </function>
42781     <function name="bus_get_finish"
42782               c:identifier="g_bus_get_finish"
42783               version="2.26"
42784               throws="1">
42785       <doc xml:whitespace="preserve">Finishes an operation started with g_bus_get().
42786 The returned object is a singleton, that is, shared with other
42787 callers of g_bus_get() and g_bus_get_sync() for @bus_type. In the
42788 event that you need a private message bus connection, use
42789 g_dbus_address_get_for_bus() and
42790 g_dbus_connection_new_for_address().
42791 Note that the returned #GDBusConnection object will (usually) have
42792 the #GDBusConnection:exit-on-close property set to %TRUE.</doc>
42793       <return-value transfer-ownership="full">
42794         <doc xml:whitespace="preserve">A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().</doc>
42795         <type name="DBusConnection" c:type="GDBusConnection*"/>
42796       </return-value>
42797       <parameters>
42798         <parameter name="res" transfer-ownership="none">
42799           <doc xml:whitespace="preserve">A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_bus_get().</doc>
42800           <type name="AsyncResult" c:type="GAsyncResult*"/>
42801         </parameter>
42802       </parameters>
42803     </function>
42804     <function name="bus_get_sync"
42805               c:identifier="g_bus_get_sync"
42806               version="2.26"
42807               throws="1">
42808       <doc xml:whitespace="preserve">Synchronously connects to the message bus specified by @bus_type.
42809 Note that the returned object may shared with other callers,
42810 e.g. if two separate parts of a process calls this function with
42811 the same @bus_type, they will share the same object.
42812 This is a synchronous failable function. See g_bus_get() and
42813 g_bus_get_finish() for the asynchronous version.
42814 The returned object is a singleton, that is, shared with other
42815 callers of g_bus_get() and g_bus_get_sync() for @bus_type. In the
42816 event that you need a private message bus connection, use
42817 g_dbus_address_get_for_bus_sync() and
42818 g_dbus_connection_new_for_address().
42819 Note that the returned #GDBusConnection object will (usually) have
42820 the #GDBusConnection:exit-on-close property set to %TRUE.</doc>
42821       <return-value transfer-ownership="full">
42822         <doc xml:whitespace="preserve">A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().</doc>
42823         <type name="DBusConnection" c:type="GDBusConnection*"/>
42824       </return-value>
42825       <parameters>
42826         <parameter name="bus_type" transfer-ownership="none">
42827           <doc xml:whitespace="preserve">A #GBusType.</doc>
42828           <type name="BusType" c:type="GBusType"/>
42829         </parameter>
42830         <parameter name="cancellable" transfer-ownership="none" allow-none="1">
42831           <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
42832           <type name="Cancellable" c:type="GCancellable*"/>
42833         </parameter>
42834       </parameters>
42835     </function>
42836     <function name="bus_own_name"
42837               c:identifier="g_bus_own_name"
42838               shadowed-by="bus_own_name_with_closures"
42839               version="2.26"
42840               introspectable="0">
42841       <doc xml:whitespace="preserve">Starts acquiring @name on the bus specified by @bus_type and calls
42842 acquired respectively lost. Callbacks will be invoked in the &lt;link
42843 linkend="g-main-context-push-thread-default"&gt;thread-default main
42844 loop&lt;/link&gt; of the thread you are calling this function from.
42845 You are guaranteed that one of the @name_acquired_handler and @name_lost_handler
42846 callbacks will be invoked after calling this function - there are three
42847 possible cases:
42848 &lt;itemizedlist&gt;
42849 &lt;listitem&gt;&lt;para&gt;
42850 &lt;/para&gt;&lt;/listitem&gt;
42851 &lt;listitem&gt;&lt;para&gt;
42852 &lt;/para&gt;&lt;/listitem&gt;
42853 &lt;listitem&gt;&lt;para&gt;
42854 &lt;/para&gt;&lt;/listitem&gt;
42855 &lt;/itemizedlist&gt;
42856 When you are done owning the name, just call g_bus_unown_name()
42857 with the owner id this function returns.
42858 If the name is acquired or lost (for example another application
42859 could acquire the name if you allow replacement or the application
42860 currently owning the name exits), the handlers are also invoked. If the
42861 #GDBusConnection that is used for attempting to own the name
42862 closes, then @name_lost_handler is invoked since it is no
42863 longer possible for other processes to access the process.
42864 You cannot use g_bus_own_name() several times for the same name (unless
42865 interleaved with calls to g_bus_unown_name()) - only the first call
42866 will work.
42867 Another guarantee is that invocations of @name_acquired_handler
42868 and @name_lost_handler are guaranteed to alternate; that
42869 is, if @name_acquired_handler is invoked then you are
42870 guaranteed that the next time one of the handlers is invoked, it
42871 will be @name_lost_handler. The reverse is also true.
42872 If you plan on exporting objects (using e.g.
42873 g_dbus_connection_register_object()), note that it is generally too late
42874 to export the objects in @name_acquired_handler. Instead, you can do this
42875 in @bus_acquired_handler since you are guaranteed that this will run
42876 before @name is requested from the bus.
42877 This behavior makes it very simple to write applications that wants
42878 to own names and export objects, see &lt;xref linkend="gdbus-owning-names"/&gt;.
42879 Simply register objects to be exported in @bus_acquired_handler and
42880 unregister the objects (if any) in @name_lost_handler.
42881 g_bus_unown_name() to stop owning the name.</doc>
42882       <return-value transfer-ownership="none">
42883         <doc xml:whitespace="preserve">An identifier (never 0) that an be used with</doc>
42884         <type name="guint" c:type="guint"/>
42885       </return-value>
42886       <parameters>
42887         <parameter name="bus_type" transfer-ownership="none">
42888           <doc xml:whitespace="preserve">The type of bus to own a name on.</doc>
42889           <type name="BusType" c:type="GBusType"/>
42890         </parameter>
42891         <parameter name="name" transfer-ownership="none">
42892           <doc xml:whitespace="preserve">The well-known name to own.</doc>
42893           <type name="utf8" c:type="gchar*"/>
42894         </parameter>
42895         <parameter name="flags" transfer-ownership="none">
42896           <doc xml:whitespace="preserve">A set of flags from the #GBusNameOwnerFlags enumeration.</doc>
42897           <type name="BusNameOwnerFlags" c:type="GBusNameOwnerFlags"/>
42898         </parameter>
42899         <parameter name="bus_acquired_handler" transfer-ownership="none">
42900           <doc xml:whitespace="preserve">Handler to invoke when connected to the bus of type @bus_type or %NULL.</doc>
42901           <type name="BusAcquiredCallback" c:type="GBusAcquiredCallback"/>
42902         </parameter>
42903         <parameter name="name_acquired_handler" transfer-ownership="none">
42904           <doc xml:whitespace="preserve">Handler to invoke when @name is acquired or %NULL.</doc>
42905           <type name="BusNameAcquiredCallback"
42906                 c:type="GBusNameAcquiredCallback"/>
42907         </parameter>
42908         <parameter name="name_lost_handler"
42909                    transfer-ownership="none"
42910                    scope="notified"
42911                    closure="6"
42912                    destroy="7">
42913           <doc xml:whitespace="preserve">Handler to invoke when @name is lost or %NULL.</doc>
42914           <type name="BusNameLostCallback" c:type="GBusNameLostCallback"/>
42915         </parameter>
42916         <parameter name="user_data" transfer-ownership="none">
42917           <doc xml:whitespace="preserve">User data to pass to handlers.</doc>
42918           <type name="gpointer" c:type="gpointer"/>
42919         </parameter>
42920         <parameter name="user_data_free_func"
42921                    transfer-ownership="none"
42922                    scope="async">
42923           <doc xml:whitespace="preserve">Function for freeing @user_data or %NULL.</doc>
42924           <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
42925         </parameter>
42926       </parameters>
42927     </function>
42928     <function name="bus_own_name_on_connection"
42929               c:identifier="g_bus_own_name_on_connection"
42930               shadowed-by="bus_own_name_on_connection_with_closures"
42931               version="2.26"
42932               introspectable="0">
42933       <doc xml:whitespace="preserve">Like g_bus_own_name() but takes a #GDBusConnection instead of a
42934 #GBusType.
42935 g_bus_unown_name() to stop owning the name.</doc>
42936       <return-value transfer-ownership="none">
42937         <doc xml:whitespace="preserve">An identifier (never 0) that an be used with</doc>
42938         <type name="guint" c:type="guint"/>
42939       </return-value>
42940       <parameters>
42941         <parameter name="connection" transfer-ownership="none">
42942           <doc xml:whitespace="preserve">A #GDBusConnection.</doc>
42943           <type name="DBusConnection" c:type="GDBusConnection*"/>
42944         </parameter>
42945         <parameter name="name" transfer-ownership="none">
42946           <doc xml:whitespace="preserve">The well-known name to own.</doc>
42947           <type name="utf8" c:type="gchar*"/>
42948         </parameter>
42949         <parameter name="flags" transfer-ownership="none">
42950           <doc xml:whitespace="preserve">A set of flags from the #GBusNameOwnerFlags enumeration.</doc>
42951           <type name="BusNameOwnerFlags" c:type="GBusNameOwnerFlags"/>
42952         </parameter>
42953         <parameter name="name_acquired_handler" transfer-ownership="none">
42954           <doc xml:whitespace="preserve">Handler to invoke when @name is acquired or %NULL.</doc>
42955           <type name="BusNameAcquiredCallback"
42956                 c:type="GBusNameAcquiredCallback"/>
42957         </parameter>
42958         <parameter name="name_lost_handler"
42959                    transfer-ownership="none"
42960                    scope="notified"
42961                    closure="5"
42962                    destroy="6">
42963           <doc xml:whitespace="preserve">Handler to invoke when @name is lost or %NULL.</doc>
42964           <type name="BusNameLostCallback" c:type="GBusNameLostCallback"/>
42965         </parameter>
42966         <parameter name="user_data" transfer-ownership="none">
42967           <doc xml:whitespace="preserve">User data to pass to handlers.</doc>
42968           <type name="gpointer" c:type="gpointer"/>
42969         </parameter>
42970         <parameter name="user_data_free_func"
42971                    transfer-ownership="none"
42972                    scope="async">
42973           <doc xml:whitespace="preserve">Function for freeing @user_data or %NULL.</doc>
42974           <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
42975         </parameter>
42976       </parameters>
42977     </function>
42978     <function name="bus_own_name_on_connection_with_closures"
42979               c:identifier="g_bus_own_name_on_connection_with_closures"
42980               shadows="bus_own_name_on_connection"
42981               version="2.26">
42982       <doc xml:whitespace="preserve">Version of g_bus_own_name_on_connection() using closures instead of callbacks for
42983 easier binding in other languages.
42984 g_bus_unown_name() to stop owning the name.</doc>
42985       <return-value transfer-ownership="none">
42986         <doc xml:whitespace="preserve">An identifier (never 0) that an be used with</doc>
42987         <type name="guint" c:type="guint"/>
42988       </return-value>
42989       <parameters>
42990         <parameter name="connection" transfer-ownership="none">
42991           <doc xml:whitespace="preserve">A #GDBusConnection.</doc>
42992           <type name="DBusConnection" c:type="GDBusConnection*"/>
42993         </parameter>
42994         <parameter name="name" transfer-ownership="none">
42995           <doc xml:whitespace="preserve">The well-known name to own.</doc>
42996           <type name="utf8" c:type="gchar*"/>
42997         </parameter>
42998         <parameter name="flags" transfer-ownership="none">
42999           <doc xml:whitespace="preserve">A set of flags from the #GBusNameOwnerFlags enumeration.</doc>
43000           <type name="BusNameOwnerFlags" c:type="GBusNameOwnerFlags"/>
43001         </parameter>
43002         <parameter name="name_acquired_closure"
43003                    transfer-ownership="none"
43004                    allow-none="1">
43005           <doc xml:whitespace="preserve">#GClosure to invoke when @name is acquired or %NULL.</doc>
43006           <type name="GObject.Closure" c:type="GClosure*"/>
43007         </parameter>
43008         <parameter name="name_lost_closure"
43009                    transfer-ownership="none"
43010                    allow-none="1">
43011           <doc xml:whitespace="preserve">#GClosure to invoke when @name is lost or %NULL.</doc>
43012           <type name="GObject.Closure" c:type="GClosure*"/>
43013         </parameter>
43014       </parameters>
43015     </function>
43016     <function name="bus_own_name_with_closures"
43017               c:identifier="g_bus_own_name_with_closures"
43018               shadows="bus_own_name"
43019               version="2.26">
43020       <doc xml:whitespace="preserve">Version of g_bus_own_name() using closures instead of callbacks for
43021 easier binding in other languages.
43022 g_bus_unown_name() to stop owning the name.</doc>
43023       <return-value transfer-ownership="none">
43024         <doc xml:whitespace="preserve">An identifier (never 0) that an be used with</doc>
43025         <type name="guint" c:type="guint"/>
43026       </return-value>
43027       <parameters>
43028         <parameter name="bus_type" transfer-ownership="none">
43029           <doc xml:whitespace="preserve">The type of bus to own a name on.</doc>
43030           <type name="BusType" c:type="GBusType"/>
43031         </parameter>
43032         <parameter name="name" transfer-ownership="none">
43033           <doc xml:whitespace="preserve">The well-known name to own.</doc>
43034           <type name="utf8" c:type="gchar*"/>
43035         </parameter>
43036         <parameter name="flags" transfer-ownership="none">
43037           <doc xml:whitespace="preserve">A set of flags from the #GBusNameOwnerFlags enumeration.</doc>
43038           <type name="BusNameOwnerFlags" c:type="GBusNameOwnerFlags"/>
43039         </parameter>
43040         <parameter name="bus_acquired_closure"
43041                    transfer-ownership="none"
43042                    allow-none="1">
43043           <doc xml:whitespace="preserve">#GClosure to invoke when connected to the bus of type @bus_type or %NULL.</doc>
43044           <type name="GObject.Closure" c:type="GClosure*"/>
43045         </parameter>
43046         <parameter name="name_acquired_closure"
43047                    transfer-ownership="none"
43048                    allow-none="1">
43049           <doc xml:whitespace="preserve">#GClosure to invoke when @name is acquired or %NULL.</doc>
43050           <type name="GObject.Closure" c:type="GClosure*"/>
43051         </parameter>
43052         <parameter name="name_lost_closure"
43053                    transfer-ownership="none"
43054                    allow-none="1">
43055           <doc xml:whitespace="preserve">#GClosure to invoke when @name is lost or %NULL.</doc>
43056           <type name="GObject.Closure" c:type="GClosure*"/>
43057         </parameter>
43058       </parameters>
43059     </function>
43060     <function name="bus_unown_name"
43061               c:identifier="g_bus_unown_name"
43062               version="2.26">
43063       <doc xml:whitespace="preserve">Stops owning a name.</doc>
43064       <return-value transfer-ownership="none">
43065         <type name="none" c:type="void"/>
43066       </return-value>
43067       <parameters>
43068         <parameter name="owner_id" transfer-ownership="none">
43069           <doc xml:whitespace="preserve">An identifier obtained from g_bus_own_name()</doc>
43070           <type name="guint" c:type="guint"/>
43071         </parameter>
43072       </parameters>
43073     </function>
43074     <function name="bus_unwatch_name"
43075               c:identifier="g_bus_unwatch_name"
43076               version="2.26">
43077       <doc xml:whitespace="preserve">Stops watching a name.</doc>
43078       <return-value transfer-ownership="none">
43079         <type name="none" c:type="void"/>
43080       </return-value>
43081       <parameters>
43082         <parameter name="watcher_id" transfer-ownership="none">
43083           <doc xml:whitespace="preserve">An identifier obtained from g_bus_watch_name()</doc>
43084           <type name="guint" c:type="guint"/>
43085         </parameter>
43086       </parameters>
43087     </function>
43088     <function name="bus_watch_name"
43089               c:identifier="g_bus_watch_name"
43090               shadowed-by="bus_watch_name_with_closures"
43091               version="2.26"
43092               introspectable="0">
43093       <doc xml:whitespace="preserve">Starts watching @name on the bus specified by @bus_type and calls
43094 known to have a owner respectively known to lose its
43095 owner. Callbacks will be invoked in the &lt;link
43096 linkend="g-main-context-push-thread-default"&gt;thread-default main
43097 loop&lt;/link&gt; of the thread you are calling this function from.
43098 You are guaranteed that one of the handlers will be invoked after
43099 calling this function. When you are done watching the name, just
43100 call g_bus_unwatch_name() with the watcher id this function
43101 returns.
43102 If the name vanishes or appears (for example the application owning
43103 the name could restart), the handlers are also invoked. If the
43104 #GDBusConnection that is used for watching the name disconnects, then
43105 possible to access the name.
43106 Another guarantee is that invocations of @name_appeared_handler
43107 and @name_vanished_handler are guaranteed to alternate; that
43108 is, if @name_appeared_handler is invoked then you are
43109 guaranteed that the next time one of the handlers is invoked, it
43110 will be @name_vanished_handler. The reverse is also true.
43111 This behavior makes it very simple to write applications that wants
43112 to take action when a certain name exists, see &lt;xref
43113 linkend="gdbus-watching-names"/&gt;. Basically, the application
43114 should create object proxies in @name_appeared_handler and destroy
43115 them again (if any) in @name_vanished_handler.
43116 g_bus_unwatch_name() to stop watching the name.</doc>
43117       <return-value transfer-ownership="none">
43118         <doc xml:whitespace="preserve">An identifier (never 0) that an be used with</doc>
43119         <type name="guint" c:type="guint"/>
43120       </return-value>
43121       <parameters>
43122         <parameter name="bus_type" transfer-ownership="none">
43123           <doc xml:whitespace="preserve">The type of bus to watch a name on.</doc>
43124           <type name="BusType" c:type="GBusType"/>
43125         </parameter>
43126         <parameter name="name" transfer-ownership="none">
43127           <doc xml:whitespace="preserve">The name (well-known or unique) to watch.</doc>
43128           <type name="utf8" c:type="gchar*"/>
43129         </parameter>
43130         <parameter name="flags" transfer-ownership="none">
43131           <doc xml:whitespace="preserve">Flags from the #GBusNameWatcherFlags enumeration.</doc>
43132           <type name="BusNameWatcherFlags" c:type="GBusNameWatcherFlags"/>
43133         </parameter>
43134         <parameter name="name_appeared_handler" transfer-ownership="none">
43135           <doc xml:whitespace="preserve">Handler to invoke when @name is known to exist or %NULL.</doc>
43136           <type name="BusNameAppearedCallback"
43137                 c:type="GBusNameAppearedCallback"/>
43138         </parameter>
43139         <parameter name="name_vanished_handler"
43140                    transfer-ownership="none"
43141                    scope="notified"
43142                    closure="5"
43143                    destroy="6">
43144           <doc xml:whitespace="preserve">Handler to invoke when @name is known to not exist or %NULL.</doc>
43145           <type name="BusNameVanishedCallback"
43146                 c:type="GBusNameVanishedCallback"/>
43147         </parameter>
43148         <parameter name="user_data" transfer-ownership="none">
43149           <doc xml:whitespace="preserve">User data to pass to handlers.</doc>
43150           <type name="gpointer" c:type="gpointer"/>
43151         </parameter>
43152         <parameter name="user_data_free_func"
43153                    transfer-ownership="none"
43154                    scope="async">
43155           <doc xml:whitespace="preserve">Function for freeing @user_data or %NULL.</doc>
43156           <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
43157         </parameter>
43158       </parameters>
43159     </function>
43160     <function name="bus_watch_name_on_connection"
43161               c:identifier="g_bus_watch_name_on_connection"
43162               shadowed-by="bus_watch_name_on_connection_with_closures"
43163               version="2.26"
43164               introspectable="0">
43165       <doc xml:whitespace="preserve">Like g_bus_watch_name() but takes a #GDBusConnection instead of a
43166 #GBusType.
43167 g_bus_unwatch_name() to stop watching the name.</doc>
43168       <return-value transfer-ownership="none">
43169         <doc xml:whitespace="preserve">An identifier (never 0) that an be used with</doc>
43170         <type name="guint" c:type="guint"/>
43171       </return-value>
43172       <parameters>
43173         <parameter name="connection" transfer-ownership="none">
43174           <doc xml:whitespace="preserve">A #GDBusConnection.</doc>
43175           <type name="DBusConnection" c:type="GDBusConnection*"/>
43176         </parameter>
43177         <parameter name="name" transfer-ownership="none">
43178           <doc xml:whitespace="preserve">The name (well-known or unique) to watch.</doc>
43179           <type name="utf8" c:type="gchar*"/>
43180         </parameter>
43181         <parameter name="flags" transfer-ownership="none">
43182           <doc xml:whitespace="preserve">Flags from the #GBusNameWatcherFlags enumeration.</doc>
43183           <type name="BusNameWatcherFlags" c:type="GBusNameWatcherFlags"/>
43184         </parameter>
43185         <parameter name="name_appeared_handler" transfer-ownership="none">
43186           <doc xml:whitespace="preserve">Handler to invoke when @name is known to exist or %NULL.</doc>
43187           <type name="BusNameAppearedCallback"
43188                 c:type="GBusNameAppearedCallback"/>
43189         </parameter>
43190         <parameter name="name_vanished_handler"
43191                    transfer-ownership="none"
43192                    scope="notified"
43193                    closure="5"
43194                    destroy="6">
43195           <doc xml:whitespace="preserve">Handler to invoke when @name is known to not exist or %NULL.</doc>
43196           <type name="BusNameVanishedCallback"
43197                 c:type="GBusNameVanishedCallback"/>
43198         </parameter>
43199         <parameter name="user_data" transfer-ownership="none">
43200           <doc xml:whitespace="preserve">User data to pass to handlers.</doc>
43201           <type name="gpointer" c:type="gpointer"/>
43202         </parameter>
43203         <parameter name="user_data_free_func"
43204                    transfer-ownership="none"
43205                    scope="async">
43206           <doc xml:whitespace="preserve">Function for freeing @user_data or %NULL.</doc>
43207           <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
43208         </parameter>
43209       </parameters>
43210     </function>
43211     <function name="bus_watch_name_on_connection_with_closures"
43212               c:identifier="g_bus_watch_name_on_connection_with_closures"
43213               shadows="bus_watch_name_on_connection"
43214               version="2.26">
43215       <doc xml:whitespace="preserve">Version of g_bus_watch_name_on_connection() using closures instead of callbacks for
43216 easier binding in other languages.
43217 g_bus_unwatch_name() to stop watching the name.</doc>
43218       <return-value transfer-ownership="none">
43219         <doc xml:whitespace="preserve">An identifier (never 0) that an be used with</doc>
43220         <type name="guint" c:type="guint"/>
43221       </return-value>
43222       <parameters>
43223         <parameter name="connection" transfer-ownership="none">
43224           <doc xml:whitespace="preserve">A #GDBusConnection.</doc>
43225           <type name="DBusConnection" c:type="GDBusConnection*"/>
43226         </parameter>
43227         <parameter name="name" transfer-ownership="none">
43228           <doc xml:whitespace="preserve">The name (well-known or unique) to watch.</doc>
43229           <type name="utf8" c:type="gchar*"/>
43230         </parameter>
43231         <parameter name="flags" transfer-ownership="none">
43232           <doc xml:whitespace="preserve">Flags from the #GBusNameWatcherFlags enumeration.</doc>
43233           <type name="BusNameWatcherFlags" c:type="GBusNameWatcherFlags"/>
43234         </parameter>
43235         <parameter name="name_appeared_closure"
43236                    transfer-ownership="none"
43237                    allow-none="1">
43238           <doc xml:whitespace="preserve">#GClosure to invoke when @name is known to exist or %NULL.</doc>
43239           <type name="GObject.Closure" c:type="GClosure*"/>
43240         </parameter>
43241         <parameter name="name_vanished_closure"
43242                    transfer-ownership="none"
43243                    allow-none="1">
43244           <doc xml:whitespace="preserve">#GClosure to invoke when @name is known to not exist or %NULL.</doc>
43245           <type name="GObject.Closure" c:type="GClosure*"/>
43246         </parameter>
43247       </parameters>
43248     </function>
43249     <function name="bus_watch_name_with_closures"
43250               c:identifier="g_bus_watch_name_with_closures"
43251               shadows="bus_watch_name"
43252               version="2.26">
43253       <doc xml:whitespace="preserve">Version of g_bus_watch_name() using closures instead of callbacks for
43254 easier binding in other languages.
43255 g_bus_unwatch_name() to stop watching the name.</doc>
43256       <return-value transfer-ownership="none">
43257         <doc xml:whitespace="preserve">An identifier (never 0) that an be used with</doc>
43258         <type name="guint" c:type="guint"/>
43259       </return-value>
43260       <parameters>
43261         <parameter name="bus_type" transfer-ownership="none">
43262           <doc xml:whitespace="preserve">The type of bus to watch a name on.</doc>
43263           <type name="BusType" c:type="GBusType"/>
43264         </parameter>
43265         <parameter name="name" transfer-ownership="none">
43266           <doc xml:whitespace="preserve">The name (well-known or unique) to watch.</doc>
43267           <type name="utf8" c:type="gchar*"/>
43268         </parameter>
43269         <parameter name="flags" transfer-ownership="none">
43270           <doc xml:whitespace="preserve">Flags from the #GBusNameWatcherFlags enumeration.</doc>
43271           <type name="BusNameWatcherFlags" c:type="GBusNameWatcherFlags"/>
43272         </parameter>
43273         <parameter name="name_appeared_closure"
43274                    transfer-ownership="none"
43275                    allow-none="1">
43276           <doc xml:whitespace="preserve">#GClosure to invoke when @name is known to exist or %NULL.</doc>
43277           <type name="GObject.Closure" c:type="GClosure*"/>
43278         </parameter>
43279         <parameter name="name_vanished_closure"
43280                    transfer-ownership="none"
43281                    allow-none="1">
43282           <doc xml:whitespace="preserve">#GClosure to invoke when @name is known to not exist or %NULL.</doc>
43283           <type name="GObject.Closure" c:type="GClosure*"/>
43284         </parameter>
43285       </parameters>
43286     </function>
43287     <function name="content_type_can_be_executable"
43288               c:identifier="g_content_type_can_be_executable">
43289       <doc xml:whitespace="preserve">Checks if a content type can be executable. Note that for instance
43290 things like text files can be executables (i.e. scripts and batch files).
43291 can be executable, %FALSE otherwise.</doc>
43292       <return-value transfer-ownership="none">
43293         <doc xml:whitespace="preserve">%TRUE if the file type corresponds to a type that</doc>
43294         <type name="gboolean" c:type="gboolean"/>
43295       </return-value>
43296       <parameters>
43297         <parameter name="type" transfer-ownership="none">
43298           <doc xml:whitespace="preserve">a content type string</doc>
43299           <type name="utf8" c:type="gchar*"/>
43300         </parameter>
43301       </parameters>
43302     </function>
43303     <function name="content_type_equals" c:identifier="g_content_type_equals">
43304       <doc xml:whitespace="preserve">Compares two content types for equality.
43305 %FALSE otherwise.</doc>
43306       <return-value transfer-ownership="none">
43307         <doc xml:whitespace="preserve">%TRUE if the two strings are identical or equivalent,</doc>
43308         <type name="gboolean" c:type="gboolean"/>
43309       </return-value>
43310       <parameters>
43311         <parameter name="type1" transfer-ownership="none">
43312           <doc xml:whitespace="preserve">a content type string</doc>
43313           <type name="utf8" c:type="gchar*"/>
43314         </parameter>
43315         <parameter name="type2" transfer-ownership="none">
43316           <doc xml:whitespace="preserve">a content type string</doc>
43317           <type name="utf8" c:type="gchar*"/>
43318         </parameter>
43319       </parameters>
43320     </function>
43321     <function name="content_type_from_mime_type"
43322               c:identifier="g_content_type_from_mime_type"
43323               version="2.18">
43324       <doc xml:whitespace="preserve">Tries to find a content type based on the mime type name.
43325 or %NULL. Free with g_free()</doc>
43326       <return-value transfer-ownership="full">
43327         <doc xml:whitespace="preserve">Newly allocated string with content type</doc>
43328         <type name="utf8" c:type="gchar*"/>
43329       </return-value>
43330       <parameters>
43331         <parameter name="mime_type" transfer-ownership="none">
43332           <doc xml:whitespace="preserve">a mime type string</doc>
43333           <type name="utf8" c:type="gchar*"/>
43334         </parameter>
43335       </parameters>
43336     </function>
43337     <function name="content_type_get_description"
43338               c:identifier="g_content_type_get_description">
43339       <doc xml:whitespace="preserve">Gets the human readable description of the content type.
43340 returned string with g_free()</doc>
43341       <return-value transfer-ownership="full">
43342         <doc xml:whitespace="preserve">a short description of the content type @type. Free the</doc>
43343         <type name="utf8" c:type="gchar*"/>
43344       </return-value>
43345       <parameters>
43346         <parameter name="type" transfer-ownership="none">
43347           <doc xml:whitespace="preserve">a content type string</doc>
43348           <type name="utf8" c:type="gchar*"/>
43349         </parameter>
43350       </parameters>
43351     </function>
43352     <function name="content_type_get_icon"
43353               c:identifier="g_content_type_get_icon">
43354       <doc xml:whitespace="preserve">Gets the icon for a content type.
43355 object with g_object_unref()</doc>
43356       <return-value transfer-ownership="full">
43357         <doc xml:whitespace="preserve">#GIcon corresponding to the content type. Free the returned</doc>
43358         <type name="Icon" c:type="GIcon*"/>
43359       </return-value>
43360       <parameters>
43361         <parameter name="type" transfer-ownership="none">
43362           <doc xml:whitespace="preserve">a content type string</doc>
43363           <type name="utf8" c:type="gchar*"/>
43364         </parameter>
43365       </parameters>
43366     </function>
43367     <function name="content_type_get_mime_type"
43368               c:identifier="g_content_type_get_mime_type">
43369       <doc xml:whitespace="preserve">Gets the mime type for the content type, if one is registered.
43370 or %NULL if unknown.</doc>
43371       <return-value transfer-ownership="full">
43372         <doc xml:whitespace="preserve">the registered mime type for the given @type,</doc>
43373         <type name="utf8" c:type="gchar*"/>
43374       </return-value>
43375       <parameters>
43376         <parameter name="type" transfer-ownership="none">
43377           <doc xml:whitespace="preserve">a content type string</doc>
43378           <type name="utf8" c:type="gchar*"/>
43379         </parameter>
43380       </parameters>
43381     </function>
43382     <function name="content_type_guess" c:identifier="g_content_type_guess">
43383       <doc xml:whitespace="preserve">Guesses the content type based on example data. If the function is
43384 uncertain, @result_uncertain will be set to %TRUE. Either @filename
43385 or @data may be %NULL, in which case the guess will be based solely
43386 on the other argument.
43387 given data. Free with g_free()</doc>
43388       <return-value transfer-ownership="full">
43389         <doc xml:whitespace="preserve">a string indicating a guessed content type for the</doc>
43390         <type name="utf8" c:type="gchar*"/>
43391       </return-value>
43392       <parameters>
43393         <parameter name="filename" transfer-ownership="none" allow-none="1">
43394           <doc xml:whitespace="preserve">a string, or %NULL</doc>
43395           <type name="utf8" c:type="gchar*"/>
43396         </parameter>
43397         <parameter name="data" transfer-ownership="none" allow-none="1">
43398           <doc xml:whitespace="preserve">a stream of data, or %NULL</doc>
43399           <array length="2" c:type="guchar*">
43400             <type name="guint8"/>
43401           </array>
43402         </parameter>
43403         <parameter name="data_size" transfer-ownership="none">
43404           <doc xml:whitespace="preserve">the size of @data</doc>
43405           <type name="gulong" c:type="gsize"/>
43406         </parameter>
43407         <parameter name="result_uncertain"
43408                    direction="out"
43409                    caller-allocates="0"
43410                    transfer-ownership="full"
43411                    allow-none="1">
43412           <doc xml:whitespace="preserve">return location for the certainty of the result, or %NULL</doc>
43413           <type name="gboolean" c:type="gboolean*"/>
43414         </parameter>
43415       </parameters>
43416     </function>
43417     <function name="content_type_guess_for_tree"
43418               c:identifier="g_content_type_guess_for_tree"
43419               version="2.18">
43420       <doc xml:whitespace="preserve">Tries to guess the type of the tree with root @root, by
43421 looking at the files it contains. The result is an array
43422 of content types, with the best guess coming first.
43423 The types returned all have the form x-content/foo, e.g.
43424 x-content/audio-cdda (for audio CDs) or x-content/image-dcf
43425 (for a camera memory card). See the &lt;ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec"&gt;shared-mime-info&lt;/ulink&gt;
43426 specification for more on x-content types.
43427 This function is useful in the implementation of
43428 g_mount_guess_content_type().
43429 or %NULL. Free with g_strfreev()</doc>
43430       <return-value transfer-ownership="full">
43431         <doc xml:whitespace="preserve">an %NULL-terminated array of zero or more content types,</doc>
43432         <array c:type="gchar**">
43433           <type name="utf8"/>
43434         </array>
43435       </return-value>
43436       <parameters>
43437         <parameter name="root" transfer-ownership="none">
43438           <doc xml:whitespace="preserve">the root of the tree to guess a type for</doc>
43439           <type name="File" c:type="GFile*"/>
43440         </parameter>
43441       </parameters>
43442     </function>
43443     <function name="content_type_is_a" c:identifier="g_content_type_is_a">
43444       <doc xml:whitespace="preserve">Determines if @type is a subset of @supertype.
43445 %FALSE otherwise.</doc>
43446       <return-value transfer-ownership="none">
43447         <doc xml:whitespace="preserve">%TRUE if @type is a kind of @supertype,</doc>
43448         <type name="gboolean" c:type="gboolean"/>
43449       </return-value>
43450       <parameters>
43451         <parameter name="type" transfer-ownership="none">
43452           <doc xml:whitespace="preserve">a content type string</doc>
43453           <type name="utf8" c:type="gchar*"/>
43454         </parameter>
43455         <parameter name="supertype" transfer-ownership="none">
43456           <doc xml:whitespace="preserve">a content type string</doc>
43457           <type name="utf8" c:type="gchar*"/>
43458         </parameter>
43459       </parameters>
43460     </function>
43461     <function name="content_type_is_unknown"
43462               c:identifier="g_content_type_is_unknown">
43463       <doc xml:whitespace="preserve">Checks if the content type is the generic "unknown" type.
43464 On UNIX this is the "application/octet-stream" mimetype,
43465 while on win32 it is "*".</doc>
43466       <return-value transfer-ownership="none">
43467         <doc xml:whitespace="preserve">%TRUE if the type is the unknown type.</doc>
43468         <type name="gboolean" c:type="gboolean"/>
43469       </return-value>
43470       <parameters>
43471         <parameter name="type" transfer-ownership="none">
43472           <doc xml:whitespace="preserve">a content type string</doc>
43473           <type name="utf8" c:type="gchar*"/>
43474         </parameter>
43475       </parameters>
43476     </function>
43477     <function name="content_types_get_registered"
43478               c:identifier="g_content_types_get_registered">
43479       <doc xml:whitespace="preserve">Gets a list of strings containing all the registered content types
43480 known to the system. The list and its data should be freed using
43481 &lt;programlisting&gt;
43482 g_list_foreach (list, g_free, NULL);
43483 g_list_free (list);
43484 &lt;/programlisting&gt;</doc>
43485       <return-value transfer-ownership="full">
43486         <doc xml:whitespace="preserve">#GList of the registered content types</doc>
43487         <type name="GLib.List" c:type="GList*">
43488           <type name="utf8"/>
43489         </type>
43490       </return-value>
43491     </function>
43492     <function name="dbus_address_get_for_bus_sync"
43493               c:identifier="g_dbus_address_get_for_bus_sync"
43494               version="2.26"
43495               throws="1">
43496       <doc xml:whitespace="preserve">Synchronously looks up the D-Bus address for the well-known message
43497 bus instance specified by @bus_type. This may involve using various
43498 platform specific mechanisms.</doc>
43499       <return-value transfer-ownership="full">
43500         <doc xml:whitespace="preserve">A valid D-Bus address string for @bus_type or %NULL if @error is set.</doc>
43501         <type name="utf8" c:type="gchar*"/>
43502       </return-value>
43503       <parameters>
43504         <parameter name="bus_type" transfer-ownership="none">
43505           <doc xml:whitespace="preserve">A #GBusType.</doc>
43506           <type name="BusType" c:type="GBusType"/>
43507         </parameter>
43508         <parameter name="cancellable" transfer-ownership="none" allow-none="1">
43509           <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
43510           <type name="Cancellable" c:type="GCancellable*"/>
43511         </parameter>
43512       </parameters>
43513     </function>
43514     <function name="dbus_address_get_stream"
43515               c:identifier="g_dbus_address_get_stream"
43516               version="2.26">
43517       <doc xml:whitespace="preserve">Asynchronously connects to an endpoint specified by @address and
43518 sets up the connection so it is in a state to run the client-side
43519 of the D-Bus authentication conversation.
43520 When the operation is finished, @callback will be invoked. You can
43521 then call g_dbus_address_get_stream_finish() to get the result of
43522 the operation.
43523 This is an asynchronous failable function. See
43524 g_dbus_address_get_stream_sync() for the synchronous version.</doc>
43525       <return-value transfer-ownership="none">
43526         <type name="none" c:type="void"/>
43527       </return-value>
43528       <parameters>
43529         <parameter name="address" transfer-ownership="none">
43530           <doc xml:whitespace="preserve">A valid D-Bus address.</doc>
43531           <type name="utf8" c:type="gchar*"/>
43532         </parameter>
43533         <parameter name="cancellable" transfer-ownership="none" allow-none="1">
43534           <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
43535           <type name="Cancellable" c:type="GCancellable*"/>
43536         </parameter>
43537         <parameter name="callback"
43538                    transfer-ownership="none"
43539                    scope="async"
43540                    closure="3">
43541           <doc xml:whitespace="preserve">A #GAsyncReadyCallback to call when the request is satisfied.</doc>
43542           <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
43543         </parameter>
43544         <parameter name="user_data" transfer-ownership="none">
43545           <doc xml:whitespace="preserve">Data to pass to @callback.</doc>
43546           <type name="gpointer" c:type="gpointer"/>
43547         </parameter>
43548       </parameters>
43549     </function>
43550     <function name="dbus_address_get_stream_finish"
43551               c:identifier="g_dbus_address_get_stream_finish"
43552               version="2.26"
43553               throws="1">
43554       <doc xml:whitespace="preserve">Finishes an operation started with g_dbus_address_get_stream().</doc>
43555       <return-value transfer-ownership="full">
43556         <doc xml:whitespace="preserve">A #GIOStream or %NULL if @error is set.</doc>
43557         <type name="IOStream" c:type="GIOStream*"/>
43558       </return-value>
43559       <parameters>
43560         <parameter name="res" transfer-ownership="none">
43561           <doc xml:whitespace="preserve">A #GAsyncResult obtained from the GAsyncReadyCallback passed to g_dbus_address_get_stream().</doc>
43562           <type name="AsyncResult" c:type="GAsyncResult*"/>
43563         </parameter>
43564         <parameter name="out_guid" transfer-ownership="none">
43565           <doc xml:whitespace="preserve">%NULL or return location to store the GUID extracted from @address, if any.</doc>
43566           <type name="utf8" c:type="gchar**"/>
43567         </parameter>
43568       </parameters>
43569     </function>
43570     <function name="dbus_address_get_stream_sync"
43571               c:identifier="g_dbus_address_get_stream_sync"
43572               version="2.26"
43573               throws="1">
43574       <doc xml:whitespace="preserve">Synchronously connects to an endpoint specified by @address and
43575 sets up the connection so it is in a state to run the client-side
43576 of the D-Bus authentication conversation.
43577 This is a synchronous failable function. See
43578 g_dbus_address_get_stream() for the asynchronous version.</doc>
43579       <return-value transfer-ownership="full">
43580         <doc xml:whitespace="preserve">A #GIOStream or %NULL if @error is set.</doc>
43581         <type name="IOStream" c:type="GIOStream*"/>
43582       </return-value>
43583       <parameters>
43584         <parameter name="address" transfer-ownership="none">
43585           <doc xml:whitespace="preserve">A valid D-Bus address.</doc>
43586           <type name="utf8" c:type="gchar*"/>
43587         </parameter>
43588         <parameter name="out_guid" transfer-ownership="none">
43589           <doc xml:whitespace="preserve">%NULL or return location to store the GUID extracted from @address, if any.</doc>
43590           <type name="utf8" c:type="gchar**"/>
43591         </parameter>
43592         <parameter name="cancellable" transfer-ownership="none" allow-none="1">
43593           <doc xml:whitespace="preserve">A #GCancellable or %NULL.</doc>
43594           <type name="Cancellable" c:type="GCancellable*"/>
43595         </parameter>
43596       </parameters>
43597     </function>
43598     <function name="dbus_annotation_info_lookup"
43599               c:identifier="g_dbus_annotation_info_lookup"
43600               version="2.26">
43601       <doc xml:whitespace="preserve">Looks up the value of an annotation.
43602 This cost of this function is O(n) in number of annotations.</doc>
43603       <return-value transfer-ownership="none">
43604         <doc xml:whitespace="preserve">The value or %NULL if not found. Do not free, it is owned by @annotations.</doc>
43605         <type name="utf8" c:type="gchar*"/>
43606       </return-value>
43607       <parameters>
43608         <parameter name="annotations" transfer-ownership="none">
43609           <doc xml:whitespace="preserve">A %NULL-terminated array of annotations or %NULL.</doc>
43610           <type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo**"/>
43611         </parameter>
43612         <parameter name="name" transfer-ownership="none">
43613           <doc xml:whitespace="preserve">The name of the annotation to look up.</doc>
43614           <type name="utf8" c:type="gchar*"/>
43615         </parameter>
43616       </parameters>
43617     </function>
43618     <function name="dbus_error_encode_gerror"
43619               c:identifier="g_dbus_error_encode_gerror"
43620               version="2.26">
43621       <doc xml:whitespace="preserve">Creates a D-Bus error name to use for @error. If @error matches
43622 a registered error (cf. g_dbus_error_register_error()), the corresponding
43623 D-Bus error name will be returned.
43624 Otherwise the a name of the form
43625 &lt;literal&gt;org.gtk.GDBus.UnmappedGError.Quark._ESCAPED_QUARK_NAME.Code_ERROR_CODE&lt;/literal&gt;
43626 will be used. This allows other GDBus applications to map the error
43627 on the wire back to a #GError using g_dbus_error_new_for_dbus_error().
43628 This function is typically only used in object mappings to put a
43629 #GError on the wire. Regular applications should not use it.</doc>
43630       <return-value transfer-ownership="full">
43631         <doc xml:whitespace="preserve">A D-Bus error name (never %NULL). Free with g_free().</doc>
43632         <type name="utf8" c:type="gchar*"/>
43633       </return-value>
43634       <parameters>
43635         <parameter name="error" transfer-ownership="none">
43636           <doc xml:whitespace="preserve">A #GError.</doc>
43637           <type name="GLib.Error" c:type="GError*"/>
43638         </parameter>
43639       </parameters>
43640     </function>
43641     <function name="dbus_error_get_remote_error"
43642               c:identifier="g_dbus_error_get_remote_error"
43643               version="2.26">
43644       <doc xml:whitespace="preserve">Gets the D-Bus error name used for @error, if any.
43645 This function is guaranteed to return a D-Bus error name for all
43646 #GError&lt;!-- --&gt;s returned from functions handling remote method
43647 calls (e.g. g_dbus_connection_call_finish()) unless
43648 g_dbus_error_strip_remote_error() has been used on @error.</doc>
43649       <return-value transfer-ownership="full">
43650         <doc xml:whitespace="preserve">An allocated string or %NULL if the D-Bus error name could not be found. Free with g_free().</doc>
43651         <type name="utf8" c:type="gchar*"/>
43652       </return-value>
43653       <parameters>
43654         <parameter name="error" transfer-ownership="none">
43655           <doc xml:whitespace="preserve">A #GError.</doc>
43656           <type name="GLib.Error" c:type="GError*"/>
43657         </parameter>
43658       </parameters>
43659     </function>
43660     <function name="dbus_error_is_remote_error"
43661               c:identifier="g_dbus_error_is_remote_error"
43662               version="2.26">
43663       <doc xml:whitespace="preserve">Checks if @error represents an error received via D-Bus from a remote peer. If so,
43664 use g_dbus_error_get_remote_error() to get the name of the error.
43665 %FALSE otherwise.</doc>
43666       <return-value transfer-ownership="none">
43667         <doc xml:whitespace="preserve">%TRUE if @error represents an error from a remote peer,</doc>
43668         <type name="gboolean" c:type="gboolean"/>
43669       </return-value>
43670       <parameters>
43671         <parameter name="error" transfer-ownership="none">
43672           <doc xml:whitespace="preserve">A #GError.</doc>
43673           <type name="GLib.Error" c:type="GError*"/>
43674         </parameter>
43675       </parameters>
43676     </function>
43677     <function name="dbus_error_new_for_dbus_error"
43678               c:identifier="g_dbus_error_new_for_dbus_error"
43679               version="2.26"
43680               introspectable="0">
43681       <doc xml:whitespace="preserve">Creates a #GError based on the contents of @dbus_error_name and
43682 Errors registered with g_dbus_error_register_error() will be looked
43683 up using @dbus_error_name and if a match is found, the error domain
43684 and code is used. Applications can use g_dbus_error_get_remote_error()
43685 to recover @dbus_error_name.
43686 If a match against a registered error is not found and the D-Bus
43687 error name is in a form as returned by g_dbus_error_encode_gerror()
43688 the error domain and code encoded in the name is used to
43689 create the #GError. Also, @dbus_error_name is added to the error message
43690 such that it can be recovered with g_dbus_error_get_remote_error().
43691 Otherwise, a #GError with the error code %G_IO_ERROR_DBUS_ERROR
43692 in the #G_IO_ERROR error domain is returned. Also, @dbus_error_name is
43693 added to the error message such that it can be recovered with
43694 g_dbus_error_get_remote_error().
43695 In all three cases, @dbus_error_name can always be recovered from the
43696 returned #GError using the g_dbus_error_get_remote_error() function
43697 (unless g_dbus_error_strip_remote_error() hasn't been used on the returned error).
43698 This function is typically only used in object mappings to prepare
43699 #GError instances for applications. Regular applications should not use
43700 it.</doc>
43701       <return-value>
43702         <doc xml:whitespace="preserve">An allocated #GError. Free with g_error_free().</doc>
43703         <type name="GLib.Error" c:type="GError*"/>
43704       </return-value>
43705       <parameters>
43706         <parameter name="dbus_error_name" transfer-ownership="none">
43707           <doc xml:whitespace="preserve">D-Bus error name.</doc>
43708           <type name="utf8" c:type="gchar*"/>
43709         </parameter>
43710         <parameter name="dbus_error_message" transfer-ownership="none">
43711           <doc xml:whitespace="preserve">D-Bus error message.</doc>
43712           <type name="utf8" c:type="gchar*"/>
43713         </parameter>
43714       </parameters>
43715     </function>
43716     <function name="dbus_error_quark" c:identifier="g_dbus_error_quark">
43717       <return-value transfer-ownership="none">
43718         <type name="GLib.Quark" c:type="GQuark"/>
43719       </return-value>
43720     </function>
43721     <function name="dbus_error_register_error"
43722               c:identifier="g_dbus_error_register_error"
43723               version="2.26">
43724       <doc xml:whitespace="preserve">Creates an association to map between @dbus_error_name and
43725 #GError&lt;!-- --&gt;s specified by @error_domain and @error_code.
43726 This is typically done in the routine that returns the #GQuark for
43727 an error domain.
43728 exists.</doc>
43729       <return-value transfer-ownership="none">
43730         <doc xml:whitespace="preserve">%TRUE if the association was created, %FALSE if it already</doc>
43731         <type name="gboolean" c:type="gboolean"/>
43732       </return-value>
43733       <parameters>
43734         <parameter name="error_domain" transfer-ownership="none">
43735           <doc xml:whitespace="preserve">A #GQuark for a error domain.</doc>
43736           <type name="GLib.Quark" c:type="GQuark"/>
43737         </parameter>
43738         <parameter name="error_code" transfer-ownership="none">
43739           <doc xml:whitespace="preserve">An error code.</doc>
43740           <type name="gint" c:type="gint"/>
43741         </parameter>
43742         <parameter name="dbus_error_name" transfer-ownership="none">
43743           <doc xml:whitespace="preserve">A D-Bus error name.</doc>
43744           <type name="utf8" c:type="gchar*"/>
43745         </parameter>
43746       </parameters>
43747     </function>
43748     <function name="dbus_error_register_error_domain"
43749               c:identifier="g_dbus_error_register_error_domain"
43750               version="2.26">
43751       <doc xml:whitespace="preserve">Helper function for associating a #GError error domain with D-Bus error names.</doc>
43752       <return-value transfer-ownership="none">
43753         <type name="none" c:type="void"/>
43754       </return-value>
43755       <parameters>
43756         <parameter name="error_domain_quark_name" transfer-ownership="none">
43757           <doc xml:whitespace="preserve">The error domain name.</doc>
43758           <type name="utf8" c:type="gchar*"/>
43759         </parameter>
43760         <parameter name="quark_volatile" transfer-ownership="none">
43761           <doc xml:whitespace="preserve">A pointer where to store the #GQuark.</doc>
43762           <type name="gulong" c:type="gsize*"/>
43763         </parameter>
43764         <parameter name="entries" transfer-ownership="none">
43765           <doc xml:whitespace="preserve">A pointer to @num_entries #GDBusErrorEntry struct items.</doc>
43766           <type name="DBusErrorEntry" c:type="GDBusErrorEntry*"/>
43767         </parameter>
43768         <parameter name="num_entries" transfer-ownership="none">
43769           <doc xml:whitespace="preserve">Number of items to register.</doc>
43770           <type name="guint" c:type="guint"/>
43771         </parameter>
43772       </parameters>
43773     </function>
43774     <function name="dbus_error_set_dbus_error"
43775               c:identifier="g_dbus_error_set_dbus_error"
43776               version="2.26"
43777               introspectable="0">
43778       <doc xml:whitespace="preserve">Does nothing if @error is %NULL. Otherwise sets *@error to
43779 a new #GError created with g_dbus_error_new_for_dbus_error()
43780 with @dbus_error_message prepend with @format (unless %NULL).</doc>
43781       <return-value transfer-ownership="none">
43782         <type name="none" c:type="void"/>
43783       </return-value>
43784       <parameters>
43785         <parameter name="error" transfer-ownership="none">
43786           <doc xml:whitespace="preserve">A pointer to a #GError or %NULL.</doc>
43787           <type name="GLib.Error" c:type="GError**"/>
43788         </parameter>
43789         <parameter name="dbus_error_name" transfer-ownership="none">
43790           <doc xml:whitespace="preserve">D-Bus error name.</doc>
43791           <type name="utf8" c:type="gchar*"/>
43792         </parameter>
43793         <parameter name="dbus_error_message" transfer-ownership="none">
43794           <doc xml:whitespace="preserve">D-Bus error message.</doc>
43795           <type name="utf8" c:type="gchar*"/>
43796         </parameter>
43797         <parameter name="format" transfer-ownership="none">
43798           <doc xml:whitespace="preserve">printf()-style format to prepend to @dbus_error_message or %NULL.</doc>
43799           <type name="utf8" c:type="gchar*"/>
43800         </parameter>
43801         <parameter transfer-ownership="none">
43802           <varargs>
43803           </varargs>
43804         </parameter>
43805       </parameters>
43806     </function>
43807     <function name="dbus_error_set_dbus_error_valist"
43808               c:identifier="g_dbus_error_set_dbus_error_valist"
43809               version="2.26"
43810               introspectable="0">
43811       <doc xml:whitespace="preserve">Like g_dbus_error_set_dbus_error() but intended for language bindings.</doc>
43812       <return-value transfer-ownership="none">
43813         <type name="none" c:type="void"/>
43814       </return-value>
43815       <parameters>
43816         <parameter name="error" transfer-ownership="none">
43817           <doc xml:whitespace="preserve">A pointer to a #GError or %NULL.</doc>
43818           <type name="GLib.Error" c:type="GError**"/>
43819         </parameter>
43820         <parameter name="dbus_error_name" transfer-ownership="none">
43821           <doc xml:whitespace="preserve">D-Bus error name.</doc>
43822           <type name="utf8" c:type="gchar*"/>
43823         </parameter>
43824         <parameter name="dbus_error_message" transfer-ownership="none">
43825           <doc xml:whitespace="preserve">D-Bus error message.</doc>
43826           <type name="utf8" c:type="gchar*"/>
43827         </parameter>
43828         <parameter name="format" transfer-ownership="none">
43829           <doc xml:whitespace="preserve">printf()-style format to prepend to @dbus_error_message or %NULL.</doc>
43830           <type name="utf8" c:type="gchar*"/>
43831         </parameter>
43832         <parameter name="var_args" transfer-ownership="none">
43833           <doc xml:whitespace="preserve">Arguments for @format.</doc>
43834           <type name="va_list" c:type="va_list"/>
43835         </parameter>
43836       </parameters>
43837     </function>
43838     <function name="dbus_error_strip_remote_error"
43839               c:identifier="g_dbus_error_strip_remote_error"
43840               version="2.26">
43841       <doc xml:whitespace="preserve">Looks for extra information in the error message used to recover
43842 the D-Bus error name and strips it if found. If stripped, the
43843 message field in @error will correspond exactly to what was
43844 received on the wire.
43845 This is typically used when presenting errors to the end user.</doc>
43846       <return-value transfer-ownership="none">
43847         <doc xml:whitespace="preserve">%TRUE if information was stripped, %FALSE otherwise.</doc>
43848         <type name="gboolean" c:type="gboolean"/>
43849       </return-value>
43850       <parameters>
43851         <parameter name="error" transfer-ownership="none">
43852           <doc xml:whitespace="preserve">A #GError.</doc>
43853           <type name="GLib.Error" c:type="GError*"/>
43854         </parameter>
43855       </parameters>
43856     </function>
43857     <function name="dbus_error_unregister_error"
43858               c:identifier="g_dbus_error_unregister_error"
43859               version="2.26">
43860       <doc xml:whitespace="preserve">Destroys an association previously set up with g_dbus_error_register_error().</doc>
43861       <return-value transfer-ownership="none">
43862         <doc xml:whitespace="preserve">%TRUE if the association was destroyed, %FALSE if it wasn't found.</doc>
43863         <type name="gboolean" c:type="gboolean"/>
43864       </return-value>
43865       <parameters>
43866         <parameter name="error_domain" transfer-ownership="none">
43867           <doc xml:whitespace="preserve">A #GQuark for a error domain.</doc>
43868           <type name="GLib.Quark" c:type="GQuark"/>
43869         </parameter>
43870         <parameter name="error_code" transfer-ownership="none">
43871           <doc xml:whitespace="preserve">An error code.</doc>
43872           <type name="gint" c:type="gint"/>
43873         </parameter>
43874         <parameter name="dbus_error_name" transfer-ownership="none">
43875           <doc xml:whitespace="preserve">A D-Bus error name.</doc>
43876           <type name="utf8" c:type="gchar*"/>
43877         </parameter>
43878       </parameters>
43879     </function>
43880     <function name="dbus_generate_guid"
43881               c:identifier="g_dbus_generate_guid"
43882               version="2.26">
43883       <doc xml:whitespace="preserve">Generate a D-Bus GUID that can be used with
43884 e.g. g_dbus_connection_new().
43885 See the D-Bus specification regarding what strings are valid D-Bus
43886 GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).</doc>
43887       <return-value transfer-ownership="full">
43888         <doc xml:whitespace="preserve">A valid D-Bus GUID. Free with g_free().</doc>
43889         <type name="utf8" c:type="gchar*"/>
43890       </return-value>
43891     </function>
43892     <function name="dbus_is_address"
43893               c:identifier="g_dbus_is_address"
43894               version="2.26">
43895       <doc xml:whitespace="preserve">Checks if @string is a D-Bus address.
43896 This doesn't check if @string is actually supported by #GDBusServer
43897 or #GDBusConnection - use g_dbus_is_supported_address() to do more
43898 checks.</doc>
43899       <return-value transfer-ownership="none">
43900         <doc xml:whitespace="preserve">%TRUE if @string is a valid D-Bus address, %FALSE otherwise.</doc>
43901         <type name="gboolean" c:type="gboolean"/>
43902       </return-value>
43903       <parameters>
43904         <parameter name="string" transfer-ownership="none">
43905           <doc xml:whitespace="preserve">A string.</doc>
43906           <type name="utf8" c:type="gchar*"/>
43907         </parameter>
43908       </parameters>
43909     </function>
43910     <function name="dbus_is_guid" c:identifier="g_dbus_is_guid" version="2.26">
43911       <doc xml:whitespace="preserve">Checks if @string is a D-Bus GUID.
43912 See the D-Bus specification regarding what strings are valid D-Bus
43913 GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).</doc>
43914       <return-value transfer-ownership="none">
43915         <doc xml:whitespace="preserve">%TRUE if @string is a guid, %FALSE otherwise.</doc>
43916         <type name="gboolean" c:type="gboolean"/>
43917       </return-value>
43918       <parameters>
43919         <parameter name="string" transfer-ownership="none">
43920           <doc xml:whitespace="preserve">The string to check.</doc>
43921           <type name="utf8" c:type="gchar*"/>
43922         </parameter>
43923       </parameters>
43924     </function>
43925     <function name="dbus_is_interface_name"
43926               c:identifier="g_dbus_is_interface_name"
43927               version="2.26">
43928       <doc xml:whitespace="preserve">Checks if @string is a valid D-Bus interface name.</doc>
43929       <return-value transfer-ownership="none">
43930         <doc xml:whitespace="preserve">%TRUE if valid, %FALSE otherwise.</doc>
43931         <type name="gboolean" c:type="gboolean"/>
43932       </return-value>
43933       <parameters>
43934         <parameter name="string" transfer-ownership="none">
43935           <doc xml:whitespace="preserve">The string to check.</doc>
43936           <type name="utf8" c:type="gchar*"/>
43937         </parameter>
43938       </parameters>
43939     </function>
43940     <function name="dbus_is_member_name"
43941               c:identifier="g_dbus_is_member_name"
43942               version="2.26">
43943       <doc xml:whitespace="preserve">Checks if @string is a valid D-Bus member (e.g. signal or method) name.</doc>
43944       <return-value transfer-ownership="none">
43945         <doc xml:whitespace="preserve">%TRUE if valid, %FALSE otherwise.</doc>
43946         <type name="gboolean" c:type="gboolean"/>
43947       </return-value>
43948       <parameters>
43949         <parameter name="string" transfer-ownership="none">
43950           <doc xml:whitespace="preserve">The string to check.</doc>
43951           <type name="utf8" c:type="gchar*"/>
43952         </parameter>
43953       </parameters>
43954     </function>
43955     <function name="dbus_is_name" c:identifier="g_dbus_is_name" version="2.26">
43956       <doc xml:whitespace="preserve">Checks if @string is a valid D-Bus bus name (either unique or well-known).</doc>
43957       <return-value transfer-ownership="none">
43958         <doc xml:whitespace="preserve">%TRUE if valid, %FALSE otherwise.</doc>
43959         <type name="gboolean" c:type="gboolean"/>
43960       </return-value>
43961       <parameters>
43962         <parameter name="string" transfer-ownership="none">
43963           <doc xml:whitespace="preserve">The string to check.</doc>
43964           <type name="utf8" c:type="gchar*"/>
43965         </parameter>
43966       </parameters>
43967     </function>
43968     <function name="dbus_is_supported_address"
43969               c:identifier="g_dbus_is_supported_address"
43970               version="2.26"
43971               throws="1">
43972       <doc xml:whitespace="preserve">Like g_dbus_is_address() but also checks if the library suppors the
43973 transports in @string and that key/value pairs for each transport
43974 are valid.
43975 supported by this library, %FALSE if @error is set.</doc>
43976       <return-value transfer-ownership="none">
43977         <doc xml:whitespace="preserve">%TRUE if @string is a valid D-Bus address that is</doc>
43978         <type name="gboolean" c:type="gboolean"/>
43979       </return-value>
43980       <parameters>
43981         <parameter name="string" transfer-ownership="none">
43982           <doc xml:whitespace="preserve">A string.</doc>
43983           <type name="utf8" c:type="gchar*"/>
43984         </parameter>
43985       </parameters>
43986     </function>
43987     <function name="dbus_is_unique_name"
43988               c:identifier="g_dbus_is_unique_name"
43989               version="2.26">
43990       <doc xml:whitespace="preserve">Checks if @string is a valid D-Bus unique bus name.</doc>
43991       <return-value transfer-ownership="none">
43992         <doc xml:whitespace="preserve">%TRUE if valid, %FALSE otherwise.</doc>
43993         <type name="gboolean" c:type="gboolean"/>
43994       </return-value>
43995       <parameters>
43996         <parameter name="string" transfer-ownership="none">
43997           <doc xml:whitespace="preserve">The string to check.</doc>
43998           <type name="utf8" c:type="gchar*"/>
43999         </parameter>
44000       </parameters>
44001     </function>
44002     <function name="file_hash" c:identifier="g_file_hash">
44003       <doc xml:whitespace="preserve">Creates a hash value for a #GFile.
44004 This call does no blocking i/o.
44005 integer that can be used as hash value for the #GFile.
44006 This function is intended for easily hashing a #GFile to
44007 add to a #GHashTable or similar data structure.</doc>
44008       <return-value transfer-ownership="none">
44009         <doc xml:whitespace="preserve">0 if @file is not a valid #GFile, otherwise an</doc>
44010         <type name="guint" c:type="guint"/>
44011       </return-value>
44012       <parameters>
44013         <parameter name="file" transfer-ownership="none">
44014           <doc xml:whitespace="preserve">#gconstpointer to a #GFile.</doc>
44015           <type name="gpointer" c:type="gconstpointer"/>
44016         </parameter>
44017       </parameters>
44018     </function>
44019     <function name="file_new_for_commandline_arg"
44020               c:identifier="g_file_new_for_commandline_arg">
44021       <doc xml:whitespace="preserve">Creates a #GFile with the given argument from the command line. The value of
44022 relative to the current working directory.
44023 This operation never fails, but the returned object might not support any
44024 I/O operation if @arg points to a malformed path.</doc>
44025       <return-value transfer-ownership="full">
44026         <doc xml:whitespace="preserve">a new #GFile.</doc>
44027         <type name="File" c:type="GFile*"/>
44028       </return-value>
44029       <parameters>
44030         <parameter name="arg" transfer-ownership="none">
44031           <doc xml:whitespace="preserve">a command line string.</doc>
44032           <type name="utf8" c:type="char*"/>
44033         </parameter>
44034       </parameters>
44035     </function>
44036     <function name="file_new_for_path" c:identifier="g_file_new_for_path">
44037       <doc xml:whitespace="preserve">Constructs a #GFile for a given path. This operation never
44038 fails, but the returned object might not support any I/O
44039 operation if @path is malformed.</doc>
44040       <return-value transfer-ownership="full">
44041         <doc xml:whitespace="preserve">a new #GFile for the given @path.</doc>
44042         <type name="File" c:type="GFile*"/>
44043       </return-value>
44044       <parameters>
44045         <parameter name="path" transfer-ownership="none">
44046           <doc xml:whitespace="preserve">a string containing a relative or absolute path. The string must be encoded in the glib filename encoding.</doc>
44047           <type name="utf8" c:type="char*"/>
44048         </parameter>
44049       </parameters>
44050     </function>
44051     <function name="file_new_for_uri" c:identifier="g_file_new_for_uri">
44052       <doc xml:whitespace="preserve">Constructs a #GFile for a given URI. This operation never
44053 fails, but the returned object might not support any I/O
44054 operation if @uri is malformed or if the uri type is
44055 not supported.</doc>
44056       <return-value transfer-ownership="full">
44057         <doc xml:whitespace="preserve">a #GFile for the given @uri.</doc>
44058         <type name="File" c:type="GFile*"/>
44059       </return-value>
44060       <parameters>
44061         <parameter name="uri" transfer-ownership="none">
44062           <doc xml:whitespace="preserve">a UTF8 string containing a URI.</doc>
44063           <type name="utf8" c:type="char*"/>
44064         </parameter>
44065       </parameters>
44066     </function>
44067     <function name="file_parse_name" c:identifier="g_file_parse_name">
44068       <doc xml:whitespace="preserve">Constructs a #GFile with the given @parse_name (i.e. something given by g_file_get_parse_name()).
44069 This operation never fails, but the returned object might not support any I/O
44070 operation if the @parse_name cannot be parsed.</doc>
44071       <return-value transfer-ownership="full">
44072         <doc xml:whitespace="preserve">a new #GFile.</doc>
44073         <type name="File" c:type="GFile*"/>
44074       </return-value>
44075       <parameters>
44076         <parameter name="parse_name" transfer-ownership="none">
44077           <doc xml:whitespace="preserve">a file name or path to be parsed.</doc>
44078           <type name="utf8" c:type="char*"/>
44079         </parameter>
44080       </parameters>
44081     </function>
44082     <function name="icon_hash" c:identifier="g_icon_hash">
44083       <doc xml:whitespace="preserve">Gets a hash for an icon.
44084 use in a #GHashTable or similar data structure.</doc>
44085       <return-value transfer-ownership="none">
44086         <doc xml:whitespace="preserve">a #guint containing a hash for the @icon, suitable for</doc>
44087         <type name="guint" c:type="guint"/>
44088       </return-value>
44089       <parameters>
44090         <parameter name="icon" transfer-ownership="none">
44091           <doc xml:whitespace="preserve">#gconstpointer to an icon object.</doc>
44092           <type name="gpointer" c:type="gconstpointer"/>
44093         </parameter>
44094       </parameters>
44095     </function>
44096     <function name="icon_new_for_string"
44097               c:identifier="g_icon_new_for_string"
44098               version="2.20"
44099               introspectable="0"
44100               throws="1">
44101       <doc xml:whitespace="preserve">Generate a #GIcon instance from @str. This function can fail if
44102 If your application or library provides one or more #GIcon
44103 implementations you need to ensure that each #GType is registered
44104 with the type system prior to calling g_icon_new_for_string().</doc>
44105       <return-value>
44106         <doc xml:whitespace="preserve">An object implementing the #GIcon interface or %NULL if</doc>
44107         <type name="Icon" c:type="GIcon*"/>
44108       </return-value>
44109       <parameters>
44110         <parameter name="str" transfer-ownership="none">
44111           <doc xml:whitespace="preserve">A string obtained via g_icon_to_string().</doc>
44112           <type name="utf8" c:type="gchar*"/>
44113         </parameter>
44114       </parameters>
44115     </function>
44116     <function name="initable_new"
44117               c:identifier="g_initable_new"
44118               version="2.22"
44119               introspectable="0">
44120       <doc xml:whitespace="preserve">Helper function for constructing #GInitiable object. This is
44121 similar to g_object_new() but also initializes the object
44122 and returns %NULL, setting an error on failure.</doc>
44123       <return-value transfer-ownership="full">
44124         <doc xml:whitespace="preserve">a newly allocated #GObject, or %NULL on error</doc>
44125         <type name="gpointer" c:type="gpointer"/>
44126       </return-value>
44127       <parameters>
44128         <parameter name="object_type" transfer-ownership="none">
44129           <doc xml:whitespace="preserve">a #GType supporting #GInitable.</doc>
44130           <type name="GType" c:type="GType"/>
44131         </parameter>
44132         <parameter name="cancellable" transfer-ownership="none" allow-none="1">
44133           <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
44134           <type name="Cancellable" c:type="GCancellable*"/>
44135         </parameter>
44136         <parameter name="error" transfer-ownership="none">
44137           <doc xml:whitespace="preserve">a #GError location to store the error occuring, or %NULL to ignore.</doc>
44138           <type name="GLib.Error" c:type="GError**"/>
44139         </parameter>
44140         <parameter name="first_property_name" transfer-ownership="none">
44141           <doc xml:whitespace="preserve">the name of the first property, or %NULL if no properties</doc>
44142           <type name="utf8" c:type="gchar*"/>
44143         </parameter>
44144         <parameter transfer-ownership="none">
44145           <varargs>
44146           </varargs>
44147         </parameter>
44148       </parameters>
44149     </function>
44150     <function name="initable_new_valist"
44151               c:identifier="g_initable_new_valist"
44152               version="2.22"
44153               introspectable="0"
44154               throws="1">
44155       <doc xml:whitespace="preserve">Helper function for constructing #GInitiable object. This is
44156 similar to g_object_new_valist() but also initializes the object
44157 and returns %NULL, setting an error on failure.</doc>
44158       <return-value transfer-ownership="full">
44159         <doc xml:whitespace="preserve">a newly allocated #GObject, or %NULL on error</doc>
44160         <type name="GObject.Object" c:type="GObject*"/>
44161       </return-value>
44162       <parameters>
44163         <parameter name="object_type" transfer-ownership="none">
44164           <doc xml:whitespace="preserve">a #GType supporting #GInitable.</doc>
44165           <type name="GType" c:type="GType"/>
44166         </parameter>
44167         <parameter name="first_property_name" transfer-ownership="none">
44168           <doc xml:whitespace="preserve">the name of the first property, followed by the value, and other property value pairs, and ended by %NULL.</doc>
44169           <type name="utf8" c:type="gchar*"/>
44170         </parameter>
44171         <parameter name="var_args" transfer-ownership="none">
44172           <doc xml:whitespace="preserve">The var args list generated from @first_property_name.</doc>
44173           <type name="va_list" c:type="va_list"/>
44174         </parameter>
44175         <parameter name="cancellable" transfer-ownership="none" allow-none="1">
44176           <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
44177           <type name="Cancellable" c:type="GCancellable*"/>
44178         </parameter>
44179       </parameters>
44180     </function>
44181     <function name="initable_newv"
44182               c:identifier="g_initable_newv"
44183               version="2.22"
44184               throws="1">
44185       <doc xml:whitespace="preserve">Helper function for constructing #GInitiable object. This is
44186 similar to g_object_newv() but also initializes the object
44187 and returns %NULL, setting an error on failure.</doc>
44188       <return-value transfer-ownership="full">
44189         <doc xml:whitespace="preserve">a newly allocated #GObject, or %NULL on error</doc>
44190         <type name="gpointer" c:type="gpointer"/>
44191       </return-value>
44192       <parameters>
44193         <parameter name="object_type" transfer-ownership="none">
44194           <doc xml:whitespace="preserve">a #GType supporting #GInitable.</doc>
44195           <type name="GType" c:type="GType"/>
44196         </parameter>
44197         <parameter name="n_parameters" transfer-ownership="none">
44198           <doc xml:whitespace="preserve">the number of parameters in @parameters</doc>
44199           <type name="guint" c:type="guint"/>
44200         </parameter>
44201         <parameter name="parameters" transfer-ownership="none">
44202           <doc xml:whitespace="preserve">the parameters to use to construct the object</doc>
44203           <type name="GObject.Parameter" c:type="GParameter*"/>
44204         </parameter>
44205         <parameter name="cancellable" transfer-ownership="none" allow-none="1">
44206           <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
44207           <type name="Cancellable" c:type="GCancellable*"/>
44208         </parameter>
44209       </parameters>
44210     </function>
44211     <function name="io_error_from_errno" c:identifier="g_io_error_from_errno">
44212       <doc xml:whitespace="preserve">Converts errno.h error codes into GIO error codes.</doc>
44213       <return-value transfer-ownership="none">
44214         <doc xml:whitespace="preserve">#GIOErrorEnum value for the given errno.h error number.</doc>
44215         <type name="IOErrorEnum" c:type="GIOErrorEnum"/>
44216       </return-value>
44217       <parameters>
44218         <parameter name="err_no" transfer-ownership="none">
44219           <doc xml:whitespace="preserve">Error number as defined in errno.h.</doc>
44220           <type name="gint" c:type="gint"/>
44221         </parameter>
44222       </parameters>
44223     </function>
44224     <function name="io_error_quark" c:identifier="g_io_error_quark">
44225       <doc xml:whitespace="preserve">Gets the GIO Error Quark.</doc>
44226       <return-value transfer-ownership="none">
44227         <doc xml:whitespace="preserve">a #GQuark.</doc>
44228         <type name="GLib.Quark" c:type="GQuark"/>
44229       </return-value>
44230     </function>
44231     <function name="io_extension_get_type"
44232               c:identifier="g_io_extension_get_type">
44233       <doc xml:whitespace="preserve">Gets the type associated with @extension.</doc>
44234       <return-value transfer-ownership="none">
44235         <doc xml:whitespace="preserve">the type of @extension</doc>
44236         <type name="GType" c:type="GType"/>
44237       </return-value>
44238       <parameters>
44239         <parameter name="extension" transfer-ownership="none">
44240           <doc xml:whitespace="preserve">a #GIOExtension</doc>
44241           <type name="IOExtension" c:type="GIOExtension*"/>
44242         </parameter>
44243       </parameters>
44244     </function>
44245     <function name="io_extension_point_implement"
44246               c:identifier="g_io_extension_point_implement"
44247               introspectable="0">
44248       <doc xml:whitespace="preserve">Registers @type as extension for the extension point with name
44249 If @type has already been registered as an extension for this
44250 extension point, the existing #GIOExtension object is returned.</doc>
44251       <return-value>
44252         <doc xml:whitespace="preserve">a #GIOExtension object for #GType</doc>
44253         <type name="IOExtension" c:type="GIOExtension*"/>
44254       </return-value>
44255       <parameters>
44256         <parameter name="extension_point_name" transfer-ownership="none">
44257           <doc xml:whitespace="preserve">the name of the extension point</doc>
44258           <type name="utf8" c:type="char*"/>
44259         </parameter>
44260         <parameter name="type" transfer-ownership="none">
44261           <doc xml:whitespace="preserve">the #GType to register as extension</doc>
44262           <type name="GType" c:type="GType"/>
44263         </parameter>
44264         <parameter name="extension_name" transfer-ownership="none">
44265           <doc xml:whitespace="preserve">the name for the extension</doc>
44266           <type name="utf8" c:type="char*"/>
44267         </parameter>
44268         <parameter name="priority" transfer-ownership="none">
44269           <doc xml:whitespace="preserve">the priority for the extension</doc>
44270           <type name="gint" c:type="gint"/>
44271         </parameter>
44272       </parameters>
44273     </function>
44274     <function name="io_extension_point_lookup"
44275               c:identifier="g_io_extension_point_lookup"
44276               introspectable="0">
44277       <doc xml:whitespace="preserve">Looks up an existing extension point.
44278 registered extension point with the given name</doc>
44279       <return-value>
44280         <doc xml:whitespace="preserve">the #GIOExtensionPoint, or %NULL if there is no</doc>
44281         <type name="IOExtensionPoint" c:type="GIOExtensionPoint*"/>
44282       </return-value>
44283       <parameters>
44284         <parameter name="name" transfer-ownership="none">
44285           <doc xml:whitespace="preserve">the name of the extension point</doc>
44286           <type name="utf8" c:type="char*"/>
44287         </parameter>
44288       </parameters>
44289     </function>
44290     <function name="io_extension_point_register"
44291               c:identifier="g_io_extension_point_register"
44292               introspectable="0">
44293       <doc xml:whitespace="preserve">Registers an extension point.
44294 and should not be freed</doc>
44295       <return-value>
44296         <doc xml:whitespace="preserve">the new #GIOExtensionPoint. This object is owned by GIO</doc>
44297         <type name="IOExtensionPoint" c:type="GIOExtensionPoint*"/>
44298       </return-value>
44299       <parameters>
44300         <parameter name="name" transfer-ownership="none">
44301           <doc xml:whitespace="preserve">The name of the extension point</doc>
44302           <type name="utf8" c:type="char*"/>
44303         </parameter>
44304       </parameters>
44305     </function>
44306     <function name="io_modules_load_all_in_directory"
44307               c:identifier="g_io_modules_load_all_in_directory">
44308       <doc xml:whitespace="preserve">Loads all the modules in the specified directory.
44309 If don't require all modules to be initialized (and thus registering
44310 all gtypes) then you can use g_io_modules_scan_all_in_directory()
44311 which allows delayed/lazy loading of modules.
44312 from the directory,
44313 All the modules are loaded into memory, if you want to
44314 unload them (enabling on-demand loading) you must call
44315 g_type_module_unuse() on all the modules. Free the list
44316 with g_list_free().</doc>
44317       <return-value transfer-ownership="full">
44318         <doc xml:whitespace="preserve">a list of #GIOModules loaded</doc>
44319         <type name="GLib.List" c:type="GList*">
44320           <type name="IOModule"/>
44321         </type>
44322       </return-value>
44323       <parameters>
44324         <parameter name="dirname" transfer-ownership="none">
44325           <doc xml:whitespace="preserve">pathname for a directory containing modules to load.</doc>
44326           <type name="utf8" c:type="gchar*"/>
44327         </parameter>
44328       </parameters>
44329     </function>
44330     <function name="io_modules_scan_all_in_directory"
44331               c:identifier="g_io_modules_scan_all_in_directory"
44332               version="2.24">
44333       <doc xml:whitespace="preserve">Scans all the modules in the specified directory, ensuring that
44334 any extension point implemented by a module is registered.
44335 This may not actually load and initialize all the types in each
44336 module, some modules may be lazily loaded and initialized when
44337 an extension point it implementes is used with e.g.
44338 g_io_extension_point_get_extensions() or
44339 g_io_extension_point_get_extension_by_name().
44340 If you need to guarantee that all types are loaded in all the modules,
44341 use g_io_modules_scan_all_in_directory().</doc>
44342       <return-value transfer-ownership="none">
44343         <type name="none" c:type="void"/>
44344       </return-value>
44345       <parameters>
44346         <parameter name="dirname" transfer-ownership="none">
44347           <doc xml:whitespace="preserve">pathname for a directory containing modules to scan.</doc>
44348           <type name="utf8" c:type="char*"/>
44349         </parameter>
44350       </parameters>
44351     </function>
44352     <function name="io_scheduler_cancel_all_jobs"
44353               c:identifier="g_io_scheduler_cancel_all_jobs">
44354       <doc xml:whitespace="preserve">Cancels all cancellable I/O jobs.
44355 A job is cancellable if a #GCancellable was passed into
44356 g_io_scheduler_push_job().</doc>
44357       <return-value transfer-ownership="none">
44358         <type name="none" c:type="void"/>
44359       </return-value>
44360     </function>
44361     <function name="io_scheduler_push_job"
44362               c:identifier="g_io_scheduler_push_job">
44363       <doc xml:whitespace="preserve">Schedules the I/O job to run.
44364 regardless whether the job was cancelled or has run to completion.
44365 If @cancellable is not %NULL, it can be used to cancel the I/O job
44366 by calling g_cancellable_cancel() or by calling
44367 g_io_scheduler_cancel_all_jobs().</doc>
44368       <return-value transfer-ownership="none">
44369         <type name="none" c:type="void"/>
44370       </return-value>
44371       <parameters>
44372         <parameter name="job_func"
44373                    transfer-ownership="none"
44374                    scope="notified"
44375                    closure="1"
44376                    destroy="2">
44377           <doc xml:whitespace="preserve">a #GIOSchedulerJobFunc.</doc>
44378           <type name="IOSchedulerJobFunc" c:type="GIOSchedulerJobFunc"/>
44379         </parameter>
44380         <parameter name="user_data" transfer-ownership="none">
44381           <doc xml:whitespace="preserve">data to pass to @job_func</doc>
44382           <type name="gpointer" c:type="gpointer"/>
44383         </parameter>
44384         <parameter name="notify" transfer-ownership="none" scope="async">
44385           <doc xml:whitespace="preserve">a #GDestroyNotify for @user_data, or %NULL</doc>
44386           <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
44387         </parameter>
44388         <parameter name="io_priority" transfer-ownership="none">
44389           <doc xml:whitespace="preserve">the &lt;link linkend="gioscheduler"&gt;I/O priority&lt;/link&gt; of the request.</doc>
44390           <type name="gint" c:type="gint"/>
44391         </parameter>
44392         <parameter name="cancellable" transfer-ownership="none" allow-none="1">
44393           <doc xml:whitespace="preserve">optional #GCancellable object, %NULL to ignore.</doc>
44394           <type name="Cancellable" c:type="GCancellable*"/>
44395         </parameter>
44396       </parameters>
44397     </function>
44398     <function name="keyfile_settings_backend_new"
44399               c:identifier="g_keyfile_settings_backend_new">
44400       <doc xml:whitespace="preserve">Creates a keyfile-backed #GSettingsBackend.
44401 The filename of the keyfile to use is given by @filename.
44402 All settings read to or written from the backend must fall under the
44403 path given in @root_path (which must start and end with a slash and
44404 not contain two consecutive slashes).  @root_path may be "/".
44405 If @root_group is non-%NULL then it specifies the name of the keyfile
44406 group used for keys that are written directly below @root_path.  For
44407 example, if @root_path is "/apps/example/" and @root_group is
44408 "toplevel", then settings the key "/apps/example/enabled" to a value
44409 of %TRUE will cause the following to appear in the keyfile:
44410 |[
44411 [toplevel]
44412 enabled=true
44413 ]|
44414 If @root_group is %NULL then it is not permitted to store keys
44415 directly below the @root_path.
44416 the name of the subpath (with the final slash stripped) is used as
44417 the name of the keyfile group.  To continue the example, if
44418 "/apps/example/profiles/default/font-size" were set to
44419 12 then the following would appear in the keyfile:
44420 |[
44421 [profiles/default]
44422 font-size=12
44423 ]|
44424 The backend will refuse writes (and return writability as being
44425 %FALSE) for keys outside of @root_path and, in the event that
44426 Writes will also be refused if the backend detects that it has the
44427 writable).
44428 There is no checking done for your key namespace clashing with the
44429 syntax of the key file format.  For example, if you have '[' or ']'
44430 characters in your path names or '=' in your key names you may be in
44431 trouble.</doc>
44432       <return-value transfer-ownership="full">
44433         <doc xml:whitespace="preserve">a keyfile-backed #GSettingsBackend</doc>
44434         <type name="SettingsBackend" c:type="GSettingsBackend*"/>
44435       </return-value>
44436       <parameters>
44437         <parameter name="filename" transfer-ownership="none">
44438           <doc xml:whitespace="preserve">the filename of the keyfile</doc>
44439           <type name="utf8" c:type="gchar*"/>
44440         </parameter>
44441         <parameter name="root_path" transfer-ownership="none">
44442           <doc xml:whitespace="preserve">the path under which all settings keys appear</doc>
44443           <type name="utf8" c:type="gchar*"/>
44444         </parameter>
44445         <parameter name="root_group" transfer-ownership="none" allow-none="1">
44446           <doc xml:whitespace="preserve">the group name corresponding to</doc>
44447           <type name="utf8" c:type="gchar*"/>
44448         </parameter>
44449       </parameters>
44450     </function>
44451     <function name="proxy_get_default_for_protocol"
44452               c:identifier="g_proxy_get_default_for_protocol"
44453               version="2.26"
44454               introspectable="0">
44455       <doc xml:whitespace="preserve">Lookup "gio-proxy" extension point for a proxy implementation that supports
44456 specified protocol.</doc>
44457       <return-value>
44458         <doc xml:whitespace="preserve">return a #GProxy or NULL if protocol is not supported.</doc>
44459         <type name="Proxy" c:type="GProxy*"/>
44460       </return-value>
44461       <parameters>
44462         <parameter name="protocol" transfer-ownership="none">
44463           <doc xml:whitespace="preserve">the proxy protocol name (e.g. http, socks, etc)</doc>
44464           <type name="utf8" c:type="gchar*"/>
44465         </parameter>
44466       </parameters>
44467     </function>
44468     <function name="proxy_resolver_get_default"
44469               c:identifier="g_proxy_resolver_get_default"
44470               version="2.26">
44471       <doc xml:whitespace="preserve">Gets the default #GProxyResolver for the system.</doc>
44472       <return-value transfer-ownership="none">
44473         <doc xml:whitespace="preserve">the default #GProxyResolver.</doc>
44474         <type name="ProxyResolver" c:type="GProxyResolver*"/>
44475       </return-value>
44476     </function>
44477     <function name="resolver_error_quark"
44478               c:identifier="g_resolver_error_quark"
44479               version="2.22">
44480       <doc xml:whitespace="preserve">Gets the #GResolver Error Quark.</doc>
44481       <return-value transfer-ownership="none">
44482         <doc xml:whitespace="preserve">a #GQuark.</doc>
44483         <type name="GLib.Quark" c:type="GQuark"/>
44484       </return-value>
44485     </function>
44486     <function name="simple_async_report_error_in_idle"
44487               c:identifier="g_simple_async_report_error_in_idle"
44488               introspectable="0">
44489       <doc xml:whitespace="preserve">Reports an error in an asynchronous function in an idle function by
44490 directly setting the contents of the #GAsyncResult with the given error
44491 information.</doc>
44492       <return-value transfer-ownership="none">
44493         <type name="none" c:type="void"/>
44494       </return-value>
44495       <parameters>
44496         <parameter name="object" transfer-ownership="none">
44497           <doc xml:whitespace="preserve">a #GObject.</doc>
44498           <type name="GObject.Object" c:type="GObject*"/>
44499         </parameter>
44500         <parameter name="callback"
44501                    transfer-ownership="none"
44502                    scope="async"
44503                    closure="2">
44504           <doc xml:whitespace="preserve">a #GAsyncReadyCallback.</doc>
44505           <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
44506         </parameter>
44507         <parameter name="user_data" transfer-ownership="none">
44508           <doc xml:whitespace="preserve">user data passed to @callback.</doc>
44509           <type name="gpointer" c:type="gpointer"/>
44510         </parameter>
44511         <parameter name="domain" transfer-ownership="none">
44512           <doc xml:whitespace="preserve">a #GQuark containing the error domain (usually #G_IO_ERROR).</doc>
44513           <type name="GLib.Quark" c:type="GQuark"/>
44514         </parameter>
44515         <parameter name="code" transfer-ownership="none">
44516           <doc xml:whitespace="preserve">a specific error code.</doc>
44517           <type name="gint" c:type="gint"/>
44518         </parameter>
44519         <parameter name="format" transfer-ownership="none">
44520           <doc xml:whitespace="preserve">a formatted error reporting string.</doc>
44521           <type name="utf8" c:type="char*"/>
44522         </parameter>
44523         <parameter transfer-ownership="none">
44524           <varargs>
44525           </varargs>
44526         </parameter>
44527       </parameters>
44528     </function>
44529     <function name="simple_async_report_gerror_in_idle"
44530               c:identifier="g_simple_async_report_gerror_in_idle">
44531       <doc xml:whitespace="preserve">Reports an error in an idle function. Similar to
44532 g_simple_async_report_error_in_idle(), but takes a #GError rather
44533 than building a new one.</doc>
44534       <return-value transfer-ownership="none">
44535         <type name="none" c:type="void"/>
44536       </return-value>
44537       <parameters>
44538         <parameter name="object" transfer-ownership="none">
44539           <doc xml:whitespace="preserve">a #GObject.</doc>
44540           <type name="GObject.Object" c:type="GObject*"/>
44541         </parameter>
44542         <parameter name="callback"
44543                    transfer-ownership="none"
44544                    scope="async"
44545                    closure="2">
44546           <doc xml:whitespace="preserve">a #GAsyncReadyCallback.</doc>
44547           <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
44548         </parameter>
44549         <parameter name="user_data" transfer-ownership="none">
44550           <doc xml:whitespace="preserve">user data passed to @callback.</doc>
44551           <type name="gpointer" c:type="gpointer"/>
44552         </parameter>
44553         <parameter name="error" transfer-ownership="none">
44554           <doc xml:whitespace="preserve">the #GError to report</doc>
44555           <type name="GLib.Error" c:type="GError*"/>
44556         </parameter>
44557       </parameters>
44558     </function>
44559     <function name="srv_target_list_sort"
44560               c:identifier="g_srv_target_list_sort"
44561               version="2.22">
44562       <doc xml:whitespace="preserve">Sorts @targets in place according to the algorithm in RFC 2782.</doc>
44563       <return-value transfer-ownership="full">
44564         <doc xml:whitespace="preserve">the head of the sorted list.</doc>
44565         <type name="GLib.List" c:type="GList*">
44566           <type name="gpointer" c:type="gpointer"/>
44567         </type>
44568       </return-value>
44569       <parameters>
44570         <parameter name="targets" transfer-ownership="none">
44571           <doc xml:whitespace="preserve">a #GList of #GSrvTarget</doc>
44572           <type name="GLib.List" c:type="GList*">
44573             <type name="gpointer" c:type="gpointer"/>
44574           </type>
44575         </parameter>
44576       </parameters>
44577     </function>
44578     <function name="unix_is_mount_path_system_internal"
44579               c:identifier="g_unix_is_mount_path_system_internal">
44580       <doc xml:whitespace="preserve">Determines if @mount_path is considered an implementation of the
44581 OS. This is primarily used for hiding mountable and mounted volumes
44582 that only are used in the OS and has little to no relevance to the
44583 casual user.
44584 of the OS.</doc>
44585       <return-value transfer-ownership="none">
44586         <doc xml:whitespace="preserve">%TRUE if @mount_path is considered an implementation detail</doc>
44587         <type name="gboolean" c:type="gboolean"/>
44588       </return-value>
44589       <parameters>
44590         <parameter name="mount_path" transfer-ownership="none">
44591           <doc xml:whitespace="preserve">a mount path, e.g. &lt;filename&gt;/media/disk&lt;/filename&gt; or &lt;filename&gt;/usr&lt;/filename&gt;</doc>
44592           <type name="utf8" c:type="char*"/>
44593         </parameter>
44594       </parameters>
44595     </function>
44596     <function name="unix_mount_at"
44597               c:identifier="g_unix_mount_at"
44598               introspectable="0">
44599       <doc xml:whitespace="preserve">Gets a #GUnixMountEntry for a given mount path. If @time_read
44600 is set, it will be filled with a unix timestamp for checking
44601 if the mounts have changed since with g_unix_mounts_changed_since().</doc>
44602       <return-value transfer-ownership="full">
44603         <doc xml:whitespace="preserve">a #GUnixMount.</doc>
44604         <type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
44605       </return-value>
44606       <parameters>
44607         <parameter name="mount_path" transfer-ownership="none">
44608           <doc xml:whitespace="preserve">path for a possible unix mount.</doc>
44609           <type name="utf8" c:type="char*"/>
44610         </parameter>
44611         <parameter name="time_read" transfer-ownership="none">
44612           <doc xml:whitespace="preserve">guint64 to contain a timestamp.</doc>
44613           <type name="guint64" c:type="guint64*"/>
44614         </parameter>
44615       </parameters>
44616     </function>
44617     <function name="unix_mount_compare" c:identifier="g_unix_mount_compare">
44618       <doc xml:whitespace="preserve">Compares two unix mounts.
44619 or less than @mount2, respectively.</doc>
44620       <return-value transfer-ownership="none">
44621         <doc xml:whitespace="preserve">1, 0 or -1 if @mount1 is greater than, equal to,</doc>
44622         <type name="gint" c:type="gint"/>
44623       </return-value>
44624       <parameters>
44625         <parameter name="mount1" transfer-ownership="none">
44626           <doc xml:whitespace="preserve">first #GUnixMountEntry to compare.</doc>
44627           <type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
44628         </parameter>
44629         <parameter name="mount2" transfer-ownership="none">
44630           <doc xml:whitespace="preserve">second #GUnixMountEntry to compare.</doc>
44631           <type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
44632         </parameter>
44633       </parameters>
44634     </function>
44635     <function name="unix_mount_free" c:identifier="g_unix_mount_free">
44636       <doc xml:whitespace="preserve">Frees a unix mount.</doc>
44637       <return-value transfer-ownership="none">
44638         <type name="none" c:type="void"/>
44639       </return-value>
44640       <parameters>
44641         <parameter name="mount_entry" transfer-ownership="none">
44642           <doc xml:whitespace="preserve">a #GUnixMount.</doc>
44643           <type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
44644         </parameter>
44645       </parameters>
44646     </function>
44647     <function name="unix_mount_get_device_path"
44648               c:identifier="g_unix_mount_get_device_path">
44649       <doc xml:whitespace="preserve">Gets the device path for a unix mount.</doc>
44650       <return-value transfer-ownership="none">
44651         <doc xml:whitespace="preserve">a string containing the device path.</doc>
44652         <type name="utf8" c:type="char*"/>
44653       </return-value>
44654       <parameters>
44655         <parameter name="mount_entry" transfer-ownership="none">
44656           <doc xml:whitespace="preserve">a #GUnixMount.</doc>
44657           <type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
44658         </parameter>
44659       </parameters>
44660     </function>
44661     <function name="unix_mount_get_fs_type"
44662               c:identifier="g_unix_mount_get_fs_type">
44663       <doc xml:whitespace="preserve">Gets the filesystem type for the unix mount.</doc>
44664       <return-value transfer-ownership="none">
44665         <doc xml:whitespace="preserve">a string containing the file system type.</doc>
44666         <type name="utf8" c:type="char*"/>
44667       </return-value>
44668       <parameters>
44669         <parameter name="mount_entry" transfer-ownership="none">
44670           <doc xml:whitespace="preserve">a #GUnixMount.</doc>
44671           <type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
44672         </parameter>
44673       </parameters>
44674     </function>
44675     <function name="unix_mount_get_mount_path"
44676               c:identifier="g_unix_mount_get_mount_path">
44677       <doc xml:whitespace="preserve">Gets the mount path for a unix mount.</doc>
44678       <return-value transfer-ownership="none">
44679         <doc xml:whitespace="preserve">the mount path for @mount_entry.</doc>
44680         <type name="utf8" c:type="char*"/>
44681       </return-value>
44682       <parameters>
44683         <parameter name="mount_entry" transfer-ownership="none">
44684           <doc xml:whitespace="preserve">input #GUnixMountEntry to get the mount path for.</doc>
44685           <type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
44686         </parameter>
44687       </parameters>
44688     </function>
44689     <function name="unix_mount_guess_can_eject"
44690               c:identifier="g_unix_mount_guess_can_eject">
44691       <doc xml:whitespace="preserve">Guesses whether a Unix mount can be ejected.</doc>
44692       <return-value transfer-ownership="none">
44693         <doc xml:whitespace="preserve">%TRUE if @mount_entry is deemed to be ejectable.</doc>
44694         <type name="gboolean" c:type="gboolean"/>
44695       </return-value>
44696       <parameters>
44697         <parameter name="mount_entry" transfer-ownership="none">
44698           <doc xml:whitespace="preserve">a #GUnixMountEntry</doc>
44699           <type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
44700         </parameter>
44701       </parameters>
44702     </function>
44703     <function name="unix_mount_guess_icon"
44704               c:identifier="g_unix_mount_guess_icon">
44705       <doc xml:whitespace="preserve">Guesses the icon of a Unix mount.</doc>
44706       <return-value transfer-ownership="full">
44707         <doc xml:whitespace="preserve">a #GIcon</doc>
44708         <type name="Icon" c:type="GIcon*"/>
44709       </return-value>
44710       <parameters>
44711         <parameter name="mount_entry" transfer-ownership="none">
44712           <doc xml:whitespace="preserve">a #GUnixMountEntry</doc>
44713           <type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
44714         </parameter>
44715       </parameters>
44716     </function>
44717     <function name="unix_mount_guess_name"
44718               c:identifier="g_unix_mount_guess_name">
44719       <doc xml:whitespace="preserve">Guesses the name of a Unix mount.
44720 The result is a translated string.
44721 be freed with g_free()</doc>
44722       <return-value transfer-ownership="full">
44723         <doc xml:whitespace="preserve">A newly allocated string that must</doc>
44724         <type name="utf8" c:type="char*"/>
44725       </return-value>
44726       <parameters>
44727         <parameter name="mount_entry" transfer-ownership="none">
44728           <doc xml:whitespace="preserve">a #GUnixMountEntry</doc>
44729           <type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
44730         </parameter>
44731       </parameters>
44732     </function>
44733     <function name="unix_mount_guess_should_display"
44734               c:identifier="g_unix_mount_guess_should_display">
44735       <doc xml:whitespace="preserve">Guesses whether a Unix mount should be displayed in the UI.</doc>
44736       <return-value transfer-ownership="none">
44737         <doc xml:whitespace="preserve">%TRUE if @mount_entry is deemed to be displayable.</doc>
44738         <type name="gboolean" c:type="gboolean"/>
44739       </return-value>
44740       <parameters>
44741         <parameter name="mount_entry" transfer-ownership="none">
44742           <doc xml:whitespace="preserve">a #GUnixMountEntry</doc>
44743           <type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
44744         </parameter>
44745       </parameters>
44746     </function>
44747     <function name="unix_mount_is_readonly"
44748               c:identifier="g_unix_mount_is_readonly">
44749       <doc xml:whitespace="preserve">Checks if a unix mount is mounted read only.</doc>
44750       <return-value transfer-ownership="none">
44751         <doc xml:whitespace="preserve">%TRUE if @mount_entry is read only.</doc>
44752         <type name="gboolean" c:type="gboolean"/>
44753       </return-value>
44754       <parameters>
44755         <parameter name="mount_entry" transfer-ownership="none">
44756           <doc xml:whitespace="preserve">a #GUnixMount.</doc>
44757           <type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
44758         </parameter>
44759       </parameters>
44760     </function>
44761     <function name="unix_mount_is_system_internal"
44762               c:identifier="g_unix_mount_is_system_internal">
44763       <doc xml:whitespace="preserve">Checks if a unix mount is a system path.</doc>
44764       <return-value transfer-ownership="none">
44765         <doc xml:whitespace="preserve">%TRUE if the unix mount is for a system path.</doc>
44766         <type name="gboolean" c:type="gboolean"/>
44767       </return-value>
44768       <parameters>
44769         <parameter name="mount_entry" transfer-ownership="none">
44770           <doc xml:whitespace="preserve">a #GUnixMount.</doc>
44771           <type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
44772         </parameter>
44773       </parameters>
44774     </function>
44775     <function name="unix_mount_points_changed_since"
44776               c:identifier="g_unix_mount_points_changed_since">
44777       <doc xml:whitespace="preserve">Checks if the unix mount points have changed since a given unix time.</doc>
44778       <return-value transfer-ownership="none">
44779         <doc xml:whitespace="preserve">%TRUE if the mount points have changed since @time.</doc>
44780         <type name="gboolean" c:type="gboolean"/>
44781       </return-value>
44782       <parameters>
44783         <parameter name="time" transfer-ownership="none">
44784           <doc xml:whitespace="preserve">guint64 to contain a timestamp.</doc>
44785           <type name="guint64" c:type="guint64"/>
44786         </parameter>
44787       </parameters>
44788     </function>
44789     <function name="unix_mount_points_get"
44790               c:identifier="g_unix_mount_points_get">
44791       <doc xml:whitespace="preserve">Gets a #GList of #GUnixMountPoint containing the unix mount points.
44792 If @time_read is set, it will be filled with the mount timestamp,
44793 allowing for checking if the mounts have changed with
44794 g_unix_mounts_points_changed_since().</doc>
44795       <return-value transfer-ownership="full">
44796         <doc xml:whitespace="preserve">a #GList of the UNIX mountpoints.</doc>
44797         <type name="GLib.List" c:type="GList*">
44798           <type name="utf8"/>
44799         </type>
44800       </return-value>
44801       <parameters>
44802         <parameter name="time_read" transfer-ownership="none" allow-none="1">
44803           <doc xml:whitespace="preserve">guint64 to contain a timestamp.</doc>
44804           <type name="guint64" c:type="guint64*"/>
44805         </parameter>
44806       </parameters>
44807     </function>
44808     <function name="unix_mounts_changed_since"
44809               c:identifier="g_unix_mounts_changed_since">
44810       <doc xml:whitespace="preserve">Checks if the unix mounts have changed since a given unix time.</doc>
44811       <return-value transfer-ownership="none">
44812         <doc xml:whitespace="preserve">%TRUE if the mounts have changed since @time.</doc>
44813         <type name="gboolean" c:type="gboolean"/>
44814       </return-value>
44815       <parameters>
44816         <parameter name="time" transfer-ownership="none">
44817           <doc xml:whitespace="preserve">guint64 to contain a timestamp.</doc>
44818           <type name="guint64" c:type="guint64"/>
44819         </parameter>
44820       </parameters>
44821     </function>
44822     <function name="unix_mounts_get" c:identifier="g_unix_mounts_get">
44823       <doc xml:whitespace="preserve">Gets a #GList of #GUnixMountEntry containing the unix mounts.
44824 If @time_read is set, it will be filled with the mount
44825 timestamp, allowing for checking if the mounts have changed
44826 with g_unix_mounts_changed_since().</doc>
44827       <return-value transfer-ownership="full">
44828         <doc xml:whitespace="preserve">a #GList of the UNIX mounts.</doc>
44829         <type name="GLib.List" c:type="GList*">
44830           <type name="utf8"/>
44831         </type>
44832       </return-value>
44833       <parameters>
44834         <parameter name="time_read" transfer-ownership="none" allow-none="1">
44835           <doc xml:whitespace="preserve">guint64 to contain a timestamp, or %NULL</doc>
44836           <type name="guint64" c:type="guint64*"/>
44837         </parameter>
44838       </parameters>
44839     </function>
44840   </namespace>
44841 </repository>